È possibile esplorare l'API appena sviluppata nel contesto della modellazione analitica.
Questo progetto fa parte di una più ampia iniziativa di modellazione guidata analitica per Revit, che introduce un approccio innovativo alla modellazione analitica, ottimizzando le funzionalità complessive di modellazione strutturale. Il modello analitico è una parte essenziale dei dati BIM ed è soggetto a workflow collaborativi all'interno dei team di progettazione e tra i team di progetto, pertanto Revit, con il nuovo insieme di funzionalità e comportamenti consentirà agli ingegneri di:
- Avere la libertà di modellazione analitica necessaria per riflettere le decisioni di progettazione individuali in relazione agli elementi strutturali e agli edifici/alle strutture considerati come sistemi interi.
- Rappresentare analiticamente eventuali tipi di strutture.
- Creare modelli analitici coerenti che consentono di eseguire processi di analisi strutturale dai modelli di Revit.
- Eseguire workflow bidirezionali completi con il software di analisi e acquisire le modifiche apportate al modello.
- Conservare il modello analitico in caso di modifiche impreviste, se necessario.
- Creare più modelli analitici che riflettono diversi tipi e configurazioni di analisi.
- Replicare la facilità della modellazione analitica, come nel software di analisi strutturale dedicato, insieme alla potenza della piattaforma BIM parametrica e di collaborazione.
Elementi di Revit con una nuova API
Nuove classi di API
AnalyticalElement: rappresenta la classe di base per tutti gli oggetti analitici. Ha sostituito 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: rappresenta un elemento lineare nel modello analitico strutturale. Ha sostituito AnalyticalModelStick e 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: rappresenta una superficie nel modello analitico strutturale. Ha sostituito 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.
- Per modificare la geometria del pannello analitico, gli utenti devono utilizzare il framework SketchEditScope. Questa funzionalità è stata migliorata con un nuovo metodo:
-
void StartWithNewSketch(ElementId elementId) - Starts a sketch edit mode for an element which, at this moment, doesn't have a sketch.
-
- Un altro modo per modificare la geometria è:
-
void SetOuterContour(CurveLoop outerContour) - Sets the Curve Loop that defines the geometry of the Analytical Surface element.
-
Come per AnalyticalMember, l'impostazione della curva di livello per il pannello analitico interromperà la connessione con altri elementi analitici. Se l'utente desidera spostare l'angolo e mantenere la connessione, esistono altri modi per ottenere questo risultato, ad esempio ElementTransformUtils.moveElements.
-
- Per modificare la geometria del pannello analitico, gli utenti devono utilizzare il framework SketchEditScope. Questa funzionalità è stata migliorata con un nuovo metodo:
-
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: un elemento che rappresenta un'apertura in un pannello analitico. Si tratta di un nuovo oggetto nell'API di Revit (prima di questa versione, non era presente alcun elemento separato per le aperture analitiche).
-
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.
- Per modificare la geometria dell'apertura analitica, utilizzare il framework SketchEditScope.
- Un altro modo per modificare la geometria dell'apertura analitica è:
-
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: gestisce le associazioni tra elementi analitici e fisici. In precedenza, gli elementi stessi erano correlati e l'utente non ne aveva il controllo (l'associazione non poteva essere modificata). Con questo nuovo approccio, è possibile modificare l'associazione. L'associazione 1-1 è supportata e gli elementi non possono far parte di più associazioni contemporaneamente.
-
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 informazioni sullo stato di connessione dei nodi analitici.
-
AnalyticalNodeData GetAnalyticalNodeData ( Element element) - Returns AnalyticalNodeData associated with this element, if it exists.
-
AnalyticalNodeConnectionStatus GetConnectionStatus () - Returns the Connections Status for an Analytical Node.
È stata eseguita la migrazione di AnalyticalLinks, BoundaryConditions e Loads per lavorare con i nuovi elementi. Nella maggior parte dei casi, l'API correlata rimane invariata. Sono stati apportati alcuni miglioramenti per Loads.
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).
Esempi
Creazione di un elemento analitico
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();
}
Creazione di un pannello analitico
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();
}
Aggiunta di una nuova associazione tra un elemento fisico e un elemento analitico
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();
}
Modifica del contorno per un pannello analitico mediante il framework 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());
Spostamento di un nodo analitico e mantenimento della connessione
// 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();
}
Recupero di punti di contorno della superficie analitica
Con la soluzione precedente:
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 nuova soluzione:
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;
}
Recupero dell'elemento analitico associato per un elemento fisico
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;
}
Creazione di vincoli esterni lineari
Con la soluzione precedente:
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 nuova soluzione:
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;
}