[返回博客](/cn/blog) # IFC 模型操作

Roman Chizhdenko 八月 18, 2023 [\#ifc](/cn/blog/tag/ifc) [\#getting started](/cn/blog/tag/getting-started)

<a class="a2a_button_facebook"></a><a class="a2a_button_twitter"></a><a class="a2a_button_linkedin"></a>

IfcCore 模块中的 IfcModelOps (IFC 模型操作) API 提供了一组函数和类，允许您删除 IfcProduct 表示子树，在模型内部以及从一个模型到另一个模型克隆 IfcProduct 子树（根据组合关系包含嵌套项），以及合并模型。

为了支持在通用对象（IfcBuidling/IfcStorey/等）中进行模型内容处理期间的通用操作，请使用 IfcModelOpsFiller 辅助类中的方法。其中许多方法提供了所需创建项的结构：prepareModel、createBuildingStorey、addRelAggregates、addRelContainedInSpatialStructure 等。

#### 合并模型

IfcModelOps 支持基于以下功能的联合模型：

```

OdDAIObjectId OdIfc։։ModelOps::ifcCombineModels(const OdDAI::ModelPtr sourceModel, const OdDAI::ModelPtr targetModel, MergeLevel level = MergeLevel::Building); 
OdIfc::ModelOps::IfcModelProcessor::ifcCombineWith(const OdDAI::ModelPtr sourceModel, OdIfc::ModelOps::MergeLevel level);
```

例如，将两个或更多 IfcBuilding 实例附加到现有 IFC 模型或文件的 IfcSite 下：

```

wchar_t* fileNames[] = {
  L"C:/path/to/source_1.ifc",
  L"C:/path/to/source_2.ifc",
  L"C:/path/to/combined_model.ifc"
  };

  OdStaticRxObject< OdIfcHostAppServices > svcs;
  OdIfcFilePtr pIfcFile = svcs.createDatabase(kScmUndefined);

  OdResult res = pIfcFile->readFile(fileNames[0]);

  if (res != eOk)
  {
    return;
  }


  OdIfcModelPtr pSrcModel = pIfcFile->getModel();

  if (pSrcModel.isNull())
  {
    odPrintConsoleString(L"Error getting model: %s\n", fileNames[0]);
  }

  OdIfcFilePtr pIfcFile2 = svcs.createDatabase(kScmUndefined);
  res = pIfcFile2->readFile(fileNames[1]);
  if (res != eOk)
  {
    return;
  }

  // access mode is RW
  OdIfcModelPtr pTargetModel = pIfcFile2->getModel(sdaiRW);

  if (pTargetModel.isNull())
  {
    odPrintConsoleString(L"Error getting model: %s\n", fileNames[1]);
  }

  OdIfc::ModelOps::IfcModelProcessor modelProcessor(pTargetModel);

  odPrintConsoleString(L"\nMerging from %ls to %ls...\n", OdString(sourceFile).c_str(), OdString(m_ifcDestFile).c_str());

  OdDAIObjectId clonedItem = modelProcessor.ifcCombineWith(pSourceModel, OdIfc::ModelOps::MergeLevel::Site);

  OdString pathToSave = fileNames[2];

  if (pIfcFile2->writeFile(pathToSave) == eOk)
  {
    odPrintConsoleString(L"Combined model items have been written to file %ls\n", pathToSave.c_str());
  }
```

更复杂的模型合并位于 ExIfcTutorials 示例模块的教程 14 中。该教程生成的文件包含从多个源文件合并到目标模型（与目标文件关联）的站点级别下的所有数据。此外，OdIfc::ModelOps::IfcModelProcessor 支持通过指定目标模型单位中的目标偏移量和适当的比例来更改附加项的位置：

```


OdGePoint3d targetOffset = OdGePoint3d(10.0, 20.0, 30.0);
modelProcessor.setTargetOffset(targetOffset);
```

ModelOps 命名空间方法的一个重要特性是支持具有各种长度和面积单位的模型，以及将几何表示自动转换为基于目标模型的通用单位。这些函数在将多个模型合并为一个模型时，或者将一个项目从一个模型克隆到另一个模型时，提供单位转换等功能。

#### 追加新内容

您可以处理层次结构中较低级别的对象，例如 IfcBuildingElement、IfcBuildingElementProxy 等。您可以将一个项目从源模型克隆到另一个具有必要目标对象的模型。以下是 IfcModelOpsFiller 和 IfcModelProcessor 的一些有用方法：

```

OdDAIObjectId IfcModelProcessor::ifcCloneTo(const OdDAIObjectId& sourceProduct, const OdDAIObjectId& targetProduct);
OdDAIObjectId IfcModelProcessor::cloneContainedInRelAggregate(const OdDAIObjectId& sourceProduct, const OdDAIObjectId& target);

OdDAIObjectId IfcModelProcessor::cloneContainedInSpatialStructure(const OdDAIObjectId& sourceProduct, const OdDAIObjectId& target);
OdIfc::OdIfcInstancePtr IfcModelOpsFiller::createBuildingStorey(const OdString& name,
  const OdAnsiString& compositionType,  const OdDAIObjectId localPlacementId);

OdIfc::OdIfcInstancePtr OdIfcModelFiller::addRelAggregates(OdIfc::OdIfcInstancePtr pRelating, OdIfc::OdIfcInstancePtr pRelated);
OdIfc::OdIfcInstancePtr OdIfcModelFiller::addRelContainedInSpatialStructure(OdIfc::OdIfcInstancePtr pRelating, OdIfc::OdIfcInstancePtr pRelated);
```

例如，您可以将具有已知 OdDbHandle 的 IfcProduct 克隆到现有模型中的新 IfcBuildingStorey 项目，并将其保存为新内容：

![IFC Model](/files/inline-images/IFC%20Model.png)```

wchar_t* fileNames[] = {
L"C:/path/to/source.ifc",
L"C:/path/to/target.ifc",
};

OdStaticRxObject< OdIfcHostAppServices > svcs;
OdIfcFilePtr pIfcFile = svcs.createDatabase(kScmUndefined);

OdResult res = pIfcFile->readFile(fileNames[0]);

if (res != eOk)
{
return;
}

OdIfcModelPtr pSrcModel = pIfcFile->getModel();

if (pSrcModel.isNull())
{
odPrintConsoleString(L"Error getting model: %s\n", fileNames[0]);
return;
}

OdIfcFilePtr pIfcFile2 = svcs.createDatabase(kScmUndefined);
res = pIfcFile2->readFile(fileNames[1]);
if (res != eOk)
{
return;
}

OdIfcModelPtr pTargetModel = pIfcFile2->getModel(sdaiRW);

if (pTargetModel.isNull())
{
odPrintConsoleString(L"Error getting model: %s\n", fileNames[1]);
return;
}

std::unique_ptr<IfcModelOpsFiller> modelFiller = std::unique_ptr<IfcModelOpsFiller>(new IfcModelOpsFiller(static_cast<OdIfcModelPtr>(pTargetModel)));

OdDbHandle sourceInstance = OdDbHandle(SOURCE_ID);
auto clonableEntity = pSrcModel->getEntityInstance(sourceInstance);

OdIfc::OdIfcEntityPtr pClonableEntInstance = clonableEntity.openObject();
if (pClonableEntInstance.isNull())
{
odPrintConsoleString(L"\nSource model doesn't contain entity with specified Id\n");
return;
}

OdDAIObjectId targetEntity = OdDAIObjectId::kNull;
auto targetEntityPresent = false;
auto buildingPresent = true;

OdDAIObjectId buildingId = OdDAIObjectId::kNull;
```

以下代码检测现有模型中克隆项目标实体的存在，如果未找到，则使用 IfcModelFiller 的方法动态创建所有所需内容：

```

if (pTargetModel->getEntityExtent("ifcbuildingstorey")->getMemberCount())
{
targetEntity = pTargetModel->getEntityExtent("ifcbuildingstorey")->getArray()[0];
targetEntityPresent = true;
}

// we need existing ifcownerhistory to create other objects
if (targetEntityPresent)
{
OdDAIObjectId history;
targetEntity.openObject()->getAttr("ownerhistory") >> history;

modelFiller->setOwnerHistory(history.openObject());
}
// create minimal amount of model items from the plate
else
{
modelFiller->prepareModel(pIfcFile2);
buildingPresent = false;
}
```

使用 IfcModelFiller 的方法，以下代码将附加 IfcBuildingStorey 类型的相应实体，这些实体将影响克隆操作的目标元素：

```

OdIfc::OdIfcInstancePtr storey = OdIfc::OdIfcInstancePtr();
if (targetEntityPresent)
{
OdDAIObjectId location = OdDAIObjectId::kNull;

if (pTargetModel->getEntityExtent("ifcbuilding")->getMemberCount())
{
buildingId = pTargetModel->getEntityExtent("ifcbuilding")->getArray()[0];

if (buildingId.openObject()->getAttr("objectplacement") >> location)
{
storey = modelFiller->createBuildingStorey("New Storey", "ELEMENT", location);
}
}

}
else //previously self created building without storeys
{
storey = modelFiller->createBuildingStorey("New Storey", "ELEMENT", modelFiller->getBuildingPlacement());
}
```

要根据适当的模式构建 IfcRelDecompose|IfcRelAggregates 等 IFC 关系，请使用以下 IfcModelFiller 方法：

```

if (!storey.isNull())
{
if (!buildingPresent)
{
OdIfc::OdIfcEntityPtr pRelAggrStorey = modelFiller->addRelAggregates(modelFiller->getBuilding().openObject(), storey);
}
else
{
OdIfc::OdIfcEntityPtr pRelAggrStorey = modelFiller->addRelAggregates(buildingId.openObject(), storey);
}
}
```

最重要的是使用 IfcModelProcessor 方法来指定位置并调用克隆操作：

```

OdIfc::ModelOps::IfcModelProcessor modelProcessor(pTargetModel);

modelProcessor.setTargetLocation(OdGePoint3d(0.0, 0.0, 0.0));
OdDAIObjectId clonedItem = modelProcessor.ifcCloneTo(clonableEntity, storey->id());
OdDAI::ApplicationInstancePtr clonedObject = clonedItem.openObject();

if (!clonedItem.isNull())
{
if (clonableEntity.openObject()->isKindOf("ifcbuildingelement"))
{
OdIfc::OdIfcEntityPtr pRelSpatial = modelFiller->addRelContainedInSpatialStructure(storey, clonedObject);
}
else
{
OdIfc::OdIfcEntityPtr pRelAggr = modelFiller->addRelAggregates(storey, clonedObject);
}
}

OdString pathToSave = fileNames[2];

if (pIfcFile2->writeFile(pathToSave) == eOk)
{
odPrintConsoleString(L"Combined model items have been written to file %ls\n", pathToSave.c_str());
}
```

ExIfcTutorials 示例模块的教程 13 中提供了 IfcBuildingElement 源顺序处理的更高级示例。该教程生成的文件包含源实体的副本，这些副本随目标模型楼层的放置而分布。

#### 删除现有项目

删除功能作为 ModelOps 模块的一部分实现：

```

OdResult OdIfc::ModelOps::removeFromSpatialStructure(const OdDAIObjectId& productToRemove);
OdResult OdIfc::ModelOps::removeFromRelAggregates(const OdDAIObjectId& productToRemove);
```

最常见的情况由以下方法提供：

```

OdResult OdIfc::ModelOps::removeRepresentationFrom(const OdDAIObjectId& productToRemove);
```

例如，要减少模型中的楼层数量，请使用 removeRepresentationFrom 或 removeFromRelAggregates 方法删除它们。源模型包含下一个几何表示：

![IFC model remove storeys](/files/inline-images/IFC%20Model%20removed%20storey.png)要从模型中删除具有已知 ID 的 IfcBuilding 楼层，您可以使用以下代码片段：

```

wchar_t *fileNames[] = {
L"C:/path/to/source.ifc",
L"C:/path/to/target.ifc",
};

odPrintConsoleString(OD_T("Open file %ls\n"), fileNames[0]);
OdIfcFilePtr pIfcFile = pHostApp->readFile(fileNames[0]);  

OdIfcModelPtr pModel = pIfcFile->getModel(sdaiRW);

if (pModel.isNull())
{
odPrintConsoleString(L"Error getting source model\n");
return;
}

OdDbHandle itemToRemove = 60; // IfcBuildingStorey ID  

auto remEnt = pModel->getEntityInstance(itemToRemove);
if (remEnt.isNull())
{
odPrintConsoleString(L"Error getting source entity\n");
return;
}

OdIfc::OdIfcInstancePtr pRemEntInstance = remEnt.openObject();
if (!pRemEntInstance.isNull())
{
OdAnsiString typeName = pRemEntInstance->typeName();
if ((typeName == OdAnsiString("ifcbuildingstorey")))
{
OdIfc::ModelOps::removeFromRelAggregates(remEnt);
auto pathToWrite = fileNames[1];
if (pIfcFile->writeFile(pathToWrite) == eOk)
{
odPrintConsoleString(L"\nModified model has been written to file %ls\n", pathToWrite.c_str());
}
}  
}
```

![ifc model result](/files/inline-images/IFC%20Model%20Result.png)ExIfcTutorials 示例模块的教程 12 中提供了一个使用克隆和删除操作在模型中复制 IfcBuilding 楼层的示例。本教程中的代码将指定的非顶部 IfcBuildingStorey 克隆 N 次，并带有垂直偏移，然后将上层楼层移动到新建筑物顶部的另一个 IfcBuildingStorey。然后将包含更新模型的内容写入输出文件。结果如下：

![IFC Model storeys](/files/inline-images/IFC%20Model%20storeys.png)

 

  



 ## 今天就开始行动

  **免费试用 ODA 软件 60 天。  
无风险，无需信用卡。**

 [ 免费试用    ](https://staging.opendesign.com/cn/free-trial)