A surface writer for the Nastran file format - both surface mesh and fields. More...

#include <nastranSurfaceWriter.H>

Inheritance diagram for nastranWriter:

Collaboration diagram for nastranWriter:

Public Types
using	fieldFormat = Foam::fileFormats::NASCore::fieldFormat
	File field formats.
using	loadFormat = Foam::fileFormats::NASCore::loadFormat
	Output load format.

Public Member Functions
	TypeNameNoDebug ("nastran")
	Declare type-name, virtual type (with debug switch).
	nastranWriter ()
	Default construct. Default FREE format.
	nastranWriter (const dictionary &options)
	Construct with some output options. Default FREE format.
	nastranWriter (const meshedSurf &surf, const fileName &outputPath, bool parallel=UPstream::parRun(), const dictionary &options=dictionary())
	Construct from components.
	nastranWriter (const pointField &points, const faceList &faces, const fileName &outputPath, bool parallel=UPstream::parRun(), const dictionary &options=dictionary())
	Construct from components.
virtual	~nastranWriter ()=default
	Destructor.
virtual bool	usesFaceIds () const
	Format uses faceIds as part of its output.
virtual fileName	write ()
	Write surface geometry to file.
	declareSurfaceWriterWriteMethod (label)
	declareSurfaceWriterWriteMethod (scalar)
	declareSurfaceWriterWriteMethod (vector)
	declareSurfaceWriterWriteMethod (sphericalTensor)
	declareSurfaceWriterWriteMethod (symmTensor)
	declareSurfaceWriterWriteMethod (tensor)
template<class Type>
Foam::Ostream &	writeValue (Ostream &os, const Type &value) const
template<class Type>
Foam::Ostream &	writeFaceValue (Ostream &os, const loadFormat format, const Type &value, const label elemId) const
Public Member Functions inherited from surfaceWriter
	TypeName ("surfaceWriter")
	Runtime type information.
	declareRunTimeSelectionTable (autoPtr, surfaceWriter, word,(),())
	declareRunTimeSelectionTable (autoPtr, surfaceWriter, wordDict,(const dictionary &writeOpts),(writeOpts))
	surfaceWriter ()
	Default construct.
	surfaceWriter (const dictionary &options)
	Default construct with specified options.
virtual	~surfaceWriter ()
	Destructor. Calls close().
virtual bool	enabled () const
	The writer is enabled. If the writer is not enabled, it may be possible for the caller to skip various preparatory operations.
virtual bool	separateGeometry () const
	True if the surface format requires geometry in a separate file.
virtual bool	needsUpdate () const
	Does the writer need an update (eg, lagging behind surface changes).
virtual bool	wroteData () const
	Geometry or fields written since the last open?
virtual bool	expire ()
	Mark that surface changed and the writer will need an update, and set nFields = 0.
virtual void	clear ()
	Close any open output, remove association with a surface and expire the writer. The parallel flag remains untouched.
virtual void	setSurface (const meshedSurf &surf, bool parallel)
	Change association with a surface, expire the writer with defined parallel/serial treatment.
virtual void	setSurface (const pointField &points, const faceList &faces, bool parallel)
	Change association with a surface, expire the writer with defined parallel/serial treatment.
virtual void	setSurface (const meshedSurf &surf)
	Change association with a surface, expire the writer with the current parallel/serial treatment.
virtual void	setSurface (const pointField &points, const faceList &faces)
	Change association with a surface, expire the writer with the current parallel/serial treatment.
bool	is_open () const noexcept
	Test if outputPath has been set.
bool	hasSurface () const
	Writer is associated with a surface.
bool	empty () const
	The surface to write is empty if the global number of faces is zero.
label	size () const
	The global number of faces for the associated surface.
label	nFields () const noexcept
	The number of expected output fields.
label	nFields (const label n) noexcept
	Set the number of expected output fields.
bool	isPointData () const noexcept
	Are the field data to be treated as point data?
