1. Start Eclipse with the required command line arguments. You can do this in one of the following ways:
   • Open the folder that contains our Eclipse distribution in special installation for Windows 32 and launch the file startup.bat
   • Use the link, alias or batch file created in step 5 of manual installation of the individual DPJF components
2. During the first startup you might see a 'Run File-Security Warning'

message (in Windows). Just click 'Run' to tell Windows that the

  Prolog runtime is a trusted process.
- When Eclipse has finished starting, check that it displays a "JTransformer" menu.
  Then the installation was successful.

If you have run the special installation for Windows 32 you will see the following layout of Eclipse views, called the DPJF perspective. If it is not displayed, you can always explicitly switch to the DPJF perspective. It consists of:

1. The Package Explorer: The upper left view displays the Java projects in your Eclipse workspace.
2. The JTransformer Control Center: The middle-left view displays installed JTransformer plugins

and lets users activate, deactivate, configure and run them. DPJF is a set of such plugins.

1. The JT Analysis Results View: The middle-right view displays the anaylsis results from the installed JTransformer

plugins, including the design pattern candidates found by DPJF. You will see the information about program

  elements playing roles in DP candidates and the links to the corresponding places in the source code.
- **The Prolog Console**: The bottom view is the Prolog Console, which displays what happens 
  under the cover. Here you can interact with DPJF or JTransformer at a low abstraction level
  entering queries manually. Most users will never need this layer of detail. 

You can detect design patterns on any Java project in your workspace. Eventually you might want to import one or check one out via SVN from our collection of DPD benchmark projects at https://svn.iai.uni-bonn.de/repos/IAI_Software/dpd/benchmarks/trunk/SourceCode/java

Our DPJF Installation package comes with the factbases for the benchmark projects used for the evaluation reported in our CSMR 2012 paper. However, make sure that the letters “JT” appear near the project(s) you want to detect patterns in. If not, you can generate a factbase for this project.

To enable design pattern detection on a Java project P generate, load and select a factbase for P.

DPJF supports two forms of Design Pattern Detection (DPD):

• Batch DPD, where analysis is triggered manually by the user
• Continuous DPD, where analysis results are automatically updated upon every saved change of a file

DPJF supports two different batch DPD workflows, adapted to the two main user profiles:

• DPD for Software Engineers who are interested in quick results, not in meta-issues
• DPD for Researchers who want to assess the precision, recall and speed of DPJF

Continuous DPD is a unique feature of DPJF, enabled by its very high query speed. It can be seen as an especially convenient form of DPD for Software Engineers:

• Users simply select the DPD plugins that should always run automatically by setting the 'On Save' trigger in the JTransformer Control Center.
• Henceforth, the results displayed in the Result View and the markers displayed in editors will be updated automatically after each file save