> For the complete documentation index, see [llms.txt](https://docs.animl.camera/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.animl.camera/fundamentals/export-data.md).

# Export Data

To export a CSV or JSON file of your *Image*, *Object*, and *Label* metadata, perform the following steps:

1. Select the *View*/*Filters* you'd like to apply to your export
2. Click on the "Export Data" button on the bottom of the *Filters* panel (bottom left of screen)
3. Select which format you'd like to export your data in

{% hint style="info" %}
**Only reviewed images will be exported**

Currently, even if the "non-reviewed" filter is checked on, only fully reviewed *Images* and *Objects* will be exported. Similarly, only the "winning" *Labels* on *Objects* (the most recently validated *Label*) will be exported. All invalidated or non-validated *Labels* are ignored.
{% endhint %}

{% hint style="info" %}
**Timezones**

Be mindful that all date-time fields in all exports will be in UTC+0.&#x20;
{% endhint %}

## Supported export formats

### CSV

CSV export is helpful for ecological data analysis in Excel and [CamtrapR](https://cran.r-project.org/web/packages/camtrapR/index.html). It does not contain bounding-box information for the *Objects*.&#x20;

### COCO for Camera Traps

[COCO for Camera Traps](https://github.com/Microsoft/CameraTraps/blob/main/data_management/README.md#coco-cameratraps-format) is helpful for pulling *Image* and annotation data into a machine learning training workflow. The *Object* records (annotations) do contain bounding box information.

## Exporting image files

Currently you need to have special AWS permissions and some basic familiarity with a command line interface to export/download your image files. If you need access, please reach out to Nathaniel at <nathaniel.rindlaub@tnc.org> for support.&#x20;

The image export process entails the following steps:

1. Procure the necessary AWS credentials
2. Install the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and configure a new named "profile" (the profile name **must** be `animl`)
3. Clone and follow the setup instructions in the [animl-analytics](https://github.com/tnc-ca-geo/animl-analytics/blob/main/README.md) GitHub repository
4. Run the `utils/download_images.py` script as described in the animl-analytics documentation
