SIG3D Quality Wiki EN - User contributions [en]

File:201711 SIG3D Modeling Guide for 3D Objects Part 1.pdf

2018-04-09T20:00:12Z

Wikiadmin: Wikiadmin uploaded a new version of File:201711 SIG3D Modeling Guide for 3D Objects Part 1.pdf

Modeling

2018-04-09T19:59:54Z

Wikiadmin:

* <big>[[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)|Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]] ( Version 0.7.1 EN, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.org/file/ag-qualitaet/201711_SIG3D_Modeling_Guide_for_3D_Objects_Part_1.pdf]]</big>

* <big>[[Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3) |Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)]] ( Version 2.0.1 EN, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.org/file/ag-qualitaet/201711_SIG3D_Modeling_Guide_for_3D_Objects_Part_2.pdf]]</big>

<br>
Hinweis: <br> Sie finden die deutsche Version dieser Dokumente unter http://wiki.quality.sig3d.de

<br>

'''Archive''':
*Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML) ( Version 0.6.0, PDF, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.de/file/ag-qualitaet/20110531_Regeln_GML_final_EN.pdf]]

File:201711 SIG3D Modeling Guide for 3D Objects Part 2.pdf

2018-04-09T19:54:54Z

Wikiadmin:

File:201711 SIG3D Modeling Guide for 3D Objects Part 1.pdf

2018-04-09T19:54:01Z

Wikiadmin:

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2018-04-09T11:31:05Z

Wikiadmin:

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|
2.0.1 EN
|
November 2017
|
SIG 3D / Quality Working Group

EC, KHH
| style="background-color: #73ff73;" |
public
|
License changed to Creative Commons BY-NC-SA 4.0;
|-
|}

-----
{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:Buero-Werkshalle-01.png|450px]]
</td>
<td width="500px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|450px]]
</td>
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|450px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|450px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|450px]]

Variante 3
[[image:Variante-03-V2-red.png|450px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|350px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|350px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="400">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}
-----

Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)

2018-04-09T11:23:02Z

Wikiadmin:

__TOC__

== Document History ==

<table border="1" cellspacing="0">
<tr align="left" valign="top">
<th width="220">
Version
</th>
<th width="220">
Date
</th>
<th width="220">
Author/s
</th>
<th width="220">
Status
</th>
<th width="220">
Remarks
</th>
</tr>

<tr align="left" valign="top">
<td>
0.1.0
</td>
<td width="220">
01.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Erstfassung
</td>
</tr>
<tr align="left" valign="top">
<td>
0.2.0
</td>
<td width="220">
14.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Solid ergänzt
</td>
</tr>

<tr align="left" valign="top">
<td>
0.3.0
</td>
<td width="220">
23.10.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Verschmelzung mit Paper Gröger
</td>
</tr>

<tr align="left" valign="top">
<td>
0.4.0
</td>
<td width="220">
23.11.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Redaktionelle Änderungen und Ergänzungen zu Planarität von Polygonen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.5.0
</td>
<td width="220">
24.11.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Einarbeitung der Änderungen, die im CityGML-Forum von K.-H. Häfele vorgeschlagen wurden
</td>
</tr>

<tr align="left" valign="top" bgcolor="green">
<td>
0.6.0
</td>
<td width="220">
15.12.2010
</td>
<td>
Gröger
</td>
<td>
öffentlich
</td>
<td>
Einarbeitung der Anregungen von G. Juen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.7.0
</td>
<td width="220">
20.01.2012
</td>
<td>
Karl-Heinz Häfele
</td>
<td>
nicht öffentlich
</td>
<td>
Konvertierung in Html, Verschiebung des Kapitel Planarität von Polygonen, Neues Kapitel CompositeSolid
</td>
</tr>
<tr align="left" valign="top">
<td>
0.7.0 EN
</td>
<td width="220">
November 2013
</td>
<td>
Egbert Casper, Karl-Heinz Häfele
</td>
<td>
public
</td>
<td>
English Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.1 EN
</td>
<td width="220">
November 2014
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Derived PDF Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.2 EN
</td>
<td width="220">
November 2017
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Minor editorial changes and completions, License change to Creative Commons BY-NC-SA-4.0 </td>
</tr>

</table>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

== References ==
* Cox, S., Daisey, P., Lake, R., Portele, C., Whiteside, A. (2004): OpenGIS Geography Markup Language (GML) Implementation Specification. Version: 3.1.1, OGC 03-105r1,
* Herring J. (2001): The OpenGIS Abstract Specification, Topic 1: Feature Geometry (ISO 19107 Spatial Schema), Open Geospatial Consortium, OGC Document Number 01-101. OGC.
* Gröger, G., Kolbe, T., Czerwinski, A., and Nagel, C. (2008) (Eds.): OpenGIS City Geography Markup Language (CityGML) Encoding Standard, OGC reference number OGC 08-007r1 version 1.0.0, 2008
* Gröger, G., Plümer, L. (2011): How to Achieve Consistency for 3D City Models. Geoinformatica, 15(1):137-165, DOI: 10.1007/s10707-009-0091-6.

== Preliminaries ==
* The rules refer to GML Version 3.1.
* The rules are based on the validity of the data with regard to the XML-Schema of GML 3.1.
* The rules are restricted to the elements of GML that are used in CityGML (Profile of GML, c.f. Figure 1 and Figure 2).
* If a condition applies to CityGML only (not to GML in general), it is stated explicitly.

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-1.png|Profil von GML]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 1:''' Profile of GML that is used in CityGML (Primitives and Composites)
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-2.png|Profilvon]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 2:''' Profile of GML that is used in CityGML (Complexes and Aggregates)
</td>
</tr>
</table>

== <span id="Spatial-Reference-Systems">Spatial Reference Systems (SRS)</span> ==
* Each geometry element (including pos, posList and coordinates) must
** either have a srsName attribute with proper value, or
** inherit the value of the srsName attribute from
*** its parent geometries (even it its obtained recursively from the parents of the parents, etc.), or
*** the gml:Envelope (or gml:Box) which is the value of the gml:boundedBy property of the parent feature or the parent feature collection (even if it is obtained recursively).
* A local value of a srsName attribute precedes the inherited value of a srsName attribute.
* If in geometries (pos, posList) the dimension of a SRS can not be derived from the SRS without a doubt, the attribute srsDimension must contain the dimension of the SRS.

== Definitions ==

=== Geometric Tolerances ===

