Skip to content

Target Scheduler Instruction

The AstroManager Target Scheduler is a sequencer instruction that automatically selects and images targets from your AstroManager schedule.

What It Does

The Target Scheduler instruction:

  1. Queries AstroManager for the best target to image
  2. Slews and centers on the target
  3. Configures filter and exposure settings
  4. Captures the planned exposures
  5. Reports progress back to AstroManager
  6. Repeats for next target when appropriate

Adding to Sequence

Location in Instruction List

  1. Open Advanced Sequencer
  2. In the instruction list, find "AstroManager" category
  3. Drag "AstroManager Target Scheduler" to your sequence
📁 Sequential Instruction Set
├── 🌙 Wait for Darkness
├── 🔓 Unpark Mount
├── ❄️ Cool Camera (target temp)
├── 📁 Loop While (AstroManager Loop Condition)
│   └── 🎯 AstroManager Target Scheduler
├── 🌡️ Warm Camera
└── 🔒 Park Mount

Instruction Settings

Basic Settings

Setting Description
Name Display name for this instruction
Enabled Whether instruction is active

Slew & Center

Setting Default Description
Slew to Target On Slew mount to target coordinates
Center Target On Plate solve and center
Rotation On Rotate to target angle

Focus

Setting Default Description
Focus on Start Off Run autofocus before first exposure
Focus on Filter Change On Autofocus when filter changes
Focus Interval 0 min Time-based autofocus (0=disabled)

Dithering

Setting Default Description
Enable Dither On Dither between exposures
Dither Every 3 Exposures between dithers
Settle Time 10 sec Wait after dither

How Target Selection Works

Selection Algorithm

When the instruction runs:

  1. Query AstroManager for current best target
  2. Apply Filters:
  3. Above minimum altitude
  4. Meets moon distance requirements
  5. Not in meridian exclusion zone
  6. Has incomplete imaging goals
  7. Score Remaining Targets:
  8. Priority weight
  9. Current altitude bonus
  10. Time remaining above horizon
  11. Completion progress
  12. Return Best Target with imaging parameters

What's Returned

Data Description
Target Coordinates RA/Dec for slewing
Current Filter Which filter to use
Exposure Time Duration in seconds
Exposure Count How many to take
Binning Pixel binning setting
Gain/Offset Camera settings
Rotation Position angle

Execution Flow

Normal Execution

┌─────────────────────────────────────┐
│ 1. Query AstroManager for Target    │
├─────────────────────────────────────┤
│ 2. Slew to Target                   │
├─────────────────────────────────────┤
│ 3. Center via Plate Solve           │
├─────────────────────────────────────┤
│ 4. Rotate to Angle (if enabled)     │
├─────────────────────────────────────┤
│ 5. Set Filter                       │
├─────────────────────────────────────┤
│ 6. Autofocus (if needed)            │
├─────────────────────────────────────┤
│ 7. Capture Exposures                │
│    ├── Expose                       │
│    ├── Dither (if enabled)          │
│    └── Report to AstroManager       │
├─────────────────────────────────────┤
│ 8. Check for Target Switch          │
├─────────────────────────────────────┤
│ 9. Repeat or Exit                   │
└─────────────────────────────────────┘

Target Switching

The scheduler may switch targets when:

  • Current target goal is complete
  • Current target is setting below minimum altitude
  • A higher-priority target becomes available
  • Filter requirements change (e.g., moon rising)

Integration with N.I.N.A.

Triggers & Conditions

The instruction respects N.I.N.A. triggers and conditions:

  • Meridian Flip Trigger: Handles flips automatically
  • Safety Conditions: Responds to safety monitor
  • Time Conditions: Works with time-based triggers

External Triggers

These triggers can affect the scheduler:

  • Autofocus triggers (AF runs between exposures)
  • Meridian flip triggers (flip handled gracefully)
  • Weather triggers (may abort instruction)

Error Handling

Common Scenarios

Scenario Behavior
No targets available Waits and retries
Plate solve fails Retries per N.I.N.A. settings
Cloud detection Pauses and waits
Connection lost Attempts reconnection
Equipment error Reports and continues if possible

Error Recovery

The scheduler is designed to recover gracefully:

  1. Log the error
  2. Attempt recovery action
  3. If unrecoverable, report and continue to next target

Tips

Use with Loop Condition

Always pair with AstroManager Loop Condition for proper control.

Configure Autofocus

Set focus-on-filter-change for multi-filter imaging.

Dither Settings

Dithering every 3-5 frames balances SNR and walking noise.

Test First

Run a short test sequence before full overnight sessions.

Center is Important

Keep "Center Target" enabled for accurate framing.