Geografic-Information-System/lib/gis/rd_cellhd.c

/*!
  \file lib/gis/rd_cellhd.c
  
  \brief GIS Library - Read cell header or window
  
  (C) 1999-2011 by the GRASS Development Team
  
  This program is free software under the GNU General Public License
  (>=v2). Read the file COPYING that comes with GRASS for details.
  
  \author USACERL and others
*/

#include <string.h>

#include <grass/gis.h>
#include <grass/glocale.h>

static int scan_item(const char *, char *, char *);
static int scan_int(const char *, int *);
static double scan_double(const char *, double *);

#define F_PROJ   1
#define F_ZONE   2
#define F_NORTH  3
#define F_SOUTH  4
#define F_EAST   5
#define F_WEST   6
#define F_EWRES  7
#define F_NSRES  8
#define F_FORMAT 9
#define F_COMP   10
#define F_COLS   11
#define F_ROWS   12

#define F_EWRES3 13
#define F_NSRES3 14
#define F_COLS3  15
#define F_ROWS3  16
#define F_TOP    17
#define F_BOTTOM 18
#define F_TBRES  19
#define F_DEPTHS 20

#define SET(x) flags|=(1<<x)
#define TEST(x) (flags&(1<<x))

/*!
  \brief Read cell header (for internal use only)
  
  \param fp file descriptor
  \param[out] cellhd pointer to Cell_head structure
  \param is_cellhd ? (unused)
*/
void G__read_Cell_head(FILE * fd, struct Cell_head *cellhd, int is_cellhd)
{
    int count;
    char **array;
    char buf[1024];

    G_debug(2, "G__read_Cell_head");

    /* Count lines */
    count = 0;
    G_fseek(fd, 0L, 0);
    while (G_getl(buf, sizeof(buf), fd))
	count++;

    array = (char **)G_calloc(count + 1, sizeof(char *));

    count = 0;
    G_fseek(fd, 0L, 0);
    while (G_getl(buf, sizeof(buf), fd)) {
	array[count] = G_store(buf);
	count++;
    }

    G__read_Cell_head_array(array, cellhd, is_cellhd);

    count = 0;
    while (array[count]) {
	G_free(array[count]);
	count++;
    }
    G_free(array);
}

/*!
  \brief Read window from NULL terminated array of strings (for internal use only)

  \param array array of strings
  \param[out] cellhd pointer to Cell_head structure
  \param is_cellhd ? (unused)
*/
void G__read_Cell_head_array(char **array,
			     struct Cell_head *cellhd, int is_cellhd)
{
    char *buf;
    char label[200];
    char value[200];
    int i, line;
    int flags;

    G_debug(2, "G__read_Cell_head_array");

    flags = 0;

    /* initialize the cell header */
    cellhd->format = 0;
    cellhd->rows = 0;
    cellhd->rows3 = 0;
    cellhd->cols = 0;
    cellhd->cols3 = 0;
    cellhd->depths = 1;
    cellhd->proj = -1;
    cellhd->zone = -1;
    cellhd->compressed = -1;
    cellhd->ew_res = 0.0;
    cellhd->ew_res3 = 1.0;
    cellhd->ns_res = 0.0;
    cellhd->ns_res3 = 1.0;
    cellhd->tb_res = 1.0;
    cellhd->north = 0.0;
    cellhd->south = 0.0;
    cellhd->east = 0.0;
    cellhd->west = 0.0;
    cellhd->top = 1.0;
    cellhd->bottom = 0.0;

    /* determine projection, zone first */

    i = 0;
    for (line = 1; (buf = array[i++]); line++) {
	if (TEST(F_PROJ) && TEST(F_ZONE))
	    break;

	switch (scan_item(buf, label, value)) {
	case -1:
	    G_fatal_error(_("Syntax error in cell header"));
	case 0:
	    continue;
	case 1:
	    break;
	}
	if (strncmp(label, "proj", 4) == 0) {
	    if (TEST(F_PROJ))
		G_fatal_error(_("Duplicate projection field"));

	    if (!scan_int(value, &cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));

	    SET(F_PROJ);
	    continue;
	}
	if (strncmp(label, "zone", 4) == 0) {
	    if (TEST(F_ZONE))
		G_fatal_error(_("Duplicate zone field"));

	    if (!scan_int(value, &cellhd->zone))
		G_fatal_error(_("Syntax error in cell header"));

	    SET(F_ZONE);
	    continue;
	}
    }
    if (!TEST(F_PROJ))
	G_fatal_error(_("Field <%s> missing"), "projection");
    if (!TEST(F_ZONE))
	G_fatal_error(_("Field <%s> missing"), "zone");

