MIS30110
Academic Year 2017/2018
Project Speci cation
October 2017
1 Description
Design a computer program, written in Python 3, that reads a data matrix from
a csv le, speci ed by the user, and outputs a costumised statistical report for
the data contained in the le.
2 Requirements
The program must:
Read csv les (with comma as data eld separator):
{ Should work at least with the \Wine" (wine.data) and \Poker Hand"
(poker-hand-training-true.data) datasets, available from the UCI Ma-
chine Learning Repository:
http://archive.ics.uci.edu/ml/
Report number of rows and columns;
Calculate mean, median and mode of any data column (if possible);
Be user-friendly, easy to use, verbose;
Use proper algorithm design;
Employ sensible naming of variables, functions, modules, etc;
Employ extensive (but clear) use of comments;
If required, only the math, sys and os standard packages can be used
(i.e. no Pandas, Numpy, etc).
Provide a pleasant interface.
2.1 Extra Functionality
In order to increase the quality of your project, and thus its nal grade, one
or more of the following functionalities should be attempted. This list is not
de nite, and any extra features (not listed here) that will add value to the
program will improve the nal evaluation of your work.
The program can also:
Be robust (should not crash with unexpected input data):
{ type detection;
{ empty value cell detection;
{ wrong lename;
{ . . .
Allow other csv separation characters (e.g. space, tab, etc) to be used:
{ These can be manually set by the user;
{ Or potentially automatically detected.
Allow titles as rst line of data le;
Provide other statistical measures:
{ Range;
{ Min and Max values;
{ Quartiles;
{ Linear Regression;
{ . . .
Provide a choice of which statistical measures to include in the report le;
Parameterise the analysis through a con guration le;
Calculate statistical measures for rows (instead of columns);
Allow choice of input data le name;
Allow choice of output report le name;
Provide visualisation of resulting statistics on screen;
Use a code structure with more than one python le (i.e. using modules).
3 Deliverables
The following deliverables are required:
A PDF report, comprised of:
{ An appropriate cover page;
{ A statement outlining the contribution of each group member;
{ A user-manual for your program (between 1 and 3 pages);
{ An upper level UML Activity Diagram, describing the main func-
tionality and ow control of the program.
Code submission.
Both deliverables will be submitted through Blackboard.
4 Practicalities
This is a group assignment, for groups of three students;
The PDF Report must state the name and ID number of all students on
the rst page (the cover page), and the title of the project;
Plagiarism, including accidental plagiarism, may result in penalties in-
cluding grade penalties, failure of the module, and disciplinary action:
http:
//www.ucd.ie/registry/academicsecretariat/plagiarism.htm
5 Submission Deadline
Deadline for submission is Friday 24th November 2017 at 5:00pm.
Both your PDF and your source code les must be submitted through
Blackboard by the deadline.
You are free to discuss your assignment with other students, but not to
look at any other group’s work, or show your work to any student out-
side your group. If you use quotes or paraphrases, images, or ideas from
outside sources, you must give a citation. Plagiarism, including accidental
plagiarism, may result in penalties including grade penalties, failure of the
module, and disciplinary action.
Please be advised that your online submission will be done using Safe-
Assign (an automatic plagiarism detector). More information can be found
on the last page of UCD’s Guidelines for Coursework:
https://www.ucd.ie/t4cms/Scholarly%20Conventions.pdf
6 Evaluation
The projects will be evaluated in week 12. Evaluation will consist of a short 10
minute interview with all group members, to demonstrate the nal software, and
discuss and justify the design and programming choices made. Each student will
be asked questions in turn, concerning both the functionality of the program,
and the Python source code.