Arch Site/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{GuiCommand/de|Name=Arch Site|Name/de=Baugrund|Workbenches=[[Arch Module/de|Arch]]|MenuLocation=Architektur → Seite|Shortcut=S I|SeeAlso=[[Arch Floor/de|Etage]], [[Arch Building/de|Gebäude]]}}
{{docnav/de
|[[Arch_Building/de|Gebäude]]
|[[Arch_Window/de|Fenster]]
|[[Arch_Module/de|Arch-Arbeitsbereich]]
|IconL=Arch_Building.svg
|IconC=Workbench_Arch.svg
|IconR=Arch_Window.svg
}}
</div>

<div class="mw-translate-fuzzy">
{{GuiCommand/de
|Name=Arch Site|Name/de=Baugrund
|Workbenches=[[Arch Module/de|Arch]]
|MenuLocation=Architektur → Grundstück
|Shortcut={{KEY|S}} {{KEY|I}}
|SeeAlso=[[Arch Floor/de|Etage]], [[Arch Building/de|Gebäude]]
}}
</div>


==Beschreibung==
==Beschreibung==

Der Baugrund ist ein spezielles Objekt, das Eigenschaften eines Standard-FreeCAD-Group-Objekts und Arch-Objekten kombiniert. Es ist besonders zur Repräsentation einer gesamten Projektfläche bzw. eines Terrains geeignet. In IFC-basierter architektonischer Arbeit dient es der Organisation des CAD-Modells und enthält [[Arch Building/de|Gebäude]]-Objekte. Der Baugrund wird auch verwendet, um vorhandenes Gelände zu verwalten und anzuzeigen und kann benutzt werden, um das Volumen von aufzufüllender oder abzutragender Erde zu berechnen.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
==Anwendung==
Der Baugrund ist ein speziell zur Repräsentation einer gesamten Projektfläche bzw. eines Terrains geeignetes FreeCAD-Gruppenobjekt. Das Objekt dient der Organisation des CAD-Modells und enthält [[Arch Building/de|Gebäude]]-Objekte.
</div>
</div>


<div class="mw-translate-fuzzy">
==Anwendung==
# Selektieren Sie optional ein oder mehrere Objekte, welche in den neuen Baugrund übernommen werden sollen.

# Drücken Sie die Schaltfläche {{Button|[[Image:Arch Site.png|16px]] '''Baugrund'''}} oder die Tasten {{KEY|S}}, dann {{KEY|I}}.
# Selektieren Sie optional ein oder mehrere Objekte, welche in den neuen Baugrund übernommen werden sollen
</div>
# Drücken Sie den {{KEY|[[Image:Arch Site.png|16px]] '''Baugrund'''}}-Knopf oder die Tasten {{KEY|S}} und {{KEY|I}}


==Optionen==
==Optionen==
Line 20: Line 41:
</div>
</div>


==Properties==
==Eigenschaften==


