WOLFRAM

Wolfram言語 ＆ システム ドキュメントセンター
Wolfram言語ホームページ »
OpenCLLink`
OpenCLLink`

OpenCLMemoryLoad

OpenCLMemoryLoad[list]

list をOpenCLMemoryマネージャにロードし，OpenCLMemoryを返す．

OpenCLMemoryLoad[list,type]

特定の type を持つ list をOpenCLMemoryマネージャにロードし，OpenCLMemoryを返す．

詳細とオプション

  • OpenCLLink アプリケーションは，Needs["OpenCLLink`"]を使ってロードしなければならない．
  • 有効なOpenCLMemoryLoadの型：
  • IntegerRealComplex
    "Byte""Bit16""Integer"
    "Byte[2]""Bit16[2]""Integer32[2]"
    "Byte[4]""Bit16[4]""Integer32[4]"
    "Byte[8]""Bit16[8]""Integer32[8]"
    "Byte[16]""Bit16[16]""Integer32[16]"
    "UnsignedByte""UnsignedBit16""UnsignedInteger"
    "UnsignedByte[2]""UnsignedBit16[2]""UnsignedInteger[2]"
    "UnsignedByte[4]""UnsignedBit16[4]""UnsignedInteger[4]"
    "UnsignedByte[8]""UnsignedBit16[8]""UnsignedInteger[8]"
    "UnsignedByte[16]""UnsignedBit16[16]""UnsignedInteger[16]"
    "Double""Float""Integer64"
    "Double[2]""Float[2]""Integer64[2]"
    "Double[4]""Float[4]""Integer64[4]"
    "Double[8]""Float[8]""Integer64[8]"
    "Double[16]""Float[16]""Integer64[16]"
  • OpenCLMemoryは，OpenCLMemoryInformationを使って問合せを行うことができる．
  • OpenCLMemoryは，OpenCLMemoryGetを使って取り込まれる．
  • OpenCLMemoryは，OpenCLMemoryUnloadを使ってアンロードされる．
  • OpenCLMemoryAllocateは，メモリが出力メモリ等に書き込まれるために割り当てられなければならない場合に使用される．
  • 使用できるオプション：
  • "Device" Automatic計算に使用するOpenCLデバイス
    "Platform" Automatic計算に使用するOpenCLプラットフォーム
    "TargetPrecision" Automatic計算で使用する精度

例題

すべて開くすべて閉じる

例  (5)基本的な使用例

まず OpenCLLink アプリケーションをロードする：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-dvgu9k

リストConstantArray[0,10]を OpenCLLink メモリマネージャに登録する：

In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-ghbd1f
Out[2]=2

ベクトルの型はロードすることができるが，型の幅の必要条件（例えば，"Byte16"の幅は16である）に従わなければならない：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-c8o5ao
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-fo53h7
Out[2]=2

さもなければ，エラーが返される：

In[3]:=3
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-g8gobn
Out[3]=3

画像をOpenCLMemoryとしてロードすることができる：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-gv09
Out[1]=1

デフォルトで，画像は整数のリストとして表されるが，別の型を使うこともできる：

In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-dfe1wh
Out[2]=2

グラフィックスオブジェクトを追加する際には，オブジェクトはラスタライズされる：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-nkjny0
Out[1]=1

メモリを得ようとすると，画像が返される：

In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-19qj3
Out[2]=2

型Realを使う場合，"Float"と"Double"のどちらであるかは，OpenCLデバイスによる：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-m1c8
Out[1]=1

この場合は，システムが倍精度をサポートする．これは"TargetPrecision"オプションを使って無効にすることができる：

In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-cd15h
Out[2]=2

オプション  (3)各オプションの一般的な値と機能

"Device"  (1)

計算に使用するデバイスは選ぶことができるが，一旦別のOpenCLの呼出しで設定されると，これを変更することはできない：

In[13]:=13
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-gt1iw6
Out[13]=13

"Platform"  (1)

計算に使用するプラットフォームは選ぶことができるが，一旦別のOpenCLの呼出しで設定されると，これを変更することはできない：

In[14]:=14
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-cxv8vv
Out[14]=14

"TargetPrecision"  (1)

目標精度を使って OpenCLLink にRealの型をどのように解釈するかを伝えることができる．デフォルトでこれは，システムが倍精度をサポートするかどうかを検知することによって決定される：

In[15]:=15
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-ecx7wk
Out[15]=15

このシステムは倍精度をサポートする：

In[16]:=16
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-i0jmn1
Out[16]=16

Realの型は"Double"として解釈される．"Float"の使用を強制するためには， "TargetPrecision"を"Single"に設定する：

In[17]:=17
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-xnm96
Out[17]=17

アプリケーション  (2)この関数で解くことのできる問題の例

2つを入力リストに加える：

In[18]:=18
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-k8h4l
Out[15]=15

OpenCLFunctionLoadを使って関数をロードする：

In[19]:=19
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-ce6n09
Out[19]=19

OpenCLFunctionを実行する：

In[20]:=20
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-jhy32g
Out[20]=20

OpenCLMemoryGetを使ってメモリを得る：

In[21]:=21
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-b107nh
Out[21]=21

OpenCLMemoryUnloadを使ってメモリをアンロードする：

In[22]:=22
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-lgkbk1

OpenCLMemoryLoadは，見えないところでメモリをロードするのに内部的に使われる．入力画像の色を無効にする：

In[1]:=1
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-lva4m5

OpenCLFunctionLoadを使って関数をロードする：

In[2]:=2
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-eoy5m3
Out[2]=2

入力パラメータを定義する：

In[3]:=3
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-ipmruc

OpenCLFunctionを実行する：

In[4]:=4
✖
https://wolfram.com/xid/0cewhkl4xs6a84rqsmphy8c4i-e0a8rs
Out[4]=4
Wolfram Research (2010), OpenCLMemoryLoad, Wolfram言語関数， https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.
✖
Wolfram Research (2010), OpenCLMemoryLoad, Wolfram言語関数， https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.

テキスト

Wolfram Research (2010), OpenCLMemoryLoad, Wolfram言語関数， https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.

✖
Wolfram Research (2010), OpenCLMemoryLoad, Wolfram言語関数， https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.

CMS

Wolfram Language. 2010. "OpenCLMemoryLoad." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.

✖
Wolfram Language. 2010. "OpenCLMemoryLoad." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html.

APA

Wolfram Language. (2010). OpenCLMemoryLoad. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html

✖
Wolfram Language. (2010). OpenCLMemoryLoad. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html

BibTeX

@misc{reference.wolfram_2025_openclmemoryload, author="Wolfram Research", title="{OpenCLMemoryLoad}", year="2010", howpublished="\url{https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html}", note=[Accessed: 22-June-2025 ]}

✖
@misc{reference.wolfram_2025_openclmemoryload, author="Wolfram Research", title="{OpenCLMemoryLoad}", year="2010", howpublished="\url{https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html}", note=[Accessed: 22-June-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_openclmemoryload, organization={Wolfram Research}, title={OpenCLMemoryLoad}, year={2010}, url={https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html}, note=[Accessed: 22-June-2025 ]}

✖
@online{reference.wolfram_2025_openclmemoryload, organization={Wolfram Research}, title={OpenCLMemoryLoad}, year={2010}, url={https://reference.wolfram.com/language/OpenCLLink/ref/OpenCLMemoryLoad.html}, note=[Accessed: 22-June-2025 ]}