Attributes reference

Every attribute in the tag DSL, with a one-line description and where it's covered.

The <compute> tags have attributes of their own (v, sep, as, width, fill, from, to, size, pattern, default). Each one belongs to a single tag and is covered where that tag is explained — see the compute reference.

Environment & config

Attribute	What it sets	See
version / v	The DSL version the file requires	Configuration
count	Number of records	Determinism
seed	RNG seed, for reproducibility	Determinism
local	Locale for template data	Template
inject	Custom interpolation marker	Output & formatting
mode	memory / disk — which engine family	Large outputs
engine	1 / 2 / 3 — force one engine (advanced)	Large outputs
comment	Free-form comment	Configuration

Sequences & dependencies

Attribute	What it sets	See
name	On <sequence>: its name. On <gen>: makes it a field, Sequence.Field. On <data> inside a sequence: a constant field, the only one that costs no draw	Sequences
parent	Parent filter, Parent.Value	Hierarchical dependencies
uniq	Combination that must be unique across all rows	Unique values
on / is	Subject / branch key for <switch>	Switch
filter	On <gen type="pool">: which members this row may draw from	Coherent records
of	On <gen type="running">: the column to accumulate	Running total
reset	On <gen type="running">: a column whose change restarts the total	Running total

Generator values

Attribute	What it sets	See
type	Which generator to use	Generators
value	The generator's main value (type-specific)	Generators
percent	Exact distribution of the values	Text
accumulate	Replace a repeat list with its running total, or say how a running column accumulates	Several values in a cell
alphabet	Named Unicode alphabet	Symbol
length	Output length or width	Number
first_zero	Allow a leading zero	Number
step	Counter step	Counters
regex_max_length	Length cap for a regex	Regex
include / exclude	Keep or drop values from the pool	Number
decimals	Digits after the decimal point	Number
oldest / youngest	Birthday age window	Date
format	Date output format	Date
from / to	Range endpoints, given separately	Date
precision	Step size for a date-time range	Date
range	Date range for date.range	Template

Statistical shape

Attribute	What it sets	See
distribution	Named distribution (normal, zipf, …)	Distributions
min / max	Clip the drawn values to a range	Distributions
missing	Share of rows left empty	Missing data
missing_as	How an empty cell is written	Missing data
anomaly	Share of rows turned into outliers	Anomalies
anomaly_factor	How far an outlier is pushed	Anomalies
anomaly_flag	Answer column that marks the outliers	Anomalies

Each distribution takes its own parameters, and they are only read when distribution= names that one. Every distribution also accepts decimals, min and max. Each is explained, with a histogram, on the distributions guide.

distribution=	Parameters	What they mean
normal	mean sd	The centre and the spread
lognormal	meanlog sdlog	The centre and spread of the logarithm — the value itself is skewed right
exponential	rate	Events per unit of time; the mean is 1/rate
pareto	alpha xmin	Tail thickness, and the smallest possible value
weibull	shape scale	shape below 1 = early failures, above 1 = wear-out; scale sets the typical lifetime
poisson	lambda	Average count per interval (capped at 700)
zipf	n s	How many ranks, and how steeply they fall off
gamma	shape scale	Total wait for shape events that each take scale on average
beta	alpha beta	Pull toward 1 and toward 0 — the result is between 0 and 1

Timeseries

Attribute	What it sets	See
base	Starting level of the series	Timeseries
trend	Drift per step	Timeseries
period	Length of one seasonal cycle	Timeseries
amplitude	Height of the seasonal swing	Timeseries
noise	Random jitter added on top	Timeseries

Pattern (a drawing as the source)

Attribute	What it sets	See
points	Inline x,y pairs instead of a file	Pattern
upper / lower	Two boundary curves — a corridor	Pattern
mode	signal (a trajectory) / density (a distribution)	Pattern
y_range	min..max — the vertical scale	Pattern
interp	linear / smooth / step between points	Pattern
spread	Widen the line into a band of ±N	Pattern
ink_threshold	How dark a PNG pixel has to be to count as ink	Pattern

mode is really two different attributes that share a name: on <env> it picks the engine family; on a pattern generator it picks what you're asking the drawing for.

Files & CSV

Attribute	What it sets	See
src	Path to a data file	File
column	CSV column (name or number)	File
header	Skip the first CSV row	File
delimiter	CSV separator	File
row	Linked-row key	File
weight	Frequency column for weighted rows	Coherent data

HTTP service

Attribute	What it sets	See
src	Service URL (the same attribute as the file path above)	HTTP service
in	Sequence whose value is sent with each row	HTTP service
on_error	fail (default) or empty when a request fails	HTTP service
timeout	Seconds to wait for a response (default 30)	HTTP service

Output & formatting

Attribute	What it sets	See
if	Display condition (an expression)	Output & formatting
pair	Paired marker for a literal </data>	Output & formatting
mask	Display mask (x/w/*)	Masks & case
case	Letter case (upper/lower/…)	Masks & case
order	Value order (random / sequential)	Generators
cycle	With sequential: cycle or raise an error	Generators
repeat / separator	Several values in one cell	Multiple values
each	Repeat a line for each list element	Relational tables
flag	Answer column that marks <mix> outliers	Mix