=== <span id="PlanarityOfPolygons">Planarity of Polygons</span> ===
„Surfaces in CityGML are represented by polygons, which define a planar geometry, i.e. the boundary and all interior points are required to be located in one single plane.” (Gröger et al., 2008). The boundary of a Polygon is defined by one or more planar Linear Rings (see gml:Polygon). From practical point of view, Linear Rings that are not exactly planar should be accepted as a valid as well.
Intuitively, a Linear Ring R would be defined as planar if there is a plane E with distance less than a given threshold  for all points Pi of R. However, this is true for Linear Rings with small bends and folds as shown in Figure 3 as well.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="50%">
[[image:Teil1-ABB6a.png|450px]]
</td>
<td width="50%">
[[image:Teil1-ABB6b.png|450px]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="2">
'''Figure 3:''' : Bends and folds should not appear in planar Linear Rings
</td>
</tr>
</table>

In order to avoid such situations, a slightly different definition of planarity of Linear Rings is introduced:

'''Definition 1:'''
A Linear Ring <math>R</math> is '''planar''', if it is a valid Linear Ring and the distance of all points to any plane <math>E_{ijk}</math>, that is defined by three co-linear points <math>P_i</math>, <math>P_j</math> and <math>P_k</math>, is less than a given threshold <math>\epsilon</math> :

<math>\forall E_{ijk} \forall P_a = dist (P_a,E_{ijk})\le \epsilon</math>



== <span id="posList">[http://www.schemacentral.com/sc/niem21/e-gml32_posList.html gml:posList]</span> ==
* The number of items in the list should correlate with the product of the SRS dimension (usually in CityGML 3) and the number of positions.

== <span id="Curve"><span id="LineString">[http://www.schemacentral.com/sc/niem21/e-gml32_Curve.html gml:_Curve], [http://www.schemacentral.com/sc/niem21/e-gml32_LineString.html gml:LineString]</span></span> ==
* Only gml:LineStrings are allowed as subtypes of _Curves (rule applies to CityGML only)
* A gml:LineString has linear interpolation.
* For the child elements of a gml:LineString (control points) the following statements must hold true:
** They form a sequence of "pos" (DirectPositionType) or "pointProperty" (PointPropertyType) elements. "pos" elements are control points that belong to this curve only. "pointProperty" elements contain points that may be referenced from other geometries or that reference other points (via XLinks) which are defined in other geometries.
** Alternatively, a gml:LineString can be composed of a "posList" element, providing a compact way of representing coordinates. In that case all control points must belong to the same Curve and must be given in the same SRS. The number of points (Direct Position) must be at least two.
* Each control point in a gml:LineString occurs only once, beside the first and the last one which may both be identical.
* Line segments of a gml:LineString are defined by pairs of two subsequent control points. Those line segments must not intersect mutually and must not have any identical points. Exceptions of that rule are the pairs which consist of an endpoint of one line segment and the start point of the next line segment in the sequence.

== <span id="LinearRing">[http://www.schemacentral.com/sc/niem21/e-gml32_LinearRing.html gml:LinearRing]</span> ==

The Linear Ring is the fundamental element to describe 3D geometry in CityGML. Every single polygon of a building geometry is defined by its boundary – the Linear Ring.

A sequence is an ordered list of elements. Unlike a set, order matters, and the exact same elements can appear multiple times at different positions in the sequence. A finite sequence <math>a</math> with <math>n+1</math> elements is denoted as <math>a=(a_0,a_1,...,a_n)</math>. The empty sequence <math>a=()</math> has no elements..

A finite sequence of points <math>R=(P_0,P_1,...,P_n),n\ge3,P_i=(x_i,y_i,z_i)</math> is a Linear Ring if:

(i) the first and last point <math>P_0</math> and <math>P_n</math> represent the same point: <math>P_0 =P_n </math> '''(closeness)'''

(ii) All points of the sequence besides start and end point are different:
<math>\underset{\underset {i \ne k}{\underset{k=0...n-1}{i=0...n-1}}}{\forall} P_i\ne P_k</math>

(iii) Two edges <math>(P_i , P_{i+1})</math> and <math>(P_k , P_{k+1})</math> <math>i = 0 ... (n-1), k= 0 ... (n-1), i \not= k</math> do only intersect in one start-/ endpoint. No other intersection is allowed (no self intersection).

If all points of the sequence are co-planar, the Linear Ring is planar.

'''Examples:'''

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3,P_0)</math>

with

<math>P_0 =(1,1,1)</math>

<math>P_1 =(3,1,1)</math>

<math>P_2 =(3,3,1)</math>

<math>P_3 =(1,3,1)</math>
</td>
<td width="33%">
<gml:LinearRing>

<gml:pos> 1 1 1 </gml:pos>

<gml:pos> 3 1 1 </gml:pos>

<gml:pos> 3 3 1 </gml:pos>

<gml:pos> 1 3 1 </gml:pos>

<gml:pos> 1 1 1 </gml:pos>

</gml:LinearRing>
</td>
<td>
[[image:Teil1-ABB3.png]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="3">
'''Figure 4:''' Planar Linear Ring: definition, GML and graphic representation
</td>
</tr>
</table>

'''Please note:'''
The two Linear Rings <math>R_1 = (P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2 = (P_0,P_3,P_2,P_1,P_0)</math> are not identical.

<table width="900px" border="0" cellspacing="0" cellpadding="5">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB4a.png]]</td>
<td width="33%">
[[image:Teil1-ABB4b.png]]</td>
<td>
[[image:Teil1-ABB4c.png]]
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_3,P_2,P_0)</math>
</td>
<td>
<math>R=(P_0,P_1,P_4,P_3,P_2,P_4,P_0)</math>
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
No Linear Ring: not closed (see (i) closeness)

</td>
<td width="33%">
No Linear Ring:self intersection (see (iii) self-intersection)

</td>
<td>
No Linear Ring: <math>P_4</math> appears twice in the sequence (see (ii), <math>P_4=(2,2,1)</math>)
</td>
</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 5:''' Examples of non-valid Linear Rings</td>
</tr>
</table>

<table width="600px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB5a.png|250px]]</td>
<td width="33%">
[[image:Teil1-ABB5b.png]]</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_4,P_3,P_0)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_2,P_0)</math>
</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
Linear Ring, but not planar <math>P_4=(2,4,0)</math></td>
<td width="33%">
No Linear Ring: all 3 points are co-linear; self-intersection (see (iii))
</td>

</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 6:''' Special cases: non-planar and co-linear Linear Ring Elements.</td>
</tr>
</table>

== <span id="Polygon">[http://www.schemacentral.com/sc/niem21/e-gml32_Polygon.html gml:Polygon]</span> ==
* A Polygon <math>S</math> is defined by a planar Linear Ring <math>R_s</math> (exterior ring).
* A polygon has exactly one exterior ring. In addition, a polygon can have <math>n\ge0</math> interior rings. These interior rings a planar Linear Rings as well. All interior rings and the exterior ring must be on the same plane (within the given tolerance).
* As interior rings define holes in the polygon, they have to be completely included in the area defined by the exterior ring.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-02-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 7:''' Polygon with <span style="color:#008000">correct interior ring (left)</span> and <span style="color:#FF0000">incorrect inner ring (right)</span> </td>
</tr>
</table>
* Interior rings must not overlap other Linear Rings or be included in another Linear Ring (except the exterior Linear Ring).
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-04-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 8:''' Polygon with <span style="color:#008000">two correct interior Rings (left)</span> and two interlaced, <span style="color:#FF0000">not correct interior Rings (right)</span> </td>
</tr>
</table>
* Interior rings and the exterior ring may touch each other in a finite number of points. The inner area of the polygon has to be connected.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-05-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 9:''' Polygon with <span style="color:#008000">correct, interior ring touching the outer ring at exactly one point (left)</span> and <span style="color:#FF0000">incorrect interior Ring touching the outer ring at two points and splitting the polygon (right) </span> </td>
</tr>
</table>
* • The order of points of the exterior ring defines the orientation of the polygon. The non co-linear points <math>P_i</math>, <math>P_j</math> und <math>P_k</math>define the plane <math>E(P_i,P_j,P_k)</math>. The normal vector <math>\vec n</math> is given by the cross product of the two vectors <math>\vec{P_iP_j}</math> and <math>\vec{P_jP_k}</math>:

<math>\vec n = \frac {\vec{P_iP_j}\times\vec{P_jP_k}}{\| {\vec{P_iP_j}\times\vec{P_jP_k}}\|}</math>

'''Please note:''' that due to the tolerance of planar Linear Rings, the normal vector can be ambiguous.

'''Remark:'''
The two Linear Rings <math>R_1=(P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2=(P_0,P_3,P_2,P_1,P_0)</math> define polygons with the same geometric extend but different orientation.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:Teil1-ABB7.png|300px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 10:''' Polygon with normal vector n</td>
</tr>
</table>

== <span id="OrientableSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_OrientableSurface.html gml:OrientableSurface]</span> ==
* If the value of the attribute “orientation” of an OrientableSurface is "+", the orientation of the OrientableSurface is identical to the one of the baseSurface. If the value of “orientation is " ", the normal of the OrientableSurface has a direction which is opposite to the normal of the baseSurface. The default value of “orientation” is "+".
* Either the element “baseSurface” references the base surface via a XLink attribute or the element “baseSurface” contains the base surface as child element. The base surface has positive orientation.

== <span id="MultiSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_MultiSurface.html gml:MultiSurface]</span> ==
A MultiSurface is an unstructured set <math>M=\lbrace S_1,S_2,...S_n\rbrace</math> of polygons. No further constraints are defined for a MultiSurface element. It is not necessary that <math>M</math> is a connected surface. Orientation of the polygons is arbitrary. By a MultiSurface any existing polygonal boundary representation of a rigid body can be described. Unfortunately, also objects that do not exist in real space can be modeled.

Due to the missing constraints it is recommended that MultiSurface elements should only be used to model non-volumetric parts of the building model as shown in Figure 11. Volumetric parts should be modeled as solids (see gml:Solid)

<table width="700px" border="0" cellspacing="0">

<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-Explode-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-Explode-01b.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td colspan="2">
'''Figure 11:''' Modeling overlapping roof parts ('''above:''' complete models, polygons outlined; '''below:''' roof polygons exploded)

'''Please note:''' the left model in Figure 11 is created with a MultiSurface element containing 7 polygons. However, the polygons do not represent a valid boundary of a rigid body. Calculating a volume is not possible. The right model is the same building geometry but modeled with 1 Solid element (7 polygons) and 1 MultiSurface element (2 polygons F6 and F8) as recommended (see CityGML Standard v1.0,p.61)

</td>
</tr>
</table>

== <span id="CompositeSurface"> [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html gml:CompositeSurface]</span>==

A set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons is a CompositeSurface for which

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and/or edges <math>e</math>that are part of both Linear Rings.
The polygon <math>S</math> is defined by the planar Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>.
The intersection of <math>S_i</math> and <math>S_k</math> equals<br>
<math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math> is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math> defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vectors of neighbouring polygons point to the same direction.
# The union of all polygons in <math>C</math> without the edges or points where the polygons touch, is isomorphic to a polygon.

It follows from (i) and (ii) that the surface defined by <math>C</math> , must not contain any overlapping or penetrating polygons, that is, polygons touch at most at points or edges.

== <span id="Solid"> [http://www.schemacentral.com/sc/niem21/e-gml32_Solid.html gml:Solid]</span>==

A solid geometry represents a rigid body. The surface of the solid is defined by a set of polygons with the following properties.
The set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons bounds a solid if:

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and edges <math>e</math> that are part of both Linear Rings. The polygon <math>S</math> is defined by the Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>. The intersection of <math>S_k</math> and <math>S_l</math> equals: <br><math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every Edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math>, is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math>, defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vector of each polygon points to the outside of the solid.
# All polygons in <math>C</math> are connected, that is the dual graph of <math>C</math> has a path containing all nodes. The dual graph G<sub>C</sub> =(V<sub>C</sub>, E<sub>C</sub>) of <math>C</math> consists of a set V<sub>C</sub> of nodes and a set E<sub>C</sub> of edges. Every node v of V<sub>C</sub> represents exactly one polygon of <math>C</math>. An edge shared by two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is represented by an edge <math>e=(v_{s_k},v_{s_l})</math> in E<sub>C</sub>.
# For every point <math>P</math> of a Linear Ring of a polygon of <math>C </math> applies: The graph <math>G_P =(V_P, E_P)</math>, that is only build by polygons and edges that touch<math>P</math> is connected. Each node <math>v</math> of <math>V_P</math> represents a polygon which Linear Ring contains <math>P</math>. Two nodes are connected by an edge <math>e</math> of <math>E_P</math> if the two polygons represented by the nodes have a common edge that touches <math>P</math>.

It follows from (i) and (ii) that the surface defined by <math>C</math> has no holes. Together with conditions (4) and (5) it follows that the inner of the solid defined by <math>C</math> is connected
<math>S</math> is denoted as closed [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html '''CompositeSurface'''].

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-01.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-02.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-03.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-04.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
correct: 6 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 11 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 10 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 30 surfaces, closed, correct surface orientation
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-05.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-06.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-07.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-08.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
incorrect: 5 surfaces, not closed, correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 6 surfaces, closed, incorrect surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, no closed (two outer hulls), correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, not closed (inner and outer hull), correct surface orientation
</td>
</tr>
</table>

== <span id="CompositeSolid">[http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSolid.html gml:CompositeSolid]</span>==
A CompositeSolid is represented by a nonempty set <math>C = \{S_1,..., S_n\}</math> of '''[[#Solid|Solids]]''' (see 10.) with the following properties:

# The intersection of the inner of two solids <math>S_i</math>, <math>S_j</math>, 1 ≤ i ≤ n, 1 ≤ j ≤ n, i ≠ j of <math>C</math> is empty, that is either both solids <math>S_i</math>, <math>S_j</math> are disjoint or both solids are connected only by surfaces, lines or points.
# Let <math>C'</math> be the union of all solids from <math>C</math>. Then the boundary of <math>C'</math> (the surface of <math>C'</math> without the surfaces or points where the solids touch each other) is the boundary of a solid.

In CityGML inner inclusions ( hollow spaces ) are not considered in CompositeSolids, as in solids.

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall01.png|300px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall02.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall03.png|240px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall04.png|260px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall05.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall06.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall07.png|280px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall08.png|180px]]
</td>

</tr>

<tr align="middle">

<td width="300px" valign="bottom">
not correct; line contact
</td>
<td width="300px" valign="bottom">
not correct; point contact
</td>
<td width="300px" valign="bottom">
not correct; no contact at all
</td>
<td width="300px" valign="bottom">
not correct; intersection
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall14.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14a.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14b.png|220px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
not correct; 26 boxes with surface contact
</td>
<td width="300px" valign="bottom">
but with internal hollow space
</td>
<td width="300px" valign="bottom">
not correct; interior boundaries
</td>

</tr>

</table>

== <span id="Triangle">[http://www.schemacentral.com/sc/niem21/e-gml32_Triangle.html gml:Triangle]</span> ==
* A Triangle is a special case of a polygon that is bounded by one outer Linear Ring with four points.
* There are no interior rings (no element "interior").

== <span id="TriangulatedSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_TriangulatedSurface.html gml:TriangulatedSurface]</span> ==
A triangulated surface is a [[#CompositeSurface|CompositeSurface]] that consists of triangles only, but is not closed (it may have boundaries). There is no restriction on how the triangulation is derived.

== <span id="TIN">[http://www.schemacentral.com/sc/niem21/e-gml32_Tin.html gml:Tin] </span>==
In contrast to a gml:TriangulatedSurface, the triangles of a gml:TIN are not represented explicitly, but by its three vertices (called control points). In addition, breaklines, stop lines and the maximal length of a side of a triangle can be represented in a gml:TIN.

# A TIN is a triangulated surface that is the result of the application of a Delaunay Algorithm or of a similar algorithm (extended by breaklines, stop lines and the maximal length of a side of a triangle). The surface satisfies the Delaunay criterion:
## For each triangle in the network, the circle passing through its vertices does not contain, in its interior, the vertex of any other triangle.
# Stoplines are lines where the local continuity or regularity of the surface is questionable. In the area of these pathologies, triangles intersecting a stopline shall be removed from the TIN surface, leaving holes in the surface. If triangles incident to the boundary of the surfaces are removed, the boundary of the surfaces changes.
# Breaklines are lines that are critical for the shape of the surface, representing local ridges, or depressions (such as drainage lines) in the surface. As such their constituent segments must be included in the TIN even if doing so violates the Delaunay criterion.
# Areas of the surface where the data is not sufficiently dense to assure reasonable calculations shall be removed by adding a retention criterion for triangles based on the length of their sides. For any triangle sides exceeding maximum length, the adjacent triangles to that triangle side shall be removed from the surface. # The number of control points is at least three.
# The surface is not affected by the order in which the control points are given. Application schemas may add information based on the ordering of the control points to facilitate the reconstruction of the TIN from the control points.

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)

2018-04-09T11:21:02Z

Wikiadmin:

__TOC__

== Document History ==

<table border="1" cellspacing="0">
<tr align="left" valign="top">
<th width="220">
Version
</th>
<th width="220">
Date
</th>
<th width="220">
Author/s
</th>
<th width="220">
Status
</th>
<th width="220">
Remarks
</th>
</tr>

<tr align="left" valign="top">
<td>
0.1.0
</td>
<td width="220">
01.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Erstfassung
</td>
</tr>
<tr align="left" valign="top">
<td>
0.2.0
</td>
<td width="220">
14.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Solid ergänzt
</td>
</tr>

<tr align="left" valign="top">
<td>
0.3.0
</td>
<td width="220">
23.10.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Verschmelzung mit Paper Gröger
</td>
</tr>

<tr align="left" valign="top">
<td>
0.4.0
</td>
<td width="220">
23.11.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Redaktionelle Änderungen und Ergänzungen zu Planarität von Polygonen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.5.0
</td>
<td width="220">
24.11.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Einarbeitung der Änderungen, die im CityGML-Forum von K.-H. Häfele vorgeschlagen wurden
</td>
</tr>

<tr align="left" valign="top" bgcolor="green">
<td>
0.6.0
</td>
<td width="220">
15.12.2010
</td>
<td>
Gröger
</td>
<td>
öffentlich
</td>
<td>
Einarbeitung der Anregungen von G. Juen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.7.0
</td>
<td width="220">
20.01.2012
</td>
<td>
Karl-Heinz Häfele
</td>
<td>
nicht öffentlich
</td>
<td>
Konvertierung in Html, Verschiebung des Kapitel Planarität von Polygonen, Neues Kapitel CompositeSolid
</td>
</tr>
<tr align="left" valign="top">
<td>
0.7.0 EN
</td>
<td width="220">
November 2013
</td>
<td>
Egbert Casper, Karl-Heinz Häfele
</td>
<td>
public
</td>
<td>
English Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.1 EN
</td>
<td width="220">
November 2014
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Derived PDF Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.2 EN
</td>
<td width="220">
November 2017
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Minor editorial changes and completions, License change to Creative Commons BY-NC-SA-4.0 </td>
</tr>

</table>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

== References ==
* Cox, S., Daisey, P., Lake, R., Portele, C., Whiteside, A. (2004): OpenGIS Geography Markup Language (GML) Implementation Specification. Version: 3.1.1, OGC 03-105r1,
* Herring J. (2001): The OpenGIS Abstract Specification, Topic 1: Feature Geometry (ISO 19107 Spatial Schema), Open Geospatial Consortium, OGC Document Number 01-101. OGC.
* Gröger, G., Kolbe, T., Czerwinski, A., and Nagel, C. (2008) (Eds.): OpenGIS City Geography Markup Language (CityGML) Encoding Standard, OGC reference number OGC 08-007r1 version 1.0.0, 2008
* Gröger, G., Plümer, L. (2011): How to Achieve Consistency for 3D City Models. Geoinformatica, 15(1):137-165, DOI: 10.1007/s10707-009-0091-6.

== Preliminaries ==
* The rules refer to GML Version 3.1.
* The rules are based on the validity of the data with regard to the XML-Schema of GML 3.1.
* The rules are restricted to the elements of GML that are used in CityGML (Profile of GML, c.f. Figure 1 and Figure 2).
* If a condition applies to CityGML only (not to GML in general), it is stated explicitly.

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-1.png|Profil von GML]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 1:''' Profile of GML that is used in CityGML (Primitives and Composites)
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-2.png|Profilvon]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 2:''' Profile of GML that is used in CityGML (Complexes and Aggregates)
</td>
</tr>
</table>

== <span id="Spatial-Reference-Systems">Spatial Reference Systems (SRS)</span> ==
* Each geometry element (including pos, posList and coordinates) must
** either have a srsName attribute with proper value, or
** inherit the value of the srsName attribute from
*** its parent geometries (even it its obtained recursively from the parents of the parents, etc.), or
*** the gml:Envelope (or gml:Box) which is the value of the gml:boundedBy property of the parent feature or the parent feature collection (even if it is obtained recursively).
* A local value of a srsName attribute precedes the inherited value of a srsName attribute.
* If in geometries (pos, posList) the dimension of a SRS can not be derived from the SRS without a doubt, the attribute srsDimension must contain the dimension of the SRS.

== Definitions ==

=== Geometric Tolerances ===

=== <span id="PlanarityOfPolygons">Planarity of Polygons</span> ===
„Surfaces in CityGML are represented by polygons, which define a planar geometry, i.e. the boundary and all interior points are required to be located in one single plane.” (Gröger et al., 2008). The boundary of a Polygon is defined by one or more planar Linear Rings (see gml:Polygon). From practical point of view, Linear Rings that are not exactly planar should be accepted as a valid as well.
Intuitively, a Linear Ring R would be defined as planar if there is a plane E with distance less than a given threshold  for all points Pi of R. However, this is true for Linear Rings with small bends and folds as shown in Figure 3 as well.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="50%">
[[image:Teil1-ABB6a.png|450px]]
</td>
<td width="50%">
[[image:Teil1-ABB6b.png|450px]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="2">
'''Figure 3:''' : Bends and folds should not appear in planar Linear Rings
</td>
</tr>
</table>

In order to avoid such situations, a slightly different definition of planarity of Linear Rings is introduced:

'''Definition 1:'''
A Linear Ring <math>R</math> is '''planar''', if it is a valid Linear Ring and the distance of all points to any plane <math>E_{ijk}</math>, that is defined by three co-linear points <math>P_i</math>, <math>P_j</math> and <math>P_k</math>, is less than a given threshold <math>\epsilon</math> :

<math>\forall E_{ijk} \forall P_a = dist (P_a,E_{ijk})\le \epsilon</math>



== <span id="posList">[http://www.schemacentral.com/sc/niem21/e-gml32_posList.html gml:posList]</span> ==
* The number of items in the list should correlate with the product of the SRS dimension (usually in CityGML 3) and the number of positions.

== <span id="Curve"><span id="LineString">[http://www.schemacentral.com/sc/niem21/e-gml32_Curve.html gml:_Curve], [http://www.schemacentral.com/sc/niem21/e-gml32_LineString.html gml:LineString]</span></span> ==
* Only gml:LineStrings are allowed as subtypes of _Curves (rule applies to CityGML only)
* A gml:LineString has linear interpolation.
* For the child elements of a gml:LineString (control points) the following statements must hold true:
** They form a sequence of "pos" (DirectPositionType) or "pointProperty" (PointPropertyType) elements. "pos" elements are control points that belong to this curve only. "pointProperty" elements contain points that may be referenced from other geometries or that reference other points (via XLinks) which are defined in other geometries.
** Alternatively, a gml:LineString can be composed of a "posList" element, providing a compact way of representing coordinates. In that case all control points must belong to the same Curve and must be given in the same SRS. The number of points (Direct Position) must be at least two.
* Each control point in a gml:LineString occurs only once, beside the first and the last one which may both be identical.
* Line segments of a gml:LineString are defined by pairs of two subsequent control points. Those line segments must not intersect mutually and must not have any identical points. Exceptions of that rule are the pairs which consist of an endpoint of one line segment and the start point of the next line segment in the sequence.

== <span id="LinearRing">[http://www.schemacentral.com/sc/niem21/e-gml32_LinearRing.html gml:LinearRing]</span> ==

The Linear Ring is the fundamental element to describe 3D geometry in CityGML. Every single polygon of a building geometry is defined by its boundary – the Linear Ring.

A sequence is an ordered list of elements. Unlike a set, order matters, and the exact same elements can appear multiple times at different positions in the sequence. A finite sequence <math>a</math> with <math>n+1</math> elements is denoted as <math>a=(a_0,a_1,...,a_n)</math>. The empty sequence <math>a=()</math> has no elements..

A finite sequence of points <math>R=(P_0,P_1,...,P_n),n\ge3,P_i=(x_i,y_i,z_i)</math> is a Linear Ring if:

(i) the first and last point <math>P_0</math> and <math>P_n</math> represent the same point: <math>P_0 =P_n </math> '''(closeness)'''

(ii) All points of the sequence besides start and end point are different:
<math>\underset{\underset {i \ne k}{\underset{k=0...n-1}{i=0...n-1}}}{\forall} P_i\ne P_k</math>

(iii) Two edges <math>(P_i , P_{i+1})</math> and <math>(P_k , P_{k+1})</math> <math>i = 0 ... (n-1), k= 0 ... (n-1), i \not= k</math> do only intersect in one start-/ endpoint. No other intersection is allowed (no self intersection).

If all points of the sequence are co-planar, the Linear Ring is planar.

'''Examples:'''

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3,P_0)</math>

with

<math>P_0 =(1,1,1)</math>

<math>P_1 =(3,1,1)</math>

<math>P_2 =(3,3,1)</math>

<math>P_3 =(1,3,1)</math>
</td>
<td width="33%">
<gml:LinearRing>

<gml:pos> 1 1 1 </gml:pos>

<gml:pos> 3 1 1 </gml:pos>

<gml:pos> 3 3 1 </gml:pos>

<gml:pos> 1 3 1 </gml:pos>

<gml:pos> 1 1 1 </gml:pos>

</gml:LinearRing>
</td>
<td>
[[image:Teil1-ABB3.png]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="3">
'''Figure 4:''' Planar Linear Ring: definition, GML and graphic representation
</td>
</tr>
</table>

'''Please note:'''
The two Linear Rings <math>R_1 = (P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2 = (P_0,P_3,P_2,P_1,P_0)</math> are not identical.

<table width="900px" border="0" cellspacing="0" cellpadding="5">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB4a.png]]</td>
<td width="33%">
[[image:Teil1-ABB4b.png]]</td>
<td>
[[image:Teil1-ABB4c.png]]
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_3,P_2,P_0)</math>
</td>
<td>
<math>R=(P_0,P_1,P_4,P_3,P_2,P_4,P_0)</math>
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
No Linear Ring: not closed (see (i) closeness)

</td>
<td width="33%">
No Linear Ring:self intersection (see (iii) self-intersection)

</td>
<td>
No Linear Ring: <math>P_4</math> appears twice in the sequence (see (ii), <math>P_4=(2,2,1)</math>)
</td>
</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 5:''' Examples of non-valid Linear Rings</td>
</tr>
</table>

<table width="600px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB5a.png|250px]]</td>
<td width="33%">
[[image:Teil1-ABB5b.png]]</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_4,P_3,P_0)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_2,P_0)</math>
</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
Linear Ring, but not planar <math>P_4=(2,4,0)</math></td>
<td width="33%">
No Linear Ring: all 3 points are co-linear; self-intersection (see (iii))
</td>

</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 6:''' Special cases: non-planar and co-linear Linear Ring Elements.</td>
</tr>
</table>

== <span id="Polygon">[http://www.schemacentral.com/sc/niem21/e-gml32_Polygon.html gml:Polygon]</span> ==
* A Polygon <math>S</math> is defined by a planar Linear Ring <math>R_s</math> (exterior ring).
* A polygon has exactly one exterior ring. In addition, a polygon can have <math>n\ge0</math> interior rings. These interior rings a planar Linear Rings as well. All interior rings and the exterior ring must be on the same plane (within the given tolerance).
* As interior rings define holes in the polygon, they have to be completely included in the area defined by the exterior ring.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-02-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 7:''' Polygon mit <span style="color:#008000">korrektem interior Ring (links)</span> und <span style="color:#FF0000">nicht korrektem inneren Ring (rechts)</span> </td>
</tr>
</table>
* Interior rings must not overlap other Linear Rings or be included in another Linear Ring (except the exterior Linear Ring).
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-04-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 8:''' Polygon with <span style="color:#008000">two correct interior Rings (left)</span> and two interlaced, <span style="color:#FF0000">not correct interior Rings (right)</span> </td>
</tr>
</table>
* Interior rings and the exterior ring may touch each other in a finite number of points. The inner area of the polygon has to be connected.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-05-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 9:''' Polygon with <span style="color:#008000">correct, interior ring touching the outer ring at exactly one point (left)</span> and <span style="color:#FF0000">incorrect interior Ring touching the outer ring at two points and splitting the polygon (right) </span> </td>
</tr>
</table>
* • The order of points of the exterior ring defines the orientation of the polygon. The non co-linear points <math>P_i</math>, <math>P_j</math> und <math>P_k</math>define the plane <math>E(P_i,P_j,P_k)</math>. The normal vector <math>\vec n</math> is given by the cross product of the two vectors <math>\vec{P_iP_j}</math> and <math>\vec{P_jP_k}</math>:

<math>\vec n = \frac {\vec{P_iP_j}\times\vec{P_jP_k}}{\| {\vec{P_iP_j}\times\vec{P_jP_k}}\|}</math>

'''Please note:''' that due to the tolerance of planar Linear Rings, the normal vector can be ambiguous.

'''Remark:'''
The two Linear Rings <math>R_1=(P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2=(P_0,P_3,P_2,P_1,P_0)</math> define polygons with the same geometric extend but different orientation.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:Teil1-ABB7.png|300px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 10:''' Polygon with normal vector n</td>
</tr>
</table>

== <span id="OrientableSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_OrientableSurface.html gml:OrientableSurface]</span> ==
* If the value of the attribute “orientation” of an OrientableSurface is "+", the orientation of the OrientableSurface is identical to the one of the baseSurface. If the value of “orientation is " ", the normal of the OrientableSurface has a direction which is opposite to the normal of the baseSurface. The default value of “orientation” is "+".
* Either the element “baseSurface” references the base surface via a XLink attribute or the element “baseSurface” contains the base surface as child element. The base surface has positive orientation.

== <span id="MultiSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_MultiSurface.html gml:MultiSurface]</span> ==
A MultiSurface is an unstructured set <math>M=\lbrace S_1,S_2,...S_n\rbrace</math> of polygons. No further constraints are defined for a MultiSurface element. It is not necessary that <math>M</math> is a connected surface. Orientation of the polygons is arbitrary. By a MultiSurface any existing polygonal boundary representation of a rigid body can be described. Unfortunately, also objects that do not exist in real space can be modeled.

Due to the missing constraints it is recommended that MultiSurface elements should only be used to model non-volumetric parts of the building model as shown in Figure 11. Volumetric parts should be modeled as solids (see gml:Solid)

<table width="700px" border="0" cellspacing="0">

<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-Explode-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-Explode-01b.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td colspan="2">
'''Figure 11:''' Modeling overlapping roof parts ('''above:''' complete models, polygons outlined; '''below:''' roof polygons exploded)

'''Please note:''' the left model in Figure 11 is created with a MultiSurface element containing 7 polygons. However, the polygons do not represent a valid boundary of a rigid body. Calculating a volume is not possible. The right model is the same building geometry but modeled with 1 Solid element (7 polygons) and 1 MultiSurface element (2 polygons F6 and F8) as recommended (see CityGML Standard v1.0,p.61)

</td>
</tr>
</table>

== <span id="CompositeSurface"> [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html gml:CompositeSurface]</span>==

A set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons is a CompositeSurface for which

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and/or edges <math>e</math>that are part of both Linear Rings.
The polygon <math>S</math> is defined by the planar Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>.
The intersection of <math>S_i</math> and <math>S_k</math> equals<br>
<math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math> is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math> defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vectors of neighbouring polygons point to the same direction.
# The union of all polygons in <math>C</math> without the edges or points where the polygons touch, is isomorphic to a polygon.

It follows from (i) and (ii) that the surface defined by <math>C</math> , must not contain any overlapping or penetrating polygons, that is, polygons touch at most at points or edges.

== <span id="Solid"> [http://www.schemacentral.com/sc/niem21/e-gml32_Solid.html gml:Solid]</span>==

A solid geometry represents a rigid body. The surface of the solid is defined by a set of polygons with the following properties.
The set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons bounds a solid if:

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and edges <math>e</math> that are part of both Linear Rings. The polygon <math>S</math> is defined by the Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>. The intersection of <math>S_k</math> and <math>S_l</math> equals: <br><math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every Edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math>, is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math>, defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vector of each polygon points to the outside of the solid.
# All polygons in <math>C</math> are connected, that is the dual graph of <math>C</math> has a path containing all nodes. The dual graph G<sub>C</sub> =(V<sub>C</sub>, E<sub>C</sub>) of <math>C</math> consists of a set V<sub>C</sub> of nodes and a set E<sub>C</sub> of edges. Every node v of V<sub>C</sub> represents exactly one polygon of <math>C</math>. An edge shared by two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is represented by an edge <math>e=(v_{s_k},v_{s_l})</math> in E<sub>C</sub>.
# For every point <math>P</math> of a Linear Ring of a polygon of <math>C </math> applies: The graph <math>G_P =(V_P, E_P)</math>, that is only build by polygons and edges that touch<math>P</math> is connected. Each node <math>v</math> of <math>V_P</math> represents a polygon which Linear Ring contains <math>P</math>. Two nodes are connected by an edge <math>e</math> of <math>E_P</math> if the two polygons represented by the nodes have a common edge that touches <math>P</math>.

It follows from (i) and (ii) that the surface defined by <math>C</math> has no holes. Together with conditions (4) and (5) it follows that the inner of the solid defined by <math>C</math> is connected
<math>S</math> is denoted as closed [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html '''CompositeSurface'''].

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-01.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-02.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-03.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-04.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
correct: 6 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 11 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 10 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 30 surfaces, closed, correct surface orientation
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-05.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-06.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-07.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-08.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
incorrect: 5 surfaces, not closed, correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 6 surfaces, closed, incorrect surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, no closed (two outer hulls), correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, not closed (inner and outer hull), correct surface orientation
</td>
</tr>
</table>

== <span id="CompositeSolid">[http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSolid.html gml:CompositeSolid]</span>==
A CompositeSolid is represented by a nonempty set <math>C = \{S_1,..., S_n\}</math> of '''[[#Solid|Solids]]''' (see 10.) with the following properties:

# The intersection of the inner of two solids <math>S_i</math>, <math>S_j</math>, 1 ≤ i ≤ n, 1 ≤ j ≤ n, i ≠ j of <math>C</math> is empty, that is either both solids <math>S_i</math>, <math>S_j</math> are disjoint or both solids are connected only by surfaces, lines or points.
# Let <math>C'</math> be the union of all solids from <math>C</math>. Then the boundary of <math>C'</math> (the surface of <math>C'</math> without the surfaces or points where the solids touch each other) is the boundary of a solid.

In CityGML inner inclusions ( hollow spaces ) are not considered in CompositeSolids, as in solids.

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall01.png|300px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall02.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall03.png|240px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall04.png|260px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall05.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall06.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall07.png|280px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall08.png|180px]]
</td>

</tr>

<tr align="middle">

<td width="300px" valign="bottom">
not correct; line contact
</td>
<td width="300px" valign="bottom">
not correct; point contact
</td>
<td width="300px" valign="bottom">
not correct; no contact at all
</td>
<td width="300px" valign="bottom">
not correct; intersection
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall14.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14a.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14b.png|220px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
not correct; 26 boxes with surface contact
</td>
<td width="300px" valign="bottom">
but with internal hollow space
</td>
<td width="300px" valign="bottom">
not correct; interior boundaries
</td>

</tr>

</table>

== <span id="Triangle">[http://www.schemacentral.com/sc/niem21/e-gml32_Triangle.html gml:Triangle]</span> ==
* A Triangle is a special case of a polygon that is bounded by one outer Linear Ring with four points.
* There are no interior rings (no element "interior").

== <span id="TriangulatedSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_TriangulatedSurface.html gml:TriangulatedSurface]</span> ==
A triangulated surface is a [[#CompositeSurface|CompositeSurface]] that consists of triangles only, but is not closed (it may have boundaries). There is no restriction on how the triangulation is derived.

== <span id="TIN">[http://www.schemacentral.com/sc/niem21/e-gml32_Tin.html gml:Tin] </span>==
In contrast to a gml:TriangulatedSurface, the triangles of a gml:TIN are not represented explicitly, but by its three vertices (called control points). In addition, breaklines, stop lines and the maximal length of a side of a triangle can be represented in a gml:TIN.

# A TIN is a triangulated surface that is the result of the application of a Delaunay Algorithm or of a similar algorithm (extended by breaklines, stop lines and the maximal length of a side of a triangle). The surface satisfies the Delaunay criterion:
## For each triangle in the network, the circle passing through its vertices does not contain, in its interior, the vertex of any other triangle.
# Stoplines are lines where the local continuity or regularity of the surface is questionable. In the area of these pathologies, triangles intersecting a stopline shall be removed from the TIN surface, leaving holes in the surface. If triangles incident to the boundary of the surfaces are removed, the boundary of the surfaces changes.
# Breaklines are lines that are critical for the shape of the surface, representing local ridges, or depressions (such as drainage lines) in the surface. As such their constituent segments must be included in the TIN even if doing so violates the Delaunay criterion.
# Areas of the surface where the data is not sufficiently dense to assure reasonable calculations shall be removed by adding a retention criterion for triangles based on the length of their sides. For any triangle sides exceeding maximum length, the adjacent triangles to that triangle side shall be removed from the surface. # The number of control points is at least three.
# The surface is not affected by the order in which the control points are given. Application schemas may add information based on the ordering of the control points to facilitate the reconstruction of the TIN from the control points.

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)

2018-04-09T11:18:52Z

Wikiadmin:

__TOC__

== Document History ==

<table border="1" cellspacing="0">
<tr align="left" valign="top">
<th width="220">
Version
</th>
<th width="220">
Date
</th>
<th width="220">
Author/s
</th>
<th width="220">
Status
</th>
<th width="220">
Remarks
</th>
</tr>

<tr align="left" valign="top">
<td>
0.1.0
</td>
<td width="220">
01.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Erstfassung
</td>
</tr>
<tr align="left" valign="top">
<td>
0.2.0
</td>
<td width="220">
14.10.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Solid ergänzt
</td>
</tr>

<tr align="left" valign="top">
<td>
0.3.0
</td>
<td width="220">
23.10.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Verschmelzung mit Paper Gröger
</td>
</tr>

<tr align="left" valign="top">
<td>
0.4.0
</td>
<td width="220">
23.11.2010
</td>
<td>
Coors
</td>
<td>
nicht öffentlich
</td>
<td>
Redaktionelle Änderungen und Ergänzungen zu Planarität von Polygonen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.5.0
</td>
<td width="220">
24.11.2010
</td>
<td>
Gröger
</td>
<td>
nicht öffentlich
</td>
<td>
Einarbeitung der Änderungen, die im CityGML-Forum von K.-H. Häfele vorgeschlagen wurden
</td>
</tr>

<tr align="left" valign="top" bgcolor="green">
<td>
0.6.0
</td>
<td width="220">
15.12.2010
</td>
<td>
Gröger
</td>
<td>
öffentlich
</td>
<td>
Einarbeitung der Anregungen von G. Juen
</td>
</tr>

<tr align="left" valign="top">
<td>
0.7.0
</td>
<td width="220">
20.01.2012
</td>
<td>
Karl-Heinz Häfele
</td>
<td>
nicht öffentlich
</td>
<td>
Konvertierung in Html, Verschiebung des Kapitel Planarität von Polygonen, Neues Kapitel CompositeSolid
</td>
</tr>
<tr align="left" valign="top">
<td>
0.7.0 EN
</td>
<td width="220">
November 2013
</td>
<td>
Egbert Casper, Karl-Heinz Häfele
</td>
<td>
public
</td>
<td>
English Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.1 EN
</td>
<td width="220">
November 2014
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Derived PDF Version </td>
</tr>
<tr align="left" valign="top">
<td>
0.7.2 EN
</td>
<td width="220">
November 2017
</td>
<td>
Egbert Casper
</td>
<td>
public
</td>
<td>
Minor editorial changes and completions, License change to Creative Commons BY-NC-SA-4.0 </td>
</tr>

</table>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

== References ==
* Cox, S., Daisey, P., Lake, R., Portele, C., Whiteside, A. (2004): OpenGIS Geography Markup Language (GML) Implementation Specification. Version: 3.1.1, OGC 03-105r1,
* Herring J. (2001): The OpenGIS Abstract Specification, Topic 1: Feature Geometry (ISO 19107 Spatial Schema), Open Geospatial Consortium, OGC Document Number 01-101. OGC.
* Gröger, G., Kolbe, T., Czerwinski, A., and Nagel, C. (2008) (Eds.): OpenGIS City Geography Markup Language (CityGML) Encoding Standard, OGC reference number OGC 08-007r1 version 1.0.0, 2008
* Gröger, G., Plümer, L. (2011): How to Achieve Consistency for 3D City Models. Geoinformatica, 15(1):137-165, DOI: 10.1007/s10707-009-0091-6.

== Preliminaries ==
* The rules refer to GML Version 3.1.
* The rules are based on the validity of the data with regard to the XML-Schema of GML 3.1.
* The rules are restricted to the elements of GML that are used in CityGML (Profile of GML, c.f. Figure 1 and Figure 2).
* If a condition applies to CityGML only (not to GML in general), it is stated explicitly.

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-1.png|Profil von GML]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 1:''' Profile of GML that is used in CityGML (Primitives and Composites)
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="left" valign="top">
<td>
[[image:GML-Profil-CityGML-2.png|Profilvon]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Figure 2:''' Profile of GML that is used in CityGML (Complexes and Aggregates)
</td>
</tr>
</table>

== <span id="Spatial-Reference-Systems">Spatial Reference Systems (SRS)</span> ==
* Each geometry element (including pos, posList and coordinates) must
** either have a srsName attribute with proper value, or
** inherit the value of the srsName attribute from
*** its parent geometries (even it its obtained recursively from the parents of the parents, etc.), or
*** the gml:Envelope (or gml:Box) which is the value of the gml:boundedBy property of the parent feature or the parent feature collection (even if it is obtained recursively).
* A local value of a srsName attribute precedes the inherited value of a srsName attribute.
* If in geometries (pos, posList) the dimension of a SRS can not be derived from the SRS without a doubt, the attribute srsDimension must contain the dimension of the SRS.

== Definitions ==

=== Geometric Tolerances ===

=== <span id="PlanarityOfPolygons">Planarity of Polygons</span> ===
„Surfaces in CityGML are represented by polygons, which define a planar geometry, i.e. the boundary and all interior points are required to be located in one single plane.” (Gröger et al., 2008). The boundary of a Polygon is defined by one or more planar Linear Rings (see gml:Polygon). From practical point of view, Linear Rings that are not exactly planar should be accepted as a valid as well.
Intuitively, a Linear Ring R would be defined as planar if there is a plane E with distance less than a given threshold  for all points Pi of R. However, this is true for Linear Rings with small bends and folds as shown in Figure 3 as well.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="50%">
[[image:Teil1-ABB6a.png|450px]]
</td>
<td width="50%">
[[image:Teil1-ABB6b.png|450px]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="2">
'''Figure 3:''' : Bends and folds should not appear in planar Linear Rings
</td>
</tr>
</table>

In order to avoid such situations, a slightly different definition of planarity of Linear Rings is introduced:

'''Definition 1:'''
A Linear Ring <math>R</math> is '''planar''', if it is a valid Linear Ring and the distance of all points to any plane <math>E_{ijk}</math>, that is defined by three co-linear points <math>P_i</math>, <math>P_j</math> and <math>P_k</math>, is less than a given threshold <math>\epsilon</math> :

<math>\forall E_{ijk} \forall P_a = dist (P_a,E_{ijk})\le \epsilon</math>



== <span id="posList">[http://www.schemacentral.com/sc/niem21/e-gml32_posList.html gml:posList]</span> ==
* The number of items in the list should correlate with the product of the SRS dimension (usually in CityGML 3) and the number of positions.

== <span id="Curve"><span id="LineString">[http://www.schemacentral.com/sc/niem21/e-gml32_Curve.html gml:_Curve], [http://www.schemacentral.com/sc/niem21/e-gml32_LineString.html gml:LineString]</span></span> ==
* Only gml:LineStrings are allowed as subtypes of _Curves (rule applies to CityGML only)
* A gml:LineString has linear interpolation.
* For the child elements of a gml:LineString (control points) the following statements must hold true:
** They form a sequence of "pos" (DirectPositionType) or "pointProperty" (PointPropertyType) elements. "pos" elements are control points that belong to this curve only. "pointProperty" elements contain points that may be referenced from other geometries or that reference other points (via XLinks) which are defined in other geometries.
** Alternatively, a gml:LineString can be composed of a "posList" element, providing a compact way of representing coordinates. In that case all control points must belong to the same Curve and must be given in the same SRS. The number of points (Direct Position) must be at least two.
* Each control point in a gml:LineString occurs only once, beside the first and the last one which may both be identical.
* Line segments of a gml:LineString are defined by pairs of two subsequent control points. Those line segments must not intersect mutually and must not have any identical points. Exceptions of that rule are the pairs which consist of an endpoint of one line segment and the start point of the next line segment in the sequence.

== <span id="LinearRing">[http://www.schemacentral.com/sc/niem21/e-gml32_LinearRing.html gml:LinearRing]</span> ==

The Linear Ring is the fundamental element to describe 3D geometry in CityGML. Every single polygon of a building geometry is defined by its boundary – the Linear Ring.

A sequence is an ordered list of elements. Unlike a set, order matters, and the exact same elements can appear multiple times at different positions in the sequence. A finite sequence <math>a</math> with <math>n+1</math> elements is denoted as <math>a=(a_0,a_1,...,a_n)</math>. The empty sequence <math>a=()</math> has no elements..

A finite sequence of points <math>R=(P_0,P_1,...,P_n),n\ge3,P_i=(x_i,y_i,z_i)</math> is a Linear Ring if:

(i) the first and last point <math>P_0</math> and <math>P_n</math> represent the same point: <math>P_0 =P_n </math> '''(closeness)'''

(ii) All points of the sequence besides start and end point are different:
<math>\underset{\underset {i \ne k}{\underset{k=0...n-1}{i=0...n-1}}}{\forall} P_i\ne P_k</math>

(iii) Two edges <math>(P_i , P_{i+1})</math> and <math>(P_k , P_{k+1})</math> <math>i = 0 ... (n-1), k= 0 ... (n-1), i \not= k</math> do only intersect in one start-/ endpoint. No other intersection is allowed (no self intersection).

If all points of the sequence are co-planar, the Linear Ring is planar.

'''Examples:'''

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3,P_0)</math>

with

<math>P_0 =(1,1,1)</math>

<math>P_1 =(3,1,1)</math>

<math>P_2 =(3,3,1)</math>

<math>P_3 =(1,3,1)</math>
</td>
<td width="33%">
<gml:LinearRing>

<gml:pos> 1 1 1 </gml:pos>

<gml:pos> 3 1 1 </gml:pos>

<gml:pos> 3 3 1 </gml:pos>

<gml:pos> 1 3 1 </gml:pos>

<gml:pos> 1 1 1 </gml:pos>

</gml:LinearRing>
</td>
<td>
[[image:Teil1-ABB3.png]]
</td>
</tr>
<tr align="left" valign="top">
<td colspan="3">
'''Figure 4:''' Planar Linear Ring: definition, GML and graphic representation
</td>
</tr>
</table>

'''Please note:'''
The two Linear Rings <math>R_1 = (P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2 = (P_0,P_3,P_2,P_1,P_0)</math> are not identical.

<table width="900px" border="0" cellspacing="0" cellpadding="5">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB4a.png]]</td>
<td width="33%">
[[image:Teil1-ABB4b.png]]</td>
<td>
[[image:Teil1-ABB4c.png]]
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_3)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_3,P_2,P_0)</math>
</td>
<td>
<math>R=(P_0,P_1,P_4,P_3,P_2,P_4,P_0)</math>
</td>
</tr>
<tr align="left" valign="top">
<td width="33%">
No Linear Ring: not closed (see (i) closeness)

</td>
<td width="33%">
No Linear Ring:self intersection (see (iii) self-intersection)

</td>
<td>
No Linear Ring: <math>P_4</math> appears twice in the sequence (see (ii), <math>P_4=(2,2,1)</math>)
</td>
</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 5:''' Examples of non-valid Linear Rings</td>
</tr>
</table>

<table width="600px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="33%">
[[image:Teil1-ABB5a.png|250px]]</td>
<td width="33%">
[[image:Teil1-ABB5b.png]]</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
<math>R=(P_0,P_1,P_2,P_4,P_3,P_0)</math>
</td>
<td width="33%">
<math>R=(P_0,P_1,P_2,P_0)</math>
</td>

</tr>
<tr align="left" valign="top">
<td width="33%">
Linear Ring, but not planar <math>P_4=(2,4,0)</math></td>
<td width="33%">
No Linear Ring: all 3 points are co-linear; self-intersection (see (iii))
</td>

</tr>

<tr align="left" valign="top">
<td colspan="3">
'''Figure 6:''' Special cases: non-planar and co-linear Linear Ring Elements.</td>
</tr>
</table>

== <span id="Polygon">[http://www.schemacentral.com/sc/niem21/e-gml32_Polygon.html gml:Polygon]</span> ==
* A Polygon <math>S</math> is defined by a planar Linear Ring <math>R_s</math> (exterior ring).
* A polygon has exactly one exterior ring. In addition, a polygon can have <math>n\ge0</math> interior rings. These interior rings a planar Linear Rings as well. All interior rings and the exterior ring must be on the same plane (within the given tolerance).
* As interior rings define holes in the polygon, they have to be completely included in the area defined by the exterior ring.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-02-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 7:''' Polygon mit <span style="color:#008000">korrektem interior Ring (links)</span> und <span style="color:#FF0000">nicht korrektem inneren Ring (rechts)</span> </td>
</tr>
</table>
* Interior rings must not overlap other Linear Rings or be included in another Linear Ring (except the exterior Linear Ring).
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-04-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 8:''' Polygon with <span style="color:#008000">two correct interior Rings (left)</span> and two interlaced, <span style="color:#FF0000">not correct interior Rings (right)</span> </td>
</tr>
</table>
* Interior rings and the exterior ring may touch each other in a finite number of points. The inner area of the polygon has to be connected.
<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:InnerLoops-05-2.png|500px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 9:''' Polygon with <span style="color:#008000">correct, interior Ring, der den außeren Ring an einem Punkt berührt (left)</span> and <span style="color:#FF0000">not correct interior Ring, der den äußeren Ring an zwei Punkten berührt und damit dass Polygon spaltet (rechts)</span> </td>
</tr>
</table>
* • The order of points of the exterior ring defines the orientation of the polygon. The non co-linear points <math>P_i</math>, <math>P_j</math> und <math>P_k</math>define the plane <math>E(P_i,P_j,P_k)</math>. The normal vector <math>\vec n</math> is given by the cross product of the two vectors <math>\vec{P_iP_j}</math> and <math>\vec{P_jP_k}</math>:

<math>\vec n = \frac {\vec{P_iP_j}\times\vec{P_jP_k}}{\| {\vec{P_iP_j}\times\vec{P_jP_k}}\|}</math>

'''Please note:''' that due to the tolerance of planar Linear Rings, the normal vector can be ambiguous.

'''Remark:'''
The two Linear Rings <math>R_1=(P_0,P_1,P_2,P_3,P_0)</math> and <math>R_2=(P_0,P_3,P_2,P_1,P_0)</math> define polygons with the same geometric extend but different orientation.

<table width="900px" border="0" cellspacing="0">
<tr align="left" valign="top">
<td width="100%">
[[image:Teil1-ABB7.png|300px]]
</td>

</tr>
<tr align="left" valign="top">
<td colspan="1">
'''Figure 10:''' Polygon with normal vector n</td>
</tr>
</table>

== <span id="OrientableSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_OrientableSurface.html gml:OrientableSurface]</span> ==
* If the value of the attribute “orientation” of an OrientableSurface is "+", the orientation of the OrientableSurface is identical to the one of the baseSurface. If the value of “orientation is " ", the normal of the OrientableSurface has a direction which is opposite to the normal of the baseSurface. The default value of “orientation” is "+".
* Either the element “baseSurface” references the base surface via a XLink attribute or the element “baseSurface” contains the base surface as child element. The base surface has positive orientation.

== <span id="MultiSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_MultiSurface.html gml:MultiSurface]</span> ==
A MultiSurface is an unstructured set <math>M=\lbrace S_1,S_2,...S_n\rbrace</math> of polygons. No further constraints are defined for a MultiSurface element. It is not necessary that <math>M</math> is a connected surface. Orientation of the polygons is arbitrary. By a MultiSurface any existing polygonal boundary representation of a rigid body can be described. Unfortunately, also objects that do not exist in real space can be modeled.

Due to the missing constraints it is recommended that MultiSurface elements should only be used to model non-volumetric parts of the building model as shown in Figure 11. Volumetric parts should be modeled as solids (see gml:Solid)

<table width="700px" border="0" cellspacing="0">

<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-01a.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td width="50%">
[[image:MultiSurface-Explode-01a.png|300px]]
</td>
<td width="50%">
[[image:MultiSurface-Explode-01b.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td colspan="2">
'''Figure 11:''' Modeling overlapping roof parts ('''above:''' complete models, polygons outlined; '''below:''' roof polygons exploded)

'''Please note:''' the left model in Figure 11 is created with a MultiSurface element containing 7 polygons. However, the polygons do not represent a valid boundary of a rigid body. Calculating a volume is not possible. The right model is the same building geometry but modeled with 1 Solid element (7 polygons) and 1 MultiSurface element (2 polygons F6 and F8) as recommended (see CityGML Standard v1.0,p.61)

</td>
</tr>
</table>

== <span id="CompositeSurface"> [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html gml:CompositeSurface]</span>==

A set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons is a CompositeSurface for which

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and/or edges <math>e</math>that are part of both Linear Rings.
The polygon <math>S</math> is defined by the planar Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>.
The intersection of <math>S_i</math> and <math>S_k</math> equals<br>
<math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math> is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math> defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vectors of neighbouring polygons point to the same direction.
# The union of all polygons in <math>C</math> without the edges or points where the polygons touch, is isomorphic to a polygon.

It follows from (i) and (ii) that the surface defined by <math>C</math> , must not contain any overlapping or penetrating polygons, that is, polygons touch at most at points or edges.

== <span id="Solid"> [http://www.schemacentral.com/sc/niem21/e-gml32_Solid.html gml:Solid]</span>==

A solid geometry represents a rigid body. The surface of the solid is defined by a set of polygons with the following properties.
The set <math>C=\lbrace S_1,S_2,...,S_n \rbrace</math> of polygons bounds a solid if:

# The intersection of two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is either empty or contains only points <math>P</math> and edges <math>e</math> that are part of both Linear Rings. The polygon <math>S</math> is defined by the Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math>. The intersection of <math>S_k</math> and <math>S_l</math> equals: <br><math>S_i \cap S_k= \begin{cases}\emptyset\\ \lbrace Q_0,Q_1,...,Q_m\rbrace,Q_j=P_k^i\\ \lbrace e_0,e_1,...,e_m\rbrace,e_j=\overline{P_i^kP_{i+1}^k} \end{cases}</math>
# Every Edge <math>e_k=\overline{P_i^kP_{i+1}^k}</math> of a Linear Ring <math>R_k=(P_0^k,P_1^k,...,P_n^k)</math> , defining a polygon <math>S_k \in C</math>, is used exactly once as an edge <math>e_l=\overline{P_j^lP_{j+1}^l}</math> in a Linear Ring <math>R_l=(P_0^l,P_1^l,...,P_m^l)</math>, defining another polygon <math>S_l \in C</math> with <math>P_i^k=P_{j+1}^l</math> and <math>P_{i+1}=P_j^l</math>.
# All polygons in <math>C</math> are oriented such that the normal vector of each polygon points to the outside of the solid.
# All polygons in <math>C</math> are connected, that is the dual graph of <math>C</math> has a path containing all nodes. The dual graph G<sub>C</sub> =(V<sub>C</sub>, E<sub>C</sub>) of <math>C</math> consists of a set V<sub>C</sub> of nodes and a set E<sub>C</sub> of edges. Every node v of V<sub>C</sub> represents exactly one polygon of <math>C</math>. An edge shared by two polygons <math>S_k</math> and <math>S_l</math> of <math>C</math> is represented by an edge <math>e=(v_{s_k},v_{s_l})</math> in E<sub>C</sub>.
# For every point <math>P</math> of a Linear Ring of a polygon of <math>C </math> applies: The graph <math>G_P =(V_P, E_P)</math>, that is only build by polygons and edges that touch<math>P</math> is connected. Each node <math>v</math> of <math>V_P</math> represents a polygon which Linear Ring contains <math>P</math>. Two nodes are connected by an edge <math>e</math> of <math>E_P</math> if the two polygons represented by the nodes have a common edge that touches <math>P</math>.

It follows from (i) and (ii) that the surface defined by <math>C</math> has no holes. Together with conditions (4) and (5) it follows that the inner of the solid defined by <math>C</math> is connected
<math>S</math> is denoted as closed [http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSurface.html '''CompositeSurface'''].

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-01.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-02.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-03.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-04.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
correct: 6 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 11 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 10 surfaces, closed, correct surface orientation
</td>
<td width="300px" valign="top">
correct: 30 surfaces, closed, correct surface orientation
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:Solid-Fall-05.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-06.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-07.png|200px]]
</td>
<td width="300px">
[[image:Solid-Fall-08.png|200px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="top">
incorrect: 5 surfaces, not closed, correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 6 surfaces, closed, incorrect surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, no closed (two outer hulls), correct surface orientation
</td>
<td width="300px" valign="top">
incorrect: 12 surfaces, not closed (inner and outer hull), correct surface orientation
</td>
</tr>
</table>

== <span id="CompositeSolid">[http://www.schemacentral.com/sc/niem21/e-gml32_CompositeSolid.html gml:CompositeSolid]</span>==
A CompositeSolid is represented by a nonempty set <math>C = \{S_1,..., S_n\}</math> of '''[[#Solid|Solids]]''' (see 10.) with the following properties:

# The intersection of the inner of two solids <math>S_i</math>, <math>S_j</math>, 1 ≤ i ≤ n, 1 ≤ j ≤ n, i ≠ j of <math>C</math> is empty, that is either both solids <math>S_i</math>, <math>S_j</math> are disjoint or both solids are connected only by surfaces, lines or points.
# Let <math>C'</math> be the union of all solids from <math>C</math>. Then the boundary of <math>C'</math> (the surface of <math>C'</math> without the surfaces or points where the solids touch each other) is the boundary of a solid.

In CityGML inner inclusions ( hollow spaces ) are not considered in CompositeSolids, as in solids.

'''Examples:'''

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall01.png|300px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall02.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall03.png|240px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall04.png|260px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>
<td width="300px" valign="bottom">
correct; surface contact
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall05.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall06.png|260px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall07.png|280px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall08.png|180px]]
</td>

</tr>

<tr align="middle">

<td width="300px" valign="bottom">
not correct; line contact
</td>
<td width="300px" valign="bottom">
not correct; point contact
</td>
<td width="300px" valign="bottom">
not correct; no contact at all
</td>
<td width="300px" valign="bottom">
not correct; intersection
</td>

</tr>

</table>

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="middle" valign="top">
<td width="300px">
[[image:CompositeSolid-01-Fall14.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14a.png|220px]]
</td>
<td width="300px">
[[image:CompositeSolid-01-Fall14b.png|220px]]
</td>

</tr>

<tr align="middle">
<td width="300px" valign="bottom">
not correct; 26 boxes with surface contact
</td>
<td width="300px" valign="bottom">
but with internal hollow space
</td>
<td width="300px" valign="bottom">
not correct; interior boundaries
</td>

</tr>

</table>

== <span id="Triangle">[http://www.schemacentral.com/sc/niem21/e-gml32_Triangle.html gml:Triangle]</span> ==
* A Triangle is a special case of a polygon that is bounded by one outer Linear Ring with four points.
* There are no interior rings (no element "interior").

== <span id="TriangulatedSurface">[http://www.schemacentral.com/sc/niem21/e-gml32_TriangulatedSurface.html gml:TriangulatedSurface]</span> ==
A triangulated surface is a [[#CompositeSurface|CompositeSurface]] that consists of triangles only, but is not closed (it may have boundaries). There is no restriction on how the triangulation is derived.

== <span id="TIN">[http://www.schemacentral.com/sc/niem21/e-gml32_Tin.html gml:Tin] </span>==
In contrast to a gml:TriangulatedSurface, the triangles of a gml:TIN are not represented explicitly, but by its three vertices (called control points). In addition, breaklines, stop lines and the maximal length of a side of a triangle can be represented in a gml:TIN.

# A TIN is a triangulated surface that is the result of the application of a Delaunay Algorithm or of a similar algorithm (extended by breaklines, stop lines and the maximal length of a side of a triangle). The surface satisfies the Delaunay criterion:
## For each triangle in the network, the circle passing through its vertices does not contain, in its interior, the vertex of any other triangle.
# Stoplines are lines where the local continuity or regularity of the surface is questionable. In the area of these pathologies, triangles intersecting a stopline shall be removed from the TIN surface, leaving holes in the surface. If triangles incident to the boundary of the surfaces are removed, the boundary of the surfaces changes.
# Breaklines are lines that are critical for the shape of the surface, representing local ridges, or depressions (such as drainage lines) in the surface. As such their constituent segments must be included in the TIN even if doing so violates the Delaunay criterion.
# Areas of the surface where the data is not sufficiently dense to assure reasonable calculations shall be removed by adding a retention criterion for triangles based on the length of their sides. For any triangle sides exceeding maximum length, the adjacent triangles to that triangle side shall be removed from the surface. # The number of control points is at least three.
# The surface is not affected by the order in which the control points are given. Application schemas may add information based on the ordering of the control points to facilitate the reconstruction of the TIN from the control points.

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright-BY-NC-SA-4.0}}</div>
|}

Template:Copyright-BY-NC-SA-4.0

2018-04-09T09:53:51Z

Wikiadmin:

[[File:CC-BY-NC-SA-4.0-88x31.png|link=http://creativecommons.org/licenses/by-nc-sa/4.0/|Creative Commons License]] This document is licensed under a [http://creativecommons.org/licenses/by-nc-sa/4.0/ Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License].

File:CC-BY-NC-SA-4.0-88x31.png

2018-04-09T09:46:47Z

Wikiadmin:

Template:Copyright-BY-NC-SA-4.0

2018-04-09T09:07:43Z

Wikiadmin: Created page with "<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc..."

<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a><br />This page is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.

Template:Copyright

2018-04-09T08:59:32Z

Wikiadmin:

Main Page

2016-12-12T10:03:11Z

Wikiadmin:

= SIG 3D Quality Working Group =

'''Welcome at the Wiki of the SIG3D Quality Working Group'''

Consult the [http://www.sig3d.org SIG3D web site] for general information about the SIG3D.

<br>

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_5_1.svg|100px|link=Certification]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_6_1.svg|100px|link=Standard Specifications]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_7_1.svg|100px|link=Continuation]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Willkommen AG Qualitaet}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Kontakt}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

Modeling

2016-02-17T14:27:43Z

Wikiadmin:

* <big>[[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)|Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]] ( Version 0.7.1 EN, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.org/file/ag-qualitaet/201311_SIG3D_Modeling_Guide_for_3D_Objects_Part_1.pdf]]</big>

* <big>[[Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3) |Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)]] ( Version 2.0.1 EN, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.org/file/ag-qualitaet/201311_SIG3D_Modeling_Guide_for_3D_Objects_Part_2.pdf]]</big>

<br>
Hinweis: <br> Sie finden die deutsche Version dieser Dokumente unter http://wiki.quality.sig3d.de

<br>

'''Archive''':
*Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML) ( Version 0.6.0, PDF, English) [[File:Adobe_PDF_Icon.svg|20px|link=http://files.sig3d.de/file/ag-qualitaet/20110531_Regeln_GML_final_EN.pdf]]

Template:Copyright

2015-10-21T23:22:40Z

Wikiadmin:

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T12:04:11Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:Buero-Werkshalle-01.png|450px]]
</td>
<td width="500px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|450px]]
</td>
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|450px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|450px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|450px]]

Variante 3
[[image:Variante-03-V2-red.png|450px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|350px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|350px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="400">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T12:02:31Z

Wikiadmin: /* Geometry */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:Buero-Werkshalle-01.png|450px]]
</td>
<td width="500px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|450px]]
</td>
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|450px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|450px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|450px]]

Variante 3
[[image:Variante-03-V2-red.png|450px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|250px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|250px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|350px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|250px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|350px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="400">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T11:54:18Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:Buero-Werkshalle-01.png|450px]]
</td>
<td width="500px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1000px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|450px]]
</td>
<td width="500px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|450px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|450px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|450px]]

Variante 3
[[image:Variante-03-V2-red.png|450px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T11:51:13Z

Wikiadmin: /* Geometry */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="333">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T11:49:25Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1000px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-real.png|166px]]
</td>

<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|166px]]
</td>
<td width="166px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|166px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T11:34:40Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|-

| align="left" colspan="6" |
'''Dormer'''
|-

| valign="top" align="center" |
Actual Example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

| align="center" width="200px" valign="top" |
| align="center" width="200px" valign="top" |

[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
| align="center" width="200px" valign="top" |
|}

{| width="90%" cellspacing="0" border="1"
|-
| align="left" colspan="6" |
'''Dormer (Gable)'''
|-

| valign="top" align="center" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|-

| align="center" width="200px" valign="top" |
[[image:Zwerchhaus-Foto-V3.jpg|200px]]


| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD0-v02.png|170px]]

[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD1-v02.png|170px]]

[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD2-v02.png|170px]]

[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]

| align="center" width="200px" valign="top" |
[[image:Zwerchgiebel-LOD3-v02.png|170px]]

[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]

|}

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T11:02:50Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dormer'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>

<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>

<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="200px" |
Actual example

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="200px" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building

|
CityGML LOD0
|
CityGML LOD1
|
CityGML LOD2
|
CityGML LOD3
|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T10:49:16Z

Wikiadmin: /* Examples */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dormer'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>

<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>

<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
| width="20%" |
Actual example


| width="20%" |
CityGML LOD0

| width="20%" |
CityGML LOD1

| width="20%" |
CityGML LOD2

| width="20%" |
CityGML LOD3

|- align="center"
| width="20%" valign="bottom" |
[[Image:Real Arkaden.png|200px]]
|

| width="20%" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="20%" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="20%" valign="bottom" |
|- align="center"
| width="20%" valign="bottom" |

| width="20%" valign="bottom" |
| width="20%" valign="bottom" |
| width="20%" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px ]]

| width="20%" valign="bottom" |
|}

<br>

{| width="90%" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
| width="20%" |
Real Building



| width="20%" |
CityGML LOD0

| width="20%" |
CityGML LOD1

| width="20%" |
CityGML LOD2

| width="20%" |
CityGML LOD3

|- align="center"
| width="20%" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="20%" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="20%" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="20%" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="20%" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T10:09:37Z

Wikiadmin: /* Document History */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-

|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dormer'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>

<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>

<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====

{| width="1200px" cellspacing="0" border="1" style="border:thin"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
|
Actual example


|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]

|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px]]

| width="200px" valign="bottom" |
|}

<br>

{| width="1200px" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
|
Real Building



|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T08:34:36Z

Wikiadmin: /* Document History */

{{TOC limit|4}}
== Document History ==


{| border="1" style="border-collapse:collapse" width="90%" colspan="5"
|-
| style="width: 10%"|
'''Version'''
| style="width: 15%"|
'''Date'''
| style="width: 25%"|
'''Author(s)'''
| style="width: 15%"|
'''Status'''
| style="width: 35%"|
'''Remarks'''
|-
|
0.8.0
|
Januar 2012
|
| style="background-color: #ff7777;" |
nicht öffentlich
|
Erste Versuche
|-
|
0.9.0
|
April 2012
|
| style="background-color: #ff7777;" |
nicht öffentlich
|
Fertigstellung von Kapitel 1-4.1; 4.2 wird später bearbeitet
|-
|
1.0.0
|
Mai 2012
|
SIG 3D / AG Qualität
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version von Kapitel 1-4.1;
|-
|
1.1.0
|
Januar/Februar 2013
|
SIG 3D / AG Qualität
| style="background-color: #ff7777;" |
nicht öffentlich
|
Vorbereitung Version 2.0.0 mit Erweiterter Modellierung;
|-
|
2.0.0
|
März 2013
|
SIG 3D / AG Qualität

© 2013 Special Interest Group 3D (SIG3D) der GDI-DE http://www.sig3d.org
| style="background-color: #73ff73;" |
öffentlich
|
Erste öffentliche Version mit Erweiterter Modellierung;
|-
|
2.0.0 EN
|
November 2013
|
SIG 3D / Quality Working Group

© 2013-2014 Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
| style="background-color: #73ff73;" |
public
|
English version;
|-
|}

-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dormer'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>

<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>

<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====

{| width="1200px" cellspacing="0" border="1" style="border:thin"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
|
Actual example


|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]

|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px]]

| width="200px" valign="bottom" |
|}

<br>

