# uio-exoplanet-group
UiO exoplanet group tools for data processing. Created for [Centre for Earth Evolution and Dynamics](https://www.mn.uio.no/ceed/) and its successor [Center for Planetary Habitability](https://planetaryhabitability.org/).
<!-- MarkdownTOC -->
- [Installing](#installing)
- [From sources](#from-sources)
- [From PyPI](#from-pypi)
- [Modules](#modules)
- [Data](#data)
- [Documentation](#documentation)
- [API](#api)
- [wiki](#wiki)
- [Tests](#tests)
<!-- /MarkdownTOC -->
## Installing
### From sources
``` sh
$ cd /path/to/uio-exoplanet-group/
$ pip install ./
```
Add an `-e` argument, if you intend to modify the original sources.
You can also build a wheel and install/distribute that instead:
``` sh
$ cd /path/to/uio-exoplanet-group/
$ python -m build
$ pip install ./dist/uio_exoplanet_group-0.1.0-py3-none-any.whl
```
### From PyPI
Later the package will also be published at PyPI, so it could be installed with pip.
## 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](https://github.com/retifrav/uio-exoplanet-group/tree/master/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](https://uio.decovar.dev/).
It is generated with [pdoc](https://pdoc.dev):
``` sh
$ 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](https://github.com/mitmproxy/pdoc/blob/main/.github/workflows/docs.yml).
### 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:
``` sh
$ pip install pytest
$ python -m pytest ./src/uio/tests/*[^_*].py
```
Raw data
{
"_id": null,
"home_page": "https://github.com/retifrav/uio-exoplanet-group",
"name": "uio-exoplanet-group",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "tap,adql,astronomy,astrophysics,cosmology,science",
"author": "retif",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/a3/e3/c18190ff9657965b70229fcbbaa8989ed9091ac19cb9e019a3d6f7d6be40/uio-exoplanet-group-0.3.1.tar.gz",
"platform": null,
"description": "# uio-exoplanet-group\n\nUiO exoplanet group tools for data processing. Created for [Centre for Earth Evolution and Dynamics](https://www.mn.uio.no/ceed/) and its successor [Center for Planetary Habitability](https://planetaryhabitability.org/).\n\n<!-- MarkdownTOC -->\n\n- [Installing](#installing)\n - [From sources](#from-sources)\n - [From PyPI](#from-pypi)\n- [Modules](#modules)\n- [Data](#data)\n- [Documentation](#documentation)\n - [API](#api)\n - [wiki](#wiki)\n- [Tests](#tests)\n\n<!-- /MarkdownTOC -->\n\n## Installing\n\n### From sources\n\n``` sh\n$ cd /path/to/uio-exoplanet-group/\n$ pip install ./\n```\n\nAdd an `-e` argument, if you intend to modify the original sources.\n\nYou can also build a wheel and install/distribute that instead:\n\n``` sh\n$ cd /path/to/uio-exoplanet-group/\n$ python -m build\n$ pip install ./dist/uio_exoplanet_group-0.1.0-py3-none-any.whl\n```\n\n### From PyPI\n\nLater the package will also be published at PyPI, so it could be installed with pip.\n\n## Modules\n\n- utility - reusable/common utility modules;\n- tasks - special module for performing particular tasks.\n\n## Data\n\nWherever 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](https://github.com/retifrav/uio-exoplanet-group/tree/master/data) folder - chances are, that file will be provided there.\n\n## Documentation\n\nThere are two different pieces of documentation.\n\n### API\n\nLocated in `documentation`. This is the package API documentation, which is published [here](https://uio.decovar.dev/).\n\nIt is generated with [pdoc](https://pdoc.dev):\n\n``` sh\n$ pip install pdoc\n\n$ cd /path/to/uio-exoplanet-group\n$ rm -r ./documentation/_deploy/*\n\n$ UIO_PACKAGE_VERSION=$(git rev-parse --short HEAD) pdoc ./src/uio/utility ./src/uio/tasks \\\n --template-directory ./documentation/_templates/ \\\n --edit-url=\"uio=https://github.com/retifrav/uio-exoplanet-group/blob/master/src/uio/\" \\\n --output-directory ./documentation/_deploy/\n$ cp ./documentation/{favicon.ico,phab.jpg} ./documentation/_deploy/\n```\n\nFor 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](https://github.com/mitmproxy/pdoc/blob/main/.github/workflows/docs.yml).\n\n### wiki\n\nLocated 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.\n\nIt 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.\n\n## Tests\n\nTo run tests:\n\n``` sh\n$ pip install pytest\n$ python -m pytest ./src/uio/tests/*[^_*].py\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "UiO exoplanet group tools for data processing",
"version": "0.3.1",
"project_urls": {
"Bug Tracker": "https://github.com/retifrav/uio-exoplanet-group/issues",
"Changelog": "https://github.com/retifrav/uio-exoplanet-group/blob/master/changelog.md",
"Documentation": "https://uio.decovar.dev/",
"Homepage": "https://github.com/retifrav/uio-exoplanet-group"
},
"split_keywords": [
"tap",
"adql",
"astronomy",
"astrophysics",
"cosmology",
"science"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "414d25ac7927096c6080c19b3381756f15c3d69a995bfade4da7ce06961a67e5",
"md5": "af70f853b6cdde1b68b999f7263ab062",
"sha256": "52e7f6b7368eb6f11b48a207bbe2a2eff47d8dc2c14e1d0244918418f1da3420"
},
"downloads": -1,
"filename": "uio_exoplanet_group-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "af70f853b6cdde1b68b999f7263ab062",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 25245,
"upload_time": "2023-07-01T12:57:42",
"upload_time_iso_8601": "2023-07-01T12:57:42.491486Z",
"url": "https://files.pythonhosted.org/packages/41/4d/25ac7927096c6080c19b3381756f15c3d69a995bfade4da7ce06961a67e5/uio_exoplanet_group-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a3e3c18190ff9657965b70229fcbbaa8989ed9091ac19cb9e019a3d6f7d6be40",
"md5": "8f313387db25871744d81a82b2290579",
"sha256": "c94482ee5b85b7b89f171055ea325b02cfaa86d0afffa510e92b2df7a4184add"
},
"downloads": -1,
"filename": "uio-exoplanet-group-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "8f313387db25871744d81a82b2290579",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 24555,
"upload_time": "2023-07-01T12:57:44",
"upload_time_iso_8601": "2023-07-01T12:57:44.295741Z",
"url": "https://files.pythonhosted.org/packages/a3/e3/c18190ff9657965b70229fcbbaa8989ed9091ac19cb9e019a3d6f7d6be40/uio-exoplanet-group-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-01 12:57:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "retifrav",
"github_project": "uio-exoplanet-group",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "uio-exoplanet-group"
}
JSON
