Index: trunk/ippScripts/scripts/ipp_cleanup.pl
===================================================================
--- trunk/ippScripts/scripts/ipp_cleanup.pl	(revision 17575)
+++ trunk/ippScripts/scripts/ipp_cleanup.pl	(revision 17575)
@@ -0,0 +1,92 @@
+#!/usr/bin/env perl
+
+# this script is used to cleanup the files from the different ipp
+# stages.  It can be called with one of two cleanup modes: clean and
+# purge.  the former removes temporary data files, leaving behind
+# enough information for the results to be rebuilt.  The latter
+# removes all but basic logging data.
+
+use warnings;
+use strict;
+
+use IPC::Cmd 0.36 qw( can_run run );
+use File::Spec;
+use PS::IPP::Config;
+use Getopt::Long qw( GetOptions :config auto_help auto_version gnu_getopt );
+use Pod::Usage qw( pod2usage );
+
+my $ipprc = PS::IPP::Config->new(); # this is used for PATH, NEB filename conversions
+
+# Parse the command-line arguments
+my ($camera, $outroot, $dbname, $mode, $no_op, $help);
+GetOptions('camera|i=s'     => \$camera,    # user-supplied camera name
+	   'outroot|o=s'    => \$outroot,   # basename for files
+	   'dbname|d=s'     => \$dbname,    # Database name
+	   'mode|m=s'       => \$mode,      # cleanup mode (clean / purge)
+	   'no-op'          => \$no_op,     # pretend but don't actually inject
+	   'help'           => \$help       # give help listing
+	   ) or pod2usage( 2 );
+
+pod2usage( -msg => "remove temporary / all data files for an IPP analysis stage", 
+	   -exitval => 2) if 
+    defined $help;
+
+pod2usage( -msg => "Usage: $0 --camera (name) --outroot (path) --stage (stage) --mode (mode) [--dbname dbname] [--no-op] [--help]", 
+	   -exitval => 2 ) if 
+    scalar @ARGV == 0;
+
+pod2usage( -msg => "Required options:--camera (name) --outroot (path) --stage (stage) --mode (mode)",
+	   -exitval => 3) unless 
+    defined $camera and
+    defined $outroot and
+    defined $stage and
+    defined $mode;
+
+# $mode must be one of "clean" or "purge"
+unless (($mode eq "clean") || ($mode eq "purge")) {
+    die "invalid cleanup mode $mode\n";    
+}
+
+$ipprc->define_camera($camera);
+
+my $found = 0;
+my @files = ();
+
+# XXX : should ipp_cleanup.pl determine the class ID values, or should it require them as input?
+
+if ($stage eq "chip") {
+    # delete the temporary image datafiles
+    addFilename (\@files, "PPIMAGE.OUTPUT", $outroot, $class_id);
+    addFilename (\@files, "PPIMAGE.OUTPUT.MASK", $outroot, $class_id);
+    addFilename (\@files, "PPIMAGE.OUTPUT.WEIGHT", $outroot, $class_id);
+    addFilename (\@files, "PPIMAGE.CHIP", $outroot, $class_id);
+    addFilename (\@files, "PPIMAGE.CHIP.MASK", $outroot, $class_id);
+    addFilename (\@files, "PPIMAGE.CHIP.WEIGHT", $outroot, $class_id);
+    if ($mode eq "purge") {
+	# additional files to remove for 'purge' mode
+	addFilename (\@files, "PPIMAGE.OUTPUT.FPA1", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.OUTPUT.FPA2", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.BIN1", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.BIN2", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.JPEG1", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.JPEG", $outroot, $class_id);
+	addFilename (\@files, "PPIMAGE.STATS", $outroot, $class_id);
+    }
+}
+
+exit 0;
+
+sub addFilename 
+{
+    my $files    = shift; # reference to a list of files to unlink
+    my $filerule = shift; # filerule to add
+    my $outroot  = shift; # base filename
+    my $class_id = shift; # class_id, if needed
+
+    my $file = $ipprc->filename($filerule, $outroot, $class_id);
+
+    push @$files, $file;
+    return 1;
+}
+
+__END__