Mulan logo Mulan: A Java Library for Multi-Label Learning

Getting Mulan

Latest release

Mulan 1.5 is the latest release of Mulan library. You can download it as a single zip file from here. The compressed file contains:

  • A jar file with Mulan classes (mulan.jar)
  • A jar file with Weka classes, upon which Mulan is built (weka.jar)
  • A jar file with Mulan sources (mulan-src.jar)
  • A folder with the API reference documentation for offline inspection (apidoc/)
  • A folder with a sample dataset (data/)
  • A changelog file with changes from previous mulan versions
  • A licence file
  • An xml build file
  • A readme file with the contents of the release and a link to the online first-steps documentation

Older Releases

All older releases of Mulan are available from the Sourceforge website.

Development version

The development version of Mulan contains the latest bug fixes and new features that are still under development.

Git

As of October 2014, we are transitioning our repository to git. The project can be readily obtained using any git client.

Command Line

Git does not come preinstalled in most operating systems. However, its installation is fairly easy, using the system's package manager on Linux Systems, or by downloading straight from git's website on OS X and Windows systems.

In order to get the Mulan code, you simply run the command

git clone ssh://git.code.sf.net/p/mulan/gitcode/ mulan-gitcode

SourceTree

SourceTree is an intuitive, easy-to-use git GUI client for Windows and OS X.

    Step-by-step procedure
  • Download the installation file and install Sourcetree
  • At first run, remember to check Configure automatic line ending handling by default
  • first_setup

  • Select Clone/New and complete the fields with the project's information
  • clone_project

  • The cloning process may take a while, depending on your internet connection speed
  • clone_completed

  • When completed, you will be presented with the following screen
  • sourcetree_repo

Eclipse

The walkthrough that is presented here is based on Eclipse Luna. There is no need for any user credentials for accessing the Git server since anonymous access is available. On the other hand you will need credentials if you intend to commit your code into the Git repository.

Prerequisites

  • The Eclipse IDE with support for git (more information here)
  • Java 1.6 or later for Mulan 1.4 or later
Step 1

Open Eclipse and select Import > Git > Projects from Git. Select Next.

eclipse_step_1

Step 2

Select Clone URI and press Next.

eclipse_step_2

Step 3

In the URI field, enter the following link: https://git.code.sf.net/p/mulan/gitcode

In case you are a committer to the project, in order to commit, you have to check out with your credentials. This means completing your credentials in the relevant fields, under the Authentication category.

When you are finished, select Next.

eclipse_step_3

Step 4

Select the branches you want to clone (select master for latest changes) and the location you want the repository to be cloned to. Press Next.

eclipse_step_4

Step 5

Wait for the process to finish. (this may take a while)

eclipse_step_5

When completed, you will be asked what to do with the project. Select Import existing projects.

Click finish and you have your own copy of the Mulan repository.


Subversion (deprecated)

For a short period of time, we will also have Subversion available. Below are few examples.

Command line

Modern Linux distributions already come with Subversion either pre-installed or easily installed via the package manager of the distribution. If this is not the case, or if you are using Windows, you can download an appropriate client.

A checkout of the current developer version of Mulan looks like this:

svn checkout svn://svn.code.sf.net/p/mulan/code/trunk mulan-code

TortoiseSVN

TortoiseSVN is a neatly integrated SVN client for windows.

Eclipse

The example shown here uses Eclipse Juno to check out the most up-to-date version of Mulan. There is no need for any user credentials for accessing the SVN server since anonymous access is available. On the other hand you will need credentials if you intend to commit your code into the SVN repository.

Requirements:
  • An Eclipse IDE with suppot for SVN (you can use Subclipse or Subversive or any other plugin). This example uses Subversive.
  • Java 1.6 or later for Mulan 1.4 or later

Step 1:

  • Select Checkout Project from SVN
  • File -> New -> Project... -> SVN -> Project from SVN

Step 1

Step 2:

  • Create a new repository location using the following URL for the repository: https://svn.code.sf.net/p/mulan/code/trunk/mulan

Step 2

Step 3:

  • Select Head Revision and hit Finish.

Step 3

Step 4:

  • Select Check out as a project with the name specified and give a name.

Step 4

Step 5:

  • Click on Finish and wait for the SVN checkout to be completed.
  • After the checkout process has finished, you can use the newly created Mulan project
SourceForge.net Logo