User Documentation

CID Portal User Documentation

Contents

1 Introduction
 1.1 Background
 1.2 Image Portal Web Application
  1.2.1 Layout
  1.2.2 Browser Compatibility
2 Image Portal Web Application – First Steps
 2.1 Registration and Log In
 2.2 User Interface
3 Search
 3.1 Performing New Search
  3.1.1 Geographic Filter - Image Extent
   3.1.1.1 Search By Location Name
   3.1.1.2 Search by Selecting Location on The Map
  3.1.2 Search templates
 3.2 Past Searches
  3.2.1 Load The Search Criteria From The Search History
  3.2.2 Naming Search and Adding Custom Description
  3.2.3 Delete Past Searches
 3.3 Search Results
  3.3.1 Result Table
  3.3.2 Export of Search Results
  3.3.3 Result Table and Map
   3.3.3.1 Show All Images on The Map
   3.3.3.2 Zoom To Search Results
   3.3.3.3 Show Image Thumbnails in Result Table
   3.3.3.4 Show Image detailed metadata
 3.4 Expert search
  3.4.1 Define filter types
  3.4.2 Create custom search templates
4 Mapping The CID Portal Network Share
 4.1 Microsoft Windows®; Environments
 4.2 Linux/UNIX Systems
5 Data Access
 5.1 Preview Image
 5.2 Browse / Visualize Image
  5.2.1 Allow Pop-Ups in Your Browser
   5.2.1.1 For Internet Explorer
   5.2.1.2 For Firefox
   5.2.1.3 For Google Chrome
 5.3 Load Image Into Application via ECWP Protocol
 5.4 Data Access via File System
6 Portfolios
 6.1 Add Images
  6.1.1 Add Single Image
  6.1.2 Add Multiple Images to Portfolio
 6.2 Remove Images
 6.3 Create a New Portfolio
  6.3.1 New WMS/WCS Portfolio
 6.4 Activate / Deactivate Portfolio
 6.5 Access Portfolio
  6.5.1 Access FTP Portfolio
  6.5.2 Access WMS/WCS Portfolio
  6.5.3 Access FILE Portfolio
7 Virtual File Structure
 7.1 Manage Virtual Structure (VFS)
  7.1.1 Create a New VFS
  7.1.2 Browsing VFS
  7.1.3 Modify VFS
  7.1.4 Remove VFS
 7.2 Group VFS
8 Administrative Tasks for Image Metadata
 8.1 Metadata editor: Assign Tags and Keywords to an Image
 8.2 Tags and Keywords Definition
  8.2.1 Add Tags and Keywords
  8.2.2 Removing Tags or Keywords

Chapter 1
Introduction

1.1 Background

The European Commission Joint Research Center (JRC) uses large amounts of satellite remote sensing (SRS) data in the development, implementation and monitoring of EU policies and related activities. The Community Image Data portal (CID) has been launched upon JRC consensus as a project to provide horizontal support to other JRC Units and Actions for archiving of SRS data and to set up a common technical platform. The image portal consists of storage volumes, a catalog database, and a set of services to discover, view, and download the data, taking into account user’s credentials and restrictions based on intellectual property rights (IPRs).

1.2 Image Portal Web Application

The main entry point to the image data archive is the CID Image Portal web application. Search and preview of image data and a listing of some common metadata is open to the public. More detailed data access functionalities require prior registration and authentication. Staff of institutions of the European Union can be granted access to most of the archive data after registration. Please see section 2.1 for details.

1.2.1 Layout

The application layout consists of three main panels: the map panel, search panel, and the portfolio and search management panel (the latter only visible to authenticated users logged in to the application). The map panel offers a wide range of background (=base) layers that allow for orientation and navigation. The image locations (”image footprints”) are displayed in an overlay layer.

1.2.2 Browser Compatibility

The application is based on several modern JavaScript libraries for mapping and interaction with the back-end database. The set up ensures compatibility with all major browser types, namely Firefox, Internet Explorer (+6.x), Google Chrome, Safari, Opera. For best performance and interactivity, however, modern browser types are recommended. This means all the aforementioned browsers except Internet Explorer.

