DER VET User Guide/Outputs - Revision history

AndrewEtringer: adds some clarifying text for LCOH

2024-12-18T02:58:07Z

adds some clarifying text for LCOH

← Older revision		Revision as of 22:58, 17 December 2024
Line 15:		Line 15:

	= dervet_log.log =		= dervet_log.log =
	This is a log file, useful for diagnosing problems.		This is a log file, useful for diagnosing problems. If a DER-VET case fails to complete, search this log file for 'ERROR' for more information about what went wrong.

	= ecc_breakdown.csv =		= ecc_breakdown.csv =
Line 25:		Line 25:
	This file contains a column for each DER with rows showing the DER's beginning of life (start of construction), beginning of operation, end of life, and its expected lifetime.		This file contains a column for each DER with rows showing the DER's beginning of life (start of construction), beginning of operation, end of life, and its expected lifetime.

	= es_cycle_counting.csv =		= Electrolyzer System Degradation =
			== ez1_cycle_counting.csv ==
			This file contains information on how electrolzyer systems are cycled. This is the results of a rainflow counting algorithm, which counts the number of half-cycles at what depth (power fluctuation, as a percentage of rated power) the electrolyzer system executes in every optimization window. Each row represents a new cycle (count=1) or half-cycle (count=.5).

			* "rng" - effective power fluctuation (after degradation) of the electrolyzer system in this optimization window.
			* "mean" - average power fluctuation of the electrolyzer system in the half-cycle.
			* "count" - is the cycle represented in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?
			* "i_start" - the time step in the optimization window when the (half) cycle starts
			* "i_end" - the time step in the optimization window when the (half) cycle ends
			* "Opt window" - the optimization window number. (1 is the first opt window)
			* "Input_cycle_Depth_mapping" - depth (power fluctuation) of the (half) cycle in kW
			* "Cycle Life Value" - this comes from the input cycle life file. It is the number of cycles at the depth (power fluctuation) of the cycle until replacement (if starting SOH = 100%)

			== ez1_degradation_data.csv ==
			This file processes the cycle counting data (above) into degradation outcomes.

			* "Optimization Start" - The optimization window number
			* "degradation" - The change in SOH of the electrolyzer system over the optimization window.
			* "soh" - The remaining state of health at the end of the optimization window

			== ez1_yearly_degradation.csv ==
			This shows the change in SOH of the electrolyzer system in each year of the analysis.

			= Energy Storage Degradation =
			== es_cycle_counting.csv ==
	This file contains information on how energy storage systems are cycled. This is the results of a rainflow counting algorithm, which counts the number of half-cycles at what depth of discharge the storage system executes in every optimization window. Each row represents a new cycle (count=1) or half-cycle (count=.5).		This file contains information on how energy storage systems are cycled. This is the results of a rainflow counting algorithm, which counts the number of half-cycles at what depth of discharge the storage system executes in every optimization window. Each row represents a new cycle (count=1) or half-cycle (count=.5).

	* "rng" - effective energy capacity (after degradation) of the energy storage system in this optimization window.		* "rng" - effective energy capacity (after degradation) of the energy storage system in this optimization window.
	* "mean" - ~~Average~~ SOE of the storage system in the half-cycle.		* "mean" - average SOE of the storage system in the half-cycle.
	* "count" - is the cycle represented in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?		* "count" - is the cycle represented in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?
	* "i_start" - the time step in the optimization window when the (half) cycle starts		* "i_start" - the time step in the optimization window when the (half) cycle starts
	* "i_end" - the time step in the optimization window when the (half) cycle ends		* "i_end" - the time step in the optimization window when the (half) cycle ends
	* "Opt window" - ~~The~~ optimization window number. (1 is the first opt window)		* "Opt window" - the optimization window number. (1 is the first opt window)
	* "Input_cycle_DoD_mapping" - ~~Depth~~ of discharge of the (half) cycle in kWh		* "Input_cycle_DoD_mapping" - depth of discharge of the (half) cycle in kWh
	* "Cycle Life Value" - ~~This~~ comes from the input cycle life file. It is the number of cycles at the depth of discharge of the cycle until replacement (if starting SOH = 100%)		* "Cycle Life Value" - this comes from the input cycle life file. It is the number of cycles at the depth of discharge of the cycle until replacement (if starting SOH = 100%)

	= es_degradation_data.csv =		== es_degradation_data.csv ==
	This file is processes the cycle counting data (above) into degradation outcomes.		This file processes the cycle counting data (above) into degradation outcomes.

	* "Optimization Start" - The optimization window number		* "Optimization Start" - The optimization window number
Line 44:		Line 68:
	* "soh" - The remaining state of health at the end of the optimization window		* "soh" - The remaining state of health at the end of the optimization window
	* "effective energy capacity" - The remaining useful energy capacity at the end of the optimization window.		* "effective energy capacity" - The remaining useful energy capacity at the end of the optimization window.

			== es_yearly_degradation.csv ==
			This shows the change in SOH of the storage system in each year of the analysis.

	= es_dispatch_map.csv =		= es_dispatch_map.csv =
	This is a rectangular data file used to make heatmaps of energy storage system charge and discharge profiles.		This is a rectangular data file used to make heatmaps of energy storage system charge and discharge profiles.

	~~= es_yearly_degradation.csv =~~
	~~This shows the change in SOH of a storage system in each year of the analysis.~~

	= model_parameters.csv =		= model_parameters.csv =
