Project Planning Defining the project Software specification Development stages Software testing

Defining the Project Input-Process-Output model Define the input Define the process Define the output Define the hardware Define the development tools

Defining the Project Input-Process-Output model Process File

Defining the Project Define the Input What information is needed to perform the software task? What information is fixed or assumed? What information does the user provide? What information is read from files?

Defining the Project Input Examples Subject information Stimulus parameters Spreadsheet data Image data Data acquired from recording hardware User’s choice of processing options User’s choice of output options

Defining the Project Input Methods Dialog boxes –radio buttons, checkboxes, pushbuttons, edit boxes, sliders, pull-down lists, menus Command line questions and answers Files Data acquisition cards Frame grabber cards

Defining the Project Input Worksheet ?

Defining the Project Define the Process What is the sequence of events? What are the computations? How must the data be rearranged? How must the units be scaled?

Defining the Project Process Examples Produce a stimulus and/or gather results Compute statistics on subject performance Filter or enhance an image Evaluate eye movement signals Evaluate neurological signals Simulate a model Fit data to a model

Defining the Project Process Methods Sequence of events –Menu driven –Dialog box selections –Data dependent Scripts or functions Matlab toolboxes MATVIS Psychophysics Toolbox

Defining the Project Process Worksheet ?

Defining the Project Define the Output Record of input information Record of data processing or collection Temporary feedback during data processing or collection

Defining the Project Output Examples Stimulus control Experiment results Simulation results Computational results

Defining the Project Output Methods Text files Binary files Image files Graphical plots Stimulus control signals Changes to the user interface

Defining the Project Output Worksheet ?

Software Specification Purpose Organization

Software Specification Purpose Documents your design decisions Organizes all input information Describes format of files Describes sequence of events

Software Specification Organization Introduction User interface Parameters Sequence of events Computations Graphic results File formats Reference information

Software Specification Organization: Introduction Describes purpose of software Gives overview of software Describes overview of hardware Describes development tools –MATLAB –Simulink –Psychophysics Toolbox –MATVIS

Software Specification Organization: User interface Organization of menus Organization of dialog boxes Arrangement of items on dialog boxes Options or preferences May be appropriate to incorporate these details in the other sections

Software Specification Organization: Parameters Describe parameters –purpose –units –default values –acceptable ranges Summarize parameters in a table for quick reference

Software Specification Organization: Sequence Describe the sequence of events as a numbered list Describe what happens when the user makes different selections Describe error handling

Software Specification Organization: Computations Describe computations as you would in the methods section of a paper Supply all necessary information to perform the computations For complex computations –reference descriptive documents –reference existing software

Software Specification Organization: Graphic Results Plots –Axes and scaling –Axes titles –Markers and lines Images –Data format (uint8, double, indexed) –Colormap –Meaning of intensity scale

Software Specification Organization: File Formats Describe the rows and columns of tab- delimited text files Select graphic file format for output Include both input and output file formats Describe any naming conventions Indicate if files are to be overwritten or appended

Software Specification Organization: Reference Info. Contact information for software tools Contact information for special hardware References to related manuals –hardware –software References to related publications –computations –experiment methods

Development Stages The Chronological Approach The Availability Approach The Feasibility Approach The Generic Approach The ‘They Did It This Way’ Approach

Development Stages The Chronological Approach Add each block of code in sequential order –First write code that receives all the inputs –Next write code that does first stage processing –Next add code that depends on first stage –Continue until all results are available –Produce results and record them to files

Development Stages The Availability Approach Some code depends on hardware. Write that code when new hardware arrives or when existing hardware is not otherwise scheduled for subjects. Some code depends on software. Order software tools early. Write user interface code or file formatting code at any time.

Development Stages The Feasibility Approach Sometimes it is not clear that a new experiment system or simulation will work. If it does not, then there is no purpose to adding a fancy user interface or producing output files. Start with the part that you are least confident will work. Once you prove that part works, the rest of the program development is worth the effort.

Development Stages The Generic Approach If you must wait on some aspect of software design, it can be beneficial to write routines that you expect to use over and over: –Writing or reading standard file types –Unit or file conversions (pc2mac.m) –Subject response or feedback methods –Standard stimuli (like gabor.m)

Development Stages “They Did It This Way” Research software can often be changed in minor ways to perform similar yet distinct experiments. Re-using code can save time. Be sure to UNDERSTAND the content and format of the parameters and results for existing code that you re-use.

Software Testing Verify units of measure Verify format of files Ask naïve users to try your user interface Measure brightness/size/timing of stimuli Perform calculations on known data sets