/* stcf01.f -- translated by f2c (version 19980913).
   You must link the resulting object file with the libraries:
	-lf2c -lm   (in that order)
*/

#include "f2c.h"

/* Table of constant values */

static integer c__15 = 15;

/* $Procedure   STCF01 (STAR catalog type 1, find stars in RA-DEC box) */
/* Subroutine */ int stcf01_(char *catnam, doublereal *westra, doublereal *
	eastra, doublereal *sthdec, doublereal *nthdec, integer *nstars, 
	ftnlen catnam_len)
{
    /* Builtin functions */
    /* Subroutine */ int s_copy(char *, char *, ftnlen, ftnlen);

    /* Local variables */
    extern /* Subroutine */ int chkin_(char *, ftnlen), errch_(char *, char *,
	     ftnlen, ftnlen);
    doublereal ramin;
    extern /* Subroutine */ int repmc_(char *, char *, char *, char *, ftnlen,
	     ftnlen, ftnlen, ftnlen);
    doublereal ramax;
    extern /* Subroutine */ int repmd_(char *, char *, doublereal *, integer *
	    , char *, ftnlen, ftnlen, ftnlen);
    logical error;
    char query[512], qrytm1[512], qrytm2[512];
    doublereal decmin;
    extern /* Subroutine */ int ekfind_(char *, integer *, logical *, char *, 
	    ftnlen, ftnlen);
    doublereal decmax;
    extern /* Subroutine */ int sigerr_(char *, ftnlen), chkout_(char *, 
	    ftnlen);
    char errmsg[512];
    extern /* Subroutine */ int setmsg_(char *, ftnlen);
    extern logical return_(void);
    extern doublereal dpr_(void);

/* $ Abstract */

/*     Search through a type 1 star catalog and return the number of */
/*     stars within a specified RA - DEC rectangle. */

/* $ Disclaimer */

/*     THIS SOFTWARE AND ANY RELATED MATERIALS WERE CREATED BY THE */
/*     CALIFORNIA INSTITUTE OF TECHNOLOGY (CALTECH) UNDER A U.S. */
/*     GOVERNMENT CONTRACT WITH THE NATIONAL AERONAUTICS AND SPACE */
/*     ADMINISTRATION (NASA). THE SOFTWARE IS TECHNOLOGY AND SOFTWARE */
/*     PUBLICLY AVAILABLE UNDER U.S. EXPORT LAWS AND IS PROVIDED "AS-IS" */
/*     TO THE RECIPIENT WITHOUT WARRANTY OF ANY KIND, INCLUDING ANY */
/*     WARRANTIES OF PERFORMANCE OR MERCHANTABILITY OR FITNESS FOR A */
/*     PARTICULAR USE OR PURPOSE (AS SET FORTH IN UNITED STATES UCC */
/*     SECTIONS 2312-2313) OR FOR ANY PURPOSE WHATSOEVER, FOR THE */
/*     SOFTWARE AND RELATED MATERIALS, HOWEVER USED. */

/*     IN NO EVENT SHALL CALTECH, ITS JET PROPULSION LABORATORY, OR NASA */
/*     BE LIABLE FOR ANY DAMAGES AND/OR COSTS, INCLUDING, BUT NOT */
/*     LIMITED TO, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND, */
/*     INCLUDING ECONOMIC DAMAGE OR INJURY TO PROPERTY AND LOST PROFITS, */
/*     REGARDLESS OF WHETHER CALTECH, JPL, OR NASA BE ADVISED, HAVE */
/*     REASON TO KNOW, OR, IN FACT, SHALL KNOW OF THE POSSIBILITY. */

/*     RECIPIENT BEARS ALL RISK RELATING TO QUALITY AND PERFORMANCE OF */
/*     THE SOFTWARE AND ANY RELATED MATERIALS, AND AGREES TO INDEMNIFY */
/*     CALTECH AND NASA FOR ALL THIRD-PARTY CLAIMS RESULTING FROM THE */
/*     ACTIONS OF RECIPIENT IN THE USE OF THE SOFTWARE. */

/* $ Required_Reading */

/*     EK */

/* $ Keywords */

/*     None. */

/* $ Declarations */
/* $ Brief_I/O */

/*     Variable  I/O  Description */
/*     --------  ---  -------------------------------------------------- */
/*     CATNAM      I   Catalog table name. */
/*     WESTRA      I   Western most right ascension in radians. */
/*     EASTRA      I   Eastern most right ascension in radians. */
/*     STHDEC      I   Southern most declination in radians. */
/*     NTHDEC      I   Northern most declination in radians. */
/*     NSTARS      O   Number of stars found. */

/* $ Detailed_Input */

/*     CATNAM      is name of the catalog data table. This name is */
/*                 returned by the catalog loader routine STCL01. */

/*     WESTRA      are right ascension and declination constraints */
/*     EASTRA      giving the western, eastern, southern and northern */
/*     STHDEC      boundaries of a search rectangle as follows: */
/*     NTHDEC */
/*                       RA  BETWEEN WESTRA  AND EASTRA  and */
/*                       DEC BETWEEN STHDEC AND NTHDEC */

/*                 where RA and DEC are the right ascension and */
/*                 declination of a star. WESTRA always represents */
/*                 "west" side of this rectangle and EASTRA -- the */
/*                 "east" side.  STHDEC represents the "south" side */
/*                 of the rectangle, NTHDEC represents the "north" */
/*                 side of the rectangle. */

/*                 For an observer standing on the surface */
/*                 of the earth at the equator, the west side of the */
/*                 rectangle ( the side associated with WESTRA) rises */
/*                 first. The east side (the side associated with */
/*                 EASTRA) rises last.  All meridians that rise between */
/*                 the rising of the west and east edges of the */
/*                 rectangle  cross through the RA-DEC rectangle. */

/*                 To specify the 6 degrees wide RA-DEC */
/*                 square centered on the celestical equator that */
/*                 has western most right ascension of 357 degrees, */
/*                 use the following values for WESTRA, EASTRA, STHDEC, */
/*                 and NTHDEC (we multiply the angles by the SPICELIB */
/*                 function RPD to convert degrees to radians). */

/*                      WESTRA  = 357.0D0 * RPD() */
/*                      EASTRA  =   3.0D0 * RPD() */
/*                      STHDEC  =  -3.0D0 * RPD() */
/*                      DEXMAX  =   3.0D0 * RPD() */

/*                 To specify a 5 degree wide RA-DEC square that has */
/*                 western most right ascension 10 degrees and */
/*                 eastern most right ascension 15 degrees and southern */
/*                 most declination of 45 degrees, assign the following */
/*                 values to WESTRA, EASTRA, STHDEC and NTHDEC. */

/*                      WESTRA  =  10.0D0 * RPD() */
/*                      EASTRA  =  15.0D0 * RPD() */
/*                      STHDEC  =  45.0D0 * RPD() */
/*                      DEXMAX  =  50.0D0 * RPD() */

/*                 All RA and DECS should be in radians and relative */
/*                 to the J2000 inertial frame. */

/*                 All Right Ascension values should be in the */
/*                 interval [0, 2*pi ).  This routine does */
/*                 not "fold" Right Ascension values into the this */
/*                 interval.  For example if you request stars in */
/*                 whose right ascensions lie between 3*pi and 4*pi */
/*                 no stars will be found. */

/*                 All Declination values should be in the interval */
/*                 [-pi,pi]. */

/* $ Detailed_Output */

/*     NSTARS      is number of catalog stars found within the */
/*                 specified RA - DEC rectangle. */

/* $ Parameters */

/*     None. */

/* $ Exceptions */

/*     1) If no star catalog has been loaded, an error will be */
/*        signalled by a routine in the call tree of this routine. */

/*     2) If the catalog query fails for any reason then */
/*        the error 'SPICE(QUERYFAILURE)'is signalled. */

/* $ Files */

/*     This routine searches for stars within SPICE type 1 star catalog */
/*     files that have been loaded by calls to the STCL01 routine and */
/*     that contain that catalog data table named CATNAM. */

/*     SPICE type 1 star catalog files MUST contain a single data table. */
/*     It can occupy a single segment or it can spread across multiple */
/*     segments. This table MUST include the following columns: */

/*        column name                data type          units */
/*     ------------------------------------------------------- */
/*        RA                   DOUBLE PRECISION        DEGREES */
/*        DEC                  DOUBLE PRECISION        DEGREES */
/*        RA_SIGMA             DOUBLE PRECISION        DEGREES */
/*        DEC_SIGMA            DOUBLE PRECISION        DEGREES */
/*        CATALOG_NUMBER       INTEGER */
/*        SPECTRAL_TYPE        CHARACTER*(4) */
/*        VISUAL_MAGNITUDE     DOUBLE PRECISION */

/*     Nulls are not allowed in any of the columns. */
/*     Other columns can also be present in the table but their data */
/*     will NOT be accessible through STCF01 and STCG01 -- */
/*     the interface used to access data in the catalog. Note */
/*     that the names and attributes of these additional columns */
/*     must be identical for all segments containing this table. */

/* $ Particulars */

/*     This routine is intended to be a part of the user interface to */
/*     the SPICE type 1 star catalog. It allows the caller to find all */
/*     stars within a specified RA - DEC rectangle in the SPICE */
/*     EK type 1 star catalog files loaded by STCL01. This */
/*     subroutine MUST NOT be called before a catalog file has */
/*     been loaded. */

/*     Other routines in the SPICE type 1 star catalog access */
/*     family are: */

/*        STCL01  load the catalog file and make its data */
/*                available for search and retrieval. */

/*        STCG01  retrieve position and characteristics for */
/*                a specified star in the set found by this */
/*                routine. */

/* $ Examples */

/*     In the following code fragment, STCF01 is used to find */
/*     all stars within a specified RA - DEC rectangle in a SPICE */
/*     EK type 1 star catalog. */

/*     C */
/*     C     Load catalog file. */
/*     C */
/*           CALL STCL01 ( CATFN, TABNAM, HANDLE ) */
/*     C */
/*     C     Search through the loaded catalog. */
/*     C */
/*           CALL STCF01 ( TABNAM, WESTRA,  EASTRA, */
/*          .              STHDEC, NTHDEC, NSTARS ) */
/*     C */
/*     C     Retrieve data for every star found. */
/*     C */
/*           DO I = 1, NSTARS */

/*              CALL STCG01 ( I, RA, DEC, RASIG, DECSIG, */
/*          .                 CATNUM, SPTYPE, VMAG ) */

/*           END DO */

/* $ Restrictions */

/*     1) The catalog file STCF01 searches through MUST be loaded */
/*        by STCL01 before STCF01 is called. */

/* $ Literature_References */

/*     None. */

/* $ Author_and_Institution */

/*     B.V. Semenov    (JPL) */

/* $ Version */

/* -    SPICELIB Version 1.0.0, 15-MAY-1996 (BVS) */

/* -& */
/* $ Index_Entries */

/*      find stars in RA-DEC rectangle in type 1 star catalog */

/* -& */


/*     SPICELIB functions */


/*     Local parameters. */


/*     Local variables */


/*     Standard SPICE error handling. */

    if (return_()) {
	return 0;
    } else {
	chkin_("STCF01", (ftnlen)6);
    }

/*     Query templates. */

    s_copy(qrytm1, "SELECT RA, DEC, RA_SIGMA, DEC_SIGMA,CATALOG_NUMBER, SPEC"
	    "TRAL_TYPE, VISUAL_MAGNITUDE FROM # WHERE ( RA  BETWEEN # AND # )"
	    " AND ( DEC BETWEEN # AND # ) ", (ftnlen)512, (ftnlen)149);
    s_copy(qrytm2, "SELECT RA, DEC, RA_SIGMA, DEC_SIGMA,CATALOG_NUMBER, SPEC"
	    "TRAL_TYPE, VISUAL_MAGNITUDE FROM # WHERE ( ( RA BETWEEN # AND 36"
	    "0 ) OR   ( RA BETWEEN 0 AND #   )      ) AND   ( DEC BETWEEN # A"
	    "ND # ) ", (ftnlen)512, (ftnlen)191);

/*     Choose query template to be used. */

    if (*westra <= *eastra) {
	s_copy(query, qrytm1, (ftnlen)512, (ftnlen)512);
    } else {
	s_copy(query, qrytm2, (ftnlen)512, (ftnlen)512);
    }

/*     Convert angles in radians to angles in degrees. */

    ramin = *westra * dpr_();
    ramax = *eastra * dpr_();
    decmin = *sthdec * dpr_();
    decmax = *nthdec * dpr_();

/*     Construct query using inputs and chosen template. */

    repmc_(query, "#", catnam, query, (ftnlen)512, (ftnlen)1, catnam_len, (
	    ftnlen)512);
    repmd_(query, "#", &ramin, &c__15, query, (ftnlen)512, (ftnlen)1, (ftnlen)
	    512);
    repmd_(query, "#", &ramax, &c__15, query, (ftnlen)512, (ftnlen)1, (ftnlen)
	    512);
    repmd_(query, "#", &decmin, &c__15, query, (ftnlen)512, (ftnlen)1, (
	    ftnlen)512);
    repmd_(query, "#", &decmax, &c__15, query, (ftnlen)512, (ftnlen)1, (
	    ftnlen)512);

/*     Submit query and get number of stars. Check for */
/*     errors in QUERY. */

    ekfind_(query, nstars, &error, errmsg, (ftnlen)512, (ftnlen)512);
    if (error) {
	setmsg_("Error querying type 1 star catalog. Error message: # ", (
		ftnlen)53);
	errch_("#", errmsg, (ftnlen)1, (ftnlen)512);
	sigerr_("SPICE(QUERYFAILURE)", (ftnlen)19);
	chkout_("STCF01", (ftnlen)6);
	return 0;
    }
    chkout_("STCF01", (ftnlen)6);
    return 0;
} /* stcf01_ */

