Skip to main content

Tools for observing the terrestrial and aquatic surfaces of Earth

Project description


Build status

Tools for observing the terrestrial and aquatic surfaces of Earth

"You belong among the wildflowers, you belong somewhere you feel free." Tom Petty

An observatory is a location used for observing terrestrial or celestial events (thank you Wikipedia). Observatories have been as simple as containing an astronomical sextant, and as complicated as modern academic supported observatories containing multi-million dollar instruments, tools, with institutions supporting long term research and education programs. While observatories are usually thought of as star-gazing investments in the field of astronomy, observatories have also been constructed in climatology/meteorology, geophysical, oceanography and volcanology communities, in order to investigate and coordinate their research efforts.

This repository is intended for the sharing and distribution of open-source Python based code useful for model and data integration that improves access to large datasets, reduces computational burden, reinvent the wheel less often, and share and communicate more about how to synthesize earth surface observations in useful ways.

Installing Version on conda-forge

Install package with conda:

conda install -c conda-forge ogh

Execute from Jupyter Notebook

!conda install -c conda-forge --yes ogh
import ogh

Installing Latest Master Version


conda create -n oghenv -c conda-forge python=2.7 --file requirements.txt --file requirements-dev.txt
source activate oghenv
pip install git+

Work with a git-versioned-folder in hydroshare to develop your own Utilities

  1. Make a fork of Freshwater-Initiative/Observatory
  2. In HydroShare, get to JupyterHub and open up a terminal instance.
  3. Change the working directory to notebooks/utilities

If you haven't cloned this repository into Hydroshare yet:

  1. type/copy in "git clone <github link>" that is available from your fork (eg.,
  2. then type in your github username and password to then download the git clone. $ git config --global "your git username" $ git config --global "your email that you used to setup the git account"
  3. you should now have notebooks/utilities/Observatory subdirectory with this and the (OGH) within.

If you have previously cloned the git folder to notebooks/utilities, update this to the latest file

  1. Change the working directory to notebooks/utilities/Observatory
  2. Pull the latest (your updated fork - pull from Freshwater-Initiative/Observatory master, before you do this) files from the repository $ git pull
  3. you should now have notebooks/utilities/Observatory subdirectory that matches your fork on (which should match Freshwater-Initiative/Observatory - if you pulled from the master)

Either way:

  1. Change the working directory to notebooks/utilities/Observatory
  2. Copy to notebooks/utilities/ $ cp ../ Now, the file '/notebooks/utilities/' is updated to the latest state (from git)

Saving changes back to git repository

  1. Work on the file and save the changes.
  2. Change the working directory to '/notebooks/utilities'
  3. Copy the modified file back to git versioned folder $ cp '' Observatory/
  4. Change the working directory to '/notebooks/utilities/Observatory'
  5. Check file changes $ git status
  6. Commit the changes $ git add $ git commit -m 'Add message to describe these changes, if any' $ git push
  7. Check that the files changed $ git status

“Use only that which works, and take it from any place you can find it.” Bruce Lee

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ogh-0.1.11-py3-none-any.whl (60.1 kB) Copy SHA256 hash SHA256 Wheel py3
ogh-0.1.11.tar.gz (76.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page