INFO
Astro Mosaic is configurable using URL parameters. With URL parameters it is possible to specify target, default telescope, add your own telescope and a few other settings. Astro Mosaic also supports embedding it to a page by selecting only part of the functionality to be visible.
Basic setting with URL parameters
Astro Mosaic accepts several parameters from URL string. Below are listed basic settings using URL parameters with some examples.
- Set the target at startup: target=name-or-ra-dec
- https://ruuth.xyz/AstroMosaic.html?target=Orion%20nebula
- https://ruuth.xyz/AstroMosaic.html?target=05:35:17.29%20-05:23:27.9
- Set the service at startup: service=name
- https://ruuth.xyz/AstroMosaic.html?service=Telescope%20Live
- Set the telescope at startup: telescope=name
- https://ruuth.xyz/AstroMosaic.html?telescope=C2
- https://ruuth.xyz/AstroMosaic.html?service=Telescope%20Live&telescope=CHI-3
- Set the date at startup: date=date
- https://ruuth.xyz/AstroMosaic.html?date=2021-03-21&target=M51
Add your own telescope or camera and lens
You can add your own telescope or camera with set_service and add_service URL parameters. Parameter set_service removes built in services and adds a new one. Parameter add_service creates a new service if service-name is not found. Then it adds a new telescope to a given service.
- set_service=service-name,telescope-name,fov-x-minutes,fov-y-minutes,latitude,longitude[,detect_location-for-seeing]
add_service=service-name,telescope-name,fov-x-minutes,fov-y-minutes,latitude,longitude[,detect_location-for-seeing] - https://ruuth.xyz/AstroMosaic.html?set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452,detect_location
- add_service=service-name,telescope-name,fov-x-minutes,fov-y-minutes,latitude,longitude[,detect_location-for-seeing]
- https://ruuth.xyz/AstroMosaic.html?add_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452,detect_location
If you want to add your own camera and lens, you can check camera/lens field of view in degrees for example from Field of View Calculator (FoV) of a Camera and Lens. You can then convert degrees to arcminutes for example here Convert Degrees to Arcminutes.
Set multiple services and telescopes using a json file
You can replace built in services with services_json URL parameter. The json file gives more control and options than set_service and add_service URL parameters.
- services_json=url-to-json-file
- https://ruuth.xyz/AstroMosaic.html?services_json=https://ruuth.xyz/am_test_services.json
Sample services_json file
{
"telescope_services": [
{
"name": "Fuji X-T3", "radec_format": 0,
"telescopes": [
{ "name": "400mm", "fov_x": 206, "fov_y": 137, "lat": 60.04298, "lng": 24.24452,
"alt": 0, "weather": null, "horizon_limits": [10], "meridian_transit": 0 },
{ "name": "135mm", "fov_x": 609, "fov_y": 406, "lat": 60.04298, "lng": 24.24452,
"alt": 0, "weather": null, "horizon_limits": [10], "meridian_transit": 0 }
]
},
{
"name": "My telescope", "radec_format": 0,
"telescopes": [
{ "name": "Takahashi FSQ-106ED", "fov_x": 324, "fov_y": 324, "lat": 60.04298, "lng": 24.24452,
"alt": 0, "weather": null, "horizon_limits": [10], "meridian_transit": 10 }
]
}
]
}
Embed to a page
Astro Mosaic can be embedded to a page. With embedding it is possible to select which view is shown. It is possible to show target view, day visibility view or year visibility view. Embedded view can be shown for example in an Iframe. By default Astro Mosaic detects the window size and adjusts the content to that window.
- view={target|day|year}[,width-px[,height-px]]
- https://ruuth.xyz/AstroMosaic.html?view=target&target=horsehead%20nebula&set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452
- https://ruuth.xyz/AstroMosaic.html?view=day&target=5.68305%20-2.45831&set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452
- https://ruuth.xyz/AstroMosaic.html?view=year&target=05:40:58.99%20-02:27:29.90&set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452
Embedding examples
Example code for embedding
<iframe src="https://ruuth.xyz/AstroMosaic.html?view=target&target=horsehead%20nebula&set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452" height="300px" width="300px" title="FoV"></iframe>