ansys::CffProvider Class Reference

To read the nodes (vertices) for a specific face, specified face range or all faces within a face zone the following group of functions must be called. In this example the code is reading the nodes for all faces for the first zone that contains faces with nodes.

// Create the provider
ansys::CffProvider* provider = ...;
provider->startReading(ansys::DataClass::CFF_CASE);
// Obtain the zones containing vertices
ansys::ZoneIds faceZones;
provider->startReadingNodesForFaces(faceZones);
if (!faceZones.empty()) {
// Determine the size of the expected data from the zone size
ansys::ElemIdType sz = 0;
provider->getZoneSizeInfo(faceZones[0], CFF_ZONE_SIZE, sz);
// Start reading node counts
provider->startReadingNodeCountsForFaces();
short uniformNodeCount = 0;
// First check to see if all faces are defined by a uniform node count
bool isUniform =
provider->hasUniformNodeCountForFacesInZone(faceZones[0],
&uniformNodeCount);
size_t totalNodeCount = 0;
short* nodeCounts = nullptr;
if (isUniform) {
nodeCounts = &uniformNodeCount;
totalNodeCount = uniformNodeCount * sz;
} else {
// Allocate the memory to store a node count per face
nodeCounts = new short[sz];
provider->getNodeCountsForFacesInZone(faceZones[0], nodeCounts, sz);
totalNodeCount = std::accumulate(nodeCounts, nodeCounts+sz, 0);
}
// Finish reading node counts
provider->endReadingNodeCountsForFaces();
// Start reading nodes
provider->startReadingNodeIdsForFaces();
// Allocate memory for the nodes themselves using total node count
ansys::ElemIdType* nodes = new ansys::ElemIdType[totalNodeCount];
provider->getNodeIdsForFacesInZone(faceZones[0], nodes, totalNodeCount);
// Process face nodes read
// End reading node ids
provider->endReadingNodeIdsForFaces();
// End reading nodes
provider->endReadingNodesForFaces();
// End reading case
provider->endReading(ansys::DataClass::CFF_CASE);

Any given mesh face in a model will have either one or two cell parents. The cell on the first side is termed c0, the cell on the other side is termed c1. In general c0 will always exist but c1 may not.

The consistency of the node indices' order must be handled by the CFF consumer application. The standard order is the right-hand rule: if you curl the fingers of your right hand in the order of the nodes, your thumb will point toward c1. Note that Fluent and Fluent Meshing written CFF case files use the face-node reversed right-hand rule: if you curl the fingers of your right hand in the order of the nodes, your thumb will point toward c0.

In order to read the cell parents for a specific face, specified face range or all faces in a face zone the following group of functions must be called. In this example the code is reading the cells on side 0 (c0) for all faces for the first zone that contains faces with c0 data.

// Create the provider
ansys::CffProvider* provider = ...;
provider->startReading(ansys::DataClass::CFF_CASE);
// Obtain the zones containing c0 parent cells
ansys::ZoneIds faceZones;
provider->startReadingCell0sForFaces(faceZones);
if (!faceZones.empty()) {
// Determine the size of the expected data from the zone size
ansys::ElemIdType sz = 0;
provider->getZoneSizeInfo(faceZones[0], CFF_ZONE_SIZE, sz);
// Allocate the memory to store a cell 0 per face in the zone.
ansys::ElemIdType* parents = new ansys::ElemIdType[sz];
provider->getCell0sFacesInZone(faceZones[0], parents, sz);
// Process face parents read
// End reading cell0s
provider->endReadingCell0ssForFaces();
// End reading case
provider->endReading(ansys::DataClass::CFF_CASE);

To read the type for a specific cell, specified cell range or all cells within a cell zone the following group of functions must be called. In this example the code is reading all the nodes for the first zone that contains cell types;

// Create the provider
ansys::CffProvider provider = ...;
provider->startReading(ansys::DataClass::CFF_CASE);
// Obtain the zones containing types
ansys::ZoneIds cellZones;
provider->startReadingTypesForCells(cellZones);
if (!cellZones.empty()) {
// Determine the size of the expected data from the zone size
ansys::ElemIdType sz = 0;
provider->getZoneSizeInfo(nodeZones[0], CFF_ZONE_SIZE, sz);
// Start reading cell types - may be uniform or inndividual
ansys::CellType uniformCellType;
// First check to see if all cells have the same uniform type
bool isUniform =
provider->hasUniformTypesForCellsInZone(cellZones[0], &uniformCellType);
if (!isUniform) {
// Allocate the memory to store a node count per face
ansys::CellType* types = new ansys::CellType[sz];
provider->getNodeCountsForFacesInZone(cellZones[0], types, sz);
}
}
// Finish reading cell types
provider->endReadingTypesForCells();
}
// Finish reading the case data
provider->endReading(ansys::DataClass::CFF_CASE);

Note

Cell/Node meshes only

To read the nodes (vertices) for a specific cell, specified cell range or all cells within a cell zone the following group of functions must be called. In this example the code is reading the nodes for all cells for the first zone that contains cells with nodes.

// Create the provider
ansys::CffProvider provider = ...;
provider->startReading(ansys::DataClass::CFF_CASE);
// Obtain the zones containing nodes
ansys::ZoneIds cellZones;
provider->startReadingNodesForCells(CellZones);
if (!cellZones.empty()) {
// Determine the size of the expected data from the zone size
ansys::ElemIdType sz = 0;
provider->getZoneSizeInfo(cellZones[0], CFF_ZONE_SIZE, sz);
// Start reading node counts
provider->startReadingNodeCountsForCells();
short uniformNodeCount = 0;
// First check to see if all Cells are defined by a uniform node count
bool isUniform =
provider->hasUniformNodeCountForCellsInZone(cellZones[0],
&uniformNodeCount);
size_t totalNodeCount = 0;
short* nodeCounts = nullptr;
if (isUniform) {
nodeCounts = &uniformNodeCount;
totalNodeCount = uniformNodeCount * sz;
} else {
// Allocate the memory to store a node count per cell
nodeCounts = new short[sz];
provider->getNodeCountsForCellsInZone(cellZones[0], nodeCounts, sz);
totalNodeCount = std::accumulate(nodeCounts, nodeCounts+sz, 0);
}
// Finish reading node counts
provider->endReadingNodeCountsForCells();
// Start reading nodes
provider->startReadingNodeIdsForCells();
// Allocate memory for the nodes themselves using total node count
ansys::ElemIdType* nodes = new ansys::ElemIdType[totalNodeCount];
provider->getNodeIdsForCellsInZone(cellZones[0], nodes, totalNodeCount);
// Process Cell nodes read
// End reading node ids
provider->endReadingNodeIdsForCells();
// End reading nodes
provider->endReadingNodesForCells();
// End reading case
provider->endReading(ansys::DataClass::CFF_CASE);

Note

These functions should only be used for accessing the faces of Polyhedral Cells in a CFF Post Data Model