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
Download PDF
Sidebar