DragScript Elements

From Voyager Unofficial Wiki
Revision as of 08:46, 18 August 2019 by Rowland (talk | contribs) (Dome: Unpark command)
Jump to: navigation, search

The DragScript "language" is composed of blocks that are dragged from the list on the right side of the DragScript editor to the script being created or edited on the left.

Each category of element is organized in list that can be expanded or contracted by clicking the "+" or "-" next to the element category name:

Dragscript-editor-elements.png

E.g., if you click the + in front of Actions, the list expands like this:

List-expanded.png

As you can see in the case of Actions, there are further subcategories of actions, and clicking the + in front of one of them expands it again:

Subcategory-expanded.png

Here, the list of Setup actions is fully expanded and we see three choices that we can drag to the active script: Connect Setup, Connect Setup with Timeout, and Disconnect Setup

For the remainder of this page, we will describe the available DragScript elements. New elements are added periodically and will be documented in the release notes and here.

DragScript Actions

Operating System

The Operating System actions control the PC running Voyager:

DSopOs.png

  • Shutdown PC: Shutdown the PC running Voyager
  • Restart PC: Restart (reboot) the PC running Voyager
  • Kill Process: Kill a process on the PC running Voyager. Either type in the Process name or click one of the buttons to use a preconfigured process name.

Kill-process.png


Setup

Setup actions control connecting and disconnecting to your equipment and software:

Dragscript-setup-2.14c.png

  • Connect Setup: Commands Voyager to connect to the equipment and software in the currently selected Profile
  • Connect Setup with Timeout: Command Voyager to connect to the equipment in the currently selected Profile. Voyager will timeout if connection does not complete within the specified number of seconds:

Setup-timeout.png

  • Disconnect Setup: Command Voyager to disconnect from the equipment and software in the currently selected Profile
  • Connect Safety Monitor Control: Connect only the Safety Monitor control. This is useful for monitoring conditions prior to connecting all your equipment
  • Disconnect Safety Monitor Control: Disconnect only the Safety Monitor control


Session

Session actions run sequences to acquire images, flat frames, and shutdown ("Good Night") your system:

Session-script.png

Dragscript-sequence-211g.jpg

  • Configuration Panel:
  • TYPO: Star/TimeSpan should be Start/TimeSpan
    • Start/TimeSpan: Click one of the radio buttons to use that option to tell when to start and end the sequence. This is one way to have Voyager image this target until a specific time is reached, or an interval has elapsed. It is a good idea to specify an ending time here, or a minimum altitude in the Sequence definition or the Options field below, so Voyager will not continue trying to take images after the object has set
      • Start and End from Sequence: Use the start and end times specified in the sequence definition file. The start time comes from the On Start tab and the end time comes from the On End tab
      • Immediately Start and Finish After Interval: Start the sequence immediately and end it after the HH:MM:SS amount of time specified with the Time Span: counter fields
      • Start and End at Absolute Time: Voyager should wait until the specified Start: time and end the sequence at the specified End: time.
      • Immediately Start and End at Absolute Time: Start the sequence immediately and end it at the time specified in the counter fields
      • Immediately Start and Finish With Astronomical Night: Start the sequence immediately and finish it at Astronomical Night's end, offset +/- by the number of minutes set in the Offset: counter field
  • Calculated Time Span: Voyager will show how much time this sequence will take with the chosen Start/TimeSpan option if you choose Start and End at Absolute time. It is not possible to calculate this if you choose one of the "Immediately Start" options


Important Note! Enter time in 24 hour format using local time - or the time zone on the computer running Voyager. That's the time that will be used in doing these calculations. Midnight is 00:00:00. 10 pm local time is 22:00:00. 3 AM is 03:00:00.


Important Note! Note: If the Start: time is more than 12 hours in the future, Voyager will start the sequence, assuming that the start time has passed already in the current night. For example, if you specify a start time of 20:00:00 and it is now 20:15:00, Voyager will start the sequence


Important Note! If the End time is more than 12 hours in the future, Voyager will assume the End time has already passed for the night and end the sequence. For example, if a sequence has a Start time of 20:00:00 and an End time of 21:00:00 and the current time is 22:00:00, Voyager will end the sequence


Important Note! Times entered here will override any start or end times defined in the Sequence file. The times you define when you create the sequence are used for OnTheFly running of the Sequence, not for DragScript execution


