Orb

التوثيق

الاحتمالات والضوضاء والتخفيف

كل عامل يستطيع برنامج .lolo استدعاءه، من السجل المعتمد الذي يضمّنه المترجم.

في هذه الصفحة

نطاقات الأسماء في هذه الصفحة: anim/, ease/, noise/, prob/.

anim/

`anim/direction-from-delta`

Facing direction string from (dx,dy); 4-way (default) or 8-way

lolo

(anim/direction-from-delta dx dy)

المعاملات

الاسم	النوع	الوصف
`dx`	`number`	X delta
`dy`	`number`	Y delta (variadic)

القيمة المعادة: string

مثال

lolo

(anim/direction-from-delta 1 0) // => "right"

`anim/frame-at`

Frame index for elapsed time; loops by default, else clamps to last

lolo

(anim/frame-at elapsed frameCount frameDuration)

المعاملات

الاسم	النوع	الوصف
`elapsed`	`number`	Elapsed time
`frameCount`	`number`	Total frame count
`frameDuration`	`number`	Duration per frame (variadic)

القيمة المعادة: number

مثال

lolo

(anim/frame-at 1000 8 100) // => 2

`anim/sheet-rect`

Source rect {sx,sy,sw,sh} for a frame index on a sprite sheet

lolo

(anim/sheet-rect frameIdx frameW frameH sheetW)

المعاملات

الاسم	النوع	الوصف
`frameIdx`	`number`	Frame index
`frameW`	`number`	Frame width
`frameH`	`number`	Frame height
`sheetW`	`number`	Sheet width

القيمة المعادة: object

مثال

lolo

(anim/sheet-rect 1 32 32 128) // => {"sx": 32, "sy": 0, "sw": 32, "sh": 32}

ease/

`ease/apply`

Apply an easing curve to t∈[0,1]: linear, in-quad, out-quad, in-out-quad, in-cubic, out-cubic, in-out-cubic, elastic-out, bounce-out (unknown → linear)

lolo

(ease/apply t curve)

المعاملات

الاسم	النوع	الوصف
`t`	`number`	Time value in [0, 1]
`curve`	`string`	Easing curve name

القيمة المعادة: number

مثال

lolo

(ease/apply 0.5 "in-quad") // => 0.25

`ease/smoothstep`

Smoothstep: clamp((x-edge0)/(edge1-edge0),0,1) then tt(3-2*t)

lolo

(ease/smoothstep x edge0 edge1)

المعاملات

الاسم	النوع	الوصف
`x`	`number`	Input value
`edge0`	`number`	Lower edge
`edge1`	`number`	Upper edge

القيمة المعادة: number

مثال

lolo

(ease/smoothstep 0.5 0 1) // => 0.5

noise/

`noise/fbm`

Fractal Brownian motion: summed perlin octaves (clamped 1..8); output [-1,1]

lolo

(noise/fbm x y octaves)

المعاملات

الاسم	النوع	الوصف
`x`	`number`	X coordinate
`y`	`number`	Y coordinate
`octaves`	`number`	Octave count (variadic)

القيمة المعادة: number

مثال

lolo

(noise/fbm 0.5 0.3 4) // => 0.234

`noise/perlin`

2D Perlin noise at (x,y) with optional seed; output [-1,1]

lolo

(noise/perlin x y)

المعاملات

الاسم	النوع	الوصف
`x`	`number`	X coordinate
`y`	`number`	Y coordinate (variadic)

القيمة المعادة: number

مثال

lolo

(noise/perlin 0.5 0.3) // => 0.123

`noise/simplex`

Value-coherent noise (perlin-derived) at (x,y) with optional seed; output [-1,1]

lolo

(noise/simplex x y)

المعاملات

الاسم	النوع	الوصف
`x`	`number`	X coordinate
`y`	`number`	Y coordinate (variadic)

القيمة المعادة: number

مثال

lolo

(noise/simplex 0.5 0.3) // => 0.567

prob/

`prob/beta`

Sample from a Beta(alpha, beta) distribution

lolo

(prob/beta alpha beta)

المعاملات

الاسم	النوع	الوصف
`alpha`	`number`	Shape parameter α > 0
`beta`	`number`	Shape parameter β > 0

القيمة المعادة: number

مثال

lolo

(prob/beta 2 5) // => value in (0, 1), mean ≈ 0.286

`prob/categorical`

Weighted random selection from items

lolo

(prob/categorical items weights)

المعاملات

الاسم	النوع	الوصف
`items`	`array`	Array of items to sample from
`weights`	`number[]`	Non-negative weights (need not sum to 1)

القيمة المعادة: any

مثال

lolo

(prob/categorical (a "b" "c") [1 2 1]) // => "b" ~50%

`prob/condition`

Mark current sample as rejected if predicate is false

lolo

(prob/condition predicate)

المعاملات

الاسم	النوع	الوصف
`predicate`	`boolean`	Condition that must hold for the sample to be accepted

القيمة المعادة: void · يعمل على: any

مثال

lolo

(prob/condition [">",5,0])

