Author: bugman
Date: Thu May 3 19:45:18 2012
New Revision: 15917
URL: http://svn.gna.org/viewcvs/relax?rev=15917&view=rev
Log:
This should hurt!! Shifted the pipe module from the prompt to user_functions
package.
This is in preparation for the full conversion of this user function class
into the new
auto-generation design. relax will be broken for a while now!
Added:
branches/uf_redesign/user_functions/pipe.py
- copied unchanged from r15908, branches/uf_redesign/prompt/pipe.py
Removed:
branches/uf_redesign/prompt/pipe.py
Removed: branches/uf_redesign/prompt/pipe.py
URL:
http://svn.gna.org/viewcvs/relax/branches/uf_redesign/prompt/pipe.py?rev=15916&view=auto
==============================================================================
--- branches/uf_redesign/prompt/pipe.py (original)
+++ branches/uf_redesign/prompt/pipe.py (removed)
@@ -1,252 +1,0 @@
-###############################################################################
-#
#
-# Copyright (C) 2004-2011 Edward d'Auvergne
#
-#
#
-# This file is part of the program relax.
#
-#
#
-# relax is free software; you can redistribute it and/or modify
#
-# it under the terms of the GNU General Public License as published by
#
-# the Free Software Foundation; either version 2 of the License, or
#
-# (at your option) any later version.
#
-#
#
-# relax is distributed in the hope that it will be useful,
#
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
#
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#
-# GNU General Public License for more details.
#
-#
#
-# You should have received a copy of the GNU General Public License
#
-# along with relax; if not, write to the Free Software
#
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
-#
#
-###############################################################################
-
-# Module docstring.
-"""Module containing the 'pipe' user function class."""
-__docformat__ = 'plaintext'
-
-# relax module imports.
-from base_class import User_fn_class, _build_doc
-import arg_check
-from generic_fns import pipes
-from relax_errors import RelaxError
-from specific_fns.setup import hybrid_obj
-
-
-class Pipe(User_fn_class):
- """Class for holding the functions for manipulating data pipes."""
-
- def copy(self, pipe_from=None, pipe_to=None):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.copy("
- text = text + "pipe_from=" + repr(pipe_from)
- text = text + ", pipe_to=" + repr(pipe_to) + ")"
- print(text)
-
- # The argument checks.
- arg_check.is_str(pipe_from, 'pipe from', can_be_none=True)
- arg_check.is_str(pipe_to, 'pipe to', can_be_none=True)
-
- # Both pipe arguments cannot be None.
- if pipe_from == None and pipe_to == None:
- raise RelaxError("The pipe_from and pipe_to arguments cannot
both be set to None.")
-
- # Execute the functional code.
- pipes.copy(pipe_from=pipe_from, pipe_to=pipe_to)
-
- # The function doc info.
- copy._doc_title = "Copy a data pipe."
- copy._doc_title_short = "Data pipe copying."
- copy._doc_args = [
- ["pipe_from", "The name of the source data pipe to copy the data
from."],
- ["pipe_to", "The name of the target data pipe to copy the data to."]
- ]
- copy._doc_desc = """
- This allows the contents of a data pipe to be copied. If the source
data pipe is not set, the current data pipe will be assumed. The target data
pipe must not yet exist.
- """
- copy._doc_examples = """
- To copy the contents of the 'm1' data pipe to the 'm2' data pipe,
type:
-
- relax> pipe.copy('m1', 'm2')
- relax> pipe.copy(pipe_from='m1', pipe_to='m2')
-
- If the current data pipe is 'm1', then the following command can be
used:
-
- relax> pipe.copy(pipe_to='m2')
- """
- _build_doc(copy)
-
-
- def create(self, pipe_name=None, pipe_type=None):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.create("
- text = text + "pipe_name=" + repr(pipe_name)
- text = text + ", pipe_type=" + repr(pipe_type) + ")"
- print(text)
-
- # The argument checks.
- arg_check.is_str(pipe_name, 'data pipe name')
- arg_check.is_str(pipe_type, 'data pipe type')
-
- # Execute the functional code.
- pipes.create(pipe_name=pipe_name, pipe_type=pipe_type)
-
- # The function doc info.
- create._doc_title = "Add a new data pipe to the relax data store."
- create._doc_title_short = "Data pipe creation."
- create._doc_args = [
- ["pipe_name", "The name of the data pipe."],
- ["pipe_type", "The type of data pipe."]
- ]
- create._doc_desc = """
- The data pipe name can be any string however the data pipe type can
only be one of the following:
-
- 'ct': Consistency testing,
- 'frame order': The Frame Order theories,
- 'jw': Reduced spectral density mapping,
- 'hybrid': A special hybrid pipe,
- 'mf': Model-free analysis,
- 'N-state': N-state model of domain motions,
- 'noe': Steady state NOE calculation,
- 'relax_fit': Relaxation curve fitting,
- """
- create._doc_examples = """
- To set up a model-free analysis data pipe with the name 'm5', type:
-
- relax> pipe.create('m5', 'mf')
- """
- _build_doc(create)
-
-
- def current(self):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.current()"
- print(text)
-
- # Execute the functional code.
- pipes.current()
-
- # The function doc info.
- current._doc_title = "Print the name of the current data pipe."
- current._doc_title_short = "Current data pipe printing."
- current._doc_examples = """
- To run the user function, type:
-
- relax> pipe.current()
- """
- _build_doc(current)
-
-
- def delete(self, pipe_name=None):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.delete("
- text = text + "pipe_name=" + repr(pipe_name) + ")"
- print(text)
-
- # The argument checks.
- arg_check.is_str(pipe_name, 'data pipe name', can_be_none=True)
-
- # Execute the functional code.
- pipes.delete(pipe_name=pipe_name)
-
- # The function doc info.
- delete._doc_title = "Delete a data pipe from the relax data store."
- delete._doc_title_short = "Data pipe deletion."
- delete._doc_args = [
- ["pipe_name", "The name of the data pipe to delete."]
- ]
- delete._doc_desc = """
- This will permanently remove the data pipe and all of its contents
from the relax data store. If the pipe name is not given, then all data
pipes will be deleted.
- """
- _build_doc(delete)
-
-
- def display(self):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.display()"
- print(text)
-
- # Execute the functional code.
- pipes.display()
-
- # The function doc info.
- display._doc_title = "Print a list of all the data pipes."
- display._doc_title_short = "Data pipe listing."
- display._doc_examples = """
- To run the user function, type:
-
- relax> pipe.display()
- """
- _build_doc(display)
-
-
- def hybridise(self, hybrid=None, pipes=None):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.hybridise("
- text = text + "hybrid=" + repr(hybrid)
- text = text + ", pipes=" + repr(pipes) + ")"
- print(text)
-
- # The argument checks.
- arg_check.is_str(hybrid, 'hybrid pipe name')
- arg_check.is_str_list(pipes, 'data pipes')
-
- # Execute the functional code.
- hybrid_obj._hybridise(hybrid=hybrid, pipe_list=pipes)
-
- # The function doc info.
- hybridise._doc_title = "Create a hybrid data pipe by fusing a number of
other data pipes."
- hybridise._doc_title_short = "Hybrid data pipe creation."
- hybridise._doc_args = [
- ["hybrid", "The name of the hybrid data pipe to create."],
- ["pipes", "An array containing the names of all data pipes to
hybridise."]
- ]
- hybridise._doc_desc = """
- This user function can be used to construct hybrid models. An
example of the use of a hybrid model could be if the protein consists of two
independent domains. These two domains could be analysed separately, each
having their own optimised diffusion tensors. The N-terminal domain data
pipe could be called 'N_sphere' while the C-terminal domain could be called
'C_ellipsoid'. These two data pipes could then be hybridised into a single
data pipe. This hybrid data pipe can then be compared via model selection to
a data pipe whereby the entire protein is assumed to have a single diffusion
tensor.
-
- The requirements for data pipes to be hybridised is that the
molecules, sequences, and spin systems for all the data pipes is the same,
and that no spin system is allowed to be selected in two or more data pipes.
The selections must not overlap to allow for rigorous statistical comparisons.
- """
- hybridise._doc_examples = """
- The two data pipes 'N_sphere' and 'C_ellipsoid' could be hybridised
into a single data pipe
- called 'mixed model' by typing:
-
- relax> pipe.hybridise('mixed model', ['N_sphere', 'C_ellipsoid'])
- relax> pipe.hybridise(hybrid='mixed model', pipes=['N_sphere',
'C_ellipsoid'])
- """
- _build_doc(hybridise)
-
-
- def switch(self, pipe_name=None):
- # Function intro text.
- if self._exec_info.intro:
- text = self._exec_info.ps3 + "pipe.switch("
- text = text + "pipe_name=" + repr(pipe_name) + ")"
- print(text)
-
- # The argument checks.
- arg_check.is_str(pipe_name, 'data pipe name')
-
- # Execute the functional code.
- pipes.switch(pipe_name=pipe_name)
-
- # The function doc info.
- switch._doc_title = "Switch between the data pipes of the relax data
store."
- switch._doc_title_short = "Data pipe switching."
- switch._doc_args = [
- ["pipe_name", "The name of the data pipe."]
- ]
- switch._doc_desc = """
- This will switch between the various data pipes within the relax
data store.
- """
- switch._doc_examples = """
- To switch to the 'ellipsoid' data pipe, type:
-
- relax> pipe.switch('ellipsoid')
- relax> pipe.switch(pipe_name='ellipsoid')
- """
- _build_doc(switch)
r15917 - in /branches/uf_redesign: prompt/pipe.py user_functions/pipe.py