Skip to content

Commit

Permalink
add new error to common runtime errors table
Browse files Browse the repository at this point in the history
  • Loading branch information
peverwhee committed Aug 28, 2024
1 parent c4f2fb3 commit c466dca
Showing 1 changed file with 1 addition and 0 deletions.
1 change: 1 addition & 0 deletions docs/conversion/run-cam-sima.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ debug_output = 0 !Turns off debug messages which interfere with the validation
|`ERROR: cam_get_file: FAILED to get UNSET_PATH` | No initial data file specified (or defaulted to) | Specify `ncdata = '<file>'` in your user_nl_cam file |
|`ERROR: read_field_3d: No variable foun din (/XXX, /)` | Variable not found when we're reading in the initial data or snapshot file | <ul><li>Double-check your standard name</li><li>Determine if CAM-SIMA needs to handle/initialize the variable. If it does, follow the procedure for the error below</li></ul> |
|`ERROR: Cannot read XXX from file, XXX has no horizontal dimension` | Variable is a scalar; we don't have an interface to read it in from a file (and it's not likely to be present on the file) | <ul><li>If "XXX" is static during the run, add `access="protected"` to the variable's XML entry in the registry</li><li>if the variable is not static, either:<ul><li>Initialize the variable in the init phase of your scheme (`intent=out`), or</li><li>initialize "XXX" in CAM-SIMA (NOT in the physics code) and add a call to `mark_as_initialized(<standard_name>)` so CAM-SIMA doesn't try to read in the variable</li></li></ul></ul> |
|`ERROR in '<path/to/cesm.exe>': corrupted size vs. prev_size: 0xXXXXXXXXXXXXXX` | Possibly an out of bounds error | <ul><li>Find the line that the stack trace is pointing to (likely in the generated code) and trace the variable in question, looking for out-of-bounds errors<ul><li>Specifically, check that the variable has the **correct dimensions** in the metadata (e.g. vertical_layer_dimension vs vertical_interface_dimension)</li></ul></li><li>Also, check the variables immediately before and after the line for out-of-bounds errors (we have seen this error reported on the line immediately before the problem line).</li><li>Try running in DEBUG mode if not already to include bounds checking</li></ul> |

- Once the model completes without error, the results from the validation tool will appear in the `atm_log` file for each timestep (under the header ` ********** Physics Check Data Results **********`)
- The message `No differences found!` should be logged for each timestep.
Expand Down

0 comments on commit c466dca

Please sign in to comment.