EnergySiteCreateRequest

Basic Asynchronous Request

Method: POST
URL: https://service.solaranywhere.com/api/v2/EnergySites

To create an energy site, specify energy site elements such as site name and location, as well as PV system elements like inverter and module specifications and array configuration details. The response to this Post request will contain a unique EnergySiteId associated with the system that can be used in a variety of operations including simulation requests.

Clean Power Research offers two solar simulation models for use in energy site simulation: pvlib and CprPVForm. Visit the introduction page to learn more about the power models available and determine the optimal way to define your energy sites. To learn more about the attributes specified in an EnergySiteCreateRequest, visit the terms & concepts page.

Energy Site Examples for Use with pvlib Power Model

If you plan to use the pvlib power model, use these JSON or XML samples to get started.

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "01",
    "Description": "Basic fixed tilt utility-scale PV system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6.0,
        "RainAccumPeriod": 24,
        "ThresholdSnowfall_CentimeterPerHour": 1.0, 
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80,
        "SlideAmountCoefficient": 0.197,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 25.00,
              "Tracking": "Fixed",
              "TrackingRotationLimit_Degrees": 90,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
              "NumStrings": 2
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "02",
    "Description": "Basic single-axis tracking utility-scale PV system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6.0,
        "RainAccumPeriod": 24,
        "ThresholdSnowfall_CentimeterPerHour": 1.0, 
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80,
        "SlideAmountCoefficient": 0.197,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 0.00,
              "Tracking": "SingleAxis",
              "TrackingRotationLimit_Degrees": 60,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
              "NumStrings": 1
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "03",
    "Description": "Basic single-axis tracking with backtracking utility-scale PV system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6.0,
        "RainAccumPeriod": 24,
        "ThresholdSnowfall_CentimeterPerHour": 1.0, 
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80,
        "SlideAmountCoefficient": 0.197,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 0.00,
              "Tracking": "SingleAxisWithBacktracking",
              "TrackingRotationLimit_Degrees": 60,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
              "NumStrings": 1
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "04",
    "Description": "Basic single-axis tracking utility-scale PV system with near-object shading",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6.0,
        "RainAccumPeriod": 24,
        "ThresholdSnowfall_CentimeterPerHour": 1.0, 
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80,
        "SlideAmountCoefficient": 0.197,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 0.00,
              "Tracking": "SingleAxis",
              "TrackingRotationLimit_Degrees": 60,
              "ModuleRowCount": 25,
             "RelativeRowSpacing": 3
            },          
            "MonthlyShadings": [
              {
                "MonthNumber": 1,
                "SolarAccess_Percent": 77.0
              },
              {
                "MonthNumber": 2,
                "SolarAccess_Percent": 87.0
              },
              {
                "MonthNumber": 3,
                "SolarAccess_Percent": 98.0
              },
              {
                "MonthNumber": 4,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 5,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 6,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 7,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 8,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 9,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 10,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 11,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 12,
                "SolarAccess_Percent": 91.0
              }
            ]
          }
        ]
      }
    ]
  }
}

{ 
  "EnergySite": { 
    "Name": "Sample Site - El Paso", 
    "CustomerSiteId": "05", 
    "Description": " Single-Axis Backtracking Utility-Scale PV System with Bifacial Modules ", 
    "Location": { 
      "Latitude": 31.775, 
      "Longitude": -106.485 
    }, 
    "PvSystems": [ 
      { 
        "Bifacial": true, 
        "GeneralDerate_Percent": 86.00, 
        "CleaningThreshold_Millimeters": 6.0, 
        "RainAccumPeriod": 24, 
        "ThresholdSnowfall_CentimeterPerHour": 1.0,  
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80, 
        "SlideAmountCoefficient": 0.197, 
        "Inverters": [ 
          { 
            "Count": 12, 
            "MaxPowerOutputAC_kW": 4166.7, 
            "EfficiencyRating_Percent": 97.000000 
          } 
        ], 
        "PvArrays": [ 
          { 
            "PvModules": [ 
              { 
                "Count": 165000, 
                "NameplateDCRating_kW": 0.33, 
                "PtcRating_kW": 0.3054, 
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4 
              } 
            ], 
            "ArrayConfiguration": { 
			 "Azimuth_Degrees": 180.000, 
			 "Tilt_Degrees": 0.00, 
			 "Tracking": "SingleAxisWithBacktracking", 
			 "TrackingRotationLimit_Degrees": 60, 
			 "ModuleRowCount": 25, 
			 "RelativeRowSpacing": 3,
			 "RowHeight_Meters": 1, 
			 "Pitch_Meters": 10, 
			 "BifacialityFactor_Unitless": 0.65, 
			 "TransmissionFactor_Unitless": -0.013, 
			 "ShadeFactor_Unitless": -0.02 
            } 
          } 
        ] 
      } 
    ] 
  } 
}

{ 
  "EnergySite": { 
    "Name": "Sample Site - El Paso", 
    "CustomerSiteId": "06", 
    "Description": " Single-Axis Backtracking Utility-Scale PV System with a mix of Monofacial and Bifacial Modules ", 
    "Location": { 
      "Latitude": 31.775, 
      "Longitude": -106.485 
    }, 
    "PvSystems": [ 
      {  
        "Bifacial": true, 
        "GeneralDerate_Percent": 86.00, 
        "CleaningThreshold_Millimeters": 6.0, 
        "RainAccumPeriod": 24, 
        "ThresholdSnowfall_CentimeterPerHour": 1.0,  
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80, 
        "SlideAmountCoefficient": 0.197, 
        "Inverters": [ 
          { 
            "Count": 12, 
            "MaxPowerOutputAC_kW": 4166.7, 
            "EfficiencyRating_Percent": 97.000000 
          } 
        ], 
        "PvArrays": [ 
          { 
            "PvModules": [ 
              { 
                "Count": 165000, 
                "NameplateDCRating_kW": 0.33, 
                "PtcRating_kW": 0.3054, 
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4 
              } 
            ], 
            "ArrayConfiguration": { 
              "Azimuth_Degrees": 180.000, 
              "Tilt_Degrees": 0.00, 
              "Tracking": "SingleAxisWithBacktracking", 
              "TrackingRotationLimit_Degrees": 60, 
              "ModuleRowCount": 25, 
              "RelativeRowSpacing": 3,
              "RowHeight_Meters": 1, 
              "Pitch_Meters": 10, 
              "BifacialityFactor_Unitless": 0.65, 
              "TransmissionFactor_Unitless": -0.013, 
              "ShadeFactor_Unitless": -0.02 
            } 
          } 
        ] 
      }, 
       { 
        "Bifacial": false, 
        "GeneralDerate_Percent": 86.00, 
        "CleaningThreshold_Millimeters": 6.0, 
        "RainAccumPeriod": 24, 
        "ThresholdSnowfall_CentimeterPerHour": 1.0,  
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80, 
        "SlideAmountCoefficient": 0.197, 
        "Inverters": [ 
          { 
            "Count": 12, 
            "MaxPowerOutputAC_kW": 4166.7, 
            "EfficiencyRating_Percent": 97.000000 
          } 
        ], 
        "PvArrays": [ 
          { 
            "PvModules": [ 
              { 
                "Count": 165000, 
                "NameplateDCRating_kW": 0.33, 
                "PtcRating_kW": 0.3054, 
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4 
              } 
            ], 
            "ArrayConfiguration": { 
              "Azimuth_Degrees": 180.000, 
              "Tilt_Degrees": 0.00, 
              "Tracking": "SingleAxisWithBacktracking", 
              "TrackingRotationLimit_Degrees": 60, 
              "ModuleRowCount": 25, 
              "RelativeRowSpacing": 3 
            } 
          } 
        ] 
      } 
    ] 
  } 
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "07",
    "Description": "Fixed tilt utility-scale PV system for HSU Soiling Losses",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6.0,
        "RainAccumPeriod": 24,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 25.00,
              "Tracking": "Fixed",
              "TrackingRotationLimit_Degrees": 90,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "08",
    "Description": "Fixed tilt utility-scale PV system for Kimber Soiling Losses",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "GeneralDerate_Percent": 86.00,
        "CleaningThreshold_Millimeters": 6,
        "RainAccumPeriod": 24,
        "DailySoilingLossRate": 0.0015,
        "SoilingGracePeriod_Days": 14,
        "MaximumSoiling": 0.3,
        "ManualWashesPerMonth": [0,0,0,0,0,0,0,0,0,0,0,0],
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 25.00,
              "Tracking": "Fixed",
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3,
              "NumStrings": 2
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - Calgary",
    "CustomerSiteId": "09",
    "Description": "Fixed tilt utility-scale PV system for NREL Snow Losses",
    "Location": {
      "Latitude": 51.045,
      "Longitude": -114.055
    },
    "PvSystems": [
      {
        "GeneralDerate_Percent": 86.00,
        "ThresholdSnowfall_CentimeterPerHour": 1.0, 
        "CanSlideCoefficient_WattPerMeterSquareCelsius": -80,
        "SlideAmountCoefficient": 0.197,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 25.00,
              "Tracking": "Fixed",
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3,
              "NumStrings": 2
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - Calgary",
    "CustomerSiteId": "10",
    "Description": "Fixed tilt utility-scale PV system for Townsend Snow Losses",
    "Location": {
      "Latitude": 51.045,
      "Longitude": -114.055
    },
    "PvSystems": [
      {
        "GeneralDerate_Percent": 86.00,
        "RowSlantHeight_Meters": 1.67,
        "GroundClearance_Meters" : 0.9,
        "Inverters": [
          {
            "Count": 12,
            "MaxPowerOutputAC_kW": 4166.7,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 165000,
                "NameplateDCRating_kW": 0.33,
                "PtcRating_kW": 0.3054
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 25.00,
              "Tracking": "Fixed",
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3,
              "NumStrings": 2
            }
          }
        ]
      }
    ]
  }
}

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Basic fixed tilt utility-scale PV system">
  <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" />
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.00" Azimuth_Degrees="180.000"  RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="1" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Basic single-axis tracking utility-scale PV system">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxis" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Basic single-axis tracking with backtracking utility-scale PV system">
  <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxisWithBacktracking" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Basic single-axis tracking utility-scale PV system with near-object shading">
  <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Bifacial="true" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxis" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" />
      <MonthlyShadings>
       <MonthlyShading MonthNumber="1" SolarAccess_Percent="77.0" />
       <MonthlyShading MonthNumber="2" SolarAccess_Percent="87.0" />
       <MonthlyShading MonthNumber="3" SolarAccess_Percent="98.0" />
       <MonthlyShading MonthNumber="4" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="5" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="6" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="7" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="8" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="9" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="10" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="11" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="12" SolarAccess_Percent="91.0" />
      </MonthlyShadings>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Basic single-axis tracking with backtracking utility-scale PV system">
  <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Bifacial="true" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxisWithBacktracking" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Single-Axis Backtracking Utility-Scale PV System with a mix of Monofacial and Bifacial Modules">
  <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Bifacial ="true" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxisWithBacktracking" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" RowHeight_Meters="1" Pitch_Meters="10" BifacialityFactor_Unitless="0.65" TransmissionFactor_Unitless="-0.013" ShadeFactor_Unitless="-0.02" />
     </PvArray>
    </PvArrays>
   </PvSystem>
   <PvSystem Bifacial ="false" GeneralDerate_Percent="86.00" GridInterconnectionLimitAC_kW="45" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" ThresholdSnowfall_CentimeterPerHour = "1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxisWithBacktracking" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Fixed tilt utility-scale PV system for HSU Soiling Losses">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" >
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Fixed tilt utility-scale PV system for Kimber Soiling Losses">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" CleaningThreshold_Millimeters ="6.0" RainAccumPeriod ="24" DailySoilingLossRate ="0.0015" SoilingGracePeriod_Days ="14" MaximumSoiling ="0.3" ManualWashesPerMonth ="[0,0,0,0,0,0,0,0,0,0,0,0]">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - Calgary" Description="Fixed tilt utility-scale PV system for NREL Snow Losses">
 <Location Latitude="51.045" Longitude="-114.055" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" ThresholdSnowfall_CentimeterPerHour ="1.0" CanSlideCoefficient_WattPerMeterSquareCelsius ="-80" SlideAmountCoefficient ="0.197">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - Calgary" Description="Fixed tilt utility-scale PV system for Townsend Snow Losses">
 <Location Latitude="51.045" Longitude="-114.055" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="86.00" RowSlantHeight_Meters ="1.67" GroundClearance_Meters ="0.9">
    <Inverters>
     <Inverter Count="12" MaxPowerOutputAC_kW="4166.7" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="165000" NameplateDCRating_kW="0.33" PtcRating_kW="0.3054" PowerTemperatureCoefficient_PercentPerDegreeC="0.4"/>
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25" NumStrings="2" />
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

Tracking Options
In addition to fixed-tilt and single-axis tracking PV systems, the pvlib power model supports the modeling of single-axis systems with backtracking. Learn more about these tracking types and their different specification requirements at our terms & concepts page. To specify these different tracking types, use: “Fixed”, “SingleAxis” or “SingleAxisWithBacktracking”.

Modeling a Grid Interconnection Limit
If you would like to model the system to the maximum AC capacity based on the inverter count and capacity, but still limit the PowerAC_kW and EnergyAC_kW simulation outputs to interconnection limit of the system, specify a GridInterconnectionLimitAC_kW in the PV System element of your site. When you have specified a grid interconnection limit, you can also include the PowerBeforeGridInterconnectionLimitAC_kW and ClearSkyPowerBeforeGridInterconnectionLimitAC_kW output fields in your simulation requests to see the power modeled to the max capacity of the system.

Shading Options
If you would like to model near-object shading on your system by month, start with the “monthly solar access percentages” sample when creating your energy site, then use the MonthlyPercentSolarResource shading model when creating the simulation request for the site. This shading model is discussed in more detail in our terms & concepts page.
You can also model the impact of near-object shading on energy performance by modifying the GeneralDerate_Percent in the energy site specification. To learn how the derate is computed from individual loss components in the pvlib model, see the “System Losses/Derate” definition in the terms & concepts page.

Snow Loss Inputs
Pvlib supports the Marion model from NREL and Townsend model for snow loss modeling. The NREL model assumes snow sliding to be the primary method of snow removal. The Townsend model calculates snow losses by snow sliding that is limited by accumulation of snow at the base of the PV modules. The following optional parameters can be specified in the API for use in these models:

ThresholdSnowfall_CentimeterPerHour: The hourly snowfall threshold above which snow coverage is set to the row’s slant height. In other words, when the snowfall exceeds this threshold, the PV module is assumed to be fully covered by snow. It is expressed in units of centimeters per hour. Pvlib uses a default value of 1 centimeter per hour.
CanSlideCoefficient_WattPerMeterSquareCelsius¹: The coefficient that determines if snow can slide off the PV panels given irradiance and air temperature. It is expressed in units of Watt per meter square Celsius. Pvlib uses a default value of -80.
SlideAmountCoefficient¹: The coefficient that determines the fraction of snow sliding off the PV panels in one hour. It is unitless. Pvlib uses a default value of 0.197.
NumStrings: The number of parallel-connected strings along a row slant height. It is unitless. Pvlib uses a default value of 2 for fixed arrays and 1 for tracking arrays.
RowSlantHeight_Meters²: The length of each row in the slanted plane of the array. It is expressed in units of meters. Pvlib uses a default value of 1.67.
GroundClearance_Meters²: The clearance between the bottom edge of each module and the ground. Snow that slides off the module can accumulate on the ground and cover the module. It is expressed in units of meters. Pvlib uses a default value of 0.9.

¹Only used as inputs for the NREL model.
²Only used as inputs for the Townsend model.

Soiling Loss Inputs
Pvlib supports the Humboldt State University (HSU) and Kimber soiling loss models. The HSU model assumes natural precipitation is the only source of cleaning for the PV panels. Particulate matter and the other environmental data required for the HSU model are automatically extracted from SolarAnywhere time-series weather data. The Kimber model assumes soiling accumulates at a defined daily rate until the daily rainfall is greater than the defined threshold. SolarAnywhere API users can specify the following optional input parameters for use with these models in the PVSystem element:

CleaningThreshold_Millimeters: The minimum amount of rain in an accumulation period that is needed to clean the PV modules. It is expressed in millimeters. SolarAnywhere uses a default value of 6.0 milimeters.
RainAccumPeriod: The period for accumulating rainfall to used with the CleaningThreshold_Millimeters parameter. It is recommended that this parameter be between 1 and 24 hours. SolarAnywhere uses a default value of 24 hours for this parameter.
DailySoilingLossRate*: The expected daily loss in energy output occurring due to soiling buildup on the modules. Expressed as a unitless fractional value per day. SolarAnywhere uses a default value of 0.0015.
SoilingGracePeriod_Days*: The number of days the ground is expected to be damp after each rainfall event. Soiling does not accumulate during this period. SolarAnywhere uses a default value of 14.
ManualWashesPerMonth*: The number of times the PV modules are cleaned during the month. Cleanings are assumed to be roughly evenly spaced. Expressed as a sequence of 12 integers. SolarAnywhere uses a default value of [0,0,0,0,0,0,0,0,0,0,0,0].

*Only used as inputs for the Kimber model.

Bifacial PV System Inputs
Pvlib supports the Infinite Sheds Bifacial Model. To specify a bifacial PV system, set Bifacial = “true” in the PvSystems element of the energy site definition. If your PV system has monofacial PV modules, specify Bifacial as false or remove it from the request completely.

SolarAnywhere API users can specify the following optional input parameters for use with this model. Table 2 lists the optional set of parameters for use with bifacial energy systems.

Optional Energy Site Parameters	Definition	Default value	Acceptable Ranges	Unit
BifacialityFactor_Unitless	Ratio of the efficiency of the module’s rear surface to the efficiency of the front surface.	0.65	0 to 1, inclusive	Unitless
RowHeight_Meters	Height of the center point of the row above the ground.	1	1 to 50	meters
Pitch_Meters	Distance between two rows.	10	1 to 50	meters
TransmissionFactor_Unitless	Fraction of irradiance on the back surface that does not reach the module’s cells due to module features such as busbars, junction box, etc. A negative value is a reduction in back irradiance.	-0.013	-1 to 0, inclusive	Unitless
ShadeFactor_Unitless	Fraction of back surface irradiance that is blocked by array mounting structures. Negative value is a reduction in back irradiance.	-0.02	-1 to 0, inclusive	Unitless

Visit the Terms & Concepts page to learn more about soiling loss modeling.

Energy Site Examples for Use with CprPVForm Power Model

If you plan to use the CprPVForm power model, use these JSON or XML samples to get started.

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "01",
    "Description": "Sample residential rooftop system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 85.00,
        "Inverters": [
          {
            "Count": 1,
            "MaxPowerOutputAC_kW": 4.470000,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 20,
                "NameplateDCRating_kW": 0.22000,
                "PtcRating_kW": 0.19760,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 177.000,
              "Tilt_Degrees": 25.000,
              "Tracking": "Fixed",
              "TrackingRotationLimit_Degrees": 90,
              "ModuleRowCount": 1,
              "RelativeRowSpacing": 3
            }
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "02",
    "Description": "Sample residential rooftop system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 85.00,
        "Inverters": [
          {
            "Count": 1,
            "MaxPowerOutputAC_kW": 4.470000,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 20,
                "NameplateDCRating_kW": 0.22000,
                "PtcRating_kW": 0.19760,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 0.00,
              "Tracking": "SingleAxis",
              "TrackingRotationLimit_Degrees": 60,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
            },
            "SolarObstructions": [
              {
                "Azimuth_Degrees": 90.000,
                "Elevation_Degrees": 33.000,
                "Opacity_Percent": 80.0
              },
              {
                "Azimuth_Degrees": 120.000,
                "Elevation_Degrees": 50.000,
                "Opacity_Percent": 100.0
              },
              {
                "Azimuth_Degrees": 150.000,
                "Elevation_Degrees": 22.000,
                "Opacity_Percent": 100.0
              },
              {
                "Azimuth_Degrees": 180.000,
                "Elevation_Degrees": 3.000,
                "Opacity_Percent": 100.0
              },
              {
                "Azimuth_Degrees": 210.000,
                "Elevation_Degrees": 1.000,
                "Opacity_Percent": 100.0
              },
              {
                "Azimuth_Degrees": 240.000,
                "Elevation_Degrees": 2.000,
                "Opacity_Percent": 100.0
              },
              {
                "Azimuth_Degrees": 270.000,
                "Elevation_Degrees": 4.000,
                "Opacity_Percent": 70.0
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "02",
    "Description": "Sample residential rooftop system",
    "Location": {
      "Latitude": 31.775,
      "Longitude": -106.485
    },
    "PvSystems": [
      {
        "Albedo_Percent": 17,
        "GeneralDerate_Percent": 85.00,
        "Inverters": [
          {
            "Count": 1,
            "MaxPowerOutputAC_kW": 4.470000,
            "EfficiencyRating_Percent": 97.000000
          }
        ],
        "PvArrays": [
          {
            "PvModules": [
              {
                "Count": 20,
                "NameplateDCRating_kW": 0.22000,
                "PtcRating_kW": 0.19760,
                "PowerTemperatureCoefficient_PercentPerDegreeC": 0.4
              }
            ],
            "ArrayConfiguration": {
              "Azimuth_Degrees": 180.000,
              "Tilt_Degrees": 0.00,
              "Tracking": "SingleAxis",
              "TrackingRotationLimit_Degrees": 60,
              "ModuleRowCount": 25,
              "RelativeRowSpacing": 3
            },          
            "MonthlyShadings": [
              {
                "MonthNumber": 1,
                "SolarAccess_Percent": 77.0
              },
              {
                "MonthNumber": 2,
                "SolarAccess_Percent": 87.0
              },
              {
                "MonthNumber": 3,
                "SolarAccess_Percent": 98.0
              },
              {
                "MonthNumber": 4,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 5,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 6,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 7,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 8,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 9,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 10,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 11,
                "SolarAccess_Percent": 100.0
              },
              {
                "MonthNumber": 12,
                "SolarAccess_Percent": 91.0
              }
            ]
          }
        ]
      }
    ]
  }
}

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Sample residential rooftop system">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" />
      </PvModules>
      <ArrayConfiguration Tracking="Fixed" Tilt_Degrees="25.000" Azimuth_Degrees="177.000" RelativeRowSpacing="3"/>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Sample residential rooftop system">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" />
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxis" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25"/>
      <SolarObstructions>
       <SolarObstruction Opacity_Percent="80.0" Azimuth_Degrees="90.000" Elevation_Degrees="33.000" />
       <SolarObstruction Opacity_Percent="100.0" Azimuth_Degrees="120.000" Elevation_Degrees="50.000" />
       <SolarObstruction Opacity_Percent="100.0" Azimuth_Degrees="150.000" Elevation_Degrees="22.000" />
       <SolarObstruction Opacity_Percent="100.0" Azimuth_Degrees="180.000" Elevation_Degrees="3.000" />
       <SolarObstruction Opacity_Percent="100.0" Azimuth_Degrees="210.000" Elevation_Degrees="1.000" />
       <SolarObstruction Opacity_Percent="100.0" Azimuth_Degrees="240.000" Elevation_Degrees="2.000" />
       <SolarObstruction Opacity_Percent="70.0" Azimuth_Degrees="270.000" Elevation_Degrees="4.000" />
      </SolarObstructions>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site - El Paso" Description="Sample residential rooftop system">
 <Location Latitude="31.775" Longitude=" -106.485" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" />
      </PvModules>
      <ArrayConfiguration Tracking="SingleAxis" TrackingRotationLimit_Degrees="60" Tilt_Degrees="0.00" Azimuth_Degrees="180.000" RelativeRowSpacing="3" ModuleRowCount="25"/>
      <MonthlyShadings>
       <MonthlyShading MonthNumber="1" SolarAccess_Percent="77.0" />
       <MonthlyShading MonthNumber="2" SolarAccess_Percent="87.0" />
       <MonthlyShading MonthNumber="3" SolarAccess_Percent="98.0" />
       <MonthlyShading MonthNumber="4" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="5" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="6" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="7" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="8" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="9" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="10" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="11" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="12" SolarAccess_Percent="91.0" />
      </MonthlyShadings>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

Shading Options
If you would like to model shading on your system, you can do this in one of two ways when defining your energy site. If you have near object shading specifics for your PV sytem (i.e. the elevation, altitude, and opacity of surrounding objects), start with the “azimuthal shading” code sample. If you don’t have these specifics but would like to derate the simulated output based on the month, start with the “monthly solar access” sample. When creating the simulation request for the site, you will select the shading model that corresponds to the way you specified shading:

Azimuthal Shading = ShadeSimulator
Monthly Solar Access = MonthlyPercentSolarResource

The shading models are discussed in more detail in the terms & concepts page.

Tracking Options
The CprPVForm power model supports fixed-tilt as well as single-axis and dual-axis tracking PV systems. Learn more about these tracking types and their different specification requirements at the terms & concepts page. To specify these different tracking types, use: “Fixed”, “SingleAxis”, or DualAxis”.

Attributes Required for Energy Site Creation

When creating an energy site for use with either power model, the attributes listed below are required, meaning they must be present in the EnergySiteCreateRequest to successfully create a site. While it is recommended to fill out as many of the energy site specifics as possible, the fields not in this list can be removed from the request if the information is not available.

Latitude
Longitude
Inverter Count
Inverter MaxPowerOutputAC_kW
Inverter EfficiencyRating_Percent
Module Count
Module NameplateDCRating_kW
PtcRating_kW
Array Azimuth_Degrees
Array Tilt_Degrees

Optional: Provide aCustomerSiteId when specifying EnergySite. This can be used to keep track of the mapping between client and Clean Power Research systems.

Cookie	Duration	Description
CloudFlare CDN	4 weeks	This cookie is set by CloudFare to identify individual clients behind a shared IP address and apply security settings on a per-client basis. It does not correspond to any user ID in the web application and does not store any personally identifiable information.
CookieLawInfo Checkbox Necessary	11 months	This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category ‘Strictly Necessary’.
CookieLawInfo Checkbox Performance	11 months	This cookie is set by GDPR Cookie Consent plugin. The purpose of this cookie is to check whether or not the user has given the consent to the usage of cookies under the category ‘Performance’.
CookieLawInfo Checkbox Personalization	11 months	This cookie is set by GDPR Cookie Consent plugin. The purpose of this cookie is to check whether or not the user has given the consent to the usage of cookies under the category ‘Enhancements & Personalization’.
Viewed Cookie Policy	1 hour	This cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
Website Search Interaction	Session	This cookie is set by Site Search 360, our search engine for all Clean Power Research websites, to record search session preferences and performance.
Website Search Session ID	11 months	This cookie is set by Site Search 360, our search engine for all Clean Power Research websites, to record search session preferences.

Cookie	Duration	Description
Google Analytics Data Limiter	1 minute	This cookie is installed by Google Universal Analytics to throttle the request rate to limit the colllection of data on high traffic sites.
Google Analytics Page Visits	1 day	This cookie is installed by Google Analytics. The cookie is used to store information of how visitors use a website and helps in creating an analytics report of how the wbsite is doing. The data collected including the number visitors, the source where they have come from, and the pages visted in an anonymous form.
Google Analytics Random Identifier	2 years	This cookie is installed by Google Analytics. The cookie is used to calculate visitor, session, campaign data and keep track of site usage for the site’s analytics report. The cookie stores information anonymously and assigns a randomly generated number to identify unique visitors.
Marketo Tracking	2 years	This cookie is associated with an email marketing service provided by Marketo. This tracking cookie allows the website to link visitor behavior to the recipient of an email marketing campaign, to measure campaign effectiveness.

Cookie	Duration	Description
Wistia Videos	11 months	Set by Wistia to support video functionality that may be found throughout the website. In addition to keeping track of the website visitor's position in a video should playback be interrupted, this cookie also notes user behavior regarding the video itself.
Wistia Videos Data	10 months	This cookie collects visitor interaction data regarding Wistia video content so that such content can be made more relevant to the visitor.