Pixel-by-Pixel
Classification for Zoning and MonitoringVersion
0.3d (October 2013)conceived and
written by Silvio Griguolo, with the collaboration of Antonio Ciavarella

This package can be freely used by anybody for any type of application.
The authors' only expectation is its use to be acknowledged in publications,
as it is customary in the scientific community.

Some years ago I wrote the package
ADDAPIX for DOS to perform some
multivariate analyses (Principal Components, Clustering) on a time
series of satellite images. It was targeted to Early Warning
applications, and specially aimed at constructing an eco-climatic zoning,
monitoring
the evolution of the cropping season, or assess its performance ex-post.The rationale under the development of the package
was that:

"...NDVI images are timely available for whole
continents, and it would be a waste of resources to omit any effort to
draw from them all possible useful information. ADDAPIX is an attempt to
obtain useful synthetic results, at least from a qualitative viewpoint
and in spite of the NDVI scarce reliability, by processing large
amounts of NDVI data." (ADDAPIX Manual, Introduction)

Version 2.03.05 was the last one, partially
funded by FAO, project GCP/INT/578/NET, and released in 1996.
However, with the developing and spreading of Windows 32 DOS applications became obsolete. The main drawback
concerned the graphic utilities,
unable to take advantage of Windows drivers to control video cards.

I started to convert the software to Win32,
but that was indeed a very slow
process, as most of my time was dedicated to my academic duties. For several
years a provisional version was used only in my research, or by my students. Along the way I
found the necessity to adapt the software to various types of
applications, sometimes quite far from the initial Early Warning area,
like neural networks or neuro-biological applications. I did not find
the time to make it easy for anybody's use, with online help, a
detailed manual and all tests and cross-controls necessary to
prevent inappropriate use.

Now it seems to me that the software works acceptably well, at least
in the hands of someone who knows what to do. Certainly more options
should be added, and it still is certainly plagued by some
bugs - no illusion about that - but the analytical sequences I usually
follow, and the graphic visualization application, appear to work smoothly. As I think that waiting for perfection
might mean to wait forever, at least considering the limited time I intend to
dedicate to its completion, I decided to make it available for others 'as
is'.

I hope that feedbacks from users will help me to improve it, albeit in
the limit of a non-professional application.

Features and use

Though mostly conceived for SPOT/VGT NDVI images in RAW or
IDA/WINDISP format, WINADX can be used to process 8-bit images of
any type and in any format, after suitably filling a DEFinition to
describe them (i.e., after providing their 'Image Type'). Some operations
can be
extended to 16-bit images (but only some...).

Various types of operations on (even very) numerous sets of
images can be carried out in one go.

The software links some DLLs or runs some external applications
to include the facilities offered by some other software I wrote
over years for UN-FAO, specially MADAM (computation of long-term
statistics for a time series of images) and AICON
(cropping/recoding/reprojecting a set of satellite images), to
prepare the images for the analyses to follow.

CropVGT,
used to extract images from a set of SPOT/VGT zipped
distribution files, is also included.

After suitably preparing (extracting, correcting,
merging) the
series of input images, the final goal is to perform
a multivariate
analysis (Principal Components Analysis and
Clustering, both for
zoning and monitoring purposes). Some graphic tools are
available to inspect the resulting classified images pixel by pixel.

Sets of images not making up a time series (e.g., some radiometric
bands) are also accepted as input.

The package

When unzipped, the zipped file downloaded from
this page will create a directory <ADDAPIX>
containing all the files (.EXE, .DLL, online help, etc.)
necessary for running, and the following subfolders:

<TANA>, which includes all the files necessary for a quite
detailed sample exercise. Please open the file
<instructions_for_Addapix.pdf >, describing the
exercise.
The <TANA> directory
contains some other subfolders (<prova>,
<zoning>, <monitoring>,
etc.) whose files are used
in some sample exercises described in the Help pages.

<DEFS>, with some DEFinitions
needed in the <Tana> exercise or in examples proposed in the
online help, plus many DEFinitions I had the occasion to use in the past
and copied here just as examples.
Any new DEF created by the user is automatically saved in this
folder. The currently existing DEFs, loaded at program's
startup, can be visualized/edited/deleted by selecting
Edit/SetImage
Type DEFinitions, View/Edit/Create from the Addapix Menu.
A DEF can also be removed by deleting from the <DEFS> folder the file
having the DEF's
name .

<IMAGES>, contains some auxiliary information specially
used when dealing with SPOT/VGT files. It includes also some
shapefiles. You can have a look at its contents, but please do not delete
or modify
any file in this directory.

<LOGS>, where the Log files
are saved (one per day) if so is requested in the Preferences
file winadx.ini.

Run the executable winadx.exe to start. Do not
launch directly any of the other .exe files included in the
<ADDAPIX> folder: they are meant to be internally managed by
winadx.

Changes from version 0.3c (September 2013)

Some imperfections have been fixed. The Edit/Set menu has been
re-organized, adding a 'Conversions' section that includes the
conversion of a .TXT CropVGT documentation file into a DEFinition.

Changes from version 0.3b (June 2013)

More bugs and imperfections have been fixed, mostly concerning the CROP
and RECODE utilities. A new utility to change the form of the date in a
set of filenames has been added.

The help system is now fully available in both .HLP and .CHM form. See
below for more details.

Changes from version 0.3a (February 2013)

Some bugs have been corrected, which affected the three utilities 'Reproject/crop/recode', 'Recode pixel values'
and 'Creating a raster mask' in the Utilities Menu.
These utilities have been best-tuned, and their joint use,
albeit not easy to master, is quite powerful. Some help notes
describing them have been added.

A new utility to compute the distribution of pixel values in a
8-bit image has been included.

A short note on the conversion of VGT and Metop NDVI images has
been added.

Changes from version 0.3 (October 2012)

A bug which caused Addapix to crash when processing a set of
WINDISP images in Madam, Step1, was brought to my attention by
Esther Amler of the UN-WFP. The bug was fixed in version 0.3a
(October 2012). Thanks, Esther.

A program crash occurring when choosing "Select classes" from
the Analysis Menu, and then exiting Display without selecting
any class, has been fixed.

At the time being ADDAPIX
for Windows
offers a complete online help in WinHelp (*.HLP) format, which is unfortunately no
longer natively supported in Windows Vista, 7 and 8. The
Help system is quite detailed, and the user should have frequent recourse to it for explanations and
instructions.

An online
help in HTML format (*.CHM) is also included, supported
by the most recent Windows Systems, but somehow limited
owing to
non-availability of popup windows in the HTML Help.

The user can set the
desired type of help by editing the initialization file:
just select Edit/SetPreferences,
Settings from the Addapix Menu.

WINHELP is
much more complete, and I strongly recommend its use
when possible.

For users of Windows Vista, 7
or 8,
who would like to continue to use WinHelp, Microsoft
does make the WinHelp application available as a separate
download. You'll need to install the
version fitting your Windows system choosing from the
following links: