Skip to content

Reports

Mark Torrance edited this page Aug 17, 2019 · 3 revisions

Reports provide access to pen data - typically marked up pen-data - in a form that makes them available for further analysis. After marking up your data you will want, for example, measures of the fluency with which each of your marked up segments (sentences, words, letters...) has been produced.

Various reports can be generated from within the MarkWrite GUI (file > export). These can also be created for batches of files - either raw pen data (e.g., GetWrite generated HDF5 files) or, typically, data that has already been marked up in markwrite (.mwp files). This requires straightforward editing of \examples\batchreportgen.py and then running from Run_BatchReport.bat.

Custom Reports

Creating new custom reports is achieved by adding a new ReportExporter subclass to \MarkWrite\customreports.py, following the examples already there. This will require some understanding of Python and Numpy, and of the MarkWrite pendata object.

The following custom reports are included with the MarkWrite distribution and are available via the export menu.

  • Detailed Segment Report This gives a range of measures for data that have been marked up within MarkWrite (with one row per segment).
  • Sample Velocity and Curvature Stroke Parser Report. This provides by-sample information about velocity and acceleration. This can then be processed externally to provide measures of production fluency for each segment (word, letter, letter-component) that the user has identified in their data. R scripts exist for this post-processing which we plan to make available at some point. Note that this report uses stroke and curvature settings set by the user from within MarkWrite. This is the case even if the report is run for batches of files without opening the MarkWrite GUI.