stk-files 0.0.2__tar.gz

stk_files-0.0.2/.claude/skills/stk-attitude-format.md

@@ -0,0 +1,122 @@
+# STK Attitude File Format (*.a)
+
+Reference for STK 13 external attitude data files. Source: AGI/Ansys STK Help `importfiles-01.htm`.
+
+## File Structure
+
+```
+stk.v.11.0
+BEGIN Attitude
+  [keywords]
+  <FormatKeyword>
+  <time> <data...>
+  ...
+END Attitude
+```
+
+## Keywords
+
+| Keyword | Required | Description |
+|---------|----------|-------------|
+| `stk.v.X.X` | Yes | Version stamp, must be first line |
+| `BEGIN Attitude` / `END Attitude` | Yes | Brackets all data |
+| `MessageLevel` | No | `Errors`, `Warnings`, or `Verbose` |
+| `ScenarioEpoch` | No | Reference epoch: `dd mmm yyyy hh:mm:ss.s` |
+| `CentralBody` | No | Default: Earth |
+| `CoordinateAxes` | No | Reference coordinate system (see below) |
+| `CoordinateAxesEpoch` | Conditional | Required for epoch-dependent axes |
+| `InterpolationMethod` | No | `Lagrange` (default) or `Hermite` |
+| `InterpolationOrder` | No | Default: 1 |
+| `NumberOfAttitudePoints` | No | Max points to read |
+| `AttitudeDeviations` | No | `Rapid` (default) or `Mild` |
+| `BlockingFactor` | No | Memory allocation for large files |
+| `Sequence` | Conditional | Rotation order for Euler/YPR formats |
+| `InitialQuaternion` | Conditional | `<q1> <q2> <q3> <q4>` (q4=scalar), for AngVels format |
+| `InitialEulerAngle` | Conditional | `<Sequence> <RotA> <RotB> <RotC>`, for EulerAngleRates |
+| `InitialYPRAngle` | Conditional | `<Sequence> <Y> <P> <R>`, for YPRAngleRates |
+| `TimeFormat` | No | Date format abbreviation (default: EpSec) |
+| `RepeatPattern` | No | Cycles data; first/last points should match |
+
+## Coordinate Axes
+
+**Standard:** Fixed, J2000, ICRF, Inertial, TrueOfDate, MeanOfDate
+
+**Epoch-dependent (require CoordinateAxesEpoch):** MeanOfEpoch, TrueOfEpoch, TEMEOfEpoch, AlignmentAtEpoch
+
+**Custom (VGT):** `CoordinateAxes AWB <AxisName> <ObjectPath>`
+
+## Data Formats (16 total)
+
+### Quaternion Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeQuaternions` | `time q1 q2 q3 q4` | q4 is scalar (scalar-last). Auto-normalized to unit magnitude. |
+| `AttitudeTimeQuatScalarFirst` | `time q1 q2 q3 q4` | q1 is scalar (scalar-first) |
+| `AttitudeTimeQuatAngVels` | `time q1 q2 q3 q4 wx wy wz` | + angular velocity (deg/s, body frame) |
+| `AttitudeTimeAngVels` | `time rA rB rC` | Rates only (deg/s). Requires `InitialQuaternion`. |
+
+### Euler Angle Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeEulerAngles` | `time rotA rotB rotC` | Degrees. Requires `Sequence`. |
+| `AttitudeTimeEulerAngleRates` | `time rateA rateB rateC` | deg/s. Requires `InitialEulerAngle`. |
+| `AttitudeTimeEulerAnglesAndRates` | `time rotA rotB rotC rateA rateB rateC` | Requires `InitialEulerAngle`. |
+
+**Valid Euler sequences:** 121, 123, 131, 132, 212, 213, 231, 232, 312, 313, 321, 323 (default: 313)
+
+Euler rotations are relative to the rotated frame.
+
+### YPR Angle Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeYPRAngles` | `time Y P R` | Degrees. Data always in Y-P-R order. Requires `Sequence`. |
+| `AttitudeTimeYPRAngleRates` | `time rateA rateB rateC` | deg/s. Requires `InitialYPRAngle`. |
+| `AttitudeTimeYPRAnglesAndRates` | `time Y P R rateA rateB rateC` | Requires `InitialYPRAngle`. |
+
+**Valid YPR sequences:** 123, 132, 213, 231, 312, 321 (default: 321)
+
+YPR rotations are relative to the original reference frame. Sequence controls rotation order, not data column order.
+
+### DCM Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeDCM` | `time m11 m12 m13 m21 m22 m23 m31 m32 m33` | Row-major, ref-to-body |
+| `AttitudeTimeDCMAngVels` | `time m11..m33 wx wy wz` | + angular velocity (deg/s, body frame) |
+
+### Vector Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeECIVector` | `time V1 V2 V3` | Body X-axis in ECI, Z toward nadir. Ignores CoordinateAxes. |
+| `AttitudeTimeECFVector` | `time V1 V2 V3` | Body X-axis in ECF, Z toward nadir. Ignores CoordinateAxes. |
+
+## Data Conventions
+
+- One data point per line, values separated by at least one space
+- Ascending time order, no duplicate timestamps
+- Angular velocities always in degrees/second, body-frame components
+- Quaternions are auto-normalized to unit magnitude by STK
+- For spinning objects: 3-4 points per revolution minimum
+- Neighboring points should span less than half a revolution, or include angular velocity data
+- All attitudes represent rotation from reference frame to body frame
+
+## Example
+
+```
+stk.v.11.0
+BEGIN Attitude
+NumberOfAttitudePoints 3
+ScenarioEpoch 1 Jan 2003 00:00:00.0
+CoordinateAxes J2000
+InterpolationMethod Lagrange
+InterpolationOrder 1
+AttitudeTimeQuaternions
+0.0     0.0  0.0  0.0  1.0
+3600.0  0.1  0.2  0.3  0.9274
+7200.0  0.0  0.0  0.7071  0.7071
+END Attitude
+```

stk_files-0.0.2/.claude/skills/stk-ephemeris-format.md

@@ -0,0 +1,136 @@
+# STK Ephemeris File Format (*.e)
+
+Reference for STK 13 external ephemeris data files. Source: AGI/Ansys STK Help `importfiles-02.htm`.
+
+## File Structure
+
+```
+stk.v.12.0
+BEGIN Ephemeris
+  [keywords]
+  <FormatKeyword>
+  <time> <data...>
+  ...
+END Ephemeris
+```
+
+## Keywords
+
+| Keyword | Required | Description |
+|---------|----------|-------------|
+| `stk.v.X.X` | Yes | Version stamp, must be first line |
+| `BEGIN Ephemeris` / `END Ephemeris` | Yes | Brackets all data |
+| `ScenarioEpoch` | No | Reference epoch: `dd mmm yyyy hh:mm:ss.s` (UTC) |
+| `CentralBody` | No | Default: Earth |
+| `CoordinateSystem` | No | Default: Fixed. **Note: uses `CoordinateSystem`, not `CoordinateAxes`** |
+| `CoordinateSystemEpoch` | Conditional | Required for epoch-dependent frames |
+| `DistanceUnit` | No | Default: meters |
+| `TimeFormat` | No | Default: EpSec |
+| `TimeScale` | No | Default: TAI. Alternative: TDB |
+| `MessageLevel` | No | `Errors`, `Warnings`, or `Verbose` |
+| `NumberOfEphemerisPoints` | No | Max points to read (optional since STK 11.5) |
+| `InterpolationMethod` | No | `Lagrange` (default), `Hermite`, `LagrangeVOP`, `GreatArc`, `GreatArcTerrain`, `GreatArcMSL` |
+| `InterpolationSamplesM1` | No | Default: 5. One less than interpolation point count. Replaces deprecated `InterpolationOrder`. |
+| `ComputeVelocity` | No | `DerivativeOfInterpolatingPolynomial` (default), `ForwardDifference`, `BackwardDifference`, `CentralDifference` |
+| `SmoothData` | No | `Yes`/`No`, `True`/`False`, `On`/`Off` |
+| `BlockingFactor` | No | Memory allocation hint |
+
+## Coordinate Systems
+
+**Standard:** Fixed (default), J2000, ICRF, Inertial, TrueOfDate, MeanOfDate
+
+**Epoch-dependent (require CoordinateSystemEpoch):** MeanOfEpoch, TrueOfEpoch, TEMEOfEpoch, AlignmentAtEpoch
+
+**Custom (VGT):** `CoordinateSystem AWB <name> <object>`
+
+## Data Formats (14 ephemeris + 3 covariance)
+
+### Cartesian Formats
+
+| Format Keyword | Columns | Units |
+|----------------|---------|-------|
+| `EphemerisTimePos` | `time X Y Z` | sec, m |
+| `EphemerisTimePosVel` | `time X Y Z Xdot Ydot Zdot` | sec, m, m/s |
+| `EphemerisTimePosVelAcc` | `time X Y Z Xdot Ydot Zdot Xddot Yddot Zddot` | sec, m, m/s, m/s^2 |
+
+### Geodetic LLA Formats
+
+| Format Keyword | Columns | Units |
+|----------------|---------|-------|
+| `EphemerisLLATimePos` | `time Lat Lon Alt` | sec, deg, deg, m |
+| `EphemerisLLATimePosVel` | `time Lat Lon Alt LatDot LonDot AltDot` | sec, deg, deg, m, deg/s, deg/s, m/s |
+| `EphemerisMSLLLATimePos` | `time Lat Lon Alt(MSL)` | sec, deg, deg, m |
+| `EphemerisMSLLLATimePosVel` | `time Lat Lon Alt(MSL) LatDot LonDot AltDot` | same |
+| `EphemerisTerrainLLATimePos` | `time Lat Lon Alt(terrain)` | sec, deg, deg, m |
+
+### Geocentric LLR Formats
+
+| Format Keyword | Columns | Units |
+|----------------|---------|-------|
+| `EphemerisLLRTimePos` | `time Lat(geocentric) Lon Radius` | sec, deg, deg, m |
+| `EphemerisLLRTimePosVel` | `time Lat Lon Radius LatDot LonDot RadDot` | sec, deg, deg, m, deg/s, deg/s, m/s |
+
+### Mixed Geodetic/Geocentric Formats
+
+| Format Keyword | Columns |
+|----------------|---------|
+| `EphemerisGeocentricLLATimePos` | `time Lat(geocentric) Lon Alt` |
+| `EphemerisGeocentricLLATimePosVel` | `time Lat Lon Alt LatDot LonDot AltDot` |
+| `EphemerisGeodeticLLRTimePos` | `time Lat(geodetic) Lon Radius` |
+| `EphemerisGeodeticLLRTimePosVel` | `time Lat Lon Radius LatDot LonDot RadDot` |
+
+### Covariance Formats
+
+| Format Keyword | Values | Notes |
+|----------------|--------|-------|
+| `CovarianceTimePos` | 6 unique | 3x3 position covariance (m^2) |
+| `CovarianceTimePosVel` | 21 unique | 6x6 pos+vel covariance |
+| `StateErrorTransition` | 36 values | 6x6 state transition matrix |
+
+Covariance keywords: `CovarianceFormat` (LowerTriangular/UpperTriangular), `CovarianceInterpolationMethod`, `CovarianceCoordinateSystem`.
+
+## Interpolation Methods
+
+| Method | Notes |
+|--------|-------|
+| `Lagrange` | Default polynomial interpolation |
+| `Hermite` | Uses velocity for smoother results; requires velocity data |
+| `LagrangeVOP` | Requires mu: `InterpolationMethod LagrangeVOP 3.986e+14` |
+| `GreatArc` | Fixed frame, WGS84 great circle |
+| `GreatArcTerrain` | Terrain-following great arc |
+| `GreatArcMSL` | MSL-following great arc |
+
+## Optional Sections
+
+**SegmentBoundaryTimes:** List of times where interpolation should not cross. Allows duplicate times at boundaries.
+
+**TrendingControl (STK 11.6+):** `TrendingControlTimes` block or `TrendingControlStep <seconds>`.
+
+## Data Conventions
+
+- One data point per line, values separated by at least one space
+- Ascending time order (not necessarily evenly spaced)
+- No duplicate times except at SegmentBoundaryTimes
+- Minimum 90 points per orbital revolution recommended
+- Scientific notation permitted
+- Position-only formats auto-generate velocity via `ComputeVelocity` method
+
+## Example
+
+```
+stk.v.12.0
+BEGIN Ephemeris
+ScenarioEpoch  1 Jan 2003 00:00:00.0
+CentralBody    Earth
+CoordinateSystem J2000
+InterpolationMethod Lagrange
+InterpolationSamplesM1 5
+NumberOfEphemerisPoints 3
+
+EphemerisTimePosVel
+0.0    7000000.0  0.0    0.0    0.0   7500.0   0.0
+60.0   6999500.0  450200.0  10500.0  -100.0   7400.0   50.0
+120.0  6998000.0  897800.0  40200.0  -300.0   7300.0   150.0
+
+END Ephemeris
+```

stk_files-0.0.2/.claude/skills/stk-interval-format.md

@@ -0,0 +1,84 @@
+# STK Interval List File Format (*.int)
+
+Reference for STK 13 external interval list files. Source: AGI/Ansys STK Help `importfiles-04.htm`.
+
+## File Structure
+
+```
+stk.v.12.0
+BEGIN IntervalList
+    ScenarioEpoch <epoch>         (option A: numeric seconds)
+    DateUnitAbrv <abbreviation>   (option B: formatted dates)
+BEGIN Intervals
+    <start> <stop> [optional_data]
+    ...
+END Intervals
+END IntervalList
+```
+
+## Keywords
+
+| Keyword | Required | Description |
+|---------|----------|-------------|
+| `stk.v.X.X` | Yes | Version stamp, must be first line |
+| `BEGIN IntervalList` / `END IntervalList` | Yes | Brackets entire keyword group |
+| `BEGIN Intervals` / `END Intervals` | Yes | Brackets data entries |
+| `ScenarioEpoch` | Option A | `dd mmm yyyy hh:mm:ss.s` (Gregorian UTC). Times as seconds past epoch. |
+| `DateUnitAbrv` | Option B | STK date format abbreviation. Non-numeric times must be quoted. |
+
+All keywords are case-insensitive.
+
+## Time Format Options
+
+### Option A: ScenarioEpoch (numeric seconds)
+```
+ScenarioEpoch 1 Jul 2000 00:00:00.00
+BEGIN Intervals
+    0.000000  3600.000000
+    7200.000000  10800.000000
+END Intervals
+```
+
+### Option B: DateUnitAbrv (formatted dates, quoted)
+```
+DateUnitAbrv UTCG
+BEGIN Intervals
+    "1 Jul 2000 00:00:00.00" "1 Jul 2000 01:30:00.00"
+    "1 Jul 2000 02:00:00.00" "1 Jul 2000 03:00:00.00"
+END Intervals
+```
+
+**Supported abbreviations:** EpSec, UTCG, GPSG, GPSZ, TAIG, TDTG, JDate, ModJDate, YYDDD, YYYYDDD, ISO-YMD, ISO-YD, and others.
+
+**Not supported:** LCLG (local Gregorian), LCLJ (local Julian), Mission Elapsed.
+
+## Data Line Format
+
+Each line: `<start_time> <stop_time> [optional_data_string]`
+
+Non-numerical times must be enclosed in quotes.
+
+## Optional Data Strings
+
+| Field | Examples |
+|-------|----------|
+| Target/Object | `Facility/Philadelphia`, `Satellite/Sat315` |
+| Color | `Color red`, `Color #0000ff` |
+| Pointing target | `Sun`, `Viewer` |
+| 2D Graphics | `Show On`, `Color`, `LineStyle dotted`, `LineWidth 3`, `MarkerStyle Plus` |
+| 3D Graphics | `Show On`, `Color`, `LineWidth 3`, `Translucency 50` |
+
+Invalid optional data is silently ignored.
+
+## Example (ISO-YMD)
+
+```
+stk.v.12.0
+BEGIN IntervalList
+    DateUnitAbrv ISO-YMD
+BEGIN Intervals
+    "2020-01-01T00:00:00.000" "2020-01-01T00:10:00.000"
+    "2020-01-02T00:00:00.000" "2020-01-02T00:20:00.000"
+END Intervals
+END IntervalList
+```

stk_files-0.0.2/.claude/skills/stk-sensor-format.md

@@ -0,0 +1,107 @@
+# STK Sensor Pointing File Format (*.sp)
+
+Reference for STK 13 external sensor pointing files. Source: AGI/Ansys STK Help `importfiles-07.htm`.
+
+## File Structure
+
+```
+stk.v.11.0
+[keywords outside block]
+BEGIN Attitude
+  <FormatKeyword>
+  <time> <data...>
+  ...
+END Attitude
+```
+
+**Note:** Sensor pointing files use `BEGIN Attitude` / `END Attitude` (same block name as attitude files), despite having `.sp` extension.
+
+## Keywords
+
+| Keyword | Required | Description |
+|---------|----------|-------------|
+| `stk.v.X.X` | Yes | Version stamp, must be first line |
+| `BEGIN Attitude` / `END Attitude` | Yes | Brackets data section |
+| `MessageLevel` | No | `Errors`, `Warnings`, or `Verbose` |
+| `CentralBody` | No | Default: parent vehicle's central body |
+| `CoordinateAxes` | No | Reference frame. When unspecified: parent body axes (rotated 180 deg about X for ground objects) |
+| `ScenarioEpoch` | No | Reference epoch: `dd mmm yyyy hh:mm:ss.s` |
+| `TimeFormat` | No | Date format abbreviation |
+| `NumberOfAttitudePoints` | No | Max points to read (recommended) |
+| `Sequence` | Conditional | Rotation order for Euler/YPR/AzEl formats |
+| `RepeatPattern` | No | Cycles data; first/last points should match |
+| `AttitudeDeviations` | No | `Rapid` (default) or `Mild` |
+| `InterpolationMethod` | No | `Lagrange` (default) or `Hermite` |
+| `InterpolationOrder` | No | Default: 1 |
+
+## Coordinate Axes
+
+Same as attitude files: Fixed, J2000, ICRF, Inertial, TrueOfDate, MeanOfDate, plus epoch-dependent and custom AWB.
+
+**Default behavior when unspecified:**
+- **Vehicle parent:** parent's body axes
+- **Facility/Target/Place parent:** parent's body axes rotated 180 degrees about X-axis
+
+## Data Formats
+
+### Quaternion Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeQuaternions` | `time q1 q2 q3 q4` | q4 is scalar (scalar-last) |
+| `AttitudeTimeQuatScalarFirst` | `time q1 q2 q3 q4` | q1 is scalar |
+
+### Angle Formats
+
+| Format Keyword | Columns | Notes |
+|----------------|---------|-------|
+| `AttitudeTimeEulerAngles` | `time rotA rotB rotC` | Degrees. Requires `Sequence`. |
+| `AttitudeTimeYPRAngles` | `time Y P R` | Degrees. Data always in Y-P-R order. |
+| `AttitudeTimeAzElAngles` | `time azimuth elevation` | Degrees. Sensor-specific format. |
+
+### AzElAngles Details
+
+- **Azimuth:** positive counter-clockwise about +Z axis (vehicles) or -Z axis (ground locations)
+- **Elevation:** degrees above XY plane, positive toward +Z axis
+- Third rotation is always 0.0 (not provided in data)
+
+## Rotation Sequences
+
+**Euler sequences:** 121, 123, 131, 132, 212, 213, 231, 232, 312, 313, 321, 323 (default: 313)
+
+**YPR sequences:** 123, 132, 213, 231, 312 (default: **312**, differs from attitude file default of 321)
+
+**AzEl sequences:** 323 (default, "Rotate About Boresight"), 213 ("Hold About Boresight")
+
+## Data Conventions
+
+- One data point per line, values separated by at least one space
+- Ascending time order, no duplicate timestamps
+- For dynamic attitudes: 3-4 points per revolution minimum
+- Sensor boresight is the Z-axis of the sensor body frame
+
+## Example (AzEl)
+
+```
+stk.v.11.0
+ScenarioEpoch 1 Jan 2003 00:00:00.0
+Sequence 323
+BEGIN Attitude
+AttitudeTimeAzElAngles
+0.0    45.0  30.0
+3600.0 90.0  45.0
+7200.0 135.0 60.0
+END Attitude
+```
+
+## Example (Quaternions)
+
+```
+stk.v.11.0
+CoordinateAxes J2000
+BEGIN Attitude
+AttitudeTimeQuaternions
+0.0     0.0  0.0  0.0  1.0
+3600.0  0.1  0.2  0.3  0.9274
+END Attitude
+```

