ppf_visibility.h

read envisat and analyis sar data from NASA

 PV_ANXUTC_ID,
 PV_UTCANX_ID,
 PV_ORBITINFO_ID,
 PV_STARVISTIME_ID,
 PV_TIME_SEGMENTS_NOT_ID,
 PV_TIME_SEGMENTS_OR_ID,
 PV_TIME_SEGMENTS_AND_ID,
 PV_TIME_SEGMENTS_SORT_ID,
 PV_TIME_SEGMENTS_MERGE_ID,
 PV_TIME_SEGMENTS_DELTA_ID,
 PV_MAX_FUNC_ID	                /* Number of functions defined in this list */

} PV_Func_enum;


/* List of errors of the main CFI functions (Look up the PPF_VISIBILITY SUM) */
/* ========================================================================= */

/* Error codes list of pv_zonevistime */
/* ---------------------------------- */
typedef enum
{
   PV_CFI_ZONEVISTIME_NEGATIVE_NUM_ZONE_ERR = PL_ZERO_E,
   PV_CFI_ZONEVISTIME_NEGATIVE_MAX_SEGMENTS_ERR,
   PV_CFI_ZONEVISTIME_NEGATIVE_MIN_DURATION_ERR,
   PV_CFI_ZONEVISTIME_PROJECTION_OUT_OF_RANGE_ERR,
   PV_CFI_ZONEVISTIME_READ_SWATH_FILE_ERR,
   PV_CFI_ZONEVISTIME_INCORRECT_SWATH_TYPE_ERR,
   PV_CFI_ZONEVISTIME_ALLOCATE_SWATH_MEMORY_ERR,
   PV_CFI_ZONEVISTIME_NEGATIVE_START_ORBIT_ERR,
   PV_CFI_ZONEVISTIME_READ_OEF_OSF_ERR,
   PV_CFI_ZONEVISTIME_EARLIER_START_ORBIT_WARN,
   PV_CFI_ZONEVISTIME_LATER_STOP_ORBIT_WARN,
   PV_CFI_ZONEVISTIME_WRONG_ORBIT_RANGE_ERR,
   PV_CFI_ZONEVISTIME_ORBITINFO_CALL_ERR,
   PV_CFI_ZONEVISTIME_INCONSISTENT_SWATH_ERR,
   PV_CFI_ZONEVISTIME_ORBITAL_CHANGE_WARN,
   PV_CFI_ZONEVISTIME_ZONE_ID_EMPTY_ERR,
   PV_CFI_ZONEVISTIME_WRONG_ZONE_ID_LENGTH_ERR,
   PV_CFI_ZONEVISTIME_READ_ZONE_DB_FILE_ERR,
   PV_CFI_ZONEVISTIME_DEFAULT_PROJECTION_WARN,
   PV_CFI_ZONEVISTIME_ALLOCATE_ZONE_MEMORY_ERR,
   PV_CFI_ZONEVISTIME_WRONG_LATITUDE_RANGE_ERR,
   PV_CFI_ZONEVISTIME_TWO_EQUAL_POINTS_WARN,
   PV_CFI_ZONEVISTIME_DIFF_LONG_180_ERR,
   PV_CFI_ZONEVISTIME_ANTIPODAL_POINTS_ERR,

   PV_CFI_ZONEVISTIME_SEGMENT_INTERSECT_PREC_ERR = PL_FIRST_E,
   PV_CFI_ZONEVISTIME_SEGMENT_INTERSECT_COMP_ERR,
   PV_CFI_ZONEVISTIME_GNOMONIC_COORD_ERR,
   PV_CFI_ZONEVISTIME_TWO_SEGMENTS_INTERSECT_ERR,
   PV_CFI_ZONEVISTIME_ALLIGNED_SEGMENTS_ERR,
   PV_CFI_ZONEVISTIME_ZONE_DIAM_NEGATIVE_ERR,
   PV_CFI_ZONEVISTIME_POLE_IN_SWATH_ERR,
   PV_CFI_ZONEVISTIME_CUADRILATERAL_NOT_CONVEX_ERR,
   PV_CFI_ZONEVISTIME_POINT_IN_CUADRILATERAL_ERR,
   PV_CFI_ZONEVISTIME_SORT_INTERSECTIONS_ERR,
   PV_CFI_ZONEVISTIME_MAX_OFF_NUMBER_REACHED_ERR,
   PV_CFI_ZONEVISTIME_MAX_ON_NUMBER_REACHED_ERR,
   PV_CFI_ZONEVISTIME_CHECK_SEGMENTS_WARN,
   PV_CFI_ZONEVISTIME_CHECK_SEGMENTS_ERR,
   PV_CFI_ZONEVISTIME_ANXUTC_CALL_ERR
} PI_CFI_Zonevistime_err_enum;


/* Error codes list of pv_stavistime */
/* --------------------------------- */
typedef enum                            
{
   /* Errors and warnings related with calls to other functions */
   PV_CFI_STAVISTIME_SWATH_TYPE_ERR = PL_ZERO_E,
   PV_CFI_STAVISTIME_INPUTS_CHECK_ERR,
   PV_CFI_STAVISTIME_OEF_READ_ERR,
   PV_CFI_STAVISTIME_FIRST_ORBIT_WARN,
   PV_CFI_STAVISTIME_LAST_ORBIT_WARN,
   PV_CFI_STAVISTIME_WRONG_INTERVAL_ERR,
   PV_CFI_STAVISTIME_ORBIT_INFO_ERR,
   PV_CFI_STAVISTIME_ORBIT_CHANGE_WARN,
   PV_CFI_STAVISTIME_SWATH_READ_ERR,
   PV_CFI_STAVISTIME_POTENTIAL_MEMORY_ERR,
   PV_CFI_STAVISTIME_INCONSISTENT_SWATH_ERR,
   PV_CFI_STAVISTIME_READ_STA_ERR,
   PV_CFI_STAVISTIME_AZEL2LONLAT_ERR,
   PV_CFI_STAVISTIME_ZONEVISTIME_CALL_ERR,
   PV_CFI_STAVISTIME_CALL_STAVIS_ERR,
   PV_CFI_STAVISTIME_CALL_STAVIS_WARN,
   PV_CFI_STAVISTIME_ZERO_DOPPLER_ERR,
   PV_CFI_STAVISTIME_LONG_SEGM_SKIPPED_WARN

} PV_CFI_Stavistime_err_enum;


/* Error codes list of pv_drsvistime */
/* --------------------------------- */
typedef enum 	                          
{
   /* Errors and warnings related with calls to other functions */
   PV_CFI_DRSVISTIME_PO_PPF_PREDICT_ERR = PL_ZERO_E,
   PV_CFI_DRSVISTIME_PG_EF_TO_QEF_ERR,
   PV_CFI_DRSVISTIME_PL_CHANGE_CS_ERR,
   PV_CFI_DRSVISTIME_PL_PT_DIR_RANGE_ERR,
   PV_CFI_DRSVISTIME_PV_AZIM_ELEV_ERR,
   PV_CFI_DRSVISTIME_PV_FIXED_CHECK_ERR,
   PV_CFI_DRSVISTIME_PV_EARTH_CHECK_ERR,
   PV_CFI_DRSVISTIME_PV_ROTATING_POS_ERR,
   PV_CFI_DRSVISTIME_PV_ROTATING_SOLAR_PANEL_CHECK_ERR,
   PV_CFI_DRSVISTIME_PV_ROTATING_SOLAR_PANEL_STR_CHECK_ERR,
   PV_CFI_DRSVISTIME_PV_OSF_RECORDS_READ_ERR,
   PV_CFI_DRSVISTIME_PV_DRSINPUTS_CHECK_ERR,
   PV_CFI_DRSVISTIME_PV_DRSINPUTS_CHECK_WARN,
   PV_CFI_DRSVISTIME_PV_CANON_POS_ERR,
   PV_CFI_DRSVISTIME_PV_ORBIT_INFO_ERR,
   PV_CFI_DRSVISTIME_PG_GENSTATE_ERR,
   PV_CFI_DRSVISTIME_MAX_NUMBER_ITER_ERR,
   PV_CFI_DRSVISTIME_PV_TIME_SEC_ERR,
   PV_CFI_DRSVISTIME_MAX_NUMBER_SEGMENTS_ERR,
   PV_CFI_DRSVISTIME_FIRST_ORBIT_VIS_WARN,
   PV_CFI_DRSVISTIME_LAST_ORBIT_VIS_WARN,
   PV_CFI_DRSVISTIME_PV_CHECK_STOP_TRAJECTORY_ERR,
   PV_CFI_DRSVISTIME_PV_CHECK_STOP_TRAJECTORY_WARN,
   PV_CFI_DRSVISTIME_PV_CHECK_STARTUP_TRAJECTORY_ERR,
   PV_CFI_DRSVISTIME_PV_CHECK_STARTUP_TRAJECTORY_WARN,
   PV_CFI_DRSVISTIME_MEMORY_ERR,
   PV_CFI_DRSVISTIME_ANXUTC_ERR,
   PV_CFI_DRSVISTIME_DRS_LAT_ERR
} PV_CFI_Drsvistime_err_enum;


