Professional Documents
Culture Documents
Helioscope User Manual
Helioscope User Manual
Helioscope User Manual
Contact:
Email: support@folsomlabs.com
Web: www.helioscope.com
Rev-201610
Disclaimer
HelioScope software by Folsom Labs, Inc. is provided for informational purposes only. Folsom Labs makes no warrants as to the
accuracy or validity of any calculations, results, or implications of the HelioScope Software. To the maximum amount permitted by
law, Folsom Labs excludes any liability for any direct, indirect, or consequential loss or damage incurred by any user in connection
with our site or in connection with the use, inability to use, or results of the use of our site, any websites linked to it and any materials
posted on it. Folsom Labs does not guarantee the results of the software, which depend to a large extent on the parameters entered
by the user. The validity of the content of meteorological databases and the validity of components databases cannot be guaranteed.
Contact Information
Telephone:
(415) 729-4050
Email:
support@folsomlabs.com
Web:
www.helioscope.com
www.folsomlabs.com
Contents
1.0 Glossary and Requirements ........................................................................................................ 4
2.0 Quick-Start Guide ......................................................................................................................... 5
3.0 Project............................................................................................................................................ 8
3.1 Project List ........................................................................................................................................... 8
3.2 Create Project ...................................................................................................................................... 9
4.0 Design .......................................................................................................................................... 10
4.1 Mechanical Layout ............................................................................................................................. 11
4.2 Electrical Design ................................................................................................................................ 17
4.3 Managing Multiple Field Segments and Wiring Zones ................................................................... 21
4.4 Keepouts and Shade Objects ........................................................................................................... 22
4.5 Shade Optimization ........................................................................................................................... 23
Overlays ......................................................................................................................................................... 24
4.6 Design Outputs .................................................................................................................................. 25
5.0 Condition Set............................................................................................................................... 26
6.0 Reports ........................................................................................................................................ 29
6.1 Production Report ............................................................................................................................. 30
7.0 Project Sharing ........................................................................................................................... 33
8.0 Libraries ....................................................................................................................................... 34
8.1 Module and Inverter Libraries ........................................................................................................... 34
8.2 Wiring Library ..................................................................................................................................... 35
8.3 Meteo Library ..................................................................................................................................... 35
8.4 Component Detail .............................................................................................................................. 36
8.5 PAN File Uploader .............................................................................................................................. 37
8.6 Characterization Preview & Editing.................................................................................................. 37
9.0 Appendix ...................................................................................................................................... 38
www.folsomlabs.com
1.0
Term
Project
Design
Field
Segment
Keepout
Wiring
Zone
Condition
Set
Simulation
Report
Definition
A Project represents a specific location where an array (or set of arrays) will be designed
and installed.
The Project is the highest-level structure in HelioScope; all Designs and Condition Sets are
created under a Project.
A Design describes the physical layout of a solar array.
A Design includes the modules used, the quantity and location of the modules, and how the
modules are oriented. It also includes the electrical stringing design, the conductors used,
the inverters used, and the location of the inverters.
A Field Segment is an area of the design used to define module layouts.
A user defines a shape, which is populated with modules based on a set of layout rules.
A Design can contain multiple Field Segments.
A Keepout is an area of the design used to define shading objects and keepout zones
where modules cannot be placed.
A user defines a shape, which can be given a height and a setback.
A Design can contain multiple keepouts.
A Wiring Zone defines the electrical rules for the modules that have been laid out in the
Field Segment.
A Wiring zone consists of one or more Field Segments, an inverter SKU and quantity, and a
set of rules for how to connect the modules electrically (including the string size, conductor
size, and combiner box size).
A Design can contain multiple Wiring Zones, but a single Field Segment may not be split
across multiple Wiring Zones.
A Condition Set describes the environment around the solar array.
A Condition Set includes a weather file, shading assumptions, soiling assumptions,
temperature assumptions, and other potential loss factors and simulation settings.
A Simulation is an estimate for how much energy a Design will produce over a full year,
based on the environment defined in the Condition Set.
Simulations are based on hourly time intervals (8,760 per year).
The results of each Simulation can be viewed as a report, which summarizes the production
of the corresponding Design under the given Conditions.
Reports will also show the calculation of system losses at each step in the process.
System Requirements
HelioScope is a web-based product that can be accessed from any standard modern browser.
Recommended browsers include Chrome and Firefox. Safari, Edge, and Internet Explorer 10 are also
supported but not recommended. Internet Explorer 8 (or earlier) is not supported.
www.folsomlabs.com
2.0
Quick-Start Guide
The three major steps for creating your first project in HelioScope:
1) Create Project
2a) Create Design (Mechanical)
2b) Create Design (Electrical)
3) Run Simulation and View Report
1: Create Project
www.folsomlabs.com
2: Create
Design
(Mechanical
and Electrical)
(optional)
Edit
Condition Set
3: Run
Simulation &
View Report
www.folsomlabs.com
Define system
wiring rules
3: Run Simulation
www.folsomlabs.com
3.0
Project
A Project represents a specific location where an array (or arrays) will be designed and installed. The Project
is the highest-level structure in HelioScope; all Designs and Condition Sets are created under a Project.
3.1
Project List
The HelioScope home page shows a project list and a link to create a new project.
A. Project list, in order
of last modified
project
B. Starred projects are
at the top of the list
C. The number of
Designs, Reports,
and users for each
Project
D. Archive or Unarchive
a project
E. Create a new project
www.folsomlabs.com
3.2
Create Project
www.folsomlabs.com
4.0
Design
A Design contains the physical layout of a solar array, including the detailed module layout, orientation, roof
shape, and surrounding obstructions. It also includes the electrical design, including wires and inverters.
Click on the blue New button to
create a new Design.
A Project can have multiple Designs.
Often these multiple designs are used
to compare design alternatives. Use
cloning to create multiple Designs for
detailed engineering analysis and
comparison (e.g. ground coverage
ratio, tilt, conductor size, etc.).
www.folsomlabs.com
10
4.1
Mechanical Layout
A Mechanical Layout is based on Field Segments that define areas to be filled with modules, and Keepouts
which define areas to be excluded.
Generating a Field Segment
1) Click points on the map to define
the corners of a new Field
Segment
2) Define module layout & racking
assumptions
3) If desired, set the maximum
system size for the field segment
4) Every line segment has a grey
circle at its midpoint that can
create a new point when dragged
5) Right-click a point on a Field
Segment to delete that point
Setting Azimuth
The Azimuth defines the orientation of the modules
(following a compass, where 90 is east, 180 is
south, and 270 is west. Right-click the edge of a
Field Segment to automatically set the module
orientation to face that edge of the building.
www.folsomlabs.com
11
Spacing Metrics
There are several ways to define the
spacing between modules:
A. Row Spacing is the edge-toedge spacing between rows (in
the N/S direction).
B. Module Spacing is the distance
between modules on every side
of each module, and is generally
used to define the spacing
needed for module clips or similar
items
www.folsomlabs.com
12
D
E
Alignment:
Modules in the Field Segments can be aligned to the left, aligned to the right, staggered, or justified.
Left Align
www.folsomlabs.com
Staggered
Justified
13
Right Align
www.folsomlabs.com
14
3D View
HelioScope gives users the option of viewing
their designs in 3D mode. With the 3D button
selected, hold down shift and click and drag to
rotate the design.
www.folsomlabs.com
15
Description
Racking type
Indicates whether modules are mounted in fixed-tilt racking on a flat plane, or are
mounted flush to a roof in the same plane. This affects the row-to-row shading (zero for
flush-mount), and the thermal coefficients (thermal losses will be higher in flush-mount).
The height of the field segment, from ground to the rooftop (or to the lowest edge for
flush-mount systems)
The orientation angle of the modules, following a compass: 90 degrees is East, 180
degrees is South, and 270 is to the west
The angle of inclination of the modules. Zero is flat.
The direction that the modules are mounted in the racking, either vertical (portrait),
horizontal (landscape), or dual tilt (east/west).
The number of modules in each frame, including the vertical (up) and horizontal (wide)
size
The distance from the back of one bank of modules to the front of the next bank
The distance between adjacent modules in the same frame
When not in dual tilt, this affects the distance from the side of one bank of modules to the
side of the adjacent bank
The area around the perimeter of the Field Segment or Keepout that is off-limits to
modules
Depending on the selected mode, modules will align themselves within the field segment
differently either to the left, centered, justified, or to the right
Height
Azimuth
Tilt
Orientation
Frame Size
Row Spacing
Module Spacing
Frame Spacing
Setback
Alignment
www.folsomlabs.com
16
4.2
Electrical Design
An Electrical Design completes the Mechanical Layout by generating stringing and connecting inverters to the
wiring zones. Select the Electrical icon for the electrical layout:
1) Choose the inverter (the
quantity will automatically
update based on a target
DC/AC ratio)
2) Combiners can be sized
using the Combiner
Poles field, which controls
the maximum number of
1
inputs available per
combiner. These can also
5
6
be removed by clicking x
remove at the bottom of
2
the section in the designer.
3) Set the string size
3
automatically based on the
4
ASHRAE temperature
data, or manually size it
according to your project specifications.
3
4) (optional) When designing with SolarEdge inverters, you must select an
optimizer to complete the electrical design
5) Inverters and combiner boxes can be moved on the map, and the wires
will be re-routed appropriately
6) Percentage values next to the
conductors show their total voltage drop
based on the arrays STC voltage and
current, and the wire quantity and
resistance.
www.folsomlabs.com
17
www.folsomlabs.com
18
www.folsomlabs.com
19
Description
Trunk (optional)
The conductor size between the re-combiner box and the inverter. If no recombiner has been configured, this is not used.
The conductor size between each combiner box and the inverter or recombiner
The target maximum number of strings connected to each combiner box.
The range of string sizes the design will accept for stringing. Note that if a range
of string sizes is allowed, then HelioScope will use mismatched strings to connect
all modules in the array.
The user can choose whether they would like stringing set to go up and down or
along the racking for the project
The size of the conductor for the source circuits from the modules to the combiner
or inverter
www.folsomlabs.com
20
4.3
If the Design has multiple Field Segments, they can either be wired in one Wiring Zone or multiple Wiring
Zones. Click the << wiring zones link at the top of the Electrical control.
With one Wiring Zone selected, all modules in the Field Segments will be assigned to strings as one group,
and connected to the inverter(s). In this case, modules will be assigned to strings in the order that the Field
Segments are listed.
When Field Segments are assigned to separate Wiring Zones, each electrical Wiring Zone is independent.
Field
Segment 3
Field
Segment 4
Field
Segment 1
Field
Segment 2
www.folsomlabs.com
21
4.4
Keepouts can be used to define both areas where modules should not be placed, and objects near an array
that will cast shade on the modules.
1) Draw Keepout shapes on the map. Each Keepout can have a setback distance for mechanical
clearance, and a height associated with it to model the shade patterns.
2) Copy a Keepout by switching to Edit mode, clicking the Keepout to select it, then holding the Alt key
while dragging it.
3) Define time range for generating shade patterns Keepouts. The default behavior will remove modules
that are shaded at this day and time.
4) (optional) Check or uncheck the Keepout from Shade box to remove or place modules in shaded
areas during the time range you have set (typically a precursor to the Shade Optimization in section
4.5).
3
4
www.folsomlabs.com
22
4.5
Shade Optimization
3) Select Show Monthly Values to see the shade losses each month.
www.folsomlabs.com
23
Overlays
In addition to imagery from Google Maps and Bing Maps, user can also upload overlays to HelioScope. Often
this is enhanced imagery or site layouts for a building that has not yet been built. By turning their imagery into
a KMZ or KML file, users can upload any image to HelioScope to use as the background of their design. The
HelioScope SketchUp plugin can also be used to upload imagery.
www.folsomlabs.com
24
4.6
Design Outputs
From the Project Overview, click the blue name of a Design to view the details:
A. Design name
and size
B. Bill of
B
Materials
C. Field Segment
D. Wiring Zones
A
E. Detailed
Layout
C
F. Configurable
list of Design
details to be
D
shown in
image
F
E
Designs within a project have a number of exports that users can download:
A. AutoCAD A CAD diagram of the mechanical design (.dxf format)
B. Single-line Diagram The Single Line Diagram of the electrical design (.dxf format)
C. Layout Image A detailed image of the project
www.folsomlabs.com
25
5.0
Condition Set
A Condition Set describes the environment around the solar array, such as weather conditions and soiling
losses. All Projects will have a default Condition Set when first created, though this can be edited (or a
second Condition Set created).
Weather
A. Nearby weather stations are
shown on the map in the
area the project was created
B. Weather stations are sorted
by distance from the Project.
The source and class of
each file is shown in
parenthesis. The class of the
weather file can be selected
in some cases when more
than just a single data
source is available for that
location / source type.
C. Select the desired weather
file using the radio buttons
B
C
Shading
If a project has shading that
the user would prefer to model
with external shading systems,
they can choose a SketchUp
shade profile and/or horizon
profile rather than use the
integrated shading in
HelioScope. For SketchUp
shade profiles to be used, they
must first have been loaded
accorded to the process
contained in our SketchUp
integration manual:
http://www.folsomlabs.com/content/resources/sketchup-manual.pdf
www.folsomlabs.com
26
Mismatch
Module mismatch can be viewed and
modified using three statistical
mismatch parameters:
A. Difference in plane-of-array
irradiance (normally distributed)
B. Module temperature differences
(uniform distribution)
C. Module manufacturing
tolerance (uniform distribution).
This has two inputs to account
for positive-tolerance module
binning.
www.folsomlabs.com
A
B
27
Advanced
A. The user can choose the
transposition model (the
mathematics used to convert
diffuse light to POA
irradiance).
B. Solar Angle Source will let the
user choose the location for
calculating solar angles (either
the location of the weather file,
or the project location).
C. Spectral adjustment is an
adjustment to GHI irradiance
for CdTe modules.
AC System Losses
If a full AC system is not desired, a
constant derate factor can be applied
to account for AC system losses. This
value will only be defined if you do not
define an AC subsystem.
www.folsomlabs.com
28
6.0
Reports
The reports tab shows the full set of Designs and Condition sets that have been created for a Project. Each
combination of a Design and Condition Set can be simulated to create a Report.
A. Click on the orange Simulate button to trigger a simulation. The mechanical and electrical design
must have been completed to allow a simulation.
B. The blue progress bar shows the status of active simulations, and how far they are away from
completion
C. Completed Reports are shown with a blue button. Click to view the detailed Report
D. The metric shown on the completed Reports can be set to kWh/kWp, Performance Ratio, or Energy
(total generation) for quick comparison between simulations.
C
A
www.folsomlabs.com
29
6.1
Production Report
E. Monthly production values appear in a chart. Clicking the Show table text at the bottom of the
Monthly Production section to show a table with the values (ideal for copy-pasting to a different
program)
F. The Sources of System Loss chart can be used for quick diagnosis of the largest loss factors in the
simulation
E
www.folsomlabs.com
30
I. Components shows a bill of materials including modules, wiring, combiners, and inverters
J. Wiring Zones list out the different wiring zones and their electrical design assumptions
K. Field Segments list out the different field segments and their mechanical design assumptions
I
www.folsomlabs.com
31
www.folsomlabs.com
32
7.0
Project Sharing
www.folsomlabs.com
33
8.0
Libraries
HelioScope includes four different library databases: Modules, Inverters/Optimizers, Wires, and Meteo Files.
Modules and inverters are organized hierarchically, with SKUs and
Characterizations. The SKU represents the product (e.g. a Trina PC14 280-watt
module). Each SKU can have multiple characterizations, which define the products
behavior. For a module, a PAN file is a characterization, so a single module SKU can
have multiple PAN files.
8.1
A.
B.
C.
D.
Access the module or inverter library from the library menu in the top right of the page
Specific products can be searched for by Manufacturer, Module Name, and Cell Technology
Click on any module or inverter to view its characteristics
PAN files for Modules can be privately uploaded if they are saved in a version of PVSyst 6.4 or later.
You can find the documentation to upload PAN files here:
https://www.dropbox.com/s/cimah8wdx0ahpq2/%20PAN%20file%20upload%20v0.1.pdf?dl=0
E. Click the orange star to favorite a device so it will show up automatically on the drop-down menu in
the Designer
D
B
C
B
C
www.folsomlabs.com
34
8.2
Wiring Library
In the Wiring Library, users can select between metric and AWG conductors, and whether to show Aluminum
wires or not.
8.3
Meteo Library
HelioScope provides a range of meteorological sources across the world. In particular, the program is
compatible with TMY3, TMY2, EPW, and Prospector weather files. Users can navigate through the map to
see where weather files are located from a physical view. If the weather files present in HelioScope are not
appropriate for an area, users can upload their own weather files within the Meteo Library. The process for
uploading these files is detailed here:
https://www.dropbox.com/s/3a31dsna8c3socp/%20weather%20file%20upload%20v0.1.pdf?dl=0
www.folsomlabs.com
35
8.4
Component Detail
www.folsomlabs.com
36
8.5
Use the PAN file uploader to import module characterizations from PVSyst v6.4 or later.
1) Click Select Files to browse and select PAN files. These can also be dragged into the browser
2) The characterizations are automatically matched to modules in the database if they already exist.
Suggestions for similar modules will appear, but new modules can be created as well
3) View drop down menu to choose or confirm the module used
4) If no match is found, a new module will be created
5) Click Preview to view and edit the characterization details
6) Users can upload files to add them to a personal database
8.6
www.folsomlabs.com
37
9.0
Appendix
Description
Production
Performance Ratio
Performance Ratio (PR) shows the percentage of total potential energy for the array
that is converted to AC energy.
Mathematically, the PR is defined as the AC power production, divided by the
product of plane-of-array (POA) irradiance times the system DC nameplate power.
The specific energy total simulation energy generation divided by the system DC
nameplate power.
kWh/kWp
Description
Annual Global
Horizontal Irradiance
POA Irradiance
The total irradiance that will fall on a flat plane at the location of the array. This is
aggregated directly from the weather file.
The total irradiance in the Plane of Array (POA), accounting for tilt and azimuth
angles. This is averaged across all modules in the array.
The total irradiance accounting for all shading (from horizon, row-to-row, and
obstruction)
The total irradiance after accounting for reflection off the surface of the module (also
known as the Incident Angle Modifier, or IAM reflection).
Irradiance after module soiling is accounted for. Note that soiling assumptions are
made in the Condition Set.
The total annual irradiance available to the modules in the array. This is averaged
across all modules.
The maximum potential power of the array, defined as the total collector irradiance
multiplied by the system nameplate power.
The total energy output by the modules, after accounting for low-light effects and
module IV curve distortions.
The total output of the modules, factoring in the temperature effects on the IV curves.
This is the sum of the modules at their maximum power points.
The total energy output of the modules, factoring in all system constraints (e.g. series
& parallel mismatch, voltage drop, etc.).
If DC optimizers are present, this shows the total output of the optimizers, factoring in
their efficiency curves and principles of operation.
The total energy output of the DC system, accounting for all wire resistive losses.
Shaded Irradiance
Irradiance after
Reflection
Irradiance after
Soiling
Total Collector
Irradiance
Nameplate
Output at Irradiance
Levels
Output at Cell
Temperature Derate
Output After
Mismatch
Optimizer Output
System DC Output
System AC Output
www.folsomlabs.com
The total AC energy output from the inverters, taking into account inverter
performance losses.
38