Tidy up the use of interpolation (#642)

* Update settings and documentation

* Temporarily suppress test

* Revert change to settings

* Switch some interp to sel

* Interp to sel in factories module

* More fixes

* Revert some changes

* Select technology data for a single year

* Update settings and documentation

* Revert change to settings

* Raise error for unsupported operations with technology and asset

* Add doctest to broadcast_techs, make more generic

* Fix errors from merge

* Fix mistakes from merge

* Remove filter_input function

* Add back necessary interpolation, update trade model

* Reverting change to `examples`

* Update interpolation_mode documentation

* Add interpolate_capacity function

* interpolation_mode parameter for technodata

* Add warnign message about Active mode

* Improve docstrings

* Fix incorrect settings name

* Update trade reesults

* Update trade results

Author: tsmbland

docs/inputs/commodities_io.rst

@@ -79,5 +79,3 @@ The input data has to be provided for the base year. Additional years within the
 framework of the overall simulation can be defined. In this case, MUSE would interpolate
 the values between the provided periods and assume a constant value afterwards. The additional
 years at which input data for input/output commodities, are defined needs to equal for :ref:`inputs-technodata` and :ref:`inputs-technodata-ts`.
-
-Interpolation is activated only if the feature *interpolation_mode = 'Active'* is defined in the TOML file.

docs/inputs/technodata.rst

@@ -166,5 +166,3 @@ The input data has to be provided for the base year. Additional years within the
 framework of the overall simulation can be defined. In this case, MUSE would interpolate
 the values between the provided periods and assume a constant value afterwards. The additional
 years at which input data for techno-data are defined need to equal for :ref:`inputs-iocomms` and :ref:`inputs-technodata-ts`.
-
-Interpolation is activated only if the feature *interpolation_mode = 'Active'* is defined in the TOML file.

docs/inputs/technodata_timeslices.rst

@@ -44,5 +44,3 @@ The input data has to be provided for the base year. Additional years within the
 framework of the overall simulation can be defined. In this case, MUSE would interpolate
 the values between the provided periods and assume a constant value afterwards. The additional
 years at which input data for techno-data timeslices, need to equal those for :ref:`inputs-iocomms` and :ref:`inputs-technodata`.
-
-Interpolation is activated only if the feature *interpolation_mode = 'Active'* is defined in the TOML file.

docs/inputs/toml.rst

@@ -26,7 +26,7 @@ a whole.
    time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
    regions = ["USA"]
    interest_rate = 0.1
-   interpolation_mode = 'Active'
+   interpolation_mode = 'linear'
    log_level = 'info'
 
    equilibrium_variable = 'demand'
@@ -293,8 +293,9 @@ A sector accepts these attributes:
    Defaults to "last".
 
 *interpolation*
-   Interpolation method user when filling in missing values. Available interpolation
-   methods depend on the underlying `scipy method's kind attribute`_.
+   Interpolation method used to fill missing years in the *technodata* (defaults to "linear").
+   Available interpolation methods depend on the underlying `scipy method's kind attribute`_.
+   Years outside the data range will always be back/forward filled with the closest available data.
 
    .. _scipy method's kind attribute: https://docs.scipy.org/doc/scipy/reference/generated/scipy.interpolate.interp1d.html
 

docs/tutorial-code/add-agent/1-single-objective/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind"]
 # Convergence parameters

docs/tutorial-code/add-agent/2-multiple-objective/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind"]
 # Convergence parameters

docs/tutorial-code/add-correlation-demand/1-correlation/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind"]
 # Convergence parameters

docs/tutorial-code/add-new-technology/1-introduction/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind", "solar"]
 # Convergence parameters

docs/tutorial-code/add-new-technology/2-scenario/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind", "solar"]
 # Convergence parameters

docs/tutorial-code/add-region/1-new-region/settings.toml

@@ -3,7 +3,7 @@
 time_framework = [2020, 2025, 2030, 2035, 2040, 2045, 2050]
 regions = ["R1", "R2"]
 interest_rate = 0.1
-interpolation_mode = 'Active'
+interpolation_mode = 'linear'
 log_level = 'info'
 excluded_commodities = ["wind"]
 # Convergence parameters