Chapter 3.2

User Compliance Data

Compliance data (referred to as user data in previous sections) is a set of .csv files with fixed format. The data can be used in the ASHRAE 90.1-2019 PRM method to provide additional information that cannot not be found in an OpenStudio model (e.g., motor_power). The compliance data can improve the accuracy of the PRM model.

Now, these set of data can be also arranged in a JSON Schema following the schema set provided in the .json files.

SON Schema is a powerful tool for validating the structure and content of JSON data. It defines the expected format of JSON documents, providing a clear, structured way to ensure that data adheres to a defined set of rules. Unlike the .csv files, JSON Schema files are not the ones to fill in data, rather they server as as documentation and guideline to structure the data.

For example, a JSON Schema is defined as:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Product",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    }
  },
  "required": ["id", "name", "price"]
}

Following the data rules in the schema, the user shall provide jsons looks like the one below to meet the data validation requirements.

{
  "id": 1,
  "name": "Widget",
  "price": 25.99
}

Currently there are 9 .csv and .json files in the compliance data set. Each of them covers a specific set of ASHRAE 90.1-2019 compliance data to OpenStudio object. This chapter will provide the detailed explaination on each of the files.