> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eyesotope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fields

> Drawing, managing, and analyzing your farm fields

# Field Management

Fields are the foundation of your farm data. Each field represents a physical plot of land with a defined boundary, area, and assigned crop.

## Adding a Field

<Steps>
  <Step title="Open the Fields Page">
    Navigate to **Fields** in the left sidebar.
  </Step>

  <Step title="Start Drawing">
    Click the **+ Add Field** button. The map will enter drawing mode with polygon tools enabled.
  </Step>

  <Step title="Draw the Boundary">
    Click on the map to place corner points of your field boundary. Click each vertex to outline the shape. Close the polygon by clicking the first point again or using the finish button.
  </Step>

  <Step title="Review & Edit the Polygon">
    After drawing, you'll see a **Confirm Geometry** step. You can:

    * Drag vertices to adjust the shape
    * Review the calculated area in hectares
    * Discard and draw again if needed
  </Step>

  <Step title="Save Field Details">
    Once the geometry is confirmed, fill in:

    * **Field Name** — A descriptive name
    * **Crop Type** — Select the crop grown on this field

    Click **Save** to create the field.
  </Step>
</Steps>

## Field Area Calculation

The field area is **automatically calculated** from the polygon geometry when you save. The area is displayed in hectares (ha) and is recalculated whenever you edit the field boundary.

<Info>
  Area calculations use geodesic measurements to account for the Earth's curvature, ensuring accuracy even for large fields.
</Info>

## Editing a Field

1. Click on a field in the list or on the map
2. Edit the name, crop, or boundary
3. If you modify the polygon, the area is recalculated automatically
4. Save your changes

## Deleting a Field

1. Select the field you want to remove
2. Click **Delete**
3. Confirm the deletion

<Warning>
  Deleting a field is permanent. The field boundary, associated satellite data, and any linked monitoring polygons (from satellite providers like Agromonitoring) are also cleaned up automatically.
</Warning>

## Archiving a Field

Instead of permanently deleting, you can **archive** a field:

1. Open the field detail page
2. Click the **Archive** button
3. The field is soft-archived and removed from active views

Archived fields can be found and restored from the **Archive Center** (accessible from the sidebar). Archiving preserves all data including satellite imagery, operations, and analytics.

<Tip>
  Use archiving instead of deletion when you want to remove a field from active use but may need to reference its data later.
</Tip>

## Uploading Field Data

You can also upload field boundaries from files:

1. Go to **Uploads** in the sidebar (under the Fields module)
2. Upload shapefiles (`.shp`, `.geojson`, `.kml`) containing field boundaries
3. Review and import the uploaded fields

## Crops

Manage your crop types from the **Crops** page:

* Add custom crop varieties
* Assign crops to fields
* Track which crops are grown across your farm

## Field Detail Page

Click on any field to open its detail page. The detail page uses a **vertical sidebar** with organized sections giving you access to a comprehensive set of analysis tools:

### Core Tabs

| Tab         | Description                                                  |
| ----------- | ------------------------------------------------------------ |
| Overview    | Field information, area, crop, and key statistics            |
| Operations  | Agricultural activities linked to this field                 |
| AI Analysis | AI-powered health assessment with structured recommendations |
| Satellite   | Satellite imagery overlays on the map                        |
| Indices     | 6 vegetation indices (NDVI, EVI, EVI2, DSWI, NRI, NDWI)      |

### Environmental Data

| Tab           | Data Source    | Description                                        |
| ------------- | -------------- | -------------------------------------------------- |
| Temperature   | Agromonitoring | Accumulated GDD tracking                           |
| Precipitation | Agromonitoring | Cumulative and daily rainfall                      |
| Weather       | Agromonitoring | Real-time conditions, UV, wind                     |
| Climate Intel | NASA POWER     | 28 climate channels + derived agricultural metrics |

### Soil (collapsible group)

| Tab          | Data Source     | Description                                           |
| ------------ | --------------- | ----------------------------------------------------- |
| Temperatures | Agromonitoring  | Surface and 10 cm depth soil temperature and moisture |
| Layers       | ISRIC SoilGrids | 14 soil properties across 6 depth layers (0–200 cm)   |

### Crop Intelligence (collapsible group)

| Tab             | Data Source | Description                                 |
| --------------- | ----------- | ------------------------------------------- |
| Water Balance   | NASA POWER  | FAO Penman-Monteith water demand vs. supply |
| Yield Potential | NASA POWER  | 3 FAO yield estimation methods (A/B/C)      |

### Visualization (collapsible group)

| Tab          | Data Source       | Description                               |
| ------------ | ----------------- | ----------------------------------------- |
| Voxel Cube   | Satellite imagery | 3D temporal stack with playback animation |
| Pixel Matrix | Satellite imagery | Per-pixel 2D/3D index visualization       |

<Info>
  For detailed documentation on satellite, weather, soil, and visualization tabs, see the [Satellite & Remote Sensing](/guides/satellite) guide. For crop intelligence tabs, see [Crop Intelligence](/guides/crop-intelligence).
</Info>

## Permissions

| Action         | Admin | Manager | Operator | Viewer |
| -------------- | :---: | :-----: | :------: | :----: |
| View fields    |   ✅   |    ✅    |     ✅    |    ✅   |
| Create fields  |   ✅   |    ✅    |     ✅    |    ❌   |
| Edit fields    |   ✅   |    ✅    |     ✅    |    ❌   |
| Archive fields |   ✅   |    ✅    |     ❌    |    ❌   |
| Delete fields  |   ✅   |    ✅    |     ❌    |    ❌   |