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

# Rezultati laboratorija za tla (CSV/Excel) - pametni uvoz

GeoPard Agriculture je prva platforma, ki resnično »reši« kaos formatov rezultatov laboratorija za tla - z avtomatiziranim pametnim uvozom.

## Pregled

Datoteke laboratorijskih analiz tal pogosto uporabljajo različne predloge, jezike, imena stolpcev in merske enote. Smart Import prepozna tabelo z rezultati in jo za analizo poveže z vzorčnimi točkami.

<figure><img src="https://29491374-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>Samodejna obdelava rezultatov laboratorijskih analiz tal v CSV-/Excelovih datotekah</p></figcaption></figure>

## Podprte datoteke

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), vključno z delovnimi zvezki z več listi
* Pri posameznem nalaganju je mogoče naložiti več datotek, velikost posamezne datoteke pa je lahko največ 40 MB

### Excelove predloge za rezultate laboratorijskih analiz tal

{% file src="/files/c8b4f4ababa5d631324be22425d45f1716d82722" %}

{% file src="/files/e23004f4630e46d82f650e9c9a934f4cfcb6907b" %}

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

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

Te delovne zvezke uporabite za pripravo **zbirnih rezultatov po upravljavskih conah**. Vsaka vrstica predstavlja rezultat ene cone. Vrednosti so zgolj ponazoritvene in ne predstavljajo priporočil za gnojenje.

* `geopard-lab-results-zones-plan-id-en.xlsx`: angleške glave; cone povezuje prek **ID načrta** in **ID cone**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: ukrajinske glave; cone povezuje prek **ID плану** in **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: angleške glave; cone povezuje prek **Ime polja** in **ID cone**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: ukrajinske glave; cone povezuje prek **Назва поля** in **ID зони**.

#### Izberite ustrezno predlogo

Uporabite predlogo za **ID načrta** ko vzorci izvirajo iz načrta vzorčenja GeoPard. To je najzanesljivejša možnost. Vnesite identifikator načrta ter identifikator cone ali točke natančno tako, kot sta navedena v načrtu.

Predlogo za **Ime polja** uporabite, kadar identifikator načrta GeoPard ni na voljo. Ime polja vnesite natančno tako, kot je prikazano v GeoPard. Identifikatorji con se morajo ujemati s conami tega polja.

V isti datoteki ne mešajte povezovanja po ID-ju načrta in imenu polja. Rezultate za cone in rezultate za točke hranite v ločenih datotekah. Ko laboratorij prejme vzorce, ne spreminjajte vrednosti v stolpcih, ki se uporabljajo za povezovanje.

#### Izpolnite delovni zvezek

1. Prvo vrstico ohranite kot glavo stolpcev. Celic z glavo ne združujte.
2. Za vsako vzorčeno cono ali točko dodajte svojo vrstico. Več con ali točk ne združujte v eno vrstico.
3. V ločenih stolpcih ohranite **ID načrta** + **ID cone**, **ID načrta** + **ID točke**, oziroma **Ime polja** + **ID cone**.
4. Vsak rezultat vnesite v svoj stolpec za hranilo ali lastnost tal. Enote, ki jih je navedel laboratorij, ohranite v glavi stolpca.
5. Vrednosti za pH, organsko snov, dušik, fosfor, kalij, žveplo, cink in bor vnesite v ustrezne stolpce. Če laboratorij rezultata ni navedel, pustite polje prazno.
6. Tabele z rezultati v delovnem zvezku ne spreminjajte. Vanjo ne dodajajte vsot, komentarjev ali dodatnih tabel.

Predloge vsebujejo samo vzorčne vrednosti. Pred uporabo uvoženih rezultatov pri agronomski odločitvi preverite laboratorijsko metodo, globino vzorčenja, merjene parametre in enote.

#### Rezultati vzorčenja točk

{% file src="/files/b3b34da4fdca17818a0c06a900e4314aea6854bb" %}

{% file src="/files/fdd8ae3f8ff96526d749caa97c1993724ca81bfe" %}

Te delovne zvezke uporabite za **vzorce talnih jeder iz načrta vzorčenja GeoPard**. Vsaka vrstica predstavlja eno vzorčeno točko.

* `geopard-lab-results-points-plan-id-en.xlsx`: angleške glave; točke povezuje prek polj **ID načrta** in **ID točke**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: ukrajinske glave; točke povezuje prek polj **ID плану** in **ID точки**.

ID točke vnesite natanko tako, kot je natisnjen na oznaki točke. Primer:

```csv
ID načrta,ID točke,pH KCl,Organska snov (%),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
```

Za točke, vzorčene brez načrta GeoPard, namesto tega navedite stolpca `Lon` in `Lat` GeoPard vsako točko poveže s poljem, znotraj katerega leži. Pred nalaganjem preverite preslikavo koordinat.

{% hint style="warning" %}
Uvoženi rezultati analize tal so meritve, ne priporočila za uporabo. V predogledu uvoza preverite vsak atribut in mersko enoto.
{% endhint %}

## Kaj se izvede samodejno

