scallop dome pyformex logo

Previous topic

16. fileread — Read geometry from file in a whole number of formats.

Next topic

18. widgets — A collection of custom widgets used in the pyFormex GUI

[FSF Associate Member]

Valid XHTML 1.0 Transitional

17. filewrite — Write geometry to file in a whole number of formats.

This module defines bothe the basic routines to write geometrical data to a file and the specialized exporters to write files in a number of well known standardized formats.

The basic routines are very versatile as well as optimized (using the version in the pyFormex C-library) and allow to easily create new exporters for other formats.

Classes defined in module filewrite

Functions defined in module filewrite

filewrite.writeData(data, fil, fmt=' ')

Write an array of numerical data to an open file.

Parameters:

  • data: a numerical array of int or float type
  • fil: an open file object
  • fmt: a format string defining how a single data item is written. It should be one of:
    • ‘’: an empty string: in this case the data are written in binary mode, using the function numpy.tofile.
    • ‘ ‘: a single space: in this case the data are written in text mode, separated by a space, also using the function numpy.tofile. At the end, a newline is added. All the data of the array thus appear on a single line.
    • a format string compatible with the array data type. In this case float arrays will be forced to float32 and int arrays to int32. The format string should contain a valid format converter for a a single data item in both Python and C. They should also contain the necessary spacing or separator. Examples are ‘%5i ‘ for int data and ‘%f,’ or ‘%10.3e’ for float data. The array will be converted to a 2D array, keeping the lengt of the last axis. The all elements will be written row by row using the specified format string, and a newline character will be written after each row. This mode is written by pyFormex function misc.tofile_int32 or misc.tofile_float32, which have accelerated versions in the pyFormex C library.
filewrite.writeIData(data, fil, fmt, ind=1)

Write an indexed array of numerical data to an open file.

ind = i: autoindex from i
array: use these indices
filewrite.writeOFF(fn, coords, elems)

Write a mesh of polygons to a file in OFF format.

Parameters:

  • fn: file name, by preference ending on ‘.off’
  • coords: float array with shape (ncoords,3), with the coordinates of ncoords vertices.
  • elems: int array with shape (nelems,nplex), with the definition of nelems polygon elements.
filewrite.writeGTS(fn, coords, edges, faces)

Write a mesh of triangles to a file in GTS format.

Parameters:

  • fn: file name, by preference ending on ‘.gts’
  • coords: float array with shape (ncoords,3), with the coordinates of ncoords vertices.
  • edges: int array with shape (nedges,2), with the definition of nedges edges in function of the vertex indices.
  • faces: int array with shape (nfaces,3), with the definition of nfaces triangles in function of the edge indices.