📄 specification.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>EDISON Command Prompt Specification</title>
<h2>Edge Detection and Image SegmentatiON (EDISON) System Command Prompt
Specification</h2>
<hr>
</head>
<body bgcolor=#FFFFFF>
<!---Table of Contents--->
<h3>Table of Contents</h3>
<ul>
<li><a href="#overview">Overview</a>
<li><a href="#syntax">Syntax</a>
<li><a href="#commands">Commands</a>
<li><a href="#parameters">Parameters</a>
<li><a href="#enumerations">Data Types and Enumerations</a>
<li><a href="#input">Input Types</a>
<li><a href="#output">Output Types</a>
<li><a href="#images">Supported Image/File Formats</a>
<li><a href="#formats">Other Image Formats</a>
<li><a href="#example_edge">Example: Confidence Based Edge Detection</a>
<li><a href="#example_ms">Example: Mean Shift Based Segmentation</a>
<li><a href="#example_syn">Example: Synergistic Segmentation</a>
<li><a href="#example_filt">Example: Mean Shift Based Image Filtering and Region Fusion</a>
</ul>
<hr>
<!---System Overview--->
<h3><a name="overview">Overview</a></h3>
<p>
The command prompt version of the Edge Detection and Image SegmentatiON (EDISON)
System provides a versatile environment for performing confidence based edge
detection and synergistic image segmentation through the definition of user
defined scripts. In an EDISON script one specifies the system parameters,
input, output, and operations. The system functionality is facilitated
through a simple set of commands and parameters described in the following
sections.
<p>
Once compiled and installed, the system may be invoked from the command
prompt by typing,
<br><br>
<font face="courier" size=1> >> edison myscript.eds</font>
<br><br>
where 'myscript.eds' is a user defined EDISON script file.
<p>
The source code and makefile for the command prompt version of the EDISON system
is available from the
<a href="http://www.caip.rutgers.edu/riul/"> Robust Image Understanding
Laboratory </a> web site. The system was tested under both UNIX and Windows
operating system environments.
<br><br>
<hr>
<!---Syntax--->
<h3><a name="syntax">Syntax</a></h3>
<p>
The C-like syntax of the EDISON system is extraordinarily simple. In short,
the EDISON script language is case sensitive, each statement must end in a semicolon,
and assignments must be performed using the equals sign. Line comments and block
comments are facilitated through the use of '
<font face="courier" size=2>//</font>
' and '
<font face="courier" size=2>/*</font> ... <font face="courier" size=2>*/</font>
' respectively. The language is limited to a small set of pre-defined
parameters and commands whose usage is outlined in the following sections.
<br><br>
<hr>
<!---Commands--->
<h3><a name="commands">Commands</a></h3>
<p>
The EDISON language contains three basic classes of commands. These classes as
well as the commands that constitute them are listed below.
<p><b>Input/Output</b>
<p>
<table width="80%" border=0>
<tr>
<td width="5%"></td>
<td width="15%"><u>Command</u>:</td>
<td width="80%"><a name="save"><b>Save</b></a></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
Outputs system results. System results may be saved as images and
MATLAB ASCII data files for analysis and further processing. If the
requested result is not available a run-time error will be flagged by
the system and the system execution will be halted.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Save('filename', filetype, outputtype);</i></td>
</tr>
<tr>
<td></td>
<td><u>Arguments</u></td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>filename</i></td>
<td>A character string containing the name of the file to which the result
will be saved. The file extension must be included in the filename,
EDISON will <u>not</u> place one automatically.</td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>filetype</i></td>
<td>An enumeration that specifies the image/data format, the only data
format available being a MATLAB ASCII file. The
<a href="#images"> File Type </a> enumeration is detailed below.</td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>outputtype</i></td>
<td>An enumeration that specifies which result is to be saved. The
<a href="#output"> Output Type </a> enumeration is detailed below.</td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><a name="load"><b>Load</b></a></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
Loads system input. There are two types of system input: (1) the images
which are processed by the EDISON system, and (2) data maps used by
the synergistic image segmentation algorithm to segment an image using
specialized (possible higher-level) information. If the specified file
to be loaded does not exist or read permission is denied, a run-time
error is flagged and the system execution is halted.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Load('filename', inputtype);</i></td>
</tr>
<tr>
<td></td>
<td><u>Arguments</u></td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>filename</i></td>
<td>A character string containing the name of the input file.</td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>inputtype</i></td>
<td>An enumeration specifying the type of input IMAGE or MAP. The
<a href="#input"> input type </a> is outlined below.</td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Use Result</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
Routes the filtering or segmentation result from the previous operation
to the current input of the system. When UseResult is invoked, the original
image is replaced by the system output and any current output is deleted.
In order to reinstate the input image Load must be called once again.
If system output does not exists in the form of a filtered or segmented image
a run-time error is generated and the system is halted.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>UseResult(outputtype);</i></td>
</tr>
<tr>
<td></td>
<td><u>Arguments</u></td>
</tr>
<tr>
<td></td>
<td valign=top>   <i>outputtype</i></td>
<td>An enumeration that specifies which result is to be stored as
input to the system. Unlike <a href="#save"> Save </a> the outputtype
to argument to UseResult may only have one of two values: SEGM_IMAGE or
FILT_IMAGE. The
<a href="#output"> Output Type </a> enumeration is detailed below.</td>
</tr>
</table>
<p><b>Operations</b>
<p> EDISON operations do not take any arguments when invoked. The arguments to
these operations are specified by the parameter assignments which must be made
prior to invoking an operation. If a parameter remains un-specified or system
input is needed to perform the desired operation, a run-time error will be
flagged and the system execution halted.
<p>
<table width="80%" border=0>
<tr>
<td width="5%"></td>
<td width="12%"><u>Command</u>:</td>
<td width="83%"><b>Edge Detect</b></td>
</tr>
<tr>
<td></td>
<td><u>Description</u>:</td>
<td>
Performs confidence based edge detection.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>EdgeDetect;</i></td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Filter</b></td>
</tr>
<tr>
<td></td>
<td><u>Description</u>:</td>
<td>
Performs mean shift filtering.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Filter;</i></td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Fuse</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
Performs transitive closure on the input image, fusing its regions
based on a set of similarity criterion. See the
<a href="http://www.caip.rutgers.edu/riul/"> paper </a> for details. The
Fuse operation will use the filtered image output as input if available,
otherwise the input image regions will be fused.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Fuse;</i></td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Segment</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
Performs traditional mean shift based and synergistic image segmentation.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Segment;</i></td>
</tr>
</table>
<p><b>Flags</b>
<p> EDISON flags define the system state. They have a value of either ON or OFF
The EDISON system keeps track of three system flags which are set using the
following commands. If a flag is not specified its default value is OFF.
The <a href="#flags"> flag type </a> enumeration is also mentioned below.
<p>
<table width="80%" border=0>
<tr>
<td width="5%"></td>
<td width="12%"><u>Command</u>:</td>
<td width="83%"><b>Synergistic</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
The system performs synergistic segmentation when this flag has the
value ON and mean shift based segmentation when it has the value OFF.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>Synergistic FLAG;</i></td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Display Progress</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
When turned ON this flag instructs the system to output its progress
to <font style="courier" size=2> stdout </font>. When OFF no output
is generated.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>DisplayProgress FLAG;</i></td>
</tr>
<tr height=20></tr>
<tr>
<td></td>
<td><u>Command</u>:</td>
<td><b>Use Custom Weight Map</b></td>
</tr>
<tr>
<td></td>
<td valign=top><u>Description</u>:</td>
<td>
The user specified custom weight map is used during synergistic
segmentation when this flag is set to ON. When OFF the derived weight
map is used.
</td>
</tr>
<tr>
<td></td>
<td><u>Syntax</u>:</td>
<td><i>UseCustomWeightMap FLAG;</i></td>
</tr>
</table>
<br><br>
<hr>
<!---Parameters--->
<h3><a name="parameters">Parameters</a></h3>
All necessary parameters must be specified prior to invoking an operation. The
system takes <u>no</u> default values because of the strong dependence between
parameter values and the input image. The parameters are categorized according
to operation and are outlined below. Although each parameter is briefly described,
for a more detailed description please consult the papers available from the
<a href="http://www.caip.rutgers.edu/riul/"> RIUL </a> web site.
<p><b>Mean Shift Based Segmentation</b>
<p>
<table width=80% border=0>
<tr>
<td width="5%"></td>
<td width="15%"><u>Parameter</u>:</td>
<td width="80%"><b>SpatialBandwidth</b></td>
</tr>
<tr>
<td width="5%"></td>
<td width="15%" valign=top><u>Description</u>:</td>
<td width="80%">Specifies a spatial search window of size (2<i>r</i>+1)x
(2<i>r</i>+1) during the mean shift computation, where <i>r</i> is the
spatial bandwidth.</td>
</tr>
<tr>
<td width="5%"></td>
<td width="15%"><u>Type</u>:</td>
<td width="80%">Integer</td>
</tr>
<tr>
<td width="5%"></td>
<td width="15%"><u>Range</u>:</td>
<td width="80%"> Greater than zero.</td>
</tr>
<tr height=20></tr>
<tr>
<td width="5%"></td>
<td width="15%"><u>Parameter</u>:</td>
<td width="80%"><b>RangeBandwidth</b></td>
</tr>
<tr>
<td width="5%"></td>
<td width="15%" valign=top><u>Description</u>:</td>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -