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.
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
Select Solar > Generate Insolation Map to open the Insolation Calculation Options dialog
Select your location from the list or define a new location using the ellipsis button
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
Set your date sequence (e.g., June 21 or December 21 for solstice analysis)
Define the Pixel Size - larger pixels process faster, smaller pixels provide more detail
Choose your Palette type (colour intensity or Shadow/Grey for shadow analysis only)
Select Calculate and choose the planes to analyse
The software processes each time slice and displays results with a legend
🧾 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 |
🛠 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.
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
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.
Selecting GrayScale for the palette colour displays the relative insolation levels in gray tones.
🛠 Analysing solar panel yield
To calculate insolation on solar panel arrays:
Place the Fixture sub-figure representing the array on your preferred roof location
Unpack the fixture so it's included in calculations
Select the panel surfaces for insolation calculation
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:
Vertical Legend
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:
Select Solar > Insert Plane ID's
Enter the group ID number in the dialog
Select each panel plane to assign the group ID
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.
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.
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.
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.
The current ID numbers are displayed.
Select the plane on each panel and it will change to the defined group ID.
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.
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.
🛠 Group information display
Add descriptive information to panel groups using Solar > Add-GroupInfo:
Select information to display by checking available options
Edit the text in the scroll box for custom descriptions
Settings are saved as GroupDisplay.dat in the User folder
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.
A close up of the Group annotation box may look like this. On the whole job it will look like the image below:
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.
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.
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



























