Mesh Scripting/es: Difference between revisions

From FreeCAD Documentation
(Created page with "Por último, un ejemplo completo que calcula la intersección entre una esfera y un cilindro que corta a la esfera.")
(Created page with "Ver también: Interfaz de programación de aplicaciones Malla.")
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
=== Introducción ===

{{TOCright}}

==Introducción==

Para obtener acceso al módulo {{incode|Malla}} hay que importarlo primero:


{{Code|code=
En primer lugar tienes que importar el módulo Malla:
<syntaxhighlight>
import Mesh
import Mesh
}}
</syntaxhighlight>
Después de eso, ya tendrás acceso al módulo Malla y la clase Malla, que ofrecen las funciones del nucleo FreeCAD C++ Mesh-Kernel.


=== Creación y Carga ===
==Creación==


Para crear un objeto malla vacío sólo tienes que utilizar el constructor estándar:
Para crear un objeto de malla vacío basta con utilizar el constructor estándar:


{{Code|code=
<syntaxhighlight>
mesh = Mesh.Mesh()
mesh = Mesh.Mesh()
}}
</syntaxhighlight>


También puedes crear un objeto desde un archivo
También puede crear un objeto a partir de un archivo:


{{Code|code=
<syntaxhighlight>
mesh = Mesh.Mesh('D:/temp/Something.stl')
mesh = Mesh.Mesh("D:/temp/Something.stl")
}}
</syntaxhighlight>


