Difference between revisions of "EODMS How-To Guide"
Line 215: | Line 215: | ||
'''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.''' | '''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 === | ||
+ | |||
+ | Nous vous invitons à utiliser une ligne de commande de terminal pour l'exécuter sur les commandes exécutées en fournissant le nom d'utilisateur et le mot de passe comme suit : | ||
+ | wget https://username:password@data.eodms-sgdot.nrcan-rncan.gc.ca/rcm/carts/(my_cart_directory) --recursive --no-parent | ||
+ | |||
+ | Ou, pour les données publiques, vous pouvez exécuter sans nom d'utilisateur ni mot de passe : | ||
+ | wget https://username:password@data.eodms-sgdot.nrcan-rncan.gc.ca/rcm/carts/(my_cart_directory) --recursive --no-parent | ||
+ | |||
+ | Si vous êtes sous Windows, vous pouvez télécharger wget depuis https://eternallybored.org/misc/wget/ | ||
=== I downloaded my image order. What software can I use to view the images?=== | === I downloaded my image order. What software can I use to view the images?=== | ||
Line 238: | Line 248: | ||
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. | 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 | + | === My RCM order was fulfilled with more than 1 product zip files === |
− | + | e.g. | |
− | 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. | + | 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 == | == User Account Information == | ||
Line 512: | Line 523: | ||
'''Remarque: Certains ministères GC signalé des problèmes d'accès FTP. Cela est généralement attribué à un problème de pare-feu au niveau du service. L'accès FTP à l'Internet ouvert est un service qui devrait toujours être opérationnel. ''' | '''Remarque: Certains ministères GC signalé des problèmes d'accès FTP. Cela est généralement attribué à un problème de pare-feu au niveau du service. L'accès FTP à l'Internet ouvert est un service qui devrait toujours être opérationnel. ''' | ||
+ | |||
+ | === Comment puis-je télécharger des fichiers en masse sans avoir à cliquer un par un dans mon navigateur === | ||
+ | |||
+ | |||
=== J'ai téléchargé ma commande d'images. Quel logiciel puis-je utiliser pour visualiser les images? === | === J'ai téléchargé ma commande d'images. Quel logiciel puis-je utiliser pour visualiser les images? === |
Revision as of 10:21, 27 April 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]
[edit | edit source]
Yes! Use the fullscreen button top-right:
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:
- From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
- Next, click on "2. Select Dates". The default is "Any Time", but you can narrow to date range, seasonal dates, or last 24 hrs
- Next, click on "3. Select Data" and select the dataset / collection of interest
- Next, click on "4. Select Data Options" and enter particular data options specific to your dataset
- Finally click on "5. Submit Search", then click the "Search Button"
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:
- From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
- Next, click on "2. Select Dates" and select "Any Time"
- Next, click on "3. Select Data" and select "National Area Photo Library"
- 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.
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
- From the Start Page, start a new search by clicking, the "Search for Earth Observation Data and Aerial Photographs" link
- Next, click on the "1. Select an Area of Interest" Search Criteria grouping (grey header #1)
- OPTION 1: Select the "Draw an Area" option
- Select a pink shape option e.g. the Rectangle.
- Next, go to the map on the right, and draw a shape around the area of interest.
- OPTION 2: You can also use the "Enter Coordinates" option and enter a latitude and longitude and click "Draw"
- Notice how you area is reflected on the map in pink.
- Finally click the last Search criteria grouping "5. Submit Search", then click the "Search Button"
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
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):
- From the Start Page, start a new search by clicking, "Search”
- Next, click on the "3. Select Data" section and select “National Air Photo Library”
- Next, click on the "4. Select Data Options" section and select “true” from “Preview Available” dropdown.
- 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?[edit | edit source]
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 text search function:
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:
- Choose “Map Options” in the upper left corner of the reference map
- Choose “Select Base Map”
- Select the “Canadian Base Map” and close the window
- Select “Map Options”
- Select “Change Projection”
- 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]
Answer
You can hide result thumbnails using the "View only selected footprints" menu option in the top left of the results screen.
There are so many columns, how do I hide some or show different ones?[edit | edit source]
- Position your mouse in any column header until a blue down-arrow appears. Click it
- Next click, Columns, which will open up the list of columns
- Hide and Show different columns by checking and unchecking
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:
- Scrolling the results view to the right by using the horizontal scroll bar along the bottom
- Clicking the "View" link in the "Metadata" column.
Is it possible to export the results including geometry (i.e. spatial info)[edit | edit source]
- Above the results, click on the "Select Option" menu button
- Choose, "Save Search Results"
- Choose the desired format
How can I preview an image?[edit | edit source]
- Scroll to the right until you see the "Thumbnail" column.
- click the checkbox
- Observe the preview on the map.
- 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]
- With results loaded, check the "Order" checkbox
- Check the "Select item(s)" checkbox
- Finally, click the "Update Cart" button.
- Observe a new cart tab appears.
How do I order a National Air Photo Library Photo?[edit | edit source]
- Follow the steps to search for a particular NAPL photo above.
- With results loaded, check the "Order" checkbox
- 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.
- 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
- 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.
- 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:
- 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.
- 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
- For any other situation, we invite you to re-submit your order using the Resubmit option as follows:
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]
- Perform a new search
- hit "+ Select Dates"
- Select a *future* time range
- (Optional) Refine the search with data options, or area of interest
- hit "Submit Search" then the "Search" button. Name you "Watch Mode" search.
- Observe the "Saving Watch Mode" and let the search finish.
- Go back to Start tab, Click "Watch Searches" and select your search
- Under the "Subscription" tab, set you notification preference e.g. "Only when results are found"
- 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".
- 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:
- 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.
- 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.
- 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]
Nous vous invitons à utiliser une ligne de commande de terminal pour l'exécuter sur les commandes exécutées en fournissant le nom d'utilisateur et le mot de passe comme suit :
wget https://username:password@data.eodms-sgdot.nrcan-rncan.gc.ca/rcm/carts/(my_cart_directory) --recursive --no-parent
Ou, pour les données publiques, vous pouvez exécuter sans nom d'utilisateur ni mot de passe :
wget https://username:password@data.eodms-sgdot.nrcan-rncan.gc.ca/rcm/carts/(my_cart_directory) --recursive --no-parent
Si vous êtes sous Windows, vous pouvez télécharger wget depuis https://eternallybored.org/misc/wget/
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.
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.
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
- perform a search for RADARSAT-1
- Scroll to the right, until you see the "Download Link" column
- Click the link and voila!
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:
- As your username is case sensitive, please ensure that you are entering all uppercase and lowercase correctly
- Your account may be disabled, despite entering correct username and password. Please contact EODMS support team (mailto:nrcan.eodms-sgdot.rncan@canada.ca) to have it reactivated.
How do I update my account information (e.g. email address, password)?[edit | edit source]
- Login to EODMS
- At the top right of the map, Click on your username, then click Account Information:
- With the Account Information screen displayed, update any detail you wish, e.g. Email Address, First Name, Last Name, Department, etc.
- 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]
- Click the login link
- Fill in only your username into the username text box
- 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:nrcan.eodms-sgdot.rncan@canada.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
- OGC compliant APIs: CSW for searching and WCS for ordering. See File:EODMS OGC Services.pdf for more info as well as samples in this documentFile:Procedure - Using the Catalog Service for the Web (CSW) Interface.pdf
- An EODMS Open Search API for RADARSAT-1 Open Data Products and NAPL
- A Katalon utility to automate website user clicks for searching and ordering.
To find more GC APIs, visit the GC API site.
https://api.canada.ca/en/homepage