LIO DOTNET server – users' manual

Document Sample
LIO DOTNET server – users' manual Powered By Docstoc
					EUROPEAN COMMISSION
DIRECTORATE GENERAL JRC JOINT RESEARCH CENTRE - ISPRA Institute for the Protection and Security of the Citizen Agriculture and Fisheries Unit JRC IPSC/G03/P/PAR/par D(2005)(3908) /

Technical report

LIO DOTNET server – users’ manual

Author: Co-author: Approved: Date:

Mihaela Fotin Philippe Buchet, Armin Burger Pär Åstrand 31/03/2006

Status: Circulation: Int. ref:

V2.1 Internal/Commission file://S:\FMPArchive\P\3908.doc

Contents 1.
1.1.

Introduction...............................................................................................................2
Objectives............................................................................................................................................ 2

2.
2.1. 2.2.

Instructions ...............................................................................................................2
LIO DOTNET....................................................................................................................................... 2 The MARS VHR Browser.................................................................................................................. 13

Post: IPSC-AGRIFISH, TP 266, Joint Research Centre, I-21020 Ispra (VA), Italy Telephone: direct line +39 0332 78 «Telephone1» Facsimile: +39 0332 78 «Fax1» E-mail: «email1» URL: http://agrifish.jrc.it/

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

1.
1.1. 1.2.

Introduction
Objectives The objective of this document is to give instructions on how to handle the interface with the LIO DOTNET server and the MARS VHR Browser. All actors involved (Image Providers, Contractors, National Administrations and the JRC) need to understand the workflow and the role they have to play in order to synchronize the actions between the different actors and to ensure a good interaction for the acquisition management of the Campaign. Fig. 1 - Image Request Workflow

National Administration asks images from site and window. to JRC JRC request images to providers Providers upload images (QL)

Contractor accept images (QL) if proposed JRC sends out order to provider

Provider sends out invoice to JRC

Provider sends out images to Contractor

2.
2.1. 2.1.1.

Instructions
LIO DOTNET The LioDotNet application is a web-based informatics application that manages request, validation, ordering, invoicing and archiving of satellite images. An automatic mail exchange takes place to synchronize actions between different actors such as providers, contractors, the JRC and National Administrations. From a technical point of view the application is based on the dotnetnuke portal that runs on the DOTNET framework from Microsoft.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

2

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

2.1.2.

Rules for the use of the LIO application o o Never use the back functionality of your explorer, use the menu item or the back link on the current page All fields referenced by a red colour are required fields

2.1.3.

First Connection

The user connects to the LIO application with the internet browser at this address: http://lio2.jrc.it/liodotnet/default.aspx When a contact (image provider, contractor, national administration or other user) is created in LIO an account is automatically created with the following information. The user can login with the following information: Username = your lastname and Password = your lastname
User Name:

buchet
Password:

******

Remember Login

. After the login:

Login

Register

Passw ord Reminder

It is better if the user changes his password as soon as possible by clicking on the login information at the top right of the screen:
Register

* A ll field s m ark ed w ith a n asterisk (* ) are req uired . First N am e: Stre et: Philippe * L as t N am e: U s er N a m e: E m a il A d dress: W eb site: Ins ta nt M ess eng er ID :
Buc het
U n it # :

*
C ity: C ou n try :

B uch et
philippe.buc het@ jrc .it

<Not Spec if ied>

*

R e g ion : P o stal C od e : Te leph one : C e ll: F ax :

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

3

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

Entering and confirming a new password.

After these steps you are ready to use the LIO application. All pages are organized in the same way:

-

The user can add a new item by clicking on the small pencil icon placed to the left of the title. The user can edit an item by clicking on the small pencil icon placed to the left of the item The user can exit from the current page by using the menu item to go directly to a new page or use the back link to go back or if the page is modified make the update by the update link.

Important! Before starting the Campaign, it is recommended for all users to enter in LioDotNet, to click on Mail Selection, and to select the automatic e-mail notifications they want to receive during the Acquisition Campaign.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

4

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

All users can select the Resolution for which they want to be notified: HR or VHR.

2.1.4.

JRC: Workflow and Acquisition Request (AR) status:

2.1.4.1. The JRC enters the acquisition request information in the LIO application: o o o o o o o o Site (define the site with geographic information only), Window (only period information), Providers, Contractors, Platforms, Sensors, Products, Administrations

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

5

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

The JRC publishes the Acquisition Request (AR) and a notification mail containing a description of the acquisition request is sent to the users which want to receive this mail. The JRC will issue an AR for the product type requested. In the case when a validated acquisition is uploaded, the JRC accepts and closes the acquisition and issues an order within 2 working days. The colouring in the Acquisition Request (AR) list, when an acquisition is closed and ordered: Green for full coverage and light green for partial coverage In the case when a proposed or retained acquisition is uploaded, the Contractor will accept or reject the acquisition and the JRC will confirm the choice of the Contractor within 3 working days. Each of these actions notifies the actors concerned by email. After the closure of the AR, JRC will issue the Order. The Orders for HR and VHR will be always separated.

