MDP/latest/hdf5mine_8h_source.html

 #ifndef HDF5MINE_H_

 #define HDF5MINE_H_


 #ifdef __cplusplus

 extern "C" {

 #endif


 //#define GSP_READ 0

 //#define GSP_WRITE 1


 bstring GS_H5ObjectTypeAsString(int objtype);

 bstring GS_GSObjectTypeAsString(int objtype);


 int GS_CheckFileExistence(const_bstring filename);

 void GS_init();


 int     GS_ValidID(hid_t id);

 bstring GS_GetIDName(hid_t id);


 int GS_GetStringAttribute( hid_t object_id, const_bstring name, bstring value);

 int GS_SetStringAttribute( hid_t object_id, const_bstring name, const_bstring value);


 int GS_ObjectIsFile(hid_t id);

 int GS_ObjectIsDataset(hid_t id, const_bstring name);

 int GS_ObjectIsDatasetByID(hid_t id);

 int GS_ObjectIsGroup(hid_t id, const_bstring name);

 int GS_ObjectIsGroupByID(hid_t id);


 int GS_CheckInternalName(hid_t object_id, const_bstring thename);

 hid_t GS_CreateAccessPlist(void);


 hid_t GS_FileCreate(const_bstring filename);

 int   GS_FileDelete(const_bstring filename);

 hid_t GS_FileOpen(const_bstring dbname, const_bstring access);

 int   GS_FileFlush(hid_t object_id);

 int   GS_FileClose(hid_t file_id);

 int   GS_FileCloseAllObjects(hid_t file_id);

 int   GS_FileIsWriteable(hid_t id);

 int   GS_FileCopy(bstring oldname, bstring newname);

 int   GS_FileIsOpen(const_bstring filename);

 int   GS_FileRename(const_bstring oldname, const_bstring newname);

 int   GS_FileReport(const_bstring filename, bstring report_string);

 hid_t GS_GetValidFileID(hid_t id);


 bstring GS_GetFilename(hid_t id);

 herr_t GS_SetCacheSize(hid_t file_id, size_t cache_size);

 int GS_FileCommitDatatypes(hid_t file_id);


 char *GS_Dirname(const char *name);


 hid_t GS_DatasetCreate(hid_t source, const_bstring name, int datatype,

                        int ndims, int *size, int is_extendable,

                        int is_compressed);

 int   GS_DatasetDelete(hid_t file_id, const_bstring dataset_name);

 hid_t GS_DatasetOpen(hid_t source, const_bstring name);

 hid_t GS_DatasetClose(hid_t id);

 int   GS_DatasetRename(hid_t group_id, const_bstring oldname, const_bstring newname);

 hid_t GS_DatasetGetParent(hid_t id);

 int   GS_DatasetGetDatatype(hid_t id, const_bstring name);

 int   GS_DatasetGetDatatypeByID(hid_t id);

 int   GS_DatasetGetDimensionsByID(hid_t id, long int **size);

 int   GS_DatasetGetDimensions(hid_t id, const_bstring name, long int **size);

 hid_t GS_DatasetCopy(hid_t source, hid_t destination_group_id,

                      const_bstring destination_dataset_name);


     int GS_DatasetRead(hid_t dataset_id, const long int *offsets,

                      const long int *sizes, int datatype, void *buffer);

 int GS_DatasetWrite(hid_t dataset_id, const long int *offsets,

                      const long int *sizes, int datatype, const void *buffer);


 int GS_DataConversion( int in_type, const void *in_buffer,

                        int out_type, void *out_buffer,

                        int nelements);

 int GS_RasterTypeNumbytes(int datatype );


 int   GS_ConvertFromHDFDatatype(hid_t datatype);

 hid_t GS_ConvertToHDFDatatype(int datatype);

 int   GS_HDFDatatypeClose(hid_t id);


 bstring GS_PathnameNodir(const_bstring name);

 bstring GS_PathnameGetDir(const_bstring name);

 bstring GS_PathnameGetHDFDir(const_bstring name);

 bstring GS_PathnameJoin(const_bstring front, const_bstring back);


 hid_t   GS_GroupCreate(hid_t file_id, const_bstring groupname);

 hid_t   GS_GroupOpen(hid_t source, const_bstring name);

 int     GS_GroupClose(hid_t id);

 int     GS_GroupCloseAllObjects(hid_t id);

 hid_t   GS_GroupCopy(hid_t source, hid_t destination_object_id,

                      const_bstring destination_group_name);

 int GS_GroupRename(hid_t id, const_bstring oldname, const_bstring newname);

 int GS_GroupDelete(hid_t file_id, const_bstring group_name );


 #define GS_READ 0

 #define GS_WRITE 1


   //#define GS_DATASET_TYPE_UNKNOWN       0

   //#define GS_DATASET_TYPE_INTERNAL_FILE 1

   //#define GS_DATASET_TYPE_RASTER        2

   //#define GS_DATASET_TYPE_METADATA      3

   //#define GS_DATASET_TYPE_METADATA_IFILE 4


 #define GS_IFILE_SUCCESS 1

 #define GS_IFILE_FAILURE 2


 // geosci group types in hdf5 files:

 #define GS_OBJECT_TYPE_UNKNOWN        0

 #define GS_OBJECT_TYPE_METADATA_GROUP 1

 #define GS_OBJECT_TYPE_IMAGE    2

 #define GS_OBJECT_TYPE_VECTOR   3

 #define GS_OBJECT_TYPE_VECTOR2D 4

 #define GS_OBJECT_TYPE_VECTOR3D 5

 #define GS_OBJECT_TYPE_TIN      6

 #define GS_OBJECT_TYPE_MESH2D   7

 #define GS_OBJECT_TYPE_MESH3D   8

 #define GS_OBJECT_TYPE_RASTER   9

 #define GS_OBJECT_TYPE_IFILE   10

 #define GS_OBJECT_TYPE_FILE    11

 #define GS_OBJECT_TYPE_METADATA_DATASET 12

 #define GS_OBJECT_TYPE_METADATA_IFILE   13

 #define GS_OBJECT_TYPE_UNDER_CONSTRUCTION -1


 // geosci coordinates units:

 #define GS_COORDINATES_UNKNOWN 0

 #define GS_COORDINATES_DEGREES 1

 #define GS_COORDINATES_METERS  2

 #define GS_COORDINATES_PIXELS  3


 /* complex types: */

 /* needs updating based on machine defaults....*/

 /* tried using the int8_t, etc types but it would not compile...??? */

 /* LEP: dec 1, 2013 */

 typedef char complex ci16_t;

 typedef short int complex ci32_t;

 typedef int complex ci64_t;

 typedef float complex c64_t;

 typedef double complex c128_t;


 // the functions:

 int GS_AppendMetadata(hid_t object_id, const_bstring metadata_name,

                       const_bstring value);

 int GS_FileCreateMetadata(hid_t file_id, const_bstring descriptor);

   //int GS_ImageCreateMetadata(hid_t file_id, const_bstring image_name,

   //                        const_bstring typestring, const_bstring chanstr,

   //                        const_bstring pixstr, const_bstring linestr,

   //                        const_bstring descriptor);

 int GS_ImageCreateMetadata(hid_t file_id, const_bstring image_name,

                         const_bstring descriptor);

 int GS_VectorCreateMetadata(hid_t file_id, const_bstring vector_name,

                          const_bstring descriptor);


 int GS_RasterCreateMetadata(hid_t image_id, const_bstring raster_name,

                             int raster_type, int npixels, int nlines,

                             const_bstring descriptor);


   //int GS_ObjectGetType(hid_t object_id);

 int GS_ObjectIsIFileByID( hid_t dataset_id );

 int GS_ObjectIsIFile( hid_t id, const_bstring name );

 int GS_ObjectIsImageByID( hid_t id );

 int GS_ObjectIsImage(hid_t file_id, const_bstring image_name);

 int GS_ObjectIsMetadataDatasetByID( hid_t dataset_id );

 int GS_ObjectIsMetadataDataset( hid_t id, const_bstring name );

 int GS_ObjectIsMetadataIFileByID( hid_t dataset_id );

 int GS_ObjectIsMetadataIFile( hid_t id, const_bstring name );

 int GS_ObjectIsRasterByID( hid_t dataset_id );

 int GS_ObjectIsRaster( hid_t id, const_bstring name );

 int GS_ObjectIsVectorByID( hid_t id );

 int GS_ObjectIsVector( hid_t id, const_bstring name );

 int GS_ObjectLock(hid_t id);

 int GS_ObjectUnlock(hid_t id);

 int GS_SplitHistory(const_bstring history_string, bstring front, bstring back);

 int GS_UpdateMetadata( hid_t object_id, const_bstring name, bstring value);

 int GS_ValidMetadataName(int object_type, const_bstring name);


 hid_t GS_ConvertToHDFDatatype(int datatype);


 int           GS_DatatypeIsComplex(int datatype);

 bstring GS_DatatypeAsString(int datatype);


 bstring GS_DatasetReport(hid_t dataset_id);

 int     GS_DatasetIsWriteable(hid_t file_id, const_bstring dataset_name);

 int     GS_DatasetIsWriteableByID(hid_t dataset_id);


 int     GS_GroupIsWriteable(hid_t file_id, const_bstring group_name);

 int     GS_GroupIsWriteableByID(hid_t group_id);

 bstring GS_GroupReport(hid_t group_id);


 int     GS_GroupGetType(hid_t group_id);

 int     GS_GroupSetType(hid_t group_id, int typecode);


 bstring GS_GroupGetDatum(hid_t group_id);

 bstring GS_GroupGetProjection(hid_t group_id);

 int     GS_GroupGetBounds(hid_t group_id, double *xmin, double *xmax,

                           double *ymin, double *ymax);


 bstring GS_DatasetGetDatum(hid_t dataset_id);

 bstring GS_DatasetGetProjection(hid_t dataset_id);

 int     GS_DatasetGetBounds(hid_t dataset_id, double *xmin, double *xmax,

                           double *ymin, double *ymax);


 int GS_ObjectGetH5Children( hid_t object_id, int *nobjs,

                           bstring **objnames, int **objtypes);

 int GS_ObjectGetGSChildren( hid_t object_id, int *nobjs,

                           bstring **objnames, int **objtypes);


 int GS_DatasetGetType(hid_t dataset_id);

   int GS_DatasetSetType(hid_t dataset_id, int typecode);


 hid_t GS_ImageCreate(hid_t file_id, const_bstring image_name,

                const_bstring image_descriptor);

 int   GS_ImageClose( hid_t image_id);

 hid_t GS_ImageOpen( hid_t file_id, const_bstring image_name);

 int   GS_ImageDelete( hid_t file_id, const_bstring image_name);


 int GS_AppendHistory(hid_t object_id, const_bstring history_line);

 int GS_AbortedHistory(hid_t object_id, const_bstring history_line);


 hid_t GS_RasterCreate(hid_t image_id, const_bstring raster_name,

                    int raster_type, int npixels, int nlines,

                    const_bstring descriptor);

 hid_t GS_RasterOpen( hid_t image_id, const_bstring raster_name);

 int   GS_RasterClose( hid_t raster_id);

 int   GS_RasterDelete( hid_t image_id, const_bstring raster_name);

 bstring GS_GetRasterTypeAsString(int datatype);

 int GS_RasterPixelSize(hid_t raster_id,int func, double *x_pixelsize,

                    double *y_pixelsize, bstring pixel_units);

 int GS_RasterSizeInfo(hid_t raster_id, int *npixels, int *nlines);

 int GS_RasterCheckWindow( hid_t file_id, const_bstring image_name, int *window);

 int GS_RasterCheckWindowByID( hid_t image_id,  int *window);

 int GS_CheckWindowInside( int *window_in, const int *window_enclosing );


   //yet int GetRasterTypes(hid_t image_id, int **types, int *ntypes);

   //yet int GetRasterTypeNumbytes(int datatype );

   //yet int GetRasterTypeAsInteger(char *typestring);

 int GS_RasterTypeIsInteger(int datatype);

 int GS_RasterTypeIsComplex(int datatype);

 int GS_CheckUniqueName(hid_t file_id, const char *thename);


 #ifdef OLDSTUFF


   //int GetStringAttribute( hid_t group_id, const char *name, char **value);


   //int FileReport(const char *filename, char **report_string);

 int ImageReport(const char *filename, const char *image_name,

                 char **report_string);

 int FreeReportString(char *str);


   //done//hid_t ImageOpen( hid_t file_id, const char *image_name);

   //done//int   ImageClose( hid_t image_id);

   //done//int   ImageDelete( hid_t file_id, const char *image_name);

   //done//hid_t ImageAdd(hid_t file_id, const char *image_name,

   //               const char *image_descriptor,

   //               int pixels, int lines,int channels,

   //               int *channel_types, const char **channel_descriptors);

 int ImageCopy( hid_t file_from, const char *image_from,

                int *channels_from, int *window_from,

                hid_t file_to,   const char *image_to,

                int *channels_to,   int *window_to);


 int ImageCopyByID( hid_t image_from, const char *raster_name_from, int *window_from,

                    hid_t image_to,   const char *raster_name_to,   int *window_to);


 int ImageImport(const char *infilename,const char *outfilename,

                 const char *outimagename);

 int ImageChannelAdd(hid_t file_id, const char *cimage_name,

                     int channels, int *channel_types,

                     const char **channel_descriptors);

 int ImageChannelDelete(hid_t file_id, const char *cimage_name,

                        int *channels);


   //hid_t GroupOpen(hid_t gid, const char *name);

   //int GroupClose(hid_t id );

   //hid_t GroupCreate(hid_t file_id, const char *groupname);

   //int GroupDelete(hid_t file_id, const char *group_name );


   //hid_t FileCreate(const char *filename, int pixels, int lines, const int channels[]);

   //hid_t FileCreateEmpty(const char *filename);

   //hid_t FileOpen(const char *dbname, const char *access);

   //int   FileClose(hid_t file_id);

   //int   FileFlush(hid_t object_id);


   //void  Time (char *string, int format);


   //herr_t SetCacheSize(hid_t file_id, size_t cache_size);


   //hid_t  CreateAccessPlist(void);


 int ImageSizeInfo(hid_t image_id, int *npixels, int *nlines, int *nchannels);


   //int FileWriteable( hid_t id);

   //char *GetFilename(hid_t id);

 int CheckWindow( hid_t file_id, const char *image_name, int *window);

 int CheckWindowByID( hid_t image_id,  int *window);

 int CheckWindowInside( int *window_in, const int *window_enclosing );

 int CheckChannels( hid_t file_id, const char *image_name,

                    const int *channel_list, int nchans,

                    int *is_valid_channel, int *is_writeable_channel);

 int CheckChannelsValid( hid_t file_id, const char *image_name,

                         const int *channel_list, int nchans);

 int CheckChannelsWriteable( hid_t file_id, const char *image_name,

                             const int *channel_list, int nchans);


 int CheckDatatype(int datatype);

   //hid_t GetHdf5Type(int datatype);

 char *GetRasterTypeAsString(int datatype);

 int HDF5Type2GSPType(hid_t datatype);


 void DisableHDF5ErrorReporting(void);

 void EnableHDF5ErrorReporting(void);


   //int ValidID(hid_t id);

   //hid_t GetValidFileID(hid_t id);


   //int ObjectIsDataset(hid_t id, const char *name);

   //int ObjectIsDatasetByID(hid_t id);

   //int ObjectIsFile(hid_t id);

   //int ObjectIsImage(hid_t id, const char *name);

   //int ObjectIsImageByID( hid_t id );

   //int ObjectIsVector( hid_t id, const char *name );

   //int ObjectIsVectorByID( hid_t id );

   //int ObjectIsGroup(hid_t file_id, const char *name);

   //int ObjectIsGroupByID(hid_t id);

   //int ObjectIsMetadataDataset( hid_t id, const char *name );

   //int ObjectIsMetadataDatasetByID( hid_t dataset_id );

   //int ObjectIsMetadataIFileByID( hid_t dataset_id );


 hid_t   RasterOpen( hid_t image_id, const char *raster_name);

 hid_t   RasterClose( hid_t raster_id);

 int GetRasterTypes(hid_t image_id, int **types, int *ntypes);

 int GetRasterTypeNumbytes(int datatype );

 int GetRasterTypeAsInteger(char *typestring);

 int GS_RasterTypeIsInteger(int datatype);

 int GS_RasterTypeIsComplex(int datatype);


 void Progress( const char *name, double frac);


   //hid_t DatasetOpen(hid_t source, const char *name);

   //hid_t DatasetClose(hid_t id);

   //int DatasetDelete(hid_t file_id, const char *dataset_name);

   //int DatasetGetType(hid_t dataset_id);

   //int DatasetSetType(hid_t dataset_id, int typecode);


 int ImageIO( hid_t file_id, const char *image_name, int func,

              int xoff, int yoff, int xsize, int ysize,

              void *buffer, int *datatypes, int *buffer_window,

              int nchans, int *chanmap, int write_history);


 //#include "generic_image.h"


 double GetDoubleValue(void *buf,int index, int from_type,

                       int to_type, int reim);

 int PutDoubleValue(double value, void *buf,int index,

                    int to_type, int reim);


 double complex GetDoubleComplexValue(void *buf,int index, int from_type,

                                      int to_type);

 int PutDoubleComplexValue(double complex value, void *buf,int index,

                           int to_type);


 long int GetSystemMemory(void);

 long int GetFreeMemory(void);


   //char *Dirname(const char *name);


   //int ObjectIsRaster( hid_t id, const char *name );

   //int ObjectIsRasterByID( hid_t datasetid );


 int SpatialrefCreate(hid_t file_id, const char *object_name,

                      const char *code, const char *wkt,

                      const char *proj4);


 int SpatialrefIO(hid_t file_id, const char *object_name, int func,

                  char *code, char *wkt, char *proj4);


 int SpatialrefReport(const char *filename, const char *object_name,

                      char **report_string);


 int SpatialrefCopy(hid_t from_file_id, const char *from_object_name,

                    hid_t   to_file_id, const char   *to_object_name);


 //char *GSPGetAuthorityCode(OGRSpatialReferenceH asr);


 //int GetObjectType(hid_t object_id);

 //int GS_GetGroupType(hid_t file_id, const_bstring group_name);

 //int GS_GetGroupTypeByID(hid_t object_id);

 //int GroupTypeString2Int(const char *grouptypestring);


 //int CreateFileMetadata(hid_t file_id, const char *descriptor);

 //int CreateImageMetadata(hid_t file_id, const char *image_name,

 //                        const char *typestring, const char *chanstr,

 //                        const char *pixstr, const char *linestr,

 //                        const char *descriptor);

 //int CreateVectorMetadata(hid_t file_id, const char *vector_name,

 //                         const char *descriptor);


 //int UpdateFileMetadata( hid_t file_id, const char *name, const char *value);

 //int AppendFileMetadata( hid_t file_id, const char *name, const char *value);

 //int ValidFileMetadataName(const char *name);

 //int AppendMetadata(hid_t object_id, const char *metadata_name, const char *value);

 //int UpdateMetadata( hid_t object_id, const char *name, const char *value);


 //int UpdateImageMetadata( hid_t file_id, const char *image_name,

 //                         const char *name, const char *value);

 //int AppendImageMetadata( hid_t file_id, const char *image_name,

 //                         const char *name, const char *value);

 //int UpdateImageMetadataByID( hid_t image_id, const char *name,

 //                             const char *value);


 //int UpdateRasterMetadata( hid_t file_id, const char *image_name,

 //                          const char *raster_name,

 //                          const char *name, const char *value);


 //int ValidMetadataName(int object_type, const char *name);


 int UpdateDescriptor( hid_t object_id, const char *descriptor);

   //done//int AbortedHistory(hid_t object_id, const char *history_line);

   //DONE//int AppendHistory(hid_t object_id, const char *history_line);

   //int SplitHistory(char *history_string, char **front, char **back);


 int CoordinatesCreate(hid_t file_id, const char *object_name,

                       double ULx, double ULy, double LRx, double LRy);


 int CoordinatesCopy(hid_t from_file_id, const char *from_object_name,

                    hid_t   to_file_id, const char   *to_object_name);


 int CoordinatesIO(hid_t file_id, const char *object_name, int func,

                   double *ULx, double *UULy, double *ULRx, double *ULRy,

                   int *units);

 int CoordinatesReport(hid_t file_id, const char *object_name,

                      char *report_string);


 int VectorDatabaseInit(hid_t file_id, const char *vector_name);


 //sqlite3 *VectorDatabaseOpen(hid_t vector_id);


 int GetVectorTableDef(const char *filename, char **table_name,

                       int *geometry_type, int *dimension,

                       char ***column_types, char ***column_names);


 hid_t VectorAdd(hid_t file_id, const char *vector_name,

                 const char *vector_descriptor);


 //int OSRImport(OGRSpatialReferenceH asr, OGRDataSourceH hDS);


 int SpatialrefImport( const char *filename, char *code,

                       char *wkt, char *proj4 );


 int DecodeSRID( const char *code, int *code_number );


 // defs for very generic geometry types for vectors

 // these include 2d, 2.5-d, and on-multi and multi- versions of each

 #define GSP_POINT 1

 #define GSP_LINE  2

 #define GSP_POLYGON 3

 #define GSP_COLLECTION 4


 //defs for more specific geometry types:

 #define GSP_POINT2 1

 #define GSP_LINE2  2

 #define GSP_POLYGON2 3

 #define GSP_COLLECTION2 4

 #define GSP_RING2 5

 #define GSP_POINT25 6

 #define GSP_LINE25  7

 #define GSP_POLYGON25 8

 #define GSP_COLLECTION25 9


 char *GetVectorTypeAsString(int datatype);

 int GetVectorNumShapes(hid_t vector_id,int *num_types,int *types,

                        long int *num_per_type);

 int GetVectorBounds(hid_t vector_id,int *num_types,int *types,

                     double *bounds_per_type);


   //int GetChildren( hid_t object_id, int *nobjs,

   //                 char ***objnames, int **objtypes);

 char *H5ObjectTypeAsString(int objtype);

 int GetGSPChildren( hid_t object_id, int *nobjs,

                  char ***objnames, int **objtypes);

 char *GSPObjectTypeAsString(int objtype);


 // for debug only:

 int report_num_objects_open(void);

 int count_num_objects_open(void);


   //int DatasetRename(hid_t group_id, const char *oldname, const char *newname);


   //int FileRename(const char *oldname, const char *newname);

   //int FileIsOpen(const char *filename);

   //int FileDelete(const char *filename);


   //int ObjectLock(hid_t id);

 hid_t GetRasterParent(hid_t id);

 int GetRasterNumber(hid_t id);

 int ChannelWritabilityIO(hid_t image_id, int func, int *nchannels,

                          int *writeability);

   //int ObjectUnlock(hid_t id);


   //done//hid_t RasterCreate(hid_t image_id, const char *raster_name,

   //                   int raster_type, int nnpixels, int nnlines,

   //                   const char *descriptor);

 int RasterDelete( hid_t image_id, const char *raster_name);


 hid_t PyramidCheck(hid_t image_id, int npyramids, int *xsizes, int *ysizes);

 hid_t PyramidCreate(hid_t image_id);

 int PyramidDelete(hid_t image_id);

 hid_t PyramidExist(hid_t image_id);

 hid_t PyramidCalcSizes(int npixels, int nlines,

                       int *npyramids, int **xsizes, int **ysizes);

 hid_t PyramidUpdate(hid_t image_id);

 int DatetimeCompare(const char *time2, const char *time1, double *difference);


 int CheckRasterWriteableByID(hid_t raster_id);


   //char *PathnameDir(const char *name);

   //char *PathnameNodir(const char *name);

   //char *PathnameJoin(const char *front, const char *back);


 int ImageFilterAverage( hid_t file_from, const char *image_from, int *channels_from,

                         int *filter_size, const char *mask, int nthreads, int memsize_gbytes,

                         hid_t file_mask, const char *image_mask, int channel_mask,

                         int *window_mask,

                         hid_t file_to,   const char *image_to,   int *channels_to);


 int ImageFilterBoxcarByID( hid_t in_raster_id,

                            int *filter_size, double *filter_coeffs,

                            const char *mask, int nthreads, int memsize_gbytes,

                            hid_t raster_mask_id,int *window_mask,

                            hid_t out_raster_id);


 //int LocationCreate(hid_t file_id, const char *object_name,

 //                   GeoLocationMetadata_t *location_hdr);


 //int LocationIO(hid_t file_id, const char *object_name, int func,

 //               GeoLocationMetadata_t *location_hdr);


 int LocationCopy(hid_t from_file_id, const char *from_object_name,

                    hid_t   to_file_id, const char   *to_object_name);


 int LocationReport(const char *filename, const char *object_name,

                      char **report_string);


 // reading files with keys and values in ascii:

 void set_keyval_comment(char comment_character);

 int open_keyval(char *filename, char *mode);

 int close_keyval(int filehandle);

 int read_keyval_int(int fileh,char *location);

 double read_keyval_dbl(int fileh,char *location);

 char *read_keyval_str(int fileh,char *location);

 int *read_keyval_intvec(int fileh,char *location, int *n);

 double *read_keyval_dblvec(int fileh,char *location, int *n);

 char **read_keyval_strvec(int fileh,char *location, int *n);


 /********************************************************************/

 /*  formatted_read.h  7-96                                          */

 /*                                                                  */

 /*  by Leland Pierce    (lep@eecs.umich.edu)                        */

 /*                                                                  */

 /*  This is a set of subroutines for doing reading                  */

 /*  of any type of data from a binary string.                       */

 /*                                                                  */

 /*  Data types: ASCII: int, double, string  BINARY: int, float      */

 /*  scalars only.                                                   */

 /*                                                                  */

 /*  A pointer to each dynamically-allocated variable is             */

 /*  returned.                                                       */

 /*                                                                  */

 /*  Usage:                                                          */

 /*        #include "formatted_read.h"                               */

 /*                                                                  */

 /*        link with formatted_read.o                                */

 /*                                                                  */

 /*  =============================================================== */


 /*-------------------------------------------*/

 /*     PUBLIC CONSTANTS:                     */

 /*-------------------------------------------*/


 /* integer formats that are possible: */

 #define TWOS_COMPLEMENT 1

 #define SIGN_MAGNITUDE  2


 /* real formats that are possible: */

 #define IEEE_754             1

 #define VAX_F_FLOATING       2

 #define IBM_360_370_E_FORMAT 3


 /* Possible machine names, for use in formattedReadInit */

 #define SUN      1

 #define INTEL_PC 2

 #define VAX      3

 #define IBM360   4

 #define HP9000   5

 #define APOLLO   6

 #define SGI      7

 #define DEC_UNIX 8

 /* others? */


 /*-------------------------------------------*/

 /*     PUBLIC FUNCTIONS:                     */

 /*-------------------------------------------*/


 void formattedReadInit(int machineName);


 void formattedReadRawInit(int intByteOrder[4], int   intFormat,

                           int floatByteOrder[4], int floatFormat);


 void *formattedRead(unsigned char *string, char *format);


 //==============================================================

 //=============end of formatted_read.h==========================

 //==============================================================

 //==============================================================

 //==============================================================


 /*-----------------------------------------------------------------*/

 /*                Reading URLs as files                            */

 /*-----------------------------------------------------------------*/

 #include <curl/curl.h>

 enum fcurl_type_e {

   CFTYPE_NONE=0,

   CFTYPE_FILE=1,

   CFTYPE_CURL=2

 };


 struct fcurl_data

 {

   enum fcurl_type_e type;     /* type of handle */

   union {

     CURL *curl;

     FILE *file;

   } handle;                   /* handle */


   char *buffer;               /* buffer to store cached data*/

   size_t buffer_len;          /* currently allocated buffers length */

   size_t buffer_pos;          /* end of data in buffer*/

   int still_running;          /* Is background url fetch still in progress */

 };


 typedef struct fcurl_data URL_FILE;


 URL_FILE *url_fopen (const char *url,const char *operation);

 int url_fclose (URL_FILE *file);

 int url_feof (URL_FILE *file);

 size_t url_fread (void *ptr, size_t size, size_t nmemb, URL_FILE *file);

 char * url_fgets (char *ptr, size_t size, URL_FILE *file);

 void url_rewind (URL_FILE *file);

 //==============================================================

 //=============end of reading urls as files=====================

 //==============================================================


 void convert_inertial_to_fixed(double *x, double *y, double *z,

                                double *vx, double *vy, double *vz, double gha);

 double GreenwichMeanSiderealTimeDegrees(double julian_date);

 double GreenwichApparentSiderealTimeDegrees(double julian_date);


 //==============================================================

 // reading xml files...basic stuff

 int open_xml(const char *filename, char *mode);

 int close_xml(int filehandle);

 int read_xml_int(int fileh,char *location);

 double read_xml_dbl(int fileh,char *location);

 char *read_xml_str(int fileh,char *location);

 int *read_xml_intvec(int fileh,char *location, int *n);

 double *read_xml_dblvec(int fileh,char *location, int *n);

 char **read_xml_strvec(int fileh,char *location, int *n);


 //==============================================================

 int polyfit(int npts, double *inx,double *iny, int ncoeffs, double *coeffs);


 //==============================================================

 //for reading hdf5 files that aren't geoscipy files:

 hid_t open_hdf5(const char *filename, char mode);

 herr_t close_hdf5(hid_t filehandle);

 int read_hdf5_int(hid_t file,char *location,char *name);

 double read_hdf5_dbl(hid_t file,char *location,char *name);

 char *read_hdf5_str(hid_t file,char *location,char *name);

 double *read_hdf5_dblvec(hid_t file,char *location,char *name, int *n);

 double *read_hdf5_dblmat(hid_t file,char *location,char *name, int *n, int *m);

 void read_hdf5_dataset_dimensions(hid_t file,char *location,

                                   int *ndims, int **dims);

 int hdf5_dump(int argc, const char *argv[]);


 //==============================================================

 void Geodetic2XYZ(double lat, double lon, double h,

                   double *x, double *y, double *z,

                   double major, double flattening);

 void XYZ2Geodetic(double x, double y, double z,

                   double *lat, double *lon, double *h,

                   double major, double flattening);

 //void Any2XYZ(double projx, double projy, double projheight,

 //             ProjInfo_t *projinfo,

 //             double *x, double *y, double *z);

 //==============================================================


 //temporarily here (this is pure PCI.....)

 typedef struct {

   int    pbx;     /* No. of elements computed for BETA b(X)         */

   int    pby;     /* No. of elements computed for BETA b(Y)         */

   double rbx[21]; /* Actual current BETAS b(X)                  */

   double rby[21]; /* Actual current BETAS b(Y)                      */

   double rabx[3]; /* Actual current affine BETAS b(X)               */

   double raby[3]; /* Actual current affine BETAS b(Y)               */

   double covx[21][21]; /* covariance matrix for b(X)                    */

   double covy[21][21]; /* covariance matrix for b(Y)                    */

 } GEOInfo_t;


 void    GCPRegression2(GEOInfo_t *geo,

                        double *rix, double *riy,

                        double *rox, double *roy,

                        int ngcp, int *order, double *rmsx, double *rmsy );


 void    GCPTransform(GEOInfo_t *geo, double rix, double riy,

                      double *roxhat, double *royhat);


 void    GCPTransform2(GEOInfo_t *geo, double rix, double riy,

                      double *roxhat, double *royhat,

                      double *roxerr, double *royerr);


 //==============================================================


 double JulianDateOfYear(int year);

 double DayOfYear(int year, int month, int day);


 int GetSpatialref_UTM_WGS84(int zone,char row, char *code,

                             char *wkt, char *proj4);


 int RasterDescriptorIO(hid_t image_id, const char *raster_name,

                        int func, char *descriptor);


 int RawHeaderGetSize(hid_t file_id, const char *object_name);

 int RawHeaderIO(hid_t file_id, const char *object_name, int func,

                 void *hdr, int hdrlength);

 int RawHeaderCreate(hid_t file_id, const char *object_name,

                     void *hdr, int hdrlength);


 //==============================================================


 void    DestroyStringList( char **list );

 int     CountStringList( char **list );

 char    **AddStringToList( char **target_list, char *new_string );


 //==============================================================


 #endif

   //OLDSTUFF


 #ifdef __cplusplus

 }

 #endif


 #endif

