Download the Dataset

There are two ways to work with the dataset: (1) downloading all the images via the LabelMe Matlab toolbox. The toolbox will allow you to customize the portion of the database that you want to download, (2) Using the images online via the LabelMe Matlab toolbox. This option is less preferred as it will be slower, but it will allow you to explore the dataset before downloading it. Once you have installed the database, you can use the LabelMe Matlab toolbox to read the annotation files and query the images to extract specific objects.

Option 1: Customizable download using the LabelMe Matlab toolbox

Before downloading the dataset, we only ask you to label some images using the annotation tool online. Any new labels that you will add, will be inmediately ready for download.

Step 1: Download the LabelMe Matlab toolbox and add the toolbox to the Matlab path.

Step 2: The function LMinstall will download the database. There are three ways to use this function:

  • To download the entire dataset, type the following into Matlab:
  • HOMEIMAGES = '/desired/path/to/Images';
    HOMEANNOTATIONS = '/desired/path/to/Annotations';
    LMinstall (HOMEIMAGES, HOMEANNOTATIONS);
    
    where "/desired/path/to/" is the desired location where the annotations and images will be stored.
    This process will create the following directory structure under "/desired/path/to/": ./Annotations ./Annotations/folder1 ... ./Annotations/folderN ./Images ./Images/folder1 ... ./Images/folderN where folder1 through folderN are directories containing the images and annotations.
  • If you only want to download a list of specific folders, then run:
  • HOMEIMAGES = '/desired/path/to/Images';
    HOMEANNOTATIONS = '/desired/path/to/Annotations';
    folderlist = {'05june05_static_street_porter'};
    LMinstall (folderlist, HOMEIMAGES, HOMEANNOTATIONS);
    This will download only one folder from the collection. You can see the complete list of folders here.
  • If you already have the dataset but want to update the annotations, then use LMinstall with four arguments:
  • LMinstall (folders, images, HOMEIMAGES, HOMEANNOTATIONS);

    Option 2: Access the online database directly with the LabelMe Matlab toolbox

    Before downloading the dataset, we only ask you to label some images using the annotation tool online. Any new labels that you will add, will be inmediately ready for download. If you use the LabelMe Matlab toolbox, it is not necesary to download the database. You can use the online images and annotations in the same way as if they were on your local hard drive. This might be slow, but it will let you explore the database before downloading it. If you plan to use the database extensively, it is better to download a local copy for yourself. Here are a few Matlab commands that show how to use the online database:

    HOMEIMAGES = 'http://people.csail.mit.edu/brussell/research/LabelMe/Images';
    HOMEANNOTATIONS = 'http://people.csail.mit.edu/brussell/research/LabelMe/Annotations';
    
    D = LMdatabase(HOMEANNOTATIONS); % This will build an index, which will take few minutes.
    
    % Now you can visualize the images
    LMplot(D, 1, HOMEIMAGES);
    
    % Or read an image
    [annotation, img] = LMread(D, 1, HOMEIMAGES);

    You can query the database to select the images you want and install only those ones. For instance, if you are interested only in images containing cars, you can run the following:

    % First create the list of images that you want:
    [Q,j] = LMquery(D, 'object.name', 'car');
    clear folderlist filelist
    for i = 1:length(Q);
          folderlist{i} = Q(i).annotation.folder;
          filelist{i} = Q(i).annotation.filename;
    end
    
    % Install the selected images:
    HOMEIMAGES = '/desired/path/to/Images';
    HOMEANNOTATIONS = '/desired/path/to/Annotations';
    LMinstall (folderlist, filelist, HOMEIMAGES, HOMEANNOTATIONS);