artisynth.core.femmodels

Class NodeNumberReader

java.lang.Object

artisynth.core.femmodels.NodeNumberReader

public class NodeNumberReader
extends java.lang.Object

Reads a set of FEM nodes from a file containing their node numbers. The file is a simple text file containing integers (the node numbers), separated by white space. There is no limit to how many numbers can appear on a line but typically this is limited to ten or so to make the file more readable. Optionally, the numbers can be surrounded by square brackets ([ ]) The special character `#' is a comment character, commenting out all characters from itself to the end of the current line. For a file) containing the node numbers 2, 12, 4, 8, 23 and 47, the following formats are all valid:

 2 12 4 8 23 47
 

 [ 2 12 4 8 23 47 ]
 

 # this is a node number file
 [ 2 12 4 8 
   23 47
 ]
 

Constructor Summary

Constructors

Constructor and Description
NodeNumberReader(java.io.File file)
NodeNumberReader(java.io.Reader reader)
NodeNumberReader(ReaderTokenizer rtok)
NodeNumberReader(java.lang.String fileName)

Method Summary

Modifier and Type	Method and Description
void	close()
void	finalize()
boolean	getWarningsEnabled()
boolean	nodesWereBracketed() Queries whether the most recently read node numbers were enclosed in brackets.
java.util.ArrayList<FemNode3d>	read(FemModel3d fem) Reads a set of nodes for a FEM model, based on the node numbers in the input stream.
static java.util.ArrayList<FemNode3d>	read(java.io.File file, FemModel3d fem) Reads node numbers from a file and uses them to locate nodes within a specified FEM model.
static java.util.ArrayList<FemNode3d>	read(java.lang.String filePath, FemModel3d fem) Reads node numbers from a file and uses them to locate nodes within a specified FEM model.
void	setWarningsEnabled(boolean enable)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NodeNumberReader

public NodeNumberReader(ReaderTokenizer rtok)

NodeNumberReader

public NodeNumberReader(java.io.Reader reader)

NodeNumberReader

public NodeNumberReader(java.io.File file)
                 throws java.io.IOException

Throws:

java.io.IOException

NodeNumberReader

public NodeNumberReader(java.lang.String fileName)
                 throws java.io.IOException

Throws:

java.io.IOException

Method Detail

nodesWereBracketed

public boolean nodesWereBracketed()

Queries whether the most recently read node numbers were enclosed in brackets.

Returns:

true if last nodes read were bracketed.

getWarningsEnabled

public boolean getWarningsEnabled()

setWarningsEnabled

public void setWarningsEnabled(boolean enable)

read

public java.util.ArrayList<FemNode3d> read(FemModel3d fem)
                                    throws java.io.IOException

Reads a set of nodes for a FEM model, based on the node numbers in the input stream. The format is described in the class documentation.

Parameters:

fem - FEM model containing the nodes

Returns:

a list of the nodes

Throws:

java.io.IOException - if an I/O error occurred

close

public void close()

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

read

public static java.util.ArrayList<FemNode3d> read(java.io.File file,
                                                  FemModel3d fem)
                                           throws java.io.IOException

Reads node numbers from a file and uses them to locate nodes within a specified FEM model. The format is described in the class documentation. If warnings are enabled, numbers which do not correspond to nodes with the model are ignored and cause a warning message to be printed.

Parameters:

file - file to read the node numbers from

fem - FEM model containing the nodes

Returns:

a list of the identified nodes

Throws:

java.io.IOException - if an I/O error occurred

read

public static java.util.ArrayList<FemNode3d> read(java.lang.String filePath,
                                                  FemModel3d fem)
                                           throws java.io.IOException

Reads node numbers from a file and uses them to locate nodes within a specified FEM model. The format is described in the class documentation. If warnings are enabled, numbers which do not correspond to nodes with the model are ignored and cause a warning message to be printed.

Parameters:

filePath - path name of the file to read the node numbers from

fem - FEM model containing the nodes

Returns:

a list of the identified nodes

Throws:

java.io.IOException - if an I/O error occurred