From b73f5f882bf0e67c5c2cdf01a7eef265eda78bf3 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Tue, 9 Sep 2025 13:53:16 -0500
Subject: [PATCH 01/25] kit _bluesky.py

---
 WrightTools/kit/__init__.py |   2 +
 WrightTools/kit/_bluesky.py | 142 ++++++++++++++++++++++++++++++++++++
 2 files changed, 144 insertions(+)
 create mode 100644 WrightTools/kit/_bluesky.py

diff --git a/WrightTools/kit/__init__.py b/WrightTools/kit/__init__.py
index d6a60842..9a8fa608 100644
--- a/WrightTools/kit/__init__.py
+++ b/WrightTools/kit/__init__.py
@@ -15,3 +15,5 @@
 from ._unicode import *
 from ._utilities import *
 from ._glob import *
+
+from . import _bluesky as bluesky
diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
new file mode 100644
index 00000000..734958c8
--- /dev/null
+++ b/WrightTools/kit/_bluesky.py
@@ -0,0 +1,142 @@
+"""
+Helpers specific to deal with data structures from Wright Group Bluesky deployment
+https://github.com/wright-group/bluesky-in-a-box/
+"""
+
+import re
+import json
+import datetime
+import pathlib
+import logging
+from typing import NamedTuple
+
+from .._open import open as wt5_open
+
+
+__folder_parts__ = [
+    r"(?P<date>\d\d\d\d-\d\d-\d\d)",
+    r"(?P<time>" + r"\d{5}" + ")",
+    r"(?P<plan>\w*)",
+    r"(?P<name>[\s\w\d.-]*)",  # not great...
+    r"(?P<uid>\w{8})"
+]
+
+__folder_seed__ = " ".join(__folder_parts__)
+__datetime_seed__ = re.compile(" ".join(__folder_parts__[:3]))
+__fseed__ = "{date} {time} {plan} {name} {uid}"
+
+
+class BlueskyFolder:
+    """container class for Bluesky acquisitions"""
+
+    def __init__(self, folder_path:pathlib.Path):
+        self.path = folder_path
+        self.info = parse_folder_name(folder_path.name)
+        if self.info is None:
+            return
+
+        self._primary = None
+        self.logger = logging.getLogger(self.info.uid)
+        self.logger.info(self.info)
+
+    @property
+    def primary(self):
+        """open procedure based on plan"""
+        if self._primary is None:
+            # TODO: open procedure based on plan
+            self._primary = wt5_open(self.path / "primary.wt5")
+        return self._primary
+    
+    @property
+    def baseline(self):
+        raise NotImplementedError
+
+    @property
+    def baseline_tree(self):
+        return (self.path / "baseline tree.txt").read_text()
+
+    @property
+    def primary_tree(self):
+        return (self.path / "primary tree.txt").read_text()
+
+    @property    
+    def start(self) -> dict:
+        path = self.path / "bluesky_docs" / "start.json"
+        return json.load(path.open())
+
+    @property    
+    def stop(self) -> dict:
+        path = self.path / "bluesky_docs" / "stop.json"
+        return json.load(path.open())
+
+    @property
+    def primary_descriptor(self) -> dict:
+        path = self.path / "bluesky_docs" / "primary descriptor.json"
+        return json.load(path.open())
+
+    @property
+    def baseline_descriptor(self) -> dict:
+        path = self.path / "bluesky_docs" / "baseline descriptor.json"
+        return json.load(path.open())
+
+
+class FolderInfo(NamedTuple):
+    date: datetime.date
+    time: datetime.time
+    plan: str
+    name: str
+    uid: str
+
+    @property
+    def folder(self):
+        return __fseed__.format(
+            date=self.date.strftime("%Y-%m-%d"),
+            time=int(datetime.timedelta(
+                minutes=self.time.minute,
+                seconds=self.time.second,
+                hours=self.time.hour
+            ).total_seconds()),
+            plan=self.plan,
+            name=self.name,
+            uid=self.uid
+        )
+
+
+def match_identifier(dir:pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
+    """walk a directory to find datasets that meet the criteria
+    """
+    for key in bluesky_identifier.keys():
+        assert key in FolderInfo._fields
+
+    keep = []
+
+    for info in map(
+        lambda item: parse_folder_name(item.name),
+        filter(
+            lambda item: item.is_dir() and re.fullmatch(__folder_seed__, item.name),
+            dir.iterdir()
+        )
+    ):
+        idict = info._asdict()
+        if all(idict[k] == bluesky_identifier[k] for k in bluesky_identifier.keys()):
+            keep.append(BlueskyFolder(dir / info.folder))
+
+    return keep
+
+
+def parse_folder_name(folder:str) -> FolderInfo | None:
+    # TODO: match procedure is leaky (mainly due to name and plan), could be cleaned up
+    if ((uid_match := re.fullmatch(r"(?P<uid>\w{8})", folder.split()[-1])) is not None) \
+        and ((datetime_match := __datetime_seed__.match(folder)) is not None):
+        matchdict = uid_match.groupdict() | datetime_match.groupdict()
+        matchdict["name"] =  " ".join(folder.split()[3:-1])
+        return _to_object(matchdict)
+    else:
+        return None
+
+
+def _to_object(mdict:dict) -> FolderInfo:
+    date = datetime.date.fromisoformat(mdict.pop("date"))
+    ts = int(mdict.pop("time"))  # total seconds since date start
+    time = datetime.time(hour=ts // 3600, minute=(ts % 3600) // 60, second=ts % 60)
+    return FolderInfo(date=date, time=time, **mdict)

From 4407083d11f908cf7024e3bd6816a203e5e7c99f Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 9 Sep 2025 18:59:02 +0000
Subject: [PATCH 02/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 43 ++++++++++++++++++-------------------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 734958c8..1a1206ec 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -18,7 +18,7 @@
     r"(?P<time>" + r"\d{5}" + ")",
     r"(?P<plan>\w*)",
     r"(?P<name>[\s\w\d.-]*)",  # not great...
-    r"(?P<uid>\w{8})"
+    r"(?P<uid>\w{8})",
 ]
 
 __folder_seed__ = " ".join(__folder_parts__)
@@ -29,7 +29,7 @@
 class BlueskyFolder:
     """container class for Bluesky acquisitions"""
 
-    def __init__(self, folder_path:pathlib.Path):
+    def __init__(self, folder_path: pathlib.Path):
         self.path = folder_path
         self.info = parse_folder_name(folder_path.name)
         if self.info is None:
@@ -46,7 +46,7 @@ def primary(self):
             # TODO: open procedure based on plan
             self._primary = wt5_open(self.path / "primary.wt5")
         return self._primary
-    
+
     @property
     def baseline(self):
         raise NotImplementedError
@@ -59,12 +59,12 @@ def baseline_tree(self):
     def primary_tree(self):
         return (self.path / "primary tree.txt").read_text()
 
-    @property    
+    @property
     def start(self) -> dict:
         path = self.path / "bluesky_docs" / "start.json"
         return json.load(path.open())
 
-    @property    
+    @property
     def stop(self) -> dict:
         path = self.path / "bluesky_docs" / "stop.json"
         return json.load(path.open())
@@ -91,20 +91,19 @@ class FolderInfo(NamedTuple):
     def folder(self):
         return __fseed__.format(
             date=self.date.strftime("%Y-%m-%d"),
-            time=int(datetime.timedelta(
-                minutes=self.time.minute,
-                seconds=self.time.second,
-                hours=self.time.hour
-            ).total_seconds()),
+            time=int(
+                datetime.timedelta(
+                    minutes=self.time.minute, seconds=self.time.second, hours=self.time.hour
+                ).total_seconds()
+            ),
             plan=self.plan,
             name=self.name,
-            uid=self.uid
+            uid=self.uid,
         )
 
 
-def match_identifier(dir:pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
-    """walk a directory to find datasets that meet the criteria
-    """
+def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
+    """walk a directory to find datasets that meet the criteria"""
     for key in bluesky_identifier.keys():
         assert key in FolderInfo._fields
 
@@ -113,9 +112,8 @@ def match_identifier(dir:pathlib.Path, **bluesky_identifier) -> list[BlueskyFold
     for info in map(
         lambda item: parse_folder_name(item.name),
         filter(
-            lambda item: item.is_dir() and re.fullmatch(__folder_seed__, item.name),
-            dir.iterdir()
-        )
+            lambda item: item.is_dir() and re.fullmatch(__folder_seed__, item.name), dir.iterdir()
+        ),
     ):
         idict = info._asdict()
         if all(idict[k] == bluesky_identifier[k] for k in bluesky_identifier.keys()):
@@ -124,18 +122,19 @@ def match_identifier(dir:pathlib.Path, **bluesky_identifier) -> list[BlueskyFold
     return keep
 
 
-def parse_folder_name(folder:str) -> FolderInfo | None:
+def parse_folder_name(folder: str) -> FolderInfo | None:
     # TODO: match procedure is leaky (mainly due to name and plan), could be cleaned up
-    if ((uid_match := re.fullmatch(r"(?P<uid>\w{8})", folder.split()[-1])) is not None) \
-        and ((datetime_match := __datetime_seed__.match(folder)) is not None):
+    if ((uid_match := re.fullmatch(r"(?P<uid>\w{8})", folder.split()[-1])) is not None) and (
+        (datetime_match := __datetime_seed__.match(folder)) is not None
+    ):
         matchdict = uid_match.groupdict() | datetime_match.groupdict()
-        matchdict["name"] =  " ".join(folder.split()[3:-1])
+        matchdict["name"] = " ".join(folder.split()[3:-1])
         return _to_object(matchdict)
     else:
         return None
 
 
-def _to_object(mdict:dict) -> FolderInfo:
+def _to_object(mdict: dict) -> FolderInfo:
     date = datetime.date.fromisoformat(mdict.pop("date"))
     ts = int(mdict.pop("time"))  # total seconds since date start
     time = datetime.time(hour=ts // 3600, minute=(ts % 3600) // 60, second=ts % 60)

From 7c536c9e93fe35d2b941e46e5b72b95181bd325f Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Tue, 9 Sep 2025 15:00:43 -0500
Subject: [PATCH 03/25] Update CHANGELOG.md

---
 CHANGELOG.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index aa7b791a..002ca855 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 ## [Unreleased]
 
+### Added
+- new kit module `bluesky` for working with `bluesky-in-a-box` data / directories
+
 ### Fixed
 - quick2D works with contours on
 - quick2D works with `pixelated=False` (i.e. contourf)

From d1c9db9145b4f822a96fc0bee1ebf68684111392 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Wed, 10 Sep 2025 15:26:47 -0500
Subject: [PATCH 04/25] Update _bluesky.py

---
 WrightTools/kit/_bluesky.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 1a1206ec..9e3f193b 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -29,8 +29,8 @@
 class BlueskyFolder:
     """container class for Bluesky acquisitions"""
 
-    def __init__(self, folder_path: pathlib.Path):
-        self.path = folder_path
+    def __init__(self, folder_path):
+        self.path = pathlib.Path(folder_path)
         self.info = parse_folder_name(folder_path.name)
         if self.info is None:
             return
@@ -44,7 +44,10 @@ def primary(self):
         """open procedure based on plan"""
         if self._primary is None:
             # TODO: open procedure based on plan
-            self._primary = wt5_open(self.path / "primary.wt5")
+            if self.info.plan == "gridscan_wp":
+                self._primary = wt5_open(self.path / "primary.wt5")
+            else:
+                raise NotImplementedError(f"plan {self.info.plan}")
         return self._primary
 
     @property

From 8066a2bb9b21c0c05c27e965cd76eb8ca00d1515 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Sep 2025 17:01:36 -0500
Subject: [PATCH 05/25] Update _bluesky.py

---
 WrightTools/kit/_bluesky.py | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 9e3f193b..31c02e07 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -9,6 +9,7 @@
 import pathlib
 import logging
 from typing import NamedTuple
+from dataclasses import dataclass
 
 from .._open import open as wt5_open
 
@@ -20,7 +21,6 @@
     r"(?P<name>[\s\w\d.-]*)",  # not great...
     r"(?P<uid>\w{8})",
 ]
-
 __folder_seed__ = " ".join(__folder_parts__)
 __datetime_seed__ = re.compile(" ".join(__folder_parts__[:3]))
 __fseed__ = "{date} {time} {plan} {name} {uid}"
@@ -106,7 +106,26 @@ def folder(self):
 
 
 def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
-    """walk a directory to find datasets that meet the criteria"""
+    """
+    walk a directory to find datasets that meet the criteria
+    
+    Parameters
+    ----------
+
+    dir: path-like
+        the directory to iterate through
+    
+    kwargs
+    ------
+    
+    bluesky_identifiers
+        keys corresponding to FolderInfo properties (e.g. date, plan).
+
+    Returns
+    -------
+    matches: list of BlueskyFolder objects
+        BlueskyFolders corresponding to full matches with the bluesky_identifiers    
+    """
     for key in bluesky_identifier.keys():
         assert key in FolderInfo._fields
 

From 8d4c36c285c3d510a584257eff11f093eb124788 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Sep 2025 17:55:36 -0500
Subject: [PATCH 06/25] Update _bluesky.py

---
 WrightTools/kit/_bluesky.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 31c02e07..906acb2e 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -9,7 +9,6 @@
 import pathlib
 import logging
 from typing import NamedTuple
-from dataclasses import dataclass
 
 from .._open import open as wt5_open
 

From 5c7f3fa2db1201df8378c907a95e00c8f00f5256 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Fri, 12 Sep 2025 05:10:55 +0000
Subject: [PATCH 07/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 906acb2e..b312d7d6 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -107,23 +107,23 @@ def folder(self):
 def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
     """
     walk a directory to find datasets that meet the criteria
-    
+
     Parameters
     ----------
 
     dir: path-like
         the directory to iterate through
-    
+
     kwargs
     ------
-    
+
     bluesky_identifiers
         keys corresponding to FolderInfo properties (e.g. date, plan).
 
     Returns
     -------
     matches: list of BlueskyFolder objects
-        BlueskyFolders corresponding to full matches with the bluesky_identifiers    
+        BlueskyFolders corresponding to full matches with the bluesky_identifiers
     """
     for key in bluesky_identifier.keys():
         assert key in FolderInfo._fields

From 47fab443418384a0e32b262ce5b4848dc55e7538 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Sat, 1 Nov 2025 14:06:40 -0500
Subject: [PATCH 08/25] bluesky test

---
 tests/kit/bluesky.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 tests/kit/bluesky.py

diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
new file mode 100644
index 00000000..0a6a331a
--- /dev/null
+++ b/tests/kit/bluesky.py
@@ -0,0 +1,22 @@
+import WrightTools as wt
+
+
+def test_folderinfo():
+    name1 = "2025-10-27 52433 count 2 beam PL spot2 post d7f183b5"
+    name2 = "2025-10-27 54622 grid_scan_wp spot 3 spectral 6a45457c"
+
+    fi1 = wt.kit.bluesky.parse_folder_name(name1)
+    fi2 = wt.kit.bluesky.parse_folder_name(name2)
+
+    for name, fi in [[name1, fi1], [name2, fi2]]:
+        assert fi is not None
+        assert fi.folder == name
+
+    assert fi1.name == "2 beam PL spot2 post"
+    assert fi2.name == "spot 3 spectral"
+    assert fi1.plan == "count"
+    assert fi2.plan == "grid_scan_wp"
+
+
+if __name__ == "__main__":
+    test_folderinfo()

From 7ce995b45c271d833431dd60108deb0990b01b15 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Sat, 1 Nov 2025 14:08:14 -0500
Subject: [PATCH 09/25] Update _bluesky.py

documentation, typing
---
 WrightTools/kit/_bluesky.py | 52 ++++++++++++++++++++++++++++++-------
 1 file changed, 43 insertions(+), 9 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index b312d7d6..a93459c8 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -1,5 +1,5 @@
 """
-Helpers specific to deal with data structures from Wright Group Bluesky deployment
+Helpers specific to deal with data structures from the Wright Group's Bluesky deployment
 https://github.com/wright-group/bluesky-in-a-box/
 """
 
@@ -22,19 +22,22 @@
 ]
 __folder_seed__ = " ".join(__folder_parts__)
 __datetime_seed__ = re.compile(" ".join(__folder_parts__[:3]))
-__fseed__ = "{date} {time} {plan} {name} {uid}"
+__fmtseed__ = "{date} {time} {plan} {name} {uid}"
 
 
 class BlueskyFolder:
     """container class for Bluesky acquisitions"""
 
-    def __init__(self, folder_path):
+    def __init__(self, folder_path:str|pathlib.Path):
         self.path = pathlib.Path(folder_path)
+        # DDK: better to extract the information from the data inside, rather than relying on the name
+        # self.info = parse_folder_contents(folder_path.name)
         self.info = parse_folder_name(folder_path.name)
         if self.info is None:
             return
 
         self._primary = None
+        self._baseline = None
         self.logger = logging.getLogger(self.info.uid)
         self.logger.info(self.info)
 
@@ -51,14 +54,16 @@ def primary(self):
 
     @property
     def baseline(self):
-        raise NotImplementedError
+        if self._baseline is None:
+            self._baseline = wt5_open(self.path / "primary.wt5")
+        return self._baseline
 
     @property
-    def baseline_tree(self):
+    def baseline_tree(self) -> str:
         return (self.path / "baseline tree.txt").read_text()
 
     @property
-    def primary_tree(self):
+    def primary_tree(self) -> str:
         return (self.path / "primary tree.txt").read_text()
 
     @property
@@ -83,6 +88,7 @@ def baseline_descriptor(self) -> dict:
 
 
 class FolderInfo(NamedTuple):
+    """Object representation of bluesky folder names"""
     date: datetime.date
     time: datetime.time
     plan: str
@@ -91,7 +97,7 @@ class FolderInfo(NamedTuple):
 
     @property
     def folder(self):
-        return __fseed__.format(
+        return __fmtseed__.format(
             date=self.date.strftime("%Y-%m-%d"),
             time=int(
                 datetime.timedelta(
@@ -106,7 +112,7 @@ def folder(self):
 
 def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
     """
-    walk a directory to find datasets that meet the criteria
+    walk a directory to find bluesky folder names that match the specified identifiers
 
     Parameters
     ----------
@@ -143,8 +149,35 @@ def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFol
     return keep
 
 
+def parse_folder_contents(folder: str) -> FolderInfo | None:
+    """
+    (Coming soon!)
+    Parse key identifiers from a bluesky folder based on the data inside.
+
+    See also
+    --------
+    parse_folder_name:
+        Use the folder name, rather than data inside the folder.
+    """
+    raise NotImplementedError
+
+
+
 def parse_folder_name(folder: str) -> FolderInfo | None:
-    # TODO: match procedure is leaky (mainly due to name and plan), could be cleaned up
+    """
+    Convert a bluesky-formatted folder name into a structured dictonary-like format.
+
+    Parameters
+    ----------
+    folder : string
+        the folder name
+
+    Returns
+    -------
+    FolderInfo | None
+        if the name is parsed, returns a FolderInfo object.
+        otherwise, returns None.
+    """
     if ((uid_match := re.fullmatch(r"(?P<uid>\w{8})", folder.split()[-1])) is not None) and (
         (datetime_match := __datetime_seed__.match(folder)) is not None
     ):
@@ -156,6 +189,7 @@ def parse_folder_name(folder: str) -> FolderInfo | None:
 
 
 def _to_object(mdict: dict) -> FolderInfo:
+    """convert re match dictionary into FolderInfo object"""
     date = datetime.date.fromisoformat(mdict.pop("date"))
     ts = int(mdict.pop("time"))  # total seconds since date start
     time = datetime.time(hour=ts // 3600, minute=(ts % 3600) // 60, second=ts % 60)

From 43bae85f854ebfc4f7772176fcfbe234ce865b72 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 1 Nov 2025 19:08:27 +0000
Subject: [PATCH 10/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index a93459c8..a8118c32 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -28,7 +28,7 @@
 class BlueskyFolder:
     """container class for Bluesky acquisitions"""
 
-    def __init__(self, folder_path:str|pathlib.Path):
+    def __init__(self, folder_path: str | pathlib.Path):
         self.path = pathlib.Path(folder_path)
         # DDK: better to extract the information from the data inside, rather than relying on the name
         # self.info = parse_folder_contents(folder_path.name)
@@ -89,6 +89,7 @@ def baseline_descriptor(self) -> dict:
 
 class FolderInfo(NamedTuple):
     """Object representation of bluesky folder names"""
+
     date: datetime.date
     time: datetime.time
     plan: str
@@ -162,7 +163,6 @@ def parse_folder_contents(folder: str) -> FolderInfo | None:
     raise NotImplementedError
 
 
-
 def parse_folder_name(folder: str) -> FolderInfo | None:
     """
     Convert a bluesky-formatted folder name into a structured dictonary-like format.

From da2b9b1100841df7cafb7bdd7d54790edd10f5a6 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Sun, 2 Nov 2025 10:06:57 -0600
Subject: [PATCH 11/25] revision

filter function for bluesky folders
new function names
more documentation
---
 WrightTools/kit/_bluesky.py | 88 +++++++++++++++++++++++--------------
 1 file changed, 54 insertions(+), 34 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index a8118c32..f144e2ad 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -1,5 +1,5 @@
 """
-Helpers specific to deal with data structures from the Wright Group's Bluesky deployment
+Helpers and containers for data structures in the Wright Group's Bluesky deployment
 https://github.com/wright-group/bluesky-in-a-box/
 """
 
@@ -8,7 +8,7 @@
 import datetime
 import pathlib
 import logging
-from typing import NamedTuple
+from typing import NamedTuple, Generator, Iterable
 
 from .._open import open as wt5_open
 
@@ -111,56 +111,76 @@ def folder(self):
         )
 
 
-def match_identifier(dir: pathlib.Path, **bluesky_identifier) -> list[BlueskyFolder]:
+def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Generator[pathlib.Path, None, None]:
     """
-    walk a directory to find bluesky folder names that match the specified identifiers
+    Filter an iterator of folder names for bluesky folder pattern that match specified values.
 
     Parameters
     ----------
 
-    dir: path-like
-        the directory to iterate through
-
+    items: pathlikes
+        potential paths of bluesky folders
+        
     kwargs
     ------
 
     bluesky_identifiers
         keys corresponding to FolderInfo properties (e.g. date, plan).
 
-    Returns
+    Yields
     -------
-    matches: list of BlueskyFolder objects
-        BlueskyFolders corresponding to full matches with the bluesky_identifiers
+
+    pathlib.Path: 
+        bluesky folders corresponding to full matches with the bluesky_identifiers
+
+    Examples
+    --------
+    ```
+    # match within a directory
+    spooky_folders = [
+        info for info in filter_bluesky(
+            data_folder.iterdir(), 
+            date="2025-10-31"
+        )
+    ]
+    ```
     """
-    for key in bluesky_identifier.keys():
+    for key in bluesky_identifiers.keys():
         assert key in FolderInfo._fields
 
-    keep = []
+    for item in map(pathlib.Path, items):
+        if (info := parse_folder_name(item.name)) is not None:
+            idict = info._asdict()
+            if all(idict[k] == v for k,v in bluesky_identifiers.items()):
+                yield item
 
-    for info in map(
-        lambda item: parse_folder_name(item.name),
-        filter(
-            lambda item: item.is_dir() and re.fullmatch(__folder_seed__, item.name), dir.iterdir()
-        ),
-    ):
-        idict = info._asdict()
-        if all(idict[k] == bluesky_identifier[k] for k in bluesky_identifier.keys()):
-            keep.append(BlueskyFolder(dir / info.folder))
 
-    return keep
+def bluesky_paths(dir: pathlib.Path, **bluesky_identifiers) -> list[pathlib.Path]:
+    """
+    walk a directory to find bluesky folder names that match the specified identifiers.
 
+    Parameters
+    ----------
 
-def parse_folder_contents(folder: str) -> FolderInfo | None:
-    """
-    (Coming soon!)
-    Parse key identifiers from a bluesky folder based on the data inside.
+    dir: path-like
+        the directory to iterate through
 
-    See also
-    --------
-    parse_folder_name:
-        Use the folder name, rather than data inside the folder.
+    kwargs
+    ------
+
+    bluesky_identifiers
+        keys corresponding to FolderInfo properties (e.g. date, plan).
+
+    Returns
+    -------
+    matches: list of BlueskyFolder objects
+        BlueskyFolders corresponding to full matches with the bluesky_identifiers
     """
-    raise NotImplementedError
+
+    return sorted([
+        dir / info.folder
+        for info in filter_bluesky(dir.iterdir(), **bluesky_identifiers)
+    ])
 
 
 def parse_folder_name(folder: str) -> FolderInfo | None:
@@ -178,14 +198,14 @@ def parse_folder_name(folder: str) -> FolderInfo | None:
         if the name is parsed, returns a FolderInfo object.
         otherwise, returns None.
     """
+    out = None
     if ((uid_match := re.fullmatch(r"(?P<uid>\w{8})", folder.split()[-1])) is not None) and (
         (datetime_match := __datetime_seed__.match(folder)) is not None
     ):
         matchdict = uid_match.groupdict() | datetime_match.groupdict()
         matchdict["name"] = " ".join(folder.split()[3:-1])
-        return _to_object(matchdict)
-    else:
-        return None
+        out = _to_object(matchdict)
+    return out
 
 
 def _to_object(mdict: dict) -> FolderInfo:

From 428b22d7fee4e29f2b93a147c7febad0f39677cb Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Sun, 2 Nov 2025 10:07:17 -0600
Subject: [PATCH 12/25] test_filter

---
 tests/kit/bluesky.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index 0a6a331a..111be34b 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -18,5 +18,16 @@ def test_folderinfo():
     assert fi2.plan == "grid_scan_wp"
 
 
+def test_filter():
+    name1 = "2025-10-27 52433 count 2 beam PL spot2 post d7f183b5"
+    name2 = "2025-10-27 54622 grid_scan_wp spot 3 spectral 6a45457c"
+
+    gridscans = [x for x in wt.kit.bluesky.filter_bluesky([name1, name2], plan="grid_scan_wp")]
+    assert len(gridscans) == 1
+    assert str(gridscans[0]) == name2
+
+
 if __name__ == "__main__":
     test_folderinfo()
+    test_filter()
+

From 9b46888df94d3bc688d749a4f80288287833d81e Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 2 Nov 2025 16:07:31 +0000
Subject: [PATCH 13/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 19 ++++++++++---------
 tests/kit/bluesky.py        |  1 -
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index f144e2ad..43ca5f6b 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -111,7 +111,9 @@ def folder(self):
         )
 
 
-def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Generator[pathlib.Path, None, None]:
+def filter_bluesky(
+    items: Iterable[pathlib.Path], **bluesky_identifiers
+) -> Generator[pathlib.Path, None, None]:
     """
     Filter an iterator of folder names for bluesky folder pattern that match specified values.
 
@@ -120,7 +122,7 @@ def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Gener
 
     items: pathlikes
         potential paths of bluesky folders
-        
+
     kwargs
     ------
 
@@ -130,7 +132,7 @@ def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Gener
     Yields
     -------
 
-    pathlib.Path: 
+    pathlib.Path:
         bluesky folders corresponding to full matches with the bluesky_identifiers
 
     Examples
@@ -139,7 +141,7 @@ def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Gener
     # match within a directory
     spooky_folders = [
         info for info in filter_bluesky(
-            data_folder.iterdir(), 
+            data_folder.iterdir(),
             date="2025-10-31"
         )
     ]
@@ -151,7 +153,7 @@ def filter_bluesky(items:Iterable[pathlib.Path], **bluesky_identifiers) -> Gener
     for item in map(pathlib.Path, items):
         if (info := parse_folder_name(item.name)) is not None:
             idict = info._asdict()
-            if all(idict[k] == v for k,v in bluesky_identifiers.items()):
+            if all(idict[k] == v for k, v in bluesky_identifiers.items()):
                 yield item
 
 
@@ -177,10 +179,9 @@ def bluesky_paths(dir: pathlib.Path, **bluesky_identifiers) -> list[pathlib.Path
         BlueskyFolders corresponding to full matches with the bluesky_identifiers
     """
 
-    return sorted([
-        dir / info.folder
-        for info in filter_bluesky(dir.iterdir(), **bluesky_identifiers)
-    ])
+    return sorted(
+        [dir / info.folder for info in filter_bluesky(dir.iterdir(), **bluesky_identifiers)]
+    )
 
 
 def parse_folder_name(folder: str) -> FolderInfo | None:
diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index 111be34b..5d66b808 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -30,4 +30,3 @@ def test_filter():
 if __name__ == "__main__":
     test_folderinfo()
     test_filter()
-

From 6240cc99f47c51458d77ec0b177965723e34164e Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Sun, 2 Nov 2025 10:08:00 -0600
Subject: [PATCH 14/25] function apply_points_axes

---
 WrightTools/kit/_bluesky.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index f144e2ad..0d265c5c 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -85,6 +85,14 @@ def primary_descriptor(self) -> dict:
     def baseline_descriptor(self) -> dict:
         path = self.path / "bluesky_docs" / "baseline descriptor.json"
         return json.load(path.open())
+def apply_points_axes(data):
+    """
+    Switch to reduced dimensional axes when available.
+    Useful for gridscan plans.
+    """
+    transform = [f"{n}_points" if f"{n}_points" in data.variable_names else n for n in data.axis_names]
+    data.transform(*transform)
+    return data
 
 
 class FolderInfo(NamedTuple):

From 6d6d40e202137a8bee0c5b5adf1b607a19c21867 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 2 Nov 2025 16:09:36 +0000
Subject: [PATCH 15/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 93baa0c6..db9cfaf0 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -85,12 +85,16 @@ def primary_descriptor(self) -> dict:
     def baseline_descriptor(self) -> dict:
         path = self.path / "bluesky_docs" / "baseline descriptor.json"
         return json.load(path.open())
+
+
 def apply_points_axes(data):
     """
     Switch to reduced dimensional axes when available.
     Useful for gridscan plans.
     """
-    transform = [f"{n}_points" if f"{n}_points" in data.variable_names else n for n in data.axis_names]
+    transform = [
+        f"{n}_points" if f"{n}_points" in data.variable_names else n for n in data.axis_names
+    ]
     data.transform(*transform)
     return data
 

From 26d11756a53be2348e5b53c2930453e6eebd723c Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Mon, 3 Nov 2025 09:49:07 -0600
Subject: [PATCH 16/25] Update .gitignore

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index bc584112..4551f2d9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -48,3 +48,4 @@ coverage.xml
 
 # vim
 *.sw?
+/.vscode

From 93ef8e97495bca10d14f89bbec52703e67241f93 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 22 Jan 2026 09:39:20 -0600
Subject: [PATCH 17/25] Update _bluesky.py

---
 WrightTools/kit/_bluesky.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index db9cfaf0..a7962d5f 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -17,7 +17,7 @@
     r"(?P<date>\d\d\d\d-\d\d-\d\d)",
     r"(?P<time>" + r"\d{5}" + ")",
     r"(?P<plan>\w*)",
-    r"(?P<name>[\s\w\d.-]*)",  # not great...
+    r"(?P<name>[\s\w\d.-=+-]*)",  # not great...
     r"(?P<uid>\w{8})",
 ]
 __folder_seed__ = " ".join(__folder_parts__)

From 82dab009aba770a698886c480869d9b1963933e4 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 05:15:14 +0000
Subject: [PATCH 18/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index a7962d5f..7c899e5f 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -12,7 +12,6 @@
 
 from .._open import open as wt5_open
 
-
 __folder_parts__ = [
     r"(?P<date>\d\d\d\d-\d\d-\d\d)",
     r"(?P<time>" + r"\d{5}" + ")",

From d9d1b1e55deab737fab23d107398a24e1bae29d0 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Jun 2026 13:24:58 -0500
Subject: [PATCH 19/25] compress_sensor_mappings

---
 WrightTools/kit/_bluesky.py | 52 +++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index 7c899e5f..b3e142a6 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -8,10 +8,14 @@
 import datetime
 import pathlib
 import logging
+from numpy import prod
 from typing import NamedTuple, Generator, Iterable
 
+from ._array import joint_shape
 from .._open import open as wt5_open
 
+logger = logging.getLogger(__name__)
+
 __folder_parts__ = [
     r"(?P<date>\d\d\d\d-\d\d-\d\d)",
     r"(?P<time>" + r"\d{5}" + ")",
@@ -86,6 +90,54 @@ def baseline_descriptor(self) -> dict:
         return json.load(path.open())
 
 
+def compress_sensor_mappings(data, sensor_name):
+    """
+    Compress sensor mappings that repetitively broadcast against e.g. all points in a grid_scan.
+    Note: do NOT use if the sensor axes are dynamic. This method performs no redundancy checks checks.
+
+    Parameters
+    ----------
+    data : WrightTools.Data
+        the data object
+    
+    sensor_name : str
+        the name of the sensor to inspect for compression
+    
+    Returns
+    -------
+    data : the input data object is returned
+    """
+    # determine which axes of ndim are entirely sensor mappings and not part of grid
+    is_sensor_var = lambda name: name.startswith(sensor_name)
+    sensor_vars = {vn for vn in filter(is_sensor_var, data.variable_names)}
+
+    sensor_shape = joint_shape(*[data[vi][:] for vi in sensor_vars])
+    non_sensor_shape = joint_shape(*[data[vi][:] for vi in set(data.variable_names)-sensor_vars])
+
+    exclusive = [prod(s) == max(s) for s in zip(sensor_shape, non_sensor_shape)]
+
+    if any(exclusive):
+        # replace the variables with a slice of the original
+        transform = list(data.axis_expressions)
+        slc = [slice(None) if exi else 0 for exi in exclusive]
+        for sn in sensor_vars:
+            new_shape = tuple(data[sn].shape[i] if exclusive[i] else 1 for i in range(data.ndim))
+            logger.info(f"reshaping {sn}: {data[sn].shape} -> {new_shape}")
+            # now rewrite the array
+            data.create_variable(
+                f"_{sn}",
+                values=data[sn][*slc].reshape(new_shape),
+                units=data[sn].units
+            )
+            # perhaps we should just create a new array and then overwrite
+            if sn in transform:
+                data.transform(*[ai for ai in transform if ai != sn])
+                data.remove_variable(sn)
+                data.rename_variables(**{f"_{sn}": sn}, implied=False, verbose=False)
+                data.transform(*transform)
+    return data
+
+
 def apply_points_axes(data):
     """
     Switch to reduced dimensional axes when available.

From 515d8b9e260c0f5f6ee7fea51935792861bdf404 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Jun 2026 13:25:38 -0500
Subject: [PATCH 20/25] tweaks

---
 WrightTools/kit/_bluesky.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index b3e142a6..f7578716 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -20,12 +20,12 @@
     r"(?P<date>\d\d\d\d-\d\d-\d\d)",
     r"(?P<time>" + r"\d{5}" + ")",
     r"(?P<plan>\w*)",
-    r"(?P<name>[\s\w\d.-=+-]*)",  # not great...
+    r"(?P<name>[\s\w\d.-=+-]*)",  # not great...just trying to include all valid characters
     r"(?P<uid>\w{8})",
 ]
 __folder_seed__ = " ".join(__folder_parts__)
 __datetime_seed__ = re.compile(" ".join(__folder_parts__[:3]))
-__fmtseed__ = "{date} {time} {plan} {name} {uid}"
+__fmtseed__ = "{date} {time:05d} {plan} {name} {uid}"
 
 
 class BlueskyFolder:
@@ -49,7 +49,7 @@ def primary(self):
         """open procedure based on plan"""
         if self._primary is None:
             # TODO: open procedure based on plan
-            if self.info.plan == "gridscan_wp":
+            if self.info.plan == "grid_scan_wp":
                 self._primary = wt5_open(self.path / "primary.wt5")
             else:
                 raise NotImplementedError(f"plan {self.info.plan}")
@@ -160,7 +160,7 @@ class FolderInfo(NamedTuple):
     uid: str
 
     @property
-    def folder(self):
+    def strf(self) -> str:
         return __fmtseed__.format(
             date=self.date.strftime("%Y-%m-%d"),
             time=int(

From 4756edcbb09998d1099596c005b6a04b01c24708 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 18:26:14 +0000
Subject: [PATCH 21/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 WrightTools/kit/_bluesky.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/WrightTools/kit/_bluesky.py b/WrightTools/kit/_bluesky.py
index f7578716..da0e7815 100644
--- a/WrightTools/kit/_bluesky.py
+++ b/WrightTools/kit/_bluesky.py
@@ -99,10 +99,10 @@ def compress_sensor_mappings(data, sensor_name):
     ----------
     data : WrightTools.Data
         the data object
-    
+
     sensor_name : str
         the name of the sensor to inspect for compression
-    
+
     Returns
     -------
     data : the input data object is returned
@@ -112,7 +112,7 @@ def compress_sensor_mappings(data, sensor_name):
     sensor_vars = {vn for vn in filter(is_sensor_var, data.variable_names)}
 
     sensor_shape = joint_shape(*[data[vi][:] for vi in sensor_vars])
-    non_sensor_shape = joint_shape(*[data[vi][:] for vi in set(data.variable_names)-sensor_vars])
+    non_sensor_shape = joint_shape(*[data[vi][:] for vi in set(data.variable_names) - sensor_vars])
 
     exclusive = [prod(s) == max(s) for s in zip(sensor_shape, non_sensor_shape)]
 
@@ -125,9 +125,7 @@ def compress_sensor_mappings(data, sensor_name):
             logger.info(f"reshaping {sn}: {data[sn].shape} -> {new_shape}")
             # now rewrite the array
             data.create_variable(
-                f"_{sn}",
-                values=data[sn][*slc].reshape(new_shape),
-                units=data[sn].units
+                f"_{sn}", values=data[sn][*slc].reshape(new_shape), units=data[sn].units
             )
             # perhaps we should just create a new array and then overwrite
             if sn in transform:

From 106321791a78a5419670405c5ef2148646f7c429 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:13:52 -0500
Subject: [PATCH 22/25] test bluesky

revise folderinfo test
---
 tests/kit/bluesky.py | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index 5d66b808..f636806d 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -2,20 +2,22 @@
 
 
 def test_folderinfo():
-    name1 = "2025-10-27 52433 count 2 beam PL spot2 post d7f183b5"
-    name2 = "2025-10-27 54622 grid_scan_wp spot 3 spectral 6a45457c"
+    names = [
+        "2025-10-27 52433 count 2 beam PL spot2 post d7f183b5",
+        "2025-10-27 00622 grid_scan_wp spot 3 spectral 6a45457c",
+        "2025-10-27 00010 custom_plan +-5 --testing-- p3uyqhr7",
+    ]
 
-    fi1 = wt.kit.bluesky.parse_folder_name(name1)
-    fi2 = wt.kit.bluesky.parse_folder_name(name2)
+    fis = [wt.kit.bluesky.parse_folder_name(ni) for ni in names]
 
-    for name, fi in [[name1, fi1], [name2, fi2]]:
+    for name, fi in zip(names, fis):
         assert fi is not None
-        assert fi.folder == name
+        assert fi.strf == name
 
-    assert fi1.name == "2 beam PL spot2 post"
-    assert fi2.name == "spot 3 spectral"
-    assert fi1.plan == "count"
-    assert fi2.plan == "grid_scan_wp"
+    assert fis[0].name == "2 beam PL spot2 post"
+    assert fis[1].name == "spot 3 spectral"
+    assert fis[0].plan == "count"
+    assert fis[1].plan == "grid_scan_wp"
 
 
 def test_filter():

From 5c103e04751f769818c4df8e9179ff6a016a1c1b Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:36:10 -0500
Subject: [PATCH 23/25] test_compress_sensor_mappings

new dataset added
---
 WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5 | Bin 0 -> 101734 bytes
 tests/kit/bluesky.py                          |  13 +++++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5

diff --git a/WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5 b/WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5
new file mode 100644
index 0000000000000000000000000000000000000000..bca86e0e614400c00440e2d6700c3ffa786e2f77
GIT binary patch
literal 101734
zcmeFZ1z1(jyDz@!PU!||6a?u8>F)0C25F_0?vj*lDJcO#8tG6{8W9kXPA?nw{s!mg
z`JUgo_dd`0-@o(l>{;`^pLyq<&&--NYi1TNB}Bwf5D5?gzyJ>qfCix7T!Mdof`VBD
z#El4?2I~z#7q?mf-~}jM2zh$}0YC--b$B2-I><g5)U7}Q`ZiWk5)}mipa5X|;24w*
zU;zihg9LU`w<TtQ(j?)x>0MCzcl7@j0}`S_3cwl}fI1pHD1HO~_j-cFfE)1NRsXFN
z2B^Q@?bpZvi5q*s{*48I2k7g&nL0UJ+S}>t-^lSHAZ~I3@1|RyZXE^t2XieaL%M+i
zfY->NI|t%A1%G|F7`mG}1GV?AGZ0?K5ZCsA0d(8^5!;#QKeaG5wITD8v$r$#xxs*b
z4DC$po%D?jZB3mF_1*O??MzJFL9oB6JpQHvWkv=u2mwI7@yFQ0(9X`(M&It*9MCbK
zUzpc1*e`Is!13Qou(UNaH@!8C3=q7zfB?YW@Mdgd=nS;?PkaG~2{2!<*Vljghj{Cs
zy`8g*p`FVOY1ew7f7sXYul#ecw=s0G^fYziV}AUI@e!GqiK#h|y+8efzxB__)X>G$
z<RASbyUq*t4>(jI130gLfo+d;<DaFAsqG)+UCV*~0l5PE2gLq0{OJeGjUPbXf%<>q
z30OAR4`7e`(+=E?9cO!2C*x~N|77Q{d?Vc0;k;>D2msnmecZ0uGc>X>1=r~=-^kZ_
zfB_ua7#g`)-d5pO0sQ@2Cjs@)zY9Tq69De!f9Acu0t@v`Or2dU?F?P6Z$H2v4f|K<
zAHu&v4ebnVJg$4dUxC-9-wOW<{Iehjd&@t%m<@}*gUxl{_*-_c@Ne0H2xU2W5s2%j
z>+L9TJ&rN`E#H4g{PDaL{12+X2_At`kt=@_|A)lwXaxYE9{vZ_|0f0Db^<#OPTwW|
zZ(Zy!<Ivya;I4OV>~C^#@4J?R8x~w1IDNM~a6bq4O)wsuzKj1u4(eKe^i)vBKhk$H
z-rS7W7!7a%zvKTa42VCGm$~5@_#nRyVBTSFlK^ukdsm0+YtVG}=2;F@iG$?e=QSBn
zcpX?Cv9LdU#Qu<(S%sO6`|%@gW;RA<7PiM6Y!4r?aX)$lnhyVAhneva<Kydm;PSvR
zSPpy^0s}aoh@p!iFb$e61IU1h>+tt-S=hN*I2a#sv9Ysr-Ifa;m%#ZPoUU&cCl3H{
z><0$0ec&tun7(~s_;WsT{rCimub+0e0c;O^UxJ?lV7VIT`GEq$gYBDpS_0|3o^{*?
zFdl3N4I~HK^DuPe2J3(-P%~XW>u!UEy|W9WiM_G4sT1S%*lp@`J-!1q7$E&!`@lI3
zFo4?)T(5h#;y=c3u>at4z%kgDJGbl2Tm)$1Zh1H$yWsr4@)!3G?pNi2pBs1i#0Ta7
z6>kI}J-9y^+q>R8>40-jU;y`vC%5xJ0MV`ZkA4AeH)4<++<t!>PniJ#lK)Kq2ml}j
z>A`;fH9t^A2GWDu`L_N4oamB+^#8;s1qcUj@4uF#|Ci^){X6#lhWpENgA#-Tw=cMV
zP=Vxk+k+Y;{}oR(ApNg+patoF#RDBk|4%&7-@*N=eheVo-TFNM$?w+hAxQo&>v!GG
zj3E85>Ia@4{i=S~CT_w%)$h8?{SEiG`u*kk&hlTx0mousxH~?u-irUYzrphZwmWig
zzhDQ+@AAfR2M@M$`!@0CeEROV#|6swPkeCy!afg3ez#t{ckF`wxjVk`-LVU<CqGDj
zx1Iub@L;=wAUU{S+^we&NdHgu6uyH4+rR7g6A%sp6ocO%ML=nABnr9!kAvWOo)}1e
z_r4GZ$?w)%;um<yU*M(g;KB1nX^{M{Jb`sUl?+J#Pdv$jaA5zzHspRGm%n2djK9mP
z!kzr!{-6kw-{nQ=4jyb*86^KzJyk&Zf2ybI9UR#HUBA^pIB=v6x&Y5R{>TTKuY>2`
zVE(}M)CA?bTTd;J96Yc3V}1{kYlGsu_H=$>Pxl|}>4Eg%c^2?~`fHiDt5tx1oG%&t
zLpg>Z{oV1y2qXut#Q?(}W#1v*_*VVL_zC9G1SG%9<IN=WTK6j+%|Q8nRc~{U{-64d
z1qk;~{#$}@ck2%l1KxubV8QSBHv_*J_#e*za9;}I`mG<l9|exV^R0iXfB|?S4+4VU
zkHPZ|a10*r|H<BO{ci?-Gw_>%-wga_;5P%m8Tie>Zw7ud@IRLUcRgqQ?Uq!u7k(Bf
z>jZ-?WU#Mu!Xg=qp^V71uIx^El*wQzV9j97+<-B(gD3#*dZj}wmjuOK&)6UftDfRH
z)b-Zl69JfdcfIZSxrF<4$Uz9E!sLNmW9(!Q6MQM?1lik{fyX{W{5f__ePk}ra*N~b
zX6qf7yCMiV{?)}vMdgtm-FD5s9NkX3)8wVpMfi5<Le*h<eA9iJo!YU{Q7scjoYU;u
zxW?M-!!%qNm3!#qyHnl)(Y@+@)B>oMTy~HFy4Z7suxHY<g@JFXBauRDVelh~Xq^P%
z<8$u!Y@w+l^mr>;WLqmIVW+$iZif(5)XQ}UvNedyo70cxDUCruoexyQhzh`~(nNbH
z3@L5HVnPR}b0HE}#rf<7@w0|@Qb1ofj(^cPT`8KEg{DatF1z5)2bf7A+G0Z@?3#>d
zbeXGxFe4i>{HH3Ak|#v`KX9vx{HgGXusWXZs*}6DHwvgG)KSZ!Kwjpl6!T|i$!otC
z4}C)Z26anQkc^I!X;4fQeHafu<a{p@$+Q-MO$q`v+BYY#@eEM3@1SQWVY3~F^{mnz
z@-VD#(LgLcadb*LJ9=jKAUQ?YK}FdURsO^x3A0Vb925JV&1)<F_d@N#XbM;G=ePo#
zOc&1&yRtbELuw>3xGhSl#)YgG6N_OzZ4kmlKW9_JHHkJnv0Q976R3y7JjWL<Zd~-6
z#J0gT!c`?Z;Bu=v9zowKYHKdn(otM16i0r<8BH54yhkmY;C6+Lz_ZK#=FI!*jch2H
z6asP&Ty)ck|3hzskhi;*IXnmE@1VG!u!LAXSAtn3>PH`qsGBU&9+{Z)X1C5cp4`?A
zZc^X;{$XHNj5(-@rF23~i*z#HYQ9Oe#J>6|A$Ji=fXGi}*LP<Nqm9QKIReG&{9csa
z=N3$hC?!|n-??W)o@s{!_SFOOtvFs?3=@l3z4ED%N?+4`r`ja6S$45DcD8i|olDC>
zs0Sl=q|nHQnu;o0IsSJ1rv;6bI)-2=<;xz6@=O3-8E)k;#Y+5c4ok7+r8q8mANMok
z&hck}7boa%-{C#!Hi_^R(!k^|*No8~uwln9ZftzlBzcBs@1f(hKdpeUK@KUV2J>at
zCDeJRGmIcFK=pfwbRVOdD)!sV$c<9ucIm|C@lpSW2d;(I;yB(y<wl9z+B~8qy@g8F
z$!0=oD1=O|g2Q%EQ(4uG-4L2`UK{fZ;Y8y_KL~2*8p}Omn~J}rqVk^!R}$hT@pJPM
zu(y31h(}S(9_sAc!Fhr^cE)+YV@z)xoqsigedvPMtb#&CuBg{SpF<Zv$a{H-V*<4+
z#MoS_A3*RK!TO=Po4>2|Gkip5QTMu#wvuqlRdNQeZ<?=~WmNiwG%T@Tt61fUwMKD1
z30beXw`v)#q?S+(WKM+!i><uR2<{HYTsCC#wv0188*_&>da;q1@p#VdT-Qfx5*=Ii
z&A6~Fa&F16Hmzq*9&|ppa^tX7@|x<mamVah62`D#to#1G%Q3l@$U@;e?&6Mto5A0+
zlS5*bKSH6Qj`iQ`gRJnk&#=<!d5_}Yars%DN)i!qOgVIrxs;O#GIb;3eyH=PJn6Tr
zON*R+1%Z)dJbJ#9>2OtZ*$=eB`qTHej4j&Tf(7%;KN3FBuPGKIrMJ)Kx+r@0li*5j
z9;cYRpOijS`dyX@6&fwm>di>B_iUN8UKwBWdLZj3M;B5Ah>YNhDq@K$UI2fvo?&5&
z0pr`hRWEbiiDW+4okUCwVAvCAY`!w!wCal6uxYVKD%rMs#+fmgw7Grd-Xc}-_S0MM
z{mUAk^YRjQ)$(4p2I@~MsXB4iPO|?ZF)nhE%#n4VSPC3s@nCWcu)_TnA0djh(Sj0-
zP!DW~ba=fXg(-|Ml~|k*rRc2)w75N~Wm1^U+hVb;*=?pO*Wbt7GiTIka9nST!?ox4
zKHUrP3knby6cH8^GF90r)YJN!F2j-x3HOyHu&q#UsjX*X6Icit6d=vT`H{Px_CUi|
z;>Q6cPyp0*$N``)00{N#?WIvbu)7}5EETb<!S@C<FZM6r8nUw~U3Y($H|SsCRu5q5
zTUYm93638&X_<zc8moD`ZZ(<iEG#U*L(9p@MZh~CK?ufPZ@=(-ey9z!N`?eIE8(uV
zo8xEf-{GH_I63+D?NMappd9c?b8iIo+LixvAkiKnjQ4`*kV067eqI#!zfVp#lDV$L
zc(@KA!`7wf+B8^y$dmP_N+C0)AWnaEaB=9}{3IFg&8-WZWP*^8WG^8BIVT9&|8pPd
z|CVPE*C$PYYkUTv4GakIxlpLvmA_xD2mVS9b$vD%m=l9c0JK*k2w+75u>J(?F91&u
z1ND$lkT(S&U6%*EfViGT00ZQW9s=NO;c8}PWBSK_3j|1RVrq7Cs1dy10uLa&$p-}q
zO$Is(0(9-h<aPYVvgM!WOmENiy4qRZoW=d8bEZJI!RJ+hXNvCHx!z|rwYir6lO3QV
zU^_qu@7npVo-_Wd9pIkh-E-c?_O=dArp~~V-q+fH_6x`(*e~E-)Svb+ZqDP{*grMB
zKBVp9WTS6mX=~{Mv<VEqYTuhiy@lNT{%P;_9J;-cm8r4I&8gfQ{lCK-@T|t4_TT~3
z*Uby=CwSNW2Us@xH9@yNzyrjDWR!vX;wnn2x7*{_3b23R_|JCu_s$;!xd-zG+<X1g
zuUp<+9UT7qya~Dr{%H^4rX8;LMfHJauda)_3ID_!aNiK@AMlLIpXa?1uCL(%Kzk1M
zPJh?~@&@c%0D$1lFPI-lpPS@$9<co1JMaD1{t7(P_N)C0pzgmCQhx7O{8woDjrq;M
zZw7ud@SB0(4E$!`Hv_*J_|3ro6Ab)6v|cd`I;;PGZM_2c?Z}_+ZU5f)%zu4vyZ0~b
z{8!gK{`wvYy#DjO_J7{`0`Ls&pZ@)yT3?X3whCN#_@B2f0Q|P=&;If6z1RP>U4h?z
z{mI+yI?w;kIu!65u|NI#@2|@MzbX6QUH7<MuORym=PP@`3y{}k{AZyUv|iEi3q1IH
zGq8>KpbryT?%=`a`@uMH90>YwVD=aIyY_`a2mHU>!QaJ!?UR5G;4l0Fe>dNy@omoL
zJNSoSgLmRNi(5h8FYtHmr`q1)8$tMgI<{`&bc_G+3;bRCBu{VgXfU@i*#58hU-Y`g
z(ftB{*Z%JFTRiO@{9W8F>U#Y)`1T6t7x=sRgu-s|VE)1W|B8S0=v(|<e!%#<_OTLf
z@vR^}VQ-Va{QZ=2s{;3*yZF2I6Ekk{F`)W_@xS8VE$0^h^B4HL_Th?d@%?x3cX78U
z006e)_Uh9w@OSf#)ZF4f-r)z#C)h4HE^NHLYWfBKu6>u*Tf94{VZq;*fbHFlnL2JI
zxxc{QwO`PEi?;;%1GfJw{-yhG@!<RSF8;3lnxR{K=pFlaaknS{z<2!iD)$%oyZPX!
zZt>=K>iaAHOXqI!UcbQKwSR9B?AdJ${_YFR4;T-eKm88B8Tie>Zw7ud@c&;1fTtq0
zogUC3i)a!^C%-8XgfBdrlYAJFCrh$;E`YHgw)NISqDV!`MXEcJn8$7FbEWaWy0}#L
z`Y@`cmB&$Vv6i4V>10~ws9`^P+BfSQ!>NnJ;iIQ(@h~I_YHl%Yr8LN{?Y<F4Ak9<Z
zK}2_sK_*{46VInu^C>P2Ro@vnt42ukJe?InqSX+405J&<ww6eY9<V%(r%F{!zoO^M
z#4fr=%ZU*U4^I@kt^JS;Lo}EXD+&%eI>6weC;*eQrS*qkvOZT?gzyi2BgaS_k({{5
zI(Q!ZQ=E*(`^*_(taNz7XsP5_SM{)bT(6;u7SY7s1Uz@^OU!xjBfr%Z0iQcJf*z~t
z<pZUQa^*Mkr-hD{G_KI?F55OS5KAf|Rp`_j&`xU<u~y_K0K-fQ>g0ul-ZaSpl;~mO
z>{$k>P|U0<iEy=79tyqB(v2{RdT{7FxyvOA0*je)@OYgaUTkr{9)u=-)Pv32{(dC5
z6#uFz^$QDbP`iPnbZ;dMb~ggnS5b<$3|6{Aa6al6F;L|SM)-p%R`FD#^tLP$G1zK*
zq#?r)d-Jl2fE09iN~fTo(nS{qdc!Yz1hWdRiIpKosHmSNb$E&}Ja!eNLV?yqhREqx
zZ~ssjMQuhN;h7TWy#q$2hX!se^q<JjYd$!>@We*+AbP2*BZ}c4=%(||Pev7@*-gq|
z6$OhM;C~*f1JP|H1SwyLB-Z){V!(EM&6lHM{@a_yvJ=}0@$=<@G9QmI$>jpq9ktoA
z1K+y6hId}u-+$IO=;wJ^s+DLyef8vdj;C$jsd2USLultmFOYKQwV9d`>_f%U+;~4q
z=wjuys+O+MejZuAU%`G7KG}qdMKSqGVE4VuAoS-=Xfy*Z4%^_jx@4CuLdm#~m0_P!
z;j~6AmEOw@*zr;+y3Y|OMxP&ozBcA(StgmUcJ8fWq6{IdPVBU?R4QG_zUemg75;M}
zV-2#Hl1hS{vFSx2p($2zQY^--bzSjNLvSX2xpMIr#<lHNf&|cE!7?iOQF9RMp=Gd<
zp~Cnb^c;Qf*D6ce5)T2GC@OkkIK>=#DhIl@YG<P-Y~$y#O;S7TZK|!~%$KaJ#f7F?
z7GE%4>lkGXirT}g&~%L{s(j)e-Z?o*Rvi_P3HDDW9U%}lqGk9HLZ*tzHvTvlp8&3B
zbPQvqt~4B~c`q|-1==;4drG`nXF~Qs<sKWQBT0Q|RYkO*a#8SyB;QcLWko)ILFL!-
zVEY8~u-H`%%9qoMQ|RT+s}q5XS_ZO}<zAj<(^yfHiHbt(M(eZAd22r9+CyKP_MuT?
znMEOsUd-hO=bVct=t!OH+7(Zax#Q>X_86sh^kGRdn29oJLw9vn<GqH0FiZJV_ybnC
z;~ka>w&~ew9qh{k(V<>dK1>zr>7|5`qTYTJIXEh5%=%O_LVa0xQGMg9h5RAbh{ifN
z9~vj-4BjZx0yiqhz<c@xJr&<cWW)8254z1W1xWR39od_x#iNe3<(+H1zA?a=oVu;|
zzj$g{d?*A#LL{FW^L3V`|BRw=3HJ;6Hz!kv15?~D_XBp=GG6+O^B#=6+N$F#R=g}f
zy%~ls(av!nzoR_39>WqgrwD1##pohXmp;eVfA7n)p`!~LbsAiN{ISBZFF6VM;T>+U
zs}zk~8mHq@$IE;F>f+*)2HG>O)mkM_64;by`+6ELnR04>d~jZ(D~sP3NHKUQz$MVj
zR`Bq>OqEEaPG6}FM)zi=uM{H{gIIn7>ADX~VoWKv0`yBw;lyL1`Uk5f#idFHv?6pk
zvgF;YrqFCp;q;u);^O<VM>@pYvf-7+-_izFStcsWh6ha(;xl2hDCJ^*rVhc9I(GV;
z1q~x9WY$lk@;$=LRFwytR50_oiz+u_9AZGXO=fKTz%ZNh3cj}T3A*uN<I`tV?XO!V
z66YnHdC+It3G>;5@}|xAO@!;QhIk*=hG<5z^=rxT$L@U+=HC<>mLViYn2eZpM-PC1
z(Olo*8iyGhRF--fnuo&yBjHZof><R?BC9*tL+<3<<3Jx~8fmIh1T*zWNY`nqPdFzH
zMq=-NtZQzv+o6en0+d5aiE|+~Gc=60;Zs{`-K8)-HCQb(mXV~0W|2zH$ILwhZ%THN
zGSN|#Y*=YN2NAEqu`fhTqz%mw2Gu)v?%%`Fn14y-W?<)DwB94Nv{Opf?9&sokyfav
zr>GV$DuFcrtlrkoF3$nezfArShL5I=G}TCNbe}J2K)~nRj-y<J2aWL^v4NB+a@p2F
z7?NpO=#6;i#-7npM5@&4KNw4C4Maj;Glz>m_1nmtak49`Q}eQKK2rQ?Wg2fiu9s5c
zI?ke%u5SCqvvyjHxHSBW@!-hR`#LtW3dKT}7PW>mJmj;LkWx+Qhue?~b4A1F;jMOZ
z8_hLmNDmacV3sV_P97VKb&DoUeZ268hI?*KS6w&N<sBzV;6;-Kh-pBI=$be9pcFJW
zbmc!_<NQwSvSyeD{!mKwbSsnAthx6^X-~|@tsO$YVhVm$!fC>zXIRe>(|4dftwf$g
z1~%%&YvL{6FDlOG&5z#od-PE+@34dn!(X*5w&HM|Y6_wgt;b(596vtEGj6<l1;B`!
zt2XDBlX%|?OD%<Ixf5s9EbX3^gTXj=jQAqYRV_r#kYE0N_2WX`_@8a*@|8k?S&wLX
zQu@ryji;0N3+eaWsmK7HoWqbtZE>ev%1fd5mmdol>kv(h3!}iinbv!v%vN0UDl|!^
zP`$-Yc+s}?D*iE{^hmVDtEcD5k8E`$*}N+;6Rprgf)_aVvvIwB1E=Qp^XbzaW>VEk
zzI7(;wr4E7Xki_5sYU_3Z#rxxkHQw6BDjAV`jRO9LZWV@pzK@i-ogCRNY==wOO~K~
zzbsPK`_HBwUQd&gyrQ{h?xtKkBb9U6MPTn|yV~nq>}b#_wyOcRc}QPxgQmES9rER!
zHoISl^o;AXbtZkleLIy1oDtNWr@LJbJ=d0Dig8-klAb8NQfjo@Bo%HtC||=r{a&a%
z(@?9IhG~ygK`$!(GPv|!gkEU9<yJczm*3EY>(zExzQLU8vm`HXYo<CT#Qi$=)xe<-
z@&zb*TTJtGO!Z0eZa&x*()%k~`!EYW!4EqPHOkM!{Jw1={>T~t5T38SE6`P+D6s0O
z*&Op>syb;lyAZz}fv(IikdD+@u1`^KC(Ohwb0Ujk_XW0N<#*wHaT*e9AI6%_fZ}>y
zc1hi5t4!%m3Mk_L&n95RJXhAU)^p;G_N_)nR9C2GW9g_}-Wn!rZZ5g;6q)*Kl4fs4
zLuFz|iBsq%g*5jVQ2Kjyf=h*ad?)eBmitkP#wt4zSWKFiy@JAPkOBS}X&Q~jxd2?1
zt3v%DgO^>C+TrhGq~gTilM?t8k~m8TY?2%AjIJNw`z|t8VIYp)v79aOQo&7NC3m)M
z*G8rd;naB0^XqAmq!jhMFrTO0Mtenn-Gc=Z!&K}aXu7m&Z}S`;1j>0#tej;t9W}&K
zA}%+=XJ7GIwdNTtY3h}SZd?%aPsQd+Vni_;s-^^@rJJ<98D%PyDo}V^w$S)Q?lY#O
z{~>_!u+c-a9J{mOgRl(@`Nyza581v<ir$(hy-JjsNz$(=A>zL#sUm%<BcP1sh31B+
zN)3RUq#gUP?#wGDW`iqwl*|7Jt-qzi+X{c2g?c^i#02q$WYVb-`-WJzuy34dF**)W
zU@T84CObA%rFDMOfdTh$i~s}XMImDcNoWGoN*Ul~#0#{>ZmvpSKGw#T`=_Y7XC4=f
z9wczNq}iqj*jV~drLat=L)6Omwdb{a$rps`Sh9IDVB*OT{rG)n{e)Gaq*AM`B6UhA
zgT8)S(N>{jvpd4rkc<&pv{Dcsd~9T4D<Qjwut(9r<rDTTsp<U&)u&0R%;wc8>;CP6
zNu`-{W$VqnBr)ObvdK1M{G8gSmTYx;n-9tk`OQfw-2}Ny%2pM7?7cmW^PhQ^=RIdm
z-ONhTOz&$*m>goCNkMueld-jF8d(yl*pcjG_B`QJpP;cVb_YF1G7L7YWrPhn2D213
z)W>;WC*t(vM{X1Eqv|!!@IFT1p5PUWs-C?1gdmfYeXP#q1-sdylUQ6EXT-|Yzd@2w
z+}WSQ0_jU{W>PYWrS^D?rdP3o-MOjMq0Gre)eSM^d+<j^I876lZ#Z<yS&#c*-l32+
zMO06InP5+t6{4G@j^gjzgxV)mtd@(G;@PwjcEegG>i)neB)!Z{LU#618Y3}ZWZyS<
zzGO9iG<167bI4SoS49#Vo=wjCaV)+7#IVtvh4^fJtOiI9E>b3Foq!b<vy5$&)t(Qr
z$hkQv6-2nF4_0dSR~z%cW3cug@~I!j`^uoD6S7iN%$&ea8Wqc=8gk5J3eV7rMcn7+
zhi~eGYuqoouryrEcGzz;S<`SH%_Z3nZ1H4=U47k0L$R^NV{R{*l9)B!d1_2mNi=Zu
z&QeBEpRd`wF^{Mq<Yfb*818KA5y|0&Lf03q%xB;5vD=P!v$7teH^KRZ9C27^1YmR~
z@zn&(qS!w{vP>g#ixprCl!{E=UU$=UAei7ioKu!9v(3llUU6hD&qON8(SK|=c>e8R
zkY8c23;!fSh}Gkg@0(+Pvt>M|oha)XskNWcP6`cwE2qbNrn{&MQy3G%iBo@CkrI>L
z*8@|-XZ89MUim!D;k@f`eOH!xb?yTeoL;<0su_4po)8SJ4FUGb@9bBDVD+d;3-{U$
zZS+X>&8Cjqvwj{$F)HV8AW^33d&9WMee1+<pLcN^&i?^fE#z||fBSZL@#O>;F@dDy
z=It_enH^cQAzm*uF}kR-vu-QT!cs?T(2qLdi^^(}L!B(f`_5*v!uYqgGr#^juW%!}
zsBq0qh~$~0o9k}YAmY?``01j|t09Ksg)BQNQ9m5Zr_ARG7pnn;A6GKC@G@QzT}tXd
zN0MyA8t%90-!K@nsWYX@5DCho&nWbKC9_1_RC>xCz86O^V1z-1qbQZ@-$IFr{qWv}
ziP7W99DNV@b`~-ixQq!J`au(;lZR#ZH7!pKR&wxlDjmOUnolw7PR5jRPLn4bqUnr>
z>k4H=Q)-1SF(iv_5nJpgI3H~7N?y!p%q}7Lc7G@LWrcamKZ}Ee;7w?ff%Te09^Etc
zo1HZAl9+x#n-Z;1Y-n^ydSCpGaDme)m&`$ue<h-96c!RJF1wv}kx0XrHry4e59pZV
zXgTrL{;uz#0%Yk<iC9kA#V7hBcwQhe=rd@q859NJH9^LgMhV2rwru;Kc*8I^Jg~&a
z$BKeST7aW@X>gAcv2jRByPXI};6O_;SV+%_vOW)BntNaj7%2>W-E;DCICqVbhOPG#
zH-trVPizvTYsg0)tA}2c^8#s4B+pLg{qtYc1{0%8QYg58)e`YFkY=lYiLPh{k6w~z
zwwx(~z0e5d%%@Q5r|yh6?H>8rTM)(h)1?J~u0t680(&+oS-L8ON_5iW+)y1SDj6#k
zt=SF_(U44rT9Du;%LEma3tXCNS)vI1SJr8Z+SMtolIEm&YeUVmWZTFqp5vpUt;CWH
z^KKpjjE2L>ig_vGLze+Py4r|7`&S+ZQ{{=$6+SL8(j^HyTH+)tGE1HVDN6S0JIpM+
z7ffa02vWqRT2UP-FDr0Qcn4GH`a`O+gd?)<eJVL%r{tWWwdnJpeHn^X(%?Hho}a7r
zJaIo_*(MKpm<5p^Mwn)iEz|qZDI+gO+yjd+=S1O5{0NsjUJ#;K6Uzbmhpqr$s#Ut(
z)6^js%o?p$Ry2E$u|BiMix&5+Nj@C;o^{5tc-Yj`%$N&*;ZoiSRHS3d3NW$WO~+Yn
z)s5bI{H@m`+}e}gDQ5n(K&a7DDTM_uqYiFJEm2vZ+r#g1xv+l!s+ys&)T$s$ad6<8
zYJRD2Tda;*-ZMso2!ohy-2~1Y)hxC7Jzk~_7Km2sQ<R_#K2$j>9^UQZ%Yz4;sjX6c
z8#dH*a&05I&q%n;b2z&bsKzi+gkSiSm7l*U`Di8c9Oao~*B3_QB>_)<#fFSQl0MjR
zaUQCUm8=Ml-Zb@NBI1vBIms{uh~X7+-zZn6Q&u=+>6jxfCv5SRrx<I-8d*{vyz1=i
zq3ydr<Iwq8e!V^n+QnCLhU?y(wgxYU!Vp)hnWK05#v$eab8A}mgJe><@K?@n(PfvC
z;sAVhhSck;rO5Uk&Ggx0(z1v88A!$309JaMtCTNH-<Nc2ndEUpp^P{xM!0CJ=8bWf
z1a%yr>pwbE_&Ialgy!iX^?7qr&b}r<S@`*f0ah+jwyxxfUW0H1EuGhfeD5T}W_&Nd
zZ|B;0^qYIaC+RMKfKYOQ#Kl|-OnA7Q*Ve+LutvOufD!9M{Q0VV-1I!o$7kez>sKEi
z58)?jM0&GUJ}u4OMR-D?Ia>@LlLjhp2C1u%OO#a}stw@OZKRfx23dqB9wi9t-8pO^
zG@t!ra#mqS+VT>T^OLdeFBV6KtYisNRLoww|7zjvk2SSRb%sr?^U*I_XJb#NY|5-F
zUT^1_jx<Fcv@a%dXrIN`uI8bi(n)ED0r-SWTDOK`-t<8+(Nx6-Ta>Y+<<N{!L(veu
zm#JLPeHD&7wL%Z=BLR3wo)ki|fZjVxMF)ANF#Y4?(Xwv+D(PfUJdFLDP8ho&Eu78@
zXbJ(s%$!&NQv26fOE*}?<oy$o73S|jSh(k8P(2*o_${=x&!bx&iNIhgwG{51F_}&t
z-gnd}NB+!7b@KW`cv4o$p!V}{@K)zcCa&J+tICX6#Sk>qO-0(L3UTjVlOOwkEJScv
zlhZp#=)Bj`t{_|w*sX(q(+eHyPFDDMIgYY3!8-(s71tNdf0CyNJv}NyP|}|}8`82$
z$;@v;PQLjAzXv?eT-6|!Y7A~Y%o*C_3y8iDc0d4ng1!G#|1v|TL?UHQpYZ$&D)w`7
z1P>((S3iiki|!abL0ZiW^o6v;_e_pI63XLCpZB%Z#~z^(+bC2VK+yFo9bs{vuKRQP
z2obn==qbpMs4Mm0nl8rU&H71<Bli}rxU4$mL52xu{k(XhdEhHIY95fJQvN{SB(SOa
zb8PW<SrN>|EQNW--NDZtOp>sG(B4l-@`&UYlB)caEAsOw2_hlX?udqHJFzCvWJ99D
zwpfVh@G&pW79pP*6+R!r+a~rwj<PuW?(^|$oyU&PRm+?!UgXA<{$iO&=6&zaX>;F4
za+-n;$y-mqebB~@JS4&K{nEavKj$NNJe_W8ElUoq6*tpg=5d+B5S+VKd&CZ{;M3@I
z{Jp}8SxXkD*@>F^e*31y<V>j$>^<T7l#`GQoB=&<)k00SJ*9el<WjMc>3g;sO2RcG
z_Ek?SG@Eju609qN>ZJ%CzAN!PhERLzi1#>Y6io~9J_@5Ss^sD*J7u{-F<z6;%hv9+
zc*8{Bm)IPAk~oH%@6K%6n+s4w4jfAcR`MZN%CbUPF|*EhHue*D`G;Av^3~kUeCr+^
zstx!*=_?UGe?9X>g0q$CN12;QM_p0n2yaVgMcAbKP;z+iB>C~Y0Zryr@mzjClev%!
z9+E7|)W+_M;&837x-*{f^OK1d`rg{KJ!R}d&-AOUkD*y9&qu6nKOziAk`SO`kH+sl
z{C54?7{Nv<)Gid3EWbFC=1BPXw2UB^+iJAFjgpz{Yl$KS9$wzz6dlx-gsiuUAEFE)
z7ZIjmYDzHd;>r*&?PAGk$=FJrLNP&K;a8P=9OuaHv&;6=usD3?<>8WJ3d(tnqOkdj
z8k&%}B4uU=HZrnpFL(sMk@K;I)kw6(EtCc@7_`p3v%Od;b|S?-^W9uSSWi-EO&|&9
zIF1u)+TpnLRzdg3G3Ks;Z7#x}P~lf*D()p1#yA_nBQSu~uAc6|EsE>f9xtBwD5O?L
zH)2sYUC780u`l?-BE94hR>fvFlRt{2wQmWb0{qI3j>ZOKOAIc(JryzOIEw{a$n0yw
z8pKHgAIH&om1Eb_+|1xtZ(|D7eAj<`l3+Z<CuKZh(qea)fsM_KFo!-Faj$Z_pg&e!
zUZ5>PPXDQP`-=Iqw)J``ovsi#eVa*GVMi9h4}GEtKc8aRQk0>9b$xBog8L2NeIfg?
zoP<)LkX|@_^gn$${mJ&7hnP-xgJRT?wB^gOYxkLJwHxuV>l=x0j+zecQE8ixLS)9g
zjrt+SqL!C};-A-VIcYr6iZA%uuM|q}XJ4m5#zi)p0Bf&knch?tyNV&|pId+-{|?Tw
z>C{};1X??`T$-A4WNS?H5bH-Vk{QtmZt)Mqiw|q<VKzqvXD>LodM_l8RJF9|$NG7h
zRecNDVxc7~v108uJg8PtO_=PaaC0=xE@K@-vAOsgMuL<yk}>$=%9aj88>KPddMA^3
zGQ2=)8%I8bl~nwiZbPB?iLs86N{X!54%ehiU5|7LG0wEg=S<qjO>#*`NQZ?RgPm5t
zPB<U_M}oOaTz9uz0=!c%+rqeo+l%lYGx=*{i=$YCTJ#G!o#)vL?pfVWc<4o5zzT=F
z(|#QbPvrBwZnHP95V7_Mt=MT%5nEnQrSoW!??`hZ^ohIjw!tUu!*_+WHB@cTub;$A
zvlmI}VE5{pu~gB9D#OEX0bWvN+p8-Ts#@x(q(PhUJbJL-8+1-Ce_BDg=<pJ!>Z{{9
z6MN0$jWuGF_<izcFhwEORn-Tv@j7Zj{&r7=izHR{j^&dV%jM>y_&4(&8i%P++}G4I
z3l&CqmK5k+dEZqYYJym7MWpN!ZBL+MNfGV(eF}56RbiTfw2IQTKyQ63=Qx(3PR(k&
z?30qTef8=Tp>&z!`9|}RlK3fpUeu)1`S-kv=`Nc9i?U`ttQhLi+!xlQ6DuRV$<C8n
z>lz+4stw^%QS*a)1lGf)ZpI%+C%JH=5|uw`^R*FIzM<{UeNuHOu)rqhHKh9bz3TL#
zUH>Rz7K{=0x8}Fgjk<n?4Brjn)(&MMg5GB*KA-0F%Z7)Y-$*7zk@&$^D2yn}b)W4+
zJkj~^=UHwiwTk#ht_ySqe(<nYZFu>eHgm76OUn^G*R%KHQu$@9ic?cXzZqM5dC_Bq
zw*<e9dGChMKVK+(UwB>8>gUp|$@sc^3?ZXqJCkGPV<_l&<ji92FJ)dwwvP2@pRmG2
ziG<moCHB6EE=vu;L%J{4X-KQ={6>3RU(jK-WGJs+_X(Y$y9k3o5Sv$>4Tk+`RH*cb
z{I<c;FqLY9YG+kxt#ew>tGEv?s-}ysDJ2UZlX4WlebnI%-}!E{^ck6yPhD$CMn6)<
z(I*|X<h-%}lqK}z_uaJTVWaH|PVA_NqgH&x6<w5>^JyyZEm{KS^p{jak$axmE;OC@
zjqzONrXK-V`Uen@Jn@i8;FE2PDm~#lx}o-9@?el6g{63_Q_|-#Nu4?|TjaWCm_Ly7
zzbD!MNc7G;#!MG=TT+fB<B*dNk+XOb?ZiGVA8K~`n2Cl(Euw8ePTx3H?@G)4v+s)`
zm%5nc<*%llyS$NEtyale$$|L34-zschZfN=^h$BLU@8j)a9R~usl0T2*YVEZb5?iy
zA^KmYL~UW1()dC2o(ZaKpIqd|;9SXDUo1SakM_!Wzh8(`eVRU`<-4rSk+AR8XP8yg
zPfDQa_)>r6W-_%Wu&j@pM9T~uycRtk(;)}e#m84Y^wxhzM)}4$U4bBP?i~fptaGa(
z5z~WF3o*==@_)Id37(l<RnHyseQG=qsJLucFT2#?D3C^axZbhdIN5l(_&|QuLw{ci
zSErU*O#esHW(S-^XKtoL5cyN8RFVClYCs!S+Uo>m_va>!GF1&i3CSMoi!c@$)yeo=
zFEO}xj{GR#DY7AhJ}mo_s6b?zT!^aoNKG%*?+Q=B?58|1Uu(#Ad8XS#e%}#G%n<2P
z<w;DaY&-%~hNONst`5h948&AK+61JdGsK}(8wZ{5NKb=gZdhO`ilFak9FrwQa+V}H
zbtnxl#K6TVG(!5uTliQ~-mDl+*F>9GLRW*bxB*llDUqWvPm3l@<GlG!SYL~FeVLd3
za74H?rBl>pJX}hIc$h(5r4Ygku^(}TUbb55Sj_Ss87U1Spv}GwJxrj5p3{G9xsBFm
z;LwKaiM!SF3X{An$HPaF@=9sl|7g0iA@+6RuqyO3BqbzRK|mc@czeQggF)yI`d{!R
z&t8&^q@u$j1*F)7%o1uxXYFAMlEurByqQAWr=5F=u94_RQ^1`<^d*b-L0G3^%SVOn
zSa!TO<lE_26rrUb;YbLF52%7y#^lgmSHzd1sGbZ2mKYo((b4QhMDxzP#Cn^eUr3FF
z#s0k(N*z<C%|Jn6B(pUyz?CJI)aQAd%(#dgch8&`q(P@ur8Mh{TqV7^H!@k4-^;qj
zw2Hoy3}_#J?@Ub?wN<I8O?Jb<_%M*6rypuD(&+u_nBA)1HSpbZcl%}&HrjA%Qg#x_
zNKm$q>uY{9UHCQ8DcwCXH;!z&*`9*k#rcvSEuE5sBjmK0i<t|#4Qz&iZ$vapx^=mb
z2d9H`5gMmvo^w#CP>>oikgW$vJngl0h$wuLMRhMM1fxpyEe<xNWf7ZIjk~(z_y!tP
z;TsfsCCyJ~k!mG9HR40x$=U5o)(|~i7)h22L;I$VrS?YCOHUM<M>oP>sNzWNGjl&_
zQ;`>UHj#{1wPnDZKlb{WOF`RC`#Ni8rJVAMN^Z>KnKB8<eLWSg!kP!+)62PxIn64g
zdR}D#r|1LIUZ35y&q*BU4DeBug6Ku}&hTtet>sOkSRNC=xjf!8@J}PrOyo-_Aq@}8
z!XkRJQWnoyO`hSjGk4%NjC;sk+`POo&a5|jMIzc0Ke_FvF-YhyqpX8i`?LNhYyOrt
z;4-A<47z%moH*UXNbVrga4hg^Z7@;-6w}WUL$~J;y(y#wxrxf-p7dDa!3sIXd*NGl
z_oav4u0<G>Ry|6XQUT;KF5h40$WuH!Dx?$>`oVsgSBWiLh`I18jVo*~)@;bjXvNBf
zzXB%YV?cM@)8~HQ@)=Zo<7Ye<2_&=&AZalXwZ?nfOgMfrEY9A`v79x^durC)vt#;^
z^iy=hTHn}t7Nh8RO`&09Kq@6h*@T!fS1@%rb-RZ01By(3+BtJF2?6Txz(8kw+Sd!L
zfR9!u(%;dPFGG%sXHT16WA+QZ!dyK~H*97U2`%d^_<p5Pf$Zm4TQ7{Pa*&PbFqZCx
zI)3HTkCb#z0;c-I%GP$K3N5#8-eTS1?f$0zIj*fEJ@6mC#P_?da3hP{>=4Ylg+242
zz8BOryr$RlYN~mEGO%fm0s;$BRH6I!{q$GsXwTmA%ynyZSDqNUHnl|6e6CmLj*R~t
z`og84){g&VFTaC{85$!Q)e-ZV3BWox@(J03M#0P${L(3G2jwOALsS`+f~*Btfewv0
zY8OiWA_k|OEV9S<JKxmju9}!tNsiJL4_$r;?7p{kK}D;@nM*{zR<WB(H)#la^>q_f
zs?|npYq;AcO@!}(Elnd*onIY+czrYmxqbt0JY+xX%ZE9tOk{CCeOeM|d!Q?xb%xu+
z|A=lUx1?i;IqA>eeGqqXu>!$}a6;=>uF*q|*Z@<B9VMxrb?@OmO*_4T=CfXfN2~6Q
zm3Hy>uTb^OpkIF<{z`Z7T(W!HLP0~RGzA%2vTvgZ)rAs{jv?=BJLXfeP<va*fw0R3
z7o;A&_z%m%+~rA)fxi6kBA*RMOyBy@Dp=rs`<$r~Tl?8SIk@iK>p+>Diy!bNrMa)e
z%;iTDv4$oaU0+zBo0x<=u`#VGMek}dPF0<tksSUhkYMT<=pT}sBxj83{3KGmfB9vc
z=zDPt!GO!Eev_B_21NdFK8lI-$=DqoRVv<8IEG?M6T4Vx58`Xy(<mw>F0{Q43AFR5
z2uY*-SXC9FAVp@Af~VV~3A?69`w{x*jDN>K?4uVLDS>ZjNS^bMc(S*zzf~X$d~&rJ
zGOy0KoqpO~kWjLwbZ+6XGVL&~CC=2W>ZbW=TFX9Np20MH9tnbLHlXKd1aWZkIi86Q
zvAykKX-cLZi|E+{K<(4s+C)9tPTY9*wKTxe{hGC|au}_l!w38j;mQXkhs>LsrFkpL
zW`e4pr-aQ$N}$C*bn?enF*|&Px|o+E^kbsRvI}m~s8D-I*#Mnii-AhY=(R~qTlncJ
zAGh+^(0hvNgqJ^+DEu%SWcFkR540_$Dc-20pXLkp-Xj@(opvO)W3-M1g-uDYai$Q;
z^jwq_n|5}C_9WvVIw6WF;&o*@D!qv|UbZaP%&Ay$sg4DWlp@v8^qiUiqIc*STPlVa
zIiGoLokM1Wlfs8(m&c#f>xj*bGpbx#Kdpacbcg-<iLDnO(JS=B@@X->u(+F1b!q+w
z<unHQn5w*Vcppfs)u&G#h+wZiG8}#kXEI{ecrqYsG^ILznzHYa=<!ndsi5>vYP|=n
zWpeKdE{jw;7`T6YU{2PnjSl0z95be~4~pyI%14oh<{JsEr0Vk+{Bp@q4k@KFT?fN$
z?kIdTK!pA?twI8kZ}6k&A~$mu8}!C(gk*j@wA=versV_;Lll3j<qNT*5k^$`mgE9)
zh6RdQ2MWQrX#w5I?l43Fih2@zQ~6pABWXdSYq*~63lF7c1JCAi?7q%7`_){Xryw%D
z^xxxJo<6NwP|x1nIFMuCD(2%@aBAm`E#awrm_PJN=`l(spB_$dM|#M3_<bVMP_F!>
z@TB*oO36hd!8@<rHFu4eLz3b=wz7MIzVH7KRjS~OU7ImFnHHSE+sA<lpd1u)yjT);
zS}IT%h2gGomu3;(Yo|wL-{YDY-H)8V8GC*XT|suPVG;iM0*Re!v?~_|O*(fE@rg1m
zYUi=A&&9U$h4faW7RB{07{;jMua1`8PU`fRsRz$_2jk9{HM$!H<61j^aL+n8dbIZN
zXjU2QMb~lkhhT@5CXlsX$_7V$f90Djc$)G&YxPUj7eida_BH4cf=LO1lN~12EXI^n
zBMv3XM6RqC25X)#M)#s^*JwMu{Hn`TdTA6PrY<FUa~W;D5Un<1l2d#`FIL9Bd8aAb
z^ZOqJ35>SK`#iIMN4@k^GcEpo&d<^4j{-_R)gQ~q2*Jabru8+d%6^UQdfBu>mGq>%
zk6Yz_qGe!{R{Z;TN*K%D&5=wi(f;K}xY0Hy^Bn8?1O;icX1X$#t8RUmYmy^Tx$fE<
z0VuN3DN|~Wn~4+sd^oPL-uUa^$|`=a4HaldQqBrLceYx2!h_J{rv212Gvi^erD^fP
z&niNKSfu>q3kM0~>JL&HmQum`B&*h4r_UQ{=8L$qW!B}ASuZx~z77^siBrs{<QG%z
z?y1lvQmDnrzh(YHe40sjq|lr5&~HdQh?i~YB7x>2h%Lr9KdiLPt=4l&Y@V85MZQVO
zz(<iPmir_j)n_v4#}7u*Lh>&nuQE0|l8!DFd`4UOSBh1!cnJ;@JbmhTJm_Nr(&bMd
zJZse%8b7Y#s|uicn>aWsfKW877ox{YJwGI?BrEasy}T*IkT}M!evxXqQDwA7-$HTI
z)Vp!L*W&nW^JN1T)uI*K74urQJJvPRUK=B4L}gK3R`&dp7|r1%>IX+-T?WshrwgrZ
z55C|~6*s6i*B@czxnxN1Jga>%?-ia^%FgX2X_M?yT`$%_xHZi<s*NnA?FMhr;@?%4
z@;P?UW}C*!vRUOcYP7qcY7EJA8`9~WSlN@$h0Iw#MUS*ri&&?t8QpDz&Wk5c7W3m@
zOfhM6N{_HY>k3m~*Sg}jC<gE1R7`b8#|v`aGa75`DxG?{PH+ZqEAf`&nQjQWm~T@o
zszP-Y3_wkCb1y?1PjL&zPxX~_87^a&2qTO;=@j=_iH-^`X6XXURhADHDv^dfyelW<
zBRa<-&fUsO3s`;thO8ZlW}WM}yyq;8qeeZ>(0Os(he*j<0`X>87ruZL*mKr-on)f7
zudlw%L-Wp`b)-D9`iQcehg(sPb&`J+)m==B1`y=F3`d$)uMb7ih25&A&|W>19O#IU
z`@|h4(?ofOG<NQ_R%-Argzwx%kdJ4rag~?TPIwxyFO3>sM{Dm?fy#2~Q1FGQ1p~dI
zoYy{)z9Jr{*R*Pvq{U!bw2X$q7S;S+^2@XVin)5k4_i78j5)p*yJll4o80lso&0P}
zDl42UZnjGeaiQ-pTIa58PS^PCAIRZezp>7*eGM#NOLP4qJU49a;KKvI4jG_t$0<ls
zmM(w^<?{N{`gmq>r-cxoC<h^QeNLje&4|;~m--BjhcT-4W$Lg|)clwD2o|IagYM3)
zlb7w^SxRVYf<AXwWA(|S9YszFbVfyefs2}8WaB^WI>UCx<O2xsMkSKkrnE>C8=U)>
zAzv`XEHC=yntgF;5jEMA@)iAD(uiN-e6vn}5p@E`dPoui9Kz-tS2&Rauh+l~;p@~%
z_TVT*JxbV7gITg^u|k|Kh048JioK||Qep(NMo<J14gZsU%$c`8t?I6Jc)HM+d_r8C
z9_pS-YV1Y&Zin<6A7Xz(bgC$f%A8waiadxAhqD$PqB?}*GD2LSh-M^GeNX=Wy`_Sy
zP?5%X5QR%OAC+Hlb?gGxDMIwRJPh56(1J1=sY$|f*j9}WE^*$vOh4)`a2Ab;(I*ms
z?|zXgsAOX6rQUsF-*MVzOU0k(z@Xa8hwuxgVIm_S8Xz`&QE0e6Y=VC3?1qL`>3Zo9
zHp>t}8wD4sf$WcQQoxM?fsh+gp!58JfrQ4qIRUbd`gecGxjj?`0!X<*M_;YJ#j=I<
zV>gXPtZbRs9FNMGoHX8HxhE?+&btSqQtt3jXmI}i)#C^nIztNu7ywpA0arEmHJ;%B
z3B`o~q$2{QN20QI62bBgY@tVZEA%i37a~;`>qqFGWd7bBSTI=|Ry#Z5!J7aBzS*=C
zt2Ql@3?2<pB45It23o}XUp>iCs{)+e$NNi=UT`MNG)c&L!+T{R<#B(+t$d9oq*7ef
z9@mn_@l}uVJq(V^cgON5v;t8m82D(&k?o)lgc>TG_Q#4}iYiWJ5kwUU_*fD05i<q!
zEc#&-&lb`#KD}vKj$3^IAK5V)YA?I1?>F?oVDmy}@_2?>C#xDp_v4c^#o~E`hR5iE
z(-QSwEx6HPXq|%8YAj!l!%1s|c}YkE$)T0;S_DdS?<XmhejC%H+N>Lo|EN^aU{W%v
zEsM=?bV{TydOYr$&C`HMQq3r@7^}eBHJu$bXl;#Xr6v_;yrT80*BDR}TNu7vG{Q1M
z{oH60Q{oAHRu3CikyEd{p?Xw4p|eBVN)C~@&+2{R?iiIOQnrHBeO?7}O|B$)sA9S|
z)c4fm26e<T^M`W|!r^O0RjRnj2}4pOKKaI{<*_EU=BjvWZyQ~o3gO0-Va0qiTGaYL
z8Q0TV_Q0}KOABp;;WY2Zl2PwqO3;0hAcDyi23-WnfsJ(!$wDy^=js~m@?|P^>~Z$s
z#w30JODq<Z2_@CXf&>@P-o<DkREJ9Ou>={NRJET{Eb`y5L4F%ckWqGhs=+i3fISl~
z@@E-CcOYfew^B^2fpa3YiDpq%@kNomSfF4_d28~@>Ulc1@;W|^7FxGJhvbNAfIOm7
zawVe28(Tr_v*Koa*U0&w<*T?-kF7Nf0;kP#A~uy~SU;4HSjse%*jka4(I2MLc$JjO
zF!fh-L0YK{$PMT{Hp%E}d4YB+5@ywJjQUW^(7)>}At^X6vLn!`!d6cUWxJU;=xD4W
zO{Df<WQ}NyBh)A4ZDO(8XVr<c^~0dR72`!qf~`4~dwK~WFW|%xYY>Ee8^2>BEnDf1
zNz`N0McANR_ezCgBm+ZM;)lZr-6ihg+v7Q-RC0^C?g0rJ?$71N7>6`3m{(Dvqm46p
z>FGwIM;TEb6q&G0sFZVlWmZ)wTd&WbhyPZkVO{ktiu%Atomjc2ammB;h|64-HimY3
zeS%TC?2T*!9JPl}<uJ<tcT3B7<e+lS^i|>#-MDss+9B^cm6hj{H$1&xn5<ZLvON#?
zr62#$T`Z%1t<I&9HIysfbC#z(FPN7uW{Y4<JTc^aw0WE<@Ges7M-Y3*=a0PUK050=
z6%2Ma!`V;6p8z&;_E)zvx@u1JK!hNL_;vvvv8Uv3IM9NY6yQ6vx6}tdPJQAt*PrNu
z&23Rpt$X)iEMN8&yX|z1<-fYPRBvKjpRMAY>u&Fk*d&OQ9>OK9)7e6^d&jiQK0|J$
z8SK$>NrA4fQ!7Wpg1p*gS{h$DTaWSBeaW`rsV%X5V*C_BlJ-LZBmwDSbCTS=@w|cl
zB|+;FEb4^V{)r99SOt`c#}ZD4LNDJB>V6T$-X&6dQvM|BsSn@f6@38aJT>fbfCa4#
zIdl;`lG?Fb{k(Abk0tU4u^VgVY32OLT@k^qG@n+@^|Ms^(SQDMdd<Y*KNtpI(!mrh
z>R*yk-61!Ml<{L;1ZG2=VuPGOiv0?EpAY%DZSpG#WXpBrPZ}Xo4`3G<-z8Tq=QQ>i
zJ1GX4P8cI}t3nsK+ouw~VsXU$PFh38h8fz#cfe?V@-WG^*EE?$F0}kdOUJ2LSB{dw
z5ijzjsgYiOz-d)&xo#R$9yay41NlppQ}{f$Ri;$fPYS)SYNJNRQhC#0X8PUrH|rNS
zP<p~Vss>)YL8wpEz_sM7mRa&rY|{BrMf)KeQ3{STftfh1X3>_m@@Tdylp8xRT&I|E
zx)GuH9>n6KbBNyBqj}K@9o!sKH~XhfDP%@PnT8hev+$A*&Q!<f)F1LJo|eI`LLmvM
z!Z0k_Ib1$*3NnW58Qq34HXkbSQ?gwW(Xf0V5MA_iQ;3KVr$komZ2giMBE1iv`_Y?-
zq1tx>{Xg`QPoy2Nn4y2F$>~`qX<&YfZGD8;NWY41w6@M8poB^{8Ef={&M`>E8=0<S
zXF>X)Go-!~uP)w6MZu0aLCdM<WF^+8RMU}P%(M@oTSqD)Z)H@oM{%dJn@Cbo7@0?&
z`4hU2jDFAyjl$?3Ejwk(e#5Ez!J8z#B>j{AQDxYx$UI!}tobO&dIqf!!V_t22|l|f
z$FSVIEF7c|I((8yssyU4592S;*Q1@v%7n9W58(Alx^N=kNf3<e=u{1l#~<`vy`axz
z$HeYjQ;FjY>&t+#j6*iu%%jZg;Mhfn|LnB4koP94p)SX*&upa_61yZ>1VL+BPg{ht
zFjf?2BNc(jy{p!A=vAI7-0q5cxfFzfXZ)s^x&mFn<n9w6X#4A-i9)xde_H+<$;9aA
z%}8p^H@O+ZvGRK^*+IcjZAIAvLf$_Tt=c^8i4$IV4mn-qS8Li~KAf1BNO_Hhh3s`Q
z`Un~UvD{_6@p#hBAIfys`WgD3Vl!+BpAo|VXHkk+!XwYXBa4ai7Q!X*3nbKMtP3!c
zO0)^pEPM&@-ikb`QIJB)xXV*K7M8CYt;a&mZ1^}47B{!VKYeZUd(G}(AWwklxy#Gh
zCO#l58yg-Dzl^|$V#yN~_s%8MI2PrFV95|cmKtj<TVbZ(OG6zty!ZZUl9;VX5h2bB
zT>8!CUnRz+=ThprqS!D`2#8>qmrU(zk5K6j#(KI3?sI3y?_x7}R7e`zR%1Oc<Wk>P
z3}D>0GExE9E~_{r2QnY-bDmX}h+~y(7@B8}bv-EXChGRc7{x!v<h<9VO54(Q;eFK1
z!gcnQ)~`LsxTl6Yef>&`PbEU%Jz0XJjXf~nrz455Sj{JLb3x7~&9M@*cNt7;<&Ia%
z6CLeSn-|~gX~a_<64R--+0i78CS{*FaRZ(S=nqxnz8?8sg#A;HDB-e&i?(gswr$(C
zZOyiA+qP}nwr#t6-nrJk=WU;T>fw*9r;4bE`XVbc$4Fs;bbwi^KUit{bw{pvvVM5n
zJx3}}<olez-|!>*|3kXJ^?m@w@q#q}1!ck&8-fTTl&~NK-Cg8xR(^Bqk^lu1Xn_sI
zE%Uba+nVa{h{Pdqy7-?tfmvGZR-27R)2Y<|EqK+poxRw0Fn(tY%kn*E+F7n@%F2t)
zF@)pkG$h>h+3KQOLLQWzQl9nP+SXPNTvuV@zZ1#TdYo^>&i&fokf$z=dE0v7D-Wz9
z2FG*-y<Y#`M&Yo_?r&k~e?0zc2yArl&{|q`Vi4BVHxyA%C8mO&kQvO?+X~|Au@iwq
zsFh(*(ykhsg6FtDBY_-;mHePk%+r5te6Mi`9WUr1{;MCCn#UEJ$lt4$L<I1P&><`l
zE!*xt5)PSYx0i+5-8Rm1D^bLHw)!KRp;8)2%$Z&4Wq<s3KM)UCH!$-QTh<!$uc_!C
zV$rKwbQLhYw65f+G{)gY4xip=DMVPfs@egJ3Uyz&*enzY_*T5yk4VMiKR*xq*S3B9
zSO5;Tbu4B<Z*P)Wa9@_;78&UnsI#vL^DLtF{N$dEA~dCVd2I(9FGN!+xo-z2YV)Z#
z2*f*xNd>5omecr}!4Ly1`o=OPjMj3M{Siju;;O*d3B%#76;&WBIKL>qX#RZ53tMGH
zo{l2}>)v6jl-TnNx)eh=0(@%~5M-&jTVx~GyMXtMT^ylhz2{&@iD2s<8$*yZyH65v
zI&XBnb3m{rk9$KFZtYAvQC2znTSOV}d?{P??<#~1zpHAPLGE!Ot3xKarKH&F47S!0
zFgg+?uOy;`9o%E9qq^xH0o?f!Ay05VEIuLOVi$(8EN4o(5~Rl*<uH!6Ov9>gF5^F)
z%YvGuc&uiuDZD4g+}YElrefEw(z<liM}jhxc(V508uJK-65a8v*N7^mQpLx3iwoz7
zhDOZh9BrzS5p8AVy4<-U3gVoC^+cX{b+WB!KAoyO<1)qeqryu*6X99Ya;j&*Y#EM{
zCF#gB!mmaM*@;f({s=J;F`f{SOaYD%z(Hn^5+x$uSOT7b^tog4s?pR~?kmPzy0sju
zHNC&!MzC%R5Y7}aw8uu0Loi0;@{9^x#|7arFt5^DsspsILIc6^U`d+@zMC#6acKUC
zfEmS&V7g(-vlqm_(z3J3l`sQcxO}uoQl>gRqsvHX&+*bDwLi+|^Xs<|mrs(>FuT}<
z*rm&=v~B(`Ah~Kx$}%T}1>MiaXNDFes}IVRLnSLFV}*Om@3oQovae+FAvvvL(29d=
zZ!g!i@pe!?xo|e{0#;R3cG-JtJRiw4e!%Ocb-&?CEnSCOa1m?R1Yw016mJW%6I-4Y
zVYiTByhQ=hvP(r(v~H!}B8IH!PEx7jjLOqWar2b+&@M}Rgk%0s`l)EnQjG<HVnO&0
zJuU0#K@!*^U1*{+$l*4sJ_kXUEnYPgAUkWcH5FT5v<ez2DonH_N)Z`pZ*MLutE`(E
z_}APxdW@2FOUu<&1tpDDBCe3!W0;DHzEM~089zOC!7v#z>AdGEN%oCr&u3bWH*RGn
z_EIq-==#RgmFMrzT0x7jkcwioL-aRd@>5FP+0~VS1)kDXt|z24a+5%wx*sHpa)<Mx
zfzNOb@)ir5y5Hhlbh>JKNzG#J!l-KA)xJ(SISgA2JcHcJvLhd>>!j*!#r)z95Y}cE
zoFV-u`ymK)(q{p4d0!E({I3%RkcX9hS&cYyBY+()YQs9Ff~76{PmIGQhxmm7*Dwo1
zAj)YmMIB&>FYot%A@_y<N`E)XT=E}IUbXxi5f0Xjlrn^zu%qdvob1hN9#FEQq#7wP
z;T!+rKRc#BND~1F!USk^{@?ld|3~M~pC{i>YtKI)7j*0|ZgOvFPibp6Z>|^Wd_LdV
zPmkWzLHTdp;lw+RBWooXLFuy!lD*g4lnG2a7nvYNlDTR_NE673aFUAO<RieM5Y+~f
zph1lWRY!HO=mwFkmwy~jIF<Nh0L3GTAts=b+({gxHApq5M>@`!BRcxC+0CV}3&|0I
zqyQg<HQYfkTO-}$C)!*@F_~1~RT2L6-|8O@T^)sSi3v<BGJ*=Jyn4nku*X(W!##p!
z7jcQ5eq*r3zA@MrPqO!Llp<vUEO+MzDg=nj>@VXfHCWf7Dk`4;uF9iKfFMv0+VexS
zlS-!o8QO3~=k~RH?#(>MD@9BGU1n<qgEWO!Y~SJJ4ueo7^wtF0Y1`fPU!C5=8rWZ#
zQ1Dmy6k@Mls=Tw;%mXksM9-F&!a`eEdf)14$OlZ$r|2$aod%v=GxfgHc%;MX2X8g@
z>iQr<<s?wX6acluT6*n`7Y>Q~J)d0vU}Uene1SFPs3cRof7!Ep$6n3n{SJYoWDkAH
z`f9Z%8ALBBwV1u}${McR4pC7MSr-fd659@Tlo$1=8D<Up0}Lj_QV9S7y#lo*a1g`w
z<Uxf=13KoWXz9dpXGZ~BEvamWFs^_&=X1^XjcX$sk~pj9@N96QRIbC(OK%JT4Js@b
zaGsf!gKdek+x*p)uv;F_9n&Y3TNH=qT;U^6dRAGLtsTpm+L%`KmY|HO8mnV8!+83w
z%*dFUV2vwfNqUk0tm8%5DOd6=F4utnaLs!o6;rXAj)Xy467MW`gdtlxoG4|@sc8!e
zQGL7{r&O6ZU9+vF6y;QwAEmTJ*OsV-V#C2F$a(V>F53oGK}$OCd@X7tr4o@YENC#j
z(qGI0MNL|J)1I1I%zM5@k|aEmXf4r9rV6OqV;xAR8d3m^8(|pGI-w{Qaj8+NtrEi+
zE&^AqX@u^DNG~u_SevX68AydI#RwuuRx+Lw4Q1$h&JaQ(O35-%dd8V+e&Jan&<AxL
zX-VgGY0ewl<VuO0x2?*nk+fn4EBm*<r@7JsmTYM;!57Erly~^-Y3`fm#=;3Ll)Au@
zB1<#$$)h{AiTy^bVC9hVV8maFcdIGNg)PKVeTM3z-5{UDv;s35w6l3k1!xV3f0U51
zF!K^WWTZTqj{vihYmfB}kJWSZmw69HCZ41%GSdQx8Foex$7yLR6^15N1yNAMg?4)T
zBAsi1jFP%Os#0@ZCt@YKkxlsD1{pQOIT^98dTZfyGlM!7g^GCTSdBlFD)YRKY!3w?
z;gay;<#8ri$nIRdxqW(P7MAt+mn<gF$2f=Daa?j9c}LARz!vI#cqME7${*jJJ{ORw
zmpoeN!@?t6P3E?}y?TCqxq+J{g2>Hh@|JPW@um7_{AFnQ3&{{XO%1B4*Y3G>Yl>dR
zQ=05NF8Pd|m4InS<$fi)NealX1OtLw+OIufWn>(1N-ruVPDO4FOw2X4k!FO<K-y~%
zjBYz_-ECxkyEg|ZZ5tZYbNf4Dwn~?;-sC)QWTur8$A<FwaI(Bi$2qyXeli(1hWw}l
zbhrG$h?-!wDimQqq%0D!#g~XEp<4NMT+i|ayk>vgBW{hyWZMe$|BJA{L%*OdURWLf
z^PBxo6efcCPZWmZIn92v8zWLc+1!DC`LWlu7wq#)5FmsKKvnYpHM_Frx~FsZHJhQ`
ztK93{`RLk};Us4>c4Ks86cJVo{zU^WW=8Bhawmn3M&KVXl*gVbDmS5#xYHiO43QSz
z8<l5&K!oFtAMBu=+xCIqtbJKc9^@2Haz~oY*vLG|U)v{SxvDu?%l|x07(lMWdfM%S
zLgqBUHIDcup_B}>P)NXxf!~?fAc(AAq>6NXv;g~d^vF(u){`zn&sp!~!8)c~y2Uf8
z?C%6Ipsr~Wo*dxB|Lq%cC%h7^xH6Sb5jc@|E^V+DC{M#*NMz|It5~Q6(6P5Fe1@ZA
zQWH*XN~+Vz<C1i&30F>zj>i?@9EFi8JHZdZGbbWmNTa|+52|PyFF}Sz0LnfP4U42C
zecJJiL~0W9X@Jq0*!!nF<FC0c&O<S|$#JyLK*<FzmY<}^Yc#@AJ(;ska;aQmB~?^<
zA-Fohh}rdbJeww*mRTz5923+#iQTu48d4t(_#SD}p=zQ0r+;D@FHy(7(PRH0{8x4B
zmS{)V^>M35P;lf)QZa3hf;XZZ!>ox^fz}<sBol(1{0S8GpzzYRRRd4}neZdXQZe;M
zAj>|XR44)H5y42QcKs9WND?ZHUL!-20LOmR-;_M1^BNHucY1gaPLqS<iq@+$I$Zn!
zrey0!I%;OJiQS%<1<#zC7*5Z+qL~J-s+=%B4Ud*ZPwU>7k-C`OPpgty-YE@Zo1b0V
zLsfBBkg$hbpSH>~AQw8fvFxOp4n31BdYsS9{OcHC?4FD5wR!WF2EHF=uJhm;MTfj2
zQ{Ts!*QCnT$Uwa=NE33u!czceyVh0z3B0|3b(T>tLF~&r(e*`J-%}<at78D;6}AFV
z+2Y=I`gSQ$4T(mcXZ))Be(M7+T_)kO;N*(@;$bA4sj6Nu)glVl!WK5DDDn|<1foh3
zBaNWmDRfpX6xV&&HnP|rEYd=5kQ(NeLg1+xB368^kn<!VZ|z_T)WAs<X4ni8<CwC#
zl|LmF+HsAa)g^OABmMc2Dq$Ft0I?@<Si`q%BeiVc_?zX>*=$wG&V;_ob%uhkOYo_D
zY<8fWRNu8rjz;@dE!kVuU=$osKaESPQ<f_74IQyM%JuVX1SEGKJ^T2`JUB39kJP0W
z^ij{zF(sjBN4FNr6aemV6B?>|i|~o@Thqi3RQZB;Xv$$oS^xxTW^C3>IZUj8YAJw+
zcdwc^d8kdo=s1>iyJV4t>GO_(2^L(TZ7Zmch@WmOn*jcpr7hVLzmFE>vye?#k%?$g
zdo|3fI8}$Qwa0G;>~l%D;g*CGo?9Uue}BRoX{z*?m$y{V?)8gWTX2Ek#G_lT_m&i&
zy4T-1+=_8vTJKb*;6sx5#TVjcP9>ch(~&u^BqmOO8Hk2n6?NwZZrz{`9c_5dn%*PQ
z9b5IMBUH7mT2iLwA{Kd4WT*2l^nYf5BJbp^r<g59Y&1}03guFJ9+MQINj@~@ZO0fw
z%jeLY@0DatbVdkaMt!_B;Zi<Wi}fB}c>ik*@^|SMATWmb_#eDdwpy<KjSZ_}NsmwR
zqCqA$=E$i?Nf}yhV0V7ZO|m<F$4eNPF$8<Z{-5}Y{fl$LajP`RH92ESNq6tq<X+dc
zJ$Cr1aYbgEFn8$rD0zS4WazbHr_im&DPv^q*wc>4N+_c%4y1Kei(^zj2uk{Q5l;`j
zk7<SEZo&kaO|xm8{t2HVLdGY#e33Nahe}EYi@A~L<dKhMU%*B31|%|0C5^tND{GC~
zy5{If!sMY^RxBXO2ss)yWhc|*X33Z<5hxXQqg=G`!se1P1AbiiR-em(q%Gs3G%y5_
zZcmyktNGsYs)3SLa{^Mb7M<{h9r|Z7q_A{|MzOtlBc(FU4273Uh>kQByieo7AF6Pd
zy8}eJ;!xwRc5~e9jDdX1m5?>+0BU_1NJj0Ga9vns`X`6XSdy1%lDZJLcrr1WiuF#d
z8-#|G0zn)p!(4EZ14O0bcRWc6^}4lEMZDdp_uMT{UDC1qeL#jraQFo@P!Hu#+Hu?U
zMuw#{$eZ1axw@0KM%+Z?B#nS_$}*)wThf_FSG9I)mGVEai?@MtT9kZl<Aife4~eqL
z?}o!=0(Hv<L3(4U{~=aGBV${$WV$%9QDbL$y~IntR7G)#5p&Y0uZ^UvymDYeT8!4K
zMzDq(zKN#YpIkaPN|r#?EXRwxYsrM)h{{>gNu=-Ax5HSl@&b+ORnuI{*Yv}+9V3w}
z+h+`)*gr0O9ksS1&s?*3<~@ad-S{nH-Lsoqel=qzMQ!H`6=!Y^oZ-&TlPlM(R>-yD
zyl0q*>ORWc=2dyWc#PWQVBbI2NjVE(5_SG%#Gx3@vmA(;V<W5WX5+R_d3A8bLSOHq
zQ2O28;FG7UUoRO{P*k;gTdcvxIb?>OZ|_%ya3xEvlKB0JZ2uO_v6AQHv?${#5mxKf
zuyuT;b!i4!M_PI{uNKbQOb%oHET%dhYOS<01k7>x1!#oL=IIJ+RuLk~wxu(bOwAV?
zC}F=kPp!FYSL~C=u{}hq?L~^UfCKCQHNxgb)`FO4(gUV$md~<@BkugQ@XP@}Pe5SZ
zR)V31D)DtsPm4}}giae~ap{>w!{;;4wVIVjzvmtU54*2E>$V6RV*y?YVr<8NCu4w*
z7t5(dr1vra!kwG#$k8wV<m?FIox{?Dr~S>IAsi^M&V)pIErRv41?P-cEh8x7*jzbW
zG*YnXA99Kwx`@h#km`MBy0o-U=hK5_(Vcn1jv=gn7%k_JDYIKwGvMG6!HtFB{RE*H
z8faqn35Hx(<WB>~L-%nO)9b@sI)DkN#H6=XFqs8{;^R+XD`)1bS=+pFb<*R!(vA1+
z&DQV2&z{P+`g}}B_^?c?uVsdY2@e{0Hw>$_$YID?0!;Yue#0Mlv~;*A9J&A=865fG
z*o1F6*7$nz8q6lFWm#!BRg~M}W%9$q2zl+0gXg=tEI~Luo?L*gDw(##ySe^$xc7gY
zI^N)fD1-|eMb7phA@)6t5zf{$@gh)q_*Z_&1b=^FalC-RGi`=AVUapvzN?GUW1=z7
zWzub%+8dub!@8Hx()Vq_Ioy5P8~v|<;XUsGo}h`i=YR6A?f>Lo|GK^~S9T9Iw+bkk
zLR(%14}Jf-&&<S%1PZDE19F!CXS27jCHt0|98Y~#ebQSe;?4EUWhY&`+X)0INmHMl
z@sC-+)2at4&YCG(0@pe_&vt2GvQNE~O(}pB7|*znUSfn?ub+A#iPAa>C*fGTw2Uhm
zD+W?v3W|;(Dg({Q6cLGQVE#P{l)%Xz5p4!*6-u;|pdk$ONqaa5q#-0`0gsRh!hS)t
zKlu6U5tJCQvkM795~6xCb?0U<gM>F5jV9bwU(H1DR<uHr4;4rF9fYSvQPl#8cD{Jz
z)rMEUy=x@NFY4}ii=y9nBgVvC7_pT=iArD<An(HaRJ?`Cxj&q8pcfLEvRy<INgEU_
z#NjtWXIAdvvFaA?v<Zl@3PGflFxgh(>3rBloBjd@t0cxPIZZQUr2?=nh_F9-$Tk)8
z@#qY-2}x87(yI&uJ6}zpZB-|#DFa~v$RtVEd~npuH)K}K)0Mh_sp>c`;-zXAD8%ow
zuVMlRPwwI!!26R2xMU*3coIs0Cx5LwxW5fqId(S1pv|zj?n3HRuy(?JRss;KgsPAY
z+yH+_RCdr&1oQDgD;lUoCh;VI;;={Xy-X?=?o@z<49N$2J&`1e)E)UCk0c#58Z9<;
zWh1Jc0!K}zxqrD%nN09+WT+{8V7K;E<qK}oP^Ku#M?3N0j!Vj>XWh+?m1R-Pf>usV
z+rk${Pjh5bx75vhT+!@CY+%dcZcpv5+Kp@c3cqdZtJiez<vH?v>!<ay<Yi?^>?U{|
zn-`&3pp=%r!Lo1W9@-o$6lIU=qS@HKea-Xdo{(Bi&%WSF`thGYNXlcPwg)bV&`>D}
zB4o>!Rpaus6K%Y~ujbB8KK~h^7w}80zdp^%76V>2&w-1>f(sU7%2p<Ij(BX43s20e
z_3ahKe6x^)*`xO}Mk%3Z>8{D@79w~GT!M)aYQ#mNLPY~d>2An3pd$*aZuJT-8jR7y
zub0gcHy+7F7!rU}Pu~|iDjm2*qzG@sTFScT%GJ7+IP2~&O;e2M_$fpuE$&+m{hKj`
zz*h=tEvBP0sy2{Zy*}NR#@hF}*>_gc06!*AZ|{o{gsfwwRiYCE;jzGBTr`pCh2CFV
zI6Q8=J`^}LyXgd8;*QMEUYS>%=!0uG<TI7fzbChtP~oTDSxIN{UYqmz5kzRt5Zf9r
zvM+E&K_if_&Ij(aWJ?|nY{3Qwha4EE7dFm(aQVc1Berr^9OXMon15DO!-k(8F}l?I
z1%rOS@wS_0i*Rx)iTkIyU#D^27Ojz#;bdF9Zkc*(P*^wF!yrw?|GbCA)QeE%%|_=K
zR(BJzhyid5I%Dw`+MDaUK=bPFw;%3Ui3C&H`LmAnOTIRJYW&ezd~eRZ=*1ksH^((T
z<h{ppGy|Zc19;mqy5gZ-qm~nkuAx=Rdutx){yRO>{65Dxc1Tl}mX~$b;pF+`f|crB
zSJKMKx2%SXQoiOT^wCgPio6<!Fw1NE8|l8#mx3R0i^^}b?2yLVW2F~}x)!TX4OLIS
zA_h}S^=6hcg@5&5Vd`t$E5C^mZS8;Xwc~O9pA0NgS`n5#^}Q~ITk)SIQppL<xW`<Y
z`JgqeDA2!p+P3Zg)pcmS?%VV}?Un7#z1hg~iKES>!-H$(eB<=Fox2--l1a6@e^^Gw
zy9H{zafUYk4afxQ=#pK)f5JSc?jl2dT)>US<SRY)SsG|#_q&JgO9QYLEWRY%s>~om
zo-ZdL59<(xTQC)IGkn|mses8pd=To<T=~MNyCN%7AnZze>64Ze8LT5f2aSNSkxLj3
zCqf*`Rod?qwRDW&l9tZ<xD4m=|4tv6pTQwKdV4PUIByhxDU<;O+O4a?t`%Kmb_=Yk
zV@iWX!K*q<Qw@iCRPqgvg|ay;k61#d<FGHdS3IISs|e<`2oh+PQsH=cU?K93NtS{n
zK&B?60Ea}qp|>f9H+P>B{B{SWbJGzP`3?tQW$MloCkV+B-;XDV9q*znlSq7}ftbLc
zqB1=T)s4T`c0qRf1<@xBuLSM@l0*L$zVG#;v{f(Z{A2uvuDeZ(VP_u`9>dV2vA~h1
zHm;L7aRLb!Rxr3?tkHd0!(Sczs<Wybcz~oC7~NIsyIVNAsLWPEJXEn{7K8Xa*({?^
z56O&eTIi23U~-v~mRA9OW{8MyB(zGe%MbXh<oSdh^rx8d@h5ZD0PI6opRzY)@eGwL
z51mZzJ=aefoMA7QW8q72r2CJ)5LkHX{(>eyMy9HkV(mE2F{fn7s*1B*#cHC|5xsh=
z60hfEc50?P4wl!(P~zo;8{H3&Gi6J|ZP9b0^KH!1tFE|}NO5WepLU1STYGbMgmv~x
z=$ru~)7&Is+@Kd_kf@|V16d(kQ*rLV75O#+=cgifLrdDOmvv1WlvNeEOQ*!+<X%Vi
z^_kl5r1=Mc8{RRg_6?<=vafe0lX1voD)%v^gk1;Dm;i%oc?os$U%5uG3&wbn9vNR)
zydt8OU61UZN51)a0`^Fj1Gk)RpTbs9y+jp})_96OWzteNY4_X;%HAjW(Q1`&)0Tv6
zDnYndSuk@_V9`+R$9e^1xlO^mS)#Kl&F@8e(tV|B4$ONhl;BZh#!Xn{B(^CsW6EZ>
z@S31vh9WzmEu&=Cv?C0B5GDLf1IMoAW)as=T}p5cl>)2{8WX&cO^xMOOt~Oh5>Qwk
z+~6p5#`sma0uSa#q99AJ9(M*ceB@^lAAs>##NE_)AuQ-Z67|Uy9r8?0IxY<`VeU-h
zt8z0h7ArX)ZvY`I{j>v@Od}lvv(fibaT|2!*8veveWg&DuLGE_(Xy1KDx<p2B|Y$=
zHTy@sH(nu}Ely695l3EtzjPlMGGH}8-Pw8p<^0N$Krh+@I>y<BF{$TfF3QujLn`gc
z7P4a(CaaE~wpZt^g^;U{ia9S%xUp$%lZ-Y*Z+wNKzhLR?$hsI>^uK=^!rf-0?r!ki
zLRwq9I8;@ZFtp7q97*!!Gc4yXynhdnxN!^PlQ7H8|Hh`Cx|!1D%+#a1fhW2Fw|m04
zaHeafy3}tb1v!?k$L3><K!;DA9h<@Vp?31a;pjgg|ErvVz4`3uu<&A}+#PR--cp->
zkNNz#>#M}eo40>NoxXf<^79`(b?~RH0ccI&*U*sTeCO!>PkC(Z7tnnJOXk0POW9_F
z3DFdiQlO+7aC9U6jVL^|H}7^^edY8}r=$ugDF;c5zcX69<Mco?6C+OO9~l9qID_N9
zt{?ipjy^4CpDW$Hx0;tKx}IOxk=54Dlsdl6lSLiv8>KH)>zae%6w*M);iSFJqpMZ3
z{ZGfM=35tei9H<l$$F~9Jmg2JIjf0G<VJ<{=53>8d!iNWJXJ?11b~Hodmr=t9tlq3
z=rD<h*WG{@y{x35Tmb}Cgsa_zMSnHN2AAN<`c6B1N>u;8lqg`y&()4jH?j9WkX4hd
zK>5vgwZIaUjo`JCgFWs?3fz>GpGLK%;Yn0=K3h9>@YU=O$s|=P%9_`2ahrQHgmG5&
zUMb}A&=;s;XikwOfevUBr9zO7PAP0NAeR$cG)V|vuN#Wpl84j!1+xe$>4DLln%rOP
z+i%<}<_15T5sOxXtQYlEB~U?&v2l-<GmtkyO3FkjHU_e9a#>elYED(!wq56}mW8Mv
zED?ewwRN+p$$}B2&CH6cxShHsovMkNDW!8%802ELTPdT38wNX+h{0bqu3Nnuu?l|5
zN@NP^;#OD5Da0lx*Pg2R!Iupu`7CATwnuf3IaaJUHp0-4iixUND|X7&9$0Oqi!`hd
zE3<(X)Ot$iMDWOtTN^_vW=kz;QTyxmuIij}&}1PN7_v5d+MvnNNSaWH6rtDlw)!VF
z&AxTYnYrpg7u<%GWGnU~4>!0o!l!b}&q=IX>~ghxZ7~w6R^w3W)he!EYV2))I?3Hy
zj7IXH^C~yaeI<E>RWT8iDR8Z{0JC!bv<jh`9%hVPcG`Zugb7-ys*k+%AFQpsEcJTb
zg~czP3q$bvJ`$Fu8$a@m@`&e-V))FaX!FgrmthFcR+QpE9#D=T4J8i_(*kl{)S>-)
zJT8nW5>lEgo!dt$Q)0pdKEQc{FoEI_Wm#5GCJXGx3sCW$CYZF#bIwjN!3Rb*PUq!~
z^!TSdHZPOH5yJU~J3h}DKkz9iXK&Oh_vj4fQSv}$sT}27sq*ni@vSktQw4<hlNh5o
z!9B68JvsG-EXW5)i-kZi7$Q(B>&~Vvq1Hk|^1yA!3dmaCI~)D+=qN{0t#I)O^&4bP
z{m_v=+lsn3%G8)1#~4Kj4QG<3ojUO)op+}wO2#wKlOnpg5Ta=xXp-zf&`Jz03{s>l
zC92Mrl8|?ih@OxR#gU$DS<GXY2Tleilg~IqxbdJQXL+Q0$>=8!HU#j7@{mIAKpz#U
zSg}o-IQ$_&2%dGEw$hsLB|#lQ6EUkRJfYk=2GQ>k@MhBw&ampxwTqX)ijX-gn1WkE
za?VMedil-ocO+4(JQw<eD5%etqo-FQhApxnJQ~MIqLi5)fvwOxPz3ty|C2A8FKi=r
zJoWMLP6fqmVOT#)4D8Ij^5N3CV-L^P*vaPUO8lF$h<wnJo!aH5$m0Qc>3;s`k$LLP
zrAuF@-+L)jf2~R^N2%a0`Qpvn=k4Xa5*^D$qWPIQ-}HV2%SmQdzd&i#2wN6h2Ft8l
z&p8-pSd?lGx7J0LkwHs7v%)NktMKexKVR%v&dJ0hNDQ$-S-~(vPMVsiR8zL4scW!V
zQd}B(Y^9WGE_<EhsQiQ)p%J7)Mji%JLJtqJxJ7U&S_s(8JYqq2wsn=pZ8&63^un~D
zIE~fWAy;<w^YUUZ2S{F5{Ll0(!n|VX<I}yn=SM)xOkak8=Uk$=fnfON^W@<trcF9?
z(RrWdo(vO{U5~wq>-qKdhn$``Bxnv>*2)UWs$*AQudnw<K#AYMCTjV(iY$#w-+s-0
z&-YhF-F@mjW%S^**~F_RyYAmB`TMlA`w@ogwr&{qBmaf&MkdGn56CLoDc5WWD8T{@
z!O(&TPEL2RyH47#-ETRvy`Y2$FoXyo|2>sTApNtwyZ)GsrLL@~uFz7qjNy4*H~b&R
zU(V)Q)rx|aN|%-Px|S6!SL=2g+o7C6bn8m{12CHdE!7~rdc>@cdMh1ZxHPQ`Fp6Kt
zx_=NNY_F_$9;vIAeb=cf#V2+7d&y=4HMd#XrU#jU3$MOi*=DFgT}6O?oB^nCU$IW)
zsmsn}pch6;$N->dqZ7vFfcg?q84>1Me|TF%i3!4r`oeyB9`QW@x1j)3(vXM0y5>@k
zs4rkeOz}cN=87&MQU$x%T3UiwYHXOo*W{qfPN;oh<w@~biB+TYsoxUV6)=@q72`uF
z%_5jzb+wROVu>-cZ{H_E3ZOQq4s=u-h1^oZplM4}Eb*nN<x0a-PPD!2T8}e<j4#o6
ziJG<u_7lH@=W7s0_E0OfT9Y+5yeaEZkGZ+IoG$`BCG>R^)}JEUrWy)Jxx8*$uB*C3
z6$~T?X15|lXd*(6!Qi<LGPs%|JwL4w2gZi6VemX@M<Eb|VsH-CGoTQ8UQ>XcLgrNC
zHsf=|&<{^27;p9&^hX`W2s={+ur^}K3Aby{shS|yzy$!ke4~?1ww;UOSa?+csWa`I
zpjdA$z}zs%v<96x^ib5ip7r7{yHi0+OnMFy?-1H`zefSWW&kLS+M>VCGx(4G1RAPl
z=J@m=DOc27D4%0Z-IX7GJ!}O7NYRi~zgZ`l?eF}!p>|jc_sU3+N*m(aOP&4Js%<_o
z!HD>JQ9F287a&T_jT4@mkit@r|MxdJ-9b~OyCg%7Jhx%8$KQ*(fJzf<5-GM}^2S2r
zyFE6A6xdA*;@-+71Ln-{pEGWo)%q?s;C=kudTH63A$%qaH@vfMBxr7mFjB2}l+pMy
z;rm_gqe9o+180U+&@=G~LT<l)Pls8}yX*7nCVBT$qeRJ3#$pWb$$?-21p5cb0kjBX
zyr$!H<;Y!fds`8tR&D%v&Il99g^oZF0WW+7VzIPErBS6)o{~gwcc%vfS|_1rG7S7v
zrO4xnIL=Q5+d*OkFQ<Vb-}G2ht<yxK##xMT4vs(f4*;6&nFAW5I^P^x7D9Rw^PslX
zeKe+Go|Bjg5;3}wZTojZ@k`w@PZVUs=QR(bTjXJX;kaY?bM2-YOdb|Yvj8)Yd4zJ`
z$UaY8XvWhRLE94swi`Wzdoh6g=R%gnvf}e}!e>FuZIQ-%b7$8qB^{-RRf;4H(Bt9E
z$lMbksFAa$*@))Im)T~u1^V-t&KOMF6Xpd4LW5k}pTYFi$=17Nl$cVHdIYG2f#58H
zD<l#sWbB4<v7v=5;B&Y*x{^)Bl1Yk?KaY_hK%u299zR_8@IdF6k{$2-`gf+~cmXN(
z=BB)PgdEV4qX|NJ!4f(A9(;S~!j*td;Zhh;;PG|i&u8DBN@%9S)1frLFh=b#f1lE}
zEIDaSGeIV@kMYxSuw_}m)15l?XUU`INbHIgxF8&w0hVs<>Dx|xMH=hTxZ(U3%=e9N
z_io>&Ecwy^I#$<%!jk$K*8SW2y0`0~rw<iG4F;w0Fx^Ah`g(fw=+pfX#R*Fc44NLY
zC9dxqrc3fd5Sx;|HqViye8&i%)Ii99H5ii9DOv$44U-R&r%fr#8p915iC{4@f|pG8
z!!j7Tpu0ykp)!&#lN@(waUi|Ac=hSVOf$%)SyY_HIW_BXmK-{E?b>$3AnhS?QMdx1
zHsl|Ej$XX`aHlM>f;c|KT^yKxyI}3>=H9Mu+NYJpg!UiUmjjDlqu%E3?&d5G8Rwv3
zA_RsVa5%C!;17<DZf>0V3MJG3y!IOvJF&&#`FQ*G^z!SUk_tKv?ib&KECPu8e&1X@
zz5F_5nh(?$<fgc|!@!My==1mS<>lp}XCyx3;1n*1_W~2#U9J6lY}ykfGqe(h8H}~x
zyy?&H$JW`@*H5>MrBD`3R=>LPzPIN;50`c0INsOyz6W>_EVZS7_*cF1*#0-{2uT@0
zS`3oBKlhs8j!Y8wmP#u9=$9Oiq#-0FKuI$|YGOtYdOT%+{oqbiAD6KKTB6cqHj~L}
zy;`mLzXgAHTogs^I@MIAMx<7x4&rFhGb=^Wbu`XI^?R;#TCRzJZnfxCsg+%GF4;N>
z$z>O>0{ttk+U{DWA{iU!g6FF52bct|wMk*T8zg94Mmi_gS2QJ+iUSwo+%w<=UU9Lt
z`Xwd?@x7s#{!k$!66Z=#K@-={_qloQLE)lEH(Hnyw5!*Lti_TDiQI-fL!@UvC~y@A
z^<5(fme2u7oA)q+NXyJ3d?p}ULkkO$dZ5uS19XVo6^6IXmuHL%NYF^9ivXxU5*Tdw
zS0r|I3rY|mHi-B(2Fi!c>$K`J-zf__k!lo<j)0jFnUFvi7V{XeSJf`--kFGZ3uS1<
zBj?+*T60L+(Q2X!A|O8qp5%N!6fhO!oBN8m<cNJER|_DHAi#NJav=6X-wENbiW@DI
zS9xA>XeTN~M#K@x#8~b))oM17K`KL&A;e1E=#=3t!{3T(H1TOyxG8L;1oP5g4y;<f
z7T&7F5m`vd{uBGKqbj5Ln_$ew0hnvq8KIA7WcsPEl2VzhXz#fET;0fnS(6Ehwg2;G
zp5!rknX*4jz{(U!$1v^eO#A1dIVv04NRfbwM3M``$vhw-#5B_C>D#9B_xA_<AcY(Q
za1<M-4UV&~T=qe7s^?o;*;l&kX_YYgF}_&^U~+Kwvgf#m821q+V>oEI4Yp}u!$^&m
zMKW!?qxFyL7PssMHT|lw*=^!n>p{(6Wpag5h>(@{@^If!T|BfaRdoc5O96fBlXC_>
zB~3a65Rq#qF_LDI07yK@073}cES5EnZ#J`A{Vv>W@bOb)?O9R-TkP!CeqqaAPSZWs
z5XY%$htBM(0sieMnD;(v5c5KbD`)N15Ptoc&V4Ru_uFjOx$x{$yPo>HX0QQjpRj{Z
zba`T_M{jm5x-mi;%~~}yAzU~+<FRSx+SCM$-97l<9(;gpcY)9*NWSSQM@~<9j9C~)
zvSg7PK$M=G(~I`%fx!hx!gmmdCd&N5<hZG9FY5+Wg=KD%2Lk^y#yF41scS_v7qMaS
zBn>c2;=wV}5lq7Th+w=0Fzi}!Kz!wCLUDWKXV)NX@X3_uGv#o)(}h@lO8AizUO^Z1
zuK{>qe~r8X5;sq5#YCBUi0IKmW@44V@cDl5i+pK23~!txo*cQfFWmI;Q4(}vevVUS
z51FIxY<qin;DP}2e3AF10DiQ^#%%ewt13odI%?!VHehU(2#<`pv$QSLL(E2hqftNT
z1(7>OtfvPjA09p40J6zA`cDIy>0R2fCGQ?yJ<qq9*Pi<R@OOU^i-GW4JbM1x<WXPj
zP(m#Vj(niVEgt!&4>!()K5=y8`}02dfvtsT&eMzT+}Ko{jg?)Pbj+dD;B==<%-K>Q
zU;G8hx#4q6GbY)1>rBqRbNl^7Vrv+4D84x5%p(!1b`BmV>~Cj|oVj!sIrc4a-t7S3
zK=WzZ(#5ffR~S47mfhEMc$arC7-0<J&?sdvnsep59YO^Y6Rams&+hN<cTmT5!fIl)
zz#^DRgSX$$-v>xjkXZ6c309r{Zn~?Rhu@D2Nd}F3pu8Y-4o9i8rJI+hwJw<~93@Uf
z9(&5ThtAzSK0e<EQ-1)2;S4}Qiijp&{n_%bPhePv(z6P3=2CdTF_T_B{JXll?H7*R
zbXqvGxr<1<Uj4bYuOnEY@u;Aq0KKR9uVg1a`n0hl(6PnGaHGd}H71_oe3xv;R(o^_
zz!T(fm~?JDP#AZo_1v`=qzzUT90!1n=yA<(&M`~PRODIg6jzK2jFXhn?IVn(WM@8(
zUP%V7a{FGVQ%1gmFa}KI{?_~-o(yo0AOaj^6GwnDp2t3;|AP0c?-kz2l(zFfnf#V(
zF$anY1TqjI2Z(6BIiB@AGD*IE^NnTK&4(HUTmS+aNQe*w@}OD-q`};V{!Xi<R%fNQ
z>RTWJtJQM3Vv$%3*8diKudOQ~H?E7wy(b{`nxbX+F_kn&uujBdXON<ape1StYHyD;
z*lL?1aD@5UK~W+h-RG?0h-hFVIt7dnDJlh|DcN|WR7ngErtD|r>mXX%W-b@Umn8FK
z00fAvisyh)7;TZPDTF6aM06!;We$eEOltZnnb}e#V?R6KVpfaofF}R39N9==iHx7#
zgxn^;<s_;LHWZxf*QFG4I3Dj8=3L6d<z`Hp1`L22;X*nH$)M3mHZ2`w8$`m(%#d?6
zO-lg~2zaNQ$jNBb2+0bgEfUu$QEEs6hM=s~CT<IrrDF;gtvZLK2F24g6;3r7CeGM7
z;6JXR+~=?s5-EsNRv~Z#uEOd-%hrY2p%7B=wr=guNfAX}K)zCD<8y)ycsow`Gx(+X
ztyN)o<buLgE@H|vjT5bk+{#)_GoDwhgfoC^kY84yS*;9Ga+vzPG!jZMO<g7k?S~*<
zuVgSJVOC2VBukt1j0HmBA0ARqvx-hFZMHdq&ef&I6|mRkD=89b;CVWs5(#za!#7@+
zXQ3jD!($^uzh9F6?m3kQSjk3YN>wsY;T=WaHW$`CfkFWj-ncwnLf8KHSDeQNwi2K_
zoD^7rW_;$A+nZ9E_E*J3)`D6pD-2c@8;!(OtG+7$RVTA$<J}*PHCcydAMLi60hxDn
zKt$;|o4r~(+;!$EG_N|noyw8}*+CDj4_ndwev+uTIjgOaj{w;jv_M+dhSBRt#0fgG
zeHbeE<R|nyrFXxYVxOb^5BLhR^kEdW1XZx|1w>G{6e^d5tJ9pJ(BzpV7tUzIUC!k-
zym9hk4s*^z4(ou<zX}0MC`0>xGV|)68rwc=`xe$woVY2=Ok<c`ck7lvqd)U<+IP(h
zpWYGjPbkLt*#mq6s%714Qry<hA1t`1lp<qEn*cq`VCAb61ao6Y95QqmYs8oaqs<%<
zMLFzdLJJ6icL{YZBPGCw;JY=y+OmYvjL%|Kvz!7}b$HxGTs1OR&nRUJ7-!D_yb$*z
zs0eDBwnphXAm~>({ivobTAZf+h$NJ#UYqerk34X?`37KBL2W?|XqVgsmPG{Bu0G}k
z`Rc`xe*2B;1V-CMt2tIFulG|79`mi#vs^{xk>c)9YrF2tVa~gisVfDrGXTWJeDrN+
zCrq;q;M6MMlt<9)cs`yzyR&0MD7>%GOgR6{G~deIM_w&+ODq2LKtlOB3^cH)R9sEH
zbY_oYY-|@WEOoAR-T*Ap($i0!xMP6d<rp0?uv+lN7K+<-@a4fR;RL<}U>TGgXed-*
z&Zar1k2&^BT`@XKEg8<YNrC$C%!D<>&Az@OI?<R3H}LMq9B{~4*oPzH2DfMkvu@`@
zbh9jZha*1Pf@^bHZ43TA4`Cw=J&*BaLE|-rjv6w7H-F*C?=uuwN+|*^1|G!Gf1ZEs
zePQTf7S52c-RhHov?bvYV^zpGz?4IATjt9JJ34Sjab7qW7zDQ!dE;P5aP#Zy>&eO6
z55KAzIY&ZRB*2Q~_x0J<_tT4e0!hY$M~F-ggGjpgsf%lS%afn-4kkAP2$K_ck7=?<
z{c`u~>g&xeTL_yU!^2@+7T^-8xV`y(b?U-VSVg~D$lrmB&GhNp%cV1yk#hk4w@4r)
zEL?evec<Zn!b9_v4-S!pHIG8J3f5e6FL!PVQa<X4I|v#tlhwA!aLS2i))8jbxbi-}
z<(0epka_&@Y>5dBo^uxdoOW0Ectjj&sDh!!*n`k;V99VSA}9&3+9mo413ce}EPfW2
zw?5_E@Pd993(<dAgnyY`j#m5RnjxR4@&4NlidW!?$0iin{h|NE7o$8^o;uvk!r3F~
z!6)D3zYu=Mf1r>2<{$ru_2iojY(kh|O41UAp^>Su;o3W{0v4&M?!k{d@;*f;J$i|v
z3_*^P|8+OY|Fbsbm(@wnvZi`Wi@7elaaAqTlJ2L3^<~;4v7G%xRP;JAA4;`OKxrqN
zSw1n*NmBikgz#y3RVHB$I!@%(3~<+1TOmKo;#eX$LQSn7LeDl0qaJ=pl5Tnd0MT8D
z8H-3j;ajwf0^V}7Fl@3SdNvZpMN?dXL50+s#x7T2LA5K%S5Sb*yc|~FqEn(6T;^cz
ziiCE7TSN)|EShAPf?LHR3x(7y8B8<x8=h%vSjHDjz6GE$TnC~aBnOi7@<B1ngE@K^
z0g#XQc!(T;0+=8XDO-^WCw>5ec-WKOI4e>9HL@FKWyWzJ=JyG?fPGO=p=+8Pqd5|0
zH}FgdCiH@m@|x`2FW(Xk%yjrk)L{}BkQN_O@WWWXRFoh{Bt|EFnG~&6ZvAp^&!}b~
zSZzLNN}mm|nGMKgIQXAqTJk?DI5fg+Li+i7vVoLZ$Z!;e2)1=FCkP0iYca?!nsK}Y
z9fy=zeW?=gW2VtU0Kf8e?Q;!=$v(Axb2g=Lc$!yqu!jjbmLfV~s}XF4aFNwusX$?G
z^|xWVDP(2@9Mybb!rfQ(=>UEUWG3ixc*tO+N2Xx^^ojsLCy#1(U<hSq5slsW1&dLq
z!2yIkwhNT3{AvqSZB6)ov|1Z3EvU*$t$GNgec*61KDAb^&NjwN(^W5PHE#XRy*95G
z!=BZ{)yj;Hj>F5H%(mUSTei@R9W8v*=7kxrr`z3Y-|nOx*}s(^GwS%8tk`QsWOgCw
ztk^#9?IA_IbZnQqG)Tk;V8ts_FI?Nz3!^pYS1cB?)_jqIQaPVnbT^MsIdaOb7;TN>
zcSW1ZDFv$KtiQuLHpP`(2H{?nU&O%YWNf;8<A}7av8Y6xH0RHHJyepu@1?u$8Y9fF
zMm2jedI>5m2vpVMx2x}N(p@;13)=(ay5$aI#Rr4do|%2OWQe@WkUJ)=FzyBh5{C$q
zy*@nbdM{e}6AhVd;@^tJ@Ef(ruZ4*Hp5AnuRydyEjB@*_1cbX>vjK#OA8Z?I^U99$
zI0M~OUsjy)Qeg|{70BO-Jt0(t;(6f82Gwx%MSpjwrfEW}Bm|=g>%6M@z*mj6ZWaPL
zcxM@*Riol0CgTPnsH8DNIF%=7!#!-mm!jd7vT3njW&k6yBt{)A6oZ0QW*eh@8HZ$m
z;Gl~lo8)>>cVbqh7XV;N1)M|4=&_h%GFuCrA`se!IJG?7rSF)*>Sc4$?2;cFj;Y7D
zN-Wb5a$f(jZR$bPd<e#oqNn%u!}ae0*7ncBelxyZzR!ed$euBejNA&WxlVh^bRR1x
z@3%G|&pJ+8_?M-ly{lVH!F>Pq7No8h_nG0q?d=hz;}8qw?7AwY%XZZ^!L00c#<ZKI
zi0N&A2VAgC1?-0X2kx6{4Ha_TQ;b%MmA`aYrPvw!TLq)|;1cQY?w=uoZA|a*F?z@s
zncSzN!I<qnrIwhr{ljMQaDALUG4XJ3WWpD33%1db8AKDt*d)Y{*1bIwT^a4Rw6VBA
z&)r%PUxFaniZAfL|6SSit^W;JR7R`#AC_&T{AXhdW~S14BWbM?C(8f0p*`)LJ<}gh
z(Q51g3zRgQOeFr($k1pu{%^tFq>ufU+gwI#MsFI+N(dw@o8FyE(Lms1ECJobSjPp=
z9gEM9=n`9pY%SG{I2%)igyi2Z<6-qV)G<s@N^=y^GSGW9OIO!6H&-waJ7$p$@B)7s
z7wE<1C1{OOHUdL<bE$F1q)`|W$DP3Bm71`qjN;QE%mwLa0mKLeJhioUQLHGD3=)+b
zyb=g=k~e-B2Bx-+(vJnv0|U!<m^#|?$vJPpMX&qJ2a4#hpoTyBje>i>+hpm0n^K{m
z8jJR15|=IKcsmecZ4|V`A;(WBKxE936KAxK6RyxGqmZ(Logq|_iXwxacKV%zsxiBH
zm;S%SQk!KU%i_99pGML7E)7pyQD6k6Qb_RWg7W~@M)E)saeXjE{D53gpeMK>cD81l
zgED-ap9b7!Dv}3ydQSzB%p3|HBcA;EfdeR#A~XA;{~T-vKnxc(-Ix^)&!alL;pg4J
z{%S|^*a1ZXae<Y}o`R7ghHMfIB;@Hfyax$LWWj*oDlGl5cx>@0>cb=Nu9C*647x%o
zxE?o<Zp*m%F)OJQDgv8)gJW+0Xo8hg6xP<bPnI8|-j&-qEoCrZCduH;xSx~h1nm?7
z4YOd22088{%p0%ZmDFSTvo1QXiRIDo^@JgU9AM9^<GCr#Z=n?{ZLL^UnAdc)<$Cc-
zQ^%w&#xGdcx;`)ZSYndq*1Ya^BkGEEujY!6**D|;*67us<20YFidzP$h}U>wo>AaG
zW8~=+{fW9unYvPq6Ko7EdHrM#zZzOI9F+3i)nW!H?-V^?FP~eDvs1B5M)4V?bMem&
zg>isKlve7zk&PrgQj<fv(G5MfCOowOwuujc9ApOYuaG36j}%2;o)3Jz6{jOFNYQTU
z#I<-4Ha-!a=vL11bRE-iY8f<u2#L1}stVD%Aa{lLcf%r(uGE3wLB{hb!+(D<*3nIe
zqd4Nc6rD3t2;=qVhjmc`X>&S8muYOb>W4_yz!8r104O?8EQ*1P=bO+0UMsj$bd$Oj
z@Eu(g)&G}J{t6_lYq>FZ`|li}LX%Qzt4=LBM{wpgEw{<uE)acN`Q_~ljIpVqLrQ3Z
zJE%pVUNl>ytN}U{^Xck|>s%*07YNLiA&9$a3eczd-rUgUw>hMXH*16h#m6qG<e4UJ
zZ1>=hZgnd88gvQ2JK$>udk)t!&D(Hipm0cj@IRjVS3`5YA_zY><s@?my5__-;)$#=
z1H^Ec#&n(pKAaSD2!`|zZWPG5aIEPsWk`e3fKjOzGI|;t{jyYfxmSTF@MYg{jB;ds
zc{5}#YE1N>GDg5w^V=EN=9N(ou`$8VxAgE5+jz9&;?c;bK<fhKW#_=`0mg+!O^KKE
zZd3m4#O~qdt4DhG>ZNr3IItM~Y6xKb$Z?v<6&N3&<#I{+vGSApJ8?paJLed;(8#CM
z8ob9G3vB&oUbvA1t`CIKIR9{H5te%pCErgKj^;f}dQJ{->*Zmkb{O*bG`sjFelC%d
zv9H-p`@i)0OYj%43zT-|AG%U>V@dv*(sD}ShY(jUuS5*QXRt1A2Ng{#a%>KtZTn=D
zd1$wYEXya2#zJ6A<t&c=zh3&rGa0AToO8`ea?Ue6YoGQ#YQyGwl#QuqoMp)qi%Zkj
zkO{KhqiwqkBz*VMq(f{Tg>qHd{LN(GWFknE@~n@PG_)5L0FmOj^onq5$MICbDGEfu
z^eDl0rBz|sViNhR#g9j_8_&Fy(X@k@M4a(Zw};qli_M|QXv9dqNOk8TdzgHPB@;pt
z2LPl-&mrcOL^*o%E01eJ2D5Pt6Su}_&Xkt~qMi@vm0^^Z?u=wJ!UbWtR#JJv1Y`2=
zrs`QRjz<2W^F=7i_vela2J2~s&w(tT!%{p^Qiw62zoODfhkmdOb*R_Yzk{-YeCbZ_
zf~1!W!mPqZW*P+gfbERTA5S9c_vTo$@kz9APn0PDUNnw!EHLzq1x8|2OJUK|K&ddN
zGl`)Gg6tq@lkS3`1310s03{63FWz;}3C2V)6w&>3tkcylSL*c-GY2b~3f-PnE7nbm
zVoP6EJ2hz5cH+#;f0WTOWFuB8zwUQEYkJmJJA16Utlnya6@M0Y&uc*IG_0I^po(Qd
z^`viZYFm6F%Nt<x2C0@7hfUIm4&!OB1P$~yDItUB@DH(kDU^wj0&yR$oT@=61&GSb
zI9A1v4;6++nYBgrowO~7!^6cc(p3YzL+iUXRj#m-A+iczeAJ5Gw8B0~YQCnt=yN>W
zmyOF`UMoJG#>?@(4YFkr=-LQtcD*p1)}x-MXML+4m^MA)p3uSu7pXR5^&IyGCHPlP
zr2%ujaL+X1Nf#2TJ3i9H77t;hXt{{fRX#MYt5%y<3UcMg`XA!r(9J0+kD%K72o}a`
z&Or!PNS3SYf;v^$=^+0m+R~2k5?OKK&pd|<a{5SCN{FsWkeP@wCpU1*NXatS&2^h9
z0-rd!x~^~x4Y^3*964Hi-5aWLnU_;jS}R$XEi`I~Fw4M+;LW@#ZdD*&%wATWr*|F_
zgO#(@>2Wk4WZPer%?`+$vASEAOqJb^ZjG+|94gK0M{5n8k}EEED}8cYL@u4858I|>
zHNo1g-mHCvjctG2By(}$GRmE-zxe+Beq!%<*g^Pf&(6m7%l`e5wf%1Q4hs=s5A^T5
zOWH{I=i((|DU~6F->ThBS{b{WfkAHa?^by-*#mM#-S1{kOq@ZLO9CJQq~FQT=>P3H
z>>I?t#RzlW{{OXi7GPCuZQtLZC?E(ZD&0sLqzFoPcZW1ccY`!YgTz5VDd{e06+uc;
zK|rKL5Tsk`oxPEx_<kHc>hm6-^Ub>0Yu3!Hb?<wAYi3{E|5>vpf#M48Bf>Y@xQ+{Y
zoAYB^1)3t>g*f6yTF0a4o;E%srg6ILm+*|s$MdM-E31c&(kIJlWH<Hb-yD%xc$}?6
z(n+!Ls{Xt_0;+K{sjhg6zMgJLq(PiR&1vPZHy&h94DzWWnr%-RE0M2UxK-FDC=?ma
zuo=or5lKy0+QK)A$dFKXtzJ`2lDNH_IwLJwRGhA^8n~ZkUsEBBHRYpFE-s8X8J#Th
z!NT^@vJ&!XBFoZxeXS3hqO^lN&vB_0wE9@y-ax|45~**x`7}HQVuqc{9h_3vx7A)|
zOFr!E#P{BXa#jsO6=d63kDazL77!LLPF^S4OpZ@dh8STUmvhIXj5S-BLO4MmXOJXG
z&&@)wm|FH4w)IuRmFUi<?iGJzeO^`l4T;^wOTBVan!qgsq}7^Dis@Xn7g!4m@-5qo
zI~!G1*?3eK@i<ycfx+IYgFyjF9pqe7xi7CS)L}@A6Q{*!3sKP)+`*F(^*5=p^slmP
zyr%dv@N|2eksmPiOHcTyfT7__N1=kK!nevex#YbS=m9we@e%9N&zb6(qGN?UOJpsg
zQ-*F5Hj^MZ7@@zwu@XK7JpXdynx;@r<SC_I=?#o~)WjFkqS#ODAjIN`pdyt?E<F)Y
zOON0-l11wHV_h#YDT_DzL&|OHbW0TS-6JL^QK@6B0`8R9V7`lFRq^k50dK=Ek!3XZ
zDo^(WWs{cC9T5*4ZAGWP)tZuE8kOa@JPuKU)#SOGE<<McAp<^im@EDQQsjn1rfW2{
zCdp=Se2lzeNLtAD&pPb0awX{No}pkF$Zs?AI_Mh~yh$KU<5`Zf#aup9c!97uP|xfB
zRYT>tWBo1ZS8Qko5@N8<pA33paD<drD&b)n9*t$@%XWqCjrFbk(`V>(OX7>_WR<*f
zfw8uQmejXpy>UD->6pZLqw%>>r3I*tvgY=n*Jt<YO;DT1U@3G_85Wq8bn-FVRAq|O
zYh+|J^s5Y&*=89jm756j=7?5j513S{<(0V%vS8WjOh0&>=}u=Sy7tUv&Pd<!1+KNn
zOdfZ#S%`*4$k5uQhKH%>CGDN3%la4Ww>Gxd*QTdyG*pbuX~@zL^a`DKCB(NF*Zuwd
zch3y%Mx5qAb%PTTvw=P~Cc|b)dIdACgE-_C={zDLer^lNanE)XmQjIID<c9VR3eo=
zZ!h%vpy0P*SRcjXO02u;5j<>akfmA@#t@y^K^jIx@WyFy`!ZkHp=m(_LkC5=nUY+d
z&IcX2iG#i1gj6F5kq5=owK>J7!(k*&ypSej1j|(3t8v`6^9i~n(FKp}q=-(BC@!<S
zMj*uIIfazsL&rp|Gi0Y8D$2#)_>_RYTiDjm&V#Abr+T5ucSzcC$WCo4rn!KojU-r@
z57UMC_)ayBZFra9Y-qPXW#wb3(3@N8s1~+CBuV4*D`JHduAaCXk`}B3O|C2-Dm~6S
zOGqRf)3Zy^<Paoz9N>>&BS3$L;HAb}y3m`8M|>sY)gP0;BGmA77V%O#S(_2ndOPWK
z{nV>!{}hM?yCiuZg0DsTxpbn4h2^L_isz0aJX}rGmb-P4D1o2PjU<}nWJeH3y6?@1
zi1kUY5N{&#`4N8658O#ud~nHqABNP7i{PI@?u|~_APP4f#o-g-9?_l0iryu2a`#~o
zuF>%zmpL(XocN=JS&BfstQR89u<;P8`td>B@<*J;Nf!g|v-E3U56v4&Us5}vQpD0z
zCE-E{j3Nps6=D}9&%5Z?CPK$jlYR76b%1b+5E`|nt35XILPQd~^oT8Wpc|TU5@CXW
zEwQ(RV5TDC4l+jYrG*t0i?=BB?DW>D#ijkS;zkNVqPjs0k&oqPoU?*11(lT2Kgbj|
ziFZPCnBF$djHlB!3DYWW&^I)HU>mgH*B16f?Rr;hG1E?t%}PqVSlSXo*PYzr&YQ9$
zxT!%*r4|vZ)-_d^spP5S9+z4nQoR#@S5%Z$qGyQCbvv_!+s0(NUranLVEksp)J<<J
z12Jl5Z<G}E*T$tP0UiFG<ZYDW4Q-UVkL_4%tEvWPA8JUGP~Sl9q++R5%;~9&&&_Or
zNG8!B3V1db3##Q@sr2L_Ol!G)S@xZ%Oxe=LqN7t88x|rJQx=Kw%S*~3fu`bVy;r6O
zwyQIZy)kVGtnkwBQy4gx_M6(FAqIxYdfdslb0J6y-MT_Cx6HThdZ{p@xOz}x{1^mI
zZqxr>>kVH2g`ODRpb_S_CoTO~#MrKCsA_R)>rPVW6x@Ofd0^qnTCSRl87MPfBby4R
zBG}bKWW^kR!Bk#85qs`L;M1y5l`FZcuIw7BW~FCPGFixzjZ{%WZEp;V4=m9jHb{!B
zXAd)oJ-xozAa-MUW6E|H;t=(R4-?MWjQBrF1L{ATy6s|jTBf|nOKHiKJet#8wBoqC
zKK_Rl{uupIb0$Wdlw^0ppz$mr0na0oXEyMc9Fao0KTNb_Js-Jc5EL+*kHi$^s-(Jf
z_MEoe+WPu3uhB-~qXOh584CF;uC}(-gKj(98`Ckxj6+@(yr?<T5v3;jEi*eU-Af9u
z=@sP)uH*EcQKxCuE2yd7y|A?~5i+OKAmG{B*to8-Fvj-BLgzf%1=e6<;D<)89C#}s
zChx;UZeJAqsnhF7w0QzgxuioWr=pIXvI%;p*xH)glF05p0{qsDo?b>m!Kb#Kbd576
z)z8i04iP?nt2eKbP_Zt?_ptQLjW0c?r(f<&jiSIKHmfMZ7FDb%YGe38#<P`CQSZ<A
z5Et2_;k4xA-Ne*<uF0fRjNR4VELVYaS9qYq@R&F&dVfgBe9sKy#TS9^AGu>Av?ZeO
zvOF?fA=e5rQoL`7aH-#9oXb6<Qth-2-U)U=;yB*U^O6H9=+@NwOdp4@7?LKxcv%tr
zo^gddA2rtfvayYfiBY@v%hdAwB>6g+7Y$L}g3~htW^60qx(seiCZlNi6OcEi59DW_
z@mBBfuqmwb!{xFT3yR4x@{3J51&FL?)sl!ZP0)|#7RVyY%a(NI@L(y}=3sY0lF6Si
zlZ*I=Sr4LX$|Y9nE|bXQm<*`a&1-qyRt}e6FUX;+(r)BRtxHFi@{>xw)MuI+!S>Yt
zL}oB~(JL}!5zH3}bOyI^>R3fRJHr#BV&BYP(Be|FGY{pZLypdtRFKBwn|%T=bH!Yg
z)jvFrHQX#q#hf8p<T*8}6e0V7Ul_Jk*_@QF(EwMQpC>i;3g1|$<>n666ff}!JX4D2
zKK)XOq>CCA_i}Bls^uEXtLNX|!Sf{>#pxrmR1=uN8GV@}#p)f<l2m)C6Ey;@Uq3m>
z6B)mxtXE@qV>%^=;q01cy3nP*M5X-3?G5}ZEfv7k{rvVSzKajziI97E4q+jSNm!Gr
z6dB>y0<NAbK$jM2da0w_dRr-&v|QM0SXC&DOjVGT{9L^w)7=mXzT6^ODehE%+2P?P
zeX9DK1vRxA7bo~S+mHE+WA@y6N|mTZ9MqTF>dcHCbj&43G8*xs1^iL!rshFCm5cf<
zh6zUTf*8;I1@m!5$hAvo${sN4(c`1p5b|ArJSHpH7;z+VwQ{hAv89i3ZmndN#`wNj
zcnS;E#)zb8>nwrG(lwD&jeNQ&@cwf*Ybj>yE$MM|wh5SL?L*Rr#f}~&5J!8aR-SOu
z*D)rQ#PdUpaYj$id;3>&E#o&;bv!kr{A76;Sj*OD-Y*mjOuSFWI(bLjN!Xq7K|W@Z
zvjYpEEiMBM|B)PNME3#3=1MHohtAFpjx0DuF(`}9et|+apEzMNT2M7~_i2@@(mtzG
zHLM@2@xtyreLeiVLc?pbRu7+)W0KTbXLf^QI<X=Y2hErpvU|rc^!)tSsK}5J+^Nb3
zW}8tL70=d(>ZIOCo5kXl$Q;}mk(_;Qdp+S@%(c!zq}Yr83TP9)-S6`UY0q|dLaw}L
z@Zp^)7bc$DS{`4peyuG$MvNzd6BbHIq1F^V5q&9b%+!j52d_dxX;Bt2Y}5zIaAs+2
z!<sUBsgKgL?N06mJp?!+M<*9P<;~|e>9Hqi>%9`?QY`Mx`r11cUAojRP?Qj2K5lax
z>AZoT3>MGg&dT=71hjESIx2&cNK|z*r}2E&%ht+(5mknju@aW?`Ys7tEa5E#*O9lT
zd)La!Caeq_A}kV63u%pb9ta#8cXQqx+g^G9P@{dqTE9Cm<&6cG1daj+djtUo?&Q4^
zU*BiDzJ&LLLhhmN!rv;&dItQG$;19-;+>Qfi0McSzSTjjMvk$IJ)e~*cyl9?SBgfP
zJm<<FX)A{PQLmE@URUAkPzTXo8<6T>luOJY@kO)WuE4z!iPh40SX$2;j$<I;L8N^u
zXhu7K>y#0z3Cl6etGC_xKImW=(Rwj2zO$afq@zEZ5#8T;#(~plz}!_w5vACRq{IVG
zBHIvob^sj>Ke+RQs2C5tp+P?0T_615;rdfIUjfexoVUNNZM7UfhZTz)$8MnENcm{M
zgQem8dr_xGG@a3caTAOX0og`##|1Kuvz^-3o%sRqj#rf)OO8@(w|09y7)OY_&xG;l
zG8M&4j+uRD@mr6Zf=IFX;>VO8D@he!NaZ4dFZWw^J&A2tFzLeMM5WE|9%^cQ;%!iO
zJ{ftqVSh9;nXSa;U7biRk_vnAxN`_>^WB8UZy%2owAKl}qpfeDm9{>%cJgKTASOcn
zF-;RyM&Ad)(XYh$PPw`U7Th}N)+gxTDB9c>9u6^HE*KxN|0uP)q;mg*>jPfP$1<0D
zXcZ^k>bjT`=UAV8i-&P;eRZ3Rkd5pLT{19V_~cm)@qiYdFz3(*g0C6zXfJ5*z%TYK
zTw66p?m2?};3@Z!;FF!i4V>;;-qL(N!^mkZ5AWZH=R?x)_u$v&el-4YU7RN)K7u^y
zUB=a7gdHpkDWdoHU0I)%d90pAzqfc_i0-}kAO;2E3~I~z@MUGH<dRZl8pB9Axs28u
z*Z#<3UTeRktR+O1;mtH9Y@{u#w6a-dXE!kDddb^HkwF>9-9=op<U^3@to+@XmLgeu
zcWD*vydXO9tJ9lf@3l%Cx3*BUT5TExwan#Jj2t}|oNM~nXA(N6I{adbGK*)GDd&!R
zHfdE?yS<_jq^o$53Wq>usK%-h<a_Vz-I=K-L9^7Zsi}TN$~pq#L373S=zGiq&!myE
zk&N))(Fk@mE7Xk`u-?t-5h1R;!7OZj<{A|_(et%qbqmj}3l*hB4bB~_KuIz3R8%!n
z91@)xz;2}uz^c6cu2~xQeX(5)N9MC+T+yPgTO}e?Ml?r}?5fq>E@KS}UhcY@LbRJ5
zDyI<JRo=Cd*@<}le$6RmC82VpfJWh&YyDX@Pl$5jp31WF<LSxCZTDGLZ*Gmxm=#i0
z@UzHBVKr73*I87*ndP?M73Nj$D1Y)t!6<UgmO;&Hb{7Y?U7ty^azM;PAemfsy{3_;
z0UsrGCRAumz&5d6sdp|YZF-Qs%60pJmn7K<!hWKQRMmOM%36HWqRZA4UPMNn8At4F
zu#tN?Epa|z#&qrDYNlAK>bVty3v32f55v1R78f*kdryc<iolf!Ds@KkoOP9zP?(<C
zaiGZHN_CDTF*-?%_OW|ItE9#)v@t|EOw)hM!ZC9(#`%g0?G>8WOoBa`0i?{OB0H+%
zS&o<Qwnw#CZ&De#OVY+iW~(9$Zad2NPOQHd7Shbcz;>YVE=w>Csqz7CP-#8dmOOQp
zRLr}xgZbmi72v-p&Rsnn9i1(=b=cbcrRv*pcF^Fh+;WT`J-!3@pXxNL?4&t6mu|q5
zxJQuT3~eOo7t-famGHArSCH0^x<2tbdB)VwoW~pYBh#d1ei%cq{BxSy@cI=RwXTCV
zXo(L?Bef*?9aYR`@x$)*SUiCwg_MfB<R{fD&*QB#J7SR58KNU1-8tvQ@@lcec!>L)
z3ZW7@OC3T2=h1%8>PcL8maQb#Flr)rGVZD?@oxGF3mx?5)1!!XuqZ_tM@-yW_yRaz
zaO;jfAoRoZm|HLzQ+kHYH^(h0zs!+jAK-2mSLQd1(CNnOaW<0s)sl&?>=eZ){26Q;
zFI8R(LMjP+tpHin_hdLL+Pww2<CqkV@*QEumPh&sL<wd(xbE`{TI2=#4K%WLj!K1k
zd$7P`^H7@~n_?IF&`&(-wsAzi`g|sG;SRE43YPAxOSNteyUpH1r3s8r)w|lHUTm*!
zZ<=+@3A9_>uB|aAQ<Jsbd~<vIZ15^+65A<3yOd2DwpW|0Z6wNiGr8KMf!nTLd0TlJ
zV^Ir}P4TbnM1!PG(^i?>-9AE4u5S>F8KxSG&Q9mdb86@#dNl=`BZps79s%#fU4`2A
ziZ)VHJI|=gD$b-awM=oA*lFE0v}9{OUitO(n-^{If(35c_EM3aT<9mNAxFmZuX)pE
zYsu7by~9$q<gFx8NTVr#>8-0;sU&ZXTHeBWLr(7qIX9*zVl#ZrrH+*AB0b3yt*4C`
zLu=g1iX4q^Fkc9*H(6ActL0saEmC4y^k(EYN)GH&rp^eetlhMCD2Qu+R@Z-~!7ztD
zXD5_DOLgMi?8jM0hZ>gnAeVSH6_(_jrt7ER%FBmT^V%mU#=_cN46X8Ug4jBgvo7W3
z_GB#;jWtI%zoLy6S4xVeZlNzz*2s>2-jtGwtf82%6l9bdC`D;)WATPDtw_q``fPR+
z?SinsZ&G;HQoZw4{LR8fHSvsc?8zEptCZ)XJVi0$K0I?dwmpieyRyP6S=rY8trKZQ
znriRbCJ<golAa286exUb%o^XrGgsA~h@B=G7~C1!R+13dFy?slO_I5?UhMs0OmD^O
z3G(E4%ss1T$L2d&urkmxZd0)6&(q=bHHKpo<nZ8+O?NpVbcY7P-9VA|;G*(<P&m=v
z9&*q0lEU-lhZj39SO$9HhRe1@r?sPLE?L+x<0{Bykdv{chszVZe{!w%+I828@)|`^
z0a6W|S4eD(()i~!6Kboj`P^Mu)M3re?0-yZ_Tg5X52l#zTpoKHo$qZgG|^-3vNGC2
z2?PYQbGh>R&x-mdie<`KSzA%8_2v70pTC>6EQyOl5%I=&a{O(V*IUk}WZ&n{$8Xle
zy?EKN{zS=yA)YHdoS9*2%CcHHPE>$AC%D8@6u-;9$sqLwLW3J?!b`bve21WA9?RQ!
zG8Ia$F%surrZ1<qSOt0Gvrvm#y$}d^aP>ia9eGqkx!bYS^b1)MA!&6MK_!-{Z)TDR
zC<A$(T*?ZbUdXq8gNeYXdBysC5ek=pqEhN~#nTIdfimGATaO(P;=-0~A{=V+x`#?a
zOg!RN4}^eE+I?!_u7?I%0l!g^ong?|nNl#mGp{@)6xy}k<_^5WAxRSN_K;`WnuW%W
zmB|?=TYfzFNz+?#{k=w-hozC)QR?35nvKfbMe1z(*X6^cL*o@9bT=2(3g1>JVRAG%
zNYS7YUpe7qdDat6pH7*6gx=tkT$O2-M(=ppXslUzPiQu+OO_q!B`1ee*DxtIoz!LR
zKy=Jl7hxt10yaJmHzxXB!!^1_8mb`5<&G(m?eIjW1cmb)>ZbY%#tNgo<91nv<oIl&
zCn5y6afRBW7b}1<OOn@^mO`pNtdLV|kQox;mLc>i_W+}EPbVSLyF{-Iv2+xAm#dMj
zWaQM6m0liu|1_l4ePjE>yMf&J8C~DTjL6c#rq!+Rit!2i_2v}+dC{{@LT=@*#(IRc
zv`u7A@(liOc^8^B%k5g?WQFwqsFzG!7N*{m8l`3)yVf#xk1Q<-k`gO|VVNB{LvI>}
zv5h$~Tqh~7hMazW+T@XsM*GJoCJKw|apZO%#Ha~EIQ3fY2cJAw!*VmIbJ|ay!*RKP
zt$Ota&6}ldcK+#-)&8kfj82thb#1dTKjwFI$t#^C5Af)y%skhywL`}6t~=;?dgQwu
zm15ZxVC;>&)00T*-D<m>exd)`r~&5MPG8@Qicv|KT7h4G+O>%K&dB=&ZCH_mEGalD
z_oik9ocuBd(6-!PB}TRh)9U7zU}5{(b!#(}l$L9!m-)b}NLfUWvw2FEY&;>DMxr}b
zmoOnY7%Ly&C**}OcfREWoDYuYgYZ`g%u+0PY*UPn=+NJ!7)u#N1YM*X@QmQ}if?|s
znZPsru-L$v(AWZRVP|1yX_GCrplem)>D{(rd;yLSj^OUo$;g8>nzZcQ%_;Ymw%7-_
zy4#qR$D8Wv`-0c$SoEyQ9!r^fpiE7ucCxj%$7yB-MizT^XYhw=Uw(sy*K5%>IfUme
zX8Q8(#8vuL2DYKe*Y4VcGL(<G+9f4s<DR!wDZHi&4lf_8a^dN5=L@zm!@bVHT`KtI
zp@}*-<wzgC2>}akk>lO0TJMnz0sgBc`0eT@Y^@9HttULtOVeB=u9CXJzqHDg<>;Fq
ze~y@oa1vWvpHkI||8jNZ1=n4%i_T2zAx@f_BfE8TwN2i6K5h`PD)kS*Wfsu_TxRIJ
zhRreDr{&pjM$v42br8kEs2IiO&ZM>^Sj&hWrN=VPmyC>z<TM+2a%gg^cUidQr2p8c
z)?s!qXtRccq_v^iq_=eGaWInXLwYOyXXm(FXBz|Z1~G5WjI{At4`^zQ(YHUuOpz?S
zyL(5vgw)?`K$Thw&AT_Xutk4pyowgBT582y^?aQellOzBvg?IZ=Akqs?7`bFSSxum
zWr~)XP2^dY%-*`vBh8kEb4FHaqsYirZk*0(MJ%{I%0|ZeWJMzRM&(OmmWG0u=q8o7
z%^QtUVfC3VE?c@4gJeS_bMn32t4NB;n&Rk2Tf|!!51yh&4Lvp=c#6r3Gq`*QU6|~l
z_OhUV{WePO30a?cHBV8r$Mk%5J`7vgcAG6LmgvVV+x<(~9!Bc$@-r=NPnM6#kbGcZ
zh!qs!n6SZ{ev$k^(f7O&Ib7oQV!^oH;@L>#(EgXH{WD=^;m>8YNZ{<|(1VZW42(xS
zqWG9G?Emmpyz%ZU?sLL&M#dv5$<^u;cqI?i9cfbK6XL9>#;3DV6z<uih!?+&b)wE-
z>=~zIdPy&kmE6{&p0nENP}1*c#I&R`)hEm`Kuc?MT}HE$-ASmVgkd|oIxV(uRE(?5
zCI22q7=M_1@e_u3c&Vt;IcC+i0gh~XY#2U1t>?rrno1Yhtgs{zS~4JRR(COWa-Lo*
zN#QLuBfIO`6NPrJB<`wi>`OSFyz#6UfhAVIsCG|_``0YR<rL_(?^l*3=+zZxlD@#K
ze{z{JO(96K>uAF}L)v9VJ9zs%r8^z;c4+R&z?@xSR|*A=E{HUg9luq}RK2@3w#`l<
zzV@c!k%HoV8gZreH9VI<;Em9<v1bM?6T~-M(K0{A+(VjXJYMcu&~Cd-zfvgf@>FQB
zS6_T=Qqei^YDf0`DBK8~qwa>gB~9JRi+9&FO=g#-whjD)tH<4)x8ANAbSW$evZx0y
z6;)1^jNnEF#+Q?%UsPiY9d)TY$B)Iq^vuZjd0;yo85$DT`}_FU%hm2>5cpSQKJpxl
zt6{_uQsuP{c4X1LcVRnshdx3-vK-&iL87^-O2Fv-@#Bb8tcAG8Ez@N)>EutUSJgen
z*ePHd9eV7Xx8Ob9I9yD((YyQhiCtYye*S#z=w5kfZN{<>4uTGWgFqmcj{+Hx;2<n}
z%OlXO5XcEw4uM?zYI)f9BM>Z@Jq#ia2qLTvCxr0?gmL%Co&f}4E7UUl5qQ`aoB+NL
zT7ZM!+Yb-h4+pU_u+h^q*8OAy>KC*f97IP~&sfu17xKwnU@H-<;Su<ww|MtVK)(qM
z_z(b}Jr{ri3WO8Lp>~czFoDfBriRv5z&bV@lmG<wfjRW4$zB-()P_KaJ{>F$Q2yGE
zwy~zw_t-i9g&ka&9YG+6`hx=VN88NA+)~%d%FxUdw*6avL63jmFFc@(0=WTe2M0j_
z>|sH43{9YJ9e#YkaYNH5?0+s#0^9cOLIHlcjt{J(Ko0tCrgc+S+gig^(?l28`xoB_
z+Y4>~**+mq{%j8savos6-|tv}V^9y#fgarN7k(~L89rc}th5|-0o$?PPy5Ty{c{|~
z)ymAqQX6pXTRfrX!2WR)0p-trA;Ii8Xj*6(m|0l^yI|>C_Ar53`}T-|GRppS1wjJJ
zh!Chfb2H07?Lm(d_yZCrEZ;vKg&5c>&}M%-w0{vH`@p~D$0?xsz8@q&`SWod-{Wnl
zZ>p;Uf&5+GdtO2Nf{zb+UG9FB{P!z-V`)Wuu)_ZD%Kq{1|L*LuIan850||fxKms5E
zkN`*kBmfcs34jFty9n&-50sw*`or{xuj7Hk;)H)te`uTBLl1Qg>Mk^N`7><!9KY@9
z55}5Wy2e0-Z^dt4#*w5z{jcqOul@jaWIqlhgV_-Ta;T#}uRoB(>`8vI_xJRN{eInF
zeyKN{KVTOH7Oxtb>gby50-5Pv==^u%*8T7K90%_m|Ig?c6fi&cdHy~+2IT?2eqP6*
zg4z3|5B?wP7++oo)PNs{=?>1ozVAs}hv*Lbdc*#C0=;g)1QGxVfCNASAOVm7NB|@N
z5&#MOcN6$t-QnwaU|)Cmdiy`9JMeGpbp_Nls9Vs`<<GF?SLg*afWfch<)0a^01drR
zAirKOxNyMk@2eMFJizn!(F-me@ayOGg3B;_|GZv62lImy$e|a<kLz#rK>NdV2k7{b
z?@9L1lk|(UuQPnT{PP0-qApkj34jDZ0w4j907w8N01^NRfCT=#2*5!wU;+A#L&iIN
z9S3}C{U6jFYLNDvgXa66Kf{)<b%*bL-U9mY#{M`32B7@4o$nnt0d-{G4&(pB&X0_n
zV1n5Z1oB@qZi4xMJq*~meq%E`T}usZYfEDdV?z_ey+IB@y~CcT**`y^K0(vhI?dl5
z*YG8`D+lcTvpNL|;LCo0LKTJ2$GOMN#@zhJxpCTXezy1Xy2n+Re?O*sz`FpAVeL6#
z%f07$zW;fTFZ+)buyB}OfeN$!?aU9<E4~d0tN{`L34jDZ0w4j907w8N0226@5cn7A
z6{a}<VZDM4=<^@dE501x4jshtwVfZ)E3U)r{5rjY{eZpSPp{xO;NS0~S8yKi>-W<u
zxM2SMGkV3B=RG&z$6<Pf5U}riQsh^9#r}A$eVuH73Drr!1QGxVfCNASAOVm7NB|@N
z5&#MOcN2hvoPZ5Rh=Jcbj&IE;u^$f{7AO3J<0}Yg_MC&d1}#B9e}*kz>jU3Az5;4w
z|2{eoQ2yG^_l~asn*M2r7iMQ)XZY1|_urfE@XL8Np_4>@eSANnqwpU%zMr2jLjbUM
zSey%;OXGXe8!*oO9!y{zkN`*kBmfcs34jDZ0w4j9z`ugP{`>`4hdf7cSUh{!_J1(W
zJ;wSs;@lsJ-=LA{=keV?AHPBGMSiyTEAE32KmKg*$L1r13IqFbz3>75esw(l_ui}U
z<+y#31AhJNeeg%X8wZBCK6Cr|ar>e$|9<Q~IPxzXw=V|sgA>T1qR-!(ui(q`Kpbc<
zBQC)U2fQui2Gkgkd=U07w!O9go!fufv~%XK>-l}EmwW!N>)roUPyNbY*ZWlMw_W_K
zUULLG>Bkr8u-{>5|A7f401^NRfCNASAOVm7NB|@N68P^X@GsJ9N=5cUIcNw2EkQqj
zhAm&;Z~xx$1YeE=mjDcYZRbaHALtB|pY?&C*L|c8*!%r-AL#@B{XV*n%mKfCKix+b
z=HEY~`+Rxc%K?7;tj<6Q>I?uyFo6U>0w4j907w8N01^NRfCT>kAOHtJh6Uu3|AOZq
zRR04y1N1D|A15IXlt1eOzdBz2d(SPPec_h^%r8zL|9t=dNAwRxp#A6L`+5CC39xrq
zd<vcO@OzRN7@vL*Ca?}j03-ks011EuKms5EkN`;FUqRqo^9dd{F7~kP|KM{AH8=kQ
z@hK9}%lq-EGEn{%_rX<Qb_8MP4;)|-6S!UfGw*LyJz(!w+z0>Paq8cFZ^4(`)DHOf
ztK<5=_xuAY;LCo0svq#{XYYdp#(wd83p8N<{n&kQxSxFf;miKJ0rP_s$Uo~J-#fp>
zm+ueJ1lk{_SDc1f|90jB>J{IH1l9lvfCNASAOVm7NB|@N5&#MOO9=dn^a@j_|A1a`
z2I%Mg_*M%j{|dcA8)oO%=@mK$?EQXvh3*0WejmL;?|@&wpI)I4^Y5S0E51DM4Pbt7
z0{PGB6^20jz4;mtAn7n`5C}j2-bMRq^?xlMe%i9C@YnS^KGjn<`0IMZpX%+{{&l_i
RPxW$r|GM6%YX9ep{{h~jk|6*9

literal 0
HcmV?d00001

diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index f636806d..39ef276a 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -1,4 +1,16 @@
 import WrightTools as wt
+import logging
+from WrightTools import datasets
+
+
+logging.basicConfig(level=logging.INFO)
+
+
+def test_compress_sensor_mappings():
+    data = wt.open(datasets.wt5.v1p0p1_shg_andor)
+    wt.kit.bluesky.compress_sensor_mappings(data, "andor_camera")
+    assert data["andor_camera_x_index"].shape == (1, 1, 60)
+    assert data["andor_camera_y_index"].shape == (1, 60, 1)
 
 
 def test_folderinfo():
@@ -30,5 +42,6 @@ def test_filter():
 
 
 if __name__ == "__main__":
+    test_compress_sensor_mappings()
     test_folderinfo()
     test_filter()

From 62ba42e53fe5bfa7b7bfdf21a32902461e15f738 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 20:36:24 +0000
Subject: [PATCH 24/25] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 tests/kit/bluesky.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index 39ef276a..03758bd2 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -2,7 +2,6 @@
 import logging
 from WrightTools import datasets
 
-
 logging.basicConfig(level=logging.INFO)
 
 

From c317fa34f7439d211aac305bb9361418dac2fb96 Mon Sep 17 00:00:00 2001
From: Daniel Kohler <11864045+ddkohler@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:39:45 -0500
Subject: [PATCH 25/25] relocate new dataset

---
 WrightTools/datasets/__init__.py                    |   1 +
 .../datasets/wt5/{v1.0.1 => v1.0.3}/shg_andor.wt5   | Bin
 tests/kit/bluesky.py                                |   2 +-
 3 files changed, 2 insertions(+), 1 deletion(-)
 rename WrightTools/datasets/wt5/{v1.0.1 => v1.0.3}/shg_andor.wt5 (100%)

diff --git a/WrightTools/datasets/__init__.py b/WrightTools/datasets/__init__.py
index 942357f5..10d3a003 100644
--- a/WrightTools/datasets/__init__.py
+++ b/WrightTools/datasets/__init__.py
@@ -91,6 +91,7 @@ def _from_directory(self, dirname, prefix=""):
 wt5 = DatasetContainer()
 wt5._from_files(here / "wt5" / "v1.0.0", prefix="v1p0p0_")
 wt5._from_files(here / "wt5" / "v1.0.1", prefix="v1p0p1_")
+wt5._from_files(here / "wt5" / "v1.0.3", prefix="v1p0p3_")
 
 
 # --- pretty namespace ----------------------------------------------------------------------------
diff --git a/WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5 b/WrightTools/datasets/wt5/v1.0.3/shg_andor.wt5
similarity index 100%
rename from WrightTools/datasets/wt5/v1.0.1/shg_andor.wt5
rename to WrightTools/datasets/wt5/v1.0.3/shg_andor.wt5
diff --git a/tests/kit/bluesky.py b/tests/kit/bluesky.py
index 39ef276a..3c7a7f67 100644
--- a/tests/kit/bluesky.py
+++ b/tests/kit/bluesky.py
@@ -7,7 +7,7 @@
 
 
 def test_compress_sensor_mappings():
-    data = wt.open(datasets.wt5.v1p0p1_shg_andor)
+    data = wt.open(datasets.wt5.v1p0p3_shg_andor)
     wt.kit.bluesky.compress_sensor_mappings(data, "andor_camera")
     assert data["andor_camera_x_index"].shape == (1, 1, 60)
     assert data["andor_camera_y_index"].shape == (1, 60, 1)