landcover_assignment.distribution

This module is designed to manage and process land distribution scenarios for the Irish national context, particularly focusing on adjustments in land use areas based on various scenario inputs. It integrates with land cover data management, scenario-specific data fetching, and national area analysis to provide a comprehensive tool for land distribution analysis.

Features:

  • Land Distribution Analysis: Manages the calculation and distribution of land areas across different land use types based on scenario-driven changes.

  • Grassland Distribution Management: Specifically handles the redistribution of grassland areas, taking into account changes in mineral and organic components.

Dependencies:

  • landcover_assignment.landcover_data_manager.DistributionManager

  • landcover_assignment.national_landcover.NatioanlLandCover

  • resource_manager.scenario_data_fetcher.ScenarioDataFetcher

  • pandas for data manipulation and analysis.

Classes:

class landcover_assignment.distribution.LandDistribution(scenario_data)[source]

Handles the distribution of land areas for various land use types under different scenarios, adjusting for changes in areas and soil composition.

land_distribution(land_use, new_area)[source]
Calculates and updates the distribution of land based on land use type and the area change. It supports special
handling for grassland, wetland, and forest types, among others, adjusting shares of mineral, organic, and other
soil types accordingly.
grassland_distribution(mineral_area, organic_area, grassland_area)
Specifically handles the distribution and adjustment of grassland areas, considering changes in mineral and organic
components, and recalculates the total remaining grassland area along with its composition.

Module Contents

Classes

LandDistribution

Handles the distribution of land areas for various land use types under different scenarios,

class landcover_assignment.distribution.LandDistribution(scenario_data)[source]

Handles the distribution of land areas for various land use types under different scenarios, adjusting for changes in areas and soil composition.

This class provides methods to calculate and update land distribution based on changes in land use types, including special considerations for grassland, wetland, and forest. It utilizes data from land cover data managers, catchment analysis, and scenario-specific data fetchers to accurately model land distribution adjustments under various scenarios.

Parameters:

scenario_data (pd.DataFrame) – A DataFrame containing scenario-specific data inputs. This data is used to fetch catchment names and drive the scenario-based calculations for land distribution adjustments.

data_manager_class

An instance of DistributionManager for managing land distribution data.

Type:

DistributionManager

national_class

An instance of NatioanlLandCover for accessing and analyzing Irish national context land cover data.

Type:

NationalLandCover

sc_fetcher_class

An instance of ScenarioDataFetcher initialized with scenario data for fetching scenario-specific information.

Type:

ScenarioDataFetcher

land_distribution(land_use, new_area)[source]

Calculates and updates the distribution of land based on land use type and the area change. It supports special handling for grassland, wetland, and forest types, among others, adjusting shares of mineral, organic, and other soil types accordingly.

grassland_distribution(mineral_area, organic_area, grassland_area)

Specifically handles the distribution and adjustment of grassland areas, considering changes in mineral and organic components, and recalculates the total remaining grassland area along with its composition.

land_distribution(year, land_use, new_area)[source]

Calculates and updates the land distribution based on land use type and area change.

Parameters:
  • year (int) – The reference year for national land use data

  • land_use (str) – The type of land use to calculate distribution for.

  • new_area (float) – The area change to be applied to the land use type.

Returns:

A dictionary containing updated land distribution details.

Return type:

dict

grassland_distriubtion(year, mineral_area, organic_area, grassland_area)[source]

Manages the distribution of grassland areas, taking into account changes in mineral and organic areas.

Parameters:
  • year (int) – The reference year for national land use data

  • mineral_area (float) – The area of grassland to be converted to mineral soil.

  • organic_area (float) – The area of grassland to be converted to rewetted organic soil.

  • grassland_area (pandas.DataFrame) – The total initial grassland area before distribution.

Returns:

A dictionary containing updated grassland distribution details.

Return type:

dict