# Yield Data Import

To upload as-applied data files choose the **Import Data** menu and the **Upload Files** item. Then select **Yield Data**.

Keep in mind that there are some restrictions:

* Only WGS84 (EPSG:4326) shape files are supported with points or polygons-based data.
* The attributes must be a Numeric type (Integer or Real, not String).
* 100MB is the maximum file size.
* Try to eliminate the usage of special symbols like `%+@` in the attribute titles.
* The maximum amount of attributes is 20.
* Each archive is treated as a single dataset (\*.shp and \*.dbf files are mandatory).

<figure><img src="/files/tz6bubjN8VUafqfS230c" alt=""><figcaption><p>Upload Yield Data as Shapefile</p></figcaption></figure>

1. You can either drag and drop single or multiple Yield Datasets to the panel or click the **Browse** button and select a dataset from your computer.
2. Click the **Upload** button. Then GeoPard will verify that the file meets the requirements and save the data.

Wait for the confirmation dialog to see that the dataset was uploaded successfully:

<figure><img src="https://lh6.googleusercontent.com/8Dk9Poz900uimyYo-W8XuuMHeauRkDNo6-Klo8ejFsZt0Gd_ktEhXOxALfxZPV7kl86DfkQSJo1X3UvP6Vw9ib1RtSd--3dQ1ZC4gLLoV733quEp7YYbaJMXYrbLC7vZPa3ItCgA" alt=""><figcaption></figcaption></figure>

The Yield Dataset will be available in the tree in the Yield Data section for further interactions including ZonesMaps creation.

<figure><img src="https://lh5.googleusercontent.com/mDqfJIosDlhKNvM6JkSd7f6I4zZ_tDAYg2WoubwjEZU5SKh32FDwePQBJc-7zxIGR4wNtzME0Yzmqopdo6YM7zb6jP6Ex6annMrfjWr6ougD0V8hz2f3mn0e9QWFn1HoJKjoiiDM" alt=""><figcaption><p>Uploaded Yield Dataset</p></figcaption></figure>

## Yield — Metadata & Units Reference

{% hint style="info" %}
Each shapefile archive **can optionally include** a \<filename>-Metadata.json file. The `DataAttributes` array tells GeoPard how to label and unit-convert each column. Unit strings use compound notation: t1ha-1 = t·ha⁻¹, km1hr-1 = km·h⁻¹.
{% endhint %}

### Harvesting file Metadata JSON example

```json
{
  "Version": "1.0",
  "FarmName": "My Farm",
  "FieldName": "North Field",
  "Operation": "Harvest",
  "CropSeason": 2024,
  "CropToken": "CORN",
  "CropName": "Corn",
  "FieldOperationStartDate": "2024-10-15T07:00:00.000Z",
  "FileCreatedTimeStamp": "2024-10-16T12:00:00.000Z",
  "DataAttributes": [
    { "Name": "VRYIELDMAS", "Unit": "t1ha-1",   "Description": "Dry Mass Yield" },
    { "Name": "VRYIELDVOL", "Unit": "[m3]1ha-1", "Description": "Yield as Volume" },
    { "Name": "Moisture",   "Unit": "prcnt",    "Description": "Grain Moisture" },
    { "Name": "DRYMATTER",  "Unit": "prcnt",    "Description": "Dry Matter" },
    { "Name": "SWATHWIDTH", "Unit": "m",        "Description": "Swath Width" },
    { "Name": "DISTANCE",   "Unit": "m",        "Description": "Distance From Previous Point" },
    { "Name": "VEHICLSPEE", "Unit": "km1hr-1",  "Description": "Vehicle Speed" },
    { "Name": "Elevation",  "Unit": "m",        "Description": "Elevation" },
    { "Name": "Heading",    "Unit": "arcdeg",   "Description": "Machine Heading" }
  ]
}

```

### Standard yield attributes

| Attribute name | Description                              | Uni        |
| -------------- | ---------------------------------------- | ---------- |
| VRYIELDMAS     | Dry mass yield — primary yield value     | t1ha-1     |
| VRYIELDVOL     | Volumetric yield (combine sensor output) | \[m3]1ha-1 |
| Moisture       | Grain moisture at harvest                | prcnt      |
| DRYMATTER      | Dry matter content (100 − moisture)      | prcnt      |
| SWATHWIDTH     | Header / swath width                     | m          |
| DISTANCE       | Distance from previous logged point      | m          |
| VEHICLSPEE     | Machine travel speed                     | km1hr-1    |
| Elevation      | GPS elevation above sea level            | m          |
| Heading        | Machine travel direction                 | arcdeg     |
| FUEL           | Fuel consumption                         | l          |
|                |                                          |            |

### CropToken values examples

* CORN
* SOYBEANS
* WHEAT
* SUNFLOWER\_OIL
* CANOLA
* BARLEY
* OATS
* SORGHUM
* COTTON

### Unit Strings Reference

Relevant unit strings for field operations

<table><thead><tr><th>Unit string</th><th>Meaning</th><th width="251.03369140625">Used for</th></tr></thead><tbody><tr><td>t1ha-1</td><td>metric tonne per hectare</td><td>Dry mass yield, lime rate</td></tr><tr><td>[m3]1ha-1</td><td>cubic metre per hectare</td><td>Volumetric yield (combine)</td></tr><tr><td>l1ha-1</td><td>litre per hectare</td><td>Liquid fertilizer / chemical applied rate</td></tr><tr><td>kg1ha-1</td><td>kilogram per hectare</td><td>Dry/granular fertilizer rate</td></tr><tr><td>ha-1</td><td>per hectare</td><td>Seeding rate (seeds/ha)</td></tr><tr><td>prcnt</td><td>percent (%)</td><td>Moisture, dry matter, humidity</td></tr><tr><td>km1hr-1</td><td>kilometre per hour</td><td>Vehicle speed, wind speed</td></tr><tr><td>m</td><td>metre</td><td>Swath width, distance, elevation</td></tr><tr><td>cm</td><td>centimetre</td><td>Planting depth</td></tr><tr><td>in</td><td>inch</td><td>Planting depth (US imperial)</td></tr><tr><td>l</td><td>litre</td><td>Fuel consumed</td></tr><tr><td>C</td><td>degrees Celsius</td><td>Air temp, soil temp</td></tr><tr><td>arcdeg</td><td>degrees of arc</td><td>Machine heading / bearing</td></tr><tr><td>bu</td><td>bushels</td><td>US yield volume</td></tr><tr><td>bu1ac-1</td><td>bushels per acre (non-standard)</td><td>US yield rate — prefer t1ha-1</td></tr></tbody></table>

#### Compound unit notation rules

Multiplication is written with `1` between tokens: km1hr-1 = km × hr⁻¹

Division uses negative exponent suffix `-1`: t1ha-1 = t × ha⁻¹ = t/ha

Cubic metres use brackets: \[m3]1ha-1 = m³/haSimple per-unit (no numerator): ha-1 = per hectare

See [Chapter Zones Maps](https://help.geopard.tech/zones-maps/#soil) to find more details on how to create a ZonesMap using Yield Data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/product-tour-web-app/import-precision-agriculture-data/yield-data-import.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.