Base class for surface writers. More...


Public Member Functions | |
| TypeName ("surfaceWriter") | |
| Runtime type information. More... | |
| declareRunTimeSelectionTable (autoPtr, surfaceWriter, word,(),()) | |
| declareRunTimeSelectionTable (autoPtr, surfaceWriter, wordDict,(const dictionary &writeOpts),(writeOpts)) | |
| surfaceWriter () | |
| Default construct. More... | |
| surfaceWriter (const dictionary &options) | |
| Default construct with specified options. More... | |
| virtual | ~surfaceWriter () |
| Destructor. Calls close() More... | |
| 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. More... | |
| virtual bool | separateGeometry () const |
| True if the surface format requires geometry in a separate file. More... | |
| virtual bool | usesFaceIds () const |
| True if the writer format uses faceIds as part of its output. More... | |
| virtual bool | needsUpdate () const |
| Does the writer need an update (eg, lagging behind surface changes) More... | |
| virtual bool | wroteData () const |
| Geometry or fields written since the last open? More... | |
| virtual bool | expire () |
| Mark that surface changed and the writer will need an update, and set nFields = 0. More... | |
| virtual void | clear () |
| Close any open output, remove association with a surface and expire the writer. The parallel flag remains untouched. More... | |
| virtual void | setSurface (const meshedSurf &surf, bool parallel) |
| Change association with a surface, expire the writer with defined parallel/serial treatment. More... | |
| virtual void | setSurface (const pointField &points, const faceList &faces, bool parallel) |
| Change association with a surface, expire the writer with defined parallel/serial treatment. More... | |
| virtual void | setSurface (const meshedSurf &surf) |
| Change association with a surface, expire the writer with the current parallel/serial treatment. More... | |
| virtual void | setSurface (const pointField &points, const faceList &faces) |
| Change association with a surface, expire the writer with the current parallel/serial treatment. More... | |
| bool | is_open () const noexcept |
| Test if outputPath has been set. More... | |
| bool | hasSurface () const |
| Writer is associated with a surface. More... | |
| bool | empty () const |
| The surface to write is empty if the global number of faces is zero. More... | |
| label | size () const |
| The global number of faces for the associated surface. More... | |
| label | nFields () const noexcept |
| The number of expected output fields. More... | |
| label | nFields (const label n) noexcept |
| Set the number of expected output fields. More... | |
| bool | isPointData () const noexcept |
| Are the field data to be treated as point data? More... | |
| bool | isPointData (bool on) noexcept |
| Set handling of field data to face/point data. More... | |
| bool | vertexOutput () const noexcept |
| Output as 1D vertex/point elements instead of faces. More... | |
| bool | vertexOutput (bool on) noexcept |
| Output as 1D vertex/point elements instead of faces. More... | |
| bool | useTimeDir () const noexcept |
| Should a time directory be spliced into the output path? More... | |
| bool | useTimeDir (const bool on) noexcept |
| Enable/disable use of spliced output path. More... | |
| bool | verbose () const noexcept |
| Get output verbosity. More... | |
| bool | verbose (const bool on) noexcept |
| Enable/disable verbose output. More... | |
| scalar | mergeDim () const noexcept |
| The current value of the point merge dimension (metre) More... | |
| scalar | mergeDim (const scalar dist) noexcept |
| Change the point merge dimension (metre) More... | |
| scalar | scale () const noexcept |
| The current value of the geometry scaling. More... | |
| scalar | scale (const scalar factor) noexcept |
| Change the geometry scaling. More... | |
| const coordSystem::cartesian & | transform () const noexcept |
| The current (cartesian) coordinate system transformation. More... | |
| bool | hasTime () const |
| True if there is a known time. More... | |
| const word & | timeName () const |
| The current time value/name. More... | |
| scalar | timeValue () const |
| The current time value/name. More... | |
| void | setTime (const instant &inst) |
| Set the current time. More... | |
| void | setTime (scalar timeValue) |
| Set current time from timeValue, auto generating the name. More... | |
| void | setTime (scalar timeValue, const word &timeName) |
| Set current time from timeValue and timeName. More... | |
| void | unsetTime () |
| Clear the current time. More... | |
| virtual void | beginTime (const Time &t) |
| Begin a time-step. More... | |
| virtual void | beginTime (const instant &inst) |
| Begin a time-step. More... | |
| virtual void | endTime () |
| End a time-step. More... | |
| virtual void | open (const fileName &outputPath) |
| Open for output on specified path, using existing surface. More... | |
| virtual void | open (const pointField &points, const faceList &faces, const fileName &outputPath, bool parallel) |
| Open from components. More... | |
| virtual void | open (const meshedSurf &surf, const fileName &outputPath, bool parallel) |
| Open from components. More... | |
| virtual void | open (const pointField &points, const faceList &faces, const fileName &outputPath) |
| Open from components, with the current parallel/serial treatment. More... | |
| virtual void | open (const meshedSurf &surf, const fileName &outputPath) |
| Open from components, with the current parallel/serial treatment. More... | |
| virtual void | close () |
| Finish output, performing any necessary cleanup. More... | |
| virtual fileName | write ()=0 |
| Write separate surface geometry to file. More... | |
| virtual fileName | write (const word &fieldName, const Field< label > &values)=0 |
| Write field of label (per face or vertex) More... | |
| virtual fileName | write (const word &fieldName, const Field< scalar > &values)=0 |
| Write field of scalar (per face or vertex) More... | |
| virtual fileName | write (const word &fieldName, const Field< vector > &values)=0 |
| Write field of vector (per face or vertex) More... | |
| virtual fileName | write (const word &fieldName, const Field< sphericalTensor > &values)=0 |
| Write field of sphericalTensor (per face or vertex) More... | |
| virtual fileName | write (const word &fieldName, const Field< symmTensor > &values)=0 |
| Write field of symmTensor (per face or vertex) More... | |
| virtual fileName | write (const word &fieldName, const Field< tensor > &values)=0 |
| Write field of tensor (per face or vertex) More... | |
| virtual InfoProxy< surfaceWriter > | info () const noexcept |
| Return info proxy, used to print information to a stream. More... | |
Static Public Member Functions | |
| static dictionary | formatOptions (const dictionary &dict, const word &formatName, const word &entryName="formatOptions") |
| Same as fileFormats::getFormatOptions. More... | |
| static dictionary | formatOptions (const dictionary &dict, const dictionary &surfDict, const word &formatName, const word &entryName="formatOptions") |
| Same as fileFormats::getFormatOptions. More... | |
| static bool | supportedType (const word &writeType) |
| True if New is likely to succeed for this writeType. More... | |
| static autoPtr< surfaceWriter > | TryNew (const word &writeType) |
| Optional select construct surfaceWriter. More... | |
| static autoPtr< surfaceWriter > | TryNew (const word &writeType, const dictionary &writeOptions) |
| Optional select construct surfaceWriter with extra write options. More... | |
| static autoPtr< surfaceWriter > | New (const word &writeType) |
| Select construct a surfaceWriter. More... | |
| static autoPtr< surfaceWriter > | New (const word &writeType, const dictionary &writeOptions) |
| Select construct a surfaceWriter with extra write options. More... | |
Static Public Attributes | |
| static scalar | defaultMergeDim |
| The default merge dimension (1e-8) More... | |
Protected Member Functions | |
| void | checkOpen () const |
| Verify that the outputPath_ has been set or FatalError. More... | |
| virtual bool | merge () const |
| Merge surfaces if they are not already upToDate (parallel) or simply mark the surface as being up-to-date. More... | |
| const meshedSurf & | surface () const |
| Merge surfaces (if not upToDate) and return merged (parallel) or regular surface (non-parallel) More... | |
| 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. More... | |
| template<class Type > | |
| tmp< Field< Type > > | mergeFieldTemplate (const Field< Type > &fld) const |
| Gather (merge) fields with renumbering and shrinking for point data. More... | |
| template<class Type > | |
| tmp< Field< Type > > | adjustFieldTemplate (const word &fieldName, const tmp< Field< Type >> &tfield) const |
| Apply refLevel and fieldScaling. More... | |
| 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. More... | |
Protected Attributes | |
| meshedSurfRef | surf_ |
| Reference to surface or surface components. More... | |
| mergedSurf | mergedSurf_ |
| Surface after merging (parallel) More... | |
| meshedSurfRef | adjustedSurf_ |
| The surface after point coordinate transforms and scaling. More... | |
| scalar | mergeDim_ |
| Dimension for merging. More... | |
| scalar | geometryScale_ |
| Output geometry scaling after rotate/translate. More... | |
| point | geometryCentre_ |
| The centre of rotation (untranslate, translate) More... | |
| coordSystem::cartesian | geometryTransform_ |
| Local coordinate system transformation. More... | |
| bool | upToDate_ |
| The topology/surface is up-to-date? More... | |
| bool | wroteGeom_ |
| Track if geometry has been written since the last open. More... | |
| bool | parallel_ |
| Writing in parallel (via master) More... | |
| bool | useTimeDir_ |
| Insert additional time sub-directory in the output path. More... | |
| bool | isPointData_ |
| Is point vs cell data. More... | |
| bool | vertexOutput_ |
| Output as 1D vertex/point elements instead of faces. More... | |
| bool | verbose_ |
| Additional output verbosity. More... | |
| UPstream::commsTypes | commType_ |
| Communication type (for field merging) More... | |
| bool | gatherv_ |
| Prefer MPI gatherv intrinsic (for field merging) [experimental]. More... | |
| label | nFields_ |
| The number of fields. More... | |
| instant | currTime_ |
| The current time value/name. More... | |
| fileName | outputPath_ |
| The full output directory and file (surface) name. More... | |
| dictionary | fieldLevel_ |
| Field level to remove (on output) More... | |
| dictionary | fieldScale_ |
| Field scaling (on output) More... | |
Friends | |
| Ostream & | operator<< (Ostream &os, const InfoProxy< surfaceWriter > &iproxy) |
| Output info proxy. More... | |
Base class for surface writers.
The surfaceWriter interface is rather large since we need a writer that can either be initially defined without a surface association and have that added at a later stage, or be defined with a surface association.
formatOptions
{
default
{
verbose true;
commsType scheduled;
fieldLevel
{
"p.*" 1e5; // Absolute -> gauge [Pa]
T 273.15; // [K] -> [C]
U #eval{ 10/sqrt(3) }; // Uniform magU=10
}
}
someFormat // Eg, ensight, vtk, etc
{
fieldScale
{
"p.*" 0.01; // [Pa] -> [mbar]
}
scale 1000; // [m] -> [mm]
transform
{
origin (0 0 0);
rotationCentre (0 0 0);
rotation axisAngle;
axis (1 0 0);
angle 45;
}
}
}
Format options:
| Property | Description | Reqd | Default |
|---|---|---|---|
verbose | Additional output verbosity | no | no |
commsType | Communication type | no | scheduled |
gatherv | Use MPI gatherv [experimental] | no | false |
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 |
transform sub-dictionary also supports a rotationCentre keyword which applies untranslate by that amount prior to the rotation, and subsequently followed by a translate.For surface formats that require geometry in a separate file, it is the responsibility of the implementation (not the caller) to ensure that this occurs.
Using MPI gatherv [experimental] is not well tested and may change or be removed in the future!
Definition at line 179 of file surfaceWriter.H.
| surfaceWriter | ( | ) |
Default construct.
|
explicit |
Default construct with specified options.
|
virtual |
Destructor. Calls close()
|
protected |
Verify that the outputPath_ has been set or FatalError.
|
protectedvirtual |
Merge surfaces if they are not already upToDate (parallel) or simply mark the surface as being up-to-date.
|
protected |
Merge surfaces (if not upToDate) and return merged (parallel) or regular surface (non-parallel)
|
protected |
Merge surfaces (if not upToDate) and return merged (parallel) or regular surface (non-parallel) and apply any coordinate system changes and/or output scaling.
Gather (merge) fields with renumbering and shrinking for point data.
|
protected |
Apply refLevel and fieldScaling.
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
inlineprotected |
Dummy templated write operation.
| fieldName | Name of field |
| localValues | Local field values to write |
Definition at line 363 of file surfaceWriter.H.
References fileName::null, surfaceWriter::write(), and surfaceWriter::wroteGeom_.

