Homework 6: Stats Templates

Educational Objectives: After completing this assignment the student should have the following knowledge, ability, and skills:

Distinguish between a function template and a concrete function: definition, implementation, and file structure conventions
Demonstrate correct notation and syntax for defining and implementing a function template
State the rules compilers use to instantiate a function template
Test a function template for correct syntax
Test a function template for correct behavior
Test a function template for genericity

Operational Objectives: Implement and test the function templates Mean, Median, and InsertionSort.

Deliverables: Two files: stats.t and log.txt

Assessment Rubric

================================================
item/category                       points range
-------------                       ------------
build stattest1.x - stattest19.x           0..10
stattest[1-19].x data1                     0..05
stattest[1-19].x data2                     0..05
stattest[1-19].x data3                     0..05
stattest[1-19].x data4                     0..05
student log                                0..05
templates usage                            0..05
code quality                             -50..10
dated submissions deduction [2 pts per]     ( 0)
------------------------------------------------
total                                      0..50

Note: input files may vary over time and from those distributed.

Code quality includes: 
  - conformance to assignment requirements and specifications
  - conformance to coding standards [see course organizer]
  - engineering and design, including appropriateness of name choices
  - readability
=====================================================================

Background: See lecture notes Chapter 12. Templates.

Procedural Requirements

Copy the following files from the course library:

hw6/stattest.cpp     # client program testing Stats Templates
hw6/makefile         # builds stattest1.x, ... , stattest19.x
hw6/deliverables.sh  # assignment specs
scripts/submit.sh    # submission script

Begin a log file named log.txt. This should be an ascii text file in cop3330/hw6 with the following header:
```
log.txt # log file for stats project
<date file created>
<your name>
<your CS username>
```
This file should document all work done by date and time, including all testing and test results.
Create the file stats.t defining and implementing function templates for Mean, Median, and InsertionSort. Be sure to make log entries for all work.
READ the test program LIB/stattest.cpp. Note that stattest.cpp is set up so that you can choose any one of 19 different numerical types by uncommenting one of 19 possible typedef statements defining NumberType. Start your testing by creating 19 different tests stattest1.cpp, ... , stattest19.cpp, where stattestX.cpp uses the number type X.

This is a good exercise in using basic unix commands and Emacs. Do this work yourself, on linprog. Be sure to keep your log up to date.
READ the supplied LIB/makefile. Note that makefile is set up so that you can
1. Build any specific stattestX.x target [X = 1,2,...,19]
2. Build all stattest1.x ... stattest19.x targets
3. Erase output data files created by runtests.sh
Test your implementation using the supplied client program stattest.cpp. There should be 19 versions of stattest.cpp, one for each numerical type listed in the program header documentation, named as in the distributed makefile. Again be sure to make log entries appropriately.
Turn in the files stats.t and log.txt. using the submit script.

Warning: Submit scripts do not work on the program and linprog servers. Use shell.cs.fsu.edu to submit projects. If you do not receive two confirmations, the second with the contents of your project, there has been a malfunction.

Code Requirements and Specifications

In file stats.t define and implement function templates with these prototypes:

template < typename T >
long double Mean (const std::vector<T>& v);  // returns mean of elements of v

template < typename T >
long double Median (std::vector<T>& v);  // returns median of elements of v

template < typename T >
void InsertionSort (std::vector<T>& v);  // implements insertion_sort algorithm

The behavior and semantics are similar to the non-template functions from Homework 2, using vector instead of array to contain data.

Be sure your code conforms to the standards in C++ Style (available also through the Course Organizer).
Be sure that you have tested your code for syntax errors with the supplied test harness as well as your own test program, using the supplied makefile with warning flags set. All warnings should be eliminated.
Be sure that you have tested your code for both logic errors with the supplied test harness as well as your own test program.
Be sure that you have tested your code for genericity using all 19 numerical types signed char, short, int, long, unsigned char, unsigned short, unsigned int, unsigned long, float, double, and long double.

Hints

The behavior required is essentially the same as that from homework 2 "Stats". Sample executables may be found in LIB/area51.
Copy LIB/hw6/runtests.sh. Read and understand it. Change permissions to 700. Create data files data1, data2, data3, data4. Execute runtests.sh. Be sure your data files are varied, so that int and float types get exercised with both even and odd sizes. If you get no errors and no differences to screen, you are in good shape.