FemProcess
The GeMA Fem Process Plugin
Loading...
Searching...
No Matches
Print options

The printOptions table is an optional field of the solver options table that is supplied as a parameter to the FEM process functions. It can instruct the solver to print all of its internal matrices and is useful when debugging new physics implementations or to fully understand a FEM process behavior. The supported flags are:

Attribute Description Type Required Def. Value
elementMatrices When set to true, all element local matrices will be printed. Boolean No false
elementVectors When set to true, all element local vectors will be printed. Boolean No false
elementDofMapping When set to true, the element DOF mapping between local and global matrix columns will be printed. Boolean No false
assembledMatrix When set to true, the global equivalent matrix created by the assembler from local matrices will be printed. If the assembler does not automatically merges global matrices into an equivalent matrix, the K matrix will be printed. Boolean No false
assembledVector When set to true, the global equivalent vector created by the assembler from local vectors will be printed. If the assembler does not automatically merges global vectors into an equivalent vector, the Fe vector will be printed. Boolean No false
globalMatrices When set to true, all global matrices, each corresponding to one of the local element matrices, will be printed. If the assembler automatically merges global matrices into an equivalent one (the default setting), a set of additional global matrices will be created for printing purposes only. Boolean No false
globalVectors When set to true, all global vectors, each corresponding to one of the local element vectors, will be printed. If the assembler automatically merges global vectors into an equivalent one (the default setting), a set of additional global vectors will be created for printing purposes only. Boolean No false
linearSystemMatrix When set to true, the final equivalent matrix \(K\) for the linear system \(Kx = f\) will be printed, whenever the system is solved. This is the matrix used to solve the system and already treats fixed dofs. See the filter options below to reduce the number of printed matrices. Boolean No false
linearSystemVector When set to true, the final equivalent vector \(f\) for the linear system \(Kx = f\) will be printed, whenever the system is solved. This is the vector used to solve the system and already treats fixed dofs. See the filter options below to reduce the number of printed vectors. Boolean No false
linearSystemResult When set to true, the global degrees of freedom vector ( \(x\)) will be printed after the \(Kx = f\) linear system has been solved. See the filter options below to reduce the number of printed vectors. Boolean No false
saveLinearSystemMatrix When set to true, the final equivalent matrix \(K\) for the linear system \(Kx = f\) will be saved to a file, whenever the system is solved. This is the matrix used to solve the system and already treats fixed dofs. The saved file will be in the standard "Matrix Market" format. See the saveLinearSystemBaseName option below for the file naming convention. See the filter options below to reduce the number of saved matrices. Boolean No false
saveLinearSystemVector When set to true, the final equivalent vector \(f\) for the linear system \(Kx = f\) will be saved to a file, whenever the system is solved. This is the vector used to solve the system and already treats fixed dofs. The saved file will be in the standard "Matrix Market" format. If the matrix was also saved, they will be saved to the same file in "Extended Matrix Market" format. See the saveLinearSystemBaseName option below for the file naming convention. See the filter options below to reduce the number of saved vectors. Boolean No false
saveLinearSystemResult When set to true, the global degrees of freedom vector ( \(x\)) will be saved to a file after the \(Kx = f\) linear system has been solved. The saved file will be in the standard "Matrix Market" format. See the saveLinearSystemBaseName option below for the file naming convention. See the filter options below to reduce the number of saved vectors. Boolean No false
saveLinearSystemBaseName The base name for the files saved when one of the save linear system flags is set to true. Can include path macros. The final name of the saved file will be given by baseName_index[_filter_val][_result].mtx, where baseName is this attribute value and index is a value that is incremeneted each time a linear system is saved, ensuring that the file name is unique. If there is an active filter to select which linear systems will be saved, _filter will be the name of the attribute used for filtering and _val its value. When saving the linear system result, the _result suffix will be added. Notice that whenever selected, the system matrix and vector will be saved to the same file, while the result will be placed on a different one. String No '$SIMULATIONDIR/linSystemLog'
linearSystemFilter When not empty, defines the name of the results atribute that will be used for defining which linear systems should be printed and/or saved. Whenever the linear system is solved, the value of this attribute is checked to see if it belongs to the set of values in linearSystemFilterValues. If it does, the print/save operation proceeds. Otherwise, it is canceled. String No ''
linearSystemFilterValues The set of attribute values defining when the linear system should be printed/saved if a linear system filter is active. Table No {}
format This field controls how values will be formatted when printed. It uses a subset of the C printf() syntax, allowing the user to specify the field width, precision and format type. A format = "8.2f" statement means that the formatted value will have at least 8 characters and 2 decimal values. Allowed format specifiers are 'f' (for decimal floating point format), 'e' (for scientific notation format) and 'g' (corresponding to 'f' or 'e', whichever is shortest). String No '7.2f'