Help

From a Tycho folder to usable limits.

Use the GUI for interactive work or the CLI for repeatable folder analysis. Both share the same calculation core.

GUI workflow

  1. Start Known Object Ranges and select a folder.
  2. If a Known Objects CSV is present, select Analyze.
  3. If the folder contains only FITS data, confirm the separate Tycho analysis when prompted.
  4. Review the cumulative table and export the formats you need.
  5. Use Local website to create one self-contained known_objects.html in the selected data folder.

The first FITS image must be plate solved with third-order SIP metadata. An unsolved image stops before Tycho starts.

CLI examples

KnownObjectRangesCLI.exe "Q:\Data\Tycho"
KnownObjectRangesCLI.exe "Q:\Data\Tycho" --limit-magnitude 22.37
KnownObjectRangesCLI.exe "Q:\Data\Tycho" --formats json txt csv xml ods xls
KnownObjectRangesCLI.exe "Q:\Data\Tycho" --analyze-with-tycho
KnownObjectRangesCLI.exe "Q:\Data\Tycho" --analyze-with-tycho --tycho-maximized

Tycho starts minimized unless --tycho-maximized is supplied. Only the first aligned FITS image is loaded.

Output files

Full exports use known_object_minmax_ranges.*. Compact exports use known_object_minmax_ranges_short.* and contain only magnitude limit, Motion minimum/maximum, and PA minimum/maximum.

By default the CLI writes JSON, TXT, CSV, and the self-contained HTML report directly into the selected data folder. Use --output-dir to choose another flat destination.

Exit codes

0
Analysis completed successfully.
2
Input, folder, CSV, or limiting-magnitude error.
3
The reference FITS image is not plate solved.
4
Tycho analysis failed or timed out.