Creating and Populating View Sheets

View sheets can be created and managed automatically using the Revit API.

Creating a Sheet

To start, we'll keep things simple and discuss adding a sheet to a file. To do that, we'll use the ViewSheet.Create() method, which takes two arguments:
  • The document we want to add our sheet to.
  • The ID of the title block we want the view sheet to use.
    doc = DocumentManager.Instance.CurrentDBDocument
    #Get the ID of the TitleBlock we want to create
    titleblocks = Fec(doc).OfCategory(Bic.OST_TitleBlocks).WhereElementIsElementType()
    for titleblock in titleblocks:
        name = titleblock.get_Parameter(BuiltInParameter.SYMBOL_NAME_PARAM).AsString()
        if name == "lorem_ipsum":
            target_titleblock_id = titleblock.Id 
            break 
    #Create a ViewSheet of the established target type
    TransactionManager.Instance.EnsureInTransaction(doc)
    new_sheet = ViewSheet.Create(doc, target_titleblock_id)
    TransactionManager.Instance.TransactionTaskDone()

Setting up a Sheet

Once we've created a sheet, we need to set up its parameters. As we discussed here, this involves getting the parameter, then using Set() to overwrite its parameter. (Make sure to pass the parameter a value of the expected type. "SHEET_NUMBER", for instance, despite its name, takes a string rather than an integer.) 
    plannummer_para = new_sheet.get_Parameter(BuiltInParameter.SHEET_NUMBER)
    planname_para = new_sheet.get_Parameter(BuiltInParameter.SHEET_NAME)
    
    TransactionManager.Instance.EnsureInTransaction(doc)
    plannummer_para.Set("000")
    planname_para.Set("lorem_ipsum")
    TransactionManager.Instance.TransactionTaskDone()

Populating a Sheet

Our sheet should now be set up, though it's looking a little empty. That's because we need to add a view. We'll use Viewport.Create(), which takes four arguments:
  • The document we want to add our sheet to.
  • The ID of the sheet we want to populate.
  • The ID of the view we want to add.
  • The desired position of the view on the sheet.
Please note that the origin of the sheet is the bottom right corner. The midpoint of an A4 sheet in landscape is therefore -148.5mm, 105mm. But because Revit works in decimal feet, we need to divide both those values by 304.8 to get the true value: -0.487, 0.344. 
    target_sheet_id = new_sheet.Id 

    #Get View ID
    views = Fec(doc).OfCategory(Bic.OST_Views).WhereElementIsNotElementType().ToElements()
    for view in views:
        name = view.Name
        if name == "lorem_ipsum":
            target_view = view
            target_view_id = view.Id
            break

    sheet_midpoint = XYZ(-0.487, 0.344, 0)

    TransactionManager.Instance.EnsureInTransaction(doc)
    add_viewport = Viewport.Create(doc, target_sheet_id, target_view_id, sheet_midpoint)
    TransactionManager.Instance.TransactionTaskDone()
You should now see the desired view in the centre of your sheet.

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

Using Excel in Automations

Let's say you want your non-coding coworkers to be able to control certain results of your scripts. There are several ways to do this, but by far the simplest is to create a shared Excel file. Your coworkers can input values into this file, which can then be read by your script at execution time. There are countless possible use-cases for this method, but for this example, we'll keep it simple and look at creating levels at certain elevations. Setting Up Excel Before we create any code, we need to set up our Excel file. Make sure to save it somewhere your coworkers can access. We'll create two columns, one called "LevelName" and the other "Elevation". We'll call our sheet "New Level Names". NOTE: Once the file is created, we'll want to add guards to make sure our script runs smoothly. We don't want people to be able to add non-integers to the Elevation column, for instance. For more information on protectin...
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