Difference between revisions of "Voyager Setup"

From Voyager Wiki
Jump to navigation Jump to search
 
(9 intermediate revisions by the same user not shown)
Line 60: Line 60:
  
 
*'''Wait Process Starting for''':  Number of seconds to wait after starting a process external to Voyager, e.g. PHD2 guiding software, TheSkyX planetarium or Maxim DL camera control
 
*'''Wait Process Starting for''':  Number of seconds to wait after starting a process external to Voyager, e.g. PHD2 guiding software, TheSkyX planetarium or Maxim DL camera control
*'''Force Starting TSX by Voyager:'''  If you have trouble with Voyager starting TheSkyX by its normal method (Windows 10 DCOM), try checking this box and Voyager will use an alternate method to start TheSkyX
+
*'''Force Starting TSX (32 bit) by Voyager:'''  If you have trouble with Voyager starting TheSkyX by its normal method (Windows 10 DCOM), try checking this box and Voyager will use an alternate method to start TheSkyX. This work only if the application is installed on the default installation folder.
 +
*'''Force Starting TSX (64 bit)  by Voyager:'''  If you have trouble with Voyager starting TheSky64 by its normal method (Windows 10 DCOM), try checking this box and Voyager will use an alternate method to start TheSky64. This work only if the application is installed on the default installation folder.
  
 
<br />
 
<br />
Line 121: Line 122:
  
 
== File Pattern Manager ==
 