2.1.4.2. Explanations for possible Acquisition JRC Status Not Requested (N): Used when the file does not need a JRC or Contractor validation. Accepted (A): The JRC accepts the Validated, Proposed or Retained acquisition file upload by the provider. Rejected (R): The JRC rejects the Validated, Proposed or Retained acquisition file upload by the provider. Empty (E): The JRC has not yet Accepted or Rejected the acquisition.

2.1.4.3. Explanations for possible AR Status (Fig.2) In Preparation: This AR is in preparation, the step before publishing (published state: opened) Opened: This AR is published and the provider can upload acquisitions. Cancelled: This AR is cancelled by the JRC before publishing it. This Acquisition Request will not be visible after this operation. Accepted: The AR is accepted (window closed) with either full or partial coverage. Closed: The AR is closed (window closed). In case of competitive AR it means that one of the other competitive ARs has been accepted. In case of a speculative AR it means that the corresponding dedicated AR was accepted (and hence we do not need the speculative AR any more) Failed: This AR has failed (no acquisition during the opened window). Extended: This AR is extended.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

6

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

Fig. 2 Acquisition Request (AR) Status
Acquisition Request (AR) Status EMPTY

Image

PROPOSED OR RETAINED

NOT REQUESTED

VALIDATED

Image

REJECTED

ACCEPTED

Image

REJECTED

ACCEPTED

Waiting new acquisition PARTIAL Acquisition Request Coverage JRC STATE CONTRACTOR STATE PROVIDER STATE ACQUISITION REQUEST COVERAGE STATE FULL

Creating new acquisition request

Closing acquisition request

2.1.5.

Image Providers: Work flow and Acquisition Provider Status

2.1.5.1. Workflow The Provider will in LioDotNet see all the dedicated sites, ARs and Actions relevant for him.

In all ARs there is the list of the images status and the link to the order.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

7

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

Acquisitions Actions contains the all the pending actions on Acquisitions and Acquisition Requests (ARs), with direct link to the AR: Acquisition Waiting For Contractor Action Acquisition Waiting For JRC Action Acquisition Request To Be Ordered By JRC Orders Waiting For JRC Action Orders Waiting For Provider Action Orders Waiting For Contractor Action

Orders actions contain all the information on all pending actions, with direct link to the order page:

The Provider uploads acquisitions (QuickLook) for the AR published for him.

For HR, the provider has to select the status manually. For VHR, the status will be inserted in the .XML

The Product Type list for the 6 providers is as follows: o o o o o o QB IK EROS SPOT FORMOSAT ORBVIEW3 -

Bundle, Pansharpened, Bundle_retask, Pansharpened_retask Bundle, Pansharpened PAN PAN2020 PAN3030 , PAN4040 , PAN6060 PAN3FULL, PAN3, PAN3n PAN

When uploading a new acquisition, the variable <ProductType> of the XML file (Fig. 3), specifies the real product that has been collected and uploaded – this, together with the variable <ProviderStatus> (validated, proposed, retained) will allow JRC to calculate the price. The Provider will upload the acquisition (using the XML description file – see Fig.3) via the LIO application within 2 days of the image acquisition date. In the zip file, the provider status “In Preparation” is not accepted; only “Validated”, “Proposed” or “Not Requested” may be used

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

8

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

Fig.3. Example of an XML file to be included in the upload zip file

The acquisition date has to be inserted with this format: DD/MM/YYYY [English (UK)] The Image Provider will upload the acquisitions in any of the following formats: o o o GeoTIFF format in LAT/LONG WGS 84 or TIFF format with the worldfile .tfw in LAT/LONG WGS 84 or JPG format with the jgw in LAT/LONG WGS 84

(and NOT a GeoTIFF projected in a UTM zone) The colouring in the acquisition request list, when an acquisition has been uploaded becomes Yellow.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

9

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

2.1.5.2. Explanations of the possible Provider Acquisition Status In Preparation: This status is used only by the provider when the upload is made manually (not via the zip file) as long as the acquisition is in this status, no notification is made to JRC and contractors Not Requested: Used when the file does not need a validation Proposed: when the contractor and the JRC must make a validation. Retained: Only used by HR providers - same as proposed. Validated: Needs only the JRC validation. Disable: This acquisition is disabled in the VHR browser (wrong upload).

2.1.6.

Contractors: Work flow and Acquisition Contractor Status

2.1.6.1. Workflow When an Image Provider has uploaded an acquisition, the Contractor (already notified by e-mail) has the possibility to see his pending actions in the menu item.

The Contractor may use Site actions, Acquisition Actions, Orders Action, to follow up the acquisitions. On Acquisition Actions, the Contractor has to choose Year, Resolution and the Period desired and will be able to see all the pending actions for his sites, with direct link to the AR page.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

10

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