Chapter 2
Image Portal Web Application – First Steps

Go to the portal by opening the following URL in your browser:

http://cidportal.jrc.ec.europa.eu/home/


PIC

Figure 2.1: CID Homepage with link to CID Portal


From the Web page shown in fig. 2.1, navigate to the portal by clicking on the link ”Image Data Portal” on the top left or the link ”Direct Access to the Portal” (both marked in red). You will then open the main page of the portal application as seen in fig. 2.2


PIC

Figure 2.2: Main window of image portal


2.1 Registration and Log In

Access to the image data in the archive via a variety of on-line services is limited to authorized and registered users. Staff of institutions of the European Union can be granted default access to most of the archive data after registration. Users outside of the EC can only be granted access to certain datasets after internal cross-checks with the JRC Action responsible for the data. For some cases additional documentation will be requested from the external users.

In order to register go the CID homepage as displayed in fig. 2.1 and navigate with the tabs ”Image Data Portal ¿ CID Portal ¿ Registration”. After acceptance of the privacy statement you need to fill in some personal data required for user registration and authorization and then press the ”Submit Query” button.

Your request will be processed by CID staff. Your account will be created and your permission and credentials set. Staff of the European Commission shall indicate their DG and Unit, JRC users shall indicate also their Action. External users outside of the EC shall indicate a JRC contact person. This is required to check internally if the request is justified and to define to which data the user shall have access via which data services/protocols.

After insertion into the user database you will receive a mail that will notify how to proceed. Please follow the instructions and finalize your registration. After successful registration you can log in to the portal clicking on the ”login” link on the top right as displayed in fig. 2.3.


PIC

Figure 2.3: Login link for registered users


You will be re-directed to the CID Authentication Service (CAS) to type in user name and password as seen in fig. 2.4


PIC

Figure 2.4: Login via CID Authentication Service


2.2 User Interface

The main window of the user interface is used for image search, definition of portfolios and personalized virtual file structure and is the starting point to access the image data. Fig. 2.5 delineates the various zones and elements of the user interface.

  1. Map panel: Interactive map with various background layers that allows standard map navigation (zoom in/out, pan) and search related functionality
  2. Map tools panel for performing view or search actions on map
    • PIC Zoom to Full Extent
    • PIC Zoom to Previous Extent
    • PIC Zoom to Next Extent
    • PIC Zoom in
    • PIC Pan
    • PIC Select Images
    • PIC Draw Area of Interest

    The first 3 tools are stateless, ie. they just perform an action by clicking on it. The other 4 tools are stateful tools that set the state of the mouse action related to the chosen tool.

  3. Map layers panel selector for selecting base layer and overlay layers
    • To extend this selector panel with additional base layers and overlay layers see fig. 2.6.
      1. Right-click on the map and select ”Select Layers for Display”
      2. In ”Select Layers for Display” window select layers to display
  4. Overview map panel for fast orientation within whole map
  5. Search, result and messages panels for performing a search with specific attributes and processing result of the search
  6. Portfolios and searches panels for manipulation of portfolios and search history


PIC

Figure 2.5: User interface zones and elements



PIC

Figure 2.6: Right mouse click context menu [a] and Select layers to be available in the layer selector [b]


Chapter 3
Search

Image search can be performed either by specifying criteria in the web form, selecting geographical area on the map or loading past search from the search history.

3.1 Performing New Search

In the main form you can manually specify some search parameters. See fig. 3.1. If your search require some customized set of return fields, you can select fields to be returned under link ”Show fields” by ticking the respective check boxes. The figure below shows the default search form, but you can select others or define you own as described in 3.4


PIC

Figure 3.1: Search for IKONOS images from 2004 over France


3.1.1 Geographic Filter - Image Extent

Restricting the search to a user-defined geographical area has two possible input methods.

