Skip to main content

How do I generate and use insolation maps for solar analysis?

Create detailed solar radiation maps on roof planes to analyse panel placement and shadow effects for optimal solar installations.

Updated this week

Menu path

Solar > Generate Insolation Map


🧾 What it does

The Generate Insolation Map function creates a detailed map of solar radiation that hits roof planes based on the orientation of each plane to the sun for specified days and times. The software divides the roof into 'pixels' and displays colours indicating the relative intensity of radiation at each pixel.

This image shows an Insolation Map on a model 3D model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Any roof fixtures (chimneys, roof penetrations, adjacent buildings) are included in the calculation. You can add a North Arrow marker (Solar > North Marker) to indicate true north, and the software automatically rotates the 3D model for accurate calculations.

🔧 How to generate an insolation map

  1. Select Solar > Generate Insolation Map to open the Insolation Calculation Options dialog

  2. Select your location from the list or define a new location using the ellipsis button

  3. Plan your analysis - choose whether you want the same time across multiple days, the same day each month, or a series of hours in a single day

  4. Set your date sequence (e.g., June 21 or December 21 for solstice analysis)

  5. Define the Pixel Size - larger pixels process faster, smaller pixels provide more detail

  6. Choose your Palette type (colour intensity or Shadow/Grey for shadow analysis only)

  7. Select Calculate and choose the planes to analyse

  8. The software processes each time slice and displays results with a legend

This image shows Areas where a shadow is cast in a Model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

🧾 Insolation calculation settings

Field

Description

Location

Select from pre-defined locations or create custom location with latitude, longitude, and UTC time difference

Date Sequence

Choose specific days, months, or time ranges for analysis

Pixel Size

Size of square areas on roof plane representing radiation intensity - larger pixels process faster

Palette Type

Colour display options - intensity colours or Shadow (Grey) for shadow-only analysis

Legend Orientation

Horizontal (default) or Vertical legend placement

This image shows the Insolation Calculation Options menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


🛠 Location management

Location data is stored in locations.csv in the Roof Wizard\User folder and can be edited in Microsoft Excel. The software includes default NREL measurement locations with USAF reference codes.

This image shows the Select/Modify Location Menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Coordinate system:

  • Longitude: Eastings are positive, Westings are negative

  • Latitude: Northings are positive, Southings are negative

  • Time: East of UTC is positive, west of UTC is negative

This image shows the Insolation Calculation Options menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Once this is decided, set your sequence up to give the required results. Typically, you select your date first. For example, if you are preparing a sequence for a particular day, say from sunrise to sunset during the shortest or longest day (June 21 and December 21 respectively).

Next define the Pixel Size. This is the size of the square area on the roof plane that will represent the radiation intensity. Big pixels are best to start with as they process quicker. Once you have all the settings as you want them and the result is as you require, then perhaps use a smaller pixel size and rerun the job.

The Palette type allows you to define the colours for the legend for the squares that represents the radiation. Use the Shadow (Grey) palette option if you’re only interested in shadows instead of radiation intensity.

Some preparation ahead of time, setting up the model is assumed at this point. It is assumed that you have added the roof fixtures (panels, AC Units, plumbing vents etc) and perhaps a site base and whatever trees and surrounding structures that are part of the study and that will impact on your calculation. Note that such fixtures must be comprised of plane entities and lines – no curves or ruled surfaces as these do not cast a shadow or block the sun.

This image shows the a grey scale model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Selecting GrayScale for the palette colour displays the relative insolation levels in gray tones.

This image shows the Insolation Calculation Options menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

This image shows the a grey scale model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


🛠 Analysing solar panel yield

To calculate insolation on solar panel arrays:

  1. Place the Fixture sub-figure representing the array on your preferred roof location

  2. Unpack the fixture so it's included in calculations

  3. Select the panel surfaces for insolation calculation

  4. Compare multiple locations to determine optimal panel placement

The default layout of the legend for the Insolation map is horizontal. By checking the Vertical Legend box, it will be inserted vertically as shown below:

This image shows the Insolation Calculation Options menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>
This image shows an Insolation Map on a model 3D model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Vertical Legend

This image shows an Insolation Map on a model 3D model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Horizontal Legend


🔧 Managing plane IDs for grouped analysis

Each panel plane gets a unique ID number during calculation. To group panels for array-level reporting:

  1. Select Solar > Insert Plane ID's

  2. Enter the group ID number in the dialog

  3. Select each panel plane to assign the group ID

  4. Repeat for additional arrays under investigation

The output spreadsheet is saved as <database name>-INSOLATION-INSOLCALC.csv in the User folder.

Select the Calculate button, and the operator is prompted to select the planes to calculate the insolation for. This is useful if you have a very large job and only need to calculate the radiation on a small area, or you wish to calculate the radiation just on one or two planes or indeed, individual items such as a panel array.

The software divides the selected planes into squares according to the defined pixel size; takes the data from the file; accounts for the azimuth of the selected planes and calculates the insolation for each pixel and exports it to a csv file called INSOLATION.csv.

This image shows the Text menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

As the software proceeds, the prompt area displays the time slice, date and sun position (altitude and azimuth) as each is processed. Depending on the size of the job and the size of the pixels, tis can be very quick or quite slow. You will also notice an arrow is displayed at the origin of the job indicating the position of the sun in the ‘sky’.

The resultant data can be used by the operator to export to external systems for other engineering or accounting tasks to determine the return of investment of a proposed installation.


Solar Yield for your Solar Panels

If you wish to calculate the insolation on just your solar panel array (similar to what is shown below), you place the Fixture sub-figure that represents the array onto the preferred location on your roof. Then you must unpack it so that it is accounted for in the calculation. Fixtures and fittings may be added for annotation of the model only – these are not unpacked.

This image shows the Solar yield on Solar Panels in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Once unpacked, select the panel surfaces and these will have the insolation calculated for them.

Typically, several locations may be explored to determine the best location for the panels for the best average annual radiation result. Indeed, groups of panels may be located and checked.

This image shows the Solar yield on Solar Panels in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


Plane ID’s

On initial placement of the fixture plane representing the solar panel, each plane is allocated a unique ID number and then when the insolation calculation is done the value is attached to that plane. That would give you the average annual insolation for each plane (which in this case would be a single panel). However, usually we need the sum of the whole array, so we have a tool that groups panels and gives them a single group ID number.

This provides the ability to report the array as a single unit.

To apply the group ID, select Solar > Insert Plane ID’s and the following dialog box is displayed prompting for the ID number to use for the group.

This image shows the Plane ID number menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

The current ID numbers are displayed.

This image shows the Solar yield on Solar Panels with the plane id shown in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Select the plane on each panel and it will change to the defined group ID.

This image shows the Solar yield on Solar Panels with the plane id shown in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Do this for the rest of the arrays under investigation and then you are ready to generate our insolation map and create the output spreadsheet.
The output spreadsheet file is given the name <database name>-INSOLATION-INSOLCALC.csv
and may be reviewed in Microsoft Excel.

This image shows the Solar yield on Solar Panels with the plane id shown in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

This image shows the insolation CSV file in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

With this data sitting in the …\User folder, you can now annotate the model with Group information. Select Solar > Add-GroupInfo and the following dialog box will be displayed. It provides a powerful tool to modify the appearance of the group box.

This image shows the Group information display menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


🛠 Group information display

Add descriptive information to panel groups using Solar > Add-GroupInfo:

  1. Select information to display by checking available options

  2. Edit the text in the scroll box for custom descriptions

  3. Settings are saved as GroupDisplay.dat in the User folder

  4. Select the group to annotate, position the annotation box, and draw the leader line


🧾 Insolation table options

Data Source

Description

NREL TMY3

Pre-defined data set in TMY3_Data folder, specify column for Direct Normal (DNI) or Diffuse Horizontal (DHI) data

Custom Table

User-created CSV file covering every hour, day, and month with kWh/sqM values from reliable sources

AppliCad Default

Select custom insolation table files you've created

Depending on the information selected by checking the available information, the key text string is displayed on the scroll box. You may edit the scroll box to add more descriptive detail – for example ###Group is the key text string placed by the software. Group No. is placed in the box by the operator by clicking in the box and simply typing the required text.

