https://github.com/laurentrdc/iris-ued

Ultrafast electron scattering data exploration
https://github.com/laurentrdc/iris-ued

physics python science ultrafast ultrafast-electron-diffraction visualization

Last synced: 2 months ago
JSON representation

Ultrafast electron scattering data exploration

• Host: GitHub
• URL: https://github.com/laurentrdc/iris-ued
• Owner: LaurentRDC
• License: gpl-3.0
• Created: 2015-12-08T18:33:25.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-11-13T15:03:13.000Z (2 months ago)
• Last Synced: 2024-11-18T00:06:55.942Z (2 months ago)
• Topics: physics, python, science, ultrafast, ultrafast-electron-diffraction, visualization
• Language: Python
• Homepage: https://iris-ued.readthedocs.io
• Size: 70.3 MB
• Stars: 15
• Watchers: 7
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Iris - Ultrafast Electron Scattering Data Exploration

[![Documentation Build Status](https://readthedocs.org/projects/iris-ued/badge/?version=master)](http://iris-ued.readthedocs.io/) [![PyPI Version](https://img.shields.io/pypi/v/iris-ued.svg)](https://pypi.python.org/pypi/iris-ued) [![Conda-forge Version](https://img.shields.io/conda/vn/conda-forge/iris-ued.svg)](https://anaconda.org/conda-forge/iris-ued) [![DOI badge](https://img.shields.io/badge/DOI-10.1186%2Fs40679--018--0060--y-blue)](https://doi.org/10.1186/s40679-018-0060-y)

Iris is both a library for interacting with ultrafast electron

diffraction data, as well as a GUI frontend for interactively exploring

this data.

Iris also includes a plug-in manager so that you can explore your data.

![Two instances of the iris GUI showing data exploration for ultrafast

electron diffraction of single crystals and

polycrystals.](iris_screen.png)

## Contents:

  - [Installation](#installation)

  - [Usage](#usage)

  - [Test Data](#test-data)

  - [Documentation](#documentation)

  - [Citations](#citations)

  - [Support / Report Issues](#support--report-issues)

  - [License](#license)

## Installation

To interact with `iris` datasets from a Python environment, the `iris` package must be installed. `iris` is available on PyPI; it can be installed with [pip](https://pip.pypa.io).:

    python -m pip install iris-ued

`iris` is also available on the conda-forge channel:

    conda config --add channels conda-forge

    conda install iris-ued

To install the latest development version from

[Github](https://github.com/LaurentRDC/iris-ued):

    python -m pip install git+git://github.com/LaurentRDC/iris-ued.git

Each version is tested against Python 3.8+. If you are using a different

version, tests can be run using the `pytest` package.

### Windows Installers

For Windows, installers are available on the [Releases](https://github.com/LaurentRDC/iris-ued/releases) page. You will still need to install `iris` via `pip` or `conda` to use the scripting functionality.

## Usage

Once installed, the package can be imported as `iris`.

The GUI component can be launched from a command line interpreter as

`python -m iris` or `pythonw -m iris` (no console window). See the documentation

for a visual guide.

## Documentation

The [Documentation on readthedocs.io](https://iris-ued.readthedocs.io)

provides API-level documentation, as well as tutorials.

## Citations

If you find this software useful, please consider citing the following

publication:

> L. P. René de Cotret, M. R. Otto, M. J. Stern. and B. J. Siwick, *An open-source software ecosystem for the interactive exploration of ultrafast electron scattering data*, Advanced Structural and Chemical Imaging 4:11 (2018) [DOI: 10.1186/s40679-018-0060-y.](https://ascimaging.springeropen.com/articles/10.1186/s40679-018-0060-y)

If you are using the baseline-removal functionality of iris-ued,

please consider citing the following publication:

> L. P. René de Cotret and B. J. Siwick, *A general method for baseline-removal in ultrafast electron powder diffraction data using the dual-tree complex wavelet transform*, Struct. Dyn. 4 (2017) [DOI: 10.1063/1.4972518](https://doi.org/10.1063/1.4972518).

## Support / Report Issues

All support requests and issue reports should be [filed on Github as an

issue](https://github.com/LaurentRDC/iris-ued/issues).

## License

iris is made available under the GPLv3 License. For more details, see

[LICENSE.txt](https://github.com/LaurentRDC/iris-ued/blob/master/LICENSE.txt).