rsl_add_volume

This procedure adds a new volume to an existing radar structure.

Note: the value of radar.h.nvolumes is incremented by this procedure.

Syntax

rsl_add_volume, radar [, new_volume] [, FIELD=string]

Arguments

radar A radar structure.
new_volume Volume structure to be added to the radar structure. If not given, a new volume containing initialized values is created in the radar structure.

Keywords

FIELD String naming new field. This replaces the field type in the new volume header and sweep headers.

Examples

Example 1

Copy volume from radar, modify data, then add the modified volume to radar.
; Copy an existing volume.
vol = rsl_get_volume(radar,'dz')

; Modify data in vol.
vol.sweep.ray.range = . . .

; Add vol to radar structure, naming the new field 'FZ'.
rsl_add_volume, radar, vol, field='FZ'

Example 2

Add a volume to radar first, then store data.
; Add new volume to radar, and name the new field 'FZ'.
rsl_add_volume, radar, field='FZ'
   
; Modify data in new volume.
newvol = radar.h.nvolumes - 1
radar.volume[newvol].sweep.ray.range = . . .

See Also

rsl_changefield