Initial Help revisions for PV UI redesign

Author: cpaulgilman

doc/source/degradation/degradation_ac.rst

@@ -2,42 +2,38 @@ AC Degradation
 ==============
 
 The AC Degradation inputs allow you to model a decline in the system's AC electrical output over time due, for example, to aging of equipment.
-
-
 
 .. note:: When you specify degradation in each year, SAM ignores the value you specify for Year 1 (Row 1 of the input table) because it assumes degradation applies in Years 2 and later.
 
-
-.. note:: For systems with battery storage, the battery's degradation depends on the inputs on the :doc:`Battery Life <../battery-storage/battery_life>` page. For systems with fuel cells, the fuel cell degradation inputs are on the :doc:`Fuel Cell <../fuel-cell/fuelcell_fuel_cell>` page.
+   For systems with battery storage, the battery's degradation depends on the inputs on the :doc:`Battery Life <../battery-storage/battery_life>` page. For systems with fuel cells, the fuel cell degradation inputs are on the :doc:`Fuel Cell <../fuel-cell/fuelcell_fuel_cell>` page.
 
 Annual Degradation for Single-year Simulation
-.............................................
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Annual AC degradation rate**
   The annual reduction in the system's AC output as a percentage of the system's total annual AC output.
 
 .. _degac-valueschedule:
 
 Value and Schedule Mode
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Value Mode: Fixed Degradation Rate
-..................................
-
-For most situations where you want to model an annual reduction in the system's output, you can use a single annual degradation rate that applies to all years of the project cash flow. SAM applies the percentage to the system's total annual electrical output value in years 2 and later.
+------------------------
 
-For example, for performance models other than the Detailed Photovoltaic and PVWatts models, a degradation rate of 1% for a system with a net annual output of 100,000 kWh in Year one results in annual output values of 100,000 kWh in year 1, 99,000 kWh in year 2, 98,010 kWh in year 3, 97,029.9 kWh in year 4, etc.
+For most situations where you want to model an annual reduction in the system's output, you can use the "value mode" for a single annual degradation rate that applies to all years of the project cash flow. SAM applies the percentage to the system's total annual electrical output value in years 2 and later.
 
-Schedule Mode: Annual Degradation Rates
-.......................................
+.. topic:: Value Mode Example
+  
+   An AC degradation rate of 1% for a system with a net annual AC output of 100,000 kWh in Year one results in annual output values of 100,000 kWh in year 1, 99,000 kWh in year 2, 98,010 kWh in year 3, 97,029.9 kWh in year 4, etc.
 
-In some situations, you may want to assign a different degradation rate to different years of the project cash flow. To do that, you use the annual schedule option to specify a table of degradation rate values. In Schedule mode, SAM applies the degradation rate for a given year to the annual output in Year one to calculate the annual output for that year.
+In some situations, you may want to assign a different degradation rate to different years of the project cash flow. To do that, you use the "schedule mode" to specify a table of degradation rate values. In Schedule mode, SAM applies the degradation rate for a given year to the annual output in Year one to calculate the annual output for that year.
 
-.. note:: For example, for a system with a Year 1 output of 10,000 kWh, if you specify a degradation rate of 0.5% for Year 5, SAM would calculate the annual output in Year 5 as follows: 10,000 kWh × (1 - 0.005) = 9,950 kWh.
+.. topic:: Schedule Mode Example
+  
+   For a system with a Year 1 AC output of 10,000 kWh, if you specify an AC degradation rate of 0.5% for Year 5, SAM would calculate the annual AC output in Year 5 as follows: *10,000 kWh × (1 - 0.005) = 9,950 kWh*.
 
-.. note:: Because Year 1 is the first year of operation before degradation begins, you should set the degradation rate for Year 1 (the first row in the degradation table) to zero.
+   Because Year 1 is the first year of operation before degradation begins, you should set the degradation rate for Year 1 (the first row in the degradation table) to zero.
 
 To enter an annual schedule of degradation rates:
+.................................................
 
 .. include:: ../includes/snip_annual_values.rst
 

doc/source/degradation/degradation_dc.rst

@@ -3,17 +3,12 @@ DC Degradation
 
 The DC Degradation inputs allow you to model a decline in a photovoltaic system's output over time due, for example, to the degradaton of module cover material.
 
-
- 
-.. note:: When you specify degradation in each year, SAM ignores the value you specify for Year 1 (Row 1 of the input table) because it assumes degradation applies in Years 2 and later.
-
-
-.. note:: The multi-year simulation uses the same weather file for each year, so it does not accurately represent the effect of changes in the solar resource and weather from year to year over the analysis period.
-
-The :ref:`lifetime daily losses <lifetimedaily>` inputs  can be used to model losses in the system that vary over the analysis period and are not covered by annual degradation.
+.. note:: Use inputs on the :doc:`../grid/grid_limits` page to model an interconnection limit and grid curtailment. Use :ref:`pvavailability` inputs on the Electrical Losses page to model system availability losses.
 
 Annual Degradation for Multi-year Simulation
-............................................
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The multi-year simulation uses the same weather file for each year, so it does not accurately represent the effect of changes in the solar resource and weather from year to year over the analysis period.
 
 **Annual DC degradation rate**
   The reduction in system DC output in each time step as a percentage of the system's DC output in each time step by year.
@@ -23,9 +18,7 @@ Annual Degradation for Multi-year Simulation
 Lifetime Daily Losses
 ~~~~~~~~~~~~~~~~~~~~~
 
-In addition to the annual DC degradation, you can define tables of daily AC and DC losses over the analysis period. This requires that you have a set of losses for each day over the analysis period (defined on the Financial Parameters page). For example, for an analysis period of 25 years, you would need a table of* 1 value/day × 365 days/year × 25 years = 9,125 values*.
-
-.. note:: Inputs on the :doc:`Grid <../grid/grid_limits>` and :doc:`Losses <../detailed-photovoltaic-model/pv_losses>` page can be used to model curtailment and system availability losses.
+In addition to the annual DC degradation, you can define tables of daily AC and DC losses that vary over the analysis period. This requires that you have a set of losses for each day over the analysis period (defined on the Financial Parameters page). For example, for an analysis period of 25 years, you would need a table of *1 value/day × 365 days/year × 25 years = 9,125 values*.
 
 **Enable lifetime daily DC losses**
   Check the box, and then click **Edit time series data** to :doc:`enter a table of DC loss percentages <../window-reference/win_edit_data_lifetime>`   as a percentage of the system's DC output in each day for each year in the analysis period. The table requires a set of 365 values for each year in the analysis period.
@@ -36,25 +29,24 @@ In addition to the annual DC degradation, you can define tables of daily AC and
 .. _degdc-valueschedule:
 
 Value and Schedule Mode
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Value Mode: Fixed Degradation Rate
-..................................
-
-For most situations where you want to model an annual reduction in the system's output, you can use a single annual degradation rate that applies to all years of the project cash flow. SAM applies the percentage to the system's total annual electrical output value in years 2 and later.
+-----------------------
 
-For example, for performance models other than the Detailed Photovoltaic and PVWatts models, a degradation rate of 1% for a system with a net annual output of 100,000 kWh in Year one results in annual output values of 100,000 kWh in year 1, 99,000 kWh in year 2, 98,010 kWh in year 3, 97,029.9 kWh in year 4, etc.
+For most situations where you want to model an annual reduction in the system's output, you can use the "value mode" for a single annual degradation rate that applies to all years of the project cash flow. SAM applies the percentage to the system's total annual electrical output value in years 2 and later.
 
-Schedule Mode: Annual Degradation Rates
-.......................................
+.. topic:: Value Mode Example
+  
+   A DC degradation rate of 1% for a system with a annual DC output of 100,000 kWh in Year one results in annual output values of 100,000 kWh in year 1, 99,000 kWh in year 2, 98,010 kWh in year 3, 97,029.9 kWh in year 4, etc.
 
-In some situations, you may want to assign a different degradation rate to different years of the project cash flow. To do that, you use the annual schedule option to specify a table of degradation rate values. In Schedule mode, SAM applies the degradation rate for a given year to the annual output in Year one to calculate the annual output for that year.
+In some situations, you may want to use "schedule mode" to assign a different degradation rate to different years of the project cash flow. To do that, you use the annual schedule option to specify a table of degradation rate values. In Schedule mode, SAM applies the degradation rate for a given year to the annual output in Year one to calculate the annual output for that year.
 
-.. note:: For example, for a system with a Year 1 output of 10,000 kWh, if you specify a degradation rate of 0.5% for Year 5, SAM would calculate the annual output in Year 5 as follows: 10,000 kWh × (1 - 0.005) = 9,950 kWh.
+.. topic:: Schedule Mode Example
+  
+   For a system with a Year 1 DC output of 10,000 kWh, if you specify a DC degradation rate of 0.5% for Year 5, SAM would calculate the annual output in Year 5 as follows: 10,000 kWh × (1 - 0.005) = 9,950 kWh.
 
-.. note:: Because Year 1 is the first year of operation before degradation begins, you should set the degradation rate for Year 1 (the first row in the degradation table) to zero.
+   Because Year 1 is the first year of operation before degradation begins, you should set the degradation rate for Year 1 (the first row in the degradation table) to zero.
 
 To enter an annual schedule of degradation rates:
+.................................................
 
 .. include:: ../includes/snip_annual_values.rst
 

doc/source/detailed-photovoltaic-model/index.rst

@@ -7,7 +7,9 @@ Detailed Photovoltaic Model
    pv_location_and_resource
    pv_module
    pv_inverter
-   pv_system_design
-   pv_shading
-   pv_losses
+   pv_system_size
+   pv_tracking_layout_land
+   pv_soiling_shading_snow
+   pv_electrical_losses
+   pv_sizing_instructions
    pv_results