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

# Land-use Conflict Screening · Kigali

> Find where Kigali's development presses on ecological space, steep slopes and riverbanks, grade the conflicts, and turn them into remediation priorities.

Land-use Conflict Screening checks whether a hilly city's built-up land collides with the constraints it should respect: **ecological space, steep slopes, riverbanks and protected areas**. It reports each conflict family on its own and then a de-duplicated union, so one patch cannot be counted twice, and it ends with remediation priorities instead of a single "risk score".

<img src="https://mintcdn.com/mapx/L6yONbs9UgIwEtf3/images/scenarios/landuse-conflict-screening.jpg?fit=max&auto=format&n=L6yONbs9UgIwEtf3&q=85&s=a232c097e07535df37640154004c5a11" alt="The Kigali run as delivered: ecological space with the three conflict families and the worst-patch ranking" width="1200" height="675" data-path="images/scenarios/landuse-conflict-screening.jpg" />

## What the scenario ships

Eight layers cover the Kigali window. Only land cover is visible by default; the other layers are analysis inputs and cross-checks.

| Layer | Data | Role in the study |
| - | - | - |
| Watercourses | OSM waterways, 416 lines | 30 m setback corridor |
| Administrative boundaries | 8 ADM3 units | Study area, attribution and labels |
| Protected area constraints | Overture, 14 features in Rwanda; 1 inside the city | Background and cross-check for ecological space |
| Building footprints | Overture, 644,665 polygons | Context layer; not used as the development surface (see below) |
| Land cover | ESA WorldCover 2021, 10 m, 11 classes (visible) | Ecological classes and the built-up surface |
| Terrain | SRTM 30 m, clipped to the city | Slope classes |
| Surface water | JRC Global Surface Water, 0–99% frequency | Water presence cross-check |
| Population | GHSL, 100 m | Exposed population per assessment cell |

*All layers come from the [built-in catalog](/en/concepts/builtin-datasets) with source and attribution attached, and they are not limited to Kigali: the catalog provides the same datasets for other cities at the same specification — switch the study area, add the same entries, and this chapter's method chain transfers in minutes.*

## How the study works

| Stage | Question | What MapX runs | Output |
| - | - | - | - |
| 1. Identify the conflicts | Where does built-up land meet each constraint? | Raster calculator, Raster to polygons, Overlay clip, Euclidean distance (100 m / 30 m), Buffer, Slope, Reclassify | Ecological-space mask, steep-slope classes and the four conflict families |
| 2. Grade and prioritise | Which conflicts matter most, and where do they cluster? | Append features, Zonal summary on a 500 m grid, Top N patch ranking, Label anchors | Conflict area per cell, exposed population, worst-patch ranking |
| 3. Remediate | What should be done per type and severity? | Select features, Zonal statistics, Charts, Report | Remediation table, charts and a compliance report |

In short, the study first builds spatial masks for each constraint — ecological space, steep slopes and riverbank corridors — and overlays them with the development surface to produce four conflict layers; it then summarises conflict area and affected population on a grid and ranks the worst patches; finally it issues remediation and avoidance guidance by conflict type and grade, delivering conflict layers, a ranking and a screening report.

## Run it

The screenshots below come from this scenario's reference workspace. Each step names the platform surface it uses, so you can follow the same path in your own project.

<Tip>
  **Suggested question:** *"Screen land-use conflicts for Kigali: find development encroaching on ecological space, steep slopes or riverbanks, grade conflicts by severity, locate hotspots and recommend fixes; deliver layers, charts and a report."*
</Tip>

### 1. Open the scenario

Open **Scenarios** in the top menu, select this card and choose **Open scenario**. The whole bundle imports at once: every layer keeps its default style, legend, source and attribution, and the camera flies to the study area. Use the **Layers** panel to switch layers on and off before you type anything.

<img src="https://mintcdn.com/mapx/3JpAc87IWpdp9K6O/images/scenarios/steps/landuse-conflict-screening/open.jpg?fit=max&auto=format&n=3JpAc87IWpdp9K6O&q=85&s=b6d4eb1f82cd2675e82df9ecb12b66cf" alt="The Kigali scenario opened in a fresh project: the layer bundle imported, the Layers panel expanded, and the chat panel confirming the import with the suggested question" width="1440" height="715" data-path="images/scenarios/steps/landuse-conflict-screening/open.jpg" />

### 2. Ask the suggested question and review the plan

Send the **suggested question** in the box above — or edit it first. [Plan mode](/en/concepts/plan-mode) records the ecological-space definition, the development surface and the rule that conflict families are reported per type plus a de-duplicated union.

<img src="https://mintcdn.com/mapx/3JpAc87IWpdp9K6O/images/scenarios/steps/landuse-conflict-screening/plan.jpg?fit=max&auto=format&n=3JpAc87IWpdp9K6O&q=85&s=b217b320ef3b001543e7050fd2d33e0a" alt="The Kigali plan document with the Plans panel open on the left; plan sections and recorded decisions readable" width="1440" height="715" data-path="images/scenarios/steps/landuse-conflict-screening/plan.jpg" />

### 3. Approve the plan and run the analysis

The chain uses raster algebra and polygon conversion to build the ecological-space layer, Euclidean distance for the 100 m encroachment band and the 30 m waterway setback, buffering, slope reclassification, the steep-slope mask, and the 500 m grid where conflict area and exposed population are summed. The **Analysis** panel keeps every run's operator, inputs, parameters and result layer, and the workflow graph in the centre visualises the whole chain.

<img src="https://mintcdn.com/mapx/3JpAc87IWpdp9K6O/images/scenarios/steps/landuse-conflict-screening/analysis.jpg?fit=max&auto=format&n=3JpAc87IWpdp9K6O&q=85&s=6fac9b9aea776f7fb7e46c8990737065" alt="The analysis view for Kigali: the Analysis panel lists every operator run on the left, with the workflow graph in the centre" width="1440" height="715" data-path="images/scenarios/steps/landuse-conflict-screening/analysis.jpg" />

### 4. Style the result on the map

Each conflict family owns one hue so the four translucent layers stay readable together; the worst-patch ranking is styled as a dark-red fill with rank labels from an anchor layer, and legend titles carry the definitions.

<img src="https://mintcdn.com/mapx/3JpAc87IWpdp9K6O/images/scenarios/steps/landuse-conflict-screening/style.jpg?fit=max&auto=format&n=3JpAc87IWpdp9K6O&q=85&s=ae0919c1011815f20aa13004302dac98" alt="The style editor on a deliverable layer: classed-colour breaks and label settings, with the layer editing panel highlighted in red" width="1440" height="900" data-path="images/scenarios/steps/landuse-conflict-screening/style.jpg" />

### 5. Turn the result into charts and a report

The run reports conflict area per family and the exposed population, with the union stated separately. The **[charts](/en/concepts/charts)** and the **[report](/en/concepts/reports)** quote those definitions rather than a single risk score.

<img src="https://mintcdn.com/mapx/3JpAc87IWpdp9K6O/images/scenarios/steps/landuse-conflict-screening/chart.jpg?fit=max&auto=format&n=3JpAc87IWpdp9K6O&q=85&s=f287850466c606332415c56cac42ab06" alt="A chart from this scenario in the chart editor, with the editing area highlighted in red" width="1440" height="900" data-path="images/scenarios/steps/landuse-conflict-screening/chart.jpg" />

<img src="https://mintcdn.com/mapx/L6yONbs9UgIwEtf3/images/scenarios/steps/landuse-conflict-screening/report.jpg?fit=max&auto=format&n=L6yONbs9UgIwEtf3&q=85&s=1cd54d805a0ecc3624e6ba43346a0953" alt="The scenario report opened in the report canvas, with an executive summary, figures and embedded maps" width="1440" height="900" data-path="images/scenarios/steps/landuse-conflict-screening/report.jpg" />

## Example output

<Note>The screenshots above come from one example run with the default settings on the shipped data. They show the shape of the deliverables, not what your run will return.</Note>

A finished run hands back a named, reusable set of deliverables instead of a single map:

* **Layers** — the ecological-space layer, the four conflict families (ecological encroachment, steep slope, waterway setback, protected area) and the worst-patch ranking, all with their definitions in the legend.
* **Tables** — the per-type conflict areas plus the de-duplicated union, and the exposed population per assessment cell.
* **Charts** — the conflict-area and exposure summaries, editable and ready for the report.
* **Report** — the compliance document with the definitions, the areas and the remediation guidance.

The layer names follow the run language, but the deliverable set is stable enough to plan a handover around.

## Related

* [Scenarios](/en/concepts/scenarios) — the full catalog and how scenarios work
* [Development Suitability Baseline](/en/concepts/scenarios/development-suitability-baseline) — the same constraints used to screen buildable land
* [Carrying Capacity Assessment](/en/concepts/scenarios/carrying-capacity-assessment) — constraint logic for water and climate
* [Analysis](/en/concepts/analysis) — raster algebra, distance and overlay tools
* [Built-in datasets](/en/concepts/builtin-datasets) — where every layer comes from


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.