<img src="https://raw.githubusercontent.com/aymgal/COOLEST/main/images/full_logo.png#gh-light-mode-only" width="600" alt="COOLEST logo" />
<img src="https://raw.githubusercontent.com/aymgal/COOLEST/main/images/full_logo_dark_bg.png#gh-dark-mode-only" width="600" alt="COOLEST logo" />
# Standard for Strong Gravitational Lensing Analyses
[](https://github.com/aymgal/COOLEST/actions/workflows/ci-tests.yml)
[](https://coveralls.io/github/aymgal/COOLEST)
[](https://coolest.readthedocs.io/en/latest/?badge=latest)
[](https://doi.org/10.21105/joss.05567)
## What is COOLEST?
The COde-independent Organized LEns STandard (COOLEST) defines a set of conventions to be shared across the strong lensing community, in order to consistently store, share and improve lens modeling analyses. In short, this project provides tools to manipulate lens models as a single, human-readable JSON template file alongside Python routines for visualizing and comparing lens models possibly obtained from different modeling codes.
For more information and the full list of COOLEST features, refer to the [online documentation](https://coolest.readthedocs.io/en/latest/).
## Components of the standard
COOLEST is composed of three distinct building blocks:
- __A set of [conventions](docs/conventions.md)__: reference point for all modelling assumptions and codes, which includes coordinate systems, units and profile definitions used when manipulating the lens models stored in the template file;
- __Template file system__ ([`coolest.template`](coolest/template/)): a Python interface to create, store and manipulate COOLEST template files (JSON format) and linked external files (such as FITS files for data and pixelated model components);
- __Analysis & plotting__ ([`coolest.api`](coolest/api/)): a Python interface to compute key lensing quantities and generate publication-ready lens model plots.
## Examples
See the [`example notebooks`](docs/notebooks) directory to generate and manipulate typical JSON template files describing lens models. Below is an example of plot generated using the `coolest.api` submodule.
## Installation of the Python package
The easiest way to install the `coolest` Python package is via the `pip` installer:
```bash
# clone the latest version
git clone https://github.com/aymgal/COOLEST.git
# Move to the repo directly
cd COOLEST
# Now is a good idea to activate your virtual environment if needed
```
Then you can install the `coolest` package. If you wish to modify or contribute to the source code, do not forget to use the `-e` option in the commands below to install it in development mode. For installing the package without optional dependencies, use the following command:
```bash
# install coolest and required dependencies
pip install [-e] .
```
For installing the package with all optional dependencies, use the following command:
```bash
# also install optional dependencies
pip install [-e] ".[opt]"
```
You can test the installation by running `python -c "import coolest"` in the terminal, or by running some of the example notebooks from the [documentation](docs/notebooks) directory. Moreover, you can run all unit tests (having `pytest` installed in your environment), with the command `pytest test`.
_There will be soon the possibility to install_ `coolest` _directly from PyPi and Conda._
## Contributing to the COOLEST standard
We encourage and highly value All types of feedback, feature proposals and contributions from the whole lensing community. Please have a look at [CONTRIBUTING.md](CONTRIBUTING.md) for more information about contributing to the project.
## Citing the COOLEST standard
If you make use of COOLEST for your research, please cite our [JOSS publication](https://joss.theoj.org/papers/10.21105/joss.05567). Here is the corresponding BibTeX entry:
```
@article{Galan2023,
author = {Galan, Aymeric and de Vyvere, Lyne Van and Gomer, Matthew R. and Vernardos, Georgios and Sluse, Dominique},
doi = {10.21105/joss.05567},
journal = {Journal of Open Source Software},
month = aug,
number = {88},
pages = {5567},
title = {{COOLEST: COde-independent Organized LEns STandard}},
url = {https://joss.theoj.org/papers/10.21105/joss.05567},
volume = {8},
year = {2023}
}
```
## Original contributors
The full list of contributors is given in [AUTHORS.md](AUTHORS.md).
As this is an open source project, we very much appreciate any feedback and new contributions from the community. The goal is really to improve the standard so that most of the research using strong lens modeling can benefit from it.
Raw data
{
"_id": null,
"home_page": "https://github.com/aymgal/COOLEST",
"name": "coolest",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "coolest, lensing, gravitation, astrophysics",
"author": "Aymeric Galan & COOLEST contributors",
"author_email": "aymeric.galan@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2d/aa/5fa48cb99f8e88e8536cd58ee23151affff21dfd52ca954ab3600248c5c0/coolest-0.1.8.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/aymgal/COOLEST/main/images/full_logo.png#gh-light-mode-only\" width=\"600\" alt=\"COOLEST logo\" />\n<img src=\"https://raw.githubusercontent.com/aymgal/COOLEST/main/images/full_logo_dark_bg.png#gh-dark-mode-only\" width=\"600\" alt=\"COOLEST logo\" />\n\n# Standard for Strong Gravitational Lensing Analyses\n\n\n[](https://github.com/aymgal/COOLEST/actions/workflows/ci-tests.yml)\n[](https://coveralls.io/github/aymgal/COOLEST)\n[](https://coolest.readthedocs.io/en/latest/?badge=latest)\n\n[](https://doi.org/10.21105/joss.05567)\n\n## What is COOLEST?\n\nThe COde-independent Organized LEns STandard (COOLEST) defines a set of conventions to be shared across the strong lensing community, in order to consistently store, share and improve lens modeling analyses. In short, this project provides tools to manipulate lens models as a single, human-readable JSON template file alongside Python routines for visualizing and comparing lens models possibly obtained from different modeling codes.\n\nFor more information and the full list of COOLEST features, refer to the [online documentation](https://coolest.readthedocs.io/en/latest/).\n\n## Components of the standard\n\nCOOLEST is composed of three distinct building blocks:\n\n- __A set of [conventions](docs/conventions.md)__: reference point for all modelling assumptions and codes, which includes coordinate systems, units and profile definitions used when manipulating the lens models stored in the template file;\n\n- __Template file system__ ([`coolest.template`](coolest/template/)): a Python interface to create, store and manipulate COOLEST template files (JSON format) and linked external files (such as FITS files for data and pixelated model components);\n\n- __Analysis & plotting__ ([`coolest.api`](coolest/api/)): a Python interface to compute key lensing quantities and generate publication-ready lens model plots.\n\n## Examples\n\nSee the [`example notebooks`](docs/notebooks) directory to generate and manipulate typical JSON template files describing lens models. Below is an example of plot generated using the `coolest.api` submodule.\n\n\n\n## Installation of the Python package\n\nThe easiest way to install the `coolest` Python package is via the `pip` installer:\n```bash\n# clone the latest version\ngit clone https://github.com/aymgal/COOLEST.git\n\n# Move to the repo directly\ncd COOLEST\n\n# Now is a good idea to activate your virtual environment if needed\n```\n\nThen you can install the `coolest` package. If you wish to modify or contribute to the source code, do not forget to use the `-e` option in the commands below to install it in development mode. For installing the package without optional dependencies, use the following command:\n```bash\n# install coolest and required dependencies\npip install [-e] .\n```\nFor installing the package with all optional dependencies, use the following command:\n```bash\n# also install optional dependencies\npip install [-e] \".[opt]\"\n```\n\nYou can test the installation by running `python -c \"import coolest\"` in the terminal, or by running some of the example notebooks from the [documentation](docs/notebooks) directory. Moreover, you can run all unit tests (having `pytest` installed in your environment), with the command `pytest test`.\n\n_There will be soon the possibility to install_ `coolest` _directly from PyPi and Conda._\n\n\n## Contributing to the COOLEST standard\n\nWe encourage and highly value All types of feedback, feature proposals and contributions from the whole lensing community. Please have a look at [CONTRIBUTING.md](CONTRIBUTING.md) for more information about contributing to the project.\n\n## Citing the COOLEST standard\n\nIf you make use of COOLEST for your research, please cite our [JOSS publication](https://joss.theoj.org/papers/10.21105/joss.05567). Here is the corresponding BibTeX entry:\n\n```\n@article{Galan2023,\n author = {Galan, Aymeric and de Vyvere, Lyne Van and Gomer, Matthew R. and Vernardos, Georgios and Sluse, Dominique},\n doi = {10.21105/joss.05567},\n journal = {Journal of Open Source Software},\n month = aug,\n number = {88},\n pages = {5567},\n title = {{COOLEST: COde-independent Organized LEns STandard}},\n url = {https://joss.theoj.org/papers/10.21105/joss.05567},\n volume = {8},\n year = {2023}\n}\n```\n\n## Original contributors\n\nThe full list of contributors is given in [AUTHORS.md](AUTHORS.md).\n\nAs this is an open source project, we very much appreciate any feedback and new contributions from the community. The goal is really to improve the standard so that most of the research using strong lens modeling can benefit from it.\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "Standard for Strong Gravitational Lensing Analyses",
"version": "0.1.8",
"project_urls": {
"Changelog": "https://github.com/aymgal/COOLEST/blob/main/HISTORY.md",
"Documentation": "https://coolest.readthedocs.io/",
"Download": "https://github.com/aymgal/coolest/archive/refs/tags/v0.1.8.tar.gz",
"Homepage": "https://github.com/aymgal/COOLEST"
},
"split_keywords": [
"coolest",
" lensing",
" gravitation",
" astrophysics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6b9d51e298af3d5e592d324556cd973f582e44d83d60e71dfd304ddd9ca16871",
"md5": "9419eb57ffb7eed361766f5d136d65a0",
"sha256": "9b171440f69e649656190a1f76ed49b0eb7d5596e94c02a9a67cde05f2e4f97b"
},
"downloads": -1,
"filename": "coolest-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9419eb57ffb7eed361766f5d136d65a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 89502,
"upload_time": "2024-04-17T14:09:49",
"upload_time_iso_8601": "2024-04-17T14:09:49.249573Z",
"url": "https://files.pythonhosted.org/packages/6b/9d/51e298af3d5e592d324556cd973f582e44d83d60e71dfd304ddd9ca16871/coolest-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2daa5fa48cb99f8e88e8536cd58ee23151affff21dfd52ca954ab3600248c5c0",
"md5": "14da715be5f5d2380407c1418a348fb2",
"sha256": "73bb6f0da295b594b37af4f09b89ad260e471ace76eb0ce6d727d22a3f762912"
},
"downloads": -1,
"filename": "coolest-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "14da715be5f5d2380407c1418a348fb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 75963,
"upload_time": "2024-04-17T14:09:50",
"upload_time_iso_8601": "2024-04-17T14:09:50.430567Z",
"url": "https://files.pythonhosted.org/packages/2d/aa/5fa48cb99f8e88e8536cd58ee23151affff21dfd52ca954ab3600248c5c0/coolest-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-17 14:09:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aymgal",
"github_project": "COOLEST",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "coolest"
}
JSON
