version 1.3, 2000/01/11 05:17:11 |
version 1.5, 2000/01/15 06:26:06 |
|
|
% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.2 2000/01/02 07:32:12 takayama Exp $ |
% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.4 2000/01/13 09:21:34 ohara Exp $ |
|
|
\section{OpenXM Clients} |
\section{OpenXM Clients} |
(noryo and Ohara) |
|
MEMO: keywords: |
|
Asir and Mathematica clients. |
|
|
|
\subsection{Risa/Asir} |
\subsection{Risa/Asir} |
|
|
Line 44 it receives the data from the stream. |
|
Line 41 it receives the data from the stream. |
|
\item {\tt ox\_cmo\_rpc()} |
\item {\tt ox\_cmo\_rpc()} |
|
|
After pushing the name of a function, arguments and the number of the |
After pushing the name of a function, arguments and the number of the |
arguments to the stack of a server , it request the server to execute |
arguments to the stack of a server, it request the server to execute |
the function. It does not wait the termination of the function call. |
the function. It does not wait the termination of the function call. |
|
|
\item {\tt ox\_reset()} |
\item {\tt ox\_reset()} |
Line 55 it completes the operations stated in Section \ref{con |
|
Line 52 it completes the operations stated in Section \ref{con |
|
Furthermore {\tt ox\_select()} is provided to detect streams ready for |
Furthermore {\tt ox\_select()} is provided to detect streams ready for |
reading. It is realized by the {\tt select()} system call and is used |
reading. It is realized by the {\tt select()} system call and is used |
to avoid blocking on read operations. |
to avoid blocking on read operations. |
|
|
|
\subsection{Mathematica} |
|
|
|
We provide an OpenXM client {\tt math2ox} written as an external module |
|
for Mathematica. Our client communicates to Mathematica by MathLink and |
|
to an OpenXM server by OpenXM protocols. |
|
By using the module {\tt math2ox}, |
|
we can call OpenXM servers from Mathematica; |
|
here is an example of a computation of the de Rham cohomology groups |
|
of ${\bf C}^2 \setminus V(x^3-y^2)$. |
|
{\footnotesize |
|
\begin{verbatim} |
|
In[1]:= Install["math2ox"] |
|
In[2]:= OxStart["../lib/sm1/bin/ox_sm1_forAsir"] |
|
In[3]:= OxExecute[" [(x^3-y^2) (x,y)] deRham "] |
|
In[4]:= OxPopString[] |
|
Out[4]= [ 1 , 1 , 0 ] |
|
\end{verbatim} |
|
} |
|
|
|
\subsubsection{Functions} |
|
|
|
The {\tt math2ox} has the following functions |
|
which respectively correspond those in Risa/Asir. |
|
\begin{quote} |
|
{\tt OxStart[s\_String]} \\ |
|
{\tt OxStartInsecure[s\_String]} \\ |
|
{\tt OxExecuteString[s\_String]} \\ |
|
{\tt OxParse[s\_String]} \\ |
|
{\tt OxGet[]} \\ |
|
{\tt OxPopCMO[]} \\ |
|
{\tt OxPopString[]} \\ |
|
{\tt OxClose[]} \\ |
|
{\tt OxReset[]} |
|
\end{quote} |
|
For example, the {\tt OxPopCMO[]} function above requests a server to |
|
send data on the stack to the stream, then it receives the data from the |
|
stream. |
|
|
|
By using the {\tt OxParse[]} function, we can send suitable OX messages, |
|
written by the OX expression, to a server. OX expressions are |
|
Lisp-like expressions for OX messages and are defined |
|
in~\cite{noro-takayama}. |
|
The {\tt OxGet[]} receives an OX data message |
|
and returns its translation to an local object. |
|
|