perClass Documentation
version 5.0 (21-sep-2016)

Chapter 1: Introduction

Table of contents

1.1. This manual ↩

This manual assumes basic knowledge of pattern recognition and Matlab environment. In order to embed trained classifiers into custom applications, basic familiarity with C language is also assumed.

The manual is structured in four parts:

1.2. Introduction to perClass ↩

perClass is a software package that provides quick development of custom machine learning solutions. With perClass, R&D specialists in many innovative companies, have developed algorithms to detect cancer, sort luggage at the airports, classify defects of machine parts or spot traffic accidents.

perClass is composed of two parts, namely perClass Toolbox for quick design of classifiers in Matlab and perClass Runtime for classifier deployment in production.

perClass provides tools for:

1.2.1. Versions ↩

perClass comes in the following versions for commercial use:

These versions are available for academic research and teaching:

For Academic and Commercial versions, also group licensing is available using floating licenses provided by a license server.

1.2.2. System requirements ↩

perClass is supported on the following platforms:

perClass requires Matlab 7.5 or later

1.2.3. Useful general commands ↩

1.2.3.1. Displaying perClass version and license information ↩

perClass version information may be displayed using sdversion. It consists of a numerical part (e.g. 4.0) and a build date (6-May-2013).

sdversion also provides several license-related details such as license type (Commercial, Academic or Lite), licensee name and the license expiration date.

>> sdversion
perClass 4.0 (06-May-2013), Copyright (C) 2007-2013, PR Sys Design, All rights reserved
 Customer: PR Sys Design (PRSD)  Issued: 27-mar-2013
 Toolbox with DB,imaging: The license expires on 1-jul-2013.
 SDK: The license expires on 1-jul-2013.
 Installation directory: '/Users/pavel/matlab/toolboxes/perclass'

1.2.3.2. Demo examples ↩

sddemo lists several basic examples to get started

>> sddemo
run perclass_exampleX.m where X is the index of the desired example

 1 : Working with data sets
 2 : Training a classifier and visualizing decisions
 3 : Tuning a classifier using ROC analysis
 4 : Multi-class ROC analysis
 5 : Building detectors
 6 : Building a detector-classifier cascade

1.2.3.3. Provide direct feedback to PR Sys Design ↩

sdfeedback command allows users to submit feedback such as error messages to PR Sys Design directly from within Matlab. Running sdfeedback without arguments opens an edit dialog where the user may paste or type the desired message. An alternative is to provide the message to sdfeedback as a string.

1.2.3.4. Control messages displayed by perClass ↩

sddisplay command provides global verbosity control in perClass. Running sddisplay without arguments prints the current display state (on/off). To switch off messages printed by perClass, use:

>> sddisplay off

Default sddisplay state is on. When perclass_mex library is re-loaded into memory, this default state is re-introduced.

Alternatively, you may use the 'nodisplay' option in the functions that support it: sdrelab, sdroc, sddetect and sdcrossval.

1.3. Release notes ↩

Version 5.0 (21-Sep-2016)

Version 4.8 (19-Apr-2016)

Version 4.7 (15-Dec-2015)

Version 4.6 (29-Jun-2015)

Version 4.5 (17-Mar-2015)

Version 4.4 (3-Dec-2014)

Version 4.3 (24-Jun-2014)

Version 4.3 (26-May-2014)

Version 4.2 (5-Mar-2014)

Version 4.1 (3-Dec-2013)

Version 4.0 (26-Jul-2013)

How to upgrade to 4.0

Version 3.4 (9-Oct-2012)

Version 3.3.1 (7-Aug-2012)

Version 3.3 (21-May-2012)

Version 3.2 (14-Mar-2012)

Version 3.1.2 (22-Dec-2011)

Version 3.1.1 (24-Nov-2011)

Version 3.1 (14-Nov-2011)

Version 3.0.0 (6-Jun-2011)

Version 2.4.0 (7-Feb-2011)

Version 2.3.0 (13-Dec-2010)

Version 2.2.5 (24-Nov-2010)

Version 2.2.4 (5-Oct-2010)

Version 2.2.3 (29-July-2010)

Version 2.2.2 (22-June-2010)

Version 2.2.1 (3-May-2010)

Version 2.1.0 (21-Apr-2010)

Version 2.0.9 (8-Mar-2010)

Version 2.0.8 (19-Feb-2010)

Version 2.0.5 (22-Dec-2009)

Version 2.0.4 (14-Dec-2009)

Version 2.0.3 (9-Dec-2009)

Version 2.0.2 (4-Dec-2009)

1.x Compatibility changes

Version 1.3 (30-Nov-2009)

Version 1.2.5 (12-Oct-2009)

Version 1.2.4 (13-Aug-2009)

Version 1.2.3 (15-Jul-2009)

Version 1.2.2 (16-Jun-2009)

Version 1.2.1 (27-May-2009)

Version 1.2 (19-May-2009)

Version 1.1.6 (9-May-2009)

Version 1.1.5 (1-May-2009)

Version 1.1.4 (19-Mar-2009)

Version 1.1.3 (26-Jan-2009)

Version 1.1.2 (18-Nov-2008)

Version 1.1.1 (09-Nov-2008)

Version 1.1 (04-Nov-2008)

Version 1.1 (26-Oct-2008)

Version 1.0 (15-Sep-2008)

Version 1.0 (02-Sep-2008)