AstroImager is along with AstroTelescope, AstroGuider and AstroDSLR part of powerful, but still easy to use astrophotography suite for Apple Mac computers built around INDIGO and INDI standard. Even if they can be used separately, they are meant to work together and with other astronomy and astrophotography tools for macOS or iOS provided by CloudMakers, like INDIGO Server for macOS, INDIGO Control Panel, FITS Preview, iINDI or NightSky Toolbox.
Specific purpose of AstroImager is to control main imaging camera, filter wheel and focuser, to allow proper framing, focusing and capturing from single batch of images to quite complicated series of images with different parameters and settings.
It can control many devices supported by built-in INDIGO drivers or it can use any 3rd party remote INDIGO or INDI driver. Out-of-the-box it contains INDIGO drivers for the following cameras, filter wheels and focusers:
- CCD, focuser and wheel simulator drivers,
- Atik CCD and wheel drivers,
- ZWO ASI CCD, wheel and focuser drivers (doesn't work with non-S ASI120MM/MC),
- IIDC CCD driver (both USB and FireWire cameras),
- QHY CCD and filter wheel drivers,
- SBIG CCD and filter wheel driver (vendor SDK must be installed),
- Meade DSI CCD driver,
- Orion SSAG/QHY5 CCD driver,
- StarlightXpress CCD and wheel drivers,
- QSI CCD and wheel driver,
- FLI CCD and wheel driver,
- Apogee CCD driver,
- Moravian Instruments CCD and wheel driver,
- ToupTek CCD driver,
- AltairAstro CCD driver,
- UVC (USB Video Class, e.g. SVBONY SV205) CCD driver,
- Trutek (TruTech) wheel driver (untested),
- Brightstar Quantum wheel driver (untested),
- Xagyl wheel driver (untested),
- Optec wheel driver (untested),
- Manual filter wheel driver,
- Shoestring FCUSB driver,
- Focuser USB v3 driver,
- WeMacro Rail USB and BT drivers,
- MJKZZ macro rail USB and BT drivers,
- PegasusAstro DMFC and FlatMaster drivers,
- RigelSys nSTEP and nFOCUS drives,
- MoonLite focuser driver,
- Optec focuser driver (untested),
- LakesideAstro focuser driver (untested),
- Deep Sky Dad AF1, AF2 and AF3 focuser driver,
- Baader Planetarium SteelDrive II focuser driver,
- AstroGadget FocusDreamPro focuser driver,
- Lunatico Limpet/Armadillo/Platypus Focuser/Powerbox drivers,
- PlaneWave/Celestron focuser driver,
- Unihedron SQM sky quality meter driver,
- Artesky flatbox driver,
- Lacerta Flat Box Controller driver,
- Optec Flip-Flat driver,
- USB_Dewpoint V1 and V2 driver,
- Lunatico AAG CloudWatcher driver,
- Astromi.ch MGBox v1/v2, MBox, MGPBox and PBox driver.
To use Atik cameras, make sure that ArtemisHscService is not running (installed e.g. as a part of Nebulosity4 or TheSkyX).
What's new in version 3.14
- INDIGO framework updated to 2.0.124.
What's new in version 3.13
- INDIGO framework updated to 2.0.113.
What's new in version 3.12
- Deep Sky Dad AF1/AF2 focuser driver added,
- Baader Planetarium SteelDrive II focuser driver added,
- Unihedron SQM sky quality meter driver added,
- PegasusAstro Pocket Powerbox driver added,
- Artesky flatbox driver added,
- Pegasus Astro FlatMaster driver added,
- PTP-over-USB driver added,
- USB devpoint driver added,
- INDIGO framework updated to 2.0.112.
What's new in version 3.11
- INDIGO framework updated to 2.0.88.
What's new in version 3.10
- dashboard/control panel widget for guiding stats added,
- INDIGO framework updated to 2.0.87.
What's new in version 3.9
- INDIGO framework updated to 2.0.85,
- new embedded control panel,
- Horizon support added to Atik driver,
- ZWO ASI focuser driver added,
- streaming preferences are ignored if exposure time is longer than 1s or time lapse is used.
What's new in version 3.8
- INDIGO framework updated to 2.0.76,
- TIFF output format added,
- Issue with USB devices on pre-Mojave systems fixed.
What's new in version 3.7
- OS X 10.10 compatibility fixed.
What's new in version 3.6
- INDIGO framework updated to 2.0.75,
- auxiliary device panel added,
- PegasusAstro Ultimate Powerbox driver added,
- AltairAstro and ToupTek driver added,
- more Mojave dark appearance cleanup.
What's new in version 3.5
- INDIGO framework updated to 2.0.74,
- Microtouch, Moonlite, NFocus/NStep, WeMacro and MJKZZ focuser driver added,
- Quantum, Optec, TruTek and Xagyl wheel driver added,
- Mojave dark appearance support added.
What's new in version 3.4
- INDIGO framework updated to 2.0.73,
- Moravian Instruments CCD driver added,
- high speed/low noise mode can be used (if driver supports it),
- legacy modes support added for IIDC cameras.
What's new in version 3.3
- INDIGO framework updated to 2.0.68,
- list of manually added INDIGO services is persistent now.
What's new in version 3.2
To see a new video tutorial, please visit https://youtu.be/XNqRq6QZ7Hs
- Sequencer gain/gamma issue fixed.
- INDIGO framework updated to 2.0.67.
What's new in version 3.1
- ArtemisHSCService detection added,
- ZWO ASI EFW issues fixed,
- ZWO ASI SDK updated to 0.7.0118 and
- INDIGO framework updated to 2.0.65.
What's new in version 3.0
- driver stack and INDI support are completely reimplemented and replaced by INDIGO framework,
- embedded INDIGO control panel added,
- streaming is supported fast cameras (ASI and IIDC),
- SER lossless video format support is added and
- FITS based imaging component is replaced by more generic one accepting JPEG and various raw formats as well.
Please note, that AstroImager contains many INDIGO drivers, but none of them is loaded by default. To enable the driver you actually need, select it on Preferences → INDIGO Drivers pane. You may need to scroll down to find some of them.
Initial setup and preferences
When AstroImager is started for the first time or when button in toolbar is clicked, preferences panel is shown. It has four different panes. On the first one there are general settings and the rest is related to INDIGO framework.
If Use streaming mode... option is selected, CCD driver will be instructed to use more effective streaming in INDIGO raw format instead of FITS. Unless you can further process raw images, use it only if you want save captured images into video instead of separate files. You can select video format in Output format list. Use dithering... and Suspend guiding... options affect only communication with AstroGuider application, otherwise are ignored. Aperture and Focal length values are used only by Bahtinov Mask Helper, otherwise are ignored.
Port number, Bonjour service name and Bonjour service type are parameters for configuration of internal INDIGO server. Do not change them unless you understand how INDIGO works. If something will go wrong you can try to set Log level to debug or trace to see more verbose output from INDIGO framework.
AstroImager will connect to any INDIGO server in the local network automatically, but if you want to configure connection to a service without Bonjour support (e.g. linux based INDI server or INDIGO server outside local network), you can do it on INDIGO Services pane.
Camera panel, operations and state
On the camera panel you can select an active camera and configure parameters for its driver:
- frame type,
- camera mode,
- cooler state and/or temperature settings,
- gain and
Frame type is optionally encoded into image name and also into FITS metadata, otherwise is not used with the exception of dark frame type on cameras with mechanical shutter.
Camera mode represents binning, colour mode and/or bits/pixel settings of the camera.
Not every parameter can be configured for every device (e.g. Gain or Gamma) and not every parameter can be configured from the camera panel (e.g. advanced or device specific parameters). For these parameters you need to use INDIGO or INDI control panel instead while AstroImager is running and device is connected. Make sure that you saved the configuration before closing control panel (configuration control property in main group).
The camera related operations represented by the toolbar buttons are:
- capture and display single frame,
- set/clear capture and display single frame (select rectangle on the image to set or clear subframe),
- capture and display frames in endless loop,
- capture and save batch of images (it will ask to select the folder first) and
- stop all captures.
The buttons are enabled only if camera is selected.
In the status bar there are two groups of indicators related to the active camera. The first one, in the middle, shows remaining time of capture or timelapse and a current FPS. The second one, on the right, shows current cooler power and current temperature.
Filter wheel panel
On the filter wheel panel you can select an active wheel and select filter to use.
Filter names are provided by the driver, if you want to change them, use INDIGO or INDI control panel while AstroImager is running and device is connected. Make sure that you saved the configuration before closing control panel (configuration control property in main group).
Filter name is optionally encoded into image name and also into FITS metadata.
Focuser panel, operations and state
On the focuser panel you can select an active focuser and configure parameters for its driver:
- focuser speed,
- step size,
- backlash and
- initial and step final for autofocus routine.
Variable speed is not supported by all focusers and also step size meaning may differ. For focusers with stepper motor it is number of steps while for focusers with DC motors it is duration in milliseconds.
The focuser related operations represented by the toolbar buttons are:
- focus in,
- focus out and
- stop focuser.
If step size is greater than zero, focuser is in stepper mode and will move in or out specified number of steps or milliseconds every time focus in or focus out button is clicked. If step size is equal to zero, focuser is in timed mode and will move in or out while focus in or focus out button is pressed. Timed mode is not supported by all focusers.
Autofocus is enabled only if camera captures frames in endless loop and if star is selected. Autofocus routine tries to focus in and out until quality of focus based on FWHM, HFD and peak value of selected star improves. It starts with initial step size and every time it switches the direction, it reduces step size to 1/2 of current value and continues until it reaches final step size.
In the status bar there is an indicator which shows the current position and temperature if they are reported by the focuser.
Batch panel, operations and state
On the batch panel you can configure parameters for capture of simple series of images:
- timelapse between shots,
- frame count and
- base image file name.
Depending on preference settins the duration, filter name, mode or temperature can be encoded into file name. AstroImager never overwrites existing file, instead sequence number is increased.
The batch related operations represented by the toolbar buttons are:
- previous image in the batch (it will load previous image into preview panel),
- show in finder and
- next image in the batch (it will load next image into preview panel).
Image, histogram, detail and PSF panels
Image preview panel shows the last image captured by the camera, image loaded by previous or next image in the batch operation or image loaded by View → Load image... operation.
If you move the mouse cursor over the image, coordinates and intensity or RGB values are shown in status bar.
If you click the position in the image, the nearest star is found and selected (marked by the green cross). This position is also used to display enlarged detail of the image, for PSF (point spread function) approximations and drift measurement.
In the histogram panel (top right) you can see among histogram in logarithmic scale, size of the image and some statistical data. Below the histogram there are sliders and steppers for setting black and white point for image stretching and also button to set the component into automatic mode.
In the image detail panel (middle right) there is magnified surrounding of the star selected in the image preview panel. Green cross marks the computed centroid, blue circle FWHM (full width at half maximum) and red circle HFD (half-flux diameter) of the selected star.
In the PSF panel there are graphs of changes of FWHM, HFD, peak and background values and also their current values.
The image preview related operations are represented by two toolbar button groups. In zoom settings group there is
- zoom in,
- zoom to full size,
- zoom to fit and
- zoom out.
- do not debayer (the only option for colour images),
- RGGB mask,
- GRGB mask,
- GBRG mask and
- BGGR mask.
Other operations related to preview panel and available from view menu are load image, show/hide crosshair reticle, set/remove guide lines #1 and set/remove guide lines #2. To set/remove guide lines select or deselect (by right mouse click) star and select operation from the menu. The setting is persistent, so you can use it to align current view with some another image.
Drift measurement helper panel
For polar alignment by the drift method or for the validation of the guiding you can use drift measurement helper panel.
The scale of the graph is adjusted automatically. Blue curve represents drift in X and red curve in Y direction. Blue value in lower left corner is drift per image in X direction and red value in lower right corner is drift per image in Y direction.
To use the panel for polar alignment, rotate camera (to align RA/Dec axes along X/Y directions), start preview in endless loop, select accordingly bright star and use drift method.
Please note, that the graph is cleared every time you select the star in the preview image.
Bahtinov focusing helper panel
AstroImager can help you to focus faster and more reliably with Bahtinov mask focusing aid.
To use it just point your telescope to some bright star, put the mask on, open helper panel and select rectangle by the mouse over the captured image in preview panel to center the diffraction pattern in the panel view. Once centered, two blue and one red (not properly focused) or green (properly focused) line will appear and show the intersection of diffraction spikes.
Telescope is properly focused when the focus error is within critical focus zone. Due to limitation of the line detection algorithm make sure, that each diffraction spike is always crossing the opposite sides of the frame.
Please note, that telescope focal length and aperture needs to be set in preferences to calculate the focus error and the critical focus zone.
AstroImager can be used to capture sophisticated sequences of images, each batch with different duration, time lapse time, image count, base file name, binning and filter.
Whole sequence can be repeated to allow both RRRGGGBBB and RGBRGBRGB approaches. To use it, open Sequencer panel enter required parameters (or leave them empty for use the values from the previous batch or current settings, only selected lines of the table will be used) and click Execute button.
Sequence execution will continue in the background even if panel is hidden until finished or aborted.
Please note, that the camera related fields in sequencer panels are available only if camera is selected and filter wheel related fields are available only if wheel is selected.
Plate solver panel
AstroImager uses astrometry.net package for the plate solving. You can use either the public one on the http://nova.astrometry.net over web services (the easy but quite slow way) or your private installation of Astrometry for OS X (GUI and web service wrapper around OS X astrometry.net port is available from our web).
Use local service option is available only if Astrometry for OS X is installed and running. Make sure, that you have correct indexes downloaded for your imaging setup resolution.
To use public service, open Image solver panel by clicking Solve toolbar button while some image preview is shown. Enter the service URL (e.g. http://nova.astrometry.net) and API key (both are remembered and need not to be entered every time) and click Solve button. If your API key is successfully authenticated, image is uploaded and solving job successfully finished, the lower four fields contains RA and Dec coordinates of the center of the image, the image orientation and the image pixel scale.
If you are running also AstroTelescope on the same machine or somewhere in the local network, you can use Sync button to sync the telescope mount with the computed image center position.
Plate solving job will continue even if Image solver panel is hidden until aborted.
Please note, that unless you have your own Astrometry for OS X installation, this function uses 3rd party service, needs the Internet connection and its availability is out of our control.
In control panel you can manage all properties of all devices hosted by local INDIGO bus.
To change property, navigate in device / Group / Property tree, enter new values of the items (changed values became red) and click Set.
If you want AstroImager to use changed values on the next start, save configuration in "Configuration control" property in "Main" group of the device. You can also set particular profile in "Profile selection" property first.
AstroImager device represents AstroImager itself and can be used by scripting tools etc.
Please note, that embedded control panel can be used only to control local devices. To access remote devices you need full featured INDIGO Control panel.
As far as AstroImager is based on INDIGO, it can natively use distributed setup, e.g. to control device driver running within other application or on another machine. INDIGO uses bonjour service discovery, so you don't need to configure anything while both AstroImager and the remote server are running on machines connected to the same local network. Otherwise you need to add hostname and port of INDIGO service to the list at INDIGO Services tab in Preferences.
Typical example of distributed setup is INDIGO server running on RaspberryPI controlling mount and cameras in the observatory or your backyard, while AstroImager runs on Mac computer somewhere in warm room. Another example is INDI driver executed by AstroImager as external driver (in this case INDI driver itself acts as a server, just communicating over pipes instead of the network).
You can download INDIGO for various linux platforms (including INDIGO server and device drivers) from www.indigo-astronomy.org. If you want to use Mac computer as remote server, you can use INDIGO Server for macOS.
Device detected by remote servers appears in the list of available devices the same way as local device, just with '@ server' suffix in the name (e.g. 'Titan @ rpi.local').
To setup properties of local or remote devices not managed directly by AstroImager (e.g. filter names, serial port device names etc.) you can use INDIGO Control Panel. Remember to save the configuration of the device driver (each device has Options section with Configuration page).
Optional INDI Server for macOS
If your device isn't supported by INDIGO, but has INDI driver ported to Mac computers, you can use it with optional INDI Server for OS X. These drivers can’t be bundled with AstroImager due to GPL license, but you can download and install them yourself.
Source code of these drivers is available from INDI github repository.
Please contact us at email@example.com or bb.cloudmakers.eu.