-*- mode: org -*-

Revit API Exploration Tools

• RevitLookup
• BipChecker
• AdnRevitApiLabsXtra
• RevitPythonShell

// Transactions
using (Transaction trxn = new Transaction(doc)) {
  TransactionStatus status = trxn.Start("trxn description");
  // do something here
  trxn.Commit();
}

Coordinate Systems

https://www.learnrevitapi.com/blog/convert-coordinate-systems-in-revit-api-draft

• Internal
• Project
• Survey

  # ╦╔╦╗╔═╗╔═╗╦═╗╔╦╗╔═╗
  # ║║║║╠═╝║ ║╠╦╝ ║ ╚═╗
  # ╩╩ ╩╩  ╚═╝╩╚═ ╩ ╚═╝
  #==================================================
  from Autodesk.Revit.DB import *

  # ╦  ╦╔═╗╦═╗╦╔═╗╔╗ ╦  ╔═╗╔═╗
  # ╚╗╔╝╠═╣╠╦╝║╠═╣╠╩╗║  ║╣ ╚═╗
  #  ╚╝ ╩ ╩╩╚═╩╩ ╩╚═╝╩═╝╚═╝╚═╝
  #==================================================
  uidoc  = __revit__.ActiveUIDocument
  doc    = __revit__.ActiveUIDocument.Document #type:Document


  # ╔═╗╦  ╔═╗╔═╗╔═╗
  # ║  ║  ╠═╣╚═╗╚═╗
  # ╚═╝╩═╝╩ ╩╚═╝╚═╝
  #==================================================
  class CoordSys:
      Internal = 'Internal'
      Project  = 'Project'
      Survey   = 'Survey'

  class PointConverter:
      pt_internal = None
      pt_survey   = None
      pt_project  = None

      def __init__(self, input_pt, coord_sys=CoordSys.Internal):
          """Converte 2.0 for converting XYZ points between any Coordinate Systems.
          Args:
              :param input_pt: The XYZ point in Internal Coordinate System. Adjust coord_sys argument if you want to use other Cooridnate Systems.
              :param coord_sys: The coordinate system chosen from CoordSys helper class (Internal, Project, Survey)
              
          Example:
              pt = elem.Location.Point
              
              converter   = PointConverter(pt, CoordSys.Internal)
              pt_survey   = pt_converter.pt_survey   # XYZ in FEET 
              pt_survey_m = pt_converter.pt_survey_m # XYZ in Meters
             
              pt_converter.print_in_metric(coord_sys=CoordSys.Survey)    
          """
          # type: float, float, float, CoordSys

          # Get Systems Transform
          srvTrans  = self._GetSurveyTransform()
          projTrans = self._GetProjectTransform()

          #1️⃣ INPUT - INTERNAL COORDINATE SYSTEM
          if coord_sys == CoordSys.Internal:
              self.pt_internal = input_pt
              self.pt_survey   = self._ApplyInverseTransformation(srvTrans, self.pt_internal)
              self.pt_project  = self._ApplyInverseTransformation(projTrans, self.pt_internal)

          #2️⃣ INPUT -  PROJECT COORDINATE SYSTEM
          elif coord_sys == CoordSys.Project:
              self.pt_project  = input_pt
              self.pt_internal = self._ApplyTransformation(projTrans, self.pt_project)
              self.pt_survey   = self._ApplyInverseTransformation(srvTrans, self.pt_internal)

          #3️⃣ - SURVEY COORDINATE SYSTEM
          elif coord_sys == CoordSys.Survey:
              self.pt_survey   = input_pt
              self.pt_internal = self._ApplyTransformation(srvTrans, self.pt_survey)
              self.pt_project  = self._ApplyInverseTransformation(projTrans, self.pt_internal)

          else:
              raise Exception("Wrong argument value for 'coord_sys' in PointConverter class.")


          #🧮 Create Metric Points
          self.pt_internal_m = self._get_metric_XYZ(CoordSys.Internal)
          self.pt_project_m   = self._get_metric_XYZ(CoordSys.Project)
          self.pt_survey_m   = self._get_metric_XYZ(CoordSys.Survey)


      def print_in_metric(self, coord_sys, units=UnitTypeId.Meters):
          """ Helper function to display coordinates in Metric System."""
          pt_m = self._get_metric_XYZ(coord_sys, units)
          print('[{}] XYZ: ({}m, {}m, {}m)'.format(coord_sys, pt_m.X, pt_m.Y, pt_m.Z))


      #🚧 INTERNAL HELPING METHODS
      def _get_metric_XYZ(self, coord_sys, units=UnitTypeId.Meters):
          """Convert the point into Metric XYZ System.
          NB! Do not use it with Revit API as it needs internal units."""
          # Get Point With Correct Coordinate System
          if coord_sys == CoordSys.Internal:  pt = self.pt_internal
          elif coord_sys == CoordSys.Project: pt = self.pt_project
          elif coord_sys == CoordSys.Survey:  pt = self.pt_survey

          # Convert Values to Metric
          X_m = UnitUtils.ConvertFromInternalUnits(pt.X, units)
          Y_m = UnitUtils.ConvertFromInternalUnits(pt.Y, units)
          Z_m = UnitUtils.ConvertFromInternalUnits(pt.Z, units)

          return (XYZ(X_m, Y_m, Z_m))

      def _GetSurveyTransform(self):
          """Gets the Active Project Locations Transform (Survey)."""
          return doc.ActiveProjectLocation.GetTotalTransform()

      def _GetProjectTransform(self):
          """Get the Project Base Points Transform."""
          basePtLoc = next((l for l in FilteredElementCollector(doc) \
                            .OfClass(ProjectLocation) \
                            .WhereElementIsNotElementType() \
                            .ToElements() if l.Name == "Project"), None)
          return basePtLoc.GetTotalTransform()

      def _ApplyInverseTransformation(self, t, pt):
          """Applies the inverse transformation of
          the given Transform to the given point."""
          return t.Inverse.OfPoint(pt)

      def _ApplyTransformation(self, t, pt):
          """Applies the transformation of
          the given Transform to the given point."""
          return t.OfPoint(pt)


# Get Elements
elems = FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_GenericModel).WhereElementIsNotElementType().ToElements()
boxes = [e for e in elems if 'EF_Box' in e.Name] # ⚠️ I use specific Type Name to filter...

# Get Coordinates
for box in boxes:
    # Get Location
    pt     = box.Location.Point # Internal Coordinate System (defualt)

    # 👉 Convert XYZ Point 
    pt_converter = PointConverter(pt, CoordSys.Internal)
  
    pt_survey    = pt_converter.pt_survey    # XYZ - SURVEY WITH VALUES IN FEET
    pt_survey_m  = pt_converter.pt_survey_m  # XYZ - SURVEY WITH VALUES IN METERS 

    pt_project   = pt_converter.pt_project   # XYZ - PROJECT WITH VALUES IN FEET
    pt_project_m = pt_converter.pt_project_m # XYZ - PROJECT WITH VALUES IN METERS 
  

    # Extra Function To Print Correct Data Display Results
    pt_converter.print_in_metric(coord_sys=CoordSys.Survey)