Metadata-Version: 2.4
Name: agox
Version: 3.11.1
Summary: Atomistic Global Optimziation X is a framework for structure optimization in materials science.
Author: AGOX Developers
Author-email: "Mads-Peter V. Christiansen" <machri@phys.au.dk>, Nikolaj Rønne <nronne@phys.au.dk>, Bjørk Hammer <hammer@phys.au.dk>
License-Expression: GPL-3.0-only
Project-URL: homepage, https://agox.gitlab.io/agox/
Project-URL: Repository, https://gitlab.com/agox/agox
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy>=2
Requires-Dist: scipy
Requires-Dist: ase
Requires-Dist: matplotlib
Requires-Dist: cymem
Requires-Dist: scikit-learn
Requires-Dist: h5py
Requires-Dist: dscribe>=2.0.0
Requires-Dist: ray
Requires-Dist: rich-click>=1.8.3
Requires-Dist: pydantic>=2.11.7
Requires-Dist: ase-ga>=1.0.3
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-mock; extra == "test"
Requires-Dist: pytest-regressions; extra == "test"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: sphinx-autoapi; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-tabs; extra == "docs"
Requires-Dist: sphinx-design; extra == "docs"
Requires-Dist: sphinx-autobuild; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: myst-nb; extra == "docs"
Requires-Dist: sphinx-substitution-extensions; extra == "docs"
Requires-Dist: ipywidgets; extra == "docs"
Provides-Extra: torchjax
Requires-Dist: torch; extra == "torchjax"
Requires-Dist: jax; extra == "torchjax"
Requires-Dist: jaxlib; extra == "torchjax"
Requires-Dist: typing_extensions; extra == "torchjax"
Requires-Dist: matscipy; extra == "torchjax"
Provides-Extra: all
Requires-Dist: agox[docs,test]; extra == "all"
Dynamic: license-file

# Atomistic Global Optimization X (AGOX)

![logo](docs/source/logos/logo-carbon.gif)


AGOX is a package for global optimization of atomic system using e.g. the energy 
calculated from density functional theory as the objective function. AGOX interfaces 
with the Atomistic Simulation Environment (ASE) and as such supports any of 
calculators in ASE as objectives for optimization. 

AGOX is built to be flexible, consisting of modules that can be put together to 
create an optimization algorithm, from simple random searches to Bayesian searches 
guided by a surrogate model and many more. 

Check out the documentation at 

https://agox.gitlab.io/agox/

## Installation

AGOX can be installed from PyPI 

```
pip install agox
```

Or from source by cloning the repo.

## Contributions & Issues 

Feel free to make a fork and submit a merge request! 

If you have an issue or a question please post it on the issue board! 

## Authors 

The main AGOX framework has been written by 
* Mads-Peter Verner Christiansen
* Nikolaj Rønne
* Bjørk Hammer

with inspiration and help from current and previous members of the Hammer group at Aarhus University, Denmark.
Parts of the code have been contributed by

* Andreas Slavensky (Complementary Energy Generator)
* Florian Brix (Symmetry generators)
* Joe Pitfield (Replica-exchange)
* Jon Eunan Quinlivan Dominguez (Grand canonical)

## License

AGOX is released under the GPLv3 license. 


