dshelper_lan_archive::set_archive

Source: dataset/helpers/lan_archive/dshelper_lan_archive__set_archive.pro

 dshelper_lan_archive::set_archive
        Select whether to plot from the raw ULA archive files or from the
        averaged UAV files.

 Call:
        dsref -> set_archive[, prefix, suffix, <keys>]
   or:
        dsref -> set_archive, spec

 Arguments:
        prefix  string  input   prefix for a user-defined file type.
        suffix  string  input   suffix for a user-defined file type.
        spec    {lan_arc_spec}  A full specification of the archive
                                type (mainly used by menu method).

 Keywords:
        ula     If set and non-zero, use ula archives.
        uav     If set and non-zero, use uav archives.
        cmp1d   If set and non-zero, use 1-day compressed archives.
        cmp6h   If set and non-zero, use 6-hour compressed archives
        uaf     If set and non-zero, use uaf filtered archives
        cuaf    If set and non-zero, use cuaf comressed filtered
                archives.
        hiscale, ulysses        If set and non-zero, then archives are 
                                for Ulysses/HISCALE (default)
        epam, ace       If set and non-zero, then archives are for Ace/EPAM
        resolution      float   input   Time resolution of the archive
                                        (unit given by keyword).
        duration        int     input   Number of days data per file.
        seconds, minutes, hours, days   If set specify units for
                                        resolution in the obvious way.
        sparse  If set and non-zero, then a user-defined
                archive has sparse records (like UAV and UAF), if set
                and zero then archive is compact (like ULA and CUAF).

 History:
        Prototype: 22/3/91; SJT
        Include selection of rate/exponents/fluxes: 25/3/91; SJT
        Add composition ratios: 19/7/91; SJT
        Add X-rays: 23/7/91; SJT
        Add number of channels to overlay: 25/7/91; SJT
        Unified Version: 4/9/91; SJT
        Replot locking: 13/9/91; SJT
        Add lock for PLOT_MAG, PLOT_PAD and PLOT_SPECT: 22/7/92; SJT
        Add 1-Day and 6-hour archives: 26/10/92; SJT
        Add UAF archives: 23/7/93; SJT
        Add CUAV & CUAF archives: 22/8/94; SJT
        Thorough rebuild: 21/10/94; SJT
        Deal with ala etc. for EPAM: 3/11/98; SJT
        Make into a dshelper_lan_archive method: 17/12/99; SJT
        Fix the status flag clearings: 7/6/02; SJT