> 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/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Maanäytteiden laboratoriotulokset (CSV/Excel) – älykäs tuonti

GeoPard Agriculture on ensimmäinen alusta, joka todella "ratkaisee" maaperälaboratorion tulosmuotojen sekavuuden – automaattisella älytuonnilla.

## Yleiskatsaus

Maaperälaboratorioiden tiedostoissa käytetään usein erilaisia malleja, kieliä, sarakeotsikoita ja yksiköitä. Smart Import tunnistaa tulostaulukon ja yhdistää sen näytteenottopisteisiin analyysia varten.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fq4l9jRvhxTwmgtYiLmLe%2Fsoil_lab_results_import.jpeg?alt=media&amp;token=836b5fde-4943-473d-b13a-321e5b9c1fd6" alt="Automated parsing of csv/excel soil lab results"><figcaption><p>Maaperälaboratorion CSV- ja Excel-tulosten automaattinen jäsentäminen</p></figcaption></figure>

## Tuetut tiedostot

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), myös usean taulukon työkirjat
* Useita tiedostoja latauskertaa kohden, enintään 40 Mt tiedostoa kohden

### Maaperälaboratorion tulosten Excel-mallit

{% file src="/files/0f526304f2ffb8b9fea7cadf0065bb65aa236de8" %}

{% file src="/files/9a63b684f42cb6839cc4f1e922e559aa97d928cf" %}

{% file src="/files/6672fee6cef997efa1b65007927593c50dd3d9f0" %}

{% file src="/files/6ee48376e13120dd61b697f34eac07efdb18f904" %}

Käytä näitä työkirjoja valmistellaksesi **hallintavyöhykkeittäin koostetut tulokset**. Kukin rivi vastaa yhden vyöhykkeen tulosta. Arvot ovat havainnollistavia eivätkä ole lannoitussuosituksia.

* `geopard-lab-results-zones-plan-id-en.xlsx`: englanninkieliset otsikot; vyöhykkeet yhdistetään tunnisteen **Suunnitelman tunnus** ja **Vyöhykkeen tunnus**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: ukrainankieliset otsikot; vyöhykkeet yhdistetään tunnisteen **ID плану** ja **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: englanninkieliset otsikot; vyöhykkeet yhdistetään tunnisteiden **Pellon nimi** ja **Vyöhykkeen tunnus**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: ukrainankieliset otsikot; vyöhykkeet yhdistetään tunnisteiden **Назва поля** ja **ID зони**.

#### Valitse oikea malli

Käytä **Suunnitelman tunnus** -mallia, kun näytteet on otettu GeoPardin näytteenottosuunnitelman mukaan. Tämä on luotettavin vaihtoehto. Syötä suunnitelman tunniste sekä vyöhykkeen tai näytepisteen tunniste täsmälleen samassa muodossa kuin suunnitelmassa.

Käytä **Pellon nimi** -mallia, kun GeoPardin suunnitelman tunnistetta ei ole saatavilla. Syötä pellon nimi täsmälleen siinä muodossa kuin se näkyy GeoPardissa. Vyöhyketunnisteiden on vastattava kyseisen pellon vyöhykkeitä.

Älä käytä samassa tiedostossa sekä suunnitelman tunnukseen että pellon nimeen perustuvaa yhdistämistä. Pidä vyöhyketulokset ja näytepistetulokset eri tiedostoissa. Älä muuta avainsarakkeiden arvoja sen jälkeen, kun laboratorio on vastaanottanut näytteet.

#### Täydennä työkirja

1. Säilytä ensimmäinen rivi sarakeotsikkoina. Älä yhdistä otsikkosoluja.
2. Lisää yksi rivi kutakin näytteistettyä vyöhykettä tai näytepistettä kohti. Älä yhdistä useita vyöhykkeitä tai näytepisteitä samalle riville.
3. Säilytä **Suunnitelman tunnus** + **Vyöhykkeen tunnus**, **Suunnitelman tunnus** + **Näytepisteen tunnus**, tai **Pellon nimi** + **Vyöhykkeen tunnus**, omissa sarakkeissaan.
4. Syötä kukin tulos omaan ravinne- tai maaperäominaisuuden sarakkeeseensa. Säilytä ilmoitetut yksiköt sarakeotsikossa.
5. Säilytä pH:n, orgaanisen aineksen, typen, fosforin, kaliumin, rikin, sinkin ja boorin arvot niille tarkoitetuissa sarakkeissa. Jätä tulos tyhjäksi, jos laboratorio ei ole ilmoittanut sitä.
6. Säilytä työkirjan tulostaulukko ennallaan. Älä lisää siihen summia, kommentteja tai muita taulukoita.

