RadarGetCode

Syntax

char *RadarGetCode(struct RadarNetwork *ptr,int stid,int cnum);

Header

superdarn/radar.h

Library

radar

Description

The RadarGetCode function locates the station identifier code for one of the radars.

The argument ptr is a pointer to a structure containing the information for the entire network. The radar identifier number for the radar is given by the argument stid.

Originally, radars were identified using a single letter code. However as the network has expanded, multiple letter codes are now used. To maintain compatibility, radars can have multiple identifier codes defined. The argument cnum is used to select which identifier code is returned.

Returns

Returns a pointer to a zero terminated text string that contains the radar code. On error, a NULL pointer is returned.

Errors

On error, a NULL pointer is returned.

Example

Source Code: RadarGetCode.c

/* RadarGetCode
   ============
   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 "radar.h"

struct RadarNetwork *network; 

int main(int argc,char *argv[]) {
  char *envstr;
  FILE *fp;
  int codenum=0;
  char *code=NULL;
  int st,c;

  envstr=getenv("SD_RADAR");
  if (envstr==NULL) {
    fprintf(stderr,"Environment variable 'SD_RADAR' must be defined.'n");
    exit(-1);
  }

  fp=fopen(envstr,"r");

  if (fp==NULL) {
    fprintf(stderr,"Could not locate radar information file.'n");
    exit(-1);
  }

  network=RadarLoad(fp);
  fclose(fp); 
  if (network==NULL) {
    fprintf(stderr,"Failed to read radar information.'n");
    exit(-1);
  }
  
  st=atoi(argv[argc-1]);

  codenum=RadarGetCodeNum(network,st);

  fprintf(stdout,"RadarGetCode'n"); 
  for (c=0;c<codenum;c++) {
    code=RadarGetCode(network,st,c);
    fprintf(stdout,"%s'n",code);
  }

  return 0;
}