GS_ObjectIsMetadataIFileByID
int GS_ObjectIsMetadataIFileByID(hid_t dataset_id)
GS_ObjectIsMetadataIFileByID determines if the object-id refers to a metadata internal-file.
Definition: GS_ObjectIsMetadataIFileByID.c:64

GS_FileIsOpen
int GS_FileIsOpen(const_bstring filename)
GS_FileIsOpen determines if a GeoSci datafile is already open in the current process.
Definition: GS_FileIsOpen.c:50

GS_PathnameNodir
bstring GS_PathnameNodir(const_bstring name)
GS_PathnameNoDir strips the directory name from the pathname.
Definition: GS_Pathname.c:69

GS_GroupIsWriteable
int GS_GroupIsWriteable(hid_t file_id, const_bstring group_name)
GS_GroupIsWriteable returns if the group is writeable or not.
Definition: GS_GroupIsWriteable.c:48

GS_RasterCheckWindow
int GS_RasterCheckWindow(hid_t file_id, const_bstring image_name, int *window)
GS_RasterCheckWindow checks whether a requested window selection is within the bounds of an image...
Definition: GS_RasterCheckWindow.c:62

GS_DatasetClose
hid_t GS_DatasetClose(hid_t id)
GS_DatasetClose closes a dataset in a GeoSci datafile.
Definition: GS_DatasetClose.c:41

GS_RasterOpen
hid_t GS_RasterOpen(hid_t image_id, const_bstring raster_name)
GS_RasterOpen opens existing raster dataset.
Definition: GS_RasterOpen.c:65

GS_ObjectIsVectorByID
int GS_ObjectIsVectorByID(hid_t id)
GS_ObjectIsVectorByID determines if the object-id refers to a vector.
Definition: GS_ObjectIsVectorByID.c:53

GS_AbortedHistory
int GS_AbortedHistory(hid_t object_id, const_bstring history_line)
GS_AbortedHistory writes aborted message to history metadata.
Definition: GS_AbortedHistory.c:66

GS_ObjectIsIFile
int GS_ObjectIsIFile(hid_t id, const_bstring name)
GS_ObjectIsIFile determines if the object is an internal file.
Definition: GS_ObjectIsIFile.c:49

GS_ValidMetadataName
int GS_ValidMetadataName(int object_type, const_bstring name)
GS_ValidMetadataName check if the name is a valid metadata item for the given object type...
Definition: GS_ValidMetadataName.c:77

GS_CheckUniqueName
int GS_CheckUniqueName(hid_t file_id, const char *thename)
GS_CheckUniqueName check if name is unique.
Definition: GS_CheckUniqueName.c:36

GS_Dirname
char * GS_Dirname(const char *name)
Dirname returns the directory name for a UNIX pathname.
Definition: GS_Dirname.c:39

GS_RasterTypeIsComplex
int GS_RasterTypeIsComplex(int datatype)
GS_RasterTypeIsComplex returns TRUE for complex types.
Definition: GS_RasterTypeIsComplex.c:60

GS_RasterCheckWindowByID
int GS_RasterCheckWindowByID(hid_t image_id, int *window)
GS_RasterCheckWindowByID checks whether a requested window selection is within the bounds of a raster...
Definition: GS_RasterCheckWindowByID.c:81

GS_FileCopy
int GS_FileCopy(bstring oldname, bstring newname)
GS_FileCopy copies a GeoSci datafile to a new file.
Definition: GS_FileCopy.c:54

GS_ImageOpen
hid_t GS_ImageOpen(hid_t file_id, const_bstring image_name)
GS_ImageOpen opens an existing image.
Definition: GS_ImageOpen.c:52

GS_GroupRename
int GS_GroupRename(hid_t id, const_bstring oldname, const_bstring newname)
GS_GroupRename renames a group in a GeoSci datafile.
Definition: GS_GroupRename.c:45

GS_GroupDelete
int GS_GroupDelete(hid_t file_id, const_bstring group_name)
GS_GroupDelete deletes a group in a GeoSci datafile.
Definition: GS_GroupDelete.c:52

GS_ImageCreateMetadata
int GS_ImageCreateMetadata(hid_t file_id, const_bstring image_name, const_bstring descriptor)
GS_ImageCreateMetadata fills the standard image metadata attributes with the values that are passed i...
Definition: GS_ImageCreateMetadata.c:83

GS_FileOpen
hid_t GS_FileOpen(const_bstring dbname, const_bstring access)
GS_FileOpen opens a GeoSci datafile.
Definition: GS_FileOpen.c:58

GS_ConvertFromHDFDatatype
int GS_ConvertFromHDFDatatype(hid_t datatype)
GS_ConvertFromHDFDatatype returns the GeoSci datatype for the given HDF datatype. ...
Definition: GS_ConvertFromHDFDatatype.c:72

GS_GroupCreate
hid_t GS_GroupCreate(hid_t file_id, const_bstring groupname)
GS_GroupCreate creates a new group in a GeoSci Datafile.
Definition: GS_GroupCreate.c:61

GS_DatasetIsWriteableByID
int GS_DatasetIsWriteableByID(hid_t dataset_id)
GS_DatasetIsWriteableByID returns if dataset is writeable or not.
Definition: GS_DatasetIsWriteableByID.c:42

GS_FileCloseAllObjects
int GS_FileCloseAllObjects(hid_t file_id)
GS_FileCloseAllObjects closes all open objects in a file.
Definition: GS_FileCloseAllObjects.c:45

GS_GroupSetType
int GS_GroupSetType(hid_t group_id, int typecode)
GS_GroupSetType sets the type of a group in a GeoSci datafile.
Definition: GS_GroupSetType.c:53

