# MIME's errors

Every code MIME gives, by its class. Each error's last line names its page. A code marked *no test names this code* is one no file under `tests/` names; a test may raise it without naming it, and until the hook that records what a test raises lands, the mark says names, never raises.

## user

The script can change it: the error says what happened in the experiment's names, and what to write instead.

- [`asset.audit`](asset.audit.md)
- [`asset.derivation-check`](asset.derivation-check.md)
- [`asset.locations-file`](asset.locations-file.md)
- [`asset.lock`](asset.lock.md)
- [`asset.manifest`](asset.manifest.md)
- [`asset.offline-setting`](asset.offline-setting.md)
- [`asset.reference`](asset.reference.md)
- [`asset.unknown`](asset.unknown.md)
- [`asset.unknown-role`](asset.unknown-role.md)
- [`binding.missing`](binding.missing.md)
- [`binding.moving-surface`](binding.moving-surface.md)
- [`binding.unknown`](binding.unknown.md)
- [`binding.unknown-role`](binding.unknown-role.md)
- [`binding.wrong-kind`](binding.wrong-kind.md)
- [`bundle.changed`](bundle.changed.md)
- [`bundle.credential`](bundle.credential.md)
- [`bundle.file-too-large`](bundle.file-too-large.md)
- [`bundle.lock-terms`](bundle.lock-terms.md)
- [`bundle.machine-path`](bundle.machine-path.md)
- [`bundle.manifest`](bundle.manifest.md)
- [`bundle.name-collision`](bundle.name-collision.md)
- [`bundle.no-location`](bundle.no-location.md)
- [`bundle.output-inside`](bundle.output-inside.md)
- [`bundle.referenced-copy`](bundle.referenced-copy.md)
- [`bundle.special-file`](bundle.special-file.md)
- [`bundle.stray-file`](bundle.stray-file.md)
- [`bundle.unreadable`](bundle.unreadable.md)
- [`bundle.unsafe`](bundle.unsafe.md)
- [`bundle.unscannable`](bundle.unscannable.md)
- [`call.missing-setting`](call.missing-setting.md)
- [`call.renamed`](call.renamed.md)
- [`call.units`](call.units.md)
- [`call.wrong-type`](call.wrong-type.md)
- [`chain.armature`](chain.armature.md)
- [`chain.articulated-payload`](chain.articulated-payload.md)
- [`chain.closed-loop`](chain.closed-loop.md)
- [`chain.fixed-base`](chain.fixed-base.md)
- [`chain.inertia-gap`](chain.inertia-gap.md)
- [`chain.initial`](chain.initial.md)
- [`chain.massless-joint`](chain.massless-joint.md)
- [`chain.mount`](chain.mount.md)
- [`chain.mount-first`](chain.mount-first.md)
- [`chain.mount-rates`](chain.mount-rates.md)
- [`chain.not-a-segment`](chain.not-a-segment.md)
- [`chain.orientation`](chain.orientation.md)
- [`chain.segment-name`](chain.segment-name.md)
- [`chain.spinner-speed`](chain.spinner-speed.md)
- [`chain.spinner-tilted`](chain.spinner-tilted.md)
- [`chain.spinner-unbalanced`](chain.spinner-unbalanced.md)
- [`command.ambiguous`](command.ambiguous.md) (no test names this code)
- [`command.undriven`](command.undriven.md)
- [`command.unknown`](command.unknown.md)
- [`conditions.form`](conditions.form.md)
- [`conditions.tolerance`](conditions.tolerance.md)
- [`conditions.units`](conditions.units.md)
- [`conditions.value`](conditions.value.md)
- [`confinement.hull-not-held`](confinement.hull-not-held.md)
- [`confinement.more-than-one`](confinement.more-than-one.md)
- [`confinement.moving-surface`](confinement.moving-surface.md)
- [`confinement.no-hull`](confinement.no-hull.md)
- [`confinement.rule`](confinement.rule.md)
- [`confinement.spacing-short`](confinement.spacing-short.md)
- [`confinement.surface-shape`](confinement.surface-shape.md)
- [`control.law-raised`](control.law-raised.md)
- [`control.law-traced-branch`](control.law-traced-branch.md)
- [`control.law-writes`](control.law-writes.md)
- [`controller.impure`](controller.impure.md)
- [`controller.labels`](controller.labels.md)
- [`controller.latency`](controller.latency.md)
- [`controller.mode-unbuilt`](controller.mode-unbuilt.md)
- [`controller.mode-unknown`](controller.mode-unknown.md)
- [`controller.more-than-one`](controller.more-than-one.md)
- [`controller.read-refused`](controller.read-refused.md)
- [`controller.read-unknown`](controller.read-unknown.md)
- [`controller.signal`](controller.signal.md)
- [`controller.unreached-read`](controller.unreached-read.md)
- [`controller.untraceable`](controller.untraceable.md)
- [`controller.write-unknown`](controller.write-unknown.md)
- [`controller.written-twice`](controller.written-twice.md)
- [`credentials.in-git-tree`](credentials.in-git-tree.md)
- [`credentials.service`](credentials.service.md)
- [`credentials.token`](credentials.token.md)
- [`description.changed`](description.changed.md)
- [`description.invalid`](description.invalid.md)
- [`description.missing`](description.missing.md)
- [`description.refused`](description.refused.md)
- [`drag.body-kind`](drag.body-kind.md)
- [`drag.empty-cell`](drag.empty-cell.md)
- [`drag.mrs-indefinite`](drag.mrs-indefinite.md)
- [`drag.mrs-on-wall`](drag.mrs-on-wall.md)
- [`drag.mrs-quadrature`](drag.mrs-quadrature.md)
- [`drag.mrs-resistance`](drag.mrs-resistance.md)
- [`drag.no-axis`](drag.no-axis.md)
- [`drag.no-region`](drag.no-region.md)
- [`drag.no-samples`](drag.no-samples.md)
- [`drag.outside-training`](drag.outside-training.md)
- [`drag.patches`](drag.patches.md)
- [`drag.wall-kind`](drag.wall-kind.md)
- [`drag.wall-range`](drag.wall-range.md)
- [`dynamics.wrong-thing`](dynamics.wrong-thing.md) (no test names this code)
- [`entry.unregistered`](entry.unregistered.md)
- [`env.gpu-type`](env.gpu-type.md)
- [`env.lab`](env.lab.md)
- [`env.lock`](env.lock.md)
- [`env.precision`](env.precision.md)
- [`env.python`](env.python.md)
- [`env.runner`](env.runner.md)
- [`env.variant`](env.variant.md)
- [`experiment.name`](experiment.name.md)
- [`frame.gravity-invalid`](frame.gravity-invalid.md) (no test names this code)
- [`frame.gravity-missing`](frame.gravity-missing.md)
- [`frame.gravity-units`](frame.gravity-units.md)
- [`frame.up-invalid`](frame.up-invalid.md)
- [`frame.up-missing`](frame.up-missing.md)
- [`frame.up-not-y-or-z`](frame.up-not-y-or-z.md)
- [`frame.up-on-experiment`](frame.up-on-experiment.md)
- [`frame.up-twice`](frame.up-twice.md)
- [`generator.near-wall-edge-open`](generator.near-wall-edge-open.md)
- [`generator.no-cases`](generator.no-cases.md)
- [`generator.outside-domain`](generator.outside-domain.md)
- [`geometry.moving-read`](geometry.moving-read.md)
- [`geometry.native`](geometry.native.md)
- [`geometry.schema-incomplete`](geometry.schema-incomplete.md)
- [`geometry.schema-not-applied`](geometry.schema-not-applied.md)
- [`geometry.unknown-kind`](geometry.unknown-kind.md)
- [`group.no-dynamics`](group.no-dynamics.md) (no test names this code)
- [`group.rates`](group.rates.md)
- [`group.settings`](group.settings.md)
- [`id.duplicate`](id.duplicate.md)
- [`live.chunk`](live.chunk.md)
- [`live.command`](live.command.md)
- [`live.input-mode`](live.input-mode.md)
- [`live.input-unknown`](live.input-unknown.md)
- [`live.input-value`](live.input-value.md)
- [`live.log`](live.log.md)
- [`live.pace`](live.pace.md)
- [`live.protocol`](live.protocol.md)
- [`live.record`](live.record.md)
- [`live.remote-bind`](live.remote-bind.md)
- [`live.select`](live.select.md)
- [`live.stage-writer`](live.stage-writer.md)
- [`live.state`](live.state.md)
- [`live.step`](live.step.md)
- [`live.stopped`](live.stopped.md)
- [`live.timeout`](live.timeout.md)
- [`live.watch`](live.watch.md)
- [`load.asset-changed`](load.asset-changed.md)
- [`load.assets`](load.assets.md)
- [`load.code-in-document`](load.code-in-document.md)
- [`load.document-encoding`](load.document-encoding.md)
- [`load.document-material`](load.document-material.md)
- [`load.document-shape`](load.document-shape.md)
- [`load.document-thing`](load.document-thing.md)
- [`load.document-yaml`](load.document-yaml.md)
- [`load.id`](load.id.md)
- [`load.input-hash`](load.input-hash.md)
- [`load.lock`](load.lock.md)
- [`load.lock-shape`](load.lock-shape.md)
- [`load.missing-file`](load.missing-file.md)
- [`load.missing-folder`](load.missing-folder.md)
- [`load.newer-form`](load.newer-form.md)
- [`load.record-changed`](load.record-changed.md)
- [`load.reference`](load.reference.md)
- [`load.reference-changed`](load.reference-changed.md)
- [`load.setting`](load.setting.md)
- [`load.setting-unknown`](load.setting-unknown.md)
- [`load.stage-changed`](load.stage-changed.md)
- [`load.units`](load.units.md)
- [`lubrication.twice`](lubrication.twice.md)
- [`magnet.direction`](magnet.direction.md)
- [`magnet.direction-missing`](magnet.direction-missing.md)
- [`magnet.direction-twice`](magnet.direction-twice.md)
- [`magnet.no-part`](magnet.no-part.md) (no test names this code)
- [`magnet.no-prim`](magnet.no-prim.md)
- [`magnet.part`](magnet.part.md)
- [`magnet.part-missing`](magnet.part-missing.md) (no test names this code)
- [`magnet.role`](magnet.role.md) (no test names this code)
- [`magnet.schema-incomplete`](magnet.schema-incomplete.md)
- [`magnet.schema-not-applied`](magnet.schema-not-applied.md)
- [`magnet.several`](magnet.several.md)
- [`material.accept`](material.accept.md) (no test names this code)
- [`material.accept-pending`](material.accept-pending.md)
- [`material.extrapolation`](material.extrapolation.md) (no test names this code)
- [`material.file`](material.file.md) (no test names this code)
- [`material.file-name`](material.file-name.md) (no test names this code)
- [`material.name`](material.name.md)
- [`material.nominal`](material.nominal.md) (no test names this code)
- [`material.nominal-pending`](material.nominal-pending.md)
- [`material.not-a-record`](material.not-a-record.md) (no test names this code)
- [`material.require`](material.require.md) (no test names this code)
- [`observation.field-read`](observation.field-read.md)
- [`part.apparatus-material`](part.apparatus-material.md)
- [`part.at`](part.at.md) (no test names this code)
- [`part.at-on-asset`](part.at-on-asset.md) (no test names this code)
- [`part.inside`](part.inside.md) (no test names this code)
- [`part.missing`](part.missing.md) (no test names this code)
- [`part.mount`](part.mount.md)
- [`part.name`](part.name.md)
- [`part.not-a-part`](part.not-a-part.md) (no test names this code)
- [`part.not-a-solid`](part.not-a-solid.md) (no test names this code)
- [`part.scaled`](part.scaled.md) (no test names this code)
- [`parts.centre-of-mass`](parts.centre-of-mass.md)
- [`parts.density`](parts.density.md)
- [`parts.extent`](parts.extent.md)
- [`parts.inertia-axes`](parts.inertia-axes.md)
- [`parts.no-bulk`](parts.no-bulk.md) (no test names this code)
- [`parts.no-magnet`](parts.no-magnet.md) (no test names this code)
- [`parts.several-magnets`](parts.several-magnets.md)
- [`profile.reserved`](profile.reserved.md)
- [`profile.unknown`](profile.unknown.md)
- [`provider.part`](provider.part.md)
- [`provider.reader-inside`](provider.reader-inside.md)
- [`pull.assets-large`](pull.assets-large.md)
- [`pull.destination`](pull.destination.md)
- [`pull.restricted`](pull.restricted.md)
- [`pull.sandbox-doi`](pull.sandbox-doi.md)
- [`pull.source`](pull.source.md)
- [`push.confirm-stale`](push.confirm-stale.md)
- [`push.creators`](push.creators.md)
- [`push.draft-changed`](push.draft-changed.md)
- [`push.draft-foreign`](push.draft-foreign.md)
- [`push.draft-moved`](push.draft-moved.md)
- [`push.folder-changed`](push.folder-changed.md)
- [`push.licence`](push.licence.md)
- [`push.lock-changed`](push.lock-changed.md)
- [`push.lock-unwritten`](push.lock-unwritten.md)
- [`push.metadata-changed`](push.metadata-changed.md)
- [`push.metadata-edited`](push.metadata-edited.md)
- [`push.no-draft`](push.no-draft.md)
- [`push.not-confirmed`](push.not-confirmed.md)
- [`push.permission`](push.permission.md)
- [`push.permission-unconfirmed`](push.permission-unconfirmed.md)
- [`push.published`](push.published.md)
- [`push.referenced-copy`](push.referenced-copy.md)
- [`push.rejected`](push.rejected.md)
- [`push.sandbox-location`](push.sandbox-location.md)
- [`push.second-concept`](push.second-concept.md)
- [`push.service`](push.service.md)
- [`push.setup`](push.setup.md)
- [`push.sharing`](push.sharing.md)
- [`push.sharing-missing`](push.sharing-missing.md)
- [`push.too-large`](push.too-large.md)
- [`push.too-many-files`](push.too-many-files.md)
- [`push.unconfirmed`](push.unconfirmed.md)
- [`read.not-published`](read.not-published.md)
- [`record.changed`](record.changed.md)
- [`record.extrapolation`](record.extrapolation.md) (no test names this code)
- [`record.file`](record.file.md)
- [`record.form`](record.form.md) (no test names this code)
- [`record.no-pick`](record.no-pick.md)
- [`record.nominal`](record.nominal.md) (no test names this code)
- [`record.not-an-interval`](record.not-an-interval.md) (no test names this code)
- [`record.not-met`](record.not-met.md)
- [`record.not-read`](record.not-read.md) (no test names this code)
- [`record.outside-bounds`](record.outside-bounds.md)
- [`record.unit`](record.unit.md) (no test names this code)
- [`record.unknown`](record.unknown.md)
- [`record.unreadable`](record.unreadable.md) (no test names this code)
- [`registration.not-accepted`](registration.not-accepted.md)
- [`result.format`](result.format.md)
- [`result.matlab-name`](result.matlab-name.md)
- [`result.no-observation`](result.no-observation.md)
- [`result.no-output`](result.no-output.md)
- [`result.not-a-run-folder`](result.not-a-run-folder.md)
- [`result.not-recorded`](result.not-recorded.md)
- [`result.table`](result.table.md)
- [`result.window`](result.window.md)
- [`run.chunks`](run.chunks.md)
- [`run.dt-invalid`](run.dt-invalid.md)
- [`run.dt-missing`](run.dt-missing.md)
- [`run.dt-units`](run.dt-units.md)
- [`run.duration`](run.duration.md)
- [`run.every`](run.every.md)
- [`run.no-node-at-dt`](run.no-node-at-dt.md)
- [`run.non-finite`](run.non-finite.md)
- [`run.nothing-to-step`](run.nothing-to-step.md)
- [`run.out-over-source`](run.out-over-source.md)
- [`run.rate-not-multiple`](run.rate-not-multiple.md)
- [`run.rate-units`](run.rate-units.md)
- [`run.record`](run.record.md)
- [`run.seed`](run.seed.md) (no test names this code)
- [`run.stage-every`](run.stage-every.md)
- [`run.window-past-end`](run.window-past-end.md)
- [`rung.missing`](rung.missing.md)
- [`rung.reserved`](rung.reserved.md)
- [`rung.unknown`](rung.unknown.md)
- [`save.not-loadable`](save.not-loadable.md)
- [`save.unsavable`](save.unsavable.md)
- [`scene.asset-changed`](scene.asset-changed.md)
- [`scene.asset-default-prim`](scene.asset-default-prim.md)
- [`scene.asset-dependencies`](scene.asset-dependencies.md) (no test names this code)
- [`scene.asset-missing`](scene.asset-missing.md) (no test names this code)
- [`scene.asset-name`](scene.asset-name.md) (no test names this code)
- [`scene.asset-units`](scene.asset-units.md)
- [`scene.asset-unreadable`](scene.asset-unreadable.md) (no test names this code)
- [`scene.not-a-scene`](scene.not-a-scene.md) (no test names this code)
- [`scene.reference-path`](scene.reference-path.md)
- [`scene.stage-first`](scene.stage-first.md)
- [`scene.units`](scene.units.md)
- [`setting.direction`](setting.direction.md)
- [`setting.evidence-required`](setting.evidence-required.md)
- [`setting.numerical-default`](setting.numerical-default.md)
- [`setting.source-required`](setting.source-required.md)
- [`setting.undeclared-default`](setting.undeclared-default.md)
- [`setting.units`](setting.units.md)
- [`setting.value`](setting.value.md)
- [`source.duplicate`](source.duplicate.md)
- [`source.no-site`](source.no-site.md)
- [`source.pending`](source.pending.md)
- [`source.reason`](source.reason.md)
- [`source.unknown`](source.unknown.md)
- [`state.missing`](state.missing.md)
- [`state.outside-region`](state.outside-region.md)
- [`state.units`](state.units.md)
- [`state.unknown`](state.unknown.md)
- [`state.value`](state.value.md)
- [`support.unsupported`](support.unsupported.md)
- [`target.chain-link`](target.chain-link.md)
- [`target.exclusive`](target.exclusive.md)
- [`target.kinematic-chain`](target.kinematic-chain.md)
- [`target.not-accepted`](target.not-accepted.md)
- [`terms.custom-licence`](terms.custom-licence.md)
- [`terms.file`](terms.file.md)
- [`terms.licence`](terms.licence.md)
- [`terms.origin`](terms.origin.md)
- [`terms.permission`](terms.permission.md)
- [`thing.duplicate`](thing.duplicate.md)
- [`thing.duplicate-prim`](thing.duplicate-prim.md)
- [`thing.field-name`](thing.field-name.md) (no test names this code)
- [`thing.name`](thing.name.md)
- [`thing.prim`](thing.prim.md) (no test names this code)
- [`thing.prim-inside-asset`](thing.prim-inside-asset.md)
- [`thing.prim-missing`](thing.prim-missing.md)
- [`thing.prim-taken`](thing.prim-taken.md)
- [`value.duplicate`](value.duplicate.md)
- [`value.from-kind`](value.from-kind.md)
- [`value.not-positive`](value.not-positive.md)
- [`value.reason`](value.reason.md)
- [`value.reason-pending`](value.reason-pending.md)
- [`value.undeclared`](value.undeclared.md)
- [`value.units`](value.units.md)
- [`value.unknown`](value.unknown.md)
- [`value.unknown-part`](value.unknown-part.md) (no test names this code)
- [`value.unknown-thing`](value.unknown-thing.md)
- [`verify.nothing-saved`](verify.nothing-saved.md)
- [`visuals.no-stage`](visuals.no-stage.md)
- [`visuals.not-shareable`](visuals.not-shareable.md)
- [`visuals.unknown-set`](visuals.unknown-set.md)
- [`visuals.web-out`](visuals.web-out.md)
- [`vocabulary.reserved`](vocabulary.reserved.md)

## environment

Something the run needs is missing or different where it runs (a package, a file, a device, the network): the error names what to install, fetch or attach.

- [`asset.conflict`](asset.conflict.md)
- [`asset.hash-mismatch`](asset.hash-mismatch.md)
- [`asset.manifest`](asset.manifest.md)
- [`asset.missing`](asset.missing.md)
- [`asset.offline`](asset.offline.md)
- [`asset.placed-file`](asset.placed-file.md)
- [`asset.size-exceeded`](asset.size-exceeded.md)
- [`asset.unreachable`](asset.unreachable.md)
- [`credentials.file-mode`](credentials.file-mode.md)
- [`credentials.store`](credentials.store.md)
- [`env.device`](env.device.md)
- [`env.missing`](env.missing.md)
- [`env.os`](env.os.md)
- [`env.pin`](env.pin.md)
- [`env.python`](env.python.md)
- [`env.shadow`](env.shadow.md)
- [`env.unpinned`](env.unpinned.md)
- [`live.address-in-use`](live.address-in-use.md)
- [`live.transport`](live.transport.md)
- [`load.assets`](load.assets.md)
- [`load.derived-hash`](load.derived-hash.md)
- [`load.input-hash`](load.input-hash.md)
- [`load.namespace-import`](load.namespace-import.md) (no test names this code)
- [`load.stage-hash`](load.stage-hash.md)
- [`load.stage-writer`](load.stage-writer.md)
- [`load.unknown-entry`](load.unknown-entry.md)
- [`load.version`](load.version.md)
- [`modal.wheel`](modal.wheel.md)
- [`pull.record`](pull.record.md)
- [`pull.token`](pull.token.md)
- [`push.after-publish`](push.after-publish.md)
- [`push.checksum`](push.checksum.md)
- [`push.metadata-read-back`](push.metadata-read-back.md)
- [`push.service`](push.service.md)
- [`push.state`](push.state.md)
- [`push.token`](push.token.md)
- [`push.token-scope`](push.token-scope.md)
- [`run.out-of-memory`](run.out-of-memory.md)
- [`save.not-writable`](save.not-writable.md)
- [`terms.unlisted-licence`](terms.unlisted-licence.md)
- [`visuals.convert`](visuals.convert.md)

## internal

A check on MIME's own construction, which no supported script should reach: a MIME defect, to report with the file the error names; or an error MIME raised with no code yet (error.uncoded), keeping its own class, to report so that it gets one.

- [`entry.defect`](entry.defect.md)
- [`error.uncoded`](error.uncoded.md)
- [`lag.cross-check`](lag.cross-check.md)
- [`lag.unplanned`](lag.unplanned.md)
- [`load.input-hash`](load.input-hash.md)
- [`maddening.compile`](maddening.compile.md) (no test names this code)
- [`maddening.dtype`](maddening.dtype.md) (no test names this code)
- [`maddening.error`](maddening.error.md)
- [`maddening.shape`](maddening.shape.md) (no test names this code)
- [`maddening.units`](maddening.units.md)
- [`post-build.additive`](post-build.additive.md)
- [`post-build.base-step`](post-build.base-step.md) (no test names this code)
- [`post-build.command-writers`](post-build.command-writers.md)
- [`post-build.controller-order`](post-build.controller-order.md)
- [`post-build.exclusive`](post-build.exclusive.md)
- [`post-build.external-input`](post-build.external-input.md)
- [`post-build.host-callback`](post-build.host-callback.md)
- [`post-build.input-units`](post-build.input-units.md)
- [`post-build.not-by-edge`](post-build.not-by-edge.md) (no test names this code)
- [`post-build.read-field`](post-build.read-field.md)
- [`post-build.transform`](post-build.transform.md)
- [`post-build.underived-input`](post-build.underived-input.md)
- [`post-build.units`](post-build.units.md)
- [`post-build.unsaved-arguments`](post-build.unsaved-arguments.md)
- [`profile.not-a-waiver`](profile.not-a-waiver.md)
- [`profile.tables`](profile.tables.md)
- [`push.rejected`](push.rejected.md)
- [`run.unfed-input`](run.unfed-input.md)
- [`slot.collision`](slot.collision.md) (no test names this code)

## unrecognised

An error from below (the script's own code, JAX, MADDENING or another library) that MIME has no translation for: it is shown at the script's own line, and is never called MIME's defect.

- [`error.unrecognised`](error.unrecognised.md)