> 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/fr/visite-guidee-du-produit-application-web/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Résultats de laboratoire de sol (CSV/Excel) - Import intelligent

GeoPard Agriculture est la première plateforme à vraiment « résoudre » le chaos des formats de résultats de laboratoire de sol - grâce à un import intelligent automatisé.

## Vue d’ensemble

Les fichiers de laboratoire d’analyse des sols utilisent souvent des modèles, des langues, des noms de colonnes et des unités différents. Smart Import repère le tableau de résultats et l’associe aux points de prélèvement pour l’analyse.

<figure><img src="https://690567185-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>Analyse automatisée des résultats de laboratoire des sols au format CSV/Excel</p></figcaption></figure>

## Fichiers pris en charge

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), y compris les classeurs à plusieurs feuilles
* Plusieurs fichiers par importation, jusqu’à 40 Mo par fichier

### Modèles Excel pour les résultats de laboratoire des sols

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

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

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

{% file src="/files/57041633e24e32424929d4a97f50166ed6f6a518" %}

Utilisez ces classeurs pour préparer des **résultats composites par zone de gestion**. Chaque ligne correspond au résultat d’une zone. Les valeurs sont données à titre d’exemple et ne constituent pas des recommandations de fertilisation.

* `geopard-lab-results-zones-plan-id-en.xlsx`: en-têtes en anglais ; associe les zones à l’aide de **ID du plan** et de **ID de zone**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: en-têtes en ukrainien ; associe les zones à l’aide de **ID плану** et de **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: en-têtes en anglais ; associe les zones à l’aide de **Nom du champ** et de **ID de zone**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: en-têtes en ukrainien ; associe les zones à l’aide de **Назва поля** et de **ID зони**.

#### Choisir le bon modèle

Utilisez un modèle avec **ID du plan** lorsque les échantillons proviennent d’un plan d’échantillonnage GeoPard. C’est l’option la plus fiable. Saisissez l’identifiant du plan ainsi que l’identifiant de la zone ou du point exactement comme ils figurent dans le plan.

Utilisez un modèle avec **Nom du champ** lorsqu’aucun identifiant de plan GeoPard n’est disponible. Saisissez le nom du champ exactement comme il apparaît dans GeoPard. Les identifiants de zone doivent correspondre aux zones de ce champ.

Ne mélangez pas les méthodes d’association par ID de plan et par nom de champ dans un même fichier. Conservez les résultats des zones et ceux des points dans des fichiers distincts. Ne modifiez pas les valeurs des colonnes clés après la réception des échantillons par le laboratoire.

#### Remplir le classeur

1. Conservez la première ligne comme ligne d’en-têtes de colonnes. Ne fusionnez pas les cellules d’en-tête.
2. Ajoutez une ligne pour chaque zone ou point échantillonné. Ne regroupez pas plusieurs zones ou points sur une même ligne.
3. Conservez **l’ID du plan** + **l’ID de zone**, **l’ID du plan** + **l’ID de point**, ou le **nom du champ** + **l’ID de zone**, dans des colonnes distinctes.
4. Saisissez chaque résultat dans sa propre colonne de nutriment ou de propriété du sol. Conservez les unités indiquées dans l’en-tête de colonne.
5. Placez les valeurs du pH, de la matière organique, de l’azote, du phosphore, du potassium, du soufre, du zinc et du bore dans les colonnes correspondantes. Laissez une cellule vide si le laboratoire n’a pas fourni le résultat correspondant.
6. Conservez le tableau de résultats du classeur tel quel. N’y ajoutez ni totaux, ni commentaires, ni tableaux supplémentaires.

Les modèles ne contiennent que des valeurs d’exemple. Vérifiez la méthode d’analyse du laboratoire, la profondeur d’échantillonnage, les attributs et les unités avant d’utiliser les résultats importés pour prendre une décision agronomique.

#### Résultats d’échantillonnage ponctuel

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

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

Utilisez ces classeurs pour les **échantillons de sol prélevés à la tarière dans le cadre d’un plan d’échantillonnage GeoPard**. Chaque ligne correspond à un point échantillonné.

* `geopard-lab-results-points-plan-id-en.xlsx`: en-têtes en anglais ; fait correspondre les points à l’aide de **ID du plan** et **ID du point**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: en-têtes en ukrainien ; fait correspondre les points à l’aide de **ID du plan** et **ID du point**.

Saisissez l’ID du point exactement comme il figure sur l’étiquette du point. Exemple :

```csv
ID du plan,ID du point,pH KCl,Matière organique (%),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
```

Pour les points prélevés sans plan GeoPard, indiquez plutôt des colonnes `Lon` et `Lat` . GeoPard associe chaque point lorsqu’il se trouve à l’intérieur des limites d’une parcelle. Vérifiez l’association des coordonnées avant l’importation.

{% hint style="warning" %}
Les résultats d’analyse de sol importés sont des mesures, et non des recommandations d’application. Vérifiez chaque attribut et chaque unité dans l’aperçu de l’importation.
{% endhint %}

## Traitements automatiques

