Issues and tips

• Compilation issues

• Run time issues

• Stable Atlantis versions

• How to edit nc files

• Podman tips

Some common issues we've encountered during compilation or run time and how they were resolved

Compilation

preRules.am file

You may need to add:

> WARN += -Wno-error=pointer-bool-conversion

This prevents warnings associated with converting pointers to boolean from halting compilation

> WARN += -Wno-error=misleading-indentation

This prevents warnings associated with improper indentation (Due to stricter rules as newer versions of gcc are used) from halting compilation

> WARN += -Wno-nullability-completeness
> WARN += -Wno-error=unused-but-set-variable
> WARN += -Wno-error=implicit-function-declaration

Run time

• Updates in the atlantis code base often contain additional parameters in the prm files. Errors at run time will often inform you which parameter(s) are missing from which prm file(s). Often adding the parameter with a default value = 0 will be sufficient.

• /bin/sh: 1: ./RunAtlantis.sh: not found - often due to having a windows end of line (EOL) format (CR LF). Convert to Linux EOF (LF) using notepad++ (Edit -> EOL Conversions -> Unix (LF)).

• /bin/sh: 1: ./RunAtlantis.sh: Permission denied - often due to the file not being executable. This can happen if copied from a windows machine to a Linux server. chmod 774 RunAtlantis.sh should make it executable to you and your group

• Util_Read_Functional_Group_XML: you have MAK as fished but not impacted, set impacted to 1 for this group to continue please - ???

Stable versions

Only some versions of the code base can be compiled or run. We have had success with the following versions. While getting the model to compile is a good first step. Getting it to run for different versions of the code base using the same parameter files can be challenging since the models requirements for inputs changes over time.

• 6536
• 6580 (Wont run with migration turned on for NEUS model)
• 6599 (Wont run with migration turned on for NEUS model. Requires minor changes to configure.ac file)
• 6626
• 6631
• 6645 (requires changes to nc file)

How to edit nc files

Atlantis manual chapter 2.7 describes how to edit nc files using two functions, ncdump and ncgen, from the NetCDF libraries.

To edit an nc file called neus-init.nc, navigate to directory (using powershell) where nc file lives:

ncdump neus-init.nc > neus-init.cdf

This creates a file called neus-init.cdf which can be edited in any text editor. Make any changes needed.

When finished, save the cdf file and then convert it back to an nc file using ncgen

ncgen -b -o neus-init.nc neus-init.cdf

If you receive a message Input file contains a BOM indicating a non-UTF8 encoding you will need to encode the file prior to saving. To do this:

• Open notepad+
• Select Encoding -> Convert to UTF-8
• Save

Podman tips

• To run multiple containers with each container dedicated to its own core

  podman run --cpuset-cpus=X

where X is the core number