Monte Carlo Simulation Model for Commercial Residential Buildings (MCS-CRB) Use Case II Glossary
Glossary
MCS-LB
ENCLOSURECONDITIONUPDATER_GABLE.m
Input Variables | Description | Terms in Documentation |
direction i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
RoofType | a string array describing the geometry of the roof, it can be ‘Gable’ or ‘Hip’ | |
RoofSlope | a string array describing the geometry of the roof, it can be ‘Gable’ or ‘Hip’. | |
EaveHeight | a scalar describing the height of the roof at the eave in feet. | |
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
EnclosureConditionAttic | a string array containing an initial condition for the enclosure condition of the attic; it can be ‘E’, ‘P’, or ‘O’. | |
EnclosureConditionAllFloors | a matrix (rows = TotalNumberofStories, cols = 1), containing the enclosure condition (‘E’, ‘P’, or ‘O’) for every story. | |
Component Area Maps | matrices containing the area occupied by a component in a location of a wall mapped by the matrix indexes (matrix size = # of stories by # of wall sheathing panels on that wall). | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
Component Damage Mappers | matrices identifying the damage of particular components for a given wall (matrix size = # of stories by # of wall sheathing panels on that wall). A 1 denotes a damaged component while a 0 denotes an undamaged one. | |
External Pressure Coefficient Possibilities | scalars determined in accordance with ASCE 7-05, they are function of the wind effective area of the building and the approach direction of the wind. | |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking | |
Area_of_Sheathing | a matrix comprising the area of each sheathing panel on the roof | |
External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
Output Variables | ||
GCpi | A vector whose length is equal to the number of floors of the building. The internal pressure is determined by the opening created by wall sheathing and window damages. | |
GCpi_Attic | A scalar indicating the internal pressure of the attic space. |
ENCLOSURECONDITIONUPDATER_HIP.m
Input Variables | Description | Terms in Documentation |
direction i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
Failure_Ident_Sheathing_Hip_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Ident_Sheathing_Main_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Failure_Load_Sheathing_Hip_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Load_Sheathing_Main_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Areas | Matrix = Matrix identifying the total area of each sheathing panel on the Main Roof Regions. Units are ft^2 | |
Areas_Hip | Matrix = Matrix identifying the total area of each sheathing panel on the Hip Regions. Units are ft^2 | |
RoofType | a string array describing the geometry of the roof, it can be ‘Gable’ or ‘Hip’. | |
RoofSlope | a scalar describing the roof slope | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
EaveHeight | a scalar describing the height of the roof at the eave in feet. | |
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
EnclosureConditionAttic | a string array containing an initial condition for the enclosure condition of the attic; it can be ‘E’, ‘P’, or ‘O’. | |
EnclosureConditionAllFloors | a matrix (rows = TotalNumberofStories, cols = 1), containing the enclosure condition (‘E’, ‘P’, or ‘O’) for every story. | |
Component Area Maps | matrices containing the area occupied by a component in a location of a wall mapped by the matrix indexes (matrix size = # of stories by # of wall sheathing panels on that wall). | |
Component Damage Mappers | matrices identifying the damage of particular components for a given wall (matrix size = # of stories by # of wall sheathing panels on that wall). A 1 denotes a damaged component while a 0 denotes an undamaged one. | |
External Pressure Coefficient Possibilities | scalars determined in accordance with ASCE 7-05, they are function of the wind effective area of the building and the approach direction of the wind. | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading. | |
Area_of_Sheathing | = a matrix comprising the area of each sheathing panel on the roof | |
External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
Output Variables | ||
GCpi | A vector whose length is equal to the number of floors of the building. The internal pressure is determined by the opening created by wall sheathing and window damages. | |
GCpi_Attic | A scalar indicating the internal pressure of the attic space. |
*Model_Control.m
R2W_Capacity_Gable.m
Input Variables | Description | Terms in Documentation |
rating | scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover. |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the roof. | |
Output Variables | ||
r2w_cap | Matrix contains the randomly assigned capacity of each of the r2w connection. The size of the matrix depends on the number of trusses and is equal to 2 by Number_of_Trusses_Row (one row for each roof face). Units are lbs. | |
mean_resist | A scalar value representing the mean resistance of the r2w connection after the FS is applied. |
R2W_Capacity_Hip.m
Input Variables | Description | Terms in Documentation |
rating | scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong). Variable is used to select the mean capacity of the roof components. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular roof areas of the roof on either end of a rectangular house. (roof line runs along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal roof area of the roof on either side of a rectangular house. (roof line runs along the longer of the two dimensions of the house) |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the Main Roof Region. | |
Number_of_Trusses_Row_Hip | scalar = Indicates the number of r2w connections along the eave of the Hip Region. | |
Output Variables | ||
r2w_cap_Hip | Matrix contains the randomly assigned capacity of each of the r2w connection in the hip regions. The size of the matrix depends on the number of trusses in the hip region and is equal to 2 by Number_of_Trusses_Row_Hip (one row for each Hip Region). Units are psf | |
r2w_cap_Main | Matrix contains the randomly assigned capacity of each of the r2w connection in the main roof regions. The size of the matrix depends on the number of trusses in the main roof region and is equal to 2 by Number_of_Trusses_Row (one row for each Main Roof Region). Units are psf. | |
mean_resist | A scalar value representing the mean resistance of the r2w connection after the FS is applied. |
r2w_Loading_Failure_Gable_New_Approach.m
Input Variables | Description | Terms in Documentation |
Length | scalar = the longer of the horizontal linear dimensions of the rectangular roof area. Units are ft. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover. |
Width | scalar = the shorter of the horizontal linear dimensions of the rectangular roof area. Units are ft. | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge line. (example: 6/12) | |
EnclosureCondition | indicator of the enclosure of the building (‘O’ for Open, ‘P’ for Partially Enclosed and ‘E’ Fully Enclosed, which essentially effects the interior pressure coefficient for the building) | |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units in mph | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
m | Scalar = index for the Velocity vector. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the roof. | |
Number_of_Trusses_Row_Hip | scalar = Indicates the number of r2w connections along the ridge of the roof. | |
Width_of_Sheathing | Vector = Indicates the width of sheathing panels present in a specific row (Length of the vector is equal to the *Number_of_Rows) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover. |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. (initially a zeroes matrix which is the same size as the Length_of_Sheathing matrix) | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading | |
Tributary_Width | Vector = Indicates the width of the roof area that the r2w connection is influenced by. Units are ft. | |
Sheathing_Equiv | Matrix = Values indicate which number of sheathing in a particular row, counting from left to right, is attached to the truss. The column location of the matrix identifies the truss being analyzed. Matrix is 2*Number_of_Rows by Number_of_Trusses_Row in size. | |
r2w_cap | Matrix contains the randomly assigned capacity of each of the r2w connection in the hip regions). The size of the matrix depends on the number of trusses in the hip region and is equal to 2 by Number_of_Trusses_Row (one row for each Hip Region). Units are psf | |
Output Variables | ||
Failure_Ident_Trusses | Matrix = Identifies the sheathing panels that have failed with a value of 1. | |
percent_damage_r2w | Scalar = Output of the total percentage of r2w failures due to the wind event. | |
Percent_Sheathing_Loss_Truss_1 | Vector = Vector identifying the number of sheathing lost along the length of each truss on Side 1 of the roof area (left side of the roof region) | |
Percent_Sheathing_Loss_Truss_2 | Vector = Vector identifying the number of sheathing lost along the length of each truss on Side 2 of the roof area (right side of the roof region) |
r2w_Loading_Failure_Hip.m
Input Variables | Description | Terms in Documentation |
Length | scalar = the longer of the linear dimensions of the rectangular roof area. Units are ft. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area. Units are ft. | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
EnclosureCondition | indicator of the enclosure of the building (‘O’ for Open, ‘P’ for Partially Enclosed and ‘E’ Fully Enclosed, which essentially effects the interior pressure coefficient for the building) | |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units in mph. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Area_Zone_#_r2w_Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2
(Area_Zone_2_r2w_Hip_1: Area of each panel that lies in Zone 2 boundary on hip region #1) |
Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Area_Zone_#_r2w_Overhang Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2. | |
Area_Zone_#_r2w_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2.
(Area_Zone_2_r2w_Main_1: Area of each panel that lies in Zone 2 boundary on main roof region #1) |
|
Area_Zone_#_r2w_Overhang_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2.
(Area_Zone_3_r2w_Overhang _Main_2: Area of each panel that lies in Zone 3 Overhang boundary on main roof region #2) |
|
m | Scalar = index for the Velocity vector. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Trusses_Row_Hip | Scalar = Indicates the number of r2w connections along the ridge of the Hip Region. | |
Number_of_Trusses_Row | Scalar = Indicates the number of r2w connections along the eave of the Main Roof Region. |
Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Number_of_Rows_Hip | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Eave | Scalar = Indicates the number of sheathing along the eave of the roof Main Roof Region. |
|
Number_of_Sheathing_Ridge | Scalar = Indicates the number of sheathing along the ridge of the roof Main Roof Region. |
|
Sheathing_per_Row | Vector = Indicates the number of sheathing panels present in a specific row in the main roof regions | |
Sheathing_per_Row_Hip | Vector = Indicates the number of sheathing panels present in a specific row in the hip regions | |
Width_of_Sheathing | Vector = Indicates the width of sheathing panels present in a specific row in the main roof regions | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Width_of_Sheathing_Hip | Vector = Indicates the width of sheathing panels present in a specific row in the hip regions | |
Failure_Ident_Sheathing_Hip_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Ident_Sheathing_Main_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Failure_Load_Sheathing_Hip_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Load_Sheathing_Main_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Tributary_Width | Vector = Indicates the width of the roof area that the r2w connection is influenced by on the main roof regions. Units are ft. | |
Tributary_Width _Hip | Vector = Indicates the width of the roof area that the r2w connection is influenced by on the hip regions. Units are ft. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Sheathing_Equiv | Matrix = Values indicate which number of sheathing in a particular row, counting from left to right, is attached to the truss on the Main Roof Region. The column location of the matrix identifies the truss being analyzed. Matrix is Number_of_Rows by Number_of_Trusses_Row in size. | |
Sheathing_Equiv _Hip | Matrix = Values indicate which number of sheathing in a particular row, counting from left to right, is attached to the truss on the Hip Region. Matrix is Number_of_Rows_Hip by Number_of_Trusses_Row_Hip in size | |
r2w_cap_Hip | Matrix contains the randomly assigned capacity of each of the r2w connection in the hip regions . The size of the matrix depends on the number of trusses in the hip region and is equal to 2 by Number_of_Trusses_Row_Hip (one row for each Hip Region). Units are psf | |
r2w_cap_Main | Matrix contains the randomly assigned capacity of each of the r2w connection in the main roof regions. The size of the matrix depends on the number of trusses in the main roof region and is equal to 2 by Number_of_Trusses_Row (one row for each Main Roof Region). Units are psf | |
Output Variables | ||
percent_damage_r2w | Scalar = Output of the total percentage of r2w failures due to the wind event. |
ENCLOSURECONDITIONUPDATER_Breach.m
Input Variables | Descriptions | Terms in Documentation |
direction i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
RoofType | a string array describing the geometry of the roof, it can be ‘Gable’ or ‘Hip’ | |
RoofSlope | a string array describing the geometry of the roof, it can be ‘Gable’ or ‘Hip’. | |
EaveHeight | a scalar describing the height of the roof at the eave in feet. | |
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
EnclosureConditionAttic | a string array containing an initial condition for the enclosure condition of the attic; it can be ‘E’, ‘P’, or ‘O’. | |
EnclosureConditionAllFloors | a matrix (rows = TotalNumberofStories, cols = 1), containing the enclosure condition (‘E’, ‘P’, or ‘O’) for every story. | |
Component Area Maps | matrices containing the area occupied by a component in a location of a wall mapped by the matrix indexes (matrix size = # of stories by # of wall sheathing panels on that wall). | |
Component Damage Mappers | matrices identifying the damage of particular components for a given wall (matrix size = # of stories by # of wall sheathing panels on that wall). A 1 denotes a damaged component while a 0 denotes an undamaged one. | Enclosure Condition: the condition that describes the area of openings within a given building. For this model the enclosure condition is computed for every story and for the attic. The enclosure condition affects the internal pressure of the building and as a result the load intensities can change. |
External Pressure Coefficient Possibilities | scalars determined in accordance with ASCE 7-05, they are function of the wind effective area of the building and the approach direction of the wind. | |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking | |
Area_of_Sheathing | a matrix comprising the area of each sheathing panel on the roof | |
External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
Output Variables | ||
GCpi | A vector whose length is equal to the number of floors of the building. The internal pressure is determined by the opening created by wall sheathing and window damages. | |
GCpi_Attic | A scalar indicating the internal pressure of the attic space. |
Garage_Door_Pressure_Damage_CR.m
Input Variables | Descriptions | Terms in Documentation |
direction i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | |
Velocity | 1 x 41 vector representing the randomized wind speeds at the mean roof | |
mncapacityGarageDoor | A scalar of the mean pressure capacity of the garage assigned based on the buildings quality | |
COV_GarageDoorcapacity | A scalar coefficient of variation for the garage doors capacity | |
GarageLength | The scalar horizontal dimension of the garage door | |
GarageHeight | The scalar vertical dimension of the garage door | |
a | The scalar width of the pressure coefficient zone. | |
m | a scalar index for the Velocity vector. | |
GCpi | A scalar indicating the internal pressure of the attic space. | |
Output Variables | ||
Garage_Door_Failure | A scalar value of either 1(damaged) or 0 (undamaged) delineating damage to the garage door |
Masonry_Shear_Wall_Failure_2014.m
Input Variables | Descriptions | Terms in Documentation |
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
InnerStoryHeight | a scalar describing the height of the roof at the eave in feet. | |
MainStoryHeight | a scalar describing the building’s re-assigned floor plan length in feet. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
GCpi | a vector of internal pressure is determined by the opening created by wall sheathing and window damages | |
rating | a string describing the construction quality of the building; it could be ‘Weak’, ‘Medium’, or ‘Strong’ | |
k | a scalar that indicates orientation of the wind (direction: 1-8) | |
WindSpeeds_mean_MainStory | a matrix that contains the mean wind speed at the height that the matrix index maps to the building’s face. | |
WindSpeeds_GableEnd_Walls | A vector of Wind speeds taken at the centroid of the gable end panels | |
Velocity | A 1 x 41 vector representing the randomized wind speeds at the mean roof | |
GCp_zone4_POSITIVE
GCp_zone5_POSITIVE GCp_zone4_NEGATIVE GCp_zone5_NEGATIVE |
Scalars of positive and negative pressure coefficients for zone 4 and 5 wall areas | |
ShearFailureRatio_orig | a matrix of the ratio of the shear load over the shear capacity of the wall. | |
BendingFailureRatio_orig | A matrix of the ratio of the bending load over the bending capacity of the wall. | |
Time_Step | A scalar representing which time step that the analysis is currently in. | |
RoofType | Identifies the type of roof system used, “Gable” or “Hip” Roof. | |
GCpFinalGableEndShortSide1
GCpFinalGableEndShortSide2 GCpExternalFinalGableEndShortSide1 GCpExternalFinalGableEndShortSide2 |
Pressure coefficients at each designated panel. | |
GableEndSheetMapShortSide13D
GableEndSheetMapShortSide23D GableEndWallCoverMapShortSide13D GableEndWallCoverMapShortSide23D |
Matrices designating the location of the wall sheathing and wall cover for the gable ends | |
MapofDamagedSheets_GableEndWallsShortSide1
MapofDamagedSheets_GableEndWallsShortSide2 |
the matrices mapping the damaged wall sheathing panels to the walls. | |
MapofDamagedWallCover_GableEndWallsShortSide1
MapofDamagedWallCover_GableEndWallsShortSide2 |
the matrices mapping the damaged wall cover to the walls | |
Output Variables | ||
ShearFailureRatio | a matrix of the ratio of the shear load over the shear capacity of the wall. | |
BendingFailureRatio | A matrix of the ratio of the bending load over the bending capacity of the wall. | |
ShearFailureRatio_orig | a matrix of the ratio of the shear load over the shear capacity of the wall. (original) | |
BendingFailureRatio_orig | A matrix of the ratio of the bending load over the bending capacity of the wall. (original) | |
GableEndSheetMapShortSide13D
GableEndSheetMapShortSide23D GableEndWallCoverMapShortSide13D GableEndWallCoverMapShortSide23D |
Matrices designating the location of the wall sheathing and wall cover for the gable ends | |
MapofDamagedSheets_GableEndWallsShortSide1
MapofDamagedSheets_GableEndWallsShortSide2 MapofDamagedWallCover_GableEndWallsShortSide1 MapofDamagedWallCover_GableEndWallsShortSide2 |
Matrices identifying the damages to the wall sheathing and cover components |
Soffit_Pressure_Damage.m
Input Variables | Descriptions | Terms in Documentation |
direction i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | |
Velocity | 1 x 41 vector representing the randomized wind speeds at the mean roof | |
mnsoffitcapacity | a scalar mean pressure capacity of the soffit assigned based on the buildings quality | |
COV_soffitcapacity | A scalar coefficient of variation for the soffit capacity | |
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
m | a scalar index for the Velocity vector. | |
GCpi_Attic | A scalar indicating the internal pressure of the attic space. | |
Output Variables | ||
Percent_SoffitDamage_Wall#(1-4) | A vector whose length is equal to the number of floors of the building. The internal pressure is determined by the opening created by wall sheathing and window damages. | |
No_Soffit_LongWall | A scalar indicating the number of soffit along the long dimension of the building | |
No_Soffit_ShortWall | A scalar indicating the number of soffit along the short dimension of the building | |
Total_Average_Damage_Soffit | A scalar indicating the total number of soffit installed on the building |
Redist_uplift.m
Input Variables | Description | Terms in Documentation |
r2w_cap | a 2 column matrix that contains the capacity of each r2w connection, one long end per column. If a particular r2w has already failed, its capacity has been set to zero. This is both input and output. | |
uplift | a 2 column matrix containing the uplift load (lbs.) in each r2w connection, one long end per column. This is both input and output. | |
r2w_indx | a vector that contains an index to each r2w connection within ‘r2w_cap’that has failed | |
num_r2w_connections | scalar = # of r2w connections along one long end | |
Output Variables | ||
new_r2w_indx | scalar that contains the number of r2w connections that have failed | |
r2w_cap | a 2 column matrix that contains the capacity of each r2w connection, one long end per column. If a particular r2w has already failed, its capacity has been set to zero. This can have different values from its input version if more connections fail due to the load redistribution. | |
uplift | a 2 column matrix containing the uplift load (lbs.) in each r2w connection, one long end per column. This is both input and output. |
Roof_Cover_Loss_Gable_Truncation_Fix_8_20.m
Input Variables | Description | Terms in Documentation |
Area_zone# | Matrix = Summation of the respective zone matrices (Main roof area + Overhang, where # = 1-3) Units are ft^2. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover. |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units are mph. | |
direction_i | Scalar = indicates orientation of the wind (direction: 1-8) | |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. (initially a zeroes matrix which is the same size as the Length_of_Sheathing matrix) | |
Area_Zone_#_Sheathing | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone) Units are ft^2. (Area_Zone_2_r2w : Area of each panel that lies in Zone 2 boundary) | |
Area_Zone_#_Sheathing_Overhang | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 2 or 3, depending on the particular overhang zone ) Units are ft^2. (Area_Zone_3_r2w_Overhang: Area of each panel that lies in Zone 3 Overhang boundary) | |
m | Scalar = index for the Velocity vector. | |
rating | Scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover. |
RoofSlope | Scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
mnshinglecapacity | a scalar describing the mean capacity of the shingles. It is 51 psf, 56 psf, or 70 psf for a weak, medium or strong construction quality, respectively. | |
COV_shinglecapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
Output Variables | ||
Percent_Roof_Cover_Loss | scalar = Indicates the percentage of the roof covering that was lost. | |
Number_of_shingles | scalar = the total number of shingles based on the roof area and average shingle size. | |
cover_fail | scalar = Value of the mean capacity of the roof cover used for outputting in the ‘Header’ |
Roof_Cover_Loss_Hip_Truncation_Fix_8_20.m
Input Variables | Description | Terms in Documentation |
Area_zone# | Matrix = Summation of the respective zone matrices (Main roof area + Overhang, where # = 1-3) Units are ft^2. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units in mph. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Failure_Ident_Sheathing_Hip_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Ident_Sheathing_Main_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Area_Zone_#_Sheathing_Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2. | |
Area_Zone_#_Sheathing_Overhang Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2. | |
Area_Zone_#_Sheathing_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Area_Zone_#_Sheathing_Overhang_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2. | |
m | Scalar = index for the Velocity vector. | |
rating | Scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong) | |
Output Variables | ||
Percent_Roof_Cover_Loss | scalar = Indicates the percentage of the roof covering that was lost. | |
Number_of_shingles | scalar = the total number of shingles based on the roof area and average shingle size. | |
cover_fail | scalar = Value of the mean capacity of the roof cover used for outputting in the ‘Header’ |
Sheathing_Capacity_Gable.m
Input Variables | Description | Terms in Documentation |
rating | scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roofcover. |
Number_of_Rows | scalar = indicates the number of rows of sheathing on one face of the roof. | |
Number_of_Sheathing_Row | scalar = Indicates the number of sheathing along the eave of the roof. | |
Length | scalar = the longer of the linear dimensions of the rectangular roof area (ft) Units are ft. | |
Output Variables | ||
capacity_sheathing | Matrix = contains the randomly assigned capacity of each of the sheathing panels on the roof. Size depends on the determined dimensions of the roof area and is equal to that of the Length and Width of sheathing matrices outputted from the roof layout codes. Units are psf. | |
sheathing_fail | Scalar = Value of the mean capacity of the sheathing used for outputting in the ‘Header’ |
Sheathing_Capacity_Hip.m
Input Variables | Description | Terms in Documentation |
rating | scalar = Indicates the strength rating of the components: 1 (weak), 2 (medium), and 3 (strong) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roofcover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Number_of_Rows | scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Rows_Hip | scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Eave | scalar = Indicates the number of sheathing along the eave of the roof Main Roof Region. | |
Number_of_Sheathing_Ridge | scalar = Indicates the number of sheathing along the ridge of the roof Main Roof Region. | |
Output Variables | ||
capacity_sheathing_Hip_# | Matrix = contains the randomly assigned capacity of each of the sheathing panels in the hip regions (# = 1 or 2 for the separation of the roof surfaces). The size of the matrix depends on the determined dimensions of the hip region area and is equal to Number_of_Rows_Hip by Number_of_Rows_Hip. Cells within the matrix that do not represent a sheathing panel is represented by a zero. Units are psf | |
capacity_sheathing_Main_# | Matrix = contains the randomly assigned capacity of each of the sheathing panels in the main roof regions (# = 1 or 2 for the separation of the roof surfaces). The size of the matrix depends on the determined dimensions of the hip region area and is equal to Number_of_Rows by Number_of_Sheathing_Eave. Cells within the matrix that do not represent a sheathing panel is represented by a zero. Units are psf | |
sheathing_fail | Scalar = Value of the mean capacity of the sheathing used for outputting in the ‘Header’ |
Sheathing_Layout_Gable_Nov_2009.m
Input Variables | Description | Terms in Documentation |
Length | scalar = the longer of the linear dimensions of the rectangular roof area. Units are ft. | |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area. Units are ft. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
a | scalar = Width of the pressure coefficient zone. Units are ft. | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
Output Variables | ||
Area_Zone_#_Sheathing# | Matrix = the Area contribution of the pressure coefficients on each sheathing element (where # is 1, 2 or 3, depending on the zone) | |
Area_Zone_#_Sheathing_Overhang | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone) | |
Area_zone# | Matrix = Summation of the respective zone matrices (Main roof area + Overhang) | |
Total_Area | Matrix = Summation of the contributing zones for each sheathing element. The values should equal the total area of each sheet. Units are ft^2. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Row | Scalar = Indicates the number of sheathing along the eave of the roof | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. Units are ft. | |
Width_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the shorter of the two roof dimensions. Units are ft. | |
1 | Vector = Vector indicating a count of the number of sheathing in each row |
Sheathing_Layout_Hip.m
Input Variables | Description | Terms in Documentation |
a | scalar = Width of the pressure coefficient zone (ft.) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house.(Running along the longer of the two dimensions of the house) |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Length | scalar = the longer of the linear dimensions of the rectangular roof area (ft) | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area (ft) | |
Output Variables | ||
Areas | Matrix = Matrix identifying the total area of each sheathing panel on the Main Roof Regions. Units are ft^2 | |
Areas_Hip | Matrix = Matrix identifying the total area of each sheathing panel on the Hip Region | |
Area_Zone_#_Sheathing_Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) | |
Area_Zone_#_Sheathing_Overhang Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) | |
Area_Zone_#_Sheathing_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house.(Running along the longer of the two dimensions of the house) |
Area_Zone_#_Sheathing_Overhang_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) | |
Area_zone# | Matrix = Summation of the respective zone matrices (Main roof area + Overhang, where # = 1-3) | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. | |
Length_of_Sheathing_Hip | Matrix = Indicates the length of the individual sheathing running parallel to The shorter of the two roof dimensions. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Rows_Hip | scalar = indicates the number of rows of sheathing on one face of the roof | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house.(Running along the longer of the two dimensions of the house) |
Number_of_Sheathing_Eave | scalar = Indicates the number of sheathing along the eave of the roof Main Roof Region. | |
Number_of_Sheathing_Ridge | scalar = Indicates the number of sheathing along the ridge of the roof Main Roof Region. | |
Sheathing_per_Row | Vector = Indicates the number of sheathing panels present in a specific row in the main roof regions | |
Sheathing_per_Row_Hip | Vector = Indicates the number of sheathing panels present in a specific row in the hip regions | |
Total_Area | Matrix = Summation of the contributing zones for each sheathing element. The values should equal the total area of each sheet. | |
Width_of_Sheathing_Main | Vector = Indicates the width of sheathing panels present in a specific row in the main roof regions | |
Width_of_Sheathing_Hip | Vector = Indicates the width of sheathing panels present in a specific row in the hip regions |
Input Variables | Description | Terms in Documentation |
Length | scalar = the longer of the linear dimensions of the rectangular roof area. Units are ft. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area. Units are ft. | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
EnclosureCondition | indicator of the enclosure of the building (‘O’ for Open, ‘P’ for Partially Enclosed and ‘E’ Fully Enclosed, which essentially effects the interior pressure coefficient for the building) | |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units in mph. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Areas | Matrix = Matrix identifying the total area of each sheathing panel on the Main Roof Regions. Units are ft^2 | |
Areas_Hip | Matrix = Matrix identifying the total area of each sheathing panel on the Hip Regions. Units are ft^2 | |
Area_Zone_# | Matrix = Summation of the respective zone matrices (Main roof area + Overhang, where # = 1-3) Units are ft^2. | |
Area_Zone_#_Sheathing_Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Area_Zone_#_Sheathing_Overhang Hip_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Hip Region) Units are ft^2. | |
Area_Zone_#_Sheathing_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2. | |
Area_Zone_#_Sheathing_Overhang_Main_## | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone and ## is a 1 or 2 and is used in the identification of the particular Main Roof Region) Units are ft^2. | |
m | Scalar = index for the Velocity vector. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Rows_Hip | scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Eave | scalar = Indicates the number of sheathing along the eave of the roof Main Roof Region. | |
Number_of_Sheathing_Ridge | scalar = Indicates the number of sheathing along the ridge of the roof Main Roof Region. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Sheathing_per_Row | Vector = Indicates the number of sheathing panels present in a specific row in the main roof regions | |
Sheathing_per_Row_Hip | Vector = Indicates the number of sheathing panels present in a specific row in the hip regions | |
Width_of_Sheathing_Main | Vector = Indicates the width of sheathing panels present in a specific row in the main roof regions. Units are ft. | |
Width_of_Sheathing_Hip | Vector = Indicates the width of sheathing panels present in a specific row in the hip regions. Units are ft. | |
capacity_sheathing_Hip_# | Matrix = contains the randomly assigned capacity of each of the sheathing panels in the hip regions (# = 1 or 2 for the separation of the roof surfaces). The size of the matrix depends on the determined dimensions of the hip region area and is equal to Number_of_Rows_Hip by Number_of_Rows_Hip. Cells within the matrix that do not represent a sheathing panel is represented by a zero. Units are psf | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
capacity_sheathing_Main_# | Matrix = contains the randomly assigned capacity of each of the sheathing panels in the main roof regions (# = 1 or 2 for the separation of the roof surfaces). The size of the matrix depends on the determined dimensions of the hip region area and is equal to Number_of_Rows by Number_of_Sheathing_Eave. Cells within the matrix that do not represent a sheathing panel is represented by a zero. Units are psf | |
Output Variables | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house. (Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
|
percent_damage_Sheathing | Scalar = Output of the total percentage of sheathing loss from the roof due to the wind event. | |
percent_damage_Sheathing_Overhang | Scalar = Output of the percentage of sheathing loss from the eave of roof due to the wind event. | |
percent_damage_Sheathing_Interior | Scalar = Output of the percentage of sheathing loss from interior region of the roof. Interior sheathing panels refer to sheathing that is not along the eave of the roof. | |
Failure_Ident_Sheathing_Hip_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Hip Region)) | |
Failure_Ident_Sheathing_Main_# | Matrix = Identifies the sheathing panels that have failed with a value of 1. (# = 1 or 2 is used in the identification of the particular Main Roof Region) | |
Failure_Load_Sheathing_Hip_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Hip Region) | |
Failure_Load_Sheathing_Main_# | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading (# = 1 or 2 is used in the identification of the particular Main Roof Region) |
Truss_Layout_Gable_Reduced_Aug_20_2009.m
Input Variables | Description | Terms in Documentation |
a | scalar = Width of the pressure coefficient zone. Units are ft. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Length | scalar = the longer of the linear dimensions of the rectangular roof area. Units are ft. | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. Units are ft. | |
RoofSlope | scalar = pitch of the roof from the eave to the ridge (example: 6/12) | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Row | Scalar = Indicates the number of sheathing along the eave of the roof | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. Units are ft. | |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area. Units are ft. | |
1 | vector = Indicates the number of sheathing found in each row, where each entry represents a different row. | |
Output Variables | ||
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the Main Roof Region. | |
Tributary_Width | Vector = Indicates the width of the roof area that the r2w connection is influenced by on the main roof regions. Units are ft. | |
Sheathing_Equiv | Matrix = Values indicate which number of sheathing in a particular row, starting from 1 from left to right, is attached to the truss on the Main Roof Region. The column location of the matrix identifies the truss being analyzed. Matrix is Number_of_Rows by Number_of_Trusses_Row in size. |
Truss_Layout_Hip_Reduced_Aug_20_2009.m
Input Variables | Description | Terms in Documentation |
a | scalar = Width of the pressure coefficient zone (ft.) | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Length | scalar = the longer of the linear dimensions of the rectangular roof area (ft) | |
Length_of_Sheathing_Hip | Matrix = Indicates the length of the individual sheathing running parallel to the shorter of the two roof dimensions. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Rows_Hip | scalar = indicates the number of rows of sheathing on one face of the roof | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. | |
Length_of_Sheathing_Hip | Matrix = Indicates the length of the individual sheathing running parallel to the shorter of the two roof dimensions. | |
Sheathing_per_Row | Vector = Indicates the number of sheathing panels present in a specific row in the main roof regions | |
Sheathing_per_Row_Hip | Vector = Indicates the number of sheathing panels present in a specific row in the hip regions | |
Width | scalar = the shorter of the linear dimensions of the rectangular roof area (ft) | |
Width_of_Sheathing | Vector = Indicates the width of sheathing panels present in a specific row in the main roof regions | |
Width_of_Sheathing_Hip | Vector = Indicates the width of sheathing panels present in a specific row in the hip regions | |
Output Variables | ||
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the Main Roof Region. | |
Number_of_Trusses_Row_Hip | scalar = Indicates the number of r2w connections along the ridge of the Main Roof Region. | |
Tributary_Width | Vector = Indicates the width of the roof area that the r2w connection is influenced by on the main roof regions. Units are ft. | |
Tributary_Width _Hip | Vector = Indicates the width of the roof area that the r2w connection is influenced by on the hip regions. Units are ft. | |
Sheathing_Equiv | Matrix = Values indicate which number of sheathing in a particular row, starting from 1 from left to right, is attached to the truss on the Main Roof Region. The column location of the matrix identifies the truss being analyzed. Matrix is Number_of_Rows by Number_of_Trusses_Row in size. | |
Sheathing_Equiv _Hip | Matrix = Values indicate which number of sheathing in a particular row, starting from 1 from left to right, is attached to the truss on the Hip Region. Matrix is Number_of_Rows_Hip by Number_of_Trusses_Row_Hip in size. |
adimcalculator.m
Input Variables | Description | Terms in Documentation |
Height | a scalar describing the building’s mean roof height in feet | ASCE 7-05: the standard used to determine the design loads on a building.
Loading Zones: ASCE 7-05 divides the roof and walls of a building into different loading zones. The pressure loading varies throughout the building because as the wind flows through the body it behaves differently from zone to zone. The zones are 1, 2, and 3 on the roof and 4 and 5 on the wall faces; zone 3 has the strongest loads but is the smallest zone, zones 2 and 5 have the medium loads and are the 2nd largest zones, while zones 1 and 4 have the weakest loads and are the largest zones. The different loading zones are shown in Figure 1: “ASCE 7-05 ‘a’ dimension and loading zones”. a: the dimension that specifies the size and locations of the loading zones. ‘a’ is a function of the building’s dimensions. The ‘a’ dimension is shown in Figure 1: “ASCE 7-05 ‘a’ dimension and loading zones”. |
Width | a scalar describing the re-assigned building’s roof plan width dimension in feet. | |
Output Variables | ||
a | a scalar describing the ASCE ‘a’ dimension in feet. |
BUILDINGDIMREASSIGNER.m
Input Variables | Description | Terms in Documentation |
LengthFLR | a scalar describing the building’s initial floor plan length in feet as inputted by the user. | Length and Width: the dimensions of the plan view of the building. The width is the smaller dimension; the roof plan dimensions are greater than the floor plan dimensions by 4 feet because the roof has an overhang of 2 feet on each side.
Roof Overhang: a roof extension beyond the edge of the exterior walls of the building. |
WidthFLR | a scalar describing the building’s initial floor plan width in feet as inputted by the user. | |
Output Variables | ||
LengthFLR | a scalar describing the building’s re-assigned floor plan length in feet. | |
WidthFLR | a scalar describing the building’s re-assigned floor plan width in feet. | |
Length | a scalar describing the building’s roof plan length in feet. | |
Width | a scalar describing the building’s roof floor plan width in feet. |
CONSTRUCTIONQLTYTOBLDGSTRENGTH.m
Input Variables | Description | Terms in Documentation |
ConstructionQuality | a string describing the construction quality of the building; it could be ‘Weak’, ‘Medium’, or ‘Strong’. | Glazing: openings in the building envelope, they could be windows, sliding doors, or entry doors. Glazing is usually made of glass; however, entry doors will also be part of this category because they also cover an opening. |
Output Variables | ||
mnshinglecapacity | a scalar describing the mean capacity of the shingles. It is 51 psf, 56 psf, or 70 psf for a weak, medium or strong construction quality, respectively. | |
COV_shinglecapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
mnroofsheathing | a scalar describing the mean capacity of the roof sheathing. It is 55 psf, 103 psf, or 181.9 psf for a weak, medium or strong construction quality, respectively. | |
COV_roofsheathing | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
mnr2w | a scalar describing the mean capacity of the shingles.There are two different capacities for each strength level and is based on the materials that the wall is made out of. R2W connections attached to masonry walls typically have a higher resistance than a timber framed building. It is 700 lbs, 1065 lbs, or 1240 lbs for a weak, medium or strong construction quality, respectively for a masonry building. | |
COV_r2w | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | Glazing: openings in the building envelope, they could be windows, sliding doors, or entry doors. Glazing is usually made of glass; however, entry doors will also be part of this category because they also cover an opening. |
mncapacitywallcover | a scalar describing the mean capacity of the wall cover. It is 25 psf, 72 psf, or 88 psf for a weak, medium or strong construction quality, respectively. | |
COV_wallcovercapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
mncapacitywallsheets | a scalar describing the mean capacity of the wall sheathing panels. It is 55 psf, 103 psf, or 181.9 psf for a weak, medium or strong construction quality, respectively. | |
COV_wallsheetscapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
mncapacitywindow | a scalar describing the mean capacity of the windows against pressure loading. It is 53 psf, 71 psf, or 164 psf for a weak, medium or strong construction quality, respectively. | |
COV_windowscapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | Glazing: openings in the building envelope, they could be windows, sliding doors, or entry doors. Glazing is usually made of glass; however, entry doors will also be part of this category because they also cover an opening. |
mncapacitySlidingDoor | a scalar describing the mean capacity of the sliding doors against pressure loading. It is 67.5 psf, 90 psf, or 173 psf for a weak, medium or strong construction quality, respectively. | |
COV_SlidingDoorscapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. | |
mncapacityEntryDoor | a scalar describing the mean capacity of the entry doors against pressure loading. It is 73 psf, 90.5 psf, or 180 psf for a weak, medium or strong construction quality, respectively. | |
COV_EntryDoorscapacity | a scalar describing the coefficient of variation. It decreases as the construction quality increases. |
CVARIABLE.m
Input Variables | Description | Terms in Documentation |
EaveHeight | a scalar of height to eave | C variable: The variable C is the fraction of the total area of the impacted wall that is a particular opening. |
LengthFLR | a scalar of length of impacted wall | |
WidthFLR | a scalar of width of side wall | |
Output Variables | ||
The C Matrices | the matrices containing the fraction of area of glazing at a particular location (mapped by the matrix to a corresponding wall location) of the total wall area (matrix size = # of stories by # of wall sheathing panels that could fit on that wall). |
DAMAGECOUNTERIMPACTWINDOWS.m
Input Variables | Description | Terms in Documentation |
Impact Capacity Matrices | matrices containing the randomized impact capacities for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | Glazed components’ impact resistance: the randomized capacity that a component that covers an opening (such as entry doors, windows, and sliding doors) has against impact.
Impact loading: the randomized impact load imparted on a component during an impact event. Glazed component map matrices: the matrices mapping the glazed components to the walls. Glazed component damage map matrices: the matrices mapping the damaged glazed components to the walls. |
Impact Load Matrices | matrices containing the loading for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a panel while a 0 denotes the absence of one. | |
Glazed Component Damage Mappers | matrices identifying the damage of the glazed component (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes a damaged panel while a 0 denotes an undamaged one. | |
Output Variables | ||
Glazed Component Mappers | the output is the input after updating | |
Glazed Component Damage Mappers | the output is the input after updating |
DAMAGECOUNTERWALLCOVER.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | Roof Type: the building’s roof type, it could be either ‘Hipped Roof’ or ‘Gabled Roof’.
Wall Covers’ resistance: the randomized capacities for each section of wall cover. Loading: the pressure loading imparted on the building’s faces as a result of it being in the trajectory of a wind field. The G Matrix: the limit state condition (‘Resistance – Load’); whenever it is less than zero the load has exceeded the resistance of the component and the component has failed. Wall Cover Map Matrices: the matrices mapping the wall cover sections to the walls. Wall Cover Damage Map Matrices: the matrices mapping the damaged wall cover sections to the walls. The wall cover sections are placed on the wall sheathing panels and can be fixed to the panels in a variety of ways (some being stronger than others). Thus, whenever a wall sheathing panel fails, the wall cover corresponding to that panel automatically fails. Main Story: the section of the walls that spans from the floor to the ceiling of every story. Inner Story: the section of the walls that spans from the ceiling of one story to the floor of the story above it. The utilities are typically placed in this section. |
Capacity Matrices | matrices containing the randomized capacities (in psf) for each wall cover section on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Load Matrices | matrices containing the loading (in psf) for each wall cover section on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Wall Covering Mappers | matrices identifying the presence or absence of a wall cover section at a particular location on its corresponding wall (matrix size = # of stories by # of wall cover sections on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a cover section while a 0 denotes the absence of one. | |
Wall Cover Damage Mappers | matrices identifying the damage of the wall cover sections (matrix size = # of stories by # of wall cover sections on that wall). There is one matrix for each story section and for each wall, and a 1 denotes a damaged or missing section while a 0 denotes an undamaged one. | |
Output Variables | ||
Wall Covering Mappers | the output is the input after updating | |
Wall Cover Damage Mappers | the output is the input after updating |
DAMAGECOUNTERWALLSHEETS.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | Roof Type: the building’s roof type, it could be either ‘Hipped Roof’ or ‘Gabled Roof’.
Sheathings’ resistance: the randomized capacities of the wall sheathing panels. Loading: the pressure loading imparted on the building’s faces as a result of it being in the trajectory of a wind field. The G Matrix: the limit state condition (‘Resistance – Load’); whenever it is less than zero the load has exceeded the resistance of the component and the component has failed. Wall Sheathing Map Matrices: the matrices mapping the wall sheathing panels to the walls. Wall Cover Map Matrices: the matrices mapping the wall cover sections to the walls. Wall Sheathing Damage Map Matrices: the matrices mapping the damaged wall sheathing panels to the walls. The wall sheathing panels are placed on the studs that support the structural frame of the building; they are usually nailed to the studs. Wall Cover Damage Map Matrices: the matrices mapping the damaged wall cover to the walls. The wall cover is placed on the wall sheathing panels and can be fixed to the panels in a variety of ways (some being stronger than others). Thus, whenever a wall sheathing panel fails, the wall cover corresponding to that panel automatically fails. Main Story: the section of the walls that spans from the floor to the ceiling of every story. Inner Story: the section of the walls that spans from the ceiling of one story to the floor of the story above it. The utilities are typically placed in this section. |
Capacity Matrices | matrices containing the randomized capacities (in psf) for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Load Matrices | matrices containing the loading (in psf) for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Component Mappers | matrices identifying the presence or absence of a component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a component while a 0 denotes the absence of one. | |
Component Damage Mappers | matrices identifying the damage of components (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes a damaged component while a 0 denotes an undamaged one. | |
Output Variables | ||
Wall Covering Mappers | the output is the input after updating | |
Component Damage Mappers | the output is the input after updating |
DAMAGECOUNTERWINDOWS.m
Input Variables | Description | Terms in Documentation |
Capacity Matrices | matrices containing the randomized capacities (in psf) for each glazed component on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | Glazed components’ resistance: the randomized capacity that a component that covering an opening has against pressure loads. Such components can be entry doors, windows, or sliding doors.
Loading: the pressure loading imparted on the building’s faces as a result of it being in the trajectory of a wind field. Glazed component map matrices: the matrices mapping the glazed components to the walls. Glazed component damage map matrices: the matrices mapping the damaged glazed components to the walls. The G Matrix: the limit state condition (‘Resistance – Load’), whenever it is less than zero the load has exceeded the resistance of the component and the component has failed. |
Load Matrices | matrices containing the loading (in psf) for each window on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Load Matrices | matrices containing the loading (in psf) for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a panel while a 0 denotes the absence of one. | |
Glazed Component Damage Mappers | matrices identifying the damage of the glazed component (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes a damaged panel while a 0 denotes an undamaged one. | |
Output Variables | ||
Glazed Component Mappers | the output is the input after updating | |
Glazed Component Damage Mappers | the output is the input after updating |
EXTONLYWALLSHEETPRESSURECOEFFICIENTSRANDOMIZED.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | External Pressure Coefficient: the ASCE 7-05 coefficient that describes the variation of the pressure loads imparted to the building by the wind throughout a given location in the face. Provides the loads on external components such as wall cover or roof cover. |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
TotalNumberofStories | a scalar describing the total number of stories in a building. | External Pressure Coefficient: the ASCE 7-05 coefficient that describes the variation of the pressure loads imparted to the building by the wind throughout a given location in the face. Provides the loads on external components such as wall cover or roof cover. |
COV_GCpsWalls | a scalar describing the coefficient of variation for the pressure coefficients. | |
Weighted External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
Output Variables | ||
Final External Pressure Coefficients | a matrix containing the final external pressure coefficients for every sheathing panel in a given wall of the building (matrix size = # of stories by # of wall sheathing panels fitting on that wall). |
MissilePhysParam.m
Input Variables | Description | Terms in Documentation |
NA | A scalar number representing the number of available missiles | |
Mean | A scalar number representing mean value of the shingle capacity, shingle density, shingle thickness, shingle length, I variable, force coefficient, J variable, shingle width and momentum resistance of the glazing, respectively. | |
Coefficient of Variation | A scalar number representing mean value of the shingle capacity, shingle density, shingle thickness, shingle length, I variable, force coefficient, J variable, shingle width and momentum resistance of the glazing, respectively. | |
Standard Deviation | A scalar number representing mean value of the shingle capacity, shingle density, shingle thickness, shingle length, I variable, force coefficient, J variable, shingle width and momentum resistance of the glazing, respectively. | |
Output Variables | ||
ShingleCapacityImpactModule | A vector of randomized shingle capacities | |
ShingleDensity | A vector of randomized shingle densities | |
Thickness | A vector of randomized shingle thicknesses | |
I | A vector of randomized of values of variable I (fixing strength parameter) | |
CF | A vector of randomized of values of variable CF (Force Coefficient) | |
J | A vector of randomized of values of variable J (the fraction of the wind velocity that the debris can achieve before striking an object or hitting the ground) | |
ShingleLength | A vector of randomized shingle lengths | |
ShingleWidth | A vector of randomized shingle widths | |
mom_resistance | A vector of randomized moment resistance of the glazing |
Numberofavailablemissileobjects.m
Input Variables | Description | Terms in Documentation |
MissileExposureType | a string array describing the missile exposure type, it can be ‘open’, ‘treed’, ‘suburban’, or ‘urban’ | Missile Exposure Type: the density of the environment in which the building is located, this directly affects the number of available missile objects. |
Number_of_shingles | a scalar describing the total number of shingles present in the roof of the building being analyzed. | |
direction_i | scalar values that indicates the current orientation of the wind (direction: 1-8) being analyzed. | |
Suburban_DistMult | Scalar multiplier that augments the distance between buildings to represent a typical Suburban spacing. | |
Open_DistMult | Scalar multiplier that augments the distance between buildings to represent a typical Suburban spacing. | |
Output Variables | ||
NA | a scalar describing the total number of available potential missile objects. | |
Req_Travel | a scalar value identifying the distance required for the debris to strike the building |
OPENINGCORRECTIONFACTOR.m
Input Variables | Description | Terms in Documentation |
ShutterProtection | a string array describing the type of protection present at the openings on a building, it can be ‘None’, ‘Plywood’, ‘Steel’, or ‘Engineered’. Determines the PFactor | Shutter Protection: a type of protective system for openings used during wind events. They can be made of plywood, aluminum, steel, or can even be engineered. Although there are a variety of configurations for storm shutters (Storm Panels, Hurricane Screens, Accordion Shutters, Bahamas Shutters, Colonial Shutters, and Rolling Shutters, among others) the model only considers shutter’s material when determining the capacity correction factor.
Impact Resistance: the degree to which a material used to make a glazed component is resistant to windborne debris impact. PFactor: an internal variable of this function; the shutter protection factor, it could be 1.00, 1.15, 1.25, or 1.50 depending on the type of protection present. PFactor accounts for the added resistance of some physical exterior protection installed over the glazed opening (i.e. a shutter) MFactor: an internal variable of this function; the material’s resistance factor, could be 1.00, 1.50, or 2.00 depending on the material’s impact resistance. MFactor accounts for the added resistance of the window material itself, separate from any exterior physical protective shutter. |
ImpactResistance | a string array describing the type of impact resistance that the glazed components have, it can be ‘Normal Windows’, ‘Laminated Windows’ or ‘Impact Resistant Windows’. Determines the MFactor | |
Output Variables | ||
CorrFactor | a scalar describing the correction that needs to be applied to the glazed components’ capacities, it is simply a multiplication of the PFactor and the MFactor. In this manner the protective properties of having both shutters and impact resistant material are accounted for. Factors are produced for the all three opening components, including window, sliding doors and entry doors. |
Sheathing_Loading_Failure_Gable_New_Approach_4_9_2014.m
Input Variables | Description | Terms in Documentation |
Length | the longer of the linear dimensions of the rectangular roof area. Units are ft. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house.(Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
Width | the shorter of the linear dimensions of the rectangular roof area. Units are ft. | |
RoofSlope | pitch of the roof from the eave to the ridge (example: 6/12) | |
EnclosureCondition | indicator of the enclosure of the building (‘O’ for Open, ‘P’ for Partially Enclosed and ‘E’ Fully Enclosed, which essentially effects the interior pressure coefficient for the building) | |
Velocity | Vector = 1 x 41 vector representing the randomized wind speeds at the mean roof height. Units in mph. | |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
Areas | Matrix = Matrix identifying the total area of each sheathing panel on the Main Roof Regions. Units are ft^2 | |
Areas_Hip | Matrix = Matrix identifying the total area of each sheathing panel on the Hip Regions. Units are ft^2 | |
Area_zone# | Summation of the respective zone matrices (Main roof area + Overhang, where # = 1-3) Units are ft^2. | |
Area_Zone_#_Sheathing_Main | Matrix = the Area contribution of the pressure coefficients on each sheathing panel (where # is 1, 2 or 3, depending on the zone) Units are ft^2. | |
Area_Zone_#_Sheathing_Overhang | Matrix = the Area contribution of the pressure coefficients on each sheathing Element (where # is 2 or 3, depending on the particular overhang zone) Units are ft^2. | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house.(Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
m | Scalar = index for the Velocity vector. | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Rows_Hip | scalar = indicates the number of rows of sheathing on one face of the roof | |
Number_of_Sheathing_Eave | scalar = Indicates the number of sheathing along the eave of the roof Main Roof Region. | |
Number_of_Sheathing_Ridge | scalar = Indicates the number of sheathing along the ridge of the roof Main Roof Region. | |
Sheathing_per_Row | Vector = Indicates the number of sheathing panels present in a specific row in the main roof regions. | |
Width_of_Sheathing | Vector = Indicates the width of sheathing panels present in a specific row in the main roof regions. Units are ft. | |
capacity_sheathing | Matrix = contains the randomly assigned capacity of each of the sheathing panels. The size of the matrix depends on the determined dimensions of the hip region area and is equal to Number_of_Rows by Number_of_Sheathing_Eave. Cells within the matrix that do not represent a sheathing panel is represented by a zero. Units are psf | |
Output Variables | Roof sheathing: The 4×8 ft plywood panels that are attached to the roof trusses and provide a mounting system for the roof cover.
Hip Region: Refers to the triangular sides of the roof on either end of a rectangular house.(Running along the shorter of the two dimension of the house) Main Roof Region: Refers to the trapezoidal sides of the roof on either end of a rectangular house. (Running along the longer of the two dimensions of the house) |
|
percent_damage_Sheathing | Scalar = Output of the total percentage of sheathing loss from the roof due to the wind event. | |
percent_damage_Sheathing_Overhang | Scalar = Output of the percentage of sheathing loss from the eave of roof due to the wind event. | |
percent_damage_Sheathing_Interior | Scalar = Output of the percentage of sheathing loss from interior region of the roof. Interior sheathing panels refer to sheathing that is not along the eave of the roof. | |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading |
Sheathing_R2W_Interface.m
Input Variables | Description | Terms in Documentation |
Length | scalar = the longer of the linear dimensions of the rectangular roof area. Units are ft. | |
Number_of_Sheathing_Row | Scalar = Indicates the number of sheathing along the eave of the roof | |
Number_of_Rows | Scalar = indicates the number of rows of sheathing on one face of the roof | |
Sheathing_Equiv | Matrix = Values indicate which number of sheathing in a particular row, starting from 1 from left to right, is attached to the truss on the Main Roof Region. The column location of the matrix identifies the truss being analyzed. Matrix is Number_of_Rows by Number_of_Trusses_Row in size. | |
Failure_Ident_Sheathing | Matrix = Identifies the sheathing panels that have failed with a value of 1. (initially a zeroes matrix which is the same size as the Length_of_Sheathing matrix) | |
Failure_Load_Sheathing | Matrix = The averaged pressure load on each sheathing panel, taking into consideration the contribution of each zone for each panel and their corresponding pressure loading | |
Number_of_Trusses_Row | scalar = Indicates the number of r2w connections along the eave of the Main Roof Region. | |
Length_of_Sheathing | Matrix = Indicates the length of the individual sheathing running parallel to the longer of the two roof dimensions. Units are ft. | |
Output Variables | ||
percent_damage_Sheathing | scalar = percent damage of all roof sheathing after taking into consideration the effects of truss collapse | |
percent_damage_Sheathing_Overhang | scalar = percent damage of overhang roof sheathing after taking into consideration the effects of truss collapse | |
percent_damage_Sheathing_Interior | scalar = percent damage of interior roof sheathing after taking into consideration the effects of truss collapse | |
percent_damage_r2w | scalar = percent damage of all roof to wall connections after taking into consideration the effects of truss collapse |
Variables_A_B_D_Bakers.m
Input Variables | Description | Terms in Documentation |
ShingleCapacityImpactModule | A vector of randomized shingle capacities | |
AtempSurvivingShingles | A scalar of the number of shingles still attached to roof for subsequent damage analysis ran during the iterative damage loop. | |
mn_GCp_roof | A scalar of the mean roof pressure value | |
COV_GCpsRoof | A scalar of the coefficient of variation of the roof pressure | |
Hurr_Red_Factor | A scalar of the density reduction factor of air density for hurricanes | |
ShingleDensity | A vector of randomized shingle densities | |
Thickness | A vector of randomized shingle thicknesses | |
I | A vector of randomized of values of variable I (fixing strength parameter) | |
CF | A vector of randomized of values of variable CF (Force Coefficient) | |
Gravity | A scalar value representing the gravitational constant | |
AirDensity | A scalar value of the air density during a hurricane event | |
J | A vector of randomized of values of variable J (the fraction of the wind velocity that the debris can achieve before striking an object or hitting the ground) | |
Req_Travel | A scalar value identifying the distance required for the debris to strike the building | |
ShingleLength | A vector of randomized shingle lengths | |
ShingleWidth | A vector of randomized shingle widths | |
mom_resistance | A vector of randomized moment resistance of the glazing | |
direction_i | a scalar describing the wind’s direction of approach, it can be any integer between 1 and 8. A cornering wind is denoted by 2, 4, 6 or 8, wind hitting the short side of the building is denoted by 3 or 7, while wind hitting the building’s long side is denoted by 1 or 5. | |
Velocity | A scalar describing the current speed being analyzed. | |
WindSpeeds_mean_MeanRoofHeight | Amatrices containing the mean wind speed at the height that the matrix index maps to the building’s face. These values are converted from the wind speed measured at a height of 10 meters (33 feet). | |
COV_ WindSpeeds | A scalar describing the coefficient of variation for the wind speeds, a scalar defined by the user. | |
MeanRoofHeight | A scalar representing the height above ground level at their respective positions | |
Output Variables | ||
Avar | a scalar, the number of potential missile objects that have become airborne. | |
Bvar | a scalar, the fraction of the airborne missiles that actually hit the building. | |
Dvar | a scalar, the fraction of the missile that hit the house that have enough momentum to cause damage. | |
AtempSurvivingShingles | A scalar of the number of shingles still attached to roof for subsequent damage analysis ran during the iterative damage loop. |
WALL_GCpe_MINUS_GCpi.m
Input Variables | Description | Terms in Documentation |
direction_i | scalar = indicates orientation of the wind (direction: 1-8) | |
AtempSurvivingShingles | A scalar of the number of shingles still attached to roof for subsequent damage analysis ran during the iterative damage loop. | |
RoofType | Identifies the type of roof system used, “Gable” or “Hip” Roof. | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
TotalNumberofStories | a scalar describing the total number of stories present in a building. | |
GCpi | A vector whose length is equal to the number of floors of the building. The internal pressure is determined by the opening created by wall sheathing and window damages. | |
GCpi_Attic | A scalar indicating the internal pressure of the attic space. | |
Weighted External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
Output Variables | ||
Resultant Pressure Coefficient | a matrix containing the resultant (external + internal) pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). | |
External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). |
WALLCOVERLOADER.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’.) | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
sheetsinGableEnd | a scalar describing the number of sheathing panels that would fit in the gable end if it had no openings, a scalar. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
Velocity | a scalar describing the current speed being analyzed. | |
Final External Pressure Coefficients | a matrix containing the final external pressure coefficients for every location in a given wall of the building (matrix size = # of stories by # of wall sheathing panels fitting on that wall). | |
Randomized Wind Speeds | matrices containing the randomized wind speeds acting at the height of the particular components they are affecting (matrix size = # of stories by 1). | |
Wall Covering Mappers | matrices identifying the presence or absence of a wall cover section at a particular location on its corresponding wall (matrix size = # of stories by # of wall cover sections on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a cover section while a 0’s denote the absence of one). | |
Output Variables | ||
Load Matrices | matrices containing the loading (in psf) for each wall cover section on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WALLLOADER.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’.) | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
sheetsinGableEnd | a scalar describing the number of sheathing panels that would fit in the gable end if it had no openings, a scalar. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
Velocity | a scalar describing the current speed being analyzed. | |
Final Pressure Coefficients | a matrix containing the final superimposed pressure coefficients for every sheathing panel in a given wall of the building (matrix size = # of stories by # of wall sheathing panels fitting on that wall). | |
Randomized Wind Speeds | matrices containing the randomized wind speeds acting at the height of the particular components they are affecting (matrix size = # of stories by 1). | |
Wall Sheathing Panel Mappers | matrices identifying the presence or absence of a wall sheathing panels at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Output Variables | ||
Load Matrices | matrices containing the loading (in psf) for each wall sheathing panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WALLPRESSURECOEFFASCE.m
Input Variables | Description | Terms in Documentation |
WindEffectiveArea | the area of the building that receives the wind. It is a scalar and varies as the winds’ direction of approach changes. | |
Output Variables | ||
External Pressure Coefficient Possibilities | scalars determined in accordance with ASCE 7-05, they are function of the wind effective area of the building and the approach direction of the wind. |
WINDSPEEDat10mtoSPEEDateverystorywalls.m
Input Variables | Description | Terms in Documentation |
z0 | a scalar = roughness length | |
Height | a scalar representing the height above ground level at their respective positions | |
WindSpeeds_avg | a vector of the 41 wind speeds of interesting, ranging from 50 to 250 mph in 5 mph increments | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
Output Variables | ||
Mean Wind Speeds | matrices containing the mean wind speed at the height that the matrix index maps to the building’s face. These values are converted from the wind speed measured at a height of 10 meters (33 feet). |
WINDOWSRANDOMCAPACITIESMAPPED.m
Input Variables | Description | Terms in Documentation |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
mncapacitywindow | a scalar describing the average resistance of a window. It depends on the construction quality and can be 110 psf for weak construction quality, 150 psf for medium, or 180 psf for strong. | |
COV_windowscapacity | a scalar describing the coefficient of variation of the resistances of the windows; it decreases as the construction quality increases. | |
mncapacityEntryDoor | a scalar describing the average resistance of an entry door. It depends on the construction quality and can be 110 psf for weak construction quality, 150 psf for medium, or 180 psf for strong. | |
COV_ EntryDoorscapacity | a scalar describing the coefficient of variation of the resistances of the entry doors; it decreases as the construction quality increases. | |
mncapacitySlidingDoor | a scalar describing the average resistance of a sliding glass door. It depends on the construction quality and can be 110 psf for weak construction quality, 150 psf for medium, or 180 psf for strong. | |
COV_ SlidingDoorscapacity | a scalar describing the coefficient of variation of the resistances of the sliding glass doors; it decreases as the construction quality increases. | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a panel while a 0 denotes the absence of one. | |
Output Variables | ||
Capacity Matrices | matrices containing the randomized capacities (in psf) for each glazed component on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WINDOWSPROBABILITYOFIMPACTFAILURE.m
Input Variables | Description | Terms in Documentation |
direction_i | scalar values that indicates the current orientation of the wind (direction: 1-8) being analyzed. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Avar | a scalar, the number of potential missile objects that have become airborne. | |
Bvar | a scalar, the fraction of the airborne missiles that actually hit the building. | |
The C Matrices | the matrices containing the fraction of area of glazing at a particular location (mapped by the matrix to a corresponding wall location) of the total wall area. | |
Dvar | a scalar, the fraction of the missile that hit the house that have enough momentum to cause damage. | |
NA | the number of available potential missile objects, a scalar, it is a function of the density of the neighborhood. | |
Output Variables | ||
Probability that debris damage a component subjected to impact analysis | matrices (size = # of stories by # of wall sheathing panels that could fit on the corresponding wall face). |
WINDOWSIMPACTRANDOMCAPACITIESMAPPED.m
Input Variables | Description | Terms in Documentation |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
CorrFactor | a scalar describing the correction factor for the opening components’ capacities; a simple multiplication of the PFactor (protection factor) and the MFactor (material factor). | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Output Variables | ||
Impact Capacity Matrices | matrices containing the randomized impact capacities for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WINDOWSAREAANDHEIGHTMAP_CR.m
Input Variables | Description | Terms in Documentation |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
LengthFLR | a scalar describing the building’s floor plan length. | |
WidthFLR | a scalar, the building’s floor plan width. | |
InnerStoryHeight | a scalar, usually 2 ft. | |
MainStoryHeight | a scalar, usually 8, 9 or 10 ft. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings. | |
FractionAreaGlazingperFloor | a scalar describing the percentage of openings per floor calculated out of the wall surface area within a given floor. | |
WindowLength | a scalar, the model currently uses a 4 ft. long window. | |
WindowHeight | a scalar, the model currently uses a 5 ft. tall window. | |
SLDoorLength | a scalar, the model currently uses an 8 ft. long sliding door. | |
SLDoorHeight | a scalar, the model currently uses an 8 ft. tall sliding door. | |
EntryDoorLength | a scalar, the model currently uses a 4 ft. long entry door. | |
EntryDoorHeight | a scalar, the model currently uses an 8 ft. tall entry door. | |
Output Variables | ||
SLdoorlocationindex | a matrix mapping the location of the sliding doors (matrix size = # of stories by # of sliding doors per floor). |
WINDOWLOADER.m
Input Variables | Description | Terms in Documentation |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
Final Pressure Coefficients | a matrix containing the final superimposed pressure coefficients for every location in a given wall of the building (matrix size = # of stories by # of wall sheathing panels fitting on that wall). | |
Randomized Wind Speeds | matrices containing the randomized wind speeds acting at the height of the particular components they are affecting (matrix size = # of stories by 1). | |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Output Variables | ||
Load Matrices | matrices containing the loading (in psf) for each window on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WINDOWIMPACTCAPACITIESUPDATER.m
Input Variables | Description | Terms in Documentation |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Impact Capacity Matrices | matrices containing the randomized impact capacities for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Output Variables | ||
Impact Capacity Matrices | the updated inputs. |
WINDOWCAPACITIESUPDATER.m
Input Variables | Description | Terms in Documentation |
Glazed Component Mappers | matrices identifying the presence or absence of a glazed component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a panel while 0’s denote the absence of one). | |
Capacity Matrices | matrices containing the randomized capacities for each panel on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Output Variables | ||
Capacity Matrices | the output is the input after updating |
WINDEFFECTIVEAREAFINDER.m
Input Variables | Description | Terms in Documentation |
LengthFLR | a scalar describing the building’s floor plan length. | |
WidthFLR | a scalar describing the building’s floor plan width. | |
EaveHeight | a scalar height to the roof eave in feet | |
direction_i | the wind’s direction of approach relative to the building front | |
Output Variables | ||
WindEffectiveArea | a scalar describing the area of the building that receives the wind. It varies as the wind’s direction of approach changes. |
WEIGHTEDEXTERNALWALLPRESSURECOEFFICIENTS.m
Input Variables | Description | Terms in Documentation |
RoofSlope | a scalar containing roof slope | |
RoofType | ‘Gable’ or ‘Hip’. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
sheetsinLongSide | the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
a | The ASCE ‘a’ dimension used to delineate different loading zones on building exterior | |
InnerStoryHeight | a scalar, usually 2 ft. | |
MainStoryHeight | a scalar, usually 8, 9 or 10 ft. | |
SheathingPanelLength | a scalar, the long dimension of a sheathing panel (commercially available 8 ft., 9 ft., 10 ft.). | |
Sheathing PanelWidth | a scalar, the short dimension of a sheathing panel (currently 4 ft.). | |
PanelHeightLeft | a matrix, contains the vertical dimension of the left side of each panel placed in the gable end. | |
PanelHeightRight | a matrix, contains the vertical dimension of the right side of each panel placed in the gable end. | |
GableEndSheetMapShortSide1 | a matrix, identifies the presence or absence of a sheathing panel at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). A 1 denotes the presence of a panel while a 0 denotes the absence of one. | |
External Pressure Coefficient Possibilities | scalars determined in accordance with ASCE 7-05, they are function of the wind effective area of the building and the approach direction of the wind. | |
Output Variables | ||
Weighted External Pressure Coefficients | a matrix containing the weighted external pressure coefficients for every sheathing panel in a given floor (matrix size = 1 by # of wall sheathing panels on that wall). |
WALLSWINDSPEEDRANDOMIZED.m
Input Variables | Description | Terms in Documentation |
Velocity | a scalar describing the current speed being analyzed. | |
Mean Wind Speeds | matrices containing the mean wind speed at the height that the matrix index maps to the building’s face. These values are converted from the wind speed measured at a height of 10 meters (33 feet). | |
COV_ WindSpeeds | a scalar describing the coefficient of variation for the wind speeds, a scalar defined by the user. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | |
Output Variables | ||
Randomized Wind Speeds | matrices containing the randomized wind speeds acting at the height of the particular components they are affecting (matrix size = # of stories by 1). |
WALLSSHEETHEIGHTMAP.m
Input Variables | Description | Terms in Documentation |
InnerStoryHeight | a scalar, usually 2 ft. | |
MainStoryHeight | a scalar, usually 8, 9 or 10 ft. | |
EaveHeight | a scalar, the height at the roof’s eave in feet, measured from the ground. | |
TotalNumberofStories | a scalar, number of building stories | |
RoofType | ‘Gable’ or ‘Hip’. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
PanelHeightLeft | a matrix, contains the vertical dimension of the left side of each panel placed in the gable end. | |
PanelHeightRight | a matrix, contains the vertical dimension of the right side of each panel placed in the gable end. | |
SheathingPanelLength | a scalar, the long dimension of a sheathing panel (commercially available 8 ft., 9 ft., 10 ft.). | |
GableEndSheetMapShortSide1 | a matrix, identifies the presence or absence of a sheathing panel at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). A 1 denotes the presence of a panel while a 0 denotes the absence of one. | |
Output Variables | ||
MainStoryHeights | a matrix (size = # of stories by 1) containing the heights of the centroids of the sheathing panels located at the main story zone. | |
InnerStoryHeights | a matrix (size = # of stories by 1) containing the heights of the centroids of the sheathing panels located at the inner story zone. | |
GableEndHeights | a matrix (size = 1 by # of sheathing panels that horizontally fit in the gable end) containing the heights of the centroids of the sheathing panels located at the gable end zone. |
WALLSHEETRANDOMCAPACITIESMAPPED.m
Input Variables | Description | Terms in Documentation |
RoofType | a string array describing the geometry of the roof, it can be either ‘Gable’ or ‘Hip’. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
TotalNumberofStories | a scalar describing the total number of stories in the building. | |
NoofWindSpeeds | a scalar describing the total number of wind speeds for which the analysis is performed. | |
mncapacitywallcover | a scalar describing the average capacity of the wall cover sections; it depends on the construction quality. | |
mncapacitywallsheets | a scalar describing the average capacity of the wall sheathing panels; it depends on the construction quality. | |
COV_wallsheetscapacity | a scalar describing the coefficient of variation for the resistance of the wall sheathing panels; it decreases as the construction quality increases. | |
COV_wallcovercapacity | a scalar describing the coefficient of variation for the resistance of the wall cover sections; it decreases as the construction quality increases. | |
Component Mappers | matrices identifying the presence or absence of a component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a component while 0’s denote the absence of one). | |
Output Variables | ||
Capacity Matrices | matrices containing the randomized capacities (in psf) for each component on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. |
WALLSHEETPRESSURECOEFFICIENTSRANDOMIZED.m
Input Variables | Description | Terms in Documentation |
RoofType | ‘Gable’ or ‘Hip’. | |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. | |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. | |
sheetsinLongSide | a scalar describing the number of sheathing panels that would fit in the long side if it had no openings, a scalar. | |
sheetsinShortSide | a scalar describing the number of sheathing panels that would fit in the short side if it had no openings, a scalar. | |
TotalNumberofStories | a scalar. | |
NoofWindSpeeds | a scalar, it is the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). | |
COV_GCpsWalls | a scalar. | |
Resulting Pressure Coefficient Matrices | the matrices containing the superimposed values for the external and internal pressure coefficients (matrix size = # of stories by # of wall sheathing panels on that wall). | |
Output Variables | ||
Final Pressure Coefficients | a matrix containing the final superimposed pressure coefficients for every sheathing panel in a given wall of the building (matrix size = # of stories by # of wall sheathing panels fitting on that wall). |
WALLSHEETCAPACITIESUPDATER.m
Input Variables | Description | Terms in Documentation |
RoofType | the building’s roof type, it could be either ‘Hipped Roof’ or ‘Gabled Roof’. | |
Component Mappers | matrices identifying the presence or absence of a component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall (1’s denote the presence of a component while 0’s denote the absence of one). | |
Capacity Matrices | matrices containing the randomized capacities (in psf) for each component on that wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall. | |
Output Variables | ||
Capacity Matrices | the output is the input variable after updating |
WALLSHEETAREAMAP.m
Input Variables | Description |
SLdoorlocationindex | a matrix mapping the location of the sliding doors (matrix size = # of stories by # of sliding doors per floor). |
SLDoorLength | a scalar, the model currently uses an 8 ft. long sliding door. |
SLDoorHeight | a scalar, the model currently uses an 8 ft. tall sliding door. |
NoofWindSpeeds | a scalar, it is the total number of wind speeds for which the analysis is performed, it can be specified by the user and it currently is 51 wind speeds (0 to 250 mph with 5 mph intervals). |
TotalNumberofStories | a scalar, number of building stories |
SheathingPanelsHorizontallyAcrossGableEnd | the number of sheathing panels that would fit horizontally in the gable end if it had no openings, a scalar. |
SheathingPanelsVerticallyAcrossGableEnd | the number of sheathing panels that would fit vertically in the gable end if it had no openings, a scalar. |
sheetsinLongSide | the number of sheathing panels that would fit in the long side if it had no openings, a scalar. |
sheetsinShortSide | the number of sheathing panels that would fit in the short side if it had no openings, a scalar. |
SheathingPanelLength | a scalar, the long dimension of a sheathing panel (commercially available 8 ft., 9 ft., 10 ft.). |
Sheathing PanelWidth | a scalar, the short dimension of a sheathing panel (currently 4 ft.). |
GableEndHeight | a scalar, the height of the gable end, measured from the eave to the highest point in the roof. |
MainStoryHeight | a scalar, usually 8, 9 or 10 ft. |
InnerStoryHeight | a scalar, usually 2 ft. |
RoofType | ‘Gable’ or ‘Hip’. |
RoofSlope | a scalar.. |
Glazed Component Area Maps | matrices containing the areas of a particular component mapped to a particular location (identified by the indexes of its location in the matrix) in a given wall. Each component has a matrix for each wall. |
Output Variables | |
PanelHeightLeft | a matrix, contains the vertical dimension of the left side of each panel placed in the gable end. |
PanelHeightRight | a matrix, contains the vertical dimension of the right side of each panel placed in the gable end. |
TotalGableEndWallCoverArea | a scalar, the total area occupied by the wall cover in the gable ends. |
TotalWallCoverAreaforaFloor | a scalar, the total area occupied by the wall cover per floor. |
TotalGableEndWallSheatingArea | a scalar, the total area occupied by wall sheathing in the gable ends |
TotalWallSheatingAreaforaFloor | a scalar, the total area occupied by wall sheathing per floor. |
Component Mappers (Originals) | matrices identifying the presence or absence of a component at a particular location on its corresponding wall (matrix size = # of stories by # of wall sheathing panels on that wall). There is one matrix for each story section and for each wall, and a 1 denotes the presence of a component while a 0 denotes the absence of one. |
Component Area Maps | matrices containing the area occupied by a component in a location of a wall mapped by the matrix indexes (matrix size = # of stories by # of wall sheathing panels on that wall). |
Terms in Documentation
Sheathing Panels: The panels that are placed on the studs to cover the frame (skeleton of the building) are called sheathing panels. Common construction practices indicate that 4 ft. wide by 8 ft., 9 ft., or 10 ft. long plywood sheathing panels are available. It will be assumed that the panels are placed vertically and side by side (with the 4 ft. dimension horizontally).
Main Story Height: the space between the top of the floor slab and the ring beam supporting the slab of the floor above created by placing sheathing panels vertically and side by side (with the 4 ft. dimension horizontally). Construction techniques usually put a ring beam at the bottom of the joists to support the floor slabs.
Inner Story Height: the space between the ring beam and the top of the floor slab; the sheathing panels are also placed with the 4 ft. dimension horizontally in this area.
The “Main and Inner Story Heights” can actually be anything the user inputs, however the program will assume that the sheets used are 4 ft. wide by “Main Story Height” or “Inner Story Height”, depending on the location of the sheathing panel. The 4 ft. by 8 ft., 9 ft., or 10 ft. plywood sheathing panels are not the only ones commercially available, they are simply more common, thus in this function any size of plywood panels could be used. However, the width of the sheathing panels has been set to 4 ft. The wall cover sections simply go on the sheathing panels.
Z_Pressure_First_MAIN_DRIVER.m
Input Variables | Description | Terms in Documentation |
ConstructionQuality | The quality of the individual components. Variable is assigned as “Weak”, “Medium” or “Strong”, depending on the level of resilience of the components. Selection of capacities are based on this input. | |
NoofSimulations | Total number of simulation to be ran for every wind speed, and at eight directions. | |
ShutterProtection | Identifies whether or not Shutter Protection is available for the windows. There are four selectable options: “ None” which signifies that no additional protection was used. An input of “Plywood”, “Steel” or “Engineered” indicates the use of shutter protection and including the type. Window capacity is multiplied by a factor, depending on the selection. | |
RoofType | Identifies the type of roof system used, “Gable” or “Hip” Roof. | |
TotalNumberofStories | Identifies the number of stories the building has. (1, 2 or 3 stories) | |
LengthFLR | The longer of the two footprint dimensions. | |
WidthFLR | The shorter of the two footprint dimensions. | |
Output Variables | ||
Output | The four dimensional damage matrix, containing the desired output data. Size of the matrix is dependent on the number of iterations, output data, wind speeds and orientations. (Example: NoofSimulations = 1000, Output data = 30 variables, Velocity = 50:5:250 (41 values) and Orientation = 0:45:315 (8 values) ……Size is equal to 1000*30*41*8) | |
Header | List of input and model information, such as: dimensions, materials and other information particular to the model that was ran. |
MCS-MHB
Model_Control_for_Mid_High_Model_February_1_2009.m
Input Variables | Description | Terms in Documentation |
No_of_Simulations | Number of simulations to be performed | Input variables for the model. See Design Requirements Section. |
All_Bldg_Types | Lists available building types: “Exterior Stairway” and “Interior Stairway” | |
All_Unit_Locations | Lists available unit locations: “Middle” and “Corner” | |
All_Shutter_Protection_Types | Lists available shutter protection types: “None”, “Plywood”, “Steel”, and “Engineered” | |
All_Glazing_Types | Lists available glazing types: “Normal Glass”, “Impact Resistant Glass”, and “Laminated Glass” | |
All_MissileExposure_Types | Missile exposure types, i.e. the density of the surrounding area. Available values are: “Urban”, “Suburban”, and “Open” |
|
Unit_Zone | Zone selection, i.e. the zone that the unit is within Available values: “Zone_1”, “Zone_2”, and “Zone_3” | |
Unit_Int_Widths | The dimension of a unit along the side with a neighboring unit | |
Unit_Ext_Lengths | The dimension of a unit along the side without a neighboring unit |
Mid_High_Opening_Analysis_Driver_February_1_2009.m
Input Variables | Description | Terms in Documentation |
No_of_Simulations | Total number of simulation to be ran for every wind speed, within ever orientation | Input variables for the model. See Design Requirements Section. |
ShutterProtection | Identifies whether or not Shutter Protection is available for the windows. There are four selectable options: “ None” which signifies that no additional protection was used. An input of “Plywood”, “Steel” or “Engineered” indicates the use of shutter protection and including the type. Window capacity is multiplied by a factor, depending on the selection. [Factor = 1 (“None”), 1.1 (“Plywood”), 1.25 (“Steel”) and 1.5(“Engineered”)] | |
MissleExposureType | Identifies the surrounding area of the building. (Input ‘Urban’, ‘Suburban’, ‘Open’, or ‘Treed’) | |
Unit_Location | Identifies the location of the unit within the building (‘Corner Unit’ or ‘Middle Unit’) | |
Bldg_Type | Identifies the type of building in which the unit is located (‘Closed corridor building’ or ‘Open corridor building’) | |
Unit_Ext_Lengths | Dimension of the unit wall along the exterior of the building. Unit are in ft | |
Unit_Int_Widths | Dimension of the unit wall along shared by adjacent units. Unit are in ft | |
Output Variables | ||
Output | The four dimensional damage matrix, containing the desired output data. Size of the matrix is dependent on the number of iterations, output data, wind speeds and orientations. (Example: NoofSimulations = 1000, Output data = 6 variables, Velocity = 50:5:250 (41 values) and Orientation = 0:45:315 (8 values) ……Size is equal to 1000*30*41*8) | Output of the model. See Design Requirements Section. |
Header | Matrix which contains information pertaining to the model that was ran. (i.e. Number of Windows, Size of Windows…etc.) | |
Total_No_of_Windows | identifies the total number of windows belonging to a unit. |
adimcalculator.m
Input Variables | Description | Terms in Documentation |
Height_Bldg | A scalar describing the building’s mean roof height in feet | ASCE 7-05: the standard used to determine the design loads on a building.
Loading Zones: ASCE 7-05 divides the roof and walls of a building into different loading zones. The pressure loading varies throughout the building because as the wind flows through the body it behaves differently from zone to zone. The zones are 1, 2, and 3 on the roof and 4 and 5 on the wall faces; zone 3 has the strongest loads but is the smallest zone, zones 2 and 5 have the medium loads and are the 2nd largest zones, while zones 1 and 4 have the weakest loads and are the largest zones. The different loading zones are shown in Figure 1: “ASCE 7-05 ‘a’ dimension and loading zones”. a: the dimension that specifies the size and locations of the loading zones. ‘a’ is a function of the building’s dimensions. The ‘a’ dimension is shown in Figure 1: “ASCE 7-05 ‘a’ dimension and loading zones”. |
Width_Bldg | A scalar describing the re-assigned building’s roof plan width dimension | |
Output Variables | Description | |
a | ‘a’ dimension |
OPENINGCORRECTIONFACTOR.m
Input Variables | Description | Terms in Documentation |
ShutterProtection | A string array describing the type of protection present at the openings on a building, it can be ‘None’, ‘Plywood’, ‘Steel’, or ‘Engineered’. Determines the PFactor | Shutter Protection: a type of protective system for openings used during wind events. They can be made of plywood, aluminum, steel, or can even be engineered. Although there are a variety of configurations for storm shutters (Storm Panels, Hurricane Screens, Accordion Shutters, Bahamas Shutters, Colonial Shutters, and Rolling Shutters, among others) the model only considers shutter’s material when determining the capacity correction factor.
Impact Resistance: the degree to which a material used to make a glazed component is resistant to windborne debris impact. PFactor: an internal variable of this function; the shutter protection factor, it could be 1.00, 1.15, 1.25, or 1.50 depending on the type of protection present. PFactor accounts for the added resistance of some physical exterior protection installed over the glazed opening (i.e. a shutter) MFactor: an internal variable of this function; the material’s resistance factor, could be 1.00, 1.50, or 2.00 depending on the material’s impact resistance. MFactor accounts for the added resistance of the window material itself, separate from any exterior physical protective shutter |
ImpactResistance | A string array describing the type of impact resistance that the glazed components have, it can be ‘Normal Windows’, ‘Laminated Windows’ or ‘Impact Resistant Windows’. Determines the MFactor | |
Output Variables | Description | |
CorrFactor | A scalar describing the correction that needs to be applied to the glazed components’ capacities, it is simply a multiplication of the PFactor and the MFactor. In this manner the protective properties of having both shutters and impact resistant material are accounted for. Factors are produced for the all three opening components, including window, sliding doors and entry doors |