Difference between revisions of "ARR DATAHUB CANNOT BE ACCESSED"

From Tuflow
Jump to navigation Jump to search
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
=Purpose=
 +
This page has been setup in the event that the ARR datahub cannot be accessed by 'Extract ARR for TUFLOW' tool in QGIS, but can still be accessed manually by the user. This situation may occur during times of heavy automated traffic on the website.<br><br>
 +
The following error appears in the log.txt when the tool cannot access the ARR website.<br>
 +
'''Failed to get data from ARR website'''<br>
 +
=Workaround=
 +
There is a workaround in place for this situation. It requires the user to manually extract data from the ARR datahub, perform some file manipulation, then save the file in the correct location with the correct name. The tool has been setup to first attempt to access the ARR datahub. If failing this, it will then seek to find an existing copy of the extracted data. The following warning message will appear in the log.txt if this is the case 'WARNING: Could not access ARR website... found and using existing ARR web data'<br>
 
=Steps=
 
=Steps=
 +
The following steps describe how to manually extract data from the ARR datahub and format appropriately for the tool to use. The first 2 steps are not necessary if the user knows the longitude and latitude of the location they would like to extract information for.
 
<ol>
 
<ol>
<li> Run 'Extract ARR2016 for TUFLOW' tool in QGIS until error - ''This will let the tool download the data from BOM as well as perform the pre-calculations such as extract the catchment area and centroid from the input catchments''
+
<li> Run 'Extract ARR2016 for TUFLOW' tool in QGIS until error - ''This will let the tool perform the pre-calculations such as extract the catchment area and centroid from the input catchments''
<li> Open 'log.txt' located in the tool output folder and extract the longitudinal and latitude values<br>[[File:log_text_coords.PNG | 350px]]
+
<li> Open 'log.txt' located in the tool output folder and extract the longitudinal and latitude values<br>[[File:log_text_coords.PNG ]]
 
