Use Case 1 | Lifewatch regional portal

You are here

Use Case 1



You upload a list with your own marine species observations and want to know how many times these species were already observed in a 1000m radius around your observation points (based on OBIS).

The input file is a text file containing three columns: ScientificName, Latitude, and Longitude (example).

This use case combines two web services in a fixed order: (1) Taxon match, (2) Number of observations in a 1000m radius around a point.

(1) First, the web service 'Taxon match' matches the marine species names to the World Register of Marine Species (WoRMS). If a species name is available in WoRMS, this web service renders its AphiaID (an unique identifier of Aphia, the database behind WoRMS), its status (accepted or unaccepted) and its accepted name. This output information is added as extra columns to the original input file. [NOTE: the taxon match can also match taxon names to other taxonomic databases and nomenclatures, such as e.g. Catalogue of Life (CoL), the Integrated Taxonomic Information System (ITIS), etc. For this use case we only select WoRMS, since the uploaded list contains purely marine species.]

(2) Second, the web service 'Number of observations in a 1000m radius around a point' defines a radius of 1000m around the uploaded observation points. Based on the AphiaID generated by the taxon match, this web service determines the observation records for the species in the Ocean Biodiversity Information System (OBIS), in this specific radius. This number of observations is added to the input file as an extra column.


1. Upload your file

Upload your data file and select the relevant row and column delimiter and decimal symbol. Select "lifewatch" for data format.

UC1 - Upload your file

2. Select web services

Select the required web services: 'Taxon match' and 'Number of observations in a 1000m radius around a point'.

UC1 - Selected services 

3. Verify order, change order if necessary and run

Only keep 'Taxon match World Register of Marine Species (WoRMS)', remove all other taxon matches. The order of the selected web services can be changed by dragging the grey bars with the arrows. The required web service order for this use case is (1) Taxon match World Register of Marine Species (WoRMS), (2) Number of observations in a 1000m radius around a point.

UC1 - Verify order services

4. Preview screen

When you click "Next", you are redirected to the preview screen. Make sure that every column name from the uploaded file corresponds with a column name from the pick list. In this case choose 'ScientificName', 'Latitude', and 'Longitude'.

UC1 - Preview1

In the lower section of the preview screen, you can find information about duplicate or missing fields per requested web service. Check for every web service if the required fields are present in the input file or will be generated by a previous web service.

UC1 - Preview2  UC1 - Preview3 

5. Results

Click "Start". The following message appears:

UC1 - Results

Click on "Results". Your result file (example) will appear at the top of the results table. The result report gives an overview of the requested web services, the results per web service, any errors that might have occurred during the process, and a legend of the added fields in the result file. The result file is also available through the result report.

UC1 - ResultReport