GS_PathnameJoin
bstring GS_PathnameJoin(const_bstring front, const_bstring back)
GS_PathnameJoin joins 2 pieces of a pathname.
Definition: GS_Pathname.c:373

GS_DatatypeIsComplex
int GS_DatatypeIsComplex(int datatype)
GS_DatatypeIsComplex returns TRUE if a complex datatype.
Definition: GS_DatatypeIsComplex.c:70

GS_GroupCloseAllObjects
int GS_GroupCloseAllObjects(hid_t id)
GS_GroupCloseAllObjects closes all open objects in a group.
Definition: GS_GroupCloseAllObjects.c:46

GS_DatasetWrite
int GS_DatasetWrite(hid_t dataset_id, const long int *offsets, const long int *sizes, int datatype, const void *buffer)
GS_DatasetWrite writes data to a dataset.
Definition: GS_DatasetWrite.c:101

GS_ObjectIsRaster
int GS_ObjectIsRaster(hid_t id, const_bstring name)
GS_ObjectIsRaster determines if the object is a raster image.
Definition: GS_ObjectIsRaster.c:60

GS_GetIDName
bstring GS_GetIDName(hid_t id)
GetIDName returns the name of the given handle.
Definition: GS_GetIDName.c:39

GS_DatasetGetBounds
int GS_DatasetGetBounds(hid_t dataset_id, double *xmin, double *xmax, double *ymin, double *ymax)
GS_DatasetGetBounds returns the rectangular bounding coordinates.
Definition: GS_DatasetGetBounds.c:55

GS_init
void GS_init()
GS_init initialize some global strings.
Definition: GS_init.c:39

GS_GroupIsWriteableByID
int GS_GroupIsWriteableByID(hid_t group_id)
GS_GroupIsWriteableByID returns if the group is writeable or not.
Definition: GS_GroupIsWriteableByID.c:45

GS_DatasetDelete
int GS_DatasetDelete(hid_t file_id, const_bstring dataset_name)
GS_DatasetDelete deletes a a dataset in a GeoSci datafile.
Definition: GS_DatasetDelete.c:50

GS_DatasetGetDimensionsByID
int GS_DatasetGetDimensionsByID(hid_t id, long int **size)
GS_DatasetGetDimensionsByID returns the current dimensions for the Dataset.
Definition: GS_DatasetGetDimensionsByID.c:62

GS_ObjectIsImageByID
int GS_ObjectIsImageByID(hid_t id)
GS_ObjectIsImageByID determines if the object is an image.
Definition: GS_ObjectIsImageByID.c:55

GS_FileDelete
int GS_FileDelete(const_bstring filename)
GS_FileDelete deletes an existing GeoSci datafile.
Definition: GS_FileDelete.c:52

GS_GroupGetType
int GS_GroupGetType(hid_t group_id)
GS_GroupGetType returns the type of a group in a GeoSci datafile.
Definition: GS_GroupGetType.c:53

GS_GroupOpen
hid_t GS_GroupOpen(hid_t source, const_bstring name)
GS_GroupOpen opens an existing group in a GeoSci datafile.
Definition: GS_GroupOpen.c:47

GS_GroupGetDatum
bstring GS_GroupGetDatum(hid_t group_id)
GS_GroupGetDatum returns a description of the relevant datum if one exists.
Definition: GS_GroupGetDatum.c:52

GS_SetCacheSize
herr_t GS_SetCacheSize(hid_t file_id, size_t cache_size)
GS_SetCacheSize sets the metadata cache size for a GeoSci datafile.
Definition: GS_SetCacheSize.c:50

GS_GetValidFileID
hid_t GS_GetValidFileID(hid_t id)
GS_GetValidFileID returns a valid FileID that contains the object.
Definition: GS_GetValidFileID.c:66

GS_ObjectIsVector
int GS_ObjectIsVector(hid_t id, const_bstring name)
GS_ObjectIsVector determines if the object is a vector.
Definition: GS_ObjectIsVector.c:49

GS_GroupClose
int GS_GroupClose(hid_t id)
GS_GroupClose closes a group in a GeoSci Datafile.
Definition: GS_GroupClose.c:50

GS_CheckWindowInside
int GS_CheckWindowInside(int *window_in, const int *window_enclosing)
CheckWindowInside checks if one Window is contained by another.
Definition: GS_RasterCheckWindow.c:176

GS_ObjectIsDatasetByID
int GS_ObjectIsDatasetByID(hid_t id)
GS_ObjectIsDatasetByID determines if an object-id refers to a dataset.
Definition: GS_ObjectIsDatasetByID.c:55

GS_FileReport
int GS_FileReport(const_bstring filename, bstring report_string)
GS_FileReport summarizes the contents of a GeoSci datafile.
Definition: GS_FileReport.c:64

GS_FileCreate
hid_t GS_FileCreate(const_bstring filename)
GS_FileCreate creates an empty GeoSci datafile.
Definition: GS_FileCreate.c:87

GS_FileRename
int GS_FileRename(const_bstring oldname, const_bstring newname)
GS_FileRename renames an existing GeoSci datafile.
Definition: GS_FileRename.c:55

GS_DatasetGetDimensions
int GS_DatasetGetDimensions(hid_t id, const_bstring name, long int **size)
GS_DatasetGetDimensions returns the current dimensions for the Dataset.
Definition: GS_DatasetGetDimensions.c:68

GS_DatasetGetDatatypeByID
int GS_DatasetGetDatatypeByID(hid_t id)
GS_DatasetGetDatatypeByID returns the GeoSci datatype for the data in the Dataset.
Definition: GS_DatasetGetDatatypeByID.c:65

