MATLAB Python

showMeTheData

Syntax

varargout = showMeTheData([include] [,select] [,operation] [,parameters] [,'alphabetical'] [,'silent'] [,purge_empty_dirs]) [] = optional parameters '' = parameter-value pairs

Description

SHOWMETHEDATA is intended as a quick command-line interface for browsing, inspecting, and coding your participant data library. Call showMeTheData to get started, or review the below.

Usage

Simply call "showMeTheData()" and follow the instructions that are printed to the console. It is intended to be used interactively, such that you add parameters as you go and as it guides you to the specific file or output you are looking for without having to poke around on your filesystem. The first call to showMeTheData, without parameters, will print out a numbered list of all participants in your database. showMeTheData(include) produces a list of all available data for a particular participant. Include is either the name of the participant, part of their name, a cell array of names, a number from the list, or an array of numbers from the list (note that the number for the participant will shift as data are added or removed). showMeTheData(include, select): if and only if include identifies exactly one participant, select identifies a specific datastruct available from the participant named by include. As above, the datastruct can be selected from the numbered list, or named in part or in full. varargout = showMeTheData(include, select, operation) tells showMeTheData to perform a certain operation on the data. You can choose among the strings: 'plot' (run easyPlot on the datastruct); 'trials' (prints a list of trial data to the console); 'score' (runs easyScore on the datastruct and returns the scored result); 'code' (runs easyCode on the datastruct); or 'load' (runs getDatastruct to return your datastruct as the first argument). 'trials' is selected by default. Provide your operation as a string. varargout = showMeTheData(include, select, operation, parameters) allows you to supply parameter-value pairs to the operation that you specified. Provide these as a cell array. For example, if you wanted to call "easyPlot" on a particular trial and save the result, you could specify: showMeTheData('my_ppt',1,'plot',{'trials',1,'save',true}) ...or you could run easyCode, supplying a set of rating scales: showMeTheData('my_ppt',1,'code',{'scale',myscale,'title','ascale'}) varargout = showMeTheData(include, ..., 'options', 'parameter', value) sets a variety of optional parameters using parameter-value pairs. All parameters that appear after the term 'options' are considered pairs. For example, to use alphabetical order, you might call: showMeThedata('options','alpha',true), or showMeTheData(1,'options','alpha',true) 'silent' Boolean. When set to true, this parameter indicates that the varargout output should not be displayed to the console. Default: false. 'alphabetical' Boolean. When set to true, participants and datastructs are listed alphabetically. Otherwise, participants and datastructs are listed in order from oldest to newest. Default: false. 'purge_empty_dirs' Boolean. While scanning files, delete folders that contain no data. Default: false.

Output

varargout: The contents of this variable will be altered depending on the operations you have requested.