The concept was presented as a poster at the EGU GA 2017 (Vienna) by Kraft et al
ODMF is a web app with database to manage environmental observatories. It was created from a hydrological persperctive but current development aims at agro-environmental observatories. The system is under constant development.
ODMF stores data from various sources in datasets, from manual measurements, lab results, continuous data providers like LoRa networks or uploaded files from field data loggers with its spatial location. The file manager stores user files as a shared folder. The messenger provides tools for planning field activity, setting alarm conditions (frost in the potato barn, no incoming data from a LoRa network, etc) and saving past activities at a site in a log book.
The basic idea is to upload and import data early and do curation, quality control, meta data annotation, calibration and verification on the server - and not wait for the users to decide when their data is ready.
Go to the odmf-docker repository and follow the instructions there.
While the docker installation in preferred, odmf can be installed in a python virtual environment for testing purposes
Install virtual environment in directory venv
and upgrade infrastructure, and activate it
Linux / MacOS:
$ python -m venv venv
$ source venv/bin/activate
$ python -m pip install --upgrade pip wheel setuptools
Windows needs an extra python installation, you might need to put it on your PATH. Then do from a PowerShell terminal:
PS C:\ODMF> python -m venv venv
PS C:\ODMF> .\venv\Scripts\activate
PS C:\ODMF> python -m pip install --upgrade pip wheel setuptools
Install odmf (this will take sometime and install many requirements),
$ pip install https://github.com/jlu-ilr-hydro/odmf/archive/master.zip
$ git clone https://github.com/jlu-ilr-hydro/odmf odmf-src
$ pip install -e odmf-src/
Check the command line tool
$ odmf --help
Create a folder for your instance, go there as your work dir and create a configuration file with
$ odmf configure
Edit the configuration file config.yaml for your needs, eg set the right db connection. If you are fine to use SQLite (ok if you have only very few parallel connections, not for production), you can leave the db connection as is. Enter a valid Google-Maps-API key, configure your http-port. If everything is settled, create the base db structure with
$ odmf db-create
Now you are ready to go:
$ odmf start -b
Starts ODMF in your commandline and opens a webbrowser with the page. Note: ODMF stops if you close the command line. If you want to run ODMF as a service, either study how to start a service on your OS or just use docker.
You can interact with the database in a prepared IPython terminal:
$ odmf interactive