TANGO naming convention - TANGO Controls

# 9 years ago
Philippe	Hi, there are several conventions XX/YY/ZZ on how to name the devices in TANGO DB according the experiments. Could some projects describe how they agreed to name their devices ? At ThomX, we actually name elements as following : LI/PS/COL.01 is an element in the LINAC (geographic position), depends from the Power Supply group (PS) and is the 1st Coil (COL.01). Another question is how to name consistently a sub-element of an element named for instance LI/PS/COL.01. It seems to be interesting in the case of elements controlled by a TANGO DS and composed by several elements controlled by TANGO DS themselves. - Philippe

# 9 years ago

Hi,
there are several conventions XX/YY/ZZ on how to name the devices in TANGO DB according the experiments.
Could some projects describe how they agreed to name their devices ?

At ThomX, we actually name elements as following : LI/PS/COL.01 is an element in the LINAC (geographic position), depends from the Power Supply group (PS) and is the 1st Coil (COL.01).

Another question is how to name consistently a sub-element of an element named for instance LI/PS/COL.01.
It seems to be interesting in the case of elements controlled by a TANGO DS and composed by several elements controlled by TANGO DS themselves.

- Philippe

# 9 years ago
hardion	Hi, MAX IV has a quite similar one [System]-[Location]/[Subsystem]/[Type]-[Enumerator]-[Connection], i.e: - R3-301/MAG/QD-01 -> 3 Gev Ring System - 1rst achromat / magnet subsystem / 1rst Quadrupole (of the 1rst achromat) - R3-A10111/MAG/PSP-02 associated power supply but located in the technical room In general we try to avoid extending the name with the dependency. The controller @MAXIV are usually in the technical location different from the lattice. But the beamline have usually a higher density of interdependent system: - B301-O1/OPT/MONO-01-BRAGG corresponds to the BRAGG Axis of the Monochromator although it is also a motion controller. my 20cts, Vincent Vincent Hardion Control System MAX IV Laboratory

# 9 years ago

hardion

Hi,

MAX IV has a quite similar one [System]-[Location]/[Subsystem]/[Type]-[Enumerator]-[Connection], i.e:
- R3-301/MAG/QD-01 -> 3 Gev Ring System - 1rst achromat / magnet subsystem / 1rst Quadrupole (of the 1rst achromat)
- R3-A10111/MAG/PSP-02 associated power supply but located in the technical room
In general we try to avoid extending the name with the dependency. The controller @MAXIV are usually in the technical location different from the lattice. But the beamline have usually a higher density of interdependent system:
- B301-O1/OPT/MONO-01-BRAGG corresponds to the BRAGG Axis of the Monochromator although it is also a motion controller.

my 20cts,
Vincent

Vincent Hardion
Control System
MAX IV Laboratory

# 9 years ago
Philippe	Thank you for your answer Vincent :) I understand you may have a B301-O1/OPT/MONO-01-BRAGG and a B301-O1/OPT/BRAGG-01. What does each stand for ? It reminds me that we give the number of an element ([member] into the doc) according to its place along the direction of the beam into a system (named domain into the doc). For instance, the beam will cross 1st Coil of LINAC (LINAC/AE/COL.01) before it crosses 2d Coil of LINAC (LINAC/AE/COL.02). We reset the number incrementation for each system : if we have elements named Coil into LINAC and RING domains, there will be a LINAC/PS/COL.01 and a RING/PS/COL.01. Additionnaly, we can have the same element into the same domain associated to 2 different families : LI/AE/COL.01 will be the magnetic element itself, controlled by the power supply LI/PS/COL.01. I found bit of information into appendix C of TANGO Controls System Handbook (http://ftp.esrf.fr/pub/cs/tango/tango_91.pdf) page 250. Is there some other doc/information on this subject somerwhere ? Thanks - Philippe Edited 8 years ago

# 9 years ago

Philippe

Thank you for your answer Vincent :)

I understand you may have a B301-O1/OPT/MONO-01-BRAGG and a B301-O1/OPT/BRAGG-01.
What does each stand for ?

