View source: R/transforms_to_dta.R
transform_to_dta | R Documentation |
The function transforms the .tidy_iea_df
into a data frame that describes the same Energy Conversion Chain from a Domestic Technology Assumption perspective,
for those assumptions that comply with the required criterion for formulating the Domestic Technology Assumption. See details.
transform_to_dta(
.tidy_iea_df,
products_to_look_for = IEATools::products,
requirement_matrices_list = c(IEATools::psut_cols$Y, IEATools::psut_cols$U_eiou,
IEATools::psut_cols$U_feed),
select_dta_observations = TRUE,
country = IEATools::iea_cols$country,
method = IEATools::iea_cols$method,
energy_type = IEATools::iea_cols$energy_type,
last_stage = IEATools::iea_cols$last_stage,
year = IEATools::iea_cols$year,
flow = IEATools::iea_cols$flow,
ledger_side = IEATools::iea_cols$ledger_side,
e_dot = IEATools::iea_cols$e_dot,
imports = IEATools::interface_industries$imports,
matnames = IEATools::mat_meta_cols$matnames,
balancing_matrix = "B"
)
.tidy_iea_df |
The |
products_to_look_for |
The list of products that need to be looked for as consumed products.
Default is |
requirement_matrices_list |
The list of matrices where the |
select_dta_observations |
A boolean that states whether observations that do not comply with the Domestic Technology Assumption criterion should be filtered out or not. Default is TRUE. |
country, method, energy_type, last_stage, year, flow, ledger_side, e_dot |
See |
imports |
The name of imports flows in the |
matnames |
The column name for matrices names.
Default is |
balancing_matrix |
The name of the Balancing matrix.
Default is |
Strictly speaking, the Domestic Technology Assumption can only be formulated when at least one unit of each consumed product (be it in the U_feed, U_eiou, or Y matrices) is produced domestically - i.e., appears at least once in the V matrix in a non-importing flow. The default run of the function is set up to return only those observations that fulfil such a requirement.
However, one may want to be more flexible about the formulation of the Domestic Technology Assumption. Indeed, nothing prevents from formulating the Domestic Technology Assumption in cases that do not fulfil the aforementioned conditions, but in that case, any demand for a given product that is not produced anywhere (be it direct or indirect demand) in the domestic economy will not be translated into any upstream demand, which is an important caveat.
The products_to_look_for
and requirement_matrices_list
offer additional flexibility, so that only products passed as argument to the products_to_look_for
argument
and matrices passed as arguments to the requirement_matrices_list
will act as constraining elements. Indeed, the new condition for formulation of the Domestic Technology
Assumption becomes that all products passed as products_to_look_for
argument and used one of the requirement_matrices_list
, must be produced at least once in the domestic
conversion chain (i.e. must appear in V in a non-importing flow).
In addition, the select_dta_observations
boolean enable to turn on and off the selection of observations that comply with the Domestic Technology Assumption requirements.
When the argument is FALSE (note that default is TRUE!), then no filter is applied to observations, and the Domestic Technology Assumption is applied to all observations.
A column specifying matrix name for each flows needs to be added before, most likely using the IEATools::add_psut_matnames()
function.
A .tidy_iea_df
that describes the Energy Conversion Chain from a Domestic Technology Assumption perspective.
tidy_AB_data %>%
IEATools::add_psut_matnames() %>%
transform_to_dta() %>%
print()
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.