Arch Site/ru: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(33 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{docnav|[[Arch_Building|Building]]|[[Arch_Window|Window]]|[[Arch_Module|Arch]]|IconL=Arch_Building.svg |IconC=Workbench_Arch.svg |IconR=Arch_Window.svg}} |
|||
{{Docnav/ru |
|||
<div class="mw-translate-fuzzy"> |
|||
|[[Arch_Project/ru|Проект]] |
|||
|[[Arch_Building/ru|Здание]] |
|||
|[[Arch_Workbench/ru|Архитектурный верстак "Arch"]] |
|||
|IconL=Arch_Project.svg |
|||
|IconR=Arch_Building.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
{{GuiCommand/ru |
{{GuiCommand/ru |
||
|Name=Arch Site |
|Name=Arch Site |
||
|Name/ru= |
|Name/ru=Местность |
||
|Workbenches=[[ |
|Workbenches=[[Arch_Workbench/ru|Arch]] |
||
|MenuLocation=Архитектура → Место |
|MenuLocation=Архитектура → Место |
||
|Shortcut=S I |
|Shortcut={{KEY|S}} {{KEY|I}} |
||
|SeeAlso=[[ |
|SeeAlso=[[Arch_Floor/ru|Уровень]], [[Arch_Building/ru|Здание]] |
||
}} |
}} |
||
</div> |
|||
= |
<span id="Description"></span> |
||
==Описание== |
|||
The Arch Site is a special object that combines properties of a standard FreeCAD group object and Arch objects. It is particularly suited for representing a whole project site, or terrain. In IFC-based architectural work, it is mostly used to organize your model, by containing [[Arch Building|building]] objects. The site is also used to manage and display a physical terrain, and can |
The Arch Site is a special object that combines properties of a standard FreeCAD group object and Arch objects. It is particularly suited for representing a whole project site, or terrain. In IFC-based architectural work, it is mostly used to organize your model, by containing [[Arch Building|building]] objects. The site is also used to manage and display a physical terrain, and can compute volumes of earth to be added or removed. |
||
<span id="Usage"></span> |
|||
==How to use== |
|||
==Применение== |
|||
# 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 {{Button|[[Image:Arch Site.svg|16px]] [[Arch Site]]}} button, or press the {{KEY|S}} then {{KEY|I}} keys. |
# Press the {{Button|[[Image:Arch Site.svg|16px]] [[Arch Site|Arch Site]]}} button, or press the {{KEY|S}} then {{KEY|I}} keys. |
||
= |
<span id="Options"></span> |
||
==Опции== |
|||
* After creating a site, you can add |
* After creating a site, you can add objects to it by drag and dropping them in the [[Tree_view|Tree view]] or by using the {{Button|[[Image:Arch Add.svg|16px]] [[Arch Add|Arch Add]]}} tool. This only determines which objects are part of the given site, and has no effect on the terrain. |
||
* You can remove objects from a site by drag and dropping them out of it the Tree |
* You can remove objects from a site by drag and dropping them out of it in the [[Tree_view|Tree view]] or by using the {{Button|[[Image:Arch Remove.svg|16px]] [[Arch Remove|Arch Remove]]}} tool. |
||
* You can add a terrain object by editing the Site's {{PropertyData|Terrain}} property. The terrain |
* You can add a terrain object by editing the Site's {{PropertyData|Terrain}} property. The terrain can be an open shell or ({{Version|0.21}}) a solid. |
||
* You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its |
* You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its Additions or Subtractions groups. The objects must be solids. |
||
* The {{PropertyData|Extrusion Vector}} property can be used to solve some problems that can appear when |
* The {{PropertyData|Extrusion Vector}} property can be used to solve some problems that can appear when the terrain is an open shell and there are additions and/or subtractions. In order to perform those additions/subtractions, the open shell 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 then be able to remedy the problem by changing this to a different value. This property is ignored if the terrain is a solid. |
||
= |
<span id="Properties"></span> |
||
==Свойства== |
|||
<span id="Data"></span> |
|||
=== Данные === |
|||
⚫ | |||
* {{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 47: | Line 59: | ||
* {{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| |
* {{PropertyData|Declination}}: The angle between the true North and the North direction in this document, that is, the Y axis. 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 |
|||
<span id="View"></span> |
|||
⚫ | |||
=== 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) |
|||
<span id="Typical_workflow"></span> |
|||
== Typical workflow == |
|||
== Типовой рабочий процесс == |
|||
Start by creating an object that represents your terrain |
Start by creating an object that represents your terrain. 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 69: | Line 86: | ||
[[Image:Arch site example 03.jpg]] |
[[Image:Arch site example 03.jpg]] |
||
== Solar |
== Solar and wind diagrams == |
||
If [ |
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}}. |
||
'''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]] |
||
= |
<span id="Scripting"></span> |
||
==Программирование== |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
{{Code|code= |
{{Code|code= |
||
Site = makeSite(objectslist=None, baseobj=None, name="Site") |
Site = makeSite(objectslist=None, baseobj=None, name="Site") |
||
Line 85: | Line 107: | ||
* Creates a {{incode|Site}} object from {{incode|objectslist}}, which is a list of objects, or {{incode|baseobj}}, which is a {{incode|Shape}} or {{incode|Terrain}}. |
* Creates a {{incode|Site}} object from {{incode|objectslist}}, which is a list of objects, or {{incode|baseobj}}, which is a {{incode|Shape}} or {{incode|Terrain}}. |
||
Пример: |
|||
Example: |
|||
{{Code|code= |
{{Code|code= |
||
import FreeCAD, Draft, Arch |
import FreeCAD, Draft, Arch |
||
Line 95: | Line 117: | ||
FreeCAD.ActiveDocument.recompute() |
FreeCAD.ActiveDocument.recompute() |
||
Building = Arch.makeBuilding([Wall]) |
|||
Site = Arch.makeSite([Building]) |
|||
FreeCAD.ActiveDocument.recompute() |
FreeCAD.ActiveDocument.recompute() |
||
FreeCAD.Gui.ActiveDocument.ActiveView.viewIsometric() |
|||
}} |
}} |
||
=== Solar diagram === |
=== 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. |
|||
FreeCAD can add a solar diagram to the active document if the {{incode|Pysolar}} (or {{incode|pysolar}}?) module is available. This module only works with Python3. |
|||
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 === |
|||
⚫ | |||
{{Code|code= |
{{Code|code= |
||
Node = makeSolarDiagram(longitude, latitude, scale=1, complete=False) |
Node = makeSolarDiagram(longitude, latitude, scale=1, complete=False) |
||
Line 109: | Line 149: | ||
* Creates a solar diagram as a Pivy node, using {{incode|longitude}} and {{incode|latitude}}, with an optional {{incode|scale}}. |
* 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. |
* 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= |
{{Code|code= |
||
import FreeCADGui, Arch |
import FreeCADGui, Arch |
||
Node = Arch.makeSolarDiagram(-46.38, -23.33) |
Node = Arch.makeSolarDiagram(-46.38, -23.33, scale=10000, complete=True) |
||
FreeCAD.Gui.ActiveDocument.ActiveView.getSceneGraph().addChild(Node) |
|||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
[[Category:Arch/ru]] |
|||
{{Docnav/ru |
|||
</div> |
|||
|[[Arch_Project/ru|Проект]] |
|||
|[[Arch_Building/ru|Здание]] |
|||
|[[Arch_Workbench/ru|Архитектурный верстак "Arch"]] |
|||
|IconL=Arch_Project.svg |
|||
|IconR=Arch_Building.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
{{Arch Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 15:33, 20 May 2023
Местность |
Системное название |
---|
Arch Site |
Расположение в меню |
Архитектура → Место |
Верстаки |
Arch |
Быстрые клавиши |
S I |
Представлено в версии |
- |
См. также |
Уровень, Здание |
Описание
The Arch Site is a special object that combines properties of a standard FreeCAD group object and Arch objects. It is particularly suited for representing a whole project site, or terrain. In IFC-based architectural work, it is mostly used to organize your model, by containing building objects. The site is also used to manage and display a physical terrain, and can compute volumes of earth to be added or removed.
Применение
- Optionally, select one or more objects to be included in your new site.
- Press the Arch Site button, or press the S then I keys.
Опции
- After creating a site, you can add objects to it by drag and dropping them in the Tree view or by using the Arch Add tool. This only determines which objects are part of the given site, and has no effect on the terrain.
- You can remove objects from a site by drag and dropping them out of it in 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 can be an open shell or (introduced in version 0.21) a solid.
- You can add volumes to be added or subtracted from the base terrain, by double-clicking the Site, and adding objects to its Additions or Subtractions groups. The objects must be solids.
- The ДанныеExtrusion Vector property can be used to solve some problems that can appear when the terrain is an open shell and there are additions and/or subtractions. In order to perform those additions/subtractions, the open shell 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 then be able to remedy the problem by changing this to a different value. This property is ignored if the terrain is a solid.
Свойства
Данные
- ДанныеTerrain: The base terrain of this site
- ДанныеAddress: The street and housenumber of this site
- ДанныеPostal Code: The postal or zip code of this site
- ДанныеCity: The city of this site
- ДанныеCountry: The country of this site
- ДанныеLatitude: The latitude of this site
- ДанныеLongitude: The longitude of this site
- ДанныеUrl: An url that shows this site in a mapping website
- ДанныеProjected Area: The area of the projection of this object onto the XY plane
- ДанныеPerimeter: The perimeter length of this terrain
- ДанныеAddition Volume: The volume of earth to be added to this terrain
- ДанныеSubtraction Volume: The volume of earth to be removed from this terrain
- ДанныеExtrusion Vector: An extrusion vector to use when performing boolean operations
- ДанныеRemove Splitter: Remove splitters from the resulting shape
- ДанныеDeclination: The angle between the true North and the North direction in this document, that is, the Y axis. 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 ДанныеNorth Deviation.
- ДанныеEPW File: Allow to attach an EPW file from the Ladybug EPW data website to this site. This is needed to display wind rose diagrams
Вид
- ВидSolar Diagram: Shows or hides the solar diagram
- ВидSolar Diagram Color: The color of the solar diagram
- ВидSolar Diagram Position: The position of the solar diagram
- ВидSolar Diagram Scale: The scale of the solar diagram
- ВидWind Rose: Shows or hides the wind rose diagram (requires the EPW File data property filled, and the Ladybug Python module installed (see below)
Типовой рабочий процесс
Start by creating an object that represents your terrain. 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 and wind diagrams
If Ladybug is installed on your system, Arch Sites can display a solar diagram and/or a wind rose. For this, ДанныеLongitude, ДанныеLatitude and ДанныеDeclination (previously ДанныеNorth Deviation) must be correctly set, and ВидSolar Diagram or ВидWind Rose set to true
.
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.
Программирование
See also: Arch API and FreeCAD Scripting Basics.
The Site tool can be used in macros and from the Python console by using the following function:
Site = makeSite(objectslist=None, baseobj=None, name="Site")
- Creates a
Site
object fromobjectslist
, which is a list of objects, orbaseobj
, which is aShape
orTerrain
.
Пример:
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
andlatitude
, with an optionalscale
. - If
complete
isTrue
, 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)
- Elements: Wall, Structure, Curtain Wall, Window, Roof, Space, Stairs, Equipment, Frame, Fence, Truss, Profile, Pipe, Pipe Connector
- Reinforcements: Straight Rebar, U-Shape Rebar, L-Shape Rebar, Stirrup, Bent-Shape Rebar, Helical Rebar, Column Reinforcement, Beam Reinforcement, Slab Reinforcement, Footing Reinforcement, Custom Rebar
- Panels: Panel, Panel Cut, Panel Sheet, Nest
- Materials: Material, Multi-Material
- Organization: Building Part, Project, Site, Building, Level, External reference, Section Plane, Schedule
- Axes: Axis, Axes system, Grid
- Modification: Cut with plane, Add component, Remove component, Survey
- Utilities: Component, Clone component, Split Mesh, Mesh to Shape, Select non-manifold meshes, Remove Shape from Arch, Close Holes, Merge Walls, Check, Toggle IFC Brep flag, 3 Views from mesh, Create IFC spreadsheet, Toggle Subcomponents
- Additional: Preferences, Import Export Preferences (IFC, DAE, OBJ, JSON, 3DS, SHP), IfcOpenShell, IfcPlusPlus, Arch API
- Начинающим
- Установка: Загрузка, Windows, Linux, Mac, Дополнительных компонентов, Docker, AppImage, Ubuntu Snap
- Базовая: О FreeCAD, Интерфейс, Навигация мыши, Методы выделения, Имя объекта, Настройки, Верстаки, Структура документа, Свойства, Помоги FreeCAD, Пожертвования
- Помощь: Учебники, Видео учебники
- Верстаки: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework