-
Notifications
You must be signed in to change notification settings - Fork 12
/
0.6.0.html
561 lines (523 loc) · 65.4 KB
/
0.6.0.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta property="og:title" content="0.6.0" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://nilearn.github.io/changes/0.6.0.html" />
<meta property="og:site_name" content="Nilearn" />
<meta property="og:description" content="Released December 2019 HIGHLIGHTS: NEW: New method for NiftiMasker instances for generating reports viewable in a web browser, Jupyter Notebook, or VSCode (#2019 by Elizabeth DuPre)., New function ..." />
<meta property="og:image" content="https://nilearn.github.io/_static/nilearn-logo.png" />
<meta property="og:image:alt" content="Nilearn" />
<title>Nilearn: Statistical Analysis for NeuroImaging in Python — Machine learning for NeuroImaging</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="../_static/nature.css" />
<link rel="stylesheet" type="text/css" href="../_static/copybutton.css" />
<link rel="stylesheet" type="text/css" href="../_static/sg_gallery.css" />
<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-binder.css" />
<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-dataframe.css" />
<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-rendered-html.css" />
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/clipboard.min.js"></script>
<script src="../_static/copybutton.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="search" title="Search" href="../search.html" />
<meta content="True" name="HandheldFriendly">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0">
<meta name="keywords" content="nilearn, neuroimaging, python, neuroscience, machinelearning">
<script type="text/javascript">
function updateTopMenuPosition(height, width) {
if($(window).scrollTop() > height && $(window).outerWidth() > 1024) {
//begin to scroll
$('.related-wrapper').css("z-index", 1000);
$('.related-wrapper').css("position", "sticky");
$('.related-wrapper').css("top", 0);
$('.related-wrapper').css("width", width)
} else {
//lock it back into place
$('.related-wrapper').css("position", "relative");
$('.related-wrapper').css("top", 0)
}
}
$(function() {
var banner_height = $('#logo-banner').outerHeight();
var banner_width = $('#logo-banner').outerWidth();
var width = $('.related-wrapper').css("height", $('.related').outerHeight());
updateTopMenuPosition(banner_height, width);
$(window).scroll(function(event) {
updateTopMenuPosition(banner_height, width)
});
$(window).resize(function(event) {
var banner_width = $('#logo-banner').outerWidth();
var menu_height = $('.related').outerHeight();
$('.related').css("width", banner_width);
$('.related-wrapper').css("height", menu_height);
updateTopMenuPosition(banner_height, width)
})
});
</script>
<script type="text/javascript">
function updateSideBarPosition(top, offset, sections) {
var pos = $(window).scrollTop();
// Lock the table of content to a fixed position once we scroll enough
var topShift = 2 * offset;
if(pos > top + topShift + 1) {
// begin to scroll with sticky menu bar
var topShift = -topShift + 1;
if ($(window).outerWidth() < 1024) {
// compensate top menu that disappears
topShift -= offset + 1
}
$('.sphinxsidebarwrapper').css("position", "fixed");
$('.sphinxsidebarwrapper').css("top", topShift)
}
else {
//lock it back into place
$('.sphinxsidebarwrapper').css("position", "relative");
$('.sphinxsidebarwrapper').css("top",0)
}
// Highlight the current section
i = 0;
current_section = 0;
$('a.internal').removeClass('active');
for(i in sections) {
if(sections[i] > pos) {
break
}
if($('a.internal[href$="' + i + '"]').is(':visible')){
current_section = i
}
}
$('a.internal[href$="' + current_section + '"]').addClass('active');
$('a.internal[href$="' + current_section + '"]').parent().addClass('active')
}
$(function () {
// Lock the table of content to a fixed position once we scroll enough
var tocOffset = $('.related-wrapper').outerHeight();
var marginTop = parseFloat($('.sphinxsidebarwrapper').css('margin-top').replace(/auto/, 0));
var top = $('.sphinxsidebarwrapper').offset().top - marginTop;
sections = {};
url = document.URL.replace(/#.*$/, "");
// Grab positions of our sections
$('.headerlink').each(function(){
sections[this.href.replace(url, '')] = $(this).offset().top - 50
});
updateSideBarPosition(top, tocOffset, sections);
$(window).scroll(function(event) {
updateSideBarPosition(top, tocOffset, sections)
});
$(window).resize(function(event) {
tocOffset = $('.related-wrapper').outerHeight();
updateSideBarPosition(top, tocOffset, sections)
});
});
</script>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-41920728-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head><body>
<div id="logo-banner">
<div class="logo">
<a href="../index.html">
<img src="../_static/nilearn-logo.png" alt="Nilearn logo" border="0" />
</a>
</div>
<!-- A tag cloud to make it easy for people to find what they are
looking for -->
<div class="tags">
<ul>
<li>
<big><a href="../auto_examples/decoding/plot_haxby_anova_svm.html">SVM</a></big>
</li>
<li>
<small><a href="../connectivity/parcellating.html">Ward
clustering</a></small>
</li>
<li>
<a href="../decoding/searchlight.html">Searchlight</a>
</li>
<li>
<big><a href="../connectivity/resting_state_networks.html">ICA</a></big>
</li>
<li>
<a href="../manipulating_images/data_preparation.html">Nifti IO</a>
</li>
<li>
<a href="../modules/reference.html#module-nilearn.datasets">Datasets</a>
</li>
</ul>
</div>
<div class="banner">
<h1>Nilearn:</h1>
<h2>Statistics for NeuroImaging in Python</h2>
</div>
<div class="search_form">
<div class="gcse-search" id="cse" style="width: 100%;"></div>
<script>
(function() {
var cx = '017289614950330089114:elrt9qoutrq';
var gcse = document.createElement('script');
gcse.type = 'text/javascript';
gcse.async = true;
gcse.src = 'https://cse.google.com/cse.js?cx=' + cx;
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(gcse, s);
})();
</script>
</div>
</div>
<div class=related-wrapper>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../py-modindex.html" title="Python Module Index"
>modules</a></li>
<li><a href="../index.html">Nilearn Home</a> | </li>
<li><a href="../user_guide.html">User Guide</a> | </li>
<li><a href="../auto_examples/index.html">Examples</a> | </li>
<li><a href="../modules/reference.html">Reference</a> | </li>
<li id="navbar-about"><a href="../authors.html">About</a>| </li>
<li><a href="../glossary.html">Glossary</a>| </li>
<li><a href="../bibliography.html">Bibliography</a>| </li>
<li id="navbar-ecosystem"><a href="http://www.nipy.org/">Nipy ecosystem</a></li>
<li class="nav-item nav-item-this"><a href="">Nilearn: Statistical Analysis for NeuroImaging in Python</a></li>
</ul>
</div>
</div>
<div class="stable-banner">
This is the <em>stable</em> documentation for the latest release of Nilearn,
the current development version is available <a href="https://nilearn.github.io/dev/index.html">here</a>.
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="id1">
<h1>0.6.0<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
<p><strong>Released December 2019</strong></p>
<div class="section" id="highlights">
<h2>HIGHLIGHTS<a class="headerlink" href="#highlights" title="Permalink to this headline">¶</a></h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<div class="line-block">
<div class="line"><strong>Python2 and 3.4 are no longer supported. We recommend upgrading to Python 3.6 minimum.</strong> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2214">#2214</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</div>
<div class="line"><br /></div>
<div class="line"><strong>Support for Python3.5 will be removed in the 0.7.x release.</strong></div>
<div class="line">Users with a Python <code class="docutils literal notranslate"><span class="pre">3.5</span></code> environment will be warned at their first Nilearn import.</div>
<div class="line"><br /></div>
<div class="line"><strong>joblib is now a dependency</strong></div>
<div class="line"><br /></div>
<div class="line"><strong>Minimum supported versions of packages have been bumped up.</strong></div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Matplotlib</span> <span class="pre">--</span> <span class="pre">v2.0</span></code>.</div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Scikit-learn</span> <span class="pre">--</span> <span class="pre">v0.19</span></code>.</div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Scipy</span> <span class="pre">--</span> <span class="pre">v0.19</span></code>.</div>
</div>
</div>
</div>
<div class="section" id="new">
<h2>NEW<a class="headerlink" href="#new" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>New method for <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiMasker.html#nilearn.maskers.NiftiMasker" title="nilearn.maskers.NiftiMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiMasker</span></code></a> instances for generating reports viewable in a web browser, Jupyter Notebook, or VSCode (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2019">#2019</a> by <a class="reference external" href="https://elizabeth-dupre.com/#/">Elizabeth DuPre</a>).</p></li>
<li><p>New function <a class="reference internal" href="../modules/generated/nilearn.image.get_data.html#nilearn.image.get_data" title="nilearn.image.get_data"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_data</span></code></a> to replace the deprecated nibabel method <code class="docutils literal notranslate"><span class="pre">Nifti1Image.get_data</span></code>. Now use <code class="docutils literal notranslate"><span class="pre">nilearn.image.get_data(img)</span></code> rather than <code class="docutils literal notranslate"><span class="pre">img.get_data()</span></code>. This is because Nibabel is removing the <code class="docutils literal notranslate"><span class="pre">get_data</span></code> method. You may also consider using the Nibabel method <code class="docutils literal notranslate"><span class="pre">nibabel.nifti1.Nifti1Image.get_fdata</span></code>, which returns the data cast to floating-point. See <a class="reference external" href="https://github.com/nipy/nibabel/wiki/BIAP8">BIAP8</a>. As a benefit, the <a class="reference internal" href="../modules/generated/nilearn.image.get_data.html#nilearn.image.get_data" title="nilearn.image.get_data"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_data</span></code></a> function works on niimg-like objects such as filenames (see <a class="reference external" href="http://nilearn.github.io/manipulating_images/input_output.html">input_output</a>) (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2172">#2172</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>New class <a class="reference internal" href="../modules/generated/nilearn.regions.ReNA.html#nilearn.regions.ReNA" title="nilearn.regions.ReNA"><code class="xref py py-class docutils literal notranslate"><span class="pre">ReNA</span></code></a> implementing parcellation method <a class="reference internal" href="../glossary.html#term-ReNA"><span class="xref std std-term">ReNA</span></a>: Fast agglomerative clustering based on recursive nearest neighbor grouping. Yields very fast & accurate models, without creation of giant clusters (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1336">#1336</a> by <a class="reference external" href="https://github.com/ahoyosid">Andrés Hoyos Idrobo</a>).</p></li>
<li><p>New function <code class="docutils literal notranslate"><span class="pre">nilearn.plotting.plot_connectome_strength</span></code> to plot the strength of a connectome on a glass brain. Strength is absolute sum of the edges at a node (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2028">#2028</a> by <a class="reference external" href="https://glemaitre.github.io/">Guillaume Lemaitre</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.image.resample_img.html#nilearn.image.resample_img" title="nilearn.image.resample_img"><code class="xref py py-func docutils literal notranslate"><span class="pre">resample_img</span></code></a> has been optimized to pad rather than resample images in the special case when there is only a translation between two spaces. This is a common case in class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiMasker.html#nilearn.maskers.NiftiMasker" title="nilearn.maskers.NiftiMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiMasker</span></code></a> when using the <code class="docutils literal notranslate"><span class="pre">mask_strategy="template"</span></code> option for brains in <a class="reference internal" href="../glossary.html#term-MNI"><span class="xref std std-term">MNI</span></a> space (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2025">#2025</a> by <a class="reference external" href="https://gkiar.me/">Greg Kiar</a>).</p></li>
<li><p>New brain development <a class="reference internal" href="../glossary.html#term-fMRI"><span class="xref std std-term">fMRI</span></a> dataset fetcher <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_development_fmri.html#nilearn.datasets.fetch_development_fmri" title="nilearn.datasets.fetch_development_fmri"><code class="xref py py-func docutils literal notranslate"><span class="pre">datasets.fetch_development_fmri</span></code></a> can be used to download movie-watching data in children and adults. A light-weight dataset implemented for teaching and usage in the examples. All the connectivity examples are changed from ADHD to brain development <a class="reference internal" href="../glossary.html#term-fMRI"><span class="xref std std-term">fMRI</span></a> dataset (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1953">#1953</a> by <a class="reference external" href="https://github.com/KamalakerDadi">Kamalakar Reddy Daddy</a>).</p></li>
</ul>
</div>
<div class="section" id="enhancements">
<h2>ENHANCEMENTS<a class="headerlink" href="#enhancements" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Functions <a class="reference internal" href="../modules/generated/nilearn.plotting.view_img_on_surf.html#nilearn.plotting.view_img_on_surf" title="nilearn.plotting.view_img_on_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_img_on_surf</span></code></a>, <a class="reference internal" href="../modules/generated/nilearn.plotting.view_surf.html#nilearn.plotting.view_surf" title="nilearn.plotting.view_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_surf</span></code></a> and <a class="reference internal" href="../modules/generated/nilearn.plotting.view_connectome.html#nilearn.plotting.view_connectome" title="nilearn.plotting.view_connectome"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_connectome</span></code></a> can display a title, and allow disabling the colorbar, and setting its height and the fontsize of its ticklabels (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1951">#1951</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Rework of the standardize-options of function <a class="reference internal" href="../modules/generated/nilearn.signal.clean.html#nilearn.signal.clean" title="nilearn.signal.clean"><code class="xref py py-func docutils literal notranslate"><span class="pre">clean</span></code></a> and the various Maskers in <a class="reference internal" href="../modules/reference.html#module-nilearn.maskers" title="nilearn.maskers"><code class="xref py py-mod docutils literal notranslate"><span class="pre">nilearn.maskers</span></code></a>. You can now set <code class="docutils literal notranslate"><span class="pre">standardize</span></code> to <code class="docutils literal notranslate"><span class="pre">zscore</span></code> or <code class="docutils literal notranslate"><span class="pre">psc</span></code>. <code class="docutils literal notranslate"><span class="pre">psc</span></code> stands for <code class="docutils literal notranslate"><span class="pre">Percent</span> <span class="pre">Signal</span> <span class="pre">Change</span></code>, which can be a meaningful metric for <a class="reference internal" href="../glossary.html#term-BOLD"><span class="xref std std-term">BOLD</span></a> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1952">#1952</a> by <a class="reference external" href="https://github.com/Gilles86">Gilles de Hollander</a>).</p></li>
<li><p>Class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiLabelsMasker.html#nilearn.maskers.NiftiLabelsMasker" title="nilearn.maskers.NiftiLabelsMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiLabelsMasker</span></code></a> now accepts an optional <code class="docutils literal notranslate"><span class="pre">strategy</span></code> parameter which allows it to change the function used to reduce values within each labelled ROI. Available functions include <code class="docutils literal notranslate"><span class="pre">mean</span></code>, <code class="docutils literal notranslate"><span class="pre">median</span></code>, <code class="docutils literal notranslate"><span class="pre">minimum</span></code>, <code class="docutils literal notranslate"><span class="pre">maximum</span></code>, <code class="docutils literal notranslate"><span class="pre">standard_deviation</span></code> and <code class="docutils literal notranslate"><span class="pre">variance</span></code>. This change is also introduced in function <a class="reference internal" href="../modules/generated/nilearn.regions.img_to_signals_labels.html#nilearn.regions.img_to_signals_labels" title="nilearn.regions.img_to_signals_labels"><code class="xref py py-func docutils literal notranslate"><span class="pre">img_to_signals_labels</span></code></a> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2221">#2221</a> by <a class="reference external" href="https://github.com/dangom">Daniel Gomez</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.view_surf.html#nilearn.plotting.view_surf" title="nilearn.plotting.view_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_surf</span></code></a> now accepts surface data provided as a file path (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2057">#2057</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
</ul>
</div>
<div class="section" id="changes">
<h2>CHANGES<a class="headerlink" href="#changes" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_img.html#nilearn.plotting.plot_img" title="nilearn.plotting.plot_img"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_img</span></code></a> now has explicit keyword arguments <code class="docutils literal notranslate"><span class="pre">bg_img</span></code>, <code class="docutils literal notranslate"><span class="pre">vmin</span></code> and <code class="docutils literal notranslate"><span class="pre">vmax</span></code> to control the background image and the bounds of the colormap. These arguments were already accepted in <code class="docutils literal notranslate"><span class="pre">kwargs</span></code> but not documented before (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2157">#2157</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
</ul>
</div>
<div class="section" id="fixes">
<h2>FIXES<a class="headerlink" href="#fixes" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiLabelsMasker.html#nilearn.maskers.NiftiLabelsMasker" title="nilearn.maskers.NiftiLabelsMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiLabelsMasker</span></code></a> no longer truncates region means to their integral part when input images are of integer type (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2195">#2195</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>The argument <code class="docutils literal notranslate"><span class="pre">version='det'</span></code> in function <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_atlas_pauli_2017.html#nilearn.datasets.fetch_atlas_pauli_2017" title="nilearn.datasets.fetch_atlas_pauli_2017"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_atlas_pauli_2017</span></code></a> now works as expected (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2235">#2235</a> by <a class="reference external" href="https://github.com/ryanhammonds">Ryan Hammonds</a>).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">nilearn</span></code> now installs the necessary dependencies (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2214">#2214</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
</ul>
<p><strong>Lots of other fixes in documentation and examples.</strong> More detailed change list follows:</p>
</div>
</div>
<div class="section" id="rc">
<h1>0.6.0rc<a class="headerlink" href="#rc" title="Permalink to this headline">¶</a></h1>
<div class="section" id="id2">
<h2>NEW<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<ul class="simple">
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.view_connectome.html#nilearn.plotting.view_connectome" title="nilearn.plotting.view_connectome"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_connectome</span></code></a> no longer accepts old parameter names. Instead of <code class="docutils literal notranslate"><span class="pre">coords</span></code>, <code class="docutils literal notranslate"><span class="pre">threshold</span></code>, <code class="docutils literal notranslate"><span class="pre">cmap</span></code>, and <code class="docutils literal notranslate"><span class="pre">marker_size</span></code>, use <code class="docutils literal notranslate"><span class="pre">node_coords</span></code>, <code class="docutils literal notranslate"><span class="pre">edge_threshold</span></code>, <code class="docutils literal notranslate"><span class="pre">edge_cmap</span></code>, and <code class="docutils literal notranslate"><span class="pre">node_size</span></code> respectively (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2255">#2255</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.view_markers.html#nilearn.plotting.view_markers" title="nilearn.plotting.view_markers"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_markers</span></code></a> no longer accepts old parameter names. Instead of <code class="docutils literal notranslate"><span class="pre">coord</span></code> and <code class="docutils literal notranslate"><span class="pre">color</span></code>, use <code class="docutils literal notranslate"><span class="pre">marker_coords</span></code> and <code class="docutils literal notranslate"><span class="pre">marker_color</span></code> respectively (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2255">#2255</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p><strong>Support for Python3.5 will be removed in the 0.7.x release.</strong> Users with a Python3.5 environment will be warned at their first Nilearn import (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2214">#2214</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
</ul>
</div>
</div>
<div class="section" id="id3">
<h2>Changes<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Add a warning to <a class="reference internal" href="../modules/generated/nilearn.regions.Parcellations.html#nilearn.regions.Parcellations" title="nilearn.regions.Parcellations"><code class="xref py py-class docutils literal notranslate"><span class="pre">Parcellations</span></code></a> if the generated number of parcels does not match the requested number of parcels (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2240">#2240</a> by <a class="reference external" href="https://elizabeth-dupre.com/#/">Elizabeth DuPre</a>).</p></li>
<li><p>Class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiLabelsMasker.html#nilearn.maskers.NiftiLabelsMasker" title="nilearn.maskers.NiftiLabelsMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiLabelsMasker</span></code></a> now accepts an optional <code class="docutils literal notranslate"><span class="pre">strategy</span></code> parameter which allows it to change the function used to reduce values within each labelled ROI. Available functions include <code class="docutils literal notranslate"><span class="pre">mean</span></code>, <code class="docutils literal notranslate"><span class="pre">median</span></code>, <code class="docutils literal notranslate"><span class="pre">minimum</span></code>, <code class="docutils literal notranslate"><span class="pre">maximum</span></code>, <code class="docutils literal notranslate"><span class="pre">standard_deviation</span></code> and <code class="docutils literal notranslate"><span class="pre">variance</span></code>. This change is also introduced in function <a class="reference internal" href="../modules/generated/nilearn.regions.img_to_signals_labels.html#nilearn.regions.img_to_signals_labels" title="nilearn.regions.img_to_signals_labels"><code class="xref py py-func docutils literal notranslate"><span class="pre">img_to_signals_labels</span></code></a> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2221">#2221</a> by <a class="reference external" href="https://github.com/dangom">Daniel Gomez</a>).</p></li>
</ul>
</div>
<div class="section" id="id4">
<h2>Fixes<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiLabelsMasker.html#nilearn.maskers.NiftiLabelsMasker" title="nilearn.maskers.NiftiLabelsMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiLabelsMasker</span></code></a> no longer truncates region means to their integral part when input images are of integer type (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2195">#2195</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.image.smooth_img.html#nilearn.image.smooth_img" title="nilearn.image.smooth_img"><code class="xref py py-func docutils literal notranslate"><span class="pre">smooth_img</span></code></a> no longer fails if <code class="docutils literal notranslate"><span class="pre">fwhm</span></code> is a <a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="(in NumPy v1.22)"><code class="xref py py-class docutils literal notranslate"><span class="pre">numpy.ndarray</span></code></a> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2107">#2107</a> by <a class="reference external" href="https://github.com/pausz">Paula Sanz-Leon</a>).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">nilearn</span></code> now installs the necessary dependencies (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2214">#2214</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.image.new_img_like.html#nilearn.image.new_img_like" title="nilearn.image.new_img_like"><code class="xref py py-func docutils literal notranslate"><span class="pre">new_img_like</span></code></a> no longer attempts to copy non-iterable headers (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2212">#2212</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>Nilearn no longer raises <code class="docutils literal notranslate"><span class="pre">ImportError</span></code> for nose when Matplotlib is not installed (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2231">#2231</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
<li><p>The argument <code class="docutils literal notranslate"><span class="pre">version='det'</span></code> in function <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_atlas_pauli_2017.html#nilearn.datasets.fetch_atlas_pauli_2017" title="nilearn.datasets.fetch_atlas_pauli_2017"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_atlas_pauli_2017</span></code></a> now works as expected (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2235">#2235</a> by <a class="reference external" href="https://github.com/ryanhammonds">Ryan Hammonds</a>).</p></li>
<li><p>Method <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiLabelsMasker.html#nilearn.maskers.NiftiLabelsMasker.inverse_transform" title="nilearn.maskers.NiftiLabelsMasker.inverse_transform"><code class="xref py py-meth docutils literal notranslate"><span class="pre">inverse_transform</span></code></a> now works without the need to call <code class="docutils literal notranslate"><span class="pre">transform</span></code> first (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2248">#2248</a> by <a class="reference external" href="http://gael-varoquaux.info/">Gael Varoquaux</a>).</p></li>
</ul>
</div>
<div class="section" id="contributors">
<h2>Contributors<a class="headerlink" href="#contributors" title="Permalink to this headline">¶</a></h2>
<p>The following people contributed to this release (in alphabetical order):</p>
<blockquote>
<div><ul class="simple">
<li><p><a class="reference external" href="https://github.com/effigies">Chris Markiewicz</a></p></li>
<li><p><a class="reference external" href="https://danjgale.github.io/">Dan Gale</a></p></li>
<li><p><a class="reference external" href="https://github.com/dangom">Daniel Gomez</a></p></li>
<li><p><a class="reference external" href="https://github.com/dPys">Derek Pisner</a></p></li>
<li><p><a class="reference external" href="https://elizabeth-dupre.com/#/">Elizabeth DuPre</a></p></li>
<li><p><a class="reference external" href="https://larsoner.com/">Eric Larson</a></p></li>
<li><p><a class="reference external" href="http://gael-varoquaux.info/">Gael Varoquaux</a></p></li>
<li><p><a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a></p></li>
<li><p><a class="reference external" href="https://github.com/JohannesWiesner">Johannes Wiesner</a></p></li>
<li><p><a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a></p></li>
<li><p><a class="reference external" href="https://github.com/pausz">Paula Sanz-Leon</a></p></li>
<li><p><a class="reference external" href="https://ltetrel.github.io/">Loic Tetrel</a></p></li>
<li><p><a class="reference external" href="https://github.com/ryanhammonds">Ryan Hammonds</a></p></li>
</ul>
</div></blockquote>
</div>
</div>
<div class="section" id="b0">
<h1>0.6.0b0<a class="headerlink" href="#b0" title="Permalink to this headline">¶</a></h1>
<p><strong>Released November 2019</strong></p>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<div class="line-block">
<div class="line"><strong>Python2 and 3.4 are no longer supported. Pip will raise an error in these environments.</strong></div>
<div class="line"><strong>Minimum supported version of Python is now 3.5 .</strong></div>
<div class="line"><strong>We recommend upgrading to Python 3.6 .</strong></div>
</div>
</div>
<div class="section" id="id5">
<h2>NEW<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>New function <a class="reference internal" href="../modules/generated/nilearn.image.get_data.html#nilearn.image.get_data" title="nilearn.image.get_data"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_data</span></code></a> to replace the deprecated nibabel method <code class="docutils literal notranslate"><span class="pre">Nifti1Image.get_data</span></code>. Now use <code class="docutils literal notranslate"><span class="pre">nilearn.image.get_data(img)</span></code> rather than <code class="docutils literal notranslate"><span class="pre">img.get_data()</span></code>. This is because Nibabel is removing the <code class="docutils literal notranslate"><span class="pre">get_data</span></code> method. You may also consider using the Nibabel method <code class="docutils literal notranslate"><span class="pre">nibabel.nifti1.Nifti1Image.get_fdata</span></code>, which returns the data cast to floating-point. See <a class="reference external" href="https://github.com/nipy/nibabel/wiki/BIAP8">BIAP8</a>. As a benefit, the <a class="reference internal" href="../modules/generated/nilearn.image.get_data.html#nilearn.image.get_data" title="nilearn.image.get_data"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_data</span></code></a> function works on niimg-like objects such as filenames (see <a class="reference external" href="http://nilearn.github.io/manipulating_images/input_output.html">input_output</a>) (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2172">#2172</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
</ul>
</div>
<div class="section" id="id8">
<h2>Changes<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>All functions and examples now use function <a class="reference internal" href="../modules/generated/nilearn.image.get_data.html#nilearn.image.get_data" title="nilearn.image.get_data"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_data</span></code></a> rather than the deprecated method <code class="docutils literal notranslate"><span class="pre">nibabel.Nifti1Image.get_data</span></code> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2172">#2172</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_neurovault.html#nilearn.datasets.fetch_neurovault" title="nilearn.datasets.fetch_neurovault"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_neurovault</span></code></a> now does not filter out images that have their metadata field <code class="docutils literal notranslate"><span class="pre">is_valid</span></code> cleared by default (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2169">#2169</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Users can now specify fetching data for adults, children, or both from <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_development_fmri.html#nilearn.datasets.fetch_development_fmri" title="nilearn.datasets.fetch_development_fmri"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_development_fmri</span></code></a>.</p></li>
</ul>
</div>
<div class="section" id="id9">
<h2>Fixes<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_connectome.html#nilearn.plotting.plot_connectome" title="nilearn.plotting.plot_connectome"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_connectome</span></code></a> now correctly displays marker size on ‘l’ and ‘r’ orientations, if an array or a list is passed to the function.</p></li>
</ul>
</div>
<div class="section" id="id10">
<h2>Contributors<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h2>
<p>The following people contributed to this release (in alphabetical order):</p>
<blockquote>
<div><ul class="simple">
<li><p><a class="reference external" href="https://github.com/illdopejake">Jake Vogel</a></p></li>
<li><p><a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a></p></li>
<li><p><a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a></p></li>
<li><p><a class="reference external" href="https://github.com/robbisg">Roberto Guidotti</a></p></li>
</ul>
</div></blockquote>
</div>
</div>
<div class="section" id="a0">
<h1>0.6.0a0<a class="headerlink" href="#a0" title="Permalink to this headline">¶</a></h1>
<p><strong>Released October 2019</strong></p>
<div class="section" id="id11">
<h2>NEW<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<div class="line-block">
<div class="line"><strong>Python2 and 3.4 are no longer supported. We recommend upgrading to Python 3.6 minimum.</strong></div>
<div class="line"><br /></div>
<div class="line"><strong>Minimum supported versions of packages have been bumped up.</strong></div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Matplotlib</span> <span class="pre">--</span> <span class="pre">v2.0</span></code>.</div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Scikit-learn</span> <span class="pre">--</span> <span class="pre">v0.19</span></code>.</div>
<div class="line">- <code class="docutils literal notranslate"><span class="pre">Scipy</span> <span class="pre">--</span> <span class="pre">v0.19</span></code>.</div>
</div>
</div>
<ul class="simple">
<li><p>A new method for <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiMasker.html#nilearn.maskers.NiftiMasker" title="nilearn.maskers.NiftiMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiMasker</span></code></a> instances for generating reports viewable in a web browser, Jupyter Notebook, or VSCode (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2019">#2019</a> by <a class="reference external" href="https://elizabeth-dupre.com/#/">Elizabeth DuPre</a>).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">joblib</span></code> is now a dependency (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2090">#2090</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>New class <a class="reference internal" href="../modules/generated/nilearn.regions.ReNA.html#nilearn.regions.ReNA" title="nilearn.regions.ReNA"><code class="xref py py-class docutils literal notranslate"><span class="pre">ReNA</span></code></a> implementing parcellation method <a class="reference internal" href="../glossary.html#term-ReNA"><span class="xref std std-term">ReNA</span></a>: Fast agglomerative clustering based on recursive nearest neighbor grouping. Yields very fast & accurate models, without creation of giant clusters (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1336">#1336</a> by <a class="reference external" href="https://github.com/ahoyosid">Andrés Hoyos Idrobo</a>).</p></li>
<li><p>New function <code class="docutils literal notranslate"><span class="pre">nilearn.plotting.plot_connectome_strength</span></code> to plot the strength of a connectome on a glass brain. Strength is absolute sum of the edges at a node (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2028">#2028</a> by <a class="reference external" href="https://glemaitre.github.io/">Guillaume Lemaitre</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.image.resample_img.html#nilearn.image.resample_img" title="nilearn.image.resample_img"><code class="xref py py-func docutils literal notranslate"><span class="pre">resample_img</span></code></a> has been optimized to pad rather than resample images in the special case when there is only a translation between two spaces. This is a common case in class <a class="reference internal" href="../modules/generated/nilearn.maskers.NiftiMasker.html#nilearn.maskers.NiftiMasker" title="nilearn.maskers.NiftiMasker"><code class="xref py py-class docutils literal notranslate"><span class="pre">NiftiMasker</span></code></a> when using the <code class="docutils literal notranslate"><span class="pre">mask_strategy="template"</span></code> option for brains in <a class="reference internal" href="../glossary.html#term-MNI"><span class="xref std std-term">MNI</span></a> space (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2025">#2025</a> by <a class="reference external" href="https://gkiar.me/">Greg Kiar</a>).</p></li>
<li><p>New brain development <a class="reference internal" href="../glossary.html#term-fMRI"><span class="xref std std-term">fMRI</span></a> dataset fetcher <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_development_fmri.html#nilearn.datasets.fetch_development_fmri" title="nilearn.datasets.fetch_development_fmri"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_development_fmri</span></code></a> can be used to download movie-watching data in children and adults; a light-weight dataset implemented for teaching and usage in the examples.</p></li>
<li><p>New example in <code class="docutils literal notranslate"><span class="pre">examples/05_advanced/plot_age_group_prediction_cross_val.py</span></code> to compare methods for classifying subjects into age groups based on functional connectivity. Similar example in <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_group_level_connectivity.py</span></code> simplified (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2063">#2063</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Merged <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_adhd_spheres.py</span></code> and <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_sphere_based_connectome.py</span></code> to remove duplication across examples. The improved <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_sphere_based_connectome.py</span></code> contains concepts previously reviewed in both examples (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2013">#2013</a> by <a class="reference external" href="https://github.com/illdopejake">Jake Vogel</a>).</p></li>
<li><p>Merged <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_compare_decomposition.py</span></code> and <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_canica_analysis.py</span></code> into an improved <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_compare_decomposition.py</span></code> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2013">#2013</a> by <a class="reference external" href="https://github.com/illdopejake">Jake Vogel</a>).</p></li>
<li><p>The Localizer dataset now follows the <a class="reference internal" href="../glossary.html#term-BIDS"><span class="xref std std-term">BIDS</span></a> organization.</p></li>
</ul>
</div>
<div class="section" id="id12">
<h2>Changes<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>All the connectivity examples are changed from ADHD to brain development <a class="reference internal" href="../glossary.html#term-fMRI"><span class="xref std std-term">fMRI</span></a> dataset.</p></li>
<li><p>Examples <code class="docutils literal notranslate"><span class="pre">plot_decoding_tutorial</span></code>, <code class="docutils literal notranslate"><span class="pre">plot_haxby_decoder</span></code>, <code class="docutils literal notranslate"><span class="pre">plot_haxby_different_estimators</span></code>, <code class="docutils literal notranslate"><span class="pre">plot_haxby_full_analysis</span></code>, <code class="docutils literal notranslate"><span class="pre">plot_oasis_vbm</span></code> now use <a class="reference internal" href="../modules/generated/nilearn.decoding.Decoder.html#nilearn.decoding.Decoder" title="nilearn.decoding.Decoder"><code class="xref py py-class docutils literal notranslate"><span class="pre">Decoder</span></code></a> and <a class="reference internal" href="../modules/generated/nilearn.decoding.DecoderRegressor.html#nilearn.decoding.DecoderRegressor" title="nilearn.decoding.DecoderRegressor"><code class="xref py py-class docutils literal notranslate"><span class="pre">DecoderRegressor</span></code></a> instead of sklearn SVC and SVR (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2000">#2000</a> by <a class="reference external" href="https://www.imo.universite-paris-saclay.fr/~tbnguyen/">Binh Nguyen</a>).</p></li>
<li><p>Functions <a class="reference internal" href="../modules/generated/nilearn.plotting.view_img_on_surf.html#nilearn.plotting.view_img_on_surf" title="nilearn.plotting.view_img_on_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_img_on_surf</span></code></a>, <a class="reference internal" href="../modules/generated/nilearn.plotting.view_surf.html#nilearn.plotting.view_surf" title="nilearn.plotting.view_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_surf</span></code></a> and <a class="reference internal" href="../modules/generated/nilearn.plotting.view_connectome.html#nilearn.plotting.view_connectome" title="nilearn.plotting.view_connectome"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_connectome</span></code></a> can display a title, and allow disabling the colorbar, and setting its height and the fontsize of its ticklabels (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1951">#1951</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Rework of the standardize-options of function <a class="reference internal" href="../modules/generated/nilearn.signal.clean.html#nilearn.signal.clean" title="nilearn.signal.clean"><code class="xref py py-func docutils literal notranslate"><span class="pre">clean</span></code></a> and the various Maskers in <a class="reference internal" href="../modules/reference.html#module-nilearn.maskers" title="nilearn.maskers"><code class="xref py py-mod docutils literal notranslate"><span class="pre">nilearn.maskers</span></code></a>. You can now set <code class="docutils literal notranslate"><span class="pre">standardize</span></code> to <code class="docutils literal notranslate"><span class="pre">zscore</span></code> or <code class="docutils literal notranslate"><span class="pre">psc</span></code>. <code class="docutils literal notranslate"><span class="pre">psc</span></code> stands for <code class="docutils literal notranslate"><span class="pre">Percent</span> <span class="pre">Signal</span> <span class="pre">Change</span></code>, which can be a meaningful metric for <a class="reference internal" href="../glossary.html#term-BOLD"><span class="xref std std-term">BOLD</span></a> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1952">#1952</a> by <a class="reference external" href="https://github.com/Gilles86">Gilles de Hollander</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_img.html#nilearn.plotting.plot_img" title="nilearn.plotting.plot_img"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_img</span></code></a> now has explicit keyword arguments <code class="docutils literal notranslate"><span class="pre">bg_img</span></code>, <code class="docutils literal notranslate"><span class="pre">vmin</span></code> and <code class="docutils literal notranslate"><span class="pre">vmax</span></code> to control the background image and the bounds of the colormap. These arguments were already accepted in <code class="docutils literal notranslate"><span class="pre">kwargs</span></code> but not documented before (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2157">#2157</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.view_connectome.html#nilearn.plotting.view_connectome" title="nilearn.plotting.view_connectome"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_connectome</span></code></a> now converts <code class="docutils literal notranslate"><span class="pre">NaNs</span></code> in the adjacency matrix to 0 (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2166">#2166</a> by <a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a>).</p></li>
<li><p>Removed the plotting connectomes example which used the Seitzman atlas from <code class="docutils literal notranslate"><span class="pre">examples/03_connectivity/plot_sphere_based_connectome.py</span></code>. The atlas data is unsuitable for the method & the example is redundant (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2177">#2177</a> by <a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a>).</p></li>
</ul>
</div>
<div class="section" id="id13">
<h2>Fixes<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_glass_brain.html#nilearn.plotting.plot_glass_brain" title="nilearn.plotting.plot_glass_brain"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_glass_brain</span></code></a> with <code class="docutils literal notranslate"><span class="pre">colorbar=True</span></code> does not crash when images have <code class="docutils literal notranslate"><span class="pre">NaNs</span></code> (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1953">#1953</a> by <a class="reference external" href="https://github.com/KamalakerDadi">Kamalakar Reddy Daddy</a>).</p></li>
<li><p>Function <code class="docutils literal notranslate"><span class="pre">add_contours</span></code> now accepts <code class="docutils literal notranslate"><span class="pre">threshold</span></code> argument for <code class="docutils literal notranslate"><span class="pre">filled=False</span></code>. Now <code class="docutils literal notranslate"><span class="pre">threshold</span></code> is equally applied when asked for fillings in the contours.</p></li>
<li><p>Functions <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_surf.html#nilearn.plotting.plot_surf" title="nilearn.plotting.plot_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_surf</span></code></a> and <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_surf_stat_map.html#nilearn.plotting.plot_surf_stat_map" title="nilearn.plotting.plot_surf_stat_map"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_surf_stat_map</span></code></a> no longer threshold zero values when no threshold is given (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1997">#1997</a> by <a class="reference external" href="https://github.com/juhuntenburg">Julia Huntenburg</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_surf_stat_map.html#nilearn.plotting.plot_surf_stat_map" title="nilearn.plotting.plot_surf_stat_map"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_surf_stat_map</span></code></a> used with a thresholded map but without a background map results in the surface mesh being displayed in half-transparent grey to maintain a 3D perception (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1997">#1997</a> by <a class="reference external" href="https://github.com/juhuntenburg">Julia Huntenburg</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.view_surf.html#nilearn.plotting.view_surf" title="nilearn.plotting.view_surf"><code class="xref py py-func docutils literal notranslate"><span class="pre">view_surf</span></code></a> now accepts surface data provided as a file path.</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_glass_brain.html#nilearn.plotting.plot_glass_brain" title="nilearn.plotting.plot_glass_brain"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_glass_brain</span></code></a> now correctly displays the left ‘l’ orientation even when the given images are completely masked (empty images) (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/1888">#1888</a> by <a class="reference external" href="https://github.com/KamalakerDadi">Kamalakar Reddy Daddy</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_matrix.html#nilearn.plotting.plot_matrix" title="nilearn.plotting.plot_matrix"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_matrix</span></code></a> with providing <code class="docutils literal notranslate"><span class="pre">labels=None</span></code>, <code class="docutils literal notranslate"><span class="pre">False</span></code>, or an empty list now correctly disables labels (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2083">#2083</a> by <a class="reference external" href="https://github.com/mjboos">Moritz Boos</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.plotting.plot_surf_roi.html#nilearn.plotting.plot_surf_roi" title="nilearn.plotting.plot_surf_roi"><code class="xref py py-func docutils literal notranslate"><span class="pre">plot_surf_roi</span></code></a> now takes <code class="docutils literal notranslate"><span class="pre">vmin</span></code>, and <code class="docutils literal notranslate"><span class="pre">vmax</span></code> parameters (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2052">#2052</a> by <a class="reference external" href="https://github.com/boredStats">Ian Abenes</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_surf_nki_enhanced.html#nilearn.datasets.fetch_surf_nki_enhanced" title="nilearn.datasets.fetch_surf_nki_enhanced"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_surf_nki_enhanced</span></code></a> is now downloading the correct left and right functional surface data for each subject (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2118">#2118</a> by <a class="reference external" href="https://github.com/juhuntenburg">Julia Huntenburg</a>).</p></li>
<li><p>Function <a class="reference internal" href="../modules/generated/nilearn.datasets.fetch_atlas_schaefer_2018.html#nilearn.datasets.fetch_atlas_schaefer_2018" title="nilearn.datasets.fetch_atlas_schaefer_2018"><code class="xref py py-func docutils literal notranslate"><span class="pre">fetch_atlas_schaefer_2018</span></code></a> now downloads from release version <code class="docutils literal notranslate"><span class="pre">0.14.3</span></code> (instead of <code class="docutils literal notranslate"><span class="pre">0.8.1</span></code>) by default, which includes corrected region label names along with 700 and 900 region parcelations (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2138">#2138</a> by <a class="reference external" href="https://danjgale.github.io/">Dan Gale</a>).</p></li>
<li><p>Colormap creation functions have been updated to avoid matplotlib deprecation warnings about colormap reversal (<a class="reference external" href="https://github.com/nilearn/nilearn/issues/2131">#2131</a> by <a class="reference external" href="https://larsoner.com/">Eric Larson</a>).</p></li>
<li><p>Neurovault fetcher no longer fails if unable to update dataset metadata file due to faulty permissions.</p></li>
</ul>
</div>
<div class="section" id="id14">
<h2>Contributors<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h2>
<p>The following people contributed to this release (in alphabetical order):</p>
<blockquote>
<div><ul class="simple">
<li><p><a class="reference external" href="https://twinee.fr/">Alexandre Abraham</a></p></li>
<li><p><a class="reference external" href="http://alexandre.gramfort.net/">Alexandre Gramfort</a></p></li>
<li><p><a class="reference external" href="https://github.com/alpinho">Ana Luisa Pinho</a></p></li>
<li><p><a class="reference external" href="https://github.com/ahoyosid">Andrés Hoyos Idrobo</a></p></li>
<li><p><a class="reference external" href="https://github.com/thomasbazeille">Thomas Bazeille</a></p></li>
<li><p><a class="reference external" href="https://pages.saclay.inria.fr/bertrand.thirion/">Bertrand Thirion</a></p></li>
<li><p><a class="reference external" href="https://github.com/reiningc">Colin Reininger</a></p></li>
<li><p><a class="reference external" href="https://github.com/celinede">Céline Delettre</a></p></li>
<li><p><a class="reference external" href="https://danjgale.github.io/">Dan Gale</a></p></li>
<li><p><a class="reference external" href="https://github.com/dangom">Daniel Gomez</a></p></li>
<li><p><a class="reference external" href="https://elizabeth-dupre.com/#/">Elizabeth DuPre</a></p></li>
<li><p><a class="reference external" href="https://larsoner.com/">Eric Larson</a></p></li>
<li><p><a class="reference external" href="https://github.com/fliem">Franz Liem</a></p></li>
<li><p><a class="reference external" href="http://gael-varoquaux.info/">Gael Varoquaux</a></p></li>
<li><p><a class="reference external" href="https://github.com/Gilles86">Gilles de Hollander</a></p></li>
<li><p><a class="reference external" href="https://gkiar.me/">Greg Kiar</a></p></li>
<li><p><a class="reference external" href="https://glemaitre.github.io/">Guillaume Lemaitre</a></p></li>
<li><p><a class="reference external" href="https://github.com/boredStats">Ian Abenes</a></p></li>
<li><p><a class="reference external" href="https://github.com/illdopejake">Jake Vogel</a></p></li>
<li><p><a class="reference external" href="https://jeromedockes.github.io/">Jerome Dockes</a></p></li>
<li><p><a class="reference external" href="https://github.com/ja-che">Jerome-Alexis Chevalier</a></p></li>
<li><p><a class="reference external" href="https://github.com/juhuntenburg">Julia Huntenburg</a></p></li>
<li><p><a class="reference external" href="https://github.com/KamalakerDadi">Kamalakar Reddy Daddy</a></p></li>
<li><p><a class="reference external" href="https://github.com/kchawla-pi">Kshitij Chawla</a></p></li>
<li><p><a class="reference external" href="https://github.com/mrahim">Mehdi Rahim</a></p></li>
<li><p><a class="reference external" href="https://github.com/mjboos">Moritz Boos</a></p></li>
<li><p><a class="reference external" href="https://github.com/SylvainTakerkart">Sylvain Takerkart</a></p></li>
</ul>
</div></blockquote>
</div>
</div>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4> Giving credit </h4>
<ul class="simple">
<li><p>Please consider <a href="../authors.html#citing">citing the
papers</a>.</p></li>
</ul>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">0.6.0</a><ul>
<li><a class="reference internal" href="#highlights">HIGHLIGHTS</a></li>
<li><a class="reference internal" href="#new">NEW</a></li>
<li><a class="reference internal" href="#enhancements">ENHANCEMENTS</a></li>
<li><a class="reference internal" href="#changes">CHANGES</a></li>
<li><a class="reference internal" href="#fixes">FIXES</a></li>
</ul>
</li>
<li><a class="reference internal" href="#rc">0.6.0rc</a><ul>
<li><a class="reference internal" href="#id2">NEW</a></li>
<li><a class="reference internal" href="#id3">Changes</a></li>
<li><a class="reference internal" href="#id4">Fixes</a></li>
<li><a class="reference internal" href="#contributors">Contributors</a></li>
</ul>
</li>
<li><a class="reference internal" href="#b0">0.6.0b0</a><ul>
<li><a class="reference internal" href="#id5">NEW</a></li>
<li><a class="reference internal" href="#id8">Changes</a></li>
<li><a class="reference internal" href="#id9">Fixes</a></li>
<li><a class="reference internal" href="#id10">Contributors</a></li>
</ul>
</li>
<li><a class="reference internal" href="#a0">0.6.0a0</a><ul>
<li><a class="reference internal" href="#id11">NEW</a></li>
<li><a class="reference internal" href="#id12">Changes</a></li>
<li><a class="reference internal" href="#id13">Fixes</a></li>
<li><a class="reference internal" href="#id14">Contributors</a></li>
</ul>
</li>
</ul>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
© The nilearn developers 2010-2022.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 4.0.2.
<span style="padding-left: 5ex;">
<a href="../_sources/changes/0.6.0.rst.txt"
rel="nofollow">Show this page source</a>
</span>
</div>
</body>
</html>