Arch Site/ro: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(21 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand|Name=Arch Site|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch → Site|Shortcut=S I|SeeAlso=[[Arch Floor|Arch Floor]], [[Arch Building|Arch Building]]}}


{{Docnav
|[[Arch_Project|Project]]
|[[Arch_Building|Building]]
|[[Arch_Workbench|Arch]]
|IconL=Arch_Project.svg
|IconR=Arch_Building.svg
|IconC=Workbench_Arch.svg
}}

<div class="mw-translate-fuzzy">
{{GuiCommand|Name=Arch Site|Workbenches=[[Arch_Workbench/ro|Arch]]|MenuLocation=Arch → Site|Shortcut=S I|SeeAlso=[[Arch Floor|Arch Floor]], [[Arch Building|Arch Building]]}}
</div>

<span id="Description"></span>
==Descriere==
==Descriere==


Site-ul Arch este un obiect special care combină proprietățile unui obiect standard al grupului FreeCAD și a obiectelor Arch. Este deosebit de potrivit pentru a reprezenta un întreg sit de proiect sau teren. În cazul lucrărilor arhitecturale bazate pe IFC, se utilizează cea mai mare parte pentru a vă organiza modelul, conținând obiecte [[Arch Building|building]]. Site-ul este, de asemenea, folosit pentru a gestiona și a afișa un teren fizic și poate calcula volumul de pământ care trebuie adăugat sau eliminat.
Site-ul Arch este un obiect special care combină proprietățile unui obiect standard al grupului FreeCAD și a obiectelor Arch. Este deosebit de potrivit pentru a reprezenta un întreg sit de proiect sau teren. În cazul lucrărilor arhitecturale bazate pe IFC, se utilizează cea mai mare parte pentru a vă organiza modelul, conținând obiecte [[Arch Building|building]]. Site-ul este, de asemenea, folosit pentru a gestiona și a afișa un teren fizic și poate calcula volumul de pământ care trebuie adăugat sau eliminat.


<span id="Usage"></span>
<div class="mw-translate-fuzzy">
== Cum se folosește ==
== Cum se folosește ==
</div>


<div class="mw-translate-fuzzy">
# Optionally, select one or more objects to be included in your new site
# Optionally, select one or more objects to be included in your new site
# Press the {{KEY|[[Image:Arch Site.png|16px]] '''Arch Site'''}} button, or press the {{KEY|S}} then {{KEY|I}} keys
# Press the {{KEY|[[Image:Arch Site.png|16px]] '''Arch Site'''}} button, or press the {{KEY|S}} then {{KEY|I}} keys
</div>


<span id="Options"></span>
== Opţiuni ==
== Opţiuni ==


<div class="mw-translate-fuzzy">
* After creating a site, you can add more objects to it by drag and dropping them in the Tree View or by using the [[Image:Arch Add.png|16px]] [[Arch Add|Arch Add]] tool. This only determines which object is part of the given site, and has no effect on the terrain itself.
* After creating a site, you can add more objects to it by drag and dropping them in the Tree View or by using the [[Image:Arch Add.png|16px]] [[Arch Add|Arch Add]] tool. This only determines which object is part of the given site, and has no effect on the terrain itself.
* You can remove objects from a site by drag and dropping them out of it the Tree View or by using the [[Image:Arch Remove.png|16px]] [[Arch Remove|Arch Remove]] tool
* You can remove objects from a site by drag and dropping them out of it the Tree View or by using the [[Image:Arch Remove.png|16px]] [[Arch Remove|Arch Remove]] tool
Line 18: Line 38:
* You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its Subtractions or Additions groups. The objects must be solids.
* You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its Subtractions or Additions groups. The objects must be solids.
* The '''Extrusion Vector''' property can be used to solve some problems that can appear when working with subtractions and additions. In order to perform those additions/subtractions, the terrain surface is extruded into a solid, which is then appropriately unioned/subtracted. Depending on the terrain topology, this extrusion might fail with the default extrusion vector. You might therefore be able to remedy the problem by changing this to a different value.
* The '''Extrusion Vector''' property can be used to solve some problems that can appear when working with subtractions and additions. In order to perform those additions/subtractions, the terrain surface is extruded into a solid, which is then appropriately unioned/subtracted. Depending on the terrain topology, this extrusion might fail with the default extrusion vector. You might therefore be able to remedy the problem by changing this to a different value.
</div>


<span id="Properties"></span>
==Proprietăți==
==Proprietăți==


=== Data ===

<div class="mw-translate-fuzzy">
* {{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 40: Line 65:
* {{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
</div>

=== View ===

* {{PropertyView|Solar Diagram}}: Shows or hides 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 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 ==


<div class="mw-translate-fuzzy">
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 '''Part -> Create Shape from Mesh...'''. Then, create a Site object, and set its '''Terrain''' property to the Part we just created:
</div>


[[Image:Arch site example 01.jpg]]
[[Image:Arch site example 01.jpg]]
Line 55: Line 91:
[[Image:Arch site example 03.jpg]]
[[Image:Arch site example 03.jpg]]


<span id="Solar_and_wind_diagrams"></span>
<div class="mw-translate-fuzzy">
== Solar diagram ==
== Solar diagram ==
</div>


<div class="mw-translate-fuzzy">
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 [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}}
</div>

'''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]]


==Scripting==

<div class="mw-translate-fuzzy">
== Scrip-Programare ==
== Scrip-Programare ==
</div>


<div class="mw-translate-fuzzy">
Instrumentul Site poate fi utilizat în [[macros]] și de la consola python utilizând următoarele funcții:
Instrumentul Site poate fi utilizat în [[macros]] și de la consola python utilizând următoarele funcții:
</div>

{{Code|code=
{{Code|code=
makeSite ([objectslist])
Site = makeSite(objectslist=None, baseobj=None, name="Site")
}}
}}

<div class="mw-translate-fuzzy">
creează un site incluzând obiectele din lista dată.
creează un site incluzând obiectele din lista dată.
</div>


Exempluː
Exempluː
{{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()
}}
}}

=== 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=
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 ===

<div class="mw-translate-fuzzy">
O diagramă de însorire poate fi creată cu :
O diagramă de însorire poate fi creată cu :
</div>
{{Code|code=
{{Code|code=
Node = makeSolarDiagram(longitude, latitude, scale=1, complete=False)
import Arch,FreeCADGui
node = Arch.makeSolarDiagram(-46.38,-23.33) # longitude, latitude, [scale]
FreeCADGui.ActiveDocument.ActiveView.getSceneGraph().addChild(node)
}}
}}


* Creates a solar diagram as a Pivy node, using {{incode|longitude}} and {{incode|latitude}}, with an optional {{incode|scale}}.
[[Category:Arch]]
* 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|[[Arch_Building|Building]]|[[Arch_Reference|Reference]]|[[Arch_Workbench/ro|Arch]]|IconL=Arch_Building.svg |IconC=Workbench_Arch.svg |IconR=Arch_Reference.svg}}
</div>

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

Latest revision as of 16:55, 15 February 2023

Arch Site

Menu location
Arch → Site
Workbenches
Arch
Default shortcut
S I
Introduced in version
-
See also
Arch Floor, Arch Building

Descriere

Site-ul Arch este un obiect special care combină proprietățile unui obiect standard al grupului FreeCAD și a obiectelor Arch. Este deosebit de potrivit pentru a reprezenta un întreg sit de proiect sau teren. În cazul lucrărilor arhitecturale bazate pe IFC, se utilizează cea mai mare parte pentru a vă organiza modelul, conținând obiecte building. Site-ul este, de asemenea, folosit pentru a gestiona și a afișa un teren fizic și poate calcula volumul de pământ care trebuie adăugat sau eliminat.

Cum se folosește

  1. Optionally, select one or more objects to be included in your new site
  2. Press the Arch Site button, or press the S then I keys

Opţiuni

  • After creating a site, you can add more objects to it by drag and dropping them in the Tree View or by using the Arch Add tool. This only determines which object is part of the given site, and has no effect on the terrain itself.
  • You can remove objects from a site by drag and dropping them out of it the Tree View or by using the Arch Remove tool
  • You can add a terrain object by editing the Site's Terrain property. The terrain must be an open shell or surface.
  • You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its Subtractions or Additions groups. The objects must be solids.
  • The Extrusion Vector property can be used to solve some problems that can appear when working with subtractions and additions. In order to perform those additions/subtractions, the terrain surface is extruded into a solid, which is then appropriately unioned/subtracted. Depending on the terrain topology, this extrusion might fail with the default extrusion vector. You might therefore be able to remedy the problem by changing this to a different value.

Proprietăți

Data

  • DateTerrain: The base terrain of this site
  • DateAddress: The street and housenumber of this site
  • DatePostal Code: The postal or zip code of this site
  • DateCity: The city of this site
  • DateCountry: The country of this site
  • DateLatitude: The latitude of this site
  • DateLongitude: The longitude of this site
  • DateUrl: An url that shows this site in a mapping website
  • DateProjected Area: The area of the projection of this object onto the XY plane
  • DatePerimeter: The perimeter length of this terrain
  • DateAddition Volume: The volume of earth to be added to this terrain
  • DateSubtraction Volume: The volume of earth to be removed from this terrain
  • DateExtrusion Vector: An extrusion vector to use when performing boolean operations
  • DateRemove Splitter: Remove splitters from the resulting shape
  • DateNorth Deviation: The angle between the true North and the north direction in this document
  • VizualizareSolar Diagram: Shows or hides the solar diagram
  • VizualizareSolar Diagram Color: The color of the solar diagram
  • VizualizareSolar Diagram Position: The position of the solar diagram
  • VizualizareSolar Diagram Scale: The scale of the solar diagram

View

  • VizualizareSolar Diagram: Shows or hides the solar diagram
  • VizualizareSolar Diagram Color: The color of the solar diagram
  • VizualizareSolar Diagram Position: The position of the solar diagram
  • VizualizareSolar Diagram Scale: The scale of the solar diagram
  • VizualizareWind 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 Terrain 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 diagram

If 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. introduced in version 0.17

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

Scrip-Programare

Instrumentul Site poate fi utilizat în macros și de la consola python utilizând următoarele funcții:

Site = makeSite(objectslist=None, baseobj=None, name="Site")

creează un site incluzând obiectele din lista dată.

Exempluː

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

O diagramă de însorire poate fi creată cu :

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)