uio-exoplanet-group

UiO exoplanet group: data processing tools and knowledge base. Created for Centre for Earth Evolution and Dynamics and its successor Centre for Planetary Habitability.

• Installing
  • From PyPI
  • From sources
    • Building a wheel
• Modules
• Data
• Documentation
  • API
  • wiki
• Tests

Installing

From PyPI

$ pip install uio-exoplanet-group

From sources

$ cd /path/to/uio-exoplanet-group/
$ pip install .

Add an -e argument, if you'd like to automatically update your locally installed package by pulling from the repository or/and if you intend to modify the sources:

$ pip install -e .

Building a wheel

You can also build a wheel and distribute/install that instead:

$ cd /path/to/uio-exoplanet-group/
$ python -m build
$ pip install ./dist/uio_exoplanet_group-*.whl

Modules

• utility - reusable/common utility modules;
• tasks - special module for performing particular tasks.

Data

Wherever you see a reference to some data files in documentation, examples, comments or anywhere else, for example some function taking a path like ./data/systems-528n.pkl, check the data folder - chances are, that file will be provided there.

Documentation

There are two different pieces of documentation.

API

Located in documentation. This is the package API documentation, which is published here.

It is generated with pdoc:

$ pip install pdoc

$ cd /path/to/uio-exoplanet-group
$ rm -r ./documentation/_deploy/*

$ UIO_PACKAGE_VERSION=$(git rev-parse --short HEAD) pdoc ./src/uio/utility ./src/uio/tasks \
    --template-directory ./documentation/_templates/ \
    --edit-url="uio=https://github.com/retifrav/uio-exoplanet-group/blob/master/src/uio/" \
    --output-directory ./documentation/_deploy/
$ cp ./documentation/{favicon.ico,phab.jpg} ./documentation/_deploy/

For now it's a blunt deployment of generated HTML, but later it probably will be better to rely on GitHub Actions (if it won't spend too much of free quota) by customizing this workflow.

wiki

Located in wiki. This is general purpose / technical manuals, articles, notes, etc: how to install/build various tools, dependencies, how to set-up environments and so on.

It is meant to be published somewhere else, but for now it will do being a part of repository. GitHub wikis could've been an option, but those are still quite bad in terms of organizing the content.

Tests

To run tests:

$ pip install pytest

$ python -m pytest ./src/uio/tests/*[^_*].py
$ python -m pytest ./src/uio/tests/databases.py
$ python -m pytest ./src/uio/tests/databases.py -k "test_get_parameters_that_are_double_in_nasa"