rate_dataset::acquire_lan_rates_sparse

Source: dataset/rate/rate_dataset__acquire_lan_rates_sparse.pro

 rate_dataset::acquire_lan_rates
       Reads in the data from the file and stores the appropriate parts of it
       in the arrays rates and times.

 Call:
       code = dsref -> acquire_lan_rate(strnos, {/hiscale|/epam})


 Arguments:
        strnos  long    A list of the stream indices which are to be
                        read by this invocation

 Keywords:
        hiscale If set, then this we are reading HISCALE data.
        epam    If set, then we are reading EPAM data.

 History:
       Converted to routine: 28/1/91; SJT
       Facility to extend arrays added: 1/1/91; SJT
       Accept a range of rate fields: 1/1/91; SJT
       Moved time limits to common: 7/2/91; SJT
       Moved plot settings to common: 7/2/91; SJT
       Moved data arrays to common: 7/2/91; SJT
       Clean up (use array ops etc.): 22/2/91; SJT
       Fix times when >2days data present: 25/2/91; SJT
       Request file type and pass to make_fname: 12/3/91; SJT
               (also potentially problematic 'case's fixed)
       Tidy extension of 'time' and change SUMMED sectors to AVERAGED
               sectors - more meaningful since c/s: 21/3/91; SJT
       "RATES" version: 21/3/91; SJT
       Modify to accomodate fluxes & exponenents: 25/3/91; SJT
       Handle intervals including e-o-year: 10/4/91; SJT
       Automatic choice of archive name: 19/4/91; SJT
       Accomodate selected sector and composition ratios: 19/7/91; SJT
       Include X-ray rates: 23/7/91; SJT
       Remove LANIO versions of open_lanfile: 24/7/91; SJT
       Acquire multiple channels: 25/4/91; SJT
       Fix bug in acquiring unmergable channels: 1/8/91; SJT
       More array ops for speed in accumulation: 8/8/91; SJT
       UNified version: 27/8/91; SJT
       Tidy up by use of TAG_NAMES and numerical tag refs: 28/8/91; SJT
       Start/stop in middle of group: 18/9/91; SJT
        Extended & sectored comp ratios: 5/11/91; SJT
        Add checking of version numbers: 2/1/92; SJT
        Get accumulation times: 3/1/92; SJT
        Use MAP/SEEK to position files: 16/1/92; SJT
        Make end times conform to time range: 30/1/92; SJT
        Fix bug in above and in opening next file rules: 19/2/92; SJT
        Add internal flux calculations: 10/6/92; SJT
        Handle 1-day & 6-hour files: 27/10/92; SJT
        Remove monitor toggle in widget-mode: 22/2/93; SJT
        Simplify & correct time differences: 8/6/93; SJT
        Spin off file handling to GET_LAN_RECORD: 13/8/93; SJT
        Add accumulation of spacecraft position: 21/2/94; SJT
        Do accums for all types: 15/4/94; SJT
        Add "singles" duty cycle: 29/4/94; SJT
        Add checks for dud data: 11/11/94; SJT
        Check for no valid data (return error): 14/2/95; SJT
        Convert to rate_dataset method: dec/99; SJT
        Removed idfref argument: 6/3/00; SJT
        Redesign refcounting: 9/2/01; SJT