Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Recent Releases of REopt_API

REopt_API - v3.12.1

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.12.0...v3.12.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 9 days ago

REopt_API - v3.12.0

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.11.0...v3.12.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by adfarth about 2 months ago

REopt_API - v3.11.0: Load year alignment fixes and ASHP max dispatch

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.10.3...v3.11.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 3 months ago

REopt_API - v3.10.3

What's Changed

New Contributors

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.10.2...v3.10.3

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 4 months ago

REopt_API - v3.10.2

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.10.1...v3.10.2

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 6 months ago

REopt_API - v3.10.1 REopt.jl v0.48.1

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.10.0...v3.10.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 6 months ago

REopt_API - v3.10.0

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.9.3...v3.10.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 7 months ago

REopt_API - v3.9.3

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.9.2...v3.9.3

Energy Systems - Energy System Modeling Frameworks - Python
Published by hdunham 9 months ago

REopt_API - v3.9.2

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.9.1...v3.9.2

Energy Systems - Energy System Modeling Frameworks - Python
Published by hdunham 9 months ago

REopt_API - v0.39.2

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.9.1...v0.39.2

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 10 months ago

REopt_API - v3.9.1

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.9.0...v3.9.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker 11 months ago

REopt_API - v3.9.0 Disaggregated heat loads, bug fixes, improved solar datasets

What's Changed

This update now uses REopt.jl v0.46.1. Which includes:

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.8.0...v3.9.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by adfarth 12 months ago

REopt_API - v3.8.0

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.7.0...v3.8.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by hdunham 12 months ago

REopt_API - v3.7.0 HiGHS solver by default, End-of-Life for new v1 and v2 runs

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.6.1...v3.7.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker about 1 year ago

REopt_API - v3.6.1

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.4.1...v3.6.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker about 1 year ago

REopt_API - v3.4.1

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.4.0...v3.4.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by adfarth about 1 year ago

REopt_API - Solver setup changes and various fixes Jan 2024

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.3.0...v3.4.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - REopt.jl Updates Including User API Key Passed to REopt.jl

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.2.3...v3.3.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - Ignore CHP unavailability during multiple outages

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.2.1...v3.2.3

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - Fix CHP-Only Resilience, Negative Intercept, CHP after tax results

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.2.0...v3.2.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - CHP and Monthly Heating Load Fixes

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.1.1...v3.2.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - v3.1.1 Add GHP to /summary endpoint

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.1.0...v3.1.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - v3.1.0 FY23 Defaults Updates and Hybrid+Central GHP

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v3.0.0...v3.1.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - V3 as stable, License/copyright updates, ERP and Wind Outages

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.16.0...v3.0.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - Production K8S server resources for v3 and add /v3 endpoints

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.15.0...v2.16.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - V3 Additions and Bug Fixes Summer 2023

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.11.1...v2.15.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 1 year ago

REopt_API - Bug fixes to /v2, minor updates to /dev

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.11.0...v2.11.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker almost 2 years ago

REopt_API - Add Hybrid GHP

What's Changed

New Contributors

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.10.1...v2.11.0

v2.11.0

Minor Updates

Added
  • Enabled hybrid GHX sizing within the GHP model through the hybrid_ghx_sizing_method variable
    • User is able to select "Automatic" (REopt sizes GHX based on the smaller of the heating or cooling load), "Fractional" (GHX size is a user-defined fraction of the non-hybrid GHX size), or "None" (non-hybrid)
    • Auxiliary heater and cooler are both currently only electric
    • Outputs added to track the thermal production, electrical consumption, and size of the auxiliary unit
Changed
  • Updated default value init_sizing_factor_ft_per_peak_ton from 246.1 to 75 for the /ghpghx endpoint

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker about 2 years ago

REopt_API - hot fix: ERP max_outage_duration bug

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.10.0...v2.10.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by hdunham about 2 years ago

REopt_API - Stochastic/Multi-Outages: add Outages outputs and CHP; CHP defaults fixes

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.9.1...v2.10.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by hdunham about 2 years ago

REopt_API - Add v3 emissions_profile endpoint

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.9.0...v2.9.1

Added
  • In job/ app (v3): emissions_profile endpoint and view function that returns the emissions data for a location

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker about 2 years ago

REopt_API - Energy Resilience Performance tool, IRA defaults updates, CHP defaults, other minor

What's Changed

New Contributors

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.8.0...v2.9.0

From CHANGELOG.md:

v2.9.0

Minor Updates

Added
  • Energy Resilience and Performance Tool:
    • Uses functionality added to the REopt Julia package in v0.27.0 to calculate outage survival reliability metrics for a DER scenario, which can be based on the results of a REopt optimization
    • Django models ERPMeta, ERPGeneratorInputs, ERPPrimeGeneratorInputs, ERPElectricStorageInputs, ERPPVInputs, ERPOutageInputs, ERPOutputs
    • /erp endpoint to which users POST ERP inputs (calls ERPJob())
    • /erp/<run_uuid>/results endpoint that GETs the results of an ERP job (calls erp_results())
    • /erp/help endpoint that GETs the ERP input field info (calls erp_help())
    • /erp/chp_defaults endpoint that GETs ERP CHP/prime generator input defaults based on parameters prime_mover, is_chp, and size_kw (calls erp_chp_prime_gen_defaults())
    • Tests in resilience+stats/tests/test_erp.py
  • In job/ app (v3), added Financial year_one_om_costs_before_tax_bau, lifecycle_om_costs_after_tax_bau
  • Added field production_factor_series to Django models WindOutputs and PVOutputs
  • In REoptjlMessageOutputs added a has_stacktrace field to denote if response has a stacktrace error or not. Default is False.
  • Added access to the multiple outage stochastic/robust modeling capabilities in REopt.jl. Not all inputs and outputs are exposed, but the following are:
    • SiteInputs: min_resil_time_steps
    • ElectricUtilityInputs: outage_start_time_steps, outage_durations, outage_probabilities
    • OutageOutputs: expected_outage_cost, max_outage_cost_per_outage_duration, unserved_load_series, unserved_load_per_outage, microgrid_upgrade_capital_cost, generator_fuel_used_per_outage
  • Added test using multiple outage modeling
  • Add /dev/schedule_stats endpoint
Changed
  • Update REopt.jl to v0.28.0 for job app (/dev -> v3)
  • /job/chp_defaults endpoint updated to take optional electric load metrics for non-heating CHP (Prime Generator in UI)
    • Changed /chp_defaults input of existing_boiler_production_type to hot_water_or_steam
    • CHP.size_class starting at 0 for average of other size_classes
    • CHP.max_size calculated based on heating load or electric load
  • In job/ app (v3), changed Financial breakeven_cost_of_emissions_reduction_per_tonnes_CO2 to breakeven_cost_of_emissions_reduction_per_tonne_CO2
  • In job/ app (v3), changed default ElectricLoad year to 2022 if user provides load data and 2017 if using CRBD
  • Changed scalar_to_vector helper function to scalar_or_monthly_to_8760
  • Changed GeneratorInputs fields fuel_slope_gal_per_kwh and fuel_intercept_gal_per_hr to electric_efficiency_full_load and electric_efficiency_half_load to represent the same fuel burn curve in a different way consistent with CHPInputs
  • Updated the following default values to job/ app (v3):
    • federal_itc_fraction to 0.3 (30%) in models PVInputs, WindInputs, and CHPInputs
    • total_itc_fraction to 0.3 (30%) in models HotWaterStorageInputs, ColdWaterStorageInputs, and ElectricStorageInputs
    • *macrs_bonus_fraction to 0.8 (80%) in models PVInputs, WindInputs, CHPInputs, PV, HotWaterStorageInputs, ColdWaterStorageInputs, and ElectricStorageInputs
    • macrs_option_years to 7 years in models HotWaterStorageInputs and ColdWaterStorageInputs
  • In reo/nested_inputs.py v2 inputs (defaults_dict[2]), updated the following default values in models ColdThermalStorageInputs, HotThermalStorageInputs
    • macrs_option_years to 7 (years)
    • macrs_bonus_pct to 0.8 (80%)
  • In reo/nested_inputs.py v2 inputs (defaults_dict[2]), updated the following default values:
    • ColdTES, HotTES: macrs_option_years to 7 (years)
    • ColdTES, HotTES: *macrs_bonus_pct to 0.8 (80%)
  • Updated the following default values to job/ app (v3):
    • PV, Wind, Storage, CHP, Hot Water Storage, Cold Water Storage, Electric Storage: federal_itc_fraction(PV,Wind,CHP) and total_itc_fraction(Hot Water Storage, Cold Water Storage, Electric Storage) to 0.3 (30%)
    • PV, Wind, Storage, CHP, Hot Water Storage, Cold Water Storage, Electric Storage: *macrs_bonus_fraction to 0.8 (80%)
    • Hot Water Storage and Cold Water Storage: macrs_option_years to 7 years
      Use TransactionTestCase instead of TestCase (this avoids whole test being wrapped in a transaction which leads to a TransactionManagementError when doing a database query in the middle)
  • Updated ubuntu-18.04 to ubuntu-latest in GitHub push/pull tests because 18.04 was deprecated in GitHub Actions
