Skip to main content

To start migrating your existing, already catalogued camera trap data into Wildlife Insights, follow the instructions below.

1. Map your data to the Wildlife Insights Global Taxonomy

Create a taxonomic mapping between your data and the Wildlife Insights Global Taxonomy. Use the script WI_Taxonomy.R, which can be found in our Github repository.

Wildlife Insights Github Repo

2. Migrate your data into the batch upload templates

First, take a look at the batch upload templates and make sure that your data includes all of the required fields. The columns names on your batch upload templates should correspond to the 'Column Name' in column H in the templates. Your data must match these templates to be migrated into Wildlife Insights as batch uploads.

The four files needed to complete a batch upload for one camera trap project include the following .csv files: Project, Camera, Deployment and Image .csv files.

See the Wildlife Insights GitHub repository for code examples that transform data from one format into these templates.

Batch upload templates Wildlife Insights Github Repo

3. Upload your images and data to the Google Cloud Platform

A. Create a Google Account

Please share with WI admins your Google account - a personal gmail or associated business Google Cloud account.

The WI Admin will associate your account to a private storage object in the Google Cloud Platform and assign you access to the GCP storage bucket.


B. Install gsutil


C. Uploading Batch Upload Templates and Images to GCP

Once you have gsutil installed the next step is to upload your images. WI Admins will create a top-level ‘bucket’ to house images for your organization. Underneath that directory we will create a project ‘folder’ for each of the projects. In each of these project folders you will upload all of the images in your project. In this example, the bucket is called gs://zsl_image_upload/LondonHogwatch

To copy files from your local storage location (i.e. laptop, attached drive, SAN, etc) you will need to do the following steps:

gsutil -m cp -r YOUR_TOP_LEVEL IMAGE_DIR gs://zsl_image_upload/LondonHogwatch

The above command means the following:

-m: starts many computer threads to upload (i.e. this means it will upload more than one image at a time);
cp: copy;
-r: recursive, or that all images and directories below your’ top level image dir’ will be copied.