Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
FlyStar dev
FlyStar dev

Getting started

  • Installation
  • First alignment
    • Start to finish
    • With your own data

Components

  • StarList and StarTable
    • The data model
    • Column naming conventions
    • Epochs are UTC decimal years
    • Putting it together
    • Where the pieces live
  • Motion models
    • The models
      • Fixed parameters
      • Where fixed parameters live
    • How a model gets chosen
      • Choosing a model versus propagating with one
    • The time-argument contract
    • Uncertainties
      • Weighting
      • The absolute_sigma convention
      • Unusable uncertainties get weight zero, not a bad weight
      • A degenerate fit is reported, not guessed
      • Empirical errors by bootstrap
    • Fitting: one star or a whole table
      • Two asymmetries between the two paths
      • Bootstrap and parallelism
    • Performance
      • On number of stars
      • On number of epochs
      • How it was measured
    • Adding new models
      • What to declare
      • What to implement
      • Pick n_params with the others in mind
      • Non-linear models
      • Testing a new model
  • Transformations
    • Choosing a model
    • Raising the order as the fit converges
    • Giving one list its own transformation
  • Alignment
    • The parameters, group by group
      • Per-iteration schedules
      • Matching
      • The initial guess
      • The transformation
      • Which stars drive the fit
      • Per-star freeze control: update_ref_motion
      • Motion fitting
      • Output and bookkeeping
    • What fit() produces
    • Matching
    • Controlling which stars drive the fit
    • Parallelism
    • Getting to an absolute frame

Examples

  • Alignment example
    • The problem we are setting up
    • Building one StarList per epoch
    • Aligning them
    • Did it work?
  • Motion model examples
    • 1. Motion model
      • 1.1. Example: linear model fit
      • 1.2. Example: acceleration model fit
      • 1.3. Example: parallax model fit
    • 2. Fit motion model in StarTable
      • 2.1. Example: default fitting
      • 2.2. Example: specify motion models
      • 2.3. Example: specify the motion_model_input column
      • 2.4. Example: infer positions
      • 2.5. Example: freezing specific stars with update_ref_motion
  • Name-match example
    • Contents
    • 1. Overview
      • Required companion argument
      • When to choose 'override' vs 'tiebreak'
    • 2. Override mode
    • 3. Tiebreak mode
    • 4. Excluding anonymous-prefix names
    • 5. Summary: which mode to choose
      • Choosing name_match_dr_tol

API

  • flystar
    • Submodules
      • flystar.align
      • flystar.align_old_functions
      • flystar.analysis
      • flystar.examples
      • flystar.io
      • flystar.match
      • flystar.motion_model
      • flystar.orbits
      • flystar.parallax
      • flystar.plots
      • flystar.starlists
      • flystar.startables
      • flystar.stitch_method2
      • flystar.template
      • flystar.transforms
      • flystar.utils

Indices

  • Index
Back to top
Copyright © 2026, Jessica Lu, Matt Hosek
Made with Sphinx and @pradyunsg's Furo