added japanese translation of javasci.
[scilab.git] / scilab / modules / javasci / help / ja_JP / javasci_step_by_step.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) 2010 - DIGITEO - Sylvestre LEDRU
6  *
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at
11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
12  *
13  -->
14
15 <!-- This document was created with Syntext Serna Free. -->
16
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="javasci_step_by_step" scilab:needs-examples="no" xml:lang="ja">
18     
19     <refnamediv>
20         
21         <refname>javasci - ステップバイステップ</refname>
22         
23         <refpurpose>javasci v2に基づくアプリケーションの書き方</refpurpose>
24         
25     </refnamediv>
26     
27     <refsection>
28         
29         <title>ステップ1 - コード本体</title>
30         
31         <para>Javasci v2 では Java APIからScilabエンジンをコールできます.
32             
33         </para>
34         
35         <para>
36             
37             いくつかのオブジェクトとメソッドがこのようなタスクを実行するために
38             
39             提供されています.
40             
41             メインクラスは <emphasis role="italic">Scilab</emphasis>です. 
42             
43             このオブジェクトにより, Scilabエンジンからのデータ送信/受信,
44             
45             エラー管理およびScilabスクリプト/コードの実行ができるようになります.
46             
47         </para>
48         
49         <para>クラスは以下の2つのパッケージに分割されています: </para>
50         
51         <itemizedlist>
52             
53             <listitem>org.scilab.modules.javasci.*; // 主要なScilabクラスを含む</listitem>
54             
55             <listitem>org.scilab.modules.types.*; // Scilab &lt;=&gt; Javaマッピングを含む</listitem>
56             
57         </itemizedlist>
58         
59         <para>
60             
61             <para>以下に古典的な使用例を示します:</para>
62             
63         </para>
64         
65         <programlisting role="java"><![CDATA[
66 /*
67  *
68  * This file is released under the 3-clause BSD license. See COPYING-BSD.
69  *
70  */
71
72 import org.scilab.modules.javasci.Scilab;
73 import org.scilab.modules.types.ScilabType;
74 import org.scilab.modules.types.ScilabDouble;
75
76 class Example1 {
77
78     public static void main(String[] args) {
79         try {
80             Scilab sci = new Scilab();
81             if (sci.open()) {
82                 /* Send a Scilab instruction */
83                 sci.exec("foo = [ 2, 4, 6; 4, 0, 10; 6, 10, 12 ];");
84
85 /* Retrieve the variable foo */
86                 ScilabType foo = sci.get("foo");
87
88 /* Display the variable */
89                 System.out.println("Representation of  : "+foo);
90
91 /* Get the data and retrieve the 2,2 value */
92                 double[][] aReal = ((ScilabDouble)foo).getRealPart();
93                 System.out.println("foo[1,1] = " + aReal[1][1]);
94
95 /* Change the value of 2,2 */
96                 aReal[1][1] = Math.PI;
97
98 /* Create a new variable */
99                 ScilabDouble bar = new ScilabDouble(aReal);
100
101 /* Send it to Scilab */
102                 sci.put("bar",bar);
103
104 /* Display it through Scilab */
105                 sci.exec("disp(bar)");
106
107                 sci.close();
108             } else {
109                 System.out.println("Could not start Scilab ");
110             }
111
112
113 /* Can be improved by other exceptions: AlreadyRunningException,
114  * InitializationException, UndefinedVariableException,
115  * UnknownTypeException, etc
116  */
117         } catch (org.scilab.modules.javasci.JavasciException e) {
118             System.err.println("An exception occurred: " + e.getLocalizedMessage());
119         }
120     }
121 }
122
123
124         ]]></programlisting>
125         
126         <para>ソースは SCI/modules/javasci/examples/v2/ で提供されています</para>
127         
128         <para>このプログラムの出力は以下のようになります:</para>
129         
130         <programlisting><![CDATA[Representation of  : [2.0, 4.0, 6.0 ; 4.0, 0.0, 10.0 ; 6.0, 10.0, 12.0]
131 foo[1,1] = 0.0
132
133 2.    4.           6.
134 4.    3.1415927    10.
135 6.    10.          12.
136         ]]></programlisting>
137         
138         <para>
139             
140             オブジェクトおよびメソッドに関する詳細については,
141             
142             <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link>
143             
144             を閲覧してください (これによりWebブラウザがオープンします).
145             
146         </para>
147         
148     </refsection>
149     
150     <refsection>
151         
152         <title>ステップ 2 - 構築</title>
153         
154         <para>
155             
156             GNU/Linux および Mac OS Xでは
157             
158             Scilabデータへのパスも指定します
159             
160             (Microsoft Windowsでは,自動的に検出されます).
161             
162         </para>
163         
164         <programlisting><![CDATA[# Variable SCI
165 # GNU/LinuxのScilabバイナリのパス:
166 /path/to/scilab-xxx/share/scilab/
167 # GNU/LinuxおよびMac OS Xのソースツリーでは, パスはソースツリーのトップです
168 /path/to/scilab/sources/
169 # Mac OS X上の パス:
170 /Applications/scilab-xxx/Contents/MacOS/share/scilab/
171 # Windows上のパス:
172 C:\Program Files\Scilab-5.3.0\
173         ]]></programlisting>
174         
175         <para>
176             
177             Javasci v2によりコードを構築するには,
178             
179             CLASSPATHに2つのjarファイルがある必要があります.
180             
181         </para>
182         
183         <programlisting role="example"><![CDATA[# 例えば, 変数CLASSPATHを作成
184 $(SCI)/modules/javasci/jar/org.scilab.modules.javasci.jar
185 $(SCI)/modules/types/jar/org.scilab.modules.types.jar
186 ]]></programlisting>
187         
188     </refsection>
189     
190     <refsection>
191         
192         <title>ステップ3 - 実行</title>
193         
194         <para>構築ステップと同様, 2つのjarを指定します. </para>
195         
196         <para>
197             
198             JavaがScilabと通信するためにネーティブライブラリへのパスを設定する必要があります.
199             
200         </para>
201         
202         <para>
203             
204             Javasci v2は,2つのライブラリ
205             
206             libjavasci2.{so,dylib,dll} および libscilab.{so,dylib,dll}がロードされていることを
207             
208             必要とします.他のライブラリは透過的にロードされます.
209             
210         </para>
211         
212         <programlisting role="example"><![CDATA[# 例えば, 変数CLASSPATHを作成
213 # GNU/LinuxのScilabバイナリのパス:
214 /path/to/scilab-xxx/lib/scilab/
215 # GNU/LinuxおよびMac OS Xのソースツリーのパス:
216 $(SCI)/modules/javasci/.libs/:$(SCI)/modules/.libs/
217 # Mac OS X上の パス:
218 /Applications/scilab-xxx/Contents/MacOS/lib/scilab/
219 # Windows上のパス:
220 set LIBPATH="C:\Program Files\Scilab-5.3.0\bin"
221         ]]></programlisting>
222         
223         <para>プログラムを起動するコマンドは以下のようになります:</para>
224         
225         <programlisting>java -cp $CLASSPATH:. -DSCI=$SCI -Djava.library.path=$LIBPATH Example1</programlisting>
226         
227     </refsection>
228     
229     <refsection>
230         
231         <title>Makefileの例</title>
232         
233         <para>シンプルなMakefileは以下のようになります:</para>
234         
235         <programlisting><![CDATA[SCI = /path/to/scilab/share/scilab/
236 CLASSPATH = $(SCI)/modules/javasci/jar/org.scilab.modules.javasci.jar:$(SCI)/modules/types/jar/org.scilab.modules.types.jar
237 LIB_PATH = /path/to/scilab/lib/scilab
238 all:
239 javac -cp $(CLASSPATH) Example1.java
240 java -cp $(CLASSPATH):. -DSCI=$(SCI) -Djava.library.path=$(LIB_PATH) Example1
241         ]]></programlisting>
242         
243     </refsection>
244     
245     <para>SCI/modules/javasci/examples/v2 ディレクトリにある
246         
247         Windows用build.batを参照ください.
248     </para>
249     
250     <refsection>
251         
252         <title>参照</title>
253         
254         <simplelist type="inline">
255             
256             <member>
257                 
258                 <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link> を閲覧(これによりWebブラウザがオープンします).
259                 
260             </member>
261             
262             <member>
263                 
264                 <link linkend="compile_and_run_javasci_v2">Javasci v2でコンパイル/実行</link>
265                 
266             </member>
267             
268             <member>
269                 
270                 <link linkend="javasci_faq_v2">Javasci v2 FAQ</link>
271                 
272             </member>
273             
274         </simplelist>
275         
276     </refsection>
277     
278 </refentry>
279