Description of ensemble_init_data

DESCRIPTION

 Initializes a data structure used by many of the Ensemble analysis functions.

 data_st = ensemble_init_data_struct;

 Fields are:
    .type - This is a string that identifies the data structure
    .vars - A cell array of strings that identifies each of the elements of
            the data cell array. This variable is used for indexing into the
            data array and also by ensemble_filter().
    .data - A cell array containing either data structures or data
    .report - A structure that contains information pertaining to reporting
            tables and figures related to this type of data
            structure. Analysis functions that have reporting sub-functions
            should register function handles within this structure.
    .meta - Structure for holding metadata pertaining to this type of data
            structure.  This might include the parameter structure that was
            passed to the function that generated this structure, or a
            question information structure, etc.


 Copyright (c) 2007-2012 The Regents of the University of California
 All Rights Reserved

 02/03/07 Petr Janata

CROSS-REFERENCE INFORMATION

check_completion_v2 provides details on subjects who have started and who have completed a given experiment

ensemble_concat_datastruct Concatenates a cell array of structs into a single struct.

ensemble_csv2datastruct Loads a CSV file into an Ensemble data structure

ensemble_data_by_question Filters/reshapes a struct such that compqids are now fields within the return struct.

ensemble_data_struct_corr Calculates correlations between variables that are contained in the

ensemble_enum_stats Calculates statistics on responses to enum questions.

ensemble_export_cefa outputs given dataset in a CEFA-friendly format, for factor analysis

ensemble_export_respnstim tabulates subject-level and stimulus-based response-level data, exports one row per stim

ensemble_extract_nd_matrix an_st = ensemble_extract_nd_matrix(data_st,params);

ensemble_form_table Prints responses to questions on a form out in tabular format

ensemble_get_stiminfo Obtains stimulus and attribute meta data for stim IDs in the response table.

ensemble_get_student_id returns unique student id/subject id combinations found in response data

ensemble_load_expinfo returns the response table and metadata associated with an experiment

ensemble_merge_data Merges data from multiple structs into one struct.

ensemble_parse_present parses presentation files, saves to appropriate place on disk

ensemble_pathdata returns an ensemble pathdata struct, given defs.paths and defs.sinfo

ensemble_report_subject_meta Summarizes subject information, e.g. age, gender

ensemble_report_written Displays written responses associated text or varchar fields.

ensemble_reshape_data Reshapes a data struct by making new variables out of the unique levels

ensemble_response_times Analyzes response time values stored in the response_text field of a

ensemble_session_trial_info Extracts the trial and session IDs in order, for each given session.

ensemble_session_trial_info_v2 sessData = ensemble_session_trial_info_without_trial_id(indata,params)

ensemble_session_trial_info_without_trial_id sessData = ensemble_session_trial_info_without_trial_id(indata,params)

ensemble_summary_subject_stats

ensemble_table2datastruct Converts a MATLAB table variable into an Ensemble datastruct

ensemble_tree2datastruct Converts a generic data structure to conform to the ensemble data structure

is_ensemble_datastruct Tests a variable to see if it conforms to the ensemble data struct

mysql_check_attribute_x_attribute Checks to see whether a mapping exists in the attribute_x_attribute table

mysql_check_stimulus_x_attribute Checks to see whether an attribute exists in the attribute table and

mysql_get_sessinfo Returns session information for given sessions.

mysql_get_subinfo Returns subject info for given subjects

stim_ids_from_resp_tbl returns all unique stimulus ids from a given response table(s)

SOURCE CODE

0001 function data_st = ensemble_init_data_struct
0002 % Initializes a data structure used by many of the Ensemble analysis functions.
0003 %
0004 % data_st = ensemble_init_data_struct;
0005 %
0006 % Fields are:
0007 %    .type - This is a string that identifies the data structure
0008 %    .vars - A cell array of strings that identifies each of the elements of
0009 %            the data cell array. This variable is used for indexing into the
0010 %            data array and also by ensemble_filter().
0011 %    .data - A cell array containing either data structures or data
0012 %    .report - A structure that contains information pertaining to reporting
0013 %            tables and figures related to this type of data
0014 %            structure. Analysis functions that have reporting sub-functions
0015 %            should register function handles within this structure.
0016 %    .meta - Structure for holding metadata pertaining to this type of data
0017 %            structure.  This might include the parameter structure that was
0018 %            passed to the function that generated this structure, or a
0019 %            question information structure, etc.
0020 %
0021 %
0022 % Copyright (c) 2007-2012 The Regents of the University of California
0023 % All Rights Reserved
0024 %
0025 % 02/03/07 Petr Janata
0026 
0027 data_st.name = '';
0028 data_st.type = '';
0029 data_st.vars = {};
0030 data_st.data = {};
0031 data_st.report = struct();
0032 data_st.meta = struct();;
0033

ensemble_init_data_struct

PURPOSE

SYNOPSIS

DESCRIPTION

CROSS-REFERENCE INFORMATION

SOURCE CODE