![]() |
IoProcess
The GeMA I/O Process Plugin
|
io.print(msg) | ||
---|---|---|
Description: | Prints the given message to both the console and to the log file using the standard plugin logger plugin.IoProcess.info . This function is rarelly needed. Calling the standard print() function is more practical since it can receive multiple parameters and has almost the same effect (the difference is the logger used to write the resulting message (gema.simRunner.info ). To write a messge with a different log level (warning, for example), use the logMsg(level, msg) function. | |
Parameters: | msg - The message to be printed. | |
Returns: | Nothing. |
Example:
io.printMesh(mesh, evalFunctions) | ||
---|---|---|
Description: | Prints mesh data values to both the console and to the log file using the standard plugin logger plugin.IoProcess.info . For node meshes, node coordinates, node attribute and state variable values are printed. For cell meshes, besides printing node data, it also prints cell information (type, nodes, property set associations and cell attribute values), cell group information and boundary data. Element meshes will also print Gauss point attribute values. Calling this function is roughly equivalent to calling in sequence printMeshNodeData() , printMeshCellData() and printMeshGaussData() , without the flexibility of configuring the printed data and output format given by those functions, also adding cell group and boundary data information. | |
Parameters: | mesh | The mesh to be printed. Accepts either a mesh name or a mesh object. |
evalFunctions | When set to false (the default), if a value is a function, the function name will be printed. If set to true, the function will be evaluated and its result printed. In that case, functions associated with cell attributes and properties will be evaluated at the cell centroid. | |
Returns: | Nothing. |
Examples:
io.printMeshInfo(mesh) | ||
---|---|---|
Description: | Prints mesh meta-data information to both the console and to the log file using the standard plugin logger plugin.IoProcess.info . Printed information is the same as the information printed for the mesh after model loading and includes, among others, the number of nodes, number of cells, associated state variables, node, cell and Gauss attributes. | |
Parameters: | mesh - The mesh. Accepts either a mesh name or a mesh object. | |
Returns: | Nothing. |
Examples:
io.printMeshNodeData(mesh, columns, options, width) | ||
---|---|---|
Description: | Prints mesh node data values in a table format to both the console and to the log file, using the standard plugin logger plugin.IoProcess.info . The printed data can be configured through the columns parameter, while the options parameter controls several aspects of the resulting table. The unit in which each column will be printed can also be controled by columns , with automatic conversions when needed. | |
Parameters: | mesh | The mesh. Accepts either a mesh name or a mesh object. |
columns | A string or a table with node attributes / state variable names. If empty, all data will be printed. The string "coordinate" can be included in the table to request that node coordinates should also be printed. Optionally, value names can have a suffix surrounded by () with the desired unit (ex: "T(K)" would ask for a temperature value named T, with values converted, if needed, to Kelvin degrees). | |
options | An optional table with a set of print options. When filling this table, keep in mind that only options different from the default are needed. When an option is not present in the table its default value will be used. | |
width | An optional table with column widths. If present, entry i will define the column width (in characters), for the attribute at entry i in the columns table. A missing value or a zero width means that the function should calculate the desired width. | |
Returns: | Nothing. |
Examples:
io.printMeshCellData(mesh, columns, options, ip, width) | ||
---|---|---|
Description: | Prints mesh cell data values in a table format to both the console and to the log file, using the standard plugin logger plugin.IoProcess.info . The printed data can be configured through the columns parameter, while the options parameter controls several aspects of the resulting table. The unit in which each column will be printed can also be controled by columns , with automatic conversions when needed. | |
Parameters: | mesh | The mesh. Accepts either a mesh name or a mesh object. The given mesh should be a cell mesh or an element mesh. |
columns | A string or a table with cell attributes / property names. If empty, all data will be printed. The strings "type" , "nodes" , "active" , "properties" and "points" can be included in the table to request that, respectiveley, cell types, cell nodes, active flag, cell property names and cell function evaluation points should also be printed. If present, those should be the first entries of the table. Optionally, value names can have a suffix surrounded by () with the desired unit (ex: "rho(g/cm3)" would ask for a density value named rho, with values converted, if needed, to g/cm3). | |
options | An optional table with a set of print options. When filling this table, keep in mind that only options different from the default are needed. When an option is not present in the table its default value will be used. | |
ip | An optional parameter with the desired integration point index used when evaluating functions. When missing or 0, the centroid will be used. Ignored for cell meshes. | |
width | An optional table with column widths. If present, entry i will define the column width (in characters), for the attribute at entry i in the columns table (skiping special columns like those given by "type" , "nodes" , "active" , "properties" and "points" which currently can't have their sizes specified). A missing value or a zero width means that the function should calculate the desired width. | |
Returns: | Nothing. |
Examples:
io.printMeshGaussData(mesh, columns, options, width) | ||
---|---|---|
Description: | Prints mesh Gauss points data values in a table format to both the console and to the log file, using the standard plugin logger plugin.IoProcess.info . The printed data can be configured through the columns parameter, while the options parameter controls several aspects of the resulting table. The unit in which each column will be printed can also be controled by columns , with automatic conversions when needed. | |
Parameters: | mesh | The mesh. Accepts either a mesh name or a mesh object. The given mesh should be an element mesh. |
columns | A string or a table with Gauss attribute names. If empty, all data will be printed. The strings "type" , "points" and "active" can be included in the table to request that, respectiveley, cell types, cell Gauss points and the active flag should also be printed. If present, those should be the first entries of the table. Optionally, value names can have a suffix surrounded by () with the desired unit (ex: "S(psi)" would ask for a stress value named S, with values converted, if needed, to pounds per square inch). | |
options | An optional table with a set of print options. When filling this table, keep in mind that only options different from the default are needed. When an option is not present in the table its default value will be used. | |
width | An optional table with column widths. If present, entry i will define the column width (in characters), for the attribute at entry i in the columns table (skiping special columns like those given by "type" , "points" and "active" which currently can't have their sizes specified). A missing value or a zero width means that the function should calculate the desired width. | |
Returns: | Nothing. |
Examples:
io.printMeshMemoryInfo(mesh) | ||
---|---|---|
Description: | Prints a summary of the approximate mesh memory usage, both to the console and to the log file, using the standard plugin logger plugin.IoProcess.info . Printed information includes the memory used to store the mesh data (nodes + geometry + borders + node sets), data sets attached to nodes, cells and Gauss points and boundary conditions attached to the mesh. | |
Parameters: | mesh - The mesh. Accepts either a mesh name or a mesh object. | |
Returns: | Nothing. |
Examples:
io.printMeshTopology(mesh) | ||
---|---|---|
Description: | Prints a detailed information about the topological structure used to execute topological queries. If no topological structure was built by the mesh, prints nothing. | |
Parameters: | mesh - The mesh. Accepts either a mesh name or a mesh object. | |
Returns: | Nothing. |
Examples: