Installation and update instructions

Installation instructions

1. Close every instance of Rhino, Excel, Revit that you have open.
2. Run BHoM Installer, which you can download from https://bhom.xyz. When you download it, if you get any security warning, please ignore it. In your browser, choose "keep anyway". When opening the installer, please select "More info" and then "Install anyway".
3. Download the installer zip file from the "Assets" section of the latest release.
4. Unzip the zip anywhere and run Run_installer.bat (this will fetch additional files from GitHub and add them to the BHoM installation folder).
   A command window should pop up informing you about the progress and success of the installation.

   You may get a windows defender message that can be bypassed by clicking on on More info and Run anyway.

🤖 Note for Developers

You can replace step 3 and 4 with cloning and compiling the VS solution contained in this repo.

There's a Post Build Event that copies the needed assemblies into the BHoM installation folder.

Optional additional steps

The following steps enable additional functionality that may be useful when creating ontologies with this toolkit.

5. Install Github Desktop if you don't have it. Clone the main BHoM repo on your machine by going in: https://github.com/BHoM/BHoM and then click the green button "Code" -> Open Github Desktop. This will download the main BHoM repo in some folder on your machine. From Github desktop, you can check the folder where the BHoM repo is stored by clicking "Show in explorer" or pressing CTRL+Shift+F.

6. Go in the Grasshopper examples folder in this repo and grab any Grasshopper example file and open it.

7. The example may give you an error related to "could not find local repository". Please specify the parent directory where the BHoM repository is stored (one folder up from the folder of step 5) to the input GitRootPath of the component called LocalRepositorySettings, see this example.

8. At this point, the example file should work with no error.

   • If you still have the "local repository" issue from the previous step, make sure you are specifying the correct folder in the LocalRepositorySettings component. See the previous step instructions. The folder path must be the path of the parent folder of the BHoM folder.
   • If you cannot see BHoM components when you open the example .gh file, the installation likely went wrong. Please Uninstall BHoM from Windows control panel and start from scratch.

Update instructions

If you have RDF_Prototypes working on your machine but you want to update it to the latest commit, please repeat step 3 and 4.