# app.gainforest.dwc.dataset

> Published by [gainforest.earth](https://lexicon.garden/identity/did:plc:qoti4acfmc5wg6zzmtix6hse)

✓ This is the authoritative definition for this NSID.

## Description

A named dataset grouping a batch of Darwin Core occurrence records uploaded together. Created during the tree upload wizard so users can manage and reference their uploads as cohesive units.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.dwc.dataset)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.dwc.dataset/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.dwc.dataset/examples)

## Definitions

### `app.gainforest.dwc.dataset`

**Type**: `record`

A user-named dataset representing a batch of uploaded occurrence records.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | User-given name for the dataset (e.g. 'March 2025 Danum Valley Survey'). |
| `createdAt` | `string` (datetime) | Yes | Timestamp of dataset creation in the ATProto PDS. |
| `description` | `string` | No | Optional description of the dataset contents, methodology, or purpose. |
| `recordCount` | `integer` | No | Number of occurrence records in this dataset. Set after upload completes. |
| `establishmentMeans` | `string` | No | Batch-level establishment means for all records in this dataset. Uses the GBIF controlled vocabulary. |

## Raw Schema

```json
{
  "id": "app.gainforest.dwc.dataset",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "User-given name for the dataset (e.g. 'March 2025 Danum Valley Survey').",
            "maxGraphemes": 256
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp of dataset creation in the ATProto PDS."
          },
          "description": {
            "type": "string",
            "description": "Optional description of the dataset contents, methodology, or purpose.",
            "maxGraphemes": 2048
          },
          "recordCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of occurrence records in this dataset. Set after upload completes."
          },
          "establishmentMeans": {
            "enum": [
              "native",
              "introduced",
              "naturalised",
              "invasive",
              "managed",
              "uncertain"
            ],
            "type": "string",
            "description": "Batch-level establishment means for all records in this dataset. Uses the GBIF controlled vocabulary.",
            "maxGraphemes": 64
          }
        }
      },
      "description": "A user-named dataset representing a batch of uploaded occurrence records."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A named dataset grouping a batch of Darwin Core occurrence records uploaded together. Created during the tree upload wizard so users can manage and reference their uploads as cohesive units."
}
```