Skip to content
This code can be used to generate simulated NIRCam, NIRISS, or FGS data
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
examples
mirage Tweak tests, and clean up Nov 20, 2019
style_guide
tests
.gitignore
.travis.yml
CITATION
CODE_OF_CONDUCT.md
LICENSE.txt
MANIFEST.in
README.md
environment.yml
setup.py

README.md

MIRaGe = Multi Instrument Ramp Generator

Build Status License Python STScI DOI

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.

Please find detailed installation instructions on our ReadTheDocs page.

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.

The following is a bare bones example of a best work flow for contributing to the project:

  1. Create a fork off of the spacetelescope mirage repository.
  2. Make a local clone of your fork.
  3. Ensure your personal fork is pointing upstream properly.
  4. Create a branch on that personal fork.
  5. Make your software changes.
  6. Push that branch to your personal GitHub repository (i.e. origin).
  7. On the spacetelescope mirage repository, create a pull request that merges the branch into spacetelescope:master.
  8. Assign a reviewer from the team for the pull request.
  9. Iterate with the reviewer over any needed changes until the reviewer accepts and merges your branch.
  10. Delete your local copy of your branch.

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

Acknowledgments:

Mirage is based on a NIRISS data simulator originally written by Kevin Volk.

You can’t perform that action at this time.