Generates a tidy dataset representing useful thermal output, auxiliary energy, and emission outcomes for solar water heating systems.

simulate_ams_ij_dataset(
  n_sites = 10,
  n_periods = 12,
  start_year = 2023,
  start_month = 1,
  mean_useful_heat_mwh = 360,
  sd_useful_heat_mwh = 55,
  baseline_emission_factor = 0.22,
  auxiliary_emission_factor = 0.18,
  mean_auxiliary_share = 0.15,
  sd_auxiliary_share = 0.05
)

Arguments

n_sites

Number of solar water heating sites to simulate.

n_periods

Number of monitoring periods per site.

start_year

Calendar year for the first monitoring period.

start_month

Calendar month for the first monitoring period.

mean_useful_heat_mwh

Mean annual useful thermal output per site in MWhth.

sd_useful_heat_mwh

Standard deviation of annual useful thermal output in MWhth.

baseline_emission_factor

Baseline emission factor in tCO2e/MWhth.

auxiliary_emission_factor

Auxiliary system emission factor in tCO2e/MWhth.

mean_auxiliary_share

Mean share of auxiliary energy relative to useful solar heat.

sd_auxiliary_share

Standard deviation of the auxiliary share.

Value

A tibble containing monitoring metadata, useful thermal output, auxiliary energy, and emission outcomes.

Examples

simulate_ams_ij_dataset(n_sites = 3)
#> # A tibble: 36 × 15
#>    site_id monitoring_period  year month   day monitoring_date monitoring_label
#>    <chr>               <int> <dbl> <dbl> <int> <date>          <chr>           
#>  1 site_1                  1  2023     1     4 2023-01-04      2023-01         
#>  2 site_1                  2  2023     2    16 2023-02-16      2023-02         
#>  3 site_1                  3  2023     3     2 2023-03-02      2023-03         
#>  4 site_1                  4  2023     4     3 2023-04-03      2023-04         
#>  5 site_1                  5  2023     5    25 2023-05-25      2023-05         
#>  6 site_1                  6  2023     6    22 2023-06-22      2023-06         
#>  7 site_1                  7  2023     7    11 2023-07-11      2023-07         
#>  8 site_1                  8  2023     8     7 2023-08-07      2023-08         
#>  9 site_1                  9  2023     9    21 2023-09-21      2023-09         
#> 10 site_1                 10  2023    10     6 2023-10-06      2023-10         
#> # ℹ 26 more rows
#> # ℹ 8 more variables: useful_heat_mwh <dbl>, auxiliary_energy_mwh <dbl>,
#> #   baseline_emission_factor <dbl>, auxiliary_emission_factor <dbl>,
#> #   baseline_emissions_tco2e <dbl>, project_emissions_tco2e <dbl>,
#> #   emission_reductions_tco2e <dbl>, solar_fraction <dbl>