addDataIdValue

lsst.daf.butler.tests.addDataIdValue(butler: lsst.daf.butler._butler.Butler, dimension: str, value: Any, **related)

Add a new data ID to a repository.

Related dimensions (e.g., the instrument associated with a detector) may be specified using related. While these keywords are sometimes needed to get self-consistent repositories, you do not need to define relationships you do not use. Any unspecified dimensions will be linked arbitrarily.

Parameters:
butler : lsst.daf.butler.Butler

The repository to update.

dimension : str

The name of the dimension to gain a new value.

value

The value to register for the dimension.

**related

Any existing dimensions to be linked to value.

Notes

Because this function creates filler data, it is only suitable for test repositories. It should not be used for repositories intended for real data processing or analysis, which have known dimension values.

Examples

See the guide on Creating and populating a repository for usage examples.