CnvMapRead

Syntax

int CnvMapRead(int fid,struct CnvMapData *map,struct GridData *grd);

Header

superdarn/cnvmapread.h

Library

cnvmap

Description

The CnvMapRead function reads a convection map from an open file.

The convection map is read from the file with the descriptor given by the argument fid. The parameters and co-efficients used to generate the convection map are stored in the structure pointed to by the argument map. The gridded data used to generate the map is stored in the structure pointed to by the argument grd.

Returns

Returns the number of bytes used to store the convection map on success. On error, (-1) is returned.

Errors

On error, (-1) is returned.

Example

Source Code: CnvMapRead.c

/* CnvMapRead.c
   =============
   Author: R.J.Barnes

Copyright (c) 2012 The Johns Hopkins University/Applied Physics Laboratory

This file is part of the Radar Software Toolkit (RST).

RST is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

Modifications:


*/


#include <stdio.h>
#include <stdlib.h>

#include "rtypes.h"
#include "rtime.h"
#include "dmap.h"
#include "limit.h"
#include "griddata.h"
#include "cnvmap.h"
#include "cnvmapread.h"

  struct CnvMapData map;
  struct GridData grd;


int main(int argc,char *argv[]) {
 
  FILE *fp;
  int fd;

  int yr,mo,dy,hr,mt;
  double sc;

  fp=fopen(argv[1],"r");


  if (fp==NULL) {
    fprintf(stderr,"File not found.'n");
    exit(-1);
  }

  fd=fileno(fp);
  while(CnvMapRead(fd,&map,&grd) !=-1) {

    TimeEpochToYMDHMS(map.st_time,&yr,&mo,&dy,&hr,&mt,&sc);
    fprintf(stdout,"%.4d-%.2d-%.2d %.2d:%.2d:%.2d pnts=%d'n",
            yr,mo,dy,hr,mt,(int) sc,grd.vcnum);


    
  }
 
  fclose(fp);


  return 0;
}