Important Note! The Start and End times are checked at the beginning of running a sequence and the sequence exits with status OK if the current time is outside the Start and End time window
    • Options: Check the boxes to select any of these options:
      • Overrides Target Coords J2000: If checked, the RA and DEC coordinates are used instead of those in the sequence file. RA coordinates are in HH MM SS and DEC coordinates are HH MM SS.sss
      • Overrides Target Name with this: If checked, the name entered in the field will be used as the target name, which is part of the file name
      • Finish Running Exposure in case of elapsed time for Sequence Execution: If checked, an exposure in progress will be allowed to finish if it starts before the sequence end time but finishes after the sequence end time
      • Override Lower Altitude value under which Exit from Sequence: If checked, if the sequence target sets below the altitude given here, the sequence will end. This value will override the minimum altitude value chosen in the sequence file
      • Override Higher Altitude value above which Exit from Sequence: If checked, if the sequence target rises above the altitude given here, the sequence will end. This value will override the maximum altitude value chosen in the sequence file
    • Default: Click this button to populate this window with the default options
    • OK: Click to save your changes and close the window
    • Cancel: Click to discard your changes and close the window
  • Research & Survey: Run a Research & Survey sequence with options

Research-survey-dragscript.png

  • Configuration Panel:
    • Click the folder icon Folder-icon.png to select the Research & Survey sequence file to run. Create your sequence files in Voyager's Research & Survey workspace
    • TYPO: Star/TimeSpan should be Start/TimeSpan
    • Start/TimeSpan: Click one of the radio buttons to use that option to tell when to start and end the Research & Survey sequence. This is one way to have Voyager image this target until a specific time is reached, or an interval has elapsed. It is a good idea to specify an ending time here, or a minimum altitude in the Research & Survey sequence definition or the Options field below, so Voyager will not continue trying to take images after the object has set
      • Immediately Start and Finish After Interval: Start the sequence immediately and end it after the HH:MM:SS amount of time specified with the Time Span: counter fields
      • Start and End at Absolute Time: Voyager should wait until the specified Start: time and end the sequence at the specified End: time.
      • Immediately Start and End at Absolute Time: Start the sequence immediately and end it at the time specified in the counter fields
    • Calculated Time Span: Voyager will show how much time this sequence will take with the chosen Start/TimeSpan option if you choose Start and End at Absolute time. It is not possible to calculate this if you choose one of the "Immediately Start" options
  • Options:
    • Finish Running Exposure in case of elapsed time for Sequence Execution: If checked, an exposure in progress will be allowed to finish if it starts before the sequence end time but finishes after the sequence end time
    • Default: Click this button to populate this window with the default options
    • OK: Click to save your changes and close the window
    • Cancel: Click to discard your changes and close the window


Important Note! See the Important Notes above in the Sequence discussion to understand how Voyager treats the values in the time fields when they have already passed in tonight's session or if they are also specified in the Research & Survey sequence definition file

Flat-sequence-dragscript.png

  • Click the folder icon Folder-icon.png and choose the Auto Flat sequence file to run. Configure the Auto Flat sequence files in the OnTheFly workspace
  • TYPO: Configuration dialog says "Good Night" but should be Auto Flat
  • Default: Click this button to populate this window with the default options (blanks out the Flat Sequence File field)
  • OK: Click to save your changes and close the window
  • Cancel: Click to discard your changes and close the window


  • Good Night: Run a series of one or more shutdown actions:

Dragscript-good-night.png

  • CCD Filter Select: Moves the filter wheel to the filter chosen from the drop-down box on the right
  • Sync Warmup: Send the CCD cooler a warmup command and wait until it finishes
  • Async Warmup: Send the CCD cooler a warmup command and continue execution without waiting for it to finish
  • Parking: Park the mount as specified in Mount Setup


Plate Solving

Plate Solving actions perform a plate solving action as defined in the Plate Solving setup of the active profile:

Dragscript-plate-solving.png

  • Web Solving with Sync: Perform a plate solve action at the current scope location using the nova.astrometry.net site. An active Internet connection is required. Send a Sync command to the mount unless you have chosen to not send a Sync command to your mount in Mount Setup

Web-solving-with-sync.png

  • Timeout: Specify the number of minutes Voyager should wait after initiating the Web Solve before timing out. Use an IF TIMEOUT decision action to define what to do if the web solve times out


  • Blind Solving with Sync: Perform a blind solve action at the current scope location using the Blind Solve software defined in the Plate Solving setup of the active profile. Send a Sync command to the mount unless you have chosen to not send a Sync command to your mount in Mount Setup


  • Plate Solving with Sync: Perform a plate solve action at the current scope location using the Plate Solve software defined in the Plate Solving setup of the active profile. Send a Sync command to the mount unless you have chosen to not send a Sync command to your mount in Mount Setup


