| Name | aragog JSON |
| Version |
0.1.8a0
JSON |
| download |
| home_page | None |
| Summary | 1-D interior dynamics of rocky mantles that are solid, liquid, or mixed phase |
| upload_time | 2024-12-09 12:23:03 |
| maintainer | None |
| docs_url | None |
| author | Dan J Bower |
| requires_python | >=3.10 |
| license | GPL-3.0-or-later |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Aragog
[](https://www.python.org/downloads/release/python-3100/)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://aragog.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/ExPlanetology/aragog/actions/workflows/python-package.yml)
## Under development
This code remains under active development, hence the interface is not stable and should not be relied upon.
## About
Aragog is a Python package that computes the 1-D interior dynamics of rocky mantles that are solid, liquid, or mixed phase. It is mostly a pure Python version of the [SPIDER code](https://github.com/djbower/spider) originally written in C albeit with some differences. Note that the atmosphere module in the original SPIDER code is now supported by a separate and more comprehensive Python package Atmodeller (release forthcoming).
Documentation: <https://aragog.readthedocs.io>
Source code: <https://github.com/ExPlanetology/aragog>
## Citation
If you use Aragog (or the original [SPIDER code](https://github.com/djbower/spider)) please cite:
- Bower, D.J., P. Sanan, and A.S. Wolf (2018), Numerical solution of a non-linear conservation law applicable to the interior dynamics of partially molten planets, Phys. Earth Planet. Inter., 274, 49-62, doi: <https://doi.org/10.1016/j.pepi.2017.11.004>.
Open access versions of the publication are available:
- arXiv: <https://arxiv.org/abs/1711.07303>
- EarthArXiv: <https://eartharxiv.org/k6tgf>
## Installation
### Quick install
The basic procedure is to install Aragog into a Python environment. For example, if you are using a Conda distribution to create and manage Python environments (e.g. [Anaconda](https://www.anaconda.com/download)), create a new environment noting that Aragog requires Python >= 3.10. Once created, make sure to activate the environment. To achieve this, terminal commands are given below, but you can also use the Anaconda Navigator (or similar GUI) to create and activate environments:
conda create -n aragog python
conda activate aragog
Alternatively, you can create and activate a [virtual environment](https://docs.python.org/3/library/venv.html).
Finally, install Aragog into the activated environment:
pip install aragog
### Developer install
> - See this [guide](https://gist.github.com/djbower/c66474000029730ac9f8b73b96071db3) to develop Aragog using [VS Code](https://code.visualstudio.com) and [Poetry](https://python-poetry.org).
> - See this [guide](https://gist.github.com/djbower/c82b4a70a3c3c74ad26dc572edefdd34) to develop Aragog if you are a Windows or Spyder user.
Navigate to a location on your computer and obtain the source code using git:
git clone git@github.com:ExPlanetology/aragog.git aragog
cd aragog
Install Aragog into the environment using either (a) [Poetry](https://python-poetry.org) or (b) [pip](https://pip.pypa.io/en/stable/getting-started/). There are some subtle differences between Poetry and pip, but in general Aragog is configured to be interoperable for most common operations (e.g. see this [Gist](https://gist.github.com/djbower/e9538e7eb5ed3deaf3c4de9dea41ebcd)).
- (a) Poetry option, which requires that [Poetry](https://python-poetry.org) is installed:
poetry install --all-extras
- (b) pip option, where the `-e` option is for an [editable install](https://setuptools.pypa.io/en/latest/userguide/development_mode.html):
pip install -e ".[docs]"
If desired, you will need to manually install the dependencies for the tests, which are automatically installed by Poetry but not by `pip`. See the additional dependencies to install in `pyproject.toml`.
Raw data
{
"_id": null,
"home_page": null,
"name": "aragog",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Dan J Bower",
"author_email": "djbower@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/56/8e/26ad5f7391812b8adbefa1f83ad3f3db3b24dc4c7e317d2e777b20761811/aragog-0.1.8a0.tar.gz",
"platform": null,
"description": "# Aragog\n\n[](https://www.python.org/downloads/release/python-3100/)\n[](https://www.gnu.org/licenses/gpl-3.0)\n[](https://aragog.readthedocs.io/en/latest/?badge=latest)\n[](https://github.com/ExPlanetology/aragog/actions/workflows/python-package.yml)\n\n## Under development\n\nThis code remains under active development, hence the interface is not stable and should not be relied upon.\n\n## About\n\nAragog is a Python package that computes the 1-D interior dynamics of rocky mantles that are solid, liquid, or mixed phase. It is mostly a pure Python version of the [SPIDER code](https://github.com/djbower/spider) originally written in C albeit with some differences. Note that the atmosphere module in the original SPIDER code is now supported by a separate and more comprehensive Python package Atmodeller (release forthcoming).\n\nDocumentation: <https://aragog.readthedocs.io>\n\nSource code: <https://github.com/ExPlanetology/aragog>\n\n## Citation\n\nIf you use Aragog (or the original [SPIDER code](https://github.com/djbower/spider)) please cite:\n\n- Bower, D.J., P. Sanan, and A.S. Wolf (2018), Numerical solution of a non-linear conservation law applicable to the interior dynamics of partially molten planets, Phys. Earth Planet. Inter., 274, 49-62, doi: <https://doi.org/10.1016/j.pepi.2017.11.004>.\n\nOpen access versions of the publication are available:\n\n- arXiv: <https://arxiv.org/abs/1711.07303>\n- EarthArXiv: <https://eartharxiv.org/k6tgf>\n\n## Installation\n\n### Quick install\n\nThe basic procedure is to install Aragog into a Python environment. For example, if you are using a Conda distribution to create and manage Python environments (e.g. [Anaconda](https://www.anaconda.com/download)), create a new environment noting that Aragog requires Python >= 3.10. Once created, make sure to activate the environment. To achieve this, terminal commands are given below, but you can also use the Anaconda Navigator (or similar GUI) to create and activate environments:\n\n conda create -n aragog python\n conda activate aragog\n\nAlternatively, you can create and activate a [virtual environment](https://docs.python.org/3/library/venv.html).\n\nFinally, install Aragog into the activated environment:\n\n\tpip install aragog\n\n### Developer install\n\n> - See this [guide](https://gist.github.com/djbower/c66474000029730ac9f8b73b96071db3) to develop Aragog using [VS Code](https://code.visualstudio.com) and [Poetry](https://python-poetry.org).\n> - See this [guide](https://gist.github.com/djbower/c82b4a70a3c3c74ad26dc572edefdd34) to develop Aragog if you are a Windows or Spyder user.\n\nNavigate to a location on your computer and obtain the source code using git:\n\n git clone git@github.com:ExPlanetology/aragog.git aragog\n cd aragog\n\nInstall Aragog into the environment using either (a) [Poetry](https://python-poetry.org) or (b) [pip](https://pip.pypa.io/en/stable/getting-started/). There are some subtle differences between Poetry and pip, but in general Aragog is configured to be interoperable for most common operations (e.g. see this [Gist](https://gist.github.com/djbower/e9538e7eb5ed3deaf3c4de9dea41ebcd)).\n\n- (a) Poetry option, which requires that [Poetry](https://python-poetry.org) is installed:\n\n\t\tpoetry install --all-extras\n\n- (b) pip option, where the `-e` option is for an [editable install](https://setuptools.pypa.io/en/latest/userguide/development_mode.html):\n\n\t\tpip install -e \".[docs]\"\n\n\tIf desired, you will need to manually install the dependencies for the tests, which are automatically installed by Poetry but not by `pip`. See the additional dependencies to install in `pyproject.toml`.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "1-D interior dynamics of rocky mantles that are solid, liquid, or mixed phase",
"version": "0.1.8a0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "596f9f2c70332ec50d7582d2f690160bc398b89abf438bd90933028200bf7d94",
"md5": "fba16acb09e6b9b14fc0b6cf51fedbf3",
"sha256": "7d03aff157de8486e8dd5d90d371725a62bb58ced22453c7f786f5bf549bafac"
},
"downloads": -1,
"filename": "aragog-0.1.8a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fba16acb09e6b9b14fc0b6cf51fedbf3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 50743,
"upload_time": "2024-12-09T12:23:01",
"upload_time_iso_8601": "2024-12-09T12:23:01.362233Z",
"url": "https://files.pythonhosted.org/packages/59/6f/9f2c70332ec50d7582d2f690160bc398b89abf438bd90933028200bf7d94/aragog-0.1.8a0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "568e26ad5f7391812b8adbefa1f83ad3f3db3b24dc4c7e317d2e777b20761811",
"md5": "b98d045a9d75f3b6ca60e0a20c05c4ec",
"sha256": "06436f529462abb922585a232684bbafb6b7326f7c4ff696270c5dbb8c5d0c34"
},
"downloads": -1,
"filename": "aragog-0.1.8a0.tar.gz",
"has_sig": false,
"md5_digest": "b98d045a9d75f3b6ca60e0a20c05c4ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 40535,
"upload_time": "2024-12-09T12:23:03",
"upload_time_iso_8601": "2024-12-09T12:23:03.301065Z",
"url": "https://files.pythonhosted.org/packages/56/8e/26ad5f7391812b8adbefa1f83ad3f3db3b24dc4c7e317d2e777b20761811/aragog-0.1.8a0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 12:23:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "aragog"
}
