Kontextový analytický model v rozhraní API aplikace Revit

Prozkoumejte nově vyvinuté rozhraní API v kontextu analytického modelování.

Tento projekt je součástí širší iniciativy analyticky řízeného modelování pro aplikaci Revit, která zavádí inovativní přístup k analytickému modelování a rozšiřuje jeho celkové možnosti konstrukčního modelování. Analytický model je důležitou součástí dat BIM a je předmětem spolupráce v rámci inženýrských týmů i napříč projektovými týmy. Aplikace Revit díky nové sadě funkcí a chování umožní inženýrům:

• Získat při analytickém modelování volnost, aby se odráželo jejich individuální rozhodování o návrhu s ohledem na konstrukční prvky a budovy/konstrukce vnímané jako celé systémy.
• Analyticky prezentovat všechny typy konstrukcí.
• Vytvářet konzistentní analytické modely, které umožňují provádě úlohy konstrukční analýzy z modelů aplikace Revit.
• Pomocí softwaru pro analýzu provádět úplný obousměrný pracovní postup a zachytit zde provedené úpravy modelu.
• V případě potřeby chránit analytický model před neočekávanými změnami.
• Vytvářet více analytických modelů, které odrážejí různé typy a konfigurace analýz.
• Provádět analytické modelování snadno a rychle, podobně jako ve specializovaném softwaru pro konstrukční analýzu, v kombinaci s výkonem parametrické platformy BIM umožňující spolupráci.

Prvky aplikace Revit s novým rozhraním API

Nové třídy rozhraní API

AnalyticalElement – Představuje základní třídu pro všechny analytické objekty. Nahrazuje třídu 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 – Představuje lineární prvek v konstrukčním analytickém modelu. Nahrazuje třídy AnalyticalModelStick a 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 – Představuje povrch v konstrukčním analytickém modelu. Nahrazuje třídu 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.

  • K úpravě geometrie analytické desky by uživatelé měli použít rámec SketchEditScope. Úprava byla vylepšena novou metodou:

    •  void StartWithNewSketch(ElementId elementId) - Starts a sketch edit mode for an element which, at this moment, doesn't have a sketch.

  • Další způsob úpravy geometrie:

    • void SetOuterContour(CurveLoop outerContour) - Sets the Curve Loop that defines the geometry of the Analytical Surface element.

      
      
      

    • Stejně jako u třídy AnalyticalMember nastavení obrysu pro analytickou desku přeruší připojení k jiným analytickým prvkům. Pokud chce uživatel přesunout roh a zachovat připojení, existují jiné způsoby, jak toho dosáhnout, například ElementTransformUtils.moveElements.

•  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 – Prvek, který představuje otvor v analytické deskce. Jedná se o nový objekt v rozhraní API aplikace Revit (před touto verzí nebyl k dispozici žádný samostatný prvek pro analytické otvory).

• 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.

  • Chcete-li upravit geometrii analytického otvoru, použijte rámec SketchEditScope.
  • Další způsob úpravy geometrie analytického otvoru:

    •  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 – Spravuje asociace mezi analytickými a fyzickými prvky. Dříve o sobě prvky navzájem věděly a uživatel nad nimi neměl žádnou kontrolu (asociaci nebylo možné upravit). Díky tomuto novému přístupu lze asociaci upravovat. Podporována je asociace 1-1 a prvky nemohou být součástí několika asociací současně.

•  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 – Obsahuje informace o stavu připojení analytických uzlů.

• AnalyticalNodeData GetAnalyticalNodeData ( Element element) - Returns AnalyticalNodeData associated with this element, if it exists.
  

• AnalyticalNodeConnectionStatus GetConnectionStatus () - Returns the Connections Status for an
  Analytical Node.

Třídy AnalyticalLinks, BoundaryConditions a Loads byly migrovány tak, aby spolupracovaly s novými prvky. Rozhraní API, které je s nimi spojeno, zůstává ve většině případů stejné. Byla provedena některá vylepšení třídy 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).

Příklady

Vytvoření analytického prvku

      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();
                }

Vytvoření analytické desky

 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();
          }

Přidání nového přidružení mezi fyzickým a analytickým prvkem

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();
  }

Úprava hranice analytické desky pomocí rámce 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());

Přesunutí analytického uzlu a zachování připojení

            // 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();
            }

Získání bodů obrysu analytického povrchu

S předchozím řešením:

    
      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;
      }

S novým řešením:

     
      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;
      }

Získání asociovaného analytického prvku pro fyzický prvek

     
      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;
      }

Vytvoření okrajových podmínek čar

S předchozím řešením:

       
        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;
        }

S novým řešením:

      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;
      }