Class Layout
Represents a layout of modules that could be connected to one inverter input
Namespace: SolarFarmerApi.Client
Syntax
public class LayoutProperties
Azimuth
The azimuth of the racks, in degrees clockwise from North.
For fixed tilt in the Southern Hemisphere we expect an azimuth around zero
and in the North we expect an azimuth around 180.
For trackers we expect an azimuth around 0. Either -2 or 358 would be acceptable for a plant rotated slightly anti-clockwise.
Declaration
public double Azimuth { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
DcOhmicConnectorLoss
Loss factor for the DC cabling losses.
It should be given as a fraction (i.e a value 0 - 1) of the DC output power at STC
i.e. a value of 0.01 would represent a loss of 1%.
This will be converted to a ConnectorResistance, so the actual loss in the simulation
will not be this percentage exactly, but will vary with irradiance level.
Declaration
public double DcOhmicConnectorLoss { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
InverterInput
List of which inverter input each layout is connected to.
The number of items in this list should equal LayoutCount.
Each input is identified by an integer. These should be base 0, i.e. the first input is called input 0.
However it's not essential that all inputs are used. You can have an inverter, with one layout, connected to input 2.
Declaration
public ICollection<int> InverterInput { get; set; }Property Value
| Type | Description |
|---|---|
| System.Collections.Generic.ICollection<System.Int32> |
IsTrackers
True if this layout uses trackers, false implies fixed tilt
Declaration
public bool IsTrackers { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
LayoutCount
The number of identical layouts attached. They are all attached to the one inverter.
One to each inverter input as specified in the InverterInput property.
Declaration
public int LayoutCount { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
ModuleMismatchLoss
A simple loss factor (fraction of 1) to account for module mismatch.
e.g. a value of 0.01 would represent a 1% loss.
Declaration
public double ModuleMismatchLoss { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
ModuleQualityFactor
A factor to account for other modeling adjustments per layout.
Similar property can be defined in the PanFileSupplements.
If provided, it will override the value for ModuleQualityFactor in PanFileSupplements.
Given as a fraction of 1 (per-unit), i.e. a value of 0.01 implies a 1% gain.
Negative value implies a loss.
Optional.
Default is null.
Declaration
public double? ModuleQualityFactor { get; set; }Property Value
| Type | Description |
|---|---|
| System.Nullable<System.Double> |
ModuleSpecificationID
The PV module used in the array. The string should match one of the items in the ModuleSpecifications dictionary in PVPlant.
Declaration
public string ModuleSpecificationID { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
MountingTypeID
The rack or tracker specification. The string should match one of the items in the MountingTypeSpecifications dictionary in PVPlant.
Declaration
public string MountingTypeID { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
Name
Name.
Optional property, used just to help view system performance.
Declaration
public string Name { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
NumberOfStringsInBackRow
The number of strings that are in the back row
FIXED TILT ONLY. For trackers use NumberOfStringsInRightRow and NumberOfStringsInLeftRow.
Only relevant for bifacial
They will have no shading of the back-irradiance from rows behind.
They will have shading from rows in-front.
Declaration
public int NumberOfStringsInBackRow { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
NumberOfStringsInFrontRow
The number of strings that are in the front row
FIXED TILT ONLY. For trackers use NumberOfStringsInRightRow and NumberOfStringsInLeftRow.
i.e. they have no shading from rows in-front
For the bifacial case they will have shading from rows behind.
Declaration
public int NumberOfStringsInFrontRow { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
NumberOfStringsInIsolatedRow
The number of strings that in a row that has neither shading from a row in-front
nor shading from a row behind.
Relevant for fixed tilt, bifacial and for trackers.
For trackers it implies that there is no row in-font in morning or afternoon.
For mono-facial, fixed tilt, this is equivalent to being in a front row.
If a row is included in this count it should not be included in NumberOfStringsInFrontRow
or NumberOfStringsInBackRow or in NumberOfStringsInRightRow or NumberOfStringsInLeftRow for trackers.
Default: 0
Declaration
public int NumberOfStringsInIsolatedRow { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
NumberOfStringsInLeftRow
This denotes the rows that are in-front when the trackers are rotated to the left,
and in the back when trackers are rotated to the right.
TRACKERS ONLY. For fixed tilt use NumberOfStringsInFrontRow and NumberOfStringsInBackRow.
For a system with near zero azimuth rotated to the left means facing West,
so NumberOfStringsInRightRow counts the strings in the western most row.
If the system azimuth is near 180 then this is reversed.
Declaration
public int NumberOfStringsInLeftRow { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
NumberOfStringsInRightRow
This denotes the rows that are in-front when the trackers are rotated to the right,
and in the back when trackers are rotated to the left.
TRACKERS ONLY. For fixed tilt use NumberOfStringsInFrontRow and NumberOfStringsInBackRow.
For a system with near zero azimuth rotated to the right means facing East,
so NumberOfStringsInRightRow counts the strings in the eastern most row.
If the system azimuth is near 180 then this is reversed.
Declaration
public int NumberOfStringsInRightRow { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
Pitch
The distance between rows of racks, in meters.
Declaration
public double Pitch { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
StringLength
The number of PV modules in each string
Declaration
public int StringLength { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
TerrainAzimuth
The direction of any terrain slope, in degrees clockwise from North.
i.e. an azimuth of 0 and a positive terrain slope implies ground that runs down towards
the North, or "North-facing" slope.
Optional. Default is 0.
Declaration
public double TerrainAzimuth { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
TerrainSlope
The slope of the terrain, in degrees
The terrain slopes in the direction of TerrainAzimuth.
Optional. Default is 0.
Declaration
public double TerrainSlope { get; set; }Property Value
| Type | Description |
|---|---|
| System.Double |
TotalNumberOfStrings
The total number of strings in one layout.
This value will get multiplied up by the LayoutCount and InverterCount and TransformerCount
Declaration
public int TotalNumberOfStrings { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
TrackerSystemID
The tracker system used in the array. The string should match one of the items in the TrackerSystems dictionary in PVPlant.
Not required for fixed tilt system
This is the preferred way to define tracker system data and replaces the tracker specific fields in MountingTypeSpecification
Declaration
public string TrackerSystemID { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |