1. Install Loong Eclipse plugin on your Eclipse

In the menu bar, click Help and choose Install New Software.... In the popup dialog, type the update site http://www.chrisyttang.org/loong/update to the Work with: box to install Loong plugin. Then you can simply follow the installation instructions, for plugin depenences you should install could be found in this link(GEF 3.10 *If you have ready installed it, you can just skip this.)

2.(Optional:for CIDE user only) Migrate a CIDE2 Project to Loong Project

This is a redundant step if you do not work from a CIDE2 project and you can safely skip this step. In Loong, we provide two options for migrating a CIDE 2 project to Loong: (1) Bridge CIDE 2 Project to a Loong Project(safe mode), which a CIDE 2 nature is detected in this project's description set. Namely, it is a project in a CIDE 2 mode in your workspace; and (2) Bridge CIDE 2 Project to a Loong Project(Force: Not safe), which will migrate any project into a Loong Project, since user is required to guarantee it is a CIDE 2 project indeed.

3. Design A Feature Model for Project

In Loong plug-in, we inheritance the feature model of guidsl and the feature model editor in FeatureIDE plugin. The detail grammar used in guidsl could be found at following website: The guidsl Tool. In addition, the feature model editor is the early version in FeatureIDE plugin (2010). You can use this function in the submenu: Edit Feature Model...(guidsl). For FeatureIDE tool and the feature model editor, you can redirect to FeatureIDE host page at FeatureIDE and a paper Reasoning about edits to feature models for more detail.

4. Annotate Seeds for Features

Seeds are selected for features concerned. To annotate a seed, you have to turn to CLREditor and use the context menu. In the context menu, use Annotated feature to the selection and select a specific feature for this region. After this selection, the feature will be annotated to this region.

5. (Optional) Save the log for seeds status

In Loong plug-in, we provide an useful feature for debugging and learning purpose. That is, we allow user to save the annotation status at any time and recover the status. In the project context menu, there are two useful actions: create Log for seeds and Rollback to A Certain Status(Seed). The action create Log for seeds allows you to save current status. Usually,we save the annotation for seed. And you can use Rollback to A Certain Status(Seed) action to roll back to a stutas from any step.

6. Create Program DataBase and Set Feature Mining Strategy

To conduct a feature mining work, the first step is to build the database for the project, use action Create Program Database... in the project context menu, please reference the screenshot in the previous step. Furthermore, we allow users to select their own feature mining strategy in the action Set Feature Mining Strategy in the project context menu.

7.Annotate features

Then we can start an annotation task on this project, use the action Annotate Features provided by project context menu.

8. (Optional) Assess the feature mining performance

As a research-oriented work, we provide a function that allow user to access their feature mining strategy by referencing benchmark. Also, in the project context menu, use the action Compare Performance With Benchmark. Then you can select a benchmark in workspace to compare with. After this process, a file named result.xml will be built inside your project, where you can inspect your feature mining strategy's performance.* For same case studies and benchmarks in CIDE format, you can use Loong to convert a CIDE project into a Loong project(see step.2).

Other Wiki document could be found at our Github Wiki