================================================================================
================================================================================

Title:      Audio Cartography - Rendered Maps 
Copyright:  2017 University of Oregon
Author:     M. Brittell
License:    Creative Commons Attribution-Share Alike 2.0 Generic (CC-BY-SA 2.0)

This work was funded in part by the National Science Foundation (NSF) Doctoral 
Dissertation Research Improvement (DDRI) Grant #1634086 and the University of 
Oregon (UO) Lewis Family Endowment.

================================================================================
================================================================================

Eighteen data sets take four forms to support exploration of the representation 
of geospatial data in an auditory display: audio, matrix, tabular, and visual.  
An accompanying README file (this file) provides an overview of the rendered 
maps.

A numeric identifier associates the rendered files with the underlying data 
sets.  The identifier is used consistently across the various forms (audio, 
matrix, tabular, visual). For example, data set #1 is represented in:

	audio/track01.wav 
	matrix/data01.txt
	tabular/table01.csv 
	visual/graphic01.pdf 

The underlying data were systematically generated and rendered by the scripts 
provided in the accompanying "audioCartography-prepare".  The audio maps were 
presented for evaluation using the test instrument provided in the accompanying 
"audioCartography-present".

--------------------------------------------------------------------------------
README (This file)
--------------------------------------------------------------------------------
File: audioCartography-maps-README.txt

An overview of the contents of this part of the collection.

--------------------------------------------------------------------------------
Stats
--------------------------------------------------------------------------------
Files: audioCartography-maps.tsv
       audioCartography-maps.json

Metrics that describe characteristics of the data sets.  The descriptive metrics
are organized in a tab separated values (.tsv) file, and the columns contained 
in that file are described in the accompanying Brain Imaging Data Structure 
(BIDS)-style JSON (.json) sidecar file (Gorgolewski et al. 2016).

--------------------------------------------------------------------------------
Audio
--------------------------------------------------------------------------------
Folder: audioCartography-maps-audio

Each data set is represented in an audio file (.wav) in one of the three audio 
map types: sequential, augmented-sequential, and concurrent.  Each audio file is 
accompanied by a metadata file (.xml).

--------------------------------------------------------------------------------
Matrix
--------------------------------------------------------------------------------
Folder: audioCartography-maps-matrix

Each matrix file (.txt) contains a two dimensional array of values.  A data 
value in the matrix corresponds to a grid cell in the two dimensional raster 
based on the location (row and column) within the matrix and the values 
represent classed data (level: 0,1,2).  The matrix format supports rendering of 
the sequential and augmented-sequential map types.  

--------------------------------------------------------------------------------
Tabular
--------------------------------------------------------------------------------
Folder: audioCartography-maps-tabular

The note table (.csv) is a list of parameter changes that produce an audio 
rendering of the data in which the display of multiple raster grid cells may 
overlap in time.  The tabular format supports rendering of the concurrent map 
type.  

--------------------------------------------------------------------------------
Visual
--------------------------------------------------------------------------------
Folder: audioCartography-maps-visual

Graphics (.pdf) provide a visual analogue to the auditory maps in a vector 
graphic format.   

================================================================================
================================================================================

REFERENCES

Gorgolewski, K.J., T. Auer, V.D. Calhoun, R.C. Craddock, S. Das, E.P. Duff, G.
	Flandin, S.S. Ghosh, T. Glatard, Y.O. Halchenko, D.A. Handwerker, M. Hanke, 
	D. Keator, X. Li, Z. Michael, C. Maumet, B.N. Nichols, T.E. Nichols, J. 
	Pellman, J.-B. Poline, A. Rokem, G. Schaefer, V. Sochat, W. Triplett, J.A. 
	Turner, G. Varoquaux, and R.A. Poldrack. (June 2016) The brain imaging data 
	structure, a format for organizing and describing outputs of neuroimaging 
	experiments. Scientific Data, 3. Web site: http://bids.neuroimaging.io/

================================================================================
================================================================================
