Building Roof¶
Insight Pack¶
Disclaimer
Overview¶
The Building Roof Insight Pack is a national digital dataset representing building roof information for each State and Territory in Australia. Roof information such as the roof colour, roof shape and roof slope, as well as the primary roof material are provided. A tree overhang flag is also provided to describe where a tree overhangs the building’s roof.
Geoscape Australia welcomes your feedback on our Building Roof Insight Pack. We also publish regular updates on the development of our products on the Geoscape website ( www.geoscape.com.au ).
Technical Description¶
Linkages¶
The Building Roof Insight Pack references buildings with roof information associated. A building in the Buildings product with null values for roof information will not be represented in the Building Roof Insight Pack.
The building_pid attribute can be used to link the Building Roof Insight Pack building_roof table to the Buildings product buildings table. This is a 1:1 relationship - a building_roof record will link to only one buildings record.
Data format¶
The Building Roof Insight Pack is provided in the Pipe-Separated Values (PSV) file format and is an aspatial file.
Data Model¶
![digraph G {
fontname="ROBOTO" fontsize="10pt"
node [fontname="ROBOTO" fontsize="8pt"]
edge [fontname="ROBOTO" fontsize="8pt"]
building_roof [shape=plain
label=<<TABLE BGCOLOR="#FFD966"
BORDER="1"
CELLBORDER="0"
style="rounded"
CELLSPACING="0"
CELLPADDING="5">
<TR>
<TD COLSPAN="2">building_roof</TD>
</TR>
<TR>
<TD BGCOLOR="white" >PK</TD>
<TD BGCOLOR="white" ALIGN="LEFT" >building_pid: varchar (15) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >date_created: date </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >date_modified: date </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >roof_colour: varchar (7) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >roof_shape: varchar (7) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >primary_roof_material: varchar (20) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >roof_slope: number (4,2) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >tree_overhang: varchar (3) </TD>
</TR>
<TR>
<TD BGCOLOR="white" ></TD>
<TD BGCOLOR="white" ALIGN="LEFT" >state: varchar (3) </TD>
</TR>
</TABLE>>];
}](_images/graphviz-fcfcf4e7bcc096161e1951ae7050e5169289b23d.png)
Data Dictionary¶
This data dictionary is applicable for the building_roof insights pack.
Attribute |
Data Type |
Description |
Primary Key |
Mandatory |
10 Character Alias |
|---|---|---|---|---|---|
building_pid |
character string (15) |
Persistent identifier for the building. |
Yes |
Yes |
BLD_PID |
date_created |
date (yyyy-mm-dd) |
The date of record creation for the building_roof record. |
No |
Yes |
DT_CREATE |
date_modified |
date (yyyy-mm-dd) |
The most recent date that an attribute has been modified for the building_roof record. |
No |
No |
DT_MOD |
roof_colour |
character string (7) |
The measured Red/Green/Blue (RGB) colour value in hexadecimal format (#rrggbb) for the primary_roof_material of the building. |
No |
No |
ROOF_CLR |
roof_shape |
character string (7) |
The shape of the aerial building’s roof (e.g. ‘Hipped’, ‘Gabled’, ‘Flat’ etc.) in line with the CityGML standard. |
No |
No |
ROOF_SHAPE |
primary_roof_material |
character string (20) |
The material that the roof is primarily made from. |
No |
No |
PR_RF_MAT |
roof_slope |
number (4,2) |
Maximum angle of slope in degrees of the building roof structure, rounded to standardised class values. |
No |
No |
ROOF_SLOPE |
tree_overhang |
character string (3) |
Provides an attribute that describes whether an identified tree overhangs the aerial building geometry. A ‘Yes’ value is used where a tree overhangs the building and a ‘No’ value is used where there is no tree overhanging the building. |
No |
No |
TREE_OVERH |
state |
character string (3) |
The abbreviated name of the State or Territory that the building is primarily within. |
No |
Yes |
STATE |
Thematic Quality¶
Thematic accuracy is defined as the accuracy of quantitative attributes, the correctness of non-quantitative attributes, and of the classification of features and their relationships. Data captured from aerial imagery represent the highest level of detail and quality within the dataset, while data captured from satellite imagery supports broad coverage and consistent identification.
Classification Correctness¶
Classification correctness is an assessment of the reliability of values assigned to features in the dataset in relation to their true ‘real world’ values.
The rate of classification correctness of the primary_roof_material attribute has been measured in excess of 90% across suburban residential areas. Commercial, industrial, and higher density residential areas are known to have lower classification correctness of the roof material.
Characteristics of a building that can impact the roof_shape classification correctness of the roof shape include but are not limited to:
Roof furniture e.g. plant rooms, steeples, aerials.
Buildings that have a larger footprint than roof area.
Multiple buildings represented as a single building due to proximity.
The height of the building.
Overhanging trees.
The rate of classification correctness of the roof_shape has been measured at above 90% on unobstructed buildings.
Frequency and Currency¶
The Building Roof Insight Pack is released on a quarterly schedule for the months of March, June, September and December.
More Information¶
For more information on the Building Roof Insight Pack please contact Geoscape Australia Support.