Web Services

Occurrence Sets

The Lifemapper Occurrence Set Service allows users to get an occurrence set, list sets that fit desired criteria, or post a new occurrence set.

Occurrence sets are groups of occurrence points. They are generally all from the same species, but do not have to be. They should, however, be related enough that creating a model would make sense. For example, if you wanted to create a model of prey for a certain species, you could create an occurrence set of all of the points where any of those species occurred.

Get a List of Occurrence Sets

If you call http://www.lifemapper.org/services/sdm/occurrences/xml with an HTTP GET request, a list of available occurrence sets will be returned.

The items returned in this list can be filtered using a number of url parameters. A full list of the available filter parameters can be found in the Lifemapper web services WADL document. You can get an idea of how the parameters work by visiting the listing service with a web browser. A form will be presented at the top of the page that will allow you to filter the results as well as display the filters used to generate that page of results.

One use of this service is to find occurrence sets that have enough points to be modeled. The Lifemapper pipeline will pick occurrence sets with fifty or more points and then model them, but you are free to set your own threshold for the models you request. The filter needed for this operation is named "minimumNumberOfPoints" and for this example we will set it to 500. The resulting url is:

http://www.lifemapper.org/services/sdm/occurrences/xml?minimumNumberOfPoints=500 .

The list of occurrence sets is available in a variety of formats. These formats do not contain the point data from the occurrence sets, just metadata about them.

Formats available:

Get an Individual Occurrence Set

You will need the occurrence set id number to return an individual occurrence set. You can browse the list of occurrence sets to find the occurrence set you would like, and just click the link. Alternatively, you can browse the occurrence sets associated with an experiment you may have submitted using that service.

Get an Individual Occurrence Set Method explains in more detail how this service works.

Formats available:

Post an Occurrence Set

When you submit an experiment through the Lifemapper Web Application, you actually have the opportunity to upload points as well. Simply expand the Upload Points section and click the Upload button.

Additionally, you can post an occurrence set directly. We currently accept points in CSV and Shapefile formats. See the links in the side navigation.

Post from CSV

Post from Shapefile