Difference between revisions of "EODMS How-To Guide"

From wiki
Jump to navigation Jump to search
Line 92: Line 92:
 
# Next, click on the "4. Select Data Options" section and select “true” from “Preview Available” dropdown. [[File:Napl-preview-search.png]]
 
# Next, click on the "4. Select Data Options" section and select “true” from “Preview Available” dropdown. [[File:Napl-preview-search.png]]
 
#  Once your results are showing you can preview the image by following How can I preview an image? article.  
 
#  Once your results are showing you can preview the image by following How can I preview an image? article.  
 
=== (GC only) The list of satellites under <Select Data> is missing a lot of NMSO satellites. How can I find this data? ===
 
 
EODMS can only load and map-search the satellites shown. However, all satellite data not loadable is stored on the EODMS Download Server with direct HTTP/FTP access. To find satellite data by name (e.g. "Flock1-ISS", "PLEIADES") we invite you to use Filezilla against data.eodms-sgdot.nrcan-rncan.gc.ca with the [https://www.youtube.com/watch?v=hQq66tp4Rg0 text search function]:
 
[[File:Filezilla-text-search.png]]
 
  
 
=== Can I change the map to a Polar Stereographic Projection? ===
 
=== Can I change the map to a Polar Stereographic Projection? ===
Line 412: Line 407:
 
[[File:Napl-preview-search.png]]
 
[[File:Napl-preview-search.png]]
 
# Pouvez-vous prévisualiser l'image? article.
 
# Pouvez-vous prévisualiser l'image? article.
 
=== (GC uniquement) La liste des satellites sous <Sélectionner les données> manque de nombreux satellites de l'OCPN. Comment puis-je trouver ces données? ===
 
 
EODMS ne peut charger et rechercher sur carte que les satellites affichés. Cependant, toutes les données satellite non chargeables sont stockées sur le serveur de téléchargement EODMS avec un accès HTTP / FTP direct. Pour trouver les données satellite par nom (par exemple "Flock1-ISS", "PLEIADES"), nous vous invitons à utiliser Filezilla contre data.eodms-sgdot.nrcan-rncan.gc.ca avec le [https://www.youtube.com/watch?v=hQq66tp4Rg0 fonction de recherche de texte]:
 
[[File: Filezilla-text-search.png]]
 
  
 
== Travailler avec les résultats ==
 
== Travailler avec les résultats ==

Revision as of 16:18, 9 December 2022

This page shows is how-to guide from the support team to users. For more general information, you can visit the EODMS page.

We invite you check out these articles to help you on your way!

Website[edit | edit source]

The application is so small compared to NRCan menu and banner. Can I make it bigger?[edit | edit source]

Yes! Use the fullscreen button top-right:

Fullscreen.png

I am getting an error when I visit the site. How do I stop this?[edit | edit source]

The website has likely been upgraded while you were using it. You can clear errors by closing you browser completely and/or clearing your browsers "cookies". This can quickly be done on most browsers by hitting Ctrl+Shift+Delete.

Maps[edit | edit source]

How do I reset my map?[edit | edit source]

To reset your Basemap:

  • At the top-left of the map, select "Map Options"
  • Select "Select Base Map"
  • In the "Select Base Map" Window, choose expand "Reset Map" and click, "OK" to the warning.
  • Close the window

How do I change my map?[edit | edit source]

  • At the top-left of the map, select "Map Options"
  • Choose "Select Base Map"
  • Choose a map from the list.
  • Close the window

How do I use my own base map[edit | edit source]

To add your own base map:

  • Select "Map Options" (top-right of map)
  • Select, "Select Base Map",
  • Select "Import Map"
  • Choose one of the map types and click, "Next"
  • *Note*: When specifying a map by URL, be sure to use the HTTP (insecure) form, not HTTPS (e.g. http://server.arcgisonline.com/ArcGIS/Services/World_Topo_Map/MapServer)
  • Hit next and continue through the wizard until your map appears.

Searching[edit | edit source]

How do I search for data outside Canada?[edit | edit source]

To search for data outside Canada, you must make sure your Basemap is set to "OpenStreetMap".

  • At the top-left of the map, select "Map Options"
  • Select "Select Base Map"
  • In the "Select Base Map" Window, choose expand "Select Base Map", the Select "World"

Note: Sometimes you have to click the chosen base map twice in order to take affect.

  • Close the window

How do I narrow my search by time, dataset, and data options?[edit | edit source]

To narrow your search for a particular image:

  1. From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
  2. Next, click on "2. Select Dates". The default is "Any Time", but you can narrow to date range, seasonal dates, or last 24 hrs EODMS-FAQ-NAPL-Dates.png
  3. Next, click on "3. Select Data" and select the dataset / collection of interest EODMS-FAQ-NAPL-Data-1.png
  4. Next, click on "4. Select Data Options" and enter particular data options specific to your dataset EODMS-FAQ-NAPL-DataOptions.png
  5. Finally click on "5. Submit Search", then click the "Search Button" EODMS-FAQ-NAPL-Data.png

How do I search for a particular National Air Photo Library Photo (i.e. Roll and Photo Number)[edit | edit source]

To find a particular National Air Photo Library (NAPL) photo using Roll Number and/or Photo Number:

  1. From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
  2. Next, click on "2. Select Dates" and select "Any Time" EODMS-FAQ-NAPL-Dates.png
  3. Next, click on "3. Select Data" and select "National Area Photo Library" EODMS-FAQ-NAPL-Data-1.png
  4. Next, click on "4. Select Data Options" and enter your Roll Number (e.g. A24565) and/or Photo Number. You can also use wildcards such as "%" and "_". For example, %15 will find "0015", "0115", etc. Using "01_9" will find "0109", "0119", and so on.

Eodms-napl-search-data-options-wildcard.png

  1. Finally click on "5. Submit Search", then click the "Search Button" EODMS-FAQ-NAPL-Data.png

How do I search for data near a given city or area of interest?[edit | edit source]

To find data near a desired area e.g. a National Air Photo Library (NAPL) over Barry's Bay, ON, CA" simply

  1. From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
  2. Next, click on the "1. Select an Area of Interest" Search Criteria grouping (grey header #1)
  3. OPTION 1: Select the "Draw an Area" option
    1. Select a pink shape option e.g. the Rectangle.
    2. Next, go to the map on the right, and draw a shape around the area of interest.
  4. OPTION 2: You can also use the "Enter Coordinates" option and enter a latitude and longitude and click "Draw"
  5. Notice how you area is reflected on the map in pink.
  6. Finally click the last Search criteria grouping "5. Submit Search", then click the "Search Button"

EODMS-FAQ-AOI.png

I did a search for data and I am not seeing any results?[edit | edit source]

The first thing to check is your search dates. If you are looking NAPL imagery (which dates back to 1920) you should select either "Any Time" or specify a specific Start and End Date

EODMS-FAQ-Dates.png

How do I narrow my search to return aerial photos with a preview (i.e. thumbnail)?[edit | edit source]

To narrow your search to aerial photos with a preview (i.e. thumbnail):

  1. From the Start Page, start a new search by clicking, "Search”
  2. Next, click on the "3. Select Data" section and select “National Air Photo Library”
  3. Next, click on the "4. Select Data Options" section and select “true” from “Preview Available” dropdown. Napl-preview-search.png
  4. Once your results are showing you can preview the image by following How can I preview an image? article.

Can I change the map to a Polar Stereographic Projection?[edit | edit source]

RCM EODMS users can select a base map that has the option of changing the projection:

  1. Choose “Map Options” in the upper left corner of the reference map
  2. Choose “Select Base Map”
  3. Select the “Canadian Base Map” and close the window
  4. Select “Map Options”
  5. Select “Change Projection”
  6. Choose one of the PS projections (EPSG:10403 is recommended)

Working with Results[edit | edit source]

The Result screen's map view displays too many image footprints to make sense of[edit | edit source]

EODMS-FAQ-TooManyThumbnails.png

Answer

You can hide result thumbnails using the "View only selected footprints" menu option in the top left of the results screen.

EODMS-FAQ-ShowSelectedFootprints.png

There are so many columns, how do I hide some or show different ones?[edit | edit source]

  1. Position your mouse in any column header until a blue down-arrow appears. Click it
  2. Next click, Columns, which will open up the list of columns
  3. Hide and Show different columns by checking and unchecking
EODMS-FAQ-Columns.png

How do I see the details of an image (i.e. metadata)?[edit | edit source]

While the result columns show some information, full metadata information can by:

  1. Scrolling the results view to the right by using the horizontal scroll bar along the bottom
  2. Clicking the "View" link in the "Metadata" column.

Metadata

Is it possible to export the results including geometry (i.e. spatial info)[edit | edit source]

  1. Above the results, click on the "Select Option" menu button
  2. Choose, "Save Search Results"
  3. Choose the desired format

14808.png

How can I preview an image?[edit | edit source]

  1. Scroll to the right until you see the "Thumbnail" column.
  2. click the checkbox
  3. Observe the preview on the map.
  4. Note: In the case of NAPL aerial photos, you may see a place holder image. This usually means digitization has not been completed and the photo still resides on film only.

Why do only certain aerial photos have a preview?[edit | edit source]

While the EODMS catalog contains over 3.5M aerial photo records, only a percentage of those have actually been digitized from original film. Only successfully digitized photos which have been loaded into the system have a preview available.

Ordering[edit | edit source]

How do I order an image?[edit | edit source]

  1. With results loaded, check the "Order" checkbox EODMS-FAQ-NAPL-CartTab.png
  2. Check the "Select item(s)" checkbox
  3. Finally, click the "Update Cart" button.
  4. Observe a new cart tab appears.

How do I order a National Air Photo Library Photo?[edit | edit source]

  1. Follow the steps to search for a particular NAPL photo above.
  2. With results loaded, check the "Order" checkbox EODMS-FAQ-NAPL-CartTab.png
  3. Select your Media Type, File Format, Image Resolution, Level of Compression, check the "Select item(s)" checkbox and finally, click the "Update Cart" button. Note: If you would like a different Image Resolution than what is listed, you can specify later in another screen. EODMS-FAQ-NAPL-OrderScreen.png
  4. Review your cart one last time and click "Submit Aerial Photo Order" Note: While pricing shown as N/A on EODMS, these images are not free and payment will be made directly with the NAPL order desk once they process your order. For complete list of pricing you can visit: https://www.nrcan.gc.ca/earth-sciences/geomatics/satellite-imagery-air-photos/air-photos/photo-collection/9707 EODMS-FAQ-NAPL-CartSubmit.png
  5. Finally enter a name for your order and any additional comments, e.g. a custom image resolution, the reason you are making this purchase. If you want an oblique photo you can specify that here. EODMS-FAQ-NAPL-NameDesc.png
  6. Your order is now submitted to NAPL. Your cart will show as "SAVED" which is correct. You will also receive an email confirming receipt of your cart. Payment will be requested by the NAPL order desk my phone or email.

Are National Air Photo Library Photos Free?[edit | edit source]

No. Despite the "$0", order requires payment. Full pricing on NAPL can always be found here: https://www.nrcan.gc.ca/earth-sciences/geomatics/satellite-imagery-air-photos/air-photos/photo-collection/9707

How do I know the prices of National Air Photo Library Photos[edit | edit source]

Full pricing on NAPL can always be found here: https://www.nrcan.gc.ca/earth-sciences/geomatics/satellite-imagery-air-photos/air-photos/photo-collection/9707

I received an email saying my order has failed. Why?[edit | edit source]

A failed email notification for an order is often for the following reasons:

  1. For NAPL: It often results if you attempted to use the "Reconfigure and Submit Order" menu option on an order which is already properly "SAVED". Doing this not necessary as submitting the order the first time correctly sends an email to the NAPL order desk for processing. An order marked as "SAVED" is correct and no further action is required on your part and you can ignore the failed notification.
  2. For RCM: For general public users, orders often fail because an order was placed on an item that is not available to the public. For more information on RCM open data, consult RCMOpenData. If you are interested in expanded RCM Vetted access, please see RCM Vetted Access
  3. For any other situation, we invite you to re-submit your order using the Resubmit option as follows:

Resubmit

To verify the order failed reason, simply click on the Order Status link on the homepage and then on the order name. Use the Contact Us page if you still require help.

I am trying to order RADARSAT images, but when I click the order checkbox I am presented with Order Desk information[edit | edit source]

This message is presented to users who are not logged in as well as for RAW collections (e.g. *RADARSAT-1 Raw Catalog*, *RADARSAT-2 Raw Catalog*). You should instead login (or register for an account) and once logged-in, re-do your search by selecting the "RADARSAT-1 Open Data Products [Online]" or the "RADARSAT-2 Products [Online]" collection.

When I try to order a CCRS Thematic Dataset, I get an error, "You are not permitted to add more than 25 items to your cart. Please select fewer items or narrow your search for Value-Added Satellite Products"[edit | edit source]

Because of the time-series nature of CCRS thematic datasets, the size of the product depends on how wide you chose your start and end time. For example, attempting to download the MODIS 10-day composite time series product for all time (e.g. start time 2016 - 2019) amounts to a 1.36 TB product. To reduce the size of your product to enable ordering, re-do your search with a more narrow time window e.g. Jan 01 2019 - Jan 17 2019 which amounts to a smaller 26 GB.

Now that I have submitted my aerial photo order, how long does the order desk production process take?[edit | edit source]

Ordering times can vary. You can always followup on the status on your order by contacting the NAPL order desk directly: https://www.nrcan.gc.ca/earth-sciences/geomatics/satellite-imagery-air-photos/air-photos/photo-collection/9707

How do I create a standing order?[edit | edit source]

Standing-order.png

  1. Perform a new search
  2. hit "+ Select Dates"
  3. Select a *future* time range
  4. (Optional) Refine the search with data options, or area of interest
  5. hit "Submit Search" then the "Search" button. Name you "Watch Mode" search.
  6. Observe the "Saving Watch Mode" and let the search finish.
  7. Go back to Start tab, Click "Watch Searches" and select your search
  8. Under the "Subscription" tab, set you notification preference e.g. "Only when results are found"
  9. Under the "Standing Order" tab and check the "Enable Standing Orders" checkbox. Enter "5" or less into the Maximum number of standing orders field. Select Delivery Type to "Download".
  10. Click "Save".

Download[edit | edit source]

How do I download my order data[edit | edit source]

When your order is ready, you will receive an email from EODMS with the subject "EODMS Image Request Delivery Notification". To download your data, you have a few options:

  1. Click the ftp link in the email e.g. ftp://data.eodms-sgdot.nrcan-rncan.gc.ca/public/carts/xxx-xxx-xxx-xxx-xxxx to open a browser and prompt you to enter your EODMS username and password.
  2. Click the https link in the email e.g. https://data.eodms-sgdot.nrcan-rncan.gc.ca/public/carts/xxx-xxx-xxx-xxx-xxxx to open a browser and prompt you to enter your EODMS username and password.
  3. Use an FTP client (e.g. Filezilla, Windows Command Line ftp.exe) and use hostname data.eodms-sgdot.nrcan-rncan.gc.ca, and your EODMS username and password. If the setting allows, select to use Passive Mode.

Note: Some government departments have reported issues with FTP access. This is usually attributed to a firewall issue at the department end. FTP access to the open Internet is a service that should always be up.

How do I bulk-download files without having to click one-by-one in my browser[edit | edit source]

We invite you to use a command line of terminal to run this on fulfilled orders by supplying username and password as follows:

 wget https://username:password@data.eodms-sgdot.nrcan-rncan.gc.ca/rcm/carts/(my_cart_directory) --recursive --no-parent

Or, for public data you may run without username and password:

 wget https://data.eodms-sgdot.nrcan-rncan.gc.ca/public/avhrr/l1b/2022/2022001 --recursive --no-parent

If you are on Windows, you can download wget from https://eternallybored.org/misc/wget/. You can also customize directory options per https://www.gnu.org/software/wget/manual/wget.html#Directory-Options.

I downloaded my image order. What software can I use to view the images?[edit | edit source]

QGIS[edit | edit source]

QGIS is a well-supported desktop GIS tool which supports a variety of GIS image formats. You can download QGIS for free from their website.

RS1qgis.png

MapReady and Google Earth[edit | edit source]

Another method is to download MapReady from https://www.asf.alaska.edu/data-tools/mapready/. open your product (.sarl file, for example), leave all the defaults and click, process file. Finally, click on the Google Earth icon to display it. At this time, MapReady only supports RADARSAT-1 Product Type SGX. Mapready.png Rs1-google-earth.png

Can I just download satellite imagery without going through the whole order process?[edit | edit source]

For RADARSAT-1, Yes! You do not even need to login. Simply

  1. perform a search for RADARSAT-1
  2. Scroll to the right, until you see the "Download Link" column
  3. Click the link and voila!
Direct-download-goto.png

For all other collections, this service is not yet available. The EODMS team is working hard to make this service available for all open collections.

My RCM order was fulfilled with more than 1 product zip files[edit | edit source]

e.g.

 RCMX_OKXXXXXX_PKXXXXXXX_1_BEAMMODE_20XXXXXX_XXXXXX_VV_VH_GRD.zip, RCMX_OKXXXXXX_PKXXXXXXX_2_BEAMMODE_20XXXXXX_XXXXXX_VV_VH_GRD.zip. 

Often images are acquired in a longer swaths and then when processed, are broken down into multiple products/images. SAR image processing applications can typically stitch them back together.

User Account Information[edit | edit source]

How do I register for an account?[edit | edit source]

Simply click on the Register (Required to order products) link on the EODMS start page.

I am receive an error, "Invalid Login" and I am sure am entering the correct username and password (or temporary password)[edit | edit source]

  • Note*: Per security controls in EODMS, a user account will expire due to 2 years of website inactivity, or password not being changed after 5 years.

Please check:

  1. As your username is case sensitive, please ensure that you are entering all uppercase and lowercase correctly
  2. Your account may be disabled, despite entering correct username and password. Please contact EODMS support team (mailto:eodms-sgdot@nrcan-rncan.gc.ca) to have it reactivated.

How do I update my account information (e.g. email address, password)?[edit | edit source]

  1. Login to EODMS
  2. At the top right of the map, Click on your username, then click Account Information: EODMS-FAQ-AccountDetails.png
  3. With the Account Information screen displayed, update any detail you wish, e.g. Email Address, First Name, Last Name, Department, etc. EODMS-FAQ-AccountDetailsEmailSave.png
  4. You can change your password by click on the "Account Information" tab and then the "(Change Password)" link

Can I change my username after my account has been created?[edit | edit source]

Unfortunately no. You can however create a new account and any special privileges will be transferred over.

I forgot my password, How do I retrieve it?[edit | edit source]

  1. Click the login link
  2. Fill in only your username into the username text box
  3. Finally, click the "Forgot your password?" link and say "OK" to the following message to have a temporary password emailed to you.

I forgot my username. How do I retrieve it?[edit | edit source]

You can contact the EODMS support team (mailto:eodms-sgdot@nrcan-rncan.gc.ca) and provide you first name, last name, and email address used to register the account and it will be provided by email.

Can I register for EODMS if I do not belong to an organization?[edit | edit source]

Yes. Simply choose the Organization Type, "Public" when registering.

API Access[edit | edit source]

Can I access EODMS using an API[edit | edit source]

EODMS is has several options for API Access and automation i.e. Machine 2 Machine

To find more GC APIs, visit the GC API site.

Api-logo.png

https://api.canada.ca/en/homepage