Table of contents

1. Introduction
2. Installation
2.1. Installation of JRE
2.2. Installation of CCFinder
2.3. Installation of ICCA
2.4. Test
3. Link to other manuals

1. Introduction


Integrated Code Clone Analysier(ICCA) is a comprehensive code clone analysis environment.
ICCA can analysis code clones included in source codes.
Currently, ICCA consists of tree components, Gemini, Aries, and Libra.
Here, we introduce these components briefly.

Gemini is a code clone analyis component.
Gemini has the Scatter Plot and the Metric Graph,
which enables user to browse source codes of code clones and filter code clones effecfively.

Aries is a refactoring support component based on code clone analysis.
Aries can detect code clones that can be easily refactored.
Aries characterizes code clones using several metrics, which enables user to refactor code clones effectively.

Libra is debugging support component for code clone.
If user have a code fragment with which he/she want to get code clones, Libra is very useful.

The following table summarizes functions of each component.
browsing the distribution
of code clones
filtering code clones
by metrics
filtering code clones
by their units
detecting code clones
with a specified fragment
Gemini¡û¡û

Aries
¡û¡Ê¢¨¡Ë¡û
Libra


¡û
¢¨In the Metrics Graph of Aries, some refactoring-oriented metrics are added.

The following table summarizes views and lists included in these components.
Scatter
Plot
Metric Graph
(Metric View)
Clone Set
List
File ListDirectory
Tree
Source Code
View
Variable
List
Gemini
(Clone Set Base Analysis View)

¡û¡û

¡û
Gemini
(File Base Analysis View)
¡û

¡û¡û¡û
Aries
¡û¡Ê¢¨¡Ë¡û

¡û¡û
Libra




¡û
¢¨In the Metric Graph of Aries, a new function filtering code clones by using their units is added.

Each component uses CCFinder to detect code clones.

In followings, we describe the installation of ICCA, and more concrete usege of each component.

2. Installation

JRE(Java Runtime Environment) is required to execute ICCA.
You have to install JRE at first.

2.1 Installation of JRE

Install JRE(version 1.4 or above is required) from the web site of Sun Microsystems.

2.2 Installation of CCFinder

Please read the manual included in CCFindeer package

2.3 Installation of ICCA

Conduct following two steps.
  1. download icca.zip, and extract it.
  2. add the "/bin" directory in directory tree of icca to environment variable "PATH"
Inputting "java -jar icca.jar" in command prompt launches a following screen.

2.4 Test

Here, test whether icca is installed correctly.

At first, input "java -jar icca.jar" in command prompt.
After that, a following screen is launched.

You will find label "analyze refactoring-oriented code clone".
push the next button of its label.

Next, the following screen will be displayed.

Pushing the "refer" button launches the following file selecting dialog box.

Here, for testing, select sample.xml which is in sample directory, and bush the "Start Aries GUI" button.
If following screen is displayed, your installation of ICCA succeeded.

3. Link to other manuals


to the manual of Gemini
to the manual of Aries
to the manual of Libra