Diagnostics

Every problem is a diagnostic with a stable code, a message and the span of source it is about. None stops the rest of a file compiling: a value that is wrong is left off, a statement that cannot be written is left out, and the graph draws everything else.

Much of what is reported here is something Desmos would accept without a word - an unknown function name is a product of variables to it, and a colour it cannot read is ignored - which is why Axis says so instead.

Reading the file

What the lexer and the parser report. After one of these, the parser picks up again at the next line.

unexpected-character

A character no token starts with.

a = 5 $ 2

unterminated-string

A string still open at the end of its line.

"A note that never ends

invalid-escape

A string escape other than \", \\, \n.

"A \q in a note"

invalid-color

# without exactly 3 or 6 hex digits.

y = x @ color: #12

The checker reports the same code for a colour that is not one (§4.3).

y = x @ color: red

unexpected-token

A token no rule could use where it stands.

y = x )

expected-expression

An operand, element or value missing.

y = 2 +

unclosed-bracket

A (, [, expression { or \| never closed.

y = (x + 1

unclosed-block

A block { or @{ never closed.

folder "Waves" {
    y = sin(x)

expected-block

A block keyword without its {.

folder "Waves"

expected-identifier

A style or macro name, a macro parameter, or a member name missing.

style { color: RED }

expected-string

An import path, as title or image source missing.

image

expected-equals

A macro without its =.

macro double(a) 2a

expected-binding

with or for not followed by name = value.

y = a x with 3

expected-bounds

sum, prod or int not opened with name = from..to.

y = sum(n, n)

expected-property

Metadata or a block entry that does not start with a property name.

y = x @ 3

expected-colon

A property name followed by something other than : or the next entry.

y = x @ color RED

expected-value

key: with nothing after it.

y = x @ color:

comma-between-properties

Block entries separated by a comma (§4.1).

config { showGrid: false, xmin: -5 }

misplaced-metadata

Metadata trailing nothing.

folder "Waves" {
    y = sin(x)
    @ collapsed
}

Checking it

What the checker and the compiler report about a file that reads, but does not mean anything Desmos can draw.

unknown-function

A call on a name that is not a function (§5.3).

y = sine(x)

assign-to-builtin

Defining or binding a function’s name, an operator, pi, tau, e, infinity, true/false.

pi = 3

theta-equation

theta = …, which Desmos will not graph - write r = … (§5.5).

theta = 1

requires-complex-mode

real, imag, conj or arg in a graph without allowComplex: true (§5.3).

a = real(3)

requires-calculator

A function or a $ token the calculator the graph is for does not have.

A = (0, 0)
B = (4, 1)
s = segment(A, B)

statement-only

A chart or a regression ~ anywhere but as a statement of its own.

L = [1, 2, 3]
H = histogram(L)

misplaced-blank

An empty slot, [4, , 6], anywhere but a table column’s values.

L = [1, , 3]

open-range

A range with an end left off anywhere but an index (L[2...]).

L = [1...]

multiple-subscripts

A name in an expression with more than one _ part (x_1_2).

a = x_1_2

boolean-in-expression

true or false in an expression - Desmos has no booleans.

a = true + 1

dt-outside-ticker

dt anywhere but the ticker’s handler (or a macro’s body).

a = dt

rebound-variable

A sum, prod or int variable already bound where it stands.

f(k) = sum(k = 1..3, k)

unexpected-string

A string where a value belongs.

a = "one" + 1

unknown-property

A property no placement has.

y = x @ colour: RED

misplaced-property

A property this placement does not take, directly or through a style.

folder "Waves" { @ color: RED
    y = sin(x)
}

duplicate-property

A property given twice in one clause.

y = x @ color: RED, color: BLUE

invalid-value

A value of the wrong type for its property (§4.2).

y = x @ lines: 3

invalid-enum

An enum value the property does not list.

y = x @ lineStyle: WAVY

unexpected-range

A range for a property that takes none.

y = x @ lineWidth: 1..3

invalid-column

A table column that is an equation (x = 5).

table { x = 5 }

misplaced-config

config inside a folder.

folder "Settings" {
    config { showGrid: false }
}

misplaced-ticker

ticker inside a folder.

n = 0
folder "Clock" {
    ticker n -> n + 1
}

misplaced-style

style inside a folder.

folder "Styles" {
    style thick { lineWidth: 5 }
}

misplaced-macro

macro inside a folder.

folder "Macros" {
    macro double(a) = 2a
}

nested-folder

A folder inside a folder.

folder "Outer" {
    folder "Inner" { y = x }
}

duplicate-config

A second config in one file.

config { showGrid: false }
config { showGrid: true }

duplicate-ticker

A second ticker in one file.

n = 0
ticker n -> n + 1
ticker n -> n - 1

duplicate-macro

A second macro of one name anywhere in the compilation.

macro double(a) = 2a
macro double(a) = a + a

macro-collision

A macro named after a builtin, a function or a variable.

macro sin(a) = a

macro-arity

A macro used with the wrong number of arguments, or with or without () wrongly.

macro double(a) = 2a
y = double(x, 1)

macro-recursion

A macro that expands into itself.

macro loop(a) = loop(a) + 1
y = loop(x)

duplicate-style

A second style of one name anywhere in the compilation.

style thick { lineWidth: 5 }
style thick { lineWidth: 8 }

unknown-style

use: naming no style.

y = x @ use: bold

style-cycle

A style that uses itself, reported at the use: that closes the loop.

style a { use: b }
style b { use: a }

unresolved-import

An import that cannot be read.

import "./lib/missing"

import-cycle

An import that closes a cycle.

graph.axis

import "./graph"

unresolved-image

An image file that cannot be read.

image "./images/missing.png"

invalid-image

An image path that is not a picture by its extension.

image "./notes.txt"

Decompiling a graph

What the decompiler reports, as warnings, about a graph it cannot write all of in Axis. The statement is still written, with a comment where the part it could not was.

Code	What
unsupported-latex	Latex the expression tree has no node for.
unsupported-item	A list item Axis has no statement for, or an image with no URL.
unsupported-value	A colour or enum value Axis cannot write.