Guiding

Guiding actions send commands to the guide software:

Dragscript-guiding-dithering.png

  • Calibrate Guide: Command the guide software to perform a calibration action. It is recommended to include a Calibrate Guide action at the start of your sequence unless you are sure that your guider is calibrated from a previous session. Double click to bring up the configuration window:

Dragscript-calibrate-guide.png

  • Time: Exposure time for Calibration exposures by the guiding software
  • Binning: Binning level for Calibration exposures by the guiding software
  • Use RoboGuide Star Selection: If selected, use Voyager's RoboGuide process to choose a guide star for the Calibration action. This is mandatory at this time since some guiding software cannot select a guide star.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Acquiring Guide Star: Commands the guiding software to select a guide star. Double click to bring up the configuration window:

Dragscript-acquire-guide-star.png

  • Time: Exposure time for guide star acquisition exposures by the guiding software
  • Binning: Binning level for guide star acquisition exposures by the guiding software
  • Use RoboGuide Star Selection: If selected, use Voyager's RoboGuide process to choose a guide star. This is mandatory at this time since some guiding software cannot select a guide star.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Guide Start: Commands the guiding software to begin guiding. Double click to bring up the configuration window:

Dragscript-guide-start.png

  • Time: Exposure time for guiding exposures by the guiding software
  • Binning: Binning level for guiding exposures by the guiding software
  • Use RoboGuide Star Selection: If selected, use Voyager's RoboGuide process to choose a guide star. This is mandatory at this time since some guiding software cannot select a guide star.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Guide Stop: Command the guiding software to stop guiding


  • Guide Dithering: Command the guiding software to perform a dithering action. Dithering is used to move the mount a tiny random amount in a random direction - usually only a couple of pixels. This prevents hot or cold pixels in your sensor from showing up in the same position in all of your images, making it easier to remove hot or cold pixels when stacking your images. Double click to bring up the configuration window:

Dragscript-guide-dithering.png

  • Max Pixel: Specify the maximum number of pixels that a dithering operation can move the mount
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window
  • Unguided Dithering: Perform a dithering action directly, vs. Guide Dithering which sends a dithering command to the guide software. Dithering is used to move the mount a tiny random amount in a random direction - usually only a couple of pixels. This prevents hot or cold pixels in your sensor from showing up in the same position in all of your images, making it easier to remove hot or cold pixels when stacking your images.

Unguided-dither-3.png

  • Max Pixel: Specify the maximum number of pixels that a dithering operation can move the mount
  • From Actual Position: This is the safest and default choice - it sends a command to move the mount up to the specified number of pixels from the current position. This should be a small movement, as the recommended number of pixels to dither is 3
  • From Last Goto Action Position: Send a command to move the mount a random number of pixels up to Max Pixel in a random direction relative to the position of the last Goto action. This should only be used following a successful Goto action in your DragScript. You can damage your mount if you use this without a successful Goto action preceding it.
  • From Last Precision Pointing Action Position: Send a command to move the mount a random number of pixels up to Max Pixel in a random direction relative to the position of the last Precision Pointing action. This should only be used following a successful Precision Pointing action in your DragScript. You can damage your mount if you use this without a successful Precision Pointing action preceding it.
  • Use Actual Position on Empty/Fail condition: If checked, if the position reported by the Last Goto Action or Last Precision Pointing Action is empty, or if the Last Goto Action or Last Precision Pointing Action ended with an error, use the Actual Position of the mount as the starting point for dithering. In other words, don't attempt to dither based on the Last Goto action position or the Last Precision Pointing action position if either of those positions is empty, as this would send a command to the mount that could cause a pier crash and/or damage to your equipment. Highly recommend leaving this checked.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


Mount

Mount actions send commands to the mount defined in the Mount setup of the active profile:

Dragscript-mount.png

  • Stop Tracking: Command the mount to stop tracking
  • Start Tracking: Command the mount to start tracking
  • Parking: Command the mount to slew to the Park position
  • Unparking: Command the mount to Unpark
  • Sync on Park: Command the mount to save the current position as the Park position
  • Homing: Command the mount to move to the Home position
  • Goto RA/DEC: Command the mount to move to the specified RA and DEC coordinates (J2000)