/* Error codes list of pv_swathcalc */
/* -------------------------------- */
typedef enum
{
   /* Errors and warnings related with internal processing */
 
   PV_CFI_SWATHCALC_ORB_NUM_LIM_ERR = PL_ZERO_E,
   PV_CFI_SWATHCALC_SEC_LIM_ERR,
   PV_CFI_SWATHCALC_MICROSEC_1ST_ERR,
   PV_CFI_SWATHCALC_MICROSEC_2ND_ERR,
   PV_CFI_SWATHCALC_ORB_NUM_OEF_ERR,
   PV_CFI_SWATHCALC_SEC_ORB_PER_ERR,
   PV_CFI_SWATHCALC_TIME_ERR,
   PV_CFI_SWATHCALC_REP_CYCLE_ERR,
   PV_CFI_SWATHCALC_CYCLE_LENGTH_ERR,
   PV_CFI_SWATHCALC_SPHER_TRIANG_ERR,
 
   /* Errors and warnings related with calls to other functions */
 
   PV_CFI_SWATHCALC_PV_OSF_RECORDS_READ_ERR = PL_FIRST_E,
   PV_CFI_SWATHCALC_PV_ORBIT_INFO_ERR,
   PV_CFI_SWATHCALC_PV_SWATH_READ_ERR
 
} PV_CFI_Swathcalc_err_enum;
 

/* Error codes list of pv_anxutc */
/* ----------------------------- */
typedef enum
{
   /* Errors and warnings related with internal processing */
 
   PV_CFI_ANXUTC_ORB_NUM_1ST_ERR = PL_ZERO_E,
   PV_CFI_ANXUTC_ORB_NUM_2ND_ERR,
   PV_CFI_ANXUTC_ORB_NUM_3RD_ERR,
   PV_CFI_ANXUTC_SEC_ERR,
   PV_CFI_ANXUTC_MICROSEC_ERR,
   PV_CFI_ANXUTC_SEC_MICROSEC_ERR,
   PV_CFI_ANXUTC_ROUNDING_WARN,
 
   /* Errors and warnings related with calls to other functions */
 
   PV_CFI_ANXUTC_PV_OSF_RECORDS_READ_ERR = PL_FIRST_E,
   PV_CFI_ANXUTC_PV_ORBIT_INFO_ERR
 
} PV_CFI_Anxutc_err_enum;
 
 
/* Error codes list of pv_utcanx */
/* ----------------------------- */
typedef enum
{
   /* Errors and warnings related with internal processing */
 
   PV_CFI_UTCANX_UTC_ERR = PL_ZERO_E,
   PV_CFI_UTCANX_UTC_OEF_1ST_ORB_ERR,
   PV_CFI_UTCANX_UTC_OEF_LAST_ORB_ERR,
 
   /* Errors and warnings related with calls to other functions */
 
   PV_CFI_UTCANX_PV_OSF_RECORDS_READ_ERR = PL_FIRST_E,
   PV_CFI_UTCANX_PV_ORBIT_INFO_ERR
 
} PV_CFI_Utcanx_err_enum;
 

/* Error codes list of pv_orbitinfo */
/* -------------------------------- */
typedef enum
    {
        PV_CFI_ORBITINFO_OEF_READ_ERR = PL_ZERO_E,
	PV_CFI_ORBITINFO_INPUT_PARAMETER_ERR = PL_FIRST_E,
	PV_CFI_ORBITINFO_GENSTATE = PL_SECOND_E
    } PV_CFI_Orbitinfo_err_enum;