GS_FileCreateMetadata
int GS_FileCreateMetadata(hid_t file_id, const_bstring descriptor)
GS_FileCreateMetadata Creates metadata in a GeoSci datafile.
Definition: GS_FileCreateMetadata.c:82

GS_SetStringAttribute
int GS_SetStringAttribute(hid_t object_id, const_bstring name, const_bstring value)
GS_SetStringAttribute sets the value of a string attribute for a given object.
Definition: GS_SetStringAttribute.c:67

GS_ImageDelete
int GS_ImageDelete(hid_t file_id, const_bstring image_name)
GS_ImageDelete deletes an existing image.
Definition: GS_ImageDelete.c:55

GS_RasterDelete
int GS_RasterDelete(hid_t image_id, const_bstring raster_name)
GS_RasterDelete deletes an existing raster.
Definition: GS_RasterDelete.c:64

GS_RasterTypeIsInteger
int GS_RasterTypeIsInteger(int datatype)
GS_RasterTypeIsInteger returns TRUE for integer types.
Definition: GS_RasterTypeIsInteger.c:63

GS_DatasetGetParent
hid_t GS_DatasetGetParent(hid_t id)
GS_DatasetGetParent returns the parent object-id for a Dataset.
Definition: GS_DatasetGetParent.c:44

GS_ObjectIsMetadataIFile
int GS_ObjectIsMetadataIFile(hid_t id, const_bstring name)
GS_ObjectIsMetadataIFile determines if the object refers to a metadata internal-file.
Definition: GS_ObjectIsMetadataIFile.c:69

GS_VectorCreateMetadata
int GS_VectorCreateMetadata(hid_t file_id, const_bstring vector_name, const_bstring descriptor)
GS_VectorCreateMetadata creates vector metadata.
Definition: GS_VectorCreateMetadata.c:84

GS_GetRasterTypeAsString
bstring GS_GetRasterTypeAsString(int datatype)
GS_GetRasterTypeAsString returns a string representing the datatype.
Definition: GS_GetRasterTypeAsString.c:55

GS_CheckInternalName
int GS_CheckInternalName(hid_t object_id, const_bstring thename)
GS_CheckInternalName checks for existence of an object name in the file.
Definition: GS_CheckInternalName.c:54

GS_CheckFileExistence
int GS_CheckFileExistence(const_bstring filename)
GS_CheckFileExistence checks for the existence of a specified file.
Definition: GS_CheckFileExistence.c:47

GS_GroupCopy
hid_t GS_GroupCopy(hid_t source, hid_t destination_object_id, const_bstring destination_group_name)
GS_GroupCopy copies a group to another location.
Definition: GS_GroupCopy.c:53

GS_RasterClose
int GS_RasterClose(hid_t raster_id)
GS_RasterClose closes an open raster dataset.
Definition: GS_RasterClose.c:35

GS_ConvertToHDFDatatype
hid_t GS_ConvertToHDFDatatype(int datatype)
GS_ConvertToHDFDatatype returns the HDF datatype for the given GeoSci datatype.
Definition: GS_ConvertToHDFDatatype.c:70

GS_DatasetGetProjection
bstring GS_DatasetGetProjection(hid_t dataset_id)
GS_DatasetGetProjection returns a description of the relevant projection.
Definition: GS_DatasetGetProjection.c:54

GS_RasterCreateMetadata
int GS_RasterCreateMetadata(hid_t image_id, const_bstring raster_name, int raster_type, int npixels, int nlines, const_bstring descriptor)
GS_RasterCreateMetadata fills the standard raster metadata attributes with the values that are passed...
Definition: GS_RasterCreateMetadata.c:129

GS_GroupGetBounds
int GS_GroupGetBounds(hid_t group_id, double *xmin, double *xmax, double *ymin, double *ymax)
GS_GroupGetBounds returns the rectangular bounding coordinates.
Definition: GS_GroupGetBounds.c:55

GS_GetStringAttribute
int GS_GetStringAttribute(hid_t object_id, const_bstring name, bstring value)
GS_GetStringAttribute reads a string attribute from an object and returns its value.
Definition: GS_GetStringAttribute.c:61

GS_RasterPixelSize
int GS_RasterPixelSize(hid_t raster_id, int func, double *x_pixelsize, double *y_pixelsize, bstring pixel_units)
GS_RasterPixelSize reads/writes Raster Pixel Size.
Definition: GS_RasterPixelSize.c:64

GS_PathnameGetHDFDir
bstring GS_PathnameGetHDFDir(const_bstring name)
GS_PathnameGetHDFDir returns the directory name of the pathname.
Definition: GS_Pathname.c:289

GS_DataConversion
int GS_DataConversion(int in_type, const void *in_buffer, int out_type, void *out_buffer, int nelements)
GS_DataConversion converts a data buffer between different types.
Definition: GS_DataConversion.c:96

GS_SplitHistory
int GS_SplitHistory(const_bstring history_string, bstring front, bstring back)
GS_SplitHistory splits history string into front and back.
Definition: GS_SplitHistory.c:89

GS_GSObjectTypeAsString
bstring GS_GSObjectTypeAsString(int objtype)
GS_GSObjectTypeAsString returns printable version of the object type.
Definition: GS_GSObjectTypeAsString.c:96

GS_UpdateMetadata
int GS_UpdateMetadata(hid_t object_id, const_bstring name, bstring value)
GS_UpdateMetadata update a metadata item for the given object.
Definition: GS_UpdateMetadata.c:64

GS_AppendHistory
int GS_AppendHistory(hid_t object_id, const_bstring history_line)
GS_AppendHistory appends to the history metadata.
Definition: GS_AppendHistory.c:65

GS_PathnameGetDir
bstring GS_PathnameGetDir(const_bstring name)
GS_PathnameGetDir returns the directory name of the pathname.
Definition: GS_Pathname.c:172

GS_ObjectIsDataset
int GS_ObjectIsDataset(hid_t id, const_bstring name)
GS_ObjectIsDataset determines if an object is a dataset.
Definition: GS_ObjectIsDataset.c:81

GS_FileFlush
int GS_FileFlush(hid_t object_id)
GS_FileFlush forces the datafile to be updated.
Definition: GS_FileFlush.c:51

GS_ObjectIsMetadataDataset
int GS_ObjectIsMetadataDataset(hid_t id, const_bstring name)
ObjectIsMetadataDataset determines if the object is a metadata dataset.
Definition: GS_ObjectIsMetadataDataset.c:44

GS_AppendMetadata
int GS_AppendMetadata(hid_t object_id, const_bstring metadata_name, const_bstring value)
GS_AppendMetadata appends the given string to the metadata item.
Definition: GS_AppendMetadata.c:72

GS_ObjectUnlock
int GS_ObjectUnlock(hid_t id)
GS_ObjectUnlock changes and object to have read-write status.
Definition: GS_ObjectUnlock.c:57

GS_FileClose
int GS_FileClose(hid_t file_id)
GS_FileClose closes a GeoSci datafile.
Definition: GS_FileClose.c:50

GS_RasterCreate
hid_t GS_RasterCreate(hid_t image_id, const_bstring raster_name, int raster_type, int npixels, int nlines, const_bstring descriptor)
GS_RasterCreate create new image raster for a GeoSci Image.
Definition: GS_RasterCreate.c:88

