openstudio-analysis 1.0.2 → 1.1.0.pre.rc1

data/spec/openstudio/weather_spec.rb

@@ -1,80 +0,0 @@
-# *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2019, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER, THE UNITED STATES
-# GOVERNMENT, OR ANY CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
-# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-# *******************************************************************************
-
-require 'spec_helper'
-
-describe OpenStudio::Weather::Epw do
-  before :all do
-    @s = OpenStudio::Analysis::SupportFiles.new
-    expect(@s).to be_a OpenStudio::Analysis::SupportFiles
-  end
-
-  it 'should process the header of a weather file' do
-    epw = OpenStudio::Weather::Epw.load('spec/files/partial_weather.epw')
-    expect(epw.valid?).to be true
-    expect(epw.city).to eq 'Denver Intl Ap'
-    expect(epw.state).to eq 'CO'
-    expect(epw.country).to eq 'USA'
-    expect(epw.data_type).to eq 'TMY3'
-    expect(epw.wmo).to eq 725650
-    expect(epw.lat).to eq 39.83
-    expect(epw.lon).to eq -104.65
-    expect(epw.gmt).to eq -7.0
-    expect(epw.elevation).to eq 1650.0
-
-    expect(epw.header_data.size).to eq 7
-    expect(epw.weather_data.size).to eq 24
-  end
-
-  it 'should read and write the weather file' do
-    o = 'spec/files/partial_weather.epw'
-    epw = OpenStudio::Weather::Epw.load(o)
-    f = 'spec/files/export/weather/weather_out.epw'
-    File.delete(f) if File.exist? f
-    expect(epw.save_as(f)).to eq true
-    expect(File.exist?(f)).to eq true
-    expect(File.size(o)).to eq File.size(f)
-  end
-
-  it 'should append weather data' do
-    o = 'spec/files/partial_weather.epw'
-    epw = OpenStudio::Weather::Epw.load(o)
-
-    epw.append_weather_data(o)
-
-    f = 'spec/files/export/weather/weather_out_appended.epw'
-    epw.save_as(f)
-  end
-end

data/spec/openstudio/workflow_spec.rb

@@ -1,126 +0,0 @@
-# *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2019, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER, THE UNITED STATES
-# GOVERNMENT, OR ANY CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
-# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-# *******************************************************************************
-
-require 'spec_helper'
-
-describe OpenStudio::Analysis::Workflow do
-  before :all do
-    @w = OpenStudio::Analysis::Workflow.new
-  end
-
-  it 'should create a workflow' do
-    expect(@w).not_to be nil
-    expect(@w).to be_a OpenStudio::Analysis::Workflow
-  end
-
-  it 'should add a measure' do
-    p = 'spec/files/measures/IncreaseInsulationRValueForRoofs'
-    expect(@w.add_measure_from_path('insulation', 'Increase Insulation', p)).to be_an OpenStudio::Analysis::WorkflowStep
-
-    p = 'spec/files/measures/ActualMeasureNoJson'
-    FileUtils.remove "#{p}/measure.json" if File.exist? "#{p}/measure.json"
-    m = @w.add_measure_from_path('a_measure', 'Actual Measure', p)
-    expect(m).to be_a OpenStudio::Analysis::WorkflowStep
-    expect(m.measure_definition_class_name).to eq 'RotateBuilding'
-  end
-
-  it 'should fix the path of the measure' do
-    p = 'spec/files/measures/IncreaseInsulationRValueForRoofs/measure.rb'
-    m = @w.add_measure_from_path('insulation', 'Increase Insulation', p)
-    expect(m).to be_an OpenStudio::Analysis::WorkflowStep
-    expect(m.measure_definition_directory).to eq './measures/IncreaseInsulationRValueForRoofs'
-    expect(m.measure_definition_directory_local).to eq 'spec/files/measures/IncreaseInsulationRValueForRoofs'
-  end
-
-  it 'should clear out a workflow' do
-    p = 'spec/files/measures/SetThermostatSchedules'
-    @w.add_measure_from_path('thermostat', 'thermostat', p)
-    @w.add_measure_from_path('thermostat 2', 'thermostat 2', p)
-
-    expect(@w.items.size).to be > 1
-    @w.clear
-    expect(@w.items.size).to eq 0
-
-    @w.add_measure_from_path('thermostat', 'thermostat', p)
-    @w.add_measure_from_path('thermostat 2', 'thermostat 2', p)
-    expect(@w.items.size).to eq 2
-  end
-
-  it 'should find a workflow step' do
-    @w.clear
-
-    p = 'spec/files/measures/SetThermostatSchedules'
-    @w.add_measure_from_path('thermostat', 'thermostat', p)
-    @w.add_measure_from_path('thermostat_2', 'thermostat 2', p)
-
-    m = @w.find_measure('thermostat_2')
-    expect(m).not_to be nil
-    expect(m).to be_a OpenStudio::Analysis::WorkflowStep
-    expect(m.name).to eq 'thermostat_2'
-  end
-
-  it 'should find a workflow step and make a variable' do
-    @w.clear
-
-    p = 'spec/files/measures/SetThermostatSchedules'
-    @w.add_measure_from_path('thermostat', 'thermostat', p)
-    @w.add_measure_from_path('thermostat_2', 'thermostat 2', p)
-
-    m = @w.find_measure('thermostat_2')
-    expect(m.argument_names).to eq ['__SKIP__', 'zones', 'cooling_sch', 'heating_sch', 'material_cost']
-
-    d = {
-      type: 'uniform',
-      minimum: 5,
-      maximum: 7,
-      mean: 6.2
-    }
-    m.make_variable('cooling_sch', 'Change the cooling schedule', d)
-
-    d = {
-      type: 'uniform',
-      minimum: 5,
-      maximum: 7,
-      mean: 6.2
-    }
-    m.make_variable('heating_sch', 'Change the heating schedule', d)
-
-    expect(@w.measures.size).to eq 2
-    expect(@w.items.size).to eq 2
-    expect(@w.items.size).to eq 2
-
-    expect(@w.all_variables.size).to eq 2
-  end
-end

