{"id":15042313,"url":"https://github.com/gitgnu/gnu_pyformex","last_synced_at":"2026-01-18T04:04:43.798Z","repository":{"id":84520999,"uuid":"90390034","full_name":"gitGNU/gnu_pyformex","owner":"gitGNU","description":null,"archived":false,"fork":false,"pushed_at":"2017-05-05T15:24:34.000Z","size":54202,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T01:13:04.546Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitGNU.png","metadata":{"files":{"readme":"README","changelog":"History","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-05T15:24:18.000Z","updated_at":"2019-08-16T16:13:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"d3c5447e-7544-4e5e-b9c8-31556f1a09d2","html_url":"https://github.com/gitGNU/gnu_pyformex","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_pyformex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_pyformex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_pyformex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_pyformex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitGNU","download_url":"https://codeload.github.com/gitGNU/gnu_pyformex/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247103307,"owners_count":20884023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T20:47:07.037Z","updated_at":"2026-01-18T04:04:43.751Z","avatar_url":"https://github.com/gitGNU.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":".. $Id:$    -*- rst -*-\n\n..\n  This file is part of pyFormex 1.0.2  (Thu Jun 18 15:35:31 CEST 2015)\n  pyFormex is a tool for generating, manipulating and transforming 3D\n  geometrical models by sequences of mathematical operations.\n  Home page: http://pyformex.org\n  Project page:  http://savannah.nongnu.org/projects/pyformex/\n  Copyright 2004-2015 (C) Benedict Verhegghe (benedict.verhegghe@feops.com)\n  Distributed under the GNU General Public License version 3 or later.\n\n  This program is free software: you can redistribute it and/or modify\n  it under the terms of the GNU General Public License as published by\n  the Free Software Foundation, either version 3 of the License, or\n  (at your option) any later version.\n\n  This program is distributed in the hope that it will be useful,\n  but WITHOUT ANY WARRANTY; without even the implied warranty of\n  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n  GNU General Public License for more details.\n\n  You should have received a copy of the GNU General Public License\n  along with this program.  If not, see http://www.gnu.org/licenses/.\n\n\nWhat is pyFormex?\n=================\npyFormex is a tool for generating, manipulating and transforming large\ngeometrical models of 3D structures by sequences of mathematical\ntransformations. Thanks to a powerful (Python based) scripting language,\npyFormex is very well suited for the automated design of spatial frame\nstructures. It provides a wide range of operations on surface meshes,\nlike STL type triangulated surfaces. There are provisions to import medical\nscan images. pyFormex can also be used as a pre- and post-processor for\nFinite Element analysis programs. Finally, it might be used just for\ncreating some nice graphics.\n\nUsing pyFormex, the topology of the elements and the final geometrical form\ncan be decoupled. Often, topology is created first and then mapped onto the\ngeometry. Through the scripting language, the user can define any sequence\nof transformations, built from provided or user defined functions.\nThis way, building parametric models becomes a natural thing.\n\nWhile pyFormex is still under development (see the project page at\nhttp://savannah.nongnu.org/projects/pyformex/), it already provides a\nfairly stable scripting language and an OpenGL GUI environment for\ndisplaying and manipulating the generated structures.\n\n\nInstallation\n============\n\nWe detail here only the installation on Linux platforms.\n\n\nPrerequisites\n-------------\nEssential:\n\n- python: http://www.python.org  (version 2.4 or higher; 2.5 recommended)\n- numpy: /http://numpy.scipy.org/ (version 1.0 or higher; 1.1 recommended)\n- Qt4: http://www.trolltech.com/products/qt\n- PyOpenGL: http://pyopengl.sourceforge.net/\n- PySide: http://www.pyside.org/\n\nTo compile the acceleration library (highly recommended!), you will also\nneed the appropriate header Python and OpenGL header files.\n\nFurther, we recommend to install the following for extended functionality:\n\n- python-gnuplot\n- python-doc\n- python-scipy\n- units\n- imagemagick\n- admesh\n\nFor the following extensions, which are not easily packaged format,\nan install script is provided in this distribution.\n\n- calpy\n- pygl2ps\n- gts\n- tetgen\n\n\nEasy way to install prerequisites on Debian GNU/Linux or Ubuntu\n---------------------------------------------------------------\nOn Debian systems (and Debian-derivatives like Ubuntu) you can install\nall basic prerequisites and their dependencies with the command::\n\n  apt-get install python-pyside python-numpy\n\nIf you want to compile the acceleration library (which is highly recommended) you also need the header files::\n\n  apt-get install python-dev libgl1-mesa-dev libglu1-mesa-dev\n\nInstall the extras::\n\n  apt-get install python-gnuplot python-doc python-scipy units imagemagick admesh\n\nHowto install pyFormex:\n-----------------------\nIf a previous version of pyFormex was already installed on your system,\nyou may want to remove the older version first before installing the new one.\nSee further (Howto uninstall pyFormex)\n\nWe suppose you have installed all the prerequisites and downloaded the\npyformex source tarball: pyformex-VERSION.tar.gz\n\nUnpack the pyFormex source tarball::\n\n  tar xvzf pyformex-VERSION.tar.gz\n\nGo to the created pyformex directory::\n\n  cd pyformex-VERSION\n\nDo (with root privileges) ::\n\n  python setup.py install --prefix=/usr/local\n\nThis will install pyFormex under /usr/local/. You can change the prefix\nto install in some other place.\n\nAfter installation you can remove the directory where you unpacked the tarball.\n\nThe installation procedure installs everything into a single directory,\nand creates a symlink to the executable in /usr/local/bin.\nYou can use the command pyformex --whereami to find out where pyFormex\nis installed.\n\nIf you have xdg-utils on your system, the installation procedure will also\ninstall a menu and desktop starter for pyFormex.\n\n\nHowto uninstall pyFormex:\n-------------------------\nA pyFormex installation of version 0.5 or later can be removed with the command ::\n\n  pyformex --remove\n\nand then answering 'yes' to the question.\n\n\n\nHowto install the extra packages\n--------------------------------\npyFormex makes use of extra software components to enhance its functionality.\nWhile they are not required for the core operation of pyFormex, many users may\nwant to install them. Some of these extras (admesh, units) can easily be\ninstalled from your regular distribution repositories.\nSome extra components however either are not available in packaged format, or\nthe existing packages do not work together well with pyFormex.\nFor these components, the pyFormex distribution contains an adhoc install\nprocedure to help our users with the installation. The procedures are located\nin dedicated subdirectories of the pyformex-VERSION/pyformex/extra directory\nof the unpacked release tree. Each subdirectory contains a ``README`` file\nwith installation instructions. It the directory contains a ``Makefile``, this\nusually boils down to the usual::\n\n  make\n  make install\n\nElse, an install script ``install.sh`` is included and installation can be done\nwith by executing it from within the subdirectory, with root privileges and with a single parameter 'all'::\n\n  (sudo) ./install.sh all\n\n\nPrerequisites: on Debian::\n\n  apt-get install gcc g++ pkg-config make\n  apt-get install python-dev libglu1-mesa-dev\n  apt-get install libgts-dev libdxflib-dev\n\n\n- gts: Installs some programs to do operations on triangulated surfaces. You need to have the ``libgts`` and its header files installed.\n- dxfparser: Installs the command ``pyformex-dxfparser``, to preprocesses AutoCAD .DXF files for import into pyFormex. You need to have the ``libdxflib`` and its header files installed.\n- postabq: Installs the command ``pyformex-postabq``, to preprocess Abaqus output files (.fil) for import into pyFormex.\n- gl2ps: Image output to in vector formats (PS, EPS, PDF and SVG). Requires\n  a Python interface, provided by our install procedure.\n- calpy: Simple finite element simulation framework. Needed for the ``*_calpy``\n  examples. Has to be installed from source, because is has to be compiled\n  against the same numpy version as pyFormex itself.\n\n\nRunning pyFormex from sources\n-----------------------------\nIf the officially released pyFormex packages are not suitable for your needs,\nyou can try installing pyFormex from the source in the git repository.\nBesides the basic prerequisites (see above), you will also need to have\ngit installed.\n\nThe `GIT repository`_ on the developer site is accessible anonymously.\nThe command ::\n\n  git clone git://git.savannah.nongnu.org/pyformex.git MYDIR\n\nwill checkout the source to a local directory ``MYDIR``. Provided you have all the prerequisites installed, pyFormex can then be run directly from the checked out source with the command::\n\n  MYDIR/pyformex/pyformex\n\nIf you want to use the compiled accelerator library however, you will have to\ncreate it first::\n\n  cd MYDIR\n  make lib\n\nOnce you have a checked-out source tree, you can easily sync it to the latest\nrepository version by just issuing the following command from your checkout\ndirectory::\n\n  git pull\n\nDocumentation\n=============\n\nThe documentation is included with the pyFormex distribution. Execute the command\npyformex --whereami to find out where the pyformex files are\ninstalled. The pyformex path contains a directory doc/html with the\nfull html ocumentation.\nWhen working with the pyFormex GUI, you can load this local documentation in your browser\nusing the help menu, or view the online documentation at\nhttp://pyformex.org/doc.\n\nTo use pyFormex, you create a script that builds a structure layout and\ngeometry. Look at the examples to get the feeling of how it is working.\nUse the File-\u003ePlay menu selection to display the structure.\n\nThe examples and the Python source are relatively well documented.\n\n\nHelp and Feedback\n=================\n\nFor any questions or feedback, please go to the pyFormex support tracker at\nhttp://savannah.nongnu.org/support/?group=pyformex\n\nIf you find any bugs or malfunctions in pyFormex, please submit them to\nthe pyFormex Bug tracker http://savannah.nongnu.org/bugs/?group=pyformex\n\n.. _`SVN repository`: http://savannah.nongnu.org/svn/?group=pyformex\n\n.. target-notes::\n\n\nCopyright\n=========\n\npyFormex is distributed under the GNU GPL version 3 or later.\n\nThe main author claims that he wrote this software in his free time,\nfor his joy, not as a commissioned task. Any copyright claims made by\nhis employer (previous, current r future) should therefore be considered\nvoid.\n\nOver the years, other members of the pyFormex team have made valuable\ncontributions. These were made with full consent of the contributor that\nthey could be used at will inside the pyFormex project and were free of\nother copyright claims.\n\n.. End\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitgnu%2Fgnu_pyformex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitgnu%2Fgnu_pyformex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitgnu%2Fgnu_pyformex/lists"}