from compass.model import run_model
from compass.step import Step
[docs]class Forward(Step):
"""
A step for performing forward MPAS-Ocean runs as part of drying slope
test cases.
"""
[docs] def __init__(self, test_case, resolution, name='forward', subdir=None,
ntasks=1, min_tasks=None, openmp_threads=1,
damping_coeff=None, coord_type='sigma'):
"""
Create a new test case
Parameters
----------
test_case : compass.TestCase
The test case this step belongs to
resolution : float
The resolution of the test case
name : str
the name of the test case
subdir : str, optional
the subdirectory for the step. The default is ``name``
ntasks : int, optional
the number of tasks the step would ideally use. If fewer tasks
are available on the system, the step will run on all available
tasks as long as this is not below ``min_tasks``
min_tasks : int, optional
the number of tasks the step requires. If the system has fewer
than this number of tasks, the step will fail
openmp_threads : int, optional
the number of OpenMP threads the step will use
damping_coeff: float, optional
the value of the rayleigh damping coefficient
"""
if min_tasks is None:
min_tasks = ntasks
if damping_coeff is not None:
name = f'{name}_{damping_coeff}'
super().__init__(test_case=test_case, name=name, subdir=subdir,
ntasks=ntasks, min_tasks=min_tasks,
openmp_threads=openmp_threads)
self.add_namelist_file('compass.ocean.tests.drying_slope',
'namelist.forward')
if resolution < 1.:
res_name = f'{int(resolution*1e3)}m'
else:
res_name = f'{int(resolution)}km'
self.add_namelist_file('compass.ocean.tests.drying_slope',
f'namelist.{res_name}.forward')
self.add_namelist_file('compass.ocean.tests.drying_slope',
f'namelist.{coord_type}.forward')
if damping_coeff is not None:
# update the Rayleigh damping coeff to the requested value
options = {'config_Rayleigh_damping_coeff': f'{damping_coeff}'}
self.add_namelist_options(options)
self.add_streams_file('compass.ocean.tests.drying_slope',
'streams.forward')
input_path = '../initial_state'
self.add_input_file(filename='mesh.nc',
target=f'{input_path}/culled_mesh.nc')
self.add_input_file(filename='init.nc',
target=f'{input_path}/ocean.nc')
self.add_input_file(filename='forcing.nc',
target=f'{input_path}/init_mode_forcing_data.nc')
self.add_input_file(filename='graph.info',
target=f'{input_path}/culled_graph.info')
self.add_model_as_input()
self.add_output_file(filename='output.nc')
# no setup() is needed
[docs] def run(self):
"""
Run this step of the test case
"""
run_model(self)