yade.ymport module¶
Import geometry from various formats (‘import’ is python keyword, hence the name ‘ymport’).
-
yade.ymport.
blockMeshDict
(path, patchasWall=True, emptyasWall=True, **kw)[source]¶ Load openfoam’s blockMeshDict file’s “boundary” section as facets.
Parameters: - path (str) – file name. Typical value is: “system/blockMeshDict”.
- patchasWall (bool) – load “patch”-es as walls.
- emptyasWall (bool) – load “empty”-es as walls.
- **kw – (unused keyword arguments) is passed to utils.facet
Returns: list of facets.
-
yade.ymport.
ele
(nodeFileName, eleFileName, shift=(0, 0, 0), scale=1.0, **kw)[source]¶ Import tetrahedral mesh from .ele file, return list of created tetrahedrons.
Parameters: - nodeFileName (string) – name of .node file
- eleFileName (string) – name of .ele file
- shift ((float,float,float)|Vector3) – (X,Y,Z) parameter moves the specimen.
- scale (float) – factor scales the given data.
- **kw – (unused keyword arguments) is passed to utils.polyhedron
-
yade.ymport.
gengeo
(mntable, shift=Vector3(0, 0, 0), scale=1.0, **kw)[source]¶ Imports geometry from LSMGenGeo library and creates spheres. Since 2012 the package is available in Debian/Ubuntu and known as python-demgengeo http://packages.qa.debian.org/p/python-demgengeo.html
Parameters: - mntable: mntable
object, which creates by LSMGenGeo library, see example
- shift: [float,float,float]
[X,Y,Z] parameter moves the specimen.
- scale: float
factor scales the given data.
- **kw: (unused keyword arguments)
is passed to utils.sphere
LSMGenGeo library allows one to create pack of spheres with given [Rmin:Rmax] with null stress inside the specimen. Can be useful for Mining Rock simulation.
Example: examples/packs/packs.py, usage of LSMGenGeo library in examples/test/genCylLSM.py.
-
yade.ymport.
gengeoFile
(fileName='file.geo', shift=Vector3(0, 0, 0), scale=1.0, orientation=Quaternion((1, 0, 0), 0), **kw)[source]¶ Imports geometry from LSMGenGeo .geo file and creates spheres. Since 2012 the package is available in Debian/Ubuntu and known as python-demgengeo http://packages.qa.debian.org/p/python-demgengeo.html
Parameters: - filename: string
file which has 4 colums [x, y, z, radius].
- shift: Vector3
Vector3(X,Y,Z) parameter moves the specimen.
- scale: float
factor scales the given data.
- orientation: quaternion
orientation of the imported geometry
- **kw: (unused keyword arguments)
is passed to utils.sphere
Returns: list of spheres.
LSMGenGeo library allows one to create pack of spheres with given [Rmin:Rmax] with null stress inside the specimen. Can be useful for Mining Rock simulation.
Example: examples/packs/packs.py, usage of LSMGenGeo library in examples/test/genCylLSM.py.
-
yade.ymport.
gmsh
(meshfile='file.mesh', shift=Vector3(0, 0, 0), scale=1.0, orientation=Quaternion((1, 0, 0), 0), **kw)[source]¶ Imports geometry from .mesh file and creates facets.
Parameters: - shift: [float,float,float]
[X,Y,Z] parameter moves the specimen.
- scale: float
factor scales the given data.
- orientation: quaternion
orientation of the imported mesh
- **kw: (unused keyword arguments)
is passed to utils.facet
Returns: list of facets forming the specimen.
mesh files can easily be created with GMSH. Example added to examples/packs/packs.py
Additional examples of mesh-files can be downloaded from http://www-roc.inria.fr/gamma/download/download.php
-
yade.ymport.
gts
(meshfile, shift=Vector3(0, 0, 0), scale=1.0, **kw)[source]¶ Read given meshfile in gts format.
Parameters: - meshfile: string
name of the input file.
- shift: [float,float,float]
[X,Y,Z] parameter moves the specimen.
- scale: float
factor scales the given data.
- **kw: (unused keyword arguments)
is passed to utils.facet
Returns: list of facets.
-
yade.ymport.
iges
(fileName, shift=(0, 0, 0), scale=1.0, returnConnectivityTable=False, **kw)[source]¶ Import triangular mesh from .igs file, return list of created facets.
Parameters: - fileName (string) – name of iges file
- shift ((float,float,float)|Vector3) – (X,Y,Z) parameter moves the specimen.
- scale (float) – factor scales the given data.
- **kw – (unused keyword arguments) is passed to utils.facet
- returnConnectivityTable (bool) – if True, apart from facets returns also nodes (list of (x,y,z) nodes coordinates) and elements (list of (id1,id2,id3) element nodes ids). If False (default), returns only facets
-
yade.ymport.
polyMesh
(path, patchasWall=True, emptyasWall=True, **kw)[source]¶ Load openfoam’s polyMesh directory as facets.
Parameters: - path (str) – directory path. Typical value is: “constant/polyMesh”.
- patchAsWall (bool) – load “patch”-es as walls.
- emptyAsWall (bool) – load “empty”-es as walls.
- **kw – (unused keyword arguments) is passed to utils.facet
Returns: list of facets.
-
yade.ymport.
stl
(file, dynamic=None, fixed=True, wire=True, color=None, highlight=False, noBound=False, material=-1, scale=1.0, shift=Vector3(0, 0, 0))[source]¶ Import a .stl geometry in the form of a set of Facet-shaped bodies.
Parameters: - file (string) – the .stl file serving as geometry input
- dynamic (bool) – controls Body.dynamic
- fixed (bool) – controls Body.dynamic (with fixed = True imposing Body.dynamic = False) if dynamic attribute is not given
- wire (bool) – rendering option, passed to Facet.wire
- color – rendering option, passed to Facet.color
- highlight (bool) – rendering option, passed to Facet.highlight
- noBound (bool) – sets Body.bounded to False if True, preventing collision detection (and vice-versa)
- material – defines material properties, see Defining materials for usage
- scale (float) – scaling factor to e.g. dilate the geometry if > 1
- shift (Vector3) – for translating the geometry
Returns: a corresponding list of Facet-shaped bodies
-
yade.ymport.
text
(fileName, shift=Vector3(0, 0, 0), scale=1.0, **kw)[source]¶ Load sphere coordinates from file, returns a list of corresponding bodies; that may be inserted to the simulation with O.bodies.append().
Parameters: - filename (string) – file which has 4 colums [x, y, z, radius].
- shift ([float,float,float]) – [X,Y,Z] parameter moves the specimen.
- scale (float) – factor scales the given data.
- **kw – (unused keyword arguments) is passed to utils.sphere
Returns: list of spheres.
Lines starting with # are skipped
-
yade.ymport.
textClumps
(fileName, shift=Vector3(0, 0, 0), discretization=0, orientation=Quaternion((1, 0, 0), 0), scale=1.0, **kw)[source]¶ Load clumps-members from file in a format selected by the
format
argument, insert them to the simulation.Parameters: - filename (str) – file name
- format (str) – selected input format. Supported
'x_y_z_r'``(default), ``'x_y_z_r_clumpId'
- shift ([float,float,float]) – [X,Y,Z] parameter moves the specimen.
- scale (float) – factor scales the given data.
- **kw – (unused keyword arguments) is passed to utils.sphere
Returns: list of spheres.
Lines starting with # are skipped
-
yade.ymport.
textExt
(fileName, format='x_y_z_r', shift=Vector3(0, 0, 0), scale=1.0, attrs=[], **kw)[source]¶ Load sphere coordinates from file in a format selected by the
format
argument, returns a list of corresponding bodies; that may be inserted to the simulation with O.bodies.append().Parameters: - filename (str) – file name
- format (str) – selected input format. Supported
'x_y_z_r'``(default), ``'x_y_z_r_matId'
,'x_y_z_r_attrs'
- shift ([float,float,float]) – [X,Y,Z] parameter moves the specimen.
- scale (float) – factor scales the given data.
- attrs (list) – attrs read from file if export.textExt(format=’x_y_z_r_attrs’) were used (‘passed by reference’ style)
- **kw – (unused keyword arguments) is passed to utils.sphere
Returns: list of spheres.
Lines starting with # are skipped
-
yade.ymport.
textFacets
(fileName, format='x1_y1_z1_x2_y2_z2_x3_y3_z3', shift=Vector3(0, 0, 0), scale=1.0, attrs=[], **kw)[source]¶ Load facet coordinates from file in a format selected by the
format
argument, returns a list of corresponding bodies; that may be inserted to the simulation with O.bodies.append().Parameters: - filename (str) – file name
- format (str) – selected input format. Supported
'x1_y1_z1_x2_y2_z2_x3_y3_z3'``(default), ``'x1_y1_z1_x2_y2_z2_x3_y3_z3_matId'
,'id_x1_y1_z1_x2_y2_z2_x3_y3_z3_matId'
or'x1_y1_z1_x2_y2_z2_x3_y3_z3_attrs'
- shift ([float,float,float]) – [X,Y,Z] parameter moves the specimen.
- scale (float) – factor scales the given data.
- attrs (list) – attrs read from file (‘passed by reference’ style)
- **kw – (unused keyword arguments) is passed to utils.facet
Returns: list of facets.
Lines starting with # are skipped
-
yade.ymport.
textPolyhedra
(fileName, material, shift=Vector3(0, 0, 0), scale=1.0, orientation=Quaternion((1, 0, 0), 0), **kw)[source]¶ Load polyhedra from a text file.
Parameters: - filename (str) – file name. Expected file format is the one output by export.textPolyhedra.
- shift ([float,float,float]) – [X,Y,Z] parameter moves the specimen.
- scale (float) – factor scales the given data.
- orientation (quaternion) – orientation of the imported polyhedra
- **kw – (unused keyword arguments) is passed to polyhedra_utils.polyhedra
Returns: list of polyhedras.
Lines starting with # are skipped
-
yade.ymport.
unv
(fileName, shift=(0, 0, 0), scale=1.0, returnConnectivityTable=False, **kw)[source]¶ Import geometry from unv file, return list of created facets.
param string fileName: name of unv file param (float,float,float)|Vector3 shift: (X,Y,Z) parameter moves the specimen. param float scale: factor scales the given data. param **kw: (unused keyword arguments) is passed to utils.facet param bool returnConnectivityTable: if True, apart from facets returns also nodes (list of (x,y,z) nodes coordinates) and elements (list of (id1,id2,id3) element nodes ids). If False (default), returns only facets unv files are mainly used for FEM analyses (are used by OOFEM and Abaqus), but triangular elements can be imported as facets. These files cen be created e.g. with open-source free software Salome.
Example: examples/test/unv-read/unvRead.py.