.. image:: https://ecoscope.io/en/latest/_static/logo.svg :width: 400 :height: 200 :align: center :target: https://ecoscope.io

|PyPI| |Tests| |Codecov| |Docs|

.. |PyPI| image:: https://img.shields.io/pypi/v/ecoscope.svg :target: https://pypi.python.org/pypi/ecoscope

.. |Tests| image:: https://github.com/wildlife-dynamics/ecoscope/actions/workflows/main.yml/badge.svg :target: https://github.com/wildlife-dynamics/ecoscope/actions?query=workflow%3ATests

.. |Codecov| image:: https://codecov.io/gh/wildlife-dynamics/ecoscope/branch/master/graphs/badge.svg :target: https://codecov.io/gh/wildlife-dynamics/ecoscope

.. |Docs| image:: https://readthedocs.org/projects/ecoscope/badge/?version=latest :target: https://ecoscope.io/en/latest/index.html

======== Ecoscope

The Ecoscope core python library is built for analyses related to wildlife movement, environmental and conservation datasets. It provides methods and approaches for: Data I/O (EarthRanger, Google Earth Engine, Landscape Dynamics, MoveBank, Geopandas), Movement Data (Relocations, Trajectories, Home-Ranges, EcoGraph, Recurse, Resampling, Filtering), Visualization, Environmental analyses (Seasons determination, Remote sensing anomalies), Covariate labeling (Day/Night, Seasonal, GEE Image Collections/Images).

Development & Testing

Development dependencies are included in environment.yml.

Please configure code-quality git hooks with:

.. code:: console

>>> pre-commit install

Copyright & License

Ecoscope is licensed under BSD 3-Clause license. Copyright (c) 2026, Wildlife Dynamics.

Donate

Ecoscope is currently developed and maintained by Wildlife Dynamics and the Allen Institute for AI (Ai2). If you find Ecoscope useful in your work, please consider donating to help support ongoing development and maintenance of this open-source project Contact Wildlife Dynamics <https://docs.google.com/forms/d/e/1FAIpQLSe6mMSvZH7JlIID2yjKUvPN4Cl4eddlZVZGrikHKvA21HdF1g/viewform>_

Acknowledgments

We thank the many individuals and organizations who have contributed to the development of Ecoscope. In particular: Jake Wall, Charles Stern, Alex Morling, Yun Wu, Ray R, Marcos Davidovich, Mariano Martinez, Tiffany Wong, Jes Lefcourt, Chris Jones, Chris Doehring, Juan Lescano, Anderson Arendt, Tevin Temu, Eric Gitonga, Rodney Omukuti, Peter Kulits, Zakaria Hussein, Catherine Villeneuve, Lydia Tiller, Harry Williams, India Taylor-Smith, Anil Patel, Holly Dublin, George Wittemyer, Allen Family Philanthropies, Allen Institute for Artificial Intelligence, Google Earth Outreach, Mara Elephant Project, Save the Elephants, and Elephants Alive.