Runtime Safety¶

Runtime Safety defines how AstroManager should react when a remote or unattended night no longer looks healthy.

It is especially useful when:

• you run unattended nights
• you manage remote observatories
• you want clear recovery or stop behavior instead of ambiguous failures

What A Runtime Safety Policy Is¶

A runtime safety policy is a set of rules.

Each rule contains:

• one or more conditions
• one or more actions

When a rule becomes true during runtime safety evaluation, AstroManager runs the configured actions in their defined order.

How To Configure It¶

The usual setup flow is:

1. Create a runtime safety policy in Settings.
2. Add one or more rules.
3. Define the conditions that should trigger each rule.
4. Define the actions AstroManager should execute.
5. Save the policy.

How To Apply It To A Client¶

Open Client Configuration and select the desired Runtime stop / safety policy.

That assignment is done per client, so different telescope PCs can use different safety behavior if needed.

The client configuration dialog also lets you define the email recipients that should receive runtime safety notifications.

Conditions¶

Conditions define when a rule should trigger. Inside one rule, conditions are connected via OR. That means the rule becomes active as soon as any one of its conditions matches.

AstroManager currently supports these condition metrics:

• Safety Monitor Safe Triggers when the safety monitor reports safe or unsafe, depending on the operator you choose.
• Guiding RMS (arcsec) Watches guiding quality and can react if the RMS becomes too high.
• HFR of Last Capture Watches the HFR of the most recent capture and can react if focus or image quality degrades.
• Star Count of Last Capture Watches how many stars were detected in the most recent capture and can react if the frame quality drops.
• Cloud Cover (%) Uses cloud-cover data from the weather source.
• Rain Rate Lets you react when rain is detected.
• Sky Quality (SQM) Uses the reported sky quality value if available.
• Mount Altitude (°) Watches the current mount altitude.
• Cooler Power (%) Watches how hard the camera cooler is working.
• Guider Connected Reacts when the guider connection changes.
• Guider Guiding (during exposure) Reacts if the guider is not actually guiding while an exposure is running.
• Guider Settling (during exposure) Reacts if the guider remains in settling state during an exposure.
• Camera Connected Reacts when the camera connection is lost.
• Mount Connected Reacts when the mount connection is lost.
• Safety Monitor Connected Reacts when the safety monitor connection is lost.
• Weather Connected Reacts when the weather source connection is lost.

Operators¶

For numeric conditions, you can use operators such as:

• greater than
• greater than or equal
• less than
• less than or equal
• equals
• does not equal

For boolean conditions, you can use:

• is
• is not

Use multiple conditions when you want several different trigger paths to lead to the same action chain, for example Cloud Cover (%), a disconnected weather source, or a failed safety monitor.

Actions¶

Actions define what AstroManager should do once a rule triggers. The order matters.

AstroManager currently supports these actions:

• Stop sequence Stops the full N.I.N.A. sequence immediately.
• Park and retry Parks the mount, or stops tracking if parking is not available, then waits for the configured time. It can optionally continue early if the rule clears and safety recovers.
• Stop tracking and retry Stops mount tracking and waits for the configured time. It can optionally continue early if the rule clears and safety recovers.
• Reconnect equipment Tries to reconnect one selected component and then continues.
• Reconnect all equipment Tries to reconnect all equipment and then continues.
• Calibrate guider Runs guider calibration and then continues.
• Run autofocus Runs autofocus and then continues.
• Skip AM scheduler Stops only the AstroManager scheduler part. N.I.N.A. continues with the rest of the sequence.
• Send email Sends an alert email and then continues with the next configured action.
• Create notification Creates an AstroManager notification/event and then continues with the next configured action.
• Adjust cooler by delta Changes the camera cooler setpoint by a positive or negative delta in degrees Celsius and then continues.

Action Details¶

Some actions have additional settings:

• Park and retry / Stop tracking and retry You define the wait time. You can also enable Resume early when safety recovers, which lets AstroManager continue before the full wait time ends.
• Reconnect equipment You choose which component should be reconnected: Critical imaging (camera + mount + guider), Camera, Mount, Guider, Focuser, Filter wheel, Rotator, Safety monitor, Weather, or Dome.
• Adjust cooler by delta Negative values cool more, positive values warm the camera.
• Send email You can customize subject, body, and additional recipients. Client-level recipients are still included automatically.
• Create notification You can customize the notification title and text.

Good Practice¶

A good first runtime safety policy is usually simple:

• one rule for lost safety-monitor or weather connection
• one rule for serious guiding or image-quality degradation
• email or notification alongside the main recovery action

For remote setups, it is usually better to start with conservative actions and then refine the rules once you have seen how your system behaves in real nights.

Related Pages¶

• Client Configuration
• Remote Control Overview