On this page:
    On this page:
      For: Electrical Engineers, Bim Managers, Electrical Designers
      Setup: Typically 2–4 hours — quicker for experienced users.

      A consistent naming strategy is critical for productivity when working in Revit
      Every view, sheet, filter, family, and parameter becomes part of a living dataset. Without clear, predictable naming conventions, you end up with a lot of confusion and wasted time!

      This is why with permission of Gavin Crump, I used his naming convention as a base for all parameters in the project template. Its not just a copy of Gavin’s Shared Parameters, but rather evolved version of his idea, adapted to suit electrical discipline. 

      1.1 Project Dashboard

      Open the model and the first thing you’ll see is the Project Dashboard.

      It ships with dummy data so you can see the wiring; swap the placeholders for your own project details and you’re ready to roll.

      Table 1 Project Dashboard
      ZoneWhat it’s forHow to edit
      Notice BoardOne-liners, site memos, alerts.Click into the text note and overwrite the sample copy. Keep it short; the board isn’t a novel.
      Originator InformationYour company name, address, logo if you fancy.Edit the text fields (or replace the logo image).
      Project & Model DetailsLive read-outs of Project Information parameters (number, name, stage, etc.).Do not touch the dashboard text; go to Manage ▶ Project Information and update the parameters once—changes ripple to sheets and tags automatically.
      Model-Health GaugeReal-time “traffic-light” of warnings, links, view count, etc.Powered by the family PD_GAN_ModelHealth-Gauge plus the free pyRevit “PD” extension. Install the extension to unlock the automated checks; otherwise the gauge will sit there looking pretty but static.
      Model Revision TableTracks every formal issue of the model or sheets.Uses Revit’s built-in revision system (View ▶ Revisions). We’ve pre-loaded three naming tracks:
      C0x — Published (C01, C02…)
      P0x — Shared (P01, P02…)
      x.01 — WIP (x.01, x.02…)

      Need a refresher on status & suitability codes?

      See our cheat sheet: Table 36 – Status and Suitability

      1.2 Start-up checklist

      1. Update Project Information parameters.
      2. Replace the Originator details.
      3. Clear the sample Notice-Board text and add your first real memo.
      4. Install the pyRevit PD extension if you want the gauge to light up.
      5. Confirm the revision sequence (C, P, or WIP) before you issue anything.

      Five minutes and your dashboard will look like it was built for this project—because, well, it now is.

      1.3 Pre-loaded Electrical Content

      This template isn’t just a blank shell—you’re getting a turnkey starter kit that would normally cost a small fortune in add-ons. Everything listed below is wired-in, QA-checked, and ready to drop into real projects.

      Table 2 Premium Families (gift-wrapped)
      Family & VersionNormal List PriceWhat it gives youWhere it’s used
      PD_ELE_Electrical-Equipment_DistributionBoards£ 24.90Parametric DB enclosure, spare-way logic, DIN-rail calcDrives the sample Distribution-Board schedules
      PD_ELF_Electrical-Fixture_Socket_v22.2.1£ 49.90UK twin & single sockets, data, USB, Lighting/Small-Power legends & schedules
      PD_LTF_Lighting-Fixture_Luminaire-Rectangular_v22.1.3£ 49.90Recessed/Surface, parametric, any sizeLighting plan, BREEAM sample notes

      Why the price tags?
      We’re not being cheeky, just honest. You’re getting around £125 worth of kit, already tested. If that earns the template a second look when the next spec drops… job done.

      2.0 pyREVIT

      What it is
      pyRevit is a free, open-source Python framework that bolts hundreds of automation, QA, and data-mining commands onto Autodesk Revit. Think Dynamo speed–but–with–Python, wrapped in a tidy ribbon tab.

      Why you need it here
      Several features in the PD template—the Model-Health Gauge, the one-click QA schedules launcher, and assorted right-click utilities—light up only when the PDtool pyRevit extension is present.

      How to get up and running (≈ 3 minutes)

      PDtool.extension
      Table 3 PDtool.extension
      Step Action
      1Visit https://pyrevitlabs.notion.site and grab the pyRevit installer (template tested on v 5.1.0).
      2Run the installer – it adds a “pyRevit” tab to Revit and a little gear-wheel in the Windows tray.
      3Log in to https://projectdesign.io/account/downloads/ and download PDtool.extension.zip.
      4Make a home for extensions – e.g. C:\pyRevit – and unzip the file so you end up with: C:\pyRevit\PDtool.extension\
      5Launch (or restart) Revit – pyRevit performs an auto-scan and the new pyRevit tab appears.
      6go to pyRevit TAB >pyRevit>Settings >Add Folder> Add Paf to your pyRevit folder (as on screenshot) > Reload pyRevit
      7Open a model based on this template; the Model-Health Gauge should animate and the PD ribbon will list the QA and productivity tools.

      Follow these six steps 

      That’s it—automation unlocked, no code required.

      3. MEP SETTINGS

      3.1 Conduit Systems — sizes, lookup tables

      Conduit Look-up tables

      Three conduit systems in the template, LTG-PWR (steel), LTG-PWR (PVC),and Rigid Non-metallic Conduit RNC twin-wall PVC, have been pre-set so that:

        • only the pre-set diameters appear in MEP Settings ▶ Electrical ▶ Conduit Settings;
        • Every elbow, automatically pulls its true outside diameter and bend geometry from an embedded CSV lookup table;
      • Each elbow exposes a yes/no parameter ‘UseMinimumRadius so you can flip between the manufacturer’s long sweep and the BS 7671 minimum[1]≥ 2.5 × outside diameter (OD)
        without the need for a second family.
      Table 4 Conduit families & type codes
      SystemFamily/type prefixSize catalogue (mm OD)Bend radius table follows “long” & “min”
      Steel conduit (lighting & power)PD-703010_CNT_Conduit_LTG-PWR_steel20 – 63 PD_Conduit_Elbow_Metric_Steel_v25.1.1.csv
      Steel conduit (lighting & power)PD-703010_CNT_Conduit_LTG-PWR_pvc20 – 63 PD_Conduit_Elbow_Metric_PVC_v25.1.1.csv
      Twin-wall PVC RNCPD-703010_CNT_Conduit_RNC20 – 178 PD_Conduit_Elbow_Metric_RNC_v25.1.1

      Each system ships with a full set of fittings already mapped to the relevant lookup table and placed in the two view templates PD_703010-10_Containment_(working) and …(published). No type-creation required – just model.

      • How the elbow decides its bend radius

      Bend Radius =

      IF(UseMinimumRadius,size_lookup(Conduit Size Lookup, “BRad_Min”, 2.5 * OutsideDiameter, OutsideDiameter),size_lookup(Conduit Size Lookup, “BRad_Long”, 2.5 * OutsideDiameter, OutsideDiameter))

       

      Conduit Size Lookup points to the embedded table (PD_Conduit Elbow – Steel, …PVC, …RNC).

      • Column BRad_Min stores the BS 7671 minimum; BRad_Long stores the manufacturer’s long sweep.
      • If a size is missing the formula falls back to 5 × OD—still code-compliant.

      What you need to remember

      1. Pick the correct system type (LTG-PWR, RNC) before routing.
      2. Tap UseMinimumRadius on when you need the tightest legal bend (e.g. congested risers).
      3. Filters in the Containment view templates will colour the run automatically
      4. Never add ad-hoc diameters: add them once in Conduit Settings and as a new row in the CSV, then reload the family.

      Lookup tables in the download pack

      For the tweakers among us, the three CSV files that drive those elbows are included in the template bundle:

      • PD_Conduit Elbow_Metric_Steel_v1.csv
      • PD_Conduit Elbow_Metric_PVC_v1.csv
      • PD_Conduit Elbow_Metric_RNC_TwinWall_v1.csv[2]

      They’re already embedded in the elbow family, so the system works out-of-the-box; the loose files are there purely for curiosity, audit, or future expansion (add a new size, re-import, job done).

      If you don’t plan on editing bend data, feel free to ignore them—and definitely don’t delete the embedded copy, or Revit will fall back to the 2.5 × OD safety net, and your sweeps will look suspiciously tight.

      PD-703010_CNT_Conduit Coupling

      A single “Standard Conduit Coupling” family is assigned to every conduit type. Its only real job is to keep Revit’s Slice tool happy; we’re not interested in counting couplers, only total conduit length. In other words, modelling three-metre conduit lengths is pointless,  so let’s leave the auto-couplers in place for slicing, but don’t waste time manually adding them.

      PD-703010_CNT_ConduitBox_STOP_END

      The template includes a standard UK Stop-End conduit box for finishing dead-end runs. Revit will not drop this fitting automatically, so add it manually when a conduit terminates.
      Systems ▶ Conduit Fitting ▶ PD-703010_CNT_ConduitBox_STOP_END.
      Place only where the run genuinely stops.

      3.2 Pre-Loaded Electrical Toolkit

      Below is an inventory of the content you just gained. Keep it handy; if it’s not on this list, you probably don’t need it.

      Containment fittings (CNT- prefix)

      All snap automatically onto tray, ladder, or conduit runs.

      Table 5a Conduit Fittings
      Family NameUse
      PD-703010_CNT_Conduit CouplingAuto-inserted by Slice; maintains run continuity
      PD-703010_CNT_ConduitBox_CROSS / _TEE / _STOP_ENDUK conduit boxes for cross-overs, tees, dead-ends
      PD-703010_CNT_Conduit_ELBOWElbow that reads the steel/PVC/RNC lookup tables
      Table 5b Tray & Ladder Fittings
      Family NameUse
      PD_703010_Fitting_Horizontal Bend / Cross / TeeStandard tray bends & junctions
      PD_703010_Fitting_Vertical Inside Bend / Outside BendVertical sweeps for tray runs
      PD_703010_Fitting_Reducer / UnionWidth transitions & joiners
      PD_703010_Fitting_Ladder … (same set as above)Ladder versions, plus Vertical Inside/Outside bends

      No hand-rotating, no “pick family” pop-ups—draw, and let Revit drop the right node.

      Schematic symbols (ANS-SH- prefix)

      Table 6 For Drafting Views & LV one-line diagrams.
      SymbolDescription
      PD_ANS_SH_MCCMotor-control centre
      PD_ANS_SH_SwitchboardMain LV switchboard
      PD_ANS_SH_Main_Earth_Terminal & …_RisersMET symbols
      PD_ANS_SH_MeterkWh / sub-meter
      PD_ANS_SH_Protective Device (vertical & horizontal)Fuse/MCB/RCBO block
      PD_ANS_SH_Switch DisconnectorIsolator symbol
      PD_ANS_SH_ATSAutomatic Transfer Switch
      PD_ANS_SH_GEN_SymbolStandby generator
      PD_ANS_SH_Cable_IDBubble for cable tag
      PD_ANS_SH_Distribution_BoxSub-DB bubble
      PD_ANS_SH_EPOEmergency-power off
      PV suite: _PV_Array / _PV_Inverter / _PV_IsolatorComplete PV feed-in set

      All symbols use the template text style (IBM Plex Sans 2.5 mm) and respect view scale.

      Annotation tags (PD_TAG- prefix)

      Every tag below is already loaded and colour-matched to the text-style palette.

      Table 7 Annotation tags
      Tag FamilyDrops OnKey Parameters Shown
      PD_TAG-RoomRoomsName, number
      PD_TAG_Space / _Zone / _AreaSpaces / ZonesName, number, conditioning
      PD_TAG_Wall / _Door / _Ceiling / _Floor-Ffl-SslArchitecturalType & mark data
      Containment Tags
      PD_TAG_CableTray-SizeTray/LadderWidth × height
      PD_TAG_CableTray-Size-SystemServedTray/LadderSize + service
      PD_TAG_CableTray-Size-SystemServed-InvertLevelTray/LadderSize + service + invert level
      PD_TAG_CableTrayFitting-SizeTray/Ladder fittingsSize
      PD_TAG_Conduit-SizeConduitsOD/ND
      Electrical Equipment & Devices
      PD_TAG_ElectricalEquipment_PanelNameBoardsPanel name, kVA
      PD_TAG_LightingFixture_TypeLuminairesType mark, emergency flag
      PD_TAG_FireAlarmDeviceFA devicesAddress / type
      PD_TAG_Wire_1.8 mm_CircuitReference
      PD_TAG_Wire_2.5 mm_CircuitReferenceWiresCircuit ref in chosen text height
      PD_TAG_Keynote / _Revision / _MC-FamilyDetails / _MechanicalEquipment_Type / _JoineryUnitMisc.Self-explanatory

      Sample drafting views

      Table 8 Sample drafting views
      View NameWhat it shows
      Security SchematicCCTV, ACS, intruder loops with PD_ANS_SH_ symbols
      Typical Desk Layout DetailPower, data, USB-C & AV outlets + clearance dims

      Both live on Sheet 00010—duplicate for new projects.

      All symbols use the template text style (IBM Plex Sans 2.5 mm) and respect view scale.

      3.3 Pre-configured MEP Settings

      • Load Classifications – pre-populated, ready for use .
      • Electrical Distribution Systems – Single Phase 230V and Three Phase 400V systems created
      • Voltage Definitions – matches the UK regs tables, so panel schedules pull the correct kVA.
      • Conduit & Cable-Ladder Sizes – steel EMT/IMC/RMC plus RNC twin-wall (110 mm & 150 mm).
      • Wiring Types – PVC/LSF singles, MICC, FP200, etc. All wired into the Distribution-Board schedule for circuit makeup.

      3.4 Panel-Schedule Templates

      Table 9 Panel-Schedule Templates
      Template NameColumn LayoutTypical Use
      PD_UK_DB_(manual + load)One bank, With calc columns (Ib, In, kVA, demand-factor)Design WIP to check load an dcircuit lenght
      PD_UK_DB_(manual) (Default)One bank, No load columnsUsed for Publication

      Select the board, or hit Edit Panel Schedule Template, pick the flavour you need – job done.

      3.5 Legend & Note Sheets

      Table 10 Legend & Note Sheets
      Sheet IDSizeContents
      PD_Legend ContainmentA1&A0Trays, ladders, RNC colours, symbol key
      PD_Legend Fire AlarmA1&A0Device icons, loop labelling, cable types
      PD_Legend LightingA1&A0Luminaire symbols, emergency icons, switching diagram
      PD_Small-PowerA1&A0Device icons, labelling,
      PD_Nurse-CallA1&A0Device icons, labelling,
      PD_SecurityA1&A0Device icons, labelling,

      Feel free to copy-paste these legends to new sheets; the symbols stay live to the families.

      3.6 Sample Schedules

      • Design Schedules – Circuits, luminaires, small-power, cable ladders, conduit runs.
      • QA Schedules – prefixed QA; Run them before sharing the model to manually purge the model
      • COBie Drops – Equipment, Spaces, Attributes all mapped to template parameters.
      • Containment – Sample containment runs and fittings schedules included in the template.

      3.7 Pre-populated Drawing Sheets

      Table 11 Pre-populated Drawing Sheets
      Sheet No.View(s)Purpose
      E-10111Lighting plan L00, legend, notesShows how titles, revisions, keyplans link up
      E-10211Small Power LayoutAs above
      E-10311Containment LayoutCombines legend, notes, and containment filter
      DB1DB1 Circuit scheduleDemonstrates a panel schedule on sheet

      Swap the model views for your own and the title block.

      3.8 Shared Parameters & Custom Fields

      All custom parameters listed in PD_Shared Parameters_V1.0.0.csv are already loaded:

      • Project parameters – feed the dashboard and drawing list.
      • Family parameters – lumen output, socket rating, DB spare ways, conduit bend radius, etc.

      You shouldn’t have to add a single extra parameter for a standard UK electrical job—but if you do, keep the naming convention (camelCase for one-offs, group under Electrical – Power).

      4.0 NAMING STRATEGY

      4.1 Use of CamelCase

      What Is CamelCase?

      CamelCase means capitalising each “word” in a compound name, with no spaces or underscores.
      Like so: ProjectNameSubElementOption1.

      It’s called CamelCase because the capital letters form “humps” (someone was feeling poetic in a CS lab).

      CamelCase is used for single-entity identifiers where readability and compactness are priorities. It eliminates the need for delimiters in straightforward compound names, making it ideal for parameters, variable names, and succinct file identifiers. For complex hierarchical naming, underscores _ and brackets () or [] are used to maintain clarity and structure.”

      Table 12 When to Use CamelCase in Your Naming Strategy
      ScenarioCamelCase is a Good FitWhy
      Short compound namesProjectName, ViewFilter, SheetNumberEasy to read, avoids visual clutter.
      Internal identifiers / ParametersFireRatingValue,ExportToIFC, RevitFamilyTypeCommon in software, scripting, coding standards.
      When delimiters are unnecessaryNorthWingLayout instead of North_Wing_LayoutWhen the hierarchy is obvious from context.
      File names in controlled systemsClientDeliverableList2025Clean for systems that don’t like special characters.
      Table 13 When Not to Use CamelCase
      Bad FitWhy
      When you want clear separation of blocksUse _ or - instead for multi-layered structures.
      For optional info or annotationsUse (Option1) or [Tag] for clarity.
      In public file shares or client deliverablesSometimes underscores are clearer for mixed audiences.

      The Golden Rule of CamelCase

      CamelCase is great for naming single “things” — entities, variables, types.
      But when you’re defining relationships between “things,” use delimiters.

      For example:

      ClientProject_LayoutType_(Option1)

      • ClientProject — CamelCase block (single entity name)
      • _ delimiter for hierarchy
      • LayoutType — another CamelCase block
      • (Option1) — optional aside in parentheses

      This naming strategy works beautifully in BIM, CAD, and structured file naming.

      4.2 Use of round parentheses () and square brackets []

      In this Revit template, treat round parentheses (…) as human-friendly comments e.g., (Emergency) and square brackets […] as machine-readable tags that pin down hard attributes e.g., [IP65].

      Table 14 Use of round parentheses () and square brackets []
      SymbolUsed ForToneExample
      (…)Optional info, human-readable notesSoft, explanatoryLuminaireSchedule_(Preliminary)
      […]Defining attributes, technical tagsFormal, machine-readableFireAlarmPanel_[IP65]
      Table 15 When To Use Which (Rules of Thumb)
      ScenarioUseWhy
      Adding optional, descriptive notes for humansRound Parentheses (…)They signal context but not structure
      Defining a precise category, spec, or hard attributeSquare Brackets […]They imply a structured, technical modifier
      Status flags, revisions, phases (informational)Round Parentheses (…)Readable, non-intrusive
      Configuration values, dimensions, controlled tagsSquare Brackets […]Machine-friendly, structured data feel

      Example:

      • ContainmentHL_(working) – “Oh, by the way, this is working view.”
      • ProtectedCorridor[FR120] — “This is formally part of Protected Escape Route.”

       

      Round brackets are your side comments — they’re for people.
      Square brackets are your database columns — they’re for systems.

      4.3 Text Annotations on Drawings

      General Guidance

      • Be Direct, Be Technical, Be Measurable: e.g., 16A commando socket for data cabinet.
      • Use correct electrical terminology: e.g., wired in 16mm² LSF cable to DB-01.
      • Always specify units & ratings: e.g., 400V, 3-phase, 4-pole.
      • Standard symbols & abbreviations: Use Ø for diameters e.g., Ø25mm conduit.
      • IP ratings, kW, LUX, VA, etc., as per BS standards.

      Tone & Clarity

      • Neutral, instructive language: e.g., Provide RCD protection for socket outlets.
      • One instruction per annotation.
      • Complex notes go in specifications, not drawings
      • Repetitive annotations belong to General Notes (e.g., use them in Legend)

      Consistent formatting:

      • Start with uppercase, no full stops unless more than one sentence.
      • Example: Route containment above ceiling level
      Table 16 Summary Table — Naming Cheat Sheet
      ElementNaming FormatExamplePurpose
      Core IdentifierscamelCasecableSchedule, smallPowerLayoutCompact, structured
      Contextual Info(Round Brackets)lightingLayout_(Emergency)Optional, human-readable
      Attributes / Filters[Square Brackets] (if used)ProtectedCorridor[FR120]Structured tag, for filtered schedules
      Drawing AnnotationsShort, factual technical phrasesConnect lighting circuit to DB-01Clear installation instruction
      Quick Note

      camelCase is how we name systems. Brackets are how we tell humans which bit we’re talking about. And text annotations? Those are not for storytelling — they’re for telling exactly what needs to happen – make it idiotproof!”

      4.4 Forbidden Characters (and the One Narrow Exception)

      Why “/” and “\” Are Radioactive in File Names

      Slash / and back-slash \ are reserved path separators in every modern operating system. The moment you slip one into a file name, two bad things happen:

      1. Windows throws a tantrum – it simply will not save DB/01 schedule.xlsx.
      2. Cross-platform chaos – scripts, cloud sync, zip archives… they all treat the slash as “make a new folder,” not “that’s part of the name.”

      Our naming strategy is meant to be WYSIWYG[1] across drawings, reports, schedules and file names.

      Rule: Never use / or \ in any identifier, view, sheet, or exported file name.

      The Lone Exception – Circuit Naming

      Electrical circuits need to show the “path” from the board to the circuit. We keep that inside Revit parameters only, never in file names.

      • Inside Revit (parameter/annotation):
        DB-01/1L1 – reads as “board DB-01, circuit 1L1”.
      • Exported file name:
        DB-01_1L1_circuitSchedule.xlsx – underscores instead of slashes.
      Table 17 Notice the subtle but crucial tweak
      ContextAllowed Form
      Circuit parameter/tagDB-01/1L1
      Any file name, view name, sheet nameDB-01_1L1

      The underscore _ keeps the board ID glued to the circuit ID without upsetting Windows, macOS, SharePoint, or your friendly BIM coordinator.

      Why

      1. Searchability: Same text string appears on the drawing, in the schedule header, and in the file name. Your desktop search works.
      2. Automation: Batch exports, COBie drops, Dynamo routines – all run without character-encoding hacks.
      Table 18 Quick Reference – Character Do’s & Don’ts
      CharacterStatusExampleNotes
      _ underscorePrimary delimiterDB-01_1L1_layoutAlways safe.
      () round bracketsOptional infolightingLayout_(Emergency)Human-readable.
      [] square bracketsStructured tagsProtectedCorridor[FR120]Use sparingly.
      / slashForbidden in namesDB/01_scheduleOnly inside circuit parameters.
      \ back-slashAbsolutely forbiddenDB\01\scheduleSame reason.

      “Slashes are path separators, not punctuation. Use them in a circuit tag if you must, but never in anything that needs saving, syncing, or emailing. Underscores cost nothing and save hours of forensic file-hunting.”

      [1] WYSWIG – what you see is what you get

      5.0 SYSTEM CLASSIFICATION

      This section explains the six-digit headers that appear at the start of every

      • Revit view-template name
      • Filter name / graphic-override set
      • Project-browser

      These headers let anyone sort or isolate content by system in a single click, while still mapping back to full Uniclass codes for data exchange.

      Why we drop “Ss_” and underscores

      Table 19 - Why we drop “Ss_” and underscores
      ItemFull Uniclass tokenProject headerRationale
      PrefixSs_(removed)Keeps the code numeric so it sorts naturally in both Revit and Windows Explorer.
      Delimiters_ (underscores)(removed)Removed to simplify.
      Contentfirst three numeric pairskeptRetains the hierarchy: Group → Sub-group → Section (e.g. 70 80 33).
      Childrenfourth pairkept only when neededUsed if two sub-systems would otherwise collide (e.g. Lightning = 70302545).

      Net result: the Uniclass string Ss_70_80_33 becomes the lean, human-friendly header 708033.

      We remove nothing that affects traceability; the stripped code still back-maps one-to-one to Uniclass.

      Table 20 – System Classification[1]
      HeaderDescriptionFull Uniclass source
      354000Architectural setting-out (gridlines, control points, datums, levels)Zz_35_40 Gridlines (CAD table)
      757054Lighting control & monitoringSs 75 70 54 10
      708033Lighting (general & emergency)Ss 70 80 33
      703045LV distribution (mains, risers, switchgear)Ss 70 30 45 45
      703080Small power and data outletsSs 70 30 80 (merged per BEP note)
      751021Structured cabling – copper & fibreSs 75 10 21
      751070Audio-visual/public AV systemsSs 75 10 70
      703010Cable containment (tray, ladder, basket)Ss 70 30 10
      755028Fire & smoke detection & alarmSs 75 50 28
      754000Security (access, CCTV, intruder) – parent bucketSs 75 40
      755011Nurse call & medical location systemsSs 75 50 11 57
      703025Earthing, bonding & lightning protectionSs 70 30 25 (children 25/45)
      256030BWIC – service penetrations & fire-stoppingSs 25 60 30 (building fabric)
      404015Combined services - coordination drawingsPM 40 40 15 (Project-Mgmt table)
      806800PD Standard reserved code! 80=P in ASCII, 68=D in ASCII, 00=NULn/a

      6.0 VIEW TEMPLATES

      6.1 View Templates Naming Strategy

      Table 21 View Templates Naming Strategy
      PDcode[5]SystemClassification[6]view series [7][5]Description[8] [5]Optional Information in Parentheses ()[5]version
      PD_XXXXXXXX_XX_XX_xX

      [5] Delimiter Underscore (U+0332).

      [6] Delimiter Hyphen-Minus (U+002D).

      [7] See section 2.9.1 Series prefix XX to distinguish layout from sections while maintaining consistency

      [8] Use camelCase or hyphens to separate words in View-Description

      6.2 Text Styles in the PD Revit Electrical Template — Quick Guide

      Structure of a Style Name

      Every text style follows the same structure

      PD_<Height><mm>_<Colour>_<Weight>_<Background>_<Font Family>

      Table 22 Text Style Name
      TokenMeaningExample
      PDTemplate prefix – identifies it as oursPD_…
      HeightPrinted text height in millimetres2.5mm
      ColourOutput colour (Black or Red)…_Black_…
      WeightBold or omitted (regular)…_Bold_…
      OpaqueBackground mask on…_Opaque_…
      Font FamilyIBM Plex Sans flavourIBM Plex Sans Condensed

      Rule of thumb: Pick the height first (legibility), then colour/weight for emphasis, then condensed or regular to hit the available space.

      Table 23 When to Use Which Size
      SizeTypical UseStyles Available
      1.5mmTightest dims, leader notes inside symbolsPD_1.5MM_Black
      2.0mmSchedules, tagging in crowded viewsPD_2.0mm_Black_Condensed
      2.5mmGeneral notes, keynotes, circuit IDsRegular / Bold / Condensed / Red Bold / Opaque
      3.0mmEquipment labels, panel titles, sub-headingsRegular / Bold
      3.5mmView titles, section headsBold only
      5.0mmSheet titles, major drawing headingsRegular / Bold
      7.5mmCover sheet project titles, big disclaimersRegular / Bold

      Colour & Weight Guidance

      • Black Regular – default for everything that isn’t yelling.
      • Black Bold – headings, titles, anything that needs hierarchy.
      • Red Bold (2.5 mm only)revision-cloud tags or critical warnings; never for permanent production text.
      • Opaque – masks busy backgrounds (e.g., text over hatch) without hacking in white-mask regions.

      Font Choice: Regular vs Condensed

      • Regular IBM Plex Sans – easier on the eye; use unless space is genuinely tight.
      • Condensed – schedules, legends, or switchboard layouts where column width is at a premium.

      If you’re thinking of mixing Regular and Condensed in the same note, take a breath, have a coffee, and rethink.

      Golden Rules

      1. Do not create new text styles – these cover every foreseeable need.
      2. Maintain WYSIWYG – what you see on the drawing should read the same in schedules and exported PDFs.
      3. Keep annotations short, factual, and technical – the style hierarchy handles emphasis; words needn’t shout.
      4. Never override colour or weight per instance – choose the correct style instead.
      5. Background mask? Use the _Opaque style, not manual masking regions.

      Cheat Sheet for New Starters

      Pick the smallest legible height for your note, default to Black Regular IBM Plex Sans, and escalate through Bold, Condensed, Opaque, or Red only when the layout or spec truly demands it.
      Stick to these predefined styles and the entire project, drawings, schedules, PDFs, stays clean, searchable, and coordination-proof.

      6.3 Dimension Styles — “Measure Twice, Model Once”

      Dimension Styles in a Nutshell.

      All dimension types [linear, radial, diameter, angular, even arc-length] use a single 2.5 mm text height and the same naming syntax: PD_DIM_2.5MM_<TYPE>_<STD/ACC>_<Font>

      Pick the STD version for anything that will be published (project rounding, black text) and flip to the ACC version when you need forensic accuracy checks (five decimal places, red & bold IBM Plex Sans Condensed).
      Never override units by hand; never invent new styles. Draw with STD, audit with ACC, hide or delete the red numbers before publishing.
      In short: “STD to publish, ACC to interrogate – if you can count five decimals, you’re still in draft.”

      We keep dimension styles lean-and-mean: one text height, two accuracy levels, four geometry types.


      If you can’t find the right style in this list, you’re either measuring the wrong thing or inventing work for yourself.

      Table 24 Dimension Styles
      Style NameDimension FamilyPurposeUnits & RoundingFont
      PD_DIM_2.5MM_LINEAR_STD_IBM Plex SansLinear / Arc lengthPublished lengths & offsetsProject defaultIBM Plex Sans
      PD_DIM_2.5MM_RADIUS_STD_IBM Plex SansRadialPublished radii & bendsProject defaultIBM Plex Sans
      PD_DIM_2.5MM_DIAMETER_STD_IBM Plex SansDiameterPublished diameters (luminaires, ducts)Project defaultIBM Plex Sans
      PD_DIM_2.5MM_ANGLE_STD_IBM Plex Sans CondensedAngularPublished angles (bracket swings, beam spreads)Project defaultIBM Plex Sans Condensed
      PD_DIM_2.5MM_LINEAR_ACC_IBM Plex Sans CondensedLinear / Arc lengthAccuracy check — clash tolerances5 dpCondensed
      PD_DIM_2.5MM_RADIUS_ACC_IBM Plex Sans CondensedRadialAccuracy check — tight radii audits5 dpCondensed
      PD_DIM_2.5MM_DIAMETER_ACC_IBM Plex Sans CondensedDiameterAccuracy check — critical bores5 dpCondensed
      PD_DIM_2.5MM_ANGLE_ACC_IBM Plex Sans CondensedAngularAccuracy check — fractional-degree checks5 dpCondensed

      Why the “Condensed” font for ACC styles?
      Five-decimal strings are long; Condensed keeps them from trampling your symbols.

      Template Rules

      1. Text height is always 2.5 mm – matches keynotes and general notes.
      2. STD vs ACC
        • STD → project rounding (whole mm or one decimal place).
        • ACC → 5 dp — brutal honesty for QA.
      3. Colour & emphasis
        • STD styles print black.
        • ACC styles print Red (C15959) and Bold – impossible to ignore.
      4. Never override per instance – if you’re tempted to click Override Units… you’re fixing the wrong problem; swap to the ACC style.
      5. Arc-length dimensions pick up the Linear styles. No extra family needed.
      6. Purge ACC dims before you issue – clients don’t want to read 12.00000 mm.

      Naming Strategy

      PD_DIM_2.5MM_<TYPE>_<STD/ACC>_<FontFamily>

      • PD_DIM  Template ID
      • 5MM  Text height
      • <TYPE>  LINEAR · RADIUS · DIAMETER · ANGLE
      • <STD/ACC> Accuracy level
      • <FontFamily> IBM Plex Sans (Condensed where space is tight)

       

      60-second Workflow

      1. Draw with STD styles.
      2. Switch to ACC styles for auditing
      3. Review values; fix the model, not the dimension.
      4. Delete/hide ACC dimensions.
      5. Publish – sheets show only clean, rounded STD values.

      One button-swap; zero nasty surprises on site.

       

      Cheat Sheet:
      “STD to publish, ACC to interrogate. If a number shows five decimals in red, you’re still in the draft.”

       

      6.4 Revision Symbol

      The Canonical Snippet

      If you ask most designers for “the placeholder text,” they’ll give you the first sentence of that Latin mash-up:

      “Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.”

      (If you’re curious, a loose English rendering starts “Pain itself is very important to us…” — oddly poetic for Distribution board Lipsum Hub Blog.)

      7.0 DOCUMENT NAMING STRATEGY

      All information in the PD Revit Template follows PROJECT DESIGN (IO) standards which have been described in detail in our DOCUMENT NAMING STRATEGY.

      Table 25 - Information Container Identifier
      Project No[1]Originator[1]Functional Breakdown[1]Spatial Breakdown[1]Form[1]Discipline[1]Number[2]Title / Description
      XXXX(XX)-XX(X)-XX-XX-X(X)-X-XXYYY_Drawing

      Please follow the link for more details: DOCUMENT NAMING STRATEGY.

      Leave a Reply

      Your email address will not be published. Required fields are marked *

      share this page

      “The inner radius of a conduit bend should be not less than 2.5 times the outside diameter of the conduit.” On-Site Guide 18th A2, Comment under Table E3