> For the complete documentation index, see [llms.txt](https://docs.enercalc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enercalc.com/efr-user-manual/calculation-types/working-with-beam-calculations/wood-beam-calculations24/assigning-material-properties/assigning-single-element.md).

# Assigning To Single Element

How to assign NDS wood material properties, species, size class, grade, and ply quantity to a single beam element in ENERCALC for Revit.

When the user chooses to select only a single element during the "Edit Wood Materials" launch, the menu will populate with one section set. If there are no material properties currently assigned to the element, then the "Current Material" display in the section set table will be blank:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-a83c59125e50e4dbcc17215b184c28b3e19942d8%2Fclip0679.png?alt=media)

If the selected element already has wood properties assigned to it, then the existing properties will be displayed when the menu loads:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-168790231d0d6dbc71ea26a6590aaf4723c4a698%2Fclip0692.png?alt=media)

The table also displays the section type and section name. The section type and name displayed in the table are based on the family name and section name of the Revit element. It is advisable to use default Revit families for wood structural framing or ensure that family and section naming is identical to the default naming. Inability to match family and section names to NDS standard types and sections will prevent the material edit menu from functioning properly:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-548d8658a55a7411ce304792b178ca0c5c4a2d71%2Fclip0693.png?alt=media)

If the family name is recognized, the table automatically displays a list of eligible NDS tables that are compatible with the selected section.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-aa15612d086804897961d1feb6bf419405856175%2Fclip0683.png?alt=media)

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-b2227dfe9210306f9dc81541a3b09cc6ae895917%2Fclip0681.png?alt=media)

In cases where there is only one eligible NDS table, the only available option will be selected automatically, and the species options found in that NDS table will be displayed:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-7aaa36193a81bf5c7c4d9c10a51073cedffc4de5%2Fclip0682.png?alt=media)

In cases where more than one table is available, the species table will populate AFTER an NDS table is selected:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-7c9c1d8df77f689754dd791cafc287a0b8bf7d69%2Fclip0684.png?alt=media)

If a different NDS table is selected, the species options will update accordingly:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-58a5701d57d395947c166fc1f01323ca06aaf3ff%2Fclip0685.png?alt=media)

Once a wood species has been selected, the Size Class table will automatically populate with the associated NDS size classifications:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-157dac4998b8a0e49ed1133624f43eb1df7dc8a1%2Fclip0686.png?alt=media)

In cases where there is only one eligible NDS size classification, the only available option will be selected automatically, and the commercial grades found in that NDS table will be displayed:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-a6d8348df53943390e658190871749bbbaf8b406%2Fclip0687.png?alt=media)

In cases where more than one size classification is available, the grade table will populate AFTER an NDS size class is selected:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-5366da8bd6e3b322e8aac2fbebd08760de57116c%2Fclip0688.png?alt=media)

Once a commercial grade option has been selected, the "Current Material" field in the section set table will show a summary of the complete material definition the user has selected:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-549506bbf50c1dde27990542f995ca006a2c4aa0%2Fclip0689.png?alt=media)

Where applicable, the user may also choose to modify the "Ply Qty" value to create a design where multiple sections are used together to achieve structural performance. In structural design practice, this is predominately done with dimensional lumber and occasionally with certain engineered sections (i.e., LVLs). The ply quantity may be directly modified using the corresponding cell in the table. For more detail on this topic, refer to [Multiple Ply Beams](/efr-user-manual/calculation-types/working-with-beam-calculations/wood-beam-calculations24/multiple-ply-beams.md).

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-41c8a49b30c5be9af694c003499a0bad863b3eba%2Fclip0694.png?alt=media)

Changing the ply quantity does not have any influence over the physically modeled beam instance. It does not change the 2D or 3D graphics of the beam, nor does it alter the total number of actual beams modeled in the Revit project. It is purely a numerical parameter that allows ENERCALC for Revit to communicate the gross section geometry to ENERCALC when building the calculation. If desired, the parameter may also be referenced in schedules or quantity take-offs, since it is a Revit "Shared Parameter". For further reading on this topic, refer to "Wood Beam Tagging". (ed note: link removed temporarily). Users should also be aware that modifying the ply quantity on a section type for which ENERCALC does not support multi-ply configurations (i.e., glulam beams) will result in an error when attempting to launch the calculation.

Alternatively, a design team may choose to use custom beam sections which represent accurate geometry and graphical appearance of a multiple-ply beam. In such cases, the multiple-ply beam sections should be named using the exact convention as that used in ENERCALC in order to ensure interoperability.

Once the definition is complete, clicking the "Apply" button will apply the chosen material properties to the Revit beam element. Clicking "Apply" when the definition is incomplete will have no effect on the element.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-dd09d1250048fbac79c153937ed73b13ee262d4d%2Fclip0690.png?alt=media)

After the "Apply" button is clicked, the window will close and the material properties will be visible in the Revit "Properties" pane for the beam:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-8ff04a50417f4f095d016bf5902292c6fb50a349%2Fclip0691.png?alt=media)

Users should also take note that since wood material property information is stored using Revit's native "Shared Parameter" framework, the parameters are exposed to view and possible removal by any team member. Removal of the underlying parameter that stores this information will result in loss of design data and will render ENERCALC for Revit unable to launch Wood Beam calculations in the project. Revit's native management tools for parameters include a warning on this topic:

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-2474e996465418a26d73c978774fde5628ef5cab%2Fclip0696.png?alt=media)

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-dd679f731939212c1ef74509e0e14444f9fd111c%2Fclip0697.png?alt=media)

In the event that these parameters are removed from a project, the parameters themselves will be re-generated automatically by ENERCALC for Revit the next time the `.rvt` file is opened. Any material properties formerly stored in the parameters will need to be manually repopulated using the "Edit Wood Material" menu.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.enercalc.com/efr-user-manual/calculation-types/working-with-beam-calculations/wood-beam-calculations24/assigning-material-properties/assigning-single-element.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
