Geoenrich online (beta)

A beta version of the GeoEnrich web app is available for basic uses. For more advanced uses, a self-hosted version is available as a docker image.

1. File format

Only DarwinCore archives and csv files are supported. The csv files must follow the following format requirements.

Warning

CSV separators must be commas. A common mistake (caused by a well-known proprietary spreadsheet software) is that separators in the csv files are semicolons instead of commas. If you’re having a mysterious error message when using geoenrich, please double-check this.

1.1. Species occurrences

The following columns are mandatory: a unique ID, an occurrence date, its latitude and longitude. They must be named respectively id, date, latitude and longitude. Here is an exemple of such a file:

Turtle occurrences

id

latitude

longitude

date

Comments

turtle1

-28.752241

154.8926541

2018-07-29

bottom feeding

turtle2

2.5754611

72.964164

2019-02-13

cruising

turtle3

-21.2871554

55.316446

2021-01-05

resting

Download sample csv file webapp_turtles.csv (right click -> Save As).

1.2. Areas

A unique ID is mandatory, as well as the bounds of the areas that are requested. Columns must be named as in the following example:

Areas of interest

id

latitude_min

latitude_max

longitude_min

longitude_max

date_min

date_max

corsica

41.2

43.2

8.3

9.7

2015-06-01

2015-06-30

galapagos

-1.5

0.79

-91.9

-89

2022-03-18

2022-03-18

samoa

-14.1

-13.3

-172.9

-171.3

2018-11-21

2018-11-28

Download sample csv file webapp_areas.csv (right click -> Save As).

2. Restrictions

For more features, you may install geoenrich (python or R) onto your computer and this will enable the following features:

  • Support for csv files with custom column names.

  • Support for calculated variables (Eddy Kinetic Energy and derivatives).

  • No maximum download size.

3. Setting up the self-hosted version

You may use GeoEnrich and its associated webapp locally by loading a Docker container.

To do this you can download docker-compose.yml and Dockerfile, and load the container the following way:

docker-compose up -d --build

You can then use geoenrich from the command line:

docker exec -it geoenrich python

Or launch the web app in a browser:

localhost:8080