This page explains step by step how to how to visualise 'wells running dry'

Step 1: Check GA output file XXX_output.in

  1. Check if the parameter QSRC_GW is listed in BINARY_MAPSTACKS *MERGE* in the GA output file located in the modules folder
  2. Check if QSRC_GW is listed in wells_out for merged layer (WELLS_OUT 'QSRC_GW' NO_NAME_CHECK *MERGE*)

see example file WMW_output.in

Step 2: Update module instance spreadheet

For visualising 'wells running dry' a few adjustments had to be made in the module instance spreadsheet. You can look at the NGMS module instance generator spreadsheet as an example from where you can copy the things needed (take care that you adjust the model name, location name, etc...). Following things have to be done

  1. add sheet diff_sim_inp to your spreadsheet
  2. carry out changes in sheet 'runMF':
    • change location set for import of QSRC_GW from file XXX_QSRC_GW_TimeSeries.xml from XXX_wells_all to XXX_wells_singles_and_childs
    • add import of QSRC_GW from file XXX_QSRC_GW_TimeSeries_MultiLayer.xml for XXX_wells_parents
    • check if QSRC_GW from file XXX_QSRC_GW_merged_MapStacks.xml is imported for the merged layer
  3. carry out changes in sheet 'interpolate':
    • add interpolation of QSRC_GW from merged layer to location set 'XXX_parents_and_singles'
    • change the interpolation of QSRC_GW for GWunits from locSet_in=XXX_wells_all to loc_ID=merged layer. Change ValType_in to grid
  1. carry out changes in sheet 'compare':
    • add comparison of QSRC_GW created in 3. for location set 'XXX_parents_and_singles'
  2. run macro 'Write_diff_sim_inp_XMLfiles'
  3. run macro 'Write_runMF_XMLfiles' (make sure you run the macro 'remove' afterwards)
  4. run macro 'Write_interpolate_XMLfiles'
  5. run macro 'Write_compare_XMLfiles'
  6. Check the contents of the created files. It might be wise to validate with an XML-validation tool.
  7. Copy the files which are OK to your configuration --> \Config\ModuleConfigFiles

Step 3: Add new module instances to moduleinstance descriptor

add the new module diff_sim_inp instances (for all scenarios and models) to ModuleInstanceDescriptor.xml (in Config/RegionConfigFiles), see also example file ModuleInstanceDescriptors 4.01 default.xml

Step 4: Update display spreadsheet

For visualising 'wells running dry' adjustments had to be made in the display spreadsheet. You can look at the NGMS display generator spreadsheet as an example from where you can copy the things needed (take care that you adjust the model name, location name, etc...). Following things have to be done

  1. carry out changes in sheet 'GridDisplay':
    • adjust the section for gw-abstractions (folder structure has changed, you now have separate folders for simulated values, input values and difference of simulated and input values (wells running dry)), all abstractions are displayed for location set XXX_wells_parents_and_singles, a new parameter has been introduced QSRC_GW.deficit
  2. carry out changes in sheet 'Filter':
    • add QSRC_GW.deficit for modified and reference scenarios for location set XXX_wells_parents_and_singles
  3. carry out changes in sheet 'DisplayGroups_folder' in the groundwater abstractions section
    • adjust folder structure according to NGMS display generator spreadsheet. level3 Default Scenarios
      • level4 All scenarios (Input Values)  => plot_QSRC_GW_ref_input => XXX_wells_all
      • level4 All scenarios (Abstraction Deficit: sim - inp)  => plot_QSRC_GW_ref_deficit => XXX_wells_parents_and_singles
      • level3 Modified Scenarios  
      • level4 Historic (Simulated and Comparison: whatif - ref)  => plot_QSRC_GW_whatif(Hist)_to_ref(Hist) => XXX_wells_all
      • level4 Recent Actual (Simulated and Comparison: whatif - ref)  => plot_QSRC_GW_whatif(RecAct)_to_ref(RecAct) => XXX_wells_all
      • ...
      • level4 All scenarios (Abstraction Deficit: sim - inp)  => plot_QSRC_GW_whatif_deficit => XXX_wells_parents_and_singles# adjust folder structure according to NGMS display generator spreadsheet.
  4. carry out changes in sheet 'DisplayGroups_plotdef' in the groundwater abstractions section => adjust / add plot definitions for gw abstractions:
      • plot_QSRC_GW_ref_all:
        • change id to plot_QSRC_GW_ref_input,
        • change MODINSTSET to 'ALL_INPUT'
      • add plot_QSRC_GW_ref_deficit
        • subplot type is 'tss_scalar_ref_deficit',
        • par_postfix is 'deficit',
        • MODINSTSET is 'ALL_DEFICIT'
      • add plot_QSRC_GW_whatif_deficit
        • subplot type is 'tss_scalar_whatif_deficit',
        • par_postfix is 'deficit',
        • MODINSTSET is 'ALL_DEFICIT'
      • plot_QSRC_GW_whatif(Scenario)_to_ref(Scenario)
        • change MODINSTSET of 1.subplot to 'ALL_INTERPOLATE'
        • change MODINSTSET of 2. subplot to 'ALL_compare'
      • check the module instance sets, location sets and subplot type !!
  5. run macros
    • write_GridDisplayXMLFiles
    • write_FiltersXMLFiles
    • write_DisplayGroupsXMLFiles
  6. check and validate the created files
  7. Copy the files which are OK to your configuration
    • GridDisplay.xml --> \Config\DisplayConfigFiles
    • Filters.xml  --> \Config\RegionConfigFiles
    • DisplayGroups.xml  --> \Config\SystemConfigFiles