Line 66:		Line 90:

	= payback.csv =		= payback.csv =
	This file expresses some financial metrics of the project - Payback Period, Discounted Payback Period, Lifetime Net Present Value, Modified Internal Rate of Return, and Benefit-Cost Ratio.		This file expresses some financial metrics of the project - Payback Period, Discounted Payback Period, Lifetime Net Present Value, Modified Internal Rate of Return, and Benefit-Cost Ratio. For projects with an active Electrolyzer System, this file will include a Levelized Cost of Hydrogen.

	= peak_day_load.csv =		= peak_day_load.csv =

AndrewEtringer: /* adds model parameter file output files */

2024-12-12T22:55:05Z

adds model parameter file output files

← Older revision		Revision as of 18:55, 12 December 2024
Line 5:		Line 5:
	= adv_monthly_bill.csv =		= adv_monthly_bill.csv =
	The "advanced monthly bill" output file shows a relational data frame containing each energy and demand charge component for each month of each optimization year. The 'billing period' column allows you to match the charge back to the input tariff file and see exactly what component of the tariff incurs what charges at what time. This table breaks out "original" charges, which are what the charge would be without any DER, from the charges themselves, which are with all DER.		The "advanced monthly bill" output file shows a relational data frame containing each energy and demand charge component for each month of each optimization year. The 'billing period' column allows you to match the charge back to the input tariff file and see exactly what component of the tariff incurs what charges at what time. This table breaks out "original" charges, which are what the charge would be without any DER, from the charges themselves, which are with all DER.

			= capacity_factor.csv =
			This file contains the Capacity Factor for each active Technology (except for EVs and Controllable Loads). The capacity factor (unitless) is calculated using the time series results from DER-VET
			CF = sum(the DER's power) / ( the number of timesteps * the DER's rated power)
			The net Capacity Factor is the unitless ratio of actual electrical energy output over a given period of time to the theoretical maximum electrical energy output over that period. The theoretical maximum energy output of a given installation is defined as that due to its continuous operation at full nameplate capacity over the relevant period.

	= cost_benefit.csv =		= cost_benefit.csv =
	This file contains lifetime present value costs and benefits for each benefit and cost component of the analysis, along with a row called "Lifetime Present Value", which is the total present value for both the cost and benefit column.		This file contains lifetime present value costs and benefits for each benefit and cost component of the analysis, along with a row called "Lifetime Present Value", which is the total present value for both the cost and benefit column.


	= dervet_log.log =		= dervet_log.log =
Line 14:		Line 18:

	= ecc_breakdown.csv =		= ecc_breakdown.csv =


	= energyp_map.csv =		= energyp_map.csv =
Line 47:		Line 50:
	= es_yearly_degradation.csv =		= es_yearly_degradation.csv =
	This shows the change in SOH of a storage system in each year of the analysis.		This shows the change in SOH of a storage system in each year of the analysis.

			= model_parameters.csv =
			This file is a copy of the input Model Parameter CSV file (if used).

			= model_parameters.json =
			This file is a copy of the input Model Parameter JSON file (if used). If the input Model Parameter was a CSV file, then it gets converted to JSON format in this file.

	= monthly_data.csv =		= monthly_data.csv =
Line 57:		Line 66:

	= payback.csv =		= payback.csv =
	This file expresses some financial metrics of the project - Payback Period, Discounted Payback Period, Lifetime Net Present Value, Internal Rate of Return, and Benefit-Cost Ratio.		This file expresses some financial metrics of the project - Payback Period, Discounted Payback Period, Lifetime Net Present Value, Modified Internal Rate of Return, and Benefit-Cost Ratio.

	= peak_day_load.csv =		= peak_day_load.csv =
Line 75:		Line 84:

	= timeseries_results.csv =		= timeseries_results.csv =
	This is the heaviest output of DER-VET. It ~~show~~ detailed information on all timeseries inputs and how DERs are operated in every time step of every optimization year.		This is the heaviest output of DER-VET. It shows detailed information on all timeseries inputs and how DERs are operated in every time step of every optimization year. Column names will vary depending on which Technologies are active.

AndrewEtringer: /* es_cycle_counting.csv */

2022-04-14T17:08:37Z

es_cycle_counting.csv

← Older revision		Revision as of 13:08, 14 April 2022
Line 27:		Line 27:
	* "rng" - effective energy capacity (after degradation) of the energy storage system in this optimization window.		* "rng" - effective energy capacity (after degradation) of the energy storage system in this optimization window.
	* "mean" - Average SOE of the storage system in the half-cycle.		* "mean" - Average SOE of the storage system in the half-cycle.
	* "count" - is the cycle ~~represnted~~ in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?		* "count" - is the cycle represented in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?
	* "i_start" - the time step in the optimization window when the (half) cycle starts		* "i_start" - the time step in the optimization window when the (half) cycle starts
	* "i_end" - the time step in the optimization window when the (half) cycle ends		* "i_end" - the time step in the optimization window when the (half) cycle ends

