Help

  1. Overview of the Portal

    CODE-DE is the German access point to the European Earth observation programme Copernicus. Data of the Sentinel satellites are the core of this Earth observation programme.

    The goal of the Copernicus Data and Exploitation Platform – Deutschland (CODE-DE) is to set up a platform for data access (connection to the ESA Collaborative Data Hub) and environmental information for further value adding. The platform will provide capacities for value-added product generation that can be cost-effectively re-used by many projects and services (public, scientific and commercial)  in Germany.

  2. FAQs

    Frequently asked questions (FAQ) or Questions and Answers (Q&A), are listed questions and answers, all supposed to be commonly asked in some context, and pertaining to a particular topic

    What is CODE-DE?

    The "Copernicus Data and Exploitation Platform" for Germany.

    You'll find more information on the About page.

    How can I get Copernicus Data?

    Use the Portal Marketplace to get data.

    You will get further information on the Marketplace features in the Help pages and FAQs below. If you have some questions not covered here please contact the Help Desk (use the contact form at the bottom of every page).

    Who has access to Copernicus / CODE-DE and according to which criteria?

    CODE-DE is the German mirrow and access point for Copernicus data and services. Users of Copernicus and CODE-DE are prioritised (grouped) as follows:

    Priority 1: German federal ministries, authorities and research entities and their contractors who need to use Copernicus.

    Priority 2: Users (officers) of other German authorities, companies, research and education entities or Non-Government Organisations (NGOs).

    Priority 3: Access to Copernicus / CODE-DE is not restricted in accordance with European regulations. So data and information is open to all German and European citizens.

    Priotity 4: There are agreements (treaties) for exchange of (Copernicus and Sentinel) data with other countries and organisations, so other users than in Priorities 1 to 3 can have access to Copernicus / CODE-DE data.

     

    A few exceptions will however exist in exceptional situations where security is at stake. In such cases, a limited access should probably be envisaged.

    Practically, Copernicus information will be provided to users through a set of services, most of them being available online.

    The Copernicus Programme covers six thematic areas: land, ocean (marine), atmosphere, climate change, emergency management and security.

    How do I request additional permissions?

    You can request permissions using the Help Desk Contact Form or if you are registered and logged-in using the "Group Membership Management Form" window under "Permissions".

    Criteria for permissions and group categories are described in the FAQ  Who has access to Copernicus and according to which critera? 

    But in any case you first need to register and login to request additional permissions / user rights. Please, be aware that you have to accept the CODE-DE Terms and Conditions and the Privacy Statement during registration.

    There are two ways for you to change group membership or request additional permissions:

    1. You can use the Help Desk Contact Form and entering/ selecting the subject "Request permissions". You should give a short statement why you need these "additional permissions" in the message box. To verify your request "Your name" and "Your e-mail address" is mandatory. Usually, if you are logged-in the fields should be prefilled.

    If you are an expert or company contracted by a German ministry or administration, please, name your client and contact there and your contract number. This will help with the procedure and make it faster. (Thanks!)

    or

    2. You click "Permissions" in the upper right part of the portal, if you are logged-in, and then can change group memberships of the available predefined groups in the "Group Membership Management Form" . Here you can leave a group, too, if you do not need the permissions assiociated with the group any longer.

    Select a group and shift it from the left to right box. If you confirm the request it will be sent to the Help Desk, where it will be processed and a decision is made in accordance with the "CODE-DE Governance" (User Management Rules). Please, add a short statement and reference as explained above, why you need additional permissions.

    Shifting a group from right to left means you leave a group.

    All requests will be processed and answered within two business days.

     

    Who provides Copernicus services?

    The service provision of Copernicus services has been delegated by the European Commission to a number "Entrusted Entities", which act or will act as "service providers".

    In this perspective, several "Delegation Agreements" were signed during the period 2014 – 2015.

    The Copernicus services are provided to users as follows:

    • The Copernicus Land Monitoring Service is provided by the European Environment Agency (EEA) for the Pan-European and local components, and by the European Commission Joint Research Center (JRC) for the global land component;
    • The Copernicus Atmosphere Monitoring Services (CAMS) and the Copernicus Climate Change Service (C3S) are provided by the European Centre for Medium-Range Weather Forecasts (ECMWF);
    • The Copernicus Marine Environment Monitoring Service (CMEMS) is provided by Mercator Océan (the French centre for analysis and forecasting of the global ocean);
    • The Copernicus Emergency Management Service (EMS) is provided by the European Commission Joint Research Centre (JRC);
    • The Copernicus Security Service will be provided respectively by FRONTEX for Border Surveillance, by the European Maritime Safety Agency (EMSA) for Maritime Security and by the European Satellite Center (SatCen) for Support to External Action.

    Are Copernicus services already available?

    The Land Monitoring Service, the Marine Environment Monitoring Service (CMEMS), the Atmosphere Monitoring Service (CAMS), the mapping component of the Copernicus Emergency Management Service (EMS - Mapping) are now delivered in an operational mode. The Climate Change Service (C3S) and Security Service are still in a development phase. The availability of downstream services (i.e. value-added services based on the above-mentioned Copernicus services) is depending on downstream providers.

    Copernicus products and services can be accessed here http://copernicus.eu/main/services and here (for downstream services, too): http://copernicus.work-with.us/

    Are Copernicus services fully free-of-charge for users? Who pays for Copernicus Services?

    Copernicus services whose implementation and operation are supported by public funding at the European level will fall into the regime defined by the Copernicus governance. Considered as "public goods", a full and open access to these services will be organised. Data from the Sentinels will be free of charge to users. ( COMMISSION DELEGATED REGULATION (EU) No 1159/2013 )

    Downstream services correspond to those services that will be implemented outside the scope of the Copernicus governance and without EU public funding. They will be developed by public or private operators with the objective to meet specific needs (e.g. specific to a group of user, location-specific, etc.).

    Downstream services will provide their users with added-value by combining the information provided by the Copernicus services with additional data (e.g. socio-economic data). Depending on the business model adopted by each service provider, these downstream services could be either free for the final user (e.g. funding through advertising) or associated to a fee (e.g. pay-per-use, recurrent fee, etc.).

    In addition to the data produced by the Sentinels satellites, Copernicus users can also have access under certain conditions to the data produced by other satellite missions referred to as "Contributing Missions". Contributing Missions have been classified into five groups that reflect the characteristics of the main types of missions.

    Most data provided by the different contributing missions are distributed by the European Space Agency (ESA). They take the form of datasets and are delivered to users through data access services. The delivery process relies on an operational system called the "Copernicus Space Component Data Access" (CSCDA).

    Third mission data will not be provided by CODE-DE.

    Further information on Sentinel data / Copernicus space data access can be retrieved here:

    https://spacedata.copernicus.eu

     

    Further Information and Contacts

    Further Information and the German Coordinators for Copernicus Themes can be found here:

    Link to D-Copernicus >

     

    Why is the programme named Copernicus?

    By choosing the name Copernicus we are paying homage to a great European scientist and observer: Nicolaus Copernicus. The Copernicus theory of the heliocentric universe is considered by many to be the main precursor of modern science. Copernicus opened to man an infinite universe, previously limited by the rotation of the planets and the sun around the Earth, and created a world without borders. Humanity was able to benefit from his insight and this set in motion the spirit of scientific research which allowed us to have a better understanding of the world we live in.

    What is Sentinel-1 and where can I get futher user and technical information?

    Sentinel-1 is a two satellite constellation with the prime objectives of Land and Ocean monitoring. The goal of the mission is to provide C-Band SAR data continuity following the retirement of ERS-2 and the end of the Envisat mission.

    To accomplish this the satellites carry a C-SAR sensor, which offers medium and high resolution imaging in all weather conditiions. The C-SAR is capable of obtaining night imagery and detecting small movement on the ground, which makes it useful for land and sea monitoring.

    Sentinel-1 user information and technical information can be accessed directly through the ESA Sentinel site:

    The Sentinel-1 User Handbook can be retrieved directly from ESA here:

     

    All information is only available in English.

    (c) ESA

    What is Sentinel-2 and where can I get further user and technical information?

    Sentinel-2 will be the next two-satellite-constellation dedicated to land monitoring.  Sentinel-2 takes high resolution imagery (10-60m) of earth's land surface, mainly to monitor land cover and land use.

    It carries an innovative high resolution multispectral imager with 13 spectral bands for a new perspective of our land and vegetation. The combination of high resolution, novel spectral capabilities, a swath width of 290 km and frequent revisit times will provide unprecedented views of Earth. The mission is based on a constellation of two identical satellites launched separately. Orbiting 180° apart, they will cover all Earth’s land surfaces, large islands, inland and coastal waters between 84°N and 56°S every five days, optimising global coverage and data delivery for numerous applications.

    Sentinel-2 expands on the French Spot and U.S. Landsat missions.  The mission will consist of two Sentinel-2 satellites in the same orbit. The first satellite (Sentinal-2A) was launched on 22nd June 2015 and is fully operational. Sentinel-2B is in orbit since March 2017. The mission is operated by ESA.

    Sentinel-2 user information und technical information can be accessed directly through the ESA Sentinel site:

    The Sentinel-2 User Handbook can be retrieved directly from ESA here:

    (c) ESA

     

    Maintenance of CODE-DE (on Tuesdays)

    Updates and Maintenance will happen on Tuesdays between 17:00h and 19:00h (CET / CEST). If there are longer downtimes (some minutes) of CODE-DE, an information will be posted in the "News" minimum the day before.

    Where can I download data?

    Data Download:

    You can download data either using the CODE-DE Catalogue Client or using a script from the CODE-DE User Tools, if you need to download large amounts of data or you need it regularly.

    You can find further information on the Catalogue Client here.

    For Copernicus products and services downloads, please use the instructions on the Copernicus sites itselves (data from the six thematic Copernicus services). You can enter these sites using the CODE-DE Marketplace Service section or the CODE-DE Marketplace search.

    Why are some Sentinel 1 and Sentinel 2 data missing?

    You will experience missing data tiles in some orbits recorded by Sentinel 1 and Sentinel 2 and also days where no Sentinel data are available on CODE-DE at all. These data gaps are due to a reduced performance of the collaborative data hubs provided by ESA, the sole source of Sentinel data products for CODE-DE. The collaborative hubs are currently undergoing a restructuring and performance upgrade. Due to these changes the overall data availability and download performance may vary and access issues might occur. CODE-DE and ESA are jointly working on solutions for the issues. Data gaps will be closed after the performance upgrade is finished.

    We apologize for any inconvenience.

  3. Marketplace

    The Marketplace portrays INSPIRE-conform entries about all types of data from the collaborative platform CODE-DE as well as third-party missions. These are mainly data sets of the Sentinel Satellites and contributing missions from national and commercial providers integrated into Copernicus.

    Additionally the Copernicus Core Services and Products and some third party (downstream) offers will be available. In future projects realized in the frame of CODE-DE  and processor modules will be available for new services featured on the marketplace. At the moment these pages have no content, the message "Your search yielded no results" is returned.

    Remark: The Marketplace does not provide any billing functionality for third party services and products.

     

     

     

     

    1. Marketplace Categories

      Service Marketplace entries are categorized as follows:

       

      • Datasets

      This category lists all available dataset collections in the catalogue service (see Catalogue-Client). Entries provide links to different representations (e.g. XML), to the Catalogue Client for viewing the collection in a map, and downloads (e.g. WCS-Web Catalogue Service).

      • Services

      This category gives an overview of the so called Copernicus Core Services. It provides links to the six official Copernicus Monitoring Service on Emergency, Land, Ocean (maritime services), Atmosphere, Climate Change and Security.

      • Tools

      This category lists relevant toolboxes (e.g. Sentinel toolboxes) along with open-source software. Entries provide a link to the provider homepages.

      • Projects

      This category presents information on application projects. Entries (will) provide a link to the project homepages.

      • Processors

      This category portrays processors and applications. Entries (will) provide links to the processing services' web-based management interfaces.

    2. Discover Marketplace Items

      When entering the Service Marketplace in general entries are displayed grouped by the Marketplace categories. The view can be narrowed down to an individual category by selecting the respective tab above the search input field.

      Entries can be filtered by typing in one or multiple keywords in the search input field as shown in the figure below. When clicking into the input field and starting to type a dropdown with keyword suggestions pops out. It includes the INSPIRE themes and relevant satellite missions. In addition, arbitrary freetext can be entered. Once submitted the Marketplace shows the filtered entries only.

      Predefined tags/key words appear in a selected entry's details as shown in the figure below. Once you clicked the Marketplace it shows all entries which conform to that tag/key word.

      Entries can be displayed as a grid or as a list. They can be sorted by relevance, date, and title. Default sorting criterion is relevance.

    3. View Marketplace Item in Map

      If an entry can be potentially viewed and explored in detail in the Catalogue-Client a button "show in map" appears in the entry's details like in the figure below.

      When you click on this link you are redirected to the Catalog-Client - an interactive map application. For details on the Catalogue-Client please refer to the next section.

  4. Catalogue Client

    The CODE-DE Catalogue Client provides an enhanced solution to discover, view, and download available Earth Observation data (EO data). These are primarily Sentinel 1 and 2 data sets. Sentinel-3 will follow soon.

    Launching the Catalogue Client after switching from the Marketplace to the Catalogue Client in the browser (by clicking "show in map") it provides a first view on the available products on the map, the time slider, and as a list.

     

    Select data set

    Click / select a data set in the Marketplace and a window opens, providing detailed information on the selected data set .

    The button "show in map" opens the Catalogue Client presenting available data of the data set in an interactive map application. The data is presented in a list and on a timeslider, too.

    If you need to query different Sensor's data sets (multiple data set search) follow the instruction in the next paragraph...

     

    Multiple Datasets queries for an area

    It is possible to search for differnet data sets (Sentinel-1 and 2,) if you start with the "map" button on the start window. The  Catalogue Client opens with multiple layers of available data sets:

     

    Short introduction

    When the Catalogue Client is opened the first time a short introduction starts guiding you through the main features and elements of the Catalogue Client. You can start this short intro anytime clicking the  -Button on the lower right of the window.

    The Catalogue Client appears at first in about the following view:

    This view is for Visualisation and viewing of existing image data in the map window. You can now zoom-in and pan the data. You can see a grid on the right part of the map. These are the appr. scene extents without image content. When you start zooming-in the satellite images will appear in a reduced resolution natural colour presentation for viewing. The map windows loads / selects data for the shown extent in the background. A time filter can be set now using the timeslider at the bottom of the map window.

    Satellite scenes in the map window are used for a preview  (pre-selection) for the download (see Download below). If you change the map extent or zoom in and out the pre-selection changes, too

    Timeslider

    The timeslider presents the distribution and number of (different) datasets in time (bar graphs). You can make a temporal selection on the timeslider:

    • dragging the lower part of the timeslider changes the interval,
    • you can click on the Plus and Minus symbol to zoom the timeslider or you can use the mouse wheel,
    • left-click + drag marks/selects datasets in the upper part of the timeslider.

    Remark:

    Changing the selection on the timeslider or filter window could differ from the selection in the map window - depending on the zoom and area selected there - and it can be different from the selection in the "Search Results". You will see a yellow message box in the map window.

    Changing the view in the map window: zoom-in / out or pan changes the selected data sets as well (pre-selection)    (Please, try and see the effects...)

     

    Catalogue Client - Filter Download

    If you use the  button in the upper right part of the map window the menu/window with search results appears. Now the Catalogue Client is in the download modus, where you can search, select and download of check the satellite scenes.

    CODE-DE provides you with Viewing functionalities in the map window and Filter/Search functionality for download in a single tool ("new usage paradigm"):

     

    Filter

    There are two possibilities to query data in the Catalogue-Client. At the left there is the Filter window - see figure below:

    1. You can apply a temporal query --> "Time Filter": Enter Start and End date of your search interval.

    2. You can apply a spatial query:  --> "Spatial Filter":  using the "Point", "Rectangle" or "Polygon" drawing options under "Draw" or

    3. You upload your area of interest as zipped shapefile using  "Upload"

    Additional Filters

    Additional Filters can be applied on the available information stored with the data sets. Filter can either apply on optical or radar data features, but the options are always shown for all sensors. So e.g. Cloud Cover etc. applies only for optical sensors and Polarisation, Antenna Look Direction etc. only for radar data (SAR).

    Layers

    If you click on "Layers" the "Overlay", "Layer" and "Base Layer" legend can be seen.  The "Base Layer " is the background for the map window for orientation and the "Layer" presents the selected data sets and its products or products levels (e.g. Sentinel-1). You can select and change the order of the layers.

    Remark: The order of of the layers has an influence on the order of layers in the timeslider (see below).

     

    Search Results

    The right window shows your "search results" with quicklooks of the available satellite imagery. Here you can select data of interest and look for further information. If you click a data set it is selected for download and will be shown in the "Download" part of the window.

    Download

    At the right window the selected data will be listed under "Download". You can either directly download the data set using "download" at the buttom of the window or "download as" providing the Metalink or URL listing.

  5. User Management

    The CODE-DE platform makes use of an User Management System (UMS), which is used for the authentication and authorisation of users. The UMS is used to manage users, user groups and user rights. Some changes of group membership and user rights can't be done automatically, but must be authorised and granted according to the CODE-DE Governance (Rules for user groups and their access rights). The process of granting additional user rights to an user can last some time.

    The main advantage of the UMS is that it provides a single-sign-on  (SSO) procedure, which means that only a single login (after registration) is required by the user to access the configured and integrated CODE-DE services.

    For further details on user groups and access rights (priorities), please, refer to the FAQ Who has access to Copernicus / CODE-DE and according to which criteria?

    1. Login

      You can log in over the login block in the header of the Portal which is shown in the figure below.

      Once you have pressed the "Login" button you are redirected to the CAS login form which you can see in the figure below. After entering your credentials and submitting the form you are logged in on the CODE-DE platform...

      ... and redirected to the Portal start page. The login block shows your user name and the following functions: go to your "Profile", update "Permissions", "Logout".

      From now on you can access all CODE-DE services and functionalities, which are accessible to you according to your user role's permissions (refer to the User roles below and FAQ Who has access to Copernicus / CODE-DE and according to which criteria? )

      (Remark: "TEST_PORTAL" is our user account for tests.)

    2. Self-Registration

      If you don't have an account yet you can create one by clicking on the "register" link next to the login block. This is necessary before you can login as a CODE-DE user.

      You will be redirected to a self-registration form which is shown in the figure below. You have to accept the CODE-DE Terms and Conditions and Privacy Statement  during registration.

      After sending the completed form you will be redirected to the CODE-DE Portal.

       

    3. Request for Additional User Permissions

      If a function in the Portal is restricted for you as a logged-in user a lock symbol is displayed next to the function as shown in the figure below. By clicking on the symbol you are redirected to the Help Desk Contact Form for applying for additional rights which is prefilled with a respective subject and default message.

      Additionally you can apply for higher processing or download quota.

      Alternatively, you can use the function "Permissions" in the login block which redirects you to a form which lists all your permissions resp.  user groups you belong to. You can choose to apply for additional permissions by selecting the respective user group(s). Once you submit the form, the content (including the requested user groups) is sent to the Help Desk . The Help Desk has to verify the requested permissions against the CODE-DE Governance rules. In the positive case, the operator adds you to the requested user groups.

      Remark: Provision of additional rights is not done automatically. So, if you apply for addition al right or like to chang groups / access right, please, provide us additional information, why you apply for these additional rights. If you are a contractor of German ministries/authorities etc., provide us with a reference contact (email), your contract number and the purpose of the data access. (It makes it easier to decide!)

  6. Search

    There are two different options for "Search" on the Portal.

    On the one hand, a general search function on every page of the Portal website, which allows the user to search for Portal contents, e.g. news, general information, help.

    On the other hand, the Marketplace will enable the user to specify pre-defined and free-text keywords in order to narrow down the result list. The pre-defined keywords include the INSPIRE themes and satellites such as the Sentinels. The Marketplace "search" is explained in the next  paragraph.

    1. Portal Search

      The Portal search function enables you to search for keywords in general Portal pages such as News, About, etc. ("magnifying glass" at the right - see figure below)

      This search won't return any Marketplace entries. For this purpose, please use the keyword entry box in the Service Marketplace.

      If you like to search in the Marketplace you should use the entry field there (navigate to the Marketplace):

       

  7. Help Desk

    The Help Desk is the point of entry for questions and requests to CODE-DE and its Sentinel data and Copernicus products and services content.

    The support/help is provided in German and English language with a maximum response time of two business days (closing of issue/answer).

    The Portal provides a contact form where the request or question can be entered. Some subjects are predefined.

    The request will be sent to the Help Desk and categorised opening a ticket. You will get a confirmation email on all your activities.

    Communication to the Help Desk is restricted to email. You can use the following email address instead of the Help Desk Contact Form as well: code-de-helpdesk[at]dlr.de

     

    If you are not allowed to execute a certain action on CODE-DE, you will see a lock-symbol. Click it and you will be redirected to the following form:

    Here you can apply for extended access rights / privileges.

     

    1. How can the Help Desk help

      You can reach the Help Desk using the Contact Form at the bottom of the most CODE-DE pages. The Help Desk uses only email communication. You can reach the Help Desk directly, too, using the folowing email address: code-de-helpdesk[at]dlr.de .

      Usually you should get a final answer within two business days. Processing or answering your request depends on the complexity of your request and your supporting information. But you will be kept up-to-date on every activity on your request by email.

      The Help Desk provides email support for the following cases:

      • Support with usage and functionalities of the CODE-DE services
      • Support with access and use of the Sentinel Data (actual and archive data)
      • Support with methods, access restrictions or problems of the CODE-DE services
      • Support with access and usage of available COPERNICUS products over the CODE-DE services

       

      The following requests and questions are managed through the Help Desk ticket system:

      • Problems with using and understanding the CODE-DE services and its functionalities
      • Collection of new user requirements and missing functionalities
      • Support how to use data, products and services when problems occur
      • Building up of a Know-How repository which is feeded into the FAQs component and help (user manual)
      • Foreward / escalate request to second and third level support for complex problems
      • Management of updates of the Manual and Help Desk functionality in accordance with Portal update cycles
      • Quota requests for data access, processing time and any other issues relevant which shall be forwarded to the CODE-DE Management for decision taking according to the CODE-DE governance
  8. Browser Requirements

    • The Portal supports the current and prior major release of Chrome, Firefox, Internet Explorer/Edge and Safari
    • With any browser, cookies need to be turned on to use the portal
    • JavaScript has to be enabled in the browser
    • No additional add-ons or plugins are necessary to use the portal