Ranks a model's uncertain inputs by how much each one moves a chosen outcome, and returns the data for a tornado chart. A tornado chart is a bar chart with one horizontal bar per input, sorted with the biggest swing at the top. This is a one-at-a-time (OAT) sensitivity analysis. Every input is held at its median while one input at a time is set to low, middle and high values from its own distribution (by default its 5th, 50th and 95th percentiles). The tool records how the outcome's average changes. Use this when you need to know which assumption matters most, so you know what to research or de-risk first. It returns one entry per input, ranked so rank 1 has the biggest impact. Each entry lists the input values tried, the outcome at each, and an elasticity score. Elasticity means how strongly the outcome reacts: roughly, how many percent the outcome moves when the input moves 1 percent. It returns numbers, not an image. Inputs whose distribution produces a list of values are skipped. It always returns a run_id. It runs the model once per input per value tried, so on a big model it can take minutes: if it is not done in about 40 seconds you get status running, and get_simulation_results gives you progress and then the ranking. Cost: one run's worth per call, even though the analysis runs the model many times. Without an account, 1 of your 3 free runs per UTC day, for a model up to 1,000 trials and 20 nodes; that daily allowance is counted per network address and client, so on a shared platform such as Claude.ai or ChatGPT you may find today's free runs already spent by someone else. Signed in with a free Kromatic account, 1 of 10 free runs per UTC day, for a small model up to 10,000 trials and 50 nodes, spent before any credits. Beyond that, 1 credit for a small model or 5 for a large one, currently $0.50 per credit; buy_credits tops up. A model that is invalid, or over the limits of the tier you are in, is rejected before running and costs nothing. If it fails mid-run, it depends on the tier: without an account the free run is still used up and not given back; signed in on a free run, the free run is given back; on credits, you are already charged, because this tool charges when the analysis starts.
View input schema
{
"type": "object",
"properties": {
"graph": {
"$ref": "#/$defs/PublicGraph",
"description": "The model: root_nodes (uncertain inputs), calc_nodes (formulas), edges (links; formulas refer to them like {e1}) and run_params (trials and time periods). Same format as run_monte_carlo_simulation's graph, which documents formulas, periods, distributions and financial metrics in full. Give this or graph_id, not both.",
"examples": [
{
"root_nodes": [
{
"id": "customers",
"name": "Customers per month",
"distribution_type": "normal",
"distribution_params": {
"mean": 1000,
"std": 200
}
},
{
"id": "price",
"name": "Price (USD)",
"distribution_type": "triangle",
"distribution_params": {
"min_val": 8,
"max_val": 15,
"mode_val": 10
}
}
],
"calc_nodes": [
{
"id": "revenue",
"name": "Monthly revenue",
"formula": "{e1} * {e2}"
}
],
"edges": [
{
"id": "e1",
"source": "customers",
"target": "revenue"
},
{
"id": "e2",
"source": "price",
"target": "revenue"
}
],
"run_params": {
"trials": 1000,
"time_periods": 12
}
}
],
"type": "object"
},
"graph_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The id of a graph you already saved, to analyse that graph instead of sending it inline. Give this or graph, not both. Requires a Neumann account -- an anonymous caller must use graph instead.",
"title": "Graph Id"
},
"target_node_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The id of the outcome node to measure. Defaults to the last calc node in the model, which is usually the final outcome.",
"title": "Target Node Id",
"examples": [
"revenue"
]
},
"time_period": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Index of the time period to measure, counting from 0: with 12 monthly periods, 11 is month 12. Defaults to the last period. This measures the node's value in that one period, not a total. For a cumulative figure such as year-one profit, add a running-total calc node with formula {e1} + {e2}, where e1 brings in the per-period value and e2 is an edge from the running-total node to itself with delay 1. Then target that node at index 11. This delayed self-edge is allowed; only loops with no delay are errors. In run_monte_carlo_simulation, use a cumsum metric instead.",
"title": "Time Period"
},
"quantiles": {
"anyOf": [
{
"items": {
"type": "number"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "A list of points in each input's own distribution to try. Each point is a fraction from 0 to 1 naming a percentile: 0.05 is the 5th percentile, the value 5% of outcomes fall below. Default [0.05, 0.5, 0.95]. Give this or num_quantiles, not both.",
"title": "Quantiles",
"examples": [
[
0.1,
0.5,
0.9
]
]
},
"num_quantiles": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Instead of quantiles: how many points to try, an even whole number from 2 to 10. That many percentiles are spread evenly between the 5th and 95th, and the median (0.5) is added. 2 gives [0.05, 0.5, 0.95]; 4 gives [0.05, 0.275, 0.5, 0.725, 0.95].",
"title": "Num Quantiles"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional whole number that fixes the random draws, so repeating the call gives the same result. Exact repeats are guaranteed only for small runs, where trials × nodes × time periods is at most 100,000.",
"title": "Seed"
},
"detail": {
"default": "summary",
"description": "How much to return. summary (the default): one row per input with its rank, its low and high values, the outcome at each, the swing between them and its elasticity. full: also each input's whole response curve.",
"enum": [
"summary",
"full"
],
"title": "Detail",
"type": "string"
}
},
"$defs": {
"AggregationRequest": {
"additionalProperties": false,
"description": "A financial metric over one node's whole series (npv, irr, cumsum, prob and others). See run_monte_carlo_simulation for full details and recipes.",
"properties": {
"id": {
"description": "Name for this metric in the result. Must be unique.",
"type": "string"
},
"target_node_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Node the metric reads."
},
"target_aggregation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "For prob only: id of an earlier metric to test."
},
"function": {
"description": "npv, irr, mirr, payback, discounted_payback, cagr, cumsum, terminal_value or prob.",
"type": "string"
},
"params": {
"additionalProperties": true,
"description": "The metric's settings, for example {\"rate\": 0.1} for npv. The rate is per period, so monthly periods need a monthly rate.",
"type": "object"
}
},
"required": [
"id",
"function"
],
"type": "object"
},
"CalcNode": {
"additionalProperties": false,
"description": "A formula node. See run_monte_carlo_simulation for the formula language.",
"properties": {
"id": {
"description": "Unique id for this node within the model.",
"type": "string"
},
"name": {
"default": "",
"description": "Readable label.",
"type": "string"
},
"formula": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Expression over incoming edge ids, for example '{e1} * {e2}'. See run_monte_carlo_simulation for full syntax."
}
},
"required": [
"id"
],
"type": "object"
},
"Edge": {
"additionalProperties": false,
"description": "A link that carries a value from one node (source) to another (target).",
"properties": {
"id": {
"description": "Unique id for this edge. Formulas refer to it in braces, like {e1}.",
"type": "string"
},
"source": {
"description": "Id of the node the value comes from.",
"type": "string"
},
"target": {
"description": "Id of the node the value goes to.",
"type": "string"
},
"delay": {
"default": 0,
"description": "How many periods later the value arrives. Default 0. A loop of edges, including an edge from a node to itself, is allowed only when at least one edge in it has delay 1 or more; that is how a running total carries last period's value forward.",
"minimum": 0,
"type": "integer"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional readable label."
}
},
"required": [
"id",
"source",
"target"
],
"type": "object"
},
"OutputRequest": {
"additionalProperties": false,
"description": "Result filter and financial metrics. See run_monte_carlo_simulation for full details.",
"properties": {
"nodes": {
"items": {
"type": "string"
},
"type": "array",
"description": "Node ids to include. Empty means all nodes."
},
"edges": {
"items": {
"type": "string"
},
"type": "array",
"description": "Edge ids to include. Empty means all edges."
},
"time_periods": {
"items": {
"type": "integer"
},
"type": "array",
"description": "Period indices to include, counting from 0. Empty means all."
},
"aggregations": {
"items": {
"$ref": "#/$defs/AggregationRequest"
},
"type": "array",
"description": "Financial metrics such as npv, irr, cumsum or prob."
}
},
"type": "object"
},
"PublicGraph": {
"additionalProperties": false,
"description": "A complete model. See run_monte_carlo_simulation for full details.",
"properties": {
"contract_version": {
"const": "1.0",
"default": "1.0",
"description": "Version of the model format. Always \"1.0\"; you can leave it out.",
"type": "string"
},
"root_nodes": {
"items": {
"$ref": "#/$defs/RootNode"
},
"type": "array",
"description": "The uncertain inputs."
},
"calc_nodes": {
"items": {
"$ref": "#/$defs/CalcNode"
},
"type": "array",
"description": "The formula nodes that combine values."
},
"edges": {
"items": {
"$ref": "#/$defs/Edge"
},
"type": "array",
"description": "The links between nodes."
},
"run_params": {
"$ref": "#/$defs/RunParams"
}
},
"required": [
"run_params"
],
"type": "object"
},
"RootNode": {
"additionalProperties": false,
"description": "An uncertain input that draws from a distribution each trial. See run_monte_carlo_simulation for full details.",
"oneOf": [
{
"description": "A constant value that never changes",
"properties": {
"distribution_type": {
"const": "constant"
},
"distribution_params": {
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Normal (Gaussian) distribution",
"properties": {
"distribution_type": {
"const": "normal"
},
"distribution_params": {
"properties": {
"mean": {
"type": "number"
},
"std": {
"type": "number"
}
},
"required": [
"mean",
"std"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Uniform distribution between low and high values",
"properties": {
"distribution_type": {
"const": "uniform"
},
"distribution_params": {
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
}
},
"required": [
"low",
"high"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Beta distribution for modeling probabilities and proportions",
"properties": {
"distribution_type": {
"const": "beta"
},
"distribution_params": {
"properties": {
"alpha": {
"type": "number"
},
"beta": {
"type": "number"
}
},
"required": [
"alpha",
"beta"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Gamma distribution for modeling waiting times",
"properties": {
"distribution_type": {
"const": "gamma"
},
"distribution_params": {
"properties": {
"shape": {
"type": "number"
},
"scale": {
"type": "number"
}
},
"required": [
"shape",
"scale"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Exponential distribution with scale parameter",
"properties": {
"distribution_type": {
"const": "exponential"
},
"distribution_params": {
"properties": {
"scale": {
"type": "number"
}
},
"required": [
"scale"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Poisson distribution for modeling count data",
"properties": {
"distribution_type": {
"const": "poisson"
},
"distribution_params": {
"properties": {
"lambda_val": {
"type": "number"
}
},
"required": [
"lambda_val"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Bernoulli distribution for binary outcomes",
"properties": {
"distribution_type": {
"const": "bernoulli"
},
"distribution_params": {
"properties": {
"p": {
"type": "number"
}
},
"required": [
"p"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Triangle distribution with minimum, maximum, and mode parameters",
"properties": {
"distribution_type": {
"const": "triangle"
},
"distribution_params": {
"properties": {
"min_val": {
"type": "number"
},
"max_val": {
"type": "number"
},
"mode_val": {
"type": "number"
}
},
"required": [
"min_val",
"max_val",
"mode_val"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Log-normal distribution for modeling skewed, positive-valued data",
"properties": {
"distribution_type": {
"const": "log_normal"
},
"distribution_params": {
"properties": {
"mu": {
"type": "number"
},
"sigma": {
"type": "number"
}
},
"required": [
"mu",
"sigma"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Discrete log-normal: sample log-normal then round to nearest integer (zero allowed)",
"properties": {
"distribution_type": {
"const": "discrete_lognormal"
},
"distribution_params": {
"properties": {
"mu": {
"type": "number"
},
"sigma": {
"type": "number"
}
},
"required": [
"mu",
"sigma"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Categorical distribution for discrete outcomes with custom probabilities",
"properties": {
"distribution_type": {
"const": "categorical"
},
"distribution_params": {
"properties": {
"values": {
"items": {
"type": "number"
},
"type": "array"
},
"probabilities": {
"items": {
"type": "number"
},
"type": "array"
}
},
"required": [
"values",
"probabilities"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Discrete gamma: sample gamma then round to nearest integer (zero allowed)",
"properties": {
"distribution_type": {
"const": "discrete_gamma"
},
"distribution_params": {
"properties": {
"shape": {
"type": "number"
},
"scale": {
"type": "number"
}
},
"required": [
"shape",
"scale"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Binomial distribution: the number of successes in n independent attempts",
"properties": {
"distribution_type": {
"const": "binomial"
},
"distribution_params": {
"properties": {
"n": {
"type": "integer"
},
"p": {
"type": "number"
}
},
"required": [
"n",
"p"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Dirichlet distribution for modeling correlated probabilities that sum to 1",
"properties": {
"distribution_type": {
"const": "dirichlet"
},
"distribution_params": {
"properties": {
"alpha": {
"items": {
"type": "number"
},
"type": "array"
}
},
"required": [
"alpha"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "A fixed list of values that never changes",
"properties": {
"distribution_type": {
"const": "constant_array"
},
"distribution_params": {
"properties": {
"values": {
"items": {
"type": "number"
},
"type": "array"
}
},
"required": [
"values"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Discrete normal distribution for integer-valued data with normal characteristics",
"properties": {
"distribution_type": {
"const": "discrete_normal"
},
"distribution_params": {
"properties": {
"mean": {
"type": "number"
},
"std": {
"type": "number"
}
},
"required": [
"mean",
"std"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
},
{
"description": "Multivariate normal (correlated inputs): draws a vector of correlated values per trial from a mean vector + correlation matrix + per-component standard deviations. Array-valued — feed multiple downstream calc nodes by INDEXing component k (1-based): INDEX({edge}, k).",
"properties": {
"distribution_type": {
"const": "multivariate_normal"
},
"distribution_params": {
"properties": {
"mean": {
"items": {
"type": "number"
},
"type": "array"
},
"stds": {
"items": {
"type": "number"
},
"type": "array"
},
"correlation": {
"items": {
"items": {
"type": "number"
},
"type": "array"
},
"type": "array"
}
},
"required": [
"mean",
"stds",
"correlation"
],
"type": "object"
}
},
"required": [
"distribution_type",
"distribution_params"
]
}
],
"properties": {
"id": {
"description": "Unique id for this node within the model.",
"type": "string"
},
"name": {
"default": "",
"description": "Readable label.",
"type": "string"
},
"distribution_type": {
"description": "Distribution name; allowed types and their parameters are in this schema's oneOf. See run_monte_carlo_simulation for which to pick.",
"type": "string"
},
"distribution_params": {
"additionalProperties": true,
"description": "Parameters for distribution_type, as listed in this schema's oneOf.",
"type": "object"
},
"interval": {
"default": 1,
"description": "Draw a new value every N periods; in the periods between, this input is 0 (the value is not carried forward). 1 (the default) means every period. 0 means draw once, in the first period after any delay, and 0 afterwards. To keep one value in every period, use sampling_frequency once instead.",
"minimum": 0,
"type": "integer"
},
"delay": {
"default": 0,
"description": "How many periods to wait before the first draw. Default 0.",
"minimum": 0,
"type": "integer"
},
"sampling_frequency": {
"default": "per_period",
"description": "per_period (the default) draws a new value each period. once draws one value per trial and reuses it in every period.",
"enum": [
"per_period",
"once"
],
"type": "string"
}
},
"required": [
"id",
"distribution_type",
"distribution_params"
],
"type": "object"
},
"RunParams": {
"additionalProperties": false,
"description": "How to run the model.",
"properties": {
"trials": {
"description": "Number of trials (random samples).",
"exclusiveMinimum": 0,
"type": "integer"
},
"time_periods": {
"description": "Number of time periods (a count).",
"exclusiveMinimum": 0,
"type": "integer"
},
"output_request": {
"$ref": "#/$defs/OutputRequest",
"description": "Optional result filter and financial metrics. See run_monte_carlo_simulation."
}
},
"required": [
"trials",
"time_periods"
],
"type": "object"
}
},
"title": "RankInputsByImpactInput"
}