Jthompson at 13:07, 27 September 2021

2021-09-27T13:07:55Z

← Older revision		Revision as of 09:07, 27 September 2021
Line 1:		Line 1:
	{{DISPLAYTITLE: {{SUBPAGENAME}}}}		{{DISPLAYTITLE: {{SUBPAGENAME}}}}
			{{DER-VET User Guide Navigation}}

Mevans: 1 revision imported

2021-03-31T20:41:59Z

1 revision imported

← Older revision	Revision as of 16:41, 31 March 2021
(No difference)

en>MilesEvans at 17:59, 31 March 2021

2021-03-31T17:59:12Z

New page

{{DISPLAYTITLE: {{SUBPAGENAME}}}}

= adv_monthly_bill.csv =
The "advanced monthly bill" output file shows a relational data frame containing each energy and demand charge component for each month of each optimization year. The 'billing period' column allows you to match the charge back to the input tariff file and see exactly what component of the tariff incurs what charges at what time. This table breaks out "original" charges, which are what the charge would be without any DER, from the charges themselves, which are with all DER.

= cost_benefit.csv =
This file contains lifetime present value costs and benefits for each benefit and cost component of the analysis, along with a row called "Lifetime Present Value", which is the total present value for both the cost and benefit column.

= dervet_log.log =
This is a log file, useful for diagnosing problems.

= ecc_breakdown.csv =

= energyp_map.csv =
This file shows a rectangular table of the price of energy, whether from a time series input or a retail tariff. This is useful for making a heatmap of energy prices, showing hour of the day along the y-axis, day of the year along the x-axis, and the price of energy in color.

= equipment_lifetimes.csv =
This file contains a column for each DER with rows showing the DER's beginning of life (start of construction), beginning of operation, end of life, and its expected lifetime.

= es_cycle_counting.csv =
This file contains information on how energy storage systems are cycled. This is the results of a rainflow counting algorithm, which counts the number of half-cycles at what depth of discharge the storage system executes in every optimization window. Each row represents a new cycle (count=1) or half-cycle (count=.5).

* "rng" - effective energy capacity (after degradation) of the energy storage system in this optimization window.
* "mean" - Average SOE of the storage system in the half-cycle.
* "count" - is the cycle represnted in this row a full (both charge and discharge) cycle or a half cycle (only charge or only discharge)?
* "i_start" - the time step in the optimization window when the (half) cycle starts
* "i_end" - the time step in the optimization window when the (half) cycle ends
* "Opt window" - The optimization window number. (1 is the first opt window)
* "Input_cycle_DoD_mapping" - Depth of discharge of the (half) cycle in kWh
* "Cycle Life Value" - This comes from the input cycle life file. It is the number of cycles at the depth of discharge of the cycle until replacement (if starting SOH = 100%)

= es_degradation_data.csv =
This file is processes the cycle counting data (above) into degradation outcomes.

* "Optimization Start" - The optimization window number
* "degradation" - The change in SOH of the storage system over the optimization window.
* "soh" - The remaining state of health at the end of the optimization window
* "effective energy capacity" - The remaining useful energy capacity at the end of the optimization window.

= es_dispatch_map.csv =
This is a rectangular data file used to make heatmaps of energy storage system charge and discharge profiles.

= es_yearly_degradation.csv =
This shows the change in SOH of a storage system in each year of the analysis.

= monthly_data.csv =

= npv.csv =
Similar to the cost_benefit.csv file, this expresses the present value of each cost/benefit category across the analysis window, but does not break out cost and benefits separately. Instead, costs are negative numbers and benefits are positive numbers.

= objective_values.csv =
This provides a detailed look under the hood of the optimization. This expresses every term of the objective function and the values they take in every optimization window.

= payback.csv =
This file expresses some financial metrics of the project - Payback Period, Discounted Payback Period, Lifetime Net Present Value, Internal Rate of Return, and Benefit-Cost Ratio.

= peak_day_load.csv =
Where applicable, this file finds the day with the peak site_load and simply expresses the site load vs time for that day. This is just used to quickly identify when the peak load occurs, what the peak load is, and make a plot accordingly.

= pro_forma.csv =
This is a full nominal cash flows pro forma document that expresses the nominal cost (-) or benefit (+) of each cost/benefit category in every year of the analysis window. This document shows how cash flows are escalated/interpolated, when DER are constructed, become operational, and fail, and all other detailed benefit-cost analysis mechanisms.

= simple_monthly_bill.csv =
Similar to the advanced monthly bill file, this expresses the energy and demand charges associated with a retail tariff. Unlike the advanced file, this aggregates each months charges into demand charges, energy charges, original (read: without DER) demand charges, and original energy charges.

= size.csv =
This returns the size of each DER, whether it was input by the user or determined optimally in DER-VET.

= technology_summary.csv =
This file simply contains a list of all DERs present and their unique name.

= timeseries_results.csv =
This is the heaviest output of DER-VET. It show detailed information on all timeseries inputs and how DERs are operated in every time step of every optimization year.