|
1 | 1 | """Helper functions for axis and plane descriptions"""
|
2 | 2 |
|
3 | 3 | from __future__ import annotations
|
4 |
| -from typing import Optional, Union |
5 | 4 |
|
6 |
| -# For sys.version_info.minor < 9: |
| 5 | +# Necessary for type aliases in python <= 3.8 : |
7 | 6 | from typing import Tuple
|
| 7 | +from typing import Union |
8 | 8 |
|
9 | 9 | AxisCode = Union[str, int, slice, None, type(Ellipsis)]
|
10 | 10 | AxisDef = Union[AxisCode, Tuple[AxisCode, AxisCode]]
|
11 | 11 |
|
12 |
| -_axis_def = dict( |
13 |
| - x=dict(index=0, label="x", unit=" [m]"), |
14 |
| - px=dict(index=1, label=r"$p_x$", unit=" [rad]"), |
15 |
| - y=dict(index=2, label="y", unit=" [m]"), |
16 |
| - py=dict(index=3, label=r"$p_y$", unit=" [rad]"), |
17 |
| - dp=dict(index=4, label=r"$\delta$", unit=""), |
18 |
| - ct=dict(index=5, label=r"$\beta c \tau$", unit=" [m]"), |
19 |
| -) |
20 |
| -for xk, xv in [it for it in _axis_def.items()]: |
| 12 | +_axis_def = { |
| 13 | + "x": {"index": 0, "label": "x", "unit": " [m]"}, |
| 14 | + "px": {"index": 1, "label": r"$p_x$", "unit": " [rad]"}, |
| 15 | + "y": {"index": 2, "label": "y", "unit": " [m]"}, |
| 16 | + "py": {"index": 3, "label": r"$p_y$", "unit": " [rad]"}, |
| 17 | + "dp": {"index": 4, "label": r"$\delta$", "unit": ""}, |
| 18 | + "ct": {"index": 5, "label": r"$\beta c \tau$", "unit": " [m]"}, |
| 19 | +} |
| 20 | +for xk, xv in list(_axis_def.items()): |
21 | 21 | xv["code"] = xk
|
22 | 22 | _axis_def[xv["index"]] = xv
|
23 | 23 | _axis_def[xk.upper()] = xv
|
|
26 | 26 | _axis_def["yp"] = _axis_def["py"] # For backward compatibility
|
27 | 27 | _axis_def["s"] = _axis_def["ct"]
|
28 | 28 | _axis_def["S"] = _axis_def["ct"]
|
29 |
| -_axis_def[None] = dict(index=None, label="", unit="", code=":") |
30 |
| -_axis_def[Ellipsis] = dict(index=Ellipsis, label="", unit="", code="...") |
31 |
| - |
32 |
| -_plane_def = dict( |
33 |
| - x=dict(index=0, label="x", unit=" [m]"), |
34 |
| - y=dict(index=1, label="y", unit=" [m]"), |
35 |
| - z=dict(index=2, label="z", unit=""), |
36 |
| -) |
37 |
| -for xk, xv in [it for it in _plane_def.items()]: |
| 29 | +_axis_def[None] = {"index": None, "label": "", "unit": "", "code": ":"} |
| 30 | +_axis_def[Ellipsis] = {"index": Ellipsis, "label": "", "unit": "", "code": "..."} |
| 31 | + |
| 32 | +_plane_def = { |
| 33 | + "x": {"index": 0, "label": "x", "unit": " [m]"}, |
| 34 | + "y": {"index": 1, "label": "y", "unit": " [m]"}, |
| 35 | + "z": {"index": 2, "label": "z", "unit": ""}, |
| 36 | +} |
| 37 | +for xk, xv in list(_plane_def.items()): |
38 | 38 | xv["code"] = xk
|
39 | 39 | _plane_def[xv["index"]] = xv
|
40 | 40 | _plane_def[xk.upper()] = xv
|
41 | 41 | _plane_def["h"] = _plane_def["x"]
|
42 | 42 | _plane_def["v"] = _plane_def["y"]
|
43 | 43 | _plane_def["H"] = _plane_def["x"]
|
44 | 44 | _plane_def["V"] = _plane_def["y"]
|
45 |
| -_plane_def[None] = dict(index=None, label="", unit="", code=":") |
46 |
| -_plane_def[Ellipsis] = dict(index=Ellipsis, label="", unit="", code="...") |
| 45 | +_plane_def[None] = {"index": None, "label": "", "unit": "", "code": ":"} |
| 46 | +_plane_def[Ellipsis] = {"index": Ellipsis, "label": "", "unit": "", "code": "..."} |
47 | 47 |
|
48 | 48 |
|
49 |
| -def _descr(dd: dict, arg: AxisDef, key: Optional[str] = None): |
50 |
| - if isinstance(arg, tuple): |
51 |
| - return tuple(_descr(dd, a, key=key) for a in arg) |
52 |
| - else: |
53 |
| - try: |
54 |
| - descr = dd[arg] |
55 |
| - except (TypeError, KeyError): |
56 |
| - descr = dict(index=arg, code=arg, label="", unit="") |
57 |
| - if key is None: |
58 |
| - return descr |
| 49 | +def _descr(dd: dict, *args: AxisDef, key: str | None = None): |
| 50 | + for arg in args: |
| 51 | + if isinstance(arg, tuple): |
| 52 | + for a in arg: |
| 53 | + yield from _descr(dd, a, key=key) |
59 | 54 | else:
|
60 |
| - return descr[key] |
| 55 | + if isinstance(arg, slice): |
| 56 | + descr = {"index": arg, "code": arg, "label": "", "unit": ""} |
| 57 | + else: |
| 58 | + descr = dd[arg] |
| 59 | + if key is None: |
| 60 | + yield descr |
| 61 | + else: |
| 62 | + yield descr[key] |
61 | 63 |
|
62 | 64 |
|
63 |
| -def axis_(axis: AxisDef, key: Optional[str] = None): |
| 65 | +def axis_(*axis: AxisDef, key: str | None = None): |
64 | 66 | r"""Return axis descriptions
|
65 | 67 |
|
66 | 68 | Parameters:
|
@@ -100,28 +102,32 @@ def axis_(axis: AxisDef, key: Optional[str] = None):
|
100 | 102 |
|
101 | 103 | Examples:
|
102 | 104 |
|
103 |
| - >>> axis_(('x','dp'), key='index') |
| 105 | + >>> axis_("x", "dp", key="index") |
104 | 106 | (0, 4)
|
105 | 107 |
|
106 | 108 | returns the indices in the standard coordinate vector
|
107 | 109 |
|
108 |
| - >>> dplabel = axis_('dp', key='label') |
| 110 | + >>> dplabel = axis_("dp", key="label") |
109 | 111 | >>> print(dplabel)
|
110 | 112 | $\delta$
|
111 | 113 |
|
112 | 114 | returns the coordinate label for plot annotation
|
113 | 115 |
|
114 |
| - >>> axis_((0,'dp')) |
| 116 | + >>> axis_(0, "dp") |
115 | 117 | ({'plane': 0, 'label': 'x', 'unit': ' [m]', 'code': 'x'},
|
116 | 118 | {'plane': 4, 'label': '$\\delta$', 'unit': '', 'code': 'dp'})
|
117 | 119 |
|
118 | 120 | returns the entire description directories
|
119 | 121 |
|
120 | 122 | """
|
121 |
| - return _descr(_axis_def, axis, key=key) |
| 123 | + ret = tuple(_descr(_axis_def, *axis, key=key)) |
| 124 | + if len(ret) > 1: |
| 125 | + return ret |
| 126 | + else: |
| 127 | + return ret[0] |
122 | 128 |
|
123 | 129 |
|
124 |
| -def plane_(plane: AxisDef, key: Optional[str] = None): |
| 130 | +def plane_(*plane: AxisDef, key: str | None = None): |
125 | 131 | r"""Return plane descriptions
|
126 | 132 |
|
127 | 133 | Parameters:
|
@@ -154,16 +160,20 @@ def plane_(plane: AxisDef, key: Optional[str] = None):
|
154 | 160 |
|
155 | 161 | Examples:
|
156 | 162 |
|
157 |
| - >>> plane_('v', key='index') |
| 163 | + >>> plane_("v", key="index") |
158 | 164 | 1
|
159 | 165 |
|
160 | 166 | returns the indices in the standard coordinate vector
|
161 | 167 |
|
162 |
| - >>> plane_(('x','y')) |
163 |
| - ({'plane': 0, 'label': 'h', 'unit': ' [m]', 'code': 'h'}, |
164 |
| - {'plane': 1, 'label': 'v', 'unit': ' [m]', 'code': 'v'}) |
| 168 | + >>> plane_("x", "y") |
| 169 | + ({'plane': 0, 'label': 'x', 'unit': ' [m]', 'code': 'h'}, |
| 170 | + {'plane': 1, 'label': 'y', 'unit': ' [m]', 'code': 'v'}) |
165 | 171 |
|
166 | 172 | returns the entire description directories
|
167 | 173 |
|
168 | 174 | """
|
169 |
| - return _descr(_plane_def, plane, key=key) |
| 175 | + ret = tuple(_descr(_plane_def, *plane, key=key)) |
| 176 | + if len(ret) > 1: |
| 177 | + return ret |
| 178 | + else: |
| 179 | + return ret[0] |
0 commit comments