Skip to content

Commit 5f1e054

Browse files
committed
fix: resolved conflicts
2 parents 639e773 + 8896ae2 commit 5f1e054

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

68 files changed

+4982
-8045
lines changed

.travis.yml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ before_install:
66
- sudo apt-get update -qq
77
- sudo apt-get install lsb-release
88
- source /etc/lsb-release
9-
- wget -O- http://neuro.debian.net/lists/${DISTRIB_CODENAME}.us-nh | sudo tee /etc/apt/sources.list.d/neurodebian.sources.list
9+
- echo ${DISTRIB_CODENAME}
10+
- wget -O- http://neuro.debian.net/lists/${DISTRIB_CODENAME}.us-nh.full | sudo tee /etc/apt/sources.list.d/neurodebian.sources.list
1011
- sudo apt-key adv --recv-keys --keyserver pgp.mit.edu 2649A5A9
1112
- sudo apt-get update -qq
1213
- sudo apt-get install -qq python-scipy python-nose
@@ -18,4 +19,4 @@ before_install:
1819
- virtualenv --system-site-packages ~/virtualenv/this
1920
- source ~/virtualenv/this/bin/activate
2021
install: python setup.py build_ext --inplace
21-
script: make test
22+
script: make test

CHANGES

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,28 @@
11
Next release
22
============
33

4+
* ENH: New interfaces: nipy.Trim, fsl.GLM, fsl.SigLoss, spm.VBMSegment
5+
* ENH: Allow control over terminal output for commandline interfaces
6+
* ENH: New workflows for dMRI and fMRI pre-processing: added motion artifact correction
7+
with rotation of the B-matrix, and susceptibility correction for EPI imaging using
8+
fieldmaps. Updated eddy_correct pipeline to support both dMRI and fMRI, and new parameters.
9+
* ENH: Minor improvements to FSL's FUGUE and FLIRT interfaces
10+
* ENH: Added optional dilation of parcels in cmtk.Parcellate
11+
* ENH: Interpolation mode added to afni.Resample
12+
13+
* FIX: SpecifyModel works with 3D files correctly now.
14+
15+
Release 0.7.0 (Dec 18, 2012)
16+
============================
17+
418
* ENH: Add basic support for LSF plugin.
5-
* ENH: New interfaces: ICC, Meshfix, ants.Register, C3dAffineTool, ants.JacobianDeterminant
19+
* ENH: New interfaces: ICC, Meshfix, ants.Register, C3dAffineTool, ants.JacobianDeterminant,
20+
afni.AutoTcorrelate, DcmStack
621
* ENH: New workflows: ants template building (both using 'ANTS' and the new 'antsRegistration')
722
* ENH: New examples: how to use ANTS template building workflows (smri_ants_build_tmeplate),
823
how to set SGE specific options (smri_ants_build_template_new)
924
* ENH: added no_flatten option to Merge
25+
* ENH: added versioning option and checking to traits
1026
* ENH: added deprecation metadata to traits
1127
* ENH: Slicer interfaces were updated to version 4.1
1228

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Copyright (c) 2006-2009, NIPY Developers
1+
Copyright (c) 2009-2013, NIPY Developers
22
All rights reserved.
33

44
Redistribution and use in source and binary forms, with or without

README.rst

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -89,16 +89,13 @@ Currently NIPYPE consists of the following files and directories:
8989
License information
9090
-------------------
9191

92-
See the file "LICENSE" for information on the history of this
93-
software, terms & conditions for usage, and a DISCLAIMER OF ALL
94-
WARRANTIES.
92+
We use the 3-clause BSD license; the full license is in the file ``LICENSE`` in
93+
the nipype distribution.
9594

96-
This NIPYPE distribution contains no GNU General Public Licensed
97-
(GPLed) code so it may be used in proprietary projects. There
98-
are interfaces to some GNU code but these are entirely optional.
95+
There are interfaces to some GNU code but these are entirely optional.
9996

10097
All trademarks referenced herein are property of their respective
10198
holders.
10299

103-
Copyright (c) 2009-2012, NIPY Developers
100+
Copyright (c) 2009-2013, NIPY Developers
104101
All rights reserved.

doc/_templates/sidebar_versions.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ <h3>{{ _('Versions') }}</h3>
1717
<td align="left">Release</td><td align="right">Devel</td>
1818
</tr>
1919
<tr>
20-
<td align="left">0.6.0</td><td align="right">pre-0.7</td>
20+
<td align="left">0.7.0</td><td align="right">pre-0.8</td>
2121
</tr>
2222
<tr>
2323
<td align="left"><a href="{{pathto('users/install')}}">Download</a></td>

doc/devel/interface_specs.rst

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -263,7 +263,15 @@ Common
263263
should be symlinked, while `True` indicates that the contents should be
264264
copied over.
265265

266-
``deprecated``
266+
``min_ver`` and ``max_ver``
267+
These metadata determine if a particular trait will be available when a
268+
given version of the underlying interface runs. Note that this check is
269+
performed at runtime.::
270+
271+
class RealignInputSpec(BaseInterfaceInputSpec):
272+
jobtype = traits.Enum('estwrite', 'estimate', 'write', min_ver='5',
273+
usedefault=True)
274+
``deprecated`` and ``new_name``
267275
This is metadata for removing or renaming an input field from a spec.::
268276

269277
class RealignInputSpec(BaseInterfaceInputSpec):
@@ -277,8 +285,8 @@ Common
277285
from current release. Raises `TraitError` after package version crosses the
278286
deprecation version.
279287

280-
``new_name``
281-
For inputs that are being renamed, one can specify the new name of the field.::
288+
For inputs that are being renamed, one can specify the new name of the
289+
field.::
282290

283291
class RealignInputSpec(BaseInterfaceInputSpec):
284292
jobtype = traits.Enum('estwrite', 'estimate', 'write',
@@ -293,6 +301,11 @@ Common
293301
When `new_name` is provided it must exist as a trait, otherwise an exception
294302
will be raised.
295303

304+
.. note::
305+
306+
The version information for `min_ver`, `max_ver` and `deprecated` has to be
307+
provided as a string. For example, `min_ver='0.1'`.
308+
296309
CommandLine
297310
^^^^^^^^^^^
298311

doc/documentation.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Documentation
99
:Release: |version|
1010
:Date: |today|
1111

12-
Previous versions: `0.5.3 <http://nipy.org/nipype/0.5.3>`_ `0.4.1 <http://nipy.org/nipype/0.4.1>`_
12+
Previous versions: `0.6 <http://nipy.org/nipype/0.6>`_ `0.5.3 <http://nipy.org/nipype/0.5.3>`_
1313

1414
.. container:: doc2
1515

doc/users/config_file.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,11 @@ Execution
109109
data through (without copying) (possible values: ``true`` and
110110
``false``; default value: ``false``)
111111

112+
*stop_on_unknown_version*
113+
If this is set to True, an underlying interface will raise an error, when no
114+
version information is available. Please notify developers or submit a
115+
patch.
116+
112117
Example
113118
~~~~~~~
114119

doc/users/install.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@ This page covers the necessary steps to install Nipype.
99
Download
1010
--------
1111

12-
Release 0.6.0: [`zip <http://github.com/nipy/nipype/zipball/0.6.0>`_ `tar
13-
<http://github.com/nipy/nipype/tarball/0.6.0>`_]
12+
Release 0.7.0: [`zip <https://github.com/nipy/nipype/archive/0.7.zip>`_ `tar.gz
13+
<https://github.com/nipy/nipype/archive/0.7.tar.gz>`_]
1414

1515
Development: [`zip <http://github.com/nipy/nipype/zipball/master>`_ `tar
1616
<http://github.com/nipy/nipype/tarball/master>`_]

doc/users/plugins.rst

Lines changed: 65 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ available plugins allow local and distributed execution of workflows and
99
debugging. Each available plugin is described below.
1010

1111
Current plugins are available for Linear, Multiprocessing, IPython_ distributed
12-
processing platforms and for direct processing on SGE_, PBS_, Condor_, and LSF_. We
12+
processing platforms and for direct processing on SGE_, PBS_, HTCondor_, and LSF_. We
1313
anticipate future plugins for the Soma_ workflow.
1414

1515
.. note::
@@ -34,7 +34,7 @@ Optional arguments::
3434
.. note::
3535

3636
Except for the status_callback, the remaining arguments only apply to the
37-
distributed plugins: MultiProc/IPython(X)/SGE/PBS/Condor/LSF
37+
distributed plugins: MultiProc/IPython(X)/SGE/PBS/HTCondor/HTCondorDAGMan/LSF
3838

3939
For example:
4040

@@ -71,11 +71,17 @@ a local system.
7171

7272
Optional arguments::
7373

74-
n_procs : Number of processes to launch in parallel
74+
n_procs : Number of processes to launch in parallel, if not set number of
75+
processors/threads will be automatically detected
7576

7677
To distribute processing on a multicore machine, simply call::
7778

78-
workflow.run(plugin='MultiProc', plugin_args={'n_procs' : 2})
79+
workflow.run(plugin='MultiProc')
80+
81+
This will use all available CPUs. If on the other hand you would like to restrict
82+
the number of used resources (to say 2 CPUs), you can call::
83+
84+
workflow.run(plugin='MultiProc', plugin_args={'n_procs' : 2}
7985

8086
IPython
8187
-------
@@ -142,27 +148,71 @@ Optional arguments::
142148
template: custom template file to use
143149
bsub_args: any other command line args to be passed to bsub.
144150

145-
Condor
146-
------
151+
HTCondor
152+
--------
153+
154+
DAGMan
155+
~~~~~~
156+
157+
With its DAGMan_ component HTCondor_ (previously Condor) allows for submitting
158+
entire graphs of dependent jobs at once. With the ``CondorDAGMan`` plug-in
159+
Nipype can utilize this functionality to submit complete workflows directly and
160+
in a single step. Consequently, and in contrast to other plug-ins, workflow
161+
execution returns almost instantaneously -- Nipype is only used to generate the
162+
workflow graph, while job scheduling and dependency resolution are entirely
163+
managed by HTCondor_.
164+
165+
Please note that although DAGMan_ supports specification of data dependencies
166+
as well as data provisioning on compute nodes this functionality is currently
167+
not supported by this plug-in. As with all other batch systems supported by
168+
Nipype, only HTCondor pools with a shared file system can be used to process
169+
Nipype workflows.
170+
171+
Workflow execution with HTCondor DAGMan is done by calling::
172+
173+
workflow.run(plugin='CondorDAGMan')
174+
175+
Job execution behavior can be tweaked with the following optional plug-in
176+
arguments::
177+
178+
template : submit spec template to use for job submission. The template
179+
all generated submit specs are appended to this template. This
180+
can be a str or a filename.
181+
submit_specs : additional submit specs that are appended to the generated
182+
submit specs to allow for overriding or extending the defaults.
183+
This can be a str or a filename.
184+
dagman_args : arguments to be prepended to the job execution script in the
185+
dagman call
186+
187+
Please see the `HTCondor documentation`_ for details on possible configuration
188+
options and command line arguments.
189+
190+
``qsub`` emulation
191+
~~~~~~~~~~~~~~~~~~
192+
193+
.. note::
194+
195+
This plug-in is deprecated and users should migrate to the more robust and
196+
more versatile ``CondorDAGMan`` plug-in.
147197

148-
Despite the differences between Condor and SGE-like batch systems the plugin
149-
usage (incl. supported arguments) is almost identical. The Condor plugin relies
150-
on a ``qsub`` emulation script for Condor, called ``condor_qsub`` that can be
198+
Despite the differences between HTCondor and SGE-like batch systems the plugin
199+
usage (incl. supported arguments) is almost identical. The HTCondor plugin relies
200+
on a ``qsub`` emulation script for HTCondor, called ``condor_qsub`` that can be
151201
obtained from a `Git repository on git.debian.org`_. This script is currently
152-
not shipped with a standard Condor distribution, but is included in the Condor
202+
not shipped with a standard HTCondor distribution, but is included in the HTCondor
153203
package from http://neuro.debian.net. It is sufficient to download this script
154204
and install it in any location on a system that is included in the ``PATH``
155205
configuration.
156206

157207
.. _Git repository on git.debian.org: http://anonscm.debian.org/gitweb/?p=pkg-exppsy/condor.git;a=blob_plain;f=debian/condor_qsub;hb=HEAD
158208

159-
Running a workflow in a Condor pool is done by calling::
209+
Running a workflow in a HTCondor pool is done by calling::
160210

161211
workflow.run(plugin='Condor')
162212

163213
The plugin supports a limited set of qsub arguments (``qsub_args``) that cover
164214
the most common use cases. The ``condor_qsub`` emulation script translates qsub
165-
arguments into the corresponding Condor terminology and handles the actual job
215+
arguments into the corresponding HTCondor terminology and handles the actual job
166216
submission. For details on supported options see the manpage of ``condor_qsub``.
167217

168218
Optional arguments::
@@ -176,4 +226,6 @@ Optional arguments::
176226
.. _Soma: http://brainvisa.info/soma/soma-workflow/
177227
.. _PBS: http://www.clusterresources.com/products/torque-resource-manager.php
178228
.. _LSF: http://www.platform.com/Products/platform-lsf
179-
.. _Condor: http://www.cs.wisc.edu/condor/
229+
.. _HTCondor: http://www.cs.wisc.edu/htcondor/
230+
.. _DAGMan: http://research.cs.wisc.edu/htcondor/dagman/dagman.html
231+
.. _HTCondor documentation: http://research.cs.wisc.edu/htcondor/manual

0 commit comments

Comments
 (0)