{| width="1200px" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
|
Real Building



|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2014-11-12T08:07:38Z

Wikiadmin: /* Geometry */

{{TOC limit|4}}
== Document History ==

<table border="1" cellspacing="0">
<tr align="left" valign="top">
<th width="220">
Version
</th>
<th width="220">
Datum
</th>
<th width="220">
Autor/en
</th>
<th width="220">
Status
</th>
<th width="220">
Bemerkungen
</th>
</tr>
<tr align="left" valign="top">
<td>
0.8.0
</td>
<td width="220">
Januar 2012
</td>
<td>
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>
<td>
Erste Versuche
</td>
</tr>
<tr align="left" valign="top">
<td>
0.9.0
</td>
<td width="220">
April 2012
</td>
<td>
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>
<td>
Fertigstellung von Kapitel 1-4.1; 4.2 wird später bearbeitet
</td>
</tr>
<tr align="left" valign="top">
<td>
1.0.0
</td>
<td width="220">
Mai 2012
</td>
<td>
SIG 3D / AG Qualität
</td>
<td bgcolor="#73ff73">
öffentlich
</td>
<td>
Erste öffentliche Version von Kapitel 1-4.1;
</td>
</tr>
<tr align="left" valign="top">
<td>
1.1.0
</td>
<td width="220">
Januar/Februar 2013
</td>
<td>
SIG 3D / AG Qualität
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>

<td>
Vorbereitung Version 2.0.0 mit Erweiterter Modellierung;
</td>
</tr>
<tr align="left" valign="top">
<td>
2.0.0
</td>
<td width="220">
März 2013
</td>
<td>
SIG 3D / AG Qualität
(c) 2013 Copyright Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org
</td>
<td bgcolor="#73ff73">
öffentlich
</td>

<td>
Erste öffentliche Version mit Erweiterter Modellierung;
</td>
</tr>
<tr align="left" valign="top">
<td>
2.0.0 EN
</td>
<td width="220">
November 2013
</td>
<td>
SIG 3D / Quality Working Group
(c) 2013-2014 Copyright Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
</td>
<td bgcolor="#73ff73">
public </td>

<td>
English version;
</td>
</tr>

</table>
-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method. That means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies is available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* [[ALKIS]]: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is represented by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balconies, dormers, chimneys, interior and furniture ) may be represented with greater detail as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not regulated explicitly in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute and so can not be specified and/or qualified any further;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

The following heights are valid for flat roofs, outshot roofs, gable roofs, hip roofs, jerkinhead roofs, mansard roofs, pyramid roof, shed roof, shells and domes:

[[image:Höhenangaben-01.png|800px]]

The following heights are valid for all kind of shed roofs:

[[image:Höhenangaben-02.png|800px]]

The following heights are valid for different roof overhangs:

[[image:Höhenangaben-03.png|800px]]

If absolute heights for the noted values are needed, they have to be defined as generic attributes (dimensioned ''gen:measureAttribute''):
* ''<gen:measureAttribute name="min height surface"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="min height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height eaves"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="max height ridge"><gen:value uom="#m">Value</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
In CityGML the terrain intersection line is an attribute of a building or building part. It is generated by intersection of the building or building part with the terrain and has the following properties:

* a terrain intersection line can be '''measured''' or '''calculated''' ;
* if a terrain intersection line is calculated, the terrain model with the '''highest resolution available''' should be used;
* a terrain intersection line is an '''attribute''' of the '''building or building part''';
* outer building installations (''bldg:BuildingInstallation'') are '''taken into account''' from a terrain intersection line (see '''Figure A''');
* a terrain intersection line is a result of the intersection of buildings in the respective LoD and the most accurate available terrain. In CityGML it has no relation to the terrain used in a visualization and its resolution and accuracy.
* a terrain intersection line may consist of '''several independent parts''';
* a terrain intersection line '''need not be closed''';
* a terrain intersection line which does not exist in reality will '''not be taken into account''' (e.g. in the case of building parts ).
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
<td>
Figure D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Overhanging or projecting building elements are defined as '''parts''' of roofs, walls etc, which should '''not be considered in the volume calculation of the building'''. Overhanging or projecting building elements are modeled as follows:
* always as from the volume-forming building element separated surface element(s) (see '''Figure A''')
* always as a surface element, if the thickness of the building element is less than 0.5 m (see '''Figure B''')
* always as a solid element, if the thickness of the building element is greater than 0.5 m (see '''Figure B''')
* in LoD2 always as a surface element, if the thickness of the building element is less than 0.5 m
* in LoD2 always as a solid element, if the thickness of the building element is greater than 0.5 m
* in LoD3 always in the best accuracy based on available information.


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="800">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
</tr>
<tr align="middle" valign="top">
<td width="500">
Figure A
</td>
</tr>
</table>

