https://github.com/atmos-python/atmos
An atmospheric sciences library for Python
https://github.com/atmos-python/atmos
Last synced: 8 months ago
JSON representation
An atmospheric sciences library for Python
- Host: GitHub
- URL: https://github.com/atmos-python/atmos
- Owner: atmos-python
- License: mit
- Created: 2015-05-08T19:17:38.000Z (over 10 years ago)
- Default Branch: develop
- Last Pushed: 2024-09-28T14:09:38.000Z (about 1 year ago)
- Last Synced: 2025-04-05T21:51:19.353Z (9 months ago)
- Language: Python
- Size: 1.51 MB
- Stars: 63
- Watchers: 7
- Forks: 21
- Open Issues: 10
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-atmos - atmos
README
*****
atmos
*****
---------------------------------------
An atmospheric sciences utility library
---------------------------------------
**atmos** is a library of Python programming utilities for the atmospheric
sciences. It is in ongoing development. If you have an idea for a feature or
have found a bug, please post it on the `GitHub issue tracker`_.
Information on how to use the module can be found predominantly by using the
built-in help() function in Python. Many docstrings are automatically
generated by the module and so information may appear to be missing in the
source code. There is also `HTML documentation`_ available.
This module is currently alpha. The API of components at the base module
level should stay backwards-compatible, but sub-modules are subject to change.
In particular, features in the util module are likely to be changed or removed
entirely.
.. contents::
:backlinks: none
:depth: 1
Features
========
* defined constants used in atmospheric science
* functions for common atmospheric science equations
* a simple calculate() interface function for accessing equations
* no need to remember equation function names or argument order
* fast calculation of quantities using numexpr
* skew-T plots integrated into matplotlib
Dependencies
============
This module is tested to work with Python versions 2.6, 2.7, 3.3, and 3.4 on
Unix. Support is given for all platforms. If there are bugs on your
particular version of Python, please submit it to the `GitHub issue tracker`_.
Package dependencies:
* numpy
* numexpr
* six
* nose
Installation
============
To install this module, download and run the following:
.. code:: bash
$ python setup.py install
If you would like to edit and develop the code, you can instead install in develop mode
.. code:: bash
$ python setup.py develop
If you are running Anaconda, you can install using conda:
.. code:: bash
$ conda install -c mcgibbon atmos
You can also install using pip:
.. code:: bash
$ pip install atmos
Development version
===================
The most recent development version can be found in the `GitHub develop
branch`_.
Examples
========
Calculating pressure from virtual temperature and air density:
.. code:: python
>>> import atmos
>>> atmos.calculate('p', Tv=273., rho=1.27)
99519.638400000011
License
=======
This module is available under an MIT license. Please see ``LICENSE.txt``.
.. _`GitHub issue tracker`: https://github.com/mcgibbon/atmos/issues
.. _`GitHub develop branch`: https://github.com/mcgibbon/atmos/tree/develop
.. _`HTML documentation`: https://pythonhosted.org/atmos