Dragscript-gotoradec.png

  • RA J2000: Enter the RA coordinates in HH MM SS or HH MM SS.sss
  • DEC J2000: Enter the RA coordinates in DD MM SS or DD MM SS.sss
  • Default: Use the default settings: clears the RA and DEC fields
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Goto ALT/AZ: Command the mount to move to the specified Altitude and Azimuth coordinates

Goto-altaz.png

  • ALT: Enter the Altitude coordinates in DD MM SS or DD MM SS.sss
  • AZ: Enter the Azimuth coordinates in DD MM SS or DD MM SS.sss
  • Force Use of Normal RA/DEC Slew With Conversion: If checked, convert the requested ALT and AZ values to RA and DEC values and send a goto RA/DEC command to the mount
  • Default: Use the default settings: clears the AZ and ALT fields
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Goto Near Zenith: Command the mount to move to a point close to the current Zenith (directly overhead).
Important Note! Goto Near Zenith followed by a Blind Solving with Sync action is a good way to initialize your mount's pointing model at the start of a session. It is only a single point, but if your mount is accurately polar aligned, doing this before the first Precise Pointing operation may helps the Precise Pointing to succeed
  • Goto By Name: Command the mount to move to an object by name with an optional RA and DEC offset. This action requires Voyager to be connected to the Planetarium software defined in the current profile. The Object Name must match a name that can be successfully searched in the connected Planetarium software.

Dragscript-gotoname.png

  • Object Name: Name of the object to goto. Must be a name that can be successfully searched in the connected Planetarium software
  • Offset RA (optional): An optional +/- offset in HH MM SS or HH MM SS.sss to be added or subtracted from the RA coordinates returned by the Planetarium software
  • Offset DEC (optional): An optional +/- offset in DD MM SS or DD MM SS.sss to be added or subtracted from the DEC coordinates returned by the Planetarium software


  • Precise Pointing: Command the mount to perform a precise pointing operation to the specified RA/DEC coordinates - slew to the object, plate solve to get actual coordinates, re-slew to correct pointing error:

Dragscript-precisepointing.png

  • RA J2000: Enter the RA coordinates in HH MM SS or HH MM SS.sss
  • DEC J2000: Enter the DEC coordinates in DD MM SS or DD MM SS.sss
  • Max Error using Multiple of Profile Error by: If selected, multiply the maximum allowed pointing error by the number specified in the counter field. E.g., if the Precision Pointing Max Allowed Error specified in Mount Setup is 50 arc-seconds, a value of 2 in the counter field here would change the maximum pointing error to 100 arc-seconds. Precise pointing returns an OK (success) result when the error is less than the Max Error.
  • Max Error is: If selected, use the value specified in the counter field as the maximum pointing error in arc-seconds. Precise pointing returns an OK (success) result when the error is less than the Max Error.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Precise Pointing by Name: Command the mount to perform a precise pointing operation to the specified named object - slew to the object, plate solve to get actual coordinates, re-slew to correct pointing error. This action requires Voyager to be connected to the Planetarium software defined in the current profile. The Object Name must match a name that can be successfully searched in the connected Planetarium software.

Dragscript-precisepointing-name.png

  • Object Name: Name of the object to goto. Must be a name that can be successfully searched in the connected Planetarium software
  • Offset RA (optional): An optional +/- offset in HH MM SS or HH MM SS.sss to be added or subtracted from the RA coordinates returned by the Planetarium software
  • Offset DEC (optional): An optional +/- offset in DD MM SS or DD MM SS.sss to be added or subtracted from the DEC coordinates returned by the Planetarium software
  • Max Error using Multiple of Profile Error by: If selected, multiply the maximum allowed pointing error by the number specified in the counter field. E.g., if the Precision Pointing Max Allowed Error specified in Mount Setup is 50 arc-seconds, a value of 2 in the counter field here would change the maximum pointing error to 100 arc-seconds. Precise pointing returns an OK (success) result when the error is less than the Max Error.
  • Max Error is: If selected, use the value specified in the counter field as the maximum pointing error in arc-seconds. Precise pointing returns an OK (success) result when the error is less than the Max Error.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Stop Tracking (Only FS2 Mount): Command an FS2 mount to stop tracking
  • Start Tracking (Only FS2 Mount): Command an FS2 mount to start tracking
  • FS2 Meridian Flip WEST: Command an FS2 mount to perform a meridian flip to the West
  • FS2 Meridian Flip EAST: Command an FS2 mount to perform a meridian flip to the East
    Important Note! The FS2 Mount commands should only be used if your mount is controlled by the Astro Electronic FS2 motor control system. Using these commands with other mounts may fail and cause damage to the mount and other equipment

