Revit API では、コンセプト デザイン モデルでのエネルギー解析を実行するために、Revit で作成した要素とオブジェクトにアクセスできます。次のクラスを使用するとこのデータで作業ができるようになります。
これらのクラス以外にも、MassGBXMLExportOptions パラメータを使用する Document.Export()オーバーロードもあります。この場合、コンセプト エネルギー解析要素(マス要素)のみを含む gBXML ファイルを書き出します。
コンセプト エネルギー解析に関連付けられるメイン クラスは MassEnergyAnalyticalModel です。このクラスはマス インスタンスをエネルギー解析モデル データとジオメトリに関連付けます。ジオメトリは最初、関連付けられているマス インスタンス ジオメトリのコピーですが、エネルギー解析モデルの要件に応じて修正されます。静的メソッド MassEnergyAnalyticalModel。GetMassEnergyAnalyticalModelIdForMassInstance()は特定のマス インスタンスの MassEnergyAnalyticalModel の ElementId を返します。
MassLevelData は、特定のレベルを Revit プロジェクトの特定のマス要素に関連付けることによって定義します。これは、MassInstanceUtils.AddMassLevelDataToMassInstance()メソッドを使用して行います。MassLevelData はコンセプト スペース計画に関連する、床面積などの基準を報告します。MassLevelData には、コンセプト エネルギー解析モデルの一部として使用される ConceptualConstructionType などの情報が含まれます。MassLevel データ ジオメトリは、マスのすべてのジオメトリを組み合わせて単一のジオメトリにし、MassLevelData のレベルを使用して交差の面積を取得することで決定されます。
MassZones は MassEnergyAnalyticalModel を細かく分割することにより作成されます。このためにはFamilyInstance に関連付けられている MassLevelDatas を、同じ Mass FamilyInstance に関連付けられている MassEnergyAnalyticalModel のジオメトリで交差させることが必要になります。MassEnergyAnalyticalModel に関連付けられている MassZones の ElementIds は GetMassZoneIds()メソッドを使用して取得できます。
MassEnergyAnalyticalModel からは、それに関連するすべての面に対する参照を取得できます。これらの参照を使用することで、GetMassSurfaceDataIdForReference()メソッドを使い互いに関連付けられている MassSurfaceData を取得できます。MassSurfaceData は、マテリアル値、敷居の高さなどの自動生成要素の寸法、天窓の幅といった MassEnergyAnalyticalModel 要素のプロパティや面に関するその他の値を保持します。
また、MassSurfaceData は、参照サーフェスに関連付けられている ConceptualConstructionType の ID も保持しています。ConceptualConstructionType は、コンセプト物理、建設、エネルギー プロパティを、Revit BIM モデルと Green Building Studio/Green Building XML の両方で解釈できる方法で表します。このクラスには、特定のドキュメント内の建築のさまざまなアスペクト(壁や窓など)の ConceptualConstructionType の ElementId を取得するための静的メソッドが多数用意されています。
MassSurfaceData には CategoryIdForConceptualSurfaceType という別のプロパティがあり、ConceptualSurfaceType に使用するマス サブカテゴリ ElementId を提供します。ConceptualSurfaceType は、マス ジオメトリの面に割り当てるコンセプト BIM オブジェクト カテゴリを表します。各マス サーフェス サブカテゴリには、ConceptualSurfaceType 要素が 1 つあります。静的メソッド ConceptualSurfaceType.GetByMassSubCategoryId()を使用すると、MassSurfaceData の ConceptualSurfaceType をマス サブカテゴリ ID から取得できます。
Revit プロジェクトでコンセプト エネルギー解析が有効になっていると、ConceptualSurfaceType が関連付けられているマス カテゴリのサブカテゴリにマス面が割り当てられます。既定の ConceptualConstructionType は ConceptualSurfaceType に関連付けられます。この既定の ConceptualConstructionType は、対応するサブカテゴリを持つマス面に割り当てられます。ConceptualSurfaceType に関連付けられている既定の ConceptualConstructionType を変更すると、ユーザが特別に優先設定値を設定していない、該当のサブカテゴリのすべてのマス面の ConceptualConstruction タイプが更新されます。
MassInstancesUtils ユーティリティ クラスには、マス インスタンスに関する情報(マス インスタンスで表される使用可能床の総面積や建築の総体積など)を取得する静的メソッドや、上記のマス インスタンスにレベルを関連付けるために MassLevelData (マス床)を作成する静的メソッドが用意されています。