On Site Actions, the Contractor can see all acquisitions by site with direct link to acquisition page

2.1.6.2. Explanations of the possible Acquisition Contractor Status Not Requested (N): used internally when the contractor does not need to validate the file (provider status =Not Requested or Validated (V)) Accepted (A): The contractor accepts the Proposed (P) or Retained (R) acquisition file upload by the provider. Rejected (R): The contractor rejects the Proposed or Retained acquisition file upload by the provider. Empty (E): The Contractor has to Accept or Reject the acquisition. In Preparation: This AR is in preparation, the step before publishing (published state: opened) Opened: This AR is published and the provider can upload acquisitions. Cancelled: This AR is cancelled by the JRC before publishing it. This Acquisition Request will not be visible after this operation. Accepted: The acquisition request is accepted (window closed) with either full or partial coverage. Closed: The acquisition request is closed (window closed). In case of competitive AR it means that one of the other competitive ARs has been accepted. In case of a speculative AR it means that the corresponding dedicated AR was accepted (and hence we do not need the speculative AR any more) Failed: This acquisition request has failed (no acquisition during the opened window). Extended: This acquisition request is extended.

2.1.7.

Administration Page

The National Administrations can see the data relevant to their country.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

11

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

Clicking on AR, the information will be available for all the RS sites (all his contractors), with direct link to the Acquisition Request page. The Order Actions page gives information on all orders with direct link to details on each order. On Site Actions page the Administration can see all acquisitions by site with direct link to Acquisition page and to the Order page.

2.1.8.

The Integration of the LioDotNet with VHR browser

The VHR Browser can be called directly within LioDotNet. If an image has been uploaded in the AR a link to the VHR browser is available. The users can click on the tool which links directly to the VHR Browser .

2.2.

MARS VHR Browser

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

12

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

2.2. 2.2.1.

The MARS VHR Browser The VHR browser is a tool for displaying, browsing and downloading the VHR QuickLooks. It includes functionality of zoom, pan, print, and switch on/off quick looks layers, download browse (QL) images and relevant shape files.

2.2.2.

The VHR Browser is a separate application from the LIO system. All data entries/uploads and settings are done via the LIO application. The VHR Browser reads the content for a site (QuickLook, shape file) from the LioDotNet database after the uploading of data with the metadata XML and applies them automatically for the data visualisation. It offers a direct control of results (and possible modifications) by image providers.

2.2.3.

The URL for opening the VHR Browser is https://imageserver.jrc.it/pub/vhrbrowser06 You will then get the login page

To enter into the VHR Browser type your user name and password (same as in LioDotNet) and hit the ‘Login’ button. 2.2.4. This loads the next page where you can select the VHR site. Note that you will only see the sites defined in the LIO system for your user account (i.e. a contractor sees only the sites relevant to him). The user can use different Selection Filters: Site Names, Country, Platform

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

13

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

2.2.5.

The VHR Browser application will open a new window with images and shape files defined and uploaded for the selected site. The VHR Browser reads the layer definitions from the LIO database and creates the corresponding layers on-the-fly. Note, that depending on your browser settings you might have to allow the site ‘imageserver.jrc.it’ to open pop-up windows.

The Layers can be enabled / disabled for display with the checkboxes on the left site of each layer. The AcqID in the VHR Browser takes the number from the lio-id number automatically. This number is also present in the order.

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

14

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

The toolbar includes all the navigation tools and buttons for print and download.

Zoom to site extent Reload Site. Useful after adding new data into LIO or modification of existing settings (e.g. display order) to reflect changes in the VHR Browser Move map (pan) Zoom in

-

Zoom out Zoom with mouse wheel Pan with right mouse button or cursor keys Download function for QuickLooks/ shape files. Creates a ZIP file (containing all the image quick looks and shape files selected in the VHR Browser)

2.2.6.

The layers (uploaded images, shape files, ancillary data) are listed in the legend

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

15

EC-DG-JRC-IPSC-MARS Unit

LIO DOTNET server - image provider instructions

The VHR layers with the highest display order number are listed at the top of the legend. On the map the layers with higher display order are rendered above the ones with lower numbers. The display order and the layer source name can be displayed moving the mouse over the legend icon. You will get a pop-up like:

If you want to change display in the LIO DB, this needs to be done inside LIODOTNET on from the Acquisitions page. The layers can be enabled/disabled for display with the checkboxes left of each layer. You can choose if you want to have the layers automatically refreshed after switching them on/off by selecting the ‘Auto-Refresh’ checkbox:

If the ‘Auto-Refresh’ is disabled you have to click on the button ‘Refresh Map’ to update the map display. Note, that modifications in the LIO system will NOT be updated via this button. For this you have to use the button ‘Reload Site’ as mentioned above. 2.2.7. You can quickly switch between sites with the pull-down menu on the top right:

(end document)

Mars ref: JRC IPSC/G03/P/PAR/par D(2005)(3908)

16