animated_map – BRDR - Aligning borders

# animated_map

    viz.animated_map(
        aligner_results,
        dict_thematic,
        dict_reference,
        xlim,
        ylim,
        interval,
        filename,
    )

Create a synchronized animation of map changes and area statistics.

This function generates a side-by-side animation: the left panel shows the geometric alignment on a map (zoomed to thematic data), while the right panel plots the percentage of area change as a function of the ‘relevant distance’ parameter.

## Parameters

Name | Type | Description | Default
--- | --- | --- | ---
aligner_results | dict | A nested dictionary structured as `{theme_id: {rel_dist: ProcessResult}}`. | required
dict_thematic | dict | Dictionary containing the original thematic geometries. | required
dict_reference | dict | Dictionary containing the reference geometries used for alignment. | required
xlim | float | The maximum value for the X-axis (relevant distance) in the trend plot. | required
ylim | float | The maximum value for the Y-axis (% area change) in the trend plot. | required
interval | int | Delay between frames in milliseconds. | required
filename | str | The output path/name for the saved animation (e.g., ‘analysis.gif’). | required

## Returns

Name | Type | Description
--- | --- | ---
| None | The function saves the animation to the specified `filename` and displays the plot.

## Notes

To prevent “stray lines” in the trend plot during animation loops, the data tracking lists are cleared whenever the animation restarts at the first distance frame.