IDL Command: vso files

IDL Command: vso_files

Purpose

vso_files allows searching the VSO from within an active SSW IDL session. It returns one or many HTTP links to data that match the given search criteria. vso_files allows for time and instrument based search only. See vso_search for the more generic VSO search routine.

Description

; Routine syntax
urls = vso_files(tstart, tend, instrument=instrument)

The tstart and instrument are mandatory, tend is optional. If tend is not given, the search will return only the one date that is closest to tstart. Otherwise, all data in the given interval are returned.

Keyword	Description	Example
tstart	This is the start time for the search interval. If tend is not specified, then the date closest to tend is returned. Time is in TAI.	'1-may-07', '21-apr-2009 10:01'
tend	This is the end time for the search interval. Time is in TAI.	'2-may-2009'
instrument	This parameter specifies the type of instrument to search for.	instrument='eit', instr='euvi'

Requirements

• Up-to-date SSW gen tree, installation and download instructions

Troubleshooting

IDL error: Cannot connect to port 80 (and similar messages)

Due to networking errors, it can happen that vso_files cannot connect to the VSO. If this occurs, check if your networking connection is working. If that is the case, try calling vso_files again later.

Examples

The following commands show how to search for data in the VSO.

; This will return one HTTP link to an EIT image closest to April 21, 2002 00:00
file=vso_files('21-apr-2002', instr='eit')

; This will return HTTP links to EUVI images between April 21, 2002 10:10 and April 21, 2002 11:00
files=vso_files('21-apr-2002 10:10', '21-apr-2002 11:00', instrument='euvi')