Mads.jl
MADS (Model Analysis & Decision Support)
Mads.jl is MADS main module.
Mads.jl module functions:
#
Mads.MFlm
— Method.
Matrix Factorization using Levenberg Marquardt
Methods
Mads.MFlm(X::Array{T,2}, range::Range{Int64}; kw...) where T in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsBSS.jl:103Mads.MFlm(X::Array{T,2}, nk::Integer; method, log_W, log_H, retries, initW, initH, tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_mu, np_lambda, show_trace, quiet) where T in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsBSS.jl:133
Arguments
X::Array{T,2}
: matrix to factorizenk::Integer
: number of features to extractrange::Range{Int64}
Keywords
initH
: initial H (feature) matrixinitW
: initial W (weight) matrixlambda
lambda_mu
log_H
: log-transform H (feature) matrix[default=false
]log_W
: log-transform W (weight) matrix [default=false
]maxEval
maxIter
maxJacobians
method
np_lambda
quiet
retries
: number of solution retries [default=1
]show_trace
tolG
tolOF
tolX
Returns:
- NMF results
#
Mads.NMFipopt
— Function.
Non-negative Matrix Factorization using JuMP/Ipopt
Methods
Mads.NMFipopt(X::Array{T,2} where T, nk::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsBSS.jl:61Mads.NMFipopt(X::Array{T,2} where T, nk::Integer, retries::Integer; random, maxiter, maxguess, initW, initH, verbosity, quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsBSS.jl:61
Arguments
X::Array{T,2} where T
: matrix to factorizenk::Integer
: number of features to extractretries::Integer
: number of solution retries [default=1
]
Keywords
initH
: initial H (feature) matrixinitW
: initial W (weight) matrixmaxguess
: guess about the maximum for the H (feature) matrix [default=1
]maxiter
: maximum number of iterations [default=100000
]quiet
: quiet [default=false
]random
: random initial guesses [default=false
]verbosity
: verbosity output level [default=0
]
Returns:
- NMF results
#
Mads.NMFm
— Method.
Non-negative Matrix Factorization using NMF
Methods
Mads.NMFm(X::Array, nk::Integer; retries, tol, maxiter) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsBSS.jl:22
Arguments
X::Array
: matrix to factorizenk::Integer
: number of features to extract
Keywords
maxiter
: maximum number of iterations [default=10000
]retries
: number of solution retries [default=1
]tol
: solution tolerance [default=1.0e-9
]
Returns:
- NMF results
#
Mads.addkeyword!
— Function.
Add a keyword
in a class
within the Mads dictionary madsdata
Methods
Mads.addkeyword!(madsdata::Associative, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:249Mads.addkeyword!(madsdata::Associative, class::String, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:253
Arguments
class::String
: dictionary class; if not provided searches forkeyword
inProblem
classkeyword::String
: dictionary keymadsdata::Associative
: MADS problem dictionary
#
Mads.addsource!
— Function.
Add an additional contamination source
Methods
Mads.addsource!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:19Mads.addsource!(madsdata::Associative, sourceid::Int64; dict) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:19
Arguments
madsdata::Associative
: MADS problem dictionarysourceid::Int64
: source id [default=0
]
Keywords
dict
#
Mads.addsourceparameters!
— Method.
Add contaminant source parameters
Methods
Mads.addsourceparameters!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:76
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.allwellsoff!
— Method.
Turn off all the wells in the MADS problem dictionary
Methods
Mads.allwellsoff!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:607
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.allwellson!
— Method.
Turn on all the wells in the MADS problem dictionary
Methods
Mads.allwellson!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:549
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.amanzi
— Function.
Execute Amanzi external groundwater flow and transport simulator
Methods
Mads.amanzi(filename::String, nproc::Int64, quiet::Bool, observation_filename::String, setup::String; amanzi_exe) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsSimulators.jl:15Mads.amanzi(filename::String, nproc::Int64, quiet::Bool, observation_filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsSimulators.jl:15Mads.amanzi(filename::String, nproc::Int64, quiet::Bool) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsSimulators.jl:15Mads.amanzi(filename::String, nproc::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsSimulators.jl:15Mads.amanzi(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsSimulators.jl:15
Arguments
filename::String
: amanzi input file namenproc::Int64
: number of processor to be used by Amanzi [default=Mads.nprocs_per_task_default
]observation_filename::String
: Amanzi observation file name [default="observations.out"
]quiet::Bool
: suppress output [default=Mads.quiet
]setup::String
: bash script to setup Amanzi environmental variables [default="source-amanzi-setup"
]
Keywords
amanzi_exe
: full path to the Amanzi executable
#
Mads.amanzi_output_parser
— Function.
Parse Amanzi output provided in an external file (filename
)
Methods
Mads.amanzi_output_parser(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsParsers.jl:22Mads.amanzi_output_parser() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-external/MadsParsers.jl:22
Arguments
filename::String
: external file name [default="observations.out"
]
Returns:
- dictionary with model observations following MADS requirements
Example:
Mads.amanzi_output_parser() Mads.amanzi_output_parser("observations.out")
#
Mads.asinetransform
— Function.
Arcsine transformation of model parameters
Methods
Mads.asinetransform(madsdata::Associative, params::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:4Mads.asinetransform(params::Array{T,1} where T, lowerbounds::Array{T,1} where T, upperbounds::Array{T,1} where T, indexlogtransformed::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:14
Arguments
indexlogtransformed::Array{T,1} where T
: index vector of log-transformed parameterslowerbounds::Array{T,1} where T
: lower boundsmadsdata::Associative
: MADS problem dictionaryparams::Array{T,1} where T
: model parametersupperbounds::Array{T,1} where T
: upper bounds
Returns:
- Arcsine transformation of model parameters
#
Mads.bayessampling
— Function.
Bayesian Sampling
Methods
Mads.bayessampling(madsdata::Associative; nsteps, burnin, thinning, seed) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:78Mads.bayessampling(madsdata::Associative, numsequences::Integer; nsteps, burnin, thinning, seed) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:99
Arguments
madsdata::Associative
: MADS problem dictionarynumsequences::Integer
: number of sequences executed in parallel
Keywords
burnin
: number of initial realizations before the MCMC are recorded [default=100
]nsteps
: number of final realizations in the chain [default=1000
]seed
: random seed [default=0
]thinning
: removal of anythinning
realization [default=1
]
Returns:
- MCMC chain
Examples:
Mads.bayessampling(madsdata; nsteps=1000, burnin=100, thinning=1, seed=2016) Mads.bayessampling(madsdata, numsequences; nsteps=1000, burnin=100, thinning=1, seed=2016)
#
Mads.calibrate
— Method.
Calibrate Mads model using a constrained Levenberg-Marquardt technique
Mads.calibrate(madsdata; tolX=1e-3, tolG=1e-6, maxEval=1000, maxIter=100, maxJacobians=100, lambda=100.0, lambda_mu=10.0, np_lambda=10, show_trace=false, usenaive=false)
Methods
Mads.calibrate(madsdata::Associative; tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_mu, np_lambda, show_trace, usenaive, save_results, localsa) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:162
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
lambda
: initial Levenberg-Marquardt lambda [default=100.0
]lambda_mu
: lambda multiplication factor [default=10.0
]localsa
: perform local sensitivity analysis [default=false
]maxEval
: maximum number of model evaluations [default=1000
]maxIter
: maximum number of optimization iterations [default=100
]maxJacobians
: maximum number of Jacobian solves [default=100
]np_lambda
: number of parallel lambda solves [default=10
]save_results
: save intermediate results [default=true
]show_trace
: shows solution trace [default=false
]tolG
: parameter space update tolerance [default=1e-6
]tolOF
: objective function tolerance [default=1e-3
]tolX
: parameter space tolerance [default=1e-4
]usenaive
: use naive Levenberg-Marquardt solver [default=false
]
Returns:
- model parameter dictionary with the optimal values at the minimum
- optimization algorithm results (e.g. results.minimizer)
#
Mads.calibraterandom
— Function.
Calibrate with random initial guesses
Methods
Mads.calibraterandom(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:39Mads.calibraterandom(madsdata::Associative, numberofsamples::Integer; tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_mu, np_lambda, show_trace, usenaive, seed, quiet, all, save_results) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:39
Arguments
madsdata::Associative
: MADS problem dictionarynumberofsamples::Integer
: number of random initial samples [default=1
]
Keywords
all
: all model results are returned [default=false
]lambda
: initial Levenberg-Marquardt lambda [default=100.0
]lambda_mu
: lambda multiplication factor [default=10.0
]maxEval
: maximum number of model evaluations [default=1000
]maxIter
: maximum number of optimization iterations [default=100
]maxJacobians
: maximum number of Jacobian solves [default=100
]np_lambda
: number of parallel lambda solves [default=10
]quiet
: [default=true
]save_results
: save intermediate results [default=true
]seed
: random seed [default=0
]show_trace
: shows solution trace [default=false
]tolG
: parameter space update tolerance [default=1e-6
]tolOF
: objective function tolerance [default=1e-3
]tolX
: parameter space tolerance [default=1e-4
]usenaive
: use naive Levenberg-Marquardt solver [default=false
]
Returns:
- model parameter dictionary with the optimal values at the minimum
- optimization algorithm results (e.g. bestresult[2].minimizer)
Example:
Mads.calibraterandom(madsdata; tolX=1e-3, tolG=1e-6, maxEval=1000, maxIter=100, maxJacobians=100, lambda=100.0, lambda_mu=10.0, np_lambda=10, show_trace=false, usenaive=false) Mads.calibraterandom(madsdata, numberofsamples; tolX=1e-3, tolG=1e-6, maxEval=1000, maxIter=100, maxJacobians=100, lambda=100.0, lambda_mu=10.0, np_lambda=10, show_trace=false, usenaive=false)
#
Mads.calibraterandom_parallel
— Function.
Calibrate with random initial guesses in parallel
Methods
Mads.calibraterandom_parallel(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:106Mads.calibraterandom_parallel(madsdata::Associative, numberofsamples::Integer; tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_mu, np_lambda, show_trace, usenaive, seed, quiet, save_results, localsa) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:106
Arguments
madsdata::Associative
: MADS problem dictionarynumberofsamples::Integer
: number of random initial samples [default=1
]
Keywords
lambda
: initial Levenberg-Marquardt lambda [default=100.0
]lambda_mu
: lambda multiplication factor [default=10.0
]localsa
: perform local sensitivity analysis [default=false
]maxEval
: maximum number of model evaluations [default=1000
]maxIter
: maximum number of optimization iterations [default=100
]maxJacobians
: maximum number of Jacobian solves [default=100
]np_lambda
: number of parallel lambda solves [default=10
]quiet
: suppress output [default=true
]save_results
: save intermediate results [default=true
]seed
: random seed [default=0
]show_trace
: shows solution trace [default=false
]tolG
: parameter space update tolerance [default=1e-6
]tolOF
: objective function tolerance [default=1e-3
]tolX
: parameter space tolerance [default=1e-4
]usenaive
: use naive Levenberg-Marquardt solver [default=false
]
Returns:
- vector with all objective function values
- boolean vector (converged/not converged)
- array with estimate model parameters
#
Mads.captureoff
— Method.
Make MADS not capture
Methods
Mads.captureoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:114
#
Mads.captureon
— Method.
Make MADS capture
Methods
Mads.captureon() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:105
#
Mads.checkmodeloutputdirs
— Method.
Check the directories where model outputs should be saved for MADS
Methods
Mads.checkmodeloutputdirs(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:599
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- true or false
#
Mads.checknodedir
— Function.
Check if a directory is readable
Methods
Mads.checknodedir(dir::String, waittime::Float64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:13Mads.checknodedir(dir::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:13Mads.checknodedir(node::String, dir::String, waittime::Float64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:4Mads.checknodedir(node::String, dir::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:4
Arguments
dir::String
: directorynode::String
: computational node name (e.g.madsmax.lanl.gov
,wf03
, or127.0.0.1
)waittime::Float64
: wait time in seconds [default=10
]
Returns:
true
if the directory is readable,false
otherwise
#
Mads.checkout
— Function.
Checkout (pull) the latest version of Mads modules
Methods
Mads.checkout(modulename::String; git, master, force, pull, required, all) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:79Mads.checkout() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:79
Arguments
modulename::String
: module name
Keywords
all
: whether to checkout all the modules [default=false
]force
: whether to overwrite local changes when checkout [default=false
]git
: whether to use "git checkout" [default=true
]master
: whether on master branch [default=false
]pull
: whether to run "git pull" [default=true
]required
: whether only checkout Mads.required modules [default=false
]
#
Mads.checkparameterranges
— Method.
Check parameter ranges for model parameters
Methods
Mads.checkparameterranges(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:709
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.cleancoverage
— Method.
Remove Mads coverage files
Methods
Mads.cleancoverage() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:24
#
Mads.cmadsins_obs
— Method.
Call C MADS ins_obs() function from MADS dynamic library
Methods
Mads.cmadsins_obs(obsid::Array{T,1} where T, instructionfilename::String, inputfilename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-old/MadsCMads.jl:40
Arguments
inputfilename::String
: input file nameinstructionfilename::String
: instruction file nameobsid::Array{T,1} where T
: observation id
Return:
- observations
#
Mads.commit
— Function.
Commit the latest version of Mads modules in the repository
Methods
Mads.commit(commitmsg::String, modulename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:227Mads.commit(commitmsg::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:227
Arguments
commitmsg::String
: commit messagemodulename::String
: module name
#
Mads.computemass
— Function.
Compute injected/reduced contaminant mass (for a given set of mads input files when "path" is provided)
Methods
Mads.computemass(madsdata::Associative; time) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:459Mads.computemass(madsfiles::Union{Regex, String}; time, path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:486
Arguments
String}
madsdata::Associative
: MADS problem dictionarymadsfiles::Union{Regex
: matching pattern for Mads input files (string or regular expression accepted)
Keywords
path
: search directory for the mads input files [default="."
]time
: computational time [default=0
]
Returns:
- array with all the lambda values
- array with associated total injected mass
- array with associated total reduced mass
Example:
Mads.computemass(madsfiles; time=0, path=".")
#
Mads.computeparametersensitities
— Method.
Compute sensitivities for each model parameter; averaging the sensitivity indices over the entire observation range
Methods
Mads.computeparametersensitities(madsdata::Associative, saresults::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:842
Arguments
madsdata::Associative
: MADS problem dictionarysaresults::Associative
: dictionary with sensitivity analysis results
#
Mads.contamination
— Method.
Compute concentration for a point in space and time (x,y,z,t)
Methods
Mads.contamination(wellx::Number, welly::Number, wellz::Number, n::Number, lambda::Number, theta::Number, vx::Number, vy::Number, vz::Number, ax::Number, ay::Number, az::Number, H::Number, x::Number, y::Number, z::Number, dx::Number, dy::Number, dz::Number, f::Number, t0::Number, t1::Number, t::Array{T,1} where T, anasolfunction::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:429
Arguments
H::Number
: Hurst coefficient for Fractional Brownian dispersionanasolfunction::Function
ax::Number
: dispersivity in X direction (longitudinal)ay::Number
: dispersivity in Y direction (transverse horizontal)az::Number
: dispersivity in Y direction (transverse vertical)dx::Number
: source size (extent) in X directiondy::Number
: source size (extent) in Y directiondz::Number
: source size (extent) in Z directionf::Number
: source mass fluxlambda::Number
: first-order reaction raten::Number
: porosityt0::Number
: source starting timet1::Number
: source termination timet::Array{T,1} where T
: vector of times to compute concentration at the observation pointtheta::Number
: groundwater flow directionvx::Number
: advective transport velocity in X directionvy::Number
: advective transport velocity in Y directionvz::Number
: advective transport velocity in Z directionwellx::Number
: observation point (well) X coordinatewelly::Number
: observation point (well) Y coordinatewellz::Number
: observation point (well) Z coordinatex::Number
: X coordinate of contaminant source locationy::Number
: Y coordinate of contaminant source locationz::Number
: Z coordinate of contaminant source location
Returns:
- a vector of predicted concentration at (wellx, welly, wellz, t)
#
Mads.copyaquifer2sourceparameters!
— Method.
Copy aquifer parameters to become contaminant source parameters
Methods
Mads.copyaquifer2sourceparameters!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:115
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.copyright
— Method.
Produce MADS copyright information
Methods
Mads.copyright() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:18
#
Mads.create_documentation
— Method.
Create web documentation files for Mads functions
Methods
Mads.create_documentation() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:382
#
Mads.create_tests_off
— Method.
Turn off the generation of MADS tests (default)
Methods
Mads.create_tests_off() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:150
#
Mads.create_tests_on
— Method.
Turn on the generation of MADS tests (dangerous)
Methods
Mads.create_tests_on() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:141
#
Mads.createmadsobservations
— Function.
Create Mads dictionary of observations and instruction file
Methods
Mads.createmadsobservations(nrow::Int64, ncol::Int64; obstring, pretext, prestring, poststring, filename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:108Mads.createmadsobservations(nrow::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:108
Arguments
ncol::Int64
: number of columns [default 1]nrow::Int64
: number of rows
Keywords
filename
: file nameobstring
: observation stringpoststring
: post instruction file stringprestring
: pre instruction file stringpretext
: preamble instructions
)
Returns:
- observation dictionary
#
Mads.createmadsproblem
— Function.
Create a new Mads problem where the observation targets are computed based on the model predictions
Methods
Mads.createmadsproblem(infilename::String, outfilename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:26Mads.createmadsproblem(madsdata::Associative, outfilename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:51Mads.createmadsproblem(madsdata::Associative, predictions::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:60Mads.createmadsproblem(madsdata::Associative, predictions::Associative, outfilename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:56
Arguments
infilename::String
: input Mads filemadsdata::Associative
: MADS problem dictionaryoutfilename::String
: output Mads filepredictions::Associative
: dictionary of model predictions
Returns:
- new MADS problem dictionary
#
Mads.createobservations!
— Function.
Create observations in the MADS problem dictionary based on time
and observation
vectors
Methods
Mads.createobservations!(madsdata::Associative, time::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:444Mads.createobservations!(madsdata::Associative, time::Array{T,1} where T, observation::Array{T,1} where T; logtransform, weight_type, weight) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:444Mads.createobservations!(madsdata::Associative, observation::Associative; logtransform, weight_type, weight) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:488
Arguments
madsdata::Associative
: MADS problem dictionaryobservation::Array{T,1} where T
: dictionary of observationsobservation::Associative
: dictionary of observationstime::Array{T,1} where T
: vector of observation times
Keywords
logtransform
: log transform observations [default=false
]weight
: weight value [default=1
]weight_type
: weight type [default=constant
]
#
Mads.createtempdir
— Method.
Create temporary directory
Methods
Mads.createtempdir(tempdirname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1226
Arguments
tempdirname::String
: temporary directory name
#
Mads.deleteNaN!
— Method.
Delete rows with NaN in a dataframe df
Methods
Mads.deleteNaN!(df::DataFrames.DataFrame) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:1068
Arguments
df::DataFrames.DataFrame
: dataframe
#
Mads.deletekeyword!
— Function.
Delete a keyword
in a class
within the Mads dictionary madsdata
Methods
Mads.deletekeyword!(madsdata::Associative, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:276Mads.deletekeyword!(madsdata::Associative, class::String, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:282
Arguments
class::String
: dictionary class; if not provided searches forkeyword
inProblem
classkeyword::String
: dictionary keymadsdata::Associative
: MADS problem dictionary
#
Mads.deleteoffwells!
— Method.
Delete all wells marked as being off in the MADS problem dictionary
Methods
Mads.welloff!(madsdata::Associative, wellname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:621
Arguments
madsdata::Associative
: MADS problem dictionarywellname::String
: name of the well to be turned off
#
Mads.deletetimes!
— Method.
Delete all times in the MADS problem dictionary in a given list.
Methods
Mads.welloff!(madsdata::Associative, wellname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:621
Arguments
madsdata::Associative
: MADS problem dictionarywellname::String
: name of the well to be turned off
#
Mads.dependents
— Function.
Lists module dependents on a module (Mads by default)
Methods
Mads.dependents(modulename::String, filter::Bool) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:43Mads.dependents(modulename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:43Mads.dependents() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:43
Arguments
filter::Bool
: whether to filter modules [default=false
]modulename::String
: module name [default="Mads"
]
Returns:
- modules that are dependents of the input module
#
Mads.diff
— Function.
Diff the latest version of Mads modules in the repository
Methods
Mads.diff(modulename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:170Mads.diff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:170
Arguments
modulename::String
: module name
#
Mads.display
— Function.
Display image file
Methods
Mads.display(p::Compose.Context) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsDisplay.jl:71Mads.display(p::Gadfly.Plot) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsDisplay.jl:65Mads.display(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsDisplay.jl:8
Arguments
filename::String
: image file namep::Compose.Context
: plotting objectp::Gadfly.Plot
: plotting object
#
Mads.dobigdt
— Method.
Perform Bayesian Information Gap Decision Theory (BIG-DT) analysis
Methods
Mads.dobigdt(madsdata::Associative, nummodelruns::Int64; numhorizons, maxHorizon, numlikelihoods) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsBayesInfoGap.jl:123
Arguments
madsdata::Associative
: MADS problem dictionarynummodelruns::Int64
: number of model runs
Keywords
maxHorizon
: maximum info-gap horizons of uncertainty [default=3
]numhorizons
: number of info-gap horizons of uncertainty [default=100
]numlikelihoods
: number of Bayesian likelihoods [default=25
]
Returns:
- dictionary with BIG-DT results
#
Mads.dumpasciifile
— Method.
Dump ASCII file
Methods
Mads.dumpasciifile(filename::String, data) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsASCII.jl:30
Arguments
data
: data to dumpfilename::String
: ASCII file name
Dumps:
- ASCII file with the name in "filename"
#
Mads.dumpjsonfile
— Method.
Dump a JSON file
Methods
Mads.dumpjsonfile(filename::String, data) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsJSON.jl:38
Arguments
data
: data to dumpfilename::String
: JSON file name
Dumps:
- JSON file with the name in "filename"
#
Mads.dumpwelldata
— Method.
Dump well data from MADS problem dictionary into a ASCII file
Methods
Mads.dumpwelldata(madsdata::Associative, filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1092
Arguments
filename::String
: output file namemadsdata::Associative
: MADS problem dictionary
Dumps:
filename
: a ASCII file
#
Mads.dumpyamlfile
— Method.
Dump YAML file
Methods
Mads.dumpyamlfile(filename::String, data; julia) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsYAML.jl:55
Arguments
data
: YAML datafilename::String
: output file name
Keywords
julia
: iftrue
, usejulia
YAML library (if available); iffalse
(default), usepython
YAML library (if available)
#
Mads.dumpyamlmadsfile
— Method.
Dump YAML Mads file
Methods
Mads.dumpyamlmadsfile(madsdata::Associative, filename::String; julia) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsYAML.jl:74
Arguments
filename::String
: output file namemadsdata::Associative
: MADS problem dictionary
Keywords
julia
: use julia YAML [default=false
]
#
Mads.efast
— Method.
Sensitivity analysis using Saltelli's extended Fourier Amplitude Sensitivity Testing (eFAST) method
Methods
Mads.efast(md::Associative; N, M, gamma, seed, checkpointfrequency, restartdir, restart) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:1111
Arguments
md::Associative
: MADS problem dictionary
Keywords
M
: maximum number of harmonics [default=6
]N
: number of samples [default=100
]checkpointfrequency
: check point frequency [default=N
]gamma
: multiplication factor (Saltelli 1999 recommends gamma = 2 or 4) [default=4
]restart
: save restart information [default=false
]restartdir
: directory where files will be stored containing model results for the efast simulation restarts [default="efastcheckpoints"
]seed
: random seed [default=0
]
#
Mads.emceesampling
— Function.
Bayesian sampling with Goodman & Weare's Affine Invariant Markov chain Monte Carlo (MCMC) Ensemble sampler (aka Emcee)
Methods
Mads.emceesampling(madsdata::Associative; numwalkers, nsteps, burnin, thinning, sigma, seed, weightfactor) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:9Mads.emceesampling(madsdata::Associative, p0::Array; numwalkers, nsteps, burnin, thinning, seed, weightfactor) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:32
Arguments
madsdata::Associative
: MADS problem dictionaryp0::Array
: initial parameters (matrix of size (number of parameters, number of walkers) or (length(Mads.getoptparamkeys(madsdata)), numwalkers))
Keywords
burnin
: number of initial realizations before the MCMC are recorded [default=10
]nsteps
: number of final realizations in the chain [default=100
]numwalkers
: number of walkers (if in parallel this can be the number of available processors; in general, the higher the number of walkers, the better the results and computational time [default=10
]seed
: random seed [default=0
]sigma
: a standard deviation parameter used to initialize the walkers [default=0.01
]thinning
: removal of anythinning
realization [default=1
]weightfactor
: weight factor [default=1.0
]
Returns:
- MCMC chain
- log likelihoods of the final samples in the chain
Examples:
Mads.emceesampling(madsdata; numwalkers=10, nsteps=100, burnin=100, thinning=1, seed=2016, sigma=0.01) Mads.emceesampling(madsdata, p0; numwalkers=10, nsteps=100, burnin=10, thinning=1, seed=2016)
#
Mads.estimationerror
— Function.
Estimate kriging error
Methods
Mads.estimationerror(w::Array{T,1} where T, x0::Array{T,1} where T, X::Array{T,2} where T, cov::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:197Mads.estimationerror(w::Array{T,1} where T, covmat::Array{T,2} where T, covvec::Array{T,1} where T, cov0::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:204
Arguments
X::Array{T,2} where T
: observation matrixcov0::Number
: zero-separation covariancecov::Function
: spatial covariance functioncovmat::Array{T,2} where T
: covariance matrixcovvec::Array{T,1} where T
: covariance vectorw::Array{T,1} where T
: kriging weightsx0::Array{T,1} where T
: estimated locations
Returns:
- estimation kriging error
#
Mads.evaluatemadsexpression
— Method.
Evaluate an expression string based on a parameter dictionary
Methods
Mads.evaluatemadsexpression(expressionstring::String, parameters::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:154
Arguments
expressionstring::String
: expression stringparameters::Associative
: parameter dictionary applied to evaluate the expression string
Returns:
- dictionary containing the expression names as keys, and the values of the expression as values
#
Mads.evaluatemadsexpressions
— Method.
Evaluate all the expressions in the Mads problem dictiorany based on a parameter dictionary
Methods
Mads.evaluatemadsexpressions(madsdata::Associative, parameters::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:173
Arguments
madsdata::Associative
: MADS problem dictionaryparameters::Associative
: parameter dictionary applied to evaluate the expression strings
Returns:
- dictionary containing the parameter and expression names as keys, and the values of the expression as values
#
Mads.expcov
— Method.
Exponential spatial covariance function
Methods
Mads.expcov(h::Number, maxcov::Number, scale::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:29
Arguments
h::Number
: separation distancemaxcov::Number
: maximum covariancescale::Number
: scale
Returns:
- covariance
#
Mads.exponentialvariogram
— Method.
Exponential variogram
Methods
Mads.exponentialvariogram(h::Number, sill::Number, range::Number, nugget::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:82
Arguments
h::Number
: separation distancenugget::Number
: nuggetrange::Number
: rangesill::Number
: sill
Returns:
- Exponential variogram
#
Mads.filterkeys
— Function.
Filter dictionary keys based on a string or regular expression
Methods
Mads.filterkeys(dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:787Mads.filterkeys(dict::Associative, key::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:786Mads.filterkeys(dict::Associative, key::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:787
Arguments
dict::Associative
: dictionarykey::Regex
: the regular expression or string used to filter dictionary keyskey::String
: the regular expression or string used to filter dictionary keys
#
Mads.forward
— Function.
Perform a forward run using the initial or provided values for the model parameters
Methods
Mads.forward(madsdata::Associative; all) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsForward.jl:6Mads.forward(madsdata::Associative, paramdict::Associative; all, checkpointfrequency, checkpointfilename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsForward.jl:10Mads.forward(madsdata::Associative, paramarray::Array; all, checkpointfrequency, checkpointfilename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsForward.jl:44
Arguments
madsdata::Associative
: MADS problem dictionaryparamarray::Array
: array of model parameter valuesparamdict::Associative
: dictionary of model parameter values
Keywords
all
: all model results are returned [default=false
]checkpointfilename
: check point file name [default="checkpoint_forward"]checkpointfrequency
: check point frequency for storing restart information [default=0
]
Returns:
- dictionary of model predictions
#
Mads.forwardgrid
— Function.
Perform a forward run over a 3D grid defined in madsdata
using the initial or provided values for the model parameters
Methods
Mads.forwardgrid(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsForward.jl:132Mads.forwardgrid(madsdatain::Associative, paramvalues::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsForward.jl:137
Arguments
madsdata::Associative
: MADS problem dictionarymadsdatain::Associative
: MADS problem dictionaryparamvalues::Associative
: dictionary of model parameter values
Returns:
- 3D array with model predictions along a 3D grid
#
Mads.free
— Function.
Free Mads modules
Methods
Mads.free(modulename::String; required, all) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:203Mads.free() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:203
Arguments
modulename::String
: module name
Keywords
all
: free all the modules [default=false
]required
: only free Mads.required modules [default=false
]
#
Mads.functions
— Function.
List available functions in the MADS modules:
Methods
Mads.functions(string::String; stdout, quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:31Mads.functions() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:31Mads.functions(re::Regex; stdout, quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:22Mads.functions(m::Union{Module, Symbol}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:70Mads.functions(m::Union{Module, Symbol}, re::Regex; stdout, quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:40Mads.functions(m::Union{Module, Symbol}, string::String; stdout, quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:70
Arguments
Symbol}
m::Union{Module
: MADS modulere::Regex
string::String
: string to display functions with matching names
Keywords
quiet
stdout
Examples:
Mads.functions() Mads.functions(BIGUQ) Mads.functions("get") Mads.functions(Mads, "get")
#
Mads.gaussiancov
— Method.
Gaussian spatial covariance function
Methods
Mads.gaussiancov(h::Number, maxcov::Number, scale::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:15
Arguments
h::Number
: separation distancemaxcov::Number
: maximum covariancescale::Number
: scale
Returns:
- covariance
#
Mads.gaussianvariogram
— Method.
Gaussian variogram
Methods
Mads.gaussianvariogram(h::Number, sill::Number, range::Number, nugget::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:103
Arguments
h::Number
: separation distancenugget::Number
: nuggetrange::Number
: rangesill::Number
: sill
Returns:
- Gaussian variogram
#
Mads.getcovmat
— Method.
Get spatial covariance matrix
Methods
Mads.getcovmat(X::Array{T,2} where T, cov::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:159
Arguments
X::Array{T,2} where T
: matrix with coordinates of the data points (x or y)cov::Function
: spatial covariance function
Returns:
- spatial covariance matrix
#
Mads.getcovvec!
— Method.
Get spatial covariance vector
Methods
Mads.getcovvec!(covvec::Array{T,1} where T, x0::Array{T,1} where T, X::Array{T,2} where T, cov::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:185
Arguments
X::Array{T,2} where T
: matrix with coordinates of the data pointscov::Function
: spatial covariance functioncovvec::Array{T,1} where T
: spatial covariance vectorx0::Array{T,1} where T
: vector with coordinates of the estimation points (x or y)
Returns:
- spatial covariance vector
#
Mads.getdictvalues
— Function.
Get dictionary values for keys based on a string or regular expression
Methods
Mads.getdictvalues(dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:809Mads.getdictvalues(dict::Associative, key::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:808Mads.getdictvalues(dict::Associative, key::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:809
Arguments
dict::Associative
: dictionarykey::Regex
: the key to find value forkey::String
: the key to find value for
#
Mads.getdir
— Method.
Get directory
Methods
Mads.getdir(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:407
Arguments
filename::String
: file name
Returns:
- directory in file name
Example:
d = Mads.getdir("a.mads") # d = "." d = Mads.getdir("test/a.mads") # d = "test"
#
Mads.getdistribution
— Method.
Parse parameter distribution from a string
Methods
Mads.getdistribution(dist::String, i::String, inputtype::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:202
Arguments
dist::String
: parameter distributioni::String
inputtype::String
: input type (parameter or observation)
Returns:
- distribution
#
Mads.getextension
— Method.
Get file name extension
Methods
Mads.getextension(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:579
Arguments
filename::String
: file name
Returns:
- file name extension
Example:
ext = Mads.getextension("a.mads") # ext = "mads"
#
Mads.getimportantsamples
— Method.
Get important samples
Methods
Mads.getimportantsamples(samples::Array, llhoods::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:351
Arguments
llhoods::Array{T,1} where T
: vector of log-likelihoodssamples::Array
: array of samples
Returns:
- array of important samples
#
Mads.getlogparamkeys
— Method.
Get the keys in the MADS problem dictionary for parameters that are log-transformed (log
)
#
Mads.getmadsdir
— Method.
Get the directory where currently Mads is running
Methods
Mads.getmadsdir() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:449
Example:
problemdir = Mads.getmadsdir()
Returns:
- Mads problem directory
#
Mads.getmadsinputfile
— Method.
Get the default MADS input file set as a MADS global variable using setmadsinputfile(filename)
Methods
Mads.getmadsinputfile() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:364
Returns:
- input file name (e.g.
input_file_name.mads
)
#
Mads.getmadsproblemdir
— Method.
Get the directory where the Mads data file is located
Methods
Mads.getmadsproblemdir(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:430
Arguments
madsdata::Associative
: MADS problem dictionary
Example:
madsdata = Mads.loadmadsfile("../../a.mads") madsproblemdir = Mads.getmadsproblemdir(madsdata)
where madsproblemdir
= "../../"
#
Mads.getmadsrootname
— Method.
Get the MADS problem root name
Methods
Mads.getmadsrootname(madsdata::Associative; first, version) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:386
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
first
: use the first . in filename as the seperator between root name and extention [default=true
]version
: delete version information from filename for the returned rootname [default=false
]
Example:
madsrootname = Mads.getmadsrootname(madsdata)
Returns:
- root of file name
#
Mads.getnextmadsfilename
— Method.
Get next mads file name
Methods
Mads.getnextmadsfilename(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:542
Arguments
filename::String
: file name
Returns:
- next mads file name
#
Mads.getnonlogparamkeys
— Method.
Get the keys in the MADS problem dictionary for parameters that are NOT log-transformed (log
)
#
Mads.getnonoptparamkeys
— Method.
Get the keys in the MADS problem dictionary for parameters that are NOT optimized (opt
)
#
Mads.getobsdist
— Method.
Get an array with dist
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobsdist
— Method.
Get an array with dist
values for all observations in the MADS problem dictionary
#
Mads.getobskeys
— Method.
Get keys for all observations in the MADS problem dictionary
Methods
Mads.getobskeys(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:45
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- keys for all observations in the MADS problem dictionary
#
Mads.getobslog
— Method.
Get an array with log
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobslog
— Method.
Get an array with log
values for all observations in the MADS problem dictionary
#
Mads.getobsmax
— Method.
Get an array with max
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobsmax
— Method.
Get an array with max
values for all observations in the MADS problem dictionary
#
Mads.getobsmin
— Method.
Get an array with min
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobsmin
— Method.
Get an array with min
values for all observations in the MADS problem dictionary
#
Mads.getobstarget
— Method.
Get an array with target
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobstarget
— Method.
Get an array with target
values for all observations in the MADS problem dictionary
#
Mads.getobstime
— Method.
Get an array with time
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobstime
— Method.
Get an array with time
values for all observations in the MADS problem dictionary
#
Mads.getobsweight
— Method.
Get an array with weight
values for observations in the MADS problem dictionary defined by obskeys
#
Mads.getobsweight
— Method.
Get an array with weight
values for all observations in the MADS problem dictionary
#
Mads.getoptparamkeys
— Method.
Get the keys in the MADS problem dictionary for parameters that are optimized (opt
)
#
Mads.getoptparams
— Function.
Get optimizable parameters
Methods
Mads.getoptparams(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:369Mads.getoptparams(madsdata::Associative, parameterarray::Array) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:372Mads.getoptparams(madsdata::Associative, parameterarray::Array, optparameterkey::Array) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:372
Arguments
madsdata::Associative
: MADS problem dictionaryoptparameterkey::Array
: optimizable parameter keysparameterarray::Array
: parameter array
Returns:
- parameter array
#
Mads.getparamdict
— Method.
Get dictionary with all parameters and their respective initial values
Methods
Mads.getparamdict(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:60
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- dictionary with all parameters and their respective initial values
#
Mads.getparamdistributions
— Method.
Get probabilistic distributions of all parameters in the MADS problem dictionary
Note:
Probabilistic distribution of parameters can be defined only if dist
or min
/max
model parameter fields are specified in the MADS problem dictionary madsdata
.
Methods
Mads.getparamdistributions(madsdata::Associative; init_dist) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:664
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
init_dist
: iftrue
use the distribution defined for initialization in the MADS problem dictionary (defined usinginit_dist
parameter field); else use the regular distribution defined in the MADS problem dictionary (defined usingdist
parameter field [default=false
]
Returns:
- probabilistic distributions
#
Mads.getparamkeys
— Method.
Get keys of all parameters in the MADS problem dictionary
Methods
Mads.getparamkeys(madsdata::Associative; filter) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:44
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
filter
: parameter filter
Returns:
- array with the keys of all parameters in the MADS problem dictionary
#
Mads.getparamrandom
— Function.
Get independent sampling of model parameters defined in the MADS problem dictionary
Methods
Mads.getparamrandom(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:387Mads.getparamrandom(madsdata::Associative, numsamples::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:387Mads.getparamrandom(madsdata::Associative, numsamples::Integer, parameterkey::String; init_dist) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:387Mads.getparamrandom(madsdata::Associative, parameterkey::String; numsamples, paramdist, init_dist) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:404
Arguments
madsdata::Associative
: MADS problem dictionarynumsamples::Integer
: number of samples, [default=1
]parameterkey::String
: model parameter key
Keywords
init_dist
: iftrue
use the distribution set for initialization in the MADS problem dictionary (defined usinginit_dist
parameter field); iffalse
(default) use the regular distribution set in the MADS problem dictionary (defined usingdist
parameter field)numsamples
: number of samplesparamdist
: dictionary of parameter distributions
Returns:
- generated sample
#
Mads.getparamsinit
— Method.
Get an array with init values for parameters defined by paramkeys
#
Mads.getparamsinit
— Method.
Get an array with init values for all the MADS model parameters
#
Mads.getparamsinit_max
— Function.
Get an array with init_max
values for parameters defined by paramkeys
Methods
Mads.getparamsinit_max(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:298Mads.getparamsinit_max(madsdata::Associative, paramkeys::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:264
Arguments
madsdata::Associative
: MADS problem dictionaryparamkeys::Array{T,1} where T
: parameter keys
Returns:
- the parameter values
#
Mads.getparamsinit_min
— Function.
Get an array with init_min
values for parameters
Methods
Mads.getparamsinit_min(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:247Mads.getparamsinit_min(madsdata::Associative, paramkeys::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:213
Arguments
madsdata::Associative
: MADS problem dictionaryparamkeys::Array{T,1} where T
: parameter keys
Returns:
- the parameter values
#
Mads.getparamslog
— Method.
Get an array with log values for parameters defined by paramkeys
#
Mads.getparamslog
— Method.
Get an array with log values for all the MADS model parameters
#
Mads.getparamslongname
— Method.
Get an array with longname values for parameters defined by paramkeys
#
Mads.getparamslongname
— Method.
Get an array with longname values for all the MADS model parameters
#
Mads.getparamsmax
— Function.
Get an array with max
values for parameters defined by paramkeys
Methods
Mads.getparamsmax(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:196Mads.getparamsmax(madsdata::Associative, paramkeys::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:174
Arguments
madsdata::Associative
: MADS problem dictionaryparamkeys::Array{T,1} where T
: parameter keys
Returns:
- returns the parameter values
#
Mads.getparamsmin
— Function.
Get an array with min
values for parameters defined by paramkeys
Methods
Mads.getparamsmin(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:157Mads.getparamsmin(madsdata::Associative, paramkeys::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:135
Arguments
madsdata::Associative
: MADS problem dictionaryparamkeys::Array{T,1} where T
: parameter keys
Returns:
- the parameter values
#
Mads.getparamsplotname
— Method.
Get an array with plotname values for parameters defined by paramkeys
#
Mads.getparamsplotname
— Method.
Get an array with plotname values for all the MADS model parameters
#
Mads.getparamsstep
— Method.
Get an array with step values for parameters defined by paramkeys
#
Mads.getparamsstep
— Method.
Get an array with step values for all the MADS model parameters
#
Mads.getparamstype
— Method.
Get an array with type values for parameters defined by paramkeys
#
Mads.getparamstype
— Method.
Get an array with type values for all the MADS model parameters
#
Mads.getprocs
— Method.
Get the number of processors
Methods
Mads.getprocs() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:28
#
Mads.getrestart
— Method.
Get MADS restart status
Methods
Mads.getrestart(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:78
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.getrestartdir
— Function.
Get the directory where Mads restarts will be stored
Methods
Mads.getrestartdir(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:321Mads.getrestartdir(madsdata::Associative, suffix::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:321
Arguments
madsdata::Associative
: MADS problem dictionarysuffix::String
: Suffix to be added to the name of restart directory
Returns:
- restart directory where reusable model results will be stored
#
Mads.getrootname
— Method.
Get file name root
Methods
Mads.getrootname(filename::String; first, version) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:479
Arguments
filename::String
: file name
Keywords
first
: use the first . in filename as the seperator between root name and extention [default=true
]version
: delete version information from filename for the returned rootname [default=false
]
Returns:
- root of file name
Example:
r = Mads.getrootname("a.rnd.dat") # r = "a" r = Mads.getrootname("a.rnd.dat", first=false) # r = "a.rnd"
#
Mads.getseed
— Method.
Get and return current random seed.
Methods
Mads.getseed() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:432
#
Mads.getsindx
— Method.
Get sin-space dx
Methods
Mads.getsindx(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:314
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- sin-space dx value
#
Mads.getsourcekeys
— Method.
Get keys of all source parameters in the MADS problem dictionary
Methods
Mads.getsourcekeys(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:78
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- array with keys of all source parameters in the MADS problem dictionary
#
Mads.gettarget
— Method.
Get observation target
Methods
Mads.gettarget(o::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:224
Arguments
o::Associative
: observation data
Returns:
- observation target
#
Mads.gettargetkeys
— Method.
Get keys for all targets (observations with weights greater than zero) in the MADS problem dictionary
Methods
Mads.gettargetkeys(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:59
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- keys for all targets in the MADS problem dictionary
#
Mads.gettime
— Method.
Get observation time
Methods
Mads.gettime(o::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:146
Arguments
o::Associative
: observation data
Returns:
- observation time ("NaN" it time is missing)
#
Mads.getweight
— Method.
Get observation weight
Methods
Mads.getweight(o::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:185
Arguments
o::Associative
: observation data
Returns:
- observation weight ("NaN" when weight is missing)
#
Mads.getwelldata
— Method.
Get spatial and temporal data in the Wells
class
Methods
Mads.getwelldata(madsdata::Associative; time) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:716
Arguments
madsdata::Associative
: Mads problem dictionary
Keywords
time
: get observation times [default=false
]
Returns:
- array with spatial and temporal data in the
Wells
class
#
Mads.getwellkeys
— Method.
Get keys for all wells in the MADS problem dictionary
Methods
Mads.getwellkeys(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:76
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- keys for all wells in the MADS problem dictionary
#
Mads.getwelltargets
— Method.
Methods
Mads.getwelltargets(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:750
Arguments
madsdata::Associative
: Mads problem dictionary
Returns:
- array with targets in the
Wells
class
#
Mads.graphoff
— Method.
MADS graph output off
Methods
Mads.graphoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:132
#
Mads.graphon
— Method.
MADS graph output on
Methods
Mads.graphon() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:123
#
Mads.haskeyword
— Function.
Check for a keyword
in a class
within the Mads dictionary madsdata
Methods
Mads.haskeyword(madsdata::Associative, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:211Mads.haskeyword(madsdata::Associative, class::String, keyword::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:214
Arguments
class::String
: dictionary class; if not provided searches forkeyword
inProblem
classkeyword::String
: dictionary keymadsdata::Associative
: MADS problem dictionary
Returns: true
or false
Examples:
- `Mads.haskeyword(madsdata, "disp")` ... searches in `Problem` class by default - `Mads.haskeyword(madsdata, "Wells", "R-28")` ... searches in `Wells` class for a keyword "R-28"
#
Mads.help
— Method.
Produce MADS help information
Methods
Mads.help() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelp.jl:9
#
Mads.importeverywhere
— Method.
Import Julia function everywhere from a file. The first function in the Julia input file is the one that will be called by Mads to perform the model simulations.
Methods
Mads.importeverywhere(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:373
Arguments
filename::String
: file name
Returns:
- Julia function to execute the model
#
Mads.indexkeys
— Function.
Find indexes for dictionary keys based on a string or regular expression
Methods
Mads.indexkeys(dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:798Mads.indexkeys(dict::Associative, key::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:797Mads.indexkeys(dict::Associative, key::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:798
Arguments
dict::Associative
: dictionarykey::Regex
: the key to find index forkey::String
: the key to find index for
#
Mads.infogap_jump
— Function.
Information Gap Decision Analysis using JuMP
Methods
Mads.infogap_jump() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:22Mads.infogap_jump(madsdata::Associative; horizons, retries, random, maxiter, verbosity, seed) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:22
Arguments
madsdata::Associative
: Mads problem dictionary
Keywords
horizons
: info-gap horizons of uncertainty [default=[0.05, 0.1, 0.2, 0.5]
]maxiter
: maximum number of iterations [default=3000
]random
: random initial guesses [default=false
]retries
: number of solution retries [default=1
]seed
: random seed [default=0
]verbosity
: verbosity output level [default=0
]
#
Mads.infogap_jump_polinomial
— Function.
Information Gap Decision Analysis using JuMP
Methods
Mads.infogap_jump_polinomial() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:126Mads.infogap_jump_polinomial(madsdata::Associative; horizons, retries, random, maxiter, verbosity, quiet, plot, model, seed) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:126
Arguments
madsdata::Associative
: Mads problem dictionary
Keywords
horizons
: info-gap horizons of uncertainty [default=[0.05, 0.1, 0.2, 0.5]
]maxiter
: maximum number of iterations [default=3000
]model
: model id [default=1
]plot
: activate plotting [default=false
]quiet
: quiet [default=false
]random
: random initial guesses [default=false
]retries
: number of solution retries [default=1
]seed
: random seed [default=0
]verbosity
: verbosity output level [default=0
]
Returns:
- hmin, hmax
#
Mads.infogap_mpb_lin
— Function.
Information Gap Decision Analysis using MathProgBase
Methods
Mads.infogap_mpb_lin() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:423Mads.infogap_mpb_lin(madsdata::Associative; horizons, retries, random, maxiter, verbosity, seed, pinit) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:423
Arguments
madsdata::Associative
: Mads problem dictionary
Keywords
horizons
: info-gap horizons of uncertainty [default=[0.05, 0.1, 0.2, 0.5]
]maxiter
: maximum number of iterations [default=3000
]pinit
: vector with initial parametersrandom
: random initial guesses [default=false
]retries
: number of solution retries [default=1
]seed
: random seed [default=0
]verbosity
: verbosity output level [default=0
]
#
Mads.infogap_mpb_polinomial
— Function.
Information Gap Decision Analysis using MathProgBase
Methods
Mads.infogap_mpb_polinomial() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:282Mads.infogap_mpb_polinomial(madsdata::Associative; horizons, retries, random, maxiter, verbosity, seed, pinit) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsInfoGap.jl:282
Arguments
madsdata::Associative
: Mads problem dictionary
Keywords
horizons
: info-gap horizons of uncertainty [default=[0.05, 0.1, 0.2, 0.5]
]maxiter
: maximum number of iterations [default=3000
]pinit
: vector with initial parametersrandom
: random initial guesses [default=false
]retries
: number of solution retries [default=1
]seed
: random seed [default=0
]verbosity
: verbosity output level [default=0
]
#
Mads.ins_obs
— Method.
Apply Mads instruction file instructionfilename
to read model output file modeloutputfilename
Methods
Mads.ins_obs(instructionfilename::String, modeloutputfilename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1005
Arguments
instructionfilename::String
: instruction file namemodeloutputfilename::String
: model output file name
Returns:
obsdict
: observation dictionary with the model outputs
#
Mads.instline2regexs
— Method.
Convert an instruction line in the Mads instruction file into regular expressions
Methods
Mads.instline2regexs(instline::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:905
Arguments
instline::String
: instruction line
Returns:
regexs
: regular expressionsobsnames
: observation namesgetparamhere
: parameters
#
Mads.invobsweights!
— Method.
Set inversely proportional observation weights in the MADS problem dictionary
Methods
Mads.invobsweights!(madsdata::Associative, multiplier::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:327
Arguments
madsdata::Associative
: MADS problem dictionarymultiplier::Number
: weight multiplier
#
Mads.invwellweights!
— Method.
Set inversely proportional well weights in the MADS problem dictionary
Methods
Mads.invwellweights!(madsdata::Associative, multiplier::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:382
Arguments
madsdata::Associative
: MADS problem dictionarymultiplier::Number
: weight multiplier
#
Mads.islog
— Method.
Is parameter with key parameterkey
log-transformed?
Methods
Mads.islog(madsdata::Associative, parameterkey::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:445
Arguments
madsdata::Associative
: MADS problem dictionaryparameterkey::String
: parameter key
Returns:
true
if log-transformed,false
otherwise
#
Mads.isobs
— Method.
Is a dictionary containing all the observations
Methods
Mads.isobs(madsdata::Associative, dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:19
Arguments
dict::Associative
: dictionarymadsdata::Associative
: MADS problem dictionary
Returns:
true
if the dictionary contain all the observations,false
otherwise
#
Mads.isopt
— Method.
Is parameter with key parameterkey
optimizable?
Methods
Mads.isopt(madsdata::Associative, parameterkey::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:425
Arguments
madsdata::Associative
: MADS problem dictionaryparameterkey::String
: parameter key
Returns:
true
if optimizable,false
if not
#
Mads.isparam
— Method.
Check if a dictionary containing all the Mads model parameters
Methods
Mads.isparam(madsdata::Associative, dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:17
Arguments
dict::Associative
: dictionarymadsdata::Associative
: MADS problem dictionary
Returns:
true
if the dictionary containing all the parameters,false
otherwise
#
Mads.ispkgavailable
— Function.
Checks if package is available
Methods
Mads.ispkgavailable(modulename::String; quiet) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:468
Arguments
modulename::String
: module name
Keywords
quiet
Returns:
true
orfalse
#
Mads.krige
— Method.
Kriging
Methods
Mads.krige(x0mat::Array{T,2} where T, X::Array{T,2} where T, Z::Array{T,1} where T, cov::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:124
Arguments
X::Array{T,2} where T
: coordinates of the observation (conditioning) dataZ::Array{T,1} where T
: values for the observation (conditioning) datacov::Function
: spatial covariance functionx0mat::Array{T,2} where T
: point coordinates at which to obtain kriging estimates
Returns:
- kriging estimates at
x0mat
#
Mads.levenberg_marquardt
— Function.
Levenberg-Marquardt optimization
Methods
Mads.levenberg_marquardt(f::Function, g::Function, x0) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:358Mads.levenberg_marquardt(f::Function, g::Function, x0, o::Function; root, tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_scale, lambda_mu, lambda_nu, np_lambda, show_trace, alwaysDoJacobian, callbackiteration, callbackjacobian) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:358
Arguments
f::Function
: forward model functiong::Function
: gradient function for the forward modelo::Function
: objective function [default=x->(x'*x)[1]
]x0
: initial parameter guess
Keywords
alwaysDoJacobian
: computer Jacobian each iteration [default=false
]callbackiteration
: call back function for each iteration [default=(best_x::Vector, of::Number, lambda::Number)->nothing
]callbackjacobian
: call back function for each Jacobian [default=(x::Vector, J::Matrix)->nothing
]lambda
: initial Levenberg-Marquardt lambda [default=eps(Float32)
]lambda_mu
: lambda multiplication factor μ [default=10
]lambda_nu
: lambda multiplication factor ν [default=2
]lambda_scale
: lambda scaling factor [default=1e-3,
]maxEval
: maximum number of model evaluations [default=1001
]maxIter
: maximum number of optimization iterations [default=100
]maxJacobians
: maximum number of Jacobian solves [default=100
]np_lambda
: number of parallel lambda solves [default=10
]root
: Mads problem root nameshow_trace
: shows solution trace [default=false
]tolG
: parameter space update tolerance [default=1e-6
]tolOF
: objective function update tolerance [default=1e-3
]tolX
: parameter space tolerance [default=1e-4
]
#
Mads.linktempdir
— Method.
Link files in a temporary directory
Methods
Mads.linktempdir(madsproblemdir::String, tempdirname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1252
Arguments
madsproblemdir::String
: Mads problem directorytempdirname::String
: temporary directory name
#
Mads.loadasciifile
— Method.
Load ASCII file
Methods
Mads.loadasciifile(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsASCII.jl:14
Arguments
filename::String
: ASCII file name
Returns:
- data from the file
#
Mads.loadbigyamlfile
— Method.
Load BIG YAML input file
Methods
Mads.loadmadsfile(filename::String; bigfile, julia, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:34
Arguments
filename::String
: input file name (e.g.input_file_name.mads
)
Keywords
bigfile
format
julia
Returns:
- MADS problem dictionary
#
Mads.loadjsonfile
— Method.
Load a JSON file
Methods
Mads.loadjsonfile(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsJSON.jl:16
Arguments
filename::String
: JSON file name
Returns:
- data from the JSON file
#
Mads.loadmadsfile
— Method.
Load MADS input file defining a MADS problem dictionary
Methods
Mads.loadmadsfile(filename::String; bigfile, julia, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:34
Arguments
filename::String
: input file name (e.g.input_file_name.mads
)
Keywords
bigfile
format
: acceptable formats areyaml
andjson
[default=yaml
]julia
: iftrue
, force usingjulia
parsing functions; iffalse
(default), usepython
parsing functions
Returns:
- MADS problem dictionary
Example:
md = Mads.loadmadsfile("input_file_name.mads")
#
Mads.loadmadsproblem
— Method.
Load a predefined Mads problem
Methods
Mads.loadmadsproblem(name::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCreate.jl:15
Arguments
name::String
: predefined MADS problem name
Returns:
- MADS problem dictionary
#
Mads.loadsaltellirestart!
— Method.
Load Saltelli sensitivity analysis results for fast simulation restarts
Methods
Mads.loadsaltellirestart!(evalmat::Array, matname::String, restartdir::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:598
Arguments
evalmat::Array
: loaded arraymatname::String
: matrix (array) name (defines the name of the loaded file)restartdir::String
: directory where files will be stored containing model results for fast simulation restarts
Returns:
true
when successfully loaded,false
when it is not
#
Mads.loadyamlfile
— Method.
Load YAML file
Methods
Mads.loadyamlfile(filename::String; julia) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsYAML.jl:18
Arguments
filename::String
: file name
Keywords
julia
: iftrue
, usejulia
YAML library (if available); iffalse
(default), usepython
YAML library (if available)
Returns:
- data in the yaml input file
#
Mads.localsa
— Method.
Local sensitivity analysis based on eigen analysis of the parameter covariance matrix
Methods
Mads.localsa(madsdata::Associative; sinspace, keyword, filename, format, datafiles, imagefiles, par, obs, J) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:126
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
J
: Jacobian matrixdatafiles
: flag to write data files [default=true
]filename
: output file nameformat
: output plot format (png
,pdf
, etc.)imagefiles
: flag to create image files [default=Mads.graphoutput
]keyword
: keyword to be added in the filename rootobs
: observations for the parameter setpar
: parameter setsinspace
: apply sin transformation [default=true
]
Dumps:
filename
: output plot file
#
Mads.long_tests_off
— Method.
Turn off execution of long MADS tests (default)
Methods
Mads.long_tests_off() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:168
#
Mads.long_tests_on
— Method.
Turn on execution of long MADS tests
Methods
Mads.long_tests_on() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:159
#
Mads.madscores
— Function.
Check the number of processors on a series of servers
Methods
Mads.madscores(nodenames::Array{String,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:304Mads.madscores() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:304
Arguments
nodenames::Array{String,1}
: array with names of machines/nodes [default=madsservers
]
#
Mads.madscritical
— Method.
MADS critical error messages
Methods
Mads.madscritical(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:73
Arguments
message::AbstractString
: critical error message
#
Mads.madsdebug
— Function.
MADS debug messages (controlled by quiet
and debuglevel
)
Methods
Mads.madsdebug(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:26Mads.madsdebug(message::AbstractString, level::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:26
Arguments
level::Int64
: output verbosity level [default=0
]message::AbstractString
: debug message
#
Mads.madserror
— Method.
MADS error messages
Methods
Mads.madserror(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:63
Arguments
message::AbstractString
: error message
#
Mads.madsinfo
— Function.
MADS information/status messages (controlled by quietand
verbositylevel`)
Methods
Mads.madsinfo(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:41Mads.madsinfo(message::AbstractString, level::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:41
Arguments
level::Int64
: output verbosity level [default=0
]message::AbstractString
: information/status message
#
Mads.madsload
— Function.
Check the load of a series of servers
Methods
Mads.madsload(nodenames::Array{String,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:324Mads.madsload() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:324
Arguments
nodenames::Array{String,1}
: array with names of machines/nodes [default=madsservers
]
#
Mads.madsmathprogbase
— Function.
Define MadsModel
type applied for Mads execution using MathProgBase
Methods
Mads.madsmathprogbase() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsMathProgBase.jl:17Mads.madsmathprogbase(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsMathProgBase.jl:17
Arguments
madsdata::Associative
: MADS problem dictionary [default=Dict()
]
#
Mads.madsoutput
— Function.
MADS output (controlled by quiet
and verbositylevel
)
Methods
Mads.madsoutput(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:11Mads.madsoutput(message::AbstractString, level::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:11
Arguments
level::Int64
: output verbosity level [default=0
]message::AbstractString
: output message
#
Mads.madsup
— Function.
Check the uptime of a series of servers
Methods
Mads.madsup(nodenames::Array{String,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:314Mads.madsup() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:314
Arguments
nodenames::Array{String,1}
: array with names of machines/nodes [default=madsservers
]
#
Mads.madswarn
— Method.
MADS warning messages
Methods
Mads.madswarn(message::AbstractString) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLog.jl:53
Arguments
message::AbstractString
: warning message
#
Mads.makearrayconditionalloglikelihood
— Method.
Make a conditional log likelihood function that accepts an array containing the optimal parameter values
Methods
Mads.makearrayconditionalloglikelihood(madsdata::Associative, conditionalloglikelihood) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:104
Arguments
conditionalloglikelihood
: conditional log likelihoodmadsdata::Associative
: MADS problem dictionary
Returns:
- a conditional log likelihood function that accepts an array
#
Mads.makearrayconditionalloglikelihood
— Method.
Make array of conditional log-likelihoods
Methods
Mads.makearrayconditionalloglikelihood(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsBayesInfoGap.jl:160Mads.makearrayconditionalloglikelihood(madsdata::Associative, conditionalloglikelihood) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:104
Arguments
conditionalloglikelihood
madsdata::Associative
: MADS problem dictionary
Returns:
- array of conditional log-likelihoods
#
Mads.makearrayfunction
— Function.
Make a version of the function f
that accepts an array containing the optimal parameter values
Methods
Mads.makearrayfunction(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:32Mads.makearrayfunction(madsdata::Associative, f::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:32
Arguments
f::Function
: function [default=makemadscommandfunction(madsdata)
]madsdata::Associative
: MADS problem dictionary
Returns:
- function accepting an array containing the optimal parameter values
#
Mads.makearrayloglikelihood
— Method.
Make a log likelihood function that accepts an array containing the optimal parameter values
Methods
Mads.makearrayloglikelihood(madsdata::Associative, loglikelihood) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:127
Arguments
loglikelihood
: log likelihoodmadsdata::Associative
: MADS problem dictionary
Returns:
- a log likelihood function that accepts an array
#
Mads.makebigdt!
— Method.
Setup Bayesian Information Gap Decision Theory (BIG-DT) problem
Methods
Mads.makebigdt!(madsdata::Associative, choice::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsBayesInfoGap.jl:35
Arguments
choice::Associative
: dictionary of BIG-DT choices (scenarios)madsdata::Associative
: MADS problem dictionary
Returns:
- BIG-DT problem type
#
Mads.makebigdt
— Method.
Setup Bayesian Information Gap Decision Theory (BIG-DT) problem
Methods
Mads.makebigdt(madsdata::Associative, choice::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsBayesInfoGap.jl:20
Arguments
choice::Associative
: dictionary of BIG-DT choices (scenarios)madsdata::Associative
: MADS problem dictionary
Returns:
- BIG-DT problem type
#
Mads.makecomputeconcentrations
— Method.
Create a function to compute concentrations for all the observation points using Anasol
Methods
Mads.makecomputeconcentrations(madsdata::Associative; calczeroweightobs, calcpredictions) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:179
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
calcpredictions
: calculate zero weight predictions [default=true
]calczeroweightobs
: calculate zero weight observations[default=false
]
Returns:
- function to compute concentrations; the new function returns a dictionary of observations and model predicted concentrations
Examples:
computeconcentrations = Mads.makecomputeconcentrations(madsdata) paramkeys = Mads.getparamkeys(madsdata) paramdict = OrderedDict(zip(paramkeys, map(key->madsdata["Parameters"][key]["init"], paramkeys))) forward_preds = computeconcentrations(paramdict)
#
Mads.makedixonprice
— Method.
Make dixon price
Methods
Mads.makedixonprice(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:260
Arguments
n::Integer
: number of observations
Returns:
- dixon price
#
Mads.makedixonprice_gradient
— Method.
Methods
Mads.makedixonprice(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:260
Arguments
n::Integer
: number of observations
Returns:
- dixon price gradient
#
Mads.makedoublearrayfunction
— Function.
Make a version of the function f
that accepts an array containing the optimal parameter values, and returns an array of observations
Methods
Mads.makedoublearrayfunction(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:77Mads.makedoublearrayfunction(madsdata::Associative, f::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMisc.jl:77
Arguments
f::Function
: function [default=makemadscommandfunction(madsdata)
]madsdata::Associative
: MADS problem dictionary
Returns:
- function accepting an array containing the optimal parameter values, and returning an array of observations
#
Mads.makelmfunctions
— Function.
Make forward model, gradient, objective functions needed for Levenberg-Marquardt optimization
Methods
Mads.makelmfunctions(f::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:100Mads.makelmfunctions(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:121
Arguments
f::Function
: Functionmadsdata::Associative
: MADS problem dictionary
Returns:
- forward model, gradient, objective functions
#
Mads.makelocalsafunction
— Method.
Make gradient function needed for local sensitivity analysis
Methods
Mads.makelocalsafunction(madsdata::Associative; multiplycenterbyweights) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:27
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
multiplycenterbyweights
: multiply center by observation weights [default=true
]
Returns:
- gradient function
#
Mads.makelogprior
— Method.
Make a function to compute the prior log-likelihood of the model parameters listed in the MADS problem dictionary madsdata
Methods
Mads.makelogprior(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:396
Arguments
madsdata::Associative
: MADS problem dictionary
Return:
- the prior log-likelihood of the model parameters listed in the MADS problem dictionary
madsdata
#
Mads.makemadscommandfunction
— Method.
Make MADS function to execute the model defined in the input MADS problem dictionary
Methods
Mads.makemadscommandfunction(madsdata_in::Associative; obskeys, calczeroweightobs, calcpredictions) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:60
Arguments
madsdata_in::Associative
: MADS problem dictionary
Keywords
calcpredictions
: Calculate predictions [default=true
]calczeroweightobs
: Calculate zero weight observations [default=false
]obskeys
Example:
Mads.makemadscommandfunction(madsdata)
MADS can be coupled with any internal or external model. The model coupling is defined in the MADS problem dictionary. The expectations is that for a given set of model inputs, the model will produce a model output that will be provided to MADS. The fields in the MADS problem dictionary that can be used to define the model coupling are:
Model
: execute a Julia function defined in an input Julia file. The function that should accept aparameter
dictionary with all the model parameters as an input argument and should return anobservation
dictionary with all the model predicted observations. MADS will execute the first function defined in the file.MADS model
: create a Julia function based on an input Julia file. The input file should contain a function that accepts as an argument the MADS problem dictionary. MADS will execute the first function defined in the file. This function should a create a Julia function that will accept aparameter
dictionary with all the model parameters as an input argument and will return anobservation
dictionary with all the model predicted observations.Julia model
: execute an internal Julia function that accepts aparameter
dictionary with all the model parameters as an input argument and will return anobservation
dictionary with all the model predicted observations.Command
: execute an external UNIX command or script that will execute an external model.Julia command
: execute a Julia script that will execute an external model. The Julia script is defined in an input Julia file. The input file should contain a function that accepts as an argument the MADS problem dictionary; MADS will execute the first function defined in the file. The Julia script should be capable to (1) execute the model (making a system call of an external model), (2) parse the model outputs, (3) return anobservation
dictionary with model predictions.
Both Command
and Julia command
can use different approaches to pass model parameters to the external model.
Only Command
uses different approaches to get back the model outputs. The script defined under Julia command
parses the model outputs using Julia.
The available options for writing model inputs and reading model outputs are as follows.
Options for writing model inputs:
Templates
: template files for writing model input files as defined at http://mads.lanl.govASCIIParameters
: model parameters written in a ASCII fileJLDParameters
: model parameters written in a JLD fileYAMLParameters
: model parameters written in a YAML fileJSONParameters
: model parameters written in a JSON file
Options for reading model outputs:
Instructions
: instruction files for reading model output files as defined at http://mads.lanl.govASCIIPredictions
: model predictions read from a ASCII fileJLDPredictions
: model predictions read from a JLD fileYAMLPredictions
: model predictions read from a YAML fileJSONPredictions
: model predictions read from a JSON file
Returns:
- Mads function to execute a forward model simulation
#
Mads.makemadsconditionalloglikelihood
— Method.
Make a function to compute the conditional log-likelihood of the model parameters conditioned on the model predictions/observations. Model parameters and observations are defined in the MADS problem dictionary madsdata
.
Methods
Mads.makemadsconditionalloglikelihood(madsdata::Associative; weightfactor) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:419
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
weightfactor
: Weight factor [default=1
]
Return:
- the conditional log-likelihood
#
Mads.makemadsloglikelihood
— Method.
Make a function to compute the log-likelihood for a given set of model parameters, associated model predictions and existing observations. The function can be provided as an external function in the MADS problem dictionary under LogLikelihood
or computed internally.
Methods
Mads.makemadsloglikelihood(madsdata::Associative; weightfactor) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:454
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
weightfactor
: Weight factor [default=1
]
Returns:
- the log-likelihood for a given set of model parameters
#
Mads.makemadsreusablefunction
— Function.
Make Reusable Mads function to execute a forward model simulation (automatically restarts if restart data exists)
Methods
Mads.makemadsreusablefunction(madsdata::Associative, madscommandfunction::Function) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:273Mads.makemadsreusablefunction(madsdata::Associative, madscommandfunction::Function, suffix::String; usedict) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:273Mads.makemadsreusablefunction(paramkeys::Array{T,1} where T, obskeys::Array{T,1} where T, madsdatarestart::Union{Bool, String}, madscommandfunction::Function, restartdir::String; usedict) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsFunc.jl:276
Arguments
String}
madscommandfunction::Function
: Mads function to execute a forward model simulationmadsdata::Associative
: MADS problem dictionarymadsdatarestart::Union{Bool
: Restart type (memory/disk) or on/off statusobskeys::Array{T,1} where T
: Dictionary of observation keysparamkeys::Array{T,1} where T
: Dictionary of parameter keysrestartdir::String
: Restart directory where the reusable model results are storedsuffix::String
: Suffix to be added to the name of restart directory
Keywords
usedict
: Use dictionary [default=true
]
Returns:
- Reusable Mads function to execute a forward model simulation (automatically restarts if restart data exists)
#
Mads.makempbfunctions
— Method.
Make forward model, gradient, objective functions needed for MathProgBase optimization
Methods
Mads.makempbfunctions(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-new/MadsMathProgBase.jl:91
Arguments
madsdata::Associative
: MADS problem dictionary
Returns:
- forward model, gradient, objective functions
#
Mads.makepowell
— Method.
Make Powell test function for LM optimization
Methods
Mads.makepowell(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:163
Arguments
n::Integer
: number of observations
Returns:
- Powell test function for LM optimization
#
Mads.makepowell_gradient
— Method.
ake parameter gradients of the Powell test function for LM optimization
Methods
Mads.makepowell_gradient(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:187
Arguments
n::Integer
: number of observations
Returns:
- arameter gradients of the Powell test function for LM optimization
#
Mads.makerosenbrock
— Method.
Make Rosenbrock test function for LM optimization
Methods
Mads.makerosenbrock(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:118
Arguments
n::Integer
: number of observations
Returns:
- Rosenbrock test function for LM optimization
#
Mads.makerosenbrock_gradient
— Method.
Make parameter gradients of the Rosenbrock test function for LM optimization
Methods
Mads.makerosenbrock_gradient(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:140
Arguments
n::Integer
: number of observations
Returns:
- parameter gradients of the Rosenbrock test function for LM optimization
#
Mads.makerotatedhyperellipsoid
— Method.
Methods
Mads.makerotatedhyperellipsoid(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:339
Arguments
n::Integer
: number of observations
Returns:
- rotated hyperellipsoid
#
Mads.makerotatedhyperellipsoid_gradient
— Method.
Methods
Mads.makerotatedhyperellipsoid_gradient(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:363
Arguments
n::Integer
: number of observations
Returns:
- rotated hyperellipsoid gradient
#
Mads.makesphere
— Method.
Make sphere
Methods
Mads.makesphere(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:218
Arguments
n::Integer
: number of observations
Returns:
- sphere
#
Mads.makesphere_gradient
— Method.
Make sphere gradient
Methods
Mads.makesphere_gradient(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:239
Arguments
n::Integer
: number of observations
Returns:
- sphere gradient
#
Mads.makesumsquares
— Method.
Methods
Mads.makesumsquares(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:301
Arguments
n::Integer
: number of observations
Returns:
- sumsquares
#
Mads.makesumsquares_gradient
— Method.
Methods
Mads.makesumsquares_gradient(n::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:320
Arguments
n::Integer
: number of observations
Returns:
- sumsquares gradient
#
Mads.makesvrmodel
— Function.
Make SVR model functions (executor and cleaner)
Methods
Mads.makesvrmodel(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:210Mads.makesvrmodel(madsdata::Associative, numberofsamples::Integer; check, addminmax, loadsvr, savesvr, svm_type, kernel_type, degree, gamma, coef0, C, nu, eps, cache_size, tol, shrinking, probability, verbose, seed) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:210
Arguments
madsdata::Associative
: MADS problem dictionarynumberofsamples::Integer
: number of samples [default=100
]
Keywords
C
: cost; penalty parameter of the error term [default=1000.0
]addminmax
: add parameter minimum / maximum range values in the training set [default=true
]cache_size
: size of the kernel cache [default=100.0
]check
: check SVR performance [default=false
]coef0
: independent term in kernel function; important only in POLY and SIGMOND kernel types
[default=0
]
degree
: degree of the polynomial kernel [default=3
]eps
: epsilon in the EPSILON_SVR model; defines an epsilon-tube within which no penalty is associated in the training loss function with points predicted within a distance epsilon from the actual value [default=0.001
]gamma
: coefficient for RBF, POLY and SIGMOND kernel types [default=1/numberofsamples
]kernel_type
: kernel type[default=SVR.RBF
]loadsvr
: load SVR models [default=false
]nu
: upper bound on the fraction of training errors / lower bound of the fraction of support vectors; acceptable range (0, 1]; applied if NU_SVR model [default=0.5
]probability
: train to estimate probabilities [default=false
]savesvr
: save SVR models [default=false
]seed
: random seed [default=0
]shrinking
: apply shrinking heuristic [default=true
]svm_type
: SVM type [default=SVR.EPSILON_SVR
]tol
: tolerance of termination criterion [default=0.001
]verbose
: verbose output [default=false
]
Returns:
- function performing SVR predictions
- function loading existing SVR models
- function saving SVR models
- function removing SVR models from the memory
#
Mads.maxtorealmax!
— Method.
Scale down values larger than max(Float32) in a dataframe df
so that Gadfly can plot the data
Methods
Mads.maxtorealmax!(df::DataFrames.DataFrame) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:1085
Arguments
df::DataFrames.DataFrame
: dataframe
#
Mads.mdir
— Method.
Change the current directory to the Mads source dictionary
Methods
Mads.mdir() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:11
#
Mads.meshgrid
— Method.
Create mesh grid
Methods
Mads.meshgrid(x::Array{T,1} where T, y::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:402
Arguments
x::Array{T,1} where T
: vector of grid x coordinatesy::Array{T,1} where T
: vector of grid y coordinates
Returns:
- 2D grid coordinates based on the coordinates contained in vectors
x
andy
#
Mads.minimize
— Method.
Minimize Julia function using a constrained Levenberg-Marquardt technique
Mads.calibrate(madsdata; tolX=1e-3, tolG=1e-6, maxEval=1000, maxIter=100, maxJacobians=100, lambda=100.0, lambda_mu=10.0, np_lambda=10, show_trace=false, usenaive=false)
Methods
Mads.calibrate(madsdata::Associative; tolX, tolG, tolOF, maxEval, maxIter, maxJacobians, lambda, lambda_mu, np_lambda, show_trace, usenaive, save_results, localsa) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCalibrate.jl:162
Arguments
madsdata::Associative
Keywords
lambda
: initial Levenberg-Marquardt lambda [default=100.0
]lambda_mu
: lambda multiplication factor [default=10.0
]localsa
maxEval
: maximum number of model evaluations [default=1000
]maxIter
: maximum number of optimization iterations [default=100
]maxJacobians
: maximum number of Jacobian solves [default=100
]np_lambda
: number of parallel lambda solves [default=10
]save_results
show_trace
: shows solution trace [default=false
]tolG
: parameter space update tolerance [default=1e-6
]tolOF
: objective function tolerance [default=1e-3
]tolX
: parameter space tolerance [default=1e-4
]usenaive
Returns:
- vector with the optimal parameter values at the minimum
- optimization algorithm results (e.g. results.minimizer)
#
Mads.mkdir
— Method.
Create a directory (if does not already exist)
Methods
Mads.mkdir(dirname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1279
Arguments
dirname::String
: directory
#
Mads.modelinformationcriteria
— Function.
Model section information criteria
Methods
Mads.modelinformationcriteria(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsModelSelection.jl:11Mads.modelinformationcriteria(madsdata::Associative, par::Array{Float64,N} where N) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsModelSelection.jl:11
Arguments
madsdata::Associative
: MADS problem dictionarypar::Array{Float64,N} where N
: parameter array
#
Mads.modobsweights!
— Method.
Modify (multiply) observation weights in the MADS problem dictionary
Methods
Mads.modobsweights!(madsdata::Associative, value::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:313
Arguments
madsdata::Associative
: MADS problem dictionaryvalue::Number
: value for modifing observation weights
#
Mads.modwellweights!
— Method.
Modify (multiply) well weights in the MADS problem dictionary
Methods
Mads.modwellweights!(madsdata::Associative, value::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:363
Arguments
madsdata::Associative
: MADS problem dictionaryvalue::Number
: value for well weights
#
Mads.montecarlo
— Method.
Monte Carlo analysis
Methods
Mads.montecarlo(madsdata::Associative; N, filename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:188
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
N
: number of samples [default=100
]filename
: file name to save Monte-Carlo results
Returns:
- parameter dictionary containing the data arrays
Dumps:
- YAML output file with the parameter dictionary containing the data arrays
Example:
Mads.montecarlo(madsdata; N=100)
#
Mads.naive_get_deltax
— Method.
Naive Levenberg-Marquardt optimization: get the LM parameter space step
Methods
Mads.naive_get_deltax(JpJ::AbstractArray{Float64,2}, Jp::AbstractArray{Float64,2}, f0::Array{Float64,1}, lambda::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:246
Arguments
Jp::AbstractArray{Float64,2}
: Jacobian matrix times model parametersJpJ::AbstractArray{Float64,2}
: Jacobian matrix times model parameters times transposed Jacobian matrixf0::Array{Float64,1}
: initial model observationslambda::Number
: Levenberg-Marquardt lambda
Returns:
- the LM parameter space step
#
Mads.naive_levenberg_marquardt
— Function.
Naive Levenberg-Marquardt optimization
Methods
Mads.naive_levenberg_marquardt(f::Function, g::Function, x0::Array{Float64,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:296Mads.naive_levenberg_marquardt(f::Function, g::Function, x0::Array{Float64,1}, o::Function; maxIter, maxEval, lambda, lambda_mu, np_lambda) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:296
Arguments
f::Function
: forward model functiong::Function
: gradient function for the forward modelo::Function
: objective function [default=x->(x'*x)[1]]x0::Array{Float64,1}
: initial parameter guess
Keywords
lambda
: initial Levenberg-Marquardt lambda [default=100
]lambda_mu
: lambda multiplication factor μ [default=10
]maxEval
: maximum number of model evaluations [default=101
]maxIter
: maximum number of optimization iterations [default=10
]np_lambda
: number of parallel lambda solves [default=10
]
Returns:
#
Mads.naive_lm_iteration
— Method.
Naive Levenberg-Marquardt optimization: perform LM iteration
Methods
Mads.naive_lm_iteration(f::Function, g::Function, o::Function, x0::Array{Float64,1}, f0::Array{Float64,1}, lambdas::Array{Float64,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:267
Arguments
f0::Array{Float64,1}
: initial model observationsf::Function
: forward model functiong::Function
: gradient function for the forward modellambdas::Array{Float64,1}
: Levenberg-Marquardt lambdaso::Function
: objective functionx0::Array{Float64,1}
: initial parameter guess
Returns:
#
Mads.noplot
— Method.
Disable MADS plotting
Methods
Mads.noplot() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:237
#
Mads.obslineismatch
— Method.
Match an instruction line in the Mads instruction file with model input file
Methods
Mads.obslineismatch(obsline::String, regexs::Array{Regex,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:954
Arguments
obsline::String
: instruction lineregexs::Array{Regex,1}
: regular expressions
Returns:
- true or false
#
Mads.of
— Function.
Compute objective function
Methods
Mads.of(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:58Mads.of(madsdata::Associative, resultvec::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:51Mads.of(madsdata::Associative, resultdict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:55
Arguments
madsdata::Associative
: MADS problem dictionaryresultdict::Associative
: result dictionaryresultvec::Array{T,1} where T
: result vector
#
Mads.paramarray2dict
— Method.
Convert a parameter array to a parameter dictionary of arrays
Methods
Mads.paramarray2dict(madsdata::Associative, array::Array) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:242
Arguments
array::Array
: parameter arraymadsdata::Associative
: MADS problem dictionary
Returns:
- a parameter dictionary of arrays
#
Mads.paramdict2array
— Method.
Convert a parameter dictionary of arrays to a parameter array
Methods
Mads.paramdict2array(dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:261
Arguments
dict::Associative
: parameter dictionary of arrays
Returns:
- a parameter array
#
Mads.parsemadsdata!
— Method.
Parse loaded MADS problem dictionary
Methods
Mads.parsemadsdata!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:161
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.parsenodenames
— Function.
Parse string with node names defined in SLURM
Methods
Mads.parsenodenames(nodenames::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:206Mads.parsenodenames(nodenames::String, ntasks_per_node::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:206
Arguments
nodenames::String
: string with node names defined in SLURMntasks_per_node::Integer
: number of parallel tasks per node [default=1
]
Returns:
- vector with names of compute nodes (hosts)
#
Mads.partialof
— Method.
Compute the sum of squared residuals for observations that match a regular expression
Methods
Mads.partialof(madsdata::Associative, resultdict::Associative, regex::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:84
Arguments
madsdata::Associative
: MADS problem dictionaryregex::Regex
: regular expressionresultdict::Associative
: result dictionary
Returns:
- the sum of squared residuals for observations that match the regular expression
#
Mads.pkgversion
— Method.
Get package version
Methods
Mads.pkgversion(modulestr::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:445
Arguments
modulestr::String
Returns:
- package version
#
Mads.plotgrid
— Function.
Plot a 3D grid solution based on model predictions in array s
, initial parameters, or user provided parameter values
Methods
Mads.plotgrid(madsdata::Associative; addtitle, title, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlotPy.jl:56Mads.plotgrid(madsdata::Associative, s::Array{Float64,N} where N; addtitle, title, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlotPy.jl:5Mads.plotgrid(madsdata::Associative, parameters::Associative; addtitle, title, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlotPy.jl:61
Arguments
madsdata::Associative
: MADS problem dictionaryparameters::Associative
: dictionary with model parameterss::Array{Float64,N} where N
: model predictions array
Keywords
addtitle
: add plot title [default=true
]filename
: output file nameformat
: output plot format (png
,pdf
, etc.)title
: plot title
Examples:
Mads.plotgrid(madsdata, s; addtitle=true, title="", filename="", format="") Mads.plotgrid(madsdata; addtitle=true, title="", filename="", format="") Mads.plotgrid(madsdata, parameters; addtitle=true, title="", filename="", format="")
#
Mads.plotlocalsa
— Method.
Plot local sensitivity analysis results
Methods
Mads.plotlocalsa(filenameroot::String; keyword, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:1219
Arguments
filenameroot::String
: problem file name root
Keywords
filename
: output file nameformat
: output plot format (png
,pdf
, etc.)keyword
: keyword to be added in the filename root
Dumps:
filename
: output plot file
#
Mads.plotmadsproblem
— Method.
Plot contaminant sources and wells defined in MADS problem dictionary
Methods
Mads.plotmadsproblem(madsdata::Associative; format, filename, keyword, hsize, vsize, gm) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:77
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
filename
: output file nameformat
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]gm
hsize
keyword
: to be added in the filenamevsize
Dumps:
- plot of contaminant sources and wells
#
Mads.plotmass
— Method.
Plot injected/reduced contaminant mass
Methods
Mads.plotmass(lambda::Array{Float64,1}, mass_injected::Array{Float64,1}, mass_reduced::Array{Float64,1}, filename::String; format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasolPlot.jl:19
Arguments
filename::String
: output filename for the generated plotlambda::Array{Float64,1}
: array with all the lambda valuesmass_injected::Array{Float64,1}
: array with associated total injected massmass_reduced::Array{Float64,1}
: array with associated total reduced mass
Keywords
format
: output plot format (png
,pdf
, etc.)
Dumps:
- image file with name
filename
and in specifiedformat
#
Mads.plotmatches
— Function.
Plot the matches between model predictions and observations
Methods
Mads.plotmatches(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:157Mads.plotmatches(madsdata::Associative, rx::Regex; kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:157Mads.plotmatches(madsdata::Associative, dict_in::Associative; plotdata, filename, format, title, xtitle, ytitle, ymin, ymax, separate_files, hsize, vsize, linewidth, pointsize, obs_plot_dots, noise, dpi, colors, display, notitle) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:189Mads.plotmatches(madsdata::Associative, result::Associative, rx::Regex; plotdata, filename, format, key2time, title, xtitle, ytitle, ymin, ymax, separate_files, hsize, vsize, linewidth, pointsize, obs_plot_dots, noise, dpi, colors, display, notitle) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:165
Arguments
dict_in::Associative
: dictionary with model parametersmadsdata::Associative
: MADS problem dictionaryresult::Associative
: dictionary with model predictionsrx::Regex
: regular expression to filter the outputs
Keywords
colors
: array with plot colorsdisplay
: display plots [default=false
]dpi
: graph resolution [default=Mads.dpi
]filename
: output file nameformat
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]hsize
: graph horizontal size [default=8Gadfly.inch
]key2time
: user provided function to convert observation keys to observation timeslinewidth
: line width [default=2Gadfly.pt
]noise
: random noise magnitude [default=0
; no noise]notitle
obs_plot_dots
: plot data as dots or line [default=true
]plotdata
: plot data (iffalse
model predictions are ploted only) [default=true
]pointsize
: data dot size [default=4Gadfly.pt
]separate_files
: plot data for multiple wells separately [default=false
]title
: graph titlevsize
: graph vertical size [default=4Gadfly.inch
]xtitle
: x-axis title [default="Time"
]ymax
ymin
ytitle
: y-axis title [default="y"
]
Dumps:
- plot of the matches between model predictions and observations
Examples:
Mads.plotmatches(madsdata; filename="", format="") Mads.plotmatches(madsdata, dict_in; filename="", format="") Mads.plotmatches(madsdata, result; filename="", format="") Mads.plotmatches(madsdata, result, r"NO3"; filename="", format="")
#
Mads.plotobsSAresults
— Method.
Plot the sensitivity analysis results for the observations
Methods
Mads.plotobsSAresults(madsdata::Associative, result::Associative; filter, keyword, filename, format, debug, separate_files, xtitle, ytitle, linewidth, pointsize) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:571
Arguments
madsdata::Associative
: MADS problem dictionaryresult::Associative
: sensitivity analysis results
Keywords
debug
: [default=false
]filename
: output file namefilter
: string or regex to plot only observations containingfilter
format
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]keyword
: to be added in the auto-generated filenamelinewidth
: line width [default=2Gadfly.pt
]pointsize
: point size [default=2Gadfly.pt
]separate_files
: plot data for multiple wells separately [default=false
]xtitle
: x-axis titleytitle
: y-axis title
Dumps:
- plot of the sensitivity analysis results for the observations
#
Mads.plotrobustnesscurves
— Method.
Plot BIG-DT robustness curves
Methods
Mads.plotrobustnesscurves(madsdata::Associative, bigdtresults::Dict; filename, format, maxprob, maxhoriz) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsBayesInfoGapPlot.jl:20
Arguments
bigdtresults::Dict
: BIG-DT resultsmadsdata::Associative
: MADS problem dictionary
Keywords
filename
: output file name used to dump plotsformat
: output plot format (png
,pdf
, etc.)maxhoriz
: maximum horizon [default=Inf
]maxprob
: maximum probability [default=1.0
]
Dumps:
- image file with name
filename
and in specifiedformat
#
Mads.plotseries
— Function.
Create plots of data series
Methods
Mads.plotseries(X::Array{T,2} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:1116Mads.plotseries(X::Array{T,2} where T, filename::String; format, xtitle, ytitle, title, logx, logy, keytitle, name, names, combined, hsize, vsize, linewidth, dpi, colors, xmin, xmax, ymin, ymax, xaxis) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:1116
Arguments
X::Array{T,2} where T
: matrix with the series datafilename::String
: output file name
Keywords
colors
: colors to use in plotscombined
: combine plots [default=true
]dpi
: graph resolution [default=Mads.dpi
]format
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]hsize
: horizontal size [default=8Gadfly.inch
]keytitle
linewidth
: width of the lines in plot [default=2Gadfly.pt
]logx
logy
name
: series name [default=Sources
]names
title
: plot title [default=Sources
]vsize
: vertical size [default=4Gadfly.inch
]xaxis
xmax
xmin
xtitle
: x-axis title [default=X
]ymax
ymin
ytitle
: y-axis title [default=Y
]
Dumps:
- Plots of data series
#
Mads.plotwellSAresults
— Function.
Plot the sensitivity analysis results for all the wells in the MADS problem dictionary (wells class expected)
Methods
Mads.plotwellSAresults(madsdata::Associative, result::Associative; xtitle, ytitle, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:436Mads.plotwellSAresults(madsdata::Associative, result::Associative, wellname::String; xtitle, ytitle, filename, format) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:447
Arguments
madsdata::Associative
: MADS problem dictionaryresult::Associative
: sensitivity analysis resultswellname::String
: well name
Keywords
filename
: output file nameformat
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]xtitle
: x-axis titleytitle
: y-axis title
Dumps:
- Plot of the sensitivity analysis results for all the wells in the MADS problem dictionary
#
Mads.printSAresults
— Method.
Print sensitivity analysis results
Methods
Mads.printSAresults(madsdata::Associative, results::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:921
Arguments
madsdata::Associative
: MADS problem dictionaryresults::Associative
: dictionary with sensitivity analysis results
#
Mads.printSAresults2
— Method.
Print sensitivity analysis results (method 2)
Methods
Mads.printSAresults2(madsdata::Associative, results::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:1003
Arguments
madsdata::Associative
: MADS problem dictionaryresults::Associative
: dictionary with sensitivity analysis results
#
Mads.printerrormsg
— Method.
Print error message
Methods
Mads.printerrormsg(errmsg) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:382
Arguments
errmsg
: error message
#
Mads.printobservations
— Function.
Print (emit) observations in the MADS problem dictionary
Methods
Mads.printobservations(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:423Mads.printobservations(madsdata::Associative, io::IO) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:423Mads.printobservations(madsdata::Associative, filename::String; json) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:432
Arguments
filename::String
: output file nameio::IO
: output streammadsdata::Associative
: MADS problem dictionary
Keywords
json
#
Mads.pull
— Function.
Pull (checkout) the latest version of Mads modules
Methods
Mads.pull(modulename::String; kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:63Mads.pull() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:63
Arguments
modulename::String
: module name
#
Mads.push
— Function.
Push the latest version of Mads modules in the default remote repository
Methods
Mads.push(modulename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:138Mads.push() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:138
Arguments
modulename::String
: module name
#
Mads.quietoff
— Method.
Make MADS not quiet
Methods
Mads.quietoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:96
#
Mads.quieton
— Method.
Make MADS quiet
Methods
Mads.quieton() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:87
#
Mads.readasciipredictions
— Method.
Read MADS predictions from an ASCII file
Methods
Mads.readasciipredictions(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsASCII.jl:44
Arguments
filename::String
: ASCII file name
Returns:
- MADS predictions
#
Mads.readmodeloutput
— Method.
Read model outputs saved for MADS
Methods
Mads.readmodeloutput(madsdata::Associative; obskeys) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:724
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
obskeys
: observation keys [default=getobskeys(madsdata)]
#
Mads.readobservations
— Function.
Read observations
Methods
Mads.readobservations(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1057Mads.readobservations(madsdata::Associative, obskeys::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1057
Arguments
madsdata::Associative
: MADS problem dictionaryobskeys::Array{T,1} where T
: observation keys [default=getobskeys(madsdata)
]
Returns:
- dictionary with Mads observations
#
Mads.readobservations_cmads
— Method.
Read observations using C MADS dynamic library
Methods
Mads.readobservations_cmads(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-old/MadsCMads.jl:15
Arguments
madsdata::Associative
: Mads problem dictionary
Returns:
- observations
#
Mads.readyamlpredictions
— Method.
Read MADS model predictions from a YAML file filename
Methods
Mads.readyamlpredictions(filename::String; julia) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsYAML.jl:137
Arguments
filename::String
: file name
Keywords
julia
: iftrue
, usejulia
YAML library (if available); iffalse
(default), usepython
YAML library (if available)
Returns:
- data in yaml input file
#
Mads.recursivemkdir
— Method.
Create directories recursively (if does not already exist)
Methods
Mads.recursivemkdir(s::String; filename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1291
Arguments
s::String
Keywords
filename
#
Mads.recursivermdir
— Method.
Remove directories recursively
Methods
Mads.recursivermdir(s::String; filename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1325
Arguments
s::String
Keywords
filename
#
Mads.regexs2obs
— Method.
Get observations for a set of regular expressions
Methods
Mads.regexs2obs(obsline::String, regexs::Array{Regex,1}, obsnames::Array{String,1}, getparamhere::Array{Bool,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:975
Arguments
getparamhere::Array{Bool,1}
: parametersobsline::String
: observation lineobsnames::Array{String,1}
: observation namesregexs::Array{Regex,1}
: regular expressions
Returns:
obsdict
: observations
#
Mads.reload
— Method.
Reload Mads modules
Methods
Mads.reload() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:38
#
Mads.removesource!
— Function.
Remove a contamination source
Methods
Mads.removesource!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:51Mads.removesource!(madsdata::Associative, sourceid::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:51
Arguments
madsdata::Associative
: MADS problem dictionarysourceid::Int64
: source id [default=0
]
#
Mads.removesourceparameters!
— Method.
Remove contaminant source parameters
Methods
Mads.removesourceparameters!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsAnasol.jl:136
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.required
— Function.
Lists modules required by a module (Mads by default)
Methods
Mads.required(modulename::String, filtermodule::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:17Mads.required(modulename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:17Mads.required() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:17
Arguments
filtermodule::String
: filter module namemodulename::String
: module name [default="Mads"
]
Returns:
- filtered modules
#
Mads.resetmodelruns
— Method.
Reset the model runs count to be equal to zero
Methods
Mads.resetmodelruns() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:207
#
Mads.residuals
— Function.
Compute residuals
Methods
Mads.residuals(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:32Mads.residuals(madsdata::Associative, resultvec::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:6Mads.residuals(madsdata::Associative, resultdict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsLevenbergMarquardt.jl:29
Arguments
madsdata::Associative
: MADS problem dictionaryresultdict::Associative
: result dictionaryresultvec::Array{T,1} where T
: result vector
Returns:
#
Mads.restartoff
— Method.
MADS restart off
Methods
Mads.restartoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:68
#
Mads.restarton
— Method.
MADS restart on
Methods
Mads.restarton() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:59
#
Mads.reweighsamples
— Method.
Reweigh samples using importance sampling – returns a vector of log-likelihoods after reweighing
Methods
Mads.reweighsamples(madsdata::Associative, predictions::Array, oldllhoods::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:325
Arguments
madsdata::Associative
: MADS problem dictionaryoldllhoods::Array{T,1} where T
: the log likelihoods of the parameters in the old distributionpredictions::Array
: the model predictions for each of the samples
Returns:
- vector of log-likelihoods after reweighing
#
Mads.rmdir
— Method.
Remove directory
Methods
Mads.rmdir(dir::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1151
Arguments
dir::String
: directory to be removed
Keywords
path
: path of the directory [default=current path
]
#
Mads.rmfile
— Method.
Remove file
Methods
Mads.rmfile(filename::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1167
Arguments
filename::String
: file to be removed
Keywords
path
: path of the file [default=current path
]
#
Mads.rmfiles
— Method.
Remove files
Methods
Mads.rmfile(filename::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1167
Arguments
filename::String
Keywords
path
: path of the file [default=current path
]
#
Mads.rmfiles_ext
— Method.
Remove files with extension ext
Methods
Mads.rmfiles_ext(ext::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1196
Arguments
ext::String
: extension
Keywords
path
: path of the files to be removed [default=.
]
#
Mads.rmfiles_root
— Method.
Remove files with root root
Methods
Mads.rmfiles_root(root::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1209
Arguments
root::String
: root
Keywords
path
: path of the files to be removed [default=.
]
#
Mads.rosenbrock
— Method.
Rosenbrock test function
Methods
Mads.rosenbrock(x::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:43
Arguments
x::Array{T,1} where T
: parameter vector
Returns:
- test result
#
Mads.rosenbrock2_gradient_lm
— Method.
Parameter gradients of the Rosenbrock test function
Methods
Mads.rosenbrock2_gradient_lm(x::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:24
Arguments
x::Array{T,1} where T
: parameter vector
Returns:
- parameter gradients
#
Mads.rosenbrock2_lm
— Method.
Rosenbrock test function (more difficult to solve)
Methods
Mads.rosenbrock2_lm(x::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:10
Arguments
x::Array{T,1} where T
: parameter vector
#
Mads.rosenbrock_gradient!
— Method.
Parameter gradients of the Rosenbrock test function
Methods
Mads.rosenbrock_gradient!(x::Array{T,1} where T, grad::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:68
Arguments
grad::Array{T,1} where T
: gradient vectorx::Array{T,1} where T
: parameter vector
#
Mads.rosenbrock_gradient_lm
— Method.
Parameter gradients of the Rosenbrock test function for LM optimization (returns the gradients for the 2 components separately)
Methods
Mads.rosenbrock_gradient_lm(x::Array{T,1} where T; dx, center) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:85
Arguments
x::Array{T,1} where T
: parameter vector
Keywords
center
: array with parameter observations at the center applied to compute numerical derivatives [default=Array{Float64}(0)
]dx
: apply parameter step to compute numerical derivatives [default=false
]
Returns:
- parameter gradients
#
Mads.rosenbrock_hessian!
— Method.
Parameter Hessian of the Rosenbrock test function
Methods
Mads.rosenbrock_hessian!(x::Array{T,1} where T, hess::Array{T,2} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:101
Arguments
hess::Array{T,2} where T
: Hessian matrixx::Array{T,1} where T
: parameter vector
#
Mads.rosenbrock_lm
— Method.
Rosenbrock test function for LM optimization (returns the 2 components separately)
Methods
Mads.rosenbrock_lm(x::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsTestFunctions.jl:57
Arguments
x::Array{T,1} where T
: parameter vector
Returns:
- test result
#
Mads.runcmd
— Function.
Run external command and pipe stdout and stderr
Methods
Mads.runcmd(cmdstring::String; quiet, pipe, waittime) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:97Mads.runcmd(cmd::Cmd; quiet, pipe, waittime) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsExecute.jl:42
Arguments
cmd::Cmd
: command (as a julia command; e.g.ls
)cmdstring::String
: command (as a string; e.g. "ls")
Keywords
pipe
: [default=false
]quiet
: [default=Mads.quiet
]waittime
: wait time is second [default=Mads.executionwaittime
]
Returns:
- command output
- command error message
#
Mads.runremote
— Function.
Run remote command on a series of servers
Methods
Mads.runremote(cmd::String, nodenames::Array{String,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:282Mads.runremote(cmd::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:282
Arguments
cmd::String
: remote commandnodenames::Array{String,1}
: names of machines/nodes [default=madsservers
]
Returns:
- output of running remote command
#
Mads.saltelli
— Method.
Saltelli sensitivity analysis
Methods
Mads.saltelli(madsdata::Associative; N, seed, restartdir, parallel, checkpointfrequency) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:638
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
N
: number of samples [default=100
]checkpointfrequency
: check point frequency [default=N
]parallel
: set to true if the model runs should be performed in parallel [default=false
]restartdir
: directory where files will be stored containing model results for fast simulation restartsseed
: random seed [default=0
]
#
Mads.saltellibrute
— Method.
Saltelli sensitivity analysis (brute force)
Methods
Mads.saltellibrute(madsdata::Associative; N, seed, restartdir) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:450
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
N
: number of samples [default=1000
]restartdir
: directory where files will be stored containing model results for fast simulation restartsseed
: random seed [default=0
]
#
Mads.saltellibruteparallel
— Method.
Parallel version of saltellibrute
#
Mads.saltelliparallel
— Method.
Parallel version of saltelli
#
Mads.sampling
— Method.
Methods
Mads.sampling(param::Array{T,1} where T, J::Array, numsamples::Number; seed, scale) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:274
Arguments
J::Array
: Jacobian matrixnumsamples::Number
: Number of samplesparam::Array{T,1} where T
: Parameter vector
Keywords
scale
: data scaling [default=1
]seed
: random esee [default=0
]
Returns:
- generated samples (vector or array)
- vector of log-likelihoods
#
Mads.savemadsfile
— Function.
Save MADS problem dictionary madsdata
in MADS input file filename
Methods
Mads.savemadsfile(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:274Mads.savemadsfile(madsdata::Associative, filename::String; julia, observations_separate, filenameobs) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:274Mads.savemadsfile(madsdata::Associative, parameters::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:291Mads.savemadsfile(madsdata::Associative, parameters::Associative, filename::String; julia, explicit, observations_separate) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:291
Arguments
filename::String
: input file name (e.g.input_file_name.mads
)madsdata::Associative
: MADS problem dictionaryparameters::Associative
: Dictionary with parameters (optional)
Keywords
explicit
: iftrue
ignores MADS YAML file modifications and rereads the original input file [default=false
]filenameobs
julia
: iftrue
use Julia JSON module to save [default=false
]observations_separate
Example:
Mads.savemadsfile(madsdata) Mads.savemadsfile(madsdata, "test.mads") Mads.savemadsfile(madsdata, parameters, "test.mads") Mads.savemadsfile(madsdata, parameters, "test.mads", explicit=true)
#
Mads.savemcmcresults
— Method.
Save MCMC chain in a file
Methods
Mads.savemcmcresults(chain::Array, filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsMonteCarlo.jl:143
Arguments
chain::Array
: MCMC chainfilename::String
: file name
Dumps:
- the file containing MCMC chain
#
Mads.savesaltellirestart
— Method.
Save Saltelli sensitivity analysis results for fast simulation restarts
Methods
Mads.savesaltellirestart(evalmat::Array, matname::String, restartdir::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:619
Arguments
evalmat::Array
: saved arraymatname::String
: matrix (array) name (defines the name of the loaded file)restartdir::String
: directory where files will be stored containing model results for fast simulation restarts
#
Mads.scatterplotsamples
— Method.
Create histogram/scatter plots of model parameter samples
Methods
Mads.scatterplotsamples(madsdata::Associative, samples::Array{T,2} where T, filename::String; format, pointsize) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:401
Arguments
filename::String
: output file namemadsdata::Associative
: MADS problem dictionarysamples::Array{T,2} where T
: matrix with model parameters
Keywords
format
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]pointsize
: point size [default=0.9Gadfly.mm
]
Dumps:
- histogram/scatter plots of model parameter samples
#
Mads.searchdir
— Function.
Get files in the current directory or in a directory defined by path
matching pattern key
which can be a string or regular expression
Methods
Mads.searchdir(key::String; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:764Mads.searchdir(key::Regex; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:763
Arguments
key::Regex
: matching pattern for Mads input files (string or regular expression accepted)key::String
: matching pattern for Mads input files (string or regular expression accepted)
Keywords
path
: search directory for the mads input files [default=.
]
Returns:
filename
: an array with file names matching the pattern in the specified directory
Examples:
- `Mads.searchdir("a")` - `Mads.searchdir(r"[A-B]"; path = ".")` - `Mads.searchdir(r".*.cov"; path = ".")`
#
Mads.set_nprocs_per_task
— Function.
Set number of processors needed for each parallel task at each node
Methods
Mads.set_nprocs_per_task() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:50Mads.set_nprocs_per_task(local_nprocs_per_task::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:50
Arguments
local_nprocs_per_task::Integer
#
Mads.setallparamsoff!
— Method.
Set all parameters OFF
Methods
Mads.setallparamsoff!(madsdata::Associative; filter) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:474
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
filter
: parameter filter
#
Mads.setallparamson!
— Method.
Set all parameters ON
Methods
Mads.setallparamson!(madsdata::Associative; filter) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:460
Arguments
madsdata::Associative
: MADS problem dictionary
Keywords
filter
: parameter filter
#
Mads.setdebuglevel
— Method.
Set MADS debug level
Methods
Mads.setdebuglevel(level::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:178
Arguments
level::Int64
: debug level
#
Mads.setdefaultplotformat
— Method.
Set the default plot format (SVG
is the default format)
Methods
Mads.setdefaultplotformat(format::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:19
Arguments
format::String
: plot format
#
Mads.setdir
— Function.
Set the working directory (for parallel environments)
Methods
Mads.setdir() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:252Mads.setdir(dir) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:247
Arguments
dir
: directory
Example:
@everywhere Mads.setdir() @everywhere Mads.setdir("/home/monty")
#
Mads.setexecutionwaittime
— Method.
Set maximum execution wait time for forward model runs in seconds
Methods
Mads.setexecutionwaittime(waitime::Float64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:198
Arguments
waitime::Float64
: maximum execution wait time for forward model runs in seconds
#
Mads.setmadsinputfile
— Method.
Set a default MADS input file
Methods
Mads.setmadsinputfile(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:351
Arguments
filename::String
: input file name (e.g.input_file_name.mads
)
#
Mads.setmadsservers
— Function.
Generate a list of Mads servers
Methods
Mads.setmadsservers(first::Int64, last::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:337Mads.setmadsservers(first::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:337Mads.setmadsservers() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:337
Arguments
first::Int64
: first [default=0
]last::Int64
: last [default=18
]
Returns
- array string of mads servers
#
Mads.setmodelinputs
— Function.
Set model input files; delete files where model output should be saved for MADS
Methods
Mads.setmodelinputs(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:646Mads.setmodelinputs(madsdata::Associative, parameters::Associative; path) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:646
Arguments
madsdata::Associative
: MADS problem dictionaryparameters::Associative
: parameters
Keywords
path
: path for the files [default=.
]
#
Mads.setnewmadsfilename
— Function.
Set new mads file name
Methods
Mads.setnewmadsfilename(filename::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:505Mads.setnewmadsfilename(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:502
Arguments
filename::String
: file namemadsdata::Associative
: MADS problem dictionary
Returns:
- new file name
#
Mads.setobservationtargets!
— Method.
Set observations (calibration targets) in the MADS problem dictionary based on a predictions
dictionary
Methods
Mads.setobservationtargets!(madsdata::Associative, predictions::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:528
Arguments
madsdata::Associative
: Mads problem dictionarypredictions::Associative
: dictionary with model predictions
#
Mads.setobstime!
— Function.
Set observation time based on the observation name in the MADS problem dictionary
Methods
Mads.setobstime!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:253Mads.setobstime!(madsdata::Associative, separator::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:253Mads.setobstime!(madsdata::Associative, rx::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:264
Arguments
madsdata::Associative
: MADS problem dictionaryrx::Regex
: regular expression to matchseparator::String
: separator [default=_
]
Examples:
Mads.setobstime!(madsdata, "_t") Mads.setobstime!(madsdata, r"[A-x]*_t([0-9,.]+)")
#
Mads.setobsweights!
— Method.
Set observation weights in the MADS problem dictionary
Methods
Mads.setobsweights!(madsdata::Associative, value::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:299
Arguments
madsdata::Associative
: MADS problem dictionaryvalue::Number
: value for observation weights
#
Mads.setparamoff!
— Method.
Set a specific parameter with a key parameterkey
OFF
Methods
Mads.setparamoff!(madsdata::Associative, parameterkey::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:499
Arguments
madsdata::Associative
: MADS problem dictionaryparameterkey::String
: parameter key
#
Mads.setparamon!
— Method.
Set a specific parameter with a key parameterkey
ON
Methods
Mads.setparamon!(madsdata::Associative, parameterkey::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:488
Arguments
madsdata::Associative
: MADS problem dictionaryparameterkey::String
: parameter key
#
Mads.setparamsdistnormal!
— Method.
Set normal parameter distributions for all the model parameters in the MADS problem dictionary
Methods
Mads.setparamsdistnormal!(madsdata::Associative, mean::Array{T,1} where T, stddev::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:511
Arguments
madsdata::Associative
: MADS problem dictionarymean::Array{T,1} where T
: array with the mean valuesstddev::Array{T,1} where T
: array with the standard deviation values
#
Mads.setparamsdistuniform!
— Method.
Set uniform parameter distributions for all the model parameters in the MADS problem dictionary
Methods
Mads.setparamsdistuniform!(madsdata::Associative, min::Array{T,1} where T, max::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:526
Arguments
madsdata::Associative
: MADS problem dictionarymax::Array{T,1} where T
: array with the maximum valuesmin::Array{T,1} where T
: array with the minimum values
#
Mads.setparamsinit!
— Function.
Set initial optimized parameter guesses in the MADS problem dictionary
Methods
Mads.setparamsinit!(madsdata::Associative, paramdict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:324Mads.setparamsinit!(madsdata::Associative, paramdict::Associative, idx::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:324
Arguments
idx::Int64
: index of the dictionary of arrays with initial model parameter valuesmadsdata::Associative
: MADS problem dictionaryparamdict::Associative
: dictionary with initial model parameter values
#
Mads.setplotfileformat
— Method.
Set image file format
based on the filename
extension, or sets the filename
extension based on the requested format
. The default format
is SVG
. PNG
, PDF
, ESP
, and PS
are also supported.
Methods
Mads.setplotfileformat(filename::String, format::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:39
Arguments
filename::String
: output file nameformat::String
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]
Returns:
- output file name
- output plot format (
png
,pdf
, etc.)
#
Mads.setprocs
— Function.
Set the available processors based on environmental variables (supports SLURM only at the moment)
Methods
Mads.setprocs(; ntasks_per_node, nprocs_per_task, nodenames, mads_servers, test, quiet, dir, exename) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:48Mads.setprocs(np::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:45Mads.setprocs(np::Integer, nt::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsParallel.jl:32
Arguments
np::Integer
: number of processors [default=1
]nt::Integer
: number of threads[default=1
]
Keywords
dir
: common directory shared by all the jobsexename
: location of the julia executable (the same version of julia is needed on all the workers)mads_servers
: iftrue
use MADS servers (LANL only) [default=false
]nodenames
: array with names of machines/nodes to be invokednprocs_per_task
: number of processors needed for each parallel task at each node [default=Mads.nprocs_per_task
]ntasks_per_node
: number of parallel tasks per node [default=0
]quiet
: suppress output [default=Mads.quiet
]test
: test the servers and connect to each one ones at a time [default=false
]
Returns:
- vector with names of compute nodes (hosts)
Example:
Mads.setprocs() Mads.setprocs(4) Mads.setprocs(4, 8) Mads.setprocs(ntasks_per_node=4) Mads.setprocs(ntasks_per_node=32, mads_servers=true) Mads.setprocs(ntasks_per_node=64, nodenames=madsservers) Mads.setprocs(ntasks_per_node=64, nodenames=["madsmax", "madszem"]) Mads.setprocs(ntasks_per_node=64, nodenames="wc[096-157,160,175]") Mads.setprocs(ntasks_per_node=64, mads_servers=true, exename="/home/monty/bin/julia", dir="/home/monty")
#
Mads.setseed
— Function.
Set / get current random seed. seed < 0 gets seed, anything else sets it.
Methods
Mads.setseed() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:417Mads.setseed(seed::Integer) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:417Mads.setseed(seed::Integer, quiet::Bool) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:417
Arguments
quiet::Bool
: [default=true
]seed::Integer
: random seed
#
Mads.setsindx!
— Method.
Set sin-space dx
Methods
Mads.setsindx!(madsdata::Associative, sindx::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:335
Arguments
madsdata::Associative
: MADS problem dictionarysindx::Number
: sin-space dx value
Returns:
- nothing
#
Mads.setsindx
— Method.
Set sin-space dx
Methods
Mads.setsindx(sindx::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:352
Arguments
sindx::Number
Returns:
- nothing
#
Mads.setsourceinit!
— Function.
Set initial optimized parameter guesses in the MADS problem dictionary for the Source class
Methods
Mads.setparamsinit!(madsdata::Associative, paramdict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:324Mads.setparamsinit!(madsdata::Associative, paramdict::Associative, idx::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:324
Arguments
idx::Int64
: index of the dictionary of arrays with initial model parameter valuesmadsdata::Associative
: MADS problem dictionaryparamdict::Associative
: dictionary with initial model parameter values
#
Mads.settarget!
— Method.
Set observation target
Methods
Mads.settarget!(o::Associative, target::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:243
Arguments
o::Associative
: observation datatarget::Number
: observation target
#
Mads.settime!
— Method.
Set observation time
Methods
Mads.settime!(o::Associative, time::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:165
Arguments
o::Associative
: observation datatime::Number
: observation time
#
Mads.setverbositylevel
— Method.
Set MADS verbosity level
Methods
Mads.setverbositylevel(level::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:188
Arguments
level::Int64
: debug level
#
Mads.setweight!
— Method.
Set observation weight
Methods
Mads.setweight!(o::Associative, weight::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:204
Arguments
o::Associative
: observation dataweight::Number
: observation weight
#
Mads.setwellweights!
— Method.
Set well weights in the MADS problem dictionary
Methods
Mads.setwellweights!(madsdata::Associative, value::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:344
Arguments
madsdata::Associative
: MADS problem dictionaryvalue::Number
: value for well weights
#
Mads.showallparameters
— Method.
Show all parameters in the MADS problem dictionary
Methods
Mads.showallparameters(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:610
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.showobservations
— Method.
Show observations in the MADS problem dictionary
Methods
Mads.showobservations(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:403
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.showparameters
— Method.
Show parameters in the MADS problem dictionary
Methods
Mads.showparameters(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsParameters.jl:574
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.sinetransform
— Function.
Sine transformation of model parameters
Methods
Mads.sinetransform(madsdata::Associative, params::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:36Mads.sinetransform(sineparams::Array{T,1} where T, lowerbounds::Array{T,1} where T, upperbounds::Array{T,1} where T, indexlogtransformed::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:46
Arguments
indexlogtransformed::Array{T,1} where T
: index vector of log-transformed parameterslowerbounds::Array{T,1} where T
: lower boundsmadsdata::Associative
: MADS problem dictionaryparams::Array{T,1} where T
sineparams::Array{T,1} where T
: model parametersupperbounds::Array{T,1} where T
: upper bounds
Returns:
- Sine transformation of model parameters
#
Mads.sinetransformfunction
— Method.
Sine transformation of a function
Methods
Mads.sinetransformfunction(f::Function, lowerbounds::Array{T,1} where T, upperbounds::Array{T,1} where T, indexlogtransformed::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:80
Arguments
f::Function
: functionindexlogtransformed::Array{T,1} where T
: index vector of log-transformed parameterslowerbounds::Array{T,1} where T
: lower boundsupperbounds::Array{T,1} where T
: upper bounds
Returns:
- Sine transformation
#
Mads.sinetransformgradient
— Method.
Sine transformation of a gradient function
Methods
Mads.sinetransformgradient(g::Function, lowerbounds::Array{T,1} where T, upperbounds::Array{T,1} where T, indexlogtransformed::Array{T,1} where T; sindx) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSineTransformations.jl:101
Arguments
g::Function
: gradient functionindexlogtransformed::Array{T,1} where T
: index vector of log-transformed parameterslowerbounds::Array{T,1} where T
: vector with parameter lower boundsupperbounds::Array{T,1} where T
: vector with parameter upper bounds
Keywords
sindx
: sin-space parameter step applied to compute numerical derivatives [default=0.1
]
Returns:
- Sine transformation of a gradient function
#
Mads.spaghettiplot
— Function.
Generate a combined spaghetti plot for the selected
(type != null
) model parameter
Methods
Mads.spaghettiplot(madsdata::Associative, number_of_samples::Integer; kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:885Mads.spaghettiplot(madsdata::Associative, dictarray::Associative; seed, kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:889Mads.spaghettiplot(madsdata::Associative, array::Array; plotdata, filename, keyword, format, xtitle, ytitle, yfit, obs_plot_dots, linewidth, pointsize, grayscale) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:926
Arguments
array::Array
: data arrays to be plotteddictarray::Associative
: dictionary array containing the data arrays to be plottedmadsdata::Associative
: MADS problem dictionarynumber_of_samples::Integer
: number of samples
Keywords
filename
: output file name used to output the produced plotsformat
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]grayscale
keyword
: keyword to be added in the file name used to output the produced plots (iffilename
is not defined)linewidth
: width of the lines in plot [default=2Gadfly.pt
]obs_plot_dots
: plot observation as dots (true
[default] orfalse
)plotdata
: plot data (iffalse
model predictions are plotted only) [default=true
]pointsize
: size of the markers in plot [default=4Gadfly.pt
]seed
: random seed [default=0
]xtitle
:x
axis title [default=X
]yfit
: fit vertical axis range [default=false
]ytitle
:y
axis title [default=Y
]
Dumps:
- Image file with a spaghetti plot (
<mads_rootname>-<keyword>-<number_of_samples>-spaghetti.<default_image_extension>
)
Example:
Mads.spaghettiplot(madsdata, dictarray; filename="", keyword = "", format="", xtitle="X", ytitle="Y", obs_plot_dots=true) Mads.spaghettiplot(madsdata, array; filename="", keyword = "", format="", xtitle="X", ytitle="Y", obs_plot_dots=true) Mads.spaghettiplot(madsdata, number_of_samples; filename="", keyword = "", format="", xtitle="X", ytitle="Y", obs_plot_dots=true)
#
Mads.spaghettiplots
— Function.
Generate separate spaghetti plots for each selected
(type != null
) model parameter
Methods
Mads.spaghettiplots(madsdata::Associative, number_of_samples::Integer; seed, kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:726Mads.spaghettiplots(madsdata::Associative, paramdictarray::DataStructures.OrderedDict; format, keyword, xtitle, ytitle, obs_plot_dots, seed, linewidth, pointsize, grayscale) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsPlot.jl:731
Arguments
madsdata::Associative
: MADS problem dictionarynumber_of_samples::Integer
: number of samplesparamdictarray::DataStructures.OrderedDict
: parameter dictionary containing the data arrays to be plotted
Keywords
format
: output plot format (png
,pdf
, etc.) [default=Mads.graphbackend
]grayscale
keyword
: keyword to be added in the file name used to output the produced plotslinewidth
: width of the lines on the plot [default=2Gadfly.pt
]obs_plot_dots
: plot observation as dots (true
(default) orfalse
)pointsize
: size of the markers on the plot [default=4Gadfly.pt
]seed
: random seed [default=0
]xtitle
:x
axis title [default=X
]ytitle
:y
axis title [default=Y
]
Dumps:
- A series of image files with spaghetti plots for each
selected
(type != null
) model parameter (<mads_rootname>-<keyword>-<param_key>-<number_of_samples>-spaghetti.<default_image_extension>
)
Example:
Mads.spaghettiplots(madsdata, paramdictarray; format="", keyword="", xtitle="X", ytitle="Y", obs_plot_dots=true) Mads.spaghettiplots(madsdata, number_of_samples; format="", keyword="", xtitle="X", ytitle="Y", obs_plot_dots=true)
#
Mads.sphericalcov
— Method.
Spherical spatial covariance function
Methods
Mads.sphericalcov(h::Number, maxcov::Number, scale::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:43
Arguments
h::Number
: separation distancemaxcov::Number
: max covariancescale::Number
: scale
Returns:
- covariance
#
Mads.sphericalvariogram
— Method.
Spherical variogram
Methods
Mads.sphericalvariogram(h::Number, sill::Number, range::Number, nugget::Number) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsKriging.jl:59
Arguments
h::Number
: separation distancenugget::Number
: nuggetrange::Number
: rangesill::Number
: sill
Returns:
- Spherical variogram
#
Mads.sprintf
— Method.
Convert @sprintf
macro into sprintf
function
#
Mads.status
— Function.
Status of Mads modules
Methods
Mads.status(madsmodule::String; git, gitmore) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:257Mads.status(; git, gitmore) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:252
Arguments
madsmodule::String
: mads module
Keywords
git
: use git [default=true
orMads.madsgit
]gitmore
: use even more git [default=false
]
Returns:
true
orfalse
#
Mads.stderrcaptureoff
— Method.
Restore STDERR
Methods
Mads.stderrcaptureoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:140
Returns:
- standered error
#
Mads.stderrcaptureon
— Method.
Redirect STDERR to a reader
Methods
Mads.stderrcaptureon() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:121
#
Mads.stdoutcaptureoff
— Method.
Restore STDOUT
Methods
Mads.stdoutcaptureoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:106
Returns:
- standered output
#
Mads.stdoutcaptureon
— Method.
Redirect STDOUT to a reader
Methods
Mads.stdoutcaptureon() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:87
#
Mads.stdouterrcaptureoff
— Method.
Restore STDOUT & STDERR
Methods
Mads.stdouterrcaptureoff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:171
Returns:
- standered output amd standered error
#
Mads.stdouterrcaptureon
— Method.
Redirect STDOUT & STDERR to readers
Methods
Mads.stdouterrcaptureon() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsCapture.jl:155
#
Mads.svrdump
— Method.
Dump SVR models in files
Methods
Mads.svrdump(svrmodel::Array{SVR.svmmodel,1}, rootname::String, numberofsamples::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:141
Arguments
numberofsamples::Int64
: number of samplesrootname::String
: root namesvrmodel::Array{SVR.svmmodel,1}
: array of SVR models
#
Mads.svrfree
— Method.
Free SVR
Methods
Mads.svrfree(svrmodel::Array{SVR.svmmodel,1}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:123
Arguments
svrmodel::Array{SVR.svmmodel,1}
: array of SVR models
#
Mads.svrload
— Method.
Load SVR models from files
Methods
Mads.svrload(npred::Int64, rootname::String, numberofsamples::Int64) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:164
Arguments
npred::Int64
: number of model predictionsnumberofsamples::Int64
: number of samplesrootname::String
: root name
Returns:
- Array of SVR models for each model prediction
#
Mads.svrpredict
— Function.
Predict SVR
Methods
Mads.svrpredict(svrmodel::Array{SVR.svmmodel,1}, paramarray::Array{Float64,2}) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:96
Arguments
paramarray::Array{Float64,2}
: parameter arraysvrmodel::Array{SVR.svmmodel,1}
: array of SVR models
Returns:
- SVR predicted observations (dependent variables) for a given set of parameters (independent variables)
#
Mads.svrtrain
— Function.
Train SVR
Methods
Mads.svrtrain(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:39Mads.svrtrain(madsdata::Associative, paramarray::Array{Float64,2}; check, savesvr, addminmax, svm_type, kernel_type, degree, gamma, coef0, C, nu, cache_size, eps, shrinking, probability, verbose, tol) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:6Mads.svrtrain(madsdata::Associative, numberofsamples::Integer; addminmax, kw...) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSVR.jl:39
Arguments
madsdata::Associative
: MADS problem dictionarynumberofsamples::Integer
: number of random samples in the training set [default=100
]paramarray::Array{Float64,2}
Keywords
C
: cost; penalty parameter of the error term [default=1000.0
]addminmax
: add parameter minimum / maximum range values in the training set [default=true
]cache_size
: size of the kernel cache [default=100.0
]check
: check SVR performance [default=false
]coef0
: independent term in kernel function; important only in POLY and SIGMOND kernel types
[default=0
]
degree
: degree of the polynomial kernel [default=3
]eps
: epsilon in the EPSILON_SVR model; defines an epsilon-tube within which no penalty is associated in the training loss function with points predicted within a distance epsilon from the actual value [default=0.001
]gamma
: coefficient for RBF, POLY and SIGMOND kernel types [default=1/numberofsamples
]kernel_type
: kernel type[default=SVR.RBF
]nu
: upper bound on the fraction of training errors / lower bound of the fraction of support vectors; acceptable range (0, 1]; applied if NU_SVR model [default=0.5
]probability
: train to estimate probabilities [default=false
]savesvr
: save SVR models [default=false
]shrinking
: apply shrinking heuristic [default=true
]svm_type
: SVM type [default=SVR.EPSILON_SVR
]tol
: tolerance of termination criterion [default=0.001
]verbose
: verbose output [default=false
]
Returns:
- Array of SVR models
#
Mads.symlinkdir
— Method.
Create a symbolic link of a file filename
in a directory dirtarget
Methods
Mads.symlinkdir(filename::String, dirtarget::String, dirsource::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1137
Arguments
dirsource::String
dirtarget::String
: target directoryfilename::String
: file name
#
Mads.symlinkdirfiles
— Method.
Create a symbolic link of all the files in a directory dirsource
in a directory dirtarget
Methods
Mads.symlinkdirfiles(dirsource::String, dirtarget::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:1119
Arguments
dirsource::String
: source directorydirtarget::String
: target directory
#
Mads.tag
— Function.
Tag Mads modules with a default argument :patch
Methods
Mads.tag(madsmodule::String, versionsym::Symbol) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:322Mads.tag(madsmodule::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:322Mads.tag(versionsym::Symbol) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:317Mads.tag() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:317
Arguments
madsmodule::String
: mads module nameversionsym::Symbol
: version symbol [default=:patch
]
#
Mads.test
— Function.
Perform Mads tests (the tests will be in parallel if processors are defined; tests use the current Mads version in the workspace; reload("Mads.jl")
if needed)
Methods
Mads.test(testname::String; madstest) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:52Mads.test() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:52
Arguments
testname::String
: name of the test to execute; module or example
Keywords
madstest
: test Mads [default=true
]
#
Mads.testj
— Function.
Execute Mads tests using Julia Pkg.test (the default Pkg.test in Julia is executed in serial)
Methods
Mads.testj(coverage::Bool) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:11Mads.testj() in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsTest.jl:11
Arguments
coverage::Bool
: [default=false
]
#
Mads.transposematrix
— Method.
Transpose non-numeric matrix
Methods
Mads.transposematrix(a::Array{T,2} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:372
Arguments
a::Array{T,2} where T
: matrix
#
Mads.transposevector
— Method.
Transpose non-numeric vector
Methods
Mads.transposevector(a::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:362
Arguments
a::Array{T,1} where T
: vector
#
Mads.untag
— Method.
Untag specific version
Methods
Mads.untag(madsmodule::String, version::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/../src-interactive/MadsPublish.jl:357
Arguments
madsmodule::String
: mads module nameversion::String
: version
#
Mads.vectoroff
— Method.
MADS vector calls off
Methods
Mads.vectoroff() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:41
#
Mads.vectoron
— Method.
MADS vector calls on
Methods
Mads.vectoron() in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsHelpers.jl:32
#
Mads.void2nan!
— Method.
Convert Void's into NaN's in a dictionary
Methods
Mads.void2nan!(dict::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:1043
Arguments
dict::Associative
: dictionary
#
Mads.weightedstats
— Method.
Get weighted mean and variance samples
Methods
Mads.weightedstats(samples::Array, llhoods::Array{T,1} where T) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsSenstivityAnalysis.jl:382
Arguments
llhoods::Array{T,1} where T
: vector of log-likelihoodssamples::Array
: array of samples
Returns:
- vector of sample means
- vector of sample variances
#
Mads.welloff!
— Method.
Turn off a specific well in the MADS problem dictionary
Methods
Mads.welloff!(madsdata::Associative, wellname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:621
Arguments
madsdata::Associative
: MADS problem dictionarywellname::String
: name of the well to be turned off
#
Mads.wellon!
— Method.
Turn on a specific well in the MADS problem dictionary
Methods
Mads.wellon!(madsdata::Associative, wellname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:563Mads.wellon!(madsdata::Associative, rx::Regex) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:585
Arguments
madsdata::Associative
: MADS problem dictionaryrx::Regex
wellname::String
: name of the well to be turned on
#
Mads.wellon!
— Method.
Turn on a specific well in the MADS problem dictionary
Methods
Mads.wellon!(madsdata::Associative, wellname::String) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:563
Arguments
madsdata::Associative
: MADS problem dictionarywellname::String
: name of the well to be turned on
#
Mads.wells2observations!
— Method.
Convert Wells
class to Observations
class in the MADS problem dictionary
Methods
Mads.wells2observations!(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsObservations.jl:676
Arguments
madsdata::Associative
: MADS problem dictionary
#
Mads.writeparameters
— Function.
Write model parameters
Methods
Mads.writeparameters(madsdata::Associative) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:873Mads.writeparameters(madsdata::Associative, parameters::Associative; respect_space) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:873
Arguments
madsdata::Associative
: MADS problem dictionaryparameters::Associative
: parameters
Keywords
respect_space
: respect provided space in the template file to fit model parameters [default=false
]
#
Mads.writeparametersviatemplate
— Method.
Write parameters
via MADS template (templatefilename
) to an output file (outputfilename
)
Methods
Mads.writeparametersviatemplate(parameters, templatefilename, outputfilename; respect_space) in Mads
: /Users/monty/.julia/v0.6/Mads/src/MadsIO.jl:829
Arguments
outputfilename
: output file nameparameters
: parameterstemplatefilename
: tmplate file name
Keywords
respect_space
: respect provided space in the template file to fit model parameters [default=false
]
#
Mads.@stderrcapture
— Macro.
Capture STDERR of a block
#
Mads.@stdoutcapture
— Macro.
Capture STDOUT of a block
#
Mads.@stdouterrcapture
— Macro.
Capture STDERR & STDERR of a block
#
Mads.@tryimport
— Macro.
Try to import a module
#
Mads.MadsModel
— Type.
MadsModel type applied for MathProgBase analyses