# Calculate Tools

## Overview of Tools

---

<table border="1" id="bkmrk-icon-descriptions-ca" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 13.2264%;"></col><col style="width: 86.7339%;"></col></colgroup><thead><tr><td class="align-center">**Icon**</td><td class="align-center">**Descriptions**</td></tr></thead><tbody><tr><td class="align-center">[![calculate_raster.png](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/scaled-1680-/calculate-raster.png)](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/calculate-raster.png)</td><td>[Calculate raster](#bkmrk-calculate-raster)

Calculate the difference between a raster layer and a reference

</td></tr><tr><td class="align-center">[![calculate-volume.png](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/scaled-1680-/calculate-volume.png)](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/calculate-volume.png)</td><td>[Calculate Volume](#bkmrk-calculate-volume)

Calculate the volume difference between bathymetry layers or against a reference level within defined polygon areas

</td></tr></tbody></table>

## Calculate Raster

---

The Calculate Raster tool allows calculations to be made, either between two overlapping bathymetry layers, or between one bathymetry layer and a fixed value. This has many useful purposes, including allowing users to compare designs with the reality on the seabed.

When a calculation is made, a new layer is created.

All the basic arithmetic operations (add/subtract/divide/multiply/average) are supported.

**Prerequisites**:

- At least one bathymetry layer loaded in your project.
- One or more polygon features defining calculation area(s).

<p class="callout warning">The Calculations menu is only available when you have at least one bathymetry layer in your project.</p>

#### Options

<table border="1" id="bkmrk-option-description-m" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.4456%;"></col><col style="width: 78.5147%;"></col></colgroup><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td>Mode</td><td>**Layers**  
Makes mathematical calculations between two bathymetry layers  
**Fixed value**  
Makes mathematical calculations between a bathymetry layer and a fixed value</td></tr><tr><td>Bathymetry layer A</td><td>The current situation</td></tr><tr><td>Bathymetry layer B</td><td>If mode = “layers" this is the reference layer/design</td></tr><tr><td>Fixed value</td><td>If mode = “fixed value" then this is the second parameter in the calculation operation</td></tr><tr><td>Operation</td><td>**Add** A + &lt;layer B/value&gt;  
**Subtract** A - &lt;layer B/value&gt;  
**Divide** A / &lt;layer B/value&gt;  
**Multiply** A \* &lt;layer B/value&gt;  
**Average** (A + &lt;layer B/value&gt;) / 2</td></tr><tr><td>Layer</td><td>The name of the layer to be created</td></tr><tr><td>Personal layer</td><td>Only possible for those with a contributor role. Select “Yes" visible to you</td></tr><tr><td>Layer group</td><td>Place the new layer in this layer group</td></tr></tbody></table>

#### Instruction Video

<iframe allowfullscreen="allowfullscreen" height="314" src="https://www.youtube.com/embed/VE46wFcHbZA" width="560"></iframe>

## Calculate Volume

---

The Calculate Volume tool calculates the volume difference within defined polygon areas between two bathymetry layers or against a reference level. This is commonly used for monitoring scour protection around monopiles and determining material volume/dredging requirements. The tool outputs into PDF or CSV format.

#### Quick Start

**Prerequisites**:

- At least one bathymetry layer loaded in your project.
- One or more polygon features defining calculation area(s).

<p class="callout warning">The Calculations menu is only available when you have at least one bathymetry layer in your project.</p>

**Modes***:*

<table border="1" id="bkmrk-mode-use-when-exampl" style="border-collapse: collapse; width: 100%; height: 123.212px;"><colgroup><col style="width: 14.5361%;"></col><col style="width: 43.2479%;"></col><col style="width: 42.2955%;"></col></colgroup><thead><tr style="height: 29.8785px;"><td class="align-left" style="height: 29.8785px;">**Mode**</td><td style="height: 29.8785px;">**Use When**</td><td style="height: 29.8785px;">**Example**</td></tr></thead><tbody><tr style="height: 46.6667px;"><td style="height: 46.6667px;">Reference Layer</td><td style="height: 46.6667px;">Comparing two bathymetry surveys to detect changes over time or want to calculate volume to meet requirements after erosion</td><td style="height: 46.6667px;">Comparing pre-installation seabed scan with current conditions around monopile foundation.</td></tr><tr style="height: 46.6667px;"><td style="height: 46.6667px;">Reference Level</td><td style="height: 46.6667px;">Calculating volume relative to a fixed elevation</td><td style="height: 46.6667px;">Calculating rock dump volume from a fixed level to the top of the rock dump.

</td></tr></tbody></table>

<details id="bkmrk-example%3A-reference-l"><summary>Example: reference layer</summary>

Example 1 - Design as the reference layer (vs Seabed)

[![Manual - Volume Calculation - Design.png](https://wiki.app.gridit.nl/uploads/images/gallery/2026-03/scaled-1680-/JVtmanual-volume-calculation-design.png)](https://wiki.app.gridit.nl/uploads/images/gallery/2026-03/JVtmanual-volume-calculation-design.png)

Example 2 - Post Dredge Seabed as reference layer (compared with Pre Dredge Seabed)

[![Manual - Volume Calculation - Pre - Post SurveyDesign.png](https://wiki.app.gridit.nl/uploads/images/gallery/2026-03/scaled-1680-/U1wmanual-volume-calculation-pre-post-surveydesign.png)](https://wiki.app.gridit.nl/uploads/images/gallery/2026-03/U1wmanual-volume-calculation-pre-post-surveydesign.png)

<span style="color: rgb(224, 62, 45);">**Red** </span>= Volume above the reference layer

<span style="color: rgb(45, 194, 107);">**Green**</span> = Volume below the reference layer

</details><details id="bkmrk-example%3A-reference-l-1"><summary>Example: reference level</summary>

[![calculate-volume-reference-level.png](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/scaled-1680-/calculate-volume-reference-level.png)](https://wiki.app.gridit.nl/uploads/images/gallery/2026-02/calculate-volume-reference-level.png)

<span style="color: rgb(224, 62, 45);">**Red** </span>= Volume above the reference level

<span style="color: rgb(45, 194, 107);">**Green**</span> = Volume below the reference level

</details>**Basic workflow**:

1. Select a model layer (the bathymetry layer to analyze)
2. Choose calculation mode (Layers or Reference Level)
3. Select reference layer (Layers mode) or enter reference level in meters (Reference Level mode)
4. Select polygon layer containing your areas of interest
5. Choose one or more polygons to calculate volume for
6. Click Export to CSV or Export to PDF

**Layer terminology**

<table border="1" id="bkmrk-layer-how-to-use-mod" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.5873%;"></col><col style="width: 78.4921%;"></col></colgroup><thead><tr><td>Layer</td><td>How to use</td></tr></thead><tbody><tr><td>Model Layer</td><td>This is the baseline to which you will be comparing a design or DTM (digital terrain model)</td></tr><tr><td>Reference layer</td><td>This is normally the design that you will be comparing to the model layer (baseline)

</td></tr><tr><td>Reference level</td><td>The depth level in relation to vertical reference that you will compare to the model layer (baseline)

</td></tr></tbody></table>

**Understanding Results**

<details id="bkmrk-nearest-neighbour-re"><summary>How volume is calculated (nearest-neighbour resampling)</summary>

<span lang="en-NL">Nearest Neighbor is a method used to align two raster layers of different detail levels (resolutions) without changing the original data.</span>

**<span lang="en-NL">What happens in your project?</span>**

<span lang="en-NL">When comparing a 1x1m survey to a 0.25x0.25m model, or visa versa the volume calculator needs them to speak the same "language." Using Nearest Neighbor, it divides each large 1m cell into 16 smaller 0.25m cells.</span>

<span lang="en-NL" style="mso-no-proof: yes;">![](https://wiki.app.gridit.nl/uploads/images/gallery/2026-04/embedded-image-cyenq4gw.png)</span>

**<span lang="en-NL">Why use this calculation method for volumes?</span>**

- **<span lang="en-NL">Zero Distortion:</span>**<span lang="en-NL"> It doesn't "invent" new heights. It simply duplicates the measured 1x1m height into the smaller squares.</span>
- **<span lang="en-NL">Mathematical Purity:</span>**<span lang="en-NL"> If your 1x1m square says the ground is at 10 meters, all 16 smaller squares will also be exactly 10 meters.</span>
- **<span lang="en-NL">Honest Comparison:</span>**<span lang="en-NL"> Other methods (like "Bilinear") would try to smooth the edges, creating "fake" slopes between points. Nearest Neighbor ensures you are comparing your actual measurements directly against the reference model.</span>

**<span lang="en-NL">The Result</span>**

<span lang="en-NL">It’s like taking a large Lego brick and swapping it for 16 tiny ones of the same height. The total volume remains identical, but the grid now perfectly matches your high-resolution reference model.</span>

<span lang="en-NL">Nearest Neighbor keeps data honest. It changes the 'grid size' without changing the 'measured value,' making it the safest choice for calculating volumes between different survey sources.</span>

<span lang="en-NL"> </span>

</details>The volume calculation produces the following metrics for each selected polygon:

<table border="1" id="bkmrk-metric-description-v" style="border-collapse: collapse; width: 100%; height: 454.547px;"><colgroup><col style="width: 25.6131%;"></col><col style="width: 74.3472%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><th style="height: 29.7969px;">**Metric**</th><th style="height: 29.7969px;">**Description**</th></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Model Name**</td><td style="height: 29.7969px;">The model layer that is being used to calculate volume for</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Reference Name**</td><td style="height: 29.7969px;">The layer that is being used as the reference for the calculation</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Polygon Name**</td><td style="height: 29.7969px;">The area for which volume will be calculated</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Volume Above Reference (m³)**</td><td style="height: 29.7969px;">Volume where the model layer is higher than the reference (material addition or accumulation)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Volume Below Reference (m³)**</td><td style="height: 29.7969px;">Volume where the model layer is lower than the reference (material loss or erosion)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Volume Difference (m³)**</td><td style="height: 46.5938px;">Net volume change (Volume Above minus Volume Below). Positive values indicate net accumulation; negative values indicate net loss</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Area Above Reference (m²)**</td><td style="height: 29.7969px;">Surface area where the model layer is above the reference</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Area Below Reference (m²)**</td><td style="height: 29.7969px;">Surface area where the model layer is below the reference</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Polygon Area (m²)**</td><td style="height: 29.7969px;">The area of the polygon (regardless of whether there is area with or without data)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Area without Data (m²)**</td><td style="height: 46.5938px;"><span style="color: rgb(68, 68, 68);">Area inside the polygon which is not covered by the model layer (required to be able to calculate the average layer thickness)</span></td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Area without Reference (m²)**</td><td style="height: 46.5938px;"><span style="color: rgb(68, 68, 68);">Area inside the polygon which is not covered by the reference layer (required to be able to calculate the average layer thickness)</span></td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Average Layer Thickness (m)**</td><td style="height: 46.5938px;">Average heights of the layer that falls withing the polygon (and coverage with data and reference)

</td></tr></tbody></table>

<p class="callout info">All values are rounded to two decimal places in the output.</p>

**Tips and Best Practices**

- **Plan your polygon areas carefully**: Create polygon layers that match your analysis needs before starting calculations. Well-defined areas of interest will make your workflow more efficient.
- **Use meaningful layer names**: Name your bathymetry layers with dates or survey identifiers to easily track which data you're comparing.
- **Monitor calculation time**: Calculations on large areas or high-resolution data may take some time. The tool displays a loading indicator during processing.
- **Export both formats**: Consider exporting both CSV and PDF formats—CSV for detailed analysis and PDF for documentation and reporting.
- **Interpret Volume Difference carefully**: Positive values indicate net accumulation; negative values indicate net loss. This metric is particularly useful for quick assessment of material changes.
- **Use map highlighting**: Selected polygons are highlighted on the map and automatically centered in the view, making it easy to verify you're analyzing the correct areas.
- **Keep data organized**: Maintain a clear naming convention for your surveys and regularly export calculation results to track changes over time.

#### Detailed guide

The Calculate Volume tool enables you to calculate volumetric differences in bathymetric data (bathymetric layers) within specified areas (polygons). This functionality is essential for monitoring seafloor changes, particularly for offshore wind farm applications where scour protection monitoring around monopile foundations is critical.

The tool calculates volumes in cubic meters and areas in square meters, providing detailed metrics including volume above, volume below, and net volume difference for each selected polygon.

##### Prerequisites

Before using the Calculate Volume tool, ensure you have:

- **Bathymetry layers**: At least one bathymetry layer loaded in your project. To Layers mode, you need at least two compatible bathymetry layers.
- **Polygon layer**: A feature layer containing polygons that define the areas where you want to calculate volumes.
- **Overlapping data**: The model layer and reference (layer or polygons) must have overlapping geographic extents.

<p class="callout warning">The Calculations menu is only available when you have at least one bathymetry layer in your project.</p>

##### Configuration

**1. Mode selection**

<table border="1" id="bkmrk-mode-when-to-use%3F-la" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 23.7302%;"></col><col style="width: 76.3492%;"></col></colgroup><thead><tr><td class="align-center">**Mode**</td><td class="align-center">**When to use?**</td></tr></thead><tbody><tr><td style="vertical-align: middle;">Reference layer</td><td>Use this mode when you want to compare two bathymetric surveys to calculate changes over time or want to calculate volume to meet requirements after erosion. This is ideal for:

- Monitoring scour protection settlement or erosion
- Comparing pre-installation and post-installation seabed conditions
- Tracking sediment accumulation or loss between survey dates
- Assessing the effectiveness of remedial work

</td></tr><tr><td style="vertical-align: middle;">Reference level (m)</td><td>Use this mode when you want to calculate volume relative to a fixed elevation value. This is useful for:

- Estimating material volume in a rock dump or scour protection layer without requiring a pre-rock dump bathymetry layer
- Calculating volume from vertical reference to a specified depth.
- Measuring fill or cut volumes against a design elevation

</td></tr></tbody></table>

**2. Model Layer Selection**

The **model layer** is the primary bathymetry layer you want to analyze. This is typically your most recent survey or the layer representing current conditions.

Select your model layer from the **Model layer** dropdown menu. Only bathymetry layers that are ready for calculations will be available in this list.

<p class="callout info">Important: Once you select a model layer, the tool automatically filters the available reference layers and polygon layers to show only those that are compatible (matching projection and overlapping geographic extent).</p>

**3. Reference Selection**

The reference defines what your model layer will be compared against. The reference selection depends on your chosen mode:

*For Layers Mode:*

Select a **reference layer** from the dropdown. This should be your baseline bathymetry survey, typically an earlier survey that you want to compare against.

<p class="callout info">Only bathymetry layers that have overlapping coverage will appear in this list.</p>

*For Reference Level Mode*:

Enter a reference level value in meters. This value represents the elevation you want to use as your comparison baseline.

- Positive values: Measure upward from the seabed (e.g., +2.0 meters above the seabed surface)
- Negative values: Measure downward from the seabed (e.g., -10.0 meters below the seabed surface)

Example: For a scour protection mound where you want to calculate the volume from the top down to 10 meters below the peak, you would enter -10.0 as your reference level.

**4. Polygon Layer Selection**

Select the feature layer that contains the polygons defining your areas of interest. These polygons specify the area for which the volume calculations will be performed.

Only layers containing polygon or closed line string features that overlap with your model layer will be available in the **Polygon layer** dropdown.

**5. Polygon Selection**

After selecting a polygon layer, choose which specific polygons you want to include in the calculation:

- Click the Polygons dropdown to see all available polygons from the selected layer
- Select one or more polygons (multi-select is supported)
- Use the Select All option to quickly select all available polygons

Selected polygons will be highlighted on the map, and the map view will automatically zoom to show all selected areas.  
do we need to explain what could be the problem if they do not see any polygons (again)? I'm assuming they did not read above.

##### Exporting the results

The Calculate Volume tool offers two export formats:

**CSV Export**

Exports calculation results as a comma-separated values file suitable for:

- Import into spreadsheet applications (Excel, Google Sheets)
- Further data analysis and processing
- Integration with other software tools
- Creating custom reports or visualizations

**PDF Export**

Generates a PDF report with one page per selected polygon, each containing:

- A table with all calculation metrics for that polygon
- A map view centered on the polygon area with bathymetry data

The PDF format is ideal for documentation, presentations, and sharing results with stakeholders who don't need to manipulate the data.

**To export:**

1. Click the main export button to use the currently selected format (default is CSV)
2. Or click the dropdown arrow to choose between CSV and PDF formats
3. The file will be automatically downloaded with a filename based on your model layer name

### Common Use Cases

<details id="bkmrk-scour-protection-mon"><summary>Scour Protection Monitoring</summary>

**Scenario**: You need to monitor the scour protection around monopile foundations and determine if additional material needs to be placed.

**Approach**:

1. Use **Layers mode** to compare your recent survey (model layer) against the as-built survey, previous monitoring survey or design (reference layer).
2. Select polygons around each monopile location.
3. Export results to identify locations with negative volume difference (material loss) that may require remediation.

</details><details id="bkmrk-rock-dump-volume-est"><summary>Rock Dump Volume Estimation</summary>

**Scenario:** You need to estimate the volume of rock material in a scour protection mound using a fixed reference level (-10m).

**Approach:**

1. Use Post survey model layer and a fixed level as reference
2. Enter -10.0 as the reference level (10 meters below the surface)
3. Select the polygon encompassing the rock dump area
4. The Volume Above value will represent the amount of material to dump

</details><details id="bkmrk-change-detection-ana"><summary>Change Detection Analysis</summary>

**Scenario:** You need to assess changes across multiple locations between two survey periods.

**Approach:**

1. Use **Layers mode** with your newer survey as the model layer and older survey as the reference layer
2. Select all polygons of interest using the Select All option
3. Export to CSV for analysis in spreadsheet software
4. Sort by Volume Difference to quickly identify areas with the greatest changes

</details>### Troubleshooting

---

<details id="bkmrk-export-button-is-dis"><summary>Export button is disabled</summary>

The export button will be disabled if:

- No model layer is selected
- No polygon layer or polygons are selected
- In Layers mode: No reference layer is selected
- In Reference Level mode: No reference level value is entered

</details><details id="bkmrk-layer-options-are-li"><summary>Layer options are limited after selecting model layer</summary>

This is expected behavior. The tool automatically filters available layers to show only those that are compatible with your selected model layer (same projection for reference layers, overlapping extent for polygon layers).

</details><details id="bkmrk-error%3A-bathymetry-la"><summary>Error: Bathymetry layer(s) are missing the required data file</summary>

This error occurs when one or more selected bathymetry layers don't have the necessary processed data for calculations. Ensure that your bathymetry layers have been fully processed before attempting volume calculations.

</details><details id="bkmrk-unexpected-or-incorr"><summary>Unexpected or incorrect results</summary>

If results seem incorrect:

- Verify that both layers (in Layers mode) use the same coordinate reference system
- Confirm that your polygons actually overlap the bathymetry data coverage area
- Check the vertical reference system of your bathymetry layers
- In Reference Level mode, verify you've entered the reference level with the correct sign (positive or negative)

</details>