Skip to main content

Cherab spectroscopy framework

Project description

DOI Build Status

Cherab

Welcome to the Cherab project.

Please see our documentation for guidance on using the code.

Installation

Cherab is a large code framework consisting of a core package and feature packages. Users will generally install the core package and the specific feature packages they need for their work. For example, users working on the JET tokamak will require the cherab-core package, and the cherab-jet package.

Unless developing new code for a cherab package, most users should clone the master branch. When developing new features for cherab, the development branch should be used as the base.

All cherab packages are standard python packages and basic installation is achieved with:

pip install cherab

This will compile the Cherab cython extensions and install the package. If you don't have administrator access to install the package, add the --user flag to the above line to install the package under your own user account. Alternatively, consider creating a virtual environment and installing cherab in the environment.

When developing cherab it is usually preferred that the packages be installed in "editable" mode. Clone this repository and change directory to the root of the repository, then run:

pip install -e .

This will cause the original installation folder to be added to the site-package path. Modifications to the code will therefore be visible to python next time the code is imported. A virtual environment or the --user flag should be used if you do not have administrative permission for your python installation. If you make any changes to Cython files you will need to run ./dev/build.sh to rebuild the relevant files.

As all the Cherab packages are dependent on the cherab-core package, this package must be installed first. Note that other packages may have their own inter-dependencies, see the specific package documentation for more information.

Cherab is organised as a namespace package, where each of the submodules is installed in the same location as the core package. Any submodules using Cython with a build-time dependency on Cherab need to use a Cython version newer than 3.0a5, due to a bug in how earlier versions of Cython handle namespaces.

Governance

The management of the project is divided into Scientific and Technical Project Management. The Scientific management happens through the normal community routes such as JET and MST1 task force meetings, ITPA meetings, etc.

The Technical Management Committee (TMC) is a smaller subset of the community, being responsible for ensuring the integrity and high code quality of Cherab is maintained. These TMC members would have in-depth knowledge of the code base through a demonstrated history of contributing to the project. The TMC would primarily be responsible for accepting / rejecting merge requests on the basis of code / physics algorithm quality standards.

TMC Members

  • Alys Brett (chairwoman, master account holder, responsible for delegation, UKAEA, UK)
  • Matt Carr (External consultant, diagnostic physics models)
  • Jack Lovell (Oak Ridge, USA)
  • Alex Meakins (External consultant, Architecture, software integrity)
  • Vlad Neverov (NRC Kurchatov Institute, Moscow)
  • Matej Tomes (Compass, IPP, Prague)

Citing The Code

  • Dr Carine Giroud, Dr Alex Meakins, Dr Matthew Carr, Dr Alfonso Baciero, & Mr Corentin Bertrand. (2018, March 23). Cherab Spectroscopy Modelling Framework (Version v0.1.0). Zenodo. http://doi.org/10.5281/zenodo.1206142

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cherab-1.4.0.tar.gz (17.4 MB view hashes)

Uploaded Source

Built Distributions

cherab-1.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (50.5 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

cherab-1.4.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl (43.5 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.5+ x86-64

cherab-1.4.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl (47.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.5+ x86-64

cherab-1.4.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl (43.8 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.5+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page