* Repère le tableau de résultats et ses en-têtes, y compris dans les mises en page non standard.
* Reconnaît les noms courants des attributs d’analyse dans différentes langues.
* Détecte les macro- et micronutriments, puis crée un aperçu de correspondance modifiable.
* Détecte et normalise les unités, puis signale les unités inhabituelles ou mélangées.
* Associe les échantillons à l’aide d’un plan d’échantillonnage GeoPard ou des données spatiales du fichier.

## Préparer un fichier CSV ou Excel

Conservez une ligne par résultat d’analyse. Utilisez une ligne d’en-tête. Placez chaque mesure dans sa propre colonne.

Dans un classeur Excel, séparez clairement les tableaux de résultats. GeoPard prend en charge les classeurs à plusieurs feuilles. Vérifiez les en-têtes, les correspondances et les unités détectés avant l’importation.

### Exemple : échantillons composites par zone

Utilisez cette structure lorsqu’un laboratoire reçoit un plan créé dans GeoPard. `Sampling Plan ID` et `Zone ID` permettent l’association la plus fiable.

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

Les valeurs et attributs ci-dessus sont des exemples. Conservez les unités indiquées par le laboratoire. Confirmez chaque unité associée dans l’aperçu.

### Exemple : échantillons de carottes issus d’un plan GeoPard

Utilisez cette structure lorsqu’un laboratoire reçoit des échantillons de carottes issus d’un plan créé dans GeoPard. `Sampling Plan ID` et `Point ID` permettent l’association la plus fiable. Le Point ID est le nom du point indiqué sur l’étiquette de l’échantillon.

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

Une ligne par point échantillonné. Ne regroupez pas plusieurs points sur une seule ligne.

### Exemple : échantillons de carottes avec coordonnées

Utilisez la longitude et la latitude pour les échantillons de carottes prélevés sans plan GeoPard. GeoPard associe chaque point lorsqu’il se trouve à l’intérieur des limites d’une parcelle.

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

N’intervertissez pas `Lon` et `Lat`.

### Exemple : résultats associés à un champ

Utilisez `Nom du champ` ou `ID du champ` lorsque le fichier du laboratoire identifie le champ. Vérifiez que le nom du champ correspond à celui utilisé dans GeoPard.

```csv
Nom du champ,ID de l’échantillon,pH,Matière organique
Champ Nord,LAB-1001,6.3,3.0
Champ Nord,LAB-1002,6.5,3.2
```

`ID du champ` correspond à l’UUID du champ dans GeoPard. Vous le trouverez dans l’URL de la page du champ.

## Comment GeoPard associe les résultats de laboratoire aux champs

GeoPard peut associer les résultats de laboratoire au bon champ de quatre façons :

1. **ID du plan d’échantillonnage avec ID de zone ou ID de point**\
   Utilisez des colonnes distinctes pour l’ID unique du plan d’échantillonnage et l’ID de zone (échantillons composites) ou l’ID de point (échantillons de carottes). C’est la méthode la plus fiable pour tout plan d’échantillonnage généré dans GeoPard.
2. **Coordonnées du point (`Lon` / `Lat`)**\
   Utilisez deux colonnes pour la longitude et la latitude. GeoPard associe le point spatialement lorsqu’il se trouve à l’intérieur des limites d’un champ. Utilisez cette méthode pour les échantillons de carottes prélevés sans plan GeoPard.
3. **Géométrie WKT**\
   Utilisez une colonne contenant une géométrie WKT. GeoPard associe spatialement la géométrie aux limites du champ.
4. **Nom du champ / ID du champ**\
   Utilisez une colonne texte contenant le nom ou l’ID du champ. GeoPard compare le nom du champ au champ `Nom`.\
   `ID du champ` correspond à l’UUID du champ dans GeoPard. Vous le trouverez dans l’URL de la page du champ.

## Importer le fichier

1. Ouvrez **Importer des données** → **Importer des fichiers** → **Résultats de laboratoire**.
2. Importez le fichier CSV, XLS ou XLSX.
3. Sélectionnez un champ ou un plan d’échantillonnage, le cas échéant. Ajoutez les dates correspondantes.
4. Vérifiez le tableau détecté, le mappage des attributs et les unités.
5. Corrigez tout mappage ou toute unité qui ne correspond pas au rapport de laboratoire.
6. Sélectionnez **Importer**.

{% hint style="warning" %}
Ne considérez pas les valeurs importées comme des recommandations d’application. Avant toute décision agronomique, vérifiez les attributs associés, les unités, la profondeur d’échantillonnage et la méthode d’analyse du laboratoire.
{% endhint %}

## Associer les résultats aux plans d’échantillonnage

Pour les échantillons composites par zone, créez le plan dans [Échantillonnage de sol - planification automatisée](https://docs.geopard.tech/geopard-tutorials/fr/visite-guidee-du-produit-application-web/soil-sampling-automated-planning.md) et conservez dans le fichier du laboratoire les identifiants du plan et des zones. Pour les échantillons de carottes, conservez les identifiants du plan et des points, ou ajoutez les coordonnées.

Cela préserve le lien entre le résultat de laboratoire, l’emplacement dans le champ et les futures analyses de l’évolution des sols.


---

# 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/fr/visite-guidee-du-produit-application-web/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.
