LABCOM group is responsible for the LHD data acquisition and archiving system called the LABCOM System. Here, we provide various kinds of data related support for the LHD staffs and collaborators in data acquisitions and managements, and also in remote participation for the experiment. For more information, click the links for what you'd like to see or do.
Japanese
You are the th visitor since 4 July 2000
: Contents viewable in the Japanese font ONLY.
Contact : LABCOM
Privacy policy
Please be sure to read the above policy before entering and sending personal information from any forms.

How to retrieve diagnostic raw data and/or primarily processed data using "Retrieve".

...Contents viewable in the Japanese font ONLY.

Diagnostic raw data and primarily processed data can be retrieved by calling the "retrieve" procedure from the LHD data acquisition and archiving system. You can follow the practical steps described here:

Install the Retrieve package Please install the "Retrieve+dbStore" package suitable for your operating system, Windows or Linux edition.

↓

 　
Set the environmental variables (only when the installer did not set them). Usually, the environment variables are automatically set by the Retrieve installer. However, in case that the installer does not successfully set them, please manually set the environmental variables by following the instructions here.

↓

 　
Will you use PV-WAVE/IDL software?

NO →

 You can use command-line "Retrieve" executable. How to use the command-line tool can be found here.

　　↓YES

 　
Install data visualization software. You can install PV-WAVE or IDL if having the license. (NIFS has the site license.)
When using PV-WAVE
Install PV-WAVE
If you are in NIFS, you can download and install PV-WAVE package. Click here for installation details.
When using IDL
Install IDL
IDL can be downloaded from the Analysis Information Group homepage. Please follow the instructions there.

↓

 　
Specify the startup script Setup "Retrieve" to be available on PV-WAVE or IDL in their startup.
PV-WAVE
 Replace [folder where the Retrieve is installed (default　C:\LABCOM\Retrieve)] \lib\pv-wave\wavestartup with [folder where the PV-WAVE is installed (default C:\VNI)] \wave\bin\wavestartup.		 IDL
 After starting the program, specify [folder where the Retrieve is installed (default　C:\LABCOM\Retrieve)] \lib\idl\startup_user_idl.pro」 at the "startup file" found in [Preferences..] in the file menu.

↓

 　
Retrieve the data Start PV-WAVE or IDL, and retrieve the diagnostic data by "Retrieve" command.
*You can search acquired data. Go to Search for the Collected to see the progress of data acquisition.
Method of retrieving data

Retrieve diagnostic data by "Retrieve" procedure.

retrieve, diagName, shotNumber, subshotNumber, channelNumber, dataArray [,code] [,param=params] [,host=HostName]

diagName : Name of diagnostics（Bolometer, Magnetics, Halpha, ...)
shotNumber : Shot number
subshotNumber : Sub-shot number
channelNumber : Channel number (If you write “3:6” 3channs between 3 and 6 can be obtained.)
dataArray : Data Array (received data buffer)
code : Result code (no need to specify). You can find their meanings at "RetrieveDLL error code table" in start menu -- program -- LABCOM Retrieve+dbStore.
params : Array list of diagnostic parameters (optional)
HostName : Specify the server name to which you would request data. (optional)

* There is no need to declare data array (dataArray) beforehand to retrieve data.
* If you specify 0 for channelNumber, you can retrieve all the channels.
* Variable names are case insensitive.

Method of obtaining diagnostic parameters

Please pre-define a variable for the parameter array, e.g. "param= 1", before calling a retrieve command. If not, you cannot store parameters because of "no-definition-error".

e.g.) params=1
　　retrieve,'Bolometer',50000,1,1,data,param=params

For To see the list of obtained parameters, printParam procedure is available. Parameter values are shown within 23 characters.

e.g.) printParam,params

Every parameter (parameter name and parameter value) is stored as a string.
Following functions are available to see or convert the obtained parameter.

getParamLong : Convert into 32-bit signed integer
LongValue = getParamLong( paramName, params [,chanNumber] )
getParamInt : Convert into 16-bit signed integer
IntValue = getParamInt( paramName, params [,chanNumber] )
getParamFloat : Convert into 32-bit single precision real number
FloatValue = getParamFloat( paramName, params [,chanNumber] )
getParamDouble : Convert into 64-bit double precision real number
DoubleValue = getParamDouble( paramName, params [,chanNumber] )

e.g.) FloatValue=getParamFloat('Range',params)
　　info, FloatValue

Note that the function for diagnostic parameters has been implemented since the program ver 4.0. (Cannot be used for the data before the 3rd LHD experimental campaign and some of 4-th campaign.)
* You can see the beginning shot number list for each diagnostics after which the parameter function becomes available.
　 　

If you have any comments or questions about this page, please send them to LABCOM.