<li> Using an internet browser, navigate to the [http://data.arr-software.org/ ARR datahub]
 
<li> Using an internet browser, navigate to the [http://data.arr-software.org/ ARR datahub]
 
<li> Input the coordinates of your catchment
 
<li> Input the coordinates of your catchment
<li> Tick on the 'Select All' box<br>[[File:ARR_datahub_input.PNG | 550px]]
+
<li> Tick on the 'Select All' box<br>[[File:ARR_datahub_input.PNG | 700px]]
 
<li> Click '''Submit'''
 
<li> Click '''Submit'''
<li> Navigate to the bottom of the page and click '''Download TXT'''<br>[[File:ARR_datahub_downloadtxt.PNG | 200px]]
+
<li> Navigate to the bottom of the page and click '''Download TXT'''<br>[[File:ARR_datahub_downloadtxt.PNG ]]
<li> Create a new .txt file called 'ARR_Web_Data_<catchment name>.txt' and save it in the '''data''' folder alongside the existing file 'BOM_raw_web_<catchment name>.html - ''The catchment name should be consistent with the name used in the QGIS tool. It will be the same as the BOM raw output and also be listed in the log.txt after name=''<br>[[File:ARR_Web_data.PNG | 500px]]
+
<li> Create a new .txt file called 'ARR_Web_Data_<catchment name>.txt' and save it in the '''data''' folder alongside the existing file 'BOM_raw_web_<catchment name>.html - ''The catchment name should be consistent with the name used in the QGIS tool. It will be the same as the BOM raw output and also be listed in the log.txt after name=''<br>[[File:ARR_Web_data.PNG ]]
<li> Copy the text from the '''Download TXT'' to the newly created 'ARR_web_data' text file<br>[[File:ARR_Web_data_content.PNG | 350px]]
+
<li> Copy the text from the '''Download TXT'' to the newly created 'ARR_web_data' text file<br>[[File:ARR_Web_data_content.PNG]]
<li> On the ARR datahub page, navigate to the temporal patterns and click '''Download (.zip)'''<br>[[File:ARR_datahub_download_tp.PNG | 250px]]
+
<li> On the ARR datahub page, navigate to the temporal patterns and click '''Download (.zip)'''<br>[[File:ARR_datahub_download_tp.PNG ]]
 
<li> Extract the contents of the zip file
 
<li> Extract the contents of the zip file
 
<li> Open '_increments.csv' in a text editor
 
<li> Open '_increments.csv' in a text editor
<li> Copy the contents of the csv to the end of 'ARR_Web_data'<br>[[File:ARR_Web_data_content_addtp.PNG | 250px]]
+
<li> Copy the contents of the csv to the end of 'ARR_Web_data'<br>[[File:ARR_Web_data_content_addtp.PNG ]]
<li> Infront of 'EventID' in the newly copied across data, insert the following text '''[STARTPATTERNS]'''<br>[[File:ARR_Web_data_content_addtpHeader.PNG | 550px]]
+
<li> Infront of 'EventID' in the newly copied across data, insert the following text '''[STARTPATTERNS]'''<br>[[File:ARR_Web_data_content_addtpHeader.PNG ]]
 +
<li> Save 'ARR_web_data_'
 +
<li> Run the tool in QGIS again - ''The tool should now first try and access the datahub online. If this fails, it will then look for a pre-existing datahub output with temporal patterns included. The following warning will appear in the log.txt file if this is the case 'WARNING: Could not access ARR website... found and using existing ARR web data' ''
 +
</ol>

Latest revision as of 12:04, 7 March 2024

Purpose

This page has been setup in the event that the ARR datahub cannot be accessed by 'Extract ARR for TUFLOW' tool in QGIS, but can still be accessed manually by the user. This situation may occur during times of heavy automated traffic on the website.

The following error appears in the log.txt when the tool cannot access the ARR website.
Failed to get data from ARR website

Workaround

There is a workaround in place for this situation. It requires the user to manually extract data from the ARR datahub, perform some file manipulation, then save the file in the correct location with the correct name. The tool has been setup to first attempt to access the ARR datahub. If failing this, it will then seek to find an existing copy of the extracted data. The following warning message will appear in the log.txt if this is the case 'WARNING: Could not access ARR website... found and using existing ARR web data'

Steps

The following steps describe how to manually extract data from the ARR datahub and format appropriately for the tool to use. The first 2 steps are not necessary if the user knows the longitude and latitude of the location they would like to extract information for.

  1. Run 'Extract ARR2016 for TUFLOW' tool in QGIS until error - This will let the tool perform the pre-calculations such as extract the catchment area and centroid from the input catchments
  2. Open 'log.txt' located in the tool output folder and extract the longitudinal and latitude values
    Log text coords.PNG
  3. Using an internet browser, navigate to the ARR datahub
  4. Input the coordinates of your catchment
  5. Tick on the 'Select All' box
    ARR datahub input.PNG
  6. Click Submit
  7. Navigate to the bottom of the page and click Download TXT
    ARR datahub downloadtxt.PNG
  8. Create a new .txt file called 'ARR_Web_Data_<catchment name>.txt' and save it in the data folder alongside the existing file 'BOM_raw_web_<catchment name>.html - The catchment name should be consistent with the name used in the QGIS tool. It will be the same as the BOM raw output and also be listed in the log.txt after name=
    ARR Web data.PNG
  9. Copy the text from the 'Download TXT to the newly created 'ARR_web_data' text file
    ARR Web data content.PNG
  10. On the ARR datahub page, navigate to the temporal patterns and click Download (.zip)
    ARR datahub download tp.PNG
  11. Extract the contents of the zip file
  12. Open '_increments.csv' in a text editor
  13. Copy the contents of the csv to the end of 'ARR_Web_data'
    ARR Web data content addtp.PNG
  14. Infront of 'EventID' in the newly copied across data, insert the following text [STARTPATTERNS]
    ARR Web data content addtpHeader.PNG
  15. Save 'ARR_web_data_'
  16. Run the tool in QGIS again - The tool should now first try and access the datahub online. If this fails, it will then look for a pre-existing datahub output with temporal patterns included. The following warning will appear in the log.txt file if this is the case 'WARNING: Could not access ARR website... found and using existing ARR web data'