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
            }
          }
        ]
      }
    ]
  }
}
{
  "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
            }
          }
        ]
      }
    ]
  }
}
{
  "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
            }
          }
        ]
      }
    ]
  }
}
{
  "EnergySite": {
    "Name": "Sample Site - El Paso",
    "CustomerSiteId": "03",
    "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
              }
            ]
          }
        ]
      }
    ]
  }
}
<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" />
     </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" />
     </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" />
     </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 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" />
      <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>

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 for snow loss modeling. This model assumes snow sliding to be the primary method of snow removal. The following optional parameters can be specified in the API for use in this model:

  • 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.

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

Soiling Loss Inputs
Pvlib supports the Humboldt State University (HSU) soiling loss model. This model assumes natural precipitation is the only source of cleaning for the PV panels. Particulate matter and the other environmental data required for this model are automatically extracted from SolarAnywhere time-series weather data. SolarAnywhere API users can specify the following optional input parameters for use with this model:

  • 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.

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.