Name | auto-AUTO JSON |
Version |
0.5.2
JSON |
| download |
home_page | None |
Summary | An AUTO-07p automatic search algorithm codebase |
upload_time | 2025-02-20 16:29:00 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.10 |
license | MIT License
Copyright (c) 2025 Jonathan Demaeyer and Oísin Hamilton
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
|
keywords |
bifurcation
bifurcation analysis
auto
automation
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
auto-AUTO (or AUTO²)
====================
[](https://badge.fury.io/py/auto-auto)
[](https://pypi.org/project/auto-auto/)
[](https://doi.org/10.5281/zenodo.14901321)
[](https://auto-auto.readthedocs.io/en/latest/?badge=latest)
[](https://opensource.org/licenses/MIT)
General Information
-------------------
AUTO² or auto-AUTO is an [AUTO](https://github.com/auto-07p/auto-07p) automatic search algorithm codebase
to enhance the original AUTO-07p Python interface with a top layer which allows users to:
* automate the continuation of as many branches as possible, branching whenever possible to construct full
bifurcation trees, and finishing computations based on a predefined logic
(meeting other branches, looping branches, etc...)
* plot results with [Matplotlib](https://matplotlib.org)
* perform these computations in [Jupyter](https://jupyter.org) notebooks
About
-----
(c) 2025 Jonathan Demaeyer and Oísin Hamilton.
See [LICENSE.txt](https://raw.githubusercontent.com/Climdyn/auto-AUTO/master/LICENSE.txt) for license information.
Please consult the auto-AUTO [code repository](http://www.github.com/Climdyn/auto-AUTO) for updates.
Installation
------------
#### Installing AUTO
> To use auto-AUTO, you need the [bleeding edge version of AUTO](https://github.com/auto-07p/auto-07p) available
> on GitHub for this codebase to work properly !
Here how to install AUTO from GitHub:
First clone the AUTO repository somewhere:
git clone https://github.com/auto-07p/auto-07p.git
Then in a terminal, in the created folder, run:
./configure
make
Your AUTO installation should now be finished, but you still need to add the
following line to your `.bashrc` file:
source [path-to-auto-07p]/cmds/auto.env.sh
In addition, we recommend that you edit the file `auto.env.sh` so that the `AUTO_DIR` environment
variable specified there points to the correct folder where you installed AUTO.
> Be sure to have all the AUTO requirements pre-installed. See AUTO documentation for
> more details. In case of issues, we recommend reading the documentation completely.
After that last step, you should be able to launch AUTO in command line by typing:
auto
If it works, you will end up in the AUTO Python prompt.
It means you have AUTO properly configured and are ready to install auto-AUTO.
> If AUTO version is changing over time, you need to update the version from GitHub and do
> the installation again.
#### Installing auto-AUTO with pip
The easiest way to install and run qgs is to use [pip](https://pypi.org/).
Type in a terminal
pip install auto-AUTO
and you are set!
#### Installing auto-AUTO with Anaconda
The second-easiest way to install and run qgs is to use an appropriate
environment created through [Anaconda](https://www.anaconda.com/).
First install Anaconda and clone the repository:
git clone https://github.com/Climdyn/auto-AUTO.git
Then install and activate the Python3 Anaconda environment:
conda env create -f environment.yml
conda activate auto2
and the code is installed.
#### Testing the installation
You can test the Jupyter notebooks present in the
[notebooks folder](./notebooks).
For instance, running
conda activate auto2
cd notebooks
jupyter-notebook
will lead you to your favorite browser where you can load and run the examples.
Documentation
-------------
To build the documentation, please run (with the conda environment activated):
cd documentation
make html
Once built, the documentation is available [here](./documentation/build/html/index.html).
The documentation is also available online on read the docs: [https://auto-auto.readthedocs.io/](https://auto-auto.readthedocs.io/)
Forthcoming developments
------------------------
* Regime diagrams object
Contributing to auto-AUTO
-------------------------
If you want to contribute actively, please contact the main authors.
In addition, if you have made changes that you think will be useful to others, please feel free to suggest these as a pull request on the [auto-AUTO Github repository](https://github.com/Climdyn/auto-AUTO).
Raw data
{
"_id": null,
"home_page": null,
"name": "auto-AUTO",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "bifurcation, bifurcation analysis, AUTO, automation",
"author": null,
"author_email": "Jonathan Demaeyer <jodemaey@meteo.be>, O\u00edsin Hamilton <oisin.hamilton@meteo.be>",
"download_url": "https://files.pythonhosted.org/packages/45/72/3f8c8bca0fe91423804607e9a3ff384ac73004c34d02aab9d1cbc5aad9a9/auto_auto-0.5.2.tar.gz",
"platform": null,
"description": "\nauto-AUTO (or AUTO\u00b2)\n====================\n\n[](https://badge.fury.io/py/auto-auto)\n[](https://pypi.org/project/auto-auto/)\n[](https://doi.org/10.5281/zenodo.14901321)\n[](https://auto-auto.readthedocs.io/en/latest/?badge=latest)\n[](https://opensource.org/licenses/MIT)\n\nGeneral Information\n-------------------\n\nAUTO\u00b2 or auto-AUTO is an [AUTO](https://github.com/auto-07p/auto-07p) automatic search algorithm codebase\nto enhance the original AUTO-07p Python interface with a top layer which allows users to:\n\n* automate the continuation of as many branches as possible, branching whenever possible to construct full\n bifurcation trees, and finishing computations based on a predefined logic\n (meeting other branches, looping branches, etc...)\n* plot results with [Matplotlib](https://matplotlib.org)\n* perform these computations in [Jupyter](https://jupyter.org) notebooks\n\nAbout\n-----\n\n(c) 2025 Jonathan Demaeyer and O\u00edsin Hamilton. \n\nSee [LICENSE.txt](https://raw.githubusercontent.com/Climdyn/auto-AUTO/master/LICENSE.txt) for license information.\n\nPlease consult the auto-AUTO [code repository](http://www.github.com/Climdyn/auto-AUTO) for updates.\n\nInstallation\n------------\n\n#### Installing AUTO\n\n> To use auto-AUTO, you need the [bleeding edge version of AUTO](https://github.com/auto-07p/auto-07p) available \n> on GitHub for this codebase to work properly !\n\nHere how to install AUTO from GitHub:\n\nFirst clone the AUTO repository somewhere:\n\n git clone https://github.com/auto-07p/auto-07p.git\n\nThen in a terminal, in the created folder, run:\n\n ./configure\n make\n\nYour AUTO installation should now be finished, but you still need to add the \nfollowing line to your `.bashrc` file:\n\n source [path-to-auto-07p]/cmds/auto.env.sh\n\nIn addition, we recommend that you edit the file `auto.env.sh` so that the `AUTO_DIR` environment \nvariable specified there points to the correct folder where you installed AUTO.\n\n > Be sure to have all the AUTO requirements pre-installed. See AUTO documentation for \n> more details. In case of issues, we recommend reading the documentation completely.\n\nAfter that last step, you should be able to launch AUTO in command line by typing:\n\n auto\n\nIf it works, you will end up in the AUTO Python prompt.\nIt means you have AUTO properly configured and are ready to install auto-AUTO.\n\n> If AUTO version is changing over time, you need to update the version from GitHub and do\n> the installation again.\n\n#### Installing auto-AUTO with pip\n\nThe easiest way to install and run qgs is to use [pip](https://pypi.org/).\nType in a terminal\n\n pip install auto-AUTO\n\nand you are set!\n\n#### Installing auto-AUTO with Anaconda\n\nThe second-easiest way to install and run qgs is to use an appropriate \nenvironment created through [Anaconda](https://www.anaconda.com/).\n\nFirst install Anaconda and clone the repository:\n\n git clone https://github.com/Climdyn/auto-AUTO.git\n\nThen install and activate the Python3 Anaconda environment:\n\n conda env create -f environment.yml\n conda activate auto2\n\nand the code is installed. \n\n\n#### Testing the installation\n\nYou can test the Jupyter notebooks present in the \n[notebooks folder](./notebooks).\nFor instance, running\n\n conda activate auto2\n cd notebooks\n jupyter-notebook\n\nwill lead you to your favorite browser where you can load and run the examples.\n\nDocumentation\n-------------\n\nTo build the documentation, please run (with the conda environment activated):\n\n cd documentation\n make html\n\nOnce built, the documentation is available [here](./documentation/build/html/index.html).\n\nThe documentation is also available online on read the docs: [https://auto-auto.readthedocs.io/](https://auto-auto.readthedocs.io/)\n\nForthcoming developments\n------------------------\n\n* Regime diagrams object\n\nContributing to auto-AUTO\n-------------------------\n\nIf you want to contribute actively, please contact the main authors.\n\nIn addition, if you have made changes that you think will be useful to others, please feel free to suggest these as a pull request on the [auto-AUTO Github repository](https://github.com/Climdyn/auto-AUTO).\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 Jonathan Demaeyer and O\u00edsin Hamilton\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.\n \n ",
"summary": "An AUTO-07p automatic search algorithm codebase",
"version": "0.5.2",
"project_urls": {
"documentation": "https://auto-auto.readthedocs.io",
"homepage": "https://github.com/Climdyn/auto-AUTO"
},
"split_keywords": [
"bifurcation",
" bifurcation analysis",
" auto",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "41914c2ab63393c4df4cb1f592a843f2f06a373d47373cbed83e09476450f730",
"md5": "23068d89f93d43a933c3fb661e18ca03",
"sha256": "05990cdb585c395d73595f3af789c9f2e49f6f99b1fb8808e64e82ec0f007588"
},
"downloads": -1,
"filename": "auto_AUTO-0.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23068d89f93d43a933c3fb661e18ca03",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 47728,
"upload_time": "2025-02-20T16:28:57",
"upload_time_iso_8601": "2025-02-20T16:28:57.774989Z",
"url": "https://files.pythonhosted.org/packages/41/91/4c2ab63393c4df4cb1f592a843f2f06a373d47373cbed83e09476450f730/auto_AUTO-0.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "45723f8c8bca0fe91423804607e9a3ff384ac73004c34d02aab9d1cbc5aad9a9",
"md5": "a6e44ab5e8f3a4632fbcd4ecc976664b",
"sha256": "57af9fb114eea261fc61c6edf10046f26772ab221f760a7ca94bca2347e3e66e"
},
"downloads": -1,
"filename": "auto_auto-0.5.2.tar.gz",
"has_sig": false,
"md5_digest": "a6e44ab5e8f3a4632fbcd4ecc976664b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 43590,
"upload_time": "2025-02-20T16:29:00",
"upload_time_iso_8601": "2025-02-20T16:29:00.123247Z",
"url": "https://files.pythonhosted.org/packages/45/72/3f8c8bca0fe91423804607e9a3ff384ac73004c34d02aab9d1cbc5aad9a9/auto_auto-0.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-20 16:29:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Climdyn",
"github_project": "auto-AUTO",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "auto-auto"
}