== File Pattern Manager ==
Form version 2.2.14j of Voyager users can change the file naming and subfoldering logic of all the kind of Sequences usable in Voyager (Sequence, Mosaic Research & Survey, Array Sequence). Setting about are stored on the profile, different profile can handle different sub foldering and file naming.
+
Form version 2.2.14j of Voyager users can change the file naming and subfoldering logic of all the kind of Sequences usable in Voyager (Sequence, Mosaic Research & Survey, Array Sequence). Setting about are stored on the profile, different profile can handle different sub foldering and file naming. To open the manager you can press the manage button in the [https://wiki.starkeeper.it/index.php/Voyager_Setup#PATH_.26_FILE FILE & PATH box] of Voyager Setup, tab Voyager.
  
 
[[File:FilePatternManager.png]]
 
[[File:FilePatternManager.png]]
Line 144: Line 145:
 
=== Commands ===
 
=== Commands ===
  
* '''Reset to Default CMOS''':  ipse dixit ...
+
* '''Reset to Default CMOS''':  replace the actual Sequence File Pattern field with a default pattern specialized to CMOS camera really similar to the sub foldering and file naming used by original Voyager sequence action logic,
* '''Reset to Default CCD''':  ipse dixit ...
+
* '''Reset to Default CCD''':  replace the actual Sequence File Pattern field with a default pattern specialized to CCD/DSLR camera really similar to the sub foldering and file naming used by original Voyager sequence action logic,
* '''Reset to Default CMOS''' '''Advanced''':  ipse dixit ...
+
* '''Reset to Default CMOS''' '''Advanced''':  replace the actual Sequence File Pattern field with a default pattern specialized to CMOS camera really similar to the sub foldering and file naming used by original Voyager sequence action logic, more sub foldering will be added and managed instead of the default CMOS pattern
* '''Reset to Default CMOS Advanced''':  ipse dixit ...
+
* '''Reset to Default CCD Advanced''':  replace the actual Sequence File Pattern field with a default pattern specialized to CCD/DSLR camera really similar to the sub foldering and file naming used by original Voyager sequence action logic, more sub foldering will be added and managed instead of the default CCD/DSLR  pattern
* '''Cancel:''' ipse dixit ...
+
* '''Cancel:''' restore the Sequence File Pattern field to the previuos version before edit begin
* '''Apply:''' ipse dixit ...
+
* '''Apply:''' apply change saving the Sequence File Pattern field in the actual profile
 +
 
 +
* '''Exit Manager:''' If you want to exit from the Manager press the X button on the top right corner of the window.
  
 
=== Example ===
 
=== Example ===
Line 165: Line 168:
  
 
where the bolded text is a subfolders. When some tag cannot be replaced with the related data Voyager will put a null space or a "Unknow" text string.
 
where the bolded text is a subfolders. When some tag cannot be replaced with the related data Voyager will put a null space or a "Unknow" text string.
 
==Application Server==
 
The Application Server panel of the Voyager Setup workspace tells Voyager whether or not to start the bundled Application Server.
 
 
The Application Server is bundled with the base version starting with Voyager 2.0.14f (daily build) and 2.1.0 (stable).
 
 
Refer to the [[Application Server API|Application Server section]] for more information.
 
 
Changes to any of these settings take effect the next time you start Voyager.
 
 
[[File:Voyager-setup-app-server-221.jpg]]
 
 
*'''Activate it on Start (*)''':  If checked, start the bundled application server when Voyager starts.  This is not checked by default
 
*'''Not Logging Heartbeat(*)''':  If checked, do not log the Heartbeat events which occur every 5 seconds.  This is checked by default, as there are many heartbeat events per hour and you probably don't want to log them all
 
*'''Allow Dashboard Service:'''  If checked, allow the [https://www.starkeeper.it/wdashinfo/ Voyager Web Dashboard] service to operate
 
*'''Dashboard JPG Quality:'''  Select the desired JPG quality level from the drop-down.  Use a lower quality if your connection speed can't support a higher quality, or if you are on a metered connection and wish to reduce the amount of data transferred.
 
  
 
<br />
 
<br />
  
==Web Server==
+
==Profiles Auto Backup==
As an option, Voyager's Web Dashboard can be hosted on the machine running Voyager. If you choose this option, the HTML and supporting files used in the Web Dashboard will be served to your browser via an internal web server included with Voyager.  No Internet connection is required with this option.
+
Voyager auto save a backup copy of Profiles Folder in a special Folder called ProfileBackup. See for more info the Voyager Folders structure
  
Alternatively, if you have an Internet connection, you can  run the Web Dashboard using the files hosted at http://www.starkeeper.it/wdash/. 
+
[[File:AutobackupProfiles.png]]
  
[[File:Voyager-setup-webserver-221.jpg]]
+
*'''Profile Backups age maximum [days]:'''  age of old backup max allowed in terms of day
 +
Voyager backup automatically the Profiles folder at each startup and when an update online from Voyager will be started.
  
*'''Activate it on Start (*):'''  If checked, Voyager's internal web server will start when you start Voyager.  This web server will be used to serve the Web Dashboard files
+
Voyager remove the oldest out of agebackup at the startup after a fresh backup of actual profile folder.
*'''TCP/IP Port:'''  Select the TCP/IP port on which the web server will listen for a connection.  The default is port 80.
 
  
  
For more information on using the Web Dashboard, see https://www.starkeeper.it/wdashinfo/ 
 
<br />{{Note|Any changes made in this section will not take effect until you restart Voyager}}<br />
 
 
==Startup Option==
 
==Startup Option==
 
As of Voyager 2.1.4a, you can choose to hide personal info from the startup form.
 
As of Voyager 2.1.4a, you can choose to hide personal info from the startup form.
Line 216: Line 201:
 
{{Note|Changes to any of these color settings requires a Voyager restart to take effect}}
 
{{Note|Changes to any of these color settings requires a Voyager restart to take effect}}
  
 +
 +
 +
 +
 +
== Moon Avoidance Lorentzian ==
 +
Define a mode to avoid moon based on Lorentzian distribution formula using Distance between moon and object and width of Lorentzian period (default half of the moon period aka 14days).
 +
The distance calculated will be used by RoboTarget Scheduler to define if a target is elegible.
 +
 +
 +
[[File:Immagineergr.png]]
 +
 +
* '''Avoidance Profiles:'''  There are 3 profile of distance: broadband for LRGB filters, narrow band and free (low consideration of moon distance). Each of this profile can be edited in terms of parameters of Lorentzian distribution or in terms of altitude for each single Moon Phase.
 +
* '''Manage(*)''': opening the Avoidance windows manager. Be patient, opening take a while (2s to 10s) depends on your PC resources
 +
 +
 +
[[File:Immaginey4y.png]]
 +
 +
* '''A''': profile for Broad Band Filters (LRGB)
 +
* '''B''': profile forNarrow Band Filters
 +
* '''C''': profile Free with very low impact of moon distance
 +
* '''Distance:''' one of the two parameters of the Lorentzian Distribution. Means the distance max used by formula at maximum phase of moon
 +
* '''Width:''' softness of curve far from the 100% moon phase, more is short the width more there will be an accentuated peak with flatness data before the 100% of moon phase. Start using 14 that is also the half of the moon period
 +
* '''Generate table:''' Create automatically the list of moon phase <-> altitude tuple from 0 to 100%
 +
* '''Data Table:'''  the list of moon phase <-> altitude tuple from 0 to 100%. You can manual edit the value one by one if you have patience
 +
* '''Chart:''' chart drawing tih the moon phase on the x axis and the minimum distance allowed between target and moon
 +
* '''Reset All:''' By default the value are like in image perfect and balanced for the porpouse of creation (values validated by more than one advanced users). Click here to report all the profiles to the default values
 +
* '''Apply:''' save the changing on Voyager profile file on disk
 +
* '''Close:''' close the windows manager
 +
{{Note|This features is reserved to Voyager Advanced and Full version}}
 +
 +
{{Note|Do not change the default valued if you do not understand what Lorentzian distribution is}}
  
 
<br />
 
<br />

Latest revision as of 20:19, 25 May 2024

Color Coding

Throughout the Setup workspace, Voyager uses color to indicate the following:

  • Black: A normal setting
  • Gold or Yellow: Use caution when changing as things may not work well or as expected
  • Red: Use extreme care when changing this setting - the wrong value can damage your equipment or the imaging session may fail


Voyager Setup Workspace

Click the Voyager button in the Setup workspace to display the Voyager settings window, which contains miscellaneous settings about Voyager's operation:

Setup-voyager-221.jpg

CCD Graph

The CCD Graph panel of the Voyager setup workspace contains parameters for the CCD Widget displayed in the Status Window

Ccd-graph.jpg

  • Default Scale Temp. Top (°C): Default value for the top of the temperature scale, in °C
  • Default Scale Temp. Bottom (°C): Default value for the bottom of the temperature scale, in °C
  • Timer Interval in Graph: Total time represented by the X axis of the graph in seconds
  • Show Min/Max Temperature Axis Label: If checked, display the white boxes with the values represented by the top and bottom of the Y axis (temperature) of the CCD Widget displayed in the Status Window
  • Show Temperature Label relative to Mouse: If checked, hovering the mouse shows the temperature of the point under the mouse cursor in the CCD Widget displayed in the Status Window
  • AutoScale Temperature Axis: If checked, automatically scale the values of the top and bottom of the Y axis (temperature) of the CCD Widget displayed in the Status Window so the displayed values fit in the widget


Guide Box

The Guide Box panel of the Voyager setup workspace contains parameters for the Guide Widget displayed in the Status Window:

Guide-box.jpg

  • Default Pixel Scale: The number selected from the drop-down box represents the number of pixels, +/-, represented by the Y axis scale of the Guide Widget displayed in the Status Window. For example, a value of 1 here means the top of the graph represents a guide error of +1 pixels, and the bottom of the graph represents a guide error of -1 pixels
  • Default Frame Scale: The number of guiding frames (exposures) represented by the X axis of the graph
  • Show Scale Label: If checked, the values of Default Pixel Scale and Default Frame Scale are displayed in white boxes at the top and bottom respectively of the Guide Widget displayed in the Status Window
  • Show Temperature Label relative to Mouse: If checked, when the mouse is hovered over the Guide Widget displayed in the Status Window, a white box pops up over the graph and shows the temperature represented by the mouse pointer location
  • Show StarMass Mobile Mean Value: If checked, the moving average of the StarMass value is displayed in the Guide Widget displayed in the Status Window
  • Show Sub RMS Value: If checked, the RMS value of the current guide exposure is displayed in the Guide Widget displayed in the Status Window


TARGET Graph

The TARGET Graph panel of the Voyager setup workspace contains parameters for the Target Widget displayed in the Status Window
Target-graph.jpg

  • Show Min/Max Altitude Axis Label: If checked, label the Y axis (altitude) of the Target Widget displayed in the Status Window with the values of the bottom and top lines of the graph
  • Show Time Label relative to Mouse: If checked, hovering the mouse over the Target Widget displayed in the Status Window pops up a box with the value corresponding to the X axis (time) value of the mouse pointer position


ECHO Box

The ECHO Box panel of the Voyager Setup workspace contains settings for the Monitor Window, formerly known as the Echo box.

Echo-box.jpg

  • Use Big Font Size in Echo Windows: If checked, use large fonts in the Monitor Window, which is the window where status messages appear for running actions


External PROCESS Starting

The External PROCESS Starting panel of the Voyager Setup workspace contains information relative to starting processes external to Voyager:

Voyager-external-process-2.1.7s.jpg

  • Wait Process Starting for: Number of seconds to wait after starting a process external to Voyager, e.g. PHD2 guiding software, TheSkyX planetarium or Maxim DL camera control
  • Force Starting TSX (32 bit) by Voyager: If you have trouble with Voyager starting TheSkyX by its normal method (Windows 10 DCOM), try checking this box and Voyager will use an alternate method to start TheSkyX. This work only if the application is installed on the default installation folder.
  • Force Starting TSX (64 bit) by Voyager: If you have trouble with Voyager starting TheSky64 by its normal method (Windows 10 DCOM), try checking this box and Voyager will use an alternate method to start TheSky64. This work only if the application is installed on the default installation folder.


Logging

The Logging panel of the Voyager Setup workspace contains settings that control what is saved in the Voyager log file, and for how long:

Logging-settings.jpg

  • Logs age maximum: The length of time to store information in Voyager logs in days, after the selected time the oldest log file will be deleted from disk
  • ASCOM Extend info: If checked, extended information from ASCOM devices is stored in the log
  • CCD Peltier Data: If checked, CCD sensor cooling data is stored in the log
  • CCD Cooling Deviation: If checked, CCD sensor deviation from the desired value is stored in the log
  • PHD2 Debug: If checked, PHD2 guiding software debug information is stored in the log
  • GUIDE Data Stream: If checked, the stream of information received from the guiding software is stored in the log
  • BROADCAST Msg Send Log: If checked, broadcast messages are stored in the log . Broadcast message are internal messages between controls that manage the setup
  • SEQUENCE Abort Expose Screenshot: If checked, when a sequence is aborted, a screenshot is taken and stored in the log . The screenshot will be stored in the screenshot directory with the other directories of Voyager like the log directory. A reference to the name of the saved screenshot will be added also to the actual log file


Window and Sound

The Window and Sound panels of the Voyager Setup workspace contain settings for Voyager's window transparency and sounds:

Window-and-sound.jpg

  • Window:
    • Transparency: A number between 0 and 30 controlling the transparency of Voyager's Main Windows
  • Sound:
    • On/Off/Only Critical Event: Controls whether Voyager plays a sound through the PC's sound card - On = always, Off= never, Only Critical Event = only when critical events occur. Critical events are all the events reported in red in the Monitor window


DEBUG

The DEBUG panel of the Voyager Setup workspace has settings to help with debugging:

Debug-setup.jpg

  • Emulate Precise Pointing for Simulator: If checked, Voyager will skip precision pointing actions and do only the normal goto (slew) actions. This is useful when testing a sequence with a simulator, as most simulators cannot perform plate solves


ASK BEFORE

The ASK BEFORE panel of the Voyager Setup workspace has settings controlling whether Voyager confirms various actions before performing them:

Ask-before.jpg

  • Confirm for OnTheFly GOTO Action: If checked, Voyager will ask confirmation before performing a goto action from the OnTheFly workspace
  • Confirm for OnTheFly SEQUENCE Action: If checked, Voyager will ask confirmation before running a Sequence from the OnTheFly workspace
  • Confirm for OnTheFly SYNC Action: If checked, Voyager will ask confirmation before running a Sync action from the OnTheFly workspace
  • Confirm for Close Voyager Application: If checked, Voyager will ask confirmation closing down


PATH & FILE

The PATH panel of the Voyager Setup workspace instructs Voyager where to save images

Sequence-path.jpg

  • Sequence Path:
    • Default: Voyager saves images in the default location, which will be in your Windows Documents folder: \Documents\Voyager\Sequence\<target name>
    • Specific: Click the second radio button and click the folder icon. Browse to the path where you want images saved
    • Manual Apply: edit manually or with copy and paste and press Manual Apply button
  • Sequence File Pattern:
    • Manage: press this button to open the FILE PATTERN manager window where you can define rules for sub foldering and file naming of the various kind of sequences in Voyager (not test shot or dragscript FIT file)

File Pattern Manager

Form version 2.2.14j of Voyager users can change the file naming and subfoldering logic of all the kind of Sequences usable in Voyager (Sequence, Mosaic Research & Survey, Array Sequence). Setting about are stored on the profile, different profile can handle different sub foldering and file naming. To open the manager you can press the manage button in the FILE & PATH box of Voyager Setup, tab Voyager.

FilePatternManager.png

Special string starting and ending with $$ chars indicated a key tag (pattern) to be replaced with the related information, more info about each syngle key tag in the pattern list. You can arrange a list of this pattern and combine them with normal chars to obtain a result in file namig reported in the preview.

You can manage also the sub foldering using the / or \ char to separate file naming pattern to a dir pattern, for sure you can add more than one level of sub foldering adding more \ chars. You can use pattern for foldering and/or fixed text.

The are some special commands to allow you to obtain a defaults set of patterns to use, default is something really similar to what Voyager do with the default naming.

Important Note! You cannot apply file pattern rules to the FIT file obtained with Test Shot, plate solving and DragScript Shot.


Important Note! Default naming is Voyager is the default for each sequence, you must chose the option in each single sequence configuration to enable the file pattern naming


Important Note! If you use File Pattern sub foldering and naming in a sequence the automation usually done by Voyager to create a folder with the target name will be not more utilized. YOU WILL MUST PROVIDE foldering for Target in your pattern !!


Data

  • Sequence File Pattern: This is the pattern file string saved in the profile, you can edit the string directly writing the $$ tag or text or / char to one or more subfolder. You can also double click on one tag on the Pattern List to add text in the end of Sequence File Pattern field
  • Pattern Preview: this is readonly field where Voyager report the equivalent sub foldering and file naming relative to the file pattern field and a demo data simulated inside the manager. The › char indicates a folder separation

Pattern List

This grid will contains alphabetical ordered all the $$ tag usable for create a File Pattern, double click on the needed row to copy the Pattern Name to the Sequence File Pattern field.

  • Pattern Name: $$ tag string can be used for compose the File Pattern, case sensitive
  • Description: short description about what kind of data will be replaced to the tag if avalaible

Commands

  • Reset to Default CMOS: replace the actual Sequence File Pattern field with a default pattern specialized to CMOS camera really similar to the sub foldering and file naming used by original Voyager sequence action logic,
  • Reset to Default CCD: replace the actual Sequence File Pattern field with a default pattern specialized to CCD/DSLR camera really similar to the sub foldering and file naming used by original Voyager sequence action logic,
  • Reset to Default CMOS Advanced: replace the actual Sequence File Pattern field with a default pattern specialized to CMOS camera really similar to the sub foldering and file naming used by original Voyager sequence action logic, more sub foldering will be added and managed instead of the default CMOS pattern
  • Reset to Default CCD Advanced: replace the actual Sequence File Pattern field with a default pattern specialized to CCD/DSLR camera really similar to the sub foldering and file naming used by original Voyager sequence action logic, more sub foldering will be added and managed instead of the default CCD/DSLR pattern
  • Cancel: restore the Sequence File Pattern field to the previuos version before edit begin
  • Apply: apply change saving the Sequence File Pattern field in the actual profile
  • Exit Manager: If you want to exit from the Manager press the X button on the top right corner of the window.

Example

For a pattern file like this:

$$TARGETNAME$$\$$VOYDATEFOLDER08$$\$$FILTER$$\$$TARGETNAME$$_$$IMAGETYPE$$_$$FILTER$$_$$LABEL$$_

$$EXPOSURETIME$$s_BIN$$BINNING$$_$$SENSORTEMP$$C_A$$ARRAYNODE$$_$$FRAMENR$$_$$VOYDATETIME$$_$$READOUTMODE$$

_$$SPEED$$_RPA$$ROTATORPA$$_$$PIERSIDE$$_F$$ROBOFIREFOCUSERPOS$$

You will obtain a sub foldering and file naming system like this:

M31 › 2020-12-06 › L › M31_LIGHT_L_LABEL_0.0001s_BIN1_-24.9C_A1_0023_20201206_203246_023_8MHZ_HighGain_RPA123.45_W_F30187

where the bolded text is a subfolders. When some tag cannot be replaced with the related data Voyager will put a null space or a "Unknow" text string.


Profiles Auto Backup

Voyager auto save a backup copy of Profiles Folder in a special Folder called ProfileBackup. See for more info the Voyager Folders structure

AutobackupProfiles.png

  • Profile Backups age maximum [days]: age of old backup max allowed in terms of day

Voyager backup automatically the Profiles folder at each startup and when an update online from Voyager will be started.

Voyager remove the oldest out of agebackup at the startup after a fresh backup of actual profile folder.


Startup Option

As of Voyager 2.1.4a, you can choose to hide personal info from the startup form.

Setup-voyager-startup-221.jpg

  • Hide Personal Info in Startup Form: If checked, the startup form (splash screen) shown when Voyager starts up will not contain your name or the Voyager serial number - it will look similar to this:
  • Startup-form-no-personal-info.png

Colorblind - Help for Alarm Text

Allows customization of colors used in Alarm notifications - the normally red text that indicates an error has occurred

Voyager-colorblind-217c.jpg

  • Personalized BackColor Monitor (*): Click the Pick Color button and choose a color to use for the background color of the Monitor window.
  • Personalized BackColor Settings (*): Click the Pick Color button and choose a color to use for the background color of Alarm (error) text in Setup
  • Personalized ForeColor (*): Click the Pick Color button and choose a color to use for the foreground color of Alarm (error) text in both Setup and the Monitor window
  • Default Colors: Click to return to the Default Color scheme
Important Note! Changes to any of these color settings requires a Voyager restart to take effect



Moon Avoidance Lorentzian

Define a mode to avoid moon based on Lorentzian distribution formula using Distance between moon and object and width of Lorentzian period (default half of the moon period aka 14days). The distance calculated will be used by RoboTarget Scheduler to define if a target is elegible.


Immagineergr.png

  • Avoidance Profiles: There are 3 profile of distance: broadband for LRGB filters, narrow band and free (low consideration of moon distance). Each of this profile can be edited in terms of parameters of Lorentzian distribution or in terms of altitude for each single Moon Phase.
  • Manage(*): opening the Avoidance windows manager. Be patient, opening take a while (2s to 10s) depends on your PC resources


Immaginey4y.png

  • A: profile for Broad Band Filters (LRGB)
  • B: profile forNarrow Band Filters
  • C: profile Free with very low impact of moon distance
  • Distance: one of the two parameters of the Lorentzian Distribution. Means the distance max used by formula at maximum phase of moon
  • Width: softness of curve far from the 100% moon phase, more is short the width more there will be an accentuated peak with flatness data before the 100% of moon phase. Start using 14 that is also the half of the moon period
  • Generate table: Create automatically the list of moon phase <-> altitude tuple from 0 to 100%
  • Data Table: the list of moon phase <-> altitude tuple from 0 to 100%. You can manual edit the value one by one if you have patience
  • Chart: chart drawing tih the moon phase on the x axis and the minimum distance allowed between target and moon
  • Reset All: By default the value are like in image perfect and balanced for the porpouse of creation (values validated by more than one advanced users). Click here to report all the profiles to the default values
  • Apply: save the changing on Voyager profile file on disk
  • Close: close the windows manager
Important Note! This features is reserved to Voyager Advanced and Full version
Important Note! Do not change the default valued if you do not understand what Lorentzian distribution is


Other Setup Pages