API Reference

struct ModelConfig <: AbstractModelConfig

Generic data structure for a model configuration. This serves as :

• default concrete type for AbstractModelConfig
• keyword constructor for AbstractModelConfig

model :: Union{Function,String,Pkg.Types.PackageSpec} = "anonymous"
configuration :: Union{Function,String} = "anonymous"
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()

ModelConfig(func::Function,inputs::NamedTuple)

Simplified constructor for case when model is a Function.

struct PlutoConfig <: AbstractModelConfig

Generic data structure for a model configuration based on a Pluto notebook.

setup(x::AbstractModelConfig)

Defaults to default_ClimateModelSetup(x). Can be expected to be specialized for most concrete types of AbstractModelConfig

f=ClimateModels.RandomWalker
tmp=ModelConfig(model=f)
setup(tmp)

build(x)

Defaults to default_ClimateModelBuild(x). Can be expected to be specialized for most concrete types of AbstractModelConfig

using ClimateModels
tmp=ModelConfig(model=ClimateModels.RandomWalker)
setup(tmp)
build(tmp)

isa(tmp,AbstractModelConfig) # hide

launch(x)

Defaults to default_ClimateModelLaunch(x) which consists in take!(x) for AbstractModelConfig. Can be expected to be specialized for most concrete types of AbstractModelConfig

f=ClimateModels.RandomWalker
tmp=ModelConfig(model=f)
setup(tmp)
build(tmp)
launch(tmp)

log(x :: AbstractModelConfig)

Show the record of git commits that have taken place in the log folder.

log( x :: AbstractModelConfig, y :: String; fil="", msg="", prm=false)

Show or add a git commit to the log folder (i.e., joinpath(x,"log")).

1. If no keyword is provided then y should be a commit ID from log(x)

2. Keyword arguments are mutually exclusive (i.e., use only one at a time) and work like this:

• msg is a non empty String : commit msg to log/README.md with message y.
• fil is a non empty String : commit changes to file log/$(fil) with message y. If log/$(fil) is unknown to git (i.e. commit errors out) then try adding log/$(fil) first.
• prm is true : add files found in input or tracked_parameters/ (if any) to git log.

Example:

MC=run(ModelConfig(ClimateModels.RandomWalker,(NS=100,)))
MC.inputs[:NS]=200
msg="update tracked_parameters.toml (or skip if up to date)"
log(MC,msg,prm=true)
log(MC)

setup(MC::PlutoConfig)

Setup a folder for PlutoConfig and unroll the notebook.

• call default_ClimateModelSetup
• call unroll
• add notebook_launch to tasks

Optionally, a posprocessing command can be provided as shown below. In this example, results from CMIP6.jl will be moved to joinpath(MC,"run").

inputs=Dict(:postprocessing=>"mv(pathof(MC),to_PlutoConfig)")
MC=PlutoConfig(model="examples/CMIP6.jl",inputs=inputs)
run(MC)

update(MC::PlutoConfig)

Update notebook dependencies (via unroll & reroll) and replace initial notebook file.

update(PlutoConfig(model="examples/defaults.jl"))
run(PlutoConfig(model="examples/defaults.jl"))

open(MC::PlutoConfig))

Open notebook in web-browser via Pluto.

Important note: this assumes that the Pluto server is already running, e.g. from Pluto.run(), at URL pluto_url (by default, "http://localhost:1234/", should work on a laptop or desktop).

notebooks.open(PlutoConfig(model="examples/defaults.jl"))

ModelRun(x :: AbstractModelConfig)

Shorthand for x |> setup |> build |> launch

Returns AbstractModelConfig as output.

@ModelRun(func)

Macro equivalent for run(ModelConfig(model=func)).

pathof(x::AbstractModelConfig)

Returns the run directory path for x ; i.e. joinpath(x.folder,string(x.ID))

pathof(x::AbstractModelConfig,subfolder::String)

Same as pathof(joinpath(x,subfolder)) or joinpath(pathof(x),subfolder)

joinpath(x::AbstractModelConfig,y...)

Same as joinpath(pathof(x),y...)

cd(x::AbstractModelConfig)

Temporarily change the current working directory to x.folder.

readdir(x::AbstractModelConfig)

Same as readdir(pathof(x)).

readdir(x::AbstractModelConfig,subfolder...)

Same as readdir(joinpath(pathof(x),subfolder...)).

show(io::IO, z::AbstractModelConfig)

tmp=ModelConfig(model=ClimateModels.RandomWalker)
setup(tmp)
show(tmp)

clean(x :: AbstractModelConfig)

Cancel any remaining task (x.channel) and rm the run directory (pathof(x))

tmp=ModelConfig(model=ClimateModels.RandomWalker)
setup(tmp)
clean(tmp)

notebooks.list(file="")

List downloadable notebooks based on the JuliaClimate/Notebooks webpage or local copy (file).

Returns a DataFrame with columns folder, file, and url.

notebooks.download(path,nbs)

Download notebooks/files listed in nbs to path.

• If nbs.file[i] is found at nbs.url[i] then download it to path/nbs.folder[i].
• If a second file is found at nbs.url[i][1:end-3]*"_module.jl" then we download it too.

nbs=notebooks.list()
notebooks.download(tempdir(),nbs)

PkgDevConfig(url::String,func::Function,inputs::NamedTuple)

Simplified constructor for case when model is a url (PackageSpec).