Tracking Extra Quantities

Often, there are quantities in models that we might be interested in viewing the values of, but which are not random variables in the model that are explicitly drawn from a distribution.

As a motivating example, the most natural parameterisation for a model might not be the most computationally feasible. Consider the following (efficiently reparametrized) implementation of Neal’s funnel (Neal, 2003):

using Turing
setprogress!(false)

@model function Neal()
    # Raw draws
    y_raw ~ Normal(0, 1)
    x_raw ~ arraydist([Normal(0, 1) for i in 1:9])

    # Transform:
    y = 3 * y_raw
    x = exp.(y ./ 2) .* x_raw
    return nothing
end

[ Info: [Turing]: progress logging is disabled globally

Neal (generic function with 2 methods)

In this case, the random variables exposed in the chain (x_raw, y_raw) are not in a helpful form — what we’re after are the deterministically transformed variables x and y.

There are two ways to track these extra quantities in Turing.jl.

Using := (during inference)

The first way is to use the := operator, which behaves exactly like = except that the values of the variables on its left-hand side are automatically added to the chain returned by the sampler. For example:

@model function Neal_coloneq()
    # Raw draws
    y_raw ~ Normal(0, 1)
    x_raw ~ arraydist([Normal(0, 1) for i in 1:9])

    # Transform:
    y := 3 * y_raw
    x := exp.(y ./ 2) .* x_raw
end

sample(Neal_coloneq(), NUTS(), 1000)

┌ Info: Found initial step size
└   ϵ = 1.6

Chains MCMC chain (1000×34×1 Array{Float64, 3}):

Iterations        = 501:1:1500
Number of chains  = 1
Samples per chain = 1000
Wall duration     = 6.76 seconds
Compute duration  = 6.76 seconds
parameters        = y_raw, x_raw[1], x_raw[2], x_raw[3], x_raw[4], x_raw[5], x_raw[6], x_raw[7], x_raw[8], x_raw[9], y, x[1], x[2], x[3], x[4], x[5], x[6], x[7], x[8], x[9]
internals         = n_steps, is_accept, acceptance_rate, log_density, hamiltonian_energy, hamiltonian_energy_error, max_hamiltonian_energy_error, tree_depth, numerical_error, step_size, nom_step_size, logprior, loglikelihood, logjoint

Use `describe(chains)` for summary statistics and quantiles.

Using returned (post-inference)

Alternatively, one can specify the extra quantities as part of the model function’s return statement:

@model function Neal_return()
    # Raw draws
    y_raw ~ Normal(0, 1)
    x_raw ~ arraydist([Normal(0, 1) for i in 1:9])

    # Transform and return as a NamedTuple
    y = 3 * y_raw
    x = exp.(y ./ 2) .* x_raw
    return (x=x, y=y)
end

chain = sample(Neal_return(), NUTS(), 1000)

┌ Info: Found initial step size
└   ϵ = 1.6

Chains MCMC chain (1000×24×1 Array{Float64, 3}):

Iterations        = 501:1:1500
Number of chains  = 1
Samples per chain = 1000
Wall duration     = 1.85 seconds
Compute duration  = 1.85 seconds
parameters        = y_raw, x_raw[1], x_raw[2], x_raw[3], x_raw[4], x_raw[5], x_raw[6], x_raw[7], x_raw[8], x_raw[9]
internals         = n_steps, is_accept, acceptance_rate, log_density, hamiltonian_energy, hamiltonian_energy_error, max_hamiltonian_energy_error, tree_depth, numerical_error, step_size, nom_step_size, logprior, loglikelihood, logjoint

Use `describe(chains)` for summary statistics and quantiles.

The sampled chain does not contain x and y, but we can extract the values using the returned function. Calling this function outputs an array:

nts = returned(Neal_return(), chain)

1000×1 Matrix{@NamedTuple{x::Vector{Float64}, y::Float64}}:
 (x = [-1.279828841788302, -1.009148119888461, 0.5641453008130184, 0.7567149410442471, -0.36603514197688536, 0.4641019683627904, 0.15877976908822422, 0.667854005612642, -1.0396970189505228], y = 0.5913372434814963)
 (x = [0.31101176461571944, -0.6043885744955496, 0.30564105197784125, 0.2698803490708072, -0.5923393658106203, -0.27898450257090784, -0.629246087326563, -0.6063616319286327, 1.218986926930398], y = -0.6903897536614294)
 (x = [2.555685956762442, -0.3557411098529959, 1.8579996608478657, 3.5306258088598286, 0.428898397710682, 1.4878229909940066, -2.0965563650727694, -1.4942133228826868, 3.114869458146579], y = 1.0207009782369)
 (x = [-0.32531862372807496, -0.1956776841863255, 0.885565431670694, -0.1288422786331684, -0.2932510236404427, 0.6625759098513888, -0.5955294149503607, 0.3325775438038483, 0.16990752488522154], y = -0.7462858118703879)
 (x = [-4.005011254378874, -4.291439989839579, 7.258992409368877, -3.761627138151817, -2.743712837914975, 1.6611875294137273, 0.5215535725550103, 2.075891606221512, 5.0920370052351265], y = 4.694203458872426)
 (x = [1.0289333296057106, 0.17709912253631135, -0.6098232001545533, 1.558249979306803, 0.9612377863544607, -2.8073107945721176, 2.5531600970445494, -2.2507026354017095, -2.867456738097888], y = 1.698181010592914)
 (x = [0.5842754081952017, -0.28279680735549234, 0.26672440904012873, 0.214129741637871, -0.29526334979417423, 0.44690721505734926, 1.2193854086571234, 1.183234949997869, 0.13950988794565372], y = -1.0313786311434012)
 (x = [-1.0687177402256438, 1.2017078639352685, 0.2368131934179151, 1.441340217795683, -2.779711463943109, 0.13863797546819664, 2.545056420432516, 2.819359686307698, 1.2276598396801723], y = 0.9584653539057097)
 (x = [-0.07969683002414434, 0.0502664600353028, -0.02143919482856948, 0.1002488156747315, 0.11805151888514738, -0.03613710227941051, -0.05963414017921889, 0.18077525417573514, 0.09559068224471591], y = -5.051761308840886)
 (x = [-0.012774055418700329, 0.038865166570320214, 0.07058287486354628, 0.08162251204203089, 0.10712447833206121, -0.20328034221922647, -0.08873538318222737, 0.11172332523662323, 0.012267927234921061], y = -5.217675314929977)
 ⋮
 (x = [6.958508406898423, 4.853319798658098, -1.0516181040941834, 1.7666313237369036, -0.7316030797121874, -1.630432135567438, 2.7764933742213027, 0.4773913565239272, 6.978084438501454], y = 2.271015080103742)
 (x = [-0.32568420944314036, -0.15393446833041124, 0.8043850989852327, 0.543069012602249, -0.1462138109849102, 0.5577244754337667, -0.27583113632463885, -0.2609673477020415, -0.21829479419166903], y = -1.5136293904477092)
 (x = [0.1776569665261715, 0.3682305208634114, 0.3201729856503211, 0.09476873529945556, 0.008199161434382467, 0.0801486093057969, -0.013848888244006015, -0.47635257431997036, -0.006318687948243553], y = -2.0793273063826385)
 (x = [-5.372736065886804, -9.785022495904707, -10.986264580945797, -3.0340534937724666, -0.3090695511598424, -6.000589034405911, 2.861013658479387, 13.82539466896422, 1.2207516163912537], y = 4.321636005903358)
 (x = [0.17967639842363328, 0.26771510015097455, 0.05241935087341695, 0.05708622412615258, 0.013138037842976439, 0.2709375334351289, -0.2804137874140957, -0.3013326973177941, 0.016465815028294663], y = -2.6994756305162584)
 (x = [0.17967639842363328, 0.26771510015097455, 0.05241935087341695, 0.05708622412615258, 0.013138037842976439, 0.2709375334351289, -0.2804137874140957, -0.3013326973177941, 0.016465815028294663], y = -2.6994756305162584)
 (x = [3.8963968951434325, -2.961438257349387, 1.2612618897920223, 5.4085251917682164, 1.6673122280988666, -1.9618360799705052, -4.990916038108569, 2.3249407485843085, -0.972546028643129], y = 2.0602112237676424)
 (x = [-1.0414087050455691, 0.7142438078985629, -0.25217774139763316, -1.379918977626506, -0.4586725383000816, 0.6208265195486636, 1.2950634155340075, -0.5111722422218875, -0.1323331360325071], y = -0.5848429031685893)
 (x = [-3.1296693457540474, 0.7833574522269156, -3.9816576605631453, -1.4120889266288867, 0.6667636263771769, 0.7462952165450272, 1.581694412131015, 0.1955408716027864, 0.5231254896812133], y = 0.6892633488384816)

where each element of which is a NamedTuple, as specified in the return statement of the model.

nts[1]

(x = [-1.279828841788302, -1.009148119888461, 0.5641453008130184, 0.7567149410442471, -0.36603514197688536, 0.4641019683627904, 0.15877976908822422, 0.667854005612642, -1.0396970189505228], y = 0.5913372434814963)

Which to use?

There are some pros and cons of using returned, as opposed to :=.

Firstly, returned is more flexible, as it allows you to track any type of object; := only works with variables that can be inserted into an MCMCChains.Chains object. (Notice that x is a vector, and in the first case where we used :=, reconstructing the vector value of x can also be rather annoying as the chain stores each individual element of x separately.)

A drawback is that naively using returned can lead to unnecessary computation during inference. This is because during the sampling process, the return values are also calculated (since they are part of the model function), but then thrown away. So, if the extra quantities are expensive to compute, this can be a problem.

To avoid this, you will essentially have to create two different models, one for inference and one for post-inference. The simplest way of doing this is to add a parameter to the model argument:

@model function Neal_coloneq_optional(track::Bool)
    # Raw draws
    y_raw ~ Normal(0, 1)
    x_raw ~ arraydist([Normal(0, 1) for i in 1:9])

    if track
        y = 3 * y_raw
        x = exp.(y ./ 2) .* x_raw
        return (x=x, y=y)
    else
        return nothing
    end
end

chain = sample(Neal_coloneq_optional(false), NUTS(), 1000)

┌ Info: Found initial step size
└   ϵ = 1.6

Chains MCMC chain (1000×24×1 Array{Float64, 3}):

Iterations        = 501:1:1500
Number of chains  = 1
Samples per chain = 1000
Wall duration     = 1.43 seconds
Compute duration  = 1.43 seconds
parameters        = y_raw, x_raw[1], x_raw[2], x_raw[3], x_raw[4], x_raw[5], x_raw[6], x_raw[7], x_raw[8], x_raw[9]
internals         = n_steps, is_accept, acceptance_rate, log_density, hamiltonian_energy, hamiltonian_energy_error, max_hamiltonian_energy_error, tree_depth, numerical_error, step_size, nom_step_size, logprior, loglikelihood, logjoint

Use `describe(chains)` for summary statistics and quantiles.

The above ensures that x and y are not calculated during inference, but allows us to still use returned to extract them:

returned(Neal_coloneq_optional(true), chain)

1000×1 Matrix{@NamedTuple{x::Vector{Float64}, y::Float64}}:
 (x = [0.25298417042157434, -0.07363672761737972, -0.007226498740111759, 0.08813609498592209, 0.20188047476192264, 0.1773959244540385, -0.027170869351000364, -0.09527158969901729, 0.11942129858316362], y = -3.5380926904829577)
 (x = [-0.16827209440756677, -0.07214659550107681, -0.017015266494858426, -0.25878959363567144, -0.012180362353569422, 0.20073564975346042, -0.030424124008827984, 0.3036859449828511, -0.05914090658402274], y = -3.377307073834035)
 (x = [0.16824839876518288, -0.1791659005968768, -0.3474692755793453, 0.6246073538472602, 0.6418362474732165, -0.49573483132774965, -0.08019263844885788, -0.6346985565107301, -0.27336607761285103], y = -2.137609793420912)
 (x = [-0.006428055578546081, 0.8302270426847079, -1.5314509589087584, 2.7316268803017074, 2.239509053549785, -3.3085170976558227, 2.1097196820668547, 2.1190898772493845, -2.1409482634435113], y = 0.9326888596743723)
 (x = [0.2681363812311565, -0.7247652414161156, -3.7542965070045633, 6.924804306841253, 2.2165615303889146, -3.9553107914684564, 1.4109848016072664, 3.1459871339615346, -3.273794294328042], y = 2.260045611146489)
 (x = [-3.5787087197412246, 0.5316978191448507, -4.308680896110935, 1.4534830875084268, 2.4962663337026005, -3.781717951470918, -0.6846480697240284, 2.0670086403416357, -2.1748957062940284], y = 1.6669146705650757)
 (x = [0.6203085300288883, 0.14551077731829062, 0.5879550338230178, -0.3678162850193984, -0.23959229566551815, 0.6659392071047319, 0.46506685709412215, -0.5771391967249239, 0.00795943971248231], y = -2.0078731188048753)
 (x = [-2.6415246339306284, -0.880564163914489, -1.155578025265789, 3.268090750614437, 1.5397736853869441, -0.5842715053642711, 0.15804538828167797, 2.0300612712287744, 0.8270235602669587], y = 1.2714952136824555)
 (x = [1.1957268309592908, 1.4681879383931455, 0.43446600642259753, -1.3866697995858244, -0.8233613296317168, 0.3266822204842358, -0.3625992540388319, -1.0800677007258748, -0.46272505660659075], y = 0.02257466148890952)
 (x = [0.2964419937843811, -0.07519550670732636, 0.24180124176376136, -0.045854765774591695, -0.180100034762458, 0.09440754959122379, -0.07256469072820197, -0.2707917892469089, -0.07811575185411361], y = -2.6906888940627915)
 ⋮
 (x = [-1.5820197400089644, -1.1424396393527696, -0.48140585766236677, -1.6270064520008904, 0.3007168775690372, 0.7162437198393867, -0.914328834054827, -0.15721734232929085, -0.7168149003622807], y = 0.03398017447937973)
 (x = [-2.242525228597972, -4.371160630825928, -0.9217866346673147, -3.4510193477559574, -2.0766483447980857, -4.84508778162502, -0.4303780465991134, 0.7548109808488813, -2.3598185527304802], y = 2.0218032444600915)
 (x = [0.04049139691000799, 0.11045188250891325, 0.05563842654483424, 0.12076732684172686, 0.009478028085369907, -0.08006221664990894, -0.16692071192334196, -0.00499572017365317, -0.06344875242387207], y = -4.696024881650329)
 (x = [-5.674768947352794, 5.549864566407237, 0.7512111779358575, -3.5593485171054122, 2.204053670661671, -2.673079309247125, -6.099881885586225, 4.860884689909499, -3.1919046097784043], y = 2.8795240161725046)
 (x = [-1.2303348184954086, -1.782432309401633, -1.9889490856659693, -2.0865391820343455, 0.39314682994581035, 0.9407942235632144, 1.8138933575905967, -1.9043884985890154, 3.6369853621391997], y = 1.8584097855530226)
 (x = [-0.0955658722900495, -0.5856481148799558, -0.42329044552216644, 0.6934363364100559, -0.27593793194920835, -0.4799556965228761, 0.8948411305804456, -0.18800991815701265, 0.06881493470871299], y = 0.21362337066100157)
 (x = [0.06115446680585134, 0.3574449585403746, -0.039198857431926734, 0.09075388707426578, 0.43674097628902797, 0.1220750286204073, 0.10521915287885936, -0.09894144800287258, -0.0739661626009714], y = -2.8448710408716567)
 (x = [-0.013997807526856327, 0.0725115151219144, -0.5687528191280482, 0.364681530223673, 0.1788969215460386, -0.1785615599275034, 0.5056278406114548, 0.1791190473138375, 0.2418674683132894], y = -2.3135436178500903)
 (x = [1.7011995820536931, 6.138952014466544, 0.007415659814763397, -2.762196010470731, -1.0233919294378113, -4.704973025583355, 3.9406240754340205, 0.638538276421202, 4.540484482824409], y = 2.668982213874514)

Another equivalent option is to use a submodel:

@model function Neal()
    y_raw ~ Normal(0, 1)
    x_raw ~ arraydist([Normal(0, 1) for i in 1:9])
    return (x_raw=x_raw, y_raw=y_raw)
end

chain = sample(Neal(), NUTS(), 1000)

@model function Neal_with_extras()
    neal ~ to_submodel(Neal(), false)
    y = 3 * neal.y_raw
    x = exp.(y ./ 2) .* neal.x_raw
    return (x=x, y=y)
end

returned(Neal_with_extras(), chain)

┌ Info: Found initial step size
└   ϵ = 1.6

1000×1 Matrix{@NamedTuple{x::Vector{Float64}, y::Float64}}:
 (x = [1.3415363881569977, 1.224689853254873, -1.644983847278625, -0.14848488237436577, 1.0374324465859153, 0.582148338463087, 0.20801684178199997, -0.03610408067961019, 0.15043770497402234], y = -0.34499963611693313)
 (x = [1.758221047483127, 1.2617077768134115, -1.4584961748988847, -0.4904555968936038, 0.5846650869378061, 0.6600345931805897, -0.5844890141423927, 0.03530961645298948, 0.6845485075230878], y = -0.11880999440065923)
 (x = [-3.736162332142526, -0.8486288912893031, 1.9450913507327647, -1.7803719907788427, -0.05072678139627535, -0.6093170751626684, -0.11146561913492556, 1.895993420665504, 0.5443982611322487], y = 0.5641167782984953)
 (x = [0.7899672934527553, 0.24421436715000588, 2.935591370336699, 0.7525808220173597, 0.02794849268832156, 2.5072069836249624, -0.6341456295651321, 1.8871912495750625, -1.3393865963378289], y = 0.49609374040229837)
 (x = [1.8248854860556767, -1.1856433933094483, 4.087546718156288, 3.0188393799523885, 3.286962278849985, 7.703693103904897, -4.737299985461982, 0.1974522703260214, -1.8884069972745923], y = 2.4565726700037493)
 (x = [-0.06510598622535606, 0.14919056995011698, -0.38598124573997544, -0.1474137469864979, -0.061854489365740936, -0.6220821335282791, 0.45483058124055686, -0.1902758858099767, 0.3884407361966625], y = -2.576204187644368)
 (x = [1.5620203144808191, -2.6259666126839787, 3.4694984761452203, 0.8895047523274214, -0.307606883860488, 3.336846473756857, -2.8273682721156224, 2.2681643972139156, -4.680310401309133], y = 2.1403555109661623)
 (x = [-0.06127492698265447, 0.447632642836144, -0.28203455493062835, -0.14090419537426277, 0.20995735804863835, -0.5760885104198591, 0.6926965578863539, 0.3006000149702584, -0.19540773078872975], y = -2.3048430378678555)
 (x = [-0.03751556963026086, 0.0032991158850026545, 0.21755751952732008, 0.10947851284454053, -0.19674208780269564, -0.2424119974671654, 0.09906994468634377, -0.09690739666895341, 0.019707854055241603], y = -4.232217987805666)
 (x = [13.642117132566252, 6.005012525732663, 8.631857309807993, -4.183044925224528, -4.062377443804092, -7.939059540243257, -1.9481001342107573, 4.256129697620345, -9.36878552082984], y = 3.4582631381528497)
 ⋮
 (x = [0.1381357528165754, 0.14609130627505162, 0.12424759023489841, -0.06684218931170502, -0.15643638192285897, 0.03577899586629029, 0.09307646627547977, 0.021021938015837703, -0.03959441257102642], y = -4.553534671782295)
 (x = [8.65760445503089, -6.612194798725665, 1.235391050262419, -2.9330309987680994, -13.036451679709716, -2.777752365373211, -0.8195978822823934, -4.2190444610520625, -0.6523295311449303], y = 3.1943385956857524)
 (x = [1.3400940384540156, -2.572056671096118, -2.4720038213624327, 0.4853204430971618, -0.36394684174480424, -1.4992226158297641, 1.079855053822037, 0.9975544250427967, -0.2773532677311102], y = 1.2412386149776862)
 (x = [-0.0683026131095643, 0.02357984703842127, -0.00492200416207323, 0.1251019267679645, 0.17379403027117735, -0.3592041578488452, 0.06583061146764183, 0.03567148895527026, -0.060253126251966216], y = -3.4227145095686993)
 (x = [1.744547900348205, 2.3939440169214006, 0.15728289592630665, -3.736779970715305, -0.7260835471201749, 17.004478885302227, 3.184247381773193, 0.4791497206384802, -0.3882143435035895], y = 4.31026245621193)
 (x = [-2.0766938913268995, 1.9874369411951358, -4.030638424035272, -3.9624361471513785, 2.4195760767701624, 9.860856624964597, -1.1980074352534396, -4.934817788449043, -2.184715121138677], y = 2.1758860374514652)
 (x = [-1.503846812055238, -0.27263050488239127, 0.2726034646156755, -0.1971349929857872, -0.22624978530805998, -3.532886269429979, 0.16155897318532927, 2.2263770287424944, -0.9466230648817746], y = 0.24883186321941386)
 (x = [2.689033688931907, -3.679877018692915, -3.232622741241792, 1.399110473274238, -4.563136771943111, 10.870780965808098, -0.19441388579427318, -3.747092615243402, -2.291815778338103], y = 3.471063882920192)
 (x = [2.1722987451724913, 1.6550453510109946, 2.527382599192023, -0.2916595230209529, 3.4264103632296607, -1.1147944705077275, 1.386904061297895, -1.5782858449725954, 0.22186246687525682], y = 2.082495130946504)

Note that for the returned call to work, the Neal_with_extras() model must have the same variable names as stored in chain. This means the submodel Neal() must not be prefixed, i.e. to_submodel() must be passed a second parameter false.