Write narrative documentation for out-of-core learning

[ogrisel]

• Update the out of core example to plot the behavior of Perceptron, PassiveAggressiveClassifier and MultinomialNB on the Reuters dataset.
• Write narrative documentation to explain the motivation, explain the partial_fit method usage in general and refer to the example in particular and give hints implementation constraints (stateless feature extraction, knowing all the classes ahead of time for classification).

Models to be linked to in this section:

For classification:

• Perceptron
• MultinomialNB
• BernoulliNB
• SGDClassifier
• PassiveAggressiveClassifier

For regression:

• SGDRegressor
• PassiveAggressiveRegressor

For out of core clustering / feature extraction:

• MinibatchKMeans

For out of core decomposition / feature extraction:

• MinibatchDictionaryLearning

[oddskool]

@ogrisel : do you think there is some way I can help you with this ?

[ogrisel]

@FedericoV has already started working on a refactoring of the example. If you want to start a PR specifically on the documentation part, please feel free to go ahead. Don't hesitate to issue an early [WIP] pull request to discuss the details on how to organize this section if you like.

[amueller]

this is tagged for the release. what is the status?

[FedericoV]

I was told someone else was working on the actual docs. The example is nearly done and just needs some very minor style changes.

On Saturday, July 27, 2013, Andreas Mueller wrote:

this is tagged for the release. what is the status?

— Reply to this email directly or view it on GitHubhttps://github.com/scikit-learn/scikit-learn/issues/2204#issuecomment-21665421 .

[amueller]

has someone written this yet?

[ogrisel]

Nope, AFAIK. Let's move that for 0.15.

[FedericoV]

I would have worked on it but I had understood that someone else was working on the narrative docs. Oh well, I'll try to write something up for 1.5 then.

On Mon, Jul 29, 2013 at 11:23 AM, Olivier Grisel notifications@github.comwrote:

Nope, AFAIK. Let's move that for 0.15.

— Reply to this email directly or view it on GitHubhttps://github.com/scikit-learn/scikit-learn/issues/2204#issuecomment-21708216 .

[ogrisel]

@oddskool @FedericoV if you want to work on this, please feel free to tell each other an open a WIP pull request early on to get each other's feedback.

[oddskool]

Yes, let's do that.

Here is a PR to discuss the strategy, track progress etc.

@FedericoV : I've added your account to the collaborators of my repo so you should be able to commit work to this PR directly.

I suggest we move further discussion to the PR page for now.

[ogrisel]

Fixed by #2321