Table of Contents¶
An outline of all sections included in this SRS is recorded here for easy reference.
- Table of Contents
- Reference Material
- Introduction
- Stakeholders
- General System Description
- Specific System Description
- Problem Description
- Solution Characteristics Specification
- Requirements
- Likely Changes
- Unlikely Changes
- Traceability Matrices and Graphs
- Values of Auxiliary Constants
- References
- Appendix
Reference Material¶
This section records information for easy reference.
Table of Units¶
The unit system used throughout is SI (Système International d'Unités). In addition to the basic units, several derived units are also used. For each unit, the Table of Units lists the symbol, a description, and the SI name.
| Symbol | Description | SI Name |
|---|---|---|
| $kg$ | mass | kilogram |
| $m$ | length | metre |
| $N$ | force | newton |
| $Pa$ | pressure | pascal |
| $s$ | time | second |
Table of Symbols¶
The symbols used in this document are summarized in the Table of Symbols along with their units. The symbols are listed in alphabetical order.
| Symbol | Description | Units |
|---|---|---|
| $a$ | Plate length (long dimension) | $m$ |
| $AR$ | Aspect ratio | -- |
| $AR_max$ | Maximum aspect ratio | -- |
| $B$ | Risk of failure | -- |
| $b$ | Plate width (short dimension) | $m$ |
| $capacity$ | Capacity or load resistance | $Pa$ |
| $d_max$ | Maximum value for one of the dimensions of the glass plate | $m$ |
| $d_min$ | Minimum value for one of the dimensions of the glass plate | $m$ |
| $E$ | Modulus of elasticity of glass | $Pa$ |
| $g$ | Glass type | -- |
| $GTF$ | Glass type factor | -- |
| $h$ | Minimum thickness | $m$ |
| $interpY$ | InterpY | -- |
| $interpZ$ | InterpZ | -- |
| $isSafeLoad$ | Load resistance safety requirement | -- |
| $isSafeLR$ | 3 second load equivalent resistance safety requirement | -- |
| $isSafePb$ | Probability of glass breakage safety requirement | -- |
| $isSafeProb$ | Probability of failure safety requirement | -- |
| $J$ | Stress distribution factor (Function) | -- |
| $J_max$ | Maximum value for the stress distribution factor | -- |
| $J_min$ | Minimum value for the stress distribution factor | -- |
| $J_tol$ | Tolerable stress distribution factor | -- |
| $k$ | Surface flaw parameter | $\frac{m^12}{N^7}$ |
| $LDF$ | Load duration factor | -- |
| $Load$ | Applied load (demand) or pressure | $Pa$ |
| $LR$ | Load resistance | $Pa$ |
| $LSF$ | Load share factor | -- |
| $m$ | Surface flaw parameter | $\frac{m^12}{N^7}$ |
| $NFL$ | Non-factored load | $Pa$ |
| $P_b$ | Probability of breakage | -- |
| $P_btol$ | Tolerable probability of breakage | -- |
| $P_f$ | Probability of failure | -- |
| $P_ftol$ | Tolerable probability of failure | -- |
| $q$ | Applied load (demand) | $Pa$ |
| $q̂$ | Dimensionless load | -- |
| $q̂_tol$ | Tolerable load | -- |
| $SD$ | Stand off distance | $m$ |
| $SD_max$ | Maximum stand off distance permissible for input | $m$ |
| $SD_min$ | Minimum stand off distance permissible for input | $m$ |
| $SD_x$ | Stand off distance ($x$-component) | $m$ |
| $SD_y$ | Stand off distance ($y$-component) | $m$ |
| $SD_z$ | Stand off distance ($z$-component) | $m$ |
| $t$ | Nominal thickness t is in ${2.5,2.7,3.0,4.0,5.0,6.0,8.0,10.0,12.0,16.0,19.0,22.0}$ | $mm$ |
| $t_d$ | Duration of load | $s$ |
| $TNT$ | TNT equivalent factor | -- |
| $w$ | Charge weight | $kg$ |
| $w_max$ | Maximum permissible input charge weight | $kg$ |
| $w_min$ | Minimum permissible input charge weight | $kg$ |
| $w_TNT$ | Equivalent TNT charge mass | $kg$ |
Abbreviations and Acronyms¶
| Abbreviation | Full Form |
|---|---|
| A | Assumption |
| AN | Annealed |
| AR | Aspect Ratio |
| DD | Data Definition |
| FT | Fully Tempered |
| GS | Goal Statement |
| GTF | Glass Type Factor |
| HS | Heat Strengthened |
| IG | Insulating Glass |
| IM | Instance Model |
| LC | Likely Change |
| LDF | Load Duration Factor |
| LG | Laminated Glass |
| LR | Load Resistance |
| LSF | Load Share Factor |
| N/A | Not Applicable |
| NFL | Non-Factored Load |
| PS | Physical System Description |
| R | Requirement |
| RefBy | Referenced by |
| Refname | Reference Name |
| SD | Stand Off Distance |
| SRS | Software Requirements Specification |
| TM | Theoretical Model |
| UC | Unlikely Change |
| Uncert. | Typical Uncertainty |
Introduction¶
Explosions in downtown areas are dangerous from the blast itself and also potentially from the secondary effect of falling glass. Therefore, software is needed to predict whether a glass slab can withstand a blast under given conditions. For example, we might wish to know whether a pane of glass fails from a gas main explosion or from a small fertilizer truck bomb. The document describes the program called GlassBR , which is based on the original, manually created version of <a href=\"https://github.com/smiths/caseStudies/tree/master/CaseStudies/glass\">GlassBR</a>.
The following section provides an overview of the Software Requirements Specification (SRS) for GlassBR. This section explains the purpose of this document, the scope of the requirements, the characteristics of the intended reader, and the organization of the document.
Purpose of Document¶
The primary purpose of this document is to record the requirements of GlassBR. Goals, assumptions, theoretical models, definitions, and other model derivation information are specified, allowing the reader to fully understand and verify the purpose and scientific basis of GlassBR. With the exception of system constraints, this SRS will remain abstract, describing what problem is being solved, but not how to solve it.
This document will be used as a starting point for subsequent development phases, including writing the design specification and the software verification and validation plan. The design document will show how the requirements are to be realized, including decisions on the numerical algorithms and programming environment. The verification and validation plan will show the steps that will be used to increase confidence in the software documentation and the implementation. Although the SRS fits in a series of documents that follow the so-called waterfall model, the actual development process is not constrained in any way. Even when the waterfall model is not followed, as Parnas and Clements point out parnasClements1986 , the most logical way to present the documentation is still to "fake" a rational design process.
Scope of Requirements¶
The scope of the requirements includes determining the safety of a glass slab under a blast loading following the ASTM standard (astm2009 ).
Characteristics of Intended Reader¶
Reviewers of this documentation should have an understanding of second year calculus, structural mechanics, glass breakage, blast risk, computer applications in civil engineering, and applicable standards for constructions using glass from astm2009 , astm2012 , and astm2016 in references. The users of GlassBR can have a lower level of expertise, as explained in Sec:User Characteristics.
Organization of Document¶
The organization of this document follows the template for an SRS for scientific computing software proposed by koothoor2013 , smithLai2005 , smithEtAl2007 , and smithKoothoor2016 . The presentation follows the standard pattern of presenting goals, theories, definitions, and assumptions. For readers that would like a more bottom up approach, they can start reading the data definitions and trace back to find any additional information they require.
The goal statements are refined to the theoretical models and the theoretical models to the instance models. The data definitions are used to support the definitions of the different models.
Stakeholders¶
This section describes the stakeholders: the people who have an interest in the product.
The Client¶
The client for GlassBR is a company named Entuitive. It is developed by Dr. Manuel Campidelli. The client has the final say on acceptance of the product.
The Customer¶
The customers are the end user of GlassBR.
General System Description¶
This section provides general information about the system. It identifies the interfaces between the system and its environment, describes the user characteristics, and lists the system constraints.
System Context¶
Fig:sysCtxDiag shows the system context. A circle represents an external entity outside the software, the user in this case. A rectangle represents the software system itself (GlassBR). Arrows are used to show the data flow between the system and its environment.
The interaction between the product and the user is through a user interface. The responsibilities of the user and the system are as follows:
- User Responsibilities
- Provide the input data related to the glass slab and blast type, ensuring no errors in the data entry.
- Ensure that consistent units are used for input variables.
- Ensure required software assumptions are appropriate for any particular problem input to the software.
- GlassBR Responsibilities
- Detect data type mismatch, such as a string of characters input instead of a floating point number.
- Determine if the inputs satisfy the required physical and software constraints.
- Predict whether the glass slab is safe or not.
User Characteristics¶
- The end user of GlassBR is expected to have completed at least the equivalent of the second year of an undergraduate degree in civil engineering or structural engineering.
- The end user is expected to have an understanding of theory behind glass breakage and blast risk.
- The end user is expected to have basic computer literacy to handle the software.
System Constraints¶
There are no system constraints.
Specific System Description¶
This section first presents the problem description, which gives a high-level view of the problem to be solved. This is followed by the solution characteristics specification, which presents the assumptions, theories, and definitions that are used.
Problem Description¶
A system is needed to predict whether a glass slab can withstand a blast under given conditions.
Terminology and Definitions¶
This subsection provides a list of terms that are used in the subsequent sections and their meaning, with the purpose of reducing ambiguity and making it easier to correctly understand the requirements. All of the terms are extracted from astm2009 .
- Glass breakage - The fracture or breakage of any lite or ply in monolithic, laminated, or insulating glass.
- Lateral - Perpendicular to the glass surface.
- Lite - Pieces of glass that are cut, prepared, and used to create the window or door.
- Specifying authority - The design professional responsible for interpreting applicable regulations of authorities having jurisdiction and considering appropriate site specific factors to determine the appropriate values used to calculate the specified design load, and furnishing other information required to perform this practice.
- Blast resistant glazing - Glazing that provides protection against air blast pressure generated by explosions.
- Equivalent TNT charge mass - Mass of TNT placed on the ground in a hemisphere that represents the design explosive threat.
- Glass Type:
- Annealed (AN) - A flat, monolithic, glass lite which has uniform thickness where the residual surface stresses are almost zero, as defined in astm2016 .
- Fully tempered (FT) - A flat, monolithic, glass lite of uniform thickness that has been subjected to a special heat treatment process where the residual surface compression is not less than 69 MPa (10 000 psi) or the edge compression not less than 67 MPa (9700 psi), as defined in astm2012 .
- Heat strengthened (HS) - A flat, monolithic, glass lite of uniform thickness that has been subjected to a special heat treatment process where the residual surface compression is not less than 24 MPa (3500psi) or greater than 52 MPa (7500 psi), as defined in astm2012 .
- Applied load (demand) or pressure - A uniformly distributed lateral pressure.
- Load resistance (LR) - The uniform lateral load that a glass construction can sustain based upon a given probability of breakage and load duration as defined in astm2009 (pp. 1 and 53).
- Non-factored load (NFL) - Three second duration uniform load associated with a probability of breakage less than or equal to 8 lites per 1000 for monolithic AN glass.
- Glass weight load - The dead load component of the glass weight.
- Short duration load - Any load lasting 3 seconds or less.
- Specified design load - The magnitude in Pa (psf), type (for example, wind or snow) and duration of the load given by the specifying authority.
- Long duration load - Any load lasting approximately 30 days.
- Stand off distance (SD) - The distance from the glazing surface to the centroid of a hemispherical high explosive charge.
- Load share factor (LSF) - A multiplying factor derived from the load sharing between the double glazing, of equal or different thicknesses and types (including the layered behaviour of LG under long duration loads), in a sealed IG unit.
- Glass type factor (GTF) - A multiplying factor for adjusting the LR of different glass type, that is, AN, FT, or HS, in monolithic glass, LG (Laminated Glass), or IG (Insulating Glass) constructions.
- Aspect ratio (AR) - The ratio of the long dimension of the glass to the short dimension of the glass. For glass supported on four sides, the aspect ratio is always equal to or greater than 1.0. For glass supported on three sides, the ratio of the length of one of the supported edges perpendicular to the free edge, to the length of the free edge, is equal to or greater than 0.5.
- Probability of breakage ($P_b$) - The fraction of glass lites or plies that would break at the first occurrence of a specified load and duration, typically expressed in lites per 1000 (astm2016 ).
Physical System Description¶
The physical system of GlassBR, as shown in Fig:physSystImage, includes the following elements:
PS1: The glass slab.
PS2: The point of explosion. Where the bomb, or any kind of man-made explosion, is located. The stand off distance is the distance between the point of explosion and the glass.
Goal Statements¶
Given the dimensions of the glass plane, the glass type, the characteristics of the explosion, and the tolerable probability of breakage, the goal statement is:
<div id=\"willBreakGS\"> Predict-Glass-Withstands-Explosion: Analyze and predict whether the glass slab under consideration will be able to withstand the explosion of a certain degree which is calculated based on user input.
</div>
Solution Characteristics Specification¶
The instance models that govern GlassBR are presented in the Instance Model Section. The information to understand the meaning of the instance models and their derivation is also presented, so that the instance models can be verified.
Assumptions¶
This section simplifies the original problem and helps in developing the theoretical models by filling in the missing information for the physical system. The assumptions refine the scope by providing more detail.
<div id=\"assumpGT\"> glassType: The standard E1300-09a for calculation applies only to monolithic, laminated, or insulating glass constructions of rectangular shape with continuous lateral support along one, two, three, or four edges. This practice assumes that: (1) the supported glass edges for two, three and four-sided support conditions are simply supported and free to slip in plane; (2) glass supported on two sides acts as a simply supported beam; and (3) glass supported on one side acts as a cantilever.
</div>
<div id=\"assumpGC\"> glassCondition: Following astm2009 (pg. 1), this practice does not apply to any form of wired, patterned, etched, sandblasted, drilled, notched, or grooved glass with surface and edge treatments that alter the glass strength. (RefBy: UC:Accommodate-Altered-Glass.)
</div>
<div id=\"assumpES\"> explainScenario: This system only considers the external explosion scenario for its calculations. (RefBy: LC:Calculate-Internal-Blast-Risk.)
</div>
<div id=\"assumpSV\"> standardValues: The values provided in Sec:Values of Auxiliary Constants are assumed for the duration of load ($t_d$), and the material properties of $m$, $k$, and $E$. (RefBy: IM:sdfTol, IM:nFL, IM:dimlessLoad, LC:Variable-Values-of-m,k,E, A:ldfConstant, and DD:loadDurFactor.)
</div>
<div id=\"assumpGL\"> glassLite: Glass under consideration is assumed to be a single lite; hence, the value of LSF is equal to 1 for all calculations in GlassBR. (RefBy: LC:Accomodate-More-than-Single-Lite.)
</div>
<div id=\"assumpBC\"> boundaryConditions: Boundary conditions for the glass slab are assumed to be 4-sided support for calculations. (RefBy: LC:Accomodate-More-Boundary-Conditions.)
</div>
<div id=\"assumpRT\"> responseType: The response type considered in GlassBR is flexural. (RefBy: LC:Consider-More-than-Flexure-Glass.)
</div>
<div id=\"assumpLDFC\"> ldfConstant: With reference to A:standardValues, the value of load duration factor ($LDF$) is a constant in GlassBR. (RefBy: LC:Variable-Values-of-m,k,E and DD:loadDurFactor.)
</div>
Theoretical Models¶
This section focuses on the general equations and laws that GlassBR is based on.
<table class=\"tdefn\">
Safety Probability </td> </tr>
If $isSafeProb$, the structure is considered safe. </td> </tr>
astm2009 </td> </tr>
<table class=\"tdefn\">
Safety Load </td> </tr>
If $isSafeLoad$, the structure is considered safe. </td> </tr>
astm2009 </td> </tr>
</td> </tr> </table>
General Definitions¶
There are no general definitions.
Data Definitions¶
This section collects and defines all the data needed to build the instance models.
<table class=\"ddefn\">
Minimum thickness </td> </tr>
$h$ </td> </tr>
$m$ </td> </tr>
$t$ is a function that maps from the nominal thickness ($h$) to the minimum thickness. </td> </tr>
astm2009 </td> </tr>
IM:sdfTol, IM:riskFun, IM:nFL, and IM:dimlessLoad
</td>
</tr>
</table>
<table class=\"ddefn\">
Load duration factor </td> </tr>
$LDF$ </td> </tr>
Unitless </td> </tr>
$t_d$ and $m$ come from A:standardValues.
$LDF$ is assumed to be constant (from A:ldfConstant). </td> </tr>
astm2009 </td> </tr>
IM:sdfTol and IM:riskFun
</td>
</tr>
</table>
<table class=\"ddefn\">
Glass type factor </td> </tr>
$GTF$ </td> </tr>
Unitless </td> </tr>
AN is annealed glass.
FT is fully tempered glass.
HS is heat strengthened glass. </td> </tr>
astm2009 </td> </tr>
IM:calofCapacity and IM:dimlessLoad
</td>
</tr>
</table>
<table class=\"ddefn\">
Stand off distance </td> </tr>
$SD$ </td> </tr>
$m$ </td> </tr>
astm2009 </td> </tr>
DD:calofDemand
</td>
</tr>
</table>
<table class=\"ddefn\">
Aspect ratio </td> </tr>
$AR$ </td> </tr>
Unitless </td> </tr>
$a$ and $b$ are the dimensions of the plate, where ($a ≥ b$). </td> </tr>
astm2009 </td> </tr>
IM:tolLoad and IM:stressDistFac
</td>
</tr>
</table>
<table class=\"ddefn\">
Equivalent TNT charge mass </td> </tr>
$w_TNT$ </td> </tr>
$kg$ </td> </tr>
astm2009 </td> </tr>
DD:calofDemand
</td>
</tr>
</table>
<table class=\"ddefn\">
Applied load (demand) </td> </tr>
$q$ </td> </tr>
$Pa$ </td> </tr>
$q$, or applied load (demand), is the 3 second duration equivalent pressure obtained from Fig:demandVSsod by interpolation using stand off distance ($SD$) and $w_TNT$ as parameters. $w_TNT$ is defined in DD:eqTNTW. $SD$ is the stand off distance as defined in DD:standOffDist. </td> </tr>
astm2009 </td> </tr>
IM:isSafeLR and IM:dimlessLoad </td> </tr> </table>
Instance Models¶
This section transforms the problem defined in the problem description into one which is expressed in mathematical terms. It uses concrete symbols defined in the data definitions to replace the abstract symbols in the models identified in theoretical models and general definitions.
The goal GS:Predict-Glass-Withstands-Explosion is met by IM:isSafePb, IM:isSafeLR.
<table class=\"idefn\">
Risk of failure </td> </tr>
$E$, $LDF$, $J$, $k$, $m$, $h$, $a$, $b$ </td> </tr>
$B$ </td> </tr>
$a$ and $b$ are the dimensions of the plate, where ($a ≥ b$).
$h$ is defined in DD:minThick and is based on the nominal thicknesses.
$LDF$ is defined in DD:loadDurFactor.
$J$ is defined in IM:stressDistFac. </td> </tr>
astm2009 , beasonEtAl1998 (Eqs. 4-5), and campidelli (Eq. 14) </td> </tr>
IM:probOfBreak
</td>
</tr>
</table>
<table class=\"idefn\">
Stress distribution factor (Function) </td> </tr>
$AR$, $q̂$ </td> </tr>
$J$ </td> </tr>
$J$ is obtained by interpolating from data shown in Fig:dimlessloadVSaspect.
$AR$ is defined in DD:aspectRatio.
$q̂$ is defined in IM:dimlessLoad. </td> </tr>
astm2009 </td> </tr>
IM:riskFun
</td>
</tr>
</table>
<table class=\"idefn\">
Non-factored load </td> </tr>
$q̂_tol$, $E$, $h$, $a$, $b$ </td> </tr>
$NFL$ </td> </tr>
$q̂_tol$ is defined in IM:tolLoad.
$E$ comes from A:standardValues.
$h$ is defined in DD:minThick and is based on the nominal thicknesses.
$a$ and $b$ are the dimensions of the plate, where ($a ≥ b$). </td> </tr>
astm2009 </td> </tr>
IM:calofCapacity
</td>
</tr>
</table>
<table class=\"idefn\">
Dimensionless load </td> </tr>
$q$, $E$, $h$, $GTF$, $a$, $b$ </td> </tr>
$q̂$ </td> </tr>
$q$ is the 3 second duration equivalent pressure, as given in DD:calofDemand.
$a$ and $b$ are the dimensions of the plate, where ($a ≥ b$).
$E$ comes from A:standardValues.
$h$ is defined in DD:minThick and is based on the nominal thicknesses.
$GTF$ is defined in DD:gTF. </td> </tr>
astm2009 and campidelli (Eq. 7) </td> </tr>
IM:stressDistFac
</td>
</tr>
</table>
<table class=\"idefn\">
Tolerable load </td> </tr>
$AR$, $J_tol$ </td> </tr>
$q̂_tol$ </td> </tr>
$q̂_tol$ is obtained by interpolating from data shown in Fig:dimlessloadVSaspect.
$AR$ is defined in DD:aspectRatio.
$J_tol$ is defined in IM:sdfTol. </td> </tr>
astm2009 </td> </tr>
IM:nFL
</td>
</tr>
</table>
<table class=\"idefn\">
Tolerable stress distribution factor </td> </tr>
$LDF$, $P_btol$, $E$, $a$, $b$, $m$, $k$, $h$ </td> </tr>
$J_tol$ </td> </tr>
$P_btol$ is entered by the user.
$a$ and $b$ are the dimensions of the plate, where ($a ≥ b$).
$m$, $k$, and $E$ come from A:standardValues.
$h$ is defined in DD:minThick and is based on the nominal thicknesses.
$LDF$ is defined in DD:loadDurFactor. </td> </tr>
astm2009 </td> </tr>
IM:tolLoad
</td>
</tr>
</table>
<table class=\"idefn\">
Probability of breakage </td> </tr>
$B$ </td> </tr>
$P_b$ </td> </tr>
$B$ is defined in IM:riskFun. </td> </tr>
astm2009 and beasonEtAl1998 </td> </tr>
IM:isSafePb
</td>
</tr>
</table>
<table class=\"idefn\">
Load resistance </td> </tr>
$NFL$, $GTF$, $LSF$ </td> </tr>
$LR$ </td> </tr>
$LR$ is also called capacity.
$NFL$ is defined in IM:nFL.
$GTF$ is defined in DD:gTF. </td> </tr>
astm2009 </td> </tr>
IM:isSafeLR
</td>
</tr>
</table>
<table class=\"idefn\">
Safety Req-Pb </td> </tr>
$P_b$, $P_btol$ </td> </tr>
$isSafePb$ </td> </tr>
If $isSafePb$, the glass is considered safe. $isSafePb$ and $isSafeLR$ (from IM:isSafeLR) are either both True or both False.
$P_b$ is defined in IM:probOfBreak.
$P_btol$ is entered by the user. </td> </tr>
astm2009 </td> </tr>
IM:isSafeLR and FR:Check-Glass-Safety
</td>
</tr>
</table>
<table class=\"idefn\">
Safety Req-LR </td> </tr>
$LR$, $q$ </td> </tr>
$isSafeLR$ </td> </tr>
If $isSafeLR$, the glass is considered safe. $isSafePb$ (from IM:isSafePb) and $isSafeLR$ are either both True or both False.
$LR$ is defined in IM:calofCapacity and is also called capacity.
$q$ is the 3 second duration equivalent pressure, as given in DD:calofDemand. </td> </tr>
astm2009 </td> </tr>
IM:isSafePb and FR:Check-Glass-Safety </td> </tr> </table>
Data Constraints¶
The Data Constraints Table shows the data constraints on the input variables. The column for physical constraints gives the physical limitations on the range of values that can be taken by the variable. The uncertainty column provides an estimate of the confidence with which the physical quantities can be measured. This information would be part of the input if one were performing an uncertainty quantification exercise. The constraints are conservative to give the user of the model the flexibility to experiment with unusual situations. The column of typical values is intended to provide a feel for a common scenario. The auxiliary constants give the values of the specification parameters used in the Data Constraints Table.
| Var | Physical Constraints | Software Constraints | Typical Value | Uncert. |
|---|---|---|---|---|
| $a$ | $a > 0 ∧ a ≥ b$ | $d_min ≤ a ≤ d_max$ | $1.5$ $m$ | 10$%$ |
| $AR$ | $AR ≥ 1$ | $AR ≤ AR_max$ | $1.5$ | 10$%$ |
| $b$ | $0 < b ≤ a$ | $d_min ≤ b ≤ d_max$ | $1.2$ $m$ | 10$%$ |
| $P_btol$ | $0 ≤ P_btol ≤ 1$ | -- | $0.008$ | 0.1$%$ |
| $SD$ | $SD > 0$ | $SD_min ≤ SD ≤ SD_max$ | $45$ $m$ | 10$%$ |
| $TNT$ | $TNT > 0$ | -- | $1$ | 10$%$ |
| $w$ | $w > 0$ | $w_min ≤ w ≤ w_max$ | $42$ $kg$ | 10$%$ |
Properties of a Correct Solution¶
The Data Constraints Table shows the data constraints on the output variables. The column for physical constraints gives the physical limitations on the range of values that can be taken by the variable.
| Var | Physical Constraints |
|---|---|
| $P_b$ | $0 ≤ P_b ≤ 1$ |
| $J$ | $J_min ≤ J ≤ J_max$ |
Requirements¶
This section provides the functional requirements, the tasks and behaviours that the software is expected to complete, and the non-functional requirements, the qualities that the software is expected to exhibit.
Functional Requirements¶
This section provides the functional requirements, the tasks and behaviours that the software is expected to complete.
<div id=\"inputValues\"> Input-Values: Input the values from Tab:ReqInputs, which define the glass dimensions, type of glass, tolerable probability of failure, and the characteristics of the blast.
</div>
<div id=\"sysSetValsFollowingAssumps\"> System-Set-Values-Following-Assumptions: The system shall set the known values as described in the table for Required Assignments.
</div>
<div id=\"checkInputWithDataCons\"> Check-Input-with-Data_Constraints: The system shall check the entered input values to ensure that they do not exceed the data constraints. If any of the input values are out of bounds, an error message is displayed and the calculations stop.
</div>
<div id=\"outputValsAndKnownValues\"> Output-Values-and-Known-Values: Output the input values from FR:Input-Values and the known values from FR:System-Set-Values-Following-Assumptions.
</div>
<div id=\"checkGlassSafety\"> Check-Glass-Safety: If $isSafePb ∧ isSafeLR$ (from IM:isSafePb and IM:isSafeLR), output the message "For the given input parameters, the glass is considered safe." If the condition is false, then output the message "For the given input parameters, the glass is NOT considered safe."
</div>
<div id=\"outputValues\"> Output-Values: Output the values from the table for Required Outputs.
</div>
| Symbol | Description | Units |
|---|---|---|
| $a$ | Plate length (long dimension) | $m$ |
| $b$ | Plate width (short dimension) | $m$ |
| $g$ | Glass type | -- |
| $P_btol$ | Tolerable probability of breakage | -- |
| $SD_x$ | Stand off distance ($x$-component) | $m$ |
| $SD_y$ | Stand off distance ($y$-component) | $m$ |
| $SD_z$ | Stand off distance ($z$-component) | $m$ |
| $t$ | Nominal thickness t is in ${2.5,2.7,3.0,4.0,5.0,6.0,8.0,10.0,12.0,16.0,19.0,22.0}$ | $mm$ |
| $TNT$ | TNT equivalent factor | -- |
| $w$ | Charge weight | $kg$ |
| Symbol | Description | Source | Units |
|---|---|---|---|
| $AR$ | Aspect ratio | DD:aspectRatio | -- |
| $E$ | Modulus of elasticity of glass | A:standardValues | $Pa$ |
| $GTF$ | Glass type factor | DD:gTF | -- |
| $h$ | Minimum thickness | DD:minThick | $m$ |
| $k$ | Surface flaw parameter | A:standardValues | $\frac{m^12}{N^7}$ |
| $LDF$ | Load duration factor | DD:loadDurFactor | -- |
| $LSF$ | Load share factor | A:glassLite | -- |
| $m$ | Surface flaw parameter | A:standardValues | $\frac{m^12}{N^7}$ |
| $SD$ | Stand off distance | DD:standOffDist | $m$ |
| $t_d$ | Duration of load | A:standardValues | $s$ |
| Symbol | Description | Source | Units |
|---|---|---|---|
| $AR$ | Aspect ratio | DD:aspectRatio | -- |
| $B$ | Risk of failure | IM:riskFun | -- |
| $GTF$ | Glass type factor | DD:gTF | -- |
| $h$ | Minimum thickness | DD:minThick | $m$ |
| $isSafeLR$ | 3 second load equivalent resistance safety requirement | IM:isSafeLR | -- |
| $isSafePb$ | Probability of glass breakage safety requirement | IM:isSafePb | -- |
| $J$ | Stress distribution factor (Function) | IM:stressDistFac | -- |
| $J_tol$ | Tolerable stress distribution factor | IM:sdfTol | -- |
| $LR$ | Load resistance | IM:calofCapacity | $Pa$ |
| $NFL$ | Non-factored load | IM:nFL | $Pa$ |
| $P_b$ | Probability of breakage | IM:probOfBreak | -- |
| $q̂$ | Dimensionless load | IM:dimlessLoad | -- |
| $q̂_tol$ | Tolerable load | IM:tolLoad | -- |
Non-Functional Requirements¶
This section provides the non-functional requirements, the qualities that the software is expected to exhibit.
<div id=\"correct\"> Correctness: The outputs of the code have the properties of a correct solution.
</div>
<div id=\"verifiable\"> Verifiability: The code is tested with complete verification and validation plan.
</div>
<div id=\"understandable\"> Understandability: The code is modularized with complete module guide and module interface specification.
</div>
<div id=\"reusable\"> Reusability: The code is modularized.
</div>
<div id=\"maintainable\"> Maintainability: If a likely change is made to the finished software, it will take at most 10$%$ of the original development time, assuming the same development resources are available.
</div>
<div id=\"portable\"> Portablity: The code shall be portable to multiple environments, particularly Windows, Mac OSX, and Linux.
</div>
Likely Changes¶
This section lists the likely changes to be made to the software.
<div id=\"calcInternalBlastRisk\"> Calculate-Internal-Blast-Risk: A:explainScenario - The system currently only calculates for external blast risk. In the future, calculations can be added for the internal blast risk.
</div>
<div id=\"varValsOfmkE\"> Variable-Values-of-m,k,E: A:standardValues, A:ldfConstant - Currently, the values for $m$, $k$, and $E$ are assumed to be the same for all glass. In the future, these values can be changed to variable inputs.
</div>
<div id=\"accMoreThanSingleLite\"> Accomodate-More-than-Single-Lite: A:glassLite - The software may be changed to accommodate more than a single lite.
</div>
<div id=\"accMoreBoundaryConditions\"> Accomodate-More-Boundary-Conditions: A:boundaryConditions - The software may be changed to accommodate more boundary conditions than 4-sided support.
</div>
<div id=\"considerMoreThanFlexGlass\"> Consider-More-than-Flexure-Glass: A:responseType - The software may be changed to consider more than just flexure of the glass.
</div>
Unlikely Changes¶
This section lists the unlikely changes to be made to the software.
<div id=\"predictWithstandOfCertDeg\"> Predict-Withstanding-of-Certain-Degree: The goal of the system is to predict whether the glass slab under consideration can withstand an explosion of a certain degree.
</div>
<div id=\"accAlteredGlass\"> Accommodate-Altered-Glass: A:glassCondition requires that the glass is not altered in any way. Therefore, this cannot be used on altered glass.
</div>
Traceability Matrices and Graphs¶
The purpose of the traceability matrices is to provide easy references on what has to be additionally modified if a certain component is changed. Every time a component is changed, the items in the column of that component that are marked with an "X" should be modified as well. Tab:TraceMatAvsA shows the dependencies of the assumptions on each other. Tab:TraceMatAvsAll shows the dependencies of the data definitions, theoretical models, general definitions, instance models, requirements, likely changes, and unlikely changes on the assumptions. Tab:TraceMatRefvsRef shows the dependencies of the data definitions, theoretical models, general definitions, and instance models on each other. Tab:TraceMatAllvsR shows the dependencies of the requirements and goal statements on the data definitions, theoretical models, general definitions, and instance models.
The purpose of the traceability graphs is also to provide easy references on what has to be additionally modified if a certain component is changed. The arrows in the graphs represent dependencies. The component at the tail of an arrow is depended on by the component at the head of that arrow. Therefore, if a component is changed, the components that it points to should also be changed. Fig:TraceGraphAvsA shows the dependencies of assumptions on each other. Fig:TraceGraphAvsAll shows the dependencies of data definitions, theoretical models, general definitions, instance models, requirements, likely changes, and unlikely changes on the assumptions. Fig:TraceGraphRefvsRef shows the dependencies of data definitions, theoretical models, general definitions, and instance models on each other. Fig:TraceGraphAllvsR shows the dependencies of requirements and goal statements on the data definitions, theoretical models, general definitions, and instance models. Fig:TraceGraphAllvsAll shows the dependencies of dependencies of assumptions, models, definitions, requirements, goals, and changes with each other.
For convenience, the following graphs can be found at the links below:
- <a href=\"../../../../traceygraphs/glassbr/avsa.svg\">TraceGraphAvsA</a>
- <a href=\"../../../../traceygraphs/glassbr/avsall.svg\">TraceGraphAvsAll</a>
- <a href=\"../../../../traceygraphs/glassbr/refvsref.svg\">TraceGraphRefvsRef</a>
- <a href=\"../../../../traceygraphs/glassbr/allvsr.svg\">TraceGraphAllvsR</a>
- <a href=\"../../../../traceygraphs/glassbr/allvsall.svg\">TraceGraphAllvsAll</a>
Values of Auxiliary Constants¶
This section contains the standard values that are used for calculations in GlassBR.
| Symbol | Description | Value | Unit |
|---|---|---|---|
| $AR_max$ | maximum aspect ratio | $5$ | -- |
| $d_max$ | maximum value for one of the dimensions of the glass plate | $5$ | $m$ |
| $d_min$ | minimum value for one of the dimensions of the glass plate | $0.1$ | $m$ |
| $E$ | modulus of elasticity of glass | $71.7⋅10^9$ | $Pa$ |
| $J_max$ | maximum value for the stress distribution factor | $32$ | -- |
| $J_min$ | minimum value for the stress distribution factor | $1$ | -- |
| $k$ | surface flaw parameter | $28.6⋅10^-54$ | $\frac{m^12}{N^7}$ |
| $LSF$ | load share factor | $1$ | -- |
| $m$ | surface flaw parameter | $7$ | $\frac{m^12}{N^7}$ |
| $SD_max$ | maximum stand off distance permissible for input | $130$ | $m$ |
| $SD_min$ | minimum stand off distance permissible for input | $6$ | $m$ |
| $t_d$ | duration of load | $3$ | $s$ |
| $w_max$ | maximum permissible input charge weight | $910$ | $kg$ |
| $w_min$ | minimum permissible input charge weight | $4.5$ | $kg$ |
References¶
[1]: ASTM. Standard Practice for Determining Load Resistance of Glass in Buildings. Standard E1300-09a. ASTM International, 2009. https://www.astm.org. [2]: ASTM. Standard Specification for Heat-Strengthened and Fully Tempered Flat Glass. West Conshohocken, PA: ASTM International, 2012. https://doi.org/10.1520/C1048-12E01. [3]: ASTM. Standard specification for Flat Glass. West Conshohocken, PA: ASTM International, 2016. https://doi.org/10.1520/C1036-16. [4]: Beason, W. Lynn, Kohutek, Terry L., and Bracci, Joseph M. Basis for ASTME E 1300 Annealed Glass Thickness Selection Charts. ASCE Library. February, 1998. https://doi.org/10.1061/(ASCE)0733-9445(1998)124:2(215). [5]: Campidelli, Manuel. "Glass-BR Software for the design and risk assessment of glass facades subjected to blast loading." [6]: Koothoor, Nirmitha. A Document Driven Approach to Certifying Scientific Computing Software. McMaster University, Hamilton, ON, Canada: 2013. Print. [7]: Parnas, David L. and Clements, P. C. "A rational design process: How and why to fake it." IEEE Transactions on Software Engineering, vol. 12, no. 2, Washington, USA: February, 1986. pp. 251–257. Print. [8]: Smith, W. Spencer and Koothoor, Nirmitha. "A Document-Driven Method for Certifying Scientific Computing Software for Use in Nuclear Safety Analysis." Nuclear Engineering and Technology, vol. 48, no. 2, April, 2016. http://www.sciencedirect.com/science/article/pii/S1738573315002582. pp. 404–418. [9]: Smith, W. Spencer and Lai, Lei. "A new requirements template for scientific computing." Proceedings of the First International Workshop on Situational Requirements Engineering Processes - Methods, Techniques and Tools to Support Situation-Specific Requirements Engineering Processes, SREP'05. Edited by PJ Agerfalk, N. Kraiem, and J. Ralyte, Paris, France: 2005. pp. 107–121. In conjunction with 13th IEEE International Requirements Engineering Conference, [10]: Smith, W. Spencer, Lai, Lei, and Khedri, Ridha. "Requirements Analysis for Engineering Computation: A Systematic Approach for Improving Software Reliability." Reliable Computing, Special Issue on Reliable Engineering Computation, vol. 13, no. 1, February, 2007. https://doi.org/10.1007/s11155-006-9020-7. pp. 83–107.
Appendix¶
This appendix holds the graphs (Fig:demandVSsod and Fig:dimlessloadVSaspect) used for interpolating values needed in the models.
