MIRaGe = Multi Instrument Ramp Generator
This repository contains code that can be used to generate simulated NIRCam, NIRISS, or FGS data. These data can be in one of two formats:
raw - No calibrations applied. Detector level effects such as non-linearity,
superbias, etc are still present.
linearized - Detector level effects have been removed, and data have been
linearized, but are still in ramp format, where multiple non-destructive
reads of the detector are present.
Installation and Documentation
The main documentation for Mirage is located on ReadTheDocs. Detailed installation instructions can be found there.
Examples
See the notebooks in the examples subdirectory. There are notebooks
for imaging simulations, WFSS simulations, moving target
(non-sidereal) simulations, and simulations of OTE commissioning.
Citation
If you find this package useful, please consider citing the Zenodo record using the DOI badge above. Please find additional citation instructions in CITATION.
Contributing
Prior to contributing to the mirage development, please review our style guide.
Contibutors should use a "forking workflow" when making contributions to the project.
Code of Conduct
Users and contributors to the mirage repository should adhere to the Code of Conduct. Any issues or violations pertaining to the Code of Conduct should be brought to the attention of a mirage team member or to conduct@stsci.edu.
Questions
For any questions about the mirage project or its software or documentation, please open an Issue.
Current Development Team
- Bryan Hilbert @bhilbert4
- Joe Filippazzo @hover2pi
- Nor Pirzkal @NorPirzkal
Acknowledgments:
Mirage is based on a NIRISS data simulator originally written by Kevin Volk.
Metadata
Release files for mirage 2.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mirage-2.5.0.tar.gz | 14.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mirage-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.7 MB
Release files / mirage-2.5.0.tar.gz
| Download URL | mirage-2.5.0.tar.gz |
|---|---|
| Size | 14.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a5972bb3037f1e514635cf1834b3d5a1a62e5f4d3a604e52b4f91e5e25de85ec
|
|
BLAKE2b-256 checksum How to use checksums |
162e010cdd66447221ef4f9d95b0d24e5bb0b339eabea4da2bdc01e45f24d65e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency logRelease files / mirage-2.5.0-py3-none-any.whl
| Download URL | mirage-2.5.0-py3-none-any.whl |
|---|---|
| Size | 8.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1f31451d93b3b5a8d54708078009620c59b588424d0a323eb4f1cb665d0e6f1c
|
|
BLAKE2b-256 checksum How to use checksums |
8ad001bb0b8e49b92b931763137c40b4bf21ed847d08d7e873ac480f76f50eb8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency log