[pktools] 06/07: Add man page for pkfssvm.
Bas Couwenberg
sebastic at xs4all.nl
Sun Dec 7 01:42:20 UTC 2014
This is an automated email from the git hooks/post-receive script.
sebastic-guest pushed a commit to branch master
in repository pktools.
commit 1ddd19c31a31735e5d1be104212f7e71196ffc81
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Sun Dec 7 02:18:55 2014 +0100
Add man page for pkfssvm.
---
debian/changelog | 2 +-
debian/man/pkfssvm.1.xml | 391 +++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 392 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index 534cb50..6683a43 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,7 +5,7 @@ pktools (2.6.1-1) UNRELEASED; urgency=medium
* Remove libbase package, library no longer installed.
* Add man page for pkann, pkascii2img, pkascii2ogr, pkcomposite, pkcreatect,
pkcrop, pkdiff, pkdsm2shadow, pkdumpimg, pkdumpogr, pkegcs, pkextract,
- pkfillnodata, pkfilter, pkfilterascii, pkfilterdem, pkfsann.
+ pkfillnodata, pkfilter, pkfilterascii, pkfilterdem, pkfsann, pkfssvm.
-- Bas Couwenberg <sebastic at xs4all.nl> Wed, 03 Dec 2014 21:16:31 +0100
diff --git a/debian/man/pkfssvm.1.xml b/debian/man/pkfssvm.1.xml
new file mode 100644
index 0000000..5009a6d
--- /dev/null
+++ b/debian/man/pkfssvm.1.xml
@@ -0,0 +1,391 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='pkfssvm'>
+
+ <refmeta>
+ <refentrytitle>pkfssvm</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>pkfssvm</refname>
+ <refpurpose>feature selection for nn classifier</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>pkfssvm</command>
+ <arg choice='plain'><option>-t</option> <replaceable>training</replaceable></arg>
+ <arg choice='plain'><option>-n</option> <replaceable>number</replaceable></arg>
+ <arg choice='opt'><replaceable>options</replaceable></arg>
+ <arg choice='opt'><replaceable>advanced options</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ Classification problems dealing with high dimensional input data can be
+ challenging due to the Hughes phenomenon.
+ Hyperspectral data, for instance, can have hundreds of spectral bands and
+ require special attention when being classified.
+ In particular when limited training data are available,
+ the classification of such data can be problematic without reducing the
+ dimension.
+ </para>
+ <para>
+ The SVM classifier has been shown to be more robust to this type of
+ problem than others.
+ Nevertheless, classification accuracy can often be improved with feature
+ selection methods.
+ The utility pkfssvm implements a number of feature selection techniques,
+ among which a sequential floating forward search (SFFS).
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-t</option> <replaceable>filename</replaceable></term>
+ <term><option>--training</option> <replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ training vector file.
+ A single vector file contains all training features
+ (must be set as: B0, B1, B2,...) for all classes
+ (class numbers identified by label option).
+ Use multiple training files for bootstrap aggregation
+ (alternative to the bag and bsize options,
+ where a random subset is taken from a single training file)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-n</option> <replaceable>number</replaceable></term>
+ <term><option>--nf</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ number of features to select
+ (0 to select optimal number,
+ see also <option>--ecost</option> option)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-i</option> <replaceable>filename</replaceable></term>
+ <term><option>--input</option> <replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ input test set (leave empty to perform a cross validation based on
+ training only)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-v</option> <replaceable>level</replaceable></term>
+ <term><option>--verbose</option> <replaceable>level</replaceable></term>
+ <listitem>
+ <para>
+ set to: 0 (results only), 1 (confusion matrix), 2 (debug)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>Advanced options</para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-tln</option> <replaceable>layer</replaceable></term>
+ <term><option>--tln</option> <replaceable>layer</replaceable></term>
+ <listitem>
+ <para>
+ training layer name(s)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-label</option> <replaceable>attribute</replaceable></term>
+ <term><option>--label</option> <replaceable>attribute</replaceable></term>
+ <listitem>
+ <para>
+ identifier for class label in training vector file.
+ (default: label)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-bal</option> <replaceable>size</replaceable></term>
+ <term><option>--balance</option> <replaceable>size</replaceable></term>
+ <listitem>
+ <para>
+ balance the input data to this number of samples for each class
+ (default: 0)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-random</option></term>
+ <term><option>--random</option></term>
+ <listitem>
+ <para>
+ in case of balance, randomize input data
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-min</option> <replaceable>number</replaceable></term>
+ <term><option>--min</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ if number of training pixels is less then min,
+ do not take this class into account
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-b</option> <replaceable>band</replaceable></term>
+ <term><option>--band</option> <replaceable>band</replaceable></term>
+ <listitem>
+ <para>
+ band index (starting from 0, either use band option or use start
+ to end)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-s</option> <replaceable>band</replaceable></term>
+ <term><option>--start</option> <replaceable>band</replaceable></term>
+ <listitem>
+ <para>
+ start band sequence number
+ (default: 0)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-e</option> <replaceable>band</replaceable></term>
+ <term><option>--end</option> <replaceable>band</replaceable></term>
+ <listitem>
+ <para>
+ end band sequence number (set to 0 to include bands)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--offset</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ offset value for each spectral band input features:
+ refl[band]=(DN[band]-offset[band])/scale[band]
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--scale</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ scale value for each spectral band input features:
+ refl=(DN[band]-offset[band])/scaleband
+ (use 0 if scale min and max in each band to -1.0 and 1.0)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-svmt</option> <replaceable>type</replaceable></term>
+ <term><option>--svmtype</option> <replaceable>type</replaceable></term>
+ <listitem>
+ <para>
+ type of SVM (C_SVC, nu_SVC,one_class, epsilon_SVR, nu_SVR)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-kt</option> <replaceable>type</replaceable></term>
+ <term><option>--kerneltype</option> <replaceable>type</replaceable></term>
+ <listitem>
+ <para>
+ type of kernel function (linear,polynomial,radial,sigmoid)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-kd</option> <replaceable>value</replaceable></term>
+ <term><option>--kd</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ degree in kernel function
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-g</option> <replaceable>value</replaceable></term>
+ <term><option>--gamma</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ gamma in kernel function
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-c0</option> <replaceable>value</replaceable></term>
+ <term><option>--coef0</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ coef0 in kernel function
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cc</option> <replaceable>value</replaceable></term>
+ <term><option>--ccost</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ the parameter C of C-SVC, epsilon-SVR, and nu-SVR
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-nu</option> <replaceable>value</replaceable></term>
+ <term><option>--nu</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ the parameter nu of nu-SVC, one-class SVM, and nu-SVR
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-eloss</option> <replaceable>value</replaceable></term>
+ <term><option>--eloss</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ the epsilon in loss function of epsilon-SVR
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cache</option> <replaceable>number</replaceable></term>
+ <term><option>--cache</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ cache memory size in MB
+ (default: 100)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-etol</option> <replaceable>value</replaceable></term>
+ <term><option>--etol</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ the tolerance of termination criterion
+ (default: 0.001)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-shrink</option></term>
+ <term><option>--shrink</option></term>
+ <listitem>
+ <para>
+ whether to use the shrinking heuristics
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sm</option> <replaceable>method</replaceable></term>
+ <term><option>--sm</option> <replaceable>method</replaceable></term>
+ <listitem>
+ <para>
+ feature selection method
+ (sffs=sequential floating forward search,
+ sfs=sequential forward search, sbs, sequential backward search,
+ bfs=brute force search)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-ecost</option> <replaceable>value</replaceable></term>
+ <term><option>--ecost</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ epsilon for stopping criterion in cost function to determine
+ optimal number of features
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cv</option> <replaceable>value</replaceable></term>
+ <term><option>--cv</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ n-fold cross validation mode (default: 0)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-c</option> <replaceable>name</replaceable></term>
+ <term><option>--class</option> <replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ list of class names.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-r</option> <replaceable>value</replaceable></term>
+ <term><option>--reclass</option> <replaceable>value</replaceable></term>
+ <listitem>
+ <para>
+ list of class values (use same order as in
+ <option>--class</option> option).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='see-also'>
+ <title>SEE ALSO</title>
+
+ <citerefentry>
+ <refentrytitle>pkfsann</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+
+ </refsect1>
+
+</refentry>
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/pktools.git
More information about the Pkg-grass-devel
mailing list