obsfmt.c

Go to the documentation of this file.

/*
  This file is part of JURASSIC.
  
  JURASSIC 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.
  
  JURASSIC 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 JURASSIC. If not, see <http://www.gnu.org/licenses/>.
  
  Copyright (C) 2013-2026 Forschungszentrum Juelich GmbH
*/
 
#include "jurassic.h"
 
/* ------------------------------------------------------------
   Functions...
   ------------------------------------------------------------ */
 
static void usage(
  void);
 
/* ------------------------------------------------------------
   Main...
   ------------------------------------------------------------ */
 
int main(
  int argc,
  char *argv[]) {
 
  ctl_t ctl;
 
  static obs_t obs;
 
  /* Print usage information... */
  USAGE;
 
  /* Check arguments... */
  if (argc < 6)
    ERRMSG("Missing or invalid command-line arguments.\n\n"
           "Usage: obsfmt <ctl> <obs_in> <obsfmt_in> <obs_out> <obsfmt_out> [KEY VALUE ...]\n\n"
           "Use -h for full help.");
 
  /* Read control parameters... */
  read_ctl(argc, argv, &ctl);
 
  /* Read profile indices... */
  const int prof_in = (int) scan_ctl(argc, argv, "PROF_IN", -1, "0", NULL);
  const int prof_out = (int) scan_ctl(argc, argv, "PROF_OUT", -1, "0", NULL);
 
  /* Read observation data... */
  ctl.obsfmt = atoi(argv[3]);
  read_obs(NULL, argv[2], &ctl, &obs, prof_in);
 
  /* Write observation data... */
  ctl.obsfmt = atoi(argv[5]);
  write_obs(NULL, argv[4], &ctl, &obs, prof_out);
 
  return EXIT_SUCCESS;
}
 
/*****************************************************************************/
 
static void usage(
  void) {
  printf("\nJURASSIC observation-format converter.\n\n");
  printf("Convert observation files between supported OBSFMT formats.\n\n");
  printf("Usage:\n");
  printf("  obsfmt <ctl> <obs_in> <obsfmt_in> <obs_out> <obsfmt_out>\n");
  printf("         [KEY VALUE ...]\n\n");
  printf("Arguments:\n");
  printf("  <ctl>         Control file.\n");
  printf("  <obs_in>      Input observation data file.\n");
  printf("  <obsfmt_in>   Input observation file format identifier.\n");
  printf("  <obs_out>     Output observation data file.\n");
  printf("  <obsfmt_out>  Output observation file format identifier.\n");
  printf("  [KEY VALUE]   Optional control parameters.\n\n");
  printf("Tool-specific control parameters:\n");
  printf("  PROF_IN <n>   Read profile index <n> from the input file.\n");
  printf("  PROF_OUT <n>  Write output as profile index <n>.\n\n");
  printf("Common control parameters:\n");
  printf
    ("  ND, NU[i]              Spectral channels in observation files.\n");
  printf("  WRITE_BBT              Brightness-temperature output flag.\n\n");
  printf("Further information:\n");
  printf("  Manual: https://slcs-jsc.github.io/jurassic/\n");
}