space-ml-sim 0.3.0__tar.gz

space_ml_sim-0.3.0/.github/CODEOWNERS

@@ -0,0 +1,18 @@
+# Default owner for everything
+* @yaitsmesj
+
+# Critical paths — require explicit review from maintainer
+src/space_ml_sim/compute/fault_injector.py @yaitsmesj
+src/space_ml_sim/compute/tmr.py @yaitsmesj
+src/space_ml_sim/compute/transformer_fault.py @yaitsmesj
+src/space_ml_sim/environment/radiation.py @yaitsmesj
+src/space_ml_sim/core/orbit.py @yaitsmesj
+src/space_ml_sim/models/chip_profiles.py @yaitsmesj
+
+# License and legal
+LICENSE @yaitsmesj
+COMMERCIAL_LICENSE.md @yaitsmesj
+
+# CI and security
+.github/ @yaitsmesj
+pyproject.toml @yaitsmesj

space_ml_sim-0.3.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,33 @@
+name: Bug Report
+description: Report a bug in space-ml-sim
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Minimal code or steps to reproduce the issue.
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: |
+        - OS:
+        - Python version:
+        - space-ml-sim version:
+        - PyTorch version:
+      render: text
+    validations:
+      required: false

space_ml_sim-0.3.0/.github/ISSUE_TEMPLATE/commercial-license.yml

@@ -0,0 +1,32 @@
+name: Commercial License Inquiry
+description: Inquire about commercial licensing for proprietary use
+labels: ["commercial-license"]
+body:
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Use case
+      description: Briefly describe how you plan to use space-ml-sim.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: org_type
+    attributes:
+      label: Organization type
+      options:
+        - Startup
+        - Enterprise
+        - Government / Defense
+        - Academic (grant-funded)
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: contact
+    attributes:
+      label: Contact
+      description: Preferred way to reach you (email, LinkedIn, etc.)
+    validations:
+      required: true

space_ml_sim-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,35 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve? What use case does it enable?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How should this work? Include code examples if helpful.
+    validations:
+      required: false
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Orbital mechanics
+        - Radiation environment
+        - Fault injection
+        - Fault tolerance (TMR)
+        - Chip profiles
+        - Visualization
+        - Documentation
+        - Other
+    validations:
+      required: true

space_ml_sim-0.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## Summary
+
+<!-- What does this PR do? 1-3 bullet points. -->
+
+## Changes
+
+<!-- List the key changes. -->
+
+## Test plan
+
+- [ ] New tests added for changed behavior
+- [ ] All existing tests pass (`pytest tests/ -v`)
+- [ ] Linting passes (`ruff check src/ tests/`)
+
+## Notes
+
+<!-- Anything reviewers should know? Breaking changes? -->

space_ml_sim-0.3.0/.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+    commit-message:
+      prefix: "chore(deps):"
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 3
+    labels:
+      - ci
+    commit-message:
+      prefix: "ci(deps):"

space_ml_sim-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,208 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+          pip install torchvision pytest-cov
+
+      - name: Run tests with coverage
+        run: |
+          python -m pytest tests/ -v \
+            --cov=space_ml_sim \
+            --cov-report=term-missing \
+            --cov-report=xml:coverage.xml \
+            --cov-fail-under=80
+
+      - name: Upload coverage artifact
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.xml
+
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Check linting
+        run: ruff check src/ tests/
+
+      - name: Check formatting
+        run: ruff format --check src/ tests/
+
+  security:
+    name: Security Scanning
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install project and security tools
+        run: |
+          pip install -e ".[dev]"
+          pip install pip-audit bandit
+
+      - name: Dependency vulnerability scan
+        run: |
+          pip freeze --exclude-editable > /tmp/requirements.txt
+          pip-audit --desc -r /tmp/requirements.txt \
+            --ignore-vuln CVE-2026-4539 \
+            || echo "::warning::pip-audit found vulnerabilities — review output above"
+
+      - name: Code security scan (bandit)
+        run: bandit -r src/ -c pyproject.toml -f json -o bandit-report.json || true
+
+      - name: Check bandit results
+        run: |
+          pip install bandit
+          bandit -r src/ -c pyproject.toml -ll
+
+      - name: Upload security report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: bandit-report
+          path: bandit-report.json
+          if-no-files-found: ignore
+
+  license-check:
+    name: License Compliance
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install project and license tool
+        run: |
+          pip install -e .
+          pip install pip-licenses
+
+      - name: Check dependency licenses
+        run: |
+          pip-licenses --format=table --with-license-file --no-license-path \
+            --fail-on="GNU General Public License v2 (GPLv2);GNU General Public License v3 (GPLv3)" \
+            --allow-only="MIT;BSD License;BSD-2-Clause;BSD-3-Clause;Apache Software License;ISC License (ISCL);Python Software Foundation License;Mozilla Public License 2.0 (MPL 2.0);The Unlicense (Unlicense);Public Domain;HPND;Historical Permission Notice and Disclaimer (HPND)" \
+            || echo "::warning::Some dependencies have non-standard licenses. Review pip-licenses output above."
+
+  benchmark:
+    name: Performance Benchmark
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+          pip install torchvision
+
+      - name: Run performance benchmarks
+        run: |
+          python -c "
+          import time, json, copy, torch, torch.nn as nn
+          from space_ml_sim.compute.fault_injector import FaultInjector
+          from space_ml_sim.environment.radiation import RadiationEnvironment
+          from space_ml_sim.models.chip_profiles import TERAFAB_D3
+          from space_ml_sim.core import Constellation
+
+          results = {}
+
+          # Benchmark 1: Fault injection speed (1000 faults into a small model)
+          model = nn.Sequential(nn.Linear(512, 512), nn.ReLU(), nn.Linear(512, 10))
+          injector = FaultInjector(RadiationEnvironment.leo_500km(), TERAFAB_D3)
+          start = time.perf_counter()
+          for _ in range(50):
+              m = copy.deepcopy(model)
+              injector.inject_weight_faults(m, num_faults=1000)
+          fault_time = (time.perf_counter() - start) / 50
+          results['fault_injection_1k_ms'] = round(fault_time * 1000, 2)
+
+          # Benchmark 2: Constellation step (100 sats, 1 step)
+          c = Constellation.walker_delta(10, 10, 550, 53, TERAFAB_D3)
+          start = time.perf_counter()
+          for _ in range(10):
+              c.step(dt_seconds=60.0)
+          step_time = (time.perf_counter() - start) / 10
+          results['constellation_step_100sats_ms'] = round(step_time * 1000, 2)
+
+          # Benchmark 3: Orbit propagation (1 orbit, 1s steps)
+          from space_ml_sim.core.orbit import OrbitConfig, propagate
+          config = OrbitConfig(altitude_km=550, inclination_deg=53, raan_deg=0, true_anomaly_deg=0)
+          start = time.perf_counter()
+          propagate(config, duration_minutes=95, step_seconds=1.0)
+          prop_time = time.perf_counter() - start
+          results['propagate_1orbit_1s_steps_ms'] = round(prop_time * 1000, 2)
+
+          print('=== BENCHMARK RESULTS ===')
+          for k, v in results.items():
+              print(f'{k}: {v} ms')
+
+          # Write results for comparison
+          with open('benchmark-results.json', 'w') as f:
+              json.dump(results, f, indent=2)
+
+          # Fail if any benchmark is unreasonably slow
+          assert results['fault_injection_1k_ms'] < 500, f\"Fault injection too slow: {results['fault_injection_1k_ms']}ms\"
+          assert results['constellation_step_100sats_ms'] < 1000, f\"Constellation step too slow: {results['constellation_step_100sats_ms']}ms\"
+          assert results['propagate_1orbit_1s_steps_ms'] < 2000, f\"Propagation too slow: {results['propagate_1orbit_1s_steps_ms']}ms\"
+          print('All benchmarks within limits.')
+          "
+
+      - name: Upload benchmark results
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results
+          path: benchmark-results.json

