/usr/share/doc/gnudatalanguage/PYTHON.txt is in gnudatalanguage 0.9.7-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | GDL can embed python as well as being
embedded in python.
1. Writing GDL extensions in python
2. Calling GDL from python
1. Writing GDL extensions in python
===================================
Since version 0.7.1 GDL provides two additional subroutines:
A PYTHON function and a PYTHON procedure.
Both are very similar, the difference is, that any result
returned in the procedures is quietly ignored, while for
the function an exception is raised if python's None is
returned except the DEFAULTRETURN keyword is set to a value, in which
case that value is returned in case of 'None'.
the syntax is:
PYTHON,python_module[,python_function[,arg1,...,argN]],ARGV=argv
res = PYTHON(python_module[,python_function[,arg1,...,argN]],ARGV=argv,
DEFAULTRETURN=defaultreturn)
python_module the python module to load
python_function the python function to call. If this paramter is not
specified, only the module is loaded and initialized.
Note that the module intitialization is done only the
first time a python module is loaded.
arg1,...,argN arguments to be passed to the python function
scalars and one dimensional arrays are passed
as python scalars, an array is passed as a python
Numpy array.
Numpy is a popular extension to python. Using it let python be integrated
in GDL quite seamlessly. See: http://numpy.scipy.org/ for details.
ARGV set this keyword to a string or string array
which is set to the command line options for python.
The first element is the (faked) name of the python
executable. With this pythons search path for modules
(sys.path) can be manipulated. If this keyword is set,
no parameter (python_module) need to be specified.
DEFAULTRETURN default return value, returned if the python function
returns 'None'.
Note that for a GDL extension, you probably have to write a GDL
program file (.pro) containing a function/procedure which uses
the PYTHON function/procedure and a python module (.py) which gets
called by PYTHON within your subroutine.
For an as simple as it gets example see the files
gdl/py/python_print.py and gdl/pro/py_print.pro
If you have the python package 'matplotlib' installed
(see: http://matplotlib.sourceforge.net), you can test the (little)
more elaborate example in.
gdl/py/python_plot.py and gdl/pro/py_plot.pro
(Note that the matplotlib library has much more capabilities then used
here.)
For the version of python and its packages used please refer to the
README file.
If you have any suggestions or needs for extensions of the python
interface please see "CONTACT" in the README file.
2. Calling GDL from python
==========================
NOTE: Due to the neglectible feedback, the python module
development is currently on hold.
If you use it, you are urged to let us know.
Since version 0.8.9 GDL can be embedded into python.
See INSTALL to learn how to build the GDL python module.
Form within python, the usage is:
first the GDL module must be imported:
import GDL
then this module provides three python functions:
GDL.pro( PROCEDURE_NAME [, args [, keywords]])
result = GDL.function( FUNCTION_NAME [, args [, keywords]])
GDL.script( SCRIPT_FILE_NAME)
for calling a GDL procedure, function and script file.
PROCEDURE_NAME, FUNCTION_NAME and SCRIPT_FILE_NAME must be
scalar strings.
args are the arguments. They are converted to GDL.
keywords are the keywords. They are converted to GDL.
if an arg or a keyword is a tuple, they are NOT copied back
when the GDL subroutine returns. This is done to save
resources. (Only the first item of each tuple is passed to GDL).
GDL arrays are passed to/from GDL as python Numpy arrays.
Numpy is a popular extension to python. See:
http://numpy.scipy.org/
for details.
Example:
>>> import GDL
>>> print GDL.function("sin",(1,))
0.841470956802
|