
/*
 *   THIS FILE IS UNDER RCS - DO NOT MODIFY UNLESS YOU HAVE
 *   CHECKED IT OUT USING THE COMMAND CHECKOUT.
 *
 *    $Id: readstas.c,v 1.2 2004/05/05 23:54:03 lombard Exp $
 *
 *    Revision history:
 *     $Log: readstas.c,v $
 *     Revision 1.2  2004/05/05 23:54:03  lombard
 *     Added location code: reads TYPE_TRACEBUF2 messages,
 *     writes TYPE_CARLSTATRIG_SCNL messages.
 *     Removed OS2 support.
 *
 *     Revision 1.1  2000/02/14 16:12:07  lucky
 *     Initial revision
 *
 *
 */

/*
 * readstas.c: Read the network stations from a file.
 *              1) Create a list of stations based on the input file.
 *              2) Sort the station array for calls to bsearch()
 */

/*******                                                        *********/
/*      Functions defined in this source file                           */
/*******                                                        *********/

/*      Function: ReadStations                                          */
/*                                                                      */
/*      Inputs:         Pointer to the CarStaTrig World structure       */
/*                                                                      */
/*      Outputs:        Updated station list(above)                     */
/*                                                                      */
/*      Returns:        0 on success                                    */
/*                      Error code as defined in carlstatrig.h on       */
/*                      failure                                         */
/*                                                                      */
/*      Auxiliary function: IsComment                                   */
/*                                                                      */
/*      Inputs:         Pointer to a string containing a line from      */
/*                      CarlStaTrig station list                        */
/*                                                                      */
/*      Outputs:        Comment determination                           */
/*                                                                      */
/*      Returns:        1 if it's a comment line                        */
/*                      0 if it's not a comment line                    */


/*******                                                        *********/
/*      System Includes                                                 */
/*******                                                        *********/
#include <stdio.h>
#include <stdlib.h>     /* malloc, qsort                                */
#include <string.h>     /* strcpy                                       */

/*******                                                        *********/
/*      Earthworm Includes                                              */
/*******                                                        *********/
#include <earthworm.h>  /* logit                                        */

/*******                                                        *********/
/*      CarlStaTrig Includes                                            */
/*******                                                        *********/
#include "carlstatrig.h"

/*******                                                        *********/
/*      Function definitions                                            */
/*******                                                        *********/
static int IsComment( char string[] );

/*      Function: ReadStations                                          */
int ReadStations( WORLD* cstWorld )
{
  char          keyword[MAXLINELEN];
  char          inBuf[MAXLINELEN];      /* Input buffer.                */
  FILE*         staFile;        /* Pointer to the station file stream.  */
  STATION       *sta;
  int           retVal = 0;     /* Return value for this function.      */
  int           i, nsta;
  
  /*    Validate the input parameter                                    */
  if ( cstWorld->cstParam.staFile )
  {
    /*  Open the stations file                                          */
    if ( staFile = fopen( cstWorld->cstParam.staFile, "r" ) )
    {
      /* Count channels in the station file.
         Ignore comment lines and lines consisting of all whitespace.
         ***********************************************************/
      nsta = 0;
      while ( fgets( inBuf, MAXLINELEN - 1, staFile ) != NULL )
        if ( !IsComment( inBuf ) ) nsta++;

      rewind( staFile );

      /*        Allocate the station list                               */
      if ( sta = (STATION *) calloc( (size_t) nsta, sizeof(STATION) ) )
      {
        /*      Properly initialize all the station structures          */
        for ( i = 0; i < nsta; i++ )
        {
          retVal = InitializeStation( &(sta[i]) );
          if ( CT_FAILED( retVal ) )
            break;
        }

        /* Read stations from the station list file into station array */
        i = 0;
        while ( fgets( inBuf, MAXLINELEN, staFile ) != NULL )
        {
          int ttl; /* read ttl don't save it here */
            
          /*    Check for comments                                      */
          if ( IsComment( inBuf ) ) continue;
            
          /*    Process the line                                        */
          if ( 6 != sscanf( inBuf, "%s %s %s %s %s %d", keyword, 
			    sta[i].staCode, sta[i].compCode, sta[i].netCode, 
			    sta[i].locCode, &ttl ) )
          {
            logit( "et",
                   "carlStaTrig: Unable to find station parameters in '%s'.\n",
                   inBuf );
            retVal = ERR_STA_READ;
            break;
          }

          if ( ttl == 0 ) /* Don't use these stations */
          {
            nsta--;
            continue;
          }
            
          /* ok, get ready for the next station */
          i++;
        }
      }
      
      else 
      {
        logit( "et", "carlStaTrig: Cannot allocate the station array\n" );
        retVal = ERR_MALLOC;
      }
      
      /*        Close the input file                                    */
      fclose( staFile );
      
      /*        Sort the station array so bsearch() will work           */
      qsort( sta, (size_t) nsta, sizeof(STATION), CompareSCNs );

      logit("", "Sorted station list:\n");
      for ( i = 0; i < nsta; i++ )
          logit( "", "\t%s.%s.%s.%s\n", 
                 sta[i].staCode, sta[i].compCode, sta[i].netCode, 
		 sta[i].locCode);
      cstWorld->stations = sta;
      cstWorld->nSta = nsta;
      
    }
    else
    {
      logit( "et", "carlStaTrig: Error attempting to open '%s'.\n", 
             cstWorld->cstParam.staFile );
      retVal = ERR_STA_OPEN;
    }
  }
  else
  {
    logit( "et", "carlStaTrig: No stations file to open.\n" );
    retVal = ERR_STA_OPEN;
  }

  return ( retVal );
}


/***************************************************************************/

static int IsComment( char string[] )
{
  int i;

  if ( string[0] == '\n') return 1; /* It's an empty line */
  
  for ( i = 0; i < (int)strlen( string ); i++ )
  {
    char test = string[i];

    if ( test!=' ' && test!='\t' )
    {
      if ( test == '#'  )
        return 1;          /* It's a comment line */
      else
        return 0;          /* It's not a comment line */
    }
  }
  return 1;                   /* It contains only whitespace */
}