`prob/credible-interval`

Compute symmetric credible interval from samples

lolo

(prob/credible-interval samples alpha)

المعاملات

الاسم	النوع	الوصف
`samples`	`number[]`	Numeric samples
`alpha`	`number`	Significance level (e.g. 0.05 for 95% CI)

القيمة المعادة: array

مثال

lolo

(prob/credible-interval [1,2,3,4,5] 0.05) // => 95% CI

`prob/expected-value`

Mean of numeric samples

lolo

(prob/expected-value samples)

المعاملات

الاسم	النوع	الوصف
`samples`	`number[]`	Array of numeric samples

القيمة المعادة: number

مثال

lolo

(prob/expected-value [1 2 3 4]) // => 2.5

`prob/flip`

Bernoulli trial: returns true with probability p

lolo

(prob/flip p)

المعاملات

الاسم	النوع	الوصف
`p`	`number`	Probability (0.0 to 1.0)

القيمة المعادة: boolean

مثال

lolo

(prob/flip 0.7) // => true ~70% of the time

`prob/gaussian`

Sample from a Gaussian (normal) distribution

lolo

(prob/gaussian mu sigma)

المعاملات

الاسم	النوع	الوصف
`mu`	`number`	Mean
`sigma`	`number`	Standard deviation

القيمة المعادة: number

مثال

lolo

(prob/gaussian 0 1) // => standard normal sample

`prob/histogram`

Bin numeric samples into a histogram

lolo

(prob/histogram samples bins)

المعاملات

الاسم	النوع	الوصف
`samples`	`number[]`	Numeric samples
`bins`	`number`	Number of bins

القيمة المعادة: object

مثال

lolo

(prob/histogram [1,2,3,4,5] 2)

`prob/infer`

Like posterior but returns {mean, variance, samples, acceptRate}

lolo

(prob/infer model evidence query n)

المعاملات

الاسم	النوع	الوصف
`model`	`expression`	Model expression (lazy)
`evidence`	`expression`	Boolean evidence condition (lazy)
`query`	`expression`	Value to summarize (lazy)
`n`	`number`	Number of simulation runs

القيمة المعادة: object

مثال

lolo

(prob/infer ["prob/gaussian",0,1] [0.5] "mu" 5000)

`prob/percentile`

Get the p-th percentile (0-100) from samples

lolo

(prob/percentile samples p)

المعاملات

الاسم	النوع	الوصف
`samples`	`number[]`	Numeric samples
`p`	`number`	Percentile (0 to 100)

القيمة المعادة: number

مثال

lolo

(prob/percentile [1,2,3,4,5] 50) // => median

`prob/poisson`

Sample from a Poisson distribution

lolo

(prob/poisson lambda)

المعاملات

الاسم	النوع	الوصف
`lambda`	`number`	Rate parameter λ > 0

القيمة المعادة: number

مثال

lolo

(prob/poisson 4) // => integer, mean ≈ 4

`prob/posterior`

Rejection sampling: returns accepted query values

lolo

(prob/posterior model evidence query n)

المعاملات

الاسم	النوع	الوصف
`model`	`expression`	Model expression that sets entity fields (lazy)
`evidence`	`expression`	Boolean evidence condition (lazy)
`query`	`expression`	Value to collect from accepted samples (lazy)
`n`	`number`	Number of simulation runs

القيمة المعادة: array

مثال

lolo

(prob/posterior ["prob/gaussian",0,1] [0.5] "mu" 5000)

`prob/sample`

Evaluate an expression n times and collect results

lolo

(prob/sample n expr)

المعاملات

الاسم	النوع	الوصف
`n`	`number`	Number of samples
`expr`	`expression`	Expression to evaluate (lazy)

القيمة المعادة: array

مثال

lolo

(prob/sample 1000 (prob/flip 0.5))

`prob/seed`

Set seeded PRNG for deterministic probabilistic sampling

lolo

(prob/seed n)

المعاملات

الاسم	النوع	الوصف
`n`	`number`	Seed value

القيمة المعادة: void · يعمل على: any

مثال

lolo

(prob/seed 42)

`prob/uniform`

Sample from a uniform distribution [lo, hi)

lolo

(prob/uniform lo hi)

المعاملات

الاسم	النوع	الوصف
`lo`	`number`	Lower bound (inclusive)
`hi`	`number`	Upper bound (exclusive)

القيمة المعادة: number

مثال

lolo

(prob/uniform 0 1) // => value in [0, 1)

`prob/variance`

Population variance of numeric samples

lolo

(prob/variance samples)

المعاملات

الاسم	النوع	الوصف
`samples`	`number[]`	Array of numeric samples

القيمة المعادة: number

مثال

lolo

(prob/variance [2 4 4 4 5 5 7 9]) // => 4

التدفق

المكان

Orb

اللغة التي تكون فيها القاعدة هي البرنامج.

تعلّم

ابدأ التوثيق المدونة

الأدوات

ساحة التجربة المكتبة القياسية استكشف العب التنزيلات Studio

المجتمع

GitHub Discord Almadar