<table border="0" cellspacing="0">
<tr align="middle" valign="top">
<td width="500">
[[image:AuskragendeBauelemente-2.png|500px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Buildings as parts of closed coverage type (applies to semi-detached and terrace houses also) can be modeled as follows:
* Buildings that are '''separated within the land register''' should be modeled as '''separate buildings'''.
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Separate buildings of closed coverage type</td><td width="400">Terrace houses as separate buildings</td></tr></table>
* Buildings that are '''united within the land register''' should be modeled as '''one single building''' which can be subdivided into building parts (e.g. row of buildings, semi-detached or terrace houses).
<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td><td width="400">Terrace houses as building parts</td></tr></table>
* Buildings '''without any land register information''' and for which the building detection provides '''no usable structures''' (e.g. based on flights) should be modeled as '''one single building'''.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Terrace houses as one single building</td></tr></table>

The modeling of '''boundary surfaces''' between buildings must satisfy the following geometric resp. semantic conditions:
* Common boundary surfaces may only '''be referenced within a building via Xlink''' (building-building part resp. building part - building part).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* The CityGML specification allows to assign an address both to a building (''bldg:Building'', ''bldg:BuildingPart'') as well as to a door (''bldg:Door''). It is recommended '''always to assign an address to a building''' (in any LoD) because doors are not available in LoD1 and LoD2.

* It is recommended to use the complete '''postal address'''.

* '''Multiple addresses''' can be assigned to one building.

* '''Umlauts''' are allowed in addresses (z.B. <span style="color:#008000">Würzburg☺</span>, <span style="color:#008000"> Wuerzburg☺</span>, <span style="color:#FF0000">Würzburg and Wuerzburg mixed ☹</span>).

'''General example:'''

Street: Hermann-von-Helmholtz-Platz
Number: 1
Zip Code: 76344
City: Eggenstein-Leopoldshafen

'''CityGML example:'''

<core:Address>
<core:xalAddress>
<xAL:AddressDetails>
<xAL:Locality Type="Town">
<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>
<xAL:Thoroughfare Type="Street">
<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>
<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>
</xAL:Thoroughfare>
<xAL:PostalCode>
<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>
</xAL:PostalCode>
</xAL:Locality>
</xAL:AddressDetails>
</core:xalAddress>
</core:Address>
-----
-----

=== Codelists ===
Codelists for the CityGML 2.0 standard are available at "http://www.sig3d.org/codelists/standard".

The recommendations for codelists in this modeling guide refer to the proposal of the SIG3D. These codelists are availabe (in German only) at "http://www.sig3d.org/codelists/Handbuch-SIG3D" and relate to ALKIS.

This modeling guide refers to the following codelists:

*Building resp. building part (''bldg:Building / bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Building installations (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generic (user defined) attributes may be used to represent attributes which are '''not covered explicitly by the CityGML schema'''. Generic attributes must be used with care; they shall only be used if there is no appropriate attribute available in the overall CityGML schema. Otherwise, problems concerning semantic interoperability may arise. Interoperability of generic attributes is '''reduced to attribute values''' which can only be interpreted semantically by additional information.
The following attribute types are defined:

* ''stringAttribute'' - for arbitrary strings
* ''intAttribute'' - for dimensionless integer numbers
* ''doubleAttribute'' - for dimensionless floating point numbers
* ''dateAttribute'' - for dates with integer-valued year, month and day representation in the format YYYY-MM-DD (e.g. 2013-03-08)
* ''uriAttribute'' - represents a Uniform Resource Identifier Reference (URI) (e.g. a link to a document or a web site)
* ''measureAttribute'' - for dimensioned values (CityGML 2.0)

Attributes can be combined in CityGML 2.0 by generic attribute sets '''''genericAttributeSet''''' with an optional '''''codeSpace'''''. If the '''''codeSpace''''' attribute is present, then its value should identify an authority for the set, such as the organisation or community who defined its content. The generic attribute set may contain arbitrary generic attributes.

'''CityGML Examples'''

<gen:stringAttribute name="'''construction'''"><gen:value>'''concrete'''</gen:value></gen:stringAttribute>
<gen:intAttribute name="'''entries'''"><gen:value>'''3'''</gen:value></gen:intAttribute>
<gen:doubleAttribute name="'''floor area ratio FAR'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>
<gen:dateAttribute name="'''approval date'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>
<gen:uriAttribute name="'''website '''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>
<gen:measureAttribute name="'''building width'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value>/gen:measureAttribute>

<gen:genericAttributeSet name="'''Base Quantities'''">
<gen:measureAttribute name="Height"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Area"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>
<gen:measureAttribute name="Volume"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>
</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means that CityGML instance files will validate with every GML geometry. The specification '''restricts''' the usage of GML geometry classes (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML references to the following geometry classes ('''CityGML 2.0 Annex D'''):

{| border="1" style="border-collapse:collapse" width="90%" colspan="3"
|-
| style="width: 25%"|
'''Abstract Classes'''
| style="width: 25%"|
'''Instantiated Classes'''
| style="width: 50%"|
'''Further Limitations'''
|-
| rowspan="2" |
''gml:_Solid''
|
''gml:'''Solid'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''CompositeSolid'''''
|
no restriction
|-
| rowspan="6" |
''gml:_Surface''
|
''gml:'''Polygon'''''
|
only ''gml:'''LinearRing''''' and ''gml:'''Ring''''' exclusively with ''gml:LineString'' or ''gml:CompositeCurve''
|-
|
''gml:'''OrientableSurface'''''
|
no restriction
|-
|
''tex:TextureSurface''
|
obsolete
|-
|
''gml:'''CompositeSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface''

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''TriangulatedSurface'''''
|
no restriction
|-
|
''gml:'''Tin'''''
|
no restriction
|-
| rowspan="2" |
''gml:_Curve''
|
''gml:'''LineString'''''
|
no restriction
|-
|
''gml:'''CompositeCurve'''''
|
''gml:LineString'' and ''gml:CompositeCurve'' only
|-
|
''gml:_GeometricPrimitive''
|
''gml:'''Point'''''
|
no restriction
|-
|

''gml:_Coverage''
|
''gml:'''RectifiedGridCoverage'''''
|
no restriction
|-
| rowspan="6" |
''gml:_AbstractGeometricAggregate''
|
''gml:'''MultiSolid'''''
|
no restriction
|-
|
''gml:'''MultiSurface'''''
|
only ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (obsolete)
|-
|
''gml:'''MultiCurve'''''
|
only ''gml:LineString'' and ''gml:CompositeCurve''
|-
|
''gml:'''MultiPoint'''''
|
no restriction
|-
|
''gml:'''GeometricComplex'''''
|
restricted to connected linear networks
|-
|
''gml:'''MultiGeometry'''''
|
restrictrions see allowed geometry types
|-
|}

In order to keep the instance files small and to ensure an optimal editability of models, maximum flat polygons should be used, if appropriate with holes (inner rings).

-----
-----

=== File Name ===
It is recommended to use *.gml as file extension to distinguish CityGML files from other XML files.
-----
-----

== Modeling ==

=== Base Modeling ===
The base modeling includes the modeling of the '''building resp. building part''' itself in LoD1, with appropriate '''boundary surfaces''' in LoD2 and LoD3 and with '''windows and doors''' in LoD3. In addition, the basic modeling covers the general use of '''building installations'''.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''SIG3D:''' A free-standing self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (for example: a place of work or recreation), habitation and/or shelter of humans, animals or things.

'''ISO:''' Provision of shelter for its occupants or contents as one of its main purposes; usually partially or totally enclosed and designed to stand permanently in one place

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' see [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Modeling Guide - Part 1]]

It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]] as well as [[#Türen|doors]] and [[#Fenster|windows]]) ('''Figure B''') ( see also conformance requirement no. 4 in chapter 10.3.9 of the CityGML V2.0 specification )


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''gml:name'' <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'name' is the proper name or the name of the building.
; ''bldg:class'' (LoD1, LoD2, LoD3)
:The attribute ''bldg:class'' allows an unspecified classification of the building; no suggestion from the SIG3D;
; ''bldg:function'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building is the predominantly functional significance of the building at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD1, LoD2, LoD3) <span style="color:#0000FF">(conditionally recommended)</span>
:The 'usage' of a building describes the use of the building and contains the respective percentage usage share of the total use.
; ''bldg:yearOfConstruction'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'yearOfConstruction' is the year of completion of the construction or alteration of the building;
; ''bldg:yearOfDemolition'' (LoD1, LoD2, LoD3)
:The 'yearOfDemolition' is the year of deconstruction of the building;
;''bldg:roofType'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Roof type' describes the characteristic shape of the roof; see also in the code list of the SIG3D
; ''bldg:measuredHeight'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:'Measured height' is the difference in [m] between the highest point of the roof structure and the defined footprint of the building; see also [[#Heights|Heights]]
; ''bldg:storeysAboveGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys above ground' is the number of above-ground floors
; ''bldg:storeysBelowGround'' (LoD1, LoD2, LoD3) <span style="color:#00FF00">(recommended, if available in the underlying land register)</span>
:'storeys below ground' is the number of underground floors
; ''bldg:storeysHeightsAboveGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the above-ground floors
; ''bldg:storeysHeightsBelowGround'' (LoD1, LoD2, LoD3)
:Height between two consecutive floors of the underground floors
; ''bldg:lodXSolid'' (LoD1, LoD2, LoD3)
:LoDX geometry (volume)of the building
; ''bldg:lodXMultiSurface'' (LoD1, LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDX geometry (surface) of the building
; ''bldg:lodYMultiCurve'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:LoDY geometry (curve) of the building
; ''bldg:lodXTerrainIntersection'' (LoD1, LoD2, LoD3)
:LoDX geometry (curve) of the [[#Terrain Intersection Line|terrain intersection line]] of the building
; ''bldg:outerBuildingInstallation'' (LoD2, LoD3)
:Relation to LoD2/LoD3 building installation
; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])
; ''bldg:consistsOfBuildingPart'' (LoD1, LoD2, LoD3)
:Relation to LoD1/LoD2/LoD3 building parts
; ''bldg:address'' (LoD1, LoD2, LoD3)
:Relation to one or more building addresses

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Detached family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>

<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' A building part is a sub-division of a building that is homogeneous related to its physical, functional or temporal aspects and may be considered as a building.

The subdivision of a building can be done by different criteria, e.g.
* structural like number of floors, roof type, height, construction method,
* administrative like building function, ownership, year of construction.

Building parts (''bldg:BuildingParts'') must satisfy the following conditions ( necessary conditions ):
* A building part '''always''' has a relation (bldg:consistsOfBuildingPart) to '''exactly one''' building:
* Buildings and building parts '''touch each other''' planar or linear-shaped,
* Building parts must be '''"connected to ground"''' and can have the following '''properties''' ( for example, storeys are no building parts ):
** Building parts may have different '''building attributes''' ( e.g. function, roof type ),
** Building parts may have an address that '''differs''' from the address of the building,
** The geometry of building parts (''bldg:BuildingParts'') must be modeled in a way that both the '''volume''' and the '''surfaces''' of the boundary surfaces ( wall surfaces, roof surfaces and ground surfaces ) correspond to the real conditions ([[#BuildingPart/Geometry|see chapter Building Part/Geometry]]),
** If a building part is emphasized as the '''main part of the building''', its semantics and geometry can be modeled in the parent building,
** Building parts will not be subdivided into further building parts.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
;'''''gml:Solid'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]

:It is recommended to use '''''gml:Solid''''' depending on the LoD in the following way :

:*In LoD1 a solid directly contains the bounding geometry ('''Figure A''')
:*In LoD2 and LoD3 a solid contains external references (Xlinks) to the bounding geometry ([[#Wall Surface|wall surfaces]], [[#Roof Surface|roof surfaces]], [[#Ground Surface|ground surfaces]], [[#Outer Ceiling Surface|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer bottom surfaces]] and [[#Closure Surface|closure surfaces]] as well as [[#Doors|doors]] and [[#Windows|windows]]). '''Surfaces, which do not exist in reality''' are modeled as closure surfaces ('''Figure B''').
:*In LoD2 a solid contains external references (Xlinks) to the real bounding geometry. '''Surfaces, which do not exist in reality''' are modeled as closure surfaces and assigned directly to the building part ('''Figure C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>

</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommended)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommended)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Since the building part is derived from the building, all attributes of the building are also available for the building part (see also [[#BuildingAttribute|Building Attribute]]).

'''Exception:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Office with factory hall'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"structurally distinct" building parts → "Office" as function of BuildingPart 1 ; "Factory Hall" as function of BuildingPart 2
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Detached house with staggered shed roof'''
</td>
<td>
'''House with a projecting floor'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
No "structurally distinct" building parts → roofType "staggered shed roof"
</td>
<td>
No "structurally distinct" building parts; 1 building part not "connected to ground"
</td>
</tr>
</table>

'''Examples with overarching building parts'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanently installed parts of the buildings outer shell which are accessory for the building structure including loggia, dormer, etc. Doors and windows are modeled by the corresponding CityGML classes.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
;'''''gml:Geometry'''''
:'''''gml:Geometry''''' allows '''points''', '''lines''', '''areas''', '''volumes''' as well as any combination of these elements.
:The use of points is '''<span style="color:#FF0000">not recommended</span>'''. <br />
:The use of lines is only '''<span style="color:#0000FF">recommenced under certain circumstances</span>''', because not all applications are able to process this geometry.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Surfaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimney)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and surfaces (e.g. satellite dish)
</td>
<td width="300">
Lines and surfaces resp. surfaces and volumes (e.g. stair and porch)
</td>
<td width="300">
Lines, surfaces und volumes (e.g. balcony)
</td>
</tr>
</table>

; ''bldg:boundedBy'' (LoD2, LoD3)
: Relation to boundary surfaces ([[#Wandflächen|wall surfaces]], [[#Dachflächen|roof surfaces]], [[#Grundflächen|ground surfaces]], [[#Äußere_Deckenflächen|outer ceiling surfaces]], [[#Äußere_Bodenflächen|outer floor surfaces]] and [[#Virtuelle_Begrenzungsflächen|closure surfaces]]) → see also [[#ErweiterteModellierung|Extended Modeling]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>

<tr align="left" valign="center">
<td width="300">
Building with a small ridge turret (modeled as a building installation with geometry)
</td>
<td width="500">
Building with a tower (modeled as a building installation with boundary surfaces)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(mandatory)</span>
: from GML version 3.2 onwards an id is mandatory
; ''bldg:class'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:The attribute ''bldg:class'' allows an unspecified classification of the building installation; no suggestion from the SIG3D;
; ''bldg:function'' (LoD2, LoD3) <span style="color:#00FF00">(recommended)</span>
:The 'function' of a building installation is the predominantly functional significance of the building installation at the date of data collection ( principle of dominance ); see also in the SIG3D code lists.
; ''bldg:usage'' (LoD2, LoD3) <span style="color:#FF0000">(not recommended)</span>
:no suggestion from the SIG3D;
; ''bldg:lodXGeometry'' (LoD2, LoD3)
:LoDX geometry of the building installation;

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LoD1: no building installation
</td>
<td width="300">
LoD2: simplified building installation
</td>
<td width="300">
LoD3: detailed building installation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against soil or water ( e.g. foundation ).

===== CityGML Feature =====

*'''LoD1:''' not available
*'''LoD2:''' ''bldg:GroundSurface''
*'''LoD3:''' ''bldg:GroundSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:Solid|Modeling Guide for 3D Objects - Part 1]]
* A '''ground surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* The '''elevation''' of the ground surface depends on the availability of data:
** If there is information available about cellars, the elevation of the ground surface is set to the lower edge of the floor of the cellar ('''Figure A''');
** If the ground surface of the building, building part or building installation is generated by an intersection with the terrain, the elevation of the (horizontal) ground surface is set to the lowest absolute height of the corresponding terrain intersection line ('''Figure B''');
** It is <span style="color:#FF0000">not recommeded</span> to generate the ground surface of the building, building part or building installation directly from an intersection with the terrain ('''Figure C''');


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
<td>
Figure C
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the base area
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the base area
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building without cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with cellar and one floor slab
(One bldg:GroundSurface)
</td>
<td>
Building with partial cellar and two different floor slabs
(Two bldg:GroundSurface)
</td>
<td>
Building with cellar and ramp
(Two bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Building with ground surface at lower edge of floor cellar
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface at lowest absolute height of the corresponding terrain intersection line
(One bldg:GroundSurface)
</td>
<td>
Building with ground surface based on intersection with the terrain
(One bldg:GroundSurface) <span style="color:#FF0000">not recommended</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A wall surface is an exterior, lateral boundary surface of a building, building part or building installation.

'''ISO:''' A wall is a vertical construction that bounds or subdivides a space and usually fulfils a loadbearing or retaining function.

The normals of the wall surfaces should generally lie in the horizontal ( up to 45 degrees ).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:WallSurface''
* '''LoD3:''' ''bldg:WallSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''wall surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wall projections''', which do not limit the volume of the building will be modeled according to the rules for
'''[[#AuskragendeBauelemente|Cantilevered building elements]]'''.



* A '''wall surface''' ''must'' consist of '''several surfaces ( SurfaceMember )''' if :
** a wall surfaces has different '''colors''' or '''textures'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 3 areas each (1 area in "orange"; 2 areas in "beige")(4 bldg:WallSurface)</td><td>4 wall surfaces with 2 areas each (1 area with texture "plaster"; 1 area with texture "sandstone") (4 bldg:WallSurface)</td></table>
** a wall surface is '''nonplanar'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 wall surfaces; 4 wall surfaces with 1 surface each and 1 wall surface (circular wall) with 6 surfaces (4 bldg:WallSurface)</td><td>Front wall as 1 wall surface consisting of 4 surfaces (revealing areas); right wall as 1 wall surface consisting of 13 surfaces (12 revealing areas)</td></table>
* A '''wall surface''' ''might'' consist of '''several surfaces ( SurfaceMember )''' if :
** it is intended to indicate a '''storey structure'''<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 wall surfaces with 1 surface each (4 bldg:WallSurface)</td><td>4 wall surfaces with 3 surfaces each (ground floor, upper floor and top floor) (4 bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the wall
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the wall
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#Windows|windows]] ) )

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
A wall surface with 4 surfaces
(1 bldg:WallSurface)
<span style="color:#FF0000">not recommended</span>
</td>
<td>
4 wall surfaces with 1 surface each
(4 bldg:WallSurface)
</td>
<td>
4 wall surfaces (3 planar walls with 1 surface each and 1 circular wall with 12 surfaces)
(4 bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
1 wall surface with elliptic or circular layout
(1 bldg:WallSurface)
</td>
<td>
5 wall surfaces by staggered facades
(5 bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' A roof surface is a exterior, upper boundary surface of a building, building part or building installation, whose primary function is to protect from the effects of weather.
'''ISO:''' A roof is a construction that encloses a building from above

The normals of a roof should generally lie in the vertical.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:RoofSurface''
* '''LoD3:''' ''bldg:RoofSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''roof surface''' surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Roof projections''', which do not limit the volume of the building will be modeled according to the rules for '''[[#AuskragendeBauelemente|cantilevered building elements]]'''.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry of the roof
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry of the roof
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Gable Roof'''
</td>
<td width="250">
'''Mixed Roof'''
</td>
<td width="250">
'''Tent Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 roof surface with 2 surfaces
(1 bldg:RoofSurface) <span style="color:#FF0000">not recommended</span>
</td>
<td>
2 roof surfaces with 1 surface each
(2 bldg:RoofSurface)
</td>
<td>
3 roof surfaces ( 2 planar roof surfaces with 1 surface each and 1 conical roof area with 12 surfaces )
(3 bldg:RoofSurface)
</td>
<td>
1 conical roof area with 24 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Jerkinhead Roof'''
</td>
<td width="250">
'''Gambrel Roof'''
</td>
<td width="250">
'''Arch Roof'''
</td>
<td width="250">
'''Dome Roof'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
4 roof surfaces
(4 bldg:RoofSurface)
</td>
<td>
1 roof surface with 12 surfaces
(1 bldg:RoofSurface)
</td>
<td>
1 roof surface with 264 surfaces
(1 bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Shed Roof I'''
</td>
<td width="250">
'''Shed Roof II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 roof surfaces
(5 bldg:RoofSurface)
</td>
<td>
10 roof surfaces
(10 bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, upper boundary surface of a building, building part or building installation which is not a roof.

The normals of an outer floor surface should generally be vertical directed upwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterFloorSurface''
* '''LoD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An outer floor surface consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Roof terrace'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Roof terrace'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
<td>
1 OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Exterior, lower boundary surface of a building, building part or building installation against air.

The normals of an outer ceiling surface should generally be vertical directed downwards.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:OuterCeilingSurface''
* '''LoD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* An '''outer ceiling surface''' consists only of surfaces which are '''visible from the outside''' of the building, building part or building installation.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening''
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Passage'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Cantilevered floor'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
<td>
1 OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Exterior or interior boundary surface providing virtual boundaries, typically used to seal holes in volumetric objects.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:ClosureSurface''
* '''LoD3:''' ''bldg:ClosureSurface''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]
* A '''closure surface''' consists only of virtual ( imaginary ) surfaces which are '''visible from the outside''' of the building, building part or building installation.

===== Attributes =====
;''bldg:lod2MultiSurface''
:points to the LoD2 surface geometry
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:opening'' <span style="color:#FF0000">not recommended</span>
:points to a CityGML feature ''bldg:Opening'' ( ''bldg:Door'' ( see [[#Doors|doors]] ) or ''bldg:Window'' ( see [[#windows|windows]] ) )

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Open barn'''
</td>
<td width="250">
'''Railway platform hall'''
</td>
<td width="250">
'''Parking garage'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 ClosureSurface
</td>
<td>
2 ClosureSurface
</td>
<td>
28 ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''ISO 6707-1:''' Construction for closing an opening intended primarily for access or egress or both.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Door''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''door''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Door as a simple surface)
</td>
<td>
'''Case B''' (Door as a textured surface)
</td>
<td>
'''Case C''' (Door modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Door as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the doors should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Doors opened)
</td>
<td>
'''Case B''' (Doors closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry
;''bldg:address''
:points to the address of the door

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple Doors'''
</td>
<td width="250">
'''Simple Doors with Embrasure'''
</td>
<td width="250">
'''Doors modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 19
</td>
<td>
Number of Polygons (Complete Model) = 128
</td>
<td>
Number of Polygons (Complete Model) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Construction for closing an opening in a wall or roof, primarily intended to admit light and / or provide ventilation (cf. ISO 6707).

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' not available
* '''LoD3:''' ''bldg:Window''

===== Geometry =====
;'''''gml:MultiSurface'''''
:see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#gml:MultiSurface|Modeling Guide for 3D Objects - Part 1]]

* A '''window''' consists only of surfaces which are either '''visible from the outside''' of the building, building part or building installation ( case A, B or C ) or consists of '''solids''' ( case D ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Window as a simple surface)
</td>
<td>
'''Case B''' (Window as a textured surface)
</td>
<td>
'''Case C''' (Window modeled in detail with surfaces only visible from the outside)
</td>
<td>
'''Case D''' (Window as a solid)
</td>
</tr>
</table>

* In order to ensure a closed outer shell of the building, the windows should '''not''' be modeled '''in an opened state''' ( case A ) but '''in closed condition''' ( case B ).

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Case A''' (Windows opened)
</td>
<td>
'''Case B''' (Windows closed)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:points to the LoD3 surface geometry

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Simple windows'''
</td>
<td width="250">
'''Simple windows with embrasure'''
</td>
<td width="250">
'''Windows modeled in detail'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Number of Polygons (Complete Model) = 28
</td>
<td>
Number of Polygons (Complete Model) = 412
</td>
<td>
Number of Polygons (Complete Model) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
The Extended Modeling covers the modeling of frequently appearing '''architectural building components''' which significantly form the building's outer appearence. These building components are modeled as '''building installations''' as a general rule.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' A '''Balcony''' is a platform attached to a building which lies above the terrain level and projects from the building structure.
It is supported by columns or console brackets, and enclosed with a balustrade [cit. en. Wikipedia]. The word's origin lies in the Italian word "balcone", which itself originates from the old-high-german word "balcho".

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the balcony's depth >= 0.5 m;
**** Plane ground-area, if the component's thickness <= 0.5 m;
**** Plane side-walls, if the component's thickness <= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the balcony's depth >= 0.2 m;
**** Plane ground-Area, if the component's thickness <= 0.2 m;
**** Plane side-walls, if the component's thickness <= 0.2 m;
** '''Modeling principle'''
*** The building contains all geometry-containing border surfaces.
*** The balcony is modeled as a '''Building Installation with Geometry'''. That is without semantic differentiation.
*** The building's volume references (Xlink) to the corresponding boarder surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a balcony</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">not recommended</span>'''

===== Attributes =====
;''bldg:function''
:Balcony'' (1000); see SIG 3D Codelistrecommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''not recommended:'''</span> A Balcony is considered as '''one''' building component which is semantically not subdivided any further.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balconies'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>

<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML download]
</td>
</tr>


<tr align="left">
<td colspan="6">
Above terrain level, projected from the building structure --> Balcony
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>

<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML download]
</td>

</tr>
<tr align="left">
<td colspan="6">
Above terrain level, partly projected from the building structure, not bounded by 3 walls --> Balcony (no Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' A '''Loggia''' is an enclosed on top exterior room within the building footprint, which is surrounded by '''3''' walls at full storey height. From an architectonical point of view, a '''Loggia''' (from the Italian) is a room within a building, which opens to the exterior area by means of archs or other constructional appliances. At ground floor level, Loggias create a passage between the interior area and the exterior area. At upper floor levels, Loggias are used as connection passages or as outdoor seating.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Modeling only, if the Loggia's depth >= 0.5 m;
** '''Threshold LOD3:'''
*** Modeling only, if the Loggia's depth >= 0.2 m;
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces

*** The Loggia (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces. If the Loggia's floor is not part of the exterior building structure, it will be modeled as boundary surface at the building installation.
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling Principle of a Loggia</td>
</tr>
</table>


===== Attributes =====
;''bldg:function''
:Loggia (1001); see SIG 3D Codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A Loggia is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Real Building
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Interior Loggia
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Partly set back ground floor
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Multi-storey building with interior Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Multi-storey building, Loggias across the whole front-width and height
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggias across half the front-width (row house)
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Projecting Loggias
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML download] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* In this example, the geometry is modeled within the <code>lod2Solid</code> but not within the specified <code>BoundarySurface</code> elements (opposed to the standard)!

-----
-----

==== Passages ====

===== Definition =====
SIG3D: An open '''Passage''' is a part of a building at ground level for '''vehicles''' to drive through the building. It is bounded by walls and a roof.

===== CityGML Feature =====
* '''LoD1:''' not available
* '''LoD2:''' ''bldg:BuildingInstallation''
* '''LoD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2 / LOD3:
*** Modeling only, if the passage's depth and height >= 2 m;
** '''Modeling Principle''' (passage in a building)
*** The building contains all geometry-containing boundary surfaces.
*** The passage (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modeling principle of a passage </td></tr></table>
** '''Modeling Principle''' (Shared passage through two buildings)
*** Each building contains all geometry-containing boundary surfaces
*** The passage (BuildingInstallation) is assigned to the building which contains the greater part of the passage. The passage '''references (Xlink)''' to the building's corresponding boarder surfaces and complements the passage with bounding geometry at the BuildingInstallation.
*** The building's volume references (Xlink) to the building's corresponding boarder surfaces.<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modeling principle of a shared passage</td>
</tr>
</table>

<br />
'''Note:''' The modeling of buildings with a closed building construction is described in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]]

===== Attributes =====
;''bldg:function''
:Passage(1002); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A passage is considered as a building component which semantically consists of the building's boundary surfaces and possibly an exterior floor surface.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Passages'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LoD0
</td>
<td>
CityGML LoD1
</td>
<td>
CityGML LoD2
</td>
<td>
CityGML LoD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Passage inside of a building
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML download]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Two buildings with a shared passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Two offset buildings with separate passages
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Two buildings with onesided passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML download]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Two buildings with a connection section
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Upper floor passage
</td>

<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:'''
'''SIG3D:''' A '''dormer'''' is a structural element of a building that protrudes from the plane of a sloping roof surface. Dormers are used, either in original construction or as later additions, to create usable space in the roof of a building by adding headroom and usually also by enabling addition of windows [Wikipedia].

A '''dormer''' does not lie on the same plane as the building's exterior wall. The dormer (or the dormer's footprint) has a minimum offset of 0,5 m and lies inside the building's footprint.

'''SIG3D:''' The '''Zwerchhaus''' is a one or more story installation of a sloping roof surface. It consists of a gable and its own roof. The !!!Zwerchgiebel!!! follows the exterior wall's building line. That represents the difference between a !!!Zwerchhaus!!! and a gable, because a gable does not have to follow the building line. The roof of the !!!Zwerchhaus!!! is often designed as a ridge roof. The ridge follows cross to the main roof's ridge. So the rainwater pipes continue in an orthogonal way to each other.

'''Note:''' The '''zwerchhaus''' is not modeled as a part of the building installation, but as a building's boundary surface itself.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">not recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** Threshold LOD2:
*** Modeling only, if the dormer's height >= 2 m;
** Threshold LOD3:
***
** '''Modeling Principle'''
*** The building contains all geometry-containing boundary surfaces of the building structure. To close the building's volume, a ClosureSurface is modeled into the roof's gap.
*** The dormer (BuildingInstallation) '''contains all geometry-containing boundary surfaces''' of the dormer. To close the volume, either a ClosureSurface is modeled or it is closed by referencing to the building's corresponding ClosureSurface (Xlink to OrientableSurface).
*** The building's volume, the building structure's volume and the volume of the dormer ('''CompositeSolid''') reference (Xlink)to the corresponding boundary surfaces of the building structure and dormer.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling Principle of a dormer</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dormer (1003); see SIG 3D codelisten recommendation for[http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> A dormer is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dormer'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>

<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML download]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Actual Example
</td>

<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>

<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML download]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML download]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' An arcade is a succession of arches, each counter thrusting the next, supported by columns or piers, or a covered walk enclosed by a line of such arches on one or both sides. In warmer or wet climates, exterior arcades provide shelter for pedestrians.[Wikipedia]

'''SIG3D:''' An '''architrave''' (from Italian architrave, from Greek ἀρχι, archi- and Latin trabs, bar) is the lintel or beam that rests on the capitals of the columns. It is an architectural element in Classical architecture. In the ancient world, it was also called Epistyl because it was commonly built on pillars.[Wikipedia]

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">net recommended</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">recommended</span>'''
** '''Threshold LOD2:'''
*** Threshold-values for the modelling of beams: all sides of the beam's BoundingBox are >= 0.5 m
** '''Modelling principle'''
*** The building contains all geometry-containing boundary surfaces
*** The Arcade (BuildingInstallation) '''references (Xlink)''' to the building's corresponding boundary surfaces
*** The building's volume references (Xlink) to the building's corresponding boundary surfaces

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modelling principle of an arcade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arcade (1009); see SIG 3D codelist recommendation for [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''recommended:'''</span> An Arcade is considered as a building component which semantically consists of the building's boundary surfaces.

===== Examples =====

{| width="1200px" cellspacing="0" border="1" style="border:thin"
|- align="left"
| colspan="6" |
'''Arcades'''

|- valign="top" align="center"
|
Actual example


|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]

|

| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px]]

| width="200px" valign="bottom" |
|}

<br>

{| width="1200px" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arcade'''

|- valign="top" align="center"
|
Real Building



|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]



| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML download]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML download]

|}

-----
-----

Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)

2013-11-12T20:03:58Z

Wikiadmin: /* Heights */

{{TOC limit|4}}
== Document History ==

<table border="1" cellspacing="0">
<tr align="left" valign="top">
<th width="220">
Version
</th>
<th width="220">
Datum
</th>
<th width="220">
Autor/en
</th>
<th width="220">
Status
</th>
<th width="220">
Bemerkungen
</th>
</tr>
<tr align="left" valign="top">
<td>
0.8.0
</td>
<td width="220">
Januar 2012
</td>
<td>
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>
<td>
Erste Versuche
</td>
</tr>
<tr align="left" valign="top">
<td>
0.9.0
</td>
<td width="220">
April 2012
</td>
<td>
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>
<td>
Fertigstellung von Kapitel 1-4.1; 4.2 wird später bearbeitet
</td>
</tr>
<tr align="left" valign="top">
<td>
1.0.0
</td>
<td width="220">
Mai 2012
</td>
<td>
SIG 3D / AG Qualität
</td>
<td bgcolor="#73ff73">
öffentlich
</td>
<td>
Erste öffentliche Version von Kapitel 1-4.1;
</td>
</tr>
<tr align="left" valign="top">
<td>
1.1.0
</td>
<td width="220">
Januar/Februar 2013
</td>
<td>
SIG 3D / AG Qualität
</td>
<td bgcolor="#ff7777">
nicht öffentlich
</td>

<td>
Vorbereitung Version 2.0.0 mit Erweiterter Modellierung;
</td>
</tr>
<tr align="left" valign="top">
<td>
2.0.0
</td>
<td width="220">
März 2013
</td>
<td>
SIG 3D / AG Qualität
(c) 2013 Copyright Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org
</td>
<td bgcolor="#73ff73">
öffentlich
</td>

<td>
Erste öffentliche Version mit Erweiterter Modellierung;
</td>
</tr>
<tr align="left" valign="top">
<td>
2.0.0 EN
</td>
<td width="220">
November 2013
</td>
<td>
SIG 3D / Quality Working Group
(c) 2013 Copyright Special Interest Group 3D (SIG3D) of the Spatial Data Infrastructure Germany (GDI-DE) http://www.sig3d.org /EC, KHH
</td>
<td bgcolor="#73ff73">
public </td>

<td>
First English version;
</td>
</tr>

</table>
-----
-----

== Introduction ==

=== Scope ===
* The modeling recommendations are usually independent from the recording method, that means that this document is '''not''' a recording manual.
* This document describes the modeling of 3D objects on the basis of '''existing information'''. In case of lacking information, in particular in case of missing height information, objects must '''explicitly not''' be modeled. For example, if all relevant information on balconies are available, this document provides recommendations for a standardized modeling. Otherwise balconies must not be modeled.
* Recommendations are related to the Open Geospatial Consortium (OGC) standard '''CityGML version 1.0 and 2.0'''.
* This document refers to '''national (German) and European standards''' (AdV, INSPIRE) and can only be partially generalized.
* This document is restricted to the '''outer shell''' of buildings, i.e. building modeling up to LoD3
-----
-----

=== Target Group===
* Modeler
* Data holder
* Developer
-----
-----

=== Prior Knowledge Required ===
* GML: Geography Markup Language
* CityGML: Application schema for GML for the representation, storage, and exchange of virtual 3D city and landscape models
* ALKIS: Official German Land Registry Information System
-----
-----

=== Further References ===
* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=28802 CityGML 1.0 Specification]

* [https://portal.opengeospatial.org/modules/admin/license_agreement.php?suppressHeaders=0&access_license_id=3&target=http://portal.opengeospatial.org/files/%3fartifact_id=47842 CityGML 2.0 Specification]

* [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]]

* [http://www.adv-online.de/icc/extdeu/binarywriterservlet?imgUid=42b23fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true GeoInfoDok V 6.0 - Modeling of the geoinformation of the official surveying and mapping of Germany (Main Document, in German only)]

* [http://www.adv-online.de/AAA-Modell/Dokumente-der-GeoInfoDok/binarywriterservlet?imgUid=c9e63fd2-1153-911a-3b21-718a438ad1b2&uBasVariant=11111111-1111-1111-1111-111111111111&isDownload=true ALKIS feature catalogue with building information ( in German only)]
-----
-----

=== Document Conventions ===
* '''Features''' are written in ''italic characters'' with the corresponding name space in ''' ''bold characters'' '''.
* '''Examples''' are written in <tt>fixed width</tt>.
* '''Online references''' to other internal or external pages and documents are written in <span style="color:blue;">blue</span>.
* A statement which is not valid for all '''Levels of Detail''' (LoD) is noted as (LoD[1234][+]), e.g. a notation with (LoD1) is only valid for LoD1, a notation (LoD2+) is valid for all LoDs from LoD2 and above.
-----
-----

== Definitions und Determinations ==

=== Level of Detail (Building, BuildingPart)===

'''Definitions of SIG 3D:'''
* LoD0
** For every building or building part the footprint or roof outline is representad by a horizontal polygon with a well defined absolute and constant height.
* LoD1
** For every building or building part the generalized outer shell is represented by exactly one prismatic extrusion solid. Ground, floor and roof surfaces must be horizontal, lateral boundary surfaces must be vertical.
* LoD2
** For every building or building part the geometrically simplified outer shell is represented by horizontal resp. vertical outer surfaces and simplified roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be represented as semantic objects.
* LoD3
** For every building or building part the geometrically detailed outer shell is represented by detailed outer surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, wall surfaces, roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional building elements ( e.g. building installations like balkonies, dormers and chimneys ) may be more detailly represented as semantic objects. In respect to LoD2 doors and windows can be modeled as planar thematic objects.
* LoD4
** For every building or building part the geometrically detailed outer shell and interior is represented by detailed outer and inner surfaces and detailed roof shapes. All kind of surfaces ( e.g. ground surfaces, inner and outer wall surfaces, inner and outer roof surfaces, outer ceiling surfaces, outer floor surfaces, virtual closure surfaces ) and additional movable and non movable building elements ( e.g. building installations like balkonies, dormers, chimneys, interior and furniture ) may be more detailly represented as semantic objects.
-----

=== Reference Coordinate System ===
CityGML 2.0 strongly recommends the specification of a reference coordinate system. For a meaningful use of data a valid reference coordinate system is imperative, therefore a valid reference coordinate system must be defined for each instance file:

* A reference coordinate system must be defined as '''three dimensional''' (usually position and height reference system --> [[Definitionen#CCRS|see Compound Coordinate Reference System]]).
* A reference coordinate system should '''not''' be changed within an instance file.
* A reference coordinate system should be defined once within <tt><gml:Envelope></tt>.

'''Recommendations for Germany:''' ''ETRS89 / UTM / Reference ellipsoid GRS80 + DHHN92''

'''CityGML Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsDimension="3" srsName="'''urn:adv:crs:ETRS89_UTM32*DE_DHHN92_NH'''">
'''--> [[Definitionen#CCRS|see Compound Coordinate Reference System]]'''
<gml:lowerCorner srsDimension="3">458868.0 5438343.0 112.0 </gml:lowerCorner>
<gml:upperCorner srsDimension="3">458892.0 5438362.0 117.0 </gml:upperCorner>
</gml:Envelope>
</gml:boundedBy>
</tt>

'''ALKIS Example:'''

<tt>
<gml:boundedBy>
<gml:Envelope srsName="'''urn:adv:crs:ETRS89_UTM32'''">
<gml:pos>367456.554 5718128.391</gml:pos>
<gml:pos>367505.094 5718091.143</gml:pos>
</gml:Envelope>
</gml:boundedBy>
</tt>

see also [[Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)#Spatial-Reference-System|Modeling Guide for 3D Objects - Part 1]]
-----
-----

=== <span id="ModelStructure">Model Structure</span> ===

The use of ''core:CityModel'' is not explicitely regulated in the specification and in the schema. The multiple use of ''core:CityModel'' is compliant to the schema and will be validated.
In order to avoid conflicts while importing CityGML models, it is recommended to use '''exactly one''' instance of ''core:CityModel'' as '''root element'''.

-----
-----

=== <span id="Heights">Heights</span> ===
The ''measuredHeight'' is the '''measured''' or '''computed''' difference between the lowest terrain intersection point and the highest roof point with the following properties:

* the ''measuredHeight'' is a '''simple''' attribute can not further specified and/or qualified;
* the ''measuredHeight'' is '''always''' related to the '''real''' building;
* the ''measuredHeight'' is '''independent of the LoD''' of the building;
* the '''computation''' of the ''measuredHeight'' should always base on the terrain model with the '''highest available resolution'''.

For flat roof, outshot roof, gable roof, hip roof, jerkinhead roof, mansard roof,
Kegeldach, pyramid roof, shed roof, shells, dome and Turmdach gelten folgende Höhenangaben:

[[image:Höhenangaben-01.png|800px]]

Für Pultdach, Versetztes Pultdach und evtl. Sheddach gelten folgende Höhenangaben:

[[image:Höhenangaben-02.png|800px]]

Bei der Verwendung von verschiedenen Dachüberstandsvarianten gelten folgende Höhenangaben:

[[image:Höhenangaben-03.png|800px]]

Werden die in den Bildern angegebenen Absoluthöhen benötigt, müssen diese als generische Attribute (dimensionsbehaftetes ''gen:measureAttribute'') abgebildet werden:
* ''<gen:measureAttribute name="Min Geländepunkt"><gen:value uom="#m">Wert</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="Min Höhe Trauflinie"><gen:value uom="#m">Wert</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="Max Höhe Trauflinie"><gen:value uom="#m">Wert</gen:value></gen:measureAttribute>''
* ''<gen:measureAttribute name="Max Höhe Firstlinie"><gen:value uom="#m">Wert</gen:value></gen:measureAttribute>''
-----
-----

=== <span id="TerrainIntersectionLine">Terrain Intersection Line</span> ===
Die Geländeschnittlinie ist in CityGML ein Attribut des Gebäudes oder des Gebäudeteils. Sie wird durch Verschneidung des Gebäudes bzw. Gebäudeteils mit dem Gelände erzeugt und hat folgende Eigenschaften:
* die Geländeschnittlinie kann '''gemessen oder berechnet''' werden;
* wird die Geländeschnittlinie '''berechnet''', sollte das Geländemodell mit der '''höchsten verfügbaren Auflösung''' verwendet werden;
* die Geländeschnittlinie ist '''ein Attribut des Gebäudes bzw. des Gebäudeteils''';
* äußere Gebäudeinstallationen (''bldg:BuildingInstallation'') werden bei der Berechnung der Geländeschnittlinie '''berücksichtigt''' (siehe '''Bild A''');
* Die Geländeschnittlinie als Produkt der Verschneidung von Gebäuden im jeweiligen LOD und dem genauesten zur Verfügung stehenden Gelände, ist im CityGML als Attribut des Gebäudes oder des Gebäudeteils definiert und hat keinen Bezug zu dem in einer Visualisierung verwendeten Gelände und dessen Auflösung und Genauigkeit.
* die Geländeschnittlinie kann aus '''mehreren unabhängigen Stücken''' bestehen;
* die Geländeschnittlinie '''muss nicht geschlossen''' sein;
* real nicht existierende Geländeschnittlinien (z.B. bei Gebäudeteilen) werden '''nicht berücksichtigt'''.
<table width="800px" border="0" cellspacing="6">
<tr align="middle">
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall a.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall b.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall c.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:TerrainIntersection-Fall d.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Bild A
</td>
<td>
Bild B
</td>
<td>
Bild C
</td>
<td>
Bild D
</td>
</tr>

</table>
-----
-----

=== <span id="AuskragendeBauelemente">Overhanging Building Elements</span> ===
Auskragende Bauelemente sind '''Teile''' von Dächern, Wänden usw. die '''nicht bei der Volumenberechnung des Baukörpers''' berücksichtigt werden sollen. Auskragende Bauelemente werden wie folgt modelliert:
* immer als vom volumenbildenden Bauelement getrennte Fläche bzw. Flächen (siehe '''Bild A''')
* immer flächenförmig, bei einer Bauelementdicke bzw. -stärke kleiner 0,5 m (siehe '''Bild B''')
* LOD2 immer flächenförmig, wenn Bauelementdicke bzw. -stärke kleiner 0,5 m
* immer räumlich, bei einer Bauelementdicke bzw. -stärke größer 0,5 m (siehe '''Bild B''')
* LOD2 immer räumlich, wenn Bauelementdicke bzw. -stärke größer 0,5 m
* LOD3 immer maximale Genauigkeit auf der Grundlage von vorhandenen Informationen


<table border="0" cellspacing="0">
<tr align="left" valign="center">
<td width="900">
[[image:AuskragendeBauelemente-1.png|800px]]
</td>
<td width="600">
[[image:AuskragendeBauelemente-2.png|400px]]
</td>
</tr>
<tr align="middle" valign="top">
<td>
Figure A
</td>
<td>
Figure B
</td>
</tr>
</table>

-----
-----

=== <span id="ClosedCoverageType"> Closed Coverage Type</span> ===
Gebäude in geschlossener Bauweise (auch Doppel- und Reihenhäuser) werden wie folgt modelliert:
* Gebäude, die im '''Kataster eigenständig''' sind, werden als '''ein Gebäude''' modelliert.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-01-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-04-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Einzelne Gebäude in geschlossener Bauweise</td><td width="400">Reihenhaus als Einzelgebäude</td></tr></table>
* Gebäude, die im '''Kataster zusammengefasst''' sind (evtl. Gebäudezeile, Doppel- und Reihenhäuser), werden als '''ein Gebäude''' modelliert und können ggf. in '''Gebäudeteile untergliedert''' werden.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td><td width="400">[[image:GeschlosseneBauweise-03-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Reihenhaus als ein Gebäude modelliert</td><td width="400">Reihenhaus als Gebäudeteile modelliert</td></tr></table>
* Gebäude, für die '''keine Katasterinformationen''' verfügbar sind und die Gebäudeerfassung '''keine Strukturierung ermöglicht''' (z.B. u.U. Befliegung), werden als '''ein Gebäude''' modelliert.<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="400">[[image:GeschlosseneBauweise-02-V01.png|400px]]</td></tr><tr align="left" valign="center"><td width="400">Reihenhaus als ein Gebäude modelliert</td></tr></table>

Für die Modellierung der '''Begrenzungsflächen''' zwischen den Gebäuden gelten folgende geometrischen / semantischen Bedingungen:
* Gemeinsame Begrenzungsflächen dürfen nur '''innerhalb eines Gebäudes per Xlink referenziert''' werden (Gebäude - Gebäudeteil; Gebäudeteil - Gebäudeteil).

-----
-----

=== <span id="Addresses">Addresses</span> ===
* Die CityGML Spezifikation erlaubt es sowohl dem Gebäude (''bldg:Building'', ''bldg:BuildingPart'') als auch Türen (''bldg:Door'') Adressen zuzuweisen. Da Türen erst ab LOD3 zur Verfügung stehen, wird empfohlen Adressen '''immer (in jedem LOD) einem Gebäude''' zuzuordnen.

* Es wird empfohlen die vollständige '''postalische''' Adresse zu verwenden.

* Einem Gebäude können '''mehrere''' Adressen zugeordnet werden

* '''Umlaute''' dürfen in Adressen benutzt werden (z.B. <span style="color:#008000">Köln ☺</span>, <span style="color:#008000">Koeln ☺</span>, <span style="color:#FF0000">Köln und Koeln gemischt ☹</span>).

'''Beispiel allgemein:'''
<table border="0" cellspacing="0">

<tr align="left" valign="top">
<td width="150">
Straße:
</td>
<td width="400">
Hermann-von-Helmholtz-Platz
</td>
</tr>
<tr align="left" valign="top">
<td>
Hausnummer:
</td>
<td>
1
</td>
</tr>
<tr align="left" valign="top">
<td>
Postleitzahl:
</td>
<td>
76344
</td>
</tr>
<tr align="left" valign="top">
<td>
Ort:
</td>
<td>
Eggenstein-Leopoldshafen
</td>
</tr>

</table>

'''Beispiel CityGML:'''

''<core:Address>''

    ''<core:xalAddress>''

        ''<xAL:AddressDetails>''

            ''<xAL:Locality Type="Town">''

                 ''<xAL:LocalityName>'''Eggenstein-Leopoldshafen'''</xAL:LocalityName>''

                ''<xAL:Thoroughfare Type="Street">''

                    ''<xAL:ThoroughfareNumber>'''1'''</xAL:ThoroughfareNumber>''

                    ''<xAL:ThoroughfareName>'''Hermann-von-Helmholtz-Platz'''</xAL:ThoroughfareName>''

                ''</xAL:Thoroughfare>''

                ''<xAL:PostalCode>''

                    ''<xAL:PostalCodeNumber>'''76344'''</xAL:PostalCodeNumber>''

                ''</xAL:PostalCode>''

            ''</xAL:Locality>''

        ''</xAL:AddressDetails>''

    ''</core:xalAddress>''

''</core:Address>''
-----
-----

=== Codelists ===
Die Codelisten für den internationalen Standard CityGML 2.0 können unter "http://www.sig3d.org/codelists/standard" heruntergeladen werden.

Empfehlungen in diesem Handbuch beziehen sich auf den Codelisten Vorschlag der SIG 3D. Diese Codelisten sind unter "http://www.sig3d.org/codelists/Handbuch-SIG3D" zu finden.
Die Codelisten sind in deutscher Sprache und in Anlehnung an ALKIS.

In diesem Handbuch wird sich auf folgenden Codelists bezogen:

*Gebäude/Gebäudeteil (''bldg:Building/bldg:BuildingPart'')
**class http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_class.xml
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_function.xml
**usage http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_usage.xml
**roofType http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/_AbstractBuilding_roofType.xml

*Gebäude Installationen (''bldg:BuildingInstallation'')
**function http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml

-----
-----

=== Generic Attributes ===
Generische Attribute bieten die Möglichkeit eigene, in CityGML nicht definierte Attribute abzubilden. Da diese Attribute '''keine im Standard verankerten Definitionen''' haben, beschränkt sich die '''Interoperabilität''' lediglich auf die entsprechenden '''Attributwerte'''. Eine semantische Auswertung kann nur durch '''zusätzliche''' Informationen erfolgen. Es stehen folgende Attributtypen zur Verfügung:
* ''stringAttribute'' - erlaubt eine beliebige Zeichenfolge
* ''intAttribute'' - erlaubt einen dimensionslosen ganzzahligen Wert
* ''doubleAttribute'' - erlaubt eine dimensionslose Gleitkommazahl
* ''dateAttribute'' - erlaubt eine Datumsangabe im Format Jahr-Monat-Tag (2012-03-08)
* ''uriAttribute'' - erlaubt eine URI (Unified Resource Identifier) (z.B. Verweis auf ein Dokument oder eine Webseite)
* ''measureAttribute'' - erlaubt dimensionsbehaftete Werte (CityGML 2.0)

Zur '''Gruppierung''' von generischen Attributen steht mit CityGML 2.0 '''''genericAttributeSet''''' zur Verfügung.

'''Examples CityGML'''

''<gen:stringAttribute name="'''Bauweise'''"><gen:value>'''Massivbau'''</gen:value></gen:stringAttribute>''

''<gen:intAttribute name="'''Anzahl der Eingänge'''"><gen:value>'''3'''</gen:value></gen:intAttribute>''

''<gen:doubleAttribute name="'''Grundflächenzahl GFZ'''"><gen:value>'''0.33'''</gen:value></gen:doubleAttribute>''

''<gen:dateAttribute name="'''Datum der Baufreigabe'''"><gen:value>'''2012-03-09'''</gen:value></gen:dateAttribute>''

''<gen:uriAttribute name="'''Web Seite'''"><gen:value>'''http://www.sig3d.org'''</gen:value></gen:uriAttribute>''

''<gen:measureAttribute name="'''Breite des Gebäudes'''"><gen:value uom="#'''m'''">'''10.00'''</gen:value></gen:measureAttribute>''

''<gen:genericAttributeSet name="'''Basismengen'''">''

:''<gen:measureAttribute name="Höhe"><gen:value uom="#m">9.00</gen:value></gen:measureAttribute>''

:''<gen:measureAttribute name="Grundflächen"><gen:value uom="#m2">80.00</gen:value></gen:measureAttribute>''

:''<gen:measureAttribute name="Volumen"><gen:value uom="#m3">720.00</gen:value></gen:measureAttribute>''

</gen:genericAttributeSet>
-----
-----

=== Geometry ===

There is '''no GML Profile''' for CityGML. This means, that CityGML instance files will validate with all GML geometry. Die '''Spezifikation schränkt''' aber die Nutzung der GML Geometrieklassen ein (CityGML 2.0 Annex D "Overview of employed GML3 geometry classes).
CityGML referenziert auf folgende Geometrieklassen ('''CityGML 2.0 Annex D'''):

<table width="1200px" border="1" cellspacing="0">
<tr align="left">
<td width="250px">
'''Abstract Classes'''
</td>
<td width="250px">
'''Instanziierbare Classes'''
</td>
<td width="700px">
'''Further Limitation'''
</td>
</tr>
<tr>
<td width="250px" rowspan="2">
''gml:_Solid''
</td>
<td width="250px">
''gml:'''Solid'''''
</td>
<td>
nur ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (veraltet)
</td>
</tr>
<tr>
<td>
''gml:'''CompositeSolid'''''
</td>
<td>
keine Einschränkung
</td>
</tr>

<tr>
<td rowspan="6">
''gml:_Surface''
</td>
<td>
''gml:'''Polygon'''''
</td>
<td>
nur ''gml:'''LinearRing''''' und ''gml:'''Ring''''' ausschließlich mit ''gml:LineString'' oder ''gml:CompositeCurve''
</td>
</tr>
<tr>

<td>
''gml:'''OrientableSurface'''''
</td>
<td>
keine Einschränkung
</td>
</tr>
<tr>

<td>
''tex:TextureSurface''
</td>
<td>
veraltet
</td>
</tr>
<tr>

<td>
''gml:'''CompositeSurface'''''
</td>
<td>
nur ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (veraltet)
</td>
</tr>
<tr>

<td>
''gml:'''TriangulatedSurface'''''
</td>
<td>
keine Einschränkung
</td>
</tr>
<tr>

<td>
''gml:'''Tin'''''
</td>
<td>
keine Einschränkung
</td>
</tr>

<tr>
<td rowspan="2">
''gml:_Curve''
</td>
<td>
''gml:'''LineString'''''
</td>
<td>
keine Einschränkung
</td>
</tr>
<tr>
<td>
''gml:'''CompositeCurve'''''
</td>
<td>
nur ''gml:LineString'' und ''gml:CompositeCurve''
</td>
</tr>
<tr>
<td>
''gml:_GeometricPrimitive''
</td>
<td>
''gml:'''Point'''''
</td>
<td>
keine Einschränkung
</td>
</tr>
<tr>

<td>
''gml:_Coverage''
</td>
<td>
''gml:'''RectifiedGridCoverage'''''
</td>
<td>
keine Einschränkung
</td>
</tr>


<tr>
<td rowspan="6">
''gml:_AbstractGeometricAggregate''
</td>
<td>
''gml:'''MultiSolid'''''
</td>
<td>
keine Einschränkung
</td>

</tr>
<tr>
<td>
''gml:'''MultiSurface'''''
</td>
<td>
nur ''gml:OrientableSurface'', ''gml:Polygon'', ''gml:CompositeSurface'',

''tex:TexturedSurface'' (veraltet)
</td>
</tr>
<tr>
<td>
''gml:'''MultiCurve'''''
</td>
<td>
nur ''gml:LineString'' und ''gml:CompositeCurve''
</td>
</tr>
<tr>
<td>
''gml:'''MultiPoint'''''
</td>
<td>
keine Einschränkung
</td>
</tr>
<tr>
<td>
''gml:'''GeometricComplex'''''
</td>
<td>
beschränkt auf verbundene lineare Netzwerke
</td>
</tr>
<tr>
<td>
''gml:'''MultiGeometry'''''
</td>
<td>
Beschränkungen siehe mögliche Geometrietypen
</td>

</tr>

</table>

Um die Instanzdateien klein zu halten und um eine optimale Editierbarkeit der Modelle zu gewährleisten, sind größtmögliche ebene Polygone ggf. mit Löchern (innere Ringe) anzustreben.

-----
-----

=== File Name ===
In order to differ CityGML files from other XML files, it is recommended to use *.gml as file extension
-----
-----

== Modeling ==

=== Base Modeling ===
Die Basismodellierung umfasst die Modellierung von dem '''Gebäude/Gebäudeteil''' selbst (LOD1), mit entsprechenden '''Begrenzungsflächen''' (LOD2 und LOD3) und mit '''Fenstern und Türen''' (LOD3). Zusätzlich deckt die Basismodellierung die allgemeine Anwendung von '''Gebäudeinstallationen''' ab.
-----
-----
==== <span id="Building">Building (''bldg:Building'')</span> ====

===== Definition =====
'''ALKIS: [A]''' 'Gebäude' ist ein dauerhaft errichtetes Bauwerk, dessen Nachweis wegen seiner Bedeutung als Liegenschaft erforderlich ist sowie dem Zweck der Basisinformation des Liegenschaftskatasters dient.
'''SIG3D:''' Gebäude können auch unterirdisch sein.

===== CityGML Feature =====
''bldg:Building''

===== Geometry =====
'''''gml:Solid''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid| Handbuch - Teil 1]]

Für die Verwendung von gml:Solid wird abhängig vom LOD folgende Vorgehensweise empfohlen:

*Bei LOD1 enthält der Solid direkt die begrenzende Geometrie ('''Fall A''')
*Bei LOD2/LOD3 enthält der Solid Referenzen (Xlinks) auf die Geometrie der Begrenzungsflächen ([[#Wandflächen|Wand-]], [[#Dachflächen|Dach-]], [[#Grundflächen|Grund-]], [[#Äußere_Deckenflächen|Äußere Decken-]], [[#Äußere_Bodenflächen|Äußere Boden-]] und [[#Virtuelle_Begrenzungsflächen|virtuelle Begrenzungsfläche]] sowie [[#Türen|Türen]] und [[#Fenster|Fenster]]) ('''Fall B''')(siehe auch CityGML V2.0 Spezifikation Kapitel 10.3.9 Conformance requirements, Conformance requirement Nr. 4)


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:BuildingSolid-V1.png|300px]]
</td>
<td width="400">
[[image:BuildingSolidXlink.png|350px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Fall A
</td>
<td>
Fall B
</td>
</tr>
</table>

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(not recommented)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(not recommented)</span>'''

===== <span id="BuildingAttributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(verpflichtend)</span>
: mit der GML Version 3.2 wird eine id verpflichtend
; ''gml:name'' <span style="color:#00FF00">(empfohlen, wenn auch in ALKIS vorhanden)</span>
:in Anlehnung an ALKIS: 'Name' ist der Eigenname oder die Bezeichnung des Gebäudes.
; ''bldg:class'' (LOD1, LOD2, LOD3)
:Das Attribut ''bldg:class'' erlaubt eine nicht näher definierte Klassifikation der Gebäude; kein Vorschlag von SIG 3D;
; ''bldg:function'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(recommented)</span>
:in Anlehnung an ALKIS: 'Gebäudefunktion' ist die zum Zeitpunkt der Erhebung vorherrschend funktionale Bedeutung des Gebäudes (Dominanzprinzip); siehe Codeliste SIG 3D
; ''bldg:usage'' (LOD1, LOD2, LOD3) <span style="color:#0000FF">(bedingt empfohlen)</span>
:in Anlehnung an ALKIS: 'Nutzung' ist die Gebäudenutzung und enthält den jeweiligen prozentualen Nutzungsanteil an der Gesamtnutzung. Die Werte für das Attribut in ALKIS und CityGML sind sehr unterschiedlich.
; ''bldg:yearOfConstruction'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(recommented)</span>
:in Anlehnung an ALKIS: 'Baujahr' ist das Jahr der Fertigstellung oder der baulichen Veränderung des Gebäudes;
; ''bldg:yearOfDemolition'' (LOD1, LOD2, LOD3)
:Jahr des Rückbaus
;''bldg:roofType'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(recommented)</span>
:in Anlehnung an ALKIS: 'Dachform' beschreibt die charakteristische Form des Daches; siehe Codeliste SIG 3D
; ''bldg:measuredHeight'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(recommented)</span>
:in Anlehnung an ALKIS: 'Objekthöhe' ist die Höhendifferenz in [m] zwischen dem höchsten Punkt der Dachkonstruktion und der festgelegten Grundfläche des Gebäudes; siehe auch Kapitel [[#Höhenangaben|Höhenangaben]]
; ''bldg:storeysAboveGround'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(empfohlen, wenn auch in ALKIS vorhanden)</span>
:in Anlehnung an ALKIS: 'Anzahl der oberirdischen Geschosse' ist die Anzahl der oberirdischen Geschosse des Gebäudes
; ''bldg:storeysBelowGround'' (LOD1, LOD2, LOD3) <span style="color:#00FF00">(empfohlen, wenn auch in ALKIS vorhanden)</span>
:in Anlehnung an ALKIS: 'Anzahl der unterirdischen Geschosse' ist die Anzahl der unterirdischen Geschosse des Gebäudes
; ''bldg:storeysHeightsAboveGround'' (LOD1, LOD2, LOD3)
:Geschosshöhen der oberirdischen Geschosse
; ''bldg:storeysHeightsBelowGround'' (LOD1, LOD2, LOD3)
:Geschosshöhen der unterirdischen Geschosse
; ''bldg:lodXSolid'' (LOD1, LOD2, LOD3)
:Zeigt auf die LODX Volumengeometrie des Gebäudes
; ''bldg:lodXMultiSurface'' (LOD1, LOD2, LOD3) <span style="color:#FF0000">(not recommented)</span>
:Zeigt auf die LODX Flächengeometrie des Gebäudes
; ''bldg:lodYMultiCurve'' (LOD2, LOD3) <span style="color:#FF0000">(not recommented)</span>
:Zeigt auf die LODY Liniengeometrie des Gebäudes
; ''bldg:lodXTerrainIntersection'' (LOD1, LOD2, LOD3)
:Zeigt auf die LODX Liniengeometrie der [[#Geländeschnittlinien|Geländeschnittlinie]] des Gebäudes
; ''bldg:outerBuildingInstallation'' (LOD2, LOD3)
:Zeigt auf LOD2/LOD3 BuildingInstallation
; ''bldg:boundedBy'' (ab LOD2)
: Zeigt auf Begrenzungsflächen ([[#Wandflächen|Wand-]], [[#Dachflächen|Dach-]], [[#Grundflächen|Grund-]], [[#Äußere_Deckenflächen|Äußere Decken-]], [[#Äußere_Bodenflächen|Äußere Boden-]] und [[#Virtuelle_Begrenzungsflächen|virtuelle Begrenzungsfläche]])
; ''bldg:consistsOfBuildingPart'' (LOD1, LOD2, LOD3)
:Zeigt auf LOD1/LOD2/LOD3 BuildingPart
; ''bldg:address'' (LOD1, LOD2, LOD3)
:Zeigt auf eine oder mehrere Adressen

===== Examples =====

<table width="1200px" border="0" cellspacing="6">
<tr align="left">
<td colspan="6">
'''Single family house'''
</td>
</tr>
<tr align="middle">
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-real.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-ALKIS.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD0.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD1.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD2.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Building-Example-1-V1-LOD3.png|200px]]
</td>
<tr align="middle" valign="top">
<td>
Real Building
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

</table>
-----
-----

==== <span id="Gebäude">Building Part (''bldg:BuildingPart'')</span> ====

===== Definition =====
'''SIG3D:''' '''building part''' (''bldg:BuildingParts'') sind miteinander verbundene Baukörper eines Gebäudekomplexes ([http://de.wikipedia.org/wiki/Geb%C3%A4udetrakt siehe Gebäudetrakt (Wikipedia)]). Die Aufteilung der Baukörper kann nach verschiedenen Kriterien erfolgen, z.B.:
* Konstruktive Kriterien: Anzahl der Stockwerke, Dachform, Höhe, Bauweise,
* Administrative Kriterien: Gebäudefunktion, Besitzverhältnisse, Baujahr.

Gebäudeteile (''bldg:BuildingParts'') müssen folgende Bedingungen (notwendige Bedingungen) erfüllen:
* Ein Gebäudeteil hat '''immer''' eine Relation (bldg:consistsOfBuildingPart) zu '''genau einem''' Gebäude
* Gebäude und Gebäudeteile '''berühren sich''' (flächig oder linienförmig),
* Gebäudeteile sind '''"bodenständig"''' (z.B. Geschosse sind keine Gebäudeteile) und können folgende '''Eigenschaften''' haben:
** Gebäudeteile dürfen unterschiedliche '''Gebäudeattribute''' haben (Funktion, Dachtyp usw.),
** Gebäudeteile dürfen vom Gebäude '''abweichende Adressen''' haben,
** die Geometrie der Gebäudeteile (''bldg:BuildingParts'') muss so modelliert werden, dass sowohl das '''Volumen''' als auch die '''Oberflächen''' der Begrenzungsflächen (Wand-, Dach- und Bodenflächen) den realen Verhältnissen entsprechen ([[#BuildingPart/Geometrie|siehe Kapitel Gebäudeteil/Geometrie]]),
** Soll ein Gebäudeteil als '''Hauptgebäudeteil''' hervorgehoben werden, kann dessen Semantik und Geometrie im übergeordneten Gebäude modelliert werden,
** Gebäudeteile werden nicht weiter in Gebäudeteile unterteilt.

===== CityGML Feature =====

''bldg:BuildingPart''

===== <span id="BuildingPart/Geometry"> Geometry</span> =====
'''''gml:Solid''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:Solid|Handbuch - Teil 1]]

Für die Verwendung von gml:Solid wird abhängig vom LOD folgende Vorgehensweise empfohlen:

*Bei LOD1 enthalten die Solids direkt die begrenzende Geometrie ('''Fall A''').
*Bei LOD2/LOD3 enthalten die Solids Referenzen (Xlinks) auf die Geometrie der Begrenzungsflächen ([[#Wandflächen|Wand-]], [[#Dachflächen|Dach-]], [[#Grundflächen|Grund-]], [[#Äußere_Deckenflächen|Äußere Decken-]], [[#Äußere_Bodenflächen|Äußere Boden-]] und [[#Virtuelle_Begrenzungsflächen|virtuelle Begrenzungsfläche]] sowie [[#Türen|Türen]] und [[#Fenster|Fenster]]). '''Real nicht existierende Flächen''' werden als virtuelle Begrenzungsflächen modelliert ('''Fall B''').
*Bei LOD2/LOD3 enthalten die Solids Referenzen (Xlinks) auf die Geometrie der realen Begrenzungsflächen. '''Real nicht existierende Flächen''', die für den Solid notwendig sind, werden direkt an das Gebäudeteil zugeordnet ('''Fall C''').


<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-FallB.png|200px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD1-gedreht.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallB.png|300px]]
</td>
<td width="400">
[[image:Geometrie-Beispiel-Wiki-LOD2-gedreht-FallC.png|300px]]
</td>
</tr>

<tr align="left" valign="top">
<td>
Fall A
</td>
<td>
Fall B
</td>
<td>
Fall C
</td>

</tr>
</table>

'''''bldg:boundedBy''''' Relation zu Begrenzungsflächen ([[#Wandflächen|Wand-]], [[#Dachflächen|Dach-]], [[#Grundflächen|Grund-]], [[#Äußere_Deckenflächen|Äußere Decken-]], [[#Äußere_Bodenflächen|Äußere Boden-]] und [[#Virtuelle_Begrenzungsflächen|virtuelle Begrenzungsfläche]])

'''''gml:MultiSurface''''' ''' <span style="color:#FF0000">(nicht empfohlen)</span>'''

'''''gml:MultiCurve''''' '''<span style="color:#FF0000">(nicht empfohlen)</span>'''

===== <span id="BuildingAttribute">Attributes</span> =====
Da der Gebäudeteil vom Gebäude abgeleitet ist, stehen alle Attribute des Gebäudes auch für den Gebäudeteil zur Verfügung (siehe [[#BuildingAttribute|Gebäude Attribute]]).

'''Ausnahme:''' ''bldg:consistsOfBuildingPart''

===== Examples =====
<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Büro mit Werkshalle'''
</td>
<td>

</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:Buero-Werkshalle-01.png|500px]]
</td>
<td width="550px" valign="bottom">

</td>

</tr>
<tr align="left">
<td>
"strukturell eigenständige" Gebäudeteile --> function BuildingPart 1 "2020" "Bürogebäude"; function BuildingPart 2 "2210" "Produktionsgebäude"
</td>
<td>

</td>
</tr>
</table>

<table width="1100px" border="0" cellspacing="0">
<tr align="left">
<td>
'''Einfamilienhaus mit versetztem Pultdach'''
</td>
<td>
'''Haus mit vorspringendem Geschoss'''
</td>
</tr>
<tr align="left">
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts.png|500px]]
</td>
<td width="550px" valign="bottom">
[[image:FJK-Haus-BuildingParts-03.png|500px]]
</td>

</tr>
<tr align="left">
<td>
Keine "strukturell eigenständige" Gebäudeteile --> roofType "2200" "versetztes Pultdach"
</td>
<td>
Keine "strukturell eigenständige" Gebäudeteile; 1 Gebäudeteil nicht "bodenständig"
</td>
</tr>
</table>

'''Beispiele mit grundrissübergreifenden Bauteilen'''

Variante 1
[[image:Variante-01-V2-red.png|500px]]

'''Variante 2'''
[[image:Variante-02-V1-red.png|500px]]

Variante 3
[[image:Variante-03-V2-red.png|500px]]

-----
-----

==== <span id="BuildingInstallation">Building Installations (''bldg:BuildingInstallation'')</span> ====

===== Definition =====
'''SIG3D:''' Permanent installierte '''Teile der Außenhülle''', die zur Gebäudestruktur gehören inklusive Loggia, Gauben usw. Türen und Fenster müssen durch die entsprechenden CityGML Klassen modelliert werden.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:BuildingInstallation''
*'''LOD3:''' ''bldg:BuildingInstallation''

===== <span id="BuildingInstallation/Geometry"> Geometry</span> =====
'''''gml:Geometry'''''

'''''gml:Geometry''''' erlaubt '''Punkte''', '''Linien''', '''Flächen''', '''Volumen''' und jede Kombination der genannten Geometrie Elemente. Die Verwendung von Punkten wird '''<span style="color:#FF0000">nicht empfohlen</span>'''. Die Verwendung von Linien wird nur '''<span style="color:#0000FF">bedingt empfohlen</span>''', da nicht alle Anwendungen diese Geometrie verarbeiten können.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-Antenne-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-SolarPanel-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Kamin-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines (e.g. Antenna)
</td>
<td width="300">
Sufaces (e.g. Solar Panel)
</td>
<td width="300">
Volumes (e.g. Chimny)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:Haus-mit-SatellitenAntenne-V2.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Treppe-V2-MultiGeo-V1.png|300px]]
</td>
<td width="300">
[[image:Haus-mit-Balkon-V2.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Lines and Surfaces (z.B. Satellitenantenne)
</td>
<td width="300">
Lines and Surfaces bzw. Surfaces and Volumes (z.B. Eingangstreppe und Vordach)
</td>
<td width="300">
Lines, Surfaces und Volumes (e.g. Balcony)
</td>
</tr>
</table>

'''''bldg:boundedBy''''' Relation zu Begrenzungsflächen ([[#Wandflächen|Wand-]], [[#Dachflächen|Dach-]], [[#Grundflächen|Grund-]], [[#Äußere_Deckenflächen|Äußere Decken-]], [[#Äußere_Bodenflächen|Äußere Boden-]] und [[#Virtuelle_Begrenzungsflächen|virtuelle Begrenzungsfläche]]) --> siehe auch [[#ErweiterteModellierung|Erweiterte Modellierung]]

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Haus mit kleinem Turm (Modelliert als Gebäudeinstallation mit Geometrie)
</td>
<td width="500">
Haus mit begehbarem Turm (Modelliert als Gebäudeinstallation mit Begrenzungsflächen)
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1-explode.png|200px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1-explode.png|320px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
Haus mit kleinem Turm (Modelliert als Gebäudeinstallation mit Geometrie)
</td>
<td width="500">
Haus mit begehbarem Turm (Modelliert als Gebäudeinstallation mit Begrenzungsflächen)
</td>
</tr>
</table>

===== <span id="BuildingInstallation/Attributes">Attributes</span> =====
; ''gml:id'' <span style="color:#008000">(verpflichtend)</span>
: mit der GML Version 3.2 wird eine id verpflichtend
; ''bldg:class'' (LOD2, LOD3) <span style="color:#0000FF">(nicht empfohlen)</span>
:Keine Definition der SIG3D;
; ''bldg:function'' (LOD2, LOD3) <span style="color:#00FF00">(empfohlen)</span>
: Art der Gebäudeinstallation zum Zeitpunkt der Erhebung; siehe Codeliste SIG 3D;
; ''bldg:usage'' (LOD2, LOD3) <span style="color:#0000FF">(nicht empfohlen)</span>
:Keine Definition der SIG3D;
; ''bldg:lodXGeometry'' (LOD2, LOD3)
:Zeigt auf die LODX Geometrie der Gebäudeinstallation

===== <span id="BuildingInstallation/Examples">Examples</span> =====
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD1-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-LOD2-V1.png|300px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-Solid-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LOD1 keine Gebäudeinstallation
</td>
<td width="300">
LOD2 generalisierte Gebäudeinstallation
</td>
<td width="300">
LOD3 detaillierte Gebäudeinstallation
</td>
</tr>
</table>
<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD1-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-V1.png|400px]]
</td>
<td width="300">
[[image:LoD2-Haus-Turm-BoundeBy-LOD3-V1.png|400px]]
</td>
</tr>
<tr align="left" valign="center">
<td width="300">
LOD1 keine Gebäudeinstallation
</td>
<td width="300">
LOD2 generalisierte Gebäudeinstallation
</td>
<td width="300">
LOD3 detaillierte Gebäudeinstallation
</td>
</tr>
</table>

------
------

==== <span id="GroundSurfaces">Ground Surfaces (''bldg:GroundSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Die '''Grundfläche''' (''bldg:GroundSurface'') eines Gebäudes ist die '''äußere Fläche''' eines Bauteils [[Definitionen#Fußboden|Fußboden]], das das Gebäude nach unten gegen Erde oder Wasser begrenzt. Die Normalen der Grundflächen zeigen in der Regel nach unten.

===== CityGML Feature =====

*'''LOD1:''' not available
*'''LOD2:''' ''bldg:GroundSurface''
*'''LOD3:''' ''bldg:GroundSurface''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]
* Eine Grundfläche besteht nur aus den '''von außen sichtbaren''' Flächen.

[[image:GroundSurface-Flaech-Volumen.png|600px]]

* Die '''Lage (Elevation)''' der Grundfläche wird durch die Datenverfügbarkeit bestimmt:
** Liegen Informationen über Kellergeschosse vor, so liegt die Grundfläche bei Unterkante Kellerboden (Fall A);
** Wird die untere Berandung des Gebäudes durch den Verschnitt mit dem Gelände erzeugt, so liegt die Grundfläche auf dem Niveau des niedrigsten absoluter Geländepunkts der Geländeschnittlinie (Fall B);
** Wird die Grundfläche aus dem Verschnitt mit dem Gelände erzeugt, liegt die Grundfläche auf dem Gelände (<span style="color:#FF0000">nicht empfohlen</span>)(Fall C).


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-Skizze-5-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-Skizze-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
'''Fall A'''
</td>
<td>
'''Fall B'''
</td>
<td>
'''Fall C'''
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>

===== Attribute =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Flächengeometrie der Grundfläche
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Flächengeometrie der Grundfläche
;''bldg:opening'' <span style="color:#FF0000">not recommented</span>
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Beispiele =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-2-V1.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-3-V1.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Einfache Bodenplatte ohne Keller
(1x bldg:GroundSurface)
</td>
<td>
Einfache Bodenplatte im Keller
(1x bldg:GroundSurface)
</td>
<td>
Zwei getrennte Bodenflächen bei teilweise unterkellertem Gebäude
(2x bldg:GroundSurface)
</td>
<td>
Zwei Bodenflächen mit unterschiedlicher Orientierung bei Rampen
(2x bldg:GroundSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:GroundSurface-5-V2.png|250px]]
</td>
<td width="253">
[[image:GroundSurface-6-V2.png|250px]]
</td>
<td width="250">
[[image:GroundSurface-7-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Bodenfläche auf dem Niveau des Kellerbodens
(1x bldg:GroundSurface)
</td>
<td>
Bodenfläche auf dem Niveau des niedrigsten Punktes der Geländeschnittlinie
(1x bldg:GroundSurface)
</td>
<td>
Bodenfläche als Ergebnis mit dem Geländeverschnitt
(1x bldg:GroundSurface) <span style="color:#FF0000">nicht empfohlen</span>

</td>

</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="WallSurfaces">Wall Surfaces (''bldg:WallSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Die '''Wandfläche''' (WallSurface) eines Gebäudes ist die '''äußere Fläche''' eines Bauteils [[Definitionen#Wand|Wand]], das das Gebäude seitlich gegen Erde, Wasser und Luft begrenzt. Die Normalen der Wandflächen liegen in der Regel in der Horizontalen (+45 / -45).

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:WallSurface''
* '''LOD3:''' ''bldg:WallSurface''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]

* Eine '''Wandfläche''' besteht nur aus den '''von außen sichtbaren''' Flächen.

[[image:WallSurface-Flaechen-Volumen.png|600px]]

* '''Wandüberstände''', die das Gebäudevolumen nicht begrenzen, werden entsprechend den Regel für '''[[#AuskragendeBauelemente|auskragende Bauelemente (Kap. 3.5)]]''' modelliert.



* Eine '''Wandfläche''' muss aus '''mehreren Flächen (SurfaceMember)''' bestehen wenn:
** eine Wandfläche verschiedene '''Farben''' oder '''Texturen''' hat<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-mit-Farben-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Texturen-V1.png|300px]]</td><tr align="left" valign="top"><td>4 Wandflächen mit je 3 Fläche (1 Fläche "Orange"; 2 Flächen "Beige")(4x bldg:WallSurface)</td><td>4 Wandflächen mit je 2 Flächen (1 Fläche Textur "Putz"; 1 Fläche Textur "Sandstein") (4x bldg:WallSurface)</td></table>
** eine Wandfläche '''nicht planar''' ist<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-Rund-V1.png|300px]]</td><td width="300">[[image:WallSurface-Laibungen-V1.png|300px]]</td><tr align="left" valign="top"><td>5 Wandflächen; 4 Wandflächen mit je 1 Fläche und 1 Wandfläche (runde Wand) mit 6 Flächen (4x bldg:WallSurface)</td><td>Wand vorne 1 Wandfläche mit 4 Flächen (Laibungsflächen); Wand rechts 1 Wandfläche mit 13 Flächen (12 Laibungsflächen)</td></table>
* Eine '''Wandfläche''' kann aus '''mehreren Flächen (SurfaceMember)''' bestehen wenn:
** eine '''Stockwerksstruktur''' angedeutet werden soll<table border="0" cellspacing="6"><tr align="left" valign="top"><td width="300">[[image:WallSurface-ohne-Stockwerke-V1.png|300px]]</td><td width="300">[[image:WallSurface-mit-Stockwerke-V1.png|300px]]</td><tr align="left" valign="top"><td>4 Wandflächen mit je 1 Fläche(4x bldg:WallSurface)</td><td>4 Wandflächen mit je 3 Flächen (Erd-, Ober- und Dachgeschoss)(4x bldg:WallSurface)</td></table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Geometrie
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:opening''
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Examples =====
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-0-V2.png|250px|link=WallSurface-0-Animation]]
</td>
<td width="250">
[[image:WallSurface-1-V2.png|250px|link=WallSurface-1-Animation]]
</td>
<td width="250">
[[image:WallSurface-2-V2.png|250px|link=WallSurface-2-Animation]]
</td>
<tr align="left" valign="top">
<td>
Eine Wandfläche mit 4 Flächen
(1x bldg:WallSurface)
<span style="color:#FF0000">nicht empfohlen</span>
</td>
<td>
Vier Wandflächen mit je 1 Fläche
(4x bldg:WallSurface)
</td>
<td>
Vier Wandflächen (drei gerade Wände mit je 1 Flächen und eine gekrümmte Wand mit 12 Flächen)
(4x bldg:WallSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:WallSurface-3-V2.png|250px]]
</td>
<td width="250">
[[image:WallSurface-4-V2.png|250px]]
</td>
<tr align="left" valign="top">
<td>
Eine Wandfläche bei ellipsenförmigen oder runden Grundrissen
(1x bldg:WallSurface)
</td>
<td>
5 Wandflächen durch versetzte Fassadenteile
(5x bldg:WallSurface)
</td>
</table>
-----
-----

==== <span id="RoofSurfaces">Roof Surfaces (''bldg:RoofSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Die '''Dachfläche''' (RoofSurface) eines Gebäudes ist die '''äußere Fläche''' eines Bauteils [[Definitionen#Dach|Dach]], das das Gebäude seitlich gegen Luft begrenzt. Die Normalen der Dachflächen zeigen in der Regel nach oben.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:RoofSurface''
* '''LOD3:''' ''bldg:RoofSurface''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]

* Eine Dachfläche besteht nur aus den von '''außen sichtbaren''' Flächen.

[[image:RoofSurface-Flaechen-Volumen.png|600px]]

* '''Dachüberstände''', die das Gebäudevolumen nicht begrenzen, werden entsprechend den Regel für '''[[#AuskragendeBauelemente|auskragende Bauelemente (Kap. 3.5)]]''' modelliert

===== Attributes =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Geometrie
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:opening''
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Satteldach'''
</td>
<td width="250">
'''Satteldach'''
</td>
<td width="250">
'''Mischform'''
</td>
<td width="250">
'''Zeltdach'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-0-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-1-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-2-V1.png|220px]]
</td>
<td width="250">
[[image:RoofSurface-3-V1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Eine Dachfläche mit 2 Flächen
(1x bldg:RoofSurface) <span style="color:#FF0000">nicht empfohlen</span>
</td>
<td>
Zwei Dachflächen mit je 1 Fläche
(2x bldg:RoofSurface)
</td>
<td>
Drei Dachflächen (zwei ebene Dachflächen mit je 1 Flächen und eine kegelförmige Dachfläche mit 12 Flächen)
(3x bldg:RoofSurface)
</td>
<td>
Eine kegelförmigen Dachfläche mit 24 Flächen
(1x bldg:RoofSurface)
</td>
</tr>
<tr align="left" valign="top">
<td>

</td>
<td>

</td>
</tr>
</table>


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Krüppelwalmdach'''
</td>
<td width="250">
'''Mansardendach'''
</td>
<td width="250">
'''Bogendach'''
</td>
<td width="250">
'''Kuppeldach'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-4-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-5-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-6-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-8-V1.png|220px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
4 Dachflächen
(4x bldg:RoofSurface)
</td>
<td>
Vier Dachflächen
(4x bldg:RoofSurface)
</td>
<td>
Eine Dachflächen mit 12 Flächen
(1x bldg:RoofSurface)
</td>
<td>
Eine Dachfläche mit 264 Flächen
(1x bldg:RoofSurface)
</td>
</tr>
</table>

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Sheddach I'''
</td>
<td width="250">
'''Sheddach II'''
</td>
<td width="250">

</td>
<td width="250">

</td>

</tr>
<tr align="left" valign="top">
<td width="250">
[[image:RoofSurface-9-V1.png|250px]]
</td>
<td width="250">
[[image:RoofSurface-10-V1.png|250px]]
</td>
<td width="250">

</td>
<td width="250">

</td>
</tr>
<tr align="left" valign="top">
<td>
5 Dachflächen
(5x bldg:RoofSurface)
</td>
<td>
10 Dachflächen
(10x bldg:RoofSurface)
</td>
<td>

</td>
<td>

</td>
</tr>
</table>
-----
-----

==== <span id="OuterFloorSurfaces">Outer Floor Surfaces(''bldg:OuterFloorSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Die '''Äußere Bodenfläche''' (OuterFloorSurface) eines Gebäudes ist die '''äußere Fläche''' eines Bauteils [[Definitionen#Fußboden|Fußboden]], das das Gebäude nach oben gegen Luft begrenzt. Die Normalen der Äußeren Bodenflächen zeigen in der Regel nach oben.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:OuterFloorSurface''
* '''LOD3:''' ''bldg:OuterFloorSurface''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]
* Eine äußere Bodenfläche besteht nur aus den von '''außen sichtbaren''' Flächen.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterFloorSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Geometrie
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:opening''
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Dachterrasse'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Altan'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterFloorSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterFloorSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 x OuterFloorSurface
</td>
<td>
1 x OuterFloorSurface
</td>
<td>
1 x OuterFloorSurface
</td>
</tr>
</table>

-----
-----

==== <span id="OuterCeilingSurface">Outer Ceiling Surface(''bldg:OuterCeilingSurface'')</span> ====

===== Definition =====
'''SIG3D:''' Die '''Äußere Deckenfläche''' eines Gebäudes ist die '''äußere Fläche''' eines Bauteils [[Definitionen#Decke|Decke]], das das Gebäude nach unten gegen Luft begrenzt. Die Normalen der Äußeren Deckenflächen zeigen in der Regel nach unten.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:OuterCeilingSurface''
* '''LOD3:''' ''bldg:OuterCeilingSurface''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]
* Eine äußere Deckenfläche besteht nur aus den von '''außen sichtbaren''' Flächen.


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="400">
[[image:OuterFloorSurface-Uebersicht.png|300px]]
</td>
<td width="600">
[[image:OuterCeilingSurface-Flaechen-Volumen.png|600px]]
</td>
</table>

===== Attributes =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Geometrie
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:opening''
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Durchfahrt'''
</td>
<td width="250">
'''Loggia'''
</td>
<td width="250">
'''Auskragendes Stockwerk'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:OuterCeilingSurface-02-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:OuterCeilingSurface-03-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 x OuterCeilingSurface
</td>
<td>
1 x OuterCeilingSurface
</td>
<td>
1 x OuterCeilingSurface
</td>
</tr>
</table>

-----
-----

==== <span id="VitualBoundarySurface">Virtual Boundary Surface (''bldg:ClosureSurface'')</span>====

===== Definition =====
'''SIG3D:''' Die '''virtuelle Begrenzungsfläche''' (''bldg:ClosureSurface'') eines Gebäudes oder eines Raumes ist eine nicht real existierende Fläche, die das Gebäude oder den Raum begrenzt, um ein legales Volumen zu bilden.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:ClosureSurface''
* '''LOD3:''' ''bldg:ClosureSurface''

===== Geometry =====
'''gml:MultiSurface''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]
* Eine virtuelle Begrenzungsfläche des Gebäudes besteht nur aus den von '''außen sichtbaren''' (gedachten) Flächen.

===== Attributes =====
;''bldg:lod2MultiSurface''
:Zeigt auf die LOD2 Geometrie
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:opening'' <span style="color:#FF0000">nicht empfohlen</span>
:Zeigt auf ein CityGML feature ''bldg:Opening'' (''bldg:Door'' (siehe [[#Türen|Türen]]) oder ''bldg:Window'' (siehe [[#Fenster|Fenster]]))

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Offene Scheune'''
</td>
<td width="250">
'''Durchgangsbahnhof'''
</td>
<td width="250">
'''Parkhaus'''
</td>
</tr>
<tr align="left" valign="top">
<td width="300">
[[image:ClosureSurface-01-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-03-V1.png|300px]]
</td>
<td width="300">
[[image:ClosureSurface-02-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
1 x ClosureSurface
</td>
<td>
2 x ClosureSurface
</td>
<td>
28 x ClosureSurface
</td>
</tr>
</table>

-----
-----

==== <span id="Doors">Doors (''bldg:Door'')</span> ====

===== Definition =====
'''SIG3D:''' Die Tür ist ein Bauteil, das eine Öffnung schließt und hauptsächlich für den Ein- und Ausgang beabsichtigt ist.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' not available
* '''LOD3:''' ''bldg:Door''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]

* Türen können nur aus den von '''außen sichtbaren''' Flächen (Fall A, B und C) oder als '''räumliche Objekte''' (Fall D) modelliert werden.

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:TerrassenTuer-Detail-0.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:TerrassenTuer-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:TerrassenTuer-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:TerrassenTuer-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Fall A''' (eine einfache Fläche)
</td>
<td>
'''Fall B''' (eine einfache Fläche mit Textur)
</td>
<td>
'''Fall C''' (nur von außen sichtbare Flächen der detaillierten Tür)
</td>
<td>
'''Fall D''' (Tür als räumliches Objekt)
</td>
</tr>
</table>

* Um eine geschlossen Außenhülle des Gebäudes zu gewährleisten, sollten Türen '''nicht im geöffneten Zustand''' (Fall A) sondern im '''geschlossenen Zustand''' (Fall B) modelliert werden.

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Tuer-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Tuer-zu-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Fall A''' (Türen geöffnet)
</td>
<td>
'''Fall B''' (Türen geschlossen)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie
;''bldg:address''
:Zeigt auf eine Adresse

===== Examples =====


<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Einfache Türen'''
</td>
<td width="250">
'''Einfache Türen mit Laibung'''
</td>
<td width="250">
'''Detaillierte Türen'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Tueren-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Tueren-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Anzahl der Polygone (Gesamtmodell) = 19
</td>
<td>
Anzahl der Polygone (Gesamtmodell) = 128
</td>
<td>
Anzahl der Polygone (Gesamtmodell) = 3498
</td>
</tr>
</table>

----
----

==== <span id="Windows">Windows (''bldg:Window'')</span> ====

===== Definition =====
'''SIG3D:''' Das Fenster ist ein Bauteil, das eine Öffnung schließt und hauptsächlich für die natürliche Belüftung und Beleuchtung vorgesehen ist.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' not available
* '''LOD3:''' ''bldg:Window''

===== Geometry =====
'''''gml:MultiSurface''''' siehe auch [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)#gml:MultiSurface| Handbuch - Teil 1]]

* Fenster können nur aus den von '''außen sichtbaren''' Flächen (Fall A, B und C) oder als '''räumliche Objekte''' (Fall D) modelliert werden.
<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
[[image:RechteckFenster-Detail-0.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-0-Texture.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1-Flaeche.png|250px]]
</td>
<td width="250">
[[image:RechteckFenster-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
[[image:RechteckFenster-Schnitt-Detail-0.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-0-Texture.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1-Flaeche.png|250px]]
</td>
<td>
[[image:RechteckFenster-Schnitt-Detail-1.png|250px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Fall A''' (eine einfache Fläche)
</td>
<td>
'''Fall B''' (eine einfache Fläche mit Textur)
</td>
<td>
'''Fall C''' (nur von außen sichtbare Flächen des detaillierten Fensters)
</td>
<td>
'''Fall D''' (Tür als räumliches Objekt)
</td>
</tr>
</table>

* Um eine geschlossen Außenhülle des Gebäudes zu gewährleisten, sollten Fenster '''nicht im geöffneten Zustand''' (Fall A) sondern im '''geschlossenen Zustand''' (Fall B) modelliert werden.

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="500">
[[image:Fenster-offen-red-v1.png|500px]]
</td>
<td width="500">
[[image:Fenster-geschlossen-red-v1.png|500px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
'''Fall A''' (Fenster geöffnet)
</td>
<td>
'''Fall B''' (Fenster geschlossen)
</td>
</tr>
</table>

===== Attributes =====
;''bldg:lod3MultiSurface''
:Zeigt auf die LOD3 Geometrie

===== Examples =====

<table border="0" cellspacing="6">
<tr align="left" valign="top">
<td width="250">
'''Einfache Fenster'''
</td>
<td width="250">
'''Einfache Fenster mit Laibung'''
</td>
<td width="250">
'''Detaillierte Fenster'''
</td>
</tr>
<tr align="left" valign="top">
<td width="250">
[[image:Beispiel-Fenster-GanzEinfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Einfach-Red-V1.png|300px]]
</td>
<td width="250">
[[image:Beispiel-Fenster-Komplex-Red-V1.png|300px]]
</td>
</tr>
<tr align="left" valign="top">
<td>
Anzahl der Polygone (Gesamtmodell) = 28
</td>
<td>
Anzahl der Polygone (Gesamtmodell) = 412
</td>
<td>
Anzahl der Polygone (Gesamtmodell) = 6269
</td>
</tr>
</table>

----
----

=== <span id ="ExtendedModeling">Extended Modeling</span> ===
Die Erweiterte Modellierung umfasst die Modellierung von häufig vorkommenden '''architektonischen Bauelementen''', die das äußere Erscheinungsbild des Gebäudes signifikant prägen. Diese Bauelemente werden in der Regel als '''Gebäudeinstallationen''' modelliert.
-----
-----
==== <span id="Balconies">Balconies</span> ====

===== Definition =====
'''SIG3D:''' Ein '''Balkon''' [balˈkɔŋ, auch, süddt./österr. nur: bal'ko:n, schweiz. 'balko:n oder 'bau̯ko:n; Plural: Balkone, norddt. Balkons] ist eine Plattform an einem Gebäude, die über dem Geländeniveau liegt und aus dem Baukörper hinausragt. Ein Balkon wird von einer Brüstung oder einem Geländer eingefasst. Das Wort geht auf das italienische Wort balcone zurück, dieses seinerseits auf das althochdeutsche (möglicherweise durch die Langobarden vermittelte) Wort balko „Balken“ [Wikipedia].

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====

*'''''gml:Geometry'' <span style="color:#00FF00">empfohlen</span>'''
** '''Schwellenwerte LOD2:'''
*** Modellierung nur, wenn Tiefe des Balkons >= 0,5 m;
**** Grundfläche flächig, wenn Dicke des Bauteils <= 0,5 m;
**** Seitenwände flächig, wenn Dicke des Bauteils <= 0,5 m;
** '''Schwellenwerte LOD3:'''
*** Modellierung nur, wenn Tiefe des Balkons >= 0,2 m;
**** Grundfläche flächig, wenn Dicke des Bauteils <= 0,2 m;
**** Seitenwände flächig, wenn Dicke des Bauteils <= 0,2 m;
** '''Modellierungsprinzip'''
*** Das Gebäude enthält alle Begrenzungsflächen mit Geometrie
*** Der Balkon wird als '''BuildingInstallation mit Geometrie''', d.h. ohne weitere semantische Differenzierung, modelliert
*** Das Gebäudevolumen referenziert (Xlink) auf die entsprechenden Begrenzungsflächen des Gebäudes

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Balkon-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modellierungsprinzip eines Balkons</td>
</tr>
</table>

*'''''bldg:boundedBy'' <span style="color:#FF0000">nicht empfohlen</span>'''

===== Attributes =====
;''bldg:function''
:Balkon'' (1000); siehe SIG 3D Codelistenvorschlag für [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#FF0000">'''nicht empfohlen:'''</span> Ein Balkon wird als '''ein''' Bauteil angesehen, das semantisch nicht mehr untergliedert wird.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Balkone'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Reales Beispiel
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-red.JPG|200px]]
</td>
<td rowspan="2" width="200px" valign="top">
[[image:KHH-3-Balkone-01-ALKIS.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD0.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD1.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD2.png|200px]]
</td>
<td width="200px" valign="top">
[[image:KHH-3-Balkone-01-LOD3.png|200px]]
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/6/6e/KHH-3-Balkone-LOD0-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/c/ce/KHH-3-Balkone-LOD1-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/a/ac/KHH-3-Balkone-LOD2-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/d/d0/KHH-3-Balkone-LOD3-V01.gml CityGML herunterladen]
</td>
</tr>


<tr align="left">
<td colspan="6">
Über Geländeniveau, außerhalb des Baukörpers --> Balkon
</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0">

<tr align="middle">
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-03-red.png|200px]]
</td>
<td rowspan="2" width="200px" valign="top">
[[image:Eckbalkon-Alkis.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD0-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD1-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD2-01.png|200px]]
</td>
<td width="200px" valign="top">
[[image:Eckbalkon-LOD3-02.png|200px]]
</td>

<tr align="middle">
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/9/96/Eckbalkon-LOD0-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/4/4a/Eckbalkon-LOD1-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/7/77/Eckbalkon-LOD2-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[http://quality.citygmlwiki.org/images/5/56/Eckbalkon-LOD3-V01.gml CityGML herunterladen]
</td>

</tr>
<tr align="left">
<td colspan="6">
Über Geländeniveau, teilweise außerhalb des Baukörpers, nicht durch 3 Wände begrenzt --> Balkon (keine Loggia)
</td>
</tr>
</table>

-----
-----




==== Loggias ====

===== Definition =====
'''SIG3D:''' Eine '''Loggia''' ist ein nach oben geschlossener Außenraum innerhalb des Gebäudegrundrisses, der auf '''3''' Seiten in voller Geschosshöhe umbaut ist [Sprengnetter-Bibliothek 20.0]. Als '''Loggia''' (aus dem Italienischen) wird in der Architektur ein Raum in einem Gebäude bezeichnet, der sich mittels Bögen oder anderer Konstruktionen zum Außenraum öffnet. Auf der Erdgeschossebene schaffen Loggien einen Übergangsbereich zwischen Außen- und Innenraum, im Obergeschoss werden sie als Verbindungsgang oder Freisitz genutzt [Wikipedia:].

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometrie =====
*'''''gml:Geometry'' <span style="color:#FF0000">nicht empfohlen</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">empfohlen</span>'''
** '''Schwellenwerte LOD2:'''
*** Modellierung nur, wenn Tiefe der Loggia >= 0,5 m;
** '''Schwellenwerte LOD3:'''
*** Modellierung nur, wenn Tiefe der Loggia >= 0,2 m;
** '''Modellierungsprinzip'''
*** Das Gebäude enthält alle Begrenzungsflächen mit Geometrie
*** Die Loggia (BuildingInstallation) '''referenziert (Xlink)''' auf die entsprechenden Begrenzungsflächen des Gebäudes. Ist der Boden der Loggia nicht Teil der Außenhülle des Gebäudes wird sie als Begrenzungsfläche mit Geometrie am BuildingInstallation modelliert.
*** Das Gebäudevolumen referenziert (Xlink) auf die entsprechenden Begrenzungsflächen des Gebäudes

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Loggia-Prinzip-v2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modellierungsprinzip einer Loggia</td>
</tr>
</table>


===== Attribute =====
;''bldg:function''
:Loggia (1001); siehe SIG 3D Codelistenvorschlag für [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''empfohlen:'''</span> Eine Loggia wird als ein Bauteil angesehen, das sich semantisch aus Begrenzungsflächen des Gebäudes und evtl. einer äußeren Bodenflächen zusammensetzt.

===== Examples =====

<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Loggien'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Reales Beispiel
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z09.png|200px]]
Innenliegende Loggia
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z09.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML herunterladen]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z12.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_01.jpg|200px]]
[http://quality.citygmlwiki.org/images/9/9a/Loggia-01-CityGML-LOD2-V1.gml CityGML herunterladen]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Teilweise zurückspringendes Erdgeschoss
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z13.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_02.jpg|200px]]
[http://quality.citygmlwiki.org/images/6/63/Loggia-02-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z13.png|200px]]
Mehrgeschossiges Gebäude mit innenliegenden Loggien
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z15.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z16.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_03.jpg.png|200px]]
[http://quality.citygmlwiki.org/images/c/c2/Loggia-03-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Loggia_Z17.png|200px]]
Mehrgeschossiges Gebäude, Loggien über gesamte Frontbreite und Höhe
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z18.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z17.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_04.jpg|200px]]
[http://quality.citygmlwiki.org/images/d/d8/Loggia-04-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Loggien_halbe_Breite-05-Foto-V1.png|200px]]
Loggien über halbe Frontbreite (Reihenhaus)
</td>
<td width="200px" valign="bottom">
[[image:|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:|200px]]
Kamen Am Langen Kamp 25
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_05.jpg|200px]]
[http://quality.citygmlwiki.org/images/a/a9/Loggia-05-CityGML-LOD2-V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Vorgebaute_Loggien-06-Foto-V1.jpg|200px]]
Vorgebaute Loggien
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Loggia_Z19.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Loggia_Z14.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Loggia_Z19.png|200px]]
[http://quality.citygmlwiki.org/images/f/f6/Loggia-06-CityGML-LOD2_V1.gml CityGML herunterladen] *
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>
* Die Geometrie ist bei diesem Beispiel innerhalb des <code>lod2Solid</code> modelliert, nicht in den jeweiligen <code>BoundarySurface</code> Elementen (Widerspruch zum Standard)!

-----
-----

==== Thoroughfare ====

===== Definition =====
SIG3D: offene '''Durchfahrt''' ist eine Stelle, an der mit '''Fahrzeugen''' durch Gebäude ebenerdig gefahren werden kann und die durch Wände und eine Decke begrenzt ist.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">nicht empfohlen</span>'''



*'''''bldg:boundedBy'' <span style="color:#00FF00">empfohlen</span>'''
** Schwellenwerte LOD2 / LOD3:
*** Modellierung nur, wenn Breite und Höhe der Durchfahrt >= 2 m;
** '''Modellierungsprinzip''' (Durchfahrt in einem Gebäude)
*** Das Gebäude enthält alle Begrenzungsflächen mit Geometrie
*** Die Durchfahrt (BuildingInstallation) '''referenziert (Xlink)''' auf die entsprechenden Begrenzungsflächen des Gebäudes.
*** Das Gebäudevolumen referenziert (Xlink) auf die entsprechenden Begrenzungsflächen des Gebäudes<table border="0" cellspacing="6"><tr align="left" valign="center"><td width="600">[[image:Durchfahrt-Prinzip.png|600px]]</td></tr><tr align="center" valign="top"><td>Modellierungsprinzip einer Durchfahrt</td></tr></table>
** '''Modellierungsprinzip''' (Gemeinsame Durchfahrt durch zwei Gebäude)
*** Die Gebäude enthalten jeweils alle Begrenzungsflächen mit Geometrie
*** Die Durchfahrt (BuildingInstallation) wird dem Gebäude mit dem größeren Anteil der Durchgangsbreite zugeordnet. Die Durchfahrt '''referenziert (Xlink)''' auf die entsprechenden Begrenzungsflächen des Gebäudes und komplettiert die Durchfahrt mit Begrenzungsgeometrie an der BuildingInstallation.
*** Die Gebäudevolumen referenzieren (Xlink) auf die entsprechenden Begrenzungsflächen der jeweiligen Gebäude<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Durchfahrt-Prinzip-Var-2.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modellierungsprinzip einer gemeinsamen Durchfahrt</td>
</tr>
</table>

<br />
'''Anmerkung:''' Die Modellierung von Gebäuden in geschlossener Bauweise wird in [[#GebäudeInGeschlossenerBauweise|Kapitel 3.7]] beschrieben

===== Attributes =====
;''bldg:function''
:Durchfahrt (1002); siehe SIG 3D Codelistenvorschlag für [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''empfohlen:'''</span> Eine Durchfahrt wird als ein Bauteil angesehen, das sich semantisch aus Begrenzungsflächen des Gebäudes und evtl. einer äußeren Bodenflächen zusammensetzt.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" style="border:thin">

<tr align="left">
<td colspan="6">
'''Durchfahrten'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Reales Beispiel
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z26.png|200px]]
Durchfahrt in einem Gebäude
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
[http://quality.citygmlwiki.org/images/0/05/Durchfahrt-01-CityGML-LOD1-V2.gml CityGML herunterladen]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-01-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/2/20/Durchfahrt-01-CityGML-LOD2-V2.gml CityGML herunterladen]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_gemeinsamer_Durchfahrt-02-Foto-V1.jpg|200px]]
Zwei Gebäude mit gemeinsamer Durchfahrt
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z26.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-02-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/a/a5/Durchfahrt-02-CityGML-LOD2-V4.gml CityGML herunterladen]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Zwei Gebäude mit getrennten Durchfahrten
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Durchfahrt_Z28.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-03-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/f/f1/Durchfahrt-03-CityGML-LOD2-V2.gml CityGML herunterladen]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">

Zwei versetzt stehende Gebäude mit getrennten Durchfahrten
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z29.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-04-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/4/4c/Durchfahrt-04-CityGML-LOD2-V1.gml CityGML herunterladen]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_einseitiger_Durchfahrt-05-Foto-V1.jpg|200px]]
Zwei Gebäude mit einseitiger Durchfahrt
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z27.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:Durchfahrt-05-LOD2.jpg|200px]]<br />
[http://quality.citygmlwiki.org/images/e/eb/Durchfahrt-05-CityGML-LOD2-V1.gml CityGML herunterladen]<br />
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Zwei_Gebaeude_mit_Verbindungstrakt-01-Foto-V1.jpg|200px]]
Zwei Gebäude mit Verbindungstrakt
</td>
<td width="200px" valign="bottom">
[[image:ALKIS_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z31.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>

<tr align="middle">
<td width="200px" valign="bottom">
[[image:Real_Durchfahrt_Z53.png|200px]]
Durchfahrt im Obergeschoss
</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">

</td>
<td width="200px" valign="bottom">
[[image:LOD1_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
[[image:LOD2_Durchfahrt_Z53.png|200px]]
</td>
<td width="200px" valign="bottom">
</td>
</tr>
</table>

==== Dormers / Zwerchhaus (Zwerchgiebel)====

===== Definition =====
'''SIG3D:''' Eine '''Dachgaube''', kurz Gaube, vereinzelt auch Dachgaupe bzw. Gaupe, ist ein Dachaufbau im geneigten Dach eines Gebäudes. Die Dachgaube dient zur Belichtung und Belüftung der Dachräume. Zu diesem Zweck befinden sich in den Gauben von Wohngebäuden im Allgemeinen Fenster. Gleichzeitig vergrößert eine Gaube den nutzbaren Raum im Dachgeschoss [Wikipedia].

Eine '''Dachgaube''' steht nicht in einer Ebene mit einer Außenwand des Gebäudes. Die Dachgaube (bzw. dessen Grundriss) hat einen Mindestversatz von 0,5 m und liegt innerhalb des Gebäudegrundrisses.

'''SIG3D:''' Das '''Zwerchhaus''' ist ein ein- oder mehrgeschossiger Aufbau eines geneigten Daches. Es hat einen Giebel und ein eigenes Dach. Der Zwerchgiebel steht in der Flucht der Gebäudeaußenwand. Dadurch unterscheidet sich das Zwerchhaus von der Gaube, die unabhängig von den Außenwänden auf dem Dach positioniert ist. Das Dach des Zwerchhauses ist häufig als Satteldach ausgebildet. Dessen First verläuft quer (zwerch) zum Dachfirst des Hauptdachs. Entsprechend stehen die Traufen von Zwerchdach und Hauptdach rechtwinklig zueinander [Wikipedia].

'''Anmerkung:''' Das '''Zwerchhaus''' wird nicht als Gebäudeinstallation modelliert sondern als Begrenzungsflächen am Gebäude selbst.

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">nicht empfohlen</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">empfohlen</span>'''
** Schwellenwerte LOD2:
*** Modellierung nur, wenn Breite und Höhe der Dachgaube >= 2 m;
** Schwellenwerte LOD3:
***
** '''Modellierungsprinzip'''
*** Das Gebäude enthält alle Begrenzungsflächen mit Geometrie des Gebäudekörpers. Um das Volumen zu schließen wird eine ClosureSurface in die Dachlücke modelliert.
*** Die Dachgaube (BuildingInstallation) '''enthält alle Begrenzungsflächen mit Geometrie''' der Dachgaube. Um das Volumen zu schließen wird eine ClosureSurface modelliert oder auf die entsprechende ClosureSurface des Gebäudekörpers referenziert (Xlink mit OrientableSurface).
*** Das Gebäudevolumen, Volumen des Gebäudekörpers und Volumen der Dachgaube ('''CompositeSolid'''), referenziert (Xlink) auf die entsprechenden Begrenzungsflächen des Gebäudekörpers und der Dachgaube.

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Dachgaube-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modellierungsprinzip einer Dachgaube</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Dachgaube (1003); siehe SIG 3D Codelistenvorschlag für [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''empfohlen:'''</span> Eine Dachgaube wird als ein Bauteil angesehen, das sich semantisch aus Begrenzungsflächen des Gebäudes zusammensetzt.

===== Examples =====
<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Dachgaube'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Reales Beispiel
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">

</td>
<td width="200px" valign="top">
[[image:DachgaubeClosure-01-LOD2.jpg|200px]]
[http://quality.citygmlwiki.org/images/b/b5/DachgaubeClosure-V1.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">

</td>
</tr>
</table>

<table width="1200px" border="1" cellspacing="0" >

<tr align="left">
<td colspan="6">
'''Zwerchhaus (Zwerchgiebel)'''
</td>
</tr>

<tr align="middle" valign="top">
<td>
Reales Beispiel
</td>
<td>
ALKIS
</td>
<td>
CityGML LOD0
</td>
<td>
CityGML LOD1
</td>
<td>
CityGML LOD2
</td>
<td>
CityGML LOD3
</td>
</tr>

<tr align="middle">
<td width="200px" valign="top">
[[image:Zwerchhaus-Foto-V3.jpg|200px]]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-ALKIS-v02.png|170px]]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD0-v02.png|170px]]
[http://quality.citygmlwiki.org/images/a/a0/Zwerchgiebel-LOD0-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD1-v02.png|170px]]
[http://quality.citygmlwiki.org/images/3/32/Zwerchgiebel-LOD1-V01.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD2-v02.png|170px]]
[http://quality.citygmlwiki.org/images/4/4b/Zwerchgiebel-LOD2-V02.gml CityGML herunterladen]
</td>
<td width="200px" valign="top">
[[image:Zwerchgiebel-LOD3-v02.png|170px]]
[http://quality.citygmlwiki.org/images/d/d4/Zwerchgiebel-LOD3-V01.gml CityGML herunterladen]
</td>

</tr>
</table>

==== Arcades / Architrav ====

===== Definition =====
'''SIG3D:''' Eine '''Arkade''' (lateinisch arcus: Bogen) bezeichnet in der Architektur einen von Pfeilern oder Säulen getragenen Bogen. Der Bogen lässt wesentlich größere Spannweiten zu als dies beim Architrav möglich ist [Wikipedia].

'''SIG3D:''' Der '''Architrav''' (von italienisch architrave, aus griechisch ἀρχι, archi-, Ober-, Haupt- und lateinisch trabs, Balken) ist ein auf einer Stützenreihe ruhender Horizontalbalken. In der Antike wurde der Architrav auch Epistyl genannt, da er hier meist auf Säulen ruht (Epistyl von griechisch auf den Säulen liegend)[Wikipedia].

===== CityGML Feature =====
* '''LOD1:''' not available
* '''LOD2:''' ''bldg:BuildingInstallation''
* '''LOD3:''' ''bldg:BuildingInstallation''

===== Geometry =====
*'''''gml:Geometry'' <span style="color:#FF0000">nicht empfohlen</span>'''

*'''''bldg:boundedBy'' <span style="color:#00FF00">empfohlen</span>'''
** '''Schwellenwerte LOD2:'''
*** Schwellenwerte für Modellierung von Stützen: alle Seiten der BoundingBox der Stütze >= 0,5 m
** '''Modellierungsprinzip'''
*** Das Gebäude enthält alle Begrenzungsflächen mit Geometrie
*** Die Arkade (BuildingInstallation) '''referenziert (Xlink)''' auf die entsprechenden Begrenzungsflächen des Gebäudes.
*** Das Gebäudevolumen referenziert (Xlink) auf die entsprechenden Begrenzungsflächen des Gebäudes

<table border="0" cellspacing="6">
<tr align="left" valign="center">
<td width="600">
[[image:Arkade-Prinzip.png|600px]]
</td>
</tr>
<tr align="center" valign="top">
<td>
Modellierungsprinzip einer Arkade</td>
</tr>
</table>

===== Attributes =====
;''bldg:function''
:Arkade (1009); siehe SIG 3D Codelistenvorschlag für [http://www.sig3d.org/codelists/Handbuch-SIG3D/building/2.0/CL-V1.0/BuildingInstallation_function.xml ''bldg:BuildingInstallation --> function'' ]
;''bldg:boundedBy''
:<span style="color:#00FF00">'''empfohlen:'''</span> Eine Arkade wird als ein Bauteil angesehen, das sich semantisch aus Begrenzungsflächen des Gebäudes und evtl. einer äußeren Bodenflächen zusammensetzt.

===== Examples =====

{| width="1200px" cellspacing="0" border="1" style="border:thin"
|- align="left"
| colspan="6" |
'''Arkaden'''

|- valign="top" align="center"
|
Reales Beispiel

|
ALKIS

|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="bottom" |
[[Image:Real Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:ALKIS Arkaden.png|200px]]

| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD1 Arkaden.png|200px]]

| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V1.png|200px]]

| width="200px" valign="bottom" |
|- align="center"
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
| width="200px" valign="bottom" |
[[Image:LOD2 Arkaden V2.png|200px]]

| width="200px" valign="bottom" |
|}

<br>

{| width="1200px" cellspacing="0" border="1"
|- align="left"
| colspan="6" |
'''Arkade'''

|- valign="top" align="center"
|
Reales Beispiel

|
ALKIS

|
CityGML LOD0

|
CityGML LOD1

|
CityGML LOD2

|
CityGML LOD3

|- align="center"
| width="200px" valign="top" |
[[Image:Arkaden-01-Foto-V1.jpg|200px]]

| width="200px" valign="top" |
[[Image:Arkade-ALKIS-v01-red.png|200px]]

| width="200px" valign="top" |
[[Image:Arkade-LOD0-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/4/43/Arkade-LoD0-Beispiel-Wiki-01-V01.gml CityGML herunterladen]

| width="200px" valign="top" |
[[Image:Arkade-LOD1-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/2/21/Arkade-LoD1-Beispiel-Wiki-01-V01.gml CityGML herunterladen]

| width="200px" valign="top" |
[[Image:Arkade-LOD2-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/e/e5/Arkade-LoD2-Beispiel-Wiki-01-V01.gml CityGML herunterladen]

| width="200px" valign="top" |
[[Image:Arkade-LOD3-v01-red.png|200px]] [http://quality.citygmlwiki.org/images/f/fb/Arkade-LoD3-Beispiel-Wiki-01-V01.gml CityGML herunterladen]

|}

-----
-----

Template:Willkommen AG Qualitaet

2013-09-02T16:44:19Z

Wikiadmin:

<div style="font-size:70%; text-align:right;">[ [[Welcome at the SIG3D Quality Working Group|Edit]] ] </div>  <div style="font-size:120%; background-color:#d0d0ff;">The Quality Concept of the SIG3D </div>  <div style="background-color:#ffffff;">

</div>
Quality of 3D objects is a key prerequisite for a sustainable continuation of 3D city models. By developing this manual we want to create reliable conditions for all parties involved in the modeling process - Modeler, Data Owners and Developers.

This public version of the Wiki was developed by the '''SIG3D Quality Working Group''' and represents the essence of intensive discussions over the last years. We want to give you some hints and recommendations about a "correct" '''modeling''' of 3D city model objects in CityGML. Please note that our goal was explicitely not to define rules for collecting source data for 3D city model objects.

The Quality Concept of the SIG3D Quality Working Group covers the whole process of generating a CityGML based city model. Based on [[General|general definitions]] we formulated a [[Modeling|Modeling Guide for Buildings]], so that we can define modular and transparent [[Testing|testing conditions]] usable in an application or project environment defined by [[Profiles]]. These are the necessary preconditions for a comprehensive and comparative [[Certification]] process. All these components are included as key components of a [[Standard Specifications]] ( in Germany a so called "Standardleistungsbuch" ) to ensure a sustainable and economically [[Continuation]] process of modeling and maintaining city models.

Template:Willkommen AG Qualitaet

2013-09-02T16:42:43Z

Wikiadmin:

<div style="font-size:70%; text-align:right;">[ [[Welcome at the SIG3D Quality Working Group|Edit]] ] </div>  <div style="font-size:120%; background-color:#d0d0ff;">The Quality Concept of the SIG3D </div>  <div style="background-color:#ffffff;">

</div>
Quality of 3D objects is a key prerequisite for a sustainable continuation of 3D city models. By developing this manual we want to create reliable conditions for all parties involved in the modeling process - Modeler, Data Owners and Developers.

This public version of the Wiki was developed by the '''SIG3D Quality Working Group''' and represents the essence of intensive discussions over the last years. We want to give you some hints and recommendations about a "correct" '''modeling''' of 3D city model objects in CityGML. Please note that our goal was explicitely not to define rules for collecting source data for 3D city model objects.

The Quality Concept of the SIG3D Quality Working Group covers the whole process of generating a CityGML based city model. Based on [[General|general definitions]] we formulated a [[Modeling|Modeling Guide for Buildings]], so that we can define modular and transparent [[Testing|testing conditions]] usable in an application or project environment defined by [[Profiles]]. These are the necessary preconditions for a comprehensive and comparative [[Certification]] process. All these components are included as key components of a [[Standard Specification]] ( in Germany a so called "Standardleistungsbuch" ) to ensure a sustainable and economically [[Continuation]] process of modeling and maintaining city models.

Template:Kontakt

2013-09-02T16:26:08Z

Wikiadmin:

<div style="font-size:120%; background-color:#ffff80">'''Contact'''</div>  <div style="background-color:#ffffff;">In case of errors, suggestions, recommendations or constructive criticism feel free to send us a mail to [mailto:QualityWG@SIG3D.org Quality Working Group of the SIG3D].<br></div>

Template:Copyright

2013-09-02T16:22:56Z

Wikiadmin:

Modeling

2013-09-02T13:21:06Z

Wikiadmin:

*[http://files.sig3d.de/file/ag-qualitaet/20110531_Regeln_GML_final_EN.pdf Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)] ( Version 0.6.0, PDF, English Version )
* [[Handbuch für die Modellierung von 3D Objekten - Teil 1: Grundlagen (Regeln für valide GML Geometrie-Elemente in CityGML)|Modeling Guide for 3D Objects - Part 1: Basics (Rules for Validating GML Geometries in CityGML)]] ( Version 0.7.0, in German )
* [[Handbuch für die Modellierung von 3D Objekten - Teil 2: Modellierung Gebäude (LOD1, LOD2 und LOD3)|Modeling Guide for 3D Objects - Part 2: Modeling of Buildings (LoD1, LoD2, LoD3)]] ( Version 2.0.0, in German )
* Modeling Guide for 3D Objects - Part x: Modeling of Interior (LoD 4)

<br>

<br>

*Archive:
**[[Image:201205 SIG3D Handbuch für die Modellierung von 3D Objekten - Teil 2 Modellierung Gebäude (LOD1, LOD2 und LOD3) Version 1.0.pdf]]

Main Page

2013-09-02T13:06:19Z

Wikiadmin: /* SIG 3D Quality Working Group */

= SIG 3D Quality Working Group =

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_5_1.svg|100px|link=Certification]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_6_1.svg|100px|link=Standard Specifications]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_7_1.svg|100px|link=Continuation]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Willkommen AG Qualitaet}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Kontakt}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

File:201303 SIG3D Logo 120x72.png

2013-09-02T13:04:06Z

Wikiadmin:

File:201303 SIG3D Logo 135x81.png

2013-09-02T13:00:47Z

Wikiadmin: Wikiadmin uploaded a new version of "File:201303 SIG3D Logo 135x81.png"

File:201303 SIG3D Logo 135x81.png

2013-09-02T12:57:35Z

Wikiadmin:

Main Page

2013-09-02T12:49:48Z

Wikiadmin: /* SIG 3D Quality Working Group */

= SIG 3D Quality Working Group =

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_5_1.svg|100px|link=Certification]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_6_1.svg|100px|link=Standard Specifications]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_7_1.svg|100px|link=Continuation]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Willkommen bei der AG Qualitaet}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Kontakt}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

File:201303 SIG3D Logo.svg

2013-09-02T12:43:13Z

Wikiadmin:

File:20130901 SIG3D QualityConcept 7 1.svg

2013-09-02T12:42:03Z

Wikiadmin:

Main Page

2013-09-02T12:40:52Z

Wikiadmin: /* SIG 3D Quality Working Group */

File:20130901 SIG3D QualityConcept 6 1.svg

2013-09-02T12:39:15Z

Wikiadmin:

Main Page

2013-09-02T12:37:54Z

Wikiadmin: Undo revision 3608 by Wikiadmin (talk)

= SIG 3D Quality Working Group =

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_5_1.svg|100px|link=Certification]]

| width="150" |
[[Image:Konzept-07-grau.png|150px]]

| width="150" |
[[Image:Konzept-08-grau.png|150px]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Willkommen AG Qualitaet}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Kontakt}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

Main Page

2013-09-02T12:34:45Z

Wikiadmin: /* SIG 3D Quality Working Group */

= SIG 3D Quality Working Group =

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_5_1.svg|100px|link=Certification]]

| width="150" |
[[Image:Konzept-07-grau.png|150px]]

| width="150" |
[[Image:Konzept-08-grau.png|150px]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Welcome at the SIG3D Quality Working Group}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Contact}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

File:20130901 SIG3D QualityConcept 5 1.svg

2013-09-02T12:33:33Z

Wikiadmin:

Testing

2013-09-02T12:31:39Z

Wikiadmin:

SIG3D Quality Working Group has developed a concept for a service driven, modular and transparent testing framework. The framework is just under heavy development.

Testing

2013-09-02T12:30:54Z

Wikiadmin: Created page with "SIG3D Quality Working Group has developed a concept for a service driven, modular and transparent testing framework. Development has not been finished yet."

SIG3D Quality Working Group has developed a concept for a service driven, modular and transparent testing framework. Development has not been finished yet.

Main Page

2013-09-02T12:28:46Z

Wikiadmin: /* SIG 3D Quality Working Group */

= SIG 3D Quality Working Group =

[[Image:20130901_SIG3D_QualityConcept.svg|center|700px|link=Main Page]]

{| cellspacing="6" border="0" align="center"
|- valign="top" align="left"
| width="100" |
[[Image:20130901_SIG3D_QualityConcept_1_3.svg|100px|link=General]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_2_3.svg|100px|link=Modeling]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_3_2.svg|100px|link=Profiles]]

| width="100" |
[[Image:20130901_SIG3D_QualityConcept_4_2.svg|100px|link=Testing]]

| width="150" |
[[Image:Konzept-06-grau.png|150px]]

| width="150" |
[[Image:Konzept-07-grau.png|150px]]

| width="150" |
[[Image:Konzept-08-grau.png|150px]]

|}

<br>

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="50%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Willkommen AG Qualitaet}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Kontakt}}</div>
|}

{| width="100%" cellspacing="6" border="0"
|- valign="top" align="left"
| width="80%" | <div style="margin: 10px; border: 2px solid #dfdfdf; background-color:#f8f8ff;">{{Copyright}}</div>
|}

File:20130901 SIG3D QualityConcept 4 2.svg

2013-09-02T12:28:13Z

Wikiadmin:

Profiles

2013-09-02T12:26:24Z

Wikiadmin:

CityGML profiles are restrictions in an project or application environment. General CityGML profiles are yet not available. In Germany the [[Abbreviations|AdV]] developed a LoD1 and LoD2 Profile for national cadastre purposes.

Profiles

2013-09-02T12:24:33Z

Wikiadmin: Created page with "CityGML profiles are restrictions in an project or application environment. General CityGML profiles are yet not available. In Germany the AdV has developed a LoD1 and LoD..."

CityGML profiles are restrictions in an project or application environment. General CityGML profiles are yet not available. In Germany the [[AdV]] has developed a LoD1 and LoD2 Profile for national cadastre purposed.