space_ml_sim-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,89 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+
+jobs:
+  validate:
+    name: Validate Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+          pip install torchvision pytest-cov
+
+      - name: Verify tag matches pyproject.toml version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          TOML_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$TAG_VERSION" != "$TOML_VERSION" ]; then
+            echo "::error::Tag version ($TAG_VERSION) does not match pyproject.toml ($TOML_VERSION)"
+            exit 1
+          fi
+          echo "Version match: $TAG_VERSION"
+
+      - name: Run full test suite
+        run: python -m pytest tests/ -v --cov=space_ml_sim --cov-fail-under=80
+
+      - name: Run security scan
+        run: |
+          pip install pip-audit bandit
+          pip freeze --exclude-editable > /tmp/requirements.txt
+          pip-audit --desc -r /tmp/requirements.txt \
+            --ignore-vuln CVE-2026-4539
+          bandit -r src/ -c pyproject.toml -ll
+
+  build:
+    name: Build Package
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

space_ml_sim-0.3.0/.gitignore

@@ -0,0 +1,26 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+env/
+.env
+*.pth
+*.pt
+*.onnx
+data/
+*.png
+*.jpg
+*.html
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.DS_Store

space_ml_sim-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.9
+    hooks:
+      - id: bandit
+        args: [-c, pyproject.toml, -r, src/]
+        additional_dependencies: ["bandit[toml]"]
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: [--baseline, .secrets.baseline]
+        exclude: LICENSE
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.3.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: [feat, fix, refactor, docs, test, chore, perf, ci, style]

space_ml_sim-0.3.0/.secrets.baseline

@@ -0,0 +1,133 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    },
+    {
+      "path": "detect_secrets.filters.regex.should_exclude_file",
+      "pattern": [
+        "LICENSE"
+      ]
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-03-26T15:53:05Z"
+}

space_ml_sim-0.3.0/CITATION.cff

@@ -0,0 +1,26 @@
+cff-version: 1.2.0
+title: "space-ml-sim: Simulation Framework for AI Inference on Orbital Satellite Constellations"
+message: "If you use this software in your research, please cite it using the metadata from this file."
+type: software
+authors:
+  - name: "space-ml-sim contributors"
+repository-code: "https://github.com/yaitsmesj/space-ml-sim"
+url: "https://github.com/yaitsmesj/space-ml-sim"
+license: AGPL-3.0-or-later
+version: 0.3.0
+date-released: "2026-04-04"
+keywords:
+  - satellite
+  - space radiation
+  - fault injection
+  - neural network reliability
+  - triple modular redundancy
+  - orbital computing
+  - LEO
+abstract: >-
+  space-ml-sim is a simulation framework for studying the effects of
+  space radiation on AI inference running aboard orbital satellite
+  constellations. It provides parametric radiation environment models,
+  ML-aware fault injection into PyTorch models, fault tolerance
+  strategies (TMR, selective TMR, checkpoint rollback), and orbital
+  mechanics for LEO constellation simulation.