Explore la API recién desarrollada en el contexto del modelado analítico.
Este proyecto forma parte de una iniciativa más amplia de modelado basado en análisis para Revit que introduce un enfoque innovador del modelado analítico, lo que mejora sus funciones generales de modelado estructural. El modelo analítico es una parte esencial de los datos de BIM y está sujeto a flujos de trabajo de colaboración en equipos de ingeniería y entre equipos de proyecto, por lo que Revit, con el nuevo conjunto de funciones y comportamientos, permitirá a los ingenieros realizar lo siguiente:
- Disfrute de la libertad de modelado analítico para reflejar sus decisiones de diseño individuales con respecto a elementos estructurales y edificios/estructuras vistos como sistemas completos.
- Representan analíticamente cualquier tipo de estructura.
- Cree modelos analíticos coherentes que permitan realizar tareas de análisis estructural a partir de modelos de Revit.
- Realice flujos de trabajo bidireccionales completos con software de análisis y capture las modificaciones realizadas en el modelo.
- Si es necesario, impida que se realicen cambios inesperados en el modelo analítico.
- Cree varios modelos analíticos que reflejen diversos tipos de análisis y configuraciones.
- Replique la facilidad del modelado analítico, como en un software de análisis estructural específico, junto con la potencia de la plataforma BIM, que permite la colaboración y el uso paramétrico.
Elementos de Revit con una nueva API
Nuevas clases de API
AnalyticalElement: representa la clase base de todos los objetos analíticos. Ha sustituido a 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: representa un elemento lineal en el modelo analítico estructural. Ha sustituido a AnalyticalModelStick y 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: representa una superficie en el modelo analítico estructural. Ha sustituido a 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.
- Para modificar la geometría de panel analítico, los usuarios deben utilizar la estructura SketchEditScope. Esto se ha mejorado con un nuevo método, como se indica a continuación:
-
void StartWithNewSketch(ElementId elementId) - Starts a sketch edit mode for an element which, at this moment, doesn't have a sketch.
-
- A continuación, se indica otra forma de editar la geometría:
-
void SetOuterContour(CurveLoop outerContour) - Sets the Curve Loop that defines the geometry of the Analytical Surface element.
-
Al igual que en AnalyticalMember, al definir la curva de nivel del panel analítico, se interrumpirá la conexión con otros elementos analíticos. Si el usuario desea desplazar la esquina y mantener la conexión, existen otras formas de lograrlo, como ElementTransformUtils.moveElements.
-
- Para modificar la geometría de panel analítico, los usuarios deben utilizar la estructura SketchEditScope. Esto se ha mejorado con un nuevo método, como se indica a continuación:
-
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: elemento que representa un hueco en un panel analítico. Este es un nuevo objeto de la API de Revit (antes de esta versión, no había ningún elemento independiente para los huecos analíticos).
-
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.
- Para modificar la geometría de hueco analítico, utilice la estructura SketchEditScope.
- A continuación, se indica otra forma de modificar la geometría de huecos analíticos:
-
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: administra las asociaciones entre elementos analíticos y físicos. Anteriormente, los elementos en sí se conocían entre sí y el usuario no tenía ningún control sobre ellos (la asociación no se podía modificar). Con este nuevo enfoque, la asociación se puede editar. Se admite la asociación 1-1 y los elementos no pueden formar parte de varias asociaciones al mismo tiempo.
-
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: contiene información sobre el estado de conexión de los nodos analíticos.
-
AnalyticalNodeData GetAnalyticalNodeData ( Element element) - Returns AnalyticalNodeData associated with this element, if it exists.
-
AnalyticalNodeConnectionStatus GetConnectionStatus () - Returns the Connections Status for an Analytical Node.
Se han migrado AnalyticalLinks, BoundaryConditions y Loads para trabajar con los nuevos elementos. La API relacionada con ellos permanece en la mayoría de los casos igual. Se han realizado algunas mejoras en las cargas.
Cargas
-
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).
Muestras
Creación de un elemento 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();
}
Creación de un panel analítico
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();
}
Añadir nueva asociación entre un elemento físico y uno analítico
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();
}
Editar contorno para un panel analítico mediante la estructura 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());
Desplazar un nodo analítico y mantener la conexión
// 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();
}
Obtener puntos de curva de nivel de superficie analítica
Con la solución anterior:
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;
}
Con la nueva solución:
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;
}
Obtiene el elemento analítico asociado para uno físico.
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;
}
Crear condiciones de contorno de línea
Con la solución anterior:
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;
}
Con la nueva solución:
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;
}