GS_ObjectIsGroup
int GS_ObjectIsGroup(hid_t id, const_bstring name)
GS_ObjectIsGroup determines if a named object is a group.
Definition: GS_ObjectIsGroup.c:70

GS_ValidID
int GS_ValidID(hid_t id)
GS_ValidID returns whether the given object-id is a valid identifier.
Definition: GS_ValidID.c:45

GS_ObjectIsRasterByID
int GS_ObjectIsRasterByID(hid_t dataset_id)
GS_ObjectIsRasterByID determines if the object-id refers to a raster image.
Definition: GS_ObjectIsRasterByID.c:53

GS_DatasetRename
int GS_DatasetRename(hid_t group_id, const_bstring oldname, const_bstring newname)
GS_DatasetRename renames a dataset in a GeoSci datafile.
Definition: GS_DatasetRename.c:50

GS_FileCommitDatatypes
int GS_FileCommitDatatypes(hid_t file_id)
GS_FileCommitDatatypes commits the complex raster datatypes to a file.
Definition: GS_FileCommitDatatypes.c:51

GS_DatasetCreate
hid_t GS_DatasetCreate(hid_t source, const_bstring name, int datatype, int ndims, int *size, int is_extendable, int is_compressed)
GS_DatasetCreate creates a dataset in a GeoSci datafile.
Definition: GS_DatasetCreate.c:84

GS_ImageCreate
hid_t GS_ImageCreate(hid_t file_id, const_bstring image_name, const_bstring image_descriptor)
GS_ImageCreate creates a new image in a GeoSci file and opens it.
Definition: GS_ImageCreate.c:68

GS_CreateAccessPlist
hid_t GS_CreateAccessPlist(void)
GS_CreateAccessPlist creates an HDF5 access parameter list.
Definition: GS_CreateAccessPlist.c:150

GS_DatasetIsWriteable
int GS_DatasetIsWriteable(hid_t file_id, const_bstring dataset_name)
GS_DatasetIsWriteable returns if dataset is writeable or not.
Definition: GS_DatasetIsWriteable.c:47

GS_FileIsWriteable
int GS_FileIsWriteable(hid_t id)
GS_FileIsWriteable returns if file is writeable or not.
Definition: GS_FileIsWriteable.c:56

GS_ObjectGetGSChildren
int GS_ObjectGetGSChildren(hid_t object_id, int *nobjs, bstring **objnames, int **objtypes)
GS_ObjectGetGSChildren returns list of GeoSci children objects.
Definition: GS_ObjectGetGSChildren.c:97

GS_ObjectIsIFileByID
int GS_ObjectIsIFileByID(hid_t dataset_id)
GS_ObjectIsIFileByID determines if the objectID is an internal file.
Definition: GS_ObjectIsIFile.c:182

GS_DatasetGetDatum
bstring GS_DatasetGetDatum(hid_t dataset_id)
GS_DatasetGetDatum returns a description of the relevant datum if one exists.
Definition: GS_DatasetGetDatum.c:52

GS_DatasetCopy
hid_t GS_DatasetCopy(hid_t source, hid_t destination_group_id, const_bstring destination_dataset_name)
GS_DatasetCopy copies a dataset to an existing Group: this can be in the same group, a different group, or a different file.
Definition: GS_DatasetCopy.c:53

GS_GroupGetProjection
bstring GS_GroupGetProjection(hid_t group_id)
GS_GroupGetProjection returns a description of the relevant projection.
Definition: GS_GroupGetProjection.c:54

tagbstring
Definition: bstrlib.h:200

GS_ImageClose
int GS_ImageClose(hid_t image_id)
GS_ImageClose closes an Open Image}.
Definition: GS_ImageClose.c:43

GS_ObjectIsFile
int GS_ObjectIsFile(hid_t id)
GS_ObjectIsFile determines if an object-id refers to a file.
Definition: GS_ObjectIsFile.c:51

GS_HDFDatatypeClose
int GS_HDFDatatypeClose(hid_t id)
GS_HDFDatatypeClose closes an HDF datatype.
Definition: GS_HDFDatatypeClose.c:51

GS_ObjectIsGroupByID
int GS_ObjectIsGroupByID(hid_t id)
GS_ObjectIsGroupByID determines if an object-id refers to a group.
Definition: GS_ObjectIsGroupByID.c:76

GS_DatasetSetType
int GS_DatasetSetType(hid_t dataset_id, int typecode)
GS_DatasetSetType set the type of a dataset in a GeoSci file.
Definition: GS_DatasetSetType.c:43

GS_DatasetGetType
int GS_DatasetGetType(hid_t dataset_id)
GS_DatasetGetType returns the type of a GeoSci Dataset.
Definition: GS_DatasetGetType.c:44

GS_ObjectLock
int GS_ObjectLock(hid_t id)
GS_ObjectLock makes an object read-only.
Definition: GS_ObjectLock.c:62

GS_ObjectIsMetadataDatasetByID
int GS_ObjectIsMetadataDatasetByID(hid_t dataset_id)
ObjectIsMetadataDatasetByID determines if the objectid is a metadata dataset.
Definition: GS_ObjectIsMetadataDataset.c:119

GS_DatasetRead
int GS_DatasetRead(hid_t dataset_id, const long int *offsets, const long int *sizes, int datatype, void *buffer)
GS_DatasetRead reads data from a dataset.
Definition: GS_DatasetRead.c:106

GS_DatasetReport
bstring GS_DatasetReport(hid_t dataset_id)
GS_DatasetReport returns a brief description of the dataset.
Definition: GS_DatasetReport.c:69

GS_ObjectGetH5Children
int GS_ObjectGetH5Children(hid_t object_id, int *nobjs, bstring **objnames, int **objtypes)
GS_ObjectGetH5Children returns list of all children objects.
Definition: GS_ObjectGetH5Children.c:107

GS_RasterSizeInfo
int GS_RasterSizeInfo(hid_t raster_id, int *npixels, int *nlines)
GS_RasterSizeInfo returns the number of pixels and lines in a raster.
Definition: GS_RasterSizeInfo.c:77

GS_ObjectIsImage
int GS_ObjectIsImage(hid_t file_id, const_bstring image_name)
GS_ObjectIsImage determines if the object is an image.
Definition: GS_ObjectIsImage.c:51

GS_GroupReport
bstring GS_GroupReport(hid_t group_id)
GS_GroupReport returns a one-line brief description of the group.
Definition: GS_GroupReport.c:64

GS_DatasetGetDatatype
int GS_DatasetGetDatatype(hid_t id, const_bstring name)
GS_DatasetGetDatatype returns the GeoSci datatype for data in the Dataset.
Definition: GS_DatasetGetDatatype.c:69

GS_DatatypeAsString
bstring GS_DatatypeAsString(int datatype)
GS_DatatypeAsString return a string representing the datatype.
Definition: GS_DatatypeAsString.c:70

GS_GetFilename
bstring GS_GetFilename(hid_t id)
GetFilename returns the filename associated with an ID.
Definition: GS_GetFilename.c:43

GS_H5ObjectTypeAsString
bstring GS_H5ObjectTypeAsString(int objtype)
GS_H5ObjectTypeAsString returns a printable version of HDF5 object type.
Definition: GS_H5ObjectTypeAsString.c:75

GS_DatasetOpen
hid_t GS_DatasetOpen(hid_t source, const_bstring name)
GS_DatasetOpen opens a dataset in a GeoSci datafile.
Definition: GS_DatasetOpen.c:53