rephrase DFN text, improve error messaging

Author: wpbonelli

doc/mf6io/mf6ivar/dfn/gwe-dis.dfn

@@ -233,6 +233,6 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
 
 

doc/mf6io/mf6ivar/dfn/gwe-disv.dfn

@@ -208,7 +208,7 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
 
 
 # --------------------- gwe disv vertices ---------------------

doc/mf6io/mf6ivar/dfn/gwf-dis.dfn

@@ -233,4 +233,4 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1 or greater, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1 or greater, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.

doc/mf6io/mf6ivar/dfn/gwf-disv.dfn

@@ -208,7 +208,7 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1 or greater, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1 or greater, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
 
 
 # --------------------- gwf disv vertices ---------------------

doc/mf6io/mf6ivar/dfn/gwt-dis.dfn

@@ -233,6 +233,6 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
 
 

doc/mf6io/mf6ivar/dfn/gwt-disv.dfn

@@ -208,7 +208,7 @@ layered true
 netcdf true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
 
 
 # --------------------- gwt disv vertices ---------------------

doc/mf6io/mf6ivar/dfn/prt-dis.dfn

@@ -224,6 +224,6 @@ reader readarray
 layered true
 optional true
 longname idomain existence array
-description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  If the IDOMAIN value for a cell is 1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not modify the top and bottom elevations of the neighboring cells above and below, which remain exactly as specified by TOP and BOTM.  To avoid leaving a gap in the grid, vertical pass-through cells should be assigned a negligible thickness (for example, zero); otherwise the cell below a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.
+description is an optional array that characterizes the existence status of a cell.  If the IDOMAIN array is not specified, then all model cells exist within the solution.  If the IDOMAIN value for a cell is 0, the cell does not exist in the simulation.  Input and output values will be read and written for the cell, but internal to the program, the cell is excluded from the solution.  The BOTM value specified for the cell is still used as the top elevation of the cell directly below it, so that lower cell must still be given a positive thickness.  If the IDOMAIN value for a cell is1, the cell exists in the simulation.  If the IDOMAIN value for a cell is -1, the cell does not exist in the simulation.  Furthermore, the first existing cell above will be connected to the first existing cell below.  This type of cell is referred to as a ``vertical pass through'' cell.  Note that this vertical pass-through connection does not alter cell geometry.  The top and bottom elevations of the existing cells above and below remain exactly as specified, and the BOTM value given for a pass-through cell is still used as the top elevation of the cell directly beneath it.  To avoid leaving a gap in the grid, a vertical pass-through cell should be given a negligible thickness by setting its BOTM equal to the bottom elevation of the cell directly above it (for a pass-through cell in the top layer, set its BOTM equal to TOP).  Otherwise the cell beneath a vertical pass-through cell may be assigned a nonpositive thickness, causing the program to terminate with an error.