Tags: Shell (2)
The pain of renumbering
In most offices, your documentation set will consist of a set of sheets, and each sheet has a titleblock with a zone for details/views/drawings/etc...whatever you want to call them, in revit there called views. Now these views generally have a corresponding number ascending from the bottom right to top left, for two reasons. Referencing from other drawings, but also the order is due to the binding normally being on the left hand side, and drawings should try to be as far away from the binding as possible (to keep the contractor happy).
The annoying part is that in revit, your view number on the sheet does not update magically when you move views around on your invisible cell grid. Furthermore, manually renumbering is sometimes a pain because you occassionally will get a nasty alert message from revit if you attempt to renumber with a duplicate number that already exists...
So I made a tool (revit python shell or dynamo player) to automatically renumber the views based on the location of the view on the sheet.
How it Works, 2 Essentials.
Move your details around, run the script, and wallah, your views are renumbered by the script analyzing the titleblock lower left point, and what cell it currently resides in! To do this we need two pieces of information.
1. Your cells are defined by a matrix. (2 dimensional array string) of numbers/text
The detail grid is a 2 dimensional (list of lists) array. Visually, it should make sense no? This matrix is hardcoded into both the rps python script and dynamo player, which you can edit. But alternatively, this can be embedded into titleblock, which is explained later below.
#<---------detail grid format --------->#
# detail grid typical, with line breaks for clarity..
detailGrid = [
["30" ,"25" ,"20" ,"15" ,"10","05"],
["29" ,"24" ,"19" ,"14" ,"09","04"],
["28" ,"23" ,"18" ,"13" ,"08" ,"03"],
["27" ,"22" ,"17" ,"12" ,"07" ,"02"],
["26" ,"21" ,"16" ,"11" ,"06" ,"01"]
#<---------detail grid can be anything, letters too :) --------->#
# detail grid can be any text
# here we have letters
detailGridLetters = [
["DD" ,"Y" ,"T" ,"O" ,"J","E"],
["CC" ,"X" ,"S" ,"N" ,"I","D"],
["BB" ,"W" ,"R" ,"M" ,"H" ,"C"],
["AA" ,"V" ,"Q" ,"L" ,"G" ,"B"],
["Z" ,"U" ,"P" ,"K" ,"F" ,"A"]
2. The bounds of the zone to subdivide with the aforementioned matrix. This generally represented as a line, top left corner to bottom right corner.
The bounds are bascially 2 points (top left to bottom right).We define by defining these pts as offsets relative to the title block corners. Normally, the script will prompt you to select a representative detail line, but alternatively, this can be embedded into titleblock, which is explained later below.
# in pseudo code
# bounds = [
# [topLeft_corner_offset_X, topLeft_corner_offset_Y],
# [botRight_corner_offset_X, botRight_corner_offset_Y]
# here we have our bounds 1.5" horiz offset from top left corner of title block and .5" vert offset.
# bounds = [[1.5",.5"],[5",2.5"]]
#keep in mind that we need in units of our project..in our case imperial is feet so make sure to convert as such..see actual thing below.
bounds = [[0.125,0.0416666666666667],[0.416666666666667,0.208333333333333]]
Embedding bounds and matrix data in titleblock family
So for these two bits of info above, you have two methods to supply this Information.
1. You can open up the script and edit the hardcoded array (matrix), and hit run. It will then prompt you to click a detail line that represents the bounds on the sheet.
2. [RECOMMENDED] The second way is you can specify two text parameters in your title block to embed this information for you and avoid prompts / detail lines / editing code all together :). Both of these parameters should be devoid of line breaks, and follow the json array format.
Nothings perfect..so you might be wondering what if the views coincidentally share the same cell? Well if this happens the script will then look for the next closest cell and try that. If that fails, it will try the next...until finally if there are no more cells available, it will start incrementally increasing from the last cell. Additionally, a message will pop up telling you how many times this duplicate situation happened, as well as highlight that view with a detail line :).
Two ways of using python with revit
1. Revit Python Shell - The revit python shell, is essentially a downloadable add-in available here. This is more like conventional scripting, and if your used to rhinoscript/python script or any kind of traditional sequential scripting, this is synonymous to having a script written with your favorite text editor and then running it. Essentially you can write scripts, and then run them via buttons/ shortcuts etc.
2. Dynamo Python node - Alternatively, you can run python in a dynamo definition, so if your familiar with grasshopper or visual programming, or if your script is more in need of this type of interface, this is a good bet. plus its native, so no add-in is necessary. This pretty much functions the same way ghPython for grasshopper works. It is a node with customizable inputs and outputs, double clicking into the node, allows you to add your code.
The building coder and proving ground provide a great resource for these two ways of using python. But I found it useful to save this snippet of code to know how to convert between all in the same place. I sometimes start out creating a dynamo graph, and then realize its more useful as a revit python shell script (I.E. in the ribbon as a button or used as a shortcut). OR vice versa. It turns out its not so different in how you set up your base code, which for most api calls, the below set of variables, dependency libraries, etc will be useful. I have converted many scripts to and from dynamo and rps, its super easy!
Typical Revit Python Shell Script
You can see here a typical RPS script base. Often you will not have to import too many libraries as you will in dynamo. API and APIUI will be enough. Also note the global var __revit__ and __window__. These are not set in the dynamo interface. __revit__ is your access into various revit globals. __window__ is actually a console (text terminal) that appears when you run a script. if you print something, for instance, it should show up here. Generally I close this in my scripts, as it is not how I like to debug, and it is generally not useful unless you are doing so.
#Typical python revit shell
from Autodesk.Revit.DB import *
#important vars, revit python shell version
app = __revit__.Application
doc = __revit__.ActiveUIDocument.Document
uidoc = __revit__.ActiveUIDocument
view = doc.ActiveView
#revit python shell has a console, access it like so
Typical Dynamo Node
Dynamo nodes for python generally take a lot more imports of nodes, especially if your'e affecting the document i.e. transactions.
#Typical dynamo node
# Import RevitNodes
# Import RevitAPI
from Autodesk.Revit.DB import *
# Import Revit elements
from Revit.Elements import *
# Import DocumentManager
from RevitServices.Persistence import DocumentManager
# important vars, dynamo version
doc = DocumentManager.Instance.CurrentDBDocument
uiapp = DocumentManager.Instance.CurrentUIApplication
uidoc = uiapp.ActiveUIDocument
app = uiapp.Application
view = uidoc.ActiveView