Configuring and Embedding AstroMosaic

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.

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 } ] } ] }

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