×
Menu

Session Control

 
The SessionCraft is accessible from Tools tab
or with F9 key.
 
The Session Control section of SessionCraft monitors for various events (triggers) and can execute defined imaging plans. These plans can contain script commands for object changing, scope parking, camera warming and etc.
 
There are different types of triggers that can be configured in any combination:
 
1. To execute plans on defined time - the time could be strict or calculated event like night start
2. To execute a plan when the scope position becomes under defined altitude
3. To execute a plan on the end of Deep Sky Darkness - the time without Moon and no astro twilight
4. To execute a plan on the end of Astro Night  - the time with no astro twilight
5. To execute a plan on the end of Night - the time between Sun set and rise
 
 
The "On end of" triggers depend on the the Darkness Clock / Deep Sky Darkness calculator to determine the events time. In order to the calculation to be be correct you have to set your imaging / observing site coordinates in Location Settings!
 
The priority of the triggers is ascending, i.e. the End of Night is top priority and if there are other events triggered by the same moment they will be ignored. It is possible more than one trigger to happens in same time, but we can execute only one plan in time so the only the one with highest priority will be executed.
 
SessionCraft works even when the window is closed. However if there is running imaging plan, the triggers are checked after exposure end. For example if Deep Sky Darkness ended in the middle of running 600s exposure, it will not be interrupted. In case that there is no running plan the triggers will be executed at the moment of happening. For example your imaging plan has finished earlier than Astro Night end, the "End imaging session" plans from the screenshot will be executed when the time comes.
 
Note: The triggers are remembered between the sessions (except the Execute at Time checkbox) so you may want to tweak some of them in the beginning of new session!
 
 
Session Control
 
Follows more detailed description.
 
1

Execute at time

1.  Execute at time
 
When the checkbox is enabled SessionCraft will check if the execution time of the defined plans has come. You can add multiple plans for different times or events (night start, astro night start and etc). When a plan is executed it will be marked with asterisk (*) and it will not be executed again during this session.
 
You can add/remove time triggers with the buttons Add and Del (see below)
 
The checkbox state is not saved between the sessions, you have to manually enable it. This prevents from starting unwanted plans from the previous session on the APT start. For example you have set a plan to start in 20:15 and on next night you start APT in 22:00. You will not want to start the plan immediately before focusing and centering object...
 
2

Add trigger

2. Add trigger
 
Adds a new time trigger with fixed or calculated time of event. It opens this dialog box:
 
 
If you select one of the "Start of..." options SessionCraft will remember that it is not fixed time and will calculate the exact moment for the current night. On next night the times will be calculated again, but don't forget that you have to manually enable the option "Execute Plan At Time"!
 
You can define astro twilight offset and start Astro Night or DSD (when the Moon is below horizon, in other case the offset is not used) a bit earlier via Astro Twilight Offset in Location tab of Settings. Some astro-photographers like to start up to 15-20 minutes earlier when are using narrow-band filters.
 
3

Delete trigger

3. Delete trigger
 
Deletes the selected time trigger from the list.
 
4

Edit

4. Edit
 
Allows editing the selected time trigger from the list.
 
5

Pause

5. Pause
 
Pauses the selected trigger. This allows to skip a trigger and to enable it later or in other imaging session.
 
6

Altitude trigger

6.  Altitude trigger
 
When enabled SessionCraft checks the telescope altitude and if it gets below the defined degrees will execute the selected plan. It is a handy option if you want to switch the target, but don't want to calculate the exact time. In the executed plan you can add #GoTo++ and #SetObjectName script commands.
 
7

End of DSD trigger

7.  End of DSD trigger
 
When enabled will execute the selected plan at the end of the Deep Sky Darkness (when Moon rises or astro twilight starts). The plan can contain a set of script commands to be executed.
 
You can define astro twilight offset and end DSD (when the Moon is below horizon, in other case the offset is not used) a bit later via Astro Twilight Offset in Location tab of Settings. Some astro-photographers like to finish imaging up to 15-20 minutes later when are using narrow-band filters.
 
The time in the brackets shows the exact moment for the trigger in the current night. N/A shows that there is no deep sky darkness in the current night.
 
8

End of Astro Night trigger

8. End of Astro Night trigger
 
When enabled will execute the selected plan at the end of the Astro Night (when astro twilight starts). The plan can contain a set of script commands to be executed.
 
You can define astro twilight offset and end Astro Night a bit later via Astro Twilight Offset in Location tab of Settings. Some astro-photographers like to finish imaging up to 15-20 minutes later when are using narrow-band filters.
 
The time in the brackets shows the exact moment for the trigger in the current night. N/A shows that there is no astro night in the current night.
 
9

End of Night trigger

9.  End of Night trigger
 
When enabled will execute the selected plan at the end of the Night (when Sun rises). The plan can contain a set of script commands to be executed.
 
The time in the brackets shows the exact moment for the trigger in the current night. N/A shows that there is no true night in the current today.