# Learn
Interactive tutorials and reference material for the `satkit` package, organized from foundational concepts to advanced applications. Tutorials are Jupyter notebooks with runnable code; theory pages provide deeper mathematical background.
## Foundations
Core concepts that underpin the rest of the library.
| [Time Systems](Time%20Systems.ipynb) | UTC, TAI, TT, TDB, UT1, GPS conversions and why they matter |
| [Quaternions](Quaternions.ipynb) | Constructing, composing, and interpolating 3D rotations |
| [Coordinate Frames](Coordinate%20Frames.ipynb) | GCRF, ITRF, TEME, and the rotations between them |
| [Geodetic Coordinates](Geodetic%20Coordinates.ipynb) | The `itrfcoord` data type: geodetic, Cartesian, and local tangent planes |
| [Keplerian Elements](Keplerian%20Elements.ipynb) | Orbital elements, Cartesian conversion, and two-body vs numerical propagation |
## Orbit Propagation
Propagating satellite orbits using analytical and numerical methods.
| [Theory: Force Models & Propagation](../guide/satprop.md) | Mathematical basis, gravity models, drag, SRP, thrust, integrator selection |
| [Theory: TLEs, SGP4 & OMMs](../guide/tle.md) | TLE/OMM formats, SGP4 history, and mean-element ephemeris concepts |
| [Two-Line Element Set](Two-Line%20Element%20Set.ipynb) | Loading and using TLEs with SGP4 |
| [High Precision Propagation](High%20Precision%20Propagation.ipynb) | Numerical orbit propagation with force models |
| [SGP4 vs Numerical Propagation](SGP4%20vs%20Numerical%20Propagation.ipynb) | Comparing analytical and numerical orbit propagation |
| [Orbit Maneuvers](Orbit%20Maneuvers.ipynb) | Hohmann transfer, Lambert targeting, and low-thrust orbit raising |
| [TLE Fitting](TLE%20Fitting.ipynb) | Fitting TLEs from state vectors |
## Applications
Common tasks built on top of the core library.
| [Plots](Plots.ipynb) | Plotting satellite orbits and ground tracks |
| [Satellite Ground Contacts](Satellite%20Ground%20Contacts.ipynb) | Computing satellite ground contacts and visibility |
| [Eclipse](Eclipse.ipynb) | Computing satellite eclipse times |
| [Sunrise & Sunset](riseset.ipynb) | Computing sunrise, sunset, and twilight times |
| [Optical Observations](Optical%20Observations%20of%20Satellites.ipynb) | Simulating optical satellite observations |
## Advanced Topics
Specialized capabilities for mission analysis and design.
| [Theory: Lambert's Problem](../guide/lambert.md) | Algorithm details: Izzo's method, Lancaster-Blanchard parameterization, multi-revolution solutions |
| [Lambert Targeting](Lambert%20Targeting.ipynb) | Orbit transfer design with delta-v computation and pork-chop plots |
| [Planetary Ephemerides](Planetary%20Ephemerides.ipynb) | JPL DE440 and low-precision Sun/Moon/planet positions |
| [Atmospheric Density](Atmospheric%20Density.ipynb) | NRLMSISE-00 density profiles, solar activity effects, and drag |
| [Covariance Propagation](Covariance%20Propagation.ipynb) | State transition matrix, uncertainty growth, and orbital frame analysis |
| [Orbital Mean-Element Message](Orbital%20Mean-Element%20Message.ipynb) | Working with OMM records |