Service Level Agreement for Reconditioned Landsat Cat-1 Images Service Table of Contents 1 INTRODUCTION... 2 1.1 Service Description / Abstract... 2 1.2 EO Help Desk... 2 1.3 Definitions and Acronyms... 2 2 SERVICES ELEMENTS... 3 2.1 Components... 3 2.2 Architecture... 3 2.2.1 Inputs... 3 2.2.2 Processing... 3 2.2.3 Output... 4 2.3 Constraints... 4 2.4 Special features... 4 2.4.1 Images rotation... 4 2.4.2 AOI partially out of image border... 4 3 SERVICE CHARACTERISTICS... 5 3.1 Services Quality... 5 3.2 Availability... 5 3.3 Services Timing... 5 3.4 Services Limitations... 5 4 TERMS AND CONDITIONS... 5 4.1 Output Products... 5 4.1.1 Non-commercial reproduction... 5 4.1.2 Commercial reproduction... 6 4.2 Warranty... 6 4.3 Disclaimer... 6 4.4 Termination... 6 4.5 Trademarks... 7 4.6 Services Price... 7 4.7 Applicable Law... 7 4.8 Arbitration... 7 5 HOWTO... 7
5.1 Reconditioned Landsat Cat-1 Images Service... 7 5.1.1 Locate the service... 7 5.1.2 Activate the service... 8 5.1.3 Retrieve Service Results... 8 6 ANNEX 1 PROCESSING MODEL AND DATA FLOW... 9 1 INTRODUCTION 1.1 Service Description / Abstract The Reconditioned Landsat Cat-1 Images Service developed by MEEO allows the user manipulating a Landsat 5/7 image by applying, in a single service through a check-box selection, Clipping and Format Conversion operations. The processing algorithm described in the present document can be applied to Landsat images belonging to the ESA collection (Landsat TM images over Europe). The output product is a Landsat image clipped according to the Area Of Interest defined by the user and converted into the selected output format. The output format can be selected by the user through a drop-down list. Permitted formats are: GeoTIFF, JPEG and JPEG2000. In the case of JPEG or JPEG2000 formats, also a RGB quicklook is produced. The service is currently available free-of-charge to authorised Landsat Category 1 user only (authorisation can be obtained by submitting a Category-1 proposal: http://eopi.esa.int/esa/esa?cmd=aodetail&aoname=cat1). User comments are encouraged and should be passed on to the Earth Observation Help Desk. 1.2 EO Help Desk For questions, problems, complaints, special requests, comments or recommendations about the service, users can contact the: Earth Observation Help Desk E-mail: EOHelp@esa.int Phone: +39 06 94180777 The help desk service is available during working hours of the ESRIN working days. The help desk will answer to the customer within 5 working days from receipt of request. 1.3 Definitions and Acronyms User The authorised user of SSE service. A user can be authorised after submitting a Category 1 proposal Service Support Environment (SSE)
The ESA provided environment supporting provision of services published as Web Services. Reconditioned Landsat Cat-1 Images Service The SSE service described in this SLA. Output Product The output of each service. An Output Product is stored on a temporary FTP server for user transfer within the next 5 days. The link to the Output Product (FTP account information, i.e.: FTP address, username and password) is provided via the order information web page or the user order list within the SSE Portal. 2 SERVICES ELEMENTS 2.1 Components The service results from the chaining of the following basic services: 1. Landsat Image Clipping Service 2. Landsat Image Format Conversion Service The input product is selected from the Landsat Dataset through a search on the ESA catalogue. The user can then decide through a check-box selection which of the basic service to apply. The output format depends on the selected basic services. 2.2 Architecture This section gives a conceptual description about the functioning principles of the Reconditioned Landsat Cat-1 Images Service. The service permits the user to apply the Clipping and Format Conversion Services as a single service to a Landsat image collected through the Landsat TM ESA database. 2.2.1 Inputs The input parameters required by the service are: Input image (internally provided via ESA catalogue) AOI coordinates (selected using the SSE AOI feature), if the Clipping option is selected Output data format (GeoTIFF, JPEG or JPEG2000), if the Format Conversion option is selected 2.2.2 Processing The processing steps of this service are the same of the basic services forming the chain: the Clipping Service and the Format Conversion Service, besides the extraction of the input archive that is executed only at the start of the process and the creation of the output archive that is executed at the end of the process. Thus the processing steps become:
Extraction of input image Clipping option: o Conversion to GeoTIFF format o Extraction of the sub-scene o Creation of a metafile with the projection and calibration parameters Format Conversion option: o Conversion to GeoTIFF format and creation of a metafile with the projection and calibration parameters o Creation of the output image containing the results of conversion in the selected output format o Creation of the RGB quicklook if JPEG/JPEG2000 are selected as output format Creation of the output archive containing the results of conversion in the selected output format. In case of processing failure an error message is returned. More details are provided in Annex 1. 2.2.3 Output The output product is a Landsat image clipped according to the Area Of Interest defined by the user and converted into the selected output format. 2.3 Constraints The following input formats are accepted by all services: CEOS Landsat 5: the image consists of the sub directory SCENE1, that contains a series of files (LEA, DAT, TRA) related to the 7 spectral bands CEOS Landsat 7: the image consists of the sub directory SCENE1, that contains series of files (LEA, DAT, TRA) related to the 8 spectral bands and the panchromatic band 2.4 Special features 2.4.1 Images rotation This feature is applied if the original image is affected by rotation. It can happen that the AOI selected by the SSE portal does not fit perfectly with the image projection, thus the algorithm uses the AOI and image coordinates to create a geographic polygon (box) in the geometry space of the image which permits the sub-scene extraction. In this way the resulting sub-scene contains the selected area. 2.4.2 AOI partially out of image border Using the AOI feature tool available on the SSE portal it could happen that the selected AOI is partially outside the image domain. In this case the Landsat Image Clipping Service extracts the portion of scene overlapped to the AOI. In case that the AOI selected by the user is completely outside of the image domain the service returns an error message.
3 SERVICE CHARACTERISTICS 3.1 Services Quality ESA will ensure services provision with professional and workmanlike quality standards consistent with industrial ones. Users are encouraged to submit to the Earth Observation Help Desk comments, which might lead to improvements in the quality of the services or of the Output Product. 3.2 Availability During the ESRIN working days, the services are always active except when network or servers maintenance activities are being performed or due to circumstances beyond the ESRIN control. The services are monitored on a daily basis. 3.3 Services Timing The SSE services will be available starting from July 1 st 2008. 3.4 Services Limitations There are no limitations for this service, except for the Terms and Conditions below. 4 TERMS AND CONDITIONS 4.1 Output Products The following Term and Conditions apply to each Output Product. The user acknowledges that copyrights subsist for any Output Product and that all property and other rights in the Output Products and all trademarks and logos used on or in relation with the Output Products shall remain with MEEO or the license providers. 4.1.1 Non-commercial reproduction Products delivered via SSE are provided with the intent of being readily available for personal and public non-commercial use. They may be reproduced, in part or in whole and by any means, without charge or further permission from MEEO. However: The name of the algorithm SOIL MAPPER and of its owner (MEEO S.r.l.) shall be mentioned any time an Output Product is reproduced in either paper or electronic form. The reproduction of any Output Product shall not be represented as an official version of the information and the Output Product reproduced, or as having been made, in affiliation with or with the endorsement of MEEO S.r.l.
4.1.2 Commercial reproduction For commercial purposes, no part of the Output Products provided via SSE may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording or by any information storage or retrieval system, except with written permission from MEEO (contact point: MEEO Meteorological and Environmental Earth Observation Help Desk, e- mail: helpdesk@meeo.it, phone: +39 0533 57046). 4.2 Warranty Neither ESA nor MEEO provide any warranty for these services. Neither ESA nor MEEO will be deemed liable in respect of a defective Output Product. All other conditions, warranties of any kind, written, oral, statutory, expressed or implied by statute or common law with respect to any Output Product including but not limited to the implied warranty of satisfactory quality, merchantability and fitness for purpose are hereby excluded. 4.3 Disclaimer ESA does not assume any liability deemed to have been caused directly or indirectly by any content of the SSE Web site or by this service. ESA and MEEO shall not be liable for any failure to perform their obligations arising from circumstances outside their control. In no event MEEO shall be liable in any way for any loss of profit, loss of turnover, economic or consequential loss suffered by the user or any third party arising directly or indirectly from any content of the Web site or the provision of this service. With respect to documents or data provided via SSE, neither ESA, nor MEEO nor any of their employees, make any warranty, explicit or implied, including the warranties of fitness for a particular purpose, or assume any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, Output Product, or process disclosed, or represent that its use would not infringe privately held rights. Reference herein to any specific commercial products, process, or service by trade name, trademark, manufacturer, or otherwise, does not necessarily constitute or imply its endorsement, recommendation, or favour by ESA or MEEO. The views and opinions of authors expressed herein do not necessarily state or reflect those of ESA or MEEO, and shall not be used for advertising or product endorsement purposes. 4.4 Termination ESA reserves the right to terminate each of the services at any time without prior notification. If the user defaults in or commits any breach of any of his obligations, ESA shall have the right forthwith to terminate the provision of the services. In no case any refund shall be due to the user. Any termination shall not prejudice or restrict the rights or remedies of ESA.
4.5 Trademarks All brand names and product names are trademarks or registered trademarks or service marks of their respective owners. 4.6 Services Price The services are free of charge for all authorised users. 4.7 Applicable Law The license/sla terms and conditions shall be governed by Italian law. 4.8 Arbitration Each and every dispute arising out of or relating to the interpretation or execution of this license/sla terms and conditions shall be submitted to arbitration. The arbitration proceedings shall take place in Rome. The arbitration tribunal shall consist of three persons, one to be appointed by the User, one by the Agency and the third, who shall be chairman, by the two arbitrators so appointed. Should these two arbitrators not be able to agree on the nomination of the third, he shall be appointed by the president of the Court of Rome. The arbitrators shall decide according to law, and awards by this arbitration tribunal shall be binding on the parties. The proceedings and the enforcement of the award shall be governed by the Italian civil procedure law. 5 HOWTO 5.1 Reconditioned Landsat Cat-1 Images Service 5.1.1 Locate the service Connect to the SSE Portal (http://services.eoportal.org) and: In the right-bottom part of the page, insert the words Reconditioned Landsat or Reconditioned in the Search text box, select the Services radio button and press the Go button Or Select All Services in the top menu bar and look for the name of this service in the leftmost column Click on the service name to open the service description page.
5.1.2 Activate the service Login into SSE (if not already logged in). Press the Search button at the end of the service description page in order to activate the service order page. In the service Search page: Define a geographical Area Of Interest (AOI) on the map, only over Europe, Middle East, North Africa (the AOI will appear on the map in red). It must be noticed that the selected AOI is used for both the search operation and the Clipping operation. The show/hide usage notes button on the left side of the Search page provides instructions on the service usage. Define a time window Click on Search button. A list of available products, matching the search parameters, with their metadata will be shown in the scrolling window at the bottom of the page. The ground frames (scenes), corresponding to the metadata in the list, are also shown in blue on the map. One or more frames can be selected by clicking either on the list items or on the scenes on the map. For selected scenes, related blue polygon is filled with a yellow path Click the Proceed button to reach the service order page In the service order page: Choose the service modules to be applied (Clipping service, Format conversion service) in related combo box Choose the Format of the output product in related combo box Click on the Proceed button to reach the order confirmation page The system will provide an Order Identifier, which shall be used to retrieve the service result. 5.1.3 Retrieve Service Results Login into SSE (if not already logged in). When logged in: Select the Order List in the top menu bar Verify dynamically the status of all orders Retrieve the results by clicking on the Order Identifier link
6 ANNEX 1 PROCESSING MODEL AND DATA FLOW The specific processing model and data flow are summarized in the table below: Context Data Description Input AreaOfInterest This input data is selected using the aoi features tools provided by the SSE Portal. A maximum of one feature must be selected for each request and the clipping will be done over the rectangular feature bounding box. Search result Chain option Output Data Format This data is provided by means of the EOLI catalogue This data is provided by selection on the corresponding check box. Selecting Clipping and/or format conversion, the user creates the elaboration chain that will be applied to the selected image. This data is provided by selection on the corresponding drop down list, it represents the desired output format of the conversion service. Admitted values are: GeoTIFF, JPEG. JPEG2000 Action Source archive The source archive specified as input is downloaded to the service hosting machine and its contents are extracted in a working directory in order to be processed. Output Error Control Processing Result production Result access Elaboration Status Output FTP Address The chain of processing selected by the user applies the actions of each single basic service. The resulting dataset is produced in the selected format with its related metfile and packed in a single zip archive An FTP account is created on the service hosting machine TOOLBOX integrated server The elaboration outcome is provided as output to the SSE system for user information The full FTP address to download the result archive is provided as output. This address refers to the FTP account created on the hosting machine Availability time This output data specifies the time until the FTP retrieval of the result will be valid; once this time is elapsed, the FTP account will be removed. - In case of failure during the service execution no result will be available for retrieval and the user will be warned with an appropriate message through the Elaboration Status and the service stylesheet on the SSE Portal. If the error persists contact the service administrator.