TABLE OF CONTENTS

• 1 Introduction 9
• 2 Overview 11
• 2.1 Catalog Configuration Information 11
• 2.2 Catalogs 11
• 2.3 Image Servers 12
• 2.4 Catalog Servers Implementation 13
• 2.5 Adding New Catalogs 13
• 2.6 The Catalog Configuration File 14
• 2.6.1 Catalog Service Types 15
• 2.6.2 Variable Substitution in URLs 16
• 2.6.3 Plot Symbols 17
• 2.6.4 Example Catalog Config Entry 19
• 3 User's Guide 21
• 3.1 C++ Interface Library 21
• 3.1.1 World Coordinates in C++ 21
• 3.1.2 Catalog Classes 21
• 3.1.3 Determining Which Catalogs are Available 22
• 3.1.3.1 Navigating the catalog lists 22
• 3.1.3.2 Hierarchical catalog lists 22
• 3.1.3.3 Catalog Entries 23
• 3.1.4 Working with Catalogs in C++ 24
• 3.1.4.1 Catalog Queries 25
• 3.1.4.2 Query Results 26
• 3.1.4.3 TCS Catalogs 27
• 3.1.4.4 Other Query Methods 28
• 3.1.5 Image Servers in C++ 30
• 3.1.6 Error Handling 30
• 3.2 Tcl Interface 31
• 3.2.1 Working with Catalogs in Tcl 31
• 3.2.2 Image Servers in Tcl 34
• 3.2.3 Error Handling in Tcl 35
• 3.2.4 [incr Tk] User Interface Classes for Accessing Catalogs 35
• 3.2.4.1 The AstroCat, AstroQuery and QueryResult Widgets 35
• 3.2.4.2 The EnterObject Widget 37
• 3.2.4.3 The CatalogInfo Widget 37
• 3.2.4.4 The SymbolConfig Widget 38
• 3.2.4.5 The SearchConfig Widget 39
• 3.2.4.6 The PreviewPlot Widget 40
• 3.3 C Interface Library 40
• 3.3.1 Information Catalogs in C 40
• 3.3.1.1 Accessing Query Results 42
• 3.3.2 Image Servers in C 43
• 4 Reference 45
• 4.1 Commands 45
• astrocat(1) 46
• 4.2 C++ Classes and C Routines 46
• AstroCatalog(3) 47
• astroCatalog(3) 56
• AstroImage(3) 66
• astroImage(3) 69
• AstroQuery(3) 71
• CatalogInfo(3) 74
• CatalogInfoEntry(3) 76
• LocalCatalog(3) 81
• QueryResult(3) 83
• TabTable(3) 86
• TcsCatalog(3) 91
• TcsCatalogObject(3) 94
• TcsQueryResult(3) 98
• 4.3 [incr Tcl] Classes and Tcl commands 99
• AstroCat(n) 100
• astrocat(n) 107
• AstroImage(n) 115
• AstroQuery(n) 119
• CatalogInfo(n) 123
• EnterObject(n) 126
• PreviewPlot(n) 127
• QueryResult(n) 129
• SearchConfig(n) 131
• SymbolConfig(n) 133
• tcscat(n) 135
• 5 INSTALLATION 137
• 5.1 Before you build the CAT software 137
• 5.2 Build the CATLIB Software 137
• 5.3 VLT Make Procedure 138
• 5.4 Running the tests 138

Please send questions or comments to abrighto@eso.org@eso.org.
Copyright © 1998 ESO - European Southern Observatory