environmentaltools.spatiotemporal.multicriteria.run_topsis_mcda

environmentaltools.spatiotemporal.multicriteria.run_topsis_mcda(combined_df: DataFrame, weighting_name: str, output_dir: Path)

Execute TOPSIS multi-criteria decision analysis on the combined suitability scores.

This function performs the complete TOPSIS analysis workflow: 1. Prepares the decision matrix from suitability scores 2. Applies multiple weighting schemes 3. Calculates TOPSIS scores and rankings 4. Creates comprehensive visualizations 5. Saves results in multiple formats

Parameters:

• combined_df (pd.DataFrame) – Combined suitability scores dataset

• output_dir (Path) – Output directory for results

Returns:

Final TOPSIS results with scores and rankings, or None if error

Return type:

pd.DataFrame

Raises:

Exception – For critical errors in TOPSIS analysis