Skip to content

Commit

Permalink
Changed documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
albinber authored and Fraser Greenroyd committed Sep 4, 2023
1 parent 3faa62f commit cb49d17
Show file tree
Hide file tree
Showing 4 changed files with 21 additions and 11 deletions.
14 changes: 12 additions & 2 deletions Environment_Engine/Create/Panel.cs
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,12 @@ public static partial class Create
[Input("brep", "A BHoM Boundary Representation to convert into a collection of Environment Panels")]
[Input("connectedSpaceName", "A name for the space which these panels are connected to. If no name is provided, a randomised default will be generated")]
[Input("angleTolerance", "The angle tolerance for collapsing to polylines used when generating the external edges of the surfaces")]
[Input("panelType", "The panel type to assign to the panels, if no input is added roof, floor and wall types are assigned by default")]
[Input("roofType", "The panel type to assign to the panels where the panels are identified as roof. If no input is added roof types are assigned by default.")]
[Input("ceilingType", "The panel type to assign to the panels where the panels are identified as ceiling. If no input is added ceiling types are assigned by default.")]
[Input("internalFloorType", "The panel type to assign to the panels where the panels are identified as internal flooring. If no input is added FloorInternal types are assigned by default.")]
[Input("externalGrounding", "The panel type to assign to the panels where the panels are identified as external grounding. If no input is added SlabOnGrade types are assigned by default.")]
[Input("externalWallType", "The panel type to assign to the panels where the panels are identified as external walls. If no input is added WallExternal types are assigned by default.")]
[Input("internalWallType", "The panel type to assign to the panels where the panels are identified as internal walls. If no input is added WallInternal types are assigned by default.")]
[Output("panelsAsSpace", "A collection of Environment Panels representing a closed space generated from the provided Brep geometry")]
[PreviousVersion("6.3", "BH.Engine.Environment.Create.Panels(BH.oM.Geometry.BoundaryRepresentation, System.String, System.Double, BH.oM.Environment.Elements.PanelType)")]
public static List<Panel> Panels(this BoundaryRepresentation brep, string connectedSpaceName = null, double angleTolerance = BH.oM.Geometry.Tolerance.Angle, PanelType roofType = PanelType.Roof, PanelType ceilingType = PanelType.Ceiling, PanelType internalFloorType = PanelType.FloorInternal, PanelType externalGrounding = PanelType.SlabOnGrade, PanelType externalWallType = PanelType.WallExternal, PanelType internalWallType = PanelType.WallInternal)
Expand All @@ -65,7 +70,12 @@ public static List<Panel> Panels(this BoundaryRepresentation brep, string connec
[Input("surfaces", "A collection of BHoM surfaces to convert into a Environment Panels. The surfaces should be grouped as a single space as all panels generated from the surfaces will have the same connectedSpaceName")]
[Input("connectedSpaceName", "A name for the space which these panels are connected to. If no name is provided, a randomised default will be generated")]
[Input("angleTolerance", "The angle tolerance for collapsing to polylines used when generating the external edges of the surfaces")]
[Input("panelType", "The panel type to assign to the panels, if no input is added roof, floor and wall types are assigned by default")]
[Input("roofType", "The panel type to assign to the panels where the panels are identified as roof. If no input is added roof types are assigned by default.")]
[Input("ceilingType", "The panel type to assign to the panels where the panels are identified as ceiling. If no input is added ceiling types are assigned by default.")]
[Input("internalFloorType", "The panel type to assign to the panels where the panels are identified as internal flooring. If no input is added FloorInternal types are assigned by default.")]
[Input("externalGrounding", "The panel type to assign to the panels where the panels are identified as external grounding. If no input is added SlabOnGrade types are assigned by default.")]
[Input("externalWallType", "The panel type to assign to the panels where the panels are identified as external walls. If no input is added WallExternal types are assigned by default.")]
[Input("internalWallType", "The panel type to assign to the panels where the panels are identified as internal walls. If no input is added WallInternal types are assigned by default.")]
[Output("panel", "An Environment Panels representing a closed space generated from the provided surfaces")]
[PreviousVersion("6.3", "BH.Engine.Environment.Create.Panels(System.Collections.Generic.List<BH.oM.Geometry.ISurface>, System.String, System.Double, BH.oM.Environment.Elements.PanelType)")]
public static List<Panel> Panels(this List<ISurface> surfaces, string connectedSpaceName = null, double angleTolerance = BH.oM.Geometry.Tolerance.Angle, PanelType roofType = PanelType.Roof, PanelType ceilingType = PanelType.Ceiling, PanelType internalFloorType = PanelType.FloorInternal, PanelType externalGrounding = PanelType.SlabOnGrade, PanelType externalWallType = PanelType.WallExternal, PanelType internalWallType = PanelType.WallInternal)
Expand Down
6 changes: 3 additions & 3 deletions Environment_Engine/Modify/SetFloorPanels.cs
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,9 @@ public static partial class Modify
/**** Public Methods ****/
/***************************************************/

[Description("Modifies a collection of Panels and sets their type to be slab on grade or internal floor if they are the lowest panel in the space. If the panel has one connected space then it is deemed to be a slab on grade panel, otherwise it is an internal floor panel")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the slab on grade or internal floor panels have had their type set")]
[Description("Modifies a collection of Panels and sets their type to be slab on grade or internal floor if they are the lowest panel in the space. If the panel has one connected space then it is deemed to be a slab on grade panel, otherwise it is an internal floor panel.")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space.")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the slab on grade or internal floor panels have had their type set.")]
[PreviousVersion("6.3", "BH.Engine.Environment.Modify.SetFloorPanels(System.Collections.Generic.List<BH.oM.Environment.Elements.Panel>)")]
public static List<Panel> SetFloorPanels(this List<Panel> panelsAsSpace, PanelType internalFloorType = PanelType.FloorInternal, PanelType externalGrounding = PanelType.SlabOnGrade)
{
Expand Down
6 changes: 3 additions & 3 deletions Environment_Engine/Modify/SetRoofPanels.cs
Original file line number Diff line number Diff line change
Expand Up @@ -40,12 +40,12 @@ public static partial class Modify
/**** Public Methods ****/
/***************************************************/

[Description("Modifies a collection of Panels and sets their type to be roof or ceiling if they are the highest panel in the space. If the panel has one connected space then it is deemed to be a roof panel, otherwise it is a ceiling panel")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space")]
[Description("Modifies a collection of Panels and sets their type to be roof or ceiling if they are the highest panel in the space. If the panel has one connected space then it is deemed to be a roof panel, otherwise it is a ceiling panel.")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space.")]
[Input("roofType", "The panel type to define external roof panels. Defaults to 'roof'.")]
[Input("ceilingType", "The panel type to define internal ceiling panels, defined as panels on the horizontal tilt with 2 connected spaces. Defaults to 'ceiling'.")]
[Input("internalFloorType", "The panel type to define internal floors. Defaults to 'FloorInternal'.")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the roof or ceiling panels have had their type set")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the roof or ceiling panels have had their type set.")]
[PreviousVersion("6.3", "BH.Engine.Environment.Modify.SetRoofPanels(System.Collections.Generic.List<BH.oM.Environment.Elements.Panel>)")]
public static List<Panel> SetRoofPanels(this List<Panel> panelsAsSpace, PanelType roofType = PanelType.Roof, PanelType ceilingType = PanelType.Ceiling, PanelType internalFloorType = PanelType.FloorInternal)
{
Expand Down
6 changes: 3 additions & 3 deletions Environment_Engine/Modify/SetWallPanels.cs
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,9 @@ public static partial class Modify
/**** Public Methods ****/
/***************************************************/

[Description("Modifies a collection of Panels and sets their type to be interior or exterior wall if they have a tilt of 90 degrees. If the panel has one connected space then it is deemed to be an internal wall panel, otherwise it is an external wall panel")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the internal or external wall panels have had their type set")]
[Description("Modifies a collection of Panels and sets their type to be interior or exterior wall if they have a tilt of 90 degrees. If the panel has one connected space then it is deemed to be an internal wall panel, otherwise it is an external wall panel.")]
[Input("panelsAsSpace", "A collection of Environment Panels that represent a closed space.")]
[Output("panelsAsSpace", "BHoM Environment panels representing a closed space where the internal or external wall panels have had their type set.")]
[PreviousVersion("6.3", "BH.Engine.Environment.Modify.SetWallPanels(System.Collections.Generic.List<BH.oM.Environment.Elements.Panel>)")]
public static List<Panel> SetWallPanels(this List<Panel> panelsAsSpace, PanelType externalWallType = PanelType.WallExternal, PanelType internalWallType = PanelType.WallInternal)
{
Expand Down

0 comments on commit cb49d17

Please sign in to comment.