Creating and Editing Schedules

Schedules can be created and adjusted via the Revit API. In this example, we'll keep things simple and create a schedule that lists all the walls in our file and their lengths.

To do this, we'll use ViewSchedule.CreateSchedule(), which takes three arguments:

  • The document we want to add our sheet to.
  • The Element ID of the category we want to analyse.
  • The Element ID of the area scheme we want to use. We won't be looking at areas in this post, so we'll pass an invalid element ID to skip it.
    doc = DocumentManager.Instance.CurrentDBDocument
 
    wall_category_id = ElementId(BuiltInCategory.OST_Walls)
 
    TransactionManager.Instance.EnsureInTransaction(doc)
    new_schedule = ViewSchedule.CreateSchedule(doc, wall_category_id, ElementId(-1)) #ElementId(-1) is an invalid ID. It is used to skip the area scheme.
    TransactionManager.Instance.TransactionTaskDone()
That should have created a new schedule. If we open that schedule, however, we see that it's empty. This is because we need to populate its fields. To do this, we'll change the schedule's definition. 
    schedulable_fields = new_schedule.Definition.GetSchedulableFields() #Every field we can add to the schedule.
    for field in schedulable_fields:
        name = field.GetName(doc)
        if name == "Type":
            typ_field = field
        if name == "Length":
            length_field = field
 
    TransactionManager.Instance.EnsureInTransaction(doc)
    new_schedule.Definition.AddField(typ_field)
    new_schedule.Definition.AddField(length_field)
    TransactionManager.Instance.TransactionTaskDone()
The schedule should now contain your desired fields.

To overwrite the schedule's parameters (its name, for instance), follow the logic outlined in this post.

Comments

Post a Comment

Popular posts from this blog

Check which user owns an element in a shared model

When working with the Revit API in shared models, we are unable to execute commands on elements that are owned by other users. The following code snippet shows how to handle this issue. For the sake of arguement, let's imagine we want to perform an action on our walls. doc = DocumentManager.Instance.CurrentDBDocument walls = FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_Walls).WhereElementIsNotElementType() owned_walls = [] unowned_walls = [] for wall in walls: wall_id = wall.Id tooltipInfo = WorksharingUtils.GetWorksharingTooltipInfo(doc, wall_id) owner = tooltipInfo.Owner #If you're interested, you can also check who created the element and who edited it last. creator = tooltipInfo.Creator lastchangedby = tooltipInfo.LastChangedBy if owner != "" and owner != "lorem.ipsum": #The element is owned (it doesn't belong to an empty string), and it...
Read more

Create dimensions

Image
It is possible to automate the creation of dimensions in Revit. This process is highly customisable, but for the sake of argument, let's say we want to dimension the horizontal extents of a series of walls (to learn how to dimension room separation lines, click here ). To do this, we'll be using the NewDimension() method, which takes four arguments: View. In this case, we'll be using the doc.ActiveView, but you can specify any view you'd like. A line. This line will form the dimension. We will create this line before creating the dimension. A reference array. We need to tell the dimension which wall planes to base itself on. That way, if the wall moves, the dimension moves too. Dimension type. This input is optional. To keep this tutorial as simple as possible, we'll ignore this for now. Before we begin, let's set up a simple rounding function (to deal with tiny imprecisions in our model), and an instance of Opt...
Read more

Create Dimensions - Rooms

Image
In this post, we discussed creating dimensions with the Revit API. But we only discussed dimensioning walls. Sometimes, however, we want to dimensions to include other elements - balconies, for instance, which are not typically drawn with wall elements. In this case, we can use our room separation lines. def r2(num): return round(num, 2) doc = DocumentManager.Instance.CurrentDBDocument rooms = FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_Rooms).WhereElementIsNotElementType().ToElements() Once that's done, we can iterate through all these lines to find their maximum extents (for the purposes of this post, I'll assume we just want to dimension the rooms' x extents). leftmost_x = float('inf') rightmost_x = 0 line_left = None line_right = None for line in roomlines: info = line.Location.Curve direction = info.Direction origin = info.Origin if r2...
Read more