Dome

Dome actions send commands to the dome defined in the Dome Setup area of the active profile:

Dragscript-dome-217d.jpg

  • Open Shutter: Command the dome's shutter or the observatory's roll-off roof to open
  • Close Shutter: Command the dome's shutter or the observatory's roll-off roof to close
  • Dome Slave ON: Send a command to the dome software to "Slave" to the mount. The dome's azimuth position will track with the mount's movements in azimuth
  • Dome Slave OFF: Send a command to the dome software to turn off "Slave" to the mount. The dome's azimuth position will stop tracking the mount's azimuth movements
  • Dome Goto Azimuth: Command the Dome to rotate to the specified Azimuth

Dragscript-dome-az.png

  • Azimuth: Azimuth position the mount should move to in degrees
  • Cancel: Discard changes and close the window
  • OK: Save changes and close the window


  • Dome Find Home: Command the dome to find its Home position. If your dome supports the Find Home command, the dome moves to a known position
  • Dome Park: Send a Park command to the dome.
  • Dome Unpark: Send an Unpark command to the dome


Camera

Camera actions can control the camera's cooling system and take exposures

Dragscript-camera.png

  • Cool Down: Command the camera's cooling system to cool down to a desired temperature:

Dragscript-cooldown.png

  • Final Temperature: Desired sensor temperature in °C
  • Async Cooling: If checked, command the cooling system to go to the Final Temperature and do not wait for the cooling system to report that it has reached the desired temperature
  • Use CCD Firmware Cooldown: If selected, let the CCD's cooling system manage the speed of the cooldown process
  • Use Voyager Ramp Mode Cooldown: If selected, let Voyager's cooldown process manage the speed of the cooldown process. Voyager's process is defined in Camera Setup
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Warmup: Command the camera's cooling system to warmup

Dragscript-warmup.png

  • Async Cooling: If checked, command the camera's cooling system to warmup and do not wait for the warmup operation to finish
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Expose: Take an exposure

Dragscript-expose-216d.jpg

  • Exposure Type: Choose Light, Bias, Dark or Flat from the drop-down list
  • Filter Index: Choose the filter for the exposure from the drop-down list
  • Expose: Enter the exposure length in seconds in the counter field
  • Binning: Select the binning level for the exposure from the counter field
  • SubFrame: Select the frame size from the drop-down list: Full Frame, 1/2, 1/4, 1/8, 1/16 or CUSTOM. If you select CUSTOM subframe size, enter the desired subframe size in percent in the counter field that appears
  • Gain: Set the camera's Gain value to the number in the spinner control. Works only if you are using the ASI Camera native driver.
  • Offset: Set the camera's Offset value to the number in the spinner control. Works only if you are using the ASI Camera native driver.
  • File Directory: Click the folder icon to select the folder where Voyager should save the image resulting from this exposure
  • File Name: Enter the file name to use when saving the image resulting from this exposure
  • Make Unique File Name: If checked, add a suffix to the file name if needed to avoid overwriting an existing file
  • FIT Object Name: The name to use to populate the OBJECT field in the FITS header
  • FIT Airmass calculation: Compute the current airmass value and add to the FITS file header. Airmass is the amount of atmosphere you are imaging through. It is one when imaging directly overhead, and increases as you image closer to the horizon.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


Important Note! Filter labels are shown in this dialog if the DragScript editor is opened from Voyager and filter labels are defined in the current profile. Otherwise only filter indexes are shown. The first filter is index zero (0)


AutoFocus

These DragScript commands perform Voyager's autofocus operations:

Dragscript-autofocus.png

  • AutoFocus with RoboStar: perform an autofocus operation using Voyager's RoboStar method to choose the focus star:

Dragscript-autofocus-robostar.png

  • Monochromatic Camera: Select if a monochrome camera is connected. Select a filter to use for the autofocus operation from the drop-down list
  • DSLR/Color Camera: Select if a DSLR or Color (OSC) camera is connected
  • No Filter: Select if a monochrome camera is connected without filters
  • Use Low Precision Pointing: If checked, Voyager's RoboStar operation will slew to the focus star with a more relaxed precision pointing operation. Specify the multiple for the maximum allowed precision pointing error in the counter field. E.g., if the precision pointing max allowed error configured in Mount Setup is 50 arc-seconds, a "Multiple Max Allowed Error by" setting of two would relax the maximum allowed pointing error to 100 arc-seconds
  • AutoFocus OnPlace: Perform the autofocus operation at the current scope location. Do not use RoboStar to select a focus star
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Precise Pointing RoboStar Star: Perform a precise pointing operation to move the mount to the focus star selected by RoboStar:

