prep = obj_new('preprocessor')
prep->setInstrument, instrument
prep->addArgument, argName, argValue
prep->setOutfile, outfile
prep->setInfile, infile
prep->preprocess
preprocessor requires the SSW gen tree and all appropriate instrument packages to be installed (best if calibration data are available).
The preprocessor object is part of the PrepServer application. It's task is to redirect and execute preprocessing requests. In order for it
to be used from the Java server application, preprocessor is exportet to Java.
The file name is preprocessor__define.pro which is not included in SSW but only available to the PrepServer application.
| instrument | This parameter specifies the image's instrument type. Currently, following values are allowed: eit, rhessi For information about the instrument preprocessing parameters, please refer to the appropriate IDL object description in SSW gen tree. | |
| infile | Optional. The file parameter can be omitted if the instrument's preprocessing package implements an interval search, such as rhessi. Otherwise, it is a hyperlink to a web repository, a file path to a local file or a byte array of data. | |
| outfile | Specifies the output file path and name. Currently, that parameter cannot be left out. If done so anyway, the created image might end up anywhere on the system and will not be able to | |
| argName | This is the parameter name used by the called preprocessing routine, such as for example cosmic for eit. | |
| argValue | This is the actual value, that goes with argname. It can be of any of the following types (including there array versions): String, boolean, byte, integer, long, float, double. |
None of the routines have return values.
The preprocessing routine might fail for various reasons. The routine vso_debug might give further information. Improved debugging functionality will be introduced in a future release.
Generally, this object should not be used directly! The following example creates a clean rhessi image from the given interval and plots it. Bear in mind, that the rhessi instrument tree must be installed. Probably, search_network, /enabled should be activate too, in case the necessary calibration data are not available.
IDL> prep = obj_new('preprocessor')
IDL> prep->setInstrument, 'rhessi'
IDL> prep->setInfile, ''
IDL> prep->setOutfile, 'rhessi_out.fits'
IDL> prep->addArgument, 'image_alg', 'clean'
IDL> prep->addArgument, 'im_time_interval', ['21-apr-2002 01:15', '21-apr-2002 01:16']
IDL> prep->preprocess
IDL> rhessi = obj_new('rhessi')
IDL> rhessi->read, 'rhessi_out.fits'
IDL> rhessi->plot, /color