Difference between revisions of "Plotting API"

From relax wiki
Jump to navigation Jump to search
(→‎Package: pipe_control: Some editing.)
(→‎Package: pipe_control: More editing.)
Line 19: Line 19:
 
== Package:  pipe_control ==
 
== Package:  pipe_control ==
  
The user functions provide a simple interface to the relax backend.  For plotting and most functionality, this is in the [http://www.nmr-relax.com/api/3.3/pipe_control-module.html pipe_control package] which is used primarily to read and write data to the relax data store.  However power-users can bypass the user function interface and directly use the backend code for greater functionality.  This also allows for the implementation of new features without modifying the user interface.  To use the backend code, you need to import:
+
The user functions provide a simple interface to the relax backend.  For plotting and most functionality, this is in the [http://www.nmr-relax.com/api/3.3/pipe_control-module.html pipe_control package] which is used primarily to read and write data to the relax data store.  However power-users can bypass the user function interface and directly use the backend code for greater functionality.  This also allows for the implementation of new features without modifying the user interface.  To use the backend code, for example for plotting XY-type data, one needs to import:
  
 
<source lang="python">
 
<source lang="python">

Revision as of 20:20, 8 February 2015

Packages

The flow of execution for plotting XY-type data in relax is:

Package: user_functions

The user interface for plotting are generally the user functions. Currently this consists of the grace.write and dx.map user functions. However in the future a software independent interface will be gradually implemented via a new plotting user function class. An idea would be to have one user function per graph type, for example:

  • plotting.write_2D
  • plotting.write_iso3D
  • plotting.write_2D_fitted_curves

The user_functions package consists of definitions that are used to construct the prompt or graphical UI and to set up automated argument checking.

Package: pipe_control

The user functions provide a simple interface to the relax backend. For plotting and most functionality, this is in the pipe_control package which is used primarily to read and write data to the relax data store. However power-users can bypass the user function interface and directly use the backend code for greater functionality. This also allows for the implementation of new features without modifying the user interface. To use the backend code, for example for plotting XY-type data, one needs to import:

from pipe_control.plotting import write_xy

Package: lib