If you have any suggestions for the primer, we will gladly review them. You can submit your comments by clicking on the following link:
If you have an example you would like to submit, please create a pull request in GitHub containing your workflow. You can do this by:
Place all necessary files for your workflow in a .zip file.
Name your file using the following format:
[Author's last name (the first three letters only, capitalized)]_[Short description of workflow].zip
Create a pull request by adding this .zip file to the following folder:
Make sure your file runs on the last version of Refinery and Revit.
In your file, please include:
your Dynamo file
a brief Description of your example
the Revit file from the most recent version (optional)
a video tutorial (optional)
an in-depth description in .PDF format (optional)
Inside the .zip file you just created, create a folder titled: 'Description'
Add a brief description and an image to this folder.
The image should be:
size: width 720px, height 300px
The brief description should include:
title of workflow
author of script
Dynamo packages required to run script
a description of how the workflow works and why it is useful
an image of the workflow (optional)
links to files uploaded in the
Check the first workflow example (High Performance Building Design Based on Daylight Analysis) as a reference on how to upload files.
To ensure that all sample files presented in this page are easy to understand, we recommend you do take the following steps. There is a beginner template provided below for you to get started with your contribution quickly!
A title block will help the user identify all the requirements needed to run the workflow (Revit version, required dynamo packages, etc.). The title block will also provide a description that will help explain what the workflow does and how is it useful.
You can copy a panel from an existing document and change the information in it so it suits your workflow
Organizing nodes into groups will help the user to understand how the workflow is structured. Groups should have comments that indicate the general purpose of the group of nodes.
We use a consistent color pallet through out our workflows. Don't forget to use this color pallet in your workflow.
Using templates in Dynamo is a good best-practice for making legible, understandable graphs.
For generative design related examples, we have created the following template that encompasses the above ideas.
In addition to the breakdown above, we have provided sample node groupings in the template.
The sample DYN to download is available here: _generative_template.dyn.