torchsky 0.5.0__tar.gz

torchsky-0.5.0/.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Tree-wide ruff format (0.5.0rc1 cleanup)
+93db0c13454e197d50d30980c4ecff6393d82bc3

torchsky-0.5.0/.gitattributes

@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true

torchsky-0.5.0/.gitignore

@@ -0,0 +1,60 @@
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pixi/
+.venv/
+venv/
+.cache/
+.coverage
+htmlcov/
+.ipynb_checkpoints/
+
+# Editor / OS
+.DS_Store
+.vscode/
+*.swp
+*~
+
+# Build and packaging
+build/
+dist/
+wheelhouse/
+_skbuild/
+site/
+*.egg-info/
+*.whl
+*.conda
+*.tar.gz
+src/torchsky/_cpp*.so
+.tmp-vendor/
+
+# Local run output
+*.log
+mpl-cache-*/
+scratch/
+benchmark_results*/
+benchmarks_results*/
+bench_results/
+
+# Fetched / generated data (tests/data and docs/data are tracked)
+*.fits
+!tests/data/**/*.fits
+examples/data_*/
+examples/output/
+
+# Generated at docs-build time (sources: examples/, docs/gallery)
+docs/published-examples/
+
+# Agent tooling and local research notes, not project code
+.claude/
+.cursor/
+.agents/
+.codex/
+.jules/
+.opencode/
+.freebuff/
+.dsh/
+notes/

torchsky-0.5.0/.pre-commit-config.yaml

@@ -0,0 +1,19 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+  # Pyright runs in CI (pixi run typecheck), not per commit.
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+        types_or: [python, pyi]
+      - id: ruff-format
+        types_or: [python, pyi]

torchsky-0.5.0/CITATION.cff

@@ -0,0 +1,18 @@
+cff-version: 1.2.0
+message: "If you use torchsky in your research, please cite it as below."
+title: "torchsky"
+abstract: "Torch-native sky data, coordinates, geometry, and mapmaking."
+type: software
+authors:
+  - family-names: Fabbro
+    given-names: Sébastien
+version: 0.5.0
+license: MIT
+repository-code: "https://github.com/astroai/torchsky"
+url: "https://astroai.github.io/torchsky/"
+keywords:
+  - astronomy
+  - pytorch
+  - wcs
+  - healpix
+  - mapmaking

torchsky-0.5.0/CMakeLists.txt

@@ -0,0 +1,10 @@
+cmake_minimum_required(VERSION 3.15)
+project(torchsky)
+
+if(DEFINED ENV{TORCHSKY_DISABLE_CPP} AND "$ENV{TORCHSKY_DISABLE_CPP}" STREQUAL "1")
+    message(STATUS "TORCHSKY_DISABLE_CPP=1: skipping native extension build")
+    return()
+endif()
+
+# Add the actual CMake project as a subdirectory
+add_subdirectory(src/torchsky/cpp_src)

torchsky-0.5.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,119 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers via a private GitHub security advisory or
+the maintainer contact listed on the GitHub profile. All complaints will be
+reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

