https://github.com/dynamods/refinerytoolkits
The Autodesk Refinery Toolkit
https://github.com/dynamods/refinerytoolkits
Last synced: about 1 year ago
JSON representation
The Autodesk Refinery Toolkit
- Host: GitHub
- URL: https://github.com/dynamods/refinerytoolkits
- Owner: DynamoDS
- License: apache-2.0
- Created: 2019-03-10T18:08:07.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-17T14:59:39.000Z (about 1 year ago)
- Last Synced: 2025-03-31T14:11:40.926Z (about 1 year ago)
- Language: C#
- Homepage:
- Size: 21.5 MB
- Stars: 49
- Watchers: 21
- Forks: 29
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Refinery Toolkits
A collection of packages to accelerate generative design workflows in [Dynamo](http://www.dynamobim.org) & [Generative Design](https://www.autodesk.com/solutions/generative-design/architecture-engineering-construction) (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](src/SpacePlanning)
## Massing Toolkit
Optimization & design option generation.
[Read more about the MassingToolkit](src/MassingSandbox)
[Read more about the MassingToolkit for Revit](src/MassingRevit)
# 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`](./samples) 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](https://github.com/DynamoDS/RefineryToolkits/releases)
- Unzip the downloaded file, we recommend using [7zip](https://www.7-zip.org/download.html).
- Once unzipped, double-check that all `.dll` files in the package's `bin` folder have been [unblocked](https://blogs.msdn.microsoft.com/delay/p/unblockingdownloadedfile/).
- 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
[](docs/CODE_OF_CONDUCT.md)
Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details on how to contribute to this package.
Also note that this project is released with a [Contributor Code of Conduct](docs/CODE_OF_CONDUCT.md). 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](./LICENSE) for details.
### Packages used
This project uses the third-party packages listed below, whose licenses are available in the [docs](docs) folder as per their MIT license requirements.
- [Graphical](https://github.com/alvpickmans/Graphical)
- [MIConvexHull](https://github.com/DesignEngrLab/MIConvexHull)
- [3DContainerPacking](https://github.com/davidmchapman/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.