EarthPy

EarthPy: A Python package that makes it easier to explore and plot raster and vector data using open source Python tools. - Published in JOSS (2019)

https://github.com/earthlab/earthpy

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 9 DOI reference(s) in README and JOSS metadata
✓
Academic publication links
Links to: science.org, joss.theoj.org
✓
Committers with academic emails
14 of 38 committers (36.8%) from academic institutions
○
Institutional organization owner
✓
JOSS paper metadata
Published in Journal of Open Source Software

Keywords

education python raster spatial-data vector

Keywords from Contributors

geoscience earth-science fatiando-a-terra geophysics interpolation scipy-stack bioinformatics fracminhash kmer minhash

Scientific Fields

Political Science Social Sciences - 90% confidence

Last synced: 4 months ago · JSON representation

Repository

A package built to support working with spatial data using open source python

Basic Info

Host: GitHub
Owner: earthlab
License: bsd-3-clause
Language: Python
Default Branch: main
Homepage: https://earthpy.readthedocs.io
Size: 2.51 MB

Statistics

Stars: 525
Watchers: 17
Forks: 162
Open Issues: 42
Releases: 11

Topics

education python raster spatial-data vector

Created almost 8 years ago · Last pushed 5 months ago

Metadata Files

Readme Changelog Contributing License Code of conduct Zenodo

EarthPy

PyPI PyPI - Downloads Conda Conda

EarthPy makes it easier to plot and manipulate spatial data in Python.

Why EarthPy?

Python is a generic programming language designed to support many different applications. Because of this, many commonly performed spatial tasks for science including plotting and working with spatial data take many steps of code. EarthPy builds upon the functionality developed for raster data (rasterio) and vector data (geopandas) in Python and simplifies the code needed to:

EarthPy also has an io module that allows users to

Quickly access pre-created data subsets used in the earth-analytics courses hosted on www.earthdatascience.org
Download other datasets that they may want to use in their workflows.

EarthPy's design was inspired by the raster and sp package functionality available to R users.

View Example EarthPy Applications in Our Documentation Gallery

Check out our vignette gallery for applied examples of using EarthPy in common spatial workflows.

Install

EarthPy can be installed using pip, but we strongly recommend that you install it using conda and the conda-forge channel.

Install Using Conda / conda-forge Channel (Preferred)

If you are working within an Anaconda environment, we suggest that you install EarthPy using conda-forge

bash $ conda install -c conda-forge earthpy

Note: if you want to set conda-forge as your default conda channel, you can use the following install workflow. We recommmend this approach. Once you have run conda config, you can install earthpy without specifying a channel.

bash $ conda config --add channels conda-forge $ conda install earthpy

Install via Pip

We strongly suggest that you install EarthPy using conda-forge given pip can be more prone to spatial library dependency conflicts. However, you can install earthpy using pip.

To install EarthPy via pip use:

bash $ pip install --upgrade earthpy

Once you have successfully installed EarthPy, you can import it into Python.

```python

import earthpy.plot as ep ```

Below is a quick example of plotting multiple bands in a numpy array format.

```python

arr = np.random.randint(4, size=(3, 5, 5)) ep.plot_bands(arr, titles=["Band 1", "Band 2", "Band 3"]) plt.show() ```

Active Maintainers

We welcome contributions to EarthPy. Below are the current active package maintainers. Please see our contributors file for a complete list of all of our contributors.

Contributors

We've welcome any and all contributions. Below are some of the contributors to EarthPy. We are currently trying to update this list!!

How to Contribute

We welcome contributions to EarthPy! Please be sure to check out our contributing guidelines for more information about submitting pull requests or changes to EarthPy.

License & Citation

BSD-3

Citation Information

When citing EarthPy, please cite our JOSS paper:

``` @article{Wasser2019EarthPy, journal = {Journal of Open Source Software}, doi = {10.21105/joss.01886}, issn = {2475-9066}, number = {43}, publisher = {The Open Journal}, title = {EarthPy: A Python package that makes it easier to explore and plot raster and vector data using open source Python tools.}, url = {https://doi.org/10.21105/joss.01886}, volume = {4}, author = {Wasser, Leah and Joseph, Maxwell and McGlinchy, Joe and Palomino, Jenny and Korinek, Nathan and Holdgraf, Chris and Head, Tim}, pages = {1886}, date = {2019-11-13}, year = {2019}, month = {11}, day = {13}, }

```

Owner

Name: Earth Lab
Login: earthlab
Kind: organization
Location: Boulder, Colorado, USA

Website: https://www.earthdatascience.org/
Twitter: EarthLabCU
Repositories: 58
Profile: https://github.com/earthlab

Capitalizing on the data deluge to accelerate science

JOSS Publication

EarthPy: A Python package that makes it easier to explore and plot raster and vector data using open source Python tools.

Published

November 13, 2019

DOI

10.21105/joss.01886

Volume 4, Issue 43, Page 1886