Step 5: Add new module instance sets

add the following module instance sets to moduleinstancesets.xml (in Config/RegionConfigFiles) for all relevant scenarios and models

see also example file ModuleInstanceSets 2.06 default.xml

  1. ALL_INPUT_ref(Scenario)
    • Model_1_runMF_ref(Scenario)
    • Model_2_runMF_ref(Scenario)
    • ...
  2. ALL_INPUT_whatif(Scenario)
    • Model_1_runMF_whatif(Scenario)
    • Model_2_runMF_whatif(Scenario)
    • ...
  3. ALL_INTERPOLATE_ref(Scenario)
    • Model_1_interpolate_ref(Scenario)
    • Model_2_interpolate_ref(Scenario)
    • ...
  4. ALL_INTERPOLATE_ref(Scenario)
    • Model_1_interpolate_whatif(Scenario)
    • Model_2_interpolate_whatif(Scenario)
    • ...
  5. ALL_DEFICIT_ref(Historic)
    • Model_1_diff_sim_inp_ref(Scenario)
    • Model_2_diff_sim_inp_ref(Scenario)
    • ...
  6. ALL_DEFICIT_ref(Historic)
    • Model_1_diff_sim_inp_whatif(Scenario)
    • Model_2_diff_sim_inp_whatif(Scenario)
    • ...

Step 6: Add new module instance to Workflows

  1. add module instance "XXX_diff_sim_inp_ref(Scenario)' to the specific workflows XXX_ref(Scenario) after module instance interpolate
  2. add module instance "XXX_diff_sim_inp_whatif(Scenario)' to the specific workflows XXX_modified_Scenario after module instance interpolate

see example files WMW_modified_Historic 4.99 default.xml and WMW_ref(Historic) 4.99 default.xml

Step 7: Update LocationSets.xml

  1. add location set XXX_wells_parents_and_singles containing the two location sets XXX_wells_parents and XXX_wells_singles
  2. Make sure that the order of the location sets in location set XXX_wells_parents is as follows (otherwise the total for the super parents will not be displayed):
    1)  XXX_wells_normal_parents
    2)  XXX_wells_super_parents
  3. Make sure all locations which refer to super parents are childs or normal parents (no singles!)
  4. Make sure there are no child locations in the single location set !!!
  5. Make sure all single locations are listed in the single location set
  6. Skip for now  (this step is in progress) "Update locations spreadsheet"

Step 8: Check xxx_global.properties

  1. Make sure that the global properties include the following line: USE_CURRENT_SIMULATED_WITH_COLD_STATE_SELECTION=true

!SKIP THIS STEP!  Step 9 Update Id Mapping

  1. comment the shut down activity in the GA run out for all scenarios
  2. run the model
  3. check for each scenario if the id's in WMW_QSRC_GW_TimeSeries_MultiLayer.xml and WMW_QSRC_GW_TimeSeries.xml in the toNGMS modules folder are the same as listed in the idmapping (Config/IdMapFiles), especially check the ordering of layers in the name of the super / normal parents
  4. if the id's are not the same you have to update the id mapping (see also pages 'HOW TO add a new module' #Step 4.8. Obtain configuration data via Module Adapter and Go to #Step 5.9. IdMaps for GW abstraction), therefore
    • run the the xxx_prepare.but for each scenario-type in the modules directory
    • populate the location worksheets as follows
      • #**# copy the individual locations (id, x,y,z) as listed in XXX_GW_abstractions_Locations.xml  
        1. paste into column H,I,J,K (starting at row 3)
        2. copy the parent locations (id, x,y,z) as listed in XXX_GW_abstractions_Locations_MultiLayer.xml
        3. paste into column B,C,D,E (starting at row 3)
        4. check that the format of z coordinatecomment the shut down activity in the GA run ou
        5. Create a backup with name XXX_LocationsResults_versionnumber.xls
        6. Run the macro 'create_XMLfiles'
        7. The macro creates XML-files in the directory of the data-spreadshee
        8. The macro overwrites existing files
        9. You can skip location types to be generated
        10. Check the contents of the id map files. It might be wise to validate with an XML-validation tool.
        11. Copy the id map files which are OK to your configuration --> \Config\IdMapfiles
  5. enable the shut down activity in the GA run

Step 10 Update parameter file

As a new parameter has been introduced you have to update the parameter file, please copy the following file to your Config directory Config/RegionConfigFiles

Parameters 4.12 default.xml

Step 11 Carry out test run

After you have updated you configuration please carry out a test run (default and modified) and check if

  1. fews executes without errors
  2. you can see all results you expect in the displays, filters,..
  3. are some locations missing?
  4. are the results reasonable (sign, amount,...) ?
  • No labels

Disclaimer