=== Data ===
* {{PropertyData|Terrain}}: The base terrain of this site
* {{PropertyData|Terrain}}: The base terrain of this site
* {{PropertyData|Address}}: The street and housenumber of this site
* {{PropertyData|Address}}: The street and housenumber of this site
Line 36: Line 58:
* {{PropertyData|Extrusion Vector}}: An extrusion vector to use when performing boolean operations
* {{PropertyData|Extrusion Vector}}: An extrusion vector to use when performing boolean operations
* {{PropertyData|Remove Splitter}}: Remove splitters from the resulting shape
* {{PropertyData|Remove Splitter}}: Remove splitters from the resulting shape
* {{PropertyData|North Deviation}}: The angle between the true North and the north direction in this document
* {{PropertyData|Declination}}: The angle between the true North and the North direction in this document, that is, the Y axis. {{version|0.18}} This means that by default North points to the Y axis, and East to the X axis; the angle increments counterclockwise. This property was previously known as {{PropertyData|North Deviation}}.
* {{PropertyData|EPW File}}: Allow to attach an EPW file from the [https://www.ladybug.tools/epwmap/ Ladybug EPW data website] to this site. This is needed to display wind rose diagrams {{version|0.19}}

=== View ===
* {{PropertyView|Solar Diagram}}: Shows or hides the solar diagram
* {{PropertyView|Solar Diagram}}: Shows or hides the solar diagram
* {{PropertyView|Solar Diagram Color}}: The color of the solar diagram
* {{PropertyView|Solar Diagram Color}}: The color of the solar diagram
* {{PropertyView|Solar Diagram Position}}: The position of the solar diagram
* {{PropertyView|Solar Diagram Position}}: The position of the solar diagram
* {{PropertyView|Solar Diagram Scale}}: The scale of the solar diagram
* {{PropertyView|Solar Diagram Scale}}: The scale of the solar diagram
* {{PropertyView|Wind Rose}}: Shows or hides the wind rose diagram (requires the '''EPW File''' data property filled, and the Ladybug Python module installed (see below)


== Typical workflow ==
== Typical workflow ==


Start by creating an object that represents your terrain. It must be an open surface, not a solid. For example, it is easy to import mesh data, that can be turned into a Part Shape from menu '''Part -> Create Shape from Mesh...'''. Then, create a Site object, and set its '''Terrain''' property to the Part we just created:
Start by creating an object that represents your terrain. It must be an open surface, not a solid. For example, it is easy to import mesh data, that can be turned into a Part Shape from menu {{MenuCommand|Part Create Shape from Mesh}}. Then, create a Site object, and set its {{PropertyData|Terrain}} property to the Part we just created:


[[Image:Arch site example 01.jpg]]
[[Image:Arch site example 01.jpg]]
Line 56: Line 82:
[[Image:Arch site example 03.jpg]]
[[Image:Arch site example 03.jpg]]


== Solar diagram ==
== Solar and wind diagrams ==


If [http://pysolar.org/ pysolar] is installed on your system, Arch Sites can display a solar diagram. For this, '''Longitude''', '''Latitude''' and '''NorthDeviation''' properties must be correctly set, and '''SolarDiagram''' view property turned on. {{Version|0.17}}
If [https://www.ladybug.tools/ladybug.html Ladybug] is installed on your system, [[Arch Site|Arch Sites]] can display a solar diagram and/or a wind rose. For this, {{PropertyData|Longitude}}, {{PropertyData|Latitude}} and {{PropertyData|Declination}} (previously {{PropertyData|North Deviation}}) must be correctly set, and {{PropertyView|Solar Diagram}} or {{PropertyView|Wind Rose}} set to {{TRUE}}. Respectively {{Version|0.17}} and {{Version|0.19}}


'''Note''': If you don't have Ladybug, [http://pysolar.org/ pysolar] is still supported to generate solar diagrams, but not wind roses. Pysolar 0.7 or above is required; this version only works with Python 3. If you require this feature with Python 2, you should have Pysolar 0.6 as this is the last version that works with Python 2. However, Ladybug is a much more powerful tool that will probably be used more in the future, so we recommend using it instead of pysolar. Ladybug can be installed simply via [https://github.com/ladybug-tools/ladybug pip].


[[Image:Freecad-solar-diagram.jpg]]
[[Image:Freecad-solar-diagram.jpg]]


<div class="mw-translate-fuzzy">
==Scripting==
==Scripting==
{{Emphasis|Siehe auch:}} [[Arch API/de|Arch API]] und [[FreeCAD Scripting Basics/de|FreeCAD Scripting Basics]].
</div>

<div class="mw-translate-fuzzy">
Das Baugrund-Werkzeug kann in [[macros/de|Makros]] ebenso wie aus der [[Python/de|Python]]-Konsole heraus über folgende Funktion angesprochen werden:
</div>


Das Baugrund-Werkzeug kann in [[macros/de|Makros]] ebenso wie aus der Python-Konsole heraus über folgende Funktion angesprochen werden:
{{Code|code=
{{Code|code=
makeSite ([objectslist])
Site = makeSite(objectslist=None, baseobj=None, name="Site")
}}
}}

<div class="mw-translate-fuzzy">
:erzeugt einen Baugrund inklusive der in der Liste angegebenen Objekte
:erzeugt einen Baugrund inklusive der in der Liste angegebenen Objekte
</div>


Beispiel:
Beispiel:
{{Code|code=
{{Code|code=
import Arch
import FreeCAD, Draft, Arch

Arch.makeSite()
p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 0, 0)
baseline = Draft.makeLine(p1, p2)
Wall = Arch.makeWall(baseline, length=None, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()

Building = Arch.makeBuilding([Wall])
Site = Arch.makeSite([Building])

FreeCAD.ActiveDocument.recompute()
FreeCAD.Gui.ActiveDocument.ActiveView.viewIsometric()
}}
}}

A solar diagram can also be created with:
=== Solar diagram ===

As long as the {{incode|pysolar}} module is present, a solar diagram can be added to the site. Set the longitude, latitude and declination angles as appropriate, as well as an adequate scale for the size of your model.

Please note that Pysolar 0.7 or above is required, and this version only works with Python 3.

{{Code|code=
{{Code|code=
Site.Longitude = -46.38
import Arch,FreeCADGui
Site.Latitude = -23.33
node = Arch.makeSolarDiagram(-46.38,-23.33) # longitude, latitude, [scale]
Site.Declination = 30
FreeCADGui.ActiveDocument.ActiveView.getSceneGraph().addChild(node)
#Site.Compass = True

Site.ViewObject.SolarDiagram = True
Site.ViewObject.SolarDiagramScale = 10000
FreeCAD.ActiveDocument.recompute()
}}
}}

=== Solar diagram independent of Site ===

A solar diagram can be created with the following function, independently of any site.
{{Code|code=
Node = makeSolarDiagram(longitude, latitude, scale=1, complete=False)
}}

* Creates a solar diagram as a Pivy node, using {{incode|longitude}} and {{incode|latitude}}, with an optional {{incode|scale}}.
* If {{incode|complete}} is {{incode|True}}, the 12 months are drawn, which shows the full solar [https://en.wikipedia.org/wiki/Analemma analemma].

{{Code|code=
import FreeCADGui, Arch

Node = Arch.makeSolarDiagram(-46.38, -23.33, scale=10000, complete=True)
FreeCAD.Gui.ActiveDocument.ActiveView.getSceneGraph().addChild(Node)
}}

<div class="mw-translate-fuzzy">
{{docnav/de
|[[Arch_Building/de|Gebäude]]
|[[Arch_Window/de|Fenster]]
|[[Arch_Module/de|Arch-Arbeitsbereich]]
|IconL=Arch_Building.svg
|IconC=Workbench_Arch.svg
|IconR=Arch_Window.svg
}}
</div>

{{Arch Tools navi{{#translation:}}}}

{{Userdocnavi{{#translation:}}}}

Revision as of 09:23, 2 June 2020

Baugrund

Menüeintrag
Architektur → Grundstück
Arbeitsbereich
Arch
Standardtastenkürzel
S I
Eingeführt in Version
-
Siehe auch
Etage, Gebäude

Beschreibung

Der Baugrund ist ein spezielles Objekt, das Eigenschaften eines Standard-FreeCAD-Group-Objekts und Arch-Objekten kombiniert. Es ist besonders zur Repräsentation einer gesamten Projektfläche bzw. eines Terrains geeignet. In IFC-basierter architektonischer Arbeit dient es der Organisation des CAD-Modells und enthält Gebäude-Objekte. Der Baugrund wird auch verwendet, um vorhandenes Gelände zu verwalten und anzuzeigen und kann benutzt werden, um das Volumen von aufzufüllender oder abzutragender Erde zu berechnen.

Anwendung

  1. Selektieren Sie optional ein oder mehrere Objekte, welche in den neuen Baugrund übernommen werden sollen.
  2. Drücken Sie die Schaltfläche Baugrund oder die Tasten S, dann I.

Optionen

  • Nach Anlegen des Baugrunds können diesem ein oder mehrere Objekte durch Ziehen in die Baumansicht oder mittels Hinzufügen-Werkzeug hinzugefügt werden.
  • Durch Ziehen von Objekten aus der Baumansicht oder mittels Entfernen-Werkzeug können Objekte vom Baugrund entfernt werden.

Eigenschaften

Data

  • DatenTerrain: The base terrain of this site
  • DatenAddress: The street and housenumber of this site
  • DatenPostal Code: The postal or zip code of this site
  • DatenCity: The city of this site
  • DatenCountry: The country of this site
  • DatenLatitude: The latitude of this site
  • DatenLongitude: The longitude of this site
  • DatenUrl: An url that shows this site in a mapping website
  • DatenProjected Area: The area of the projection of this object onto the XY plane
  • DatenPerimeter: The perimeter length of this terrain
  • DatenAddition Volume: The volume of earth to be added to this terrain
  • DatenSubtraction Volume: The volume of earth to be removed from this terrain
  • DatenExtrusion Vector: An extrusion vector to use when performing boolean operations
  • DatenRemove Splitter: Remove splitters from the resulting shape
  • DatenDeclination: The angle between the true North and the North direction in this document, that is, the Y axis. introduced in version 0.18 This means that by default North points to the Y axis, and East to the X axis; the angle increments counterclockwise. This property was previously known as DatenNorth Deviation.
  • DatenEPW File: Allow to attach an EPW file from the Ladybug EPW data website to this site. This is needed to display wind rose diagrams introduced in version 0.19

View

  • AnsichtSolar Diagram: Shows or hides the solar diagram
  • AnsichtSolar Diagram Color: The color of the solar diagram
  • AnsichtSolar Diagram Position: The position of the solar diagram
  • AnsichtSolar Diagram Scale: The scale of the solar diagram
  • AnsichtWind Rose: Shows or hides the wind rose diagram (requires the EPW File data property filled, and the Ladybug Python module installed (see below)

Typical workflow

Start by creating an object that represents your terrain. It must be an open surface, not a solid. For example, it is easy to import mesh data, that can be turned into a Part Shape from menu Part → Create Shape from Mesh. Then, create a Site object, and set its DatenTerrain property to the Part we just created:

Create some volumes (they must be solids) that represent the areas that you wish to be excavated or filled. Double-click the Site object in the Tree View, and add these volumes to the Additions or Subtractions groups. Click OK.

The site geometry will be recomputed and the areas, perimeter, and volumes properties recalculated.

Solar and wind diagrams

If Ladybug is installed on your system, Arch Sites can display a solar diagram and/or a wind rose. For this, DatenLongitude, DatenLatitude and DatenDeclination (previously DatenNorth Deviation) must be correctly set, and AnsichtSolar Diagram or AnsichtWind Rose set to true. Respectively introduced in version 0.17 and introduced in version 0.19


Note: If you don't have Ladybug, pysolar is still supported to generate solar diagrams, but not wind roses. Pysolar 0.7 or above is required; this version only works with Python 3. If you require this feature with Python 2, you should have Pysolar 0.6 as this is the last version that works with Python 2. However, Ladybug is a much more powerful tool that will probably be used more in the future, so we recommend using it instead of pysolar. Ladybug can be installed simply via pip.

Scripting

Siehe auch: Arch API und FreeCAD Scripting Basics.

Das Baugrund-Werkzeug kann in Makros ebenso wie aus der Python-Konsole heraus über folgende Funktion angesprochen werden:

Site = makeSite(objectslist=None, baseobj=None, name="Site")
erzeugt einen Baugrund inklusive der in der Liste angegebenen Objekte

Beispiel:

import FreeCAD, Draft, Arch

p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 0, 0)
baseline = Draft.makeLine(p1, p2)
Wall = Arch.makeWall(baseline, length=None, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()

Building = Arch.makeBuilding([Wall])
Site = Arch.makeSite([Building])

FreeCAD.ActiveDocument.recompute()
FreeCAD.Gui.ActiveDocument.ActiveView.viewIsometric()

Solar diagram

As long as the pysolar module is present, a solar diagram can be added to the site. Set the longitude, latitude and declination angles as appropriate, as well as an adequate scale for the size of your model.

Please note that Pysolar 0.7 or above is required, and this version only works with Python 3.

Site.Longitude = -46.38
Site.Latitude = -23.33
Site.Declination = 30
#Site.Compass = True

Site.ViewObject.SolarDiagram = True
Site.ViewObject.SolarDiagramScale = 10000
FreeCAD.ActiveDocument.recompute()

Solar diagram independent of Site

A solar diagram can be created with the following function, independently of any site.

Node = makeSolarDiagram(longitude, latitude, scale=1, complete=False)
  • Creates a solar diagram as a Pivy node, using longitude and latitude, with an optional scale.
  • If complete is True, the 12 months are drawn, which shows the full solar analemma.
import FreeCADGui, Arch

Node = Arch.makeSolarDiagram(-46.38, -23.33, scale=10000, complete=True)
FreeCAD.Gui.ActiveDocument.ActiveView.getSceneGraph().addChild(Node)