Once defined, this is remembered and saved as a file in the …\User folder as GroupDisplay.dat and may be edited in Notepad.

To apply the information to the roof model, select OK. You will be prompted to select the group to annotate; then prompted to locate the centre of the annotation box; then the start and the end of the leader line.

This image shows the Group Information Display in AppliCad Roof Wizard Https;//<a href="http://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">www.applicad.com</a>

A close up of the Group annotation box may look like this. On the whole job it will look like the image below:

This image shows en example of Group annotation boxes on a model in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

This provides the necessary information to show the client why one location better suits for the placement of the panels. If printed in colour, it also gives a guide to the different levels of insolation around the roof according to the legend.


🔧 Map display controls

Function

Purpose

Show/Hide Insolation Map

Toggle map visibility without deleting it

Show/Hide Pixel Edges

Toggle pixel edge display for enhanced appearance

Insert Legend

Add legend if missed during initial generation or after deletion

Rotate Model Back

Return model to original orientation after insolation analysis

Delete Insolation Map

Permanently remove map and legend from model


Insolation Table Options

The operator may use the pre-defined NREL TMY3 data set saved in the TMY3 folder under the folder C:\AppliCad\Roof Wizard\User\TMY3_Data or define their own insolation data table.

If you use the TMY3 data table, you must tell the software which column of data is to be used and whether that data is Direct Normal (DNI) or Diffuse Horizontal (DHI) type data (typically column 8 is DNI and column 11 is DHI). When the NREL TMY3 Table Format is selected as the source, the insolation table used is determined by the file name corresponding to the USAF reference code for the selected location – for example, Beaufort SC is 722085TY.csv. Please refer to the NREL document in the TMY3_Data folder for a detailed explanation of their data set.

The Insolation Table may also be a file that is created by the user, typically using Microsoft Excel or a text editor and saved as a text file in csv (comma separated values file) format. It must be in the form as shown below and would typically cover the range for every hour, day and month. Once created, the values are those values extracted from reliable sources that provide you with the details of the area in question. Multiple files can be created for each region that you require the insolation maps for – for example, InsolationTable-SantaClara.csv. An example is supplied and can be found in the ..\User folder.

This image shows the Insolation Table Options in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Example of InsolationTable.csv

The value used is the value typically measured and the units are kWh/sqM. The measured value in the table is multiplied by the index value calculated by the software, based on the angle to the sun for any pixel on the roof at that time.

Once defined it can be selected by selecting AppliCad Default Format and the particular file you have defined.

This image shows the Insolation Calculation Options menu in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


Show/Hide Insolation Map

The Insolation Map may be turned off or on, using the Show/Hide Insolation Map option. The pixel edges may also be turned on or off using the Show/Hide Pixel Edges. It does not delete the map, it simply hides it.

Insert Legend
Allows the operator to insert a legend if that step was missed or not selected when prompted, or to reinsert a legend after deletion. The legend is inserted with the current default settings, so if you need a horizontal legend and the vertical legend was set, then delete the legend and change the default settings and reinsert using this option.


Rotate Model Back

The function allows the operator to rotate the model and the legend back to the orientation it was before the insolation map or grid was inserted if this step was missed.

Show/Hide Pixel Edges
Turns the insolation map and shadow map edges on or off. It does not delete them. Turning them off can enhance the appearance of the map.


Delete Insolation Map

Deletes the map and the legend from the model.


💡 Tips for effective analysis

  • Start with larger pixel sizes for faster processing, then refine with smaller pixels

  • Use Shadow (Grey) palette when focusing solely on shadow analysis

  • Compare solstice dates (June 21 and December 21) for seasonal variation analysis

  • Include all roof fixtures and surrounding structures that affect shading

  • Use vertical legends for narrow layouts, horizontal for wide layouts

⚠️ Important notes

  • Daylight saving adjustments are not automatically applied

  • Fixtures must be comprised of plane entities and lines - curves don't cast shadows

  • Fixtures for annotation only should not be unpacked

  • Processing time varies based on job size and pixel size selection


Did this answer your question?