pyCall
======
Call a callable Python object from within R.    

The args and kwargs are transformed to Python variables by the
default conversion. More information about the type conversion can
be found in the vignette.    


Usage
-----
.. code-block:: R

    pyCall(callableObj, args = NULL, kwargs = NULL, autoTypecast = TRUE,
      simplify = TRUE)

Arguments
---------
.. raw:: html

    <table style="width:100%">
      <tr>
        <td style="background-color:#FFFFE0;"><b>callableObj</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">a character string giving the name of the desired callable
    Python object.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>args</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">an optional list of arguments passed to the callable.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>kwargs</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">an optional list of named arguments passed to the callable.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>autoTypecast</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">an optional logical value, default is TRUE, specifying
    if the return values should be automatically typecasted if possible.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>simplify</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">an optional logical value, if TRUE, R converts Python lists
    into R vectors whenever possible, else it translates Python
    lists always to R lists.</td>
      </tr>
    </table>

Examples
--------
.. code-block:: R

    pyCall("sum", args=list(1:3))
    
    ## define a new function with the name fun
    pyExec('
    def fun(**kwargs):
        return([(key, value) for key, value in kwargs.items()])
    ')
    pyCall("fun", kwargs=list(a=1, f=2, x=4))