sklearn.datasets.fetch_rcv1

sklearn.datasets.fetch_rcv1(*, data_home=None, subset='all', download_if_missing=True, random_state=None, shuffle=False, return_X_y=False)[source]

Load the RCV1 multilabel dataset (classification).

Download it if necessary.

Version: RCV1-v2, vectors, full sets, topics multilabels.

Classes

103

Samples total

804414

Dimensionality

47236

Features

real, between 0 and 1

Read more in the User Guide.

New in version 0.17.

Parameters
data_homestr, default=None

Specify another download and cache folder for the datasets. By default all scikit-learn data is stored in ‘~/scikit_learn_data’ subfolders.

subset{‘train’, ‘test’, ‘all’}, default=’all’

Select the dataset to load: ‘train’ for the training set (23149 samples), ‘test’ for the test set (781265 samples), ‘all’ for both, with the training samples first if shuffle is False. This follows the official LYRL2004 chronological split.

download_if_missingbool, default=True

If False, raise a IOError if the data is not locally available instead of trying to download the data from the source site.

random_stateint, RandomState instance or None, default=None

Determines random number generation for dataset shuffling. Pass an int for reproducible output across multiple function calls. See Glossary.

shufflebool, default=False

Whether to shuffle dataset.

return_X_ybool, default=False

If True, returns (dataset.data, dataset.target) instead of a Bunch object. See below for more information about the dataset.data and dataset.target object.

New in version 0.20.

Returns
datasetBunch

Dictionary-like object. Returned only if return_X_y is False. dataset has the following attributes:

  • datasparse matrix of shape (804414, 47236), dtype=np.float64

    The array has 0.16% of non zero values. Will be of CSR format.

  • targetsparse matrix of shape (804414, 103), dtype=np.uint8

    Each sample has a value of 1 in its categories, and 0 in others. The array has 3.15% of non zero values. Will be of CSR format.

  • sample_idndarray of shape (804414,), dtype=np.uint32,

    Identification number of each sample, as ordered in dataset.data.

  • target_namesndarray of shape (103,), dtype=object

    Names of each target (RCV1 topics), as ordered in dataset.target.

  • DESCRstr

    Description of the RCV1 dataset.

(data, target)tuple

A tuple consisting of dataset.data and dataset.target, as described above. Returned only if return_X_y is True.

New in version 0.20.