Refinery Toolkits

A collection of packages to accelerate generative design workflows in Dynamo & Generative Design (formerly "Refinery").

The toolkits

There are currently 2 packages included in the toolkit, each focusing on enabling specific types of workflows:

• SpacePlanning Toolkit
• Massing Toolkit

Space Planning Toolkit

The toolkit offers a range of nodes that help with general space-planning workflows in Dynamo and Revit.

Read more about the SpacePlanningToolkit

Massing Toolkit

Optimization & design option generation.

Read more about the MassingToolkit

Read more about the MassingToolkit for Revit

Using the toolkits

This repository has quite a few sample files provided to help you get started with each of the toolkits. It is highly recommended to start with the samples as they contain detailed notes and instructions on how to use each of the nodes. Feel free to open an issue or submit a PR if you'd like to see further documentation added here.

You can find the samples in this repository's samples folder folder, as well as and in the extra folder of the package you download using the Dynamo Package Manager, typically found here : %appdata%\Dynamo\Dynamo Revit\2\packages\GenerativeToolkit

The samples shows a simple example of how each node in the toolkit works. Some of the samples will have a Revit version (marked with (RVT)), and some also have a version setup to be used with Generative Design (marked with (RefineryVersion)) :

Structure

The RefineryToolkits is organized in 4 categories, based on their use in a Generative Design process :

• Generate: In this category you can find nodes to help generate design options.
• Analyse: The designs generated in the previous step can now be measured, or analyzed on how well they achieve goals defined by the designer. This category contains nodes to help with that.
• Rank: Based on the results of the analysis, design options can be ordered or ranked. This category has nodes for that.
• Explore: In Explore, nodes that helps visualize result are placed.

Alternative installation methods

Manual install

If you prefer to install one of the more experimental/work-in-progress builds, you can still follow the instructions below.

• Download the latest release from the Releases page
• Unzip the downloaded file, we recommend using 7zip.
• Once unzipped, double-check that all .dll files in the package's bin folder have been unblocked.
• Copy the package folder to the location of your Dynamo packages:
  • %appdata%\Dynamo\Dynamo Core\3.0\packages for Dynamo Sandbox, replacing 3.0 with your version of Dynamo
  • %appdata%\Dynamo\Dynamo Revit\3.0\packages for Dynamo for Revit, replacing 3.0 with your version of Dynamo
• Start Dynamo, the package should now be listed in the library and in Dynamo's Package Manager.

Prerequisites

This project requires the following applications or libraries be installed :

Dynamo : version 3.0 or later

.NET : version 8.0 or later

Please note that only projects with Revit (e.g. MassingRevit) in their name have a dependency on Revit and its APIs. The others will happily run in supported versions of Dynamo Sandbox.

Contributing & code of conduct

Please read CONTRIBUTING.md for details on how to contribute to this package.

Also note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Licensing

This project is licensed under the Apache 2.0 License - see the LICENSE FILE for details.

Packages used

This project uses the third-party packages listed below, whose licenses are available in the docs folder as per their MIT license requirements.

• Graphical
• MIConvexHull
• 3DContainerPacking

We do our best comply with all license conditions and restrictions, so please let us know if you have any questions or spot anything out of order.