| TypeName | ( | "surfaceWriter" | ) |
Runtime type information.
| declareRunTimeSelectionTable | ( | autoPtr | , |
| surfaceWriter | , | ||
| word | , | ||
| () | , | ||
| () | |||
| ) |
| declareRunTimeSelectionTable | ( | autoPtr | , |
| surfaceWriter | , | ||
| wordDict | , | ||
| (const dictionary &writeOpts) | , | ||
| (writeOpts) | |||
| ) |
|
static |
Same as fileFormats::getFormatOptions.
Referenced by Curle::read(), surfaceFieldValue::read(), and propellerInfo::setSampleDiskSurface().

|
static |
Same as fileFormats::getFormatOptions.
|
static |
True if New is likely to succeed for this writeType.
|
static |
Optional select construct surfaceWriter.
Return nullptr if the specified type is not supported.
|
static |
Optional select construct surfaceWriter with extra write options.
Return nullptr if the specified type is not supported.
|
static |
Select construct a surfaceWriter.
Referenced by averageNeighbourFvGeometryScheme::movePoints(), Curle::read(), surfaceNoise::read(), surfaceFieldValue::read(), and propellerInfo::setSampleDiskSurface().

|
static |
Select construct a surfaceWriter with extra write options.
|
inlinevirtual |
The writer is enabled. If the writer is not enabled, it may be possible for the caller to skip various preparatory operations.
This method is primarily useful for the null writer
Reimplemented in nullWriter.
Definition at line 506 of file surfaceWriter.H.
|
inlinevirtual |
True if the surface format requires geometry in a separate file.
Reimplemented in ensightWriter, foamWriter, starcdWriter, and proxyWriter.
Definition at line 514 of file surfaceWriter.H.
|
inlinevirtual |
True if the writer format uses faceIds as part of its output.
Element ids are used by various CAE formats (abaqus, nastran, starcd, ...)
Reimplemented in nastranWriter, abaqusWriter, and starcdWriter.
Definition at line 525 of file surfaceWriter.H.
|
virtual |
Does the writer need an update (eg, lagging behind surface changes)
Reimplemented in nullWriter.
|
virtual |
Geometry or fields written since the last open?
Reimplemented in nullWriter.
|
virtual |
Mark that surface changed and the writer will need an update, and set nFields = 0.
May also free up unneeded data. Return false if it was previously already expired.
|
virtual |
Close any open output, remove association with a surface and expire the writer. The parallel flag remains untouched.
|
virtual |
Change association with a surface, expire the writer with defined parallel/serial treatment.
Reimplemented in nullWriter.
|
virtual |
Change association with a surface, expire the writer with defined parallel/serial treatment.
Reimplemented in nullWriter.
|
virtual |
Change association with a surface, expire the writer with the current parallel/serial treatment.
|
virtual |
Change association with a surface, expire the writer with the current parallel/serial treatment.
|
inlinenoexcept |
Test if outputPath has been set.
Definition at line 24 of file surfaceWriterI.H.
References surfaceWriter::outputPath_.
| 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.
|
inlinenoexcept |
The number of expected output fields.
Currently only used by the legacy VTK format.
Definition at line 30 of file surfaceWriterI.H.
|
inlinenoexcept |
Set the number of expected output fields.
Currently only used by the legacy VTK format.
Definition at line 36 of file surfaceWriterI.H.
References n.
|
inlinenoexcept |
Are the field data to be treated as point data?
Definition at line 44 of file surfaceWriterI.H.
|
inlinenoexcept |
Set handling of field data to face/point data.
Definition at line 50 of file surfaceWriterI.H.
|
inlinenoexcept |
Output as 1D vertex/point elements instead of faces.
Definition at line 58 of file surfaceWriterI.H.
|
inlinenoexcept |
Output as 1D vertex/point elements instead of faces.
Definition at line 64 of file surfaceWriterI.H.
|
inlinenoexcept |
Should a time directory be spliced into the output path?
Definition at line 72 of file surfaceWriterI.H.
|
inlinenoexcept |
Enable/disable use of spliced output path.
Definition at line 78 of file surfaceWriterI.H.
|
inlinenoexcept |
Get output verbosity.
Definition at line 86 of file surfaceWriterI.H.
|
inlinenoexcept |
|
inlinenoexcept |
The current value of the point merge dimension (metre)
Definition at line 100 of file surfaceWriterI.H.
|
inlinenoexcept |
Change the point merge dimension (metre)
Definition at line 106 of file surfaceWriterI.H.
|
inlinenoexcept |
The current value of the geometry scaling.
Definition at line 114 of file surfaceWriterI.H.
|
inlinenoexcept |
|
inlinenoexcept |
The current (cartesian) coordinate system transformation.
Definition at line 130 of file surfaceWriterI.H.
|
inline |
True if there is a known time.
Definition at line 136 of file surfaceWriterI.H.
|
inline |
The current time value/name.
Definition at line 142 of file surfaceWriterI.H.
|
inline |
The current time value/name.
Definition at line 148 of file surfaceWriterI.H.
| 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 |
Begin a time-step.
Reimplemented in vtkWriter.
|
virtual |
End a time-step.
Reimplemented in vtkWriter.
|
virtual |
Open for output on specified path, using existing surface.
Reimplemented in nullWriter.
|
virtual |
Open from components.
|
virtual |
Open from components.
|
virtual |
Open from components, with the current parallel/serial treatment.
|
virtual |
Open from components, with the current parallel/serial treatment.
|
virtual |
Finish output, performing any necessary cleanup.
Reimplemented in vtkWriter, and ensightWriter.
|
pure virtual |
Write separate surface geometry to file.
Implemented in nastranWriter, boundaryDataWriter, vtkWriter, abaqusWriter, ensightWriter, foamWriter, rawWriter, starcdWriter, x3dWriter, proxyWriter, debugWriter, and nullWriter.
Referenced by surfaceWriter::writeTemplate().

