Model Configurations

MITgcm_config()

Concrete type of AbstractModelConfig for MITgcm (as part of the ClimateModels.jl interface for MITgcm) which contains

    model :: String = "MITgcm"
    configuration :: String = ""
    inputs :: OrderedDict{Any,Any} = OrderedDict{Any,Any}()
    outputs :: OrderedDict{Any,Any} = OrderedDict{Any,Any}()
    channel :: Channel{Any} = Channel{Any}(10) 
    folder :: String = tempdir()
    ID :: UUID = UUIDs.uuid4()

and can be constructed using keywords as follows

unknown_config=MITgcm_config(configuration="unknown")

setup_ECCO4!(config::MITgcm_config)

Setup method for ECCO4 and OCCA2 solutions.

using MITgcm

params=read_toml(:ECCO4)
folder=joinpath(pwd(),"tmp1")

MC=MITgcm_config(inputs=params,folder=folder)

#providing executable (optional)
#push!(MC.inputs[:setup][:main],(:exe => joinpath(pwd(),"mitgcmuv")))

#providing input folder (optional)
#push!(MC.inputs[:setup][:main],(:input_folder => joinpath(pwd(),"input_folder")))

#modifying run time options (optional)
#MC.inputs[:pkg][:PACKAGES][:useECCO]=false

setup(MC)

#modifying build options (optional)
#MC.inputs[:setup][:build][:options]=MITgcm.build_options_pleiades

build(MC)

launch(MC)

download_input_folder(config::MITgcm_config)

get_files(list1::DataFrame,nam1::String,path1::String)

Create a list of Dataverse files from folder with specified name.

list1=ECCO4_inputs.get_list()
nam1="model initialization"
ECCO4_inputs.get_files(list1,nam1,tempname())

get_list(; write_file=false)

Create a list of Dataverse folders for ECCOv4r2. If write_file=true then write to file joinpath(tempdir(),"Dataverse_list.csv")/

get_list(list1::DataFrame,name::String)

Create a list of Dataverse files from folder with specified name.

list1=ECCO4_inputs.get_list()
nam1="surface forcing fields"
list2=ECCO4_inputs.get_list(list1,nam1)

compute(pth0)

@everywhere begin
 using MITgcm
 using ECCO4_testreport.SharedArrays
end

report=ECCO4_testreport.compute("run")

compare(A::DataFrame,B::DataFrame)

using ClimateModels.DataFrames, ClimateModels.CSV
ref_file="test/testreport_baseline2.csv"
ref=CSV.read(ref_file,DataFrame)

using MITgcm
ECCO4_testreport.compare(report,ref)

compare(A::DataFrame,B::DataFrame,v::AbstractString)

setup_verification!(config::MITgcm_config)

Setup method for verification experiments.

scan_verification(; path=MITgcm_path[2])

Scan the verification folder for

• experiments (list_main)
• adjoint experiments (list_adj)
• input folders (list_inp)
• reference results (list_out)

list_main,list_adj,list_inp,list_out=MITgcm.scan_verification()

config="exp4"
ii=findall(list_main.=="exp4")[1]
println.(list_inp[ii]);

inputs=Dict(:input_folder=>"input.with_flt")
MC=MITgcm_config(configuration=config,inputs=inputs)

verification_loop(ii=:)

Run verification experiments in a loop.

• to override the default MITgcm folder and use your own, set MITgcm_path[1:2]
• all 56 forward experiments should run to completion as expected.
• 10 experiments do not contain an input folder, and will be skipped.

list_skip=[ "tutorial_dic_adjoffline", "tutorial_global_oce_optim", "tutorial_tracer_adjsens" ,
            "flt_example", "global_oce_latlon", "global_with_exf",
            "bottom_ctrl_5x5", "cpl_aim+ocn","natl_box", "obcs_ctrl"]

verification_experiments()

Get list of all most-standard configurations of MITgcm and return as an Array of MITgcm_config

exps=verification_experiments()

verification_experiments(nam::String)

Get one configurations of MITgcm and return as a MITgcm_config

advect_xy=verification_experiments("advect_xy")

testreport(config::MITgcm_config,ext="")

Run the testreport script for one model config, with additional options specified in ext if needed.

using MITgcm
testreport(MITgcm_config(configuration="front_relax"))
#testreport(MITgcm_config(configuration="front_relax"),"-norun")