stk_files-0.0.2/.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: "Publish"
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install Python 3.13
+        run: uv python install 3.13
+
+      - name: Build
+        run: uv build
+
+      - name: Publish
+        run: uv publish

stk_files-0.0.2/.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: Test
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - name: Install uv and set the Python version
+      uses: astral-sh/setup-uv@v7
+      with:
+        enable-cache: true
+        python-version: ${{ matrix.python-version }}
+      
+    - name: Install the project
+      run: uv sync --locked --all-extras --dev
+
+    - name: Run pytest
+      run: uv run pytest tests/

stk_files-0.0.2/.gitignore

@@ -0,0 +1,139 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+**/_version.py
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# VSCode
+.vscode/
+
+# ruff
+.ruff_cache/
+
+# claude
+.claude/settings.local.json

stk_files-0.0.2/CLAUDE.md

@@ -0,0 +1,50 @@
+# CLAUDE.md — stk-files
+
+## What this is
+
+Python package for generating STK (Systems Tool Kit) external data files. Provides a programmatic API and CLI to write attitude, ephemeris, sensor pointing, and interval list data in STK-compatible formats.
+
+## Quick reference
+
+```bash
+uv sync                    # Install dependencies
+pytest                     # Run tests
+ruff check src/ tests/     # Lint
+ruff format src/ tests/    # Format
+mypy src/                  # Type check (strict mode)
+```
+
+## Project layout
+
+- `src/stk_files/` — package source
+  - `attitude.py`, `ephemeris.py`, `interval.py`, `sensor.py` — file type modules (each has a frozen Config dataclass + `write_*` function)
+  - `_types.py` — type literals, column count dicts, format constants
+  - `_validation.py` — shape/quaternion/angle/sequence validation + filtering
+  - `_formatting.py` — row formatting (ISO-YMD timestamps, EpSec, quaternions, generic)
+  - `_coerce.py` — runtime coercion of pandas/polars Series/DataFrames to numpy arrays
+  - `_writer.py` — `stk_writer()` context manager, `RowWriter`
+  - `cli.py` — Click CLI with subcommands (attitude, ephemeris, interval, sensor)
+  - `__init__.py` — public API exports
+- `tests/` — pytest + hypothesis tests
+  - `strategies.py` — custom hypothesis strategies (quaternions, angles, sorted datetimes)
+
+## Conventions
+
+- **Python >=3.9**, strict mypy, ruff (line-length 99)
+- Private modules prefixed with `_`, config classes suffixed with `Config`
+- `from __future__ import annotations` in all modules
+- Timestamps are `np.datetime64[ms]`; data arrays are numpy ndarrays (pandas/polars inputs are coerced automatically via `_coerce.py`)
+- pandas and polars are optional dependencies (`pip install stk-files[pandas]` / `stk-files[polars]`)
+- Validation has strict mode (raise on invalid) and non-strict (filter invalid rows)
+- Frozen dataclasses for configs; each config has `header()` and `footer()` methods
+- Tests use hypothesis property-based testing with custom strategies in `strategies.py`
+
+## Adding a new file format
+
+1. Add type literals and column counts to `_types.py`
+2. Add validation rules to `_validation.py` if needed
+3. Add formatter to `_formatting.py` if special formatting needed
+4. Create module with Config dataclass and `write_*` function
+5. Export in `__init__.py`
+6. Add CLI subcommand in `cli.py`
+7. Add tests with hypothesis strategies