torchsky-0.5.0/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to torchsky
+
+Thanks for your interest. torchsky is a torch-native astronomy stack (WCS,
+HEALPix, mapmaking, observation operators, field models). Please read the
+[Code of Conduct](CODE_OF_CONDUCT.md) first. The full guide is
+[docs/project/contributing.md](docs/project/contributing.md); repository policy for coding
+agents and maintainers is in [AGENTS.md](AGENTS.md).
+
+## Setup
+
+torchsky uses [pixi](https://pixi.sh/). Use `pixi run ...` for all Python; do not
+call a bare `python` from your shell.
+
+```bash
+git clone https://github.com/<you>/torchsky.git
+cd torchsky
+pixi install
+pixi run dev        # build the native extension
+pixi run verify     # import smoke test
+pixi run setup-hooks  # optional pre-push hook (ruff + compileall)
+```
+
+## Checks
+
+```bash
+pixi run preflight-push                           # ruff + compileall
+pixi run -e test -- pytest tests/test_foo.py      # targeted tests
+pixi run test                                     # main suite (excludes map tests)
+pixi run -e test -- pytest -n 4 -q tests/test_map_*.py   # map tests
+pixi run typecheck                                # pyright, when types change
+pixi run docs-contract                            # strict docs build and docs tests
+pixi run examples                                 # example smoke runner
+```
+
+Run the targeted tests for what you changed; CI runs the full suite.
+
+## Pull requests
+
+- Fork, branch from `main`, and open a single focused PR against `main`.
+- Add tests for behavior changes (bounded unit, regression, adjoint, gradient,
+  or device contracts). Scientific benchmarks live in
+  [torchsky-harness](https://github.com/astroai/torchsky-harness).
+- Performance PRs state the bottleneck removed, why it scales, and the
+  benchmark evidence.
+- Public API changes update the matching guide, `docs/reference/_registry.toml`,
+  and `docs/api-manifest.json` (`pixi run api-manifest`).
+- Keep FITS I/O in [torchfits](https://github.com/astroai/torchfits); never
+  import `astropy.io.fits` or `fitsio`.
+- Add a line to `docs/project/changelog.md` for user-visible changes.
+
+Maintainers: see [docs/project/release.md](docs/project/release.md) for releases.

torchsky-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sébastien Fabbro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

torchsky-0.5.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: torchsky
+Version: 0.5.0
+Summary: Torch-native sky data, coordinates, geometry, and mapmaking
+Keywords: astronomy,pytorch,tensor,wcs,healpix,mapmaking,coadd,differentiable,machine-learning
+Author-Email: Seb Fabbro <sebfabbro@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+License-File: src/torchsky/cpp_src/third_party/pocketfft.LICENSE.md
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: C++
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Project-URL: Homepage, https://github.com/astroai/torchsky
+Project-URL: Repository, https://github.com/astroai/torchsky
+Project-URL: Documentation, https://astroai.github.io/torchsky/
+Project-URL: Changelog, https://astroai.github.io/torchsky/project/changelog/
+Project-URL: Issues, https://github.com/astroai/torchsky/issues
+Requires-Python: >=3.12
+Requires-Dist: torch<2.15,>=2.14
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: torchfits>=1.3.1
+Provides-Extra: docs
+Requires-Dist: zensical<0.1,>=0.0.71; extra == "docs"
+Requires-Dist: mkdocstrings-python<2,>=1.16; extra == "docs"
+Provides-Extra: viz
+Requires-Dist: fastapi>=0.110; extra == "viz"
+Requires-Dist: uvicorn[standard]>=0.29; extra == "viz"
+Requires-Dist: pillow>=10.0; extra == "viz"
+Requires-Dist: matplotlib>=3.8; extra == "viz"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: ruff<0.16,>=0.15.5; extra == "dev"
+Requires-Dist: ipykernel; extra == "dev"
+Requires-Dist: pyright>=1.1.350; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=6.0; extra == "test"
+Requires-Dist: pytest-cov>=2.0; extra == "test"
+Requires-Dist: pytest-xdist>=3.0; extra == "test"
+Requires-Dist: psutil>=5.0; extra == "test"
+Requires-Dist: fastapi>=0.110; extra == "test"
+Requires-Dist: httpx>=0.27; extra == "test"
+Requires-Dist: pillow>=10.0; extra == "test"
+Requires-Dist: scipy>=1.9.0; extra == "test"
+Requires-Dist: requests>=2.28.0; extra == "test"
+Requires-Dist: polars>=1.0; extra == "test"
+Requires-Dist: pyarrow>=14.0; extra == "test"
+Requires-Dist: pandas>=2.2; extra == "test"
+Requires-Dist: astropy>=5.0; extra == "test"
+Requires-Dist: matplotlib>=3.8; extra == "test"
+Requires-Dist: pyright>=1.1.350; extra == "test"
+Provides-Extra: examples
+Requires-Dist: polars>=1.0; extra == "examples"
+Requires-Dist: pyarrow>=14.0; extra == "examples"
+Requires-Dist: pandas>=2.2; extra == "examples"
+Requires-Dist: astropy>=5.0; extra == "examples"
+Provides-Extra: map
+Requires-Dist: astropy>=5.0; extra == "map"
+Requires-Dist: astroquery>=0.4.6; extra == "map"
+Provides-Extra: ephem
+Requires-Dist: jplephem>=2.17; extra == "ephem"
+Provides-Extra: tle
+Requires-Dist: sgp4>=2.21; extra == "tle"
+Provides-Extra: gwcs
+Requires-Dist: gwcs>=0.18; extra == "gwcs"
+Description-Content-Type: text/markdown
+
+# torchsky
+
+[![CI](https://github.com/astroai/torchsky/actions/workflows/ci.yml/badge.svg)](https://github.com/astroai/torchsky/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-astroai.github.io%2Ftorchsky-brightgreen)](https://astroai.github.io/torchsky/)
+[![PyPI](https://img.shields.io/pypi/v/torchsky)](https://pypi.org/project/torchsky/)
+[![Python 3.12-3.14](https://img.shields.io/badge/python-3.12%E2%80%933.14-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/astroai/torchsky/blob/main/LICENSE)
+
+Sky coordinates, spherical geometry, and mapmaking as PyTorch tensor operations.
+They run on CPU, CUDA, and MPS, support autograd, and scale to survey-sized inputs.
+
+torchsky covers FITS-WCS, HEALPix, spherical harmonic transforms, catalog
+crossmatch, image coadds, spectral cubes, and observation operators. FITS reading
+and writing is handled by [torchfits](https://github.com/astroai/torchfits), which
+torchsky installs as a dependency.
+
+## Install
+
+Stable releases, from 0.5.0, are on PyPI: `pip install torchsky`. Release
+candidates are only [GitHub pre-releases](https://github.com/astroai/torchsky/releases)
+and are never uploaded to PyPI. Building from source needs a C++ compiler and
+CMake for the native extension:
+
+```bash
+git clone https://github.com/astroai/torchsky.git
+cd torchsky
+pip install .
+```
+
+torchsky supports Python 3.12 to 3.14 with PyTorch 2.14. The
+[installation guide](https://astroai.github.io/torchsky/introduction/install/) covers CUDA,
+Pixi, and troubleshooting.
+
+## Quick start
+
+```python
+import torch
+import torchsky.sphere as sphere
+from torchsky.map import Observation, coadd, plan
+from torchsky.wcs import WCS
+
+header = {"NAXIS": 2, "NAXIS1": 64, "NAXIS2": 64,
+          "CTYPE1": "RA---TAN", "CTYPE2": "DEC--TAN", "CRPIX1": 32.5, "CRPIX2": 32.5,
+          "CRVAL1": 150.0, "CRVAL2": 2.0, "CDELT1": -2.8e-4, "CDELT2": 2.8e-4}
+
+ra, dec = WCS(header).pixel_to_world(torch.tensor([0.0, 63.0]), torch.tensor([0.0, 63.0]))
+pix = sphere.ang2pix(1024, ra, dec, lonlat=True, nest=True)
+
+obs = [Observation(data=torch.randn(64, 64), wcs={**header, "CRVAL1": c}) for c in (150.0, 150.01)]
+result = coadd(obs, plan(obs, projection="TAN"), kernel="bilinear")
+```
+
+For real files, read them with torchfits and pass the header on:
+`data, header = torchfits.read("image.fits", return_header=True)`.
+
+## What's in the box
+
+| Namespace | Contents |
+|---|---|
+| `torchsky.wcs` | FITS-WCS projections, SIP/TPV distortions, affine fitting |
+| `torchsky.sphere` | HEALPix, MOC, sparse maps, polygons, spin SHT |
+| `torchsky.coords` | Frame conversion, observed alt/az, proper motion |
+| `torchsky.catalogs` | Crossmatch and spherical partitioning |
+| `torchsky.map` | Coadds, spectral cubes, observation operators, solvers |
+| `torchsky.spectral` and friends | Spectra, photometry, extinction, cosmology |
+| `torchsky.scene`, `torchsky.field` | Forward models and continuous sky fields (experimental) |
+
+## Performance
+
+On 135 JWST/NIRCam exposures (566 Mpix) onto a 512 x 512 grid, torchsky's
+Lanczos-3 coadd takes 14.3 s on 8 CPU threads and 5.2 s on a GPU slice, against
+30.1 s for SWarp. Its drizzle matches STScI drizzle to better than 2e-6 sigma. A
+280-CCD UNIONS tile coadd fell from 2292 s to 711 s on CPU. Hardware, versions,
+and evidence are on the
+[performance highlights](https://astroai.github.io/torchsky/performance/highlights/)
+page.
+
+## Documentation
+
+- [Quick start](https://astroai.github.io/torchsky/introduction/quickstart/) and
+  [examples](https://astroai.github.io/torchsky/examples/)
+- [User guide and API reference](https://github.com/astroai/torchsky/blob/main/docs/index.md)
+  (rendered at [astroai.github.io/torchsky](https://astroai.github.io/torchsky/))
+- [Coming from Astropy, healpy, or reproject](https://astroai.github.io/torchsky/introduction/coming-from/)
+- [Changelog](https://astroai.github.io/torchsky/project/changelog/)
+
+## Contributing
+
+Development uses [pixi](https://pixi.sh):
+
+```bash
+git clone https://github.com/astroai/torchsky.git && cd torchsky
+pixi install --locked
+pixi run dev              # build the native extension in place
+pixi run preflight-push   # lint + compile check
+pixi run test             # unit suite
+```
+
+Read [CONTRIBUTING.md](https://github.com/astroai/torchsky/blob/main/CONTRIBUTING.md)
+before opening a PR. Issues labelled
+[good first issue](https://github.com/astroai/torchsky/labels/good%20first%20issue)
+are a good place to start.
+
+## Citation
+
+If torchsky helps your research, please cite it using
+[CITATION.cff](https://github.com/astroai/torchsky/blob/main/CITATION.cff).
+
+## License
+
+[MIT](https://github.com/astroai/torchsky/blob/main/LICENSE)

torchsky-0.5.0/README.md

@@ -0,0 +1,111 @@
+# torchsky
+
+[![CI](https://github.com/astroai/torchsky/actions/workflows/ci.yml/badge.svg)](https://github.com/astroai/torchsky/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-astroai.github.io%2Ftorchsky-brightgreen)](https://astroai.github.io/torchsky/)
+[![PyPI](https://img.shields.io/pypi/v/torchsky)](https://pypi.org/project/torchsky/)
+[![Python 3.12-3.14](https://img.shields.io/badge/python-3.12%E2%80%933.14-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/astroai/torchsky/blob/main/LICENSE)
+
+Sky coordinates, spherical geometry, and mapmaking as PyTorch tensor operations.
+They run on CPU, CUDA, and MPS, support autograd, and scale to survey-sized inputs.
+
+torchsky covers FITS-WCS, HEALPix, spherical harmonic transforms, catalog
+crossmatch, image coadds, spectral cubes, and observation operators. FITS reading
+and writing is handled by [torchfits](https://github.com/astroai/torchfits), which
+torchsky installs as a dependency.
+
+## Install
+
+Stable releases, from 0.5.0, are on PyPI: `pip install torchsky`. Release
+candidates are only [GitHub pre-releases](https://github.com/astroai/torchsky/releases)
+and are never uploaded to PyPI. Building from source needs a C++ compiler and
+CMake for the native extension:
+
+```bash
+git clone https://github.com/astroai/torchsky.git
+cd torchsky
+pip install .
+```
+
+torchsky supports Python 3.12 to 3.14 with PyTorch 2.14. The
+[installation guide](https://astroai.github.io/torchsky/introduction/install/) covers CUDA,
+Pixi, and troubleshooting.
+
+## Quick start
+
+```python
+import torch
+import torchsky.sphere as sphere
+from torchsky.map import Observation, coadd, plan
+from torchsky.wcs import WCS
+
+header = {"NAXIS": 2, "NAXIS1": 64, "NAXIS2": 64,
+          "CTYPE1": "RA---TAN", "CTYPE2": "DEC--TAN", "CRPIX1": 32.5, "CRPIX2": 32.5,
+          "CRVAL1": 150.0, "CRVAL2": 2.0, "CDELT1": -2.8e-4, "CDELT2": 2.8e-4}
+
+ra, dec = WCS(header).pixel_to_world(torch.tensor([0.0, 63.0]), torch.tensor([0.0, 63.0]))
+pix = sphere.ang2pix(1024, ra, dec, lonlat=True, nest=True)
+
+obs = [Observation(data=torch.randn(64, 64), wcs={**header, "CRVAL1": c}) for c in (150.0, 150.01)]
+result = coadd(obs, plan(obs, projection="TAN"), kernel="bilinear")
+```
+
+For real files, read them with torchfits and pass the header on:
+`data, header = torchfits.read("image.fits", return_header=True)`.
+
+## What's in the box
+
+| Namespace | Contents |
+|---|---|
+| `torchsky.wcs` | FITS-WCS projections, SIP/TPV distortions, affine fitting |
+| `torchsky.sphere` | HEALPix, MOC, sparse maps, polygons, spin SHT |
+| `torchsky.coords` | Frame conversion, observed alt/az, proper motion |
+| `torchsky.catalogs` | Crossmatch and spherical partitioning |
+| `torchsky.map` | Coadds, spectral cubes, observation operators, solvers |
+| `torchsky.spectral` and friends | Spectra, photometry, extinction, cosmology |
+| `torchsky.scene`, `torchsky.field` | Forward models and continuous sky fields (experimental) |
+
+## Performance
+
+On 135 JWST/NIRCam exposures (566 Mpix) onto a 512 x 512 grid, torchsky's
+Lanczos-3 coadd takes 14.3 s on 8 CPU threads and 5.2 s on a GPU slice, against
+30.1 s for SWarp. Its drizzle matches STScI drizzle to better than 2e-6 sigma. A
+280-CCD UNIONS tile coadd fell from 2292 s to 711 s on CPU. Hardware, versions,
+and evidence are on the
+[performance highlights](https://astroai.github.io/torchsky/performance/highlights/)
+page.
+
+## Documentation
+
+- [Quick start](https://astroai.github.io/torchsky/introduction/quickstart/) and
+  [examples](https://astroai.github.io/torchsky/examples/)
+- [User guide and API reference](https://github.com/astroai/torchsky/blob/main/docs/index.md)
+  (rendered at [astroai.github.io/torchsky](https://astroai.github.io/torchsky/))
+- [Coming from Astropy, healpy, or reproject](https://astroai.github.io/torchsky/introduction/coming-from/)
+- [Changelog](https://astroai.github.io/torchsky/project/changelog/)
+
+## Contributing
+
+Development uses [pixi](https://pixi.sh):
+
+```bash
+git clone https://github.com/astroai/torchsky.git && cd torchsky
+pixi install --locked
+pixi run dev              # build the native extension in place
+pixi run preflight-push   # lint + compile check
+pixi run test             # unit suite
+```
+
+Read [CONTRIBUTING.md](https://github.com/astroai/torchsky/blob/main/CONTRIBUTING.md)
+before opening a PR. Issues labelled
+[good first issue](https://github.com/astroai/torchsky/labels/good%20first%20issue)
+are a good place to start.
+
+## Citation
+
+If torchsky helps your research, please cite it using
+[CITATION.cff](https://github.com/astroai/torchsky/blob/main/CITATION.cff).
+
+## License
+
+[MIT](https://github.com/astroai/torchsky/blob/main/LICENSE)

torchsky-0.5.0/SECURITY.md

@@ -0,0 +1,16 @@
+# Security policy
+
+## Supported versions
+
+Security fixes are made on the latest released minor version and on `main`.
+
+## Reporting a vulnerability
+
+Please do not open a public issue for security problems. Use GitHub private
+vulnerability reporting: open the **Security** tab of
+[astroai/torchsky](https://github.com/astroai/torchsky/security) and choose
+**Report a vulnerability**.
+
+Include the affected version, a minimal reproduction, and the impact you
+expect. We aim to acknowledge reports within a few days and will coordinate a
+fix and disclosure timeline with you.