To be able to discover, request and use imagery products based on virtual constellation using the <geosys/> API.
Who we are
Project description
Β·
Report Bug
Β·
Request Feature
Table of Contents
EarthDaily Agro is the agricultural analysis division of EartDaily Analytics. Learn more about Earth Daily at EarthDaily Analytics | Satellite imagery & data for agriculture, insurance, surveillance. EarthDaily Agro uses satellite imaging to provide advanced analytics to mitigate risk and increase efficiencies β leading to more sustainable outcomes for the organizations and people who feed the planet.
Throught our <geosys/> platform, we make geospatial analytics easily accessible for you to be browsed or analyzed, within our cloud or within your own environment. We provide developers and data scientists both flexibility and extensibility with analytic ready data and digital agriculture ready development blocks. We empower your team to enrich your systems with information at the field, regional or continent level via our API or Apps.
We have a team of experts around the world that understand local crops and ag industry, as well as advanced analytics to support your business.
We have established a developer community to provide you with plug-ins and integrations to be able to discover, request and use aggregate imagery products based on Landsat, Sentinel, Modis and many other open and commercial satellite sensors.
The geosyspy
python package aims to provide an easy and ready to use library allowing any Python developers to quickly experience Earthdaily Agro capabilities.
- Data sourcing:
- Get aggregated NDVI/EVI normalized times series from Modis satellite imagery as pandas dataframe
- Get aggregated historical and forecast weather data (precipitation, temperatures...) location based time series as pandas dataframe
- Get SENTINEL 2, LANDSAT 8 and LANSAT 9 satellite images time series in xarray format
- Analytic publication:
- Save and retrieve custom data in Analytics Fabrik
See documentation and Examples notebook for more information
Make sure you have valid credentials. If you need to get trial access, please register here.
This package has been tested on Python 3.10.11.
If you are using Conda, there are the steps to follow to create a virtual environment:
conda create --name demo
conda activate demo
pip install geosyspy
Please refer to the install.md file.
- Install dependencies
conda config --add channels conda-forge
conda install --file requirements.txt
or
pip install -r requirements.txt
- Create .env file
You need a .env file with your credentials to run the Examples Jupyter notebook.
API_CLIENT_ID=
API_CLIENT_SECRET=
API_USERNAME=
API_PASSWORD=
- Install Jupyter notebook Examples dependencies
conda install --file requirements-notebook.txt
or
pip install -r requirements-notebook.txt
- Set up the Jupyter Notebook kernel
python -m ipykernel install --user --name demo
- Run the Jupyter notebook
Build the image locally :
docker build --tag geosyspy .
Run it :
docker run -it --env-file .env geosyspy
or, without .env file :
docker run -it -e API_CLIENT_ID='...' -e API_CLIENT_SECRET='...' -e API_USERNAME='...' -e API_PASSWORD='...' geosyspy
Then :
>>> from geosyspy import Geosys
>>> from geosyspy.utils.constants import *
>>> import os
>>> client = Geosys(os.getenv('API_CLIENT_ID'), os.getenv('API_CLIENT_SECRET'), os.getenv('API_USERNAME'), os.getenv('API_PASSWORD'), Env.PREPROD, Region.NA)
Initialize client:
from geosyspy import Geosys
from geosyspy.utils.constants import *
client = Geosys("API_CLIENT_ID", "API_CLIENT_SECRET", "API_USERNAME", "API_PASSWORD", Env.PREPROD, Region.NA)
Query data:
polygon = "POLYGON((...))"
today = dt.date.today()
year_ago = dt.date.today() + relativedelta(months=-12)
dataframe = client.get_time_series(start_date = year_ago, end_date = today, collection=SatelliteImageryCollection.MODIS, indicators=["NDVI"], polygon=polygon)
Use Geosyspy logger
import logging
geosys_logger = logging.getLogger('geosyspy')
geosys_logger.setLevel(logging.DEBUG)
See the Jupyter notebook Examples for a working example.
The following links will provide access to more information:
If this project has been useful, that it helped you or your business to save precious time, don't hesitate to give it a star.
Distributed under the GPL 3.0 License.
For any additonal information, please email us.
Β© 2022 Geosys Holdings ULC, an Antarctica Capital portfolio company | All Rights Reserved.