It reminds me that we give the number of an element ([member] into the doc) according to its place along the direction of the beam into a system (named domain into the doc).
For instance, the beam will cross 1st Coil of LINAC (LINAC/AE/COL.01) before it crosses 2d Coil of LINAC (LINAC/AE/COL.02).
We reset the number incrementation for each system : if we have elements named Coil into LINAC and RING domains, there will be a LINAC/PS/COL.01 and a RING/PS/COL.01.

Additionnaly, we can have the same element into the same domain associated to 2 different families : LI/AE/COL.01 will be the magnetic element itself, controlled by the power supply LI/PS/COL.01.

I found bit of information into appendix C of TANGO Controls System Handbook (http://ftp.esrf.fr/pub/cs/tango/tango_91.pdf) page 250.
Is there some other doc/information on this subject somerwhere ?
Thanks

- Philippe

Edited 8 years ago

# 8 years ago
hardion	Philippe Thank you for your answer Vincent :) I understand you may have a B301-O1/OPT/MONO-01-BRAGG and a B301-O1/OPT/BRAGG-01. What does each stand for ? The second is not valid in our case because BRAGG is not a type but MOT is (stands for Motor). Philippe It reminds me that we give the number of an element ([member] into the doc) according to its place along the direction of the beam into a system (named domain into the doc). For instance, the beam will cross 1st Coil of LINAC (LINAC/AE/COL.01) before it crosses 2d Coil of LINAC (LINAC/AE/COL.02). We reset the number incrementation for each system : if we have elements named Coil into LINAC and RING domains, there will be a LINAC/PS/COL.01 and a RING/PS/COL.01. Additionnaly, we can have the same element into the same domain associated to 2 different families : LI/AE/COL.01 will be the magnetic element itself, controlled by the power supply LI/PS/COL.01. Yes it's exactly the same in our case. The enumerator is related to the Tango domain. Philippe I found bit of information into appendix C of TANGO Controls System Handbook (http://ftp.esrf.fr/pub/cs/tango/tango_91.pdf) page 250. Is there some other doc/information on this subject somerwhere ? Thanks I can check if our Naming convention can be published. By the way you may should avoid the dot inside the name. The dot appears ugly in the URL of the Tango REST API. Vincent Hardion Control System MAX IV Laboratory

# 8 years ago

hardion

Philippe
Thank you for your answer Vincent :)

I understand you may have a B301-O1/OPT/MONO-01-BRAGG and a B301-O1/OPT/BRAGG-01.
What does each stand for ?

The second is not valid in our case because BRAGG is not a type but MOT is (stands for Motor).

Philippe
It reminds me that we give the number of an element ([member] into the doc) according to its place along the direction of the beam into a system (named domain into the doc).
For instance, the beam will cross 1st Coil of LINAC (LINAC/AE/COL.01) before it crosses 2d Coil of LINAC (LINAC/AE/COL.02).
We reset the number incrementation for each system : if we have elements named Coil into LINAC and RING domains, there will be a LINAC/PS/COL.01 and a RING/PS/COL.01.

Additionnaly, we can have the same element into the same domain associated to 2 different families : LI/AE/COL.01 will be the magnetic element itself, controlled by the power supply LI/PS/COL.01.

Yes it's exactly the same in our case. The enumerator is related to the Tango domain.

Philippe
I found bit of information into appendix C of TANGO Controls System Handbook (http://ftp.esrf.fr/pub/cs/tango/tango_91.pdf) page 250.
Is there some other doc/information on this subject somerwhere ?
Thanks

I can check if our Naming convention can be published.
By the way you may should avoid the dot inside the name. The dot appears ugly in the URL of the Tango REST API. smile

Vincent Hardion
Control System
MAX IV Laboratory

# 8 years ago
hardion	Philippe, Here the link to our naming convention: https://www.maxlab.lu.se/node/1425 Direct link to latest rev: https://www.maxlab.lu.se/cmis/display?id=workspace%3A%2F%2FSpacesStore%2F5f819822-294b-4554-b0ab-0b8cadac2f76 Enjoy Vincent Hardion Control System MAX IV Laboratory