/*---------------------------------------------------------------------------*\
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | www.openfoam.com
\\/ M anipulation |
-------------------------------------------------------------------------------
Copyright (C) 2011-2016 OpenFOAM Foundation
Copyright (C) 2016-2019 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
OpenFOAM is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
Class
Foam::topoSet
Description
General set of labels of mesh quantity (points, cells, faces).
SourceFiles
topoSet.C
topoSetTemplates.C
\*---------------------------------------------------------------------------*/
#ifndef topoSet_H
#define topoSet_H
#include "HashSet.H"
#include "regIOobject.H"
#include "labelList.H"
#include "typeInfo.H"
#include "autoPtr.H"
#include "pointField.H"
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
namespace Foam
{
// Forward Declarations
class mapPolyMesh;
class polyMesh;
class primitiveMesh;
class mapDistributePolyMesh;
/*---------------------------------------------------------------------------*\
Class topoSet Declaration
\*---------------------------------------------------------------------------*/
class topoSet
:
public regIOobject,
public labelHashSet
{
protected:
// Protected Member Functions
//- Update map from map.
// Used to update cell/face labels after morphing
virtual void updateLabels(const labelUList& map);
//- Check limits on addressable range.
virtual void check(const label maxSize);
//- Write part of contents nicely formatted. Prints labels only.
void writeDebug
(
Ostream& os,
const label maxElem,
topoSet::const_iterator& iter,
label& elemI
) const;
//- Write part of contents nicely formatted. Prints label
// and corresponding coordinate.
void writeDebug
(
Ostream& os,
const pointField& coords,
const label maxElem,
topoSet::const_iterator& iter,
label& elemI
) const;
//- Write labels and coordinates columnwise to os. Truncate to maxLen.
void writeDebug
(
Ostream& os,
const pointField& coords,
const label maxLen
) const;
//- No copy construct
topoSet(const topoSet&) = delete;
public:
//- Runtime type information
TypeName("topoSet");
// Static
//- Debug switch to disallow the use of generic sets
static int disallowGenericSets;
//- Name of file set will use.
static fileName localPath(const polyMesh& mesh, const word& name);
//- Find IOobject in the polyMesh/sets (used as constructor helper)
static IOobject findIOobject
(
const polyMesh& mesh,
const word& name,
readOption r=MUST_READ,
writeOption w=NO_WRITE
);
//- Find IOobject in the polyMesh/sets (used as constructor helper)
static IOobject findIOobject
(
const Time& runTime,
const word& name,
readOption r=MUST_READ,
writeOption w=NO_WRITE
);
// Declare run-time constructor selection table
// For the direct constructor
declareRunTimeSelectionTable
(
autoPtr,
topoSet,
word,
(
const polyMesh& mesh,
const word& name,
readOption r,
writeOption w
),
(mesh, name, r, w)
);
// For the constructor from size
declareRunTimeSelectionTable
(
autoPtr,
topoSet,
size,
(
const polyMesh& mesh,
const word& name,
const label size,
writeOption w
),
(mesh, name, size, w)
);
// For the constructor as copy
declareRunTimeSelectionTable
(
autoPtr,
topoSet,
set,
(
const polyMesh& mesh,
const word& name,
const topoSet& set,
writeOption w
),
(mesh, name, set, w)
);
// Constructors
//- Construct from IOobject as explicitly passed type.
// Can't use typeName info here since subclasses not yet instantiated
topoSet(const IOobject& obj, const word& wantedType);
//- Construct from polyMesh and name.
// Searches for a polyMesh/sets directory but not beyond the
// mesh.facesInstance().
topoSet
(
const polyMesh& mesh,
const word& wantedType,
const word& name,
readOption r=MUST_READ,
writeOption w=NO_WRITE
);
//- Construct empty from additional size of labelHashSet.
// Searches for a polyMesh/sets directory but not beyond the
// mesh.facesInstance().
topoSet
(
const polyMesh& mesh,
const word& name,
const label size,
writeOption w=NO_WRITE
);
//- Construct (no-read) with copy of labelHashSet
// Searches for a polyMesh/sets directory but not beyond the
// mesh.facesInstance().
topoSet
(
const polyMesh& mesh,
const word& name,
const labelHashSet& labels,
writeOption w=NO_WRITE
);
//- Construct (no-read) with moving labelHashSet
// Searches for a polyMesh/sets directory but not beyond the
// mesh.facesInstance().
topoSet
(
const polyMesh& mesh,
const word& name,
labelHashSet&& labels,
writeOption w=NO_WRITE
);
//- Construct (no-read) with copy of labels
// Searches for a polyMesh/sets directory but not beyond the
// mesh.facesInstance().
topoSet
(
const polyMesh& mesh,
const word& name,
const labelUList& labels,
writeOption w=NO_WRITE
);
//- Construct empty from IOobject and HashSet size.
topoSet(const IOobject& io, const label size);
//- Construct from IOobject and copy of labelHashSet.
topoSet(const IOobject& io, const labelHashSet& labels);
//- Construct from IOobject and move labelHashSet.
topoSet(const IOobject& io, labelHashSet&& labels);
//- Clone
autoPtr<topoSet> clone() const
{
NotImplemented;
return nullptr;
}
// Selectors
//- Return a pointer to a toposet read from file
static autoPtr<topoSet> New
(
const word& setType,
const polyMesh& mesh,
const word& name,
readOption r=MUST_READ,
writeOption w=NO_WRITE
);
//- Return a pointer to a new toposet of given size
static autoPtr<topoSet> New
(
const word& setType,
const polyMesh& mesh,
const word& name,
const label size,
writeOption w=NO_WRITE
);
//- Return a pointer to a new toposet as copy of another toposet
static autoPtr<topoSet> New
(
const word& setType,
const polyMesh& mesh,
const word& name,
const topoSet& set,
writeOption w=NO_WRITE
);
//- Destructor
virtual ~topoSet() = default;
// Member Functions
//- Has the given index?
virtual bool found(const label id) const;
//- Set an index
virtual bool set(const label id);
//- Unset an index
virtual bool unset(const label id);
//- Set multiple indices
virtual void set(const labelUList& labels);
//- Unset multiple indices
virtual void unset(const labelUList& labels);
//- Invert contents.
// Insert all members [0,maxLen) which were not in set.
virtual void invert(const label maxLen);
//- Subset contents. Only elements present in both sets remain.
virtual void subset(const topoSet& set);
//- Add elements present in set.
virtual void addSet(const topoSet& set);
//- Subtract elements present in set.
virtual void subtractSet(const topoSet& set);
//- Sync set across coupled patches.
virtual void sync(const polyMesh& mesh);
//- Write labels columnwise to os. Truncate to maxLen.
virtual void writeDebug(Ostream& os, const label maxLen) const;
//- Like above but also writes mesh related quantity
//- (usually coordinate).
virtual void writeDebug
(
Ostream& os,
const primitiveMesh&,
const label maxLen
) const = 0;
//- Write contents.
virtual bool writeData(Ostream&) const;
//- Update any stored data for new labels. Not implemented.
virtual void updateMesh(const mapPolyMesh& morphMap);
//- Update any stored data for mesh redistribution.
virtual void distribute(const mapDistributePolyMesh&) = 0;
//- Return max allowable index (+1). Not implemented.
virtual label maxSize(const polyMesh& mesh) const = 0;
//- Helper: call updateMesh on all sets in container (and
// updates instance)
template<class Container>
static void updateMesh
(
const fileName& instance,
const mapPolyMesh&,
Container&
);
//- Helper: set instance on all sets in container
template<class Container>
static void setInstance(const fileName& instance, Container&);
//- Helper: remove all sets files from mesh instance
static void removeFiles(const polyMesh&);
// Member Operators
//- Copy labelHashSet part only
void operator=(const topoSet&);
// Housekeeping
//- Deprecated(2018-10) subtract elements present in set.
// \deprecated(2018-10) - use subtractSet instead
virtual void deleteSet(const topoSet& set);
};
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
} // End namespace Foam
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
#ifdef NoRepository
#include "topoSetTemplates.C"
#endif
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
#endif
// ************************************************************************* //