Instructions:

Preliminaries

1. Make sure that you're following the instructions above (in particular, you should be working with somebody new).
2. Create a new project using the Basic Console Application template and the project name SelectionAndIteration.
3. Create a file called SelectionAndIterationReport.txt, placing it in the docs subfolder of your SelectionAndIteration project.
4. Open your SelectionAndIterationReport.txt file. You will use it to record your answers to the questions in all of the parts of this exercise. Start the report with an appropriate title, your names, the date, and a heading to indicate the beginning of Part 1.
5. Skim this document. Then return to this point.
6. Question: About how many minutes do you think it will take you to complete Part 1 of SelectionAndIteration?
7. Question: What time is it now?

Creating the CVS Module

8. Create a new module for your SelectionAndIteration project, calling the module SelectionAndIteration, spelled just like that.
9. Add your report and the initial contents of your SelectionAndIteration project to your new CVS module.

Documenting the Project

10. Write JavaDoc comments based on the planned behavior of the project. Include all of the required tags. Ensure that you can generate the HTML documentation correctly.

Selection Statements

11. Unless otherwise specified, use JOptionPane for all required input and output (I/O) in this project (you are free to use whatever method you prefer for other I/O)..
12. Add an introductory message.
13. Ensure that the program exits gracefully when it finishes.
14. Input the coefficients of a quadratic equation ax^2 + bx + c = 0 from the user.
15. Calculate the discriminant D = b^2 - 4ac.
16. Use the disriminant to calculate both roots of the quadratic equation [root1 = (-b + sqrt(D)) / 2a, and root2 = (-b - sqrt(D)) / 2a].
17. Test your program on these cases:
    • a = 1, b = -4 , c = 3
    • a = 1, b = -4 , c = 4
    • a = 1, b = -4 , c = 8
18. Question: Explain what happens in the last case and why.
19. Comment out the code that calculates the roots.
20. Write an if statement that displays the message The roots are complex conjugates when the discriminant is negative. The syntax for an if statement is:

          if( condition 1 ) {
             statement block 1
          }

21. Question: Explain why it is important to include the curly braces, even though they are optional when there is only one statement in the body of the if statement.
22. Add an else part to your if statement that displays the message The root(s) are real when the discriminant is non-negative. The syntax for an if-then-else statement is:

          if( condition 1 ) {
             statement block 1
          } else {
    
             statement block 2
    
          }

23. Question: Explain why it is important to add an else part in this case as opposed to a second if statement.
24. Modify the else part so that it displays There is a single repeated root when the discriminant is zero, and There are two distinct real roots when the discriminant is positive.
25. Question: You should now have a "cascaded if statement." Explain why it should be indented like this:

          if( condition 1 ) {
             statement block 1
          } else if( condition 2 )
             statement block 2
          } else {
             statement block 3
          }

26. Display the root(s) in each of the three cases. Note: in the complex case, the real part is -b / 2a, and the imaginary part is +/- sqrt(-D)/2a.

Submitting the Project

27. Make any final changes that you want to your project.
28. Generate the HTML documentation for your project.
29. Commit your changes to your CVS module (be sure to include your source file, your report, and your HTML documentation).
30. Tag your CVS module SelectionAndIteration1.

Summary

31. Question: Describe the role of if statements.
32. Question: How much time did you spend on Part 1 of SelectionAndIteration? Compare your answer to how much time you had estimated that you would spend. You receive full credit no matter how far off your estimate is!