Extra python modules/ro

Această pagină afișează câteva module suplimentare de tip python sau alte piese de software care pot fi descărcate gratuit de pe internet și pot adăuga funcționalitate pentru FreeCAD instalat.

PySide (previously PyQt4)

 * homepage (PySide): http://qt-project.org/wiki/PySide
 * license: LGPL
 * opțional, dar necesare sunt câteva module: Draft, Arch, Ship, Plot, OpenSCAD, Spreadsheet

PySide (anterior numit PyQt) este solicitat de mai multe module ale FreeCAD pentru a accesa interfața Qt a FreeCAD. Acesta este deja inclus în versiunea Windows a FreeCAD și, de obicei, este instalat automat de FreeCAD pe Linux, când se instalează din depozitele oficiale. Dacă aceste module (Draft, Arch etc.) sunt activate după ce FreeCAD este instalat, înseamnă că PySide (anterior PyQt) este deja acolo și nu mai trebuie să mai faceți nimic.

Notă: FreeCAD sa mutat progresiv de la PyQt după versiunea 0.13, în favoareaPySide, care face exact același lucru, dar are o licență (LGPL) mai compatibilă cu FreeCAD.

Linux
Cea mai simplă modalitate de a instala PySide este prin managerul de pachete al distribuției. Pe sistemele Debian / Ubuntu, numele pachetului este în general "python-PySide", în timp ce în sistemele bazate pe RPM se numește "pyside". Dependentele necesare (Qt și SIP) vor fi luate în considerare automat.

Windows
Programul poate fi descărcat de la http://qt-project.org/wiki/Category:LanguageBindings::PySide::Downloads. Va trebui să instalați bibliotecile Qt și SIP înainte de a instala PySide (pentru a fi documentate).

MacOSX
PyQt on Mac can be installed via homebrew or port. See Compile on MacOS/ro for more information.

Utilizare
Odată ce este instalat, puteți verifica dacă totul funcționează prin tastarea în consolă Python FreeCAD:

To access the FreeCAD interface, type :

Acum puteți începe să explorați interfața cu comanda dir. Puteți adăuga elemente noi, cum ar fi un widget personalizat, cu comenzi cum ar fi:

Working with Unicode :

Working with QFileDialog and OpenFileName :

Working with QFileDialog and SaveFileName :

Example of transition from PyQt4 and PySide
PS: Aceste exemple de erori au fost găsite în tranziția de la PyQt4 la PySide și aceste corecții au fost făcute, alte soluții sunt cu siguranță disponibile cu exemplele de mai sus

Pentru a accesa interfața FreeCAD, tastați: Puteți adăuga elemente noi, cum ar fi un widget personalizat, cu comenzi cum ar fi:

Working with Unicode :

Working with QFileDialog and OpenFileName :

Working with QFileDialog and SaveFileName :

The MessageBox:

Working with setProperty (PyQt4) and setValue (PySide)

înlocuiți cu :

Working with setToolTip

înlocuiți la :

ori :

Documentație Suplimentară
Some pyQt4 tutorials (including how to build interfaces with Qt Designer to use with python):
 * http://pyqt.sourceforge.net/Docs/PyQt4/classes.html - the PyQt4 API Reference on sourceforge
 * http://www.rkblog.rk.edu.pl/w/p/introduction-pyqt4/ - a simple introduction
 * http://www.zetcode.com/tutorials/pyqt4/ - very complete in-depth tutorial

Pivy

 * homepage: https://bitbucket.org/Coin3D/coin/wiki/Home
 * license: BSD
 * optional, but needed by several modules of FreeCAD: Draft, Arch

Pivy is a needed by several modules to access the 3D view of FreeCAD. On windows, Pivy is already bundled inside the FreeCAD installer, and on Linux it is usually automatically installed when you install FreeCAD from an official repository. On MacOSX, unfortunately, you will need to compile pivy yourself.

Cerințe preliminare
Cred că înainte de a compila Pivy, veți dori să instalați Coin și SoQt.

Am găsit că pentru construirea pe Mac a fost suficient pentru a instala Coin3 binary package. Încercarea de a instala coin de la MacPorts a fost problematică: a încercat să adauge o mulțime de pachete X Windows și în cele din urmă s-a prăbușit cu o eroare de script.

For Fedora I found an RPM with Coin3.

SoQt compiled from source fine on Mac and Linux.

Debian & Ubuntu
Începând cu Debian Squeeze și Ubuntu Lucid, pivy va fi disponibil direct din depozitele oficiale, economisind astfel o mulțime de bătăi de cap. Între timp, puteți să descărcați unul dintre pachetele pe care le-am făcut (pentru debian și karmic ubuntu) disponibile în paginile Download sau să le compilați singur.

Cea mai bună modalitate de a compila pivy cu ușurință este să luați pachetul sursă debian pentru pivy și să faceți un pachet cu debuild. Este același cod sursă de pe site-ul oficial pivy, dar oamenii de la debian au făcut mai multe adăugări de fixare a bug-urilor. De asemenea, compilează bine karmicul ubuntu: http://packages.debian.org/squeeze/python-pivy descărcați fișierul .orig.gz și .diff.gz, apoi dezarhivați ambele, apoi aplicați .diff la sursă: mergeți la directorul sursă de pivy dezarhivate și aplicați patch-ul .diff:

then

to have pivy properly built into an official installable package. Then, just install the package with gdebi.

Alte distribuții linux
First get the latest sources from the project's repository:

As of March 2012, the latest version is Pivy-0.5.

Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Pivy-0.5 raportează că a fost testată numai cu SWIG 1.3.31, 1.3.33, 1.3.35 și 1.3.40. Deci, puteți descărca o sursă tarball pentru una dintre aceste versiuni vechi de la http://www.swig.org. Then unpack it and from a command line do (as root):

Ia doar câteva secunde compilarea.

Alternativ, puteți încerca construirea cu un SWIG mai recent. Începând cu luna martie 2012, o versiune tipică pentru depozit este 2.0.4. Pivy are o problemă minoră de compilare cu SWIG 2.0.4 pe Mac OS (vezi mai jos), dar pare să construiască bine pe Fedora Core 15.

După aceea, mergeți la sursele de pivy și sunați

which creates the source files. Note that build can produce thousands of warnings, but hopefully there will be no errors.

Acest lucru este probabil depășit, însă este posibil să întâmpinați o eroare de compilator în care un "const char *" nu poate fi convertit într-un 'char *'. Pentru a repara că trebuie doar să scrieți un "const" înainte în liniile corespunzătoare. Există șase linii de rezolvat.

După asta, instalați by issuing (ca root):

Et voila, pivy este instalat.

Mac OS
Este posibil ca aceste instrucțiuni să nu fie complete. Ceva aproape de acest lucru a funcționat pentru OS 10.7 în martie 2012. Eu folosesc MacPorts pentru depozite, dar ar trebui să funcționeze și alte opțiuni.

În ceea ce privește linux, obțineți cea mai recentă sursă:

Dacă nu aveți hg, îl puteți obține de la MacPorts:

Then, as above you need SWIG. It should be a matter of:

I found I needed also:

Începând cu luna martie 2012, MacPorts SWIG este la versiunea 2.0.4. După cum s-a menționat mai sus pentru linux, este posibil să fie mai bine să descărcați o versiune mai veche. SWIG 2.0.4 pare să aibă un bug care oprește clădirea Pivy. Vedeți primul mesaj din acest rezumat:https://sourceforge.net/mailarchive/message.php?msg_id=28114815

Acest lucru poate fi corectat prin editarea celor două locații sursă pentru a adăuga dereferențe: *arg4, *arg5 in place of arg4, arg5. Now Pivy should build:

Windows
Presupunând că utilizați Visual Studio 2005 sau o versiune ulterioară, ar trebui să deschideți un prompt de comandă cu "Visual Studio 2005 Command prompt" din meniul Instrumente. Dacă interpretul Python nu este încă în calea sistemului, faceți acest lucru

Pentru a obține o pivă de lucru, ar trebui să obțineți cele mai recente surse din depozitul proiectului:

Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Se recomandă utilizarea versiunii 1.3.25 a SWIG, nu cea mai recentă versiune, deoarece în acest moment pivy va funcționa corect numai cu 1.3.25. Descărcați binarele pentru 1.3.25 de la http://www.swig.org. Apoi despachetați-l și din linia de comandă adăugați-l pe calea sistemului

și setați COINDIR pe calea potrivită

