Class Layout

Represents a layout of modules that could be connected to one inverter input

Namespace: SolarFarmerApi.Client
Syntax
public class Layout

Properties

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

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