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.