/* Error codes list of pv_starvistime */
/* ---------------------------------- */
typedef enum
    {

      PV_CFI_STARVISTIME_INPUTS_CHECK_ERR = PL_ZERO_E,
      PV_CFI_STARVISTIME_OEF_READ_ERR,
      PV_CFI_STARVISTIME_FIRST_ORBIT_WARN,
      PV_CFI_STARVISTIME_LAST_ORBIT_WARN,
      PV_CFI_STARVISTIME_STAR_RADEC_ERR,
      PV_CFI_STARVISTIME_ORBIT_INFO_ERR,
      PV_CFI_STARVISTIME_ORBIT_CHANGE_WARN,
      PV_CFI_STARVISTIME_SWATH_UPPER_READ_ERR,
      PV_CFI_STARVISTIME_SWATH_LOWER_READ_ERR,
      PV_CFI_STARVISTIME_INERTIAL_SWATH_ERR,
      PV_CFI_STARVISTIME_INCONSISTENT_SWATH_ERR,
      PV_CFI_STARVISTIME_READ_STAR_ERR,
      PV_CFI_STARVISTIME_ALT_ERR,
      PV_CFI_STARVISTIME_STAR_MAIN_ERR

    } PV_CFI_Starvistime_err_enum;


/* Error codes list of pv_time_segments_not */
/* ---------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_NOT_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_NOT_REL_TO_ABS_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_NOT_ABS_TO_REL_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_NOT_SORTING_ERR

} PV_CFI_time_segments_not_err_enum;

/* Error codes list of pv_time_segments_or */
/* ---------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_OR_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_OR_REL_TO_ABS_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_OR_ABS_TO_REL_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_OR_SORTING_ERR

} PV_CFI_time_segments_or_err_enum;

/* Error codes list of pv_time_segments_and */
/* ---------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_AND_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_AND_REL_TO_ABS_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_AND_ABS_TO_REL_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_AND_SORTING_ERR

} PV_CFI_time_segments_and_err_enum;

/* Error codes list of pv_time_segments_sort */
/* ----------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_SORT_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_SORT_CHANGING_ORBIT_ERR

} PV_CFI_time_segments_sort_err_enum;


/* Error codes list of pv_time_segments_merge */
/* ----------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_MERGE_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_MERGE_REL_TO_ABS_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_MERGE_ABS_TO_REL_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_MERGE_SORTING_ERR

} PV_CFI_time_segments_merge_err_enum;


/* Error codes list of pv_time_segments_delta */
/* ----------------------------------------- */
typedef enum
{
  /* Errors and warnings related to internal processing */
  /* Errors and warnings related to calls to other functions */
  PV_CFI_TIME_SEGMENTS_DELTA_MEMORY_ERR = PL_ZERO_E,
  PV_CFI_TIME_SEGMENTS_DELTA_REL_TO_ABS_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_DELTA_ABS_TO_REL_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_DELTA_ORBIT_TO_TIME_ERR,
  PV_CFI_TIME_SEGMENTS_DELTA_TIME_TO_ORBIT_ERR,
  PV_CFI_TIME_SEGMENTS_DELTA_TIME_ADD_ERR,
  PV_CFI_TIME_SEGMENTS_DELTA_SORT_ERR

} PV_CFI_time_segments_delta_err_enum;


/* Functions names aliases (historical names LEFT - official names RIGHT) */
/* ====================================================================== */

#define PV_Silent               pv_silent
#define PV_Verbose              pv_verbose
#define PV_Print_Msg            pv_print_msg
#define PV_Vector_Msg           pv_vector_msg
#define PV_Vector_Code          pv_vector_code

#define	zonevistime	pv_zonevistime
#define stavistime	pv_stavistime
#define drsvistime	pv_drsvistime
#define swathcalc	pv_swathcalc
#define anxutc		pv_anxutc
#define utcanx		pv_utcanx
#define starvistime	pv_starvistime


/*************************************************************************/
#ifdef __cplusplus
}
#endif


#endif