ASPECT - Advanced Solver for Problems in Earth's ConvecTion
===========================================================
[![License GPL2:](https://img.shields.io/cran/l/devtools.svg)](https://github.com/geodynamics/aspect/blob/master/LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3924604.svg)](https://doi.org/10.5281/zenodo.3924604)
[![pdf manual](https://img.shields.io/badge/get-PDF-green.svg)](https://doi.org/10.6084/m9.figshare.4865333)
About
-----
ASPECT is a code to simulate convection in Earth's mantle and elsewhere.
It has grown from a pure mantle-convection code into a tool for many
geodynamic applications including applications for inner core convection,
lithospheric scale deformation, two-phase flow, and numerical methods development.
The project is supported by CIG (http://geodynamics.org).
Installation instructions
-------------------------
The steps to install the necessary dependencies and ASPECT itself are described
in the Installation instructions section of the ASPECT
[manual](http://www.math.clemson.edu/~heister/manual.pdf). If you encounter
problems during the installation, please consult our
[wiki](https://github.com/geodynamics/aspect/wiki) for typical installation
problems or specific instructions for MacOS users, before asking your question
on the mailing list.
Running and extending ASPECT
----------------------------
Instructions on how to run and extend, as well as on how to interpret the
output of ASPECT can also be found in the ASPECT
[manual](http://www.math.clemson.edu/~heister/manual.pdf). This manual also
discusses the structure of the source code.
For getting started, you can also watch our online
[tutorial](https://geodynamics.org/cig/events/calendar/2016-cig-all-hands-meeting/aspect-tutorial/tutorial/).
Contributing to ASPECT
----------------------
ASPECT is a community project that lives by the participation of its
members — i.e., including you! It is our goal to build an inclusive
and participatory community so we are happy that you are interested in
participating! We have collected a set of guidelines and advice on how
to get involved in the community and keep them in the
[CONTRIBUTING.md](CONTRIBUTING.md)
file in ASPECT's repository.
More information
----------------
For more information see:
- The official website at https://aspect.geodynamics.org
- The current [manual](http://www.math.clemson.edu/~heister/manual.pdf)
- [How to cite ASPECT](https://aspect.geodynamics.org/cite.html)
- For questions on the source code of ASPECT, portability, installation, new or existing features, etc., use the [ASPECT forum](https://community.geodynamics.org/c/aspect). This forum is where the ASPECT users and developers all hang out. Archived discussions from the inactive aspect-devel mailing list can be downloaded at [aspect-devel archives](http://lists.geodynamics.org/pipermail/aspect-devel).
- ASPECT is primarily based on the deal.II library. If you have particular questions about deal.II, contact the [deal.II discussion groups](https://www.dealii.org/mail.html).
- In case of more general questions about mantle convection, you can contact the [CIG mantle convection mailing lists](http://lists.geodynamics.org/cgi-bin/mailman/listinfo/cig-MC).
- ASPECT is being developed by a large, collaborative, and inclusive community. It is currently maintained by the following people:
- Wolfgang Bangerth: bangerth@math.colostate.edu
- Juliane Dannberg: judannberg@gmail.com
- Menno Fraters: mrfraters@ucdavis.edu
- Rene Gassmoeller: rene.gassmoeller@mailbox.org
- Anne Glerum: acglerum@gfz-potsdam.de
- Timo Heister: heister@clemson.edu
- John Naliboff: john.naliboff@nmt.edu
- The following people have significantly contributed and furthered ASPECT's goals and are therefore Principal Developers:
- Jacky Austermann
- Wolfgang Bangerth
- Juliane Dannberg
- Menno Fraters
- Rene Gassmoeller
- Anne Glerum
- Timo Heister
- Bob Myhill
- John Naliboff
- A complete and growing list of the many authors that have contributed over the years can be found at [GitHub contributors](https://github.com/geodynamics/aspect/graphs/contributors).
- If you have specific questions about ASPECT that are not suitable for public and archived mailing lists, feel free to contact the maintainers or principal developers.
License
-------
ASPECT is published under [GPL v2 or newer](LICENSE).