Software Requirements Analysis and Specification Requirements 1 Background

Software Requirements Analysis and Specification Requirements 1

Background n n n Problem of scale is a key issue for SE For small scale, understand specifying requirements is easy For large problem - very hard; probably the hardest, most problematic and error prone Input : user needs in minds of people Output : precise statement of what the future system will do Requirements 2

Background. . n n n Identifying and specifying req necessarily involves people interaction Cannot be automated Requirement (IEEE)= A condition or capability that must be possessed by a system Req. phase ends with a software requirements specification (SRS) document SRS specifies what the proposed system should do Requirements 3

Background. . n Requirements understanding is hard n n n Visualizing a future system is difficult Capability of the future system not clear, hence needs not clear Requirements change with time … Essential to do a proper analysis and specification of requirements Requirements 4

Need for SRS n SRS establishes basis of agreement between the user and the supplier. n n n Users needs have to be satisfied, but user may not understand software Developers will develop the system, but may not know about problem domain SRS is the medium to bridge the commn. gap and specify user needs in a manner both can understand Requirements 5

Need for SRS… n Helps user understand his needs. n n n users do not always know their needs must analyze and understand the potential the goal is not just to automate a manual system, but also to add value through IT The req process helps clarify needs SRS provides a reference for validation of the final product n n Clear understanding about what is expected. Validation - “ SW satisfies the SRS “ Requirements 6

Need for SRS… n High quality SRS essential for high Quality SW n n n Requirement errors get manifested in final sw to satisfy the quality objective, must begin with high quality SRS Requirements defects are not few Requirements 7

Need for SRS… n Good SRS reduces the development cost n n n SRS errors are expensive to fix later Req. changes can cost a lot (up to 40%) Good SRS can minimize changes and errors Substantial savings; extra effort spent during req. saves multiple times that effort An Example n Cost of fixing errors in req. , design , coding , acceptance testing and operation are 2 , 5 , 15 , 50 , 150 person-hours Requirements 8

Need for SRS… n An Example Requirements 9

Need for SRS… n Example … n n After req. phase 65% req errs detected in design , 2% in coding, 30% in Acceptance testing, 3% during operation If 50 requirement errors are not removed in the req. phase, the total cost 32. 5 *5 + 1*15 + 15*50 + 1. 5*150 = 1152 hrs If 100 person-hours invested additionally in req to catch these 50 defects , then development cost could be reduced by 1152 person-hours. Net reduction in cost is 1052 person-hours Requirements 10

Requirements Process n n n Sequence of steps that need to be performed to convert user needs into SRS Process has to elicit needs and requirements and clearly specifies it Basic activities n n problem or requirement analysis requirement specification validation Analysis involves elicitation and is the hardest Requirements 11

Requirements Process. . needs Analysis Specification Validation Requirements 12

Requirement process. . n n Process is not linear, it is iterative and parallel Overlap between phases - some parts may be analyzed and specified Specification itself may help analysis Validation can show gaps that can lead to further analysis and spec Requirements 13

Requirements Process… n n Focus of analysis is on understanding the desired systems and it’s requirements Divide and conquer is the basic strategy n n Large volumes of information is generated n n decompose into small parts, understand each part and relation between parts organizing them is a key Techniques like data flow diagrams, object diagrams etc. used in the analysis Requirements 14

Requirements Process. . n Transition from analysis to specs is hard n n n during analysis, structure and domain are understood analysis structures helps in specification, but the transition is not final in specs, external behavior specified methods of analysis are similar to that of design, but objective and scope different analysis deals with the problem domain, whereas design deals with solution domain Requirements 15

Problem Analysis n n Aim: to gain an understanding of the needs, requirements, and constraints on the software Analysis involves n n n interviewing client and users reading manuals studying current systems helping client/users understand new possibilities Like becoming a consultant Must understand the working of the organization , client and users Requirements 16

Problem Analysis… n Some issues n n n Obtaining the necessary information Brainstorming: interacting with clients to establish desired properties Information organization, as large amount of info. gets collected Ensuring completeness Ensuring consistency Avoiding internal design Requirements 17

Problem Analysis… n n n Communication skills are very important Basic principle: problem partition Partition w. r. t what? n n n Object - OO analysis Function - structural analysis Events in the system – event partitioning Projection - get different views Will discuss few different analysis techniques Requirements 18

Characteristics of an SRS n What should be the characteristics of a good SRS? Some key ones are n n n Complete Unambiguous Consistent Verifiable Ranked for importance and/or stability Requirements 19

Characteristics… n Correctness n n Completeness n n Each requirement accurately represents some desired feature in the final system All desired features/characteristics specified Hardest to satisfy Completeness and correctness strongly related Unambiguous n n n Each req has exactly one meaning Without this, errors will creep in Important as natural languages often used Requirements 20

Characteristics… n Verifiability n n Consistent n n There must exist a cost effective way of checking if sw satisfies requirements two requirements don’t contradict each other Ranked for importance/stability n n Needed for prioritizing in construction To reduce risks due to changing requirements Requirements 21

Components of an SRS n What should an SRS contain ? n n Clarifying this will help ensure completeness An SRS must specify requirements on n n Functionality Performance Design constraints External interfaces Requirements 22

Functional Requirements n Heart of the SRS document; this forms the bulk of the specs Specifies all the functionality that the system should support Outputs for the given inputs and the relationship between them All operations the system is to do n Must specify behavior for invalid inputs too n n n Requirements 23

Performance Requirements n n All the performance constraints on the software system Generally on response time , throughput etc Capacity requirements Must be in measurable terms (verifiability) n Eg resp time should be xx 90% of the time Requirements 24

Design Constraints n n Factors in the client environment that restrict the choices Some such restrictions n n Standard compliance and compatibility with other systems Hardware Limitations Reliability, fault tolerance, backup req. Security Requirements 25

External Interface n n All interactions of the software with people, hardware, and sw User interface most important General requirements of “friendliness” should be avoided These should also be verifiable Requirements 26

Specification Language n n Language should support desired char of the SRS Formal languages are precise and unambiguous but hard Natural languages mostly used, with some structure for the document Formal languages used for special features or in highly critical systems Requirements 27

Structure of an SRS n Introduction n n Purpose , the basic objective of the system Scope of what the system is to do , not to do Overview Overall description n n Product perspective Product functions User characteristics Assumptions Constraints Requirements 28

Structure of an SRS… n Specific requirements n n n External interfaces Functional requirements Performance requirements Design constraints This standardization of the SRS was done by IEEE. Requirements 29

Other Approaches to Analysis Requirements 30

Data Flow Modeling n n Widely used; focuses on functions performed in the system Views a system as a network of data transforms through which the data flows Uses data flow diagrams (DFDs) and functional decomposition in modeling The SSAD methodology uses DFD to organize information, and guide analysis Requirements 31

Data flow diagrams n A DFD shows flow of data through the system n n Views system as transforming inputs to outputs Transformation done through transforms DFD captures how transformation occurs from input to output as data moves through the transforms Not limited to software Requirements 32

Data flow diagrams… n DFD n n n Transforms represented by named circles/bubbles Bubbles connected by arrows on which named data travels A rectangle represents a source or sink and is originator/consumer of data (often outside the system) Requirements 33

DFD Example Requirements 34

DFD Example Requirements 35

DFD Example Requirements 36

DFD Example Requirements 37

DFD Conventions n n n External files shown as labeled straight lines Need for multiple data flows by a process represented by * (means and) OR relationship represented by | All processes and arrows should be named Processes should represent transforms, arrows should represent some data Requirements 38

Data flow diagrams… n n n Focus on what transforms happen , how they are done is not important Usually major inputs/outputs shown, minor are ignored in this modeling No loops , conditional thinking , … DFD is NOT a control chart, no algorithmic design/thinking Sink/Source , external files Requirements 39

Drawing a DFD for a system n n Identify inputs, outputs, sources, sinks for the system Work your way consistently from inputs to outputs, and identify a few high-level transforms to capture full transformation If get stuck, reverse direction When high-level transforms defined, then refine each transform with more detailed transformations Requirements 40

Drawing a DFD for a system. . n n Never show control logic; if thinking in terms of loops/decisions, stop & restart Label each arrows and bubbles; carefully identify inputs and outputs of each transform Make use of + & * Try drawing alternate DFDs Requirements 41

Leveled DFDs n n n DFD of a system may be very large Can organize it hierarchically Start with a top level DFD with a few bubbles then draw DFD for each bubble Preserve I/O when “ exploding” a bubble so consistency preserved Makes drawing the leveled DFD a top-down refinement process, and allows modeling of large and complex systems Requirements 42

Data Dictionary n n In a DFD arrows are labeled with data items Data dictionary defines data flows in a DFD Shows structure of data; structure becomes more visible when exploding Can use regular expressions to express the structure of data Requirements 43

Data Dictionary Example n For the timesheet DFD Weekly_timesheet – employee_name + id + [regular_hrs + overtime_hrs]* Pay_rate = [hourly | daily | weekly] + dollar_amt Employee_name = last + first + middle Id = digit + digit Requirements 44

DFD drawing – common errors n n n n Unlabeled data flows Missing data flows Extraneous data flows Consistency not maintained during refinement Missing processes Too detailed or too abstract Contains some control information Requirements 45

Prototyping n n Prototyping is another approach for problem analysis Discussed it earlier with process – leads to prototyping process model Requirements 46

Requirements Validation n n Lot of room for misunderstanding Errors possible Expensive to fix req defects later Must try to remove most errors in SRS Most common errors n n Omission Inconsistency Incorrect fact Ambiguity - 30% 10 -30% 5 -20% Requirements 47

Requirements Review n n n SRS reviewed by a group of people Group: author, client, user, dev team rep. Must include client and a user Process – standard inspection process Effectiveness - can catch 40 -80% of req. errors Requirements 48

Summary n n Having a good quality SRS is essential for Q&P The req. phase has 3 major sub phases n n Analysis n n n analysis , specification and validation for problem understanding and modeling Methods used: SSAD, OOA , Prototyping Key properties of an SRS: correctness, completeness, consistency, unambiguousness Requirements 49

Summary. . n Specification n n must contain functionality , performance , interfaces and design constraints Mostly natural languages used Use Cases is a method to specify the functionality; also useful for analysis Validation - through reviews Requirements 50