Dragscript-precisepointing-robostar.png

  • Monochromatic Camera: Select if a monochrome camera is connected. Select a filter to use for the precise pointing operation from the drop-down list
  • DSLR/Color Camera: Select if a DSLR or Color (OSC) camera is connected
  • No Filter: Select if a monochrome camera is connected without filters
  • Use Low Precision Pointing: If checked, Voyager will slew to the focus star with a more relaxed precision pointing operation. Specify the multiple for the maximum allowed precision pointing error in the counter field. E.g., if the precision pointing max allowed error configured in Mount Setup is 50 arc-seconds, a "Multiple Max Allowed Error by" setting of two would relax the maximum allowed pointing error to 100 arc-seconds
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • RoboFire Focuser Move To: Move the focuser to a specified absolute or relative position:

Dragscript-robomove.png

  • Position: Desired focuser position in steps
  • Mode: Choose absolute or relative
    • Absolute: Command the focuser to move to the specified position. Your focuser must support absolute positioning.
    • Relative: Command the focuser to move in or out by the specified number of steps. Negative numbers move the focuser IN and positive move it out, unless you specify "Reverse Focuser Direction" in Autofocus Setup
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • AutoFocus with RoboFire LocalField: Perform Voyager's LocalField (multiple star) autofocus routine

Dragscript-localfield.png

  • Monochromatic Camera: Select if a monochrome camera is connected. Select a filter to use for the precise pointing operation from the drop-down list
  • DSLR/Color Camera: Select if a DSLR or Color (OSC) camera is connected
  • No Filter: Select if a monochrome camera is connected without filters
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


Rotator

Rotator actions can move the rotator to a specified Position Angle or flip the rotator 180 degrees:

Dragscript-rotator.png

  • Rotator Move To: Move the rotator to the specified position angle in degrees

Dragscript-rotatormove.png

  • PA: Move the rotator to this Position Angle in degrees
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Rotator 180° Flip: Move the rotator to a position 180 degrees opposite its current position


Flat Device

Flat Device commands can open and close the flat device cover:

Dragscript-flat-device.jpg

  • Open Flat Device Cover: Command the flat device to open
  • Close Flat Device Cover: Command the flat device to close
  • Switch On Light Flat Device: Turn the light on for the specified Flat Device

Dragscript-switch-on-flat-device.jpg

  • Device ID: Choose the Flat Device number to control with this command. See Flat Device Setup for more information on flat devices.


  • Switch Off Light Flat Device: Turn the light off for the specified Flat Device

Dragscript-switch-off-flat-device.jpg

  • Device ID: Choose the Flat Device number to control with this command. See Flat Device Setup for more information on flat devices.


  • Select Brightness Flat Device: Set the brightness level for the specified Flat Device.

Dragscript-select-brightness.jpg

  • Device ID: Choose the Flat Device number to control with this command. See Flat Device Setup for more information on flat devices.
  • Brightness: Brightness level for the specified Flat Device.
Important Note! If you have a flat device that can open and close, don't forget to issue an Open Flat Device command in your DragScript before taking exposures including plate solving and autofocus!

Script

The Script action can run an external script or program:

Dragscript-script-external.png

External-script-1.png

  • File Program/Script: Click the folder icon to select the program or script to run
  • Arguments: Command line arguments to be passed to the program or script when invoking it
  • Wait For Program/Script: If checked, wait for the program or script to return before continuing (synchronous execution)
  • On Timeout Kill Program/Script: If checked, and the "Wait for Program/Script" option is checked, and the "Wait / Timeout" time period has elapsed, terminate the external program or script
  • Return OK to DragScript Engine only if Script return this: If checked, the script or program must return the value specified in the text field in order for this action to be considered a success and return OK
  • Save External Script output to this DragScript String: If checked, store the value that the external script or program returns in STDOUT to the DragScript string variable chosen from the drop-down list
  • Save External Script output to this DragScript Decimal: If checked, store the value that the external script or program returns in STDOUT to the DragScript decimal number variable chosen from the drop-down list
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window
Important Note! Voyager will only terminate the specified program or script when the timeout period expires. If the called program calls other programs, they will not be terminated by Voyager


Important Note! If the value returned from STDOUT is stored in a DragScript decimal number, be sure that the number returned uses a period as the decimal point separator


Example of Use

In this example, we call a Python script located in the directory d:\VScheduler\Scheduler.py, and wait up to 10 seconds for the script to complete.

The Python script writes a value to STDOUT with this code:

import sys

sys.stdout.write('RUN')

sys.stdout.flush()

We store that value in the SchedulerResult DragScript string variable. We can then make decisions in the DragScript using the DO IF STRING VALUE statement.

Script-scheduler-example.jpg


Timing

Timing actions inform DragScript to wait before performing an action. You can wait for a time interval, an absolute time to be reached, astronomical night with an offset, or for an object to reach a desired altitude:
Dragscript-timing-211a.jpg

  • Wait Time: Wait for a specified time to arrive or to elapse: TYPO: Not really a "typo" but the NOTE in this dialog needs to be translated to English

Dragscript-waittime.png

  • Interval/Time: Enter a time in HH MM SS.
  • Wait Type: Chose Absolute or Relative
    • Absolute: Wait until this absolute time is reached. If the time specified is more than 12 hours in the future, Voyager will assume this time has passed and will not wait. For example, if the specified time is 20:00:00 and this action is executed at 20:15:00, Voyager will not wait because that would cause a wait until tomorrow night, which is probably not what you intended
    • Relative: Wait for this amount of time to elapse
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window
  • Wait Altitude: Wait until the object at the given RA and DEC coordinates reaches the specified altitude, either rising or setting:

Dragscript-wait-altitude.png

  • RA Target J2000: RA coordinates of the object you want to reach the Reference Altitude in HH MM SS or HH MM SS.sss
  • DEC Target J2000: DEC coordinates of the object you want to reach the Reference Altitude in DD MM SS or DD MM SS.sss
  • Reference Altitude: Altitude to reach in degrees
  • Exit Wait if Actual Altitude GREATER than or EQUAL (>=) to reference: Wait until the target rises above the reference altitude
  • Exit Wait if Actual Altitude LOWER than or EQUAL (>=) to reference: Wait until the target sets below the reference altitude
  • Wait Altitude until absolute time: The Wait Altitude operation will terminate when this time is reached, whether or not the target has reached the reference altitude. This is usually done to end the wait with morning light
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


  • Wait Astronomical Night: Wait until astronomical night, with an optional offset:

Dragscript-wait-night.png

  • Get Latitude and Longitude from Mount: Retrieve the current latitude and longitude from the connected mount, which must support this command. This location is used, along with the current date, to determine the time that astronomical night begins
  • Use the Latitude and Longitude indicated below: Specify your current latitude and longitude in the fields below. This location is used, along with the current date, to determine the time that astronomical night begins
  • Offset: Time in HH MM SS
    • Offset Before: If selected, exit the wait this amount of time before astronomical night
    • Offset After: If selected, exit the wait this amount of time after astronomical night
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window
  • Wait Dusk
    Dragscript-wait-dusk.jpg
  • Get Latitude and Longitude from Mount: Retrieve the current latitude and longitude from the connected mount, which must support this command. This location is used, along with the current date, to determine the time that dusk begins
  • Use the Latitude and Longitude indicated below: Specify your current latitude and longitude in the fields below. This location is used, along with the current date, to determine the time that dusk begins
  • Offset: Time in HH MM SS
    • Offset Before: If selected, exit the wait this amount of time before dusk
    • Offset After: If selected, exit the wait this amount of time after dusk
  • Save Time to Event (minutes) in Decimal: Save the computed time until Dusk in a decimal variable. See the DragScript example below for one way to use this.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


You can configure the time at which dusk begins in the SkyFlat section of Flat Device Setup.

Important Note! If dusk (plus or minus the offset if one is specified) has already passed, Wait Dusk returns OK if it has been less than 12 hours since dusk, else it returns ERROR if has been more than 12 hours


  • Wait Dawn

Wait-dawn-2.jpg

  • Get Latitude and Longitude from Mount: Retrieve the current latitude and longitude from the connected mount, which must support this command. This location is used, along with the current date, to determine the time that dawn begins
  • Use the Latitude and Longitude indicated below: Specify your current latitude and longitude in the fields below. This location is used, along with the current date, to determine the time that dawn begins
  • Offset: Time in HH MM SS
    • Offset Before: If selected, exit the wait this amount of time before dawn
    • Offset After: If selected, exit the wait this amount of time after dawn
  • Save Time to Event (minutes) in Decimal: Save the computed time until dawn in a decimal variable. See the DragScript example below for one way to use this.
  • Default: Use the default settings
  • OK: Save changes and close the window
  • Cancel: Discard changes and close the window


