Skip to content

LifeCycleAssessment Methods

Jump to bottom
Maryanne Wachter edited this page Apr 13, 2021 · 2 revisions

These are all the methods with corresponding descriptions and inputs/outputs in the BHoM that are part of the LifeCycleAssessment Toolkit.

BenchmarkVariance

BH.Engine.LifeCycleAssessment.Compute

Calculates the percentage change of kgCO2 between a proposed, user-created building and a baseline building based on a defined building type.

Inputs

  • projectEmbodiedCarbon
    • Combined kgCO2 per building.
    • This is a Double
  • projectArea
    • Total area of the building, including all floor surface area in m2.
    • This is a Double
  • embodiedCarbonBenchmarkTypeDataset
    • Benchmark kgCO2/m2 per building type based on program benchmark dataset.
    • This is a BH.oM.LifeCycleAssessment.BuildingBenchmarkingData
  • embodiedCarbonBenchmarkStructureDataset
    • Benchmark kgCO2/m2 per building structure based on structural benchmark dataset.
    • This is a BH.oM.LifeCycleAssessment.BuildingBenchmarkingData
  • typeWeighting
    • Subjective weighting of program type benchmark results. Used in LCA to prioritize different CO2 dataset assumptions.
    • This is a Double
  • structureWeighting
    • Subjective weighting of structure type benchmark results. Used in LCA to prioritize different CO2 dataset assumptions.
    • This is a Double

Outputs

  • embodiedCarbonPercentageVariance
    • Percentage variance between current project being evaluated and benchmark datasets, e.g. -30% for a building that is 30% less than the benchmark.
    • This is a Double

AcidificationPotential

BH.Engine.LifeCycleAssessment.Compute

Calculates the AcidificationPotential of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the acidification potential.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for acidification potential.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • acidificationPotential
    • Acidification, measured in kgSO2e, refers to emissions which increase the H+ ions in the environment causing a decrease in pH. Potential effects include fish mortality, forest decline, and the deterioration of building materials.
    • This is a Double

OzoneDepletionPotential

BH.Engine.LifeCycleAssessment.Compute

Calculates the OzoneDepletionPotential of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the OzoneDepletionPotential.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for OzoneDepletionPotential.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • ozoneDepletionPotential
    • Ozone Depletion Potential, measured in kg CFC-11 equivalents, refers to emissions which contribute to the depletion of the stratospheric ozone layer.
    • This is a Double

EutrophicationPotential

BH.Engine.LifeCycleAssessment.Compute

Calculates the EutrophicationPotential of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the EutrophicationPotential.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for EutrophicationPotential.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • eutrophicationPotential
    • Eutrophication, measured in kg N equivalents, refers to emissions of nutrients like nitrogen and phosphorus causing overfertilization, leading to overgrowth of biomass that depresses oxygen levels and suffocates ecosystems.
    • This is a Double

DepletionOfAbioticResourcesFossilFuels

BH.Engine.LifeCycleAssessment.Compute

Calculates the DepletionOfAbioticResourcesFossilFuels of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the DepletionOfAbioticResourcesFossilFuels.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for DepletionOfAbioticResourcesFossilFuels.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • depletionOfAbioticResourcesFossilFuels
    • Depletion of non-renewable Abiotic Resources (fossil fuels) measured in Methyl Jasmonate.
    • This is a Double

DepletionOfAbioticResources

BH.Engine.LifeCycleAssessment.Compute

Calculates the DepletionOfAbioticResources of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the DepletionOfAbioticResources.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for DepletionOfAbioticResources.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • depletionOfAbioticResources
    • Depletion of Abiotic Resources refers to non-renewable resources such as minerals, clay, and peat measured in kg Sb (antimony) equivalent.
    • This is a Double

GlobalWarmingPotential

BH.Engine.LifeCycleAssessment.Compute

Calculates the GlobalWarmingPotential of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the GlobalWarmingPotential.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for GlobalWarmingPotential.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • globalWarmingPotential
    • Global Warming Potential, expressed in kgCO2e, refers to the emissions of carbon dioxide, methane and other gases that contribute to the greenhouse effect and global warming.
    • This is a Double

PhotochemicalOzoneCreationPotential

BH.Engine.LifeCycleAssessment.Compute

Calculates the PhotochemicalOzoneCreationPotential of a BHoM Object based on a Mass-based QuantityType Environmental Product Declaration dataset.

Inputs

  • elementM
    • The IElementM Object to calculate the PhotochemicalOzoneCreationPotential.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • epd
    • A BHoM Environmental Product Declaration object with a valid value for PhotochemicalOzoneCreationPotential.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • photochemicalOzoneCreationPotential
    • Photochemical Ozone Creation Potential, measured in kgO3 equivalents, refers to emissions which contribute to the formation of ground-level smog.
    • This is a Double

EvaluateLifeCycleAssessment

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within a Life Cycle Assessment.

Inputs

  • lca
    • This is a complete Life Cycle Assessment object with its appropriate nested scope objects for which the evaluation will occur.
    • This is a BH.oM.LifeCycleAssessment.ProjectLifeCycleAssessment
      • The Life Cycle Assessment Scope object intends to provide a means of reporting all of the project criteria (name, area, type, location) as well as the objects that the study encompassed (structural slabs, foundation walls, etc) along with their properties for the Enviornmental Product Declarations they used (when using SetProperty), their densities and volumes. This object may be used for studies at any stage of development and can serve as a true means of 'apples to apples' comparison when catalogued.
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains project data, total results, and results per element.
    • This is a BH.oM.LifeCycleAssessment.Results.LifeCycleAssessmentResult
      • Result class for a LifeCycleAssessment of a whole project. This is used to get the total quantity in terms of embodied carbon, acidification, etc. for a whole project.

EvaluateLifeCycleAssessmentScope

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within the StructuresScope and returns results.

Inputs

  • structuresScope
    • This is a life cycle assessment scope object which contains all specified objects along with their associated EPD MaterialFragment data.
    • This is a BH.oM.LifeCycleAssessment.StructuresScope
      • The Structures Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains structures scope specific data, total results, and results per element.
    • This is a List

EvaluateLifeCycleAssessmentScope

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within the FoundationsScope and returns results.

Inputs

  • foundationsScope
    • This is a life cycle assessment scope object which contains all specified objects along with their associated EPD MaterialFragment data.
    • This is a BH.oM.LifeCycleAssessment.FoundationsScope
      • The Foundations Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains foundations scope specific data, total results, and results per element.
    • This is a List

EvaluateLifeCycleAssessmentScope

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within the EnclosuresScope and returns results.

Inputs

  • enclosuresScope
    • This is a life cycle assessment scope object which contains all specified objects along with their associated EPD MaterialFragment data.
    • This is a BH.oM.LifeCycleAssessment.EnclosuresScope
      • The Enclosures Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains enclosures scope specific data, total results, and results per element.
    • This is a List

EvaluateLifeCycleAssessmentScope

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within the MEPScope and returns results.

Inputs

  • mepScope
    • This is a life cycle assessment scope object which contains all specified objects along with their associated EPD MaterialFragment data.
    • This is a BH.oM.LifeCycleAssessment.MEPScope
      • The MEP Scope object provides a template for expected objects to be assessed within this Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains MEP scope specific data, total results, and results per element.
    • This is a List

EvaluateLifeCycleAssessmentScope

BH.Engine.LifeCycleAssessment.Compute

This method calls the appropriate compute method per object within the TenantImprovementScope and returns results.

Inputs

  • tenantImprovementScope
    • This is a life cycle assessment scope object which contains all specified objects along with their associated EPD MaterialFragment data.
    • This is a BH.oM.LifeCycleAssessment.TenantImprovementScope
      • The Tenant Improvement Scope object provides a template for expected objects to be assessed within this Life Cycle Assessments. Note that this category is not commonly assessed, but will provide for higher quality results. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.
  • field
    • This is the desired field you would like to evaluate. Notice that not all material datasets will contain information for all metrics. A holistic GWP evaluation is currently the only standard evaluation possible with all provided datasets.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The LifeCycleElementResult that contains Tenant Improvement scope specific data, total results, and results per element.
    • This is a List

EvaluateReferenceValue

BH.Engine.LifeCycleAssessment.Compute

This is a simple calculation method for EPD QuantityTypes that are not yet fully supported. This calculation is performed by multiplying the reference value by the selected field metric found within the EPD, divided by the QuantityTypeValue. This method relies upon user input and is therefore at the discretion of the user to verify all results.

Inputs

  • referenceValue
    • The amount, quantity, or value to evaluate against any Environmental Product Declaration.
    • This is a Double
  • epd
    • The Environmental Product Declaration to evaluate against the quantity.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration
  • field
    • The Environmental indicator to evaluate by. This value is queried from the EPD.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • The total result of the desired metric based on the EnvironmentalProductDeclarationField. It is up to the discre.
    • This is a Double

EvaluateEnvironmentalProductDeclaration

BH.Engine.LifeCycleAssessment.Compute

This method calculates the results of any selected metric within an Environmental Product Declaration. For example for an EPD of QuantityType Volume, results will reflect the objects volume * EPD Field metric.

Inputs

  • elementM
    • This is a BHoM object used to calculate EPD metric. This obj must have an EPD MaterialFragment applied to the object.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • field
    • Filter the provided EnvironmentalProductDeclaration by selecting one of the provided metrics for calculation. This method also accepts multiple fields simultaneously.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • result
    • A LifeCycleElementResult that contains the LifeCycleAssessment data for the input object.
    • This is a BH.oM.LifeCycleAssessment.Results.LifeCycleAssessmentElementResult
      • Base class for a LifeCycleAssessment of a single object. This contains the total quantity of global warming potential, acidification potential, etc. for a whole project.

GetElementEpd

BH.Engine.LifeCycleAssessment.Query

Query the Environmental Product Declarations from any IElementM with a MaterialComposition composed of IEPD materials.

Inputs

  • elementM
    • A IElementM from which to query the EPD.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...

Outputs

  • epd
    • The EPD or EPDs used to define the material makeup of an object.
    • This is a List
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

GetQuantityType

BH.Engine.LifeCycleAssessment.Query

Query the QuantityType values from any IElementM object's MaterialComposition.

Inputs

  • elementM
    • The IElementM object from which to query the EPD's QuantityType values.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...

Outputs

  • quantityType
    • The quantityType values from the IEnvironmentalProductDeclarationData objects found within the Element's MaterialComposition.
    • This is a List

GetQuantityTypeValue

BH.Engine.LifeCycleAssessment.Query

Query the QuantityTypeValue from any Environmental Product Declaration MaterialFragmment.

Inputs

  • epd
    • The EPD Object to query.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • quantityTypeValue
    • The quantityTypeValue property from the EPD.
    • This is a Double

GetQuantityTypeValue

BH.Engine.LifeCycleAssessment.Query

Query the QuantityTypeValue from any object with a valid construction with Environmental Product Declaration MaterialFragmments.

Inputs

  • elementM
    • The IElementM Object to query.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • type
    • The quantityType to query.
    • This is a BH.oM.LifeCycleAssessment.QuantityType

Outputs

  • quantityTypeValue
    • The quantityTypeValue property from the IElementM.
    • This is a List

GetQuantityTypeValue

BH.Engine.LifeCycleAssessment.Query

Query the QuantityTypeValue from any object with a valid construction.

Inputs

  • construction
    • The physical construction to query.
    • This is a BH.oM.Physical.Constructions.Construction
  • type
    • The quantityType to query.
    • This is a BH.oM.LifeCycleAssessment.QuantityType

Outputs

  • quantityTypeValue
    • The quantityTypeValue property from the IElementM.
    • This is a List

MaterialEndOfLifeTreatment

BH.Engine.LifeCycleAssessment.Query

Returns End of Life processing information contained within an EPD dataset.

Inputs

  • epd
    • Environmental Product Declaration of a specific material from an EPD Dataset.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • materialEndOfLifeTreatment
    • End of Life treatment per material. This includes all data collected for LCA stages C1-C4 within a provided EPD dataset.
    • This is a String

GetFragmentDensity

BH.Engine.LifeCycleAssessment.Query

Query an Environmental Product Declaration MaterialFragment to return it's Density property value.

Inputs

  • epd
    • The EPD object to query.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • density
    • Density value queried from the EPD MaterialFragment.
    • This is a Density [kg/m³] (as a Double)

GetFragmentQuantityType

BH.Engine.LifeCycleAssessment.Query

Query the QuantityType value from any IEnvironmentalProductDeclarationData object.

Inputs

  • epd
    • IEnvironmentalProductDeclarationData object from which to query.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration

Outputs

  • quantityType
    • The quantityType value from the provided IEPD.
    • This is a BH.oM.LifeCycleAssessment.QuantityType
    • -Ampere
    • -Area
    • -Item
    • -Length
    • -Mass
    • -VoltAmps
    • -Volume
    • -VolumetricFlowRate
    • -Watt

IsValid

BH.Engine.LifeCycleAssessment.Query

Query a StructuresScope object to see if it contains any data.

Inputs

  • structuresScope
    • The StructuresScope object used within your LCA to query.
    • This is a BH.oM.LifeCycleAssessment.StructuresScope
      • The Structures Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.

Outputs

  • boolean
    • True if the object contains data, False if the object does not contain data.
    • This is a Boolean

IsValid

BH.Engine.LifeCycleAssessment.Query

Query a FoundationsScope object to see if it contains any data.

Inputs

  • foundationsScope
    • The FoundationsScope object used within your LCA to query.
    • This is a BH.oM.LifeCycleAssessment.FoundationsScope
      • The Foundations Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.

Outputs

  • boolean
    • True if the object contains data, False if the object does not contain data.
    • This is a Boolean

IsValid

BH.Engine.LifeCycleAssessment.Query

Query a EnclosuresScope object to see if it contains any data.

Inputs

  • enclosuresScope
    • The EnclosuresScope object used within your LCA to query.
    • This is a BH.oM.LifeCycleAssessment.EnclosuresScope
      • The Enclosures Scope object provides a template for expected objects commonly assessed within Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.

Outputs

  • boolean
    • True if the object contains data, False if the object does not contain data.
    • This is a Boolean

IsValid

BH.Engine.LifeCycleAssessment.Query

Query a MEPScope object to see if it contains any data.

Inputs

  • mepScope
    • The MEPScope object to query.
    • This is a BH.oM.LifeCycleAssessment.MEPScope
      • The MEP Scope object provides a template for expected objects to be assessed within this Life Cycle Assessments. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment

Outputs

  • boolean
    • True if the object contains any data, False if the object does not contain any data.
    • This is a Boolean

IsValid

BH.Engine.LifeCycleAssessment.Query

Query a TenantImprovementScope object to see if it contains any data.

Inputs

  • tiScope
    • The TenantImprovementScope object used within your LCA to query.
    • This is a BH.oM.LifeCycleAssessment.TenantImprovementScope
      • The Tenant Improvement Scope object provides a template for expected objects to be assessed within this Life Cycle Assessments. Note that this category is not commonly assessed, but will provide for higher quality results. Please provide as many objects with their corresponding Environmental Product Declaration data for the most accurate Life Cycle Assessment.

Outputs

  • boolean
    • True if the object contains data, False if the object does not contain data.
    • This is a Boolean

EnvironmentalProductDeclaration

BH.Engine.LifeCycleAssessment.Query

Inputs

  • epd
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration
  • field
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

    • This is a Double

GetEvaluationValue

BH.Engine.LifeCycleAssessment.Query

Return a sum of all Material Fragment values from a specified EnvironmentalProductDeclarationField within any EPD object.

Inputs

  • epd
    • Environmental Product Declaration to query the field value from.
    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.IEnvironmentalProductDeclarationData
    • This can be of the following types: SectorEnvironmentalProductDeclaration, EnvironmentalProductDeclaration
  • field
    • Specific metric to query from provided Environmental Product Declarations.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential

Outputs

  • evaluationValue
    • The Environmental Impact metric value for the specified field.
    • This is a Double

GetEvaluationValue

BH.Engine.LifeCycleAssessment.Query

Returns the Environmental Impact metric value for the specified field input from the Environmental Product Declaration found within the MaterialComposition of an object.

Inputs

  • elementM
    • An IElementM object with a MaterialProperty from which to query the desired metric.
    • This is a BH.oM.Dimensional.IElementM
      • Enables Mass based operations to be performed on elements with materiality
      • Ensures the material composition of a physical object is represented, defined as proportions of discrete types of material forming the object's total solid volume.
      • Objects implementing this Interface will be required to implement some base methods for getting and setting data in a way that maintains the object's other properties.
      • Documentation detailing required extension methods can be found here: https://github.com/BHoM/documentation/wiki/IElement-required-extension-methods
      • This can be of the following types: Sprinkler, Opening, Panel, FrameEdge, CurtainWall, Opening, Panel, CableTray, Duct, Pipe, FlowSystem, WireSegment, Wire, Bracing, Pile, and more...
  • field
    • Specific metric to query from provided Environmental Product Declarations.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential
  • type
    • The quantityType to query.
    • This is a BH.oM.LifeCycleAssessment.QuantityType

Outputs

  • evaluationValue
    • The Environmental Impact metric value for the specified field and quantityType.
    • This is a List

GetEvaluationValue

BH.Engine.LifeCycleAssessment.Query

Returns the Environmental Impact metric value for the specified field input from the Environmental Product Declaration found within a construction.

Inputs

  • construction
    • An physical construction used to define material properties of an object.
    • This is a BH.oM.Physical.Constructions.Construction
  • field
    • Specific metric to query from provided Environmental Product Declarations.
    • This is a BH.oM.LifeCycleAssessment.EnvironmentalProductDeclarationField
      • This enum provides several evaluation fields that are commonly assessed within standard Environmental Product Declarations. You may provide single or multiple EPD Field selections for evaluation within the EvaluateEnvironmentalProductDeclaration compute method.
      • Enum values:
        • Undefined
        • AcidificationPotential
        • DepletionOfAbioticResourcesFossilFuels
        • EutrophicationPotential
        • GlobalWarmingPotential
        • OzoneDepletionPotential
        • PhotochemicalOzoneCreationPotential
  • type
    • The quantityType to query.
    • This is a BH.oM.LifeCycleAssessment.QuantityType

Outputs

  • evaluationValue
    • The Environmental Impact metric value for the specified field and quantityType.
    • This is a List

ProjectLifeCycleAssessmentResult

BH.Engine.LifeCycleAssessment.Query

Query the standard project results from a complete ProjectLifeCycleAssessment evaluation for pushing to datasets.

Inputs

  • lcaResult
    • Supply a complete LifeCycleAssessmentResult to query.
    • This is a BH.oM.LifeCycleAssessment.Results.LifeCycleAssessmentResult
      • Result class for a LifeCycleAssessment of a whole project. This is used to get the total quantity in terms of embodied carbon, acidification, etc. for a whole project.

Outputs

  • projectResults
    • The combined amount of kgCO2e of the objects provided.
    • This is a BH.oM.LifeCycleAssessment.Results.ProjectLifeCycleAssessmentResult
      • A collection of simplified project results commonly used for database collection.

TotalGlobalWarmingPotential

BH.Engine.LifeCycleAssessment.Query

Query the total global warming potential, or GWP from any LifeCycleAssessmentElementResult data. This is typically evaluated by kgCO2e or kg of Carbon Dioxide equivalent.

Inputs

  • gwpResults
    • Supply a valid GlobalWarmingPotentialResult from a scope evaluation.
    • This is a List

Outputs

  • gwp
    • The combined amount of kgCO2e of the objects provided.
    • This is a Double

ToBuildingBenchmarkingData

BH.Engine.LifeCycleAssessment.Convert

Inputs

  • obj
    • This is a BH.oM.Base.CustomObject

Outputs

    • This is a BH.oM.LifeCycleAssessment.BuildingBenchmarkingData

ToHealthProductDeclarationData

BH.Engine.LifeCycleAssessment.Convert

Inputs

  • obj
    • This is a BH.oM.Base.CustomObject

Outputs

    • This is a BH.oM.LifeCycleAssessment.HealthProductDeclaration

ToEnvironmentalProductDeclarationData

BH.Engine.LifeCycleAssessment.Convert

Inputs

  • obj
    • This is a BH.oM.Base.CustomObject

Outputs

    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.EnvironmentalProductDeclaration

ToSectorEnvironmentalProductDeclarationData

BH.Engine.LifeCycleAssessment.Convert

Inputs

  • obj
    • This is a BH.oM.Base.CustomObject

Outputs

    • This is a BH.oM.LifeCycleAssessment.MaterialFragments.SectorEnvironmentalProductDeclaration

LifeCycleAssessmentScope

BH.oM.LifeCycleAssessment.LifeCycleAssessmentScope

Creates a Duct object. Material that flows through this Duct can be established at the system level.

Inputs

  • additionalNotes
    • Additional notes should convey project design constraints (eg design for seismic activity) that could affect the overall embodied carbon.
    • This is a String
  • biogenicCarbon
    • Biogenic Carbon is a true/false that indicates that the project contains materials that originated from a biological source (trees, soil), these materials have the ability sequester/store carbon.
    • This is a Boolean
  • buildingLifespan
    • The assumed lifespan of the building being evaluated. These values are for categorisation purposes only and will not effect the overall results.
    • This is a Int32
  • constructionScopeNew
    • Identifies the overall construction scope for the project. Set True if New Construction exists within your project.
    • This is a Boolean
  • constructionScopeRenovation
    • Identifies the overall construction scope for the project. Set True if Renovation exists within your project.
    • This is a Boolean
  • contactName
    • The Contact Name denotes the person/people who performed the LCA study.
    • This is a String
  • gravityStructuralMaterial
    • The primary structural system providing gravity support for the building.
    • This is a BH.oM.LifeCycleAssessment.GravityStructuralMaterial
  • lateralStructuralMaterial
    • The primary structural system providing lateral support for the building.
    • This is a BH.oM.LifeCycleAssessment.LateralStructuralMaterial
  • levelOfDevelopment
    • Typically a term utilised in BIM practices to clearly identify the scope of work being account for. Equivalents for LOD classifications can offen times be linked to design and construction phases common to the projects locale.
    • This is a BH.oM.LifeCycleAssessment.LevelOfDevelopment
  • lifeCycleAssessmentPhases
    • This is a list of life cycle assessment phases to be accounted for within this assessment. These values are for categorisation purposes only and will not effect the overall results.
    • This is a List
  • projectType
    • A general classification of the buildings primary function. This value is for categorisation purposes only and will not effect the overall results.
    • This is a BH.oM.LifeCycleAssessment.ProjectType
  • projectName
    • The Project Name denotes the name of the project for reporting purposes.
    • This is a String
  • projectArea
    • The Project Area (m2) denotes the more precise project area which will allow assessment of kgCO2eq/m2 metrics.
    • This is a Double
  • seismicDesignCategory
    • Seismic Design Category is a classification assigned to a structure based on it's occupancy category, and the severity of the design earthquake ground motion. These categories are currently in reference to ASCE 7-05.
    • This is a BH.oM.LifeCycleAssessment.SeismicDesignCategory
      • Seismic Design Category is a classification assigned to a structure based on it's occupancy category, and the severity of the design earthquake ground motion. These categories are in reference to ASCE 7-05.
  • windSpeedCategory
    • Wind speed category is in reference to the Beaufort Scale of wind speeds. Values are arranged from 0-12 equivalent, 0 being Calm and 12 being Hurricane, and are used only to represent an average site-based, wind condition. Specific informaion on categorisation can be found at https://www.spc.noaa.gov/faq/tornado/beaufort.html
    • This is a BH.oM.LifeCycleAssessment.WindSpeedCategory
      • Wind speed category is in reference to the Beaufort Scale of wind speeds, and are used only to represent an average site-based, wind condition. Specific information on categorisation can be found at https://www.spc.noaa.gov/faq/tornado/beaufort.html
  • location
    • Provide the projects geographic location for database organisation purposes. This value is for categorisation purposes only and will not effect the overall results.
    • This is a BH.oM.Environment.Climate.Location
      • Defines a uniquely identifiable point on the Earth in standard global Latitude, Longitude and Elevation, coordinate system. Particularly useful for specifying local climate conditions for environmental analysis.

Outputs

  • lifeCycleAssessmentScope
    • A duct object is a passageway which conveys material (typically air)
    • This is a BH.oM.LifeCycleAssessment.LifeCycleAssessmentScope
      • The Life Cycle Assessment Scope object intends to provide a means of reporting all of the project criteria (name, area, type, location). This object may be used for studies at any stage of development and can serve as a true means of 'apples to apples' comparison when catalogued. The information provided within this object is utilised for database construction and organisation only, therefore all values will not effect the overall life cycle assessment results.

Home

Clone this wiki locally