eROSE
Reengineering of Software Evolution in Eclipse

Software Engineering Chair (Prof. Zeller)
Saarland University – Computer Science
Saarland Informatics Campus
Campus E9 1 (CISPA)
66123 Saarbrücken, Germany
E-mail: zeller @ cs.uni-saarland.de
Phone: +49 681 302-70970

Deutschsprachige Startseite Page d'acceuil en franšais English home page
  

eRose is a plugin for Eclipse that guides programmers along related changes. If you change f() and other people have changed f() together with g() in the past, eRose will detect this and suggest "Programmers who changed function f() also changed function g()." All eRose needs is a CVS repository; we designed eRose to be as efficient and unobstrusive as possible.

Install eROSE

Smart way:
  1. Start ECLIPSE.
  2. Select Help→ Software Updates→ Find and Install...
  3. Choose Search for new features to install and select Finish.
  4. Select New Remote Site... and enter:
    • Name: Saarland University
    • URL: http://www.st.cs.uni-saarland.de/softevo/erose/update-site/
    Then select OK to add the new update site.
  5. Include the update site "Saarland University" in your search and select Next.
  6. Choose the feature "eROSE: Reengineering of Software Evolution" and select Next.
  7. Read the license and accept the terms (if you agree) and select Next.
  8. Choose your ECLIPSE installation and select Finish.
  9. The feature is not signed (yet), so likely you will get a warning. Select Install.
  10. Restart your ECLIPSE workbench to complete the installation.
  11. You should now have two views Changed Entities and Rose (see below) in your Resource or Java perspective. If not, add both views with Window→ Show Views→ Other...→ Rose Views
Traditional way:
  1. Download eROSE and unpack the zip-file into your ECLIPSE directory.
  2. Start ECLIPSE. You should now have two views Changed Entities and Rose in your Resource or Java perspective. If not, add both views with Window→ Show Views→ Other...→ Rose Views.

    The Changed Entities and the Rose view.

Setup eROSE for a project

  1. eROSE needs a database to perform fast mining. This database is created in this step.
    Note that the creation of the database takes a while and cannot be interrupted. We recommend that you use eROSE only for small projects until we have implemented an incremental preprocessing.
  2. Select eROSE→ Preprocess project... from the context menu of a project (that is shared with CVS). This opens the preprocessing wizard:

    The Preprocess Project wizard.

  3. Choose the "Internal Database" and click on "Finish".
  4. Now eROSE analyzes the CVS repository of this project. Click on "Details" for more information about the progress or select "Run in Background".

    The progress of eROSE.

    The preprocessing consists of four steps:

    • Mirror CVS repository into database.
    • Group revisions to transactions.
    • Parse revisions for fine-grained changes (takes most of the time; see screenshot).
    • Setup Rose tables.
  5. After the preprocessing has been completed you will be informed with a message box.

    Preprocessing has completed

    In case you have selected "Run in Background", check the progress of eROSE in the Progress view. The "OK" means successful completion.

    Preprocessing has completed

Using eROSE

  1. Check that eROSE is enabled. The context menu of a resource should look like this (note that "Turn Rose on" is disabled):

    eROSE is enabled.

  2. eROSE mines whenever you change something. You can find its recommendations in the Rose view:

    eROSE makes recommendations.

    eROSE gives three kinds of recommendations (see the Action column):

    • CHG: Change the Symbol, e.g., the method usage().
    • ADD_IN: Add something in the Symbol, e.g., the file BirdieProcessor.java. For JAVA "add" refers to fields, methods, or import statements.
    • DEL_IN: Delete something in the Symbol, e.g., the file URLUtils.java. For JAVA "delete" refers to fields, methods, or import statements.
    The Support and Confidence columns represent the strength of a single recommendation.
  3. To reset the recommendations of eROSE, use the "Clear" button in the Changed Entities view.

    Reset eROSE.

See also

Imprint Privacy Policy

<webmaster@st.cs.uni-saarland.de> · http://www.st.cs.uni-saarland.de/softevo/erose/getting-started.php · Updated: 2018-04-05 13:41