INFO
Configuring Astro Mosaic
Embedding Astro Mosaic
Configuring Astro Mosaic
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.
Basic setting with URL parameters
Astro Mosaic accepts several parameters from URL string. Below are listed basic settings using URL parameters with some examples.
Url parameter descriptions:
- target - Target name or ra/dec.
- add_catalog - Add a new catalog, this option requires two comma separated parameters: catalog-name,url-to-catalog-json. Multiple catalog can be given separated by semicolon.
- add_service - Add a new service, see description below.
- set_service - Set service, see description below.
- service - Select the current service.
- telescope - Select the current telescope in the current service.
- name - Name displayed in the title.
- grid_type - Select fov|panels.
- overlap - Mosaic overlap percentage.
- grid_size - Mosaic grid size as x,y.
- date - View date in ISO format.
- services_json - Set services from a json file, see description below.
- view - Select target|day|year. Default is show all.
- offaxis - Set offaxis guiding view, see description below.
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
- Set the telescope at startup: telescope=name
- https://ruuth.xyz/AstroMosaic.html?telescope=CHI-6
- https://ruuth.xyz/AstroMosaic.html?service=Telescope%20Live&telescope=CHI-3
- Set the date at startup: date=date
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.
Parameter descriptions for set_service and add_service:
- service-name - Service name.
- telescope-name - Telescope name.
- fov-x-minutes - Horizontal field of view in arcminutes.
- fov-y-minutes - Vertical field of view in arcminutes.
- latitude - Latitude of telescope location in degrees.
- longitude - Longitude of telescope location in degrees.
- weather:detect_location - Optional weather service view will try to detect the location for weather information. This of course may or may not match the telescope location
- tz:timezone - Timezone in hours from UTC to be used in time display. If not given then UTC is used.
Syntax:
- set_service=service-name,telescope-name,fov-x-minutes,fov-y-minutes,latitude,longitude[,tz:timezone][,weather:detect_location]
- add_service=service-name,telescope-name,fov-x-minutes,fov-y-minutes,latitude,longitude[,tz:timezone][,weather:detect_location]
Examples:
- https://ruuth.xyz/AstroMosaic.html?set_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452,tz:2,weather:detect_location
- https://ruuth.xyz/AstroMosaic.html?add_service=Fuji%20X-T3,400mm,206,137,60.04298,24.24452,tz:2,weather: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.
Offaxis guiding view
Parameter descriptions for add_offaxis. This parameter sets offaxis guiding view outside of telescope FoV. It can be added to any service and telescope. (NOTE! If someone knows how offaxis view should be configured please let me know.)
- service-name - Service name.
- telescope-name - Telescope name.
- fov-x-minutes - Horizontal field of view in arcminutes.
- fov-y-minutes - Vertical field of view in arcminutes.
- offset - Offset from main Fov in arcminutes.
- Position - Position of offaxis view, one of T, B, L, R for top, bottom, left or right axis.
Syntax:
- add_offaxis=service-name,telescope-name,fov-x-minutes,fov-y-minutes,offset-in-minutes,position
Examples:
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
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, timezoneOffset: 2,
"alt": 0, "weather": null, "horizon_limits": [10], "meridian_transit": 0 },
{ "name": "135mm", "fov_x": 609, "fov_y": 406, "lat": 60.04298, "lng": 24.24452, timezoneOffset: 2,
"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, timezoneOffset: 2,
"alt": 0, "weather": null, "horizon_limits": [10], "meridian_transit": 10 }
]
}
]
}
Embedding Astro Mosaic
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 in an Iframe or in a user defined div section using AstroMosaicEngine.js script file.
Embedding using Javascript function AstroMosaicEngine
Astro Mosaic engine is available as a separate AstroMosaicEngine.js Javascript file. By callling AstroMosaicEngine function it is possible to show target view, or day or year visibility graphs in a user given div section. With Javascript functions user can also control some more options like custom colors for text and background.
Javascript embedding examples
Example code for embedding using AstroMosaicEngine.js
See AstroMosaicEngineExample.html
Embedding in an Iframe
With URL parameter view it is possible to select target view, or day or year visibility graphs. 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
Iframe embedding examples
Example code for embedding in an Iframe
<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>
Embedding using Python
A Python version to calculate day and year visibility, and mosaic coordinates is available in GitHub.