Mallit sisältävät vain esimerkkitietoja. Varmista laboratoriomenetelmä, näytteenottosyvyys, analysoitavat ominaisuudet ja yksiköt ennen kuin käytät tuotuja tuloksia viljelypäätösten tekemiseen.

#### Näytepisteiden tulokset

{% file src="/files/5a15b14c9955640edd80ee3fbaa27a75b21bd930" %}

{% file src="/files/13a440ec169ede53782b3c78adee1c54774244d1" %}

Käytä näitä työkirjoja **GeoPardin näytteenottosuunnitelman mukaisesti otettujen maanäytteiden tuloksiin**. Kukin rivi vastaa yhtä näytteistettyä pistettä.

* `geopard-lab-results-points-plan-id-en.xlsx`: englanninkieliset otsikot; pisteet yhdistetään seuraavien kenttien avulla **Suunnitelman tunnus** ja **Pisteen tunnus**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: ukrainankieliset otsikot; pisteet yhdistetään seuraavien kenttien avulla **Suunnitelman tunnus** ja **Pisteen tunnus**.

Anna pisteen tunnus täsmälleen siinä muodossa kuin se on painettu pisteen merkintään. Esimerkki:

```csv
Suunnitelman tunnus,Pisteen tunnus,pH KCl,Orgaaninen aines (%),P2O5 (mg/kg),K2O (mg/kg)
Z7D2F58,1,6.5,3.4,183,148
Z7D2F58,2,6.2,3.4,195,77
Z7D2F58,3,6.4,2.4,149,112
```

Ilmoita ilman GeoPard-suunnitelmaa otettujen pisteiden koordinaatit sarakkeissa `Lon` ja `Lat` . GeoPard yhdistää kunkin pisteen, jos se sijaitsee lohkon rajan sisäpuolella. Tarkista koordinaattien kohdistus ennen lataamista.

{% hint style="warning" %}
Tuodut maanäytetulokset ovat mittaustuloksia, eivät levityssuosituksia. Tarkista jokainen ominaisuus ja mittayksikkö tuonnin esikatselussa.
{% endhint %}

## Mitä tapahtuu automaattisesti

* Etsii tulostaulukon ja sen otsikot myös epätyypillisistä asetteluista.
* Tunnistaa yleisiä laboratorioiden käyttämiä ominaisuuksien nimiä eri kielillä.
* Tunnistaa makro- ja mikroravinteet ja luo sitten muokattavan määritysten esikatselun.
* Tunnistaa ja yhtenäistää yksiköt sekä merkitsee poikkeavat tai keskenään sekoitetut yksiköt.
* Yhdistää näytteet GeoPard-näytteenottosuunnitelman tai tiedoston paikkatietojen avulla.

## Valmistele CSV- tai Excel-tiedosto

Pidä yksi rivi kutakin laboratoriotulosta kohden. Käytä otsikkoriviä. Sijoita kukin mittaustulos omaan sarakkeeseensa.

Pidä Excel-työkirjan tulostaulukot selkeästi erillään. GeoPard tukee usean taulukon työkirjoja. Tarkista tunnistetut otsikot, määritykset ja yksiköt ennen lataamista.

### Esimerkki: vyöhykkeittäin yhdistetyt näytteet

Käytä tätä rakennetta, kun laboratorio saa GeoPardissa luodun suunnitelman. `Sampling Plan ID` ja `Zone ID` mahdollistavat luotettavimman yhdistämisen.

```csv
Sampling Plan ID,Zone ID,pH,Organic Matter,P,K
Z4B7C21,1,6.4,3.1,18,142
Z4B7C21,2,6.1,2.7,12,118
```

Yllä olevat arvot ja ominaisuudet ovat esimerkkejä. Säilytä laboratorion ilmoittamat yksiköt. Vahvista kunkin määrityksen yksikkö esikatselussa.

### Esimerkki: GeoPard-suunnitelman maanäytekairanäytteet

Käytä tätä rakennetta, kun laboratorio saa maanäytekairanäytteitä GeoPardissa luodun suunnitelman perusteella. `Sampling Plan ID` ja `Point ID` mahdollistavat luotettavimman yhdistämisen. Point ID on näytetarrassa näkyvä pisteen nimi.

```csv
Sampling Plan ID,Point ID,pH,Organic Matter,P,K
Z7D2F58,1,6.5,3.4,24,148
Z7D2F58,2,6.2,3.4,27,77
Z7D2F58,3,6.4,2.4,19,112
```

Yksi rivi kutakin näytteenottopistettä kohden. Älä yhdistä useita pisteitä samalle riville.

### Esimerkki: koordinaatein varustetut maanäytekairanäytteet

Käytä pituus- ja leveysastetta maanäytekairanäytteille, jotka on otettu ilman GeoPard-suunnitelmaa. GeoPard yhdistää kunkin pisteen, jos se sijaitsee lohkon rajojen sisällä.

```csv
Sample ID,Lon,Lat,pH,Organic Matter
CORE-001,10.123456,50.123456,6.4,3.1
CORE-002,10.124010,50.123780,6.2,2.8
```

Älä vaihda `Lon` ja `Lat`.

### Esimerkki: lohkokohtaiset tulokset

Käytä `Field Name` tai `Field ID` kun laboratoriotiedosto yksilöi lohkon. Varmista, että lohkon nimi vastaa GeoPardin lohkon nimeä.

```csv
Field Name,Sample ID,pH,Organic Matter
North Field,LAB-1001,6.3,3.0
North Field,LAB-1002,6.5,3.2
```

`Field ID` on GeoPardin lohkon UUID-tunniste. Löydät sen lohkon sivun URL-osoitteesta.

## Näin GeoPard yhdistää laboratoriotulokset lohkoihin

GeoPard voi yhdistää laboratoriotulokset oikeaan lohkoon neljällä tavalla:

1. **Näytteenottosuunnitelman tunnus sekä vyöhykkeen tai pisteen tunnus**\
   Käytä erillisiä sarakkeita yksilölliselle näytteenottosuunnitelman tunnukselle ja vyöhykkeen tunnukselle (yhdistelmänäytteet) tai pisteen tunnukselle (yksittäiset maanäytteet). Tämä on luotettavin vaihtoehto kaikille GeoPardissa luoduille näytteenottosuunnitelmille.
2. **Pisteen koordinaatit (`Lon` / `Lat`)**\
   Käytä kahta saraketta pituus- ja leveysasteelle. GeoPard yhdistää pisteen sijainnin perusteella, kun se sijaitsee lohkon rajan sisällä. Käytä tätä menetelmää yksittäisille maanäytteille, jotka on otettu ilman GeoPard-suunnitelmaa.
3. **WKT-geometria**\
   Käytä yhtä WKT-geometriaa sisältävää saraketta. GeoPard yhdistää geometrian sijainnin perusteella lohkon rajaan.
4. **Lohkon nimi / lohkon tunnus**\
   Käytä tekstisaraketta, joka sisältää lohkon nimen tai lohkon tunnuksen. GeoPard vertaa lohkon nimeä kenttään `Name`.\
   `Field ID` on GeoPardin lohkon UUID-tunniste. Löydät sen lohkon sivun URL-osoitteesta.

## Tuo tiedosto

1. Avaa **Tuo tietoja** → **Lataa tiedostoja** → **Laboratoriotulokset**.
2. Lataa CSV-, XLS- tai XLSX-tiedosto.
3. Valitse lohko tai näytteenottosuunnitelma, jos sellainen on käytettävissä. Lisää asiaankuuluvat päivämäärät.
4. Tarkista tunnistettu taulukko, attribuuttien määritykset ja yksiköt.
5. Korjaa määritykset tai yksiköt, jotka eivät vastaa laboratorioraporttia.
6. Valitse **Lataa**.

{% hint style="warning" %}
Älä käsittele tuotuja arvoja levityssuosituksina. Tarkista määritetyt attribuutit, yksiköt, näytteenottosyvyys ja laboratoriomenetelmä ennen viljelypäätösten tekemistä.
{% endhint %}

## Yhdistä näytteenottosuunnitelmiin

Luo vyöhykkeittäisiä yhdistelmänäytteitä varten suunnitelma palvelussa [Maaperänäytteet – automaattinen suunnittelu](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/soil-sampling-automated-planning.md) ja säilytä suunnitelman ja vyöhykkeen tunnisteet laboratoriotiedostossa. Säilytä yksittäisiä maanäytteitä varten suunnitelman ja pisteen tunnisteet tai lisää koordinaatit.

Näin säilyy yhteys laboratoriotuloksen, lohkon sijainnin ja tulevan maan kasvukunnon kehityksen analysoinnin välillä.


---

# 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/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.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.
