Plotting API - Revision history

Bugman admin: Switch from the depreciated tags to .

2020-10-20T12:14:21Z

Switch from the depreciated <source> tags to <syntaxhighlight>.

Bugman: Added the Category:Infobox templates category.

2015-11-06T17:07:24Z

Added the Category:Infobox templates category.

Bugman admin: Increased the sectioning depth.

2015-10-19T16:15:58Z

Increased the sectioning depth.

Bugman: Added an intro sentence.

2015-10-15T15:00:56Z

Added an intro sentence.

Bugman: /* Development */ Expanded the software specific function description.

2015-02-08T21:03:52Z

Development: Expanded the software specific function description.

Bugman: /* Development */ Expanded the section.

2015-02-08T21:00:10Z

Development: Expanded the section.

Bugman: Created a new 'development' section.

2015-02-08T20:56:36Z

Created a new 'development' section.

Bugman: /* Package: lib */ Added text to the relax library section.

2015-02-08T20:32:23Z

Package: lib: Added text to the relax library section.

Bugman: /* Package: pipe_control */ Execution of write_xy().

2015-02-08T20:23:18Z

Package: pipe_control: Execution of write_xy().

Bugman: /* Package: pipe_control */ More editing.

2015-02-08T20:20:33Z

Package: pipe_control: More editing.

@@ Line 24: / Line 24: @@
 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">
+<syntaxhighlight lang="python">
 from pipe_control.plotting import write_xy
-</source>
+</syntaxhighlight>
 The write_xy() function will assemble the data from the relax data store via the [http://www.nmr-relax.com/api/3.3/pipe_control.plotting-module.html#assemble_data assemble_data() function].  It will then call the plotting API functions write_xy_header() and write_xy_data().

← Older revision		Revision as of 17:07, 6 November 2015
Line 44:		Line 44:
	* Implement the plotting function in the software specific module. This should have identical arguments to the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api] function, but without the initial 'format' argument.		* Implement the plotting function in the software specific module. This should have identical arguments to the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api] function, but without the initial 'format' argument.
	* Register the software specific function in the API by adding it to the software independent function in [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api].		* Register the software specific function in the API by adding it to the software independent function in [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api].
		+
		+
		+	== See also ==
		+
		+	[[Category:Development]]

@@ Line 2: / Line 2: @@
-= Packages =
+== Packages ==
 The flow of execution for plotting XY-type data in relax is:
@@ Line 10: / Line 10: @@
 * The [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting] functions write_xy_header() and write_xy_data().
-== Package:  user_functions ==
+=== Package:  user_functions ===
 The user interface for plotting are generally the user functions.  Currently this consists of the [http://www.nmr-relax.com/manual/grace_write.html grace.write] and [http://www.nmr-relax.com/manual/dx_map.html 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:
@@ Line 20: / Line 20: @@
 The [http://www.nmr-relax.com/api/3.3/user_functions-module.html 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 ==
+=== 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, for example for plotting XY-type data, one needs to import:
@@ Line 30: / Line 30: @@
 The write_xy() function will assemble the data from the relax data store via the [http://www.nmr-relax.com/api/3.3/pipe_control.plotting-module.html#assemble_data assemble_data() function].  It will then call the plotting API functions write_xy_header() and write_xy_data().
-== Package:  lib ==
+=== Package:  lib ===
 The plotting API is located in the [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting relax library package].  The API is defined within the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api module].  This consists of a collection of plotting functions, each of which accepts the 'format' argument.  The format argument is then used to determine which function in which module in lib.plotting will be called.  For example see the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-pysrc.html#correlation_matrix correlation_matrix() function].
@@ Line 36: / Line 36: @@
 To implement a new plotting feature for a certain software package, for example for Gnuplot, an equivalent function should be provided in the [http://www.nmr-relax.com/api/3.3/lib.plotting.gnuplot-module.html lib.plotting.gnuplot module].  This should have the same name as the API function and accept exactly the same arguments, excluding the format argument.
-= Development =
+== Development ==
 To add a new plotting feature, the following steps are required:

← Older revision		Revision as of 15:00, 15 October 2015
Line 1:		Line 1:
		+	This describes the plotting API which is a part of the [[relax library]].
		+
		+
	= Packages =		= Packages =

@@ Line 39: / Line 39: @@
 * For a new software type, a new module in [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting] must be created.
 * For a new graph type, a new function should be added to the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api module].  The first function argument should be 'format'.
-* Implement the plotting function in the software specific module.
+* Implement the plotting function in the software specific module.  This should have identical arguments to the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api] function, but without the initial 'format' argument.
 * Register the software specific function in the API by adding it to the software independent function in [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api].

← Older revision		Revision as of 21:00, 8 February 2015
Line 35:		Line 35:
	= Development =		= Development =

−	To add a new plotting feature ~~for~~ a new software type, a new module in [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting] must be created.	+	To add a new plotting feature, the following steps are required:
		+
		+	* For a new software type, a new module in [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting] must be created.
		+	* For a new graph type, a new function should be added to the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api module]. The first function argument should be 'format'.
		+	* Implement the plotting function in the software specific module.
		+	* Register the software specific function in the API by adding it to the software independent function in [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api].

← Older revision		Revision as of 20:56, 8 February 2015
Line 32:		Line 32:

	To implement a new plotting feature for a certain software package, for example for Gnuplot, an equivalent function should be provided in the [http://www.nmr-relax.com/api/3.3/lib.plotting.gnuplot-module.html lib.plotting.gnuplot module]. This should have the same name as the API function and accept exactly the same arguments, excluding the format argument.		To implement a new plotting feature for a certain software package, for example for Gnuplot, an equivalent function should be provided in the [http://www.nmr-relax.com/api/3.3/lib.plotting.gnuplot-module.html lib.plotting.gnuplot module]. This should have the same name as the API function and accept exactly the same arguments, excluding the format argument.
		+
		+	= Development =
		+
		+	To add a new plotting feature for a new software type, a new module in [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting] must be created.

← Older revision		Revision as of 20:32, 8 February 2015
Line 28:		Line 28:

	== Package: lib ==		== Package: lib ==
		+
		+	The plotting API is located in the [http://www.nmr-relax.com/api/3.3/lib.plotting-module.html lib.plotting relax library package]. The API is defined within the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-module.html lib.plotting.api module]. This consists of a collection of plotting functions, each of which accepts the 'format' argument. The format argument is then used to determine which function in which module in lib.plotting will be called. For example see the [http://www.nmr-relax.com/api/3.3/lib.plotting.api-pysrc.html#correlation_matrix correlation_matrix() function].
		+
		+	To implement a new plotting feature for a certain software package, for example for Gnuplot, an equivalent function should be provided in the [http://www.nmr-relax.com/api/3.3/lib.plotting.gnuplot-module.html lib.plotting.gnuplot module]. This should have the same name as the API function and accept exactly the same arguments, excluding the format argument.