Write field of label (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
Write field of scalar (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
Write field of vector (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
|
pure virtual |
Write field of sphericalTensor (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
|
pure virtual |
Write field of symmTensor (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
Write field of tensor (per face or vertex)
| fieldName | Name of field |
| values | Field values to write |
|
inlinevirtualnoexcept |
Return info proxy, used to print information to a stream.
Definition at line 865 of file surfaceWriter.H.
|
friend |
Output info proxy.
|
protected |
Reference to surface or surface components.
Definition at line 188 of file surfaceWriter.H.
|
mutableprotected |
Surface after merging (parallel)
Definition at line 193 of file surfaceWriter.H.
|
mutableprotected |
The surface after point coordinate transforms and scaling.
Definition at line 198 of file surfaceWriter.H.
|
protected |
Dimension for merging.
Definition at line 203 of file surfaceWriter.H.
|
protected |
Output geometry scaling after rotate/translate.
Definition at line 208 of file surfaceWriter.H.
|
protected |
The centre of rotation (untranslate, translate)
Definition at line 213 of file surfaceWriter.H.
|
protected |
Local coordinate system transformation.
Definition at line 218 of file surfaceWriter.H.
|
mutableprotected |
The topology/surface is up-to-date?
Definition at line 228 of file surfaceWriter.H.
|
mutableprotected |
Track if geometry has been written since the last open.
Definition at line 233 of file surfaceWriter.H.
Referenced by surfaceWriter::writeTemplate().
|
protected |
Writing in parallel (via master)
Definition at line 238 of file surfaceWriter.H.
|
protected |
Insert additional time sub-directory in the output path.
Definition at line 243 of file surfaceWriter.H.
|
protected |
Is point vs cell data.
Definition at line 248 of file surfaceWriter.H.
|
protected |
Output as 1D vertex/point elements instead of faces.
Definition at line 253 of file surfaceWriter.H.
|
protected |
Additional output verbosity.
Definition at line 258 of file surfaceWriter.H.
|
protected |
Communication type (for field merging)
Definition at line 263 of file surfaceWriter.H.
|
protected |
Prefer MPI gatherv intrinsic (for field merging) [experimental].
Definition at line 268 of file surfaceWriter.H.
|
protected |
The number of fields.
Definition at line 273 of file surfaceWriter.H.
|
protected |
The current time value/name.
Definition at line 278 of file surfaceWriter.H.
|
protected |
The full output directory and file (surface) name.
Definition at line 283 of file surfaceWriter.H.
Referenced by surfaceWriter::is_open().
|
protected |
Field level to remove (on output)
Definition at line 288 of file surfaceWriter.H.
|
protected |
Field scaling (on output)
Definition at line 293 of file surfaceWriter.H.
|
static |
The default merge dimension (1e-8)
Definition at line 382 of file surfaceWriter.H.