kernel.c File Reference

Calculate kernel functions. More...

#include "jurassic.h"

Go to the source code of this file.

Functions
void	call_kernel (const ctl_t *ctl, const tbl_t *tbl, const char *wrkdir, const char *obsfile, const char *atmfile, const char *kernelfile)
	Perform kernel calculations in a single directory. More...
void	usage (void)
	Print command-line help. More...
int	main (int argc, char *argv[])

Detailed Description

Calculate kernel functions.

Definition in file kernel.c.

Function Documentation

call_kernel()

void call_kernel	(	const ctl_t *	ctl,
		const tbl_t *	tbl,
		const char *	wrkdir,
		const char *	obsfile,
		const char *	atmfile,
		const char *	kernelfile
	)

Perform kernel calculations in a single directory.

Definition at line 160 of file kernel.c.

                          {
 
  static atm_t atm;
  static obs_t obs;
 
  /* Read observation geometry... */
  SELECT_TIMER("READ_OBS", "INPUT");
  read_obs(wrkdir, obsfile, ctl, &obs, 0);
 
  /* Read atmospheric data... */
  SELECT_TIMER("READ_ATM", "INPUT");
  read_atm(wrkdir, atmfile, ctl, &atm, 0);
 
  /* Get sizes... */
  const size_t n = atm2x(ctl, &atm, NULL, NULL, NULL);
  const size_t m = obs2y(ctl, &obs, NULL, NULL, NULL);
 
  /* Check sizes... */
  if (n == 0)
    ERRMSG("No state vector elements!");
  if (m == 0)
    ERRMSG("No measurement vector elements!");
 
  /* Allocate... */
  gsl_matrix *k = gsl_matrix_alloc(m, n);
 
  /* Compute kernel matrix... */
  SELECT_TIMER("KERNEL", "FORWARD");
  kernel(ctl, tbl, &atm, &obs, k);
 
  /* Write matrix to file... */
  SELECT_TIMER("WRITE_MATRIX", "OUTPUT");
  write_matrix(wrkdir, kernelfile, ctl, k, &atm, &obs, "y", "x", "r", 0);
 
  /* Free... */
  gsl_matrix_free(k);
}

Here is the call graph for this function:

usage()

void usage

(

void

)

Print command-line help.

Definition at line 117 of file kernel.c.

        {
 
  printf("\nJURASSIC kernel tool.\n\n");
  printf("Compute Jacobian or kernel matrices for the configured channels\n");
  printf
    ("from observation geometry, atmospheric state, and control settings.\n\n");
  printf("Usage:\n");
  printf("  kernel <ctl> <obs> <atm> <kernel> [KEY VALUE ...]\n\n");
  printf("Arguments:\n");
  printf("  <ctl>     Control file.\n");
  printf("  <obs>     Observation geometry input file.\n");
  printf("  <atm>     Atmospheric state input file.\n");
  printf("  <kernel>  Output file for the kernel matrix.\n");
  printf("  [KEY VALUE]  Optional control parameters.\n\n");
  printf("Tool-specific control parameters:\n");
  printf
    ("  DIRLIST <file>   Read working directories from <file> and run one case\n");
  printf
    ("                   per directory using the same <obs>, <atm>, and\n");
  printf
    ("                   <kernel> filenames relative to each listed directory.\n");
  printf("\n");
  printf("Common control parameters:\n");
  printf
    ("  TBLBASE, TBLFMT               Lookup-table base name and format.\n");
  printf("  ATMFMT, OBSFMT, MATRIXFMT     Input/output file formats.\n");
  printf("  NG, EMITTER[i]                Active emitters.\n");
  printf("  ND, NU[i], NW, WINDOW[i]      Spectral channels and windows.\n");
  printf
    ("  NCL, CLNU[i], NSF, SFNU[i]    Cloud and surface spectral grids.\n");
  printf("  RET*_ZMIN, RET*_ZMAX          State-vector altitude limits.\n");
  printf
    ("  WRITE_BBT, FORMOD             Output units and forward-model selection.\n");
  printf("  CTM_*, REFRAC                 Continua and refractivity.\n");
  printf
    ("  RAYDS, RAYDZ, FOV             Ray tracing and field of view.\n\n");
  printf("Further information:\n");
  printf("  Manual: https://slcs-jsc.github.io/jurassic/\n");
}

main()

int main	(	int	argc,
		char *	argv[]
	)

Definition at line 48 of file kernel.c.

                {
 
  static ctl_t ctl;
 
  char dirlist[LEN];
 
  /* Print usage information... */
  USAGE;
 
  /* Check arguments... */
  if (argc < 5)
    ERRMSG("Missing or invalid command-line arguments.\n\n"
           "Usage: kernel <ctl> <obs> <atm> <kernel> [KEY VALUE ...]\n\n"
           "Use -h for full help.");
 
  /* Read control parameters... */
  SELECT_TIMER("READ_CTL", "INPUT");
  read_ctl(argc, argv, &ctl);
 
  /* Initialize look-up tables... */
  SELECT_TIMER("READ_TBL", "INPUT");
  tbl_t *tbl = read_tbl(&ctl);
 
  /* Get dirlist... */
  SELECT_TIMER("READ_DIRLIST", "INPUT");
  scan_ctl(argc, argv, "DIRLIST", -1, "-", dirlist);
 
  /* Set flags... */
  ctl.write_matrix = 1;
 
  /* Single kernel calculation... */
  if (dirlist[0] == '-')
    call_kernel(&ctl, tbl, NULL, argv[2], argv[3], argv[4]);
 
  /* Work on directory list... */
  else {
 
    /* Open directory list... */
    FILE *in;
    if (!(in = fopen(dirlist, "r")))
      ERRMSG("Cannot open directory list!");
 
    /* Loop over directories... */
    char wrkdir[LEN];
    while (fscanf(in, "%4999s", wrkdir) != EOF) {
 
      /* Write info... */
      LOG(1, "\nWorking directory: %s", wrkdir);
 
      /* Call forward model... */
      call_kernel(&ctl, tbl, wrkdir, argv[2], argv[3], argv[4]);
    }
 
    /* Close dirlist... */
    fclose(in);
  }
 
  /* Free... */
  SELECT_TIMER("FINALIZE", "OVERHEAD");
  tbl_free(&ctl, tbl);
  PRINT_TIMERS;
 
  return EXIT_SUCCESS;
}

Here is the call graph for this function: