BIM Preflight/pl: Difference between revisions
(Created page with "BIM: Kontrola przed startem") |
No edit summary |
||
(21 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{GuiCommandAddon |
{{GuiCommandAddon/pl |
||
|Name=BIM Preflight |
|Name=BIM Preflight |
||
|Name/pl=BIM: Kontrola wstępna |
|||
|Workbenches=[[Image:IFC.svg|16px]] [[ |
|Workbenches=[[Image:IFC.svg|16px]] [[BIM_Workbench/pl|BIM]] |
||
|Addon=BIM |
|Addon=BIM |
||
|MenuLocation=Manage → Preflight check |
|MenuLocation=Manage → Preflight check |
||
}} |
}} |
||
= |
<span id="Description"></span> |
||
==Opis== |
|||
[[Image:BIM preflight screenshot.png|1024px]] |
[[Image:BIM preflight screenshot.png|1024px]] |
||
Ponieważ FreeCAD jest bardzo swobodną platformą do modelowania, wymagania są bardzo niskie. Zasadniczo można modelować i organizować model BIM w dowolny sposób, korzystając ze wszystkich narzędzi oferowanych przez FreeCAD, zarówno ze środowiska pracy BIM, jak i innych środowisk pracy. Format IFC ma jednak pewne surowe wymagania, a inne aplikacje BIM, które mogą odczytywać pliki IFC, często wprowadzają dodatkowe ograniczenia, ponieważ często mają trudności z niektórymi jednostkami lub sposobem modelowania niektórych obiektów. |
|||
As FreeCAD is a very loose and free-style modelling platform, the requirements are very low. You can basically model and organize your BIM model the way you like, using all the tools that FreeCAD offers, both from the BIM workbench and other workbenches. The IFC format, however, has some strict requirements, and other BIM applications that can read IFC files often bring additional limitations as they more than often have difficulties with certain entities or the way certain objects are modeled. |
|||
Narzędzie Kontrola wstępna umożliwia przeprowadzenie kilku testów modelu w celu zweryfikowania jego zgodności ze standardami IFC i najlepszymi praktykami, a także pomaga wykryć ewentualne problemy, które warto naprawić. |
|||
The BIM Preflight tool allows you to perform several tests on your model to verify its compatibility with IFC standards and best practices, and help you to detect possible issues you might want to fix. |
|||
Wyniki większości testów dostarczanych przez to narzędzie są opcjonalne, co oznacza, że możesz wyeksportować swój model, nawet jeśli zakończą się one niepowodzeniem. To Ty musisz ocenić, czy potrzebujesz testu, aby go zdać, czy nie. Dołożyliśmy wszelkich starań, aby dostarczyć rzetelnych informacji, które pomogą Ci podjąć decyzję. |
|||
The results of most of the tests provided by this tool are optional, which means you can choose to export your model even if they fail. You are the one to assess if you need the test to pass or not. We tried our best to give sound information to help you decide. |
|||
= |
<span id="Usage"></span> |
||
==Użycie== |
|||
* |
* Mieć otwarty model w programie FreeCAD, z co najmniej kilkoma obiektami. |
||
* Możesz wybrać obiekty przed uruchomieniem testów, w którym to przypadku masz możliwość wykonania testu tylko na wybranych obiektach. |
|||
* You can select objects before launching the tests, in which case you have the option to perform the test only on the selected objects |
|||
* Naciśnij przycisk '''Testuj wszystko''', aby wykonać wszystkie testy, lub tylko przyciski odpowiadające poszczególnym testom. |
|||
* Press the '''Test All''' button to perform all the tests, or only buttons corresponding to individual tests. |
|||
* Po zakończeniu testów naciśnięcie przycisku '''Niepowodzenie''' spowoduje wyświetlenie dodatkowych informacji, które pomogą ci zdecydować, czy jest to dla ciebie istotne, czy nie. |
|||
* When the tests have finished, pressing a '''Failed''' button will give you additional information to help you decide if this is relevant to you or not. |
|||
<span id="Builtin_tests"></span> |
|||
==Builtin tests== |
|||
==Testy wbudowane== |
|||
* ''' |
* '''Uruchom wszystkie testy''': uruchamia wszystkie testy jeden po drugim. |
||
<span id="FreeCAD_setup_tests"></span> |
|||
===FreeCAD setup tests=== |
|||
===Testy konfiguracji programu FreeCAD=== |
|||
* ''' |
* '''Obsługa IFC4''': Sprawdza, czy system importu / eksportu IFC FreeCAD działa poprawnie i czy format IFC4 jest dostępny ''(co wymaga aktualnej i włączonej w preferencjach wersji [[Arch_IFC/pl|IfcOpenShell]])''. |
||
<span id="Project_organization_tests"></span> |
|||
===Project organization tests=== |
|||
===Testy dotyczące organizacji projektu=== |
|||
* ''' |
* '''Hierarchia projektu''': Format IFC wymaga co najmniej jednego obiektu [[Arch Building/pl|budynku]], a powszechną praktyką jest również posiadanie jednego [[Arch_Site/pl|terenu]] i co najmniej jednego [[Arch_BuildingPart/pl|poziomu (kondygnacji)]]. Ten test sprawdza, czy są one obecne w modelu |
||
* ''' |
* '''Budynki''': Sprawdza, czy wszystkie budynki znalezione w modelu są częścią [[Arch_Site/pl|terenu]]. |
||
* '''Poziomy''': Sprawdza, czy wszystkie [[Arch_BuildingPart/pl|poziomy]] ''(kondygnacje budynku)'' znalezione w modelu są częścią budynku. |
|||
* '''Levels''': Checks that all [[Arch BuildingPart|levels]] (building storeys) found in the model are prt of a building |
|||
* '''Struktura obiektów''': Sprawdza, czy wszystkie obiekty znalezione w modelu są częścią poziomu. |
|||
* '''Objects structure''': Checks that all objects found in the model are part of a level |
|||
<span id="Objects_&_property_tests"></span> |
|||
===Objects & property tests=== |
|||
===Test obiektów i właściwościs=== |
|||
* '''Niezdefiniowane obiekty''': Sprawdza, czy w modelu znajdują się obiekty, które nie są obiektami BIM i dlatego zostaną wyeksportowane bez pełnych właściwości BIM. |
|||
* '''Undefined objects''': Checks if there are objects in the model that are not BIM objects, and will therefore be exported without full BIM properties |
|||
* '''Bryły''': Sprawdza, czy wszystkie obiekty w modelu mają prawidłową geometrię bryłową. |
|||
* '''Solids''': Checks that all objects in the model have valid solid geometry |
|||
* ''' |
* '''Ilości jawne''': Sprawdza, czy wszystkie obiekty z właściwościami długości, szerokości lub wysokości są [[BIM IfcQuantities|oznaczone do wyraźnego eksportu]] tych wielkości. |
||
* ''' |
* '''Zestawy wspólnych właściwości''': Sprawdza, czy wszystkie obiekty BIM wspólnych typów ''(ściana, drzwi itp.)'' mają zastosowany odpowiedni "wspólny" zestaw właściwości ''(Pset_WallCommon, Pset_DoorCommon itp.)''. |
||
* ''' |
* '''Integralność zestawów właściwości''': Sprawdza, czy wszystkie wspólne zestawy właściwości ''(Pset_WallCommon, Pset_DoorCommon itp.)'' znalezione w modelu zawierają wszystkie i tylko właściwości zdefiniowane przez standardy IFC. |
||
* ''' |
* '''Materiały''': Sprawdza, czy wszystkie obiekty BIM mają materiał. |
||
* ''' |
* '''Standardy''': Sprawdza, czy wszystkie obiekty BIM mają [[BIM_Classification/pl|kod standardu]]. |
||
<span id="Compatibility_tests"></span> |
|||
===Compatibility tests=== |
|||
===Testy kompatybilności=== |
|||
* '''Wyciągnięcia''': Sprawdza, czy wszystkie obiekty BIM są wyciągnięciami liniowymi. |
|||
* '''Extrusions''': Checks that all BIM objects are linear extrusions |
|||
* '''Przypadki standardowe''': Sprawdza, czy wszystkie elementy [[Arch_Wall/pl|ściany]] i [[Arch_Structure/pl|elementy konstrukcyjne]] są przypadkami standardowymi, zgodnie ze schematem IFC. |
|||
* '''Standard cases''': Checks that all [[Arch Wall|walls]] and [[Arch Structure|structural elements]] are standard cases, as defined by the IFC schema |
|||
* ''' |
* '''Drobne linie''': Sprawdza, czy żaden segment linii w modelu nie jest mniejszy niż 1/32", minimalna długość, z którą Revit jest w stanie sobie poradzić... |
||
* '''IfcRectangleProfileDef''': |
* '''IfcRectangleProfileDef''': Sprawdza, czy opcja eksportu profili prostokątnych jako IfcRectangleProfileDef jest wyłączona, ponieważ Revit ''(tak, znowu oni)'' nie jest w stanie zaimportować tego elementu. |
||
<span id="Custom_tests"></span> |
|||
==Custom tests== |
|||
==Testy niestandardowe== |
|||
Narzędzie '''Kontrola wstępna''' umożliwia również pisanie niestandardowych testów, które będą dołączane po wbudowanych narzędziach w oknie dialogowym Kontrola wstępna i uruchamiane po użyciu przycisku ''Uruchom wszystkie testy''. Testy te są napisane w języku Python. Składają się one z prostych funkcji wewnątrz jednego lub więcej plików Python. Możesz wykonać dowolną operację wewnątrz tych funkcji, muszą one po prostu przejść lub zakończyć się niepowodzeniem, a w przypadku niepowodzenia wyświetlić komunikat informujący użytkownika o niepowodzeniu. |
|||
The Preflight tool also allows you to write custom tests, that will be appended after the built-in tools in the Preflight dialog, and run when using the '''Run all tests''' button. These tests are written in Python. They consists of simple functions inside one or more Python files. You can perform any operation you want inside those functions, they must just pass or fail, and in case they fail, show a message informing the user of what failed. |
|||
Możesz napisać kilka testów w jednym pliku Python lub podzielić je na kilka plików, jak wolisz. Pliki te muszą być umieszczone w $USERAPPDATA/BIM/Preflight i mogą mieć dowolną nazwę ''(Upewnij się, że używasz bardzo unikalnych nazw, aby nie kolidować z żadnym wbudowanym modułem Pythona)''. Folder $USERAPPDATA zależy od platformy/systemu operacyjnego ''(zazwyczaj $HOME/.FreeCAD na linux/mac, /users/YOUR USER/Application Data/roaming/FreeCAD na windows)'' i można go również znaleźć wpisując go w konsoli FreeCAD Python: |
|||
FreeCAD.getUserAppDataDir() |
FreeCAD.getUserAppDataDir() |
||
Wewnątrz każdego pliku Python testy są prostymi funkcjami, które nie przyjmują żadnych argumentów i zwracają albo wartość {{True/pl}}, jeśli test się powiódł, albo ciąg tekstu, który zostanie wyświetlony użytkownikowi, jeśli test się nie powiódł. |
|||
Inside each Python file, tests are simple functions that take no argument, and return either True if the test passed, or a string of text that will be shown to the user if the test failed. |
|||
Typowy plik testowy powinien mieć nazwę "myCustomTest.py" i być umieszczony w $USERAPPDATA/BIM/Preflight: |
|||
import FreeCAD |
import FreeCAD |
Latest revision as of 09:14, 14 January 2024
BIM Preflight |
Położenie w menu |
---|
Manage → Preflight check |
Środowisko pracy |
BIM |
Skrót klawiszowy |
Brak |
Warto zobaczyć |
Brak informacji |
To polecenie jest częścią Dodatku BIM, który może być zainstalowany poprzez menu Przybory → Menadżer dodatków |
Opis
Ponieważ FreeCAD jest bardzo swobodną platformą do modelowania, wymagania są bardzo niskie. Zasadniczo można modelować i organizować model BIM w dowolny sposób, korzystając ze wszystkich narzędzi oferowanych przez FreeCAD, zarówno ze środowiska pracy BIM, jak i innych środowisk pracy. Format IFC ma jednak pewne surowe wymagania, a inne aplikacje BIM, które mogą odczytywać pliki IFC, często wprowadzają dodatkowe ograniczenia, ponieważ często mają trudności z niektórymi jednostkami lub sposobem modelowania niektórych obiektów.
Narzędzie Kontrola wstępna umożliwia przeprowadzenie kilku testów modelu w celu zweryfikowania jego zgodności ze standardami IFC i najlepszymi praktykami, a także pomaga wykryć ewentualne problemy, które warto naprawić.
Wyniki większości testów dostarczanych przez to narzędzie są opcjonalne, co oznacza, że możesz wyeksportować swój model, nawet jeśli zakończą się one niepowodzeniem. To Ty musisz ocenić, czy potrzebujesz testu, aby go zdać, czy nie. Dołożyliśmy wszelkich starań, aby dostarczyć rzetelnych informacji, które pomogą Ci podjąć decyzję.
Użycie
- Mieć otwarty model w programie FreeCAD, z co najmniej kilkoma obiektami.
- Możesz wybrać obiekty przed uruchomieniem testów, w którym to przypadku masz możliwość wykonania testu tylko na wybranych obiektach.
- Naciśnij przycisk Testuj wszystko, aby wykonać wszystkie testy, lub tylko przyciski odpowiadające poszczególnym testom.
- Po zakończeniu testów naciśnięcie przycisku Niepowodzenie spowoduje wyświetlenie dodatkowych informacji, które pomogą ci zdecydować, czy jest to dla ciebie istotne, czy nie.
Testy wbudowane
- Uruchom wszystkie testy: uruchamia wszystkie testy jeden po drugim.
Testy konfiguracji programu FreeCAD
- Obsługa IFC4: Sprawdza, czy system importu / eksportu IFC FreeCAD działa poprawnie i czy format IFC4 jest dostępny (co wymaga aktualnej i włączonej w preferencjach wersji IfcOpenShell).
Testy dotyczące organizacji projektu
- Hierarchia projektu: Format IFC wymaga co najmniej jednego obiektu budynku, a powszechną praktyką jest również posiadanie jednego terenu i co najmniej jednego poziomu (kondygnacji). Ten test sprawdza, czy są one obecne w modelu
- Budynki: Sprawdza, czy wszystkie budynki znalezione w modelu są częścią terenu.
- Poziomy: Sprawdza, czy wszystkie poziomy (kondygnacje budynku) znalezione w modelu są częścią budynku.
- Struktura obiektów: Sprawdza, czy wszystkie obiekty znalezione w modelu są częścią poziomu.
Test obiektów i właściwościs
- Niezdefiniowane obiekty: Sprawdza, czy w modelu znajdują się obiekty, które nie są obiektami BIM i dlatego zostaną wyeksportowane bez pełnych właściwości BIM.
- Bryły: Sprawdza, czy wszystkie obiekty w modelu mają prawidłową geometrię bryłową.
- Ilości jawne: Sprawdza, czy wszystkie obiekty z właściwościami długości, szerokości lub wysokości są oznaczone do wyraźnego eksportu tych wielkości.
- Zestawy wspólnych właściwości: Sprawdza, czy wszystkie obiekty BIM wspólnych typów (ściana, drzwi itp.) mają zastosowany odpowiedni "wspólny" zestaw właściwości (Pset_WallCommon, Pset_DoorCommon itp.).
- Integralność zestawów właściwości: Sprawdza, czy wszystkie wspólne zestawy właściwości (Pset_WallCommon, Pset_DoorCommon itp.) znalezione w modelu zawierają wszystkie i tylko właściwości zdefiniowane przez standardy IFC.
- Materiały: Sprawdza, czy wszystkie obiekty BIM mają materiał.
- Standardy: Sprawdza, czy wszystkie obiekty BIM mają kod standardu.
Testy kompatybilności
- Wyciągnięcia: Sprawdza, czy wszystkie obiekty BIM są wyciągnięciami liniowymi.
- Przypadki standardowe: Sprawdza, czy wszystkie elementy ściany i elementy konstrukcyjne są przypadkami standardowymi, zgodnie ze schematem IFC.
- Drobne linie: Sprawdza, czy żaden segment linii w modelu nie jest mniejszy niż 1/32", minimalna długość, z którą Revit jest w stanie sobie poradzić...
- IfcRectangleProfileDef: Sprawdza, czy opcja eksportu profili prostokątnych jako IfcRectangleProfileDef jest wyłączona, ponieważ Revit (tak, znowu oni) nie jest w stanie zaimportować tego elementu.
Testy niestandardowe
Narzędzie Kontrola wstępna umożliwia również pisanie niestandardowych testów, które będą dołączane po wbudowanych narzędziach w oknie dialogowym Kontrola wstępna i uruchamiane po użyciu przycisku Uruchom wszystkie testy. Testy te są napisane w języku Python. Składają się one z prostych funkcji wewnątrz jednego lub więcej plików Python. Możesz wykonać dowolną operację wewnątrz tych funkcji, muszą one po prostu przejść lub zakończyć się niepowodzeniem, a w przypadku niepowodzenia wyświetlić komunikat informujący użytkownika o niepowodzeniu.
Możesz napisać kilka testów w jednym pliku Python lub podzielić je na kilka plików, jak wolisz. Pliki te muszą być umieszczone w $USERAPPDATA/BIM/Preflight i mogą mieć dowolną nazwę (Upewnij się, że używasz bardzo unikalnych nazw, aby nie kolidować z żadnym wbudowanym modułem Pythona). Folder $USERAPPDATA zależy od platformy/systemu operacyjnego (zazwyczaj $HOME/.FreeCAD na linux/mac, /users/YOUR USER/Application Data/roaming/FreeCAD na windows) i można go również znaleźć wpisując go w konsoli FreeCAD Python:
FreeCAD.getUserAppDataDir()
Wewnątrz każdego pliku Python testy są prostymi funkcjami, które nie przyjmują żadnych argumentów i zwracają albo wartość Prawda
, jeśli test się powiódł, albo ciąg tekstu, który zostanie wyświetlony użytkownikowi, jeśli test się nie powiódł.
Typowy plik testowy powinien mieć nazwę "myCustomTest.py" i być umieszczony w $USERAPPDATA/BIM/Preflight:
import FreeCAD # The name of your test. You can give the functions any name # you want, the important is the description text below def myCustomTest(): # This describes what your test does. For example, # here, it checks that there is at least one object in the document. # This text will appear next to the button in the Preflight tool """Checks that the document contains at least one object""" doc = FreeCAD.ActiveDocument objects = doc.Objects if len(objects) >= 1: result = True else: result = "This document contains no object" # The function must return either True or a string of # text if the test failed. The string or text will be displayed # to the user when they press the "Failed" button. return result