O crearla a partir de un conjunto de triángulos descritos por sus puntos de esquina:
(Una lista de formatos de archivo compatibles se puede encontrar bajo 'Mallas' [[Feature_list/es#IO|aquí]].)


{{Code|code=
O también puedes crear la malla a partir de un conjunto de triángulos descrito por sus vértices:
triangles = [

<syntaxhighlight>
planarMesh = [
# triangle 1
# triangle 1
[-0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000],[-0.5000,0.5000,0.0000],
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
#triangle 2
[-0.5000,-0.5000,0.0000],[0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000],
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
]
planarMeshObject = Mesh.Mesh(planarMesh)
meshObject = Mesh.Mesh(triangles)
Mesh.show(planarMeshObject)
Mesh.show(meshObject)
}}
</syntaxhighlight>


El núcleo de mallas, Mesh-Kernel, se encarga de crear una estructura topológica de datos correcta, ordenando conjuntamente los puntos coincidentes y los bordes.
El Núcleo-Malla se encarga de crear una estructura de datos topológicamente correcta ordenando los puntos y aristas coincidentes.
{{Top}}
==Modelización==


Para crear geometrías regulares se puede utilizar uno de los métodos {{incode|create*()}}. Un toroide, por ejemplo, se puede crear de la siguiente manera:
Más adelante podrás ver cómo examinar y revisar los datos de la malla.


{{Code|code=
=== Modelado ===
m = Mesh.createTorus(8.0, 2.0, 50)
Mesh.show(m)
}}


Los dos primeros parámetros definen los radios del toroide y el tercer parámetro es un factor de submuestreo para saber cuántos triángulos se crean. Cuanto mayor sea este valor, más suave será la malla.
Para crear geometrías regulares puedes utilizar el script de Python BuildRegularGeoms.py.


El módulo {{incode|Malla}} también proporciona tres métodos booleanos: {{incode|union()}}, {{incode|intersection()}} y {{incode|difference()}}:
<syntaxhighlight>
import BuildRegularGeoms
</syntaxhighlight>


{{Code|code=
Esta secuencia de comandos proporciona métodos para definir cuerpos de revolución sencillos, como esferas, elipsoides, cilindros, toroides y conos. Y también tiene un método para crear un cubo simple.
Para crear un toroide, por ejemplo, se puede hacer de la siguiente manera:

<syntaxhighlight>
t = BuildRegularGeoms.Toroid(8.0, 2.0, 50) # list with several thousands triangles
m = Mesh.Mesh(t)
</syntaxhighlight>

Los dos primeros parámetros definen los radios del toroide y el tercer parámetro es un factor de submuestreo relacionado con el número de triángulos que se han de crear. Cuanto mayor sea este valor, más suave es la forma y mejor acabado tiene el cuerpo.

<syntaxhighlight>
m1, m2 # are the input mesh objects
m1, m2 # are the input mesh objects
m3 = Mesh.Mesh(m1) # create a copy of m1
m3 = Mesh.Mesh(m1) # create a copy of m1
Line 68: Line 63:
m6 = Mesh.Mesh(m2)
m6 = Mesh.Mesh(m2)
m6.difference(m1) # the difference of m2 and m1, usually the result is different to m5
m6.difference(m1) # the difference of m2 and m1, usually the result is different to m5
}}
</syntaxhighlight>


Este es un ejemplo que crea una tubería utilizando el método {{incode|difference()}}:
Por último, un ejemplo completo que calcula la intersección entre una esfera y un cilindro que corta a la esfera.


{{Code|code=
<syntaxhighlight>
import Mesh, BuildRegularGeoms
import FreeCAD, Mesh
sphere = Mesh.Mesh( BuildRegularGeoms.Sphere(5.0, 50) )
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylinder = Mesh.Mesh( BuildRegularGeoms.Cylinder(2.0, 10.0, True, 1.0, 50) )
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
diff = sphere
pipe = cylA
diff = diff.difference(cylinder)
pipe = pipe.difference(cylB)
d = FreeCAD.newDocument()
pipe.flipNormals() # somehow required
d.addObject("Mesh::Feature","Diff_Sphere_Cylinder").Mesh=diff
doc = FreeCAD.ActiveDocument
d.recompute()
obj = d.addObject("Mesh::Feature", "Pipe")
</syntaxhighlight>
obj.Mesh = pipe
doc.recompute()
}}
{{Top}}
==Notas==


Una fuente extensa, aunque difícil de usar, de scripts relacionados con la malla son los scripts de pruebas unitarias del módulo {{incode|Mesh}}.
=== Examining and Testing ===
En estas pruebas unitarias se llaman literalmente todos los métodos y se ajustan todas las propiedades/atributos.

Así que si eres lo suficientemente audaz, echa un vistazo al módulo [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Mesh/App/MeshTestsApp.py Unit Test].
=== Write your own Algorithms ===

=== Exporting ===
You can even write the mesh to a python module:

<syntaxhighlight>
m.write("D:/Develop/Projekte/FreeCAD/FreeCAD_0.7/Mod/Mesh/SavedMesh.py")
import SavedMesh
m2 = Mesh.Mesh(SavedMesh.faces)
</syntaxhighlight>

=== Gui related stuff ===

=== Odds and Ends ===
An extensive (though hard to use) source of Mesh related scripting are the unit test scripts of the Mesh-Module.
In this unit tests literally all methods are called and all properties/attributes are tweaked.
So if you are bold enough, take a look at the [http://free-cad.svn.sourceforge.net/viewvc/free-cad/trunk/src/Mod/Mesh/App/MeshTestsApp.py?view=markup Unit Test module].

{{docnav|FreeCAD Scripting Basics|Topological data scripting}}

[[Category:Poweruser Documentation]]
[[Category:Python Code]]


Ver también: [[Mesh_API|Interfaz de programación de aplicaciones Malla]].
{{Top}}
{{Powerdocnavi{{#translation:}}}}
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
{{Mesh Tools navi{{#translation:}}}}
{{clear}}
{{clear}}
<languages/>

Latest revision as of 13:32, 19 September 2021

Introducción

Para obtener acceso al módulo Malla hay que importarlo primero:

import Mesh

Creación

Para crear un objeto de malla vacío basta con utilizar el constructor estándar:

mesh = Mesh.Mesh()

También puede crear un objeto a partir de un archivo:

mesh = Mesh.Mesh("D:/temp/Something.stl")

O crearla a partir de un conjunto de triángulos descritos por sus puntos de esquina:

triangles = [
# triangle 1
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
meshObject = Mesh.Mesh(triangles)
Mesh.show(meshObject)

El Núcleo-Malla se encarga de crear una estructura de datos topológicamente correcta ordenando los puntos y aristas coincidentes.

Inicio

Modelización

Para crear geometrías regulares se puede utilizar uno de los métodos create*(). Un toroide, por ejemplo, se puede crear de la siguiente manera:

m = Mesh.createTorus(8.0, 2.0, 50)
Mesh.show(m)

Los dos primeros parámetros definen los radios del toroide y el tercer parámetro es un factor de submuestreo para saber cuántos triángulos se crean. Cuanto mayor sea este valor, más suave será la malla.

El módulo Malla también proporciona tres métodos booleanos: union(), intersection() y difference():

m1, m2              # are the input mesh objects
m3 = Mesh.Mesh(m1)  # create a copy of m1
m3.unite(m2)        # union of m1 and m2, the result is stored in m3
m4 = Mesh.Mesh(m1)
m4.intersect(m2)    # intersection of m1 and m2
m5 = Mesh.Mesh(m1)
m5.difference(m2)   # the difference of m1 and m2
m6 = Mesh.Mesh(m2)
m6.difference(m1)   # the difference of m2 and m1, usually the result is different to m5

Este es un ejemplo que crea una tubería utilizando el método difference():

import FreeCAD, Mesh
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
pipe = cylA
pipe = pipe.difference(cylB)
pipe.flipNormals() # somehow required
doc = FreeCAD.ActiveDocument
obj = d.addObject("Mesh::Feature", "Pipe")
obj.Mesh = pipe
doc.recompute()

Inicio

Notas

Una fuente extensa, aunque difícil de usar, de scripts relacionados con la malla son los scripts de pruebas unitarias del módulo Mesh. En estas pruebas unitarias se llaman literalmente todos los métodos y se ajustan todas las propiedades/atributos. Así que si eres lo suficientemente audaz, echa un vistazo al módulo Unit Test.

Ver también: Interfaz de programación de aplicaciones Malla.

Inicio