在分析建模的上下文中探索新开发的 API。
此项目是 Revit 更广泛的“分析驱动建模”计划的一部分，该计划引入了一种创新的分析建模方法，从而增强其整体结构建模功能。分析模型是 BIM 数据的重要组成部分，并且受制于工程团队内和跨项目团队的协作工作流；因此，Revit 的一组新功能和行为将使工程师能够执行以下操作：
- 可以自由地进行分析建模，以反映他们对结构图元和建筑/结构（视为整个系统）的各个设计决策。
- 通过分析方式表示任何类型的结构。
- 创建一致的分析模型，以支持从 Revit 模型进行结构分析作业。
- 使用分析软件执行完整的双向工作流，然后捕获在其中所做的模型修改。
- 如果需要，可以保护分析模型以免发生意外更改。
- 创建反映不同分析类型和配置的多个分析模型。
- 复制简化了分析建模（如同使用专用结构分析软件），结合了支持 BIM 平台的参数化和协作功能。
使用新 API 的 Revit 图元
新 API 类
AnalyticalElement - 表示所有分析对象的基类。它替换了 AnaltyicalModel。
-
Transform GetTransform () - Returns the transform which reflects Analytical Element orientation.
-
AnalyzeAs AnalyzeAs - This represents the Analyze As parameter assigned to Analytical Element.
-
Reference GetReference (AnalyticalModelSelector selector) - Returns a reference to a given curve within the Analytical Element.
-
ElementId MaterialId - Defines the Material Id for the Analytical Element.
AnalyticalMember - 表示结构分析模型中的线性图元。它替换了 AnalyticalModelStick 和 AnalyticalModelColumn。
-
AnalyticalMember Create(Document aDoc,Curve curve) - Method which creates a new instance of an Analytical Member within the project.
-
AnalyticalStructuralRole StructuralRole - The structural role assigned to the Analytical Member.
-
Curve GetCurve () - Returns the curve of the Analytical Member.
-
void SetCurve(Curve curve) - Sets the curve for the Analytical Member. This method disconnects elements from other analytical elements (if the end nodes are in the same position).
If the user wants to move the corner, and keep the connection, there are other ways for achieving that such as ElementTransformUtils.moveElements.
-
bool IsValidCurve(Curve curve) - Verifies if the curve is valid for an Analytical Member.
-
void FlipCurve() - Flips the ends of the Analytical Member.
-
StructuralSectionShape StructuralSectionShape - The structural section shape of the Analytical Member (read only).
-
ElementId SectionType - The id of the type from the structural family assigned to the Analytical Member.
-
double CrossSectionRotation - Cross-section rotation of the Analytical Member.
AnalyticalPanel - 表示结构分析模型中的表面。它替换了 AnalyticalModelSurface。
-
AnalyticalPanel Create(Document aDoc, CurveLoop curveLoop) - Method which creates a new instance of an Analytical Panel within the project.
-
CurveLoop GetOuterContour() - Returns the Curve Loop that defines the geometry of the Analytical Surface element.
-
bool IsCurveLoopValid(CurveLoop profile) - Checks if curve loop is valid for Analytical Panel.
- 要修改分析面板几何图形，用户应使用 SketchEditScope 框架。这已通过新方法得到增强：
-
void StartWithNewSketch(ElementId elementId) - Starts a sketch edit mode for an element which, at this moment, doesn't have a sketch.
-
- 编辑几何图形的另一种方法是：
-
void SetOuterContour(CurveLoop outerContour) - Sets the Curve Loop that defines the geometry of the Analytical Surface element.
-
与 AnalyticalMember 类似，设置分析面板的等高线将断开与其他分析图元的连接。如果用户要移动角点并保持连接，还有其他方法可以实现此目的，如 ElementTransformUtils.moveElements。
-
- 要修改分析面板几何图形，用户应使用 SketchEditScope 框架。这已通过新方法得到增强：
-
ISet<ElementId> GetAnalyticalOpeningsIds() - Returns the Analytical Openings Ids of the Analytical Panel.
-
ElementId SketchId - Sketch associated to this Revit element.
-
AnalyticalStructuralRole StructuralRole - Structural role assigned to the Analytical Panel.
AnalyticalOpening - 表示“分析面板”中洞口的图元。这是一个 Revit API 中的新对象（在此版本之前，没有用于分析洞口的单独图元）。
-
AnalyticalOpening Create(Document doc, CurveLoop curveLoop, ElementId panelId) - Method which creates a new instance of an Analytical Opening within the project.
-
CurveLoop GetOuterContour () - Returns the Curve Loop that defines the geometry of the Analytical Surface element.
-
bool IsCurveLoopValidForAnalyticalOpening(CurveLoop loop, Document aDoc, ElementId panelId) - Checks if curve loop is valid for Analytical Opening.
- 要修改分析洞口几何图形，请使用 SketchEditScope 框架。
- 修改分析洞口几何图形的另一种方法是：
-
void SetOuterContour(CurveLoop outerContour) - Sets the Curve Loop that defines the geometry of the Analytical Surface element.
-
-
ElementId PanelId - ElementId of the host Analytical Panel.
-
ElementId SketchId - Sketch associated to this Revit element.
AnalyticalToPhysicalAssociationManager - 管理分析图元和物理图元之间的关联。以前，各图元本身彼此了解，用户无法控制它们（无法修改关联）。使用这种新方法，可以编辑关联。支持 1-1 关联，图元不能同时属于多个关联。
-
AnalyticalToPhysicalAssociationManager GetAnalyticalToPhysicalAssociationManager(Document doc) Returns the AnalyticalToPhysicalAssociationManager for this document.
-
void AddAssociation(ElementId analyticalElementId, ElementId physicalElementId) - Adds a new association between an analytical element and a physical element.
-
void RemoveAssociation(ElementId elementId) - This method will remove the association for the element with the given ElementId.
-
ElementId GetAssociatedElementId (ElementId elementId) - Returns id of the element which is associated with the given ElementId.
-
bool HasAssociation(ElementId id) - Verifies if the element has already defined an association.
AnalyticalNodeData - 包含有关分析节点的连接状态的信息。
-
AnalyticalNodeData GetAnalyticalNodeData ( Element element) - Returns AnalyticalNodeData associated with this element, if it exists.
-
AnalyticalNodeConnectionStatus GetConnectionStatus () - Returns the Connections Status for an Analytical Node.
AnalyticalLinks、BoundaryConditions 和 Loads 已移植为使用新图元。在大多数情况下，与它们相关的 API 保持不变。对 Loads 做了一些增强。
荷载
-
LineLoad.Create(Document aDoc,ElementId hostElemId, XYZ forceVector1, XYZmomentVector1, LineLoadType symbol).
-
LineLoad.Create(Document aDoc,ElementId hostElemId, int curveIndex, XYZ forceVector1, XYZ momentVector1, Structure.LineLoadType symbol).
-
LineLoad.IsValidHostId(Document doc, ElementId hostElemId).
-
AreaLoad.IsValidHostId(Document doc, ElementId hostElemId).
-
AreaLoad.Create(Document doc, ElementId hostElemId, XYZ forceVector1, AreaLoadType symbol).
-
PointLoad.Create(Document doc, ElementId hostElemId, AnalyticalElementSelector selector, XYZ forceVector, XYZ momentVector, AreaLoadTyp symbol).
-
PointLoad.IsValidHostId(Document doc, ElementId hostElemId).
样例
创建 AnalyticalMember
using (Transaction transaction = new Transaction(document, "Create Analytical Member"))
{
transaction.Start();
//create curve which will be assigned to the analytical member
Line line = Line.CreateBound(new XYZ(0, 0, 0), new XYZ(5, 0, 0));
//create the AnalyticalMember
AnalyticalMember analyticalMember = AnalyticalMember.Create(document, line);
analyticalMember.StructuralRole = AnalyticalStructuralRole.StructuralRoleBeam;
transaction.Commit();
}
创建分析面板
using (Transaction transaction = new Transaction(revitDoc, "Create Analytical Panel"))
{
transaction.Start();
//create the curveLoop for the AnalyticalPanel element
CurveLoop profileloop = new CurveLoop();
profileloop.Append(Line.CreateBound(new XYZ(1, 1, 0), new XYZ(2, 1, 0)));
profileloop.Append(Line.CreateBound(new XYZ(2, 1, 0), new XYZ(2, 2, 0)));
profileloop.Append(Line.CreateBound(new XYZ(2, 2, 0), new XYZ(1, 2, 0)));
profileloop.Append(Line.CreateBound(new XYZ(1, 2, 0), new XYZ(1, 1, 0)));
//create the AnalyticalPanel
analyticalPanel = AnalyticalPanel .Create(revitDoc, profileloop);
transaction.Commit();
}
在物理图元与分析图元之间添加新关联
using (Transaction trans = new Transaction(doc, "AddAssociationBetweenPhysicalAndAnalyticalElements"))
{
trans.Start();
ElementId analyticalElementId = ContextualAnalyticalModel.Utilities.GetSelectedObject(activeDoc, "Please select analytical element");
ElementId physicalElementId = ContextualAnalyticalModel.Utilities.GetSelectedObject(activeDoc, "Please select physical element");
//gets the AnalyticalToPhysicalAssociationManager for the current document
AnalyticalToPhysicalAssociationManager analyticalToPhysicalManager = AnalyticalToPhysicalAssociationManager.GetAnalyticalToPhysicalAssociationManager(doc);
if (analyticalToPhysicalManager == null)
return Result.Failed;
//creates a new association between physical and analytical elements
analyticalToPhysicalManager.AddAssociation(analyticalElementId, physicalElementId);
trans.Commit();
}
使用 SketchEditScope 框架编辑分析面板的边界
// Start a sketch edit scope
SketchEditScope sketchEditScope = new SketchEditScope(document, "Replace line with an arc");
sketchEditScope.StartWithNewSketch(analyticalPanel.Id);
using (Transaction transaction = new Transaction(document, "Modify sketch"))
{
transaction.Start();
//replace a boundary line with an arc
Line line = null;
Sketch sketch = document.GetElement(analyticalPanel.SketchId) as Sketch;
if (sketch != null)
{
//find first line in the sketch profile
…..
}
// Create arc
XYZ normal = line.Direction.CrossProduct(XYZ.BasisZ).Normalize().Negate();
XYZ middle = line.GetEndPoint(0).Add(line.Direction.Multiply(line.Length / 2));
Curve arc = Arc.Create(line.GetEndPoint(0), line.GetEndPoint(1), middle.Add(normal.Multiply(20)));
// Remove element referenced by the found line.
document.Delete(line.Reference.ElementId);
// Model curve creation automatically puts the curve into the sketch, if sketch edit scope is running.
document.Create.NewModelCurve(arc, sketch.SketchPlane);
transaction.Commit();
}
sketchEditScope.Commit(new FailurePreproccessor());
移动分析节点并保持连接
// Create Analytical Panel
AnalyticalPanel analyticalPanel = CreateAnalyticalPanel.CreateAMPanel(document);
// Create the connected Analytical Member
AnalyticalMember analyticalMember = CreateAnalyticalMember.CreateMember(document);
// Select the node
Reference eRef = activeDoc.Selection.PickObject(ObjectType.PointOnElement , "Select an Analytical Node");
// Move the Analytical Node using ElementTransformUtils
using (Transaction transaction = new Transaction(document, "Move node with ElementTransformUtils"))
{
transaction.Start();
ElementTransformUtils.MoveElement(document, eRef.ElementId, new XYZ(-5, -5, 0));
transaction.Commit();
}
获取分析表面等高线点
使用上一个解决方案：
private List<XYZ> GetSurfaceContourPoints( Document doc, ElementId elementId )
{
// Create point list, get list of curves from analytical model
List<XYZ> contourPoints = new List<XYZ>();
AnalyticalModel analyticalModel = (doc.GetElement(elementId) as AnalyticalModel);
IList<Curve> curves = analyticalModel.GetCurves(AnalyticalCurveType.RawCurves);
// Iterate over curves and make the desired processing
…...
return contourPoints;
}
使用新解决方案：
private List<XYZ> GetSurfaceContourPoints( Document doc, ElementId elementId )
{
// Create point list, get list of curves from analytical model
List<XYZ> contourPoints = new List<XYZ>();
AnalyticalPanel analyticalPanel = (doc.GetElement(elementId) as AnalyticalPanel);
CurveLoop outerContour = analyticalPanel.GetOuterContour();
// Iterate over curves and make the desired processing
…...
return contourPoints;
}
获取物理图元的关联分析图元
AnalyticalElement GetAnalyticalElement(Element physicalElement)
{
AnalyticalElement analyticalElement = null;
Document document = element.Document;
AnalyticalToPhysicalAssociationManager assocManager = AnalyticalToPhysicalAssociationManager.GetAnalyticalToPhysicalAssociationManager(document);
if (assocManager != null)
{
ElementId associatedElementId = assocManager.GetAssociatedElementId(physicalElement.Id);
if (associatedElementId != ElementId.InvalidElementId)
{
Element associatedElement = document.GetElement(associatedElementId);
if (associatedElement != null && associatedElement is AnalyticalElement)
{
analyticalElement = associatedElement as AnalyticalElement;
}
}
}
return analyticalElement;
}
创建线边界条件
使用上一个解决方案：
private BoundaryConditions CreateLineBC(Element hostElement)
{
Document createDoc = hostElement.Document.Create;
// use Document.NewLineBoundaryConditions Method
BoundaryConditions createdBC =
createDoc.NewLineBoundaryConditions(hostElement.GetAnalyticalModel(), 0, 0, 0, 0, 0, 0, 0, 0);
return createdBC;
}
使用新解决方案：
private BoundaryConditions CreateLineBC(Element hostElement)
{
Document createDoc = hostElement.Document.Create;
// use Document.NewLineBoundaryConditions Method
AnalyticalElement analyticalElement = GetAnalyticalElement(hostElement);
BoundaryConditions createdBC =
createDoc.NewLineBoundaryConditions(analyticalElement, 0, 0, 0, 0, 0, 0, 0, 0);
return createdBC;
}