Archive InterOperability Users Manual
Contents
1. US e esa I Tt EC E document title titre du document ISO ARCHIVE INTER OPERABILITY AIO SYSTEM USER S MANUAL prepared by pr par par Pedro Osuna Jesus Salgado reference r ference issue dition 1 revision r vision 2 date of issue date d dition 12 Nov 2003 status tat First version Documenttype type de document Technical Note Distribution distribution Potential Users of ISO AIO System European Space Agency Agence spatiale europ enne V LLAFRANCA ISO AIO Users Manual PMA doc P 0 Box 50727 28080 Madrid SPAIN Tel 34 91813 1100 Fax 34 91813 1139 e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 2 of 32 APPROVAL author Pedro Osuna Jesus Salgado date Error auteur date Reference source not found approved by date approuv by date CHANGE LOG reason for change raison du changement date date revision revision CHANGE RECOR D Issue Revision reason for change raison du changement page s page s paragraph s paragraph s e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 3 of 32 TABLE Or CONTENTS T INTRODUCTION iei neis cuite t2. MIME Type application x fv Suffixes FTZ Then select Application on the bottom and press the button Choose to select the fv application You can use the command which fv on your console to know the exact path of the application In our case we entered usr local pub Iheasoft SunOS 5 6 sparc bin fv 96s Where we have added s to the fv path to open the downloaded fits file In case you are using Internet Explorer under Windows you will need to associate the file extension to your Fits viewer application Open My Computer select Tools and then Folder options Then select the tab File Types and create a new record for extension FTZ action open and browse to select the application you use to open Fits Files
3. files proposed There is no problem however to ask for different levels for different observations A solution to this caveat will probably be implemented in a future version of the ISO AIO e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 13of 2 4 URL MODE There is basically a unique way to use the AIO in the URL mode by linking to the AIO server scripts through a URL The user can establish hyperlinks to the relevant script to be able to download on the fly the products from the IDA directly shortcutting the IDA User Interface The possibilities are exactly the same as the ones defined in the Socket Server line request mode Nevertheless they will be explained in detail here for the sake of completeness e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 14of 2 4 1 Executing the URL mode The basic script to link to in the case of a URL request is the following http pma isavilspa esa es 8080 aio product jsp It will have to be followed by one or more of the following input parameters obsno lt PPPPPPOOLL gt amp leveE lt AAA gt amp name lt TTTTTT gt Note that the amp is literal and has to be written whenever different pa
4. OPTION gt lt VALUES gt lt PARAM gt lt PARAM name INPUT OBS ID DESCRIPTION Display a certain observation by selecting the observation number DESCRI PTI ON lt PARAM gt lt PARAM name INPUT REVNO gt lt DESCRIPTION Only the observations for this obsno will be displayed lt DES CRI PTI ON gt lt PARAM gt lt RESOURCE gt lt VOTABLE gt e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 270f 2 6 APPENDIX A aioreqset dtd DTD for XML requests aioreqset dtd ELEMENT aioreqset aioreq lt ATTLIST aioreqset project IDA IDA compression TAR TAR media DIRECT DIRECT gt lt ELEMENT aioreq obsno prodtype gt lt ELEMENT obsno PCDATA gt lt ELEMENT prodtype EMPTY gt lt ATTLIST prodtype name aocsl apphl cciml ccshl cderl cglll cierl ciphl ciphl cispl cisrl cjaml cmapl cmosl colri cpe cpc cperl cpsi cpspl crphl crphl csp csp csspl cstal cstal cuffl cuffl cuffl eohal eohcl eohil eohil gehkl gehkl gshhl iiphl iiphl irph irphl Icsh Igerl lgifl lgifl liacl liac QS esa lierl ipdl ipd lisrl Ilerl olrl Ipaal paal padi padi pari Ipc Ipc Ipsp Isaal Isani Isan Iscal Iscal Iserl Isnrl Isnrl Isp Isp Ispdl Isspl Istal Istal lwghl Iwhkl Ixerl plerl plerl
5. client although its simplicity makes it very easy to compile and run the client in any other operating system The Solaris executable is called aioclient and the java script that it compiles and runs is called AioClientjava You must have both copied locally to your machine to be able to use them The files are available at http pma iso vilspa esa es 8080 aio doc follow the links to the ATO Client The following are the steps to run the tool 1 Get the files aioclient and AioClient java from aforementioned location you can right click on the links to download the files 2 In the directory where you have copied the files try aioclient S AIO host machine P A IO host port L lt input line F lt input file O output dir cp classpath Where gt AIO host machine will be xsa vilspa esa es by default gt AIO host port will be published in the AIO Home page 2002 will be the default gt Input line a GET line like the one specified in 3 1 Note that the input line must go between quotes gt Input file is an XML file as specified in section 3 2 gt output dir is the directory where the file resulting from the request will be written the default output directory will be gt classpath is the classpath where your AioClient class will be by default i e the current directory note that the L option and the F option are mutually exclusive t
6. p2erl p2erl p2esl p2esl pclal peldl peldl pelsl pc2al pe2dl pc2dl pc2sl pcae pcapl pcasl pesh pesv pgai pgatl pgaul pisrl plae plap plas polr pplal ppld ppidi pplsl pp2al pp2dl pp2di pp2sl pp3al pp3di ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 280f 2 e S a ISO Archive InterOperability AO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 290f 2 pp3dl pp3sl ppael ppapl ppasl ppc ppc pperl pperl psael psapl psas pserl pserl psld psisi psp psp pssdl psss pstal pstal pstil pstil scshl sisrl solrl spc spc ssp ssp sstal sstal swaal swaal swerl swghl swspl urd all all level Basic SciencelFully ProclQuick LooklRaw DatalHPDPICustom Quick Look extension fitsifit gzlall all e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 300f 2 7 APPENDIX B How to run the default client We provide a default client implemented in java You must have a JDK installed in your computer to be able to run this client For the time being only a Solaris script is given to run the
7. 03 09 08 16 33 58 AIOSOCK18519 35400268 tar gz rw r r 26002 2003 09 08 16 34 04 AIOSOCK18519 57600101 tar gz The input soXmlReqTest xml is an XML file containing your request values e g lt xml version 1 0 lt DOCTYPE aioreqset SYSTEM http pma iso vilspa esa es 8080 aio conf aioreqset dtd lt aioreqset gt lt aioreq gt lt obsno gt 57600101 lt obsno gt lt prodtype level Custom name cpc gt aioreq lt aioreq gt lt obsno gt 35400167 lt obsno gt lt prodtype level Basic_Science gt lt aioreq gt lt aioreq gt lt obsno gt 35400268 lt obsno gt lt prodtype level Quick_Look gt aioreq aioreqset e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 320f 2 8 APPENDIX C How to Configure the browser to run an application The following example will describe how to configure your Netscape Browser to automatically run an application in this case the fv Interactive FITS File Editor developed by NASA s HEASARC Select the Edit menu of your Netscape Browser and then select the Preferences submenu A new window will be opened Expand the Navigator selection with a double click and select the Applications option Press the new button to create a new entry Hill the fields with the following information Description Compressed Fits
8. ESCRIPTI ON gt lt PARAM name INPUT POS gt lt DESCRIPTION gt Search Position in the form ra dec where ra and dec are given in decimal degrees in the I CRS coordinate system DESCRIPTI ON gt lt PARAM gt lt PARAM name INPUT POS EQ RA MAIN lt DESCRIPTION gt Search for this RA given in decimal degrees in the I CRS coordinate system DESCRI PTI ON PARAM lt PARAM name INPUT POS EQ DEC MAIN e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 260f 2 lt DESCRIPTION gt Search for this DEC given in decimal degrees in the I CRS coordinate system DESCRIPTI ON PARAM lt PARAM name INPUT ID TARGET gt DESCRIPTION The other way to select a coordinates position Input the target name and it will be resolved by the resolver service SI MBAD by default Compatible with SIZE input lt DESCRI PTI ON gt PARAM lt PARAM name INPUT SI ZE lt DESCRIPTION gt Size of search region in the RA and DEC coordinates DESCRI PTI ON gt lt PARAM gt lt PARAM name INPUT FORMAT value VOTABLE gt lt DESCRIPTION Requested format for the output table lt DESCRI PTI ON gt VALUES type legal invalid no gt OPTI ON gt VOTABLE lt OPTI ON gt OPTI ON gt HTML lt OPTION gt lt OPTI ON gt TXT lt OPTI ON gt OPTI ON gt METADATA lt
9. SOCKET MODE In the Socket mode the client locally installed in the user machine establishes a connection to the AIO Socket Server and sends a request with a fixed set of input parameters The Socket Server gets the input parameters and processes the request accordingly after which it dumps the result file to the Socket output The user can then save the output stream to a file display the image or do whatever needed The Socket Server allows users to make requests for one or for more observations The client utility has to be implemented by the user and thus the scope of this utility is reduced to those who know how to implement a proper Socket Client in their pre ferred language Nevertheless a simple Socket Client written in Java is available at the home page of the AIO for those who want to use it to retrieve their data through the Server Socket The code is freely available and can be modified without notice to accomplish the desired needs of the user It has been written very simple with no configurable items to allow everyone to use it with a very limited knowledge of socket programming 2 2 URL MODE In the URL mode the user connects to the AIO system through a URL link from which the same machinery as in the Server Socket mode is started with the difference that the URL mode will dump the file to a temporary FTP area where the user can download it from For specific cases like PNG images or compressed uncompressed FITs formats t
10. Target_Name ucd VOX I mage Title datatype char arraysize gt FIELD ID Start Time ucd VOX OBS_START_TI ME datatype char arraysize gt FIELD ID End Time ucd VOX OBS_END_TI ME datatype char arraysize gt HELD ID RA ucd POS_EQ_RA_ MAIN datatype char arraysize gt lt FIELD ID DEC ucd POS EQ DEC MAIN datatype char arraysize gt FIELD ID NAXES ucd VOX I mage Naxes datatype int gt FIELD ID NAXI S ucd VOX I mage Naxis datatype int arraysize gt FIELD ID SCALE ucd VOX I mage Scale datatype double arraysize gt FIELD D FORMAT ucd VOX I mage Format datatype char arraysize gt DATA lt TABLEDATA gt lt TR gt e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 23of 2 lt TD gt 03003401 lt TD gt lt TD gt I CDATA http pma iso vilspa esa es 8080 aio jsp productjsp obsno 03003401 amp protoc ol HTTP amp name csp amp level C ustom 11 lt TD gt lt TD gt ISO CAMO1 I mage Target M51_LW3 lt TD gt lt TD gt 17 Dec 1995 15 08 41 lt TD gt lt TD gt 17 Dec 1995 17 45 01 lt TD gt lt TD gt 202 47285 lt TD gt lt TD gt 47 22905 lt TD gt lt TD gt 2 lt TD gt lt TD gt 10 10 lt TD gt lt TD gt 63 63 lt TD gt lt TD gt image fits lt TD gt lt TR gt e
11. c product ss 15 5 SIAP COMPLIANT MODE icici Red on ke kk vo eke teria acie tuin ou Duden 21 HH CONE SEARCHES 32 2 aede ele qeu ns 21 5 1 1 CONE SEARCH for a region of sky in HTML format 2 5 1 2 CONE search in default VOTable output format 22 5 1 3 BOX SEARCH ER oett oett a n ed ie tiet esee ae ege ertet 23 5 1 3 1 Searches can be done in RA and DEC with a BOX 23 5 1 3 2 BOX searches in other parameters etnies nne 24 5 2 TARGELSEARCGHES nepeptte lb ste PRAE e I aM Ue sos kol eio sey 24 5 9 METADATA SEARCH ip eerte ERR eee e t ete ee OR opa tee teet ero reet e tte salon 25 6 APPENDIX A aioreqset dtd eke risanti imi sanba anons kako kanta ora in kek aka oi ir asasine 27 7 APPENDIX B How to run the default client eene eere rnm 30 e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 4 of 32 8 APPENDIX C How to Configure the browser to run an application 32 e S a ISO Archive InterOperability AO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 5 of 32 1 INTRODUCTION 1 1 PURPOSE OF THE DOCUMENT The purpose of this document is to describe how to make proper use of the facilit
12. cation Ftp ftp iso vilspa esa es 21 pub ATOUR j Ey What s Related L NOA OG 4 XM f Java 14 API 4 XSAint J IDA 4 ScienceDirect S XSA GF Serco 4 M51 LW3 14 JUN 1997 CAMO1 RA Dec 13h29m53 58s 47 13 45 J2000 TDT No 57600101 CAM Filter centre 14 30 pm PFOV 3 0 arcsec Polar HOLE 1 55E 02 20 eed asANS n EE teke se H 1 35E 02 1 13E 02 15 ph os Sock eo AAA ART e zi fe ANN B 21E 03 7 08E 03 47 10 e m p 4 95E 03 2 B2E 03 i3 xg m 30 oos 29 398 ren OLP_iQ CALG 70 CAM Browse V3 1 BID We J SP E we e S a ISO Archive InterOperability AO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 180f 2 in the case that the file you requested would be a FITs file either compressed or uncompressed you can also tell the browser to run a fits viewer application a good example of which would be the fv so that you would be able to view the FITS file immediately after requesting it e S a ISO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 19of 2 POW 1 410 N File Edit Colors Tools Zoom Replot Zoom Help Graph coordinates CX X 13h29mED 6 e S a ISO Archive InterOperability Al0 System User s Ma
13. he client works either in line mode or in file mode The tool will compile and execute the client An obvious measure to increase the speed will be to edit the aioserver cshrc file and remove the bit where the file is compiled leaving only the execution file is compiled only once at the beginning We will offer support and will publish a proper FAQ in the AIO home page An example of a specific request follows e S a SO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 310f 2 aioclient S pma iso vilspa esa es P 3100 L GET obsno 57600101 Your request to the VILSPA Archive Inter Operability system has finished File AIOSOCK18517 tar gz has been created locally aioclient S pma iso vilspa esa es P 3100 L GET obsno 57600101 level Custom name cpc Your request to the VILSPA Archive Inter Operability system has finished File cpc57600101 gif has been created locally aioclient S pma iso vilspa esa es P 3100 F isoXmlReqTest xml aioclient Your request to the VILSPA Archive Inter Operability system has finished File AIOSOCK18519 tar gz has been created locally gunzip AIOSOCK18519 tar gz tar tfv AIOSOCK18519 tar drwxr xr x 0 2003 09 08 16 34 06 AIOSOCK18519 rw r r 1472083 2003 09 08 16 33 46 AIOSOCK18519 35400167 tar gz rw r r 34833 20
14. he user can setup his her browser so that the results can be displayed directly in the browser browsers can be instructed to execute certain actions for specific file types e g fv for FITs images etc C e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 7 of 32 2 3 SIAP COMPLIANT MODE In this mode SIAP Simaple Image Access Protocol compliant requests can be done to the archive Please consult the IVOA initiative web page to know more about SAIP protocol Details on how to use it will be given later in this document e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 80f 32 3 SERVER SOCKET MODE There are two different ways of using the Server Socket mode 1 Through a so called line request 2 Through an XML file In either of the two cases the user must run a client that opens a socket to the Server Socket who is listening in a specific port After sending the request through the port it is processed by the system and the results are sent back as a stream of bytes through the socket The client e g the AIO Simple Client then converts the output to a meaningful file The client supplied by the VILSPA team does all this process automa
15. ies offered by the ISO Science Data Archive IDA Archive InterOperability System AIO henceforth 1 2 INTENDED READERSHIP This document is directed to the following users of the ISO Data Archive data External applications wanting to access ISO Science data bypassing the current IDA User Interface e g applications in the Archive Virtual Observatory AVO context Normal and expert users who want to download publicly available products shortcutting the current IDA User Interface Normal and expert users who want to make links to directdownload of products through URLs to the ISO Archive products shortcutting the current IDA User Interface Expert users who want to establish client sockets that are able to download specific sets of products through a product socket server Normal and expert users accessing the Postcard Server and the associated Product Server links from it 1 3 DEFINITIONS ACRONYMS and ABREVIATIONS AIO IDA RP UI BL ARCHIVE INTEROPERABILITY System ISO Data Archive IDA Request Processing subsystem IDA User Interface subsystem IDA Business Logic subsystem e S a ISO Archive InterOperability AO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 6 of 32 2 MODES OF OPERATION The AIO can be used mainly in one of the following two modes 1 Server Socket mode 2 URL Mode 3 SIAP compliant mode 2 1 SERVER
16. ined follows 5 1 1 CONE SEARCH for a region of sky in HTML format http pma isavilspa esa es 8080 aio jsp siap jsp POS 202 5 47 1 amp SIZE 0 01 amp FORMAT HTM the result will be e S a ISO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 220f 2 p SIAP qum m E Ed Yew Fave Icok Heb el T 3 d a J D FS c ud g Back em Siop Fieesh Hone Seach Favoitss Hitoy Mal Pre Ek Discuss Dat Home Aces dd Hitpu praiso mkpa esa ec BOBO wc wap sp POS e 202 6 47 155 2E 0 T FORMAT HTML Poe questions cosuments please contact the 92 Help oak rm 5 1 2 CONE search in default VOTable output format The same query as previous one but without the format html will give the result in the default output format for the IVOA i e in VOTable format refer to the www ivoa netto know more about the VOTable In this case the result would look like lt xml version 1 0 gt lt DOCTYPE VOTABLE View Source for full doctype gt lt VOTABLE version 1 0 gt RESOURCE type results gt DESCRIPTION ISO Simple I mage Access Protocol SI AP Service DESCRI PTI ON gt INFO name QUERY STATUS value OK gt lt TABLE gt FIELD D ObsId ucd OBS ID datatype char arraysize gt lt FIELD D Reference ucd DATA LINK datatype char arraysize gt lt FIELD D
17. nual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 200f 2 please refer to Appendix C on how to configure your browser to automatically run an application e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 210f 2 5 SIAP COMPLIANT MODE The International Virtual Observatory Archive has defined the Siample Image Archive Protocol to be used as the standard protocol in the building of an international Virtual Observatory Please consult the IVOA web pages at http www ivoa net to know more details about the project and the SIAP protocol itself In summary the SIAP protocol defines what services MUST be available to an external client that wants to access the data server by the Data Provider in this case client would be any entity from outside the ISO project wanting to acess the Data Provider ISO project data The AIO has been modified to be compliant with this new protocol It follows a brief description with examples of the type of queries that can be done through the SIAP compatible part of the AIO 5 1 CONE SEARCHES One of the most important bits of the SIAP is the Cone Search every data provider must provide this service to be SIAP compliant An example of the type of query and the results that can be obta
18. observation GET obsno 0112570401 In this case the result of the request will be a tar file containing all the products for this Observation e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 10of 2 3 1 1 2 Request for Basic Science products for one observation GET obsno 0112570401 le vel Basic Science In this case the result of the request will be a tar file with all the Basic Science products defined for that observation 3 1 1 3 Request for ONE specific file To request one and only one file all the input parameters that define that file have to be given The process is very simple if we want to get the file with name CPC57600101 FITS we will input the following command line GET obsno 0112570401 level Custom name cpc Note that level Cusatom is compulsory when specifying the name option The result of the request will in this case be one single file 3 1 2 SERVER socket request output The Server Socket request sends the following information through the output stream An ASCII line indicating the name of the product being given real name of a file in the case of ONE and only one file composed AIO Server given name for the case of multiple products A binary stream containing the products The VILSPA AIO client offered in the AIO Home page takes care of the prope
19. oe meat rie eee ie a ok en 5 11 PURPOSEOPTHEDOCUMENT iiie n ert b HERR sod REPRE CH PER regente TH a 5 1 2 INTENDED READBERSHID 3 eere er en m P Bye erie ae 5 1 3 DEFINITIONS ACRONYMS and ABREVIATIONS nennen nennen eterne 5 2 MODES OF OPEBATION eiecit eee nos DuC ks ceca ce cee er eerie 6 2 1 SERVERSOCKEI MODE ie ma le cette tee a t de teet EH tends 6 2 32 URE MODE oett RERO i eeu OPPRESSA e EET NE noon ERES 6 2 3 SIAP COMPLIANT MODE e eeeseseeee eese enian atiota ensosooosoveneosooenooeaeoaooneoesoaoesoooenn 7 3 SERVER SOCKET MODE he p redet honors cereo koko docete i back da ann ii 8 3 1 SERVER SOCKET LINE REQUEST inserer enne thee stri n teen neas 9 3 1 1 Examples of server socket mode line requests 9 3 1 1 1 Request of ALL products for one observation 9 3 1 1 2 Request for Basic Science products for one observation eee 10 3411 1 3 Request for ONE specific Mile eite dte rote mei Cere Meteo ette en 10 3 1 2 SERVER socket request Output sus 10 3 2 SERVER SOCKET XML REQUEST eene aieo ieissa etn ntes nnne 11 4 URL MODE 13 4 1 Executing the URE Mode sente tiennent EE teinte rhe ree robe He Ue ete EE HORA 14 4 1 1 EXAMPLES OF URL MODE EXECUTION ere 14 4 1 1 URL Request for default products of one observation QuickLook 14 4 1 1 2 URL Request for ONE specifi
20. r streaming to file of the Server Socket results The user shall be able to modify the output coming from the socket at his her disposal See APPENDIX 6 on how to run the VILSPA AIO client e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 11of 2 3 2 SERVER SOCKET XML REQUEST The user can send a request to the server socket giving as input an XML file description of the required data The XML file will have to obey a specific DTD given at the APPENDIX A The form of the XML file will be the following lt xml version 1 0 gt lt DOCTYPE aioreqset SYSTEM http pma iso vilspa esa es 8080 aio conf aioreqset dtd gt lt aioreqset gt lt aioreq gt lt obsno gt RRRTTTTTOO lt obsno gt prodtype name T TTT leveE AAA lt aioreq gt lt aioreqset gt Note that the prodtype attribute parameters are this time quoted please refer to the DTD at the APPENDIX for exact definition of XML file A correct example of an XML request for different settings for different observations is given in what follows lt xml version 1 0 2 gt lt DOCTYPE aioreqset SYSTEM http pma iso vilspa esa es 8080 aio conf aioreqset dtd lt aioreqset gt lt aioreq gt lt obsno gt 57600101 lt obsno gt prodtype level Custom name cpc lt aioreq gt lt aioreq gt lt ob
21. rameters are given standard in HTTP see section on definitions for details 4 1 1 EXAMPLES OF URL MODE EXECUTION 4 1 1 1 URL Request for default products of one observation QuickLook In this case the URL would be of the form http pma isavilspa esa es 8080 aio jsp product jsp obsno 57600101 After the request has been processed by the system the following page is shown ISO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 150f 2 Tito ET APOT ANANA iT tT Tat GR han 930 Ed Ud TEUER EDEN tee hit HR Sard e Pietas ES 2 Pes Eni s Hep jou Bux locaton http fiaou53 2080 faio jap product j5p obsno 576001 01 1 What s Fas batacl a woe ga LINN A matanri Px 4f DA f ScerceCuect MUSA f Serco Pase Tit NT SWA L SOT A PRED Dacumert Facitty Cf Lootup INFRARED SPACE OBSERVATORY sesa The ISO Data Archive Product Server Your data have been created You wifi be redirected in 6 aecom s to the Me er you con GIck he kk binw ler Arcam po sunu A Dirmcicran Files JASO v1pl ps qz tpa POSINA10541 tar gz dt POSINA10513 ter gx fn POSUNA0545 tar gz fullciccle POSUNA10551 tar qe fv POSINAiD55 tar gx gf tp POSUMALOSS3 tar gx girp 1l 2 yo POSUMAIGLM tai ge Selection heme pa surm AIOURL1BS52D tar gee E Caret Gortain hest tpio
22. sno gt 35400167 lt obsno gt prodtype level Basic_Science gt lt aioreq gt lt aioreq gt lt obsno gt 35400268 lt obsno gt prodtype level Quick Look aioreq lt aioreqset gt e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 120f 2 The XML mode is useful when the user wants to download directly more than one observation and maybe even different levels of processing for each observation exposure source etc It is the responsibility of the user to input meaningful parameters in the XML file In case the request gives as a result some non existing combination of products the Server Socket will send an error file back to the socket stream the error file being called output err Inside this file the user will find useful information on what the error was and how it can be solved most of the times parsing erras from XML parsers due to wrong or incomplete XML file inputs CAVEAT in the case of ISO and due to the nature of the Bussiness Logic access to the database it is not possible to select different Custom levelks for different observations This means that if in the same XML file different observations are introduced with different name aocs cmap etc with the level set to Custom all of them will get the same Custom set and not the specific name
23. tc lt TR gt lt TABLEDATA gt lt DATA gt lt TABLE gt lt RESOURCE gt lt VOTABLE gt As the browsers are not compatible with the VOTable format to see the VOTable you will have to use the View Source facility in your browser some browsers as the Netscape 4 7 will apparently not do anything after the request has been sent but clicking the View Source will unveil the VOTable format In view of the general absence of good VOTable browsers we have decided to include the FORMAT HTML option which is not SIAP compulsory but we believe is extremely useful 5 1 3 BOX SEARCH 5 1 3 1 Searches can be done in RA and DEC with a BOX http pma iso vilspa esa es 8080 aio jsp siap jsp POS EQ RA MAIN 13 4 amp POS EO R A MAIN 13 6 amp POS EQ DEC MAIN 47 1 amp POS EQ DEC MAIN 48 2 amp FORMAT html e S a ISO Archive InterOperability AO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 24of 2 T SIAP Access rezullz Microzoll Internet Explorer Eb Edi Bow Fame Ioh Hee ae V 9 A d QG x vi uw a S Leod Siop Reresh Hame Sesch Favoke History An ter Dicuss Del Hone INFRAREQ SPACE OBSERVATORY esa The ISO Data Archive SIAP Query Service Pot questions comments please routact tbe IDD 5 1 3 2 BOX searches in other parameters BOX searches can be done for e
24. tically but the option is given to expert users to create more complex actions via software on the output coming from the socket See details below on how to use these facilities e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 9 of 32 3 1 SERVER SOCKET LINE REQUEST The request is done by inputting a single line to the Server Socket The current Server Socket machine name IP address etc will always be available at the AIO Home page The utility client offered in the AIO home page will contain hard coded entries for the server details The line input to the Server socket must be as follows GET obsno lt obsno gt leveE lt level gt name product name gt Where bold strings are literals i e have to be written literally angular brackets denote user inputs and square brackets denote optional inputs Note that order does NOT matter and that string inputs do NOT have quotes for more information see examples below The description of the input parameters follows Obsno ISO Observatino number 8 digits REVNO TDT OSN level User Interface defined level Can be one of trhe following Basic_Science Fully_Proc Quick_Look Raw_Data HPDP Custom name Product type e g aocs cmap cmos 3 1 1 Examples of server socket mode line requests 3 1 1 1 Request of ALL products for one
25. tpasaautt gine em c r this file will contain in this case the QuickLook products for obsno 57600101 4 1 1 2 URL Request for ONE specific product In this case the following link shall be used http pma isavilspa esa es 8080 aio jsp product jsp obsno 57600101 amp level Custom amp name csp in this case only one file will be produced the name of it as found in the ISO archive itself will be given e S a ISO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 160f 2 The ISO Data Archive Product Server Your data have been created You w t be redirected in 5 seconds 10 ibe file or you can chok Dye kak betow i z fi it a EE HE UU d auem after five seconds the browser will point you to a window asking you to locally save the file However if you have your browser configured to execute automatically applications like an image viewer the browser will directly show the image in this case it is an image to you as in the example e S a ISO Archive InterOperability AlO System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 170f 2 File Edit View Go Communicator Help 92 3 dans dx 2 Back Forward Reload Home Search Netscape Print Security Shop Stop q wt Bookmarks A Lo
26. xample In revolution number http pma isovilspa esa es 8080 aio 1sp siap sp REVNO 2500 amp REVNO 502 amp FORMAT HTM 5 2 TARGET SEARCHES Target searches only names accepted by the HTML input parameters can be done with the SIAP compliant version of the AIO http pma isavilspa esa es 8080 aio sp siap jsp ID TARGETZM51 amp FORMAT HTML e S a ISO Archive InterOperability Al0 System User s Manual issue Error Reference source not found revision Error Reference source not found Error Reference source not found page 250f 2 3 SIAP Access results Microsoft Internet Explorer File Edt View Fawomet Took Help ere 9 d dj a 218 2 a n Bak fone Stop Refiesh Home Sewch Favokbes Heo Mal Piri Fet Dios Deb Home Agress ur Wire pens ino wispa esa er BOE me h n sisp pom TARGETeMSTsermat imi vi eso For questions comments please contact the Helpdesk 5 3 METADATA SEARCH To know which type of data can be accessed through the AIO the following query has to be done http pma isavilspa esa es 8080 aio jsp siap jsp format metadata Obviously the output format of this request will be the default one 1 e VOTable and the View Source facility of your browser will display something like lt xml versionz 1 0 gt lt DOCTYPE VOTABLE View Source for full doctype gt lt VOTABLE version 1 0 gt RESOURCE type results gt DESCRIPTION XMM Siap Query Service D
Download Pdf Manuals
Related Search