    /* read the other info */
    i = 0;
    for (line = 1; (buf = array[i++]); line++) {
	G_debug(3, "region item: %s", buf);
	switch (scan_item(buf, label, value)) {
	case -1:
	    G_fatal_error(_("Syntax error in cell header"));
	case 0:
	    continue;
	case 1:
	    break;
	}

	if (strncmp(label, "proj", 4) == 0)
	    continue;
	if (strncmp(label, "zone", 4) == 0)
	    continue;

	if (strncmp(label, "nort", 4) == 0) {
	    if (TEST(F_NORTH))
		G_fatal_error(_("Duplicate north field"));
	    if (!G_scan_northing(value, &cellhd->north, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_NORTH);
	    continue;
	}
	if (strncmp(label, "sout", 4) == 0) {
	    if (TEST(F_SOUTH))
		G_fatal_error(_("Duplicate south field"));
	    if (!G_scan_northing(value, &cellhd->south, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_SOUTH);
	    continue;
	}
	if (strncmp(label, "east", 4) == 0) {
	    if (TEST(F_EAST))
		G_fatal_error(_("Duplicate east field"));
	    if (!G_scan_easting(value, &cellhd->east, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_EAST);
	    continue;
	}
	if (strncmp(label, "west", 4) == 0) {
	    if (TEST(F_WEST))
		G_fatal_error(_("Duplicate west field"));
	    if (!G_scan_easting(value, &cellhd->west, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_WEST);
	    continue;
	}
	if (strncmp(label, "top", 3) == 0) {
	    if (TEST(F_TOP))
		G_fatal_error(_("Duplicate top field"));
	    if (!scan_double(value, &cellhd->top))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_TOP);
	    continue;
	}
	if (strncmp(label, "bottom", 6) == 0) {
	    if (TEST(F_BOTTOM))
		G_fatal_error(_("Duplicate bottom field"));
	    if (!scan_double(value, &cellhd->bottom))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_BOTTOM);
	    continue;
	}
	if (strncmp(label, "e-w ", 4) == 0 && strlen(label) == 9) {
	    if (TEST(F_EWRES))
		G_fatal_error(_("Duplicate e-w resolution field"));
	    if (!G_scan_resolution(value, &cellhd->ew_res, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->ew_res <= 0.0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_EWRES);
	    continue;
	}
	if (strncmp(label, "e-w resol3", 10) == 0) {
	    if (TEST(F_EWRES3))
		G_fatal_error(_("Duplicate 3D e-w resolution field"));
	    if (!G_scan_resolution(value, &cellhd->ew_res3, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->ew_res3 <= 0.0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_EWRES3);
	    continue;
	}
	if (strncmp(label, "n-s ", 4) == 0 && strlen(label) == 9) {
	    if (TEST(F_NSRES))
		G_fatal_error(_("Duplicate n-s resolution field"));
	    if (!G_scan_resolution(value, &cellhd->ns_res, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->ns_res <= 0.0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_NSRES);
	    continue;
	}
	if (strncmp(label, "n-s resol3", 10) == 0) {
	    if (TEST(F_NSRES3))
		G_fatal_error(_("Duplicate 3D n-s resolution field"));
	    if (!G_scan_resolution(value, &cellhd->ns_res3, cellhd->proj))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->ns_res3 <= 0.0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_NSRES3);
	    continue;
	}
	if (strncmp(label, "t-b ", 4) == 0) {
	    if (TEST(F_TBRES))
		G_fatal_error(_("Duplicate t-b resolution field"));
	    if (!scan_double(value, &cellhd->tb_res))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->tb_res <= 0.0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_TBRES);
	    continue;
	}
	if (strncmp(label, "rows", 4) == 0 && strlen(label) == 4) {
	    if (TEST(F_ROWS))
		G_fatal_error(_("Duplicate rows field"));
	    if (!scan_int(value, &cellhd->rows))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->rows <= 0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_ROWS);
	    continue;
	}
	if (strncmp(label, "rows3", 5) == 0) {
	    if (TEST(F_ROWS3))
		G_fatal_error(_("Duplicate 3D rows field"));
	    if (!scan_int(value, &cellhd->rows3))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->rows3 <= 0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_ROWS3);
	    continue;
	}
	if (strncmp(label, "cols", 4) == 0 && strlen(label) == 4) {
	    if (TEST(F_COLS))
		G_fatal_error(_("Duplicate cols field"));
	    if (!scan_int(value, &cellhd->cols))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->cols <= 0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_COLS);
	    continue;
	}
	if (strncmp(label, "cols3", 5) == 0) {
	    if (TEST(F_COLS3))
		G_fatal_error(_("Duplicate 3D cols field"));
	    if (!scan_int(value, &cellhd->cols3))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->cols3 <= 0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_COLS3);
	    continue;
	}
	if (strncmp(label, "depths", 6) == 0) {
	    if (TEST(F_DEPTHS))
		G_fatal_error(_("Duplicate depths field"));
	    if (!scan_int(value, &cellhd->depths))
		G_fatal_error(_("Syntax error in cell header"));
	    if (cellhd->depths <= 0)
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_DEPTHS);
	    continue;
	}
	if (strncmp(label, "form", 4) == 0) {
	    if (TEST(F_FORMAT))
		G_fatal_error(_("Duplicate format field"));
	    if (!scan_int(value, &cellhd->format))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_FORMAT);
	    continue;
	}
	if (strncmp(label, "comp", 4) == 0) {
	    if (TEST(F_COMP))
		G_fatal_error(_("Duplicate compressed field"));
	    if (!scan_int(value, &cellhd->compressed))
		G_fatal_error(_("Syntax error in cell header"));
	    SET(F_COMP);
	    continue;
	}
	G_fatal_error(_("Syntax error in cell header"));
    }

    /* check some of the fields */
    if (!TEST(F_NORTH))
	G_fatal_error(_("Field <%s> missing"), "north");
    if (!TEST(F_SOUTH))
	G_fatal_error(_("Field <%s> missing"), "south");
    if (!TEST(F_WEST))
	G_fatal_error(_("Field <%s> missing"), "west");
    if (!TEST(F_EAST))
	G_fatal_error(_("Field <%s> missing"), "east");
    if (!TEST(F_EWRES) && !TEST(F_COLS))
	G_fatal_error(_("Field <%s> missing"), "cols");
    if (!TEST(F_NSRES) && !TEST(F_ROWS))
	G_fatal_error(_("Field <%s> missing"), "rows");
    /* This next stmt is commented out to allow wr_cellhd.c to write
     * headers that will be readable by GRASS 3.1
     if ((TEST(F_ROWS) && TEST(F_NSRES))
     ||  (TEST(F_COLS) && TEST(F_EWRES)))
     ERROR ("row/col and resolution information can not both appear ",0);
     */

    /* 3D defined? */
    if (TEST(F_EWRES3) || TEST(F_NSRES3) || TEST(F_COLS3) || TEST(F_ROWS3)) {
	if (!TEST(F_EWRES3))
	    G_fatal_error(_("Field <%s> missing"), "ewres3");
	if (!TEST(F_NSRES3))
	    G_fatal_error(_("Field <%s> missing"), "nsres3");
	if (!TEST(F_COLS3))
	    G_fatal_error(_("Field <%s> missing"), "cols3");
	if (!TEST(F_ROWS3))
	    G_fatal_error(_("Field <%s> missing"), "rows3");
    }
    else {			/* use 2D */
	cellhd->ew_res3 = cellhd->ew_res;
	cellhd->ns_res3 = cellhd->ns_res;
	cellhd->cols3 = cellhd->cols;
	cellhd->rows3 = cellhd->rows;
    }

    /* Adjust and complete the cell header  */
    G_adjust_Cell_head(cellhd, TEST(F_ROWS), TEST(F_COLS));
}

static int scan_item(const char *buf, char *label, char *value)
{
    /* skip blank lines */
    if (sscanf(buf, "%1s", label) != 1)
	return 0;

    /* skip comment lines */
    if (*label == '#')
	return 0;

    /* must be label: value */
    if (sscanf(buf, "%[^:]:%[^\n]", label, value) != 2)
	return -1;

    G_strip(label);
    G_strip(value);
    return 1;
}

static int scan_int(const char *buf, int *n)
{
    char dummy[3];

    *dummy = 0;
    return (sscanf(buf, "%d%1s", n, dummy) == 1 && *dummy == 0);
}

static double scan_double(const char *buf, double *n)
{
    char dummy[3];

    *dummy = 0;
    return (sscanf(buf, "%lf%1s", n, dummy) == 1 && *dummy == 0);
}