ENH: Make interfaces.utility.Merge(1) merge a list of lists

[effigies]

At present, Merge() does nothing, providing an undefined outputs.out. This change allows it to merge a list of lists (inputs.in_lists) into a single list, rather than enumerating them with inputs.in1 .. inputs.inN.

If no inputs.in_lists is set, Merge() still provides an undefined outputs.out, so we shouldn't break existing code.

Merge(n) for n < 0 is unchanged.

[coveralls]

Coverage increased (+0.02%) to 72.998% when pulling 88f4df5 on effigies:merge_all into d5497c9 on nipy:master.

[effigies]

Slight amendment: Merge(0, axis='hstack') previously failed to run. It now behaves the same as Merge(0, axis='vstack'), if no in_lists is provided.

[coveralls]

Coverage increased (+0.04%) to 73.02% when pulling 46bc838 on effigies:merge_all into c46b932 on nipy:master.

[coveralls]

Coverage increased (+0.03%) to 72.321% when pulling 30fbbe7 on effigies:merge_all into 6d8efd7 on nipy:master.

[coveralls]

Coverage increased (+0.03%) to 72.321% when pulling 30fbbe7 on effigies:merge_all into 6d8efd7 on nipy:master.

[coveralls]

Coverage increased (+0.03%) to 72.321% when pulling 30fbbe7 on effigies:merge_all into 6d8efd7 on nipy:master.

[coveralls]

Coverage decreased (-0.002%) to 72.289% when pulling 30fbbe7 on effigies:merge_all into 6d8efd7 on nipy:master.

[coveralls]

Coverage increased (+0.03%) to 72.321% when pulling 30fbbe7 on effigies:merge_all into 6d8efd7 on nipy:master.

[coveralls]

Changes Unknown when pulling 9c88205 on effigies:merge_all into * on nipy:master*.

[coveralls]

Changes Unknown when pulling 9ec3985 on effigies:merge_all into * on nipy:master*.

[coveralls]

Coverage increased (+0.07%) to 72.307% when pulling ea19acc on effigies:merge_all into 304ffa4 on nipy:master.

[coveralls]

Coverage increased (+0.07%) to 72.307% when pulling ea19acc on effigies:merge_all into 304ffa4 on nipy:master.

[coveralls]

Coverage increased (+0.07%) to 72.307% when pulling ea19acc on effigies:merge_all into 304ffa4 on nipy:master.

[coveralls]

Coverage increased (+0.07%) to 72.307% when pulling ea19acc on effigies:merge_all into 304ffa4 on nipy:master.

[codecov-io]

Codecov Report

Merging #1390 into master will increase coverage by 0.02%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##           master    #1390      +/-   ##
==========================================
+ Coverage   70.91%   70.93%   +0.02%     
==========================================
  Files        1057     1057              
  Lines       53363    53383      +20     
  Branches     7728     7736       +8     
==========================================
+ Hits        37843    37868      +25     
+ Misses      14139    14137       -2     
+ Partials     1381     1378       -3

Flag	Coverage Δ
#smoketests	70.93% <100%> (+0.02%)	⬆️
#unittests	70.38% <100%> (+0.02%)	⬆️

Impacted Files	Coverage Δ
nipype/interfaces/utility/tests/test_base.py	100% <100%> (ø)	⬆️
nipype/interfaces/utility/base.py	89.47% <100%> (+4.62%)	⬆️
nipype/interfaces/base.py	83.28% <0%> (-0.19%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 30ab0e1...fcf1d48. Read the comment docs.

[satra]

so the only question here is whether this should be for Merge(1) instead of Merge(0)

[effigies]

I can do Merge(1). The goal was to leave the interface unmodified for any existing uses, but I guess nobody would actually do Merge(1) as it stands.

If we do, I'd suggest making numinputs default to 1, so that Merge() can be useful.

And I can update the doctests to be demonstrative.

[satra]

sounds good.