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:
- Queries AstroManager for the best target to image
- Slews and centers on the target
- Configures filter and exposure settings
- Captures the planned exposures
- Reports progress back to AstroManager
- Repeats for next target when appropriate
Adding to Sequence¶
Location in Instruction List¶
- Open Advanced Sequencer
- In the instruction list, find "AstroManager" category
- Drag "AstroManager Target Scheduler" to your sequence
Recommended Sequence Structure¶
📁 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:
- Query AstroManager for current best target
- Apply Filters:
- Above minimum altitude
- Meets moon distance requirements
- Not in meridian exclusion zone
- Has incomplete imaging goals
- Score Remaining Targets:
- Priority weight
- Current altitude bonus
- Time remaining above horizon
- Completion progress
- 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:
- Log the error
- Attempt recovery action
- 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.