Names

meme.names.list_pvs(pattern, tag=None, sort_by=None, element_type=None, timeout=None)[source]

Gets a list of PVs from the directory service.

Parameters:

  • pattern (str) – A pattern to search for. The pattern can use an Oracle-style wildcard syntax, like this: “BPMS:BSY:%:X”, where % is the wildcard symbol, or a regular expression, like this: “(XCOR|BPMS):.*”.

  • tag (str, optional) – A tag to filter the results by. Tags come from the model system, and are used to group a region of devices. Some commonly-used tags: L1, L2, L3, BSY, LTU, UND, DUMPLINE.

  • sort_by (str, optional) – A property to sort the reults by. sort_by=”z” is very commonly used.

  • element_type (str, optional) – An element type to filter the results by. For example, you can show only instruments by passing element_type=”INST”.

Returns:

A list of PVs matching the parameters sent.

Return type:

list of str

meme.names.list_devices(pattern, tag=None, sort_by=None, element_type=None, timeout=None)[source]

Gets a list of PVs from the directory service.

Equivalent to calling list() with show=’dname’.

Parameters:

  • pattern (str) – A pattern to search for. The pattern can use an Oracle-style wildcard syntax, like this: “BPMS:BSY:%:X”, where % is the wildcard symbol, or a regular expression, like this: “(XCOR|BPMS):.*”.

  • tag (str, optional) – A tag to filter the results by. Tags come from the model system, and are used to group a region of devices. Some commonly-used tags: L1, L2, L3, BSY, LTU, UND, DUMPLINE.

  • sort_by (str, optional) – A property to sort the reults by. sort_by=”z” is very commonly used.

  • element_type (str, optional) – An element type to filter the results by. For example, you can show only instruments by passing element_type=”INST”.

Returns:

A list of device names matching the parameters sent.

Return type:

list of str

meme.names.list_elements(pattern, tag=None, sort_by=None, element_type=None, timeout=None)[source]

Gets a list of PVs from the directory service.

Parameters:

  • pattern (str) – A pattern to search for. The pattern can use an Oracle-style wildcard syntax, like this: “BPMS:BSY:%:X”, where % is the wildcard symbol, or a regular expression, like this: “(XCOR|BPMS):.*”.

  • tag (str, optional) – A tag to filter the results by. Tags come from the model system, and are used to group a region of devices. Some commonly-used tags: L1, L2, L3, BSY, LTU, UND, DUMPLINE.

  • sort_by (str, optional) – A property to sort the reults by. sort_by=”z” is very commonly used.

  • element_type (str, optional) – An element type to filter the results by. For example, you can show only instruments by passing element_type=”INST”.

Returns:

A list of element names matching the parameters sent.

Return type:

list of str