<commit_before>
A modular open source glacier model in Python
---------------------------------------------

The model accounts for glacier geometry (including contributory branches) and
includes an explicit ice dynamics module. It can simulate past and
future mass-balance, volume and geometry of (almost) any glacier in the world
in a fully automated and extensible workflow. We rely exclusively on publicly
available data for calibration and validation.

**This is the software documentation: for general information about the
OGGM project and related news, visit** `oggm.org <http://oggm.org>`_.


.. include:: _generated/version_text.txt


Principles
^^^^^^^^^^

Physical principles implemented in the model and their underlying assumptions,
with as little code as possible. For more detailed information, we recommend
to read the OGGM
`description paper <https://www.geosci-model-dev.net/12/909/2019/>`_ as
well.

* :doc:`introduction`
* :doc:`flowlines`
* :doc:`mass-balance`
* :doc:`ice-dynamics`
* :doc:`inversion`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Principles

    introduction.rst
    flowlines.rst
    mass-balance.rst
    ice-dynamics.rst
    inversion.rst

Using OGGM
^^^^^^^^^^

How to use the model, with concrete python code examples.

* :doc:`cloud`
* :doc:`installing-oggm`
* :doc:`getting-started`
* :doc:`input-data`
* :doc:`run`
* :doc:`practicalities`
* :doc:`api`
* :doc:`faq`
* :doc:`whats-new`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Using OGGM

    cloud.rst
    installing-oggm.rst
    getting-started.rst
    input-data.rst
    run.rst
    api.rst
    practicalities.rst
    faq.rst
    whats-new.rst

Contributing
^^^^^^^^^^^^

Do you want to contribute to the model? This is the right place to start.

* :doc:`citing-oggm`
* :doc:`add-module`
* :doc:`oeps`
* :doc:`contributing`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Contributing

    citing-oggm.rst
    add-module.rst
    oeps.rst
    contributing.rst

.. _contact:

Get in touch
------------

- View the source code `on GitHub`_.
- Report bugs or share your ideas on the `issue tracker`_.
- Improve the model by submitting a `pull request`_.
- Follow us on `Twitter`_.
- Or you can always send us an `e-mail`_ the good old way.

.. _e-mail: https://mailman.zfn.uni-bremen.de/cgi-bin/mailman/listinfo/oggm-users
.. _on GitHub: https://github.com/OGGM/oggm
.. _issue tracker: https://github.com/OGGM/oggm/issues
.. _pull request: https://github.com/OGGM/oggm/pulls
.. _Twitter: https://twitter.com/OGGM1


License and citation
--------------------

.. image:: _static/gpl.png
   :width: 140 px

OGGM is available under the open source `GNU GPLv3 license`_.

.. _GNU GPLv3 license: http://www.gnu.org/licenses/gpl-3.0.en.html

OGGM is free software. This implies that you are free to use the model and
copy or modify its code at your wish, under certain conditions:

1. When using this software, please acknowledge the original authors of this
   contribution by linking to our project website `www.oggm.org <http://oggm.org>`_.
   For your publications, presentations or posters we kindly ask you to refer to the
   `paper in Geoscientific Model Development`_.

   BibTeX entry::

        @Article{gmd-12-909-2019,
        AUTHOR = {<NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>.},
        TITLE = {The Open Global Glacier Model (OGGM) v1.1},
        JOURNAL = {Geoscientific Model Development},
        VOLUME = {2019},
        YEAR = {2019},
        PAGES = {909--931},
        URL = {https://www.geosci-model-dev.net/12/909/2019/},
        DOI = {10.5194/gmd-12-909-2019}
        }


   If you want to refer to a specific version of the software you can use
   the `Zenodo citation`_ for this purpose.

   An example BibTeX entry::

        @misc{OGGM_v1.1,
        author       = {<NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME>},
        title        = {OGGM/oggm: v1.1},
        month        = feb,
        year         = 2019,
        doi          = {10.5281/zenodo.2580277},
        url          = {https://doi.org/10.5281/zenodo.2580277}
        }


2. Your modifications to the code belong to you, but if you decide
   to share these modifications with others you'll have to do so under the same
   license as OGGM (the GNU General Public License as published by the Free
   Software Foundation).

See the `wikipedia page about GPL`_ and the `OGGM license`_ for more
information.

.. _paper in Geoscientific Model Development: https://www.www.geosci-model-dev.net/12/909/2019/

.. _Zenodo citation: https://zenodo.org/badge/latestdoi/43965645

.. _wikipedia page about GPL: https://en.wikipedia.org/wiki/GNU_General_Public_License

.. _OGGM license: https://github.com/OGGM/oggm/blob/master/LICENSE.rst

About
-----

:Version:
    .. image:: https://img.shields.io/pypi/v/oggm.svg
        :target: https://pypi.python.org/pypi/oggm
        :alt: Pypi version

    .. image:: https://img.shields.io/pypi/pyversions/oggm.svg
        :target: https://pypi.python.org/pypi/oggm
        :alt: Supported python versions

:Citation:
    .. image:: https://img.shields.io/badge/Citation-GMD%20paper-orange.svg
        :target: https://www.www.geosci-model-dev.net/12/909/2019/
        :alt: GMD Paper

    .. image:: https://zenodo.org/badge/43965645.svg
        :target: https://zenodo.org/badge/latestdoi/43965645
        :alt: Zenodo

:Tests:<commit_msg>Typo in web link<commit_after>
A modular open source glacier model in Python
---------------------------------------------

The model accounts for glacier geometry (including contributory branches) and
includes an explicit ice dynamics module. It can simulate past and
future mass-balance, volume and geometry of (almost) any glacier in the world
in a fully automated and extensible workflow. We rely exclusively on publicly
available data for calibration and validation.

**This is the software documentation: for general information about the
OGGM project and related news, visit** `oggm.org <http://oggm.org>`_.


.. include:: _generated/version_text.txt


Principles
^^^^^^^^^^

Physical principles implemented in the model and their underlying assumptions,
with as little code as possible. For more detailed information, we recommend
to read the OGGM
`description paper <https://www.geosci-model-dev.net/12/909/2019/>`_ as
well.

* :doc:`introduction`
* :doc:`flowlines`
* :doc:`mass-balance`
* :doc:`ice-dynamics`
* :doc:`inversion`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Principles

    introduction.rst
    flowlines.rst
    mass-balance.rst
    ice-dynamics.rst
    inversion.rst

Using OGGM
^^^^^^^^^^

How to use the model, with concrete python code examples.

* :doc:`cloud`
* :doc:`installing-oggm`
* :doc:`getting-started`
* :doc:`input-data`
* :doc:`run`
* :doc:`practicalities`
* :doc:`api`
* :doc:`faq`
* :doc:`whats-new`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Using OGGM

    cloud.rst
    installing-oggm.rst
    getting-started.rst
    input-data.rst
    run.rst
    api.rst
    practicalities.rst
    faq.rst
    whats-new.rst

Contributing
^^^^^^^^^^^^

Do you want to contribute to the model? This is the right place to start.

* :doc:`citing-oggm`
* :doc:`add-module`
* :doc:`oeps`
* :doc:`contributing`

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Contributing

    citing-oggm.rst
    add-module.rst
    oeps.rst
    contributing.rst

.. _contact:

Get in touch
------------

- View the source code `on GitHub`_.
- Report bugs or share your ideas on the `issue tracker`_.
- Improve the model by submitting a `pull request`_.
- Follow us on `Twitter`_.
- Or you can always send us an `e-mail`_ the good old way.

.. _e-mail: https://mailman.zfn.uni-bremen.de/cgi-bin/mailman/listinfo/oggm-users
.. _on GitHub: https://github.com/OGGM/oggm
.. _issue tracker: https://github.com/OGGM/oggm/issues
.. _pull request: https://github.com/OGGM/oggm/pulls
.. _Twitter: https://twitter.com/OGGM1


License and citation
--------------------

.. image:: _static/gpl.png
   :width: 140 px

OGGM is available under the open source `GNU GPLv3 license`_.

.. _GNU GPLv3 license: http://www.gnu.org/licenses/gpl-3.0.en.html

OGGM is free software. This implies that you are free to use the model and
copy or modify its code at your wish, under certain conditions:

1. When using this software, please acknowledge the original authors of this
   contribution by linking to our project website `www.oggm.org <http://oggm.org>`_.
   For your publications, presentations or posters we kindly ask you to refer to the
   `paper in Geoscientific Model Development`_.

   BibTeX entry::

        @Article{gmd-12-909-2019,
        AUTHOR = {<NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and <NAME>. and <NAME>. and
                  <NAME>. and Rothenpieler, T. and <NAME>. and
                  <NAME>. and <NAME>.},
        TITLE = {The Open Global Glacier Model (OGGM) v1.1},
        JOURNAL = {Geoscientific Model Development},
        VOLUME = {2019},
        YEAR = {2019},
        PAGES = {909--931},
        URL = {https://www.geosci-model-dev.net/12/909/2019/},
        DOI = {10.5194/gmd-12-909-2019}
        }


   If you want to refer to a specific version of the software you can use
   the `Zenodo citation`_ for this purpose.

   An example BibTeX entry::

        @misc{OGGM_v1.1,
        author       = {<NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME> and <NAME> and
                        <NAME> and <NAME> and <NAME> and
                        <NAME>},
        title        = {OGGM/oggm: v1.1},
        month        = feb,
        year         = 2019,
        doi          = {10.5281/zenodo.2580277},
        url          = {https://doi.org/10.5281/zenodo.2580277}
        }


2. Your modifications to the code belong to you, but if you decide
   to share these modifications with others you'll have to do so under the same
   license as OGGM (the GNU General Public License as published by the Free
   Software Foundation).

See the `wikipedia page about GPL`_ and the `OGGM license`_ for more
information.

.. _paper in Geoscientific Model Development: https://www.geosci-model-dev.net/12/909/2019/

.. _Zenodo citation: https://zenodo.org/badge/latestdoi/43965645

.. _wikipedia page about GPL: https://en.wikipedia.org/wiki/GNU_General_Public_License

.. _OGGM license: https://github.com/OGGM/oggm/blob/master/LICENSE.rst

About
-----

:Version:
    .. image:: https://img.shields.io/pypi/v/oggm.svg
        :target: https://pypi.python.org/pypi/oggm
        :alt: Pypi version

    .. image:: https://img.shields.io/pypi/pyversions/oggm.svg
        :target: https://pypi.python.org/pypi/oggm
        :alt: Supported python versions

:Citation:
    .. image:: https://img.shields.io/badge/Citation-GMD%20paper-orange.svg
        :target: https://www.geosci-model-dev.net/12/909/2019/
        :alt: GMD Paper

    .. image:: https://zenodo.org/badge/43965645.svg
        :target: https://zenodo.org/badge/latestdoi/43965645
        :alt: Zenodo

:Tests:
{'fraction_non_alphanumeric': 0.13548996052857387, 'fraction_numerical': 0.025570619529775185, 'mean_word_length': 2.4759916492693113, 'pattern_counts': {'":': 0, '<': 66, '<?xml version=': 0, '>': 66, 'https://': 40, 'lorem ipsum': 0, 'www.': 14, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2042490', 'n_tokens_mistral': 4054, 'n_tokens_neox': 3689, 'n_words': 1131}