Update a Study Type

Make changes to a study type for Generative Design in Revit to refine its logic or regenerate its Dependencies folder.

  1. Open the study type in Dynamo using one of the following methods:
    • Using Generative Design in Revit:
      • You may also open the study type this way while Dynamo is running. If you already have another graph open in Dynamo, you may see a message asking if you'd like to save changes to that graph.
    • Using Dynamo:
      1. In Revit, click Manage tabVisual Programming panelDynamo .
      2. In the Dynamo window, under Files, click Open.
      3. Navigate to the location where the study type resides, select its DYN file, and click Open.
  2. Make desired changes to the graph and test them.

    See these resources:

  3. In the Dynamo menu bar, click Generative DesignOpen Generative Design Tools.
  4. If the tools pane displays "Run graph to finalize validation," click Run in the bottom left corner of the window.

    This allows Dynamo to validate the graph before creating or updating the study type.

  5. If the tools pane lists any issues, resolve them before proceeding.

    For example, you may need to set nodes as inputs or outputs, or fix name conflicts. See Troubleshoot: Errors for Generative Design in Dynamo and Generative Design Primer: Setting up a Graph.

    Click the Issues tab of the tools pane for details. Click links in the issue descriptions to go to the relevant section of the graph. Make required changes, and re-run the graph.

  6. When all issues are resolved, do the following:
    • Clear cached data: Select this option when others will use the study type to create studies using a different Revit model than the one used by the author of the Dynamo graph, or if you want to encourage others to select new data or components from the Revit model. The option removes any data in the study that's specific to the Revit model you have been using to test the graph. When someone creates a study, they are prompted to select new data in their current model.

      Turn off this option to retain any data in the study that's specific to the Revit model you have been using with the graph. When someone creates a study, it uses this data unless they specifically change it.

    • Include file dependencies: Select this option when you are ready to share the study type with others. The option copies any files referenced by an input node in the graph into the Dependencies folder for the study.

      Turn this option off if you are not planning to share the study type with others or if you will be making additional changes to the files referenced in the graph.

    • Description: Enter text to describe the purpose or use case for the study type. This information appears in the Create Study dialog.
    • Image: Add an image (PNG or JPEG) for the study type, such as a thumbnail from a sample outcome. Click in the field to navigate to the desired image, or drag and drop an image. On the Create Study dialog, the image is resized and cropped to a square to fit in the card for the study type.
      Note: Use PNG files or medium- to low-resolution JPEG files. High-resolution JPEG files can cause issues.
  7. Click Update Study Type at the bottom of the Study Type tab. The study type is updated with the changes to its graph (DYN file) and any associated metadata.