bool	isPointData (const bool on) noexcept
	Set handling of field data to face/point data.
bool	useTimeDir () const noexcept
	Should a time directory be spliced into the output path?
bool	useTimeDir (const bool on) noexcept
	Enable/disable use of spliced output path.
bool	verbose () const noexcept
	Get output verbosity.
bool	verbose (const bool on) noexcept
	Enable/disable verbose output.
scalar	mergeDim () const noexcept
	The current value of the point merge dimension (metre).
scalar	mergeDim (const scalar dist) noexcept
	Change the point merge dimension (metre).
scalar	scale () const noexcept
	The current value of the geometry scaling.
scalar	scale (const scalar factor) noexcept
	Change the geometry scaling.
const coordSystem::cartesian &	transform () const noexcept
	The current (cartesian) coordinate system transformation.
bool	hasTime () const
	True if there is a known time.
const word &	timeName () const
	The current time value/name.
scalar	timeValue () const
	The current time value/name.
void	setTime (const instant &inst)
	Set the current time.
void	setTime (scalar timeValue)
	Set current time from timeValue, auto generating the name.
void	setTime (scalar timeValue, const word &timeName)
	Set current time from timeValue and timeName.
void	unsetTime ()
	Clear the current time.
virtual void	beginTime (const Time &t)
	Begin a time-step.
virtual void	beginTime (const instant &inst)
	Begin a time-step.
virtual void	endTime ()
	End a time-step.
virtual void	open (const fileName &outputPath)
	Open for output on specified path, using existing surface.
virtual void	open (const pointField &points, const faceList &faces, const fileName &outputPath, bool parallel)
	Open from components.
virtual void	open (const meshedSurf &surf, const fileName &outputPath, bool parallel)
	Open from components.
virtual void	open (const pointField &points, const faceList &faces, const fileName &outputPath)
	Open from components, with the current parallel/serial treatment.
virtual void	open (const meshedSurf &surf, const fileName &outputPath)
	Open from components, with the current parallel/serial treatment.
virtual void	close ()
	Finish output, performing any necessary cleanup.
virtual fileName	write (const word &fieldName, const Field< label > &values)=0
	Write field of label (per face or vertex).
virtual fileName	write (const word &fieldName, const Field< scalar > &values)=0
	Write field of scalar (per face or vertex).
virtual fileName	write (const word &fieldName, const Field< vector > &values)=0
	Write field of vector (per face or vertex).
virtual fileName	write (const word &fieldName, const Field< sphericalTensor > &values)=0
	Write field of sphericalTensor (per face or vertex).
virtual fileName	write (const word &fieldName, const Field< symmTensor > &values)=0
	Write field of symmTensor (per face or vertex).
virtual fileName	write (const word &fieldName, const Field< tensor > &values)=0
	Write field of tensor (per face or vertex).
virtual InfoProxy< surfaceWriter >	info () const noexcept
	Return info proxy, used to print information to a stream.
template<class Type>
Foam::tmp< Foam::Field< Type > >	mergeFieldTemplate (const Field< Type > &fld) const
template<class Type>
Foam::tmp< Foam::Field< Type > >	adjustFieldTemplate (const word &fieldName, const tmp< Field< Type > > &tfield) const

Additional Inherited Members
Static Public Member Functions inherited from surfaceWriter
static dictionary	formatOptions (const dictionary &dict, const word &formatName, const word &entryName="formatOptions")
	Same as fileFormats::getFormatOptions.
static dictionary	formatOptions (const dictionary &dict, const dictionary &surfDict, const word &formatName, const word &entryName="formatOptions")
	Same as fileFormats::getFormatOptions.
static bool	supportedType (const word &writeType)
	True if New is likely to succeed for this writeType.
static autoPtr< surfaceWriter >	TryNew (const word &writeType)
	Optional select construct surfaceWriter.
static autoPtr< surfaceWriter >	TryNew (const word &writeType, const dictionary &writeOptions)
	Optional select construct surfaceWriter with extra write options.
static autoPtr< surfaceWriter >	New (const word &writeType)
	Select construct a surfaceWriter.
static autoPtr< surfaceWriter >	New (const word &writeType, const dictionary &writeOptions)
	Select construct a surfaceWriter with extra write options.
Static Public Attributes inherited from surfaceWriter
static scalar	defaultMergeDim = 1e-8
	The default merge dimension (1e-8).
Protected Member Functions inherited from surfaceWriter
void	checkOpen () const
	Verify that the outputPath_ has been set or FatalError.
virtual bool	merge () const
	Merge surfaces if they are not already upToDate (parallel) or simply mark the surface as being up-to-date.
const meshedSurf &	surface () const
	Merge surfaces (if not upToDate) and return merged (parallel) or regular surface (non-parallel).
const meshedSurfRef &	adjustSurface () const
	Merge surfaces (if not upToDate) and return merged (parallel) or regular surface (non-parallel) and apply any coordinate system changes and/or output scaling.
template<class Type>
tmp< Field< Type > >	mergeFieldTemplate (const Field< Type > &fld) const
	Gather (merge) fields with renumbering and shrinking for point data.
template<class Type>
tmp< Field< Type > >	adjustFieldTemplate (const word &fieldName, const tmp< Field< Type > > &tfield) const
	Apply refLevel and fieldScaling.
tmp< Field< label > >	mergeField (const Field< label > &fld) const
tmp< Field< label > >	adjustField (const word &fieldName, const tmp< Field< label > > &tfield) const
tmp< Field< scalar > >	mergeField (const Field< scalar > &fld) const
tmp< Field< scalar > >	adjustField (const word &fieldName, const tmp< Field< scalar > > &tfield) const
tmp< Field< vector > >	mergeField (const Field< vector > &fld) const
tmp< Field< vector > >	adjustField (const word &fieldName, const tmp< Field< vector > > &tfield) const
tmp< Field< sphericalTensor > >	mergeField (const Field< sphericalTensor > &fld) const
tmp< Field< sphericalTensor > >	adjustField (const word &fieldName, const tmp< Field< sphericalTensor > > &tfield) const
tmp< Field< symmTensor > >	mergeField (const Field< symmTensor > &fld) const
tmp< Field< symmTensor > >	adjustField (const word &fieldName, const tmp< Field< symmTensor > > &tfield) const
tmp< Field< tensor > >	mergeField (const Field< tensor > &fld) const
tmp< Field< tensor > >	adjustField (const word &fieldName, const tmp< Field< tensor > > &tfield) const
template<class Type>
fileName	writeTemplate (const word &fieldName, const Field< Type > &localValues)
	Dummy templated write operation.
Protected Attributes inherited from surfaceWriter
meshedSurfRef	surf_
	Reference to surface or surface components.
mergedSurf	mergedSurf_
	Surface after merging (parallel).
meshedSurfRef	adjustedSurf_
	The surface after point coordinate transforms and scaling.
scalar	mergeDim_
	Dimension for merging.
scalar	geometryScale_
	Output geometry scaling after rotate/translate.
point	geometryCentre_
	The centre of rotation (untranslate, translate).
coordSystem::cartesian	geometryTransform_
	Local coordinate system transformation.
bool	upToDate_
	The topology/surface is up-to-date?
bool	wroteGeom_
	Track if geometry has been written since the last open.
bool	parallel_
	Writing in parallel (via master).
bool	useTimeDir_
	Insert additional time sub-directory in the output path.
bool	isPointData_
	Is point vs cell data.
bool	verbose_
	Additional output verbosity.
UPstream::commsTypes	commType_
	Communication type (for field merging).
bool	gatherv_
	Prefer MPI gatherv intrinsic (for field merging) [experimental].
label	nFields_
	The number of fields.
instant	currTime_
	The current time value/name.
fileName	outputPath_
	The full output directory and file (surface) name.
dictionary	fieldLevel_
	Field level to remove (on output).
dictionary	fieldScale_
	Field scaling (on output).

Detailed Description

A surface writer for the Nastran file format - both surface mesh and fields.

The formatOptions for nastran:

Property	Description	Reqd	Default
`format`	Nastran format (short/long/free)	no	free
`scale`	Output geometry scaling	no	1
`transform`	Output coordinate transform	no
`fieldLevel`	Subtract field level before scaling	no	empty dict
`fieldScale`	Output field scaling	no	empty dict
`commonGeometry`	use separate geometry files	no	false
`PLOAD2`	Field selection (words/regex) for PLOAD2	no
`PLOAD4`	Field selection (words/regex) for PLOAD4	no
`fields`	Compat: Field pairs for PLOAD2/PLOAD4	no

For example,

    formatOptions
    {
        nastran
        {
            format  free;     // format type

            scale   1000;     // [m] -> [mm]
            fieldScale
            {
               "p.*"   0.01;  // [Pa] -> [mbar]
            }

            // Specific NASTRAN load types
            PLOAD2 ( pMean );
            PLOAD4 ( "p.*" );

            // old style specification
            fields
            (
                (pMean  PLOAD2)
                (p      PLOAD4)
            );
        }
    }

Unless otherwise specified, all fields will be treated as PLOAD2 output. Can optionally specify PLOAD4 output using a combination of PLOAD4 (accept) and PLOAD2 (deny) entries. The older fields specification is also accepted and will be transcribed to corresponding PLOAD4, PLOAD2 entries.

file locations

The rootdir normally corresponds to something like postProcessing/<name>

Geometry

    rootdir
    `-- <time>
        |-- surfaceName0.{nas}
        `-- surfaceName1.{nas}

Fields

    rootdir
    `-- <time>
        `-- field0
        |   |-- surfaceName0.{bdf}
        |   `-- surfaceName1.{bdf}
        `-- field1
            |-- surfaceName0.{bdf}
            `-- surfaceName1.{bdf}

Note: Output variable scaling does not apply to integer types such as Ids.

Source files

Definition at line 178 of file nastranSurfaceWriter.H.

Member Typedef Documentation

◆ fieldFormat

using fieldFormat = Foam::fileFormats::NASCore::fieldFormat

File field formats.

Definition at line 187 of file nastranSurfaceWriter.H.

◆ loadFormat

using loadFormat = Foam::fileFormats::NASCore::loadFormat

Output load format.

Definition at line 192 of file nastranSurfaceWriter.H.

Constructor & Destructor Documentation

◆ nastranWriter() [1/4]

nastranWriter ( )

Default construct. Default FREE format.

Definition at line 300 of file nastranSurfaceWriter.C.

References surfaceWriter::surfaceWriter().

Referenced by nastranWriter(), and nastranWriter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ nastranWriter() [2/4]

nastranWriter ( const dictionary & options )

explicit

Construct with some output options. Default FREE format.

Definition at line 309 of file nastranSurfaceWriter.C.

References format(), NASCore::loadFormatNames, dictionary::readIfPresent(), and surfaceWriter::surfaceWriter().

Here is the call graph for this function:

◆ nastranWriter() [3/4]

nastranWriter	(	const meshedSurf &	surf,
		const fileName &	outputPath,
		bool	parallel = UPstream::parRun(),
		const dictionary &	options = dictionary() )

Construct from components.

Definition at line 359 of file nastranSurfaceWriter.C.

References nastranWriter(), and surfaceWriter::open().

Here is the call graph for this function:

◆ nastranWriter() [4/4]

nastranWriter	(	const pointField &	points,
		const faceList &	faces,
		const fileName &	outputPath,
		bool	parallel = UPstream::parRun(),
		const dictionary &	options = dictionary() )

Construct from components.

Definition at line 373 of file nastranSurfaceWriter.C.

References nastranWriter(), surfaceWriter::open(), and points.

Here is the call graph for this function:

◆ ~nastranWriter()

virtual ~nastranWriter ( )

virtualdefault

Destructor.

Member Function Documentation

◆ TypeNameNoDebug()

TypeNameNoDebug ( "nastran" )

Declare type-name, virtual type (with debug switch).

References UPstream::parRun(), and points.

Here is the call graph for this function:

◆ usesFaceIds()

virtual bool usesFaceIds ( ) const

inlinevirtual

Format uses faceIds as part of its output.

Reimplemented from surfaceWriter.

Definition at line 359 of file nastranSurfaceWriter.H.

◆ write()

Foam::fileName write ( )

virtual

Write surface geometry to file.

Implements surfaceWriter.

Definition at line 390 of file nastranSurfaceWriter.C.

References surfaceWriter::adjustSurface(), IOstreamOption::ATOMIC, surfaceWriter::checkOpen(), surfaceWriter::empty(), Foam::endl(), fileName::ext(), Foam::Info, Foam::isDir(), UPstream::master(), Foam::mkDir(), Foam::nl, os(), surfaceWriter::outputPath_, surfaceWriter::parallel_, fileName::path(), NASCore::setPrecision(), timeName, surfaceWriter::useTimeDir(), surfaceWriter::verbose_, writeGeometry(), and surfaceWriter::wroteGeom_.

Here is the call graph for this function:

◆ declareSurfaceWriterWriteMethod() [1/6]

declareSurfaceWriterWriteMethod ( label )

◆ declareSurfaceWriterWriteMethod() [2/6]

declareSurfaceWriterWriteMethod ( scalar )

◆ declareSurfaceWriterWriteMethod() [3/6]

declareSurfaceWriterWriteMethod ( vector )

◆ declareSurfaceWriterWriteMethod() [4/6]

declareSurfaceWriterWriteMethod ( sphericalTensor )

◆ declareSurfaceWriterWriteMethod() [5/6]

declareSurfaceWriterWriteMethod ( symmTensor )

◆ declareSurfaceWriterWriteMethod() [6/6]

declareSurfaceWriterWriteMethod ( tensor )

◆ writeValue()

template<class Type>

Foam::Ostream & writeValue	(	Ostream &	os,
		const Type &	value ) const

Definition at line 30 of file nastranSurfaceWriterImpl.C.

References os(), and Foam::setw().

Here is the call graph for this function:

◆ writeFaceValue()

template<class Type>

Foam::Ostream & writeFaceValue	(	Ostream &	os,
		const loadFormat	format,
		const Type &	value,
		const label	elemId ) const

Definition at line 62 of file nastranSurfaceWriterImpl.C.

References Foam::component(), format(), NASCore::loadFormatNames, Foam::mag(), Foam::nl, and os().

Here is the call graph for this function:

The documentation for this class was generated from the following files:

src/surfMesh/writers/nastran/nastranSurfaceWriter.H
src/surfMesh/writers/nastran/nastranSurfaceWriter.C
src/surfMesh/writers/nastran/nastranSurfaceWriterImpl.C

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

file locations

Geometry

Fields

Member Typedef Documentation

◆ fieldFormat

◆ loadFormat

Constructor & Destructor Documentation

◆ nastranWriter() [1/4]

◆ nastranWriter() [2/4]

◆ nastranWriter() [3/4]

◆ nastranWriter() [4/4]

◆ ~nastranWriter()

Member Function Documentation

◆ TypeNameNoDebug()

◆ usesFaceIds()

◆ write()

◆ declareSurfaceWriterWriteMethod() [1/6]

◆ declareSurfaceWriterWriteMethod() [2/6]

◆ declareSurfaceWriterWriteMethod() [3/6]

◆ declareSurfaceWriterWriteMethod() [4/6]

◆ declareSurfaceWriterWriteMethod() [5/6]

◆ declareSurfaceWriterWriteMethod() [6/6]

◆ writeValue()

◆ writeFaceValue()