You can configure the time at which dawn begins in the SkyFlat section of Flat Device Setup.


Important Note! If dawn (plus or minus the offset if one is specified) has already passed, Wait Dawn returns OK if it has been less than 12 hours, else ERROR if more than 12 hours


Using the Time to Event Value in a DragScript

Here's an example of using the Save Time to Event (minutes) value in a DragScript.

The basic idea is that you can decide whether or not to execute any actions based on how many minutes there are until or after dawn or dusk.

Dragscript-wait-dawn-2.jpg

The decimal variable "Minutes Before Event" is initialized to 0.

The Wait Dawn: Data from connected Setup - Offset (Before) 00:15:00 [hh:mm:ss]>>Minutes Before Event action waits until 15 minutes before dawn, and then puts the value 15 into the variable Minutes Before Event

The DO IF DECIMAL VALUE block will execute if the Minutes Before Event variable is between 0 and 15. If not, control passes to the End block.

The Goto Block: DAWN FLAT statement sends control back to that block, and the minutes before or after dawn are computed again and stored in the Minutes Before Event variable.

If it is after dawn when the Wait Dawn action runs, the value stored in Minutes Before Event will be negative, and the DO IF DECIMAL VALUE statement will not run.



Signals

Signals actions let you send notifications via email, Skype or SMS:

Dragscript-signals.png

Important Note! As of Voyager 2.1.4a, you can use the Save without Personal Info button to save a copy of your DragScript with all personal info (email addresses, email account logins, phone numbers, etc.) deleted. Use this save mode before posting a script online or sharing with others.

Dragscript-editor-toolbar-3.png

Use button 5 to save your DragScript with the personal info deleted for any of the actions in this group (Signals).


  • Send Email using Voyager Account: Send an email using Voyager's email account. You must have an active support and update Voyager license to use this option and an Internet connection

Dragscript-send-email.png

  • Mail to: Email address to send to
  • Object: Subject line of email TYPO: Should be Subject instead of Object
  • Text: Body of email
  • Cancel: Discard changes and close the window
  • OK: Save changes and close the window


  • Send Email: Send an email notification using a specified email server and account. Requires an Internet connection

Dragscript-sendemail.png

  • Mail From: Email address this message is from
  • Mail to: Email address to send to
  • Object: Subject line of email TYPO: Should be Subject instead of Object
  • Text: Body of email
  • SMTP User: Username to login to SMTP (mail) server. Check with your local ISP or network administrator if you don't know how to login to your SMTP server to send email
  • SMTP Password: Password to login to your SMTP (mail) server
  • SMTP Server: Hostname or IP address of your SMTP (mail) server
  • SMTP Port: Port number of your SMTP (mail) server
  • Use SSL: If checked, use an SSL (secure) connection to your mail server
  • GMAIL: Click this button to use the SMTP server and port information for Google Gmail
  • HOTMAIL: Click this button to use the SMTP server and port information for Microsoft Hotmail
  • Cancel: Discard changes and close the window
  • OK: Save changes and close the window


  • Start Skype Call: Start a Skype call from the computer running Voyager. Requires an Internet connection

Dragscript-skype.png

  • Phone Number to Call: Phone number or Skype name to call using Skype
  • After Command Wait: Time in seconds to wait after sending the command before timing out if no response from Skype
  • After leave ringing for: Time in seconds to wait after Skype places the call and the remote phone starts to ring
  • Skype Exe Directory: Location of Skype program on this computer
  • Find Skype: Look for Skype program on this computer and fill out the Skype Exe Directory if found
  • Test: Try to make a Skype call using the information in this dialog window
  • Cancel: Discard changes and close the window
  • OK: Save changes and close the window


  • Send SMS with Nexmo

Dragscript-nexmo.png

  • To Telephone Number: Phone number to send SMS message to
  • Text: Body of SMS messages
  • API Key: API Key for Nexmo service - you must sign up at https://www.nexmo.com/ to get an API key and secret
  • API Secret: API Secret for Nexmo service
  • Cancel: Discard changes and close the window
  • OK: Save changes and close the window


Important Note! Nexmo is an online service that offers voice and data communication. To use Nexmo from Voyager you must register at their site at https://www.nexmo.com