* Poišče tabelo z rezultati in njene glave, tudi pri nestandardnih postavitvah.
* Prepozna pogosta imena laboratorijskih parametrov v različnih jezikih.
* Prepozna makro- in mikrohranila ter pripravi predogled preslikave, ki ga lahko urejate.
* Zazna in poenoti merske enote, nato pa označi neobičajne ali mešane enote.
* Vzorce poveže z načrtom vzorčenja GeoPard ali s prostorskimi podatki v datoteki.

## Priprava datoteke CSV ali Excel

Za vsak rezultat laboratorijske analize uporabite svojo vrstico. Dodajte vrstico z glavami. Vsako meritev vnesite v svoj stolpec.

V Excelovem delovnem zvezku naj bodo tabele z rezultati jasno ločene. GeoPard podpira delovne zvezke z več listi. Pred nalaganjem preverite zaznane glave, preslikave in merske enote.

### Primer: sestavljeni vzorci po conah

To strukturo uporabite, če laboratorij prejme načrt, ustvarjen v GeoPard. `Sampling Plan ID` in `Zone ID` omogočata najbolj zanesljivo povezavo.

```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
```

Zgornje vrednosti in parametri so primeri. Uporabite merske enote, ki jih navaja laboratorij. V predogledu potrdite mersko enoto za vsak preslikani parameter.

### Primer: vzorci talnih jeder iz načrta GeoPard

To strukturo uporabite, če laboratorij prejme vzorce talnih jeder iz načrta, ustvarjenega v GeoPard. `Sampling Plan ID` in `Point ID` omogočata najbolj zanesljivo povezavo. Point ID je ime točke, natisnjeno na oznaki vzorca.

```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
```

Za vsako vzorčeno točko uporabite svojo vrstico. Več točk ne združujte v eni vrstici.

### Primer: vzorci talnih jeder s koordinatami

Za vzorce talnih jeder, odvzete brez načrta GeoPard, uporabite zemljepisno dolžino in širino. GeoPard poveže posamezno točko, če leži znotraj meje polja.

```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
```

Ne zamenjajte `Lon` in `Lat`.

### Primer: rezultati, povezani s poljem

Uporabite `Field Name` ali `Field ID` če datoteka laboratorijskih rezultatov vsebuje oznako polja. Preverite, ali se ime polja ujema z imenom polja v GeoPardu.

```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` je UUID polja v GeoPardu. Najdete ga v URL-ju strani polja.

## Kako GeoPard poveže laboratorijske rezultate s polji

GeoPard lahko laboratorijske rezultate poveže z ustreznim poljem na štiri načine:

1. **ID načrta vzorčenja z ID-jem območja ali ID-jem točke**\
   Uporabite ločena stolpca za enolični ID načrta vzorčenja in ID območja (sestavljeni vzorci) ali ID točke (vzorci z jedrnim vzorčenjem). To je najzanesljivejša možnost za vsak načrt vzorčenja, ustvarjen v GeoPardu.
2. **Koordinate točke (`Lon` / `Lat`)**\
   Za zemljepisno dolžino in širino uporabite dva stolpca. GeoPard točko prostorsko poveže s poljem, če leži znotraj njegove meje. To metodo uporabite za vzorce z jedrnim vzorčenjem, odvzete brez načrta GeoPard.
3. **Geometrija WKT**\
   Uporabite en stolpec z geometrijo WKT. GeoPard geometrijo prostorsko poveže z mejo polja.
4. **Ime polja / ID polja**\
   Uporabite besedilni stolpec z imenom polja ali njegovim ID-jem. GeoPard primerja ime polja z imenom polja `Name`.\
   `Field ID` je UUID polja v GeoPardu. Najdete ga v URL-ju strani polja.

## Uvozite datoteko

1. Odprite **Uvozi podatke** → **Naloži datoteke** → **Laboratorijski rezultati**.
2. Naložite datoteko CSV, XLS ali XLSX.
3. Če je na voljo, izberite polje ali načrt vzorčenja. Dodajte ustrezne datume.
4. Preverite zaznano tabelo, preslikavo atributov in merske enote.
5. Popravite vse preslikave ali merske enote, ki se ne ujemajo z laboratorijskim poročilom.
6. Izberite **Naloži**.

{% hint style="warning" %}
Uvoženih vrednosti ne obravnavajte kot priporočil za uporabo. Pred agronomskimi odločitvami preverite preslikane atribute, merske enote, globino vzorčenja in laboratorijsko metodo.
{% endhint %}

## Povežite z načrti vzorčenja

Za sestavljene vzorce po območjih ustvarite načrt v [Vzorčenje tal - avtomatizirano načrtovanje](https://docs.geopard.tech/geopard-tutorials/svn/predstavitev-izdelka-spletna-aplikacija/soil-sampling-automated-planning.md) in v laboratorijski datoteki ohranite identifikatorja načrta in območja. Pri vzorcih z jedrnim vzorčenjem ohranite identifikatorja načrta in točke ali vključite koordinate.

Tako ohranite povezavo med laboratorijskim rezultatom, lokacijo na polju in prihodnjo analizo trendov v tleh.


---

# 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/svn/predstavitev-izdelka-spletna-aplikacija/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.
