Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Revision history [back]

How to create an "empty" OpenStudio model without any default libraries

I am considering using OpenStudio to model complex, prototype residential buildings. (I have chosen OpenStudio over BEopt because BEopt isn't quite suitable for my use case for several reasons.)

Because (as far as I can tell) a comprehensive library of low-rise residential components is still not available in the Building Component Library and because none of the default OpenStudio libraries are intended for low-rise residential buildings, I would like to start with a blank slate when I create a new OpenStudio model. In other words, I would like to start without default libraries. What is the recommended way to do this?

Here is what I have discovered so far (please correct me if I am wrong):

  • The two libraries (hvac_libarary.osm and office_default.osm) located in the Resources/default/ folder are automatically loaded.
  • Removing them in the Preferences > Change Default Libraries dialog doesn't work because they automatically reappear when I reopen Change Default Libraries and they still populate the Library tab. I assume this happens because the app automatically loads everything in the default/ folder.
  • When I manually remove the hvac_library.osm and office_default.osm files from the default/ folder and then try to repeat the step above, I get a "Failed to load the following libaries..." error that references these same files. If I acknowledge the error a few times, it eventually goes away and the library contents are removed from the Library tab on the right side of the interface.
  • When I create a new OpenStudio model after manually removing the two aforementioned files, these file paths still appear in the Change Default Libraries dialog, but the library contents do not appear in the Library tab.

Am I using the best possible approach to start with an "empty" OpenStudio model? Eventually, I would like to populate the Libarary with my own custom residential libraries that I create in BCL, but I do not want the Library tab to be "contaminated" with library contents that will never be used.

How to create an "empty" OpenStudio model without any default libraries

I am considering using OpenStudio to model complex, prototype residential buildings. (I have chosen OpenStudio over BEopt because BEopt isn't quite suitable for my use case for several reasons.)

Because (as far as I can tell) a comprehensive library of low-rise residential components is still not available in the Building Component Library and because none of the default OpenStudio libraries are intended for low-rise residential buildings, I would like to start with a blank slate when I create a new OpenStudio model. In other words, I would like to start without default libraries. What is the recommended way to do this?

Here is what I have discovered so far (please correct me if I am wrong):

  • The two libraries (hvac_libarary.osm and office_default.osm) located in the Resources/default/ folder are automatically loaded.
  • Removing them in the Preferences > Change Default Libraries dialog doesn't work because they automatically reappear when I reopen Change Default Libraries and they still populate the Library tab. I assume this happens because the app automatically loads everything in the default/ folder.
  • When I manually remove the hvac_library.osm and office_default.osm files from the default/ folder and then try to repeat the step above, I get a "Failed to load the following libaries..." error that references these same files. If I acknowledge the error a few times, it eventually goes away and the library contents are removed from the Library tab on the right side of the interface.
  • When I create a new OpenStudio model after manually removing the two aforementioned files, these file paths still appear in the Change Default Libraries dialog, but the library contents do not appear in the Library tab.

Am I using the best possible approach to start with an "empty" OpenStudio model? Eventually, I would like to populate the Libarary with my own custom residential libraries that I create in BCL, but I do not want the Library tab to be "contaminated" with library contents that will never be used.