IDL Command: vso search: Difference between revisions
Jump to navigation
Jump to search
imported>Elaszlo m (Vso search moved to IDL Command: vso search: Nicer title) |
imported>Elaszlo mNo edit summary |
||
| Line 4: | Line 4: | ||
== Description == | == Description == | ||
<source lang="ittvis_idl"> | <source lang="ittvis_idl"> | ||
data = [f]vso_search[/f](tstart, tend, wave=wave, extent=extend, physobs=physobs, provider=provider, source=source, instrument=instrument) | |||
</source> | </source> | ||
Revision as of 19:32, 17 August 2010
Purpose
vso_search is a generalization of vso_files. It allows searching the VSO not only by instrument and time, but many more parameters. The returned result is a VSO data structure that contains all the data that matched the search.
Description
data = [f]vso_search[/f](tstart, tend, wave=wave, extent=extend, physobs=physobs, provider=provider, source=source, instrument=instrument)One of the two parameters tstart or tend must be specified. All other parameters are optional. Please notice that the list of parameters is abbreviated. See the documentation for vso_search.pro in the SSW installation folder for more information.
| Keyword | Description | Example |
|---|---|---|
| tstart | Start time | '21-april-2002' |
| tend | End time | '22-april-2002' |
| wave | (min) - (max) (unit) | wave='284-305 Angstrom' |
| extend | VSO 'extent type' ... (FULLDISK, CORONA, LIMB, etc) | extent='CORONA' |
| physobs | VSO 'physical observable | physobs='los_magnetic_field' |
| provider | VSO ID for the data provider (SDAC, NSO, SHA, MSU, etc) | provider='sdac' |
| source | spacecraft or observatory (SOHO, YOHKOH, BBSO, etc) | source='SOHO' |
| instrument | instrument ID (EIT, SXI-0, SXT, etc) | instrument='eit' |
Requirements
- Up-to-date SSW gen tree, installation and download instructions
Troubleshooting
IDL error: Cannot connect to port 80 (and similar messages)
Network timeouts can lead to this error. Try searching again later.
Examples
The following examples were taken from the vso_search.pro IDL file.
a = [f]vso_search[/f](date='2004-01-01', provider='sdac')
a = [f]vso_search[/f](date='2002-1-4T07:05', inst='mdi')
a = [f]vso_search[/f](date='2004/1/4T07:40-2004/1/4T07:45', inst='trace')
a = [f]vso_search[/f](date='2004-1-1', extent='CORONA', /FLAT)
a = [f]vso_search[/f](date='2001-1-1', physobs='los_magnetic_field')
a = [f]vso_search[/f](date='2004/1/1', inst='eit', /DEBUG)
a = [f]vso_search[/f]('2004/1/1','2004/12/31', wave='171 Angstrom', inst='eit')
a = [f]vso_search[/f]('2004/6/1','2004/6/15', wave='284-305 Angstrom', inst='eit')
a = [f]vso_search[/f]('2005-JAN-1', inst='eit', /FLAT, /URL)