3.1.1.1 Search By Location Name
  • From the combo box select the geographic constraints ”includes”, ”intersects” or ”lies within”.
  • Type in the location in the text box ”Location search:” and hit [RETURN].
  • In the pop-up box select the location from the available list (see fig. 3.2).
  • The coordinates are automatically inserted into the X and Y text boxes. You can also insert the geographic coordinates by hand. See fig. 3.3.


    PIC
    Figure 3.2: Search for images in the area of Saint-Etienne, France.



    PIC
    Figure 3.3: Search for images in the area of Saint-Etienne, France.


3.1.1.2 Search by Selecting Location on The Map
  • From the combo box select the geographic constraints ”includes”, ”intersects” or ”lies within”.
  • Choose the select tool PIC from map tools panel and draw the search area on the map. See fig. 3.4.
  • The extent of this area is inserted into the Xmin/max and Ymin/max fields for the search bounding box. See fig. 3.5. The rectangle drawn on the map remains as a blue rectangle after the search. It can be removed via the right-mouse context menu and selecting the item ”Remove Area of Interest” (see fig. 2.6 on page 24).


    PIC
    Figure 3.4: Selection made with ”Select Images” tool.



    PIC
    Figure 3.5: Search for images that intersect given bounding box defined by Xmin, Ymin, Xmax, Ymax.


3.1.2 Search templates

A list a alternatives ”search templates” (set of fields to be displayed in the search form) is available in the drop down list above the current search form. The default one is called ”basic” but by selecting another one, for instance ”extended”, your can switch from one to another.

3.2 Past Searches

3.2.1 Load The Search Criteria From The Search History

It is possible to reload search parameter definitions from previously performed searches that are automatically added to the ”Searches” panel.

  • Click ”Searches” button to change to the ”Searches”panel and view the list of past searches. See fig. 3.6. Moving the mouse over an item reveals more details of the search parameters for the respective search definition.


    PIC
    Figure 3.6: List of past searches.


  • Click on the search name to display results of the search.

3.2.2 Naming Search and Adding Custom Description

It is possible to explicitly save your search parameters under a more self-explaining name:

  • While search is loaded from past search results as described in 3.2.1.
  • Click on the ”Search” button and unroll menu by clicking on ”Definitely save this search” link (see fig. 3.7).


    PIC
    Figure 3.7: Save search with custom title and description.


  • Type in your custom search name, description and click ”Save !” button.
  • Now your search is saved on top of the list of past searches.

3.2.3 Delete Past Searches

  • Unroll menu by clicking on ”Delete searches” link.
  • Select attributes and press ”Delete” button (see fig. 3.8). Note: if you tick the check box ”include saved ones” then also explicitly saved search definitions will be deleted.
    PIC
    Figure 3.8: Delete past searches from history.


3.3 Search Results

3.3.1 Result Table

The results are displayed in a result table (see fig. 3.10), limited by default to 100 records displayed at the same time and 2500 records total.

To change these default settings (see fig. 3.9):

  • Click on ”Preferences” link.
  • In the ”Preferences” dialog box select desired parameters.
  • Click ”Save” button to save your preferences.


PIC

Figure 3.9: Search result preferences.


The table sorting order can be changed by clicking on the column headers. If the search returned more results than defined as maximum for display per page, you will get numbered links and ”next”/”last” links to go to the next part of the results.


PIC

Figure 3.10: Example search result.


3.3.2 Export of Search Results

The results of a search can exported in various spatial (and text) formats that allow the checking of available images in relation to existing datasets e.g. in GIS programs. Supported export formats are currently:

  • Shapefile
  • KML
  • CSV/Excel
  • GML
  • GeoJSON

To export the results:

  • Click on the link Export Results unroll the ”Exports Results” dialog (see fig. 3.11 on the left).
  • Select the data format for the export and if the export file shall include all images of the search results or just the ones visible on the map.
  • Click ”Export” button.
  • Click on ”download” link to download the exported file (see fig. 3.11 on the right).


PIC

Figure 3.11: Export Results dialog.
PIC


3.3.3 Result Table and Map

Map and result table are correlated. Clicking on the icon for a result record in the table highlights also the corresponding image footprint on the map (see fig. 3.12).


PIC

Figure 3.12: Highlighting of pictures on the map by selecting pictures from search result or vice versa.


The image footprints on the map can be selected with the PIC tool. The image footprints can be selected both by clicking on and by drawing a box around the image footprints. This highlights the images both on the map as well as in the result table in yellow.

3.3.3.1 Show All Images on The Map

By default only images visible in the currently result table page are displayed on the map. You can visualize all found images by clicking on the link ”Show all images on map” which is shown in the fig. 3.13.


PIC

Figure 3.13: Images found displayed on the map.


3.3.3.2 Zoom To Search Results

After executing the search the map will automatically zoom to the extent of all results displayed on the map. You can also manually launch this zoom to the search results via the link ”Zoom to Search Results” or the corresponding item in the context menu (right mouse click on the map) as displayed in fig. 3.14.


PIC

Figure 3.14: Zoom to search results via context menu.


3.3.3.3 Show Image Thumbnails in Result Table

A quick preview of thumbnails for all images listed in the result table is possible by selecting the thumbnail size in the combo box ”Show thumbnails” as displayed in fig. 3.15. The small icon on the left of every result record row will be replaced by the image thumbnail.


PIC

Figure 3.15: Show image thumbnails for every search result record.


3.3.3.4 Show Image detailed metadata


PIC

Figure 3.16: Show image metadata of a specific search result.


The metadata of each image that appears in the result table can be viewed by selecting the appropriate item in the image context menu (right mouse click). Choose the ”View metadata” item and a window will pop up, showing most of the available metadata about this specific image (see fig. 3.16). Below the main details, additional metadata are classified in several categories. Click on the category title to unroll it and display the corresponding set of metadata.

3.4 Expert search

3.4.1 Define filter types

In case you need to use some metadata fields in your search that are not available in the default search forms (as seen in 3.1.2), you can use the expert search functionality (3.1.2). This functionality is only available to registered and logged in users.


PIC

Figure 3.17: For more complex queries, use the expert search feature.


In this expert search form, you can create as many filters as you want for searching the images by clicking the ”Add a filter” button. You can remove some filters by selecting the check box on their left and clicking the ”Remove selected” button. You can then choose for each filter a field, an operator and a filter value, in the same way as it is done for the default search form.


PIC

Figure 3.18: Add and remove search filters.


Clicking the search button will execute the search and give the results as with the default search.

3.4.2 Create custom search templates

You can also save your filters selection as a search template by entering a name and clicking on ”Save template as” : PIC.

This new search template will be added to the search template list under the search history and can be selected as default template for a new search. You can also edit this template again to modify it or to save it with another name.


PIC

Figure 3.19: Reuse and edit a saved template.


Chapter 4
Mapping The CID Portal Network Share

Mapping the CID Portal network share to your computer is a prerequisite for any type of file-based access to the data (see section 5.4 on page 102 and chapter 7 on page 140). It is therefore recommended to run the required steps explained below if you plan to access the archive data via the file system. This functionality is available only at the internal network at the JRC Ispra site.

4.1 Microsoft Windows®; Environments


PIC

Figure 4.3: Change the drive letter bounded to cidportal winshare on your system


4.2 Linux/UNIX Systems

The CID network share can be mounted on Linux/UNIX systems using the ”mount.cifs” utility (see e.g. http://wiki.linuxquestions.org/wiki/Mount.cifs).

It is also possible to mount the CID storage volumes via the native UNIX network file protocol NFSv4 (see http://www.nfsv4.org/). This is useful especially for processing chains that require the maximum network file system performance. Due to the complexity of this protocol version, however, a number of additional software packages and specific configurations are required. If you plan to use NFSv4 please contact the CID team via ”cid-contactatjrc [dot] ec [dot] europa [dot] eu” mail address for further details.

Chapter 5
Data Access

5.1 Preview Image

Click on the small image icon at the beginning of the search result table. This will open an image thumbnail to the left side of the table that gives an overview of the image (see fig. 5.1). In addition, a pop-up menu appears that allows you to preview the image or copy the path/URL to the image. Depending on the user permissions some of these options might not be available.


PIC

Figure 5.1: Image thumbnail preview.


5.2 Browse / Visualize Image

After clicking on the image icon a small menu will pop up. Select the item ”Browse Image” and the image will open in full browsing mode in a new browser window (see fig. 5.2).


PIC

Figure 5.2: Image menu.


A new browser window opens that allows you to zoom in/out and pan the image with the tools from the tool bar (see fig. 5.3).


PIC

Figure 5.3: CID Image portal image viewer.


NOTE:

Most browsers (such as Internet Explorer, Firefox, Google Chrome) block pop-up windows by default so you have to allow the opening of a new browser window, as described in the following section.

5.2.1 Allow Pop-Ups in Your Browser

5.2.1.1 For Internet Explorer


PIC

Figure 5.4: IE pop-up blocker message.


Click on this message bar (see fig. 5.4) and select in the pop-up menu ”Always Allow Pop-ups from This Site” (see fig. 5.5).


PIC

Figure 5.5: IE pop-up blocker menu.


5.2.1.2 For Firefox


PIC

Figure 5.6: Firefox pop-up blocker message.


Click on the ”Options” button (see fig.5.6) and select ”Allow pop ups for cidportal.jrc.ec.europa.eu” (see fig. 5.7)


PIC

Figure 5.7: Firefox pop-up blocker menu.


5.2.1.3 For Google Chrome

Google Chrome does not ask the user if he wants to allow a pop-up window. If pop-ups are blocked by the Chrome settings then the new window will just not open. If this happens to you, you need to change the options for Chrome. Click on the tool icon of Chrome PIC and then choose the ”Options” item. Fig. 5.8 shows all steps to follow to allow pop-ups in Chrome. You need to restart Chrome for the new settings to take effect.


PIC

Figure 5.8: Google Chrome settings for allowing pop-ups


5.3 Load Image Into Application via ECWP Protocol

The ECWP is an HTTP-based protocol that allows you to load the image via a plug-in into some GIS applications. Plug-ins are available for download e.g. for ESRI GIS products from the ERDAS web site http://www.erdas.com/tabid/84/currentid/2508/default.aspx or can be requested from CID team by sending a mail to ”cid-contactatjrc [dot] ec [dot] europa [dot] eu”.

To load an image:

  • Select ”Get ECWP URL”. A box will pop up with the URL to the image.
  • Press the key [CTRL – C] to copy the URL to the clipboard (to close the box click anywhere on the page). See fig. 5.9.
  • Insert the URL into the ECWP dialogue in the GIS program as shown below (see fig. 5.10, 5.11).
  • When the authentication dialog pops up, insert your user name and password and click the ”OK” button. The data will then be streamed via HTTP(S) from the CID portal server to your client.


PIC PIC

Figure 5.9: ECWP URL for the image.



PIC

PIC

Figure 5.10: Example for ArcView 3.



PIC

PIC

Figure 5.11: Example for ArcGIS.


In addition to GIS programs, the ECWP protocol can be used to insert an image into Microsoft®; Office products. This requires the installation of the ERDAS ER Viewer tool (download at http://www.erdas.com). You can then insert an image into your office document via ”Insert ¿ Object ¿ ER Mapper IWS ECWP Image” and pasting the ECWP URL copied from the CID portal web application (see above).

5.4 Data Access via File System

  • The path to the image directory is available via the menu item ”Get File System Path” (see fig. 5.12).
  • In the box that appears copy the path with [CTRL - C] to the clipboard and insert it into the file dialogue of the applications or file explorer.
  • The path is the full UNC name to the CID disk storage and should work for all applications. Note, however, that due to constraints by Windows network share definition, you need first to map the CID Portal network share as new drive in Windows as described in chapter 4 on page 65.


PIC PIC

Figure 5.12: File system URL for image.


Chapter 6
Portfolios

Portfolios are the standard way to access images via the protocols FTP and WMS/WCS. Images that shall be accessed via these protocols need first to be added to a portfolio of the respective type.

6.1 Add Images

6.1.1 Add Single Image

See fig. 6.1

  • Click on the image thumbnail.
  • Click on ”Add to service” from menu.
  • Choose portfolio type.
  • Choose portfolio to insert image in or create a new portfolio.


PIC

Figure 6.1: Add single image to portfolio.


6.1.2 Add Multiple Images to Portfolio

See fig. 6.2

  • Unroll the select images menu by clicking on ”Select Images” link to enable multiple selection.
  • Select images by clicking on every row in the record table.
  • After adding al desired images, click on ”Send to” from menu.
  • Choose portfolio type.
  • Choose portfolio to which you want to add the image or create a new portfolio (see 6.3).
  • It is also possible to select the images to be added to the portfolio using the ”Select Images” tools described in section 2.2 on page 18.


PIC

Figure 6.2: Add single image to the portfolio.


6.2 Remove Images

To remove an image from the portfolio click on the cross in the ”View Portfolio” dialog (see fig. 6.3).


PIC

Figure 6.3: Remove image from the portfolio.


6.3 Create a New Portfolio

To create new portfolio, after selecting the portfolio type from the dropdown menu (see fig. 6.4) :

  • Click on ”New portfolio”,
  • Write portfolio title,
  • Save portfolio by clicking ”Save” button.


PIC PIC

Figure 6.4: Create new FTP portfolio.


6.3.1 New WMS/WCS Portfolio

Similar to FTP you can create portfolios for the OGC services WMS and WCS (see fig. 6.5). As well as the Portfolio title you can specify a projection system as EPSG 1 code you would like the service to provide. By default ETRS LAEA (EPSG 3035), WGS84 Geographic (EPSG 4326) and UTM/ETM projections (for the respective zones the images are in) are available. You can also choose the desired resampling method.


PIC

Figure 6.5: Create new WMS portfolio.


6.4 Activate / Deactivate Portfolio

Portfolio activation is a process of creating a temporary service URL which can be used to access files in the portfolio. Portfolio deactivation destroys the service URL and portfolio must be reactivated to make its files accessible again. Portfolio is automatically deactivated after some time. Portfolios that are activated by a user during his current session will automatically be activated also in future sessions.

To activate portfolio (see fig. 6.6):

  • Click on the name of the portfolio.
  • Click on ”activate” link in ”View Portfolio” dialog to activate the portfolio and display service URL of the portfolio.
  • Copy the service URL (see fig. 6.7), using eg. keyboard shortcuts [CTRL-C]


PIC

Figure 6.6: Activate portfolio.


To deactivate portfolio (see fig. 6.7):

  • Click on ”deactivate” link in ”View Portfolio” dialog to deactivate the portfolio.


PIC

Figure 6.7: Deactivate portfolio.


6.5 Access Portfolio

6.5.1 Access FTP Portfolio

To access the FTP portfolio:

  • Click on the ”activate” link and then copy the FTP service URL to the clipboard (see fig. 6.8).
  • Insert the URL in an FTP client or Windows Explorer (see fig. 6.9).

The FTP access is not password-protected but uses a long key combination and the FTP server does not allow browsing to parent directories. This, however, means that the URL shall be treated with the same confidentiality as username/password combination. This approach was chosen to avoid sending as clear text over the web the username/password combination that is also used for any other login mechanisms (for which secure SSL encryption is used).


PIC

Figure 6.8: FTP portfolio service URL.



PIC

Figure 6.9: Accessing portfolio files via FTP client.


6.5.2 Access WMS/WCS Portfolio

To access the WMS/WCS portfolio:

  • Click on the ”activate” link and then copy the WMS service URL to the clipboard (see fig. 6.10).
  • Insert this URL in your WMS/WCS client.

The WMS/WCS services are only available when logged into the Image Portal application. After closing this application the WMS/WCS service will be deactivated after a time out of 2 hours.


PIC

Figure 6.10: WMS portfolio service URL.


6.5.3 Access FILE Portfolio

This type of portfolio is only available at internal network in the JRC Ispra site.

To access the FILE portfolio:

  • Map The CID Portal network share (see 4).
  • Click on the ”activate” link and then copy the FILE service URL to the clipboard (see fig. 6.11).
  • Insert this URL in your Windows Explorer.


PIC

Figure 6.11: WMS portfolio service URL.


Chapter 7
Virtual File Structure

Most data loaded into the CID Portal archive are structured in a generic way using a few parameters in an hierarchical order [disk volumes/satellite type/acquisition year/unique image Id/data files]. This shall guarantee a consistent physical structure of the archived data. This generic structure however does not allow accessing image data based on logical filters and makes simple data browsing a bit difficult. To tackle this problem, the so-called ”Virtual File Structure” (VFS) functionality has been implemented in the CID Portal.

The ”Virtual File Structure” allows the user to flexibly define his/her own file structure independent of the physical data storage based on user-defined rules for the data structure and directory/file naming. This facilitates very much the access and the browsing of archive data since structure and directory naming can be defined as self-explaining.

Users can define as many VFS as they want, including different structuring of the same data in a different way, e.g. for different projects. The definition of a VFS is achieved technically via the extended usage of Unix symbolic links and has no overhead in terms of storage usage or network file system speed.

7.1 Manage Virtual Structure (VFS)

  • Open the dialog box for the VFS by clicking on the link ”Virtual file structure” as shown in fig. 7.1.

In the dialog box that opens (see fig.7.2) you can see all existing VFS definitions already made for your user account in the left dialog pane. At the first use this list will be empty.


PIC

Figure 7.1: Link to open the virtual file structure dialog box



PIC

Figure 7.2: Dialog box for defining the virtual file structures


7.1.1 Create a New VFS

  • Click on your user account name on the top of the left dialog pane and then on the link ’create directory’ as marked in fig. 7.2 on the right. You will then be asked to set the name of this directory as shown in fig. 7.3. All blanks will be substituted by underscore ”_” and special (ie. non-ASCII) characters by a dash ”-”.
    PIC
    Figure 7.3: Enter name of virtual directory


  • Afterwards you will see the newly created directory in the left pane. Select it and click on the button ”create virtual structure” as marked in fig. 7.4.
    PIC
    Figure 7.4: Create new virtual structure


  • In the right dialog pane you will have the configuration parameters for the VFS as displayed in fig. 7.5.
    PIC
    Figure 7.5: Define parameters of new virtual file structure


  • Select the search results you want to map to the virtual file structure from the select box under ”Which search?”. The mouse-over text (shown in the yellow box) displays the details of the search definition. In the samples shown below the search is defined as all ”Spot images with acquisition date in 2007” and intersecting the geographic area delineated by a rectangle drawn on the map (using the tool described in 3.1.1.2 on page 29).
  • The VFS will be automatically updated every time new images added to the archive fit the search criteria defined. If you would like to be notified by mail when new images are added, tick the check box ”Send me an email ...”.
  • Specify the data grouping structure under the ”grouping” block and and the directory naming pattern in the text box ”File Name Pattern”. As you can see in Fig. 7.6, the drop down menu below the text box helps you define the file name pattern. Just select the field you want to see appear in the image file names and its code (between two percent ”%” signs) will be added for you will be added in the text box at the place of the cursor. You can also modify the pattern by yourself. All blanks will be substituted automatically by underscores ”_”.


    PIC


    Figure 7.6: Available options for file/directory naming tags


    In order to validate and save the new VFS, click on the button ”Validate” and the VFS will be finalized as shown in fig. 7.7. The new VFS in the example uses country codes and image type (source or orthorectified) to group the images. Directory naming uses the platform name, the acquisition date, and the site name tags. The image Id is always added automatically if not specified by the user to guarantee unique file system names.


PIC

Figure 7.7: New virtual file structure now created


7.1.2 Browsing VFS

After creation of the new VFS, you can browse the data through the file system. If you mapped the CID portal network share (see section 4) to ”z:”, you will find all your VFS’s under ”z:\users\your-username\” as shown in fig. 7.8. Note the structuring of the data and the directory naming convention.


PIC

Figure 7.8: Browse and access data of new virtual file structure with a file explorer


Please note that for search results with more than 1000 records the VFS is not created immediately. It is added to a scheduler that runs every 15 minutes and creates the VFS in the background. So it might take up to 15 minutes until your newly defined VFS is available under your user directory. This is to avoid having the user interface blocked for too long time during the creation of the VFS.

7.1.3 Modify VFS

  • Select the VFS in the left dialog pane and click on the button ”modify virtual structure” shown in fig. 7.7 in the right pane. You will then get the previously defined settings displayed in the right dialog pane (see fig. 7.9).
  • To apply your modifications click on the ”validate” button.
  • If you just want to rename the directory name where your VFS is placed, click on the button ”rename directory”.


PIC

Figure 7.9: Modify the virtual file structure


7.1.4 Remove VFS

  • Select the respective VFS on the left dialog pane and click on the button ”remove virtual structure” in the right pane.
  • Afterwards you can also delete the directory where you had the associated VFS by clicking on the ”delete directory” button in the right dialog pane.

7.2 Group VFS

The virtual file structures are very convenient to access data in a way a user wants. But in addition to that, by some projects it may be required to access data within a group in a common structure for the whole group. Therefore a mechanism has been set up to define virtual file structures at a group (e.g. Unit or Action) level. The definition of these file structures is done exactly in the same way as the ones for a single user as described in section 7.1 but is accessible only to the group administrator. This user can access the group root directory (see fig. 7.10), add and remove folders in it and define virtual file structures. These file structures are available to all members of the group at the location \\139.191.240.100\cidportal\users\groups\GROUP_NAME. The role as group administrator will be provided to certain users on request. Please contact the CID team for this.


PIC

Figure 7.10: Group virtual file structure


Chapter 8
Administrative Tasks for Image Metadata

Some edit features of the image metadata are available through the CID portal user interface to defined users and data responsibles.

8.1 Metadata editor: Assign Tags and Keywords to an Image

Permission to alter an image metadata is given to defined users for each data responsible (JRC Unit or Action) for their images. This permission is set on request. Please contact the CID team for this. Users who have permission to modify image metadata will see a link labeled ”Edit metadata” under the metadata information in the ”View metadata” window (see fig. 8.1)


PIC

Figure 8.1: The metadata editor


Currently, an image data responsible can modify only the image’s custom field (namely the keywords and the tags) which the data responsible has the right to modify. Only the keywords and tags that are under the data owner responsibility can be altered. The other information is visible but not editable as you can see on fig. 8.2. Click on the ”Validate” button to apply the changes.


PIC

Figure 8.2: Modify image metadata


8.2 Tags and Keywords Definition

For defined users of a data responsible group (typically a JRC Unit or Action) it is possible to define custom tags and keywords that will be available in the metadata editor presented in previous section 8.1. To access this, you need to be allowed to do so for at least one data responsible. This role is set up on request. Users who have this role granted will see a ”Group administration” link that opens the ”Group administration” panel (fig. 8.3).


PIC

Figure 8.3: Group administration panel


8.2.1 Add Tags and Keywords

In this panel appears the list of the current tags and keywords defined for the group you can administrate. By clicking on the ”Add a new tag” or ”Add a new keyword” link, you can add a new item in the list. The fig. 8.4 shows this process for adding a new tag. You can do the equivalent to add a keyword.


PIC

Figure 8.4: Add a tag


8.2.2 Removing Tags or Keywords

You can remove a tag or a keyword only if it is not already assigned to an image. In the tag and keyword lists, the left column shows the number of images assigned to the corresponding item. If this number is zero, then you can see a ”x” symbol on which you can click to delete the tag/keyword, as shown on fig. 8.5.


PIC

Figure 8.5: Remove a tag