2.38.01 - Updated Defaults and Validation Ranges

Building on our schema updates from last week, we have improved some defaults used in the model to reflect the building's region and use type. These changes are  summarized below and reflected in updates to our documentation.
There is no change in values between this version and the previous version (except where using the default values) and no breaking changes. 
Regionalized Insulation Values
The default R-value of the opaque wall assembly is now set in relation to the building's climate zone. As with other characteristics of the envelope, it can be overridden using the "description" field of the envelope.cladding
 request object.
The default R-values here are recorded in our documentation. 
Improved Floor-to-Floor Height Defaults
The floor-to-floor height defaults in C.Scale are now a function of use category. Floor to floor (F2F) height can still be set by users for each floor individually (if using the stacked BuildingForm
 object) or for all floors together (in the simple BuildingForm
 object). 
The default floor-to-floor heights here are recorded in our documentation. 
Increased Below-Grade Floors Validation Range
The API now accepts requests with up to 15 floors below-grade. If more than 8 floors are passed, the API raises a warning in the API-messages
 object. 
Addition of 50-Year Reference Period
Danish LCA guidelines require a 50-year reference service life. This has been added as an option to reference_period
. 
Alias "Refurbishment" to "Service Life"
Aligning with emerging standards worldwide, all instances of refurbishment_period
 in the API are now alias'ed to average_service_life
. We will continue to accept both, but recommend API users change over to the new label to stay in alignment with future documentation, as all future Swagger docs will reference the new parameter name. 