To start using ISIS, see:
- Installing ISIS
- Distubuted with conda, compatible with Unix and Mac.
- Intro to ISIS
- A good primer, at the end there's an example you can try!
- Setting Up the ISIS Data Area
- You'll need this to process images on your own.
For more info, see:
For Development and Contributing, see:
The ISIS project uses a Request for Comment (RFC) model where major changes to the code, data area, or distribution are proposed, discussed, and potentially adopted. RFCs are being housed in this repository's wiki.
No RFCs are currently open.
All contributors and users are welcome to review and comment on open RFCs.
The badge at the top of this README lists the DOI of the most recent ISIS version. As of 11/22/2024, the latest release of ISIS is version 8.3.0, and its DOI is 10.5066/P13TADS5.
The Releases Page on GitHub lists the DOI for each version of ISIS. Older versions may be listed on Zenodo. It is good practice to cite the version of the software being used by the citing work, so others can reproduce your exact results.
ISIS is supported on these UNIX variants (and may work on others, though unsupported):
- Ubuntu 18.04 LTS
- macOS 10.13.6 High Sierra
- Fedora 28
- CentOS 7.2
ISIS is not supported on Windows, but using WSL may be possible.
- 64-bit x86 processors: Supported.
- Apple Silicon: In Development.
- 2.5 GB for ISIS binaries
- 10 GB up to multiple TB for mission data and processing large images
Versions of ISIS now use a Major.Minor.Patch scheme (e.g., 8.3.0), detailed in RFC 2.
| Major | Minor | Patch |
|---|---|---|
| 8 | .3 | .0 |
-
Patch Releases (i.e. 8.0.2 → 8.0.3) fix a bug, but don't make breaking changes or add features.
-
Minor Releases (i.e. 8.2.0 → 8.3.0) add features, but no breaking changes.
-
Major Releases (i.e. 8.3.0 → 9.0.0) add a breaking change.
A breaking change alters API signatures, existing arguments to ISIS apps, or output. Anything that could break backwards compatibility with a script is considered breaking*.
Additions (i.e, an added optional argument, and added column in a .csv file) aren't considered breaking, but changes to existing output or input (i.e, changing an existing argment, changing the title of an existing .csv output column) are breaking.
*.txt files, or output meant only for human readers, are excluded from ISIS's definition of a breaking change.
Contributors must make sure that breaking changes are well-identified. Breaking changes require input, discussion, and approval from the community before they can be adopted into ISIS.
Most users can safely upgrade to Minor and Patch Versions, but should be more cautious about a Major upgrade, which may introduce changes that could alter their workflow. You can reference the Changelog for more specific information on the changes.
ISIS has a Long Term Support (LTS) model. This assumes that users will update at either:
- Each LTS release (every 18 months), or
- Each quarterly release (every 3 months).