The decomposedBlockData comprise a List<char>
for each output processor, typically with IO on the master processor only.
More...
Public Member Functions | |
TypeName ("decomposedBlockData") | |
Declare type-name, virtual type (with debug switch) More... | |
decomposedBlockData (const label comm, const IOobject &io, const UPstream::commsTypes=UPstream::commsTypes::scheduled) | |
Construct given an IOobject. More... | |
virtual | ~decomposedBlockData ()=default |
Destructor. More... | |
virtual bool | read () |
Read object. More... | |
virtual bool | writeData (Ostream &os) const |
Write separated content (assumes content is the serialised data) More... | |
virtual bool | writeObject (IOstreamOption streamOpt, const bool valid) const |
Write using stream options. More... | |
![]() | |
TypeName ("regIOobject") | |
Runtime type information. More... | |
regIOobject (const IOobject &io, const bool isTimeObject=false) | |
regIOobject (const regIOobject &rio) | |
Copy construct. More... | |
regIOobject (const regIOobject &rio, bool registerCopy) | |
regIOobject (const word &newName, const regIOobject &, bool registerCopy) | |
regIOobject (const IOobject &io, const regIOobject &rio) | |
Copy construct with new IO parameters. More... | |
virtual | ~regIOobject () |
Destructor. More... | |
bool | checkIn () |
Add object to registry, if not already registered. More... | |
bool | checkOut () |
Remove all file watches and remove object from registry. More... | |
virtual void | addWatch () |
Add file watch on object (if registered and READ_IF_MODIFIED) More... | |
bool | ownedByRegistry () const |
Is this object owned by the registry? More... | |
bool | store () |
void | release (const bool unregister=false) |
Release ownership of this object from its registry. More... | |
label | eventNo () const |
Event number at last update. More... | |
label & | eventNo () |
Event number at last update. More... | |
bool | upToDate (const regIOobject &) const |
Return true if up-to-date with respect to given object. More... | |
bool | upToDate (const regIOobject &, const regIOobject &) const |
Return true if up-to-date with respect to given objects. More... | |
bool | upToDate (const regIOobject &, const regIOobject &, const regIOobject &) const |
Return true if up-to-date with respect to given objects. More... | |
bool | upToDate (const regIOobject &, const regIOobject &, const regIOobject &, const regIOobject &) const |
Return true if up-to-date with respect to given objects. More... | |
void | setUpToDate () |
Set as up-to-date. More... | |
virtual void | rename (const word &newName) |
Rename. More... | |
const dictionary * | findMetaData () const noexcept |
Return pointer to meta-data or nullptr. More... | |
dictionary & | getMetaData () noexcept |
Get or create meta-data. More... | |
void | removeMetaData () |
Remove meta-data. More... | |
virtual void | updateMetaData () |
Update internal meta-data (eg, prior to writing) More... | |
virtual fileName | filePath () const |
Return complete path + object name if the file exists. More... | |
bool | headerOk () |
Read and check header info. More... | |
Istream & | readStream (const word &, const bool valid=true) |
Return Istream and check object type against that given. More... | |
void | close () |
Close Istream. More... | |
virtual bool | readData (Istream &) |
Virtual readData function. More... | |
virtual label | addWatch (const fileName &) |
Add file watch for fileName on object if not yet watched. More... | |
const labelList & | watchIndices () const |
Return file-monitoring handles. More... | |
labelList & | watchIndices () |
Return file-monitoring handles. More... | |
virtual bool | modified () const |
virtual bool | readIfModified () |
Read object if modified (as set by call to modified) More... | |
virtual bool | write (const bool valid=true) const |
Write using setting from DB. More... | |
virtual bool | global () const |
Is object global. More... | |
void | operator= (const IOobject &io) |
Copy assignment. More... | |
virtual bool | writeObject (IOstreamOption::streamFormat fmt, IOstreamOption::versionNumber ver, IOstreamOption::compressionType comp, const bool valid) const |
Write using given format, version and compression. More... | |
![]() | |
TypeName ("IOobject") | |
Declare type-name, virtual type (with debug switch) More... | |
IOobject (const IOobject &)=default | |
Copy construct. More... | |
virtual | ~IOobject ()=default |
Destructor. More... | |
IOobject (const word &name, const fileName &instance, const objectRegistry ®istry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true, bool globalObject=false) | |
Construct from name, instance, registry, io options. More... | |
IOobject (const word &name, const fileName &instance, const fileName &local, const objectRegistry ®istry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true, bool globalObject=false) | |
Construct from name, instance, local, registry, io options. More... | |
IOobject (const fileName &path, const objectRegistry ®istry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true, bool globalObject=false) | |
Construct from path, registry, io options. More... | |
IOobject (const IOobject &io, const objectRegistry ®istry) | |
Copy construct, resetting registry. More... | |
IOobject (const IOobject &io, const word &name) | |
Copy construct, resetting name. More... | |
IOobject (const IOobject &io, readOption, writeOption) | |
Copy construct, resetting io options. More... | |
autoPtr< IOobject > | clone () const |
Clone. More... | |
autoPtr< IOobject > | clone (const objectRegistry ®istry) const |
Clone resetting registry. More... | |
const objectRegistry & | db () const noexcept |
Return the local objectRegistry. More... | |
const Time & | time () const |
Return Time associated with the objectRegistry. More... | |
const word & | name () const noexcept |
Return name. More... | |
const word & | headerClassName () const noexcept |
Return name of the class name read from header. More... | |
word & | headerClassName () noexcept |
Return non-constant access to the class name read from header. More... | |
const string & | note () const noexcept |
Return the optional note. More... | |
string & | note () noexcept |
Return non-constant access to the optional note. More... | |
bool | registerObject () const noexcept |
Should object created with this IOobject be registered? More... | |
bool | registerObject (bool on) noexcept |
Change registration preference, return previous value. More... | |
bool | globalObject () const noexcept |
Is object same for all processors? More... | |
bool | globalObject (bool on) noexcept |
Change global-object status, return previous value. More... | |
unsigned | labelByteSize () const noexcept |
The sizeof (label) in bytes, possibly read from the header. More... | |
unsigned | scalarByteSize () const noexcept |
The sizeof (scalar) in bytes, possibly read from the header. More... | |
bool | isHeaderClassName (const word &clsName) const |
Test if headerClassName() equals the given class name. More... | |
template<class Type > | |
bool | isHeaderClassName () const |
Test if headerClassName() equals Type::typeName. More... | |
readOption | readOpt () const noexcept |
The read option. More... | |
readOption | readOpt (readOption opt) noexcept |
Change the read option, return previous value. More... | |
writeOption | writeOpt () const noexcept |
The write option. More... | |
writeOption | writeOpt (writeOption opt) noexcept |
Change the write option, return previous value. More... | |
word | group () const |
Return group (extension part of name) More... | |
word | member () const |
Return member (name without the extension) More... | |
const fileName & | rootPath () const |
const fileName & | caseName () const |
const fileName & | instance () const noexcept |
fileName & | instance () noexcept |
const fileName & | local () const noexcept |
fileName | path () const |
The complete path. More... | |
fileName | path (const word &instance, const fileName &local=fileName::null) const |
The complete path with alternative instance and local. More... | |
fileName | objectPath () const |
The complete path + object name. More... | |
fileName | objectRelPath () const |
The object path relative to the root. More... | |
fileName | localFilePath (const word &typeName, const bool search=true) const |
Helper for filePath that searches locally. More... | |
fileName | globalFilePath (const word &typeName, const bool search=true) const |
Helper for filePath that searches up if in parallel. More... | |
IOstreamOption | parseHeader (const dictionary &headerDict) |
bool | readHeader (Istream &is) |
bool | readHeader (dictionary &headerDict, Istream &is) |
template<class Type > | |
bool | typeHeaderOk (const bool checkType=true, const bool search=true, const bool verbose=true) |
Read header (uses typeFilePath to find file) and check its info. More... | |
template<class Type > | |
void | warnNoRereading () const |
Helper: warn that type does not support re-reading. More... | |
bool | writeHeader (Ostream &os) const |
Write header with current type() More... | |
bool | writeHeader (Ostream &os, const word &objectType) const |
Write header with override of type. More... | |
void | writeHeader (dictionary &dict, IOstreamOption streamOpt) const |
void | writeHeader (dictionary &dict, const word &objectType, IOstreamOption streamOpt) const |
bool | good () const noexcept |
bool | bad () const noexcept |
InfoProxy< IOobject > | info () const |
Return info proxy. More... | |
void | operator= (const IOobject &io) |
readOption & | readOpt () noexcept |
Access to the read option. More... | |
writeOption & | writeOpt () noexcept |
Access to the write option. More... | |
bool & | registerObject () noexcept |
Access to the register object option. More... | |
bool & | globalObject () noexcept |
Access to the global object option. More... | |
template<> | |
bool | isHeaderClassName () const |
Specialization for void always returns true (no headerClassName check). More... | |
template<class StringType > | |
Foam::word | groupName (StringType base, const word &group) |
Static Public Member Functions | |
static bool | isCollatedType (const word &objectType) |
True if object type is a known collated type. More... | |
static bool | isCollatedType (const IOobject &io) |
True if object header class is a known collated type. More... | |
static bool | readHeader (IOobject &io, Istream &is) |
static void | writeHeader (Ostream &os, IOstreamOption streamOptContainer, const word &objectType, const string ¬e, const fileName &location, const word &objectName, const dictionary &extraEntries) |
Helper: write FoamFile IOobject header. More... | |
static void | writeHeader (Ostream &os, IOstreamOption streamOptData, const IOobject &io) |
Helper: write FoamFile IOobject header. More... | |
static void | writeExtraHeaderContent (dictionary &dict, IOstreamOption streamOptData, const IOobject &io) |
Helper: generate additional entries for FoamFile header. More... | |
static bool | readBlockEntry (Istream &is, List< char > &charData) |
Helper: read block of (binary) character data. More... | |
static std::streamoff | writeBlockEntry (OSstream &os, const label blocki, const UList< char > &charData) |
Helper: write block of (binary) character data. More... | |
static std::streamoff | writeBlockEntry (OSstream &os, IOstreamOption streamOptData, const regIOobject &io, const label blocki, const bool withLocalHeader) |
Helper: write block of (binary) character data. More... | |
static autoPtr< ISstream > | readBlock (const label blocki, ISstream &is, IOobject &headerIO) |
Read selected block (non-seeking) + header information. More... | |
static autoPtr< ISstream > | readBlocks (const label comm, const fileName &fName, autoPtr< ISstream > &isPtr, IOobject &headerIO, const UPstream::commsTypes commsType) |
static void | gather (const label comm, const label data, labelList &datas) |
Helper: gather single label. Note: using native Pstream. More... | |
static void | gatherSlaveData (const label comm, const UList< char > &data, const labelUList &recvSizes, const label startProc, const label nProcs, List< int > &recvOffsets, List< char > &recvData) |
Helper: gather data from (subset of) slaves. More... | |
static bool | writeBlocks (const label comm, autoPtr< OSstream > &osPtr, List< std::streamoff > &blockOffset, const UList< char > &masterData, const labelUList &recvSizes, const PtrList< SubList< char >> &slaveData, const UPstream::commsTypes, const bool syncReturnState=true) |
Write *this. Ostream only valid on master. More... | |
![]() | |
template<class Type > | |
static Type & | store (Type *p) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (autoPtr< Type > &ptr) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (autoPtr< Type > &&ptr) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (refPtr< Type > &ptr) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (refPtr< Type > &&ptr) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (tmp< Type > &ptr) |
Transfer pointer ownership to its registry. More... | |
template<class Type > | |
static Type & | store (tmp< Type > &&ptr) |
Transfer pointer ownership to its registry. More... | |
![]() | |
static bool | bannerEnabled () noexcept |
Status of output file banner. More... | |
static bool | bannerEnabled (bool on) noexcept |
Enable/disable an output file banner. More... | |
static bool | fileNameComponents (const fileName &path, fileName &instance, fileName &local, word &name) |
Split path into instance, local, name components. More... | |
template<class StringType > | |
static word | groupName (StringType base, const word &group) |
Create dot-delimited name.group string. More... | |
static word | group (const word &name) |
Return group (extension part of name) More... | |
static word | member (const word &name) |
Return member (name without the extension) More... | |
static word | scopedName (const std::string &scope, const word &name) |
Create scope:name or scope_name string. More... | |
static IOobject | selectIO (const IOobject &io, const fileName &altFile, const word &ioName="") |
Return the IOobject, but also consider an alternative file name. More... | |
static Ostream & | writeBanner (Ostream &os, const bool noSyntaxHint=false) |
Write the standard OpenFOAM file/dictionary banner. More... | |
static Ostream & | writeDivider (Ostream &os) |
Write the standard file section divider. More... | |
static Ostream & | writeEndDivider (Ostream &os) |
Write the standard end file divider. More... | |
Static Protected Member Functions | |
static label | calcNumProcs (const label comm, const off_t maxBufferSize, const labelUList &recvSizes, const label startProci) |
static bool | readBlocks (const label comm, autoPtr< ISstream > &isPtr, List< char > &contentChars, const UPstream::commsTypes commsType) |
Read data into *this. ISstream is only valid on master. More... | |
![]() | |
static void | writeHeaderContent (Ostream &os, const IOobject &io, const word &objectType, const dictionary *metaDataDict=nullptr) |
static void | writeHeaderContent (dictionary &dict, const IOobject &io, const word &objectType, IOstreamOption streamOpt, const dictionary *metaDataDict=nullptr) |
Protected Attributes | |
const UPstream::commsTypes | commsType_ |
Type to use for gather. More... | |
const label | comm_ |
Communicator for all parallel comms. More... | |
List< char > | contentData_ |
The block content. More... | |
Additional Inherited Members | |
![]() | |
enum | objectState : char { GOOD, BAD } |
Enumeration defining the valid states of an IOobject. More... | |
enum | readOption : char { MUST_READ, MUST_READ_IF_MODIFIED, READ_IF_PRESENT, NO_READ } |
Enumeration defining the read options. More... | |
enum | writeOption : char { AUTO_WRITE = 0, NO_WRITE = 1 } |
Enumeration defining the write options. More... | |
enum | fileCheckTypes : char { timeStamp, timeStampMaster, inotify, inotifyMaster } |
Enumeration defining the file checking options. More... | |
![]() | |
static const Enum< fileCheckTypes > | fileCheckTypesNames |
Names for the fileCheckTypes. More... | |
static char | scopeSeparator |
Character for scoping object names (':' or '_') More... | |
static fileCheckTypes | fileModificationChecking |
Type of file modification checking. More... | |
static float | fileModificationSkew |
Time skew (seconds) for file modification checks. More... | |
static int | maxFileModificationPolls |
Max number of times to poll for file modification changes. More... | |
![]() | |
bool | readHeaderOk (const IOstreamOption::streamFormat fmt, const word &typeName) |
Helper: check readOpt flags and read if necessary. More... | |
![]() | |
void | setBad (const string &s) |
Set the object state to bad. More... | |
![]() | |
static bool | masterOnlyReading = false |
To flag master-only reading of objects. More... | |
The decomposedBlockData comprise a List<char>
for each output processor, typically with IO on the master processor only.
For decomposedBlockData, we make a distinction between the container description and the individual block contents.
The FoamFile header specifies the container characteristics and thus has class
= decomposedBlockData
and normally format
= binary
. This description refers to the entire file container, not the individual blocks.
Each processor block is simply a binary chunk of characters and the first block also contains the header description for all of the blocks. For example,
FoamFile { version 2.0; format binary; arch "LSB;label=32;scalar=64"; class decomposedBlockData; location "constant/polyMesh"; object points; } // processor0 NCHARS (FoamFile { version 2.0; format ascii; arch "LSB;label=32;scalar=64"; class vectorField; location "constant/polyMesh"; object points; } ...content... ) // processor1 NCHARS (...content...) ...
Definition at line 102 of file decomposedBlockData.H.
decomposedBlockData | ( | const label | comm, |
const IOobject & | io, | ||
const UPstream::commsTypes | commsType = UPstream::commsTypes::scheduled |
||
) |
Construct given an IOobject.
Definition at line 77 of file decomposedBlockData.C.
References Foam::endl(), Foam::name(), Foam::blockMeshTools::read(), IOobject::readOpt(), and WarningInFunction.
|
virtualdefault |
Destructor.
|
staticprotected |
Helper: determine number of processors whose recvSizes fits into maxBufferSize
Definition at line 678 of file decomposedBlockData.C.
References n, and Foam::Zero.
|
staticprotected |
Read data into *this. ISstream is only valid on master.
Definition at line 305 of file decomposedBlockData.C.
References Foam::expressions::patchExpr::debug, Foam::endl(), IOstream::fatalCheck(), PstreamBuffers::finishedSends(), FUNCTION_NAME, IOstream::good(), os(), and Foam::Pout.
Referenced by decomposedBlockData::read(), and masterUncollatedFileOperation::readStream().
TypeName | ( | "decomposedBlockData" | ) |
Declare type-name, virtual type (with debug switch)
|
virtual |
Read object.
Reimplemented from regIOobject.
Definition at line 928 of file decomposedBlockData.C.
References decomposedBlockData::comm_, decomposedBlockData::commsType_, decomposedBlockData::contentData_, Foam::fileHandler(), regIOobject::filePath(), UPstream::master(), word::null, decomposedBlockData::readBlocks(), IOobject::readHeader(), and autoPtr< T >::reset().
Write separated content (assumes content is the serialised data)
The serialised master data should also contain a FoamFile header
Implements regIOobject.
Definition at line 942 of file decomposedBlockData.C.
References IOstreamOption::versionNumber::canonical(), IOstreamOption::format(), IOstream::good(), IOobject::headerClassName(), UPstream::master(), UPstream::msgType(), Foam::name(), IOobject::note(), os(), IOobject::readHeader(), Pstream::scatter(), IOstreamOption::version(), IOobject::writeEndDivider(), decomposedBlockData::writeHeader(), OBJstream::writeQuoted(), and OSstream::writeRaw().
|
virtual |
Write using stream options.
Reimplemented from regIOobject.
Definition at line 1015 of file decomposedBlockData.C.
References IOstreamOption::BINARY, UPstream::master(), autoPtr< T >::reset(), and decomposedBlockData::writeHeader().
True if object type is a known collated type.
Definition at line 54 of file decomposedBlockData.C.
Referenced by decomposedBlockData::readHeader(), and masterUncollatedFileOperation::readStream().
True if object header class is a known collated type.
Definition at line 66 of file decomposedBlockData.C.
References IOobject::headerClassName().
Read header as per IOobject with additional handling of decomposedBlockData
Definition at line 105 of file decomposedBlockDataHeader.C.
References IOobject::headerClassName(), decomposedBlockData::isCollatedType(), ISstream::name(), IOstream::name(), decomposedBlockData::readBlockEntry(), IOobject::readHeader(), and dictionary::readIfPresent().
Referenced by masterUncollatedFileOperation::readHeader().
|
static |
Helper: write FoamFile IOobject header.
Definition at line 137 of file decomposedBlockDataHeader.C.
References IOobject::bannerEnabled(), Ostream::beginBlock(), Ostream::endBlock(), Foam::nl, os(), IOobject::writeBanner(), IOobject::writeDivider(), and dictionary::writeEntries().
Referenced by decomposedBlockData::writeData(), and decomposedBlockData::writeObject().
|
static |
Helper: write FoamFile IOobject header.
Definition at line 198 of file decomposedBlockDataHeader.C.
References IOobject::bannerEnabled(), Ostream::beginBlock(), IOobject::db(), objectRegistry::dbDir(), Ostream::endBlock(), IOobject::findMetaData(), IOstreamOption::format(), IOobject::instance(), IOobject::local(), IOobject::name(), Foam::nl, IOobject::note(), os(), IOobject::writeBanner(), IOobject::writeDivider(), dictionary::writeEntry(), and Foam::writeHeaderEntry().
|
static |
Helper: generate additional entries for FoamFile header.
Definition at line 179 of file decomposedBlockDataHeader.C.
References dictionary::add(), dict, IOobject::findMetaData(), IOstreamOption::format(), and dictionary::set().
Referenced by collatedFileOperation::writeObject().
Helper: read block of (binary) character data.
Definition at line 114 of file decomposedBlockData.C.
References IOstream::fatalCheck(), FUNCTION_NAME, token::good(), token::isCompound(), token::isWord(), Istream::putBack(), and List< T >::readList().
Referenced by decomposedBlockData::readHeader().
|
static |
Helper: write block of (binary) character data.
Definition at line 156 of file decomposedBlockData.C.
References Foam::name(), Foam::nl, os(), and UList< T >::writeList().
|
static |
Helper: write block of (binary) character data.
Definition at line 178 of file decomposedBlockData.C.
References os(), regIOobject::writeData(), and IOobject::writeHeader().
|
static |
Read selected block (non-seeking) + header information.
Definition at line 227 of file decomposedBlockData.C.
References Foam::expressions::patchExpr::debug, Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOstreamOption::format(), IOstream::labelByteSize(), ISstream::name(), Foam::nl, Foam::Pout, IOobject::readHeader(), IOstream::relativeName(), autoPtr< T >::reset(), IOstream::scalarByteSize(), and IOstreamOption::version().
Referenced by masterUncollatedFileOperation::readStream().
|
static |
Read master header information (into headerIO) and return data in stream. Note: isPtr is only valid on master.
Set stream properties from realIsPtr on master
Definition at line 414 of file decomposedBlockData.C.
References Foam::expressions::patchExpr::debug, Foam::endl(), Foam::exit(), IOstream::fatalCheck(), Foam::FatalIOError, FatalIOErrorInFunction, PstreamBuffers::finishedSends(), FUNCTION_NAME, IOstream::good(), IOobject::headerClassName(), Foam::name(), IOobject::name(), Foam::nl, IOobject::note(), os(), Foam::Pout, IOobject::readHeader(), IOstream::relativeName(), IOobject::rename(), and autoPtr< T >::reset().
|
static |
Helper: gather single label. Note: using native Pstream.
datas sized with num procs but undefined contents on slaves
Definition at line 579 of file decomposedBlockData.C.
References forAll, List< T >::resize(), and List< T >::setSize().
Referenced by OFstreamCollator::write().
|
static |
Helper: gather data from (subset of) slaves.
Returns:
Definition at line 618 of file decomposedBlockData.C.
References List< T >::resize(), and List< T >::setSize().
|
static |
Write *this. Ostream only valid on master.
Returns offsets of processor blocks in blockOffset
Enable to get synchronised error checking. Is the one that keeps
slaves as slow as the master (which does all the writing)
Definition at line 718 of file decomposedBlockData.C.
References UList< T >::cdata(), Foam::expressions::patchExpr::debug, Foam::endl(), autoPtr< T >::good(), os(), Foam::Pout, Foam::blockMeshTools::read(), List< T >::resize(), DynamicList< T, SizeMin >::resize(), UList< T >::size(), UList< T >::size_bytes(), and Foam::vtk::write().
|
protected |
Type to use for gather.
Definition at line 125 of file decomposedBlockData.H.
Referenced by decomposedBlockData::read().
|
protected |
Communicator for all parallel comms.
Definition at line 128 of file decomposedBlockData.H.
Referenced by decomposedBlockData::read().
|
protected |
The block content.
Definition at line 131 of file decomposedBlockData.H.
Referenced by decomposedBlockData::read().