> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/tuo-tarkkuusmaatalouden-data/satotietojen-tuonti.md).

# Satotietojen tuonti

Tuo sadonkorjuun satotiedot GeoPardiin puhdistusta, kalibrointia, analytiikkaa ja vyöhykejakoa varten.

Ladataksesi toteutuneen ajon data‑tiedostoja valitse **Tuo data** valikko ja **Lataa tiedostot** kohta. Valitse sitten **Satomuuttujadata**.

Huomaa, että on joitakin rajoituksia:

* Vain WGS84 (EPSG:4326) -muotoiset shapefile-tiedostot, joissa on piste- tai monikulmiopohjaista dataa, ovat tuettuja.
* Ominaisuuksien on oltava numeerista tyyppiä (kokonaisluku tai reaaliluku, ei merkkijono).
* 100 MB on tiedoston enimmäiskoko.
* Yritä välttää erikoismerkkien, kuten `%+@` käyttöä ominaisuuksien otsikoissa.
* Ominaisuuksien enimmäismäärä on 20.
* Jokainen arkisto käsitellään yhtenä aineistona (\*.shp- ja \*.dbf-tiedostot ovat pakollisia).

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FX8g6FckVhv6XIDCvpskF%2Fimage.png?alt=media&amp;token=857201a5-da76-41fa-9f05-43eb744cb438" alt=""><figcaption><p>Lataa satotiedot shapefile-muodossa</p></figcaption></figure>

1. Voit joko vetää ja pudottaa yhden tai useamman satotietoaineiston paneeliin tai napsauttaa **Selaa** painiketta ja valita aineiston tietokoneeltasi.
2. Napsauta **Lataa** painiketta. Sitten GeoPard varmistaa, että tiedosto täyttää vaatimukset, ja tallentaa datan.

Odota vahvistusikkunaa nähdäksesi, että aineisto ladattiin onnistuneesti:

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

Satotietoaineisto on käytettävissä puussa Satotieto-osiossa jatkotoimia varten, mukaan lukien ZoneMapien luonti.

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

## Sato — metatieto- ja yksikköviite

{% hint style="info" %}
Jokainen shapefile-arkisto **voi sisältää valinnaisesti** \<tiedostonimi>-Metadata.json-tiedoston.  `DataAttributes` taulukko kertoo GeoPardille, miten kukin sarake nimetään ja miten sen yksikkö muunnetaan. Yksikkömerkkijonot käyttävät yhdistelmämerkintää: t1ha-1 = t·ha⁻¹, km1hr-1 = km·h⁻¹.
{% endhint %}

### Satotiedoston Metadata JSON -esimerkki

```json
{
  "Version": "1.0",
  "FarmName": "Oma tila",
  "FieldName": "Pohjoispelto",
  "Operation": "Korjuu",
  "CropSeason": 2024,
  "CropToken": "CORN",
  "CropName": "Maissi",
  "FieldOperationStartDate": "2024-10-15T07:00:00.000Z",
  "FileCreatedTimeStamp": "2024-10-16T12:00:00.000Z",
  "DataAttributes": [
    { "Name": "VRYIELDMAS", "Unit": "t1ha-1",   "Description": "Kuivamassan sato" },
    { "Name": "VRYIELDVOL", "Unit": "[m3]1ha-1", "Description": "Tilavuussato" },
    { "Name": "Moisture",   "Unit": "prcnt",    "Description": "Viljan kosteus" },
    { "Name": "DRYMATTER",  "Unit": "prcnt",    "Description": "Kuiva-aine" },
    { "Name": "SWATHWIDTH", "Unit": "m",        "Description": "Työleveys" },
    { "Name": "DISTANCE",   "Unit": "m",        "Description": "Etäisyys edellisestä pisteestä" },
    { "Name": "VEHICLSPEE", "Unit": "km1hr-1",  "Description": "Ajonopeus" },
    { "Name": "Elevation",  "Unit": "m",        "Description": "Korkeus" },
    { "Name": "Heading",    "Unit": "arcdeg",   "Description": "Koneen suunta" }
  ]
}

```

### Vakiomalliset satomittariominaisuudet

| Ominaisuuden nimi | Kuvaus                                       | Yksikkö    |
| ----------------- | -------------------------------------------- | ---------- |
| VRYIELDMAS        | Kuivamassan sato — ensisijainen satotieto    | t1ha-1     |
| VRYIELDVOL        | Tilavuussato (yhdistä anturin tuotos)        | \[m3]1ha-1 |
| Moisture          | Viljan kosteus korjuun aikana                | prcnt      |
| DRYMATTER         | Kuiva-ainepitoisuus (100 − kosteus)          | prcnt      |
| SWATHWIDTH        | Pöydän / työleveyden leveys                  | m          |
| DISTANCE          | Etäisyys edellisestä tallennetusta pisteestä | m          |
| VEHICLSPEE        | Koneen ajonopeus                             | km1hr-1    |
| Elevation         | GPS-korkeus merenpinnan yläpuolella          | m          |
| Heading           | Koneen ajosuunta                             | arcdeg     |
| FUEL              | Polttoaineen kulutus                         | l          |
|                   |                                              |            |

### CropToken-arvojen esimerkkejä

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

### Yksikkömerkkijonojen viite

Oleelliset yksikkömerkkijonot peltotöille

<table><thead><tr><th>Yksikkömerkkijono</th><th>Merkitys</th><th width="251.03369140625">Käytetään</th></tr></thead><tbody><tr><td>t1ha-1</td><td>metristä tonnia hehtaarilta</td><td>Kuivamassan sato, kalkitusmäärä</td></tr><tr><td>[m3]1ha-1</td><td>kuutiometriä hehtaarilta</td><td>Tilavuussato (puimuri)</td></tr><tr><td>l1ha-1</td><td>litraa hehtaarilta</td><td>Neste­lannoitteen / kemikaalin levitysmäärä</td></tr><tr><td>kg1ha-1</td><td>kilogrammaa hehtaarilta</td><td>Kuiva-/rakeisen lannoitteen levitysmäärä</td></tr><tr><td>ha-1</td><td>hehtaaria kohti</td><td>Kylvömäärä (siementä/ha)</td></tr><tr><td>prcnt</td><td>prosenttia (%)</td><td>Kosteus, kuiva-aine, ilmankosteus</td></tr><tr><td>km1hr-1</td><td>kilometriä tunnissa</td><td>Koneen nopeus, tuulen nopeus</td></tr><tr><td>m</td><td>metri</td><td>Työleveys, etäisyys, korkeus</td></tr><tr><td>cm</td><td>senttimetri</td><td>Istutussyvyys</td></tr><tr><td>in</td><td>tuuma</td><td>Istutussyvyys (US-imperiaalinen)</td></tr><tr><td>l</td><td>litra</td><td>Kulunut polttoaine</td></tr><tr><td>C</td><td>celsiusastetta</td><td>Ilman lämpötila, maaperän lämpötila</td></tr><tr><td>arcdeg</td><td>kulma-astetta</td><td>Koneen suunta / kulkusuunta</td></tr><tr><td>bu</td><td>bushelia</td><td>Yhdysvaltain satotilavuus</td></tr><tr><td>bu1ac-1</td><td>bushelia eekkeriä kohti (ei-vakiomuotoinen)</td><td>Yhdysvaltain satomäärä — suosi t1ha-1</td></tr></tbody></table>

#### Yhdistelmäyksiköiden merkintäsäännöt

Kertolasku kirjoitetaan merkillä `1` tokensien välillä: km1hr-1 = km × hr⁻¹

Jakolasku käyttää negatiivisen eksponentin päätettä `-1`: t1ha-1 = t × ha⁻¹ = t/ha

Kuutiometrit merkitään hakasulkeilla: \[m3]1ha-1 = m³/haYksinkertainen yksikkö ilman osoittajaa: ha-1 = hehtaaria kohti

Katso [Luku Zone Maps](https://help.geopard.tech/zones-maps/#soil) löytääksesi lisätietoja siitä, miten ZoneMap luodaan satotiedon avulla.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/tuo-tarkkuusmaatalouden-data/satotietojen-tuonti.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.