.. toctree:: :maxdepth: 2 :hidden: :caption: Version 2 Release Guide userguide/GUIDE_V2.rst .. toctree:: :maxdepth: 2 :hidden: :caption: User Guide userguide/index.rst .. toctree:: :maxdepth: 2 :hidden: :caption: Reference Guide API/index.rst .. toctree:: :maxdepth: 2 :hidden: :caption: Example Gallery source/auto_examples/index.rst .. toctree:: :maxdepth: 1 :hidden: :caption: Blog blog.md .. toctree:: :maxdepth: 1 :hidden: :caption: Getting Help GitHub Issue Tracker Atmospheric Community Toolkit (ACT) =================================== The Atmospheric data Community Toolkit (ACT) is an open source Python toolkit for working with atmospheric time-series datasets of varying dimensions. The toolkit is meant to have functions for every part of the scientific process; discovery, IO, quality control, corrections, retrievals, visualization, and analysis. It is meant to be a community platform for sharing code with the goal of reducing duplication of effort and better connecting the science community with programs such as the `Atmospheric Radiation Measurement (ARM) User Facility `_. Overarching development goals will be updated on a regular basis as part of the `Roadmap `_ . |act| .. |act| image:: act_plots.png Please report any issues or feature requests by submitting an `Issue `_. Additionally, our `discussions boards `_ are open for ideas, general discussions or questions, and show and tell! ACT's Third Roadmap =================== To meet the needs of the community and stakeholders, ACT will be creating a new roadmap. This roadmap will continue a plan forward on features to improve on and to add in newer ACT versions. A part of this new roadmap is a survey from the community that will provide feedback for the developers on priorities for newer ACT versions. If time permitting, and you are a user of ACT or are considering to use ACT the survey can be found here: `ACT Roadmap Survey` `_ The feedback would be much appreciated. Dependencies ============ | `xarray `_ | `NumPy `_ | `SciPy `_ | `matplotlib `_ | `skyfield `_ | `pandas `_ | `dask `_ | `Pint `_ | `PyProj `_ | `Proj `_ | `Six `_ | `Requests `_ | `MetPy `_ Optional Dependencies ===================== | `MPL2NC `_ Reading binary MPL data. | `Cartopy `_ Mapping and geoplots | `Py-ART `_ Reading radar files, plotting and corrections | `scikit-posthocs `_ Using interquartile range or generalized Extreme Studentized Deviate quality control tests | `icartt `_ icartt is an ICARTT file format reader and writer for Python Contributing ============ ACT is an open source, community software project. Contributions to the package are welcomed from all users. The latest source code can be obtained with the command:: git clone https://github.com/ARM-DOE/ACT.git If you are planning on making changes that you would like included in ACT, forking the repository is highly recommended. We welcome contributions for all uses of ACT, provided the code can be distributed under the BSD 3-clause license. For more on contributing, see the `contributor's guide. `_ Testing ======= After installation, you can launch the test suite from outside the source directory (you will need to have pytest installed):: $ pytest --mpl --pyargs act In-place installs can be tested using the `pytest` command from within the source directory.