agrifoodpy.land.model
=====================

.. py:module:: agrifoodpy.land.model

.. autoapi-nested-parse::

   Module for land intervention models



Functions
---------

.. autoapisummary::

   agrifoodpy.land.model.land_sequestration


Module Contents
---------------

.. py:function:: land_sequestration(land_da, use_id, fraction, max_seq, years=None, growth_timescale=10, growth='linear', ha_per_pixel=1)

   Additional land use sequestration model.

   Computes the anual additional sequestration from land use change as a
   function of the different land category converted fractional areas.

   Given a Land Data Array map with pixel id values for the different land use
   types, the model computes additional sequestration from land given the new
   value in [t CO2e / yr].

   :param land: Input land array containing the id id value with the dominant land use
                type on that pixel.
   :type land: xarray.Dataarray
   :param use_id: Land category identifiers for the land uses to be converted.
   :type use_id: int, array
   :param fraction: Fraction of each repurposed land category
   :type fraction: float, array
   :param max_seq: Maximum sequestration achieved at the end of the growth period in
                   [t CO2e / yr]
   :type max_seq: float
   :param growth: Type of sequestration growth. Can be one of "linear" and "logistic"
   :type growth: str
   :param growth_timescale: Time in years for land to reach full sequestration potential max_seq
   :type growth_timescale: float
   :param years: Year range length, or array of years for which the sequestration is
                 computed. If not set, stationary maximum values are returned
   :type years: int, array
   :param ha_per_pixel: Area per pixel in hectares.
   :type ha_per_pixel: float

   :returns: **seq** -- DataArray with the per year sequestration
   :rtype: xarray.DataArray