Fixed
  • In reo (v2), calculation of net_capital_costs_plus_om was previously missing addition sign for fuel charges. Corrected this equation.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker about 2 years ago

REopt_API - v2.8.0: IRA tax incentive and GhpGhx.jl updates

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.7.1...v2.8.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by adfarth about 2 years ago

REopt_API - v2.7.1

What's Changed

New Contributors

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.6.0...v2.7.1

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Error passing from REopt.jl and Add Thermal Storages to job app (/dev)

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.5.0...v2.6.0

v2.6.0

Minor Updates

Added

  1. REoptjlMessageOutputs model to capture errors and warnings returned by REoptjl during input processing and post optimization
  2. Missing output fields for ExistingBoilerOutputs model
  3. API test job\test\posts\all_inputs_test.json to include all input models in a single API test
  • added HotThermalStorageInputs model
  • added HotThermalStorageOutputs model
  • added ColdThermalStorageInputs model
  • added ColdThermalStorageOutputs model
  • add HotThermalStorageOutputs
  • add ColdThermalStorageOutputs
  • 0012_coldthermalstorageinputs.... file used to add new models to the db

Changed

  1. Default values for the following fields were changed to align them with REopt API v2 (i.e. stable, and REopt.jl) defaults. As-is, these values are aligned with REopt v1 defaults. Units were unchanged.
  • FinancialInputs.elec_cost_escalation_rate_fraction from 0.023 to 0.019
  • FinancialInputs.offtaker_discount_rate_fraction from 0.083 to 0.0564
  • FinancialInputs.owner_discount_rate_fraction from 0.083 to 0.0564
  • PVInputs.installed_cost_per_kw from 1600 to 1592
  • PVInputs.om_cost_per_kw from 16 to 17
  • WindInputs.om_cost_per_kw from 16 to 35
  • ElectricStorageInputs.installed_cost_per_kw from 840 to 775
  • ElectricStorageInputs.installed_cost_per_kwh from 420 to 388
  • ElectricStorageInputs.replace_cost_per_kw from 410 to 440
  • ElectricStorageInputs.replace_cost_per_kwh from 200 to 220
  1. Modified julia_src\http.jl and julia_src\cbc\http.jl to return status 400 when REopt responds with an error
  2. Updated r["Messages"] in views.py to include REoptjlMessageOutputs errors and warnings

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Add Cooling and Heating Load Outputs to job app (/dev -> /v3)

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.4.0...v2.5.0

v2.5.0

Minor Updates

Added
  • 0011_coolingloadinputs.... file used to add new models to the db
    In job/models.py:
  • added ExistingChillerInputs model
  • added ExistingChillerOutputs model
  • added CoolingLoadInputs model
  • added CoolingLoadOutputs model
  • added HeatingLoadOutputs model
    In job/process_results.py:
  • add ExistingChillerOutputs
  • add CoolingLoadOutputs
  • add HeatingLoadOutputs
    In `job/validators.py:
  • add time series length validation on CoolingLoadInputs->thermal_loads_ton and CoolingLoadInputs->per_time_step_fractions_of_electric_load
    In job/views.py:
  • add new input/output models to properly save the inputs/outputs

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Add CHP, /chp_defaults, and /simulated_load end to /dev for v3

v2.4.0

Minor Updates

Added
  • In job/models.py:
    • add CHPInputs model
    • add CHPOutputs model
  • In job/process_results.py add CHPOutputs
  • In job/validators.py add new input models
  • In job/views.py:
    • add new input/output models to properly save the inputs/outputs
    • add /chp_defaults endpoint which calls the http.jl chp_defaults endpoint
    • add /simulated_load endpoint which calls the http.jl simulated_load endpoint

What's Changed

Full Changelog: https://github.com/NREL/REopt_API/compare/v2.3.1...v2.4.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Fix Lookback

Fix lookback parameter naming and timesteps, see https://github.com/NREL/REopt_API/pull/379.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - /job REopt.jl version update, incl name changes (e.g. pct -> fraction), add Boiler, and SteamTurbine

v2.3.0

Minor Updates

Changed

The following name changes were made in the job/ endpoint and julia_src/http.jl:

  • Change "_pct" to "_rate_fraction" for input and output names containing "discount", "escalation", and "tax_pct" (financial terms)
  • Change "pct" to "fraction" for all other input and output names (e.g., "min_soc", "min_turndown")
  • Change prod_factor_series to production_factor_series
  • Updated the version of REopt.jl in /julia_src to v0.20.0 which includes the addition of:
    • Boiler tech from the REopt_API (known as NewBoiler in API)
    • SteamTurbine tech from the REopt_API

See PR https://github.com/NREL/REopt_API/pull/367.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Deployment updates and dev/job/v3 additions

Kubernetes deployment updates and memory allocation adjustments to mitigate memory overload on servers, as well as:

From CHANGELOG.md:

Minor Updates

Fixed
  • Require ElectricTariff key in inputs when Settings.off_grid_flag is false
  • Create and save ElectricUtilityInputs model if ElectricUtility key not provided in inputs when Settings.off_grid_flag is false, in order to use the default inputs in job/models.py
  • Added message to messages() to alert user if valid ElectricUtility input is provided when Settings.off_grid_flag is true
  • Register
  • Make all urls available from stable/ also available from v2/. Includes registering OutageSimJob() and GHPGHXJob() to the 'v2' API and adding missing paths to urlpatterns in urls.py.
Changed
  • job/models.py:
    • remove Generator fuel_slope_gal_per_kwh and fuel_intercept_gal_per_hr defaults based on size, keep defaults independent of size
    • changed get_input_dict_from_run_uuid to accomodate new models
    • changed ElectricLoadInputs.wholesale_rate to use scalar_to_vector function
  • job/validators.py: Align PV tilt and aziumth defaults with API v2 behavior, based on location and PV type
Added
  • 0005_boilerinputs.... file used to add new models to the db
  • job/ endpoint: Add inputs and validation to model off-grid wind
    In job/models.py:
  • added ExistingBoilerInputs model
  • added ExistingBoilerOutputs model
  • added SpaceHeatingLoadInputs model
  • added scalar_to_vector to convert scalars of vector of 12 elements to 8760 elements
  • GeneratorInputs (must add to CHP and Boiler when implemented in v3)
    • added emissions_factor_lb_<pollutant>_per_gal for CO2, NOx, SO2, and PM25
    • add fuel_renewable_energy_pct
  • ElectricUtilityInputs
    • add emissions_factor_series_lb_<pollutant>_per_kwh for CO2, NOx, SO2, and PM25
  • Settings
    • add include_climate_in_objective and include_health_in_objective
  • SiteInputs
    • add renewable_electricity_min_pct, renewable_electricity_max_pct, and include_exported_renewable_electricity_in_total
    • add CO2_emissions_reduction_min_pct, CO2_emissions_reduction_max_pct, and include_exported_elec_emissions_in_total
  • FinancialInputs
    • add CO2_cost_per_tonne, CO2_cost_escalation_pct
    • add <pollutant>_grid_cost_per_tonne, <pollutant>_onsite_fuelburn_cost_per_tonne, and <pollutant>_cost_escalation_pct for NOx, SO2, and PM25
  • FinancialOutputs
    • add lifecycle_fuel_costs_after_tax
  • SiteOutputs
    • add renewable_electricity_pct, total_renewable_energy_pct
    • add year_one_emissions_tonnes_<pollutant>, year_one_emissions_from_fuelburn_tonnes_<pollutant>, lifecycle_emissions_tonnes_<pollutant>, and lifecycle_emissions_from_fuelburn_tonnes_<pollutant> for CO2, NOx, SO2, and PM25
  • FinancialOutputs
    • add breakeven_cost_of_emissions_reduction_per_tonnes_CO2
      In job/process_results.py:
  • add ExistingBoilerOutputs
    In job/test/test_job_endpoint.py:
  • test that AVERT and EASIUR defaults for emissions inputs not provided by user are passed back from REopt.jl and saved in database
  • add a testcase to validate that API is accepting/returning fields related to new models.
    In 'job/validators.py:
  • add new input models
    In job/views.py:
  • Added SiteInputs to help endpoint
  • Added SiteOutputs to outputs endpoint
  • add new input/output models to properly save the inputs/outputs

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 2 years ago

REopt_API - Point /stable/job to v2 of reo app

The /stable/job endpoint was erroneously pointing to v1 of the reo app still, and it was meant to point to v2 (new default values for some inputs).

Also, many updates to the in-development job endpoint (/dev/job URL) which integrates the REopt Julia Package (REopt.jl).

See PR https://github.com/NREL/REopt_API/pull/342 for more details and links to other PRs that are part of this merge.

See CHANGELOG.md for more details of changes made.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker almost 3 years ago

REopt_API - v2.0.3 Bug fixes for fuel_slope, sub-hourly scenarios, international PV

See CHANGELOG.md v2.0.1, v2.0.2, and v2.0.3 (PRs #323, #326, #327) for more information.

Energy Systems - Energy System Modeling Frameworks - Python
Published by adfarth almost 3 years ago

REopt_API - v2.0 default updates

Energy Systems - Energy System Modeling Frameworks - Python
Published by NLaws about 3 years ago

REopt_API - Add GHP HVAC efficiency improvements

See CHANGELOG.md V1.9.1 additions.

See PR https://github.com/NREL/REopt_Lite_API/pull/278.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 3 years ago

REopt_API - Add emissions reduction and RE goals

Add emissions reduction and RE goals.

See CHANGELOG.md for more information, as well as the description of PR #274 and/or PR #277.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 3 years ago

REopt_API - Add off-grid capabilities

Add off-grid modeling capabilities.

See CHANGELOG.md for more information, as well as the description of PR 256.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 3 years ago

REopt_API - Add SteamTurbine, NewBoiler, and GHP

Add SteamTurbine, NewBoiler, and GHP technologies. GHP is currently beta.

See CHANGELOG.md for more information, as well as the description of PR 257.

Energy Systems - Energy System Modeling Frameworks - Python
Published by Bill-Becker over 3 years ago

REopt_API - various patches: Julia exception handling, finalize backend JuMP model

Energy Systems - Energy System Modeling Frameworks - Python
Published by NLaws almost 4 years ago

REopt_API - master<-develop 21.06.09

Minor Updates

Added
  • summary: Added /summary_by_chunk endpoint to enable a fraction of a user's total runs and summary metrics to be returned; this prevents excessive wait times when the UI was trying to load all runs
  • New <host>/dev/futurecosts endpoint
Patches
  • was returning -1 for bau_sustained_time_steps when no critical load was met in BAU case (now returns zero)
  • fixed issue with modeling last time step of the year in outages
  • NewMaxSize was sometimes less than the TechClassMinSize, creating infeasible problems
  • fix user URLs

Energy Systems - Energy System Modeling Frameworks - Python
Published by NLaws almost 4 years ago

REopt_API - v1.4.5 - 2021-03-12

Minor Updates

Changed

  • reo, *.jl: Changed the units-basis for heating load, thermal production, and fuel consumption to kW/kWh, from mmbtu/mmbtu_per_hr and gal. This does not affect the units of the inputs or outputs.

Removed

  • reo: The following inputs for Site.Boiler: installed_cost_us_dollars_per_mmbtu_per_hr, min_mmbtu_per_hr, and max_mmbtu_per_hr, and for Site.ElectricChiller: installed_cost_us_dollars_per_kw, min_kw, and max_kw.

Patches

  • reo: Catch issue in process_results.py where renewable_electricity_energy_pct is not explicitly set to None
  • reo: Catch case where CHP prime_mover is not set and not all required fields are filled in
  • reo: Catch issues with itc_unit_basis when the ITC is 100%
  • validators.py: Fix bug where length of percent_share != length of doe_reference_name even though no percent_share is provided (in LoadProfileBoilerFuel)

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.4.4 - 2021-02-25

Patches

reo: In validators.py catches case where invalid percent_share entry was used in check special cases function
reo: In loadprofile.py catches where 0 lat/long was resolving to False and leading to None for lat and long
reo: Fix divide by 0 error in results processing
reo: Handle floats as URBD periods
reo: Fix list_of_float only types

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.4.3 - 2021-02-18

Major

None

Minor

None

Patches

  • reo: new output Financial.developer_om_and_replacement_present_cost_after_tax_us_dollars
  • reo: Fix PVWatts being called when user provides PV.prod_factor_series_kw
  • reopt_api: new docker-compose.nginx.yml for standing up the API on a server with remote access (for example if one wants to host the API on a cloud service)
  • reopt_api: update Dockerfile.xpress to use nlaws/pyjul:1.5.3 base image (was using Julia 1.3)
  • reopt_api: update julia_envs/Xpress PyCall from 1.91.4 to 1.92.2

Energy Systems - Energy System Modeling Frameworks - Python
Published by NLaws about 4 years ago

REopt_API - v1.4.2 - 2021-02-03

Major

None

Minor

None

Patches

  • reo: Fix Wind size_class was not being set
  • proforma: Fix could not handle runs prior to v1.4.0 with no CHP database entries
  • resilience_stats: Fix could not handle runs prior to v1.4.0 with no CHP database entries
  • resilience_stats: outage_simulator returns 100% survivability whenCHP size_kw >= critical load kw in LoadProfile

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.4.1 - 2021-02-01

Major Updates

None

Minor Updates

None

Patches

reo: Fixes database query error the occurs when getting production runs created prior to v1.4.0

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.4.0 - 2021-01-29

Major Updates

None

Minor Updates

Added

reo/reopt.jl: Coincident peak rates and expected time steps can be specified. There can be a single rate and list of time steps. Or there can be multiple CP periods in a year with different rates, and then a set of time steps is specified for each rate. Peak demand occurring during each set of CP time steps is charged at the corresponding CP rate.

reo: Add a new ElectricTariff inputs and outputs:

coincident_peak_load_active_timesteps
coincident_peak_load_charge_us_dollars_per_kw
year_one_coincident_peak_cost_us_dollars
year_one_coincident_peak_cost_bau_us_dollars
total_coincident_peak_cost_us_dollars
total_coincident_peak_cost_bau_us_dollars

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.3.0 - 2021-01-28

Major Updates

None

Minor Updates

  • reo: New output om_and_replacement_present_cost_after_tax_us_dollars
  • reo, *.jl: New load LoadProfileBoilerFuel
    • Heating load of the site, as defined by boiler fuel consumption
  • reo, *.jl: New Tech Boiler
    • BAU Tech which serves heating load. It consumes fuel and produces hot thermal energy.
  • reo: New Site-level input FuelTariff
    • Cost structure for fuel consumed by Boiler and CHP Techs. Currently allows fixed annual or monthly values for fuel cost.
  • reo, *.jl: New load LoadProfileChillerThermal
    • Cooling load of the site, as defined by a thermal load produced by the BAU ElectricChiller or a fraction of total electric load.
    • This is treated as a subset of the total electric load (LoadProfile)
  • reo, *.jl: New Tech ElectricChiller
    • BAU Tech which serves cooling load. It consumes electricity and produces chilled water to meet the cooling load or charge ColdTES.
  • reo, *.jl: New Tech CHP
    • Combined heat and power (CHP) Tech which serves electric and heating loads. Its hot thermal production can also supply AbsorptionChiller or charge the HotTES.
  • reo, *.jl: New Tech AbsorptionChiller
    • Cooling technology which serves cooling load with a hot thermal input. It can also charge ColdTES.
  • reo, *.jl: New Storage HotTES
    • Storage model representing a hot water thermal energy storage tank. It can store hot thermal energy produced by CHP (or Boiler, but not typically).
  • reo, *.jl: New Storage ColdTES
    • Storage model representing a chilled water thermal energy storage tank. It can store cold thermal energy produced by ElectricChiller or AbsorptionChiller.
  • reo: Changed /simulated_load endpoint to add optional load_type query param for cooling and heating
    • Use load_type = "heating" with annual_mmbtu or monthly_mmbtu for heating load
    • Use load_type = "cooling" with annual_tonhour or monthly_tonhour for cooling load
  • reo: New endpoint /chp_defaults
    • Endpoint for the default prime_mover, size_class, and default cost and performance parameters for CHP
  • reo: New endpoint /loadprofile_chillerthermal_chiller_cop
    • Endpoint for the default LoadProfileChillerThermal.chiller_cop based on peak cooling load
  • reo: New endpoint /absorption_chiller_defaults
    • Endpoint for the default AbsorptionChiller cost and performance parameters based on thermal type ("hot_water" or "steam") and peak cooling load
  • reo: New endpoint /schedule_stats
    • Endpoint for getting default CHP.chp_unavailability_periods and summary metrics of the unavailability profile

Patches

  • summary: Address failing cases in user summary endpoint due to missing load profile data

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik about 4 years ago

REopt_API - v1.2.0 - 2021-01-04

Minor Updates

Added
  • reo: new inputs outage_start_time_step and outage_end_time_step to replace deprecated outage_start_hour and outage_end_hour. The latter are used as time step indices in the code, so for sub-hourly problems they do not have hourly units. For now outage_start_hour and outage_end_hour are kept in place to preserve backwards-compatibility. Also note that the new inputs are not zero-indexed.
  • reo: new output bau_sustained_time_steps to replace deprecated sustain_hours (also not deprecated yet but warning is now in response).
  • *.jl: new dvProductionToCurtail for all techs in all time steps (was previously construed with dvProductionToGrid for the third sales tier, which is meant for selling energy back to the grid beyond the annual load kWh constraint.)
  • reo: new inputs for all Techs: can_net_meter, can_wholesale, can_export_beyond_site_load, can_curtail
    • the first three correspond to the previous SalesTiers, now called ExportTiers
    • reduces the problem size in many cases since the previous model always included all three SalesTiers in every scenario and the new model only includes ExportTiers with non-zero compensation when there are Technologies that can participate
Changed
  • resilience_stats: Calculate avoided_outage_costs_us_dollars from the outagesimjob endpoint
Fixed
Deprecated
  • reo: LoadProfile outage_start_hour and outage_end_hour in favor of outage_start_time_step and outage_end_time_step
  • reo: LoadProfile sustain_hours in favor of bau_sustained_time_steps
Removed

Patches

  • resilience_stats: Catch BAU cases and do not calculate avoided outage costs
  • summary: Catch jobs that errored out and do not parse results
  • reo: Catch PVWattsDownloadError when a bad response is received
  • reo: fuel_used_gal output for Generator was incorrect for scenarios with time_steps_per_hour not equal to 1

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik over 4 years ago

REopt_API - v1.1.0 - 2020-12-08

Major

Minor

Added
  • reo: Add new Financial outputs :
    • developer_annual_free_cashflow_series_us_dollars
    • offtaker_annual_free_cashflow_series_bau_us_dollars
    • offtaker_annual_free_cashflow_series_us_dollars
    • offtaker_discounted_annual_free_cashflow_series_bau_us_dollars
    • offtaker_discounted_annual_free_cashflow_series_us_dollars
  • reo: New capability to model a rolling lookback if URDB lookbackRange is non-zero
  • reo: Add a new third-party financing output:
    • net_present_cost_us_dollars
  • reo: New Wind curtailment output
    • year_one_curtailed_production_series_kw
  • reo: Emissions factor series added for ElecticTariff (defaults to AVERT regional data) and Generator:
    • emissions_factor_series_lb_CO2_per_kwh
    • emissions_factor_lb_CO2_per_gal
  • reo/proforma: ElectricTariff, Generator and Site year 1 emissions totals as new outputs from API and in Proform
    • emissions_region (Site Only)
    • year_one_emissions_lb_C02
    • year_one_emissions_bau_lb_C02
  • reo: LCOE API output added for PV and Wind:
    • lcoe_us_dollars_per_kwh
  • reo: Simple Payback/IRR API outputs added for Site:
    • irr_pct
    • simple_payback_years
  • reo: New total storage rebates ($/kWh) Storage input:
    • total_rebate_us_dollars_per_kwh
  • proforma: PV LCOE, Wind LCOE, Host Present Worth Factor, Developer Present Worth Factor, PV Energy Levelization Factor, and Simple Payback added
  • *.jlAdd new constraint that sets dvGridToStorage to zero for all grid connected time steps when Storage.canGridCharge is false
  • reo: Add hybrid load profile option. New LoadProfile inputs:
    • percent_share
    • doe_reference_name (now a str or lis of str)
  • reo: Add PV curtailment output:
    • year_one_curtailed_production_series_kw
  • proforma: Two proforma templates, now with 3 tabs instead of 2.
    [1] one party: separate optimal and BAU cash flows
    [2] two party: separate developer and host cash flows (showing capital recovery factor and developer IRR ).
  • reo: New output for year 1 existing PV production
    • average_yearly_energy_produced_bau_kwh
  • reo: Add inputs to ElectricTariff to handle custom TOU energy rates (1-hr or 15-min resolutions):
    • add_tou_energy_rates_to_urdb_rate
    • tou_energy_rates_us_dollars_per_kwh
  • reo: Handle multiple PV systems by including a list of PV dictionaries instead of a single dictionary. New PV inputs include:
    • pv_name
    • pv_number
    • location
  • reo: New custom production factor inputs for PV and Wind:
    • prod_factor_series_kw
  • reo: Three new Financial outputs:
    • initial_capital_costs
    • initial_capital_costs_after_incentives
    • replacement_costs
  • resilience_stats: New financial_check endpoint
Changed
  • reo: Remove third-party factor from initial_capital_costs_after_incentives output
  • reo/proforma: Renames two party to third-party throughout the code
  • reo: When the wholesale rate is zero, all excess production is forced into curtailment bin by setting the wholesale rate to -1,000 $/kWh
  • resilience_stats: New post-and-poll process for resilience stats and removal of avoided_outage_costs_us_dollars calculation from results endpoint

    Note in the future this kind of change will be classified as major
  • *.jl: reverted export rate inputs to negative values (to match legacy conventions)
  • reo: Enables existing diesel generator in the financial case outage simulation
Fixed
  • reo: Developer generator OM costs now based on new capacity only in API-side calculations to match Proforma spreadsheet (could results in different API-reported NPV)
  • resilience_stats: Bug fix PV was not contributing to sustaining outage in the BAU case
  • reo: In non-third party cases the owner tax and discount percents were not saved to the database resulting in inaccurate after-incentive cost calculations in the web UI
  • *.jl: Wind dispatch fixes in julia code - including hooking up missing outputs
  • *.jl: Load balances constraints fixed in julia code
  • proforma: Addressed bugs, including:
    • Removed energy generation values from cash flow sheets
    • Added Generator fixed O&M cost outputs (was not accounted for in proforma)
    • Upfront capex was wrong with existing kw and no optimal kw
    • Removed PV degradation from other techs' annual production
    • Escalation and discount rates were applied incorrectly (off by one year)
    • O&M costs were double accounted, once with tax benefit, once without
    • Total installed costs was calculated incorrectly
    • Wind and Storage bonus fraction cell references were switched with each other in proforma_generator
    • Corrected PV PBI calcultion using new existing PV production output
Deprecated
Removed

Patches

  • reo: Catch and flag NaN input parameters
  • *.jl: Update Xpress.jl to v0.12 (should fix the OOM issues with celery workers)
  • reo: Set new cap on tax rates to avoid a divide by zero in results processing and the proforma
  • *.jl: fix OutOfMemory error in docker containers when building constraints in models that have more than one time step per hour
  • reo: Fix divide by 0 error in BAU outage sim job code when no existing PV
  • reo: Fix simple_payback_years and irr_pct calcs in reo/process_results.py
  • reo: Fix bug in upfront_capex_after_incentives
  • reo: Scenario.py was checking for wrong message in exception and raising UnexpectedError instead of WindDownloadError
  • *.jl: Diesel fuel costs were indexed on electric tariff tiers, which was necessary before the reformulation, but now leads to an index error in the JuMP model.
  • reo: Addresses multiple pvs and a division by 0 case in outage simulator inputs
  • reo: Report NaN IRR values as null
  • reo: Require energyratestructure, energyweekendschedule and energyweekdayschedule in a URDB rate; added new checking of URDB float fields
  • proforma: Fix bug when year_one_export_benefit_bau_us_dollars or year_one_export_benefit_us_dollars is null
  • reo: Updated handling of cases where outagesim results are not ready
  • *.jl: DER export to grid (in NEM and wholesale SalesTiers) was not set to zero during TimeStepsWithoutGrid.
  • reo: Run scenarios through reopt.jl to get the code precompiled in system images
  • reo: Fixes generator power output bug in resilience check
  • resilience_stats: Catches case where the same outagesim job is submitted twice
  • resilience_stats: Replaces JsonResponse with ImmediateHttpResponse for errors in outagesimjob workflow
  • reo: Bug fix to enable battery dispatch results to be returned
  • resilience_stats: When an outagesimjob has already been returned the status code is now 208 (Already Reported) rather than 500
  • reo: Enable rerunning of POSTs (clean up PV and Wind prod factor and all percent_share entries in results response)
  • reo: Uses new Wind Toolkit API URL
  • proforma: Updated storage to read per kW and per kWh incentives
  • proforma: Updated final cashflow to include non-taxed year 0 incentives (CBI and IBI)
  • *.jl: MinChargeAdd in reopt.jl was only accounting for year zero charges (needs to be lifecycle charges)
  • REopt_Lite_API: Use Django version 2.2.13 (had been 2.2.6)
  • reo: Handling the financial scenario's user uploaded critical load series bug
  • reo: Fix bug in URDB parsing timestep for TOU rates
  • reo: Fix bug in error handling for load profiles with negative non-net loads
  • reo: Handle non REoptErrors in scenario.py
  • reo: results response will not return empty lists in inputs or outputs
  • reo: Use default LoadProfile year of 2017 for all built-in load profiles
  • reo: Set 2019 default year in nested_inputs
  • *.jl: Fix bug where pwf_prod_incent was accounting for the discount rate and LevelizationFactorProdIncent was accounting for production degradation
  • reo: Upgrade to URDB 7, maintain backwards compatibility
  • resilience_stats: New resilience stats and financial metrics added to user summary endpoint
  • reo: More informative PVWatts error when site it too far away
  • reo/resilience_stats: Fix bug where simulated_load endpoint was not handling monthly_totals_kwh
  • reo: Fix bug where Wind was not constrained based on land_acres
  • resilience_stats: Fix resilience stastics bugs including:
    • mis-scaling the existing PV production
    • resilience_stats was returning 8759 hours survived when critical load was met for entire year
    • resilience_stats battery model was assuming that inverter was DC capacity, but inverter is AC capacity
    • the monthly and hourly survival probabilities were being returned as 1 when there was zero probability
  • *.jl: Upgrade psutil from 4.3.1 to 5.6.6.

Energy Systems - Energy System Modeling Frameworks - Python
Published by t-kwasnik over 4 years ago

REopt_API - REopt Lite API OpenSource - Release v1.0.0

This is the first open-source release of REopt™ Lite API. The REopt™ Lite model in this repository is a free and an active development version of the REopt™ Lite API that does behind-the-meter energy optimization for design and dispatch of various Distributed Energy Resources.

Technologies included in this version are: 1. PV, 2. Wind, 3. Storage, 4. Conventional Generator
Type of loads: electrical
Types of analyses: 1. Financial (life cycle cost minimization), 2. Resilience (with the constraint of meeting critical load using on-site DERs for a specified outage with the objective of minimizing the life cycle cost).

Energy Systems - Energy System Modeling Frameworks - Python
Published by sakshi-mishra about 5 years ago