Link Search Menu Expand Document

Release Notes and Known Issues

Version 0.4.0

  1. If the CLI installation stalls on the openstudio-standards gem: 1) exit out of the installation, 2) install openstudio-standards by itself, 3) rerun the CLI install command:

     gem install openstudio-standards
     gem install urbanopt-cli
  2. This version contains a known bug related to the feature CSV reports and the scenario-level SQL database. It is recommended that you upgrade to version 0.4.1.

  3. URBANopt SDK version 0.4.0 includes OpenDSS support via the URBANopt CLI. Windows users may experience errors detecting python and urbanopt-ditto-reader when using the opendss CLI command. If you are not able to run OpenDSS through the CLI, the functionality is also available manually by following the general OpenDSS instructions.

  4. SQLITE/WINDOWS issues: The sqlite3 gem contains native extensions and sometimes causes installation errors for WINDOWS users. To resolve, ensure your ruby version is installed with “MSYS2 and MINGW development toolchain” (option 3 during installation) and that the following command succeeds before installing the CLI:

         gem install sqlite3 -v 1.4.2
  5. The residential workflows currently only support the Single-Family Detached building type in the Baseline Scenario and have not been tested exhaustively. Single-Family Attached and lowrise Multifamily building types will be added in future releases of the URBANopt SDK. Review the modeling notes on the residential workflows page. Please submit a bug report via the URBANopt GitHub Issues Page if you run into any issues.

Version 0.2.0

  1. New example project files: The URBANopt™ SDK version 0.2.0 release comes with new files for the example project (new mappers and a new base_workflow.osw file). For compatibility purposes and to use all new features, you may want to update any existing projects with these new files. The example project can be installed via the CLI with the following command:

        uo create --project-folder <path/to/PROJECT DIR> 
  2. Project filepath length issue: Users (windows users especially) may run into an error while running URBANopt. The error will be encountered either when running ‘bundle install’ in the project directory or in the in.osw.log file of a specific feature simulation and will look like this: Errno::ENOENT: No such file or directory @ rb_sysopen – This will occur during installation of either the openstudio-standards gem or the model-articulation gem. This error occurs because the filepath to your project directory is too long. Move the directory to a shallower path on your system and try again.

  3. Walk-in refrigeration modeling: The “create_typical_building_from_model” measure in the model articulation gem that supports OpenStudio 2.9.1 adds in capability for modeling walk-in refrigeration to a select number of space types. However, this functionality requires discrete space types to be modeled, and not a whole building or whole story blended space types. As a result, when using the default URBANopt workflow that models a blended space type based on the GeoJSON footprints, the new functionality will not be enabled. If a workflow using the GeoJSON floor area and number of floors is used with the create_bar_from_building_type_ratios measure, then walk-in refrigeration can be added in URBANopt using this version of the model articulation gem.

  4. URBANopt CLI users may see 2 lines of warning regarding DEVELOPER_NREL_KEY. This does not affect operation in any way. A future patch will remove the warning.

  5. Some users may experience issues with running the CLI from within the project directory. Try moving to a higher directory and using absolute or relative paths to the feature_file (-f) and scenario CSV (-s).

  6. Many warnings get printed to the terminal when calling the URBANopt CLI from inside your project directory. The work-around to avoid these warnings is to move outside the project directory and use absolute or relative paths when calling URBANopt commands. A hypothetical example: uo run -s ~/user/uo-project-directory/baseline_scenario.csv -f ~/user/uo-project-directory/example_project.json

URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other contributors. All rights reserved.