Deployment and Import All CSV fields

Modified on Tue, 26 May at 4:53 PM

This guide provides detailed information about the fields in the import multiple deployments CSV file, their behaviour when importing into the WildObs Image Platform, and links to more information. For more information on how to upload multiple deployments to a project, visit Import multiple deployments to a project (in progress).


TABLE OF CONTENTS


About deployment fields

Deployment fields populate the deployments.csv file of the Camera Trap Data Package (Camtrap DP)


This information can be entered to the WildObs Image Platform when you Add a deployment to a project or you can Import multiple deployments to a project at once by uploading a pre-filled CSV file. 


The tables in each section below provide the following information:

  • CSV name – Header name of the column for the multiple import all CSV file. 
  • Field name - This is the name of the field on the WildObs Image Platform. If the field appears differently depending upon the current view, multiple names may be added. For example, Deployment / Camera identifier lists the Camera / Label field. 
  • Description of the field, examples and units of measurement, if applicable. Please note that units of measurement required may differ between the CSV, platform and the Camtrap DP standard. 
  • If the field maps directly to a Camtrap DP field, a link to the Camtrap DP page is provided which contains more information, constraints and examples. 


How the Import All CSV file is processed

It is important that the CSV file is completed correctly for successful import:

  • The CSV file must use the exact column names as the example CSV.
  • Each row of the CSV file is treated as an individual deployment. 
  • Required fields (denoted by an asterisk) must be complete for each deployment or an error will be given.
  • Formats for fields are validated when uploading. Be sure to check the input date format to avoid errors. 
  • Some information creates an entry on the platform, such as camera, tags and groups. The behaviour of these fields is noted under each section. 


Location information

The following details create a location entry within the project that can then be selected when adding future deployments. Locations can be added manually from the Locations view, when creating a deployment or when using the import all feature.


CSV nameField nameDescriptionFormat

locationID *


Location / Name

Deployment / Location

Identifier describing the field location.


Each location ID should have unique coordinates. 


In the platform, this is called location name. 


https://camtrap-dp.tdwg.org/data/#deployments.locationID


string

latitude * 


Location / LatitudeGeographic latitude of the deployment site. 

Example: 45.12345

https://camtrap-dp.tdwg.org/data/#deployments.latitude


number

longitude * 


Location / LongitudeGeographic longitude of the deployment site.

Example: 45.12345

https://camtrap-dp.tdwg.org/data/#deployments.longitude


number

FeatureA single descriptive feature from a pre-set list can be added to a location from the Locations view.

This field cannot be added from the Deployments view or via the import all function.

https://camtrap-dp.tdwg.org/data/#deployments.featureType


HabitatA habitat, created under Settings > Habitats, can be added to a location from the Locations view.

This field cannot be added from the Deployments view or via the import all function.

https://camtrap-dp.tdwg.org/data/#deployments.habitat


Camera information

A unique set of camera information creates a camera entry within the project that can then be selected for deployments. If identical information is used, only one new camera entry will be added. Only camera identifier appears on the deployment view on the platform – other details are accessible via the Cameras list. 


CSV nameField nameDescriptionFormat

cameraID *


Camera / Label

Deployment / Camera identifier

Unique camera identifier. 


Example: CAM_1001

It is recommended that the camera serial number is used as the cameraID to align with Camtrap DP https://camtrap-dp.tdwg.org/data/#deployments.cameraID


string

cameraMake


Camera / MakeManufacturer and model of the camera formatted as manufacturer-model.

Example: Reconyx-PC800

https://camtrap-dp.tdwg.org/data/#deployments.cameraModel
string

cameraSerialNo

Camera / Serial no.Serial number of the camera.string
cameraYOPCamera / Year of purchaseYear of purchase of the camera.integer


Time information

These fields all appear under the Deployment view when adding manually. 

deploymentStart *

Start

Date or date-time when the deployment begins.

Examples:
12/02/2025
12/02/2025, 12:06:00 AM

When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentStart


DD/MM/YYYY

or

DD/MM/YYYY, HH:MM:SS [AM or PM] 

deploymentEnd *

End

Date or date-time when the deployment ends. Must occur after the deployment start.

Examples:
12/02/2025
12/02/2025, 12:06:00 AM

When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentEnd


DD/MM/YYYY

or

DD/MM/YYYY, HH:MM:SS [AM or PM]

utcOffset

UTC Offset

Time zone offset for the deployment.  If not provided, the system will use the user's local time zone. Must start with "UTC".

Example: UTC+10


UTC[+ or -]HH

timestampIssues

Invalid

Used to indicate known timestamp problems.

Reflected as "Invalid" column in deployments. Invalid deployments are excluded from data exports.


https://camtrap-dp.tdwg.org/data/#deployments.timestampIssues
TRUE or FALSE


Deployment classification

Deployment tags and Deployment groups can be added under Settings sub-menus. For more information, see Project settings - Other settings

deploymentTags

Tags

Tags used to describe the deployment.

Example: Tag 1, TAG2, Tag*3

When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentTags


string

Comma-separated values

deploymentGroups

Groups

Labels used to group deployments, particularly denoting when and where deployments occurred.

Example: Group 1, Group2

When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentGroups


string

Comma-separated values


Camera setup information

When entering deployments manually, the Platform requests measurements in different units to what is required in the multiple import CSV file detailed below. 

detectionDistance

Detection distance


Maximum distance in meters at which the camera can reliably detect activity.
https://camtrap-dp.tdwg.org/data/#deployments.detectionDistance


number

cameraHeight

Camera height

Height of camera installation in meters.

https://camtrap-dp.tdwg.org/data/#deployments.cameraHeight


number

cameraHeading

Camera heading

Camera installation direction.

The exact value of this field must match one of:
North

North-East

East

South-East

South

South-West

West

North-West


Example: North-East

When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.cameraHeading


string

cameraTilt

Camera tilt

Vertical tilt angle of camera installation, where -90 is facing down, 0 is horizontal and 90 is facing up.

The value can range from -90 to 90.

Example: -20

https://camtrap-dp.tdwg.org/data/#deployments.cameraTilt


number

baitUse

Baits

Indicates whether bait was used.

The exact value of this field must match one of:
Food
No bait
Visual
Other bait
Acoustic
Scent

Example: No bait

The WildObs Image Platform only supports a single value from a set selection. When exported from the platform, this field will be converted to a boolean value of true or false to meet the correct format for https://camtrap-dp.tdwg.org/data/#deployments.baitUse
string


Personnel information

If the person in the following fields is a user on the project, use the matching first name and last name for the person. If details entered do not match a user on the project, the Principal Investigator will be added to these fields. 

If there is no Principal Investigator set, it will default to the project owner. Entering details here that do not match an existing user will not create a user on the project. 


setupBy

Person deploy

Person responsible for camera setup. 

Example: Jane Doe

https://camtrap-dp.tdwg.org/data/#deployments.setupBy

string

pickupBy

Person pickup

Person responsible for retreiving the camera. 

Example: Jane Doe


string



Additional information

deploymentComments

Notes


Free-text field for notes about the deployment.
https://camtrap-dp.tdwg.org/data/#deployments.deploymentComments

string

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article