Pe Windows, fișierul config pivy se așteaptă ca SoWin în loc de SoQt ca implicit. Nu am găsit o modalitate evidentă de a construi cu SoQt, așa că am modificat fișierul setup.py direct. În linia 200, scoateți doar partea "sowin": ('gui._sowin', 'sowin-config', 'pivy.gui.') (Nu scoateți paranteza de închidere).

After that go to the pivy sources and call

care creează fișierele sursă. S-ar putea să întâlniți o eroare de compilator că nu au putut fi găsite mai multe fișiere antet. În acest caz, ajustați variabila INCLUDE

și dacă antetele SoQt nu se află în același loc ca și antetele de Coin

și în final anteturile Qt

Dacă utilizați Express Edition din Visual Studio, puteți obține o excepție python keyerror. În acest caz, trebuie să modificați câteva lucruri în msvccompiler.py localizate în instalarea dvs. python.

Mergeți la linia 122 și înlocuiți linia de cod

cu

Apoi încercați din nou. Dacă primiți o a doua eroare cum ar fi

trebui să înlocuiți și linia 128

cu

Reîncercați încă o dată. Dacă apare din nou o eroare cum ar fi

then you should check the environment variables DISTUTILS_USE_SDK and MSSDK with

If not yet set then just set it e.g. to 1

Acum, puteți întâlni o eroare de compilator în care un 'const char *' nu poate fi convertit într-un 'char *'. Pentru a repara că trebuie doar să scrieți un "const" înainte în liniile corespunzătoare. Există șase linii de rezolvat. Dupa ce copiați directorul generat pivy într-un loc in care interpretul python din FreeCAD îl poate gasi.

Utilizare
Pentru a verifica dacă Pivy este instalat corect:

To have Pivy access the FreeCAD scenegraph do the following:

You can now explore the FCSceneGraph with the dir command.

Documentație suplimentară
Din păcate, documentația despre pivu este încă aproape inexistentă pe net. Dar s-ar putea să găsiți documentația Coin utilă, deoarece pivy pur și simplu traduce funcții de coin, noduri și metode în Python, totul păstrează același nume și proprietăți, ținând cont de diferența de sintaxă dintre C și python:


 * https://bitbucket.org/Coin3D/coin/wiki/Documentation - Coin3D API Reference
 * http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/index.html - The Inventor Mentor - The "bible" of Inventor scene description language.

You can also look at the Draft.py file in the FreeCAD Mod/Draft folder, since it makes big use of pivy.

pyCollada

 * homepage: http://pycollada.github.com
 * license: BSD
 * optional, needed to enable import and export of Collada (.DAE) files

pyCollada is a python library that allow programs to read and write Collada (*.DAE) files. When pyCollada is installed on your system, FreeCAD will be able to handle importing and exporting in the Collada file format.

Instalare
Pycollada, de obicei, nu este încă disponibilă în arhivele distribuțiilor linux, dar deoarece este făcută numai din fișiere Python, nu necesită compilare și este ușor de instalat. Aveți 2 moduri sau direct de la depozitul oficial pycollada git sau cu instrumentul easy_install.

Linux
În ambele cazuri, veți avea nevoie de următoarele pachete deja instalate în sistemul dvs.:

With easy_install
Presupunând că aveți deja o instalare python completă, utilitarul easy_install ar trebui să fie deja prezent:

You can check if pycollada was correctly installed by issuing in a python console:

If it returns nothing (no error message), then all is OK

Windows
Pe Windows, de la 0.15 pycollada este inclus atât în versiunea FreeCAD, cât și în versiunea dezvoltatorului, deci nu sunt necesare pași suplimentari.

Mac OS
Dacă utilizați buildul Homebrew al FreeCAD, puteți instala pycollada în sistemul dvs. Python folosind pip.

If you need to install pip:

Install pycollada:

Dacă utilizați o versiune binară a FreeCAD, puteți spune pip-ului să instaleze pycollada în pachetele de site-uri din cadrul FreeCAD.app:

sau după descărcarea codului pycollada

IfcOpenShell

 * homepage: http://www.ifcopenshell.org
 * license: LGPL
 * optional, needed to extend import abilities of IFC files

IFCOpenShell este o bibliotecă în curs de dezvoltare, care permite importul fișierelor Classes Fundation Classes (* .IFC) pentru import (și, în curând, export). IFC este o extensie a formatului STEP și devine standard în fluxurile de lucru BIM. Când sistemul ifcopenshell este instalat corect pe sistem, FreeCAD Arch Module îl va detecta și îl va folosi pentru a importa fișiere IFC în locul importatorului său rudimentar integrat. Deoarece ifcopenshell se bazează pe OpenCasCade, precum FreeCAD, calitatea importului este foarte mare, producând o geometrie solidă de înaltă calitate.

Instalare
Din moment ce ifcopenshell este destul de nou, probabil că va trebui să-l compilați singur.

Linux
Veți avea nevoie de câteva pachete de dezvoltare instalate pe sistemul dvs. pentru a compila ifcopenshell:

dar din moment ce FreeCAD le cere tuturor, dacă puteți compila FreeCAD, nu veți avea nevoie de nici o dependență suplimentară pentru a compila IfcOpenShell.

Grab the latest source code from here:

The build process is very easy:

or, if you are using oce instead of opencascade:

Deoarece ifcopenshell este făcut în primul rând pentru Blender, el folosește în mod implicit python3. Pentru a o folosi în interiorul FreeCAD, trebuie să o compilați împotriva aceleiași versiuni de Python care este folosită de FreeCAD. Deci este posibil să trebuiască să forțați versiunea python cu parametri suplimentari de tip cmake (ajustați versiunea python la a ta):

Then:

You can check that ifcopenshell was correctly installed by issuing in a python console:

If it returns nothing (no error message), then all is OK

Windows
Notă: Instalatorii oficiali FreeCAD obținuți de pe pagina web/github a FreeCAD conțin acum ifcopenshell.

Copied from the IfcOpenShell README file

Users are advised to use the Visual Studio .sln file in the win/ folder. For Windows users a prebuilt Open CASCADE version is available from the http://opencascade.org website. Download and install this version and provide the paths to the Open CASCADE header and library files to MS Visual Studio C++.

Pentru a construi învelișul IfcPython, trebuie instalat SWIG. Descărcați cea mai recentă versiune swigwin de la http://www.swig.org/download.html. După extragerea fișierului .zip, adăugați dosarul extras la variabila de mediu PATH. Python trebuie să fie instalat, vă rugăm să furnizați căile de includere și bibliotecă la Visual Studio.

Links
Tutorial Import/Export IFC - compiling IfcOpenShell

ODA Converter (în prealabil Teigha Converter)

 * homepage: https://www.opendesign.com/guestfiles/oda_file_converter
 * license: freeware
 * optional, used to enable import and export of DWG files

ODA Converter este un mic utilitar disponibil gratuit, care permite conversia între mai multe versiuni ale fișierelor DWG și DXF. FreeCAD îl poate folosi pentru a oferi import și export DWG, transformând fișierele DWG în formatul DXF ”sub capotă”, apoi utilizând importatorul DXF standard pentru a importa conținutul fișierului. Se aplică restricțiile aplicabile importatorului DXF.

Instalare
Pe toate platformele, numai prin instalarea pachetului corespunzător de la https://www.opendesign.com/guestfiles/oda_file_converter. După instalare, dacă utilitarul nu este găsit automat de FreeCAD, poate fi necesar să setați manual calea spre executabilul convertorului, Schimbați tabelul de lucru la "Draft", numai în meniul Editare → Preferinţe → Import-Export → DWG completați "Calea către Teigha File Converter" corespunzător.

LazyLoader
LazyLoader is a python module that allows deferred loading, while still importing at the top of the script. This is useful if you are importing another module that is slow, and it is used several times throughout the script. Using LazyLoader can improve workbench startup times, but the module will still need to be loaded on first use.

Installation
LazyLoader is included with FreeCAD v0.19

Usage
You will need to import LazyLoader, then change the import of whatever module you want to be deferred.

The variable Part is how the module is named in your script. You can replicate "import Part as P" by changing the variable.

You can also import a module from a package.

You can't import individual functions, just entire modules.

Links

 * Original source: https://github.com/tensorflow/tensorflow/blob/master/tensorflow/python/util/lazy_loader.py
 * Further explanation: https://wil.yegelwel.com/lazily-importing-python-modules/
 * Code within the FreeCAD source code: https://github.com/FreeCAD/FreeCAD/tree/master/src/3rdParty/lazy_loader
 * Forum discussion: https://forum.freecadweb.org/viewtopic.php?f=10&t=45298