data/spec/openstudio/workflow_step_spec.rb

@@ -1,158 +0,0 @@
-# *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2019, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER, THE UNITED STATES
-# GOVERNMENT, OR ANY CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
-# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-# *******************************************************************************
-
-require 'spec_helper'
-
-describe OpenStudio::Analysis::WorkflowStep do
-  it 'should create a workflow' do
-    s = OpenStudio::Analysis::WorkflowStep.new
-    expect(s).not_to be nil
-    expect(s).to be_a OpenStudio::Analysis::WorkflowStep
-  end
-
-  it 'should add a measure' do
-    h = 'spec/files/measures/IncreaseInsulationRValueForRoofs/measure.json'
-    s = OpenStudio::Analysis::WorkflowStep.from_measure_hash(
-      'my_instance',
-      'my instance display name',
-      h,
-      JSON.parse(File.read(h), symbolize_names: true)
-    )
-    puts s
-  end
-
-  it 'should tag a discrete variable' do
-    h = 'spec/files/measures/SetThermostatSchedules/measure.json'
-    measure = OpenStudio::Analysis::WorkflowStep.from_measure_hash(
-      'my_instance',
-      'my instance display name',
-      h,
-      JSON.parse(File.read(h), symbolize_names: true)
-    )
-
-    expect(measure.name).to eq 'my_instance'
-    v = {
-      type: 'discrete',
-      minimum: 'low string',
-      maximum: 'high string',
-      mean: 'middle string',
-      values: ['a', 'b', 'c', 'd'],
-      weights: [0.25, 0.25, 0.25, 0.25]
-    }
-    r = measure.make_variable('cooling_sch', 'my variable', v)
-    expect(r).to eq true
-  end
-
-  it 'should tag a continuous variable' do
-    h = 'spec/files/measures/SetThermostatSchedules/measure.json'
-    measure = OpenStudio::Analysis::WorkflowStep.from_measure_hash(
-      'my_instance',
-      'my instance display name',
-      h,
-      JSON.parse(File.read(h), symbolize_names: true)
-    )
-
-    expect(measure.name).to eq 'my_instance'
-    v = {
-      type: 'triangle',
-      minimum: 0.5,
-      maximum: 20,
-      mean: 10
-    }
-    o = {
-      static_value: 24601
-    }
-    r = measure.make_variable('cooling_sch', 'my variable', v, o)
-
-    h = measure.to_hash
-
-    expect(h[:variables].first[:static_value]).to eq 24601
-    expect(h[:variables].first.key?(:step_size)).to eq false
-
-    expect(r).to eq true
-  end
-
-  it 'should tag a normal continuous variable' do
-    h = 'spec/files/measures/SetThermostatSchedules/measure.json'
-    measure = OpenStudio::Analysis::WorkflowStep.from_measure_hash(
-      'my_instance',
-      'my instance display name',
-      h,
-      JSON.parse(File.read(h), symbolize_names: true)
-    )
-
-    expect(measure.name).to eq 'my_instance'
-    v = {
-      type: 'normal',
-      minimum: 0.5,
-      maximum: 20,
-      mean: 10,
-      standard_deviation: 2
-    }
-    r = measure.make_variable('cooling_sch', 'my variable', v)
-
-    h = measure.to_hash
-
-    expect(h[:variables].first.key?(:step_size)).to eq false
-
-    expect(r).to eq true
-  end
-
-  it 'should tag a uniform variable' do
-    h = 'spec/files/measures/SetThermostatSchedules/measure.json'
-    measure = OpenStudio::Analysis::WorkflowStep.from_measure_hash(
-      'my_instance',
-      'my instance display name',
-      h,
-      JSON.parse(File.read(h), symbolize_names: true)
-    )
-
-    expect(measure.name).to eq 'my_instance'
-    v = {
-      type: 'uniform',
-      minimum: 0.5,
-      maximum: 20,
-      mean: 10
-    }
-    r = measure.make_variable('cooling_sch', 'my variable', v)
-
-    h = measure.to_hash
-
-    # puts JSON.pretty_generate(h)
-    expect(h[:variables].first.key?(:step_size)).to eq false
-
-    expect(r).to eq true
-  end
-end

data/spec/schema/osa.json

@@ -1,613 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "description": "JSON Schema for the OpenStudioAnalysis File Type",
-  "type": "object",
-  "properties": {
-    "analysis": {
-      "$ref": "#/definitions/Analysis"
-    }
-  },
-  "required": [
-    "analysis"
-  ],
-  "additionalProperties": false,
-  "definitions": {
-    "Output": {
-      "description": "Hash",
-      "type": "object",
-      "properties": {
-        "units": {
-          "description": "Haystack compliant unit string, or empty string if not applicable",
-          "type": "string"
-        },
-        "objective_function": {
-          "description": "Determines if output is part of an objective function",
-          "type": "boolean"
-        },
-        "objective_function_index": {
-          "description": "Key used to define multi-objective functions, null if not applicable",
-          "type": "number"
-        },
-        "objective_function_target": {
-          "description": "Key used to define target of the objective function, null if not applicable",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "objective_function_group": {
-          "description": "Optional key used to define multi-objective functions",
-          "type": "number"
-        },
-        "scaling_factor": {
-          "description": "????",
-          "type": "null"
-        },
-        "display_name": {
-          "description": "User facing name of objective which must be unique",
-          "type": "string"
-        },
-        "display_name_short": {
-          "description": "User facing name less that 20 characters",
-          "type": "string"
-        },
-        "metadata_id": {
-          "description": "??????",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "name": {
-          "description": "Snake cased output machine name",
-          "type": "string"
-        },
-        "visualize": {
-          "description": "Determines if variable will be include in plots on the server",
-          "type": "boolean"
-        },
-        "export": {
-          "description": "?????",
-          "type": "boolean"
-        },
-        "variable_type": {
-          "description": "Allowed values of 'string', 'bool', or 'number'",
-          "type": "string"
-        }
-      },
-      "required": [
-        "units",
-        "objective_function",
-        "objective_function_index",
-        "objective_function_target",
-        "scaling_factor",
-        "display_name",
-        "metadata_id",
-        "name"
-      ],
-      "additionalProperties": false
-    },
-    "Algorithm Attributes": {
-      "title": "algorithm",
-      "description": "Hash of attributes associated with the analysis_type",
-      "type": "object",
-      "additionalProperties": {
-        "description": "Attributes defined by analysis type"
-      }
-    },
-    "Argument": {
-      "title": "argument",
-      "description": "Individual argument instance",
-      "type": "object",
-      "properties": {
-        "display_name": {
-          "description": "User-facing display name which must be unique",
-          "type": "string"
-        },
-        "display_name_short": {
-          "description": "Optional user-facing display name under 20 characters",
-          "type": "string"
-        },
-        "name": {
-          "description": "Machine readable snake-cased name of argument as defined in the measure.xml",
-          "type": "string"
-        },
-        "value_type": {
-          "description": "Accepts inputs of 'string', 'bool', and 'number'",
-          "type": "string"
-        },
-        "default_value": {
-          "description": "Default value for argument, if defined in the measure.xml file",
-          "type": [
-            "string",
-            "number",
-            "boolean"
-          ]
-        },
-        "value": {
-          "description": "Value to set argument to in analysis",
-          "type": [
-            "string",
-            "number",
-            "boolean"
-          ]
-        },
-        "machine_name": {
-          "description": "????",
-          "type": "string"
-        },
-        "uuid": {
-          "description": "UUID for the measure from the measure.xml",
-          "type": "string"
-        },
-        "version_uuid": {
-          "description": "UUID for the measure version form the measure.xml",
-          "type": "string"
-        }
-      },
-      "required": [
-        "display_name",
-        "name",
-        "value",
-        "machine_name",
-        "uuid",
-        "version_uuid"
-      ],
-      "additionalProperties": false
-    },
-    "Workflow Step": {
-      "description": "Individual measure definition",
-      "type": "object",
-      "properties": {
-        "name": {
-          "description": "Snake-cased machine readable measure name which must be unique",
-          "type": "string"
-        },
-        "display_name": {
-          "description": "User facing measure name which must also be unique",
-          "type": "string"
-        },
-        "measure_type": {
-          "description": "Accepts values of 'Ruby' 'EnergyPlus' and 'Reporting'",
-          "type": "string"
-        },
-        "description": {
-          "description": "Measure description",
-          "type": "string"
-        },
-        "taxonomy": {
-          "description": "Measure taxonomy tag",
-          "type": "string"
-        },
-        "measure_definition_class_name": {
-          "description": "Class name of measure.rb file",
-          "type": "string"
-        },
-        "measure_definition_directory": {
-          "description": "??",
-          "type": "string"
-        },
-        "measure_definition_directory_local": {
-          "description": "Local path to the measure directory",
-          "type": "string"
-        },
-        "measure_definition_display_name": {
-          "description": "?????",
-          "type": "string"
-        },
-        "measure_definition_name": {
-          "description": "?????",
-          "type": "string"
-        },
-        "measure_definition_name_xml": {
-          "description": "?????",
-          "type": "null"
-        },
-        "measure_definition_uuid": {
-          "description": "UUID of measure in measure.xml",
-          "type": "string"
-        },
-        "measure_definition_version_uuid": {
-          "description": "UUID of measure version in measure.xml",
-          "type": "string"
-        },
-        "arguments": {
-          "$ref": "#/definitions/Argument Array"
-        },
-        "variables": {
-          "$ref": "#/definitions/Variable Array"
-        },
-        "workflow_index": {
-          "description": "Index in workflow array, indexing from 0",
-          "type": "number"
-        },
-        "workflow_step_type": {
-          "description": "???????",
-          "type": "string"
-        },
-        "version_uuid": {
-          "description": "UUID of measure version from the measure.xml",
-          "type": "string"
-        },
-        "uuid": {
-          "description": "UUID of measure from the measure.xml",
-          "type": "string"
-        }
-      },
-      "required": [
-        "name",
-        "display_name",
-        "measure_type",
-        "measure_definition_class_name",
-        "measure_definition_directory",
-        "measure_definition_uuid",
-        "measure_definition_version_uuid",
-        "arguments",
-        "variables",
-        "workflow_index",
-        "workflow_step_type",
-        "version_uuid",
-        "uuid"
-      ],
-      "additionalProperties": false
-    },
-    "Uncertainty Definition": {
-      "title": "uncertainty_description",
-      "description": "Set of attributes defining the variability of the input",
-      "type": "object",
-      "properties": {
-        "type": {
-          "description": "Uncertainty type, accepting values of 'triangle', 'uniform', 'discrete', and 'normal'",
-          "type": "string",
-          "oneof": [
-            "triangle",
-            "uniform",
-            "normal",
-            "discrete"
-          ]
-        },
-        "attributes": {
-          "$ref": "#/definitions/Distribution Definition"
-        }
-      },
-      "required": [
-        "type",
-        "attributes"
-      ],
-      "additionalProperties": false
-    },
-    "Design Alternative": {
-      "description": "Individual design alternative instance",
-      "type": "object",
-      "properties": {
-        "name": {
-          "description": "Name of design alternative",
-          "type": "string"
-        },
-        "description": {
-          "description": "Description of design alternative",
-          "type": "string"
-        },
-        "seed": {
-          "$ref": "#/definitions/Seed Object"
-        },
-        "options": {
-          "description": "Each option corresponds to one WorkflowStep (i.e. Measure).  Options are listed in order",
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "measure_name": {
-                "description": "Name of the measure in this workflow",
-                "type": "string"
-              },
-              "workflow_index": {
-                "description": "Index of the measure in the workflow",
-                "type": "number"
-              },
-              "name": {
-                "description": "Name of the user specified option",
-                "type": "string"
-              },
-              "description": {
-                "description": "Description of the user specified option",
-                "type": "string"
-              }
-            },
-            "additionalProperties": false
-          }
-        }
-      },
-      "required": [
-        "name",
-        "description"
-      ],
-      "additionalProperties": false
-    },
-    "Variable": {
-      "description": "Individual variable instance",
-      "type": "object",
-      "properties": {
-        "argument": {
-          "$ref": "#/definitions/Argument"
-        },
-        "display_name": {
-          "description": "User-facing display name which must be unique",
-          "type": "string"
-        },
-        "display_name_short": {
-          "description": "Optional user-facing name under 20 characters",
-          "type": "string"
-        },
-        "variable_type": {
-          "description": "Definition of variable type",
-          "type": "string",
-          "oneof": [
-            "variable",
-            "pivot"
-          ]
-        },
-        "units": {
-          "description": "Haystack compliant units with an empty string if not defined.",
-          "type": "null"
-        },
-        "minimum": {
-          "description": "????",
-          "type": "number"
-        },
-        "maximum": {
-          "description": "????",
-          "type": "number"
-        },
-        "relation_to_output": {
-          "description": "????",
-          "type": "null"
-        },
-        "static_value": {
-          "description": "Value to default to in the case of this variable not being perturbed in a datapoint",
-          "type": "number"
-        },
-        "uuid": {
-          "description": "Variable UUID to link against in the .osd file",
-          "type": "string"
-        },
-        "version_uuid": {
-          "description": "???",
-          "type": "string"
-        },
-        "variable": {
-          "description": "????",
-          "type": "boolean"
-        },
-        "uncertainty_description": {
-          "$ref": "#/definitions/Uncertainty Definition"
-        },
-        "workflow_index": {
-          "description": "???????",
-          "type": "number"
-        },
-        "machine_name": {
-          "description": "???????",
-          "type": "string"
-        }
-      },
-      "required": [
-        "argument",
-        "display_name",
-        "variable_type",
-        "units",
-        "static_value",
-        "uuid",
-        "version_uuid",
-        "uncertainty_description",
-        "machine_name"
-      ],
-      "additionalProperties": false
-    },
-    "Problem": {
-      "title": "problem",
-      "description": "Defines procedure for running the analysis",
-      "type": "object",
-      "properties": {
-        "analysis_type": {
-          "description": "Type of analysis to be run, e.g. LHS or nsga2",
-          "type": "string",
-          "oneof": [
-            "morris",
-            "lhs",
-            "rgenound",
-            "nsga_nrel",
-            "spea",
-            "sequential_search",
-            "single_run",
-            "batch_run",
-            "doe",
-            "repeat_run",
-            "optim",
-            "baseline_perturbation",
-            "preflight"
-          ]
-        },
-        "algorithm": {
-          "$ref": "#/definitions/Algorithm Attributes"
-        },
-        "workflow": {
-          "$ref": "#/definitions/Workflow"
-        },
-        "random_seed": {
-          "description": "Random seed to set server to for the execution of the OSA file",
-          "type": "number"
-        },
-        "name": {
-          "description": "??????",
-          "type": "string"
-        },
-        "design_alternatives": {
-          "description": "Array of design alternative names and descriptions",
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/Design Alternative"
-          }
-        }
-      },
-      "required": [
-        "analysis_type",
-        "algorithm",
-        "workflow",
-        "random_seed"
-      ],
-      "additionalProperties": false
-    },
-    "Output Array": {
-      "description": "Array of objects which define user-desired outputs from the analysis ",
-      "type": "array",
-      "items": {
-        "$ref": "#/definitions/Output"
-      }
-    },
-    "Workflow": {
-      "description": "Definition of measures to be applied in the analysis",
-      "type": "array",
-      "items": {
-        "$ref": "#/definitions/Workflow Step"
-      }
-    },
-    "Seed Object": {
-      "title": "seed",
-      "description": "Seed osm or idf file for default use",
-      "type": "object",
-      "properties": {
-        "file_type": {
-          "description": "Accepted values of 'osm' and 'idf'",
-          "type": "string",
-          "oneonf": [
-            "osm",
-            "idf"
-          ]
-        },
-        "path": {
-          "description": "Path to the seed file from the project directory",
-          "type": "string"
-        }
-      },
-      "required": [
-        "file_type"
-      ],
-      "additionalProperties": false
-    },
-    "Weather File": {
-      "title": "weather_file",
-      "description": "Weather file for default use in the simulation",
-      "type": "object",
-      "properties": {
-        "file_type": {
-          "description": "Weather file type, e.g. TMY3",
-          "type": "string"
-        },
-        "path": {
-          "description": "Path to weather file from the project directory",
-          "type": "string"
-        }
-      },
-      "required": [
-        "file_type",
-        "path"
-      ],
-      "additionalProperties": false
-    },
-    "Analysis": {
-      "title": "analysis",
-      "description": "Analysis object",
-      "type": "object",
-      "properties": {
-        "display_name": {
-          "description": "User facing string, spaces & capitals allowed",
-          "type": "string"
-        },
-        "name": {
-          "description": "snake_cassed machine name",
-          "type": "string"
-        },
-        "output_variables": {
-          "$ref": "#/definitions/Output Array"
-        },
-        "problem": {
-          "$ref": "#/definitions/Problem"
-        },
-        "seed": {
-          "$ref": "#/definitions/Seed Object"
-        },
-        "weather_file": {
-          "$ref": "#/definitions/Weather File"
-        },
-        "file_format_version": {
-          "description": "1.0",
-          "type": "number"
-        },
-        "_id": {
-          "description": "UUID of the OSA file",
-          "type": "string"
-        },
-        "uuid": {
-          "description": "UUID of the OSA file",
-          "type": "string"
-        },
-        "project_id": {
-          "description": "?????",
-          "type": "string"
-        }
-      },
-      "required": [
-        "output_variables",
-        "problem",
-        "seed",
-        "weather_file",
-        "_id",
-        "uuid",
-        "project_id"
-      ],
-      "additionalProperties": false
-    },
-    "Argument Array": {
-      "description": "Array of fixed inputs for the measure",
-      "type": "array",
-      "items": {
-        "$ref": "#/definitions/Argument"
-      }
-    },
-    "Variable Array": {
-      "description": "Array of variable inputs for the measure",
-      "type": "array",
-      "items": {
-        "$ref": "#/definitions/Variable"
-      }
-    },
-    "Distribution Definition": {
-      "title": "attributes",
-      "description": "Array of attributes defining the distribution type properties",
-      "type": "array",
-      "items": {
-        "title": "Distribution Attributes",
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "value": {
-            "type": [
-              "array",
-              "string",
-              "number",
-              "boolean"
-            ]
-          }
-        },
-        "required": [
-          "name",
-          "value"
-        ],
-        "additionalProperties": false
-      }
-    }
-  }
-}