RETROCHANGE - UC3 / RETROFRAG EXAMPLE DATA
============================================================

This directory contains four finished forest classification maps for
forest fragmentation and core-forest continuity analysis. They are
categorical maps, not raw satellite photographs.

FILES
------------------------------------------------------------
Ruske_1975.tif       Ruské, Slovakia; 1975 KH-9-derived map, 5 x 5 km
Ruske_2017.tif       Ruské, Slovakia; map labeled 2017, derived from an orthophoto mosaic, 5 x 5 km
Brzegi_1975.tif      Brzegi, Poland; 1975 KH-9-derived map, 5 x 5 km
Havesova3x3_1975.tif Havešová, Slovakia; 1975 KH-9-derived map, 3 x 3 km

All maps: GeoTIFF, one UInt8 band, EPSG:5514, 0.5 m pixels, LZW,
NoData = 255. Ruské and Brzegi have 10,000 x 10,000 pixels;
Havešová has 6,000 x 6,000 pixels. See METADATA.txt for bounds.

LICENSE.txt: Dataset license and source acknowledgments.
METADATA.txt: File properties, class definitions, provenance, limitations.
README.txt: This overview and usage instructions.

CLASS VALUES - CHECK BEFORE ANALYSIS
------------------------------------------------------------
1 = forest; 0 = non-forest; 255 = declared NoData.
Brzegi and both Ruské maps also label class 2 as shadow_excluded.
The Havešová map includes deep shadow in class 0 instead.

The notebooks default to forest value 1 and no-data value 255. They
honor file masks but do not explicitly exclude class 2, so valid code-2
pixels are treated as non-forest by default. To exclude these shadow
pixels, set NODATA_VALUE = 2, or set No-data value to 2 in the interface;
the file-declared NoData 255 remains excluded. Alternatively, recode
2 to 255 in a separate copy. Record the choice with your results.

QUICK START
------------------------------------------------------------
From the uc3_retrofrag application root:
- Open ../forest_fragmentation_app.ipynb relative to this directory
  for the interface, or ../forest_fragmentation.ipynb for parameters.
- In the analysis notebook, paths are relative to the application root.
  The default MASK_A is data/Ruske_1975.tif; MODE = "single".
- For MODE = "two_dates", use data/Ruske_2017.tif as MASK_B.
- For MODE = "two_areas", use Brzegi or Havešová as MASK_B and update
  LABEL_B and RUN_NAME to describe the selected comparison.
- Set shadow handling as described above, then run the analysis.

Follow ../docs/retrofrag_guide.md for settings and interpretation.
The environment file is ../env/environment-uc-fragmentation.yml.

REPORTING AND LIMITATIONS
------------------------------------------------------------
The Ruské pair shares a raster grid. Two-date results use only common
valid coverage; a one-map run may therefore have a different denominator.
The full rectangular footprints are 2,500 ha for Ruské/Brzegi and 900 ha
for Havešová. They are not forest-area measurements.

Report the input maps, years, valid area, exclusion rule, working grain,
minimum opening and patch sizes, connectivity, and edge depths. The
0.5 m grid does not establish positional or classification accuracy.
RETROFRAG measures the supplied classifications; it does not classify
the source images or independently validate their forest boundaries.

SOURCE, LICENSE, AND CITATION
------------------------------------------------------------
Historical imagery: KH-9 HEXAGON, USGS EROS.
Modern imagery: Ortofotomozaika 2017-2019 © GKÚ Bratislava, NLC.
The map filename retains 2017; the source mosaic period is 2017-2019.
Exact source scenes, acquisition dates for the subsets, and the modern
source license notice are not supplied. See METADATA.txt and LICENSE.txt.

The derived dataset is supplied under CC BY 4.0 to the extent of the
rights held by the Technical University in Zvolen. Keep the three
text documents with the maps when redistributing them.

Technical University in Zvolen (2026).
RETROCHANGE UC3 RETROFRAG Forest Fragmentation Example Maps.
RETROCHANGE project. https://gis.tuzvo.sk/retrochange

Workflow contact: Ladislav Šumichrast, xsumichrastl@tuzvo.sk
