From 95787ecf9438328069346b47d583ff038c1367c7 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 16 Sep 2021 16:52:25 -0400
Subject: [PATCH 01/73] Initial commit adding Microscopy related files

---
 README.md                                     |   1 +
 mkdocs.yml                                    |   1 +
 src/02-common-principles.md                   |   1 +
 .../10-microscopy.md                          | 361 ++++++++++++++++++
 .../images/microscopy_chunks.png              | Bin 0 -> 136682 bytes
 .../images/microscopy_sem_overview.jpg        | Bin 0 -> 169378 bytes
 src/99-appendices/04-entity-table.md          |   4 +
 src/schema/datatypes/microscopy.yaml          |  45 +++
 src/schema/entities.yaml                      |  20 +
 9 files changed, 433 insertions(+)
 create mode 100644 src/04-modality-specific-files/10-microscopy.md
 create mode 100644 src/04-modality-specific-files/images/microscopy_chunks.png
 create mode 100644 src/04-modality-specific-files/images/microscopy_sem_overview.jpg
 create mode 100644 src/schema/datatypes/microscopy.yaml

diff --git a/README.md b/README.md
index 41136e0fd3..69fe0beb5f 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ BIDS currently supports the following data modalities with more to come in the f
 - behavioral
 - physiological
 - PET
+- Microscopy
 
 # Formatting your data with BIDS
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 59c29c098a..7927fd923d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -37,6 +37,7 @@ nav:
         - Behavioral experiments (with no neural recordings): 04-modality-specific-files/07-behavioral-experiments.md
         - Genetic Descriptor: 04-modality-specific-files/08-genetic-descriptor.md
         - Positron Emission Tomography: 04-modality-specific-files/09-positron-emission-tomography.md
+        - Microscopy: 04-modality-specific-files/10-microscopy.md
       - Derivatives:
         - BIDS Derivatives: 05-derivatives/01-introduction.md
         - Common data types and metadata: 05-derivatives/02-common-data-types.md
diff --git a/src/02-common-principles.md b/src/02-common-principles.md
index c8c5b306c6..4da3cad0b1 100644
--- a/src/02-common-principles.md
+++ b/src/02-common-principles.md
@@ -56,6 +56,7 @@ misunderstanding we clarify them here.
     1.  `ieeg` (intracranial electroencephalography)
     1.  `beh` (behavioral)
     1.  `pet` (positron emission tomography)
+    1.  `microscopy`
 
     Data files are contained in a directory named for the data type.
     In raw datasets, the data type directory is nested inside subject and
diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
new file mode 100644
index 0000000000..d2572cc6ec
--- /dev/null
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -0,0 +1,361 @@
+# Microscopy
+
+Support for Microscopy was developed as a
+[BIDS Extension Proposal](../07-extensions.md#bids-extension-proposals).
+
+Please see [Citing BIDS](../01-introduction.md#citing-bids)
+on how to appropriately credit this extension when referring to it in the
+context of the academic literature.
+
+<!---
+The following link is temporary and points to the bep031 branch of bids-examples,
+update to 'https://github.com/bids-standard/bids-examples' when examples are merged.
+-->
+Microscopy datasets formatted using this specification are available on the
+[BIDS examples repository](https://github.com/neuropoly/bids-examples/tree/bep031)
+(`microscopy_SEM001` and `microscopy_SPIM001`) and can be used for practical
+guidance when curating a new dataset.
+
+Further Microscopy datasets are available:
+
+-   In PNG format:  [`data_axondeepseg_sem`](https://doi.org/10.5281/zenodo.5498378)
+-   In OME-TIFF format: [link to the dataset - pending]
+
+## Microscopy recording data
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+-->
+Template:
+```
+sub-<label>/
+    [ses-<label>/]
+        microscopy/
+            sub-<label>[_ses-<label>]_sample-<label>[_chunk-<index>][_acq-<label>][_stain-<label>][_run-<index>]_<suffix>.<extension>
+            sub-<label>[_ses-<label>]_sample-<label>[_chunk-<index>][_acq-<label>][_stain-<label>][_run-<index>]_<suffix>.json
+```
+Microscopy data MUST be stored in the `microscopy` directory.
+
+### File formats
+The Microscopy community uses a variety of formats for storing raw data, and there is no single
+standard that all researchers agree on. However, a standardized file structure has been developed
+by the [Open Microscopy Environment](https://www.openmicroscopy.org/) for whole-slide imaging with
+the [OME-TIFF file specifications](https://docs.openmicroscopy.org/ome-model/6.1.2/ome-tiff/file-structure.html).
+The OME-TIFF file allows for multi-pages TIFF file to store multiple image planes and supports
+multi-resolution pyramidal tiled images. An OME-XML data block is also embedded inside the
+file’s header.
+
+In Microscopy-BIDS, we accept different file formats to accommodate datasets stored in 2D image
+formats and whole-slide imaging formats, to accommodate lossless and lossy compression,
+and to avoid unnecessary conversions of the original data from a non-tiled to a tiled format,
+or vice-versa.
+
+For BIDS, Microscopy raw data MUST be stored in one of the following formats:
+
+- [Portable Network Graphics](http://www.libpng.org/pub/png/) (`.png`)
+- [Tag Image File Format](https://www.adobe.io/open/standards/TIFF.html) (`.tif`)
+- [OME-TIFF](https://docs.openmicroscopy.org/ome-model/6.1.2/ome-tiff/specification.html#)
+(`.ome.tif` for standard TIFF files or `.ome.btf` for
+[BigTIFF](https://www.awaresystems.be/imaging/tiff/bigtiff.html) files)
+
+If different from PNG, TIFF or OME-TIFF, the original unprocessed data in the native format MAY be
+stored in the [`/sourcedata` directory](../02-common-principles.md#source-vs-raw-vs-derived-data).
+
+Future versions of Microscopy-BIDS may extend this list of supported file formats.
+For example with the [OME-NGFF](https://ngff.openmicroscopy.org/latest/) format currently
+developed by OME as a successor to OME-TIFF for better remote sharing of large datasets.
+
+### Modality suffixes
+Microscopy data currently support the following imaging modalities:
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+-->
+| **Name**                                         | `suffix` |
+| ------------------------------------------------ | -------- |
+| Transmission electron microscopy                 | TEM      |
+| Scanning electron microscopy                     | SEM      |
+| Micro-CT                                         | CT       |
+| Bright-field microscopy                          | BF       |
+| Dark-field microscopy                            | DF       |
+| Phase-contrast microscopy                        | PC       |
+| Differential interference contrast microscopy    | DIC      |
+| Fluorescence                                     | FLUO     |
+| Confocal microscopy                              | CONF     |
+| Polarized-light microscopy                       | PLI      |
+| Coherent anti-Stokes Raman spectroscopy          | CARS     |
+| 2-photon excitation microscopy                   | 2PE      |
+| Multi-photon excitation microscopy               | MPE      |
+| Super-resolution microscopy                      | SR       |
+| Nonlinear optical microscopy                     | NLO      |
+| Optical coherence tomography                     | OCT      |
+| Selective plane illumination microscopy          | SPIM     |
+
+### Filename entities
+
+In the context of Microscopy, a session ([`ses-<label>`](../99-appendices/09-entities.md#ses))
+can refer to all the acquisitions between the start and the end of an imaging experiment
+for ex vivo imaging or a subject lab visit for biopsy procedure and/or in vivo imaging.
+
+The [`sample-<label>`](../99-appendices/09-entities.md#sample) entity is REQUIRED for
+Microscopy data and is used to distinguish between different samples from the same subject.
+The label MUST be unique per subject and is RECOMMENDED to be unique throughout the dataset.
+
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`.
+```Text
+sub-01/
+    microscopy/
+        sub-01_sample-01_<modality_suffix>.<ext>
+        sub-01_sample-02_<modality_suffix>.<ext>
+        sub-01_sample-03_<modality_suffix>.<ext>
+        sub-01_<modality_suffix>.json
+```
+In this example, JSON metadata is common for all samples of `sub-01`.
+JSON metadata may be defined per subject or per sample as appropriate, per the
+[inheritance principle](../02-common-principles.md#the-inheritance-principle).
+
+The [`chunk-<index>`](../99-appendices/09-entities.md#chunk) entity is used when multiples
+regions (2D images or 3D volumes files) of the same physical sample are imaged with different
+fields of view, regardless if they overlap or not.
+
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`) of subject `sub-01`.
+```Text
+sub-01/
+    microscopy/
+        sub-01_sample-01_chunk-01_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-01_<modality_suffix>.json
+        sub-01_sample-01_chunk-02_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-02_<modality_suffix>.json
+        sub-01_sample-01_chunk-03_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-03_<modality_suffix>.json
+        sub-01_sample-01_chunk-04_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-04_<modality_suffix>.json
+```
+In this example, JSON metadata is different for each chunk of `sub-01_sample-01`.
+JSON metadata may be defined per sample or per chunk as appropriate, per the
+[inheritance principle](../02-common-principles.md#the-inheritance-principle).
+
+In some cases, the chunks can be "ordered" and correspond to the displacement of the
+microscope stage for example.
+In others cases, the chunks can be different images of the same sample with no explicit
+spatial relation between them.
+
+Examples of different chunks configurations can be seen in Figure 1.
+![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
+
+Figure 1: Examples of chunks configurations. a) ordered 2D chunks without overlap,
+b) ordered 2D chunks with overlap, c) unordered 2D chunks with and without overlap,
+d) and e) ordered 2D chunks on different 3D planes, f) ordered 3D chunks
+
+The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity corresponds to a custom label that
+MAY be used to distinguish a different set of parameters used for acquiring the same modality.
+For example, two images of the same sample acquired with different magnification of 40x and 60x.
+In such case two files could have the following names:
+`sub-01_sample-01_acq-40x_<modality_suffix>.<ext>` and
+`sub-01_sample-01_acq-60x_<modality_suffix>.<ext>`, however the user is free to choose any other
+label as long as they are consistent across subjects and sessions.
+
+The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity can be used to distinguish
+image files from the same sample using different stains or antibodies for contrast enhancement.
+
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+Brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three stains
+(`stain-01`, `stain-02`, `stain-03`) in three separate files.
+In this example, the entity stain is used to distinguish images with different
+stains in separate files from the same sample.
+```Text
+sub-01/
+    microscopy/
+        sub-01_sample-01_stain-01_<modality_suffix>.<ext>
+        sub-01_sample-01_stain-01_<modality_suffix>.json
+        sub-01_sample-01_stain-02_<modality_suffix>.<ext>
+        sub-01_sample-01_stain-02_<modality_suffix>.json
+        sub-01_sample-01_stain-03_<modality_suffix>.<ext>
+        sub-01_sample-01_stain-03_<modality_suffix>.json
+```
+In this example, the entity stain is used to distinguish images with different
+stains in separate files from the same sample.
+In the case where a single file contains different staining in each channel, the
+`stain-<label>` is omitted.
+
+Stains or antibodies SHOULD be indicated as appropriate in the `"SampleStaining"`,
+`"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` keys in the sidecar JSON file,
+although the label may be different.
+
+If more than one run of the same sample, chunk, acquisition and stain are acquired during
+the same session, the [`run-<index>`](../99-appendices/09-entities.md#run) entity MUST be used:
+`_run-1`, `_run-2`, `_run-3`, and so on.
+If only one run was acquired the `run-<index>` can be omitted.
+
+In microscopy, many pyramidal file formats store multiple resolutions for the same acquisition.
+In the case where a multiple resolutions file format is converted to single resolution file format,
+only the higher resolution file is present in the raw data.
+Lower resolutions files MUST be placed under the `derivatives` folder and use the
+[`res-<label>`](../99-appendices/09-entities.md#res) entity.
+See [Preprocessed, coregistered and/or resampled volumes](../05-derivatives/03-imaging.md#preprocessed-coregistered-andor-resampled-volumes).
+
+### Microscopy metadata (Sidecar JSON)
+
+Microscopy data MUST be described by metadata fields, stored in sidecar JSON files.
+
+#### Device Hardware
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+
+Note: For `StationName`, we removed "Corresponds to DICOM Tag 0008, 1010 `Station Name`." from the description.
+It will require changes to `src/schema/metatata/StationName.yaml` and `src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md`.
+-->
+| **Key name**              | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
+| ------------------------- | --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Manufacturer              | RECOMMENDED           | string    | Manufacturer of the equipment that produced the measurements. |
+| ManufacturersModelName    | RECOMMENDED           | string    | Manufacturer’s model name of the equipment that produced the measurements. |
+| DeviceSerialNumber        | RECOMMENDED           | string    | The serial number of the equipment that produced the measurements. A pseudonym can also be used to prevent the equipment from being identifiable, so long as each pseudonym is unique within the dataset. |
+| StationName               | RECOMMENDED           | string    | Institution defined name of the machine that produced the measurements. |
+| SoftwareVersions          | RECOMMENDED           | string    | Manufacturer’s designation of software version of the equipment that produced the measurements. |
+| InstitutionName           | RECOMMENDED           | string    | The name of the institution in charge of the equipment that produced the measurements. |
+| InstitutionAddress        | RECOMMENDED           | string    | The address of the institution in charge of the equipment that produced the measurements. |
+| InstitutionDepartmentName | RECOMMENDED           | string    | The department in the institution in charge of the equipment that produced the measurements. |
+
+
+#### Image Acquisition
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+-->
+| **Key name**               | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
+| -------------------------- | --------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| PixelSize                  | REQUIRED              | array of numbers    | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
+| PixelSizeUnits             | REQUIRED              | string              | Unit format of the specified PixelSize. MUST be micrometer (`"um"`). |
+| Immersion                  | OPTIONAL              | string              | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field. |
+| NumericalAperture          | OPTIONAL              | number              | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field. |
+| Magnification              | OPTIONAL              | number              | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.|
+| ImageAcquisitionProtocol   | OPTIONAL              | string or URI       | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/). |
+| OtherAcquisitionParameters | OPTIONAL              | string              | Description of other relevant image acquisition parameters. |
+
+#### Sample
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+
+Note: For `BodyPart`, we removed: "Corresponds to DICOM Tag 0018, 0015 `Body Part Examined`. For example: `"BRAIN"`."
+from the description, and replace with
+"from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN".`)".
+It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modality-specific-files/09-positron-emission-tomography.md`.
+-->
+| **Key name**                | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
+| --------------------------- | --------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| BodyPart                    | RECOMMENDED           | string                     | Body part of the organ / body region scanned. from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)". |
+| BodyPartDetails             | OPTIONAL              | string                     | If needed, additional details about body part or location (for example: `"corpus callosum"`). |
+| BodyPartDetailsOntology     | OPTIONAL              | string                     | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`). |
+| Environment                 | RECOMMENDED           | string                     | RECOMMENDED. Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`. |
+| SampleEmbedding             | OPTIONAL              | string                     | Description of the tissue sample embedding (for example: `"Epoxy resin"`). |
+| SampleFixation              | OPTIONAL              | string                     | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`). |
+| SampleStaining              | RECOMMENDED           | string or array of strings | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`). |
+| SamplePrimaryAntibody       | RECOMMENDED           | string or array of strings | Description of the primary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
+| SampleSecondaryAntibody     | RECOMMENDED           | string or array of strings | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
+| SliceThickness              | OPTIONAL              | number                     | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`). |
+| ShrinkageFactor             | OPTIONAL              | number                     | Estimated shrinkage factor of the tissue, given in percent (between 0 and 100%) of the original tissue dimensions (for example: `3`). |
+| SampleExtractionProtocol    | OPTIONAL              | string or URI              | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/). |
+| SampleExtractionInstitution | OPTIONAL              | string                     | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image. |
+
+#### Chunk transformations
+
+Chunk transformations metadata describes the spatial relation between chunks
+of the same sample in an implicit coordinate system.
+
+- The source frame of reference is the frame of reference of the associated image.
+- The target frame of reference is the implicit coordinate system of the transform.
+- The target frame of reference has the same units as the `PixelSizeUnits` metadata.
+- The chunk transform is described by 2 metadata fields: a transformation matrix and a
+description of the axis of the matrix.
+- Other transformations should be described in derivatives.
+<!---
+The following table will be generated automatically with macros after community review.
+A "manual" table is provided to facilitate the review process.
+-->
+| **Key name**                  | **Requirement level**                                            | **Data type**              | **Description**                                                                                                                                                                        |
+| ----------------------------- | ---------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ChunkTransformationMatrix     | OPTIONAL                                                         | array of arrays of numbers | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
+| ChunkTransformationMatrixAxis | OPTIONAL, but REQUIRED if `ChunkTransformationMatrix` is present | arrays of strings          | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`) |
+
+#### Example (`*_<suffix>.json`)
+```JSON
+{
+        "Manufacturer": "Hamamatsu",
+        "ManufacturersModelName": "C9600-12",
+        "PixelSize": [0.23, 0.23],
+        "PixelSizeUnits": "um",
+        "Magnification": 40,
+        "BodyPart": "BRAIN",
+        "BodyPartDetails": "corpus callosum",
+        "Environment": "exvivo",
+        "SampleFixation": "4% paraformaldehyde, 2% glutaraldehyde",
+        "SampleStaining": "LFB",
+        "SliceThickness": 5,
+        "ShrinkageFactor": 3
+}
+```
+
+## Required Samples file (`samples.tsv`)
+
+For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file) is REQUIRED.
+
+Additional optional columns in `samples.tsv` MAY be used to describe other samples' attributes.
+
+## Recommended participant data (`participants.tsv`)
+<!---
+This section may be removed or modified depending if it is included in the "general"
+participants.tsv file in PR #816.
+(https://github.com/bids-standard/bids-specification/pull/816#issuecomment-909343123)
+-->
+In addition to the species column in the [Participants file](../03-modality-agnostic-files.md#participants-file),
+the following data SHOULD be included for species different from `homo sapiens`:
+
+-   `strain`: string value indicating the strain of the species, for example: `C57BL/6J`.
+-   `strain_rrid`: research resource identifier ([RRID](https://scicrunch.org/resources/Organisms/search))
+    of the strain of the species, for example: `RRID:IMSR_JAX:000664`.
+
+For example:
+```Text
+participant_id species strain strain_rrid
+sub-01 mus musculus C57BL/6J RRID:IMSR_JAX:000664
+sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
+```
+
+## Photos of the samples (`*_photo.<extension>`)
+Photos of the tissue sample, overview microscopy scans or blockface images from cutting
+MAY be included for visualization of large samples or to indicate the location of chunks
+in a sample.
+<!--- The following example will be generated automatically with macros after community review. -->
+```Text
+sub-<label>/
+    [ses-<label>/]
+        microscopy/
+            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>]_photo.<extension>
+```
+The file `<extension>` for photos can be either `.jpg`, `.png` or `.tif`.
+
+The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity can be used to indicate
+acquisition of different photos of the same sample.
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+```Text
+sub-01/
+    microscopy/
+        sub-01_sample-01_acq-1_photo.jpg
+        sub-01_sample-01_acq-2_photo.jpg
+```
+Below is an example of a spinal cord SEM overview, modified from Zaimi et al., 2018.
+[doi:10.1038/s41598-018-22181-4](https://doi.org/10.1038/s41598-018-22181-4).
+```Text
+    sub-01_sample-01_photo.jpg
+```
+![SEM overview](images/microscopy_sem_overview.jpg "SEM overview")
+
+<!-- Link Definitions -->
diff --git a/src/04-modality-specific-files/images/microscopy_chunks.png b/src/04-modality-specific-files/images/microscopy_chunks.png
new file mode 100644
index 0000000000000000000000000000000000000000..5252cc3c6900a7b2224d5a5bbc67ac1bafb2492d
GIT binary patch
literal 136682
zcmeFZcQl-B*FKycDM$z*2nixFy680pL5OIh3?h2Z=!_DHULqkAo#=f;9|X~(N3TJM
z7QKx!%6DGK{XWm{d&}>?Z+&aMf81-`_uS)}^E$76?tL7`KKA9OATLFD@y5jyCr%Jb
zKY6Tp;>0=li4&(~3C@8}hCQ0W2PaP2C`vs%foY?j1^;p3)f07_6DQc{p?^*~CX3mh
zI6-$p`tbv0NA39-r+%_J^uZ;@2m1G~j#F^e&u|N3g_#pczA+k};e7t#ZXQ7b9X6gW
zfJ6d$R@vp+bMb+CLb9sYpKA%v4NKHt;d!@AK@)=vz&<AApPF7pRq&K7t)t3i;iDB=
zKa0gSp1rZMgU7TBln<{h2=<IeSygP;|DZc@l0f{#sVlEfocYiH_2E@x4=jm4Y0Q8A
zzyJC4HREgSL%RR=QsBGiPx-=#zRX<wAAa---1mR@2HlwW31r<#a;;nc!wrmI<oqAL
zafX_J4#WQ~0rp?)z~5UGN8CF1_uv1E?RtIsWG&fwHCwO$YB!Jn-WOK;KYZiLE4tU%
z@e=`<|N6-sT?^?&@n0<FpI;z4a|KTQqJ!+edCJhW=rC7K{|~?R&Ev$l|7n)ehyPu~
zfNRx~z5E}(LBM}S9D#f-0srr#4{XB2%l{ix{~J{Q8&uHI{NGG<n4|x{$W&wweNe$1
zcAAbc{PFpL;nwmm!={h-Qskm|k;FCIN6Glq72hXg{xA&3bsd*n5$FBgZNsr|9#`A-
zFSqY~pW(l9l!4#hJ0-lvJ;`?G(ovD~eR=}P$W`h{w7WGC+&Y^YXGzYgp}&ZoAc`t5
z=}3?eW}0UCo0z*F)5#+xNPm^+gbMLf9AA$Ty50oyo#V24e7!9qm){?xT2>lpt?Y-9
zQu!~cPUW|Y;%gnO+s+(US8@GQ$N*R*0a)GQnD|jD7Ed8qZfXBm7S3{155Gl#oX?%N
zMZC4U*4{ePk=UB0o<Gn0DP1WwvNv0^LF|f==W(g|<|i&vOBRclXZy^3^v87hXB?-D
zdhMQ4A1(EY|A}##yH7Wk)`xA{BXsuuz^B;Vw*y#-do$rVJH$-{fA3S7L4g=4ae8%_
zY590-x9Prdi_yB(%N#EAJJZQp^v5lcEeY8;QCF~>g`y!g#(cdSM;GvLAxR6vR@;ch
zt$6kve)L`pY|`4a4U0FlSdU#$exyI-gt2NG!n4ftTY0mzr9bF|Up!p)?=bQ5TC%H?
zC2^zJYU`ulyM8iudwZ3y_ptPdyMb!iJvO&F>OPvKmRmjSez0d)<4tJzv(ye}P9h~}
zKW|JVvaZmTqa&6-9gB)&E$UDB^JMAk+B-`ASD)3(oeL?29lu0~x|W)BrO5S6%>2bD
z;;sZAN#G-n6NKDWBf|ME+t&DbtD&Oo+1~6Z0T2>T+hau@iIq7m_B9wqA6N7%*FD%P
zcRRsjsb@i8e+aMClFC(XA8f}R3{YEtzm?*Cu%BWx-KOHcwAK>bOdoyzIBeJe7`wU~
zZ&1!R>XIM9k4)H}Nes@2)dis~*+|K#!(5nCvD5T4oTCciG>J}e#p6^92Ed(W#>Nr-
zeNNpz;tGh8J={?1CrwKe$v}$dxb4w&B_^A_jlL+1R#_wn<>ld=U`_sGc=dVljN1Wz
zbZB&%Sa?~yE>~V)@*1~EC&O9|?fw^YF}JzCpIVoXcVqb>z<5{j;Ec6kkrOQ~5!_Ml
zy5X>&We$7`gN5AACY`eVO=wsYqjr5Ttrc6@JXcqqL9;(S`KL>nU3Pt1Mv}od7x*8Q
zJ~{>?V52@`JCkLvudOz-M}f1@VmtGrirS`y6E~1^kfOrkMa<^58X6ZqWLegVd6C`g
zxCp1O9X*DajiiqAxeYCiOmXHTE^Bf^*bF6ObcSexf@Yb0_Fij_!zmv0W^YBh(EOK2
z1C6UK&qjg+362h08Xtf}Qq{6yY&>tz5$3T!mx*nO5$dD1@7EpGILC5zD$)#-`^JB;
z0>5asSTcPxDlolU+hs+<W_P6_3a;bY^Nw4u{xbfy)Z62eM(1?u0W$eLqGW44pf$oM
zb|7oF54BWoBvyf)cqcT^a4@N}U$=kYzUAXSRucDhh~nz;`HOhn<R0rd?l+a58k;xG
z|I3rK<#%IfYn#y0ux%TZ;CAtq2W48V8F{*<e-a%|W?QrNY-Q69Fj61i$`e)y;`Tk^
z5Wvspw`LcQm<C6Rpo%DY&D93-XldPdb14OF)710y{T6a^blh<HaVpfviTWVJZ?8|<
zvtLJ_(fsnlV*orH8bj%Sz~A_71r`j#u1CdizCV`{p0Gdr%$+MW&aJe=hr*PZnAiIE
zcmK&M$Hj)pdu^wWw>0MU<4}-;293%!3d!yr;H(Y|y}}(vUHhmV$2_JmWs7;Vx}Qvi
z*UUDFjgAp=QV>XGZ>0)6%9}i9FOiqqns5(Uv&#!we8FVwi@5K*l<B%Ar|cn=FFuv^
z?}>F;mA3iu;JiRf$Ui8&R)X#>Chc;6w17>^=)vA-m`J&dCpBt5*WN30AHH;P$f8(l
zU|)E1V)fdz$I-LumLGddEc%6v;imJ<EzJiHX=O5~)k;!`IobuLsn>cnts+hn@qhb7
z0{--;jQw<kPMJIZ>ErBa0g(Hj`42A??*w9RcSt7JUYxA0rdBc{<rg{rM)8?9?JFFp
z`0}+jA>1SXo=kWYZeb`2zf?JjdCc19xH!#Qz;Tp(6`zc4Psj0zpl}7S=WZ(jI{hSZ
zVp~<jFC*@?@2YWFlN{&&43OJu=igQCPO?u`9^flmOYP?7``D@oEo&|^Ry}_Ar%3x%
z)mhH=kgf-R&y~0Ma>VX;`rz;yVzIB|x^+6q8IQwNzbcywZ`L@z5k1byJET8E)A#V3
z#it2rMTZfng+jy3>>_`Q7qQ#9@xLD*e@hu;X1^KloXY({OTnBxtxEjQr50Gu*O%Ik
zzs|08NYSE2^wf|Nj8$#?6PHo3&Fq!KAVu98XA!u36yqm6GziXw(&@_BNp3Tvr`=d@
zj;kHtn#-BRuWRyUJ~HKQ0U#H)!=o=8=fZO!7rxV0===>16X$fCdxg`u9~1M<?7^%-
z2Z`hd-PQiE4Yzok`w@%B%N!<oMFv09RLF3*eQ((Ny7ys@5pN<m6ZdOl>&FKpw<hW~
z+vC#3Ljt(YiMzTI&7SRob6JKk<-sBgGu%%HoiYzCA0iraiw!M@pFO)jNB3fE-bi%)
zG9y2q`r|meD@dKfj9-Mo|IA#LCp?aQZjT|W%Ab}pIjY1+uhAVld%9GgqiACQSfcLa
z7M0ak-7o^Njcz4e8mT;gm8I}O@WEEFVE}8<R&PWCgPJW#U#ktx)6f5qULp`kzZ-6%
zT6X7+#4;V%r&^<01*W6*rrKi6@LmI{UegtCAN?inY4jdrO(D)pCDuRf`XV|KrTRK<
z{9W8@@$w6RPhW}Uvx)^-Azb8PR99OBcf;=9=z;41_cbQ9>W^oYC^;8$ttZj&!8LDz
z`l>VkFv>A;y1OpJE^Dn*>s`-s9M^@GzUrMLqBfR&vsk`4V)(1t%W(6j13T(+yX$$Q
zf40cz6iDV-vmJ>(+w=MDE$nV9muwnn9KvaL$Ig>U^_Yf5S(Y}=e_d<C>9r)j6U@+e
zkKMMjzxj9591pqn&%*sb-h@<7E8X_yB{y}wLS8<&(=t^;bm#BSK=MVE(SbBmjK1a9
z70G-6IX;QhjMoLoEsc~fjGiaFp>Nm{u3I!<7?ro@v?#>?_Bd~N2$DL2RR_gx!c?<3
z7KV!XE|IgOVNEvz*ef_dZsg`0e)TqH092+0pYY@x?Yn|P!Cl8iOZbo{-+cNdkXoSg
zX#`hYfoV_1Z%ST^L4BP(!?x&w^-YdU1zyWx<8zlOUg%5}I0R@<6}Vp_{CgOFUpN!D
zM<QL|EMf3Kv%q*IyK%SAeJ>2cAL@ms=sl|Tz2AFvzQ<v$L6BCk*`2P`+MlbpV3Ogg
z79SEnm^j(WH+ml`yBc-3pQk8K6uYs;{`z~U1fj>hWiXIukOI%q#t|^8F+@KhxUg89
z5SDwe+kSBWx|Z#S68vIWRLow{kYzr*5qfZ~UChcEH*d0D_cWYcn<nMiKc#^B!kIcU
znw`+N-C8#Uav0eV@rhNFH^yRbXTv^+Y#}$HH}x59qMTXrkfl&8{$0x~(b1V$mj3LR
z)1&lEq~~em{YLZ3J)B%u=hD9W!KOPOy<{MVS#MVEfh%r)peWEWotR_Y!EFw|&a8L5
z%YPn$W8*Q`K<jR9md&nFkT#pv79%vouFO!B#+KRSI6FsHNJJwT?!F!7o~u)mq2;zc
zX)lJBVa0mfq#73B_xa~ZUm@^^Wh7#(X`M%|#~x@}l^3c5c%WWloxHbXdY;DieTS%p
zGjZDg2`vaPPda8ShKdSN>GOqs+EY31dzk=J7`ewoxzf$01Aw5s(8-9nue6lMwOqjp
z%2}Q|t{W=chAk9p-%b-N3oF8uAsn>!%ZJum+m9rxuM}XJ2mlTGz`+oG$DJf}R5(tY
zLS6+c9ZcF!4%6nEXb83<QS@(k-uNXmr($q-t3eDScs3TVa<${+Q5=m0eOq!rK;e=4
z$)o!_-xVjnsYqto&Gi~gH*t?fQBfXK5d}DeDVN>$x2LD7&ePuC9JUG8I+eAP;heq$
zYPzZO`i!ou&t8|<UZ@t)F8D_Osy4C6`uhRBV3GNo%#&wG(WFX>lGDnqxY@2$`0grW
zb+^Eo<4^|2?*URGQwai&i6k!oq~&Q2W9OsdHUE-aUEpu`{rxR_3E3|Qwd8n5aQfc-
zt=hzA82p9zw<aJ^z|}6i7U;T|X*b(hhtcoIP%S_I5q4HJoU7f1xJ~cLah*5?>MqG^
zYJ1<hfa_5s<tWW~!^RNC6wP8wUE*ZgzdJ}t|IJ2Bk4Ufd`0V%st|N7(LHGDSKav89
z;rA9gscoWobDO#BV(*bNe2hv)$0X$>0YAxD$r3@}-<lFgG8Pf{yn)l=co_s>GjGu`
zc1Xwu;WwA8_E*Cy`^#08wFA!`#r$h=J#c~1aJM?<<G<hpET#6$(E>js!NE-WRy<f^
zus+ja*qfye<y1bURQYTyrS`>?mTUh(T3=7QJ$^-feA(|5;3||h6kW$MCO=fZ&Zq`2
zda<il9PBN@hnFjE>e<L2{pN`?A&g)j)JOiVYFXm7Q3d;I;4!;>;tePtS9J5cRlsZ`
zuhL6~L$#|VR%GZh6>m#{aYyx97RAlK*~<CKScwjCMl|Ws2k%7zYwMaOH9TglzER*}
z!;fj&9j0R(B1xYKcU%U?<1j6nbk(n1wmmL`;&iYxj*CWhN-f71QlJ9&RJbx>e7sTQ
z0OaUb$+jGyrN8v+7+(JsFFm>;nivENC;0o!kDl%E_W$#3bx=S;&a!h#{oRtkJNxg_
ztRl!Vj69eZxBv62{QXoPsH`&NUu&uVdu{s(A)vtB*f)Ovy*~Q>EQliYWfGgeEdB4z
z{rgSO@qn0DoVa-B)W3iJe|%e<oZz=S0#YT&cdP#{kWh9EbQ7doir_cr!}`@Of22LN
z>9(=AOA(Olch&Krhm?dWz=Q5Rg9nw=fpG4xt@1bu({pc*cJCv@``=4@_pxAS2(@1j
z9iJWQt4~%9E+HAEJkX!hePI`>+d33{VFK3nZBHc-jS)4R*AL^vT8^%96mN1O2pe*a
zo#XuRvwcUvu$||H4N3ea^Fz57eMWcM_--wlT0qDs<u>Mb%dhaG$Sk>Y_{*=`3b7&Q
zjn0Qj=vm!hD{-8D?LILXQI!8{w7`jBWP5DX(dm<rrUGJMB5ad^`)=ZWVGr0%{_@89
z3sUVeE!yJ(oZZ^zZgAS!bz!CNB)Zn+U;lnNlH#P!N_6pNW-WD-_~9*$J*Km2Py9MS
zb@^N^S*k2ODrSv*xIe0#!Y+by-!2|qUa`f8619oQWj_cBv|k}{tsz-P2i}RTalRY1
z=fViCYr|V!n*}~4Yp)pLtG13mN<+WjijTxfIptqRPFkH&YwU33EBLC_(m&+LIXr*v
zXM#kRScwi#Y)*+==*qpu8GZg~i)%WK#^WWq^sR8NLAWqq5npZ_TzGn6&;Q9Gx%99l
z`98FE*9vzV1G2|j8);3}sy(Nk)#V4F<4R+r*Myk7(|?Up(0TKpZJfFCerEjXH#k?M
zqrJUK3K3W_j;uYxnkdxn&KN9q4d*sFPeF8e20R`U{9bVS$cMTL2dTB>!xjaD)pc&%
zj&I)Y`r69ITpTCKzMQw<|1R-=ckzE?5$KcuzdA0r{b8dnYeDLjZsid|4j715s25wt
zh;+sK+%$bBy!xc8(%n73OJ1nQ_JiBbY^q_c@6{>XkQLuE(d{IGna^)c1$9`fXo|~q
zTvoiCfacW-=&%9c`(Ah4XasFJw94#xn4(|35%~T7(bKu!Z2F<-J19PYs}?H{-17As
zN%9R_Z>&v4Sw$9E3`JW0ER6snSX+GyU>j5esx;wuP|cL9e=>6-AG|%Meh$)=A_VPB
z^=VV<M%42SBe>i6YZ@J%W2OuGH93?wQ%Co4#Rht%M(weXx-XB26nU>vV7!yMD8`oE
zi-$Od0g>p|i?CajJ$*e5CaX(*I_?%Z9cM3*hcm@GCd}>+1BtP#9Ob~R|NTmSGh5mH
zvT1B}MxAzF?wdVn$-alddd*i4vpbd09oNI$u19N=An?}<fFhl9smssVBosd8HomaR
z4-z3xZu>=B^*nFU62#}HsCx!vKI%Y<*<gXm6oB?H=?8vmbC|NW%hdco3d{#OBR(RK
zfOHNeW!Jxw>qg(;V8!h(I#hDgOTD`<^Fq~>B-9f7>s<b*8(v_o>!isSxSPvVgi%Y{
z^Td|HLbK+<ThC3#YyDJ>2VMrSa+z5r`^}Y7@>xbl2-u`7Ovxhr)^_&5mbQ3aAZ<az
zwP%0l-|e%xF|IDjoI>lirAyTXVEJ7$hgA8P`Hf6Zmyc6jBP@O}WPSc_0dhjp1`vcO
z_q{%M*0~~!qJettX1#`Y8@Jy{`lVKLG9;SCH{?zdY{^KHwg=IKR)lm^fQnV_XIC*U
z@CVOu^H>F~l|HVifn>GlD{y(_8#U=W*`f-!k!w?}hIRgAxBwlVy#=sJ-qaZT$N}qS
z)<@BM2c^Qee!Z#Rq0fq7)ZGaTdI9GHNrsU_n&xob4atUgGz+$j;#r82Jn4d+#%FFX
zEz1^o%Wi)!OzzMgNK|3o86_6m{lTJHly&bxwqwcmRMbL7%-C?vV9YsGb8Dd*i?SFk
zfT%0GKqn5@t?`Dq7hhJ?ZJl<LWvhE)G8Dp7;d)QY>=#;qa%KLBUB^;%XNKM^b>ALB
zw0oPQqkh4H_<~|pq(tAQ>*i0Ri<^ZU_22`JO0m7!XSh;CsjW%Z$6(PN<FZJFhvSLC
zqNeb?YlDzhb4M=nnu(X<HB`;3tX>~|Tb_rzA{S3W^<KcgIL{_9N53G)vF)8vxXHCs
z72^Yac*$#$)JJ-1knG>RMAV|0`*KMFWUggoebAV0i)jtw8!;y0AA6nh_;Zt1dUsFB
zbgUU^piJH@MOcWo`&JFDd36z8r!fn3-?$3U3-}b%l$Jhw@GMq%U>@kvt=}tG>ZuHO
zw^r;Y-$nMf#)*wWT8zAdMqhw{CCZ?|k14jl;Gq;}d`@{Wh{roZ*Vywc0B2EE7zDh~
z{9ddpZlIx2)edK2m3*OcwF#zrU-1I=p{xeNZ>TbFBG`R5k@Y0ho{9qEP7}}!Xbj61
zifnLN;io&tbo_`kf|xqsFF%vakpycNn)c{d&*fBFF1a&%q#lY1ohBGW=L;)}%Cu)+
zhP9MGbQhPCJWF{R@p7r$6v!4i5uAG70?Xe{M=i24U&lp_?$$>;j5x`0a-eYLC_*eR
z9HrH+gAr?-!9KB$r90g3lH7?O|BA2h&ZFNZj<GGB$5)ZyRYNOo9VPOt)w+YlvZcsS
zdBH}Ee0o7b0>2*>uV2<gtlN%>O|QBUkL*J;Rnb~Bb|D7nX=Fj&&KrLWNHI{4L3*Z6
zM<KH|@(e-Plrv|8NsdeU-eYB6DLEwlElhU>vyR(#a>?%y*{mN)DO^fB#dD@iaX8gg
z*;h-SUsQhSlPIxCt<qkgQdUz*-cm04w&b>1#-@9tG{*`hw!fuUmZ1wkzI|Kqh;t^{
z6IpcbrHcV1R15{iUU9N(7FPWw<T>7@<Nh#nb=E%X_Z1817rZaNoxoo<9jz!Qb0r1~
zw9>unRzU-_amh`bbAXZV-t%nQ#u-!3Efk2pkd9iLYgPu+6d*bQRHkX?=(>9bWW71O
z%C#Z>b4Tn?A?OI)^3AxbVw6j6kh5!>J8v#ppiJ7YxK2{-z7%rAl6-jNLsTd&!I)7H
z;gsCTUkB6nPaS`R@ar0Rv7Pj#v3G1sX8aG#l!mIPM7u?Fp{MD*#R)bKrau=6;&7kV
z{77;K9UkFrzB_14zFH{k8(fqQfFXB^Uo0&Yk6Jcwrl-5aJT7qN8QoVY5oPQwtj-8g
zyNeH~lej>1UE48UsYGZL=e?3R9}VhWkXfN=0y5cVrwGni2`L?^Y71_7&|2vydkWf{
zL>n$JgW}9`-QBAx#Eml?A7>_Hj<EBFa?uW6MiTEoZSLeVP<o8<5!*j#5BK3l)bTb@
zl>5TSFq4)08#y>L{cK4EB{}B>ZiV#prEpF?^Dt`|`^RXYQN(DagJ>o0uh1Y%)K4-U
zY6t4;esNMA2qMBy&lDpl(ej}&=)s+hIl0ja*H&5fa{W?=CClIopSm;b=j=+tCyF-P
z-S_j=v9IEPwrEfOV&G8DgHyfToa<}Hs3{7>q83XU7U91-T?RERW2?9nnfa1_FMz+W
z84{63GFl#(?pL+WGg6DJey9JyXGJ_=6t~Y>#M2^kE&I<0ibO|M6EQ!SrbVF&g^~qr
z9L_uDH_$<iWnZSxYq8=VC0A*qbCf9`6<%V)eiMD$lpWi(|8meuqFS+gIyAt&W{3W%
zSV)KN-HrzI>m2?2EAxNS%{Mj=na98?QNA4`U>>gJR@l{eu|v{+pZEB@aX4RvGb5U*
z_$&(;m6S=$m&!Mb{MLRtjFyl0(6Ue}vwg^tYuz}z40;&m?a2&DBrAicM+V-?f-uw7
z3`c7=2%wM<vz4zaCR*!2!roq!4%G{|>4U0US#(`2pMki#llnMIhSd_KMSJPNE$Q*M
zBr#$;9l_D^6J3?bcbHTBQH<k-H>CXf`?OK5)Go_aMW~Q*8IfHoL=YLHXiW6nUEW%Y
zrSr5dFW}t5>pvc;QU{R4sps*vAXJE+ZqB?p!M3uT*UV<ac3zdDd2@s68r++h))F3$
zCao!OmY#$aHYh-Q1Vva8h_Ek7Gt&=`B5Xwwx3hB?Ve?MDlx0_rSR|tV#}SXd5qA_}
z#p-O4BJd`iAJ0{vp9vNi_oX*~n5U+2*B55ihv9*ATvm3_uclf9jU*Hq{EtCSGb^`R
z${m?>mau?<;_|B6sj;fJt?RR07Sz~+`vaM-`X8fvOmoKe2{jtQp-lI2f18=hAPn`B
z?F%DnlX%Q}`w1%xBjbUXXRp!;ya2LYrFLf5!+7WBx+*o|kpK)11r22~j?h!7*?xY8
zs_FmS6R=w5dCqTqFi{_rOd=cOM$rlo*mr~hI-HlOqH!3`{fz+0&!7t^#bqy<{LuCv
z;y>}f*SC$nF97#A44UD7&KVfx0xXtlC`xS_7OORqvrKX<n`xg}#R)e>fwSgLuV7*D
zh~pk2`=;wj(^qfDtS{VMXiZqvO^vpe$*+yJLMChDyvv`P5Z^#wWu9+;p8ZrVeXSG$
z(u|6tl8y)LR?e#8&J6^L4_kD90N<|{JW&3`me4qKGgq%+kbTG154N$q1i+hFbM(EE
z3J?{P=$oNi3K%lgWRQN`FqpzU*Bw6W#U;?M<|DoHltagTuW%c5a)>pnEw@)Ei@xd(
z6<GwSu0+48zQF6Pb++1&n862aw6Sc($W(r?kDuyRddAcIi8cSHVSB6v=x$6Eq&{8Q
zcHM#7Yy&Z{)%PlWAnvN-CGFy>64Sc2<1YJxJErJBP2e3HPO|hx6ZK;*LHWq&O!31|
zvYe+_KRj$f3vyX&hhoGs|IyCTnYtxj{XV(9Evx?J;?*n$ja$EHilU!?`5iXbS6)$v
zPFi4<q<z{Z`-&jH;Sp<NQxZtVL>GuPa=9!9@0YR5CVLu&M`bp*X2#+wHb+pr9a)~J
zm2;yNwP@#ls^ON3G1_cp0gzJ`{K@>-24T{<)VpOe<224Q@w$k?tl(z{=isU)`%<*7
z1!QU$FW?mGZU1yPe&V0+Ob*D;7W|f4-g8G7m@23yOb3Z&azB%46c*g?&m@y!im?s(
ziI?8g5}9igUTeAYOUGdEj(l`K!#87<Ue@B_m(6OWyw^dI*GdOPp5Me8bLzOr>;2yq
z`Q19&r)-i};kJfha<i@hFzF#G2Cxxxm2m*rKrW&-Ml^zLDrvq)hB4bEWciA@O#Q)5
zUu6+2T%*vGZ1&#Ab123eTGow>hO56D8TqzwjF{Sm(Xn$&)}K_(5jL$n_H~k9*27e5
zO(c9&wM}YJJd8<&f+od3?QK@`pB<Pkr9vF14Gz0eFlY+OI&KsgRq|hc;1z>A)u3T;
z4PEK%PjVx!gPM(;b(yLKVLyJvKZ<ct&#=*$SGgdvKuiCiOfi&zK7O)6Y#+%mq%|LO
zUp(UN6UheYP#dzpK>h8%0(F2c&)u{#KUIY_HJ8oBXn0W(JfLIwn~I6lN)&%(_zDSV
zE}Uw~#3m3fF>0HLoi0rCGp3od=46^21qiDFqB2?9<)!KbkWXV#_cMb<w<{HZYOiQ7
zUU;cjADAn>`OxedXa;{P(D((+6Wpt_WN?HoJnJK>qxbs3Bk#+(sJt|j9-qf)bWx_8
zXX5tJu8=h=CPCHsD}Z+PaUTE_9GR~?*l(S8n+W1Fx84VEtY|NBQEI$vM5aRRt7Go$
z&$8kLlD-V|{hv9?H=p+9;;wYYGABp6WaI_;(AcZpe)+1<tY&hFAyLb?gOBA1Z)f@B
z4YVI3K%*|%7D4do%KWM*WiR>81E6$@aRR-VR;O>M^9TxZxLpCINluz^^peu|MC@%{
z37&&XI<<YPJ*dbKbk!GU;HFs!J2-nXc}vzk`!%Tc-ak+L+(>SnoKgvP>~*8pKqr>#
zy%WKyCH4>jdEGTXGvj$J`Y!Rv3q@^wh;hxUI>-L0u1e58S<6->%1~qI8Iewu3byw*
zIRrsCst%b_P||wr{a(ULZ16>JF=_~bmK}sPy-A;Sv+aH^#j|iPsdDZHTh>!WC;sgI
zLBLIFypc*`*HJOgw11rl=|Fb=Mw~rDc6tq;54nb=xz)><97o(ng+~Kb)a$vW_4<^K
z{@z=d`$g`d1#E|kXaIJV?^KUv<i-<8c<KAKI~e1GtBe~LC-Y3nR6Ch5A6K`*!VD_c
z;puk^(~8Q5zmC6~9=p>Qc>wysW)Lm0iik2oCOh_oG<njvZT*Umn-<;EWWjh2eAB|w
zxbLp;UOfoV*{!bMBz9YV`?O!vGKATuH{a-4nY9!?@Cm_)Sx))GA?5T$a89(VTrulQ
zHtiyPmIxh|_vATG{Yy)K)QzZ}I9Om{NSsJ&ECJSZ4`)c5l|-bc!q-ri;K9zh(pSc|
z`ApWT=;0|3c#GU!)x(Ohhb81z9U3I0Za`*gaPRV_WqNrFo^_6d>9`GWsf=sMWm%Ta
z-svhd>x*1Ov0b+b!F}SA8TYK1kK;Cax3_j&OMwVs@sNAjAjeZ0{kk)jS|%w|x%>ME
zdRdI(G9zXSmlKV3S~Ik16PTu0=!oY9J{HZ}Z02i|I<4&3X@8vm2gf4N9#@WbR(N_5
z^)&yyVgR|^LDn5NaLOP9jiLivy9dh_9Q9!KCPIzpF6RPZQhcnMMJxh)pTjeV05j(a
zy(4GMe07SXU6;~()(1=CP2!5UaLCUwu}!M(M<AYci9-{9L@d2wv^z!tCy;1X_mVd9
zgHn=2cZySmwdmDbgH$RdNh+DD1Fo(;1)JGTU7Jgzqw@t_^13M<EXAaMPBiS*T$;|R
z8~L&(V<y)0MrHXa$30>5ehzL>B=R?UHR0>Ys(P0xIKF+-=%_dY8tEKmi=}3F5AfP0
zA)e)>4}^D@YYe;7o<n}TPXVUeun$xXePdvANpPw*yWrUxxou?X4CIW@#RR_V(q3r(
z95k#V^CSu}>NpW(2wXU<CKz@kqdY2eJ9l_AAZOOuABG&FLd@FMUX`NQD+6K_+4CpH
zU8V)q{#i_ME}hz=x|)NSQJ`hj&Wy0@N-ywLZU;eLz3ND%!nkLsw=nAh5{Z|ypf9V4
zY-6w3N^te-+F06Ic`ZNx(n`gVh~|l;(6<CL<D;`<eBB@~@rbD>g@)ULPY;>8F^6pn
z!^v^xP|HgqCc9KO$Y^K?9tXi(`_r<|etgUJahmO>>g3m)vPD7sie(8ggIx>ojTvkn
z^z3J_weo~btZh~VXl?unz$$uVDOXpx;v>Vfof|#n*dzr~IL?la%X};;qh6Z~(}_GZ
zzxCc7rYm^nQ*qg0z$c-zZp?bkIs&EJa<@S_a;ZLuDx0GCW!=T0){S#h%_A?y%Rfaa
zsm`<Zr^zjll{q^~Kh01@@c}9zW3DPV1q`UgIudDK<p({^!~ii&zEpeprYYLQD*o=v
zhahvNmRFfM0?(m6dqj58V8-~z&};1(xi;HEjmFnC)(K?~VF%G%yg6>|2<5Mn<P(8U
zh0DI`collNU7^F=5IVPPrHAhevwJ?CfqhxaJ7lg0TuX+6c7OC?iFX~+M1p(Pi=ozb
zwEduoVKZwni;3aN`9xiH?9?CIk-LC{JR8K{!YD5*aIAp5f{OCGbY1mlEuUJ(9rNl8
z4lfPT(B!Ac3yaQ!_`2&lYCU#98k4K`-%7g{bgd7op)pTr*6u^=W{ft>o_cOm?y;T6
zcL`E~T-rr8`*UzTA7AyYwk)|Wp~$qfcIh-rZPNvS3{>sy(^YfN67{ya+2j08<HgcB
zOvY{FAKD@_h3A1+P>V~~DqUJ~AoXrR?mKo`B%aTB2s|LmO2hQtkZYGRTkHOBiVps6
z7VG-k6Ud%^&e!f#LzNX-HbF3zosOk-poR|I%dGays5Q2ls4n@asbVRKPj*}Hkm8j}
z)N4|?ygfmCV7#W5fk1-%Kfp{6x!bhfV+S?Eq#XtCjmw-}-jUJbnJLVB$l7AqUA42T
zk&vu%LpSOW7n|1kSNM}RKP+4ClwGKA%+@R>3Sd$e3xgydfP2(YiHeQU?`VVu4IHvH
z3N!eZUQm`eGbK(Gz>7?|=Q$RDwJ;CWm^SO36Vz6@7PHjvo>?2x6z^prx<_T8XS2ZC
z4d6W$>2uykn<iGd3VA>V#@9VgR+UwM9MhLtUT06H!wwl+e<m`t0rBxOmZWIjV5N!d
z=V{24=p{M+(rPBud*%t3;2DNee$qodHbx7be)_1}mJ(f~A9G>L-$-YPs_ivDozfZK
z%%>&IPI+5>l$7T^>Berr2ie38HVXwM68xACu4VY0@qv-+GA~@cne`-Lx1cG=b+c@g
zkQ24ZhQXBvzaOE$0?*hoTp6!RaabBD3gexR<uZ^N@GRjaxCsoC&q?xtzjkULzf_FJ
zcv@7{k+pJLq5}9t!(MYZt?HLubxtmQts6nMX;U6PQNY)9^IX+R86fSJm3#J7Lb_3a
z8MSrv#lnycYY=~|q;s5!_sN>gH)=1!BR|3jQ~E1^c~i~rKQw)Np1A0?5-2Iv2{t5D
z<3;ebFtx0p=9=LH|AzL+@;dpBJ;c6tg-eN+B_22z1s7;Z>l;OLM#uJ;%^UMSt5M*>
z>CVGZH5`|_fW$~4vyKFen^I1=%$Zqp??}xq`dVYIb-Z^Nmzg-$Q?)8ZyOV;NyK^#u
z`?>_!dX?zy#_HXVdcxbkLl?vtd!KwwhuahuYp*RMwSoTF4OBpjs24!2Q&E{zFnFUp
zC(kPLl9Lb;82>aIYJJ~H(2`?L4=LQZqH5~~R782y+wsV$gb*W*Y^65UY(okz{U=K0
zkFys)gdo_|b(oc12dQx0lS)7qs;qnI_sMt!h{5&}GU?=ju8h-#_nd=oid4VM-*dt9
zg+C3O;R7|)reD_wU2yBW2F{cW_?pVO46I(|Rpl9zG+t*>dtv|64$g$iu*1#j{LESR
zYEF;{n7_}C9Xn;y$Qbr<&+#)BXI2<YIF8j(nYfMv*svxfA@0&4HXNvv9hjRtWS{xd
zw+!b2MHeos&?)JEJi1E)a@o-4R&nm$T(e*pmKhU$H6_WVut^#SDv8QX$jPafIddgl
zBeck5f1i&Eg#LG+{s`zll>Zznxx$~}l$xZcn}{>zS!yDTI0sd+fKZ1)JqegQqGH&g
z{567oihrR8VR!l?Me3?RsZ$Jq*}${L*=pV!zGI4j-Cz(-yLUmvtd}LfhDeA%Vt#0Z
zBXr{)#5O=yY{#f}n4aVDV;qz<2CW6FhbtR>IzuW%Bv<*&`(GTC?H?pbhh}{8gH6p2
zRXS5-evOyeN}nA`aSc`e!=kpj2)<nm!(T+K^LU!R1-g2X?!%<?U@O$yP(rr2Y`BHu
zD2_Z}G-HTa#|rqjT6a_Sw81@3wM57v>2ehcb+jTg%h{$e-C_E+2nK;??~kcG^53XD
z(0;~N>hFjnevQ`Od2P2rH)cKRo7Z5<Ve~xXzS@^=RKKgO*{`veR;&|AD{7!|pnY%u
zCEUk&>10nu=$8a%N60B=r1(&a>a?seQY+@eIiv({EqM6SnglJQe?pW8BCzx5lY=^v
ze{xl`pS*ak^l%4QUkeU04^rgj-r~{5v>{GwQ<N7RFsx0jFnLr>OJ6FM#7OwMxhvFQ
z0R~eOsI`@1roH)AK1ML2HHwd~j5h6UEpN6Av%H#*ZrHg4W^J~w%MW3<$s%8FgzLTI
z96i|IYz1wZR><x?UOwm_D`THpHB!C%r#zy(e#OEHIZ$8Copq&sXA`n%&FNTtO6@JO
z(1dK`&=5kZiv9BiLYo-nxkp^3H*W3U^g7%->N?E<f%+qw(!kwvA2bVAs3-TB{avX;
z*}<XJ!&4o>*=Z7ZRTJePmv~e!y!qDI;Eq!#CON=*`t&Vdaib=a3)t6z8ArD`Pk~62
z%==@iGLcl}lKXbEPHzEwQ9yZxi((G)D*R!HiXwtBd!5JrmWj4YT8R8k1|A3$cI2wI
zm;zr|q--{hoZaM-Ux|8gQZ1T)o=_ffDnModVLxCX2fN-h;NEmEwV#YoZ1)#&BAx%o
z=%AqyQ_@XVOm~g8NNoZ0EGVLP%_=;5fyt=9^VQD5bB%5vrR+Yd6@;Btr}tuMC0WRP
z^1J|O|72s+&f9+cM2_NdD0d8`6&r~}Zcm13b_g$i0#y4;+I;f3@<a9HJ13vR_&~4b
z4@=g}*XIk_Xraa#jSJQ;_x{qHBcS&0H0K1;%bhCfL~qaA*Uhf<;e4T25{PePPJUo`
z2ccHsz4fjX<^A;mqqxEz)sM7;fPMt77Jx|$Q+1_{U&T1W5fJ>hf4$1(>pXE!lmJ;*
zB_Q+gUU~+Xu8broqHQ;`$yhWZejImH1)_7E`tJL|BGp-O<U=H9Wq_cVjr)|h)b&h^
zr*dz>Dk{CYRKR||zoS0z<1dlT;V$#sI`Zes{d%S)PCer~VHZ*#K(bt+sa!M1hJ=S|
ze%hJvU3^#Eez)ki9o&MMg!kuQ1U9*&a;fs50#bxamMZWq5R9hn)TjgFB|iPGDeHA_
z=lsj*Lhsk*tHx=$tkl^%hcZ0_>SpcFPW_z4fgS%zK&vhNjRx@Tz!Hj+Snwp3|KbKZ
zwRZZK3;U^@6!b2Got;6N3;f;Lr2m9K{@c##0mG>rs`nG~ii)WlXgS71lQm9TzkFo<
zVIW&xYJg{EC03eEpe9+gq5{e>)AA_yT66&_t$urw6`NaJ|5|$c*B0L-Q3ld^t61{&
zJ+a|1cWKE~VGb@qk;9%@;z?5L!9z_$fPuW!;N$B<Ci~$zALqh*fCk=w<{BhCFziO&
ziz|{vNZgaXc@6IQQ1goMhMxvF6nmQJPneRa8~6_W<+swVw%J~%cf!{{NZrhB_>(vw
zw1};l2mNVzPpx@7LF73>dW`-z>B6U+R#ideg^y)-g6k@0H=na|*H#w(kUhw)*p=lH
z+{^t?M+szH(suR0Ps=vALpc1a@dtMR)H=!83}V^w74TsaM|c^b>teU~0<>ihqP51E
zEe{nEYY7#p5vOUIGWG&yHgsmzDhR!ZTaUc^P03A}1KdE}3I}2r*L~ybs7G=4>1nRQ
zxyIAdx>__}=~;C@X{<+X@lm<?3(D?Np%J|A0KE+981N0wYVCylKW!RG*w((oOj6bn
z@6bzdgq+mZh}Z1s#StYdO&V6aQ9Qv0dKGL)vSKWW*N?x(>G<<E9Y3>rEak;v0?MCH
zg-z*Qfp^ZwP)vO)9;+Xrcyp&N^;_jVd-=;sHI<y=Pgm}_Y=Z*e|Mqr`5+DS3V!5gB
z-%43Ltf!CY;$^*$fd{2MnG*4X*Vv0E@6~86TY1NXji;B@s@$k0%YM~ylMOUvij-CE
z%mcZfSgyZr<Ofsh6RBEsAV2e;`;aw@ibpXINxk3d9hcBXav;eV7Bq4AyIWfdtv@&B
z`l3o~rXwL9yHjR5_(P%jJLJ#=<RW#MiKSx=I(@)({H3}3t(}LNV7kv+fQ<4f+K~-C
zK!4J`>As7^^ZdNT{`JST)MJN3VPO(6FgO@)B!xzj4gU24h<H9px^;xA7@oKb-Ce|j
zet&2Qkak-`7-d@`dCXdX_0D82)M2i-mD*t#iMxpfzVu$M$zhtg!$!#OwkiQ`{s1J|
zrfc4ZxJvbPt2VZ(r;&3caL_|egFN$v+!(?It$2%(uLIFQMZgt*9^Bnt%kC#BD(R=f
zMXLkCA42v_BHC!=4Hb(1oQxz<O(i8#xz=QS)OU=_I-LE$kdtzuCRv6>`(F(S0%sX-
z9P-hSpLqtd(<XnU_Cd470vg*8ItNAyABGk>z7xWLw&Q5T2YRW<)L7??+rk!8PBnyl
z;h>A$PLtO_55Rc-9ZW4Hyp&yJt%duL*n`<GgL3v2%YW<%!jjVV-oSYVjB$Arl!iCF
z#Cyk?+we(_JUeTAX8S=THPoTPC&RFvWedP^Y|bPA<OF<_IWXj6_)T01xIp7_4XEK!
zQ1_ih?aQ}$K*T-}?)~e$qreq-b>d^hg?8pp5iPc<r#IB@o6K9BVgFQo@?d;a^0v4z
z(?n|)V`6B0r^~gy6ST)piM<+#idOb6cBhASTz?Ae|6g>hukYJ$^uVKlAEwph?IRkf
zFAx#>Omx8QD#jZ-zPP|rXETgcp%(K}IZGpCUqFYZ&?&Jt2<1<^(E$|QC@m*6dJ0Av
z!-z~CK_+86n925*Anpl#@`k+T{Xc9E${<(5pR_S<Vb}_KT^M)=M@Di&aAw*K&5DQ~
zyy$>$`zXscUryf(@&$W8m<sXCP;rjaY;su3RViv+<vUrB#?gwg59BTEJ8!XbS3c7!
zv%HKB^EjBR7Ckf1g-mL$i@xwS<0%P>sw%)2cJ@>)_sZ}Skc4bLg>;DSX6F=btcn`{
zpc8WWH~+x(S7;A~3n`Gk<^r+I*)+WZK{|6h82x)uS<UQw-xsFa$g>oNhT>ubPynh#
zW_W7Kff!&w`M}b{dwRW|$|`(iqG5<k(bWIBt6eb|dy+aGyZjuaY4xk{@prJg=0i6D
ziOeSdg;q!k4V|_-P`W%TE6;cr6n<j7!Hg(=KJ=BXz7_wGbcee6vYzcs9tj*d%Cxq+
z+v@MG_3~52{snAp4^TQ5n6J5Z7adCikx;iV;cAuQ%NieIKG3hp9x%<!p67&Y?yR#}
z_E5J<QD+oCvdJ8~1RiN_Wgi$@(H^pz?Mw!I|J?<`&i~6y!v_O>acviXvRk2f6P@2M
z*IAuiJrQ%(7c{BKe~e=6KK-Pn?^i1sU);#51@XcIIvaSsXW4+N6d|gJgyt1U#^UzZ
znKUys#0Ywno8<jgSnlgI&Sd!l6ApS&4%onXfU;K@ACLd+IjM-xZ~*{lDnyno_f6~|
zF!jt=77trDvv{J51$GWe@Q66~tJ{a$G{SV2m%V*7Ym4v03#0e_1lU@%YDBdA{x<IC
zV;}^q{t*I{B4nwoUF_iN>_C2MhsXn3Zx)S$@6coenFR{`kQ^A=g@(FFcEZOlfNlbz
zwT!$cHiSf~+w6wZCCmA2I79Np*DXF8x3oT%WvlY<DHC5ScB9bx1?=ps+F$$E7k>^B
z<&?8PE)CEkQLz^MJ9+qXxdaet`!%DUP1Zht_}6QjkAM%#S#?~X4SUf|A~nR$Uksg{
z+5Kk14BZ?^$!%UzR={_(FQOC7;Ys{|(h^%h4^bBs=duEykA2(Qhqte-%kB8{f<7b0
zWrS(cGfUJxe|)s`yx{3tnQuIp@vm-TTVtooI`P2qmdD!)%<XPz%9#7%qJkZ6UW0Gt
zEtbcs40qONAwyYw1a^>Wr<QWY7aMYtsfVlX>sdZrFA3|c82LfUs8nIgm4n`g?0XG6
zt5&MuGzqKidMSq|kD@EyGxvWETLVKE1MFqAj$<eBafQrN(6sq8;T6vaNHMnZg)M5g
zKNN1DfxGWc&|0XUW-NxLB{UP{SCrGwnkfM3;pa_KmW|)?q7jF=6^#0U@9wX~Su_$_
z80J{}$lO)-hb@$K0@6@+%4*bgvv88Ppiv}S80uimxxQ61Hb15An~7Ztb#mS}tf~xh
z_2Nmf!yw66YT(%kubW&<h+C{5KFL)}=xhfO6rlA%G2`qeZ})j=X2RY?DPpDu?BJa3
z>PH7jgmlSU(->{2sF($X+tLQRcP+$e82PxHF@`TrxNh@Z0!JV=Kyhdj8et!#`-(8(
zus9|1YD|0$6m89}f+a7KFy{!k(;c+!LxkVd1`Bi!l9O;?qQz8s(F~;bqNr~8&=_|(
z0Ws|R<FzMWrM6`xjUFKUgfIw^>(}Ppz<m$7rn;>s(w4;Df$stHHULow0Y0C4!&{i~
zif2=^+fio^ra;sEYa<59_<-SV<P7~gsAXjNN{1i5qWubut9AiKf_YQ)WOJD2ClXok
zgnP}|!=Uj+;jOW^MNcy@PCR=D(xG?I*@g;joEV(pNY%;HSKv1qqZrK_A#kO4{{DVl
zWzgf-j`H<U>Q5w@9*qwrKHe@Ba}3m8N55c^x4mAAhI#}6Y^C4bRFWAd<J|WJ#$|%q
z+8zq`!7zv)XZf~T6fZD=FlO<ERZPfimO`Tu-nt(ZDcM$r?z$dTfE$e3ot9GM<4v2c
zilQxl*7z>%%i(#dcPr%RWDpjE1&x7Jd~Ge!0{OF^%swcfAKkbB8)UL+jpV^uY3L@n
zj;*g~fL^j}sW{9QjM22Dl(X9fw)KH&?|eXb4X3*<D9g+PP#IJ(F63VxM8f9_3mR|a
zvi}Xi?cCEh{-aQ`FeHZFT3L7=>-^`Q&2rWGAu-RNVdKz{+39nazeIJ1!GaRY)s;o(
zKPt&{f)PNQu5Z4uLX_a86+{m9qU<v<VRk@|@ihtyZ!WQYVVuqTvW?Brw<WJ7i$f-d
z*h1M+&hYNN_&rr%mm=e3uo-GU^tdw@pZxUYm%1-3Zd1C1z8O@(Exupxjj$9zO3ws6
zk``zNc?#5+`#T588lbh_TI)yJ3Pz<hRMqZLGyU2Cwly>6KExjv=SoV>m!1L#yKD4I
zN)$aK6bdM@v*Z2_*Sj4~9VRd<;cZc&{fz~Wop-_RbIpC51IH0vp<ZOJuJq;$!Y^mM
z<gBb)$)eC}tYTSe{*`v=1{Kbp@yHI@Pb|4QGY0WT(JC#7sn}hWrRP+KsVYBwgwIR6
zHxO@4IazU~^<gw4kJM2WyN3y!@DV2;XP(9D(~G$0kLiegXiqD=lE#QpzWp@8x5*Qz
ztWAqX=_zC^Qa7EFeg?k+rpSvTB7SkqOIfZ2g^{3(%8<6Zo+?&2Sq(A2&DcwA0_%+j
zy}9Hltp*v*14IDK#OB=E@m%w7kJsAdp{7v0)+IPbzleysJMP~$op(=UTxKB_L?#mr
z{6R)tVKUfPb8dsCYrxnsH~5R`)w!cEm99gpj+ij&#EUvrEy(ci9`?IeK{7{+-`961
z0Cxo|QIdVgj2~$WJ1bq$Q2Ji(kEpt-yt@1TPN@}kE39IG{{3N>t;+W?qH$!SG4Oa^
zCISq01b2cMa~0s8rTujrInlNVvNY2gl%FS%)(a2Pf#amer3<J~szO_yZ9u{d!mhd#
zxdBT_%QuhHt$%tlqnxy&n!p@d!(|%50`-y_&xiD(H4v|9q^U(e^)^Y8X4<|v$Mqn#
zlC2<ebHi@bS5)s^%PEhqbt)tCU`(Z2<@-MqGBR|Hw8>zv@YXh+V%1mSrkl3p;{vl-
z5|s<E4AOGrj@y^iGcQA4Q%%8JvS2pj26FNs;Wwn1C0Aa=OJr-6^+Kl9^r;fl==N~V
zn)SK9oRm&Vb^qoxn+*VcLxg-`&*>Ra4UAw-4}GR{F0lfvR>02%TF>o?U)BQ3bf86T
zQ+X7KUYoeQ3>BSvN|9Ni>-%zX&&H##?gxb$?zBxdS3;{?RsFYBc2-afntxTO2i*ey
zgc@jZ$*YCi(Cj*d#n1}s<V&WNr%Ph0;KIP^xXgozg3r*P#mRS@*Z49V<hXN%iJhuv
zlK4Bl#K{+_*l@~oQAd*?8Cs+fd#DjM!}(V8H1A0MeL}B$`7z5@T$tvET!NG&qc<nP
z#CIVTMTW$HjThm<LD;Nkq7ma%HOTcL$PHkN8R~calb)JId@Ypkr)}sg(4=09`q|JO
z$5_3}y*NuKv)vRK1h0>1*mwGuLX7kle-zUUExB@)$MVrxIsc%>H}0WdpYaYJ=EjxD
zs_v#M-!&1Ft=hG~V(eYMJ-P6*e#D#5z>MNBV*};Z=oaNdbGytFT43k0-+~Ok;Ef&;
zpm|X`Zd)Mp0=)HL3e3Inf`R->_2V}mJc{_%gjNV=wr>K5<SKk8V;xLu@+L|KaY3Vu
zEkuGdbli{v3-DzR(O?%P#DVBA3|HYj!~6fdHU%KjLe%y!a2FebZc4hnn&rXbA>Z4&
z!FQD9maRxO8zo(#B7MO}xTa2=&I*Y>+V+=NxumsgPG#Y_d@)FhzN}>{1Vfk8&E2R#
zoxJyf^4_(@QjnQ{_TOlMd;&xZQb{Mnt1tWwV3|PdVbgGMPr1N<3^<wc6@q~af!pqn
za#^3ur>LW(97b`kR{WzLb6q>sI>dg3T89h3A6<}eGyDD_uGnkp!`A9>oyi*;y}KzK
zrgvi-D!g|{X9G!?{+=gLx7XZ0WY`=&17$Cr`OvD$Tza{l3oBM!i{FpKg)#gtv?s0A
zUYA;d<fM%htO_ChSFrvt;x(4!qEel_y6?1e{UIBNtI0+4=Sr(Rr`AT+kx5bo8I>Pp
z-gF~`S5Oq>_lBG(n8=5Sboti5@nZMv2R+d#^<^uOrO=@L-PSkm6TW(FAArT>==eWC
zNaNmxj2R#9a@E)>$F=>96Czc&z-qtbA8+#ZoX&x1o7jO1zOHhRK3MoAk=X9Cf7kO-
zPQChm(LODQ7%h=2MYk}Xj4Bm6<l`mU$Ygdy#;JRTmlir@*?FMRaUcm|Xe=*62`uI;
zl5r91j2kdoIJc4Wb=7~iKR2-i*rnw%RkN8TAADgMhuG*+gjT7o^n>3?HWv?D%jg_r
z*X&+>lnVJS70?LA>V$<s`53J)%eXO`@XyVd^p~kY=hUKKp~(A}&hF45-6ID8b?>X=
z%FC`Y2P+{jh{oSjO8F?q;RdLX;mnVtx!Hg1YypZVZJ>$hn4fqD>v60ECY)AEqiA5+
zxtl8jXdZqE(AZugUPdF(kZXH`C2>HAfFhd$hB539K0-6uTZ0B+TFjCUIWT|wUnuq@
zG&FApl>e<8VOz4^;;K;M(Gb?JtL(^{xT|w!l^hO@$el&j^_3?tPE0|kxD;Uflgl~q
zT{~LpgI=0kniI%mu4&-98@hbs{`V}XSi<AWS-@+2ept~Y{l*QK*tD9Y#uy&(IxfH9
zcHOZBM#!ii?|>!{lwsa*$iX)LGI`_4*Mll>Era@ZG(!s2{`0HgUi?810CBeNWiH%A
zAlsjrsn^7-`Tea&kc4A?*^~^ex_CBjvQXz&kli_`qC+Plh>T~p@D6N0XifB<)$hse
zD6)f;&5OE*$ppVyF{_5`;}^$eYDTsX=ksd3^LQ>FA}p{I`5}S0$+?#uNx&ODwKJDf
zOf`JnB}H&(ZMxlRP#kf)1@wJpzkc8bm0G(^M!10zF7qZ1Oy(FubDf`YY8@A0*L8F3
zR~w_N;9P>RahYf&V=$XmX}5o~SC0ZHk+G~Oia^$&bQLxzZ9Nm&_(<rfUG5wKjnmNB
z_uq>6_I>8=VRU)tAh~bcjEJ&V-KCm#<$89=8*Q%3w=qQ@TV#A;gs6b#p}N3wLaHWT
zFiF(a-zFg}+fu16Ey;8)sa72HD)aEFhrl!k@~y$t7_z`yml9^pEYNz99J+7FG!V_4
z!1KO138WJQpdv^Tud%=H(xLywu>k5RxC{T?>u|&@Vo*vP|HP!n{|q^gUjqb%_H_1&
zAtQ%diIy=mp&!9#rG00-(cvo|)cVR`m!P?!b|*?P+5Mn7(TLP(t53U8VP=@C^DX~W
z21)EQ&?<xm8o|&DJs6z4k9dVI)iJn7xzIH$b33EE6U<Qbf7EA*efBS)66z`-AaufS
zwt_H2kXf}+dC`r_*qN%6!1d*_kz@?FJtQ&{pn3j$P+0uG{M);d1eKi~VK&oqt~GsF
zPYsYdr$#jZDMRfWwpKPi7D?=u`Hy^WS}v7@+kyr|qXrcM4PI{Xkq4%WT-cYZ=TVmh
zd?R`NE;D1U+n#e-u|MtwG`qEsM#i!eQU+cfWe8xRzpz9t`uj{IQOir=J`#8xC+YD*
zN#Xj>S&=IK-@#CosT+Q1G?G#FQ$N~ya8wGm0lful$pgH&fg2dcQ=vJcjMK?JjNh8b
zPQ`y9&|fJp|Af~ciG?IddM%wGQ`wPm=A*gO`+v#<M3`^%<{y};jac^f5A~l6at~dx
zA`k6oe6Raa<H&JX=*S9K@}aAF9py>c3pG-YYB{Uuc>nU5Wh+Nj^?5({{F%b_c7cD2
zU#I(ZfBqV1GpINfxU4DmTYVF6%aa~Ro|$%}Xf&33VM{D=<T;s)ZLtSO7n*6cyG9Cq
zdVKx6MnBRGPi++&dZvq>+?OjvaS4_DlPMeLThj+?*Px-<Lf`MW(G{zrJ-7vKtN2E|
z<GwtX;LUf@$pXg)Qu>ZV$^3W<_i*uSA3j|^xf^xaNGEYjN9Q*cYWSZkoAe9)zjH8m
z<BX(#!g~KW)PzrEI`@Z@^w5rlAoh;t7CCAR5b8{%G)x4EknRQ?x2D8L7O9|=$e4gt
zZ1#SU%+?KzN!5pMNdN;2_aSwhiU~~9_1Yfm%Jysh-~~lRDQ3cpW4(sK&?_}St}Js}
zZDeYFaGvIxvm0^^#`9_zXL`9+GYTIIr0}U@*D`^H&6f!v#aWyKZ%Bcroqzzi84g~j
z@mTO#{w1tLK#IF*Y+;ecuBPua@NzYOU9P?)M|G>Y4SIhV^!A#=x0nIl<3lQCvAbEW
z1IWCPQ^Klf#e`m`axxkRM!W{Gy;C{=I@(tWh61^aqLJQ8(WN8AcB{~EUqQEFMOFAB
z(4+uJ3nC439?7Ye_tdvlQ(U*Xb>w1jyoYi<(%W&uwSiiok1>rM&8Z%oHyi%4mZ)O^
zqRL{o)9wDgT$xXvK;_}HvG_E%b?056x%aqmMn3vU`Jar;mI9Nm7Na;<)y|iU@!-7^
zg4{s2ID9*qvKx5)S(Fa&_fCOk(7mB&(zAY~Od9b9;N3jFj|DQylg}xo4Fh*2@9f=k
zY>l<pZS>o#spVdr+D?;X&_rRB@H=MAp;`yHHV^c!q5<&QE2Vpw?(xyly+sGZ-`_t#
zulLHJNF|y0JL6}-8(TLEz1s-N*TBr*TDPIu_C%`>f)LzBZ3SAL44B73)6fgwE~de?
zosyLTONWUsF}+*+e@J`pXgJrdfBYmNO{A#NQUt*$iQc6lMi-1O5~7pQyM#!hCm6j%
z55tV;btXg!f*?9W^e#H1eXpByp7(j)?|Oglcdg%FXB}(BnCss6zV_aqvc0Lh4O?Xz
zr2wr?C==lPsy#~pweFuU1#OhF^_(%bh2*hp<<C?*?PKUp`;uv4@-crcGdjiz{1lAd
zw$S+{ImuY0!PMiC8E}M-&N?C#hc9Xr`s1G;z4fPW6_Ad>H^_=aUYE5B4fb`j!UZ5e
z0&>@5Bm7O?!r1o#+J-`sK3a2q>nVl8v^Wq+*c?KxMNn@v>j_^Exh7eW^Yn>jzKEaR
zni#|`InPj>51pdss&>MrWdbCk6Ed!HoK+XMrb1?j%*JXVS#x}X!eE}WgfGwKS`<&d
z87sd5KbW{JeHV<|^`2BA@Fx$katQ|^Esz56#eXRPX9s%rM}h3L1nunWaLLMnet}!K
zcdSec4**%U{oVgm046NGYrXdME=D5A64C+oN&j~pAYv$c)=t+3!gj=0)TTwo`%Pbl
zckmR=Fhm`L^*s;!7p9MSBeSe8n7~gVX6<hfm<ON!r@$Np=&t8S&Xx2>;mw54PD?}m
zLxAQu_3G3`b2wEtV>tX~B1q0cCo)*jp&Xig^WdJk14OLPx@ZsPAP>L6N18V;3r+z%
z%cf0io=eYA{@ehBU9Qh{x9o&cAYLB+zT}gCuF>~>dcYenfS*E;-_zf;WDGc=Yv9<W
zBrHfi&x!ed0D!XCC(5E3@{#bgGKy}zzq(n0no@5Q<UJQEzSQ?aGjR8)l~l0|+}&B5
zjt2!wd7MK0z9i3~Y;ox}v0D&}Vt~f^T@p^xA8aTdQ9lIAvUf)<6?n}OtToL>HnrmN
zwH)OIIwf;{b~0lgZD1F+AqE@ZMA#+y9Jo0^EH;m2=Ruq4g~~f;(rfU#HksW~6s;S%
zu>uz1)QA5i4otR#W-y0&D#=o^8D0A2fd6r|q(%x*yaPI<FB~Or(O{Q?!N#NXZPxqb
zhXnX3G#~}Hv9ag<<biXeBLj4qI~TTvTM11|Lq`>;@YUE{{cQV0P?}UurAH_ipr3Gh
zA&t10BjJ2GLq8%po>+(LC_QL}GzSsb4BbBp6HCLDgI>x5rFP4XX4!&eLH<djqsD+6
zvEzTYO3Q=nc@-p-u)x$==9j;R9jQZF?Yy6Z6kf$<EHe#{C{suKOt;3H$p{Mu_`u7S
z^1oeVHPEa&|Cn{1<z88l?!I17wV2j!KroYdkFw4d>AAd&O&N8%G6kOUy7Nkwx?Y(+
z(R!^~p|4duU^}d32&MdF!0w|tq*?gcTwBZepgyblK7`;oo$LDP<+Zyt9wuFa4uSkj
zr#-;{R`+$023_-~eD*7{4}!GxD~fa%o#<eF0Ke6+XG8=X#r04ha`xY~ILBrDV}-YW
z0Y`{JtlA$e?`nvo?Qxn&qeW&k7yr|73@UiQA2Xiw?qHD656DS*_--IQ;?ZRrXC|&h
z3MzWX1e|Rz?YGIex)>nB{-F<=yAp-sgN(K(3NLA~-#Mgwt^$UXx3O(yaUXgOCW_|m
zDc-u5z5fuHy>a@pt&9R!#+{yPk`|!b-LT8|RPQsfx^peEE)mf0_jRSL(e-%wL9|Hc
z>CuX%G|a0%7Ivb^GxQxeh6>pU@jUyV-VZFL>QUf`^AXG?&DV4OO-hIZy4D^-8fSpN
zzsGY`{a+5VwPd`GoGyr<>f-HJCXU?eA|;G}*9gx6!2VxO9Y^z(|Di@8m*pLU`&;cm
z=2641^v|&hE>@<9t)t?Ip>+HW&Kw7Phk$k>DCxeQACQ}TxHnzm*cS$--+|Lld=I1X
zdl`~!@G(C4OPE`Q?XcKx#{Q{G5>KbIG{xbWlE73HxQ&T!;x#G3TTVMw!cb4BbrS}@
zV-a-&36=TM@3rXmfp3(MS(01kqLz|=hb78qx74Q)9dSNBQ9-c-DTWma+2qF5O^yIz
zCiu-iqZ*zhXjp<dmM~}#1$nF2!#gawm?*ijHCr3i_86k8AzT9L<QHFTavt7(of2L>
z@Fd#^?_FZ8rI8FI(Fwf1rs-7E6<M?1nKYBvx))wk8D9!7+e5pN2p2}bTnDtQM}(?s
zU9S0MAPKOxib1jKcHg=yyOP`KO@SyGuteX<9FS65Aop55&m=F~c>kjV)iDv2L7e8e
z2zdT4F}~3_g+<flulS~yn}X*LHe_&L8e5?TfbgQ6Yg3=Y=Ps;Y3ING^e+vt{A*c`%
z7IHjEFs}k0u-4o@f++PkA)B~<_xU_n5^u~Wa@hA@ak;-Thji6$-MptHFTfhEiBmMS
z*C5L0#g$PA<L{K>Ve@4FZ~=yOd0qs_LHZRY+4uqlM#?igO1l%E!2|I<Q1@YFW-Z$X
z4uS@hU7rIs)i>q72=g2^_W*V0ug^o#W7<YLR;L!=+~05K-iU~Dy-4X(BX$2KM{_Y6
zD8cMFJe-u~ahZ>*w8kN0(yGk?t0_SKEE)C!aAAGn)b%5UqQUdJEFTEy(mS~TfUfi0
zo0S8IA?d*C;?V5z{~zZE2f_eahe+&#Un3*3?uxS${O0f6L!-x?@01>JBJ)V_&82Us
zUB}?ER+IHIv<4<E2cWuY@B|(L%778NS3BfvRUSh&7T7%gnNiQUaO2Ymc!Lkuqz|9_
z)1xAv(3L+uDZ&kSQ3vGXVPjGd?ZII76HSJO7S$n5-)$SaJGQ4UU9-+qNw&q_ijHFQ
zC=LtOa<&jmZoZbI_}lm$(~Fkr3^0BAhOg<?rnrWwT7_5Ysyyoio%;eoUN<j&zo3Xy
z9(^82Zx_cpUwC;Dw*X080GP>DxdEWR_0R8bd3FX`DUa@o1y-vya7ev1ab%<tJp)z~
zd?0~d@;VetRXqOgvFU@+_!Mu!o_4U${!0~0jlFoPS<jG&zguOWTc7OtP`Y<4t~&di
zWgRIRm;|%M11*kE>|^j1_<KvVOyFVw#n6DbESeiMi;--v?@v2XAHA<ajL`d9d?*L`
zP1cH(r4$C0rA{nBBAPA2xu{BTRZv9xeA~X&C+G3(bFiwhPbeh7jf!*VpO6gn@#;hG
zYe5x2{0D?v_CFN>wN5$;wo$P4rSV#!$H$p#SxN+8pkSq2Vm)hcq`;nSsNNiC`CODz
z_s%{qKL?_9I&9`${6p7XqZviop>0ZjI4*tg4b!6s2*=!)vNb(*>m6#(-R`^UOno-K
z`sE|`U7B;&9rr;Ls!lM1wF&nqNWeJs3L^ZE?Lh-jv8oZUV}C-i$nhBQ>Cei49cr0H
zPF~v<ZXqZv53NB{pHdx+9||_fTW8u5CCK{d8%7{I^3kP0a^f>>Rwvw6^|EFaC5dpo
zRwGLt%AV5x_^_gM!h-r`^f`nZK_!RW5e}C2_3~|UJ9p7|)0O?&E#<?C1_wcp;(~{@
zeq%DMhef<Wx~lI#JBJnx>=Hbd`_<pV%V0H_&R0MM@0W;KMghp(;U)hrIDhp?h${-y
zDx!^8stKGN9nqv%{`v5dlan0_l9k89Z%eTC5V$Z40kLPk$3v7=qL@<wD|4me?3gwB
z;`=qC6XeEC#!Y;COuBxzp(?ZshLw<X+&w_&-QVJ8Fayq&o<T62*wbUc7hMnW=~_w|
zn9d3_+PLo&&VAGg`+cbclo?DeJ4`8X{_srwhtV7wRQD0NPsNAWRlxtVnLh7E2kn@D
zrn&?tB~3{^-4F&?9PIdi0c>lsaWIs;X;iLqM--a`>aUVmKGQ%4`3#Z$dHVKAu3ydP
z@~k8NO~?3EgPsSj;8#r%!c#s$!4C#~usc*_=R%k<B*L!I*rI3SkOMMI$TtJ;Xw(yU
zF|Vrg?Up4cWoEZLpb5uE!~@0Z$$n^1I1M|Y`rrVfTjMK%!lRx!kMl{nASxp=KV6IS
zbS*toR<&`X2A*H9YNj(0cloT$)ASwX&)$x{ugG5Kwe@#ph<n}qKzFiI->CfAqlCBH
z5L{uKupoi}j>?C%*<a3SpkH?N^$2G=QE07SNoh8|&5=K`gZo%Ie-@chTYbwG`KgRc
zeT8<k{s|B<Bdnh-`_mel6Dh~wlkr}XhL)gK@c3#uawBg~7pOcW)qXuH3JvMPBLiTN
z`!}@&;Aae9h=l*x0Ju`rd)UIrIGm4sv)PU!EK)!Eh7e#*yvP`$m(f={cPCH(;|zCl
zj!B{x&@<k22krzvz`$@JiOW)V<K~qdg6UFo{Rb-v+Rd2G9hOaKlqzf5hQS}W7lIZ-
zxNsM$<$<%KFz60TnGE;Wx$HycL02)U`#>L=A~TW?4Bu*xSm|}tKxorS0qo?s+=9xZ
zm_JOjSP+<*?c{&UZrR<}=IDz}{~A8MD@(xK0(NTk)Z`gTZy>rGOTuS)i4NM|H7qD!
zRii6m^n%Tsy@)P|DY}S#G<~;`k&<{oYsS|i=tf&ALftSUvdA3_smDBLr6{z3S$M~~
zj3>8Iwbh&BxM8n4AkJ^L9M%fz?`7b%?#;}fwRyEfe7RwR-DLQfpL#5D)Vs)47X2Yc
z01Q-Fn`!^Hgt*j=V{sXFiZ<xKQUdNXRs9Z6R(FWx{{r9<?4tY6K5BT}2F>9BM<$R@
za6R7utdRfDGZ-a`UkvPL{ZN|z(pgf|YpT8${`-A8NtDEh@TxNtkP4Muo4<LH{cDj<
zKF?}x(uDz^2d3H@?S>f^8tq1=+P~I|{~Yf69JWVgskL+_!8S$_i<>%O6HH@p!MTh>
z44-S@+Jo|3U4QBjiY%XT3Itr|5a4P3R)~z$U#SC2T?D`si3P^l{gZ|Nv(%CIDsWby
zK|tE>t?umglkB@iMlo7<_s3}Q`78T=*Y~~#Ri~Wcra;&dUtEuVI7{}rfW**Z1%JKi
z^Wut<g<8S2ZQo}%SM)E{dbjT+r|Aj+KRw7JW>X=)V_pf2yBc@ACu_g=mhm{G+ijk`
zjObsZ<5xcOS{<h4yBoyDnxF0`%UAe)ZT~zn<3X?_aV9NOF6>%~93#U3?c4CLtAM95
zh~j{pfJ9GuEqZsz(8fXztr%+vm9W7BL!gZ@#B7ObSP&hueqVME!t<<T16+#1_@j3S
z^pBZfRIzlMjPXjA&pZdlyqV(my6GV>-_9ikG8Q2q@CPnXMdw<-MpswJWs^j1PN*^)
zWTeW5GV1WHB$**iff3LY;56O^U~jQht9pOKXcBAyCOg&-^pG^ye4nZJJ@>7-W+w3t
z_x>_MU$vw6$Q}Tggh%l8bszV3KV=mA!B3A{ZT&ORbpx7s+8(Tt-H0C|PuFydMWYMn
z#hHh;WD;L2dZP3kGPo)^?+Z8>Q}-?DMP$xQb7R!sBxRe#+$&dqDy8to^s3oR_VkXo
zf0_DCMPK=cULE59NE<KYj%IG;=;5JN4ZzDON@5C_Q3&97TJ3%Swx>0PuKW)$g^z(;
zZW0_j<u^@PV*b+d)kPZ?ML+DLF?(6bmNwstrSb#sS;BQBt923G6S&B)gA4G9B|yFU
zt)h`>mT=${GR+?018nAhV7)hBmC63gCPhKjHTy}9ycNKwrxg&N^eFBp)uWzef<d(J
zR`IP+k=mINz`8_VopP6*^)Je2ZrPBtP3Xn8Y&_;0@Td7-%nCh27<#TFH@oCaID>Nc
z-V-h<2zqh31Lx@eY7RY6DoA*)G#X--6WdN@uD_C~*Mu8<E#i~?6!%JfahZ-^ShK73
zIKbHF6oUUtxF{tfn%UW%56q<aLD^jhFh$66ORo#>+U^H$Y@{3FY0_!sI3L8`NU|8#
z1!|uwh}vN+9xy2!fR3%do8CX#da>&+Kq|Am*gNUlf3piLQ&)L!(Dq&@1vXVJ8w|la
z?9Q~IO@Y<^JC;v8>M`Db!GW;xmSD?RGiY;d@mv~YyPggKDe6c{Gl|MN*8fefc+|St
zYWvi6^J<G}PhW@<>CLg7<SsIL{@V_SHH$?Ti@JV*H43u=q$s#Fm|cZP8HTKiH(TUW
zxwI+hXY`ROaz7-gJ%8JH*Yx|khN58m7OW0+{^nK1;D0yA#$GL|QP<A-ou%Yc3R;}+
zuQ4Hu9>8lE?|Dftj!Q&4p=L2od##2S+~SN^5IOIbAx1J@KTZVs4Cr6BdvO<umK+$G
zEFXh$(Li$D#7u0l#_2oFVJD3?r_}U2a_*scRl9J^oX9`b%U;;jLGYJSR;mQREwi}+
zLIiD7NO@Qv?IT$8>4Vqk>odB)4L#;HEbn`4Jk<5bH!n8rqdB^wfr-oi+idH7TC!He
zj7#mO`+f_vVlGS8h%zgq2H$<6!RM`Jh)cS37rmvxlxBI_c<}ncpEJ9m2A3^T_d?H$
zYYps9-o$h+otla!KZ)@TusXC>{UhEYF@gnh`?@6DGbsQqE=F%z8VkX+jxg5)-P367
zHrXOH#$b4ahuR>(_9`*jLBL<kPRdL(h&$&>)&ruFH7QN>@e4OTMcc4+e6gv=R%zuv
ze)OwY-5iK(vqLt(ew24ey%{Mau~#q&5<Ti&lxHo3aFMP1z{Xp%zWhuJ2~k<LvJa-W
zQLG)a30(ozCcoCx<QWouro~6T97+Kpv9)MXeruMG--FF-9t*}`xS~-UnYc+a*Oe6(
z5|H0WqO)C8s?DzE)(iv{{-M*Bro0M?>_B+b5J~(P?0j_1fucEJI{#Yp3+W?pAVG=u
z?tK2gz=5|La*X@yHCgb}R!)JdSDVeKv>u#kH{z;&v;SD5Q4&a2N-iuyY<25q3~X#X
zUzmLQ`$PSV*ZdCOg<gMtApdK;Knd+#*nae$!u9`QXl{1CZF`cb$PurKa^-WJQ3b~P
zyPJ!xfM#tM`HHg$+EDW4K@;F*Ec)cI^;7}Q_a^$X&1G6vWY*oW3%1b{)-_XL(p64c
zXJKb70h+{#AgkZ-dodDj1;b}0;WopTQlVXV%nG9-ZXU*MvyB5|9*qS1I|rIQD)D#c
z2$xHCii8&!8BE(zm!!7866~&n6%1Cyh5o`tT8BxvAIGL0u)yQD{KY=#19%}?CYAtM
z&~`LjZm%EnDxQuHKHpGi=kf5NtUmI-jL{irz75vbDK|ew93SF++PkLUr_g-c?2N;6
zFRTNda1(B0&&H@~ETfO74s|#@5(!L|1#YXN@2StPY>ywF-F837tU2=@rdf5FN+icC
zF@=vW=e90KhY;ZJ#^*mluanBHSiS<Y(0FKOC2Gucl+{h25AEd`2p|Xau96`$BsRu$
z%Le*XPd<};L*2@J)Q+f1bn9!ZDx#g5`*XT40Otz}-8M|Oq;8WI&_4zisCb|ato-r9
zfo1AkQIGFcPDbhF<{RXYJ~v8Dh5K#Hbll<+8f-81@q^j15Fv*)Xg3L~%~?W=DOL-)
z0j9n2)jX#n{+DQSNLWS~+l1^^x0w#56KN0`XP;awRo4uwt=hPV10y9!92o=T9$yd4
zCJom0<^fgvj>FWCFNfp+n`h0|HcMEz{9fT|z`R8NO+<1m(fy#Ok-oH$8Kdz#<DHkP
z!0gWyzj9C`E}s5cQ;`aXQwyzPG!R81_nn~90%#Yq`Yo^8e9pxlqCRUq30Dc=ie42X
zEd;UDYf?0ISr~8m8}tYMUoIoyPon#7yjGoz_*K*xsO4PlS#H#tT<;Usg;yKXk!CKc
zxZnGk;>Quved=nF&Rwh~k8a0}-}jZ|Xa2^xYnn`e^;fKQ+Iv{R256%T$F^1{Tk>Wp
z6pEr%Ut+mYj(`z#ChvWj@wd~1Du+Iu>GGN_bs5}Ac;XyP52wz$_iKHj6DQB<M8oB_
z1wi^iR6HpU=b04Z0AL>5#9X$RgRYeeivO=SZ1HALLGm2PTm%iF+@W_F^&T2IKk~KS
z&7ZnGiCAZVLuZ`Pb9HLFf%$Uj4T`ND`XFZ!EBbv=?SPYG@b_2yfv`kLin`ft_HuV7
z!b^?YNVB!0_JtL^Oc|^I!kvxWO*NRT)lipVsLGbl?_m25DuTk|UC_|j6d@k|w&PS;
zD@@+!s#C-dv$l<fh6ncq132LBkuR2me#?t12sq^>9<nfs1kkBqJJ`ko5A$1HB&=j&
zabG*5H7K-yMShTi?0pXB@U!*OWkvzsH_Yqff)Yuu0e`3QXjy=YFY~ucJcmqrGR4{}
zvgW;^RYOPQ(=CsU=)O!%c?cr7s^3Zk!~F_rBOtTXdc;{&%Rjq20@Q2AM*OA#(b4OO
zSl<`D;P}58iH&>W?Z5Ox^>1#*^1mCVX)I|2DWu0C`L(pLCmWTzqG3;A?_uuKzusl#
zkfdJfO`W=C`Q>g%qma9P#z#>Hxb$oHb2m4{?1%vk{NIi)pa%^f!ZUT{Q?X8D^4(((
z0WZJ`Pm}~3J77^V>Yay>n+>i0%llo??HQR!pq3b9!3ed74vbw`(lvZJHWBT(dJ#D}
zSQixSFBj0x6$mSMaxzG3{<ETy@#F*1T@|oasWSEVJLx@Rsz-ztS^rqav;bIvjx<Rz
zXSQnGC#o|6Jdi*s<M;YuT2awZvXdPiQjM&kZxEvkrU8+qcr5iz9Xq$Ohe5+_y2S@U
zIOAi(4`a#5R_|j~T)g449`Ms6emt&$d_GKfmvm%j1K9z1^*Ojx^L`yCPMz*knrqqL
zd?H9vZ8Yc71uYs9Xw|j9R6G!uInE%7>8y(@H}ShyP5Qw-S(+g-t(6a|YN+4Ed}L2e
zk8gfs5#iQ-TC?jsjaND0Z_T5>R2r`HXJ#LTE^wj~g$>LE{eE~+v<~8EIW7)#m;X>)
z8AYCU$>S9PkTj_nsB@;}^ml}2!5SE*_1B>~)QIzJo}fyfD#h>TL7R#U$}_KDf)^-U
z=$1?Y<K-6so)*xv{vtyqu^A&WUfwfbns6nA9rL~Cu$_>2Pf5)n=-SA|D<7|(S*Q0j
zeCHzg)VA)m2x+ivNZl3kz*iJ%i~+u%m@k^&Q}w%|`dZ{EqZ;%1^OjV1ElH?@YdEev
ze>NfY?olcmr#o^i&r8vVBMw_RuYu^s{2s9yMg@(`<~VqJxF9zAHM7<+j|`gcVVk=u
zb&5V@t_%a_(~!Nf`(zRgoo7-?#N@Ks;vk54ZlL>;LpQQi52`QgT1>gYk-!o5U0{>>
zb?$+;)cJA2Y{}nb*^?J@+0yb>MU&N1dyPqRSNrEYzggmq$2+VmK}su@u)`7xpZo2e
z<Jp<q9pud(;b|31-#<v5)*MJ$;2k+>K`qrepn^;LV!7P1=Ou&8Fz?qFOe$a%9_My`
zKxs6l$8us-G|`-oE-}=hfAg6jostx-c-PTKmiKj-IBM-!J9(QHj}-B7yVe*-js<RZ
zO_y^}A#lOg9c!F<d#2Jmw2v!CKW-kZUQe<2F;dg#cyPLx?qUDMhTzh^b4s28b{|Q;
zPdlbInK+8InGObZn+WXaFDMqq1(!5WKa-2-(3vdk-a&PHcQp$H!Yt&mRmrK-s1Qz%
z*7#SNDd4NR1*v4<O%HIXW#PTK<o(Og-%cKTRn$h-(}BM1!!R4}W{Um54^Et-?6iO}
zAHfFQWWFjo9?)U3b^JBtc?e0!6KKy8v61`%J6(%=NLFr(K$uYHf*|^259!7EeKSFx
zybbhBV~zWlPi5g*iXlIHp-&0<z#{5Sw$iGW&+LfWmc7@~p_e<>V&WJY&LU?}3_Tx*
zNR}%VmV$IPsP-%GT@^w}{&_wY86@?nqI3>S-{ZnwuJa}t`5#f<CU<3Pq^S2r9wS+A
zsFpnCC*=C<3-n5l4JH`%j3{{)UQ3xG%6Z1Gk?q>DrG0~Uw8?$7<css%3{XE9&{dMv
zn{+r}eiY_)^dWoAmUyYV7MY6=FG;fOE|w+_K8iHM{JFPlPLyd!n{!s7FPzkYnVaNE
z>->1l=VOGNhSTu#HAtbj%jxWbn<8qIu8dqb&Dy|oW#sBz{xS~qHVA<l6ZU)2;Lw_;
zPqL^a-qb$&%r9v`e)M<PS(ri^!wfJow{?LA<q$Ym0OrfThWA0In{GFPTdkv1c??WY
zOn~6A0QmmAo8!AwbQqpJ<3`O%XRaakI+up8U;vxT@;DZcWyhGXl2Ojd^@qo=uth$m
z>*rc&eSCvr?(~Y%S)p6;#euvL9dz=qe4V~Q=fI=QtV!Nz$v4269K@s~Yldpqnr6`2
zRf2T^hf%I-_l<Di?Rg(~V)9fdYJ-Y(eo3m?gOee>>;aNBZ|H?|KgD<V6SwB~3xi*D
zg!ye)b6~Vz7@ptd(X;0#P=z<Yq^;|{EbVVVIYRY;+{KvMh%JrW&v4X0Pf0eSom83g
z%9sBP*|$*07G)?zS5&HkbxSbNo+d&jww=J8siN`{533O1j+BGph$$EWUhFmvgi#?L
zu$~V&&-x*{R>qJR>ugW;Z?RB>SMD6XzM|ACzF2)_q^Q0N`k%)5rWwbCmJ(Vhrpx<c
zUmS&6eJER6VY3+kKhgV{D2rsz)c~+hLmzC@TXq&TYh&Cw*uopRYz;UACMTv9xC5Gi
z9V;o73P}Gk_>4)4@lBFdt^DtLK3$K)Q?H-lz^LjYPXdkO<MB0<im(E&7&@#)1uM>B
zEMDZx?8WzXVtb0RS>yU8)gT@s+Uwf{z#oJ5<Z%|DOVpIoOEl716mC_F2k7ehLVwqy
zJy^5J=e(c|ZAe5LxB``p31Cz6IZP=+WgxUbMAC(IA!zJ;Ju1KaLFFFVM6v3}Uhmte
zyQU%+dkUWG<fj(^&l+y%sRXkaJ{Z1%J6H3<q_9r-*6YWg8MIbR`NUFQMR^u#MRZI!
ze4%XrzXO853);ju+lx(>0EJ0GJ&oRXCE;Nfz?hikH24`LmZccW3|W5f>Kz{Jn*u#*
zC!j3-9L|6O#j)V$o!*mfys8t`he$RRx==qV!~yHk+bV+REGXq3i?5EU>%TR|ko97-
zM8>l#;9Nw<tVpyC@A2Qm-};|_4*~=ze^*Wr8<V(m<T*;VvNJ=720U00Sq@%~VTz}K
zfc_d*tC%RJSpf_Sx;3FFsiJt>P)@}TH%?_AHx~+Me#r>Mu)k?d+<xZw(cPBK$$D4*
zm^XKw1GXF9$JQw6)JHeXTwr^6qQc}Tf8TJMyHN9=e+KlPh<5>!E*tRIifD?sUAo{7
zI$NYmzPYi?bysL~wN(n%`ys%1_xE{jD@=JN0s%$F3j8YlwDKo&(ty;E+wcddNs+!d
z@)lp2rWnTREbFFLSBJ=iD;03hTc0Lpxa)-FY65?1Lb-(Lrgl|E$}1?_58V+cw|#mP
zx#bsW67ATZ{{80KTzyYMKf}ZUb={DJXK5+2$B@CcECulXb(KYalPuQ;+J-@qLZTk6
z^y1N{&;IXILt)kfk+UM&HsE1dM@<wNK*?iDK<%M({Px>7%@+J)@m*j27fLieV}mc!
z-H3BLcNDgU#?1!Lj{>*N;MGii^eZTI?X(wrVeEH>dRS{g3Ry_XOKpFuQ)K>eu!2xy
z|MkR~$6!O4=~}CBSd|>~T$pcPvinhVuY>He%ypyc3C=;}9dot0F?c2(Im3AJ?2T7{
zog}6Hd40m7+Bc%ZZ|QnOk8Qt72kFIa`IfWG36eL9J8*7)!t^$aXBXtN7o(XnZoOO|
zveI)Funm&y?9YCGfw4lq1;-Y)t7o}uDpyZ)wPM19`_z!-1NTNRbQ2SLpGG|BDw7*Z
z`644Q$g>ALpR7Xu%}(Y!AkoAMWV=omnsVny?(7DRoj0;R`g6|S_>l8gJxZgzUx(r(
z6(U@fdtZnH6DdV{p7b6vL-n`G9odtnNx6zadw|aK0Z`fb@`k@8`<$aH&R0M8l8%h)
z=-#bGFdToov+11R^3=3-j(P)rD~pB#UMUckq4N5{2~~X#4H3HFkN0A4!@6!9PD>wh
zj1YTDAtj8;bC-oQ7JpO$jdt^%mnJx`xCn8rkyKL!+XgF?#q2`#cILQsG3}TYYjT@+
z-dGDiXJ>#Ns6{q{&mZMH@ZWz+H{h8?E5b_tazj~r`n9|UHuNu6$AWm90XiSOpsY}`
z!AGdMase6JU^KN13xts#K7&E2<k@Y36;_-K#f{{y0Ji__jb-f$<i2OfN;@()`PCcP
zp}>KWQ23znxl;Yi+6UEtqUuwAj3B5G=MP8`B@-{I>XpsM6g-1i?nz})DzT+?A$bN3
zk8aUtW^vsnlw}So|8N0{G(mM07u?2~oY#iU-Bie=)_YY2XTx>3ye7YT=N{0-hW}`T
zS9BLpQPsXJy>RX5_$f9cK6E)l#}(i8h`irsjDdnPtM$E|@+sPa!J~X=^2&UQ6}(|e
zQXc*sE+KhG1*6M})Nh6-q52JHTx^8>^i#y;<b)>Q&F7-|Ci*Zv?uR#T20raD0MA4Q
z$=ZCIS#FsFIw(d~vo{!uk+bIiDt)@4(n{_ujhzMi(Ps!>P{J@A*9I6rFkCyY4OMX9
zI%GKQd%B$F26pVy^_JK5cJxEfI>^qp&QbSg9UWKPzKO}+{?YeXd1GDRQCBMeH5i|`
z{X*iNl5;!sA;NSb1VYYH($HUcQ}ln`w@pRQ$UY!e8loq^j&0-;bU%`vK{iu&XCM9g
zvAs7YFZGUoeGN<S7lk@u*&i2d1Git?VZZC#1pWHPtB-`bnUB5$t@yd4Q~Fnp3!M>P
zULQE2sufewd{;?7J(y+94UR9&?kMPuf~zM-23wax8IM2Q^_-L6HXBL&$5x7wU=rpO
zTWu%<zd5P9+6wA4a7QXj{O29{ub`zi^3=J=CDk&=P5njnLqZR}R9~PJlxJ%C^5c}x
z%fg_tQ&6#l%2~<t$vvSV(iOov731EchwMKZ^^*4Zl8N|lmkh}6$01u!X%uxTsPRj2
z9#!7G4+$FcdOYDqM}=1Uev`bL&(Z1F`({*$kHz!3Hdo%lark9bi60ez_Ma3A#E<KY
zbN{W*AV=?qThv2OHh>pA*>UY^6f^bd@GIv_yHiD?j*h2Hzug86{q?OjIdA7gR><ok
z2W9JoOH;_Ykw^Cdr-Z;N)lpL;c?wlH1-^*ZPD0_Ip9U)bl;&77ZSy4l6RSBpuf8y9
zuf5H)Nns~_ZQ{6Bs!P&-bVe)fJNngWN4E|tiIB*OBbb!CpIT|vEUOZ?f(o|khxH5(
z&K@QFo4yg_Y{#E6uG+D2`JXpo<Z{X<`B2jD=qcYu`=_lt-R>?|&Yx)dE>PNCReAhf
z9Lke-T%w^udFn|)_C<=3%x%8I7h~}|mj%1;LtkcCqtDfW{KWBLaajCkQTDIHiVFgV
zB{<zXP`PIK*Lx!t0{2vZ>2av;Gn&|19X*V4s^H>>b;4S0KWu`xU+}PeasGZ3s`Ro#
zo4o&gg8BdO38{_XO-LQ=b~j79eK6kp*fz+`iDzw#x*jzlbt$&b9=aM|FfUTfldLEO
z3sEw#;bPA|e3qCG)ztz1MZXwIpe80L(fR0{^cT$e#QtuRcw@D!Ppoq4LeUzhSM4(C
zR4eTr;8+qPw|pF}(+<WZ(MQp$P^{ss==sE0Xz<*MV48|)<59Gt{zTc{K91HW|5LQe
zKnEn_fZo7JD6codo)#8Yl}8^%Q$+Gdu%z2aS$t6d+SOr7sB-Isq||x|(mpuAZO_Y=
z6dI7*Xc$+vO<vL3ngmYtAHX7)?|@)50c7XVGC?%uY!C%up>i2#5B5JdYw6jr)=2F>
zGqtD!+XtgZ_NIjS0EpxUMl_~iNnio6*=q(46Sp9js!71J{ebmaw88=Jb1(k!y!B;(
zu0;Sg7>4y4RL235m;tZ_xCL=pi);pkG_E6ZwQmN|@<ss}6<~@;bQV-YrcEKmK)GK4
zzQDTytvp#BdOIsG>#4Plfz1K|LfIPY{J24hbu1`}^#Dh27FQa0u#>kD>jC%)>0qAG
zHVU|=;b5fv?m+o5(Uoem<qa^0S7)~H470Ku`+@$G7F3$iZQ^)sO|-450_>um0LxJ}
z&u1=|7xp$hx3xZsnbtq`u?Up+jN1?x-y5y<`GDc30<gx4n|016SfScm6QqSHZ=m;u
zy37diUME(YrDeI!OxbBIGwH;Rs*IJ543rgainGEFj0<v(LbulBaflG{H?%KgIIIfH
z=Rf_aryf~3-5<qczzGz4(MEe?w1V|O1ZM!Pkxf80(8b17S-q$Ndg9y!V4Tfo)|L=A
z-p$+qcG4T9m;$C%SY&`2z6zqFHUY5c5t;Xfp)OYyfSOH#h9zfE`F1KG8LF3qtrbIN
zDaFw=Q9zD(TaL*oGPisxuKb#vRiYi6k)^Q-D-JoW5Y>oAdIELBByfg_hJ*!F$s@Xc
zzuJqvZ$pbs1XIc=X02etcJO%*iKVK7li&?#(?hbhRS|)2j49Y~1njz_UHucs;Lmx`
zp0-1UJ$iMqh>A0kn}9**x72qC!0z6K9xxDFXbak?y<-?c%8n5bN+mrRLXvuL&AMnf
z^&k;kPa)P?Y@6d!OIaJc!WeTC){7wxPmT(bkb<<fk?S4{cOfg$A?jA5<@$JDzc`|#
z?-?1iZq*c+Q=c847l{~jsX{3qEZX@vMA!qT5)}pfB_J_%ad~r~>J3!>Ly26dUSKtB
z3VZ-RVlK4Qx^CE_fPVlo<GPu9X&|8{h1baw_-YLwVo6yO*&%Dibl-=OD_V_T?1hzB
zv5pUPb`c!m=7eDY*mLh=m2q<cd`uCc2%lGwmnfghlD<o~hiMhWyiaVWx5~XD76v0P
zyhG4U3?=S-e)qwDr6G~mjR8A_C%9!CLJKp#gI)HzQiE~x5G-2R0&8Y+(Rpu|=c++V
zR?JjSy^PHrs=ArCyuz~De7@h3PfP{uwpfGTR&<OF1I*_x*g{BKd$my1%i}sdw3g1r
zuz0gNo%S9RFf8lDd3o&YFZ=KUbCqPs1sqdJ6t0F<13iOUg;CCy_M}7P8d~J!^WqT^
zVw+F_?4IFH{oBc}dsTDAZOw1IhZ^?<d=49E$v@`S-CEj75DDQb1%*%Q0mvOQ-lLjq
zAx`|rLsv3FD2)>ZFUAk~YsGTK1S~eU2W_L+EHL&r1dDoDMt0g<blGk>mFEM^ivmQg
zLwxT1VhFZk+tP82L~pnnc`OQw0!oG6(%BAiX*R`}QSVop#7yZiu)qD>*5v0F<gBY*
z`6LZw;k5h`5%;ruQOLa-Ao#Wc*9}S(jEIL|omPDT*hZYUuEq4OL2>y<XLRT|fEZDL
zU~Zq`T%of6I(x9A7syjM5e7~uPoUqjosH+YouLqx=r$F*^e$Ujecoe^I|X6Ih+7Hq
zs46B>Z>)8&8}^JVwP44dN)qPUu~WH(@-N_1OW(lPbfn32FL$4u07-5>N^Aj0CevPG
zR$b;-dglKCBI-n-ERjjmO-+C0B9e#jVQR~j!p+nl<QL%01*dS^$dcY~N@S1%K2P=l
zIIeKWA{XlW%1KJmkL@-A1@A61+ed`^N<2Z+V23=F)^%3q9$<f1%o2dH?_Aq+r)*U(
zCO{ueRrp2Cedsyf@wpoOn<OJadbvKl-lDMep?S0lxQaZ7v@dd1X{JT##C`{f$;fKK
zZ96d>RaPfx)XRQpZQUghmei4xboCNWvJI&5oHkQ~c<fs&cX+aXE!33tugqOS0Tx2V
zvj>1lIg~yD2!GXq?i<llfGElaIdN`<(X^~+(S{fOd<mSa%9?t63~R(suE+8dhpq{(
zy6uD_l#1Cu^KwtkT>7RY)SupMpf!R_S8$(wWB&)V@^(#tl6}j?1zs(#pEJ(j6yD=r
z)vem<Ek$2H;9hl{n7;g)4wxx;L+q^Td0=eSE<*&%eJ3CWxxc*E?64WpZlv-{?zkT8
zT8-Hm(!odjLs})j#R;-I6r0O#pqUj<DjUq$kWA7rtY5t1>;W!Ux29>9RrvA+%n)hr
z^sNfUSzW6<Y9W(ybF-u5kGmfrjs;&-(giUEmU|c=p#9e_HL6xE8>e}{{v=B)`kCrt
zxt7EIPeaanCJ6LB{?N7T?{L10Q-N|Dd3~$vV4tC3uv95(?8)%faUJ%3Vh;8PJwlH_
z%G};rPZ@RZj>OR``SvnA;BR7TbaiUNLQY^#YCgF$1~8&udT}qXJDbHYcD=(}eY}62
zZPBBpdeYU;XirRvn`PG3vbyLhzx~AHj#{0V%{-e%v#Od&f!YK1gyW%7;fp<ApI)=F
z83T9?Y~R<b=XyRc9C;}%+x6a#Vw^nmc4)g?8uoh2Hrrx!vF9ce)=)I>Qb~8a*Du&-
zZg8Gk>)UDbP4g9NM9GxKlonq6kYH9>=L}_hJ3ebgGReeHCmRg;rZdXI9~sWduvai*
zagOEc+`hDnrpM>F5+sgwq|>kdq_F%b&qd9DvyjMqLDEMWa08jS$>zkDs!B?m&5}X-
zvB}$Hn7-PlwMp_F{qnA{X#Pv(5M5K7F{!0-Z>#b4@#V<e`s^{?<C_3yaNxuTnMk;p
zt^z1>o{)l=otH0`f=vJ?GlxTN%vdwnxV;=D`E#(7UUE5AZ7YqX)VsV+(9qyOKDw#1
z7i<q3|6yq`oYy}6b2`u5m?I}^(lr^lvmhRKUN;9hDO!(c3FJI^49o_BPY?IET$Tg)
zkhA=RQG5Cdu6UmAj2+G8VxR+`?M6pK`n^<_-Wd;01r{%GgD%-}Ru32%5fzyXk}C)b
zgFyNBOVDCbIYwknbZJG4NHaZst7TlN8B2)aUfa2TxczP>Z-RKo!vLpDc40&6I`Qiu
zR0(m%XS6UuJCGgc^LMMb8uif0HIr(N7Wej*yO#OAWOhQ&FM$Ux6&f-yWy)94Arijr
zp*u1zKcz{*V_X7i>%@1S%FI~bONG6)%YZ|6en%B~)LdO$(?J)30MBvY{E^7+z7<LH
ze7y|YGH8i}2CkcQve^T=e>bKIC=FIdF1K!x8Ll%uee8-sxk`PFUPGnZAh0DZ<8$j3
z8r6;-$xS|;>(6psZa^MDnBpYG`MP+Xt@IX(nNBz{Fs&@L<@Kx(jFcg9sI!v6Gx`+z
z0t{~7C`x#WG#&l=dg=U(uJnVVub+%ASG;xBP-$72o3NY|z3V<%2i9BMoX;&(9=<@P
z{PQjM_eY7jzr6N=R_%(xlEQ8V!fVb?Y`)reAI<Zf3$SsxcQO@xfo{{;_E`mR{BkO#
z)$hF3{3uVwbNrf}=~E=gDqj2Ap~4(^_va;yc4^ughmzW^!K?ink~@!YT_eW!v}Y*a
znH?6<odH^mLoOh{cK8;y8XH0c`?tc}7uW94F-^OAm7p57Tsz$+`3WL}pl_YNnH=#Q
zJv!`f%zHV2pI~9rax_Eq(jRX_<G}*yB@7Xe0B)?ys7dW-<h=)3Izgp@?lyYALG*M9
zN)j|~-ijbcCndCwJ@NwAZBP2@fjFxb5_Z&)Tpp1@HT?n=nJ(m<P^t(ARp<nOy+f<Z
zQW1yq0XQ0ZOUXwPkD~SB9?36>G&1OmnE?{$OBX2(X^HC2e#lFA>BL9(MrC@0FG3|s
zm|^7UO^yYYbQ-aumsu?oZ@5*{MRn-(d-B|8)7)K(e>HcEdH^tBX=%wqW3;K+b-XS5
zPVzW=^2nXRyrOJcqvXZ9;%bQy;cd6&5j<WoL8OC;*3(dj9xEj$8#LlBtovt2+r9Bb
zJ$3TuDYQ-J$hgG>3RMOb+<`Fp3C%yYa7h&$SkyK&Jg$4e5SWB`TrDTqd~UDosyx4e
z83ig_-3+;j{UhL}@RG)mTLz4j5p22ug)R1R8rfG*qWqu_87NyirxC@^tc#88G0^y7
zf4cxQzdOmr=ZMYkLEb<pP*1wRqs9=&0g4M+*SS)W&;fvk+j_R;rY+)QJQ#?BV-NWE
zPyse1g{j`u-TJfg)c5Vo5?m>j#U)`p&-+!Ll&8k^s|H@TLkVB_fs<k^pySN@q)ofj
zxv4Ysx~5Sfd|lqo#CR@y2U3jWi>9|zbxdC5Y}fm2*uyO{J22xWhVq)5ct==-5S~Yz
zpL9Y?`QDbTvMMqb+#%fA|0NW%$_jMXe1_cg^YX#UGqbA#?xl%R3@uxzj1?*1;kTr7
znn*|Pt@1>FCBzapaC=`eN!Cy&0Lr{6Q066#Hr!u6Jh1D?V0Kim>OtE_?|}Z#1jYPu
z)9NS<OFc$TgJYjlOOtH^8<3#&V;`V)%{IFol!NWu5mlgx3nXxN1BZE++^y;lwPwLG
zR-nm|PcrHb`q=Fq6eS#NW(wleSvDV>adH%w(ho!!8%WI?n?dWK%RzD-g(@2^3>>Py
z&;AA`CY9F<=Py<E1bf4FirUOx4qPsDnU?~7nNiL>N+)z9fwyrHRgPnSY)6`0<;t7_
zRt)+ph6=23ye%uI@p~I^5d(Fz>Wv<>_?yv0$$>ix^{CMr*>SCEnqrz0Fv@1*<zMG`
zvZ*JR(nZGgmPZE$Tp1>x{c3;L9abc}VgvfbeMb+SP^@8ps{a}8)VXjUqCSmRH|N!N
zD=p2g(7K_D=V8h$vu3){6+<QwN<){~F>eA)ya!o!B$KoZb!PwTe6PPS3MeOJLxb%y
zajo@GJIQyQ&-MN+SCGsBMBW0$M%V?QW=XTz^-pDMoUUq-Q%yi3K5?E4MOLjlKM1uv
zQEv$#EqPWL4wQiD%>;mL-8?KJ-oL(0++}aC0?E~Ly@2ngkrfLl8~k=T#+D<w>bmB(
z2luj4cDPmbEo$$yHT{~a)N*|04L~8K^`(~5hS;IjV1(Ul*L33yiC1+rjd9V>)nq_2
z``BPBN*Fbu)1|5ej~8I*&e@_Dz3x;Hu4K5ZY8XNr4)xf$7GP~FJz{+`KGJ}LVG7E1
z826Velgf#6(<qaS7%GXf9(ud97=g8&&&4(^+d}kMJKURoLz+gk3+HU2j;`xjoFm^d
zsKcCH1WGKr*na%cvWW0svFw-uby*~cus$VKEtN;=`T<k}LscBv%PRtF&F2R}^KuDl
zUO2Z$ks+l7`Ir5s(dFXjd=-3V-B1LJPc8#<r<OM|XcuON{RgcJLo{<-7kiJh>C3S;
zSoMcd(5pKe{3K&t_syE^%Bu8%_K9KGOB?8|-t#czwrp9RP%+A5f_XKlWkN^&YezG!
zPq1*{QJT$~3yH?PFo!A})l<>@DZZOzlq(^!m$#7k0zC7f@|RF__e!Z6PsR!;h?UqI
zMPtQ)nK<O<IIpDdk~dQ_rnvN?0o~#^yJq4TV(pa)x8gOZy&s)2019IMyE?PtggMiX
zIoQ9j*9ygE>Ru5#p17H&l%=-6?hscKFeK&(-u?Ki21AhJYxBe`++J{H@Y39#Qb=2@
z-`@ePhP*Xz(25s;Oblw)fCZERhY6UMIJUp<WOjX7{{0Rzuc)ck)vtZ0^W+@ZRW)p)
zJ}HB&zn!{c75{6?HO|d6!&Z>apkXYK=R~FpW<~}^O!NdCv2t-OOC^&zrVgMP&-Gvn
z!mZnqa5JC559Y3Bc6c8TazD!bSw{L8SzI%CSwm_|>#p_-EFhXpauGGIB>_I3E%2QU
zAiOURs)Kef^h$+JKO+W9Vr>AkB47=D=Pp<@AsZmndRA3`M?GxvYg`jEvPJLAa_6t<
zP^CD5?D7z{KTBm{yC@!-eV0H}&%99lx%A{MHV%wy#QrWhQYmw8O?JKQ6@y(>hmC$R
z@-Bc}Gn0zdXH65Dm`tnOPkw6e{dvhX<NYTD<J`9nnAMB<5vP+_dzlzQ6c)ka3|5|r
zi}j3mv;G8|GKbagb&drXUb&XwsYzKawgg5Qv^H3T!CayOv6GhwSTii^W#f$4B@Hri
zFe1@yL3wOo+7#xVBJBP|joVN~vL}bh4*pnm^;*m5(B4?qVO)lKEsS}d=UX)PY4<X}
zBwhCz_T7WeCD*W0*n7*(9cGOXbI?{aAE-}UGgQ^|&qb8)*hJKAxekDbVt4dV;E`9)
z@alF>n+^dj_EM-{F8+vL(SQ3IICs(@*g%+U3kAX`m~whq@cKK6;^OA%vUY53+-}mD
zx5GS(mp_BUy#h*NSE)-;lz)unK+GC#>8+1&^dO7H4&JtAvka=~TRafPH2oTN5MCF(
z<*racb8XDEK6Xg0fx#2w7driezuoZ?2AlL1jbrAT<GTn>jPjb-*-Y<j&7`JJ?aMzW
zNgWek7z{j6a&$Z4HLLj&*yCiw*k)VoW4R1^6n71D4nB7joRMc-pr7<iSlM8*OT)?R
zcnS=>h-zdgP1ZGWtE$ni22{nRLbO8b47$TCLo0#15iR4j&(njBDmny<7qXy++b{!7
zg`oF>ukCM@;TySEn>kN{evArHD^o?pJTzci0L(S-GGT_2g5!)jSBA&t1i>KhS-lsT
z1d{Tpk5ULV-m|+km%K;YP6-W|-%2))%*oS~YIO6~%z1TJo5cRcSNo?cq)qP3xQ@r5
z5TM<6fzyoXOpWu_qhyn3#C*c6_%xF%Qxv|;z!v;!zB!AxO@Q7<3VpBfi4Gp{)gewm
z4_Gs&Re61{pzAb|D;)S!xpH55AxdceRP=QfC`Bv8pBQ@YOlmdeAS!`7<qlLtl!@y(
zmJ4_Rz7=G7QK>!qC<nK03}l%*?WSP%f{nGjB)R@!0oaHby2Yc;49L;hrL`w4Pp5Tk
zt}i1e9frn3JUpm_azjgtwP&|b1Y=jA87P+q3!{v{dOmhQKP02n?QO8EA~Izt#Lwui
ziQP|E_ypXWK6jsE4TPn9i*0#}^bXUTL{V2AS6j#_&0pI`Ln+|l)M0jYuEnLl`}3~N
zrWZJKt(}E&Y8OM&<nq+^iH@KPfNHK^s!)?^(6_Z6{KXu4!7*#-)Ox>_8y{R==klD%
zoc>A-HkO=ro%kp>v^KJy(Z1Aas_0}I0r=q(0{DZr1WAt)55q5*JD+F;=k`7t=0i@$
zKW)~mjCOTr7Q3xt{Lk&^?gy=v8G+c<33whGhNnWrZNmef^J&^yf$J^l=RA;sEZG~y
zAgjj|ZNYSO`8&v-j(m3LypkO8qR|3fu^Oz)>zP9GS{&$zhUK_f%q2EHY3poSL(BgZ
zQuk-%r0vi2eafzP)q|1DiggnG3Ok0M)W{=Rf5R|k55S7y#EO(oN<V0%kul~dIS=R-
zO<)SaBvhrOA}h>KkWF0Q2XUQrP~Gnt>QRNX!w%fA0=Xd#tVn7GD&V;ui!i>XXM%*$
zwWRgRnH)4G$IVw6nW08AvAcYH{F)@-{a#bm58%h9Hk1-$6p<OYbWruz2`^QhH@q?k
zbQ>K$rGWEe8@=vJlKA!WQ2CsPT4cLx(9ftb_?6V}S1*4Dre4vfx*ojextZs16J@%D
zt}nX7XFDXa#n`S(OF!?iUb+bkmuGo8yE8spRXciHgOzKxgqL6{Y$tY4CpHFq?Qufm
zKDgJK)c4{NN6f`y$%O%OeQr;L?MZRWr_$*80UtHCUIr&=DERIE$OTEUDD<*H^Ek@=
zj%T6-*)Qgc%V0+6RR0!Ozc&MZ=6nwc){rlc;2cl43^b5zkO5&O5ogc*somhGcy?{B
z0tR6Qj4~9!x)0KGyJ-T=9=_wHpv&4Og1*Z}<uEB@MJOIjKJ8)-PD|ql2rl9EoVc3h
zsXODj-E6HZLS5|=0LtXYy&y15ikJ6z<gVt#t_ZIgqMK$UCL9vnGy^_L{W5IVbX0$U
z?Xh0BJ{1V_?gtDqsp?>HtoK^{NEteCgL+d!D8NDTx?fc>m`jwt?=T`MfPJW+{F;L>
zJjZhe>+*AsF^u4r%DX=Zgr84DfzaPHM6k!4y24%FD>0&@Qe)j`qjngg2<8T-4ptK9
z&@#y@gEI;2iW-Fi_l;)lz`3R#C^zX2#l?=CjmXlmeTd8mn5jehGMO^nPv&Wi9m0Xx
ziVfJw#`mo5{aXXO&BpvmSB8ri)ajZ^k5sO6v`!F|;(|cTP+vmT2GV?WoE54rVEzFU
z`BF9PJQzU89E7M)cI1Qsx{^_vp-<pn$8P_9hNzW>kGyX5b}=~1_)$I=;&M?Sd27SB
zxd}c?sdpiAdCqPz!M4u9Y9rUDx5_jPWtcn)mjP$6?V(g-EQ0=ab&yW<ub<I|AJSWF
zb3rNS^ibQ&Y#U%Mx85<@KQ1&@+1o$P4X5ZqZn$lO1FNXY$P(xc^r?Qp68k#M@@EWY
zt8{7eAsQ9=>R%^F!moTEvw!Ly9gwuU2{tB^>mn>Wy8l|Ii$X2m*l*2jr14tHmkL9K
z-6dW#;7BKCwBG=pNNIXe7Iup|^%auUl%@8_Tq&#$;-p1Ux@q5M6Pr}2wsG$(K3OK*
zhOIx0{9D1Iya$C_75{Jn(#kp?ImRU_cBB8S)3LZ`y}}i(=29*oabptY>mZcLxE2c3
zx=RPGHV!IB_HE56z&wHf#rla3$X@|Myk5Ha|JwbSdB!B9T1t=2axX0yv3&1m<$HlG
zPHght#BI#7&0q<+jX@&b_!<p^C+-7*9)0_?6zEHY=CY3Rb?UW*u|T^FACMggW!&S?
zR+n;9sr9JezznWN@=P`mGdg{v(x2jKW(n$cb;>0U(@$*x&U>X<(~N@8*_l(G_*E3P
z%x6Atrh-wo4-vWYcG$TZdUT=B6Vyts96vfb7sh44o%{RIp-27M#Xf#&U$rW7%$8zU
zcz-MO<;bk@2&J5%KqdLnWM^|F5R7%mSSy0D7_i8zdttRiYMlFl-Vrv*{@};eQzvyO
zzt7n}t>7x+!REST%_M}i?Q1N(y+E%;Yph%Osl?szGohfBIJgH*SKAl6qYc029%7t?
zgY6^=1&psxBk|_=Ck0elPeV~V+X~3~twFY*xc(-M#Nb}|7Em!x+fwdzW4*gAsVf6`
zWO1w2#a_fv;qB)l3*lxp*S{H$MErW!?^1QRi$9z{&kB~NI2%}MSObe5Vg0?06f-rS
z?Oks-P3i9nYs!~?5TDMw&-?T=*U<65c-)>OIh?%lx(}GR=ZW6T+kwm{wl2hh;ab_d
zqFD!oCz#Ub^&&<*&+*&NLkLSqgS9Auz5V_9DLl`-3#hCshc50GFxvG=t^PpetMAxE
zZ*G;r0m`Sf3QdIBG3JT@96XxWctWdnUjD`bJ=E~pc`I(eltv72Z|}_0!C(*ecPp8Z
zU<Q-h$+~`ALW>Igz|%LxBDy1VLfW3A*ThuZCg&Lu9%#=^NqnGHmGzkuBxAJDTY^lU
z-lp00!|QFh;oM)3o@TJV%-|gb8fl58ccjfk(Dl`44HW%oGzx?nOB?4ESvm6wx{A9;
zzVmoD>z>fGC~laj*xOuXX#5!q)E|wS-Bt$VhSe`jW3G$Jd&hV+qP-xw$nYg^uWr35
zG|~1I(2F5}JapDz^iPQ0hFB8uk0AG18IIhUtA3=ZvIy%LzH1c?=KPdQ;PAF$gTi@3
zq`vixhlm>$ND!W`sO)AdOw0}&6iYF<3$6p#gTaDO41qk;<=IZIn-$ZD?8;AkqnkZw
zeeUd&b+G|(+_)k9QG5};5lp^V6l<-!K)=Vk!)RuxNvq&E8v-b5H3l)A12ETx&Y;Ij
zRcp%qz#^gcO?OquG2-D1a#Y3gsEmO-@(oXE0WkY19mpHS31S`j&_HR6d&sT{P8INx
z*)?C%ah>EiYl0NL!{ofdL~R^(Ew9uUtm|F5R9aUd^}{gwQWx2yxx81a0C#MGoW}sm
zU7xw#rswVp)05I*bP-b&vbJRxv%gc+1lPCRC_g%NsaXB)l73J}`%y)F7O`>}S6pHr
z&r3?Mu~~e)n1#vutnfs0iTKkm;NWVHAj}Jjxr5(Mz?q{3Ac_c1_SsH=A-<;(TF;0e
zA)abAb4v^iXm>>i84!O^R(GYx!bF{FZ)poaPNj-KWg>Z1psdIIrOi)ws}P~U;tkjN
z4c_LX=`b^R0)~t6Nmu8)JBW1M0TG35VhV3BGF5b%J#sL_(saU7H|i9O#LDek1$)1<
z#anlpzlZHhw(RK7nkU?jmKxviwf-pro(M9u-%QT})Vw2OKVZpU8v1*VpNWg%{sz{^
zi55FEOdxhX3y>1$+0GR<2-jRb*&8J5ICdWZYGHKznZNnMkW;e!gU9u_5xQ(`4$RhR
z4KlT&8@i*D(&pCAI?0!h);|SaYB`k;E5m&@qO4b#o_rkCgNDemAD=h%U4E>01KsjE
z`(dQnYm(`MR0%8Lnd?=LJ+RfA_U*`ifTKRYq(;NG3Si%N_nYUS;YZp>qoeYW-c&9T
zFDxD#xBhLRcpk~-0)SXvSh`oIyn;cOD-bL>S3m$cv;`Fd$MSl8B7&W4`htXM&Ocni
zh}};u2D9oXP%Gv&_phf803@_@b1N-OinHQHA#UBSqRPMB!PJ*ymU3j28>QBX>*2HM
zc43??5yVwYeU@@m>b+?I=97aN4Tim>-LSp1A#O0^=qU(V-7%*+)3U;b;@tpQ#&9v3
zpq7cCo;85!KJAEBE@FK7^~93T27dP8yk9%4WBS7klNC{C(@Q5zSkY%3+){Ml`u4Yp
z0Nkhiarsn(xRLRJLy<Mkb76M|0eP$KiBw}E!d+&X<NvVt)=^QmUHh;SN+=y7Dbg??
zpoB<BNJ)t@#1PU-Nl2$C;7}?pDF}if(p`eIq|zxcba(Te*MRqPzt4L=zxDn8`qui^
zvlfd540FvHd+&4aeIEPRpW-I6e`Sd!9s-UGjoV|L)fTyk6%L5ftnTGaQY&;ADU9a|
zQlvxRB6tIlo4x)yt{jl@@2`W{w|tB}V&la<CuJEbb+s`gG<Z}d`1+(|jU;+IWO7PA
zC`v6zEl|f>V2!0vCeI_1+6iS`uxE(F^pg4TN%uiEiaN$@4T_&So0LxU&@t2vss|}b
z`C%FRHO9IG3i^Oy&n~Rpwi@I|(kFW`0>$9cQT<)?Yygb#tV@L6am>SMrB-2>e%iFb
z4TM4ECY>B`<syM;UxM3BN)z*S`6*Skz)SA!VLQm&xkPjHEyHO70=2@##WHt3$naNQ
zT?O5<0v>9vy|(F|v})sdTJ<aN)gyP<VIGM-ENAwCU)g>A%8swVnoow<!==5B7W6~c
z-{N_!KPD%neF&7{@rE#oX}lon3E%DI+yhG<aFbrL(P9>4TLjW}?K;q6-xmJhL=IhT
z-m1%>w1c{)E?20ZoZP8AUE-&fAo(Qf4>^M)E>BSt>Am|P>h~`VyfF{!BYA#b#yt@Y
zizVar3&K5*4@FBFxj4sS-T1<rwd40@s9kNX#;QC}pa9VPDLaqu-Mg%VTN6D6k?B8b
zze6|dt}e7QD`P@p;##YOA|ZVAUhLT~+umsm-V%xVOu7IHqkM+)xJgsP*3j#0+L*Zl
zfUJ$E?I9bd1$hk?Zm1&0$r~iZLIGxnt{ddgn=WZxT>(Nd+3@*QB#2$gl701XKN;Nt
z{XP)qGkQ17YB65Y+B{#ZwHEKs*0YrvdP1zkD(Vn(1C|B@y-O-}R}8v1PuzBvVc-VR
zC0w_-f>m+y3!PkkVrZ{HRzvK)D&r>=U$#&H9uo!FzV#s_j<Vj?OHCDn!YiMJzc}@J
z0FOMp2d*z_r>s-o_o>b{0pUmcRpq3%pl!(5A)1%Dhb4H$cF8TyB_doVWeK`S;Z2+b
zNj^@EsJ>248P1uo{i6y{7FvR;1$_-rEY%(>p4Ma=H;+NC3%LDl(GBtN!6=Br_>0@v
zU}?D?ZI;s)>C%m|7~AQ+N;H7;?TluZ6ILGM8x*RB;~t>MeCjf-(a&7vU@bS}P3OLP
zcVz;pclfDVW-ElevNg|+SR%ipW9zjG1<P)j&~mZqn^X{~KHF&yLvP8hu>!$RB!q7x
z2>X@N`n?a6(_iVe4T0};mr3UCv@PGDZ$#QXD4{WxuU4Zz_yv8cefr*F9duUU5)d=O
zsLJNU#dA@^CnT@JE2kuRs4F$?xyzg@kH>}2qg3iHqwv%(dJ=Yk*1G%=+51Y(K311?
zfvy$)BCevg6eqM%%-dy0=Bhw2IBKJH<7evM1%2<n{sY`>fnacEH>mJBnbA1AbIs~z
zIB1{#UpO^}2^@ybIEmgUOvUn&bwKG@R<64lQ~50_+s_WPeQxqTk7*3L23r!0Y>c?X
zt?tkmvb>)Gm1dA*60<wY)b|=fuqkmz<>i=6#J*x<>bp1*8)rpPWC?)@^NEfowg8SE
zRG#Q@W6J_;J=m?kYA-G`hMdFb!d?eA34`?!0P)fz+E?^IqHBf{kb&31I!b!X2In{Q
z97^YJMoG3UeD~U1yuTCgvJKl<1F(s*#IRpG8W4Cm<CErR5vHmPyH8aBx_;XQ<Od*l
zUWQ-kO%V|AK=3@nf0#CrE(2k!PpU5BiP8oDSw}%0k~M&p?3n2?E~dp=+jU?mZA8pq
zNW53BI%p}kKrgs^zNpz!Yvgc{pc(G`fbPTsZe;%ScR{oB8;jWxUVi%$S)0@;Uj9RE
z*w8)n=f(|5bgikL!Y7IGUfsiC$U#czMPg<;9D+Q;JLsbSh(Gw^Alw%;AHVN+iHZ?o
zKtE9bTW!U|e9o0u-Vbvn7qf5@OvH{KAaLJKxmZ7d=I_$p+u*@k6&$=i{9<=n*fsdT
z8d`knMn8(<QxWvaTHho<2L|oxmb01Fr_lXf{51kBqNbmA1`+0<@>w6WshB>_a2o!r
zB<b?>e<(?kRrWqhf^gVWf>S=fO~4MEzzU%0)pZ-5dFnt_qJZ1mLIC02h*p>Hd#{_u
zi&~&%^Oe716cu0-6iqcuw$^5#YPk3gTDK710L#xZ=wdByM-udnpZ#BDQ@#P$y}hd?
z62OWDS%XHx-I;J6m*1}_KLVo!K@gt+i#qa6)<vcAGQ`zQZUKsk7T$yQqAE~D2)*}}
zQMK?|iA!W}1=N_T(F2lJI617yfMBp2VX<ni3hpWCs2S1kg5tTzZgn)+mRY;v)7#VH
z3pT#J<8rhD&xmMmR=qu4y_@UfD_|q@Bu2roHpMji`#}>6>BcT7VE=vjf7ULA#F0QG
zNHouXsX;lz_muDgOc@R$X#$0pf)s6E(Aq>ScFx6B5nYPGE^>6B;C|EwHf<vIllk5b
z8b5x}h;+J1fyVz*H?nlVP7kDx+~k$u)1t<dTpSpYL=xkhMquJRPQd+$G3YMN=XvP7
zlL&grUWe{~7cRijFoZ%X(5TJLQ~?F<d{jy={;CGes`EhS+a~5H1S0?!Wt3Nr^BI90
zT=qg8n3w5$0~t;-reH1Uujut-I(p4J>In_@Dl4M4oV5xUliDU>_v%H4-y=F`BsZo`
zcN@Cyt6o_MEqQ-cJJ}G~ViDo+K%;z-@~7zO=o4tl-Q1sRWI-Vf;ccjH7<dEXbM@N}
zvkah@vtx&DMn!_lG?g%b6^v}CLtThVf!>%v>A*m$VW?`D6KZ-rRJ4^DfbGk4KXCpb
z+DBm$W2YK4MZ<X6_DE*&)|AfOl8R-jqQbj}p_>cY30$l&CFE&M<<!5`R9+yKJ?HZb
z!$p^XOQ;N_^`$^1G;8Rc^#G`ss2zZXG=pouQoI@@Ij3<;IJ@1%Yu2*rt$(FyEuK(w
zRn2-;%q9m8$Mb@cAk)kwSN~RUFmvKla6R+tV{X_~jvjZ?FOg&VsgNj@;?(_6uk6ww
z@Lb;wXb}`^|Efj$C8Nbd`0&QQLn$P&9(mWjtX|t38&3Z;npjAQs4haog}qAO`O~3S
z+@&dG*5efVKl`A9pYYW1y!DUnl*P)zUaz3h?947R?*^Q|F@Qtft;Pc-V!pSIvIDfG
zWwni<i}pD32Ea^MZGGE-`nz%Vnv3X81MEe+U26b#;Eghs%2qTs6wuX{FN18O6x8i=
z0Nk8rNiA&a)9T}Kar&n=y&^|)?&HF`GA&tkKpkuIpE_1X8T+1GG}_;ACZcB+NO7}S
zX27R>eYBJ)%SKdc;+~d6MDQQTFsNX-=o4_6S6UA6L1@_f33p0S;?Py!G64lF3vf0T
zqn1fv(Lq;uYss~>%dexrOZFYly2>>QYLa<i4Szgv$Ql3=k=#g+=Szc+AhNKoT4fEr
zZ@Zpbnfei+)kRLKg-Nw<>MS&FGI-v)Xt<nsi=$n$GpT&a56kdfQx>w<4lj3EYTw5M
zYeORb<D<lf+o$Ee9Kjk?L1+u{S8a-5fDi`GFG{vrJA<C<zmgk4Z!QRH_()OhV_BOY
zwKZFcY-l9l`2H~cK!2YOmUBN*Oc%uG>^#+ncDg@6&p+jcAgb#STQ+}~<Cl7P;N5Q%
z>RO<jh%HMM0dD(acv6^dKPU=QY>1VnFfoh$E+~>Km(2QI5VvR1@+bP_XT6C0MT$Q8
z<+KXsHPQCsU)36SzY|L&6-lT?Vp>?eyq#JGFibm^<Q^BGj@}6VN?)0kJ98uD#g<ij
z(;t3L{@uA-c86-mbvP^m&i2_5R3M0o9Xm|Rs@k9bP#oh>=eh<{eEcC2T|hKxlaW~Z
zZj<uTkSxd$5=or%d4%0vk?q@T&UXVB4bB&SZEk87dwNdNy12f33CwGhiyiB0p*$t5
z2_m*`kSuW~v!V{3&`HCPx>008ed_ukx4$$vg9n1AHkE){s-TMj%eSENh_sUKe<+tT
zNf>@|h3qPW0fXvyRL!L;{N=4VYcQP;A1o((uueS+)9U2eE2m{z^<+sU4}O$HK6wZR
zMg~X5oBZ8@;NF-b(DIk)#X<sI>dk`fPg0NNk<qm9wa>?KZmbnM)RPDD&}_dxcls~^
zjQjV7N+><Pf@gqwOa4<(&{+X47}vE0qNeu}DX8SUUj6+^Rw7Vj#dC+u!+neIBU<%6
z$7l=govj`X?hUH=6a!RxCi-EZj#?6aTC9XYY|{)KP0-rO&fSG8G7veIrjw|W*#)$H
zFHXls*ZpBcLCHE$_18&&-i`BEcC0nV4$G2}fdpvVQ7RYO6n|<vnp7)zDS_=kOgG0P
zm@dR~z4BhMQ%jX#?_`(^u<61hmZ4S&cQ{?T@SxwKf6C?X&$Fc16Q>P7?}i+|cHPg;
z&->9A_m$7g<3vEI3Rphn<##U$C^Z;b?9^V>vyIn)9I6@~i42u&eug&MY@6o$?_3Af
zfZ(ALrr6Oz?Uv?tBfO9>3->+wnX`f3j$xvgpjs-YWrj~>dFuA#S@*|S@3pu;-@w79
zlN(-Zb9>CVaumw{sMY;274#rs$%R1z2+2$Mxv;JnJlV&$jnLJeEU&a_1OBeQt#?YL
zdaoJ4h#KwGdW{TD3bEfIZS?TTT$Y?32%pBjAM=n)jHd(iE(MR9zQ$&J5i({ol4<I#
zNq<*1uz<9A1m`V$N+JXE=q?`E=rT0#PJdB-TYQ}M_9xnzlfPcqfALgWaH4T;P+8UL
z?ZyKy2r7hv{r&g^yX&7NRr7#h8I{b{SX%`rm%Co&!mc@$n)qbK7VV;Tw+n3hpNU=u
zBraE<XE>ggwTiU;!?-woK7w&wB?MQy3~jrnmCxR89cxWnqo2jaAL{XE8<K$-v$p6A
z2A>`4!v8QX(CrJAoYnB%^91(B(LG<grs-*Q-n&fn9Gev=x(UyAAVAl<dA47EASnP{
zX;iN){tpk6WC#Y6Y^WEjCd)zE^x{!zEvQgz<fC;$>xbO_%d<)5f(4_+zfPS&f_9Dq
z<B|WMtb-U&xG5vH`}-3Ep1bEi=xkCD&r1k99hj?QxA>odaRGHOzCEgWN*uuLsQq_e
zwDd=qh%qh36a0^rh=+rdoCn8wMEVQ0ep|;I;l8KOQcvrKpFL}p#DH%wFtFhoHd-#;
zoCl?~=xMe;iJo<oJJW=w&dy6dnpjzpfymSi%a0!<A}1^!jRTs6x^d%zyXaludmrwA
zf2ObRDGm6_T%?L}{uKFH{=LZ0K8Dq)={8n3Nsb;j#~0hk=i*vHHiNH13U=Tx5x_Ko
zxQUoAnis0Gg)}P@Y-!jP`O|VQd1-zTDCq=9B^H~0hB1La6`HU7_qSGzo$n<mA_E!u
znsJS9RXriU(><tSM_e#qhaR4#T}b7bDoEggCw}rq)ast?tHA%>SBA?zTrkRr2ItnI
z(5yzmxmwxoAs#z1^ff|iQ%qa`sgklmTE(p5{n8I$CzQlk$vT59LB<kL7x33A3zCqW
zsy!2#f<T}|paex!Amg1i+$rWNd2)$&gVyfEE!&YTkmA2v8vf{XW}7-+f@dm?ul2r1
z$3^zJVZcWHiwxn^7RzaaoR|!==yIN=xXM~^IT6XucFQ~dZ?=(;?Mw}#>WC&rn-R9x
z&<JrITI#^6u_US!IJA_XI*{Qm1G+6|rZZgX$Fc&;n=Mqb0!2u_e{AD!!y}^C79zP9
zna!xV&|A{}E@Ju50y+chS*O#*SAmW_XvFThSe{nLxdah=5byw;IT$4_J*_t5IP04z
zRPy0HnFXXo!sL+U<BtP7VKOHaY|u0D60y#tkSz<0^3~-pb2X3@n*GdSt+GdNiZV?&
zZ8WGng=FSFW_vq6?9C@sG9GQf%L`FEyZ2ykq&@T{A2%JDqV4CqgH4ljXUnLn=-q5?
zcm4mx`Mq9(AXCHVQ4QbSr%-So@~4E^w4wuuaKRNS;ZuY63X<s6YXVeBkP~i6vi!^O
zln*51Ti$ijQ!NRRPa1gg0r;+nhaWIWe~u$5#&WR3a+VAYx!X+9+x+1DO|zua@rA1Z
z<Fa0VCzu#*sh&vpS<|B}f+cHP!cU@8!TCrG-&W)Hso<e}lx@BjS`@Hm^-$=^rjwV<
zs2cIv5@P;eFCnXHI9Ni;=;#X%r*?Zel2kQcv%5UCOhenO=4lF@GcV}86xim=Yxorw
zU@O*3Yvh?3|G{P<Fl2PNIk=;eEk9jav-<Le&t-iol8AstNEOu4JPdzhYDjZxbfodR
zanHsoC&?g075{yEz*HFfLNmNY_}RVq^qN86>X_N>0U-<x3>_uSw}aWfVImnz;k4Jz
z3_&0WVdiLe@@tfBneo+<2+ub9O#pDLq%{?*)zC%i(&yN+nQB|^@iTxLcFem;_^1E&
zkqP|DZ0_iLW{+{0VBil=e%o0mPACXZCTym&XEVWmY=6OG%hqhp*FPO;Hzgp7sS<XR
zKJ{$Q%-gB%qt#1-LF2r~1^f=p*Ad~t*jSnrK@O*X{||4t10L^e&_(tSPx|W}NhOj5
zXU6Z(VE^Z@bfCunPL4V9pI<$luPWl&#lMg9uc!YR9^rW;C!OX^ng8{|*&adv$CmvD
z^K6w*_u$_?(cAxAJvkxQ`!l=nZ?B&HN(OKGKh0L6M#_5vd67ct)L#7=-rq(6O#{g}
z_0LZ~8{YUe3EO(iz_kC<Xu(+R{!g<dS|v&<nedTO|F_TnAHRA};0gcZTKpNFGl0LX
z)g-f@IZ6x%Ui9UEumJz`MhV+jH2-1Jryu-Zk@;V8{Qq;2`LCFG|JSnou_ymB{r_%R
z{wpT`6_bCEf&Yrhzf|Vzr~g`$|5}s(y0ib}`~F|Mv;SalK%n*isSArD)dc;CpvK~S
zCM{$!fI0@^c1BaZ0Dw3%fM7;|2Eq@ZYcb4=1P&+Gec8HuZ?5p3dg#ogAd8;o&5!sW
zZa%bDI6OK3y3lcn5L|*tW&r(TGw6oH&KmFV4!RD3F5`s(O2xRaM+3i_RQpegWElic
zQ{2W5SN>P*(@he6R_|`&1T{2X1lNLjpdhRXRP{4|inBvzfv!w|K7~dY01QmPt#udx
z{mX+}>!0(C2Y1gl5fem27iJep{@2s<cveAY%O=p(%H(i&Ejyo5*Wv9!@o2__qy62<
zP!qrq2|@5m$~8Ad0c^PKm|^bPS)?LO0*a$v2MeBs+yAl{5?$CYut{kbDqJ=`f{q`z
z{41aRmJ|lfJyD?lg+nXEPo6R>9Yly8i%&NmAc?b@r2;og|7M4Ok*>nBv4-dY3&b*a
zBw&v?XMDEiY)K%5f9d<V_>w+U)x`r9{kf&<q6$IZh?v{YKW{GdsaznSVS~2PacPiw
z__{#o+4v|hXm((~23Su&tqpgV0`6b~kTZ5pSy_O(W4N-LMttS;VuIl(h?_|WR4ONs
z%ln`Z-`*luIZ<pR-r>ob3D`Zw61XMZ*?Mwe2`%fS=c}BK?-2V%HOiv09NgqDzi8fG
z8v6Qc3RICeR4>tcY^u$jmKDFnXFrmv5jl-jnkt|PN&QMMNiI+1Hw%FZf+4PtX24wZ
z5wttO-9fgUrL4Up&NX^)x@-rcCnVwQV~XSiH9Do>vQQFg$8<)gsZ-`KN8&kCaF&Vi
zL4Yt*Ug-W~B<HuGpe^o5Kp><DSgJ{vsbc@6Z}88D98k<JlAg{<+y|6bs_40|$?O5J
z9ST5(-#~Yxm*ZULGnQ-RJidTMw*!nYt?=soo<{<pLi+y64N$^C#b+F#f6+YnY`tTk
zjL5TqS~7S6K0YOPIN+sy2)fTo^%^S)vHV#-3-HOk#0Dp)67Z5VVEqUA$T~!Fppotj
zc#nqdHCUD2PbGY-{gW|9UI*Ej-<p0vKveoegeGtR=Z}T4?_~kG5~n{;#rpSMNv429
zbVQ&(VFW1pC}aNSfV&E&F<6aRfqAx(e4Nm8J72=G%>_A%FE8|P?LRx96Ln=87Wqqr
zG=K<wnHu0Z6`|kQ;IYY7JnkLlf9}S5f!w?gr~&Y_>rfXXaOMB=OZEP@i}X$4W_`~3
zXbAw>3T(#o+>x9%ReNb@1O<RVD*O!^!{XYcbC%#>;PwICoFyr^G{>{=cmQ0S3Fzx?
z{S$O;OF^UI0B&ReP;{CAHN8}*7;^9-+Whnq!8=3Z7h^MYjSqSVFQ05ahwj414l2&V
z<0K(4Ovdl);BGk#sx=M!7^Ux7+5>Y~>{o;MX%bTH035~dcFf-?kmLYOit+a1!1DHE
zJsgJB)EZw|nhV$%IAjt@2b(da)b#*dGwf@=^#bYo6+j^6pmyhTzcSS8c<qL5<fPA%
zk3XO_E13Ki2m>=S1auYlKN_X}q@NhXfUQc1blqwO<T~8I66ckx%jj#%2~WL|8jk0<
zy=Mm)E6PtsKnHSTz;zh~__x{%@$FL;OkNXNi314~d|L;^qzc@2O0qDhUh=6RheKj4
ze7rk30%%9NQ6f77X7mFtGw~zUP#X^yK!=0^++EL4dduOP9||9HzZoyl4~jD-L(5}5
zxp^8WbbZiMis=yynqukRZ~nU!*7HYJA1&F8<mqeQ>1vMn3&^~#yFXr*Yt-1%;klh3
zQAC$kvJR-E%9pA^p?~*ReQ`nIl!M=|&VfAu=`JMWn@<xh;9?vO*Mz#Z(VT!n{+VUO
z2tXle;K^>~p44Cxf{wCjO?}nJTV;<YOZ3CDOli>LlYzzuA%-A&A@*#tTf$c;A<>kW
z0~A!wA8SA#1C#!o$96!E%ADq4Re+7l=DF1t=%80x1WFXF2c)7Wkjm|wOG9u7VwCON
z^Lzy8wneC3H<`}_9@YwCU}1P8P^8l<c(E%`wm9hR8U@d=Nr;UelGC+#es^sW6~y2E
z3|9!yjXJGKf0_C4i2mTYODBYVd7Ak}gWpGZnQ|q+Er3W)(ObkdMc&49Si5Ufv)0L~
z{DenQX#SD^@O|4?B5=8Dr{)uoY}(deuiAHyKof;*q$+yOt{doB6+UW%&Gw{My6r>)
zYS`vNTy?~g>F;euY&T^XqQE-ZQ5AK@bKB>Bu&mFoAcK#(F2MG>LOrLro%=y$>IgPr
zyoghF?9Xo^YM!gU^i6;^iILi>K&@@(*)ZV|`CTb2qIBp;gE50rd8d?;_0&iFjq~ID
zaLsKI_vNnBqtmAXO4kKEe5Sh@rhL0uw`~xBQQzzA0`)ZpO-HP?-sIGiS1M>kQFoo-
zAJBzf>m>6*;Hx5<pYL9EOqfuRN=69cGzfxPO<+u0LEH0{gj@>8jCQDa$C@e^n2bN@
zpzMQ1@{og4WsBRP-WlL@Fh2xkq~)LzHoIhfZzi$aEDHfR$qtJM6CKZtJOdmo!kyYw
zRvCzr&aDx&t>gl#rCjH9ag21joqWV#bv`oZ;7LF6RR&ckMT(7M7=I0%zAEk;4-gQc
z9xB=>#MWmH^oE*^XVc$nfzMx<2hE}*0KbPs!Htx!02d@n0Q9hI<#&nx;;@+m4in%&
z-bgm3fpe^$B=0J=3K(s5SLDKMJ^=~{nO`FC&pbtOf;I^viQ_=jPt}PStTA7t+E=d2
zVl~{Bwy&ORNnLnlno7zx#Dr1rXZXoEW-=CB>E+B4-=eOgIS^i!?Lm3qgzF?(&d9V$
z$4)3Xiy}EQwPj%0tBAr?7g@zqsac0OXpN^ntEAW7kDN_|h$~j8ZaobzkBA295D;!f
z^5I9=iiz6=`GE#STN9LxL&yQmZz2f>q{KjbVDgnmqf)la6?F9xyGYKCI~zeXz$r}b
zc!pnIVZJMOw)^L?@}OG+W3m!^W+t*WB01G0%P<_^B-~HCWLfrOt<A`mxjB#)yoyOL
zSLQ82fZgJ#_v?ND5U4)TDO=x`*?A3%FrP5d_s^E8KwFkfj*8*@h8vdSRE`yO?Kjhp
z>k>C%6%qq1#4UIB^om4;TLeadK)+~Qy(Z<?1c7cWz7%RKjuq1E7_pl8;)F}0*9I%%
zbZyqi;E_D~+z_KPDC>Cum~g2}H`+x~fgkZ3^X}Pl5jDL6`R&jfZSQX>x^B+?9<}Y3
zXKe<`oC@5$Tg88zLR}G$SM1qPb5?7r8?dRD9-)my=17Tb>=uF7U?uwI26Hw}O~Ie)
zU+zfYH+-GNTo!Sd?YvPWc3Eioz`Tp%Jk|>g6A_-LEc-x=7t|11Jsd6kaEJg%E>X<G
z_}dHYZqN`SM#wg~z@m@ao#C&;v=mCR6Q_;ib^{(VPKZ6+ZA(7KqhGRFmfnL2G>(JF
z6-yHS03*8;-!rNreDahS!(G-ZEuHMbttwpDv$?eLr1!U%I92Yfy*x0i1Q@_6sGG(J
z&j5sg11!fvke6c;rX=tds*wXYvc~t2kPjPCT$f^a;*%Fod23SsR6tfWwzS)$d8J&p
z7ug{&Aq43Ic;-ZBfgc)YXDfp`S`|OQqe5teA2{q0cw7b-Tn!<#L-XWp;LM595o6lD
zv46uU8{+j*ngWn7IB?h|@Pq(6L7^<q6QqRg=@O@wlxAJ$w1+e_Lu`2kFhJP>9<l&E
zgRViv&?D%?F1L83|9IIE(#Q_s6e$LI^k9wt8f>99Hvr%&i*7wE1;lPBP*_K#Yw7@8
zC3DX@%kzKy9#&v;`I){}tRsQ*+%Yn$!=5wyC<E{o*tSM)8Y?75*a0q!W`LvXTpz0=
zga3goqJaNocK|h9FCTpMcRec)OR=16Q?!+-cFGJra21?;iAy?+O$4Bgg9?quP`m16
z!m2)_YPxbzCZi2NSxzHgZGc9O0FC^N*2vp)2WNUS`dOnDV&+`lJ^AfVUuO2@VdNDn
z&(^;NpT`13QBoQp;n3`f(oy(beE^L%n=Lm04xnMLa?n9j=QzzG-{OO`KJb764ln|g
z$qW|GJl-aLQKy3kQ!SFmLUO)RHd{tCt2sY^HwDOS!lA`Y?E^ON6QCAtBUk$zdNe4v
zq9-~T#BU6ott^oTAqT<=SY=3w1}sR=FNxPjthxg6)+y}e+jWn;(ecE}+NOf~Y>BhL
zaV#AG!78Uf#1#(gs%`>kFQ`$R6b73~^s2Hf=(@*eP~)vyAAxF(YR!3EHw7qx!U2<Y
zgD$EYIIK9LQ!pGd^;46BjA@Keix94IDYH){`3ee_dtqBHfK|U&>3-$7<cc2T?W975
znnQNOJlke*UDw_eK+F1m?PCdvUMR2>nZ4Q?%i3Ci&W2hnrLa_V&H605YI*^V8<ymx
zR<Aa|LAv?)IRqqxs1=t#6oQi=DfS`o=)xej2bfdx%`$rwkJnxxAd+i@3HP4ruwiD0
z{gdR@3UYAv{V}{cESW$cjDSGg*^1$C4XOfgK;z%Fuht=~?#eG%QNQG-3s>2qKlc(~
z4O^rCP-P*!>~EM%3=oGzY(p+;{E)$c4D_l-4{Xfq!~^QEHwDoBj*7nXaT3pPyJmH!
z<I!gf;5UB+&NnJ#5XBRqrE`&2VubC}0G*2%)jX~4-5R~qHC(jkZl((dYY6(7#}m@*
zOj4M*;e;!m9yH(xf)1MBUq0(-MDEiFJxdCr6^X=WPElW1K3ym~C<eLyp}XARk8+J{
z=%8Vv2ELd1x<$%-Bm}VD$4F})H?#7sI0YIHViGptdmX0SDc@~1V|6!bg&Fs?$D^8-
zM^YD*MHGfEwC>Kjr48SbQl_=frEIxgU83hW_So&~&Q1P3x*2EAcu%hZJ{N;g_n55(
zS>xY;-Tb5i0M$!I`=;E=7a2vjM|B7em+88*t#rQfUZB<q*=aUQ3|pbyL6L;0=~wXr
zPOz;j)w>h;F8lSAsE~^@O@}gp+G6zOmc{Xl`3v0ZDRll#k+If;zj~rLl`NGKsUk{m
ztN>p#T9uCo>j&0*VIIDPg02uyz2pC>gk%&MdA8c#KwyHVBuuP&fv9wfTF69EK&~w(
zzI42_W`T3=C0e(bSu9t;;v?R0Swzus@mGdven<7L<UM5&xE|GC*89B{@7xzG8}AMn
zYz7HE+J8x@h_Ra;FWT)*S|~mZIT$)QQkwZhx~`@dIoYOe%e=gMd{ntJRl)i7UF>qq
zBYw+;A{|*jI{Tow(Un<M?517;X<HK$;6SNWF*_4t;9y}VCs0PHy`50lO;<<Y+Q|Gl
z1|_^F6fW3}1IDpPaJZI~KT^Iu$3!LWSy5m$F~4%@(ra#pHvtmi@-G_`_u?;=j7vI2
zy{h7H(snp*5FD;f+^eIXdix3=<!eG;>SZ(f!51O^^y6Ze$tR7*)eb`OaP@n-O#IVg
zi?<pIkes%maD2{c_wl>JOA~=QL7UczzT3m<0tg$?y*fb0M))I^b>(=&W9EZbx$O`0
zfhR*&mF@+$;S&moNvoogWEXyqVN{++BhLoMk5;>ih~vtm_VV>fUL)h}l+Z$lJ#W$N
zH@YG=tlDz!yBXNa%8@M#zp6Zpr$R5@E0cOX(NdlN0@Q`7;8+1X{acCfjpTbnT=QdK
zGefx`rTUX9fUfb487^|bzXCw<J|F02ItQpfFSyE35;Y}wuQ1idf*wVUAte%YZu`a7
zH#`XMNO0fYdblSZn{}8o$81x@PI*6W3W>AdEuv{n<MGxqcP=fH;c)NdNPJH45V1F+
z$kTl6<`AZjxTzqpJJ?6^Z9U#y#jrx#L1?;SL)TVeMeoYqBz>zlJspcxuXd)%4=<O=
z%T!|4FNQaot}j<_9UfQltyS1p>H>zb9G}CVCx@XlZpYZx?6Bvh^TYP2CVGb*ZGl$T
z3hg_khYhia<po9j5cnl=9mk<6`&J=`(wrE=6YchxXEKTe_ivxL&-IL)EGvK>^X=Rr
z2am;{6iA)(amA>bkum87wo(joSakk!0D(7R7>5ZpMTW}g>_FjlYhj-rC)D+(Zz|4q
zXFwDq18-NEaoBlB)NVaJ5J68kYM~P2FzT{S4_HeJJ9^-&p`u3Vmu`Pv;jo%HT6W4?
zSz|3b$@ZcboxQ2Gz^O0){hQOe=<-_C&T+3pWY8Zhz`^nWpOfg#zF?b{ro<AAo_WCC
z)8bqx(Q|T0Y&~}iCNONf*D;*02~~<;9_llp_u`t-vrR?VH#+P@;$KW)G@~8T??o5|
z=fpl+%4*ES&Zm!eOSrQ&ys^F&EbxxH5y9lPRI$Nf)L9;tb~F#qj{f+SZtNfd;qf~l
z4QXcLnIzii@ii1T7$B@eyjNV*Vt66Z5&L)1xiV7&;(Zhdh$4M3FSdZ{hg98i#|BZu
z9UNnLjTy<c5_foi^KrS?k;R<H^o@&2GA}v(2%TQN7`K?O+$l9_*i3Epr+wb(^V(<c
zeibXPo-X&7J}R>^RE<O2WCtCKe&!l&D(Na*xl*Z}PH@!4{M+MQ@5u^eJ(xDB9PP|y
z{*_3dl*W?jV5H+#(GyWU-SveUAMxzim5Af&LWhiU-#Ni*j|Or>Qv~m*+nnGsV0H?F
z^x`Ve3x*)?4i~lPCGyhCU|wASVf#Of92yT|cYU1yH4&mpF-o{>Z-RH(g=0&Pr+WK6
z%`MB4irr7*&7<YZ6QlWE7pMy=n0Ifu!ODgOT^>yN7yIAciE$5gtLQPhY|n}u?MbPR
zUaDHVyw|=x)H={e_@)rE)&JJjd_ae>^<{mBQqQFxhF`qP<Mm|MJ>lL^0o}^d&cX=W
zb%dZlty30fz?ZHTUHSc;(BmC1R8XtuG@j!A(`_nAlPddEHN90Qa7Hm?L9^+%q5w3@
z5vy<i^K4cd`y!iWEwbNMR~}?%<!=uzbCY_UbE}N1nwkAQ)3gE3EVpIp=XY70o#gso
zDDjtwg{|0z?!<c?*1<4u&AeuvDj!>B6bz<<(F%-~#QeVL{uRu^QCZqSI47T*p0zrf
z_vbBfw;Ef%iK(y(K#;izwDa3Ui+p9sn?wTI2l-dhoOmu*0XFZYssr5}AXm*-2BB<l
zGv00-CG$|&q77i)-n|0&r~ZfKMnh{#iRD~@RNa4IL6}K6N}Js37c92)Fs67`>(4P+
zcF}WTgty#%LC4N{XGL)*TQ}7zR^Y9N2g_K>;>S_vErMV%vv}D4`1U>06}9b=K{u{O
zYST;k^d9#^sCjE)VMPZ7L#@FnJnvuvBR7BO=vWzvj*eAszB_!jO0>5ycEYXeG~7i_
zdeXsi()CpTWOW9fx{{MWLMyUAexSosDP5I|qR=xk)4IXKeHBXMUdDbW#`Cn_hvpWD
zg~c@g-M~O_E(vR_cX4Rf!S46RX1?E%I`Og=txPcY-`G1rc=3pnX|E&wy{Vrah_w&B
zimc;}r{^mBJKJ|*E5Qw!itbBphp)58DC6w%;@oQ2)<HI)N%8Bk%yJyRtmiG81mJ|2
z3_Pp++H4(P9Hl2dyPO~n9ETw}qaH!P;i&d0s_Gy+&aTV6bSHPLBrU8%TqQ(wQT3}?
z%fppA*NPP$9Tq9i+Zvm~lKWSI;S#PK>&hH{o#M0@=T;wK*GBtOx14@w4n|2x$7FRU
z(mgYTr}f3H7NKKM9f@<3LT<exeQk83=LOhR=l`^;b|k;o%sgl49)5L7oZWb+?baZ-
z`goiCW~Dmn;z(JUh=v%V=>D|$LDp;$-~ncC-k!}1E4D{ZpBllZ07y9K+?tvaPby4a
zR2F`7Kd7#rL&`(G&W>g#>)6iiokO{y^sTgelU4=!)GJl8%5=})TBLPM?$yhr4Ev76
zx@a{NciU7-J*f%6A9>*Xey4F~ksYv_l~}HQoguB<-(Rq64qwp0yCLEQBx|GzKlP`E
zjtj^#!7G}bF+sLN70%GSk(}HG91eN_HvIkNub>trks!DogCK^y664`gywmXay{~kM
zGhE8Tc~J=W{qcy%O+2x2-Jw}p>Zmx+vT~#AC7XRv=r9naA4v>X3NKX=Llu1@?G_B8
zW7e^$Dvf&nAZ+Dvg9s{{%5FY7P}gfK#7~B&k_kF8jt+o(IDwSeU)?YREtOr2e@i+E
zhE^3cg%=t=h+gZ(zrUr+3D>_Nxlcb>#~JzMR#A{mjyPn~5YKv;N@w26&WFsU`x1n|
z6{lm1waSzKn5&L>{k<U;M7uukG34VZ$=}97o)swI{73yXB>BDMG#Wu4N_Bnz&SgMT
z`O<xT?$h%8krp5;uz~4vP$t+R%Z;F06^kB~ue;*EYv1yDbusQZ>1r%ggef~<zs~u}
z#4=VFvNN%e)|8&8zf|_w$$Zvc*dZoAG2X>*v0$l)GuW*;)}{rUl(m_M-np|dbpH<E
z#_0`g9;rSq+!V8qwjk-#<t+P>6$FpESiaNMXuQZ{{jB5RlciK%S}_Cf#lnr^N?@BT
zL2%TsBDMrg?iq%B9Oa|!EJexr(k@!UJ8UYVCvg=A9Xlh~WMfB;lymtf$K6(+Xr<^0
zH)}~@Qzz?i!lpWW3M6;_=dZN4pNAinKM$+h8B!@as@7?qr<;-c{qlH(qj{nwFH|hj
zZQ1R<b>eZ-o!oI@mz~NTlfaWj2DhaynULFdUVF<<j^P4Uy?7%gx_(=PfhUaBalEqA
zVtJ|wuKS8#X^U6bE;_ETc!ciyIP5n>D#4Vrzw(1ta{fraKVG>vkTP7fl-a5<ntyoQ
z)SnA;GQMfwCu0%tO@42rXl0S^O7;QH0n%-K1dwZkE{?@rcB(xxvA`%Z`i9IeY}Jj~
zRTLT~hbewKamX6xvnaA4F+mg-S&8b!FS^c`&X}yGia&3CF{ilFw12nQdcEyrpQr0Z
z^6^pgOoCM@{~Y9#D*9cD4AHTs5(w5A1Z?pvlb68&C3JmCIs!RFeoi!Y=0-K!c%Asa
zKUi6-Txm8jBd~JTOK~bXUTmN?Suc13Ykb!$;Ceq)%J^4?c%;%`u?o|?JUP5zm3KC)
zb!u*`r|9<L_)7DxqJP;7#gr%t(|bY3rT43rTW8`50p)GxLesd9hw*Obakq8+Y)4sU
zp$C#PIQjb+vBdaEz7yTJ8u<eK@p%PeY?)1@9(JXdYK6DLN+oB&&ACcerjJCD9P)BF
z*FNl!xDu18&ON}EalLq6jmrQV3-=n%u9xYy>A=gy<;CTJ#etDAmxKf7=Jpu=v4b{0
zlhGqnId3fJYyABA7V`EBBn;<^uO*=vUkK^QaB-MfW2Y5r606F*QtVj8araz(V_f06
zfAi*NJ*Al9$iS7NhFIO~beeJQqPq(;B#e|Q?|ZY@izVImn^{K~_3VA`xKCdi+`rh=
zLTlUJl=m^$`AGaLTcdHt2hI)71`}6;;9Yx(&}E$Y0nGYDSB}=4d^pRK+%{Umf<9xs
zTv9L=9@Zq(O!EEkffH*s_0LSB8F0dSBt`ukK4s364mz!R#_Wb$pN$my<thMQlCY_y
z``v4n-BVmMg<6B!1&@wgqbcY@%o4fNTukGy!5x=`gAy=P){a8OTi2?z%b2u_v;02=
zlGkVOQ|5SXpdXiZIn$`&`&;MKhwWL?vHD)+NT1`iJiL1d$>f`#^~oP`RE6lw6`PQ^
zR{639TfRh4-Lmsmdc@0Nzz%=NmU|iZ&AGF$D>$mz&se~(C6~{Cp&(Y)-_@|jF4~#p
zrE+`4XL5s?i>!y^VP|;#m!V?fo7_|zeOVDl?ew(%?JylSajDFDC%1`PqV_Uz<oTd|
zKsb-?;6%TY$-8;cG}<ygJ$oM|P_BB7eG=7rG+0<)GM>a`w#dfH@9&o#v@;k?y?#Ib
zhrL6x|D}f2(aKf1DtBSOa1S3#%^mCY!w8JMo?_w0DCG70S3B>(aBJ$Y3ic7<1NPhe
zEsPfk-b_?J`*5*`cucqKW#<}c@Qee>K{<X_<)N&yP8G(tX7+{-Z6m+El)F6~T16)$
zN3S_ze(;nB%?@3B>wDq-(LvLwOHv_X57oyxJ44NijVwu)C8&9JvaH1+UsdUh`|USr
z?zDPcjA<3-ZASKX`d4`5&TK)Oo0ncnE7$%S;6zzSHr!XhiyZPY(W9br%CYQW8Tj-@
zK(dM}fz;n=EZdAHl4d0Z(M858a{WAz5a?_58AdoKU4nt1EJlKKO_vPT8sSmL_Hx8Y
zr?}Ia+v|IA%-5=zGalV~!M?H?bm@|cvJVmYM2l7Fgj_|dpr!OmfSm9$%dMvdk892M
zzC2QlO4nRdx&J+Hi`qD!He-WHzo%7gU|g<3ICyQpE%pixwSSLJadQ-$iS>h0o!{r*
znpQI{&Ptqi(#$Orytr&zwHp+T?h}VD4uqG(X7X^Zl``30`Y!nX5l;*GqX(9<7)%lv
zPqAo@5aCDc_`RM%cXMsm8!<&3C0<nPQ{=uI7=2h9U_TJa#FFG#kJKtFcb?-b3%yk5
z6UMqG{kt*e4!gWY*_1=f@lo>g2=nQUf=JE{3J)$6vczw5#rvaBHBIp>U&IaO1kMoh
z4N}!&4GoQCLbWg5m0nE8WiE;dnSAz!SB{Tr^9g^GBtB>9K=?eqeyRI2yiX(gJxTK1
zwm~@O(-rX|#y^Y8aQ?2h-Kz~?B5JH~gz^HO?Tm_Y?K#l;efoH1=TKvW=ML!`A>WDV
zFFH+8JoHF1Zp*DZ#PAk!*~t<6-5XbTs2QZ-5u5{)ZAzsR<`vTvZnp{PeQZ2;zj4PH
zECr(i5Vkk<)LmF8I=^f2VSjn}!JNIL1QuO5@U2fC`pnzsWyL5>R&*cUBtX6nBWIV4
z&bpfTf&+DI;YgG=)AE|X_uj!}nPXY{TSfZC3-$$sIN@H)qh;hQAvn!yzXJN|XEFnt
z)fqm^)E5fzo~L~;P)JbYN1@#kVc|6@p`R$E^_KBv^B{^nUAy^CW>2D}Y`OI{yMps#
zx^J%VlkIJY8$>vA(pKG-*UZ^e*9u<${f<ei)Npx!`Ji=nSmeGn@%FtvzFmWFS4x><
zG$>I>4W<FYKSsb?kSGbU=Euc<k7ShyW1E}Nc(~LzqZQ6zyNpQDB*t&)^1axKS@9_Q
zkxo&Q%~D{d)#SZsV)EC?q2ktSy^9fq^vYL4oj_+zmpDtKm5FkSwS-D%VqGao+x1u*
z)uUiM&2S={txoNq&h^C)>#0D&Wt3B(v;EbN8Qz_)iZ|dheK(8JzxfjNRwwq{dBTp*
z4$qn}#e@_lN1<l4Lq_<yrFK{Py0B~<s`ok<jXteN!sHBA?$-P?PgTu_pJtuO%2t==
zHmmBL?{~PWAGtMiFoazID<>t}k@TqX+~Hv>z4=%g@w9TVbQj~aI4P1}t85duG3p>B
z#k3GlGxBO8>e<00Ye$O54zZBe?~ADlWVXjhFFC&NLJ2PW>`X!HcT)vh2Vc|~>a>uz
zspefjQ)giI86-+4u;onyn8w+$7PX{_##R$coL?W_GoEJNCL)~g`I(l_zbM>~h<o16
zZ2WTgUUPyK_u^Yl?fO{V@T~jtenKyMyG_bEALLqU?X~?psn|_k-?TTW7`Pa7q*I_?
zS2q>IsjZhC)b}uZ)AQ@)2YwePb6;S?{GuxDOcsU*2(2)UGBB<2(@=|#^?|lBo$KEy
zZK5eoUFc1*d061C<*tlJ-#KRZDtoTfZUUb?@qUcqPmQFsNg^HH`i=zOu6)y0dXa;b
zVbcs^0;NQm*1lHX#d_v;?bif_wewzl#>=&Zd3+|5^X%!5j=mLTD8j9!i#`3mXx2L#
zU>=wsxYYH6^Td+5VH^5z^w;QpZ@c=~{EmM4nl_yNvH*tT+~aR)ZCBpEVc^vGE`Ds}
z;n7v?ArecdP`N&nI7>_X3a0PLo}m<q<F6Us4(`xH$nxo@o?0me#of+*zNXvij7k_)
zjC%Zi7uU{QEMBC!vJXaUU|l8?P+lJ!U)@ias$v{|$DprE=DNKNKYY6HA;sr}L_-ez
zM=QL+@pkoXp1<u%z|hKA4Hjk??a!M;QEwO;b#BEM!x|Eg=yW<F_?HfMGU2>J);GUv
z7*4DpB6uA7-_v~IfJ+bazP2agZ(w*q(T=<u+TN=bGn#K~O;hG*d2OZIX+?}twxcFG
zeD6Vp<(~7^&v3P``-Ks{3T`dr<O-HjXX^nz`T{Weak$_IYpI%EnU^E}1g$oYkw`q-
z*GDz}&sR+IHHmjjqnIa%R)u-H@)(&vwQdgd64>2}I;TT9Ru}{iYIfk&U97HR5F^;i
zeAsMT66JMpx$=5S&O*)I(i`utQu=FbEezZ&M$mqpGf*m)$^V2W%lr)9z&Z8S#vMa!
z-!hZtsa)ddx=zdVl$N&Z?OGP4hOCH8V>j}F$oTUpWJ{I-H6+ohr%NPiHny#1xiFCK
zdMgu?SicrWo{DE^pgbbV*|FuttA@`Jj!IWsTOvLo)2)V{K7Vs!kraWDSLu+bX(Icf
zpbK-O;QJ_#xsb(jU&pWJ?FEh8-@Zh`wK=qA(-iv2pX)ad!>PSeAJ<Lu<m~@k>Mybv
z&(<sVDIRquzdZl&UUh=is&>o+jgDh=ldwu!6tZ&4nf_m9iUgRchAe(ll4t4|MO=)=
z`gbVIvI1HHYhU3F&>nq-XB((m#$}lj!6&cwpd1yxMsk=eZU7p_{=@pHE4+^}+I0{0
zjuANVR}!yLWQy5c4TlA;v<K{r9vws%IKM_br0i2<R$yo_yD=zW9mgEG!mTT5&@FVG
za?Pp__qwF&$7hdYHOp`7{rt8p?0zNq;PM-B61VzK4fVI5fB57Xje;q}y&YTR<4%%w
z!rEH&nNSgpV7Bo>l>3!v<p&$e{P0ChHY9g1d>x9{Pbf7cy)D23&MqGs-2U~_CX(7k
zv+qlC@t+FnqeN$%OhTmYsK@p3Js+@hFLL^Nm|Mt`EyQ=Z;2me5&9Join2>vkV=PU3
z0&FACa?Qj#C{4#JrX_+C{x!v7499Y`h%%V^VSRULitTQH-xUEyY_kq(F<H}U=~sa#
zZ`yG#FTSb`9XKiN9oA%r)5JWfh(f#8&@nay+(BoZ1}Yxh65jJV6vX$7)ALx3?T6@=
zL_BGvNJ(rDhlK~eq<0gUy$yIZy*X5zYc=LcBjnP(+r({CEd9WsMhd@|!zfQiK!{UM
zEtg2tstj@1RM8U7@fw^EQeBPojURq~$~8LiEM0nELZfx1OR6G<_x8aJw>27gW2^^t
z>Eedgq1F%kw_}-oHgY$C7ya#fr>cYb;P+{pA9;2%DBTVL$kZe$*F<*6M7mbG9^H2J
zlexm|FKQ<frzpTJ)HLtnm|0|bcc(MQ-*3a(_d)>ed>9I!bDk-y_?JR<bPLhiL$@iU
zkh)22Gy@sO!*fwy$F#Z!G6pltQV+5Vo~psEg;_WrDO71<z+!veosf4N8P{cV)tbni
z5Xd1nej;*Ivo#Y{EbsnH#bdD8;6jujJQ?=$o@bQYu4`Jt?d*;rF>FnLOUm-NZh6GC
zoTA%A?vpaka*rb36*umldMC3+&Z5QWjo-3zaUy*sO$q9E3?CaKo+V{H%bn>~tS|%}
zj5mmHJ%4|xZuE<C7H_9ig=Eg+ZD%6luutRT89yof5qs5NuL}!Z>EQ@3*2)S90q15L
zPL(n=tRiC7BZTpnzTt3AdvR@8aq7)VzUp*F4*l4^&nEV%Uki8X_C=a}FqaA=Ig@Xr
zj`XhEE`AqwnO689iTyUgle+H6jp3PjAJ+ua^+^JaFC)l+eyZJL*}BML(#8wlY*bmx
zkM#r^gY9HY?)|4=qDSWCqMQE^X;L9(IsfwTw}d*`9K)Y10Z%D%v7<F<(htY%?8<Yt
zm98o_8!XqjMet^DSIyk3FszuU86XrNLaI0}e*dP<YEp<yH_QO-zh=8WlYb89G3#>?
zh~e5Kv#E_M4T$GeCxG?#$tK7rZ>4^6uBX|bSS5DPamlw83v?cHUwRbIqkdsU(85of
zd@OH2*jO=$4PKCNcQF)_blh}L?z{$eK~&2oIsN!2eJ`2ZWSMIT<<@=NlLDU&<0gJY
z;9k4tygg^w>u2?I!SxG*H-a<fJafY(na)mYz-{hMSkG2PmU~#&c4aEjyV`nGvakh}
z<L-%}$GumfbcgF!8lvkGv&df_>M8~}3H06=`^jM>NJ?bNU^)H%P`10wy{1XcI$3zH
zsZ#$F!gl4*b`xyi{`I7unPjki1MH)fPK1UQKXYD(t<`n-J-q~LZ*D!NaeB*nd0wMo
zVj$P~_nujsvXE{6QRg@lmv)t2krtmIfv!kVr{#+W+2(%lXy5(`_MD;MnMaOKis`({
zwWJ=#7v-x-md~Q@4+tvTwDS-a6x+0~azkgq4QBB1jB2mv6Qcu676hA?mxS%>yI?n+
z=!CrWe!tyCg^C+9ueO96yQIZyL}}Q`JPh2$VliC9!{l^pNAQYvj&A-S?;2}L8Vv}%
z66C(Ou6@ZvWB%!-tET;WN?UY~BEva9f9wzWV|Ki;N?=!Jz$m?`i94SXf76xRp03~7
ze@wjmj-|YDu5B+Bk?S_NdJjD`lFoU1we2OD;`aF9L2^!QW>J?pzLy_^qLyezB-Jg8
zuL?ZjOM~fOJ0Kmhy+=qD<n97fypZX8sE_$&O2O6j0>-^GiKff8OM^nx&n>jfZap64
z!wR{XqY$wDR#F-<(D6*|i{zeVqu5Q4KG|*F92K4WS4dw<zQRkN$mtKUlOYXSeEDbG
zHHtVncJ+!RZ8zj=NO8;y1ID?zDqPlp-=S-ou`g5#i@wcS!~{hs<QUo>+$1y3-_P8x
z#?u%YX2WmNA=+!GU1lx1e@~{>^fXLn@NeJe^GE>e`kgjR=pwJtrL2d>0jX}*sbhY?
zFP-K_WDX~q@7BW`Rm-2~yAYy~g)#N$I0V>m$c(!HgA~^oDH?VT*Ze*tYQg@ff@SbG
zKMhJ+H+xU5(&Rw)rn^wsFMJ**P8ov?4)DPw5=#<apK3OWd^4wEXh{8a>*uErPxsad
zh;^$TUw4(2ZV}t$fPe4*uEi>P@hX$*X4Clq;3&2jbLO(rd0o;GOYob2bSWz@Flx;R
zgLwRBJx8O8fP09O2!L)$?K?>*xSzwL_+hgp7I7g9q4wcB+K!((jt0Pyu8jddj|*TG
zAf%u9Csl%FjNn|pA!S8<ofB?3S>Fp;eS=`{$izT`L}A~e<MZo3!oZpH{bQ%9%l7M1
zMH;cO)94^%-sWLV@=NE6hsiH3JvVw`T!*`)kman_twh@1y_^1Exw^L&^cgdnP(8@?
zInNfYPyIOQ5ekVj(b>gs-otxN{AB%NnbXtPPbQ_VeSBTIa6s>MFG}q9uHBgJuPlx8
ztq&&E)@3j`ZDWw{^mKI|KUKiN6W3^B<gp(L(t4HE>1`)-o+S3K6w8~M6DY~Tahha-
zQ4$YdGjAbxYI=8Mv^jm4XIFphQYQihkqlwb?6OBneD3nv?m9OT+<{jJX#}g}vPt(^
zkA*0IyJpAcsatMPFs3@?wW+o@BjR-u45G%5T*Ogtn39826|Vf833M~PCzA}1b-JZk
z6lsSVOcd<wV<oT<8}T9OAa6X4AS>=@A2mA`ESMTFe||t><j3gc31;K5b7bPMOzY=y
zQH5j6Y~TIb^Ik5+dnx;mZW+mxCQ~UmO8+_W#<78XRWLMPdW&`Em3L$y&T`H7SjsW2
z(g_0oUq!rNN&<S8O3;7z;+XH1%2}%1@@mt*L`BO(&&eT6a(JX#(pg7N_BTgXYb1}4
znd<UqQ{7>~2p;m5@NdbyYtBokDEmuu%av}?AgUtcoA~@7n}#A(ULu1sq1aDi?>P*G
zG+=I*qZ&6eU@k%_AU9fb2dBDGW1SunWRC8hsv5;pOp?nZ<)P8v2Lh-?;M;xGeQwcj
zu0$Jo4J3~Iu55_D#ePXeR7*PMRiR%vXD`m$bI8P;emP5kd_ukt&?YM!^U{EEg1hS3
zB~p=#^eKWfQ4yTm9n_=p&=g~^3XT!R97^B$UmCooyK|);DW+L+vfRy##S&cCFyc0K
z<3jZqF>c)<{cUHxhsnDQtm7#iMJ<lEM%^)+zuisOEV7Kmi!9i5xUZc@MoIyDA=D_-
z^q&3kW9MoY{=f+CqIL{0Pv@eHo5WreFPOOvZy-gtynBi%dA`}~3T2I18lXgyuD_c&
zR7+R&@%QsOt|gou6<5&s8jxv!U@CV7<@<m~l;}Q`q?+;##=%kgrY~qCueAYE1UIcT
zM>J?ChSamokzw)wIwpj`F+r$uqwe~76~?43#uuXl&KnaVobXLC5i5FnppIq@B4|59
za^B3Hd(dO{1~6VyaT$!<wjl}|gN0LGD*7efN^aZZ^IO#Gx31kcm67>yKjWP+!Nzd?
z3hxa83b#-?{wi(`#Qek0Y{f(e`{gUEd*7rQ%y4u0^7O@bpD!R~*HJ%j?rFD@^Ooqk
z5w!X))yHs5kj$hPSZXL9@BE6vfAASmX=?B&bDug|5Qg_PvOOlkd}EK&-{jVhfsL_N
zx0iQ_hddr-?A|`E@FY#N>^E^&s^Bi7#J@Ty*2>5A2McgH^iDF2vxQvg6WxDG)KLZE
zxK2xzCeJJii3xynk`qpoD82{;!y7AZ4G6bL;mR&97Axx{@XAcD6=$hml)rm^w>nBM
zFFGL6^N76bXPVJm*%rkR?p^+;O+*Dx`p>y+O!wR=ZGXf0qG$Ao^@gQ19|4U($9(+s
z^BbP`&ncWV@^KPxc1_L@3A<kCwHmaF^hpn)5@#WTPIW|9fIm3b#g6)~{S_KrBn6?-
z_!QqwlGU3S?V8e^{MT*t+|5wP1hX^`BO?^jW7wGz`tRuL<3BoN49l}soR(`_lw#L<
z){OGBWgdS0^#y?&uTvnggtYk}aeS!IT<Ucq*6w~lD>j^mJ+!^lcudMV<sq3~u{WRT
z{K?Zpi&h=PL#fA$Po^%Fz7q~9(3#tHKH}!mFQn367GcSJB)z3@bUUJR>xd#<X9GsY
zmeioI>9VsdS}NNAA~n%)CrZ{B?b>OV(hOFp)6<Sw1eqnWn-X3~bz_5v-^eBYGr4oP
za!>?~15^z}&@o^$UP_cEH)fd&vY<DkAXawqHPBKwT<4(~Mp?e4`=t|2C7aGXC?s8e
zE$?4aJsWWjh1BD(vju;-BV98@K@1($5u6D-_}<`ql=?kj-^R5uMz>3whzG+t=Qr8l
zzqE3h|1}O^#0gG~xQ&i<62dk%<4K=HrEql?BG;m2l?AdJO_DW3VwA$~JX^@0yMkwA
z^}qY$EO<jf!o|}dVUF>|(53g7%;!m*1J0rFSh1lG5mE*RNBlJu@-~pi=Ngu1>jIs6
z643lH(enq{6{`pJKJUC`puaIduZ~07`W%?A`K<pu;1=>?dGd=2e;&j%ZVY~$_htt(
zRLf4!H&pzW-Ah9JrU5f~MvXCA6foXqX16NgR_vm~K^T5<kTb<l3i?k~#&N5}!0@E#
zC(@<K%AsJ`<T_A}{_G2dhj!+Mh*pbau)s&hym!3(D|VyR>f7Rbz6!8e-dK6ywGNq(
zkBQ*DbkLMf{iM@jfEymj3Kw4+w+h4=t=Me`&p?kLg0m&P{|)s1a2#m2nb}OQg7N=M
zL8zJ4N1m<~`g>`u@ToUZVMXi%)+{Ye7jp}J*k-fW#e(<CG2oxKIY3Ow?SnO#L$5*W
z@U`*DNncRFGt*wTOLjVxavV@<BJMacgDa?(?JP+_g^BBodmiln>U6!6Mz-^4?EC+N
z@T6|ws%8l#@+P8pQ5)o0yIwFJfCXeY&q{i_IIJpcluj#cdnPDk;QzzfTZTp1eNp3&
zilT`0(1?`80Ma0-AdNIL#L(RW(j}tAkWz}2fCv&p$4IF(NK2P=clUcnpZHz>>;3Zn
zzxY8fXYM)oIeV|Y_S)+()6%Md7fOg#v+nYSK_2|7Y*}<h7m_1I@r6kf+Gj)rv&2^N
zV4o<yUkm#kf&OPFD|->6i}YZqDgtp@kbQr>`TKJ|{`Wbu_rP^iQ}q(+>gvgdj}DS;
zu`Vu79e)<+k!35V@QBAAck-Vp`}Y*+RrX{^-===({OZ_MczxXeD;O0afIyfkZAdPs
z_A(G{=RRAZn3Xo-#Vp1LM6oBbYT(XfvLX2T0nK?MfM=d7{5cCZ{yhtQ53yKa$qicg
zwaBL7(Q;dj{3SXHWpXK9UCQ@@j*(!-P%U35pfInx#`}<SW@d)Vx{q<Z-k%ou8U=h-
zO-DGn1|9ie-izwJ|8~Y}!B<KApih*<6y5+1RFBx7_bLev!=Lx6xDH-|Rkx;!7_88M
zCR-(K;d^yzOh&JEUw?mZnY9KI65+8@Kt%^5A|`$l7iUI2`r&aPm&=0EY#J+kFM&TY
z7_-pMzrQjLntCp<^?M_gE(&CV)=n$UpNNtBZ^X!|0Kc+q{&VFd3v4feaJ|{(^uV6a
z=I2dj<>U`S{djo}UPLCCixhYK6NjSdqzLZbjU+Sh2ynjsDAm74hhy0y*BNuN*|5Oo
z{q`GIW$Z*gD-_5_I2HOhm4SacVaA+4>b9HU<cR$a7N2RZAR+78E5*!6h?s?R68APP
zjlIxHIazVMp^uMfOl)j~6t(bk7D*|odGNDvwOQbM!hsJ#wHFW!juQRVd8B3itr|=)
z+g?L=E@6Ig@QX@cPUlx_|9#0F@Fn0=i^;b2Hz@gSo<X_9?#l*phrT}4Ew|yWr!4wu
zN;ZRlIC-3d39E3+yrbh|<Hiue=4o}5Dr(7T!&wPDJSpb;UJ5>_D|K$#^@D&4YS+0v
z1biVv@%M(2O!_w_JWu|s2|0_qKYER9a{oPreKS)9GFQJ^pb04;<T?~akjWq$*$A#=
zy*Jr0v$MY+FTq>O0%w6g7xa915A2f;%nE|zUphtjduMtaj9WYhPk@&C^F{IheNj00
zBGa=ypF=R&q+02q&snqjP#!OwgMs1N{>p%<AB|DYqTXw5!U0w=`|&#3YKBtOgNvS?
z{w}4!JPydSi##ndR~e(P{cmU}{0jsK17!-3%3j$1$xc=p|3<3=;t$%zX(^MNB)2#B
zSBF}FF?6`p`k%A8C;mKACE$^l*B8;6i@CPgAB9&RxZBd_YBqYZeg6EJU~ze_Gl>jb
z(f!EG%q%ip6|8R681<ru{MS|RJ-=V3is$d_DC+IND-2%pIGxc6n#DbJi9%&$YFDTG
zCL>u!h>s<VQ}lJzmcUgKXljxZ64KpS5W>#EaR-dDG=Q;IR+uQ)fMh<__3Oq!UhWL#
zqJzC6hb*GrRby6JbgSTNwA|OyTSD}3p8pu0WFdDv*?MuPaXhOQ5ojKNJ?(s-4r{7Z
z&3SZ%DJ1cnW2%ZUjaKv(t=|O&p!XgJ=4x#_Gz3{0RFi_PT>j6uXqia%y6miM)APmZ
z?Y0A&VgH?v4YR~q>6Q-+8qfG`i&uX=W~djAXUp(hA6**GXEpHIco-EbnElA%V-}r}
z9Z>>GFA6k7RcAW|MeiFFOwm3J0P#Vp|Fs~fhoiqrfkeEPL;}w1`0s?7MG1B_zw*W~
z((+lA>EO>6pWTJ0WmdgcTOw(ACmWHBu6|yQtiRXZW#Px0;GxB~SXo%UHW8Hmemg|U
zV)u+8XZttHBY4lK5b<zlf9R$XWpJ%5tq(yfE23CiT-;1((rcYRj4v`pEO@Iew%BzO
zZZUSt`foV+h|=Gi6Ht;z@pb<p$@k$ZA@ApoZ*#dGJD-8(UW@o^Z3P_MC)o)cm`?e@
ztJ}4WN&UaB58(^gH}|~4YWu3?+(dCaaB^<Uc^n6ItL5+@#$=0kOpnkeQ*$2>YKt<z
zb4dYa-*vU>>xKAdf~&^@!H>4RS`e<Mna}4qnQYP|wF_-T4j<T_>@7Fn#J)pm<_6``
zz>S06pajk9lLaGf#$TaWpovwDPa`vxW2J+pL;YBZ!7*=dm7o>&r4%{X6jTU&s}T3K
zW|%w#8J>(13&uBXUGhk-KC0a|S1X7aF%VVRV@5IKNCdq(KlxUu2d{n=C{{w}T|<9Y
zO`74td;i2Wf2_Pi$c?-1?=tAP^Hnk@9qjMcML2h;2ekG=xX*E_xx)9<>6ia$0rFzz
z{H&)^UvI8die;J3z-2RO4WZ8jFY78C+{9O`cL)1*yOPHgyr*YO0qMkUl(d^eS&`7-
zj8n@(A+AQDW;d;~=Mn~RysgY@u@O;#iZj12x;g?5Mtt{LuV$e^3RoHq_AYJfzK^#m
zukQAo;S}@O{A5u|<Y^+G{u9PgB;51JE5!52zURi6E}<AfkroPZu`ak58U7u04SRm8
zx@LmNsjkjr+EC|k^x|U2{K?al`%vOWCN|(-7b(@YnAS~HVKoG$@6*1*Fv^6Doo+Hx
zBJ+^0u6%c(cy>#LI&5~aOa9wGU7zqC*hsXm&lRyR3^|tgB>pR`v!zW3DnKpJxD`jj
z8fV~rY|gH%^ys)Ri<UAi#Js6FVu{9h*tApu?fj059xL9!pP+DQGw^8=fv_<>%AlT(
zsq6buubX}1{E9~>)6!2tGA<T@E|xb>MBuHEg5A9R(}q#3Y(%k4NFnAdy|4#o>8B?K
zK4tudU^XE2{S-pm=GhG7PX9>cZJu_?V{z}CYnZKbS;SizD(r4p6=TlQp(iwvwmanq
ziul=XUtiz(1EXBfl@1`8N3Mh$i-4tjOAMBdUHh~cK|=O6nyUYM!}eN#lXLiNB@{kQ
zOdAF2mzYB4>({>*+LD=$c^_^vn17RGHEv{j(vbYlij~><ixTuIB`gp5vq~G#C{<5!
z?cdyye5C~RC=AUi(cMcYU1RF6=ALhKOaNpf=tA1ur5JDDaB?Vh^z{n9R?^u{3+)my
z#q0Ic14U~SR0ebPtK}gSNAq=T)-=P|TTKJo7AneaY8EG64jmB7Ie5omaC_sYe`&1`
zzp*^zUo3B(0`iNi%*Oaj2y`P^tiyDXLO3-^k1(;-(aMU&qC3?d_vh3UEgc=5z;$J`
z$yaH#Nq?EKDOd<NQIRwXQSV6{XgXWuwJM+^2AC3^y8@2Oy4AiS!q=%TcnGyPV<n~L
zYiD>McV@bGWn0o+I!G<5iFxk(4camONQ91Q+ooyAR<z#Gn-%+8>Qtrs^E1bMw}v#*
zj3S5?Kdmbz`qyUgRWM3RzFSTu$i;FWk9KpIj;U`&p4dz}isNnGEI*Cy0Wx{bX|4j%
zD_mc3z&umAccI$GJCDR+s-VMQT31X_@w*E7Q&e<--5}~7gn@AUwu5spqr2}-kP!T*
zYnR`_z43Qn1_r))|DFxMknC+*8m&w?xv|SH5NFKdpaLp1lNkKYcD154{<g$L$VR#`
z0a5x16{LuT&H!ep{iVyGCIm&7E_B=}NHB1JCiMqL`9YdcKxObzYeCrx48>Sk$F}{0
zm-KYZdyiZfpN4I-IQxAA>B!ciq5pJdw|E1*MdjD%{wg^w&p7Bg{CMY(&M-e{K694H
z6l$vaNmJfb)cxXu3N%|<ZOEN`g^WdksB6fiCc|E?-DBjw_k2`)vXgmD;w&*OXJo2a
zSQSNSk@2C!u_?Es%pHnwG1<s_uKSe7rQ-=u-9`B7VQ|5*eMS4%H@~a!=ojahb2IYa
zxmf@Z)nj9g;P$5L%Fk~YDDW7h+wQi?VK#-iLogBcqj2%#0C^}uW<WrIc9GGQ#!Ird
z9G3ZJvXW?%dy?px07ufGCs$JyzLKKp=e{lJly0pK<ay*9Jw|6~fxZSu1~&w6<n@nS
z4!w{0gz(M7(R=0|MQcNS=A&u3(cJ6Zq$5VQT~DRel}%4)NBQ?|-hQk1G9KuD8~Q#z
zsnN}iYie2hyXk44%n@4_DOg&cH&mEusf{H*Rt>+9OU`3>5<h%l@8OKI;8&)5AzC?)
z9Ne}!zfh$Bgwa2mvmC%vs96Fwu?zXTW?WDLb&ZRqjEqc>Xkeg86R(R81}obQM_cB5
zSa@YA-MV@6D=?hDmkS5PbRd|5py%P~+Xw*wb_pc$RLL5(D6B3!AH%4InRfs|+A(gm
zyHu?2TNj+pQwe0aznYekIvgzEa(Z$Thm38n$3D?{zGqqE=K2u6?^qr4SeB((RXjp1
zVu(_(f2h*8Tm|MB+A$7uPB_U#6u%Z2!_>4dFuQt?!o1?&N9Ulu|EPEdUHTF{y9<=Q
z+I5xmy?{M(wk3+{nz?k$;vAwi?!$+B?1(B=WIV8Lk(`55TWz+2GyOppa1-n^wO<$j
zg;5>%>=C08*%iR<4O4dc|Ih|~RQ1&K*gqZpc_B_Gw;yp?9X-1fgDl5qyUhX{jBvY9
zIRC>L-1ke?{oGF5M4pPEvmbJohx~YFL2Dg6=YQp~DvHH8CISO+{uH<Qzt5sfNI}NR
zU_l4w6gvG^c2O{V)ZR`u3oAGS0CRVtGj;%~8wz<G;@rfg0utxq`FFX$0Q*51{lb#q
znI>u+w4@}?&Ul|(Zz-GaaN0k)bISsd(zvUWccSJxEQwiaJ0JzKop_dq=?zO%5ROEg
z$K}82U08W2-8}MX)$lt^NtF*8`o+lBVGQl@J5*NqJo>#K0*?~B!7auBe)2VuK<~aE
zzI@HpXr--9jtP{aH3lK2YMC<DL_!$keV;fqWhv~%X9TOB-kAOCJ;-NcKFb3}ir^-X
z{daUN&2yc{<#1F;d#v~ywc#pn71E;_)stTaV&>8c0cXed%Ham{$kG}9>wBy5P;wF~
zOEcl4^GG@Jg(%7EIKz!^oSW_=?36GZ4D1%@`$_}8BeHck#<>a4%E0e-6Vg)U#mYe5
z?lTv#o&c_o<Ag(?sfk8(u#C)1Zr~(g`T}^QNZZ-vTU^lqDBVgRarliNXa_7YlXa1Y
z3U=IZjI}&yk5BWzq!DXiz>uIipNtaKnR-!9rh7KK4hidZnv0)*KV#?I&RBfjR%ld9
zwupNhtrjaB55)SJO9L-?NJ=qKOLVq+T*E*<ZAP%W#2;(_d(1HKUhFoA#e(%STPHFR
zl+%r&#Lf56kavr7dLa<C6pVY5sp|R3zLb(u_@~F1YRyVGeK=7Z^P~*;U6j|sBDJn$
z8up)!Lg97Q&u`5xJb2Vb#AK!#ten;yd49SLALTe+G?5N7GO=P2=Cgk(>bb*$je?_R
z@;$DT)4{IB#BB9i>M=2^o%22rxZ%pCrMX}+8tvS~Y4?W^`T;hBS{n5~3B=P|5tJjT
zS1^T%VQTs;8Vz|9$_oP(7nkqJbJGvH4%aOdqMVx^1zMs!4!qk}GcrNp8mEEsQ1M%j
zhdw0yvbX9Ok}M4A7<4SsBU;iz0YQRO1=4>;dlqICiG*+~w?n%9E_r?zN6cWsx|09d
zhK>&M;CPQ*f>C1COqn|l*B8=RNiCOt=4yo<@BcbOHmo*LKoj4VHX@hOoL@UPNlhtC
z(vX4zdNIwp$$KX+3qkm^udkn5)Lc{@UigNfy3*lwC=ifTsnRj!fJ00jak%%|aUNy_
zSnyaowm8;6R^#*>So%vMs0%o;)Zbf@FzujUbeMD+`|{t%vd27DBH5Hjp-$=jI&gm{
z`|VOzR@PLiGBWA=J9^b__TX4|9-p5c5|WdLfK)Crzjcyaqz2xm$I@6^bwdVNqO;#i
z1p59j#{*)sd+4}s)}L($i}IQsR~54uekmi;bdQA|G(zjL4n`(xZz?N)Lx)W%a$>p_
z7!Y>iZ=g0~_L*=V*>H2@3TC&N(P4HQ-9M3Lr#S)h&i2E@al!Cf@Ndw(qgQAkhIzI^
z0x0lOXqagVqsxtL1ZF3&lG#i|I%2!0GR{3%8a*>|oQ>E{JrkBfojI*jdcAsWdRli*
zG#B~PQ~hoZ0(3C#LJv1;y|s6ig>hBnxl>gz0uORBYL;%@-kFSl*|h*{On$Yz_7DD=
z9E<_6nm08yH4=D{&0>J*J<lpM*!>_h8~E?c$uA7K^x1?nR%;Vlb{s7CV;2_}D@P?@
z-tKa2IDV@ycopbwQNc7hbWBp2%cYJkwUwjwPk5oBY<JO3os{W2&eHso;Uey!T*G1P
zO0gw@Vx+QrzrFz~D8zy|z*(9%ZY=~8^%wzNyB~_#aF`qzFIWyj@3<YfqDl|O2S9*D
zWPe{@PreQ>wS*t2#;$3w=W4!u`LYNYf9Vv*2s#?<ZA^&38<Ah-(ZAC^H0TLfHWxq)
zd+*p5IGbOF5^I0)yH<CxAyT9E33n#wBm?mIq*p?vMy2Q5;VqG~q2Hs7&-bizbn9w}
zG~sZ}!B8va0omk<QmV-u0r#`NUV806NxynMZa7B(z<Q=8HxT|9KgfVM9T98wPxg+l
zEW<px60i`O+QG#Grxmz%BnbjXrQ6gZ7D9>|h<v%7WJK8EX6qXUZeXhB*{t9I%QsX1
zh<V}3?j#J{7(v%s8_-aS9hcvS|I^kzi({K_H{O1S73VeW8TR7u)@RAn1{<w6lw@Ix
zNHX}#6&v(SxJMIq(cjgtPBHx}jr_s~CzX!DpmU@#W1`5=4$-qJ=J*{D!TB~xQM0&>
zp~^53rY4=K3At#YW5=Xf>*bnSJOd6m1PY!$TYDQ**bz}sgaRIzieYW6(h;SVuZl8D
z(e}I`%!Ag*eU$=1(L;{D^VQ?OAN+qhwzrtPT8(fwCpz*;2q2v2nWoP`arz_j4(<!X
zA<msK8n(B2^GM#AiN9NBntLI(e-dXWtBLfU3Oa+Qe>e!UOMZfE^QWl7tap3Ao_fBA
zTTq_n=a=BRE6PAK=|He~lZ*R4$`gb5^pLfaD3kySZrJ=D$BOTk)*8{U>his<9dZrQ
z4#D>=^|aNFgQli<wnH}C3i;9Waz0;N$WETfQ08%7_1b&kUx{Kt<U|w39bLT0Il-Ly
z$;=?<C7>%b*7Xod_5JdWM-`4q>5!6ULGdfJz7<+L1eW=XN2lh-*|@UBAg9x_2>jN$
zWBL-v4?r0$%<>n&@zXoQ%^-s(=~8HCDa1d!IP)}(2H_!g6NCrPpf0e+iH6<sdE7)G
zVP<4-ft$tHk0B*Z5KJ*BJdcE0(55Z(fsa&{$_oPmr{`~OWZ(Hdcx}DOlP>lxdlPwV
z;IJW^+SN|mp_fOSon?GJPJ1j*Udt?K0q%zj%7$aE5MRcMC)Nt#nB||K@4QcNX^Ti#
zqF|S&HYJvAhj`2F-UW3F5tj<s+rDl^|Abl<OsM^w$ls`ib~aBIap&y#Zl|Dtw8UO#
z>Yb?dCgZpHX(SyJyr4HH$j3(l-iUw<#<Pi458<kYB5wtaVw)Q~Xk`!?XGrqDEXO%Z
z3x0mq{>UyKYC<3>6tWU_G*arcF>^@TG62wB$o~Gf`c%Ksh3(bHC@aWjO8sR5_OOb<
zmmd~*iGr%A;fP4V-$>K~6V=qz|K1q$p&S4qapwiSYove<<Z8`+uMYmC&0Z76`<$gq
zl=s`=#)Q<fXI$zU8uQcpGei(eRIYa0M<q}%fQ_5DDN-1L1k@<7i~z?^YlQSiTysPj
zpWW#0b@7q9Yo{uyaf=}#*G8dno)A~4)|1muPt^|M-@XA6sQTWDG|CKb@{LDniwQmf
zSjL>~-^<vO09tIqD*v1^(E@PFvd#A%i<&^w0YSXI<%R#WxYZG`i>zIueD#vyH?Xjb
z0JEqbvm%`z;)J0wL89vV-$Z2(L?Cj_&y(^oY9R8LPfZspj0C1lFqJWohl8lcMsIrU
z-!J?OzL43R*OtA~aVo*`S@J`d=A*0K0NVP5HLR`z_TkJ+S)uev3@eP3Ll;Y}HilW{
zE-0=r(f&)wI}q)q$%x+s_9VO*be?ZEv?ixaeg#y~rrimiKmmPc{z~?QLQ6K4n`!44
znql`}jCGgWmL%S}Hz@}Skrf4$8Rn(BEIUt(=P#UXa?0(VF@gb@<oc~^Uk;<bgE^f4
z(Gm?qDh*~*;=fP^1~Cnj1QzVdK1aRv;JpUfH3ibxA6?5Zj@1uarucZVmA6zYJb=hL
zEBo>w4tml}C@Tl*VgsyXR(PLdmhtK*l_G~u9BT0*vZ2cwB-w>Nk(TYC)T*1lYL*Pm
zTzBDx=f+MJZIRzP_Hel?!@=e`;-z2hSyIl_k$ss@CBsFbl1_D=qE<=5nDcx`ilK>i
z{a-Z`2lnA1GyyNK59plxEL+-XR}-EdtTnVTFgu-hud<wZ7{~eNiP{VnhAtE&O&|M9
zJRs9fc2YwL1?JYBegyZZ`cYHRG$9%G_WU<7ounK!hGb#ab|Gyf@A=|W*H@CC0HX}t
z^tLaXIH^HnX)r>Y5WIZyk~aHqnwI=y=<C00qLydJ!Aab$5?A~uYO>hjjlSN8X<v&7
z+k~DSmFYMXCUA!KzLDywaJ^Q2$^ChLrn+`p_dU5J*Xt+B&3g~?%y`AxAl|dJ{|U7P
zYMBun@U;jy7VE}Djs1h52)S<~P#cEKf3yI*3*G#m)wf-h?g~;5<i%BnKD96fa<<~t
z$HM5)c&M;ER`74pr-Q;*9q0L_bl;HMhb^I**qt%feI<9kn}CjZ@$-qglt}YkOCtpZ
z>OO}H^9t+Ju3ADa9=vYR(`1d3H%ZR(?VE5e8xPzH$I-}0F=4ij__0dfBBSQ3AC(oQ
zM?3jSsb5(w&-P>2-Z(6gAI*801v2nF#X3Om3{elIoff-jFt`eG=kEKNBtgdvol*-S
zr<qsWk{|)gR}8P%gMQ0SI7F>BqY@df)Cc$!A`tp_Crue=k~XQP1f5y*L>lStS07Nz
zbO-d7%sfHlhRu#_LXS;u>15Ggc+ao6`ji;IbqY8MZJ}-WA#c1iUYDppCEl-&8m20I
z*g8VCD=qS8Y5ivJpBy(&H<XXry*JF=Z7I_bn-k0y#o-?QVlF1CpU<M4f_|}|bogtf
zoXUA=raWs`CbKWe+<u0EQUf&{{-eObXdbDT6&C1v?P`)p&Ek#BpHl>eE3t<Dfqly%
z299W=2bYUld^UqPDx}aL$F9`o$ZmmFHd3bn)D#xCY4&teOyL}PK#m`fMiAXzR1&D;
zG*hZ==GZ!`H~c=I<`*5${??Dj$0^ff;5|97aiq_uLAXO({GQ&jT<FtpJJ+FRH*=kt
zPJL%4OXfQ=WKvc<N`_;Pc30Adi#@UHs-N|Sd~zvNzKO(<q{Ge)a+y&=XY8-_JNlDA
zPdXzq8HlHx$t<6N9+<5B%B~+0;=3T7r*?~*5@7G9FfuCq!p*VDLKGW}$21GU9SvH)
zHV37&`UE`+sAN&!$DAL+3i5d##5Zk+Ng!k@{oWkS<eBbN7}amwq!_%`P2%4^tRmA)
z!+vbUa8**nOj>CKZrF@GzLlejD(l28*Y&9sG*G-I?s6dVe1kaBl(~x{X;~U2M6@Y5
zbrGUm`~BI{5=G5Kz5r==Xp@EtY4JmMHo+yjdJ|6fbt*ch%;<paUUBlCRWTBlEhDFu
zv9PxU)Z&CdCPvq=vSncU<2{K5FIhVzUT3<_o&`QG=uV9m2asg=E%-}U2i}VMAU~<b
zne#w<JO8r_J;vr&ze?}en#)d{9NlANBfNgwVuDoD=b>ruIBQ50ZrnPK#Ko(%yzUP#
z*v~_45)xyHxNY0DM^Msv2O&>W12Uv(ecWKQ#m5O~I(VZ=>-WUl+}y@7PWRZHrHf9i
zmSscm?lNr>>-pUR<h!})oHt`y@q^yW1(gaT=NU7^#d67+rxk+b%l@j((A%;fy`T^<
zX<n|!M?%gQTi+1E3UuRxheWQbwj3f0zP{(P{*HvufPY92tzVUHY6lEW_{5S{e#jMd
z6nP&&)2;c7fT8)7gCM-DItH4*Bdmx{`s+_V49+2|+`pHZ-^59}hu&K{6Zpg!Jm-OG
zpQt`0Na4DDtL<}%{alD&2p-J~AbA~a{Mp;&E<01sr`lhtr!<DvMOhJUE*etH)RJB^
z)BbOC%SK~Tld4*{e(0hmAmHMbcDY3!_0G%0%${0}4(iHcUPzea_k5iM_HMG0`3yiy
zC7hOLA)M-yof=Q>16*t92S5S({CqT-ot|;GYs&xh`gFjxBA3-0qPvAe?}ThAay1KM
zvt~CrlV4xH=sG(2>2$pND+Ftgh9txXTvpoi*OS+Z>UJy%obTui!)PU_Xuj;J(dI}h
zT6RE+BZk)GUAWxa$JsO0-azXwPef$!?leqxAGVijWyEIm?9?Va#3A0+acg*gC*)RW
zyk2mv&ivExq&JMO!~e{g?T>*`SU;D{rq<lQ!E5ylOifpHK$dm}H|541%B^sS??<U!
zwVTC6l$1!c3$0JW(oi9-iHQlHe*%mKyc0PfcjC_+j^extI*m`H+e);O<^;ERE5SrW
z`+EfU1gC<zla8i%*$VlKH2>p<4V;^@q*F8zLx}H95+`7Ckgj`?fcnOsLs%TEqL~Yr
z`74;wFY~D#=Tt`Awrr9MUC8ek03+Nk5|gV$?9hDnHc3K%H#9jJH~DnK>G0lDg?5N#
zC!_D4B03{V^chL2)K^W^PyDd0<gdvD@(EKCpUuo~6)#UUMQI`|DwY%WZGVkb2Kv+<
zel=E46+KxB%pKI~P|tcn_;wg(_q?55RR2t;^gKnvo6_%mvgP%zrD~-yZ+Oxd0u=}p
zHDdSd6XJOJG>wbXg1W-N!=pnRf~K!H-C2LA**v;%E)YUa?BJAFNHyemkLO<BQO!fz
zACEh|`1$^5H1*w{6lZjlSqbETagf<@G`5H=&^`nW&eMeQ3fT;yItwNdskat!ABDtE
zHw2qroMBs@A`drn)PizhwFYs}pdWznaSd`txDgh~qC%vn8CtsOh5bl@2#q5R+9ewr
zMjbw3c=ucKb=$e_{I+<B!pqn3c@nX~BZjqZ`ghkjPPpAe1HVme@~gvIYt-s+#kIL)
zQsKrO=G`;Zu<iF$*~<dz#@~E<%8XrqI$9sKltbr`3ES`QT0Cg%O^C`K@%5-yNYziA
zS}V@g%m~T7OJ~~Xg96y=751U@x0fs4K&zPZ1Lx3Q3O!SYo^9R7Xko-2U}`$ed880C
zlhrdp3>bps{e09O&eYtn&dcM#!0lC4OvEH$EiAmx<wME`o^X>m<7JUauO0gJaE<xu
zJO#V1K2YP$B*$rm!HpMQ=~P`Tx<33lNTZvs7S_DAIs4!;pB}!TlxjMzVE07nrWfv-
zF}L0Jh?`eCu98YB=NOZc^4Dq_J=@nfanSeaKlNovpkEY2!4zXXStHCSU%MCgGfJ4q
zatYH%JRZ=3l~MfwK7G@Ri@{8axP}U(Z$(0WGg4A@U_!xLqKKJ>0JHv53r&ecNtNsI
zgdx(#bTaJ;o)lLYG`OIy<!5Mqw2AGJVOn)aq?nY`%um4_!)&62E}Do%MNv}?!2|X>
z5#GtE%c}d8Z-^`%Lw4oB{A1(mO+U%?Prl{|R5Vn#*;Y42vsCvwyJAEoOOKs`1zrSL
zcnQ>5=*D?wk@f0Zw{8`^S<vi@f9G8e`k@%@$q9xjO9iF1D-5Jgv2#)xSuCT0K2Q9%
zXaKK`t5j6b_V20^P!rod6~+%EtVWM|-^H071${zBt3}~F3qt4|_6mn@-HLA@81vlU
zUJf(}^q&5)-M=*Wr5f{-=<7nyru(9beEZ!H)y{WnZ|paUtWOqGj{ex@<z}+ZwacbA
z%XhQt1HhkDccVYSq{$bILdrFLw*!8{Ra*{FAwla0JJ3cPXv{dHu>hXN9Q@4B0C?1I
zE4vdyO}>I1UZ#c`7TO*`Okq*KfnwvONj{O2z+F1O3nbh(mzOD&<Dq}%9N!RG6`~5b
z_?e!F4<&TGX>teU?_z7ndc9<3_J>B7reZT?YRbX9t7>f-*ys%Dnoq$aVWqOo;X6$m
z528%|R0tnM_w+TPT6yYto0ax2NuS!JtEOMA_{gWI2VXcmYTLD%^2O>hJi78n9uFq;
zSq`wCqD}Dm57EKS;HNdc`GSq1i$pOTzIr@#Mz2ppV}^_AA<QjR)Sghca+Ut_GHnQT
z&q~gHZL(PU!n27v4XTyyQ{^N6{pv}FchC*lZ-Oj+pVp;0q?eV@>V@)RM?ps)?9e67
zHL?e^Y6;MlM9&`e<Z>RbIV+!%6^(1BI&D_l4ldqb+PCjw#$8uFF(4rmA0>AKfYjuJ
za*8nE-(5;hmQ?59cGsJcjJ|VHt7;+0kHDkYc)mT}Imy*&`8+&+4VMLu`vh!eKldVu
zw?w};b9K|>J>M^tGN0exrM>~4hQ3R0`xbQ=(3`ir$OD|xQ0+KWnwTO6rt*;PL#Yir
z>_l|rjdYujrK+dj$nKyKC@YFhIJWYK<!bRA+?dM*-|Oxh<MBJ+#^ZIaYi&mi*>x3E
zeTzSa==luT8V`SG5bz<Om)&asgs9WW>gLwB6%OrsPy9$~kuVb#$m32M#}6*S7S4EM
zY(NwZunqsy@dcphz$hhG?qf=AVhs19poI##yV(6cguC}!iOXfQ+SV<;WJ}XR1a|>~
za4h6?)29zckH_jf%sAC8TjTAiD(Pn3Zcx@wkb|l0;Tr=Z&htNuHOL1A!JOHb@R-85
z#zr);>cT$HihM<142Bl`vJ_$>O=kV9{T>jcsnz@Wrhc0y`GVTi{LM|C>{-tmc?3nS
z?q&?!eA3holm;KQ30K)?Iw*Wk_8!~iPb)$<oB`{=1L#vu-h^3AdZQ==_fYX5n96ax
zxm~mu81atJ^dXqDq@%TGqmO&ZXKe<8G4IUz-`)pg<4spj^W~?HhDw{}G7<Xd40Ft8
zwmg8cY3T~&F+pJ$UlN1FyrU#T?)MKheLLK@ftT^uy0w8k%3qLAH0z)3N%JH!HDK8V
zmKc$#&@?ok;DxE59>Sae1FJv$e_PddQuI!nYzM)bsSs_WChA>k8ofbM@v{igpObz2
zhg0s+qQXizR8HtX1UFd}XfX>dGBF8U?;y*Mj&j`fqk0m4OO}o*Z;E3c(BtRl8Ha#$
z_Uev4pRM*i6#xwx*<uq3N&P9Hvwq5FKT5)^lFAnuYa%_wT5A2wL{Zhy&@f-SSQ3_x
zkx_vP)J>$A{^chG_s3M{rcafBQLU!D0HV~KWCBb0&21yE(5558D`MtNN&#0_g8h;X
z(y`I>AJv|JXJ=&0R`?dJ&**^!Lr=f-=N@U=g;R;)ri=-8l<dDf>ez1GE+wZBgXmTG
zGxci~I6nmL5Mh0no^78hqk*?b7bPVh`{PLX%|~kX<u;wL<3*YMybOZ^B(NxWfJZGJ
zVJ~vnVRP4Mo)23y5Qqzy=2O=J80U4QF89OmgNs2J2D#RmsT!BNz-GDEkwr3t=#51E
zae=!3$+QR-?h4X0_^{*Kpmh%kYd_g+TXrgpw&rz0R}O;vP{^_kvQ6PKA-hVrVk@*b
z59;`+kISapuz^ZG<G7Jq^T<y^`h!5C)zKqz{>{V~W(RRy_(3sSTD7(Dd<}i@7ai<9
zzikjPvocpbT1M>f?sHI@;!+9x@bIXu20SlO=I^Sft@e;0E$%iJP*ZbWo{4-p2>aSK
z5nMvxQT|;1xkn-Q$$^JphnpEd^7Av^3qleG^|vQZW!szfKMF};ow&t@Z6v<UZjBdl
zzX-}f=u|r}b6)O<%+TM+H1F57IJ{cFHKDR3CUm2^UX)%f#J)U33fs)slw%0>!*P5V
z9fC|_4QA=;IX-?Xaj)WGl90g7_({Gs)>KdZvuU31GEW<J@C7?)L){b?nny$ne@{>z
z`hoea+TE7k)hNJbc`1W9pkvJhSH3IqD&1FPrcY(6<JxA^mHo|{A=Z}er-vJpP5G>*
z+)j37P9Nf+IxhDc+k^P22#ASpJ1roqUS_=PaWPU!64%T90i@6ng%by<;*8BRAs*pk
z-)N!nv(>_S0XM1QnVV|96G;gP_n|Nr*j_wYfeb@e4~4jo5V)+sXsyI?s?Gt>{}kYf
z0<eI6!zR%|=IyIMVLoM0^Qv+Cw(3e2QH<Jw<4G7!h&5}vN4-9A68`#gz>0)OCkxW&
zIya7RZ<gD<(24!NrL>)0^5eS78|Z=3*56JNJA>~B*o<^+YVy}qYY~Zt8ff}vXs+Wz
zcZduqJG-2Y>Mz_N*Uo3@%#y0qiLMfW;jT{)pQ1B_dB;mZ<I#H|B6IKoCQ*%JSnECo
z)J<a^YXq)^G9?4;#rJwe6KyMY-7<%?td~sZFiLex<*(z*LAzRw2`1Kpmy)~gqjY{}
zcA{z@b54G7ls#W;htR<U{AzAxO3BWiqz#$JrFgr7P}#Bmm1kQGWyLd(7`%nqmy7Lz
zfD!-R(CPB}`G&+3K!*dW$>Dm!>5|KQsAPUP^+O_{*5nuOp1>>Yz6HcZ0XXvtsG5kQ
z=y7_`ijUD)lh8l8W6Z5l?9p`NxTIE(745t&whj}Pq-XBn6>2<^K=6>pPkEiEKdaS2
znHB1e?rih%S*t!hUjNm8X7LtU${d_&*eyV69y)xZz_*e>r|D;n(^E7=cRM?+3_3}x
zzR5Dx60{-vVI-G-L(nSn9oBP97e$N?16aW{_e?0Lo}n|}&x*JE@guHz97`0o@4{2r
zVYqMoPp(u~IK&Nb6rNXJ^}4gw@^U10Yyb1CsLQ;6<Hkg7a5+?>c{r!I840ljRGKze
z{KK$GUG@AW4u;XlZ1pS!A^(e-VhvcnRmV_#ZRl%vryxB1LU(i0<U_k+h_;;EO~4G7
z*7(atP|nu`FQ|6|s;CEax%j4!-T@^%r?YeqfiwNR=b{VjT<kmtE2B6X8j`BRLDyLI
z%a1tg9y3?Gpqxv)N7mN_Q}YXSo?Q8sG~ZsZH@1Z@-#q@>);zKarUT|xRQ-6X*y>GQ
ze6mD^l$wYmL`fm-@fAXD8i^mhqO5~IZL6bLRER6><j^w-*0Ud6|68B6c<3kW(IoNp
zlQcLtH#ems*$*y}kQ+}Yn~MmGcODI;p9{~-R4%f@{|ae(*W{95H26wKrkLkzy~K?p
z{AUVH3KlQH*`0deWg}mlk!@!sk?^M`a?v5R&`?(|^C$5B;d<45b5a^$N9{Lpt8*@k
z0W;x@PR;G0K^cJ$jEe7pri8QQU&?+!XmEvV9vRC_S>3IF74&ei63>H`)1NNh^Gto6
z8P;oVOI49pa;Wgf2mzhLi4xOWXe;G){?e6vj+b)!YIZo(WvTbrUP&JB@f&8G#o@uE
zc?Gvm;FA(i;~@^`^ybP*{J8;uBAZ<{NvK>P$mnF|>eYT@ZjCoDR0#A8{(!jO6d4iQ
z$V50ri8{q$YX6K>S_~4eXod7ktp<LVG5wG>{b7IYtq{W_YR!5K=UZ!f8xUDA2jT;n
zrd+GB&t$nns0WoeA~lza&u#SKlMc#*IkGY3S=IKp?^j&Dj}iKvVgpG0YPfFPz<qLf
zF%d1{@8`|UG64n=Udh8FSYXfN@t$Hc`1!-~U=g=B->VO(SW4!HV0sRFvBVs*^gFAo
zt6|_u42o(9#4=SC1TBI;K`UXC`e5Gq>c)Mz-{majm%TeJgEXg1BC@2JE*hwJoHZgb
z&)q`>d1ah(Y6)&eiN>h3GxkeOxXk?Oa-QFPfR||yc7=ys3vCkip(B*68{srJ@$u5z
za{+nb(n$D)3=@5P{)WjJNKYFD>Q9U<?On0i9Fl+y|4ADs)lm*5V`wa_^kK5z@hMv#
zo=Cq?a&%)xJ0E9v?D)j%>q)$&Bk?U^k!cM2l~S>JZ;IiV&(s73ik)nR!9Acvct7(~
z%QC~O0NjHFKrmdV*MTb|Bi*9&J&ENg-GG(~Xt*@|`WCniuBUnAV?p#bI}}0)#GuBb
zYN(}^^_Fi!3STGY+T-(vddnTL1RTepQto6UzapIH1EVTFXl!yNW*^v78gKlRBjMPo
zYGU<1Z+^PB8_^JKTiNDDTSy)?$Z=<?RTGUsa|{nHa%Pxzt0oKW-?4$^y)gg0y<<nC
z_}02cMf8Hak%AY%FZeC3igbjU%zVNfR`@uNJ#|?m1~V`RV=zN5f-tzNC7c>ro|o`p
zYgWbR0y}BTf@$Anz9edCvwriQ=X3HW{NYQElO_8(+U1{4z7~`{CqwUajyPht>&P_;
zdIqm!i7Wz2GNkSu8=Z6YC|D6d`}E6aeqh9-dss__AUJ8L(2&-$E14TFz%svzjcQcl
z?eReB=Tt8e2vjmZU$-15<3!1awNfQbJS2kOhps7>6X>Z0SmC19FkaFsb(D|muUF%E
z@^*>)7RNl~yzOMyakM$dE-zZrdb3o7>c-uvBRORjE#{FSuAp2{;N8eptT$O%i!Uh{
zwosyeegT|wTO}&(CmuNjfAT`B3s4Jt-6#;g(aJI2UU$L+<Dd)!HAK@)k4nlhDUDZn
zw2S2a-F`fM3P(4!5(^z3(AKfxHt0V_EO(Y@7vH;bdDtG7yA1gF`}3)oHU0nKFwC0v
zVBgsYYQR3oFo~y>ODulkupjSfKe2Z!f#Y339^9{`dc8Uw@Is{6Al^^W8L7h2zS`yQ
z_oI1yxl?^NJof|ite5ee=f`%Z=*K0lw&2sg?bXcDzCsvEc;xtch=2A&A5dQ4Fb!2w
za2frz@FUTbT5ff)0PqNlCjm}ac!U5rrky2Jw*nT}r{PTaiH5(R#7-*%fe8}}3rolJ
zzR%^#1NcGY(l#*S0B!kVmqq1c15%SL*{Hj6a&kqLiuzNsXcIXwQI5)H#kPcA0c=@+
z)1gg#hw<?lRt=(WM*;`#UqZ9~g`!Krdi(<$X(v)TbP)*+UT<%5A9(E5o(T0v91{Zw
zXWT#dz<lZN3~5m>&2mAXBI<HID1wWcZ#d5us`T{M<LMTh&lw%`RL&Zyp;wUGD(@<A
z9~%?Td7R&Hl~hkolQy;zPNRu9j9;V{k&>e*xlQ$+^I!l!?Af%O^I|W^RSk(M+jl{G
zcm)m6v1Jw;ydvN5+Eg8lS&L*cmMr71UZBDMyaYNmOXq$rAvkXZXui;S{UFhK6VuNm
z?vk%7j8FJ2aIQl<fN<*$@|CvP&y~Jv1bXKbqElP~C<qGY&J%vZHw2L}g`xy7-QuD_
zurU0RD1R~UCZu+eFSxTyUxF+05%E>fZxnD~U=%j<<NubMr2Nis;^TMLYlQJ^6ciLC
zj&v{}ca7vWZ5Eo>@mh*=Zi>F%4iWny6Zx3;Dk=_&A%5$`owRqC@hDUfjYh9-9K<ZT
z%smga37QNvE!zAgf9$Lv`PWsSFT<KUDrl3-pT+w=(Q747Zk8SMW&k0Z^4pxX<%e99
z8SkYunS84lZ#|`gRa$>Vbro9AM@0K6E;Oba*Rnlqezv^hxFmiLM?_qLWmaF58E>;r
zzk37IUX)xUjQ~5E{weiGDncN{QUP)%VQ7E%UH^Ik?ALdpXFZ+u7e2Qde7$G#9=ItO
z^Y~uK=BQ;GC%6Glm^TQ2{q+NhsUXV>t*gYA98&QsuFll0fY~HinS#R#&a$8Dj2sLM
z4OBw3LY2Fn0R|LSH_-?W9tuOoAIWEKD_D0x`q-St`h%RC?%JTeqsm=qUEKM6C^6!V
z=ts&}qm_<P^0D_l`KUpF@B#tC>%F((Gq7|o4_a2;)4ea{JeSbgMt3)+t_4U{TYQEQ
zgzaUtOKb9l<l;GnN-qJ}yIp7*HWJ4Ne^8f)JE#Hdo$~9?yrfgpOMs&y#g}NN*qE2w
zz<WrBWF`rRO5#)<=94UTS$pOQygovrC{0|Gs@6pHQ>MU0bf#xNnQn$Avj^YrLQv4~
zlhcgybrE&^J&(=s_HN2lbKD#OiRaApbqYn7AWKwEP3Cyzoq6QxLL|cwGbT~hU|=%O
zd9{$=d_OrUWnhMi_>s@a?BNtWrw_TC!^Az2^}!ZwI<-(1Z7y4LhXWfDCqISpszjFa
zl|T;ElOzW01CyU}hCaUSMUaH0yu+`5J<WqXsrLeIF1k!V-5L8FK4JQ@QLk8U<)~+t
zc=ho)$fGm3Rhge#vi-in3)H<sw^WSZqMts}<U`bYL1sSe{#XUKW|85LvcDUXn%+%*
z^hlEzQSH{LJ#g>RSD)uFk2r;ZvKs3iUJ*v|6LAa~cm=Lsp-_0sx!&so$Q}?Fx0kFp
ze7}K4$9SzbKJh0GX;6Zx7q!-N8L|f?blS9CUbyn!@jkfQ>1+@x6l^wG#!{m@dQh*e
zUwee&X%Ll1g?JopNJM_S5-Q|2lZ<O9$LB;UACD}Yg`L>jO%zXQM=%;}PJYhHSMd6D
zq`_8IQr0Ww*YA+UAZj6ezY|#GC%wxn&>L)sm8NY8Xvi+MU-X;xsf6{K-U8!oof?e=
z4q$3G@3~Wv1DNfX7L&)IaHUI5zuI{P&q#%TI){RmDyA)#RL{=4^Gc-Xl$w>^1-`x9
zwTZ;9@;j#lSbZDt7IUkZ?Nz1eQCc$Ya?w*KHe7$`GFvNldP?`q3=uiNvqCsGu3iXK
z1p8DWxFL;$cgEK6oUB3~+_+9zq1pdis+Qq$$`uc-KR-xvp>3XYiFk1oGYPK1>M6H{
z&+;ZtAsROKu(PtVjKQ6mO9OdiyQ|Mf(U*TYg`6kyTJ}^qnW78QqBCY5odPf8g$pC+
z?N9*Vhe1#jT0UY~Bz{(oASA^3R${XbYYb1c&qr{Pd8Ta?5Yo;EE?(@H=|9^mI&!f8
zm3klkqz1zxPZP!#IrKY}PTyYUd9KQg=1)GlJV1E06%I?<Tdc^Er|^-%3n#d!+Pw=X
zjU-Jzkc1u};-CkrE@@z1dz=|g{n;Cgx2kmmz$2Wu=G-)%a_4<b#2fB5mVM;BqZ#tr
zdaP{lbi@2^C!VBcGw!XMQj4kAXmekv(V_ue6c5dgObb$Rr#-t^-E<39K${2(SJw7w
zf)<3RL8{av_OD^rig_OZm7X({{upGh?LNf^-1VvPFjKynFa{<tZUkoNKw#i&S@;fQ
zjwP?Wy{f#Tp^4#+XYoOIlIp*{cNHnx{3<^?LgfhafB*`s@zg$PW`D@QEhk*>LD*)(
zLi}`^lg2+<0OocGp(E(O`drKtvg@JcVWlA)Utc}>tcy+_=gc=9YgXqGDq${}+&LZF
zgcmz^!t(ViiBIuU;|AC=kXg!|mEfF^X+amd$kmT0fO&vqo9`GH(sSGpa`we2UAu4p
z4zTrMf(CZ4U2S2%wgPG~gZRao1v>ZzW3G?mDO~~dzLFK$R9W2Q$tGDueP)A?!Sb+T
zO^-YrN&#Q&&ME6)|9FqbpC5QrEo-5uNBprSblocj**$5&xZBbAjs+kym6G~Cu!4bl
zw0$NJsLw_SPJ%NqhO2wGDjI5%*9?VYL^oDITUEneJV}X4aBiX@w?Q9udF;!61tZ(n
z*7pTzX=niI$i(uLxMc>W$uh(lFq}xD-+{-+3}cZ8Dpk%v@Fem87!h9Ls-u=9WDg>N
zu-CwO!)dBFQ+9h$&ruCkCHuwhF4H{n5T;(@+_X@6+p&iiL_#skmhEECQag+&!RdwY
zW&n^`s6+=gfFg(Bo+ERB9fpR@28_p_nfTOEKm%MRW+8h0BiCqv?5uWfd{(?2a@ZPM
zn~BjC7Q1h3i4*lez(?z6N$mnw*D6vI4w{HdY&7rj0bS<uajmBVgM(H6`d2kn4xa0R
z7j*Y7sYgU4ft;xg-QpVu-FU<7EsIfEnrx0w`!arj0-*6lA$TD$9nnh-+BqK)y;{P2
zw7B!g1-X&*x0um}G@yC=GXUdhqu35Pw@d(!`>@3Q6*ws|E>Wl8q%f!)M8;rrrIYA}
zQ@KZQ@B=|b)rk%E$U}8~S2=V>-g7H)azMSmDUo`>{7VTPlaLzuKXwgOUgtLqfac8=
z3I|!6L$!KFk0n~7-uZ^#**sbPc+GW@Lt0>qnQi8;LgI%Tf2oHTVXG;7dOyPa^3(00
z_7o`J^G^u*>iEd0q0R3*T1ngUb*5Eb>o+ilXZx#~l0%1j9~?R>RX@CNh5e5;8V(`F
zd)&2tQsQQ;bXB_Yz<DiU%(&Cs2#^Qtr5S=ByVyEO2t*=^U4Pf8BO;)23RZIwZ<FDQ
zK0p=!Etl&6cz3A2^kX9yIG=1gUTyM=(z*5vVrGJOe0bO@DFTW|6F2T~aSEy85GumG
zWNzH&G<dmvn{1}AOwS?-r<Z8BlsU+CGf47!8S(W*{O1XX<CU+sj_%L~UkmOm^(xf5
zrX+_O_r0ml^=!_wY*YN|;)AmfqNU&*s0Cn;=KUU4o6iL<R4Dq*vqg23P+BoG4T$v=
zPP+Vm&-3nDQh=F#G)NOnWcRAK2;-ofuhMQueL}QdZ{_p>`|<YlZtq?BuN2Pae`Xva
zz&NW85A^?H{_IN6spiDPWXEXWH~pIW7`gJcNIsU^cAjl^)v@k?4a}(BKdlBXc7yAq
zuU*LM1?$9%OtFEqGW}V)<a<E4I-7&qW(lCXsY@%PeVgSNtBI1kshlv9>@LLDlTL3l
zNLbZ-f&54cV%eE^^@pWI_TnR34=2}2tTcds*h&@VtYYe7XDzTJ;cwh8Tv*|tK#Nxa
zae&EpQ6dSm8IMcDRqh2KfDKd3?P&d@o9z&?@7=FuMd;y;^phvu?z6G$B1M;T@@OvY
zd@Dk}99_t!fL+K!xox`K^mhfdALmy5KC{GeqZR_AZ-nuISiIqrw-VXuO0e|s^TLE}
z3-KcvT}pxV<L~SZm8*kJR^MU)(N0pzeM_4O<HEe(4#7qKamy)XxPkWwxNYl99{z3Z
zyuBSsQ_}hCP=wz2-KEsP{mZjm{DnfDFuKfHa}l-a7_J}q_LKsR497bZrX5u-*m;!>
z(tBkTGU>6@)L3A!jc<Zp$rioSQ3&tp7F5O|agvUreldM9p>|Y^t-kcH@`b->ho*;6
z-s!@ka*HySht`<8-)sz66L0xde}XN(;H7+~$7QMNS||=o0n&g+^8ed@PZx8RX8#3T
z6oEB$8);<`;Z)sSezTjSe0DE@{^WhcDR7|-Nff^ZO#kdnV)dM*S3RVoGrEC2wDdD)
zg#^cFOKer(_h;(U`b?9<aPq!DBEaiw-<y-<zOr8_m~VesPOFHf=Tw9+ej-{x&omV?
za$hNj!hY~{8D1P+^QF%$@}2VYtZ0ub;;Nad(TV*2<P7h`sNVwjsa&*Pu$F)3RZ^x#
zy$R<Z37^x;5#Y)XQ&xB*|3`mp#-?L)LTI8X?{BYW&Mf%}T^*g!3UHl6g9Iam3mNLQ
z)!}mct(-jz9X-jP`CypIf@PutkS6EZz%A|nE%;eQA=>I*M;y78<){;0cGk^@mtPmZ
zGW(yK^+@CW$~iDsW?}e~<gwo94Y`_%dwzUu3FW@MU>4*PYg03$QTz*x?NtO7ISDZ{
zRQ(l~4!`(yt@iVwHS)ie<U6kQD1EL`N0uFllbqu7FZyYjzAuc!@-_<ejAud!!r~o2
zb(0<Dr-|Q*$c2}-KPnIS*GEek_VFfRiJK=*E{vz!W}kVi7nKyC^+JV=5x4?goZ)MS
zrU7<>|M@aiWP!**rc+?9w!nkCK+L7UFZy&0P}j(Q4iVrA?mvnNnhf5ua%htW4-c!r
z!;9^hZL+X}vHG<Xk(wy1=h6V7!k2q|xPYL5VL&UmqCI}|fuT%ch}@c(*N-BrflQH?
zUI&l1v+uIYg>qOXI1YzQv$F0`^%mBi@sKj#|KPLS_psS-x`nn^j1M=sJNa>#a5+Xl
zpN%AO!eQ2{yzU}X^HLx9<)dk$qE)!X#h1no#7J7xrpR3m>|c!XTZez1HWqLJt{d%q
zCfNo`kHG%&TP)wle~}|(Jyu0%@kBafX*Mb;3+iVH<^@~8Xu+bkHGS@7#wW^(Dg_*z
zxU0>5Oivuo)*h0J*;d#IfUzIYk<%+(vjLM!G-81;nrmCT5Bxv)Cds@L;U|&~duPei
zWwzYMObr}_BL6fb&ZL6Jl7Kjb%~*ZrnrhLnz^R7!0jf(Oz+o*WSP&#)|CgBK`2V(&
zt&m~@L0}pfPA>7d`5x)?{qUP@+lct;!wouz1@`ciw`^lU`<uaA0oS4*1h0QPpcW5r
zKEKiG_RyC~Ptgdlt(IUshLy7`;drUEfF~c#o!K+Lp778i$%4)8)hnIE820Yc;@?s&
z(y<sYJ_x+1fhF_b-paRtBlAombEU(SOiz`WCklC#veg#H+U%0OaduvLcAQ=9HXUU<
z^lPesO1RR_nE%78hc1L7rl0;%K7iLyVs-508C_e|r~~ayhiNC;9q%{JMj8M1X%<_h
z&<D-iC|Y6`C<3EKuR_-Nr2=e|hImH>dU_WwW}7!b<X~F7dx$}0scSS$m@&Fqm*B%U
zFHo3yuYZx!mz5q;w8<CWx9ukN%atV@S|8tWa@m}BF0U2YzkzmzxVK!KFOie5L%rDB
zSh+XWoSDJ!!>faJ)Bb>d0F}I|ow)8kdIUwAs0_#*crQdnY7nt36opMmU4({eSNH|m
z(X-)-@C|G{axa)ehKSsE!ZT?mXR{;iI`Kc~5*7b+dU{!Cczkc^rNb9hd$sD(p<H!^
zu!K=}NrJ~jF>+6ykP;HnSNyCi%*yedI@IUT*CZQ&t&auI?0P33`taUo;PspmIRv)?
z)?8XA?izHh)>twgf*Z1}p4-?;G&Fm4jeq90nqp(HE3vbvcN-C^*&c;zm)Qlf5LW=o
zr5Ik`ZvLdL2u1TgLvDJA#P@;?y@3ml%b8ECz=b0uP?$etY*bpGNf$V8a7Rrey&L7%
zSt(Fl2sLkakGs%c>Ns2or_ax<{K$i#?-f_nZ?gpe``(G~LsWt$Q=zd{ZnHsFWy-!V
zyNJyPXD{)L1D$40H`OY%xqmz*r}GNa#_O;+z_QC(s2^Qe=lKr)v+k+wdY;mK9P@pG
za8`|ca+^44u<F!CtGSvuJ2Z^~WtK%y--W}X@d#Swym{e^OPTWOv*80`?C5oO$&o-h
z`8JcTp2^xLun(h7M|;*~G$d>aBz1Z@1f=1V)}=m~@5RbqLIH;@`|B6u$ESkU<;G1|
zJ_y0pNiNg-KV*B1VqpyoUUWQrp|H#I&1+b);ollr6}NU2kJXMk;Z9qv)=3WP2a2sP
zx^Chv{Y9IWY%^CR5<HDui1{+{60=xl|G!pD0pD-q`}H#XTMeIS{Ts34*-T&vb{ufQ
zRggJ*sZ?$}G;Czs$t@tFk5_vP8UR%|Y;T`}g3097==9+t%c!SfaT|&8Vh!>6Br`)g
zSIlv&uEW_SPM5IsvQ>EB9+kM$uUHPa%6;T=!a|Ls-SMYcXQL}TLbdZu`|p!eQN9!v
z7jMTZHZ6c4&`!GoKBvt_%YsQw4%Grm-nor%i<Wnl9vs3)@5@Sppb4F89E*deMK~)z
z^IuRuya?o7^lPq234VO8*N44tAs@aREQ&7g4;{3q$`~nk8GB8Rs`6XH{1N^$HF_GU
zJ3nrEw*hh(5<9BFgD|ejIM~<{g?-H;DS8FvbmbDqg?`0hQUA3Lmm(RlG`Bk@=ot(Y
z0ej@9H>1FZ2W~WCLGgMOGhaVz%uo%)(P(5nxAqy?GUdzHAr^l);BTv~QWX<l&+LEn
z*hlfK#nAt?VO|0`1xXIeZ6;_fuXoBcl5)TU4{D@$rQlcl0F_|RL!X-h8xv3gjcafp
zJ-(KlfNw|%;?HJ--^;PAgOIh$ya~VD_jf3~V}!i$!OnrBCLf({NEP{&%0u~|H5KZ)
zgi{dObqN>SS*Y0h^?u}(!NdPr?O30fzBiOoeaL0KqK>Qb?&bfX>@CBpjJ9@R1?iGl
zgp`8hBBW7LQc_B~TRN03>FzY>lt#K1ND4@Ihje$tH<x?A=iU39_grUxe;#G&rR$k<
z%rWk9k9&-%RkI&@i&paJbl1mfD%D<v>evGu7pcu^3^r~1+d=q)xIo}p8>FhIu8Thq
zx`#_wm1kW0(@uPMZppRCM~0!rt|RAXYmfnw3N)QYJHrclD;W+(2j_{ctZuTgnI9Q^
z%j<Vq{3GQt-KBT(l;N^}#^qpN^dY4cmfMBoYWKYNzQ8-LEhIJLn;bm7Q&0C$$2{+q
z8!-Nc*YVDbX|C*{rStC3@*nHb_m}Gm#a1sXud*`+`(kWkIkXi&%DLb{^_3qw2SFdH
z5*BMk`CPah*2z#edkdZHPd=PV9l|CYtOvfr>ta)_Ju3B6n%5n<_<}2bmLbYh@8)&(
zi0ihXs2A_2l}<=Gr5klKU2vIF1n_dC8;hs-0+vEemFjmz;OFMUe|mTh4AdWvq4T1v
zQ3$#{XP2Y*Gy3U^RO_~q%PV6Adw{tCzSIvB_bn@6ts{Ebwu;_Lg}E2pr@MU4W!IBz
zJNzE){7HAIPZlOh)L)mEYW{@e+-aIt4_=avl|*bv#r2uEvODG~6~rRY7VL_)*@+)Q
zme7iPbdY9AN*=3gR2WbrKYyMql*SMixfn|Qcp_0BynMXwvE_tqW`j3oV(BzvE^QR5
zNV+#)PVZ!;S#4%YyiLR7Hpm1HIe0|HOyjd_D;9or?=z}hrm$CXmkxwts*TQ*r*@&&
z#v{x+g1yeTG^kyN`;}2&%@gf9r(@cBaqN!iZw>4h5|54bllnJiix?bChyCX&TKVL%
z!y|AJk%PmrdWZE+gbya`9D`-aqvYJrLj)L;SRzQu+r;rrX+$w<GspETwC8wObjgx@
zMus@d4o*AemIpo-s^FFdH@}pZ%dMf{)xT4%Q+-je6uT;&ZK$Q{1L+of=o|oj<hNdO
zMd%kB+n2`d<_n4Kk6T2)jN|qsal?Ay8R%>^LX02VCLFO>MU1IdsW8+up<lavbqL<@
zicQH~BoJzm;27nK3CIC?i?_e*z`jp6v>mHIOj7b$3Y7^EJ#KrUJ*2Iaq^W>W>#%ub
z@*$GgmplmD?4Wp3D_|(o%k#r!BMCa}Y+Bh%=;B;YVXddfdPdk%>~xQrU6sk(wd(7K
zyYq!1YQ`rGQ4|nw^7%F*TrUAgLd6h5N&YF1SC0y28mGqB+c6@&c5t6GwHsMD1#vh!
zjkNK>b&}9s3%FlL?2_V%F%Jhftupzp4t+leY&E2morna3=p_nLC3k3O$uPGF1#!6n
z$W-9jIVFF~1rkQgi;v$)iu|4S1EXzpKK@dd!ug?U7vT2o0)<AuUnEY|!mUJ|r&7%k
z;=Cj1`zk^<hn#f0Fw%9zQ1L0?TNB+Zu-hPV#viuD;Xd->KX8;_Rh5<oZ(d-kaVCxC
z5RM|0+;|*PN&HR@`H6&qzEH%$N>6QKrB1BLeKASP8v|MW!mKrDsvrEKRJDZ3w5u!R
z$e`jMh9FZbvYxZ^g<(k1rSwgVY}EZZ=)8{#Yx{0J)3HtMhcHy?$tV7VT|1_U#HtIu
zn;{*<2j_c1<Oq2Llggn<&Qs{<_vnuWZT81&)Xy0-`bg#{^d8{3`}J^WCQ@cos2eml
zZ_HH7<&p$AFm`LaM^b}NscmVMqH^@_Jgd@M^82h|$z}S};}I73dkE!fRBP*5RZmah
z9JsSY)o<@-_>#1$MT)MTOIg%ZnfR)gLtNu%=u+r5N-B7Cz1c-0Dan7=FR%u@XB2ON
z08JYN*w{YyfDw|m^us_X3k3T&4mi7xQaTo|nHPcbSLbHiRxFaz_D;2$I;WUvqNe|e
zhJZc7*1JN+;sQbdabV+iCd<*NA8wZ&8_N89(yOr0a2L336|w^915_6Sh*U0nO<F;3
zhNx;wE`nw&gwdJ!e2kzy*OTV#GcKuLbp+|uJKasPtxsb@2HADS)Svd+)1OwppQRt6
zP}dC7f!2z6Nz%!_K0%FBb<FEb_be=`s^AG4Z*<+p&esq~IO~a75z?sNXR2jCwAyDH
zSY|<HCDK`Bk^ETTDB+d3rnJ7)mP`QlzmDhAQs{bTB0o4>Q->xXPIUaR<#k`@0$}WL
zM}Y%$mtVY^9-P-K;5*+lP*7seW#u@%+L)|F>kJI!RS8_%^S%#TRLo*Cy5t$gdCokL
zL!_M{P;oR-v5tNks`0|&c@F`z#ksG>&*xJwt8Yxe|FUm#*8dWYD>f=s2+OYr>Fp1m
zc?sYS{Rq;Tw9t?aXIDUFQDac1RqlFw|3TNdc~`(myHVccNx`F~uCYRBkC&s^yW&Ok
zZw6<+V;ehW!;BVoZ^Z&kG7`iY*nH_oRb_>%dT5LDUwU>?h?cuG6}+7c4fq9=)qYGm
zI(4QfpR3UDob<eOag@6xmoL|kOkck3Y&kMx4urCYx>jQWry9-*e}oa{8P;Y7gqAcQ
zgC8Rz2<eRAQ8diG-LecJ5DKE`!Q&0L2Z7M~9?OemH<OZVKBt3GXLAw)rmL|0Pl)3P
z8cD-3m(?|^PuzY&rn^#M7~@6a6VGCnc~5*CRXv!Fglu8Du<2&ZO+iPE7i|lM9uIJo
zg=K0T{`8S>?o-kWQqFiz6N8CfPt6T26=<dN4p4XaynfnfwEqygXSz}*=l>|pBu;~>
zj2sj?FW*n5`7@!dt3O?;P+0rwn6kk12zKLywp%Z*KX8YiuUN&j_BKj%iARp+IVJxE
zk%3}CdW8Wem8d5!WE_90LcmBl6%@6pUoAn~!@n{LNQR961@D(|@XpZ*f3RqN1!snk
zv3~Cf_>qTO^K1ALdK-j!54W@xow(#d8>CG%efuFX$cRdp!nU#0?&_T6_%UZI?tKo%
z>fdv4Rlz*ZSt?9=1J}WDnj;V(vDJ1i8@9V~N6)#qL=yv`<99vWP4X~xOf^jJu)~M^
zvJaV;da6K=JoFVZwA!YlkhM9O=9g5yc742D2a~(J;(gAf*Te3^wD8rUB6qH_Qe8P?
zOuSjAvq8KPg=#71dtxwO7lNeciMzn`MkFD$x=OR!0Yme{i_>-V6WbvF4Ij)L*c!8L
z7<M!5q|UjYbn@|-UE|$!FE>s7!8Ya3RB1m&+P<U9EXDmc#?Mlpm&}SK!Z@{(hzya`
zAMS$Vlld*Nq#Cacq81ihy$%p)acW8R6S(szaiY8AFY;kTA}+~~{cTMP9LpDlf>-(T
zcB@+vq#I;{k4Vq=AnQN;5oNfoguBY@4$psYPqbxc#JC8S-r_-dK)SoX#HL>T{zr1n
z2U&K(!nltwlRns=fcDDu{W=VyLBZ#kd0sa|do}&ci0?OTRZV=@8y;Y)sen0le-Re*
z68h<FI$n^c;Yz!gSFt8lvo}muhVJh0d|~6sOM)333cM-iusDe<n}l$j^8!u-mmc11
zW?icBtnh??xN%%js_!(~&x&*VuaE_<Q!2McvS{#(uAaTMNz3zSxaeBgm~^DC-s3gK
z_gDXkr|GjOV<(JaJdnCuaJo0!6cpWUpUm5lZJAe{M)mOnYN|VTlxaP?_K>W!ZZKp}
z4!G5NDa(tWV6SmLm7svNENl#9?S}{RrKD(_7IgCrU{TB}ALh6~B(t%q<W0e=bpWum
zPpb)8#UWR_+%OnzBkb!-he?4z6B1HOUVRO`Ad0)+Z^=Sp_ZzL91-7UMS)QwWeeD#v
z>MOk%I)10=7u!b>smW(sK$&oo68AXDdEP_$)d{9rc8;N_s<1S$Hgs!qG`Wp|N9vhw
z=g3@XZz+ZJ8iUi@71ugXnzU*}ZhY<zex-1<rKnlYMB2o}q&xTqpcA%NE)C`Dl>5f(
zxe>odQ`_)J9Q41F^`S9+WBX^|T&(bzh$V9&U2)Be(bK(J#8B4z;=*_|R3FQvRAC?T
zBt8O<Xf-NTr&+lF>)Sh>hMNH{Owz*yk|Kro<vEU$nZwsKTnXVzp}7u6hDAOsz%LJp
zt0t+(1Ek~sx<(ZID5sgEo(w;VNwvWqsH!cB!0LFvr&|t~)h<sT+Mj#?Z%>1nVJkL3
zf*Vz%>-~EVm#KHsL!}Bmw+oYK)z)0Q&Wl_p2(tr-*4xwQutS6=SOse|o`h2b%Bhz<
zMwFyOyN;Cm670a^>XCZ4R#7a<08g%E)+u>x1x4bzf>$nUtf`xGY;Y7bw$}4uvxD<P
z&KLt`NDqpa(BIb|AK(s6rs^|dAyB7{erLFIzsgH11Gk1~H`yyUsy2DN%*G;Td@`zq
z-HT^rvBFvD%<6xB@Q&}cz*VyiGOd4ILY-MIaH^8=x-84S?ej8h;oGH@Fi?fbYK|4D
zVvo>biXUc@R7nfbn`FZ?hKr$*-)3|(xe?px!guRwno(zOC~$*WKac*d@Xt}gB`KkQ
z7rv|Ua2@W!FF*5HN(Msvm8O$DiA#vH8h$wa4S^cY5$6U-AKn2tS#tEGnfITrExrY^
z9ptR&>1L!b!P1?&yUEV@!F)Tn2LPPco(RL<FRKD+G!n|nJswDDyuiT2e|`HX9+SpS
z+|qmVYhnt|qZHH5j>Wc~1dflb^_YVv$;6zOWs!K!ttrsZKZZuCPi2r!e4r;9wfF5(
zm}CM^f|~iPk1-=GCnOB*^mA{OnGEa_<tJa*q11|K?h4r9A&N+@EaJ{+dY(yHKNJaV
zHiAv`-CpB})s<)1$Ng5I<#1(GqYo*kM#*$bVE^m~nFgfGv{o+w%IokX&{dPqoesRb
z>TKOL@J}W4{qqrUD>7SnIUfZX6o;SC?k)B(c5V9<g$;+tG<E^l`WjAw4<z;T<Tn;F
zJOg)d-7ds&uISs0_sdt7XCEQaiis_*B3yD@98M%aH@Nsawf6$`rH0c#(cg`0nKpDq
zQ5xOu380d5ATQ`$h~M1$M3O(=U7+i&FdokYHsyA4y>V!i4JPniQ4OZs=1N|lOB`RF
za$FedAm`tjr5Vbaqo(#|6?F==L3HN18}o^v=_uM#NpWtugJwI+AGgc*+wEhDMbdC7
zRlWyTM?A?;4LG;<S{pL6p0k-F4-MyQf&5T)-Z$vj+Ep(z7C74xVrfA&N%T-}pqj3+
z@yD@fOv`9gQ~h~!b)BYO`vH;LY6?`y<d?>G8>m)t+!89xXDXgqsCnNP3>#_`7yS7c
z2$dcMc})v3IC8*zIDq*qV<tq*_$`InPxBd>!IQDC_5&_Bs>06TuWYcCXOO<oW>fK+
z<5ByYa{Ajlt{b$E7G#!qzk2$H)xhz(pL|EqNjAPtin6+AG8@)>-;VaEoo=!Hd?5@*
zWiA@=8Jfrx;(mY2%Dpe-<CiC&GGTfC-sm|p(sGB#CBb$ULCMAvtAKFC=NGsu>#Q%*
z(xh)ZRP(S?2fh#my-n*JM?~qnGEEpVdiy948d{3_Rv&4HF`Z8PkaP2t9%JqOlbq`|
zyAEaQUN6^J1WYx4hR-CP1^_3P(+m)oxHx&h3A@7`(*AkZ2>2iKjbf@b(ly%>1tNF;
zmlgo_gld)PVNfZLjmWH;UJ8elmD~=<Fays|yP#l5n9lWV00uEXEs~|vUgdkq!JM~W
zxQQoo!XCV^2vn*Sao<?lZ@NBbGufPYll*FIR^}Op_vf+VFhxYa_L_+?On}T)R$dnQ
zScCQKUce579%-^^$4rDWYdp*XA=xng=xV>$PTV^pVirK#n5}IX4?H4YEwImjg4p?j
zFa7mt#V0MW3kn`|R>ho-9Y=3?_Geq`bsEYYdR57IKT2~N(QW`@(cVL$9HH52@Bz&{
zi?3O#t3*%SH4cUTL`;@?tqnQ-mjG#>A-4qS1j43w%{R5pKA4HHS!re~gKXrI?6(us
zdYb1)V}<JV_V}tcbAh4@-|(gw<2#g&Z_kGcr0`W(l&4MKl9DWtlyv8}a~JtEf^YVx
z%CMHI6w(H9EuM^pynyE(5)7sH&6sK@6O-NKz{U!i@7y`yWY<0O3c312I(l%B(Wppk
zk=h`L9nL?;BU>PJWN(j|$v#0pQ+A?ZfWzzC-58(-4!pSF?Em^7v?>rJ;68wU^>iU=
zDfI3MX&qu4gnDek+ZJxJCoq#nMCjrpq{=`jkL}#+mKL!--LfZu#S{H)v1;X3?hbBt
zu~<|`oG3ago7c9SOmElQ{-Kby4@BM}v_*X96dm9;27f6)2`j*CARl%I3B=K1YlA$u
zI=>dK&nfl0QnQk4%$ciq`NQ?R8vJiAQ$?F_3e#QVq6TXX<oM5vDgqZYJ9%zBj)_X!
z4wV<atYlO(uy6$mUEd<femljg-s3mcEtM}uH=j)>oc5S{5HRmDmf`%e4HERn@$whI
zr-EW0!aT~rfqS$7JF)Dr6W4`S8zY6oDFVfwZ5Y7#w_Mx~C}4%Zm)_4~s)5t#-Rpv)
z+Jc5|4uZJBk#ElSP@y-!&0O>Lp`CaEEODt3#Abi-9K)-x3EWvXR`au{B!eWa56Kr-
z;*`g%0qEpi-Y>^rp#HGIYc*LhkW2Z9&5-&!-F2jXI42)aev*-C;;`3Q!Yu>yPt|#C
zMxUzCpQq|H@Hy{4d*({3M9cDcKcEl!Q_dgU*X9e~aVyLQ*6ch?+)MJOyTxficTCtL
z->6pf+5)(xAa=pu2yXr5G*JC`@KLyu?!6~T$wp~;3?Hy=CC}S)Q+UR5uhq#{h9Iv1
zQi}@D3EU57VR$5HoE1Hc_MDD62Vam5fBQa<XVsF`WMDS%Q}Q0cxtv%~TbdBUhN{}~
zq+S1bYmo)whs((Z8@J6|)HnCY&wASn4b01#S5M#CP`(!$!P046Aa96DH-qthy<Q?Z
zzGTn>iXQakff;AY)-`LC_IrGVP|Q>DbZ_@}Ew3YB<My%xxeR)pA4;()UNZM5VM}ey
z|CSCzHc2<;MlJFei);f#d7oemECCwdKIeYlkz0%+)~QqvqYgS39Vq!7!~8|t7Qa{E
zrK9+v*3V*EyR}fQfH0hGWPpugZ~z>4E&jXZiA6q&;3GC^*V}WG+Durd#2zsDH>aly
zU*K`>)|O<y1)cXboWCs?5o)cm4ZqA_BNu?yW{x&ddR;-t-7z8VgQ6F|7?#YhO+>{_
zevI;a4D5WhxTSH4<#i(bnMD_D(wo2#h$fW*60D*r97dwE(@<t&&gbGjj7O)1_M&1W
z3^{G)-mEuQD6cLgK68lB9~<p->#H#7{oG+SY2TUhM!0LGw!isv{&V4_vf<#)$Sdi&
z03~nMyF;E=XJnzpeAppPud3gNU*tEttehrs?8tff<9vC_{=+<)5+weM#UiC9Wz>2g
ziGl7hM0`(>rUqD>vFW~Dk5P!*``0VXaN@AS2^(Mi-;M9fon$tq@O+m-m!Zq5_yASE
ztGy_*Ne3|d^66g}x)j=|YV`}9I0t-`6+hvv2i&Hm)gNqNTPk|@O>oygbf0*LUF3sL
zU`J4*E<{|zUy*3n@rv{*z`FiO9~HmOrJpP{d_*NXP12WYu)#&3CGa>E@B4=57qzA0
z#W*~Uvk5a-A{wC;qguciV5o;kTv=kpqH^{n69nLOgc)!7nINN`eogttt!<udOn>S;
zy#ql&AAXt~mx%XCO}9U7GjW_mQe_xA2-88Hk@3FsllKx8cM5I7B-*~X`e+%+M(qnp
z@;0i?{Nq%c#tf<hVI*mjRS^AJDoV=#-=P9H({0;DElM>&x8P(JFz_ZM#=4@~yyecp
zSzw+R{;9`!IhLLRQ%|gTPWwD4L^h(YlQM}Vt7-r7(9O4}ZQnbL#5#jw4YFa0>7V*#
zQz%CD+Q**~<9|DV7)r=PXf>wHsw45dZD$*qTY83Vxx<K=(uAI<H22P{|4ma-%SnWK
zC$3K|{MwVfx>GnLb7gcJyzu94jmkX6ROOa?1=QjjIcD1u;kC4ox0`}+`;Yn?J^p{$
zKbKvAe%BEG`eR5^pzXviL0-1)W|!C*VUtL1pEk>#JSdMXkK&k*aFLny-&*mI3QMri
z;4F+xj122Bl8BpBm}6q^q4%_uk6HR%IiBE<Ft@~N3PhYZFSN!XJXb7@#j#XtZ!9Qx
zDPELuY7_HxdBTPB*m2a@k^b<!>ll_Hmt;pK=p+$u@<m8MewNjJW#^n|@Vg_iyw^E3
zeS_&;C2!-2p&;98tDiS6VL~Vy{#uw&sd{pFZiG--1H}|FmOLSMipfvok9jX0X`lhK
z*8r96kqZenZT}5=wErIT79;Hfyif$(&zN%MzlDNvOUoOI%5VE$ecVd7U+FX-$;Cp4
zF#d_o=CPd@6Bd2|Ca6Z}G&sS#R<MiB+KmBut=V-Bza+KX2xV;`EeePPzwFB#E_Wz`
z$#|94GlW%^6M<1tM}j31?OdL3|Ni}?z02?K3d=k$9d;IAl(3s4jHC5|D7VwC4A5}9
z%&}Cr9{=to8+*y--_X8{ejYsl98;0clUj$>Ei9nNdbG{654l#p53$ce&JZi7LM8j^
zU%A=azF_%KEuTzXU%i54(jR9haKlchW3^>CK<Vf}z%w%O4p2gZ0-96|ERVrlw$v$M
zpH?CIhmM3Lip6;`cPv+Kem;hr9(>-B@$H|wcjJ2ZzUAbe7dK!MHmMnZ3I|#9O->V-
z`h=Kpo$06;cZG17mL!<Q6<r6yVC6Q&Gil!hhEo>80qGX^j`@m)`N%m*g*?T#1}pTk
z%YBd_A#5ERIC)BhCm8(&WLx5bKL6WR*w_V7WYa!>{*;CWsm5lmM}^z1?DN;J;b*%u
z)b3|Hp*cB0FbqN_;ZohEb_z^20-1a_-|<5Mhd-!bDrFED2r(mo-}(b=TZTvg`uBmo
zosd0LwaReTCU|R6*h56*MbKWvy-F8MNJ<J7?&TQZU)gz4Fdqf?{$oi&bQK6C**?^E
ztBW!FFP^s(2{d?p;;-|x+n@LRz0?yrHZxQ%ncZz%HYTPWk}6HnoLBk<TdndSsp9$P
zO7uqwecyFfJYz2P=lBIY7xw$VO7_ZUP#Fb1Sz!JA5}_lEP<6Rv8F|05R`pKP_qm3h
zaJrv#hV?ux4m}f+BEBAtuV&)M>q-OWz7+P^S(Gka)v#g#rghFDH670C0rZ2(BY?|d
z-_!@eomen_+OQ`8w^WpWBmRHmT{}A9nM_4RL|)i0i#?n8F(3$S{-z5y8z{<&zHnRP
zEoi^>w*J!{voZC94p48oZ{~MrYO+9==Q8O5CvgdV?AxmH@x!V}BR6i*%cIo}lFd&y
zYrntzjxMoV`kBmSnb_^)5VT}tC%%87bVDx_00v(5K#H{M@Yegkad=b6rt)hTGiZ3N
z)j52HhX?!B>tAL@NZAktM74aiM+qET<K+zVj3=L6S&Nr?7LrOcC54$(OQxQkU07)Q
zcl+4=p+x7xS*SWWUn}NAB~A{W!cfIX!^=c`Og6YwAWPOWi55Z@6r!An+E8@mJc(W#
zbNBrdG%*Fb9CU*<@<=6)+~Oud=Zo8(7-m{<_Gq19=tm76#`mg)ubmGyRc}8GpWm$3
z$e2$sBe<WXDIg8jG9_D`%#K6?kJ%aVcDMeo#{``3zaoZO4DAftf`KnQIOKdz1WNCU
zH6h>*k$jbc*h^=9#(S}xG-PbD;6k<1(4ZntNhzsP<vjV;iHQl!_wD;S+Jv&_+XWvz
zSaloe_s|m}@L_&VJHZzhE{%tsq$D17c1s99+uFo)@v!QlU>7>HY^O>q(i@)Qk=Eja
zG4ag=HQ3~@k~v~G1l}&5<|L)YYvv6ghMMT>r#~=<tG0gzU?^5wX`p?K;4y%c^%q**
zboxk~3c^_0<yFO?=l}v{<`OT~mMt5fb*=f$Zuj8PQiG;<L69sRj9&37^hv?>N6Sz1
z&3enlBDr3aLbo@3hWL3Y4`s)sbJ&cO2&4&EGbcY%-&Xl!{R>GxecH<YL-HniU&PJ?
z5HcG(L`Vo!1U0M2l3DXX@A~c@Ke8I9eRHG1t=v`d=j-R4=ODLSz_Z~38QA|Fnt_F`
z`>=@zT<`M=<sB1Zb)ojt<KwnuHlvE2yw}HPJ5z|>-rhq=Z4PkU;bcL+@O~s0?Tthh
znBn$DMy3r~+8A3v?R|Snw2=xQPtYh&v%2xAu@J}E7ffqOnlC&_#m2@ae3m(YgixGv
z`p)&@;2CI8eWad+OG3hMSH$_{cW^@soN>fGk32U<;#6ySw-owu99<w8bWNnR-I1b^
zGU2>kO$R_v|B`W}M%F4q-daf9%9yh8QesW$xd}~h45;>+JSMm{eU0~Bg~{Z&dl@Ad
z?HHF#u+xge*#dLA#v(r9%i2WM$%Mm*(0x6X@WR$<L%ZJj?i6|m+wIay+=x{!sC3k)
zMNz*9>GhS;!>?g8u3hHNSoW(A`HS=aW-kAY^Y;+c5}CCE!8}IPl>8tGLqjTuHIJj~
zz#K2o_aF-Vp19w(FA_$m=>!C-TFFrUu`{d+r~z(m^AZo6>{kLGKxL9xAUP`=6bhHT
z?rjd<Jq{@^41ANfd)mG&hQ=HUcwD>yBfk(3_|v?u7(mOMADGQm=V0D3MGQaRmohyl
z#z@8lcJFE{tX2stHy%@I4>DQ?j1L1do9=_WLP<c$@?xisH4RQ>Ou=Fdg0SWD30|e+
zIjr?HZhES+aS!WlvupkqEcUC6M{PWExRZ^NdsVqh_>A3cI0)JT*+N{I5Rz{P*#Mqm
zX+q{cLC+!zP@~vnt(0mB?p(j{2wuUczd#2W9>1^$f6d<vulwIKycY7s9zPVE$ApBm
z&BgM5?3iHMyoDNj1r|EHN&ifbSUPJNxqzFBN8Ig<Eeui}55dRB_XGDB8TQ08EboIn
z(4DU;az6@Oqrh!F?L+Z>B41H7J~XR#n$&C{RlHEO*bWRp9xc_=>nmqs%PB?JQgtS(
z&HU(5st1b%lkCDw&s6SgXKU@9R%ATYG;3^_*@r<Vb&z-%;iu2D4OjZ`b33+ApB4p)
zR%(F&o}P4*^lNa+u__v6>@p(m#zKFFE_Bn77>#rTlM3Q~k9L6)#VHC;k`cKiS>G*_
z^Sd0Bx_F)g9s0-X65cbjw9(G|$vc<Q<fG5|64x>`gVP_dco4Iz^|-}uUfg3gxxK+>
zMB#qQiDtaN5{D6A_uQ-CANVP{zSlTA2Ubb(DZ%G;h<b%b+$K>B4~C(tCg;}Z_k+<C
z;*vK(QgHhj8$J{R<@*O9jNd&0FmnQwg8rE-`0%wP^d_-p0hpBeTs?)|q}^}qeBOPa
z#F)=%=LHXK&ATVzpLIdU9|ahBL}aN5!*WxQX(GvIB1nkMY_$_#m;wHB)8MMipiOwS
z*<rn(`SU0dy+TU~ej?7I$*1t<@5W8_4J}}t?w2Zd5@x2>sUS)(`l}aBXVY<a-O>||
zi2`tfr@!7Za3BAL>6az5MZ_|MBA*rX?5kIaM}@S?K`p;BOL=|@@je7CIRx?wFubjI
zN_8Sq{B9@2|COU!E+IB7EqGHJs`OZa6d3tTJEOw%?ltxAoR*zWkXMC6cB>PcIApNr
zjlR8%gLc0hk_1R8!y$G=a2iVT?`r%-H!`X%^hmQ0OY(m)mVF&5GY~x#9=m$z{!06$
z%fZt?OcLKz0e7mmsr;E_IBk&ixi?MAh3$S3q&%5mAdq2bLwuwIQLW(zkIklq3{e!^
z85W&-{hN!!WzW4WKR9ergJpgG26$Xkr6Z9dpA2;3hicsh2uyH%n8L8`bwQ(yMelC*
zCYaUj!zI~amRYdFdx@V30G$x!v^ec^aJglh9>;b1X8<mf+o;xl+l$kDja8Q?GXt!l
z=z?y&ZNHtkbBHS<s{))li3a4<zfdReg9QrjiiN7o&tj~E0CjUIZrq>{=cbk8lh1>Z
zfCGAKN$1_RrDy=R*xwZ4)}c0zu~mnUi~A`%`#GD*!D4GB=hs3W0dQUnjXerDzrtWb
zXZv8}z=i@W!SpxTz8aHz4O#gycP$<T1xrQWFp2>5c>M7GZrx-al%mHA`@P&hBS^F+
zd>}7yy`F$_8(n_4UaK%0V@$%O8G2Q9O#pZxNa7URBTmBKWS^GBcPApN!sD_`TG<g_
zk6s75b;L6sR?k6SKh1^90y=As*WXBy1<wlB?eu5tBs<Mfi80iMuFB{y^|>@&pM4ot
z8yE&j@Nh+44mblfn52}`9e-ii<A2X30VQAIuqu6wsHjELTy*+_=`yEs00Hdpyo6cT
z#B{?yG1t?lk~oV=ta_0E`oC0r1Zk+l(6)E-pcM3=H<TiQg4y($tQZmg{*NA^puhnz
z<EYaefvqoeTt8s+jJ+{>$=8)j8(gbXeY{{TKW{&K^KFfMN{=pV-+#C9WwS&ZB;`Q&
zZvDyh$EX%SnZTL1zBIz1B;7tbj(3y12teZG;jeKF6W3Rdty}m_B)4TKD-yj?6+6ZY
zXtl~MvcR~7+u*>{??&^L>IB{QjdSlU*3?<LaXwUpq64KQI8-h8NK8xU+f=13pZZyQ
zN!{yA{+Q*?Bk`+0RBfpu0Lx&gF)oRv{j4M5L=LdVvwT}S7n*M8;AViI6B9%LGZA{v
z)!6Dir=|Vb)zwu;l|T7gXA#^dA(LVrKb1()`#}nWh$Vb*P$4EGk;6<LB2CKCp#=mN
z`T+!HwT6979L8$BeULz`K!4#0xh4{Bml;ndP!5UM{ZfhEo+ET0!%}Q=iL8jBwzuHz
z6EB5<`-OK5Q}yb^JS6#9(`%Yu<3Ji>M&&IXrql$V^H2e)rU5IgUM0gyJtgg@VAAZf
zAK%IhYN?nZq!kE751`Q*83Mh}N&y@4-}sONa0y41(||>GMSRANIqYu8i<p|@E{V1O
z9tI+AFzmZ#)pvT*ca`Rf>*(nYJb_S>fa{egp}}TPcdMDiavmp;D-Knd$b8tJ7ZAM^
zN~qwo{>;+?(b5kPGp${&EHu550DMc-r&Kyn6V0pdEVU-lGiyr#f-tJ*4rE?em(KiN
zH^e`NGj~mW28Ed5T2s3V;%Bpe%9jwz=t(RV(M^h;=k$xKt9*AYH1Kn$G8Q(wxajuY
zUI7Vo$CE#Z5m->##g+PZyA)|we#mqfUjW^RdSaW`t^+{ZD5yjEKn|Rccpb&(ut3I9
zO8QSW+AbHskyO<$OQ9UL>1=iZEz%%8PGr)c`kJ$YymhXSCr`fqYQMz>Q;j{;84NC0
zyn;4)54ZZEl)E0A&engFAqMF(B|fdJFz^xvmv!sHs2{#<ZQ6A_DT-%&hrZx>{!K#}
zl$>-~Cp5n<g<5uqZjS)mr>QuhIq;_TXyIN^*sh&e_N(EQ0Sk1}?l1~ARKBiYHD`}X
z6H3$?J4O9t$I-C38dMPOlbO})DVnaj!om~Gj@Kk^%9=OEije@Fn#-Hqt7`K)4Evd(
zE=<=tns@}~rK4$Th{!>~Kg4#SzNO8<@4~u*o1xOkW+n8BVb&VJv}Yg()oJg^L(YHt
zdG?KHsqC$HD^UoYZ~LwE39@S+UfBKcv-$p@Eg=uEvK@6vQ&TC>(I~&qU-Ocp93;y`
za1Co?PX%s48}MtKLk8-QK)#OYxTR1obq1Y!&hb*cs0lsqIWm<%sK$bARQW-*o*1y~
zzOmn<xVDj{KRDFrAB>om`q(ZI<6`uPkZ@4(j#xe3-ibN*H20W%FOS%cJ^(u7O#a#o
zMz3Jx`UGw0Ay5>jyDXganxX~gzr`@w9xZscRM7C|K3E=b=Wb_V_@y7;FFaa_6N#p)
zsi?03b)4(t&?Y0GYOwytn<|13)9ChZ0nKW*78mOY=Zo9<KkGrDH{W;)-;Z<}5lobO
zJ>Tf6b7zplu_Ch&p2t_|er}T?Q|GV>zm60PaGcApN#F9ELn`6rXif={+V^W|5r*Fa
zcjA#DLljOaL;<cVRV;4epmk%^E=Pu%fXmG5KW_VHW2(vWgpp43t&p28Qq12R%+0t(
zyL^F3v_NDgg*Bduig*mcoWEdBk;Sv&3Aw$(i!}>%_JU_IW<7QUo_W#BZxKMrl3nuV
zs>|rtk(?prma9k#t@Oj7)n~;SQiquVY)-~y=5}d!GUTVuDGlb#2yL-qV4y-WTv7K!
z^JUkKb>*8wkJJ{p<MZM9OD2JH|IZrD-wMhiHefLPC%(Uvc_a3_3k=DL=5w}bh*fkF
zX>i&tGaH~#DN@G;9<9A$zZpuyVOH|yS9VGa$FdA8Y?x;S1(VnZ<bWYRCV=Mn{rmUn
z4q|(}vtXU5n>9N2TRtIPfV*_<H-~A4l+8AWbLh3ItyD)aJ?HS@rjtQjq|-27#L)(c
zBLEr-&+SbZsDAt{X#k_awF@w8ve?D`u*ro9$2=Kyi-VQ+<iM%(_kX=6nQ@}vHj5mz
z)QbpfLE%d4KZ~y80U`ktG}e@=V(T72X^V46qIxrR0pYP&Y08O%`H3dHJ_A_&+WW<a
z+|~j<@JbKEqpxrQ(Z+)AyJ}3(w;w__U;u2$7G5{^`15~ahp8WCL*L&)zw*1{VUcnZ
zU=3mr(Ce$Qb2$zZft+V{CZASSdX3-XLg7R?V<+I`j#SU%FreEflU;G|6<8PgkauoO
zqkZK>T>x%kOxC}T+w9E(3yo*@J0U2q72-|;-LwZ4KqWwNLtz|TykB^PJkG0Sv2Bkh
z=xaq5(l6I$tcm%p`1@}U!hSn%0^BUo7d=m}SDn1&T*0JWZX;M~Dyn4{FrFDs(9<sU
ztx@5|+msr}jvtdwp$OD_WS|!feg^7VvB-6}Nz^dHNv)&*!z4P6TImy_H5y&m=H2%N
z8e%mPskTP)aAIR)qoHan3@If4FoV>?Chz;^?hm065nO(ddK@sbDYLbX562l4!aLQt
zy%J3j-UCIa#%g8xk1?YTH$ZFBiW8TZJML>c0ldpX`a}+U?e`%UdPz3Q9#EiXy7GTY
z1l4M^4Pgz+D$B;Gv*ITJ=dp8tf%PKm5tht0I8%P|i;L#=OxYQJJ2mA8HI`M_1Z1n2
zZ9*|0&eDdxvIY04KA2MSUlp}?r+1t&OQE7ihsN-rzz&DHD8M&2s{Wg20O`mB0|Nu9
z5ueULEYbteZ9bC_Zsq6e>o4cvP|>X!O^&H%oG{!eUwWa`iT;|ao^R7=vdjP#4eeKj
zSrm8bW<%&-c;8^VAUKqM2X338*K6hn_uG8}7ZOZEW-4SC;l!4pC?HXDZGFhJ=akvi
zidxYVmZ)zzNP(O94ieLY-z!@qO_xgzH6{+gOGN&JsCn-XUm7ok@?B6lN&s~qV>uS+
z2q;6K{aZK&2=!kJ$8b@_G?P{}CbMScV|LIRj}sCS!cCd4+u(!+h{mp?)n3Ii{nua!
zkMxO7%s*bJUw->yIO!5hob%CbatjHExTRB2QnKEC6>xXj#kN_L2Dy5r*F8X8#B!fG
zac`Bss}?gZYiGZ~ZHOsr)PrAQyEFBp!^{tg^VSC{-Gbf$40lrklx$a>bCJzJ5#v)Z
zOQSze7hnQ0^kfqx!6!<*sh!{*bPM2Bn=+1nPsAEp62gdBGr_&kll319H{xCkfHbb)
zINs_+!4v!jaDaI(#UTAB7V_c;5<F^Vwl>K70#1(6SIyww7D+(qy(Yon#KXgTOh&fD
zrXS$pKv$b-;=#PcuqjM4PtW&@kTVN2sYIv2@c!<0nMHvc-=spr>+HQ#43~EI+)}7g
znaD7kHd}J30_uNh0d$@QLZ39pXxlT`dR^>Ur;yFBfy%4eO}qV$ET$USNR-(RaFU$=
zI#*DH{Ws^z0<ghn0#;oz@Inx*y%Ep!yC?AZbUZ9{s2sNQ{2dX6BqhA}+!iEyZWnuh
zX9FjqO6GT=o4jIpXw|PKd>Og-2+jvHR2g=lKhzre5ew#LKks><*_nKn&6ETPVtqiE
zh%5qf{~5T&x3uvn)S>koe;d5FqwJ^M>Mtaqiv7d$<wp(p)vDuLL)zcHaNPgQ;RHUx
zOmM}4p9_M&DPZjXb}o=gq6I;4#Jy#wmH%p<SO`pn$}ga$Cs*!E--3J|yFyG%3_>M6
zGh&BbNAgVmI}c_V;ex|#?K%hbN^@M)#kwOv?q;4|CtYnS=+X3OK5G&2)3;dZjOg&*
z+|Pe6VDcg-3JjDqoUVM&LOF4ATo2WbvDQtSau4J9$B9^dtBcjY_8VuRi8-!q21su+
zTT%SOm|N{SIuL$#!5wvyD%?@K{BP{Zw?*{#VmNXI?aCGw-!C)1S2=;Ju_UdmnA}b_
zK-3x31n{&zBC>0u-nIV8TOe>$l(UIU+}A^3ivLDHP96caXi7jB@cEC4h=SDgJm2l5
zv*@oz{snpr%E$oy#i_=@b6J;}HuE#JtK(K{%qEglxJ1&D(Nh7WTT126{+`s?LETnz
zfI(Ra|A|3?BEs1ZnvI`u{nGucXrov}Ks}N|fbmZjCgIhZ8{oSY@)e$q#e$9q=5Mt4
z<RPUWcSgyA;hj2v)_L(3`kd-qk7>t?H2hY3lfwGAwtk4FSc2aYrJ;dBki@T88gK>X
zKsV(u64M-3iMn3`V9X7{#d@Lf@CF*d6K2+gyA!)}SRHV?blP<Y%*RQ~|FRPg(X{FX
zXL7#eff-Pw07dY>ITlGENm1RaW=)vt`NC6rIeDV+C1{;~(Z-~eU($8mWm(=%9HUI+
z``->G;*vojt95Vwu#V$gqx-#LUeBXsg>var9EChDYL6>d%f_?%D_gBW%^KUe_JiQN
z3)4d~Cha;z$oEmZ4doWx$@D514#jL&YZG6&#T3F<0ngbYy%^`vm0RhtgDE0wg#u0H
zKRv5i(`IT%=ks%XlNC!^R@%o{k(4ie!eIBl>w4W$PpX7O{NBQZzqv(3pHHo;TubBY
z{L<5k)aJcML_XbR;xr#Ap!*p_R}fjA0|Q66{uRs16d*<n48Z9CtH1(qFyyl3-zlR1
zxt<J%gu_N1n&NQD2|+8wO(8Y$bFhYT=Tg75@-fZ!Yn*=2>?1L<wj0gt?$oib?Mt%2
zq8FU;%(I<B;wPl|_IB@&V!PN$R}7;2&X&jv26h&toSw!~bs<T8zr;HwvM7q_pxSQX
zul!EkK#P%pfPy3G*Qu8;@2rBMR(Ud^n{J-gzGRTh;~4t_xYiv_Gasxfk$5>LQOiK6
z4Kb%6JFr6HTzLAo`R`!nf7X!fJpfTjx<DxhFj>fB%RqS`)rGZ7QxbiOxXkaGCVo0i
znPGJ)ooPRvO8%w2=IH&PrC(sU@OGp?G_w|W$XHr3*<=G^#zP(PKt!ypzlzoCgw!U*
z%nvV@)<cYf%AD5;IV#<5BYqO6yb?8j#6WJL?>B!JD-=I<GEEv_cf0k@N*9JMbZ=}i
zFMe*~vMd%;WppW8QM6F9SX%r;vrVMJsFsRUBMx*9nYfj6{XJvz+3@``|My7pKkt_g
zd5Jle>KnyCXs&yQ9ZlFdk-$^kOE5)nJXoR*{oM;rFEZ(*LeRe{zgm(%`tE1h<Jnp-
z$jJ+V_seABG)>Jy*W^^bZpqKEc1<2>4^1z?Sab-ccW0X9HqKppu~E^ZItq~%y3=nu
z7FeD#cm;RQX1oSBPvM)coboIvouK6taGUS4UgGX7{Q8<P()9L)+Xar;9Rh30ZTfYE
z;U<4O4i=&C=C@3m7u?o@p-D_x-D>RI(|YbGcbh>Rs5@g6W-vYjKzd~|wF7DUX2&?l
z@LSMb;@~WM*6;s7O#{SznJDVd#7Rn$_aJQvO!In4_x1j-AL^8ub(ubtvocXp7s^iZ
z3}%vkLp~d3;CF56f-2X=j!<I0yB~Wwf{Qz<oUeT!mrE>Yfv4-SnIQY_e*H*~_*Fg+
zcd-_OE+vqB>f9pJUp-PmC#^h5GJMHl%_M<I`n><fwJ?(SNmA^4y#z@dN-7f-PTIWi
z$JKYQMF)9!mF%nIV(z9f!cF#{%J5B{2NYM;tpiWxH$wv23TiM&D3c-jNSG?XW*aa5
zJ;MIa0x&fo#MjR;{uMh}YoA5y3(WXeH`wj%N`q5}lihhG^^Zqb!rg<9Kvj`rM1#jh
zThv7#XQ<^SM-83Ix*t8BMXPlUdz^%IJP@R6%(qP+k3rF4yZKf#9`>1c#ZpoJ_k7uG
zT7`C|M0RLhg(!p7i{S-jy2zGNBaX+5mt|f?;h$e%3<#yY9e-zFmJO@MmX3aZHmcGt
zjvO+n7}B^I7aIUF9r2~r3jLlxhL#`#>mxP7rE*70rvHI@u7L`kWx{J|AQE%p1Er=E
z=$UgW8HL>owrot=^}Qj57SaCJjC8~LGTG#B%tvLBURIvq`Wh$gZQ83q`;fM>k1G}i
zG8$~RqFMIl_bg1QeD7|){a6AD^Sh(tDAW^66kk*bqnhM!cHPgn?khJ@W<#Ztq#oXD
z1Qs3&IKSf7Oz8^}#^`+T;O?5oR=aCDK}L+joe_uUxlNIdcfr2&eX6y1=dgQD57lZR
zQabIqbRgK_SL?vfJ)X_W+8`e-yw@MSIxzZh@$=CbsN#mOoNFuQ5^4b~^#Ho4^S7!A
zRFD77TK!*iP%~qTp{XEivS8O{V*tRQ|9X2Xp%-;)?sfblsA?u>r<_J`&4TB^9^cVo
z^EdN*SDgl&*iyX)Dhk2<+4|R$irz8ZwFHgICjvu3MoT-T?F)RQz}i_`{p_;>S9(@q
z(Y<s$c*<sr0Uk&@TV`lv|Bw~v`;Ff*-sV?7l6q%3itFj7>vhT{-dp<_mi_)u`aG3;
zScUy^EbON(QGb@)2+mG3o$<G|3jGS{x;*kEB*%f;!vZ)d1J~SkZv(#i|0#oWq5)v7
zOe7S%<s2xWJI(7^RM0c6kCw~`^S`J;M&GnsZ66Zdz$cF6CU<Y4bEddChn-^vK;142
z|4>_<pUG`ZU*WTf%M~!ul(m|Bt9c1fBHr?$>3yl$3(v=0X%|pn*Z!rqMa^Li(w(!+
z3K!tCvNVh9(`5+-7Nyh9X&GWdt><Jv;YASEO@&<6{&hUOYH*Wv`;Qzi2$UE_(U~CC
zIR}-7Z|6y?q6SlUlq%>9wazGHFKZ`E3+T3fvvV*b=~eIgPAquzdLU#ih3ek*c=;>h
zeEx$Qvvx=3b^G(hQ%+6AIA`z{Z@ddsG(V{8kqJ2npU{wSc@b`T538s${`dyHbl2a<
z_DB8zS#3ea4v{?9echcXz}E)pP+UcW2a9Huzu$jS4S19rEI^n3KLx7|2-^0v>ISt(
zf8^P;%a8A-8@(WI&UYf}-Dja?aIQQmaLBG>>P}O}_R=oZr>&htFU!qZxfFXU;}JLS
zj9$;q(*t1==#Sj&&}Jqu0p7nTZPTe_d4CmlFD9n&)@r6wLO63Ni*~6aNf)>4Pah;l
z(Zn4HJ<%5s|9XcVxccNS@IS#M5uk8^49%uD`|IN&eEY1u6>=7f=*-30wxR#{lG5-m
zdDkq;<L!?rCtRW}7%KQMp#|COQYJ;(?}iWKK>ww#ch(EH6LNpnnUCU;WG^9?DK<Ok
zcX*uAB#?+-4AjDc5whPtF^<UzsG4sesVRA;y~|1Alj|Au%T^8MBi9+z03Mui3N-S7
z`1B98=fHnp=G=I2%!)@Ntv`}0SI_s`uH!jK@c7hzYXG%Y)MBySYFe+i!AAQ0WTj0`
zbf$IyW2P(^Hb(UB=Jg_aS?krH_x&Y`@AZfFJAoOFMwLI`md!^`WGbyDxI|rfY2+Jx
zVFWd=J^5DpceN0LKb~UrDfC1DjY_a-B?yeVe5t<x{44Uwg90^qo%4C*McvNKDu#H0
zR!?;ftAa{_B8r?=rReHb6~vRxpS@wiy8%;++vAIYz*S1A{SVcP^m)2am_pX`W{H*r
z7|U%$S+hZ{{Vj5Av$RNzb80+7qQLe2-MNs5z`msz7FnQAbn^yeRL1GM1z#Zad(KKo
zk<SRI%`9^kd~3#SgXGEVjbefH@SRPbtto*v8+uW63phU$pp)iX4QX3KHk0>I6_cNY
z663GYXYL44wx!#0r!ghmkUn<Gcn_+21gkQ^eOuU9Nlgo?d6yq$E}QM;qLU4dVLrH=
zsou|o0%@{CgD?_>=zGD<fH0!|`=>4Fr;(SnhwH&4TxgdVjqytxfcBtDsRQzo)9FLm
zzm~|a^RQ{Lr@ZYN7k`M7E{eQ@;o0pMN<n_9n^{xa$7GY0PDm16;*0BP{ZpL93OUGB
zD@qFA`>yN#e^1%14z)=pzjURIHR?)tDOmo#)N@JMPn~)H_$#jiAP!h~{D@4DW|e_g
z*(2deQ3j4h@t3DHka^nf7|Yu{(q_Xe3O1`Ph1nzqdhMN$19vYEIJylCwfy@xAJl#7
zv=g)R14Q0)T1DSJy*wV?e-laRYn#{yQ69ar$%dU2kN*=Z^LlSpcF^mTEGy%I6V(KH
zJHw`}SV}%%jMOOg>6BUScFBcaIbETKtcTX6{PaX%^>C$bWU}5qqRvda7)MCrq#MoU
z$H7brqbN*YajkbST5yduesBOIjq?`o@`$KqAEw&^BI56DMG0H0VPlmNRV~MyZ)j@W
z`&_*fPhT1H?#(u5Jt@(y^FV4t7B}jxXBNTf*B-jjJn${@nE{+!hqY+ZYAcxU!4RVb
zx-IOt4@_KL%z&h|HPj^$<ZH7S@EAbRP-81HF`kBs!6l$JTb$9vaeKQo`(6xti{{FH
z@M&?Tq<s5z!grI)PbLGxXyBSDSjxAQMX}jIeR#lcoNfGQCKf@Ak~Zs_&Gn*3ZySXc
zm+jZaAJXXeYhcGW?F3E0sFNlq{y4}1oN>wz;|2kFu0k!DHJpKz=h>@Aq!S+0cUGm6
z6eizK_NNE|I(=q!iy#6t=fp>UJcl_V-1Z_u(Kx)P+EodQZlpMBJ`ieWq(x!x2>Luj
zq&n={_YQ8$|E2wmK91~5cmM}c3b|qJ@&@zbWs%Q1ye+`d@ck}Y8)P7Y*%c(KKUTJ7
zYYoMYulh1UjUpSQ-+cSly+J>jXPmpDC)o}Te_5Z8_*Ag@x;sBU&6Y_j_F;Q}tXSLK
zpp^Dh;#}K45OyN7-d{}mn25xf1?P3nQ$q<kiJ@hhoDUUd*}zM;EfkTxvOjt1=KMag
z*INfqz*H%ZMdC2lq~f!w*Bre!xL^Yl!M%zIM^?~w3|DkT37%ZC3jmbze_N{ICG_7<
zpW*@3Y)k<=k$xR6_a*Ip^{?>Ca$;OA1*_rjeymi1bS76wc)h3HPB)b_<_87UQ|kRb
z&?riw&dxDXwpXuyVXAgh<^abByML`Di>Jz>k?>3yfZ%;7;O|r6J*xu|FaC9nm}-|9
z^#d}0*>!x#BPp45wN1M}WV$*v_uC)%DzaOT70qdnt=p~EvX}Si^UF<)Cs=BuUv++c
z1+d(3YI!P{@`)7-&NHnaT4&ViXjTdiXD7E~edW$)g=#F+`OYXiQ{@`T47(ae@vuai
zV`HPZlyB5`xmSXhYlYNicB^$j)$;O{2e)d=NB9sE%0L|ZZ+>-)Qq>(@pWlwzy|Of6
z6-&HF*7yne{NtZsTy}qp=K*3+`-;%LtCDHNRgX9h_6xJ@KJ`j$uI<s9y1AcIdZ10e
zdff4ZaT5!)%{K*U#F-gfwUcBLB(FvXKu?geN9g2@#EcOlDR{5qdqGCugv6f)IUoZ@
z>mtuoEby=0Ki?kyON!g(Z&GU*3tH&ELCr508`MLFiFr((&3l~-G$f5zjH+C-G~p5o
zpucnkqbD{%bz0!o^I%cXRE{Jl#Ax}qe!vOIV?yR9^_E=mEyx1538(8<RZ!Hu5k=$U
zLAyuXCzfU~iMqr)Ff<^d%*g4#$in$dc)t1u4x4%?w9ETOOBCu}#nS%%Jvcjmv`(7R
zH|uxplzF@Uv17?t=CH>d0R&ijEtC6_TVm2QU*#_O5Ncf6XOAoN*F<*a>$MmiSGN)@
zlV854CG6KW59AQIK5r>3g|r_GE*XM)s5Di7b&-!5yjRe1r58MmWB^fhxO1_ErKZhb
zL?aLjVv6(&0BYvJ#0V5(a#CzYOJV9l+c`ASFg#ShEXgq2<6qc+v6xb4Pvx&)BE2WL
zFYM^y=m2;y<JFi7Wxx`jolh>^s+SwH<QuDo46ovn;RcbtbeI;XS#3l6{#xF-$fM)C
zQgdvK;$3Vh%9%~lD^O9_ZlB%6_h(M<xlXqcHNGG4ZciiSyc3BRjU!LIb65*4ve+|9
zdPvLVrerqn$-fv^fzS!ug1D|ToS*{iKU^!e6D`b?!XtO0kizX<b-^R(ss0m^l4d)4
z(i(RzCRBTL{FdnPEC=y=Gap@~GR$7U9~(z}kG~Fgm`>$MiL88T_-Ol~VZ^$g3q?ko
z=z+%ZK$%mArvFt?2n<XrdA<yIF_&tPU-R=c!ynauNWfW(EKRlRfV85EgA(YbJcstL
z<tA&5GoL3;L6~x7mn}D)5tgVpJI_9QC}C|?zJ!V`K&A{hwKE(oc1u65I9?&~@$wT|
z^IbmEI@_rjelx@H2}|?ZeXAY!;-eMqRbG6d0+JE!KpSa5=%heH&ODc3evo1TN5@<Y
zxx^LJU1G0}s&I6~>1*9T5X--&|L#B;-b|WC;5RyyTNFA3F#P*4r?rk^SPMIo0spkq
zncpg6>xUK4CLdBo`}~V^H5O`w#Qwvjl<A%{!K@tJ6evg}TD|wPob7BqZl>S^<55cV
z8cNVhI4#Er?)+{JufCLGpfulJX@Mp-zkbk&3HW0$egPQ}{QqkP!x+ZDpg5Liv~3V&
zV&W2Gd-D7G54e6;PMytjGh%gqF$Ek7Iaeree`o5kZ_c=jBA?-va@o$2C{lNtOxKQ#
zCzd>bn^ns^IV#o$de30`Yp%M6bM#@PqQNU^13-^y{;WC)LiBo=!R?uYnN)T+XMfZE
zFyr^4LDpc0txskU8d$DtDUe>N7Ub=M_%#t}R)O#@Y!Ntp8Sj{WR9y#Q`gtpKQgAm^
zTZ{SFLKU$Sn?J-xvt#WOFdvRSWb#(cW=)p;T!(40P|D=3fF=U~P^r*;DAt0F@Uatf
zG)!3VSStQ!0ul$|VzKkQ$e89kI18IR0Wu3*ZEgdkMg;(AQb|9+A6iEMznOKZ;nXho
z{I{DnKAf)(q!piMhzw3P9$FN<4SKRg2d9J_vz&ZiNa3#=(?>l$#$86Y6PNKu<HjVP
zB(+pyhU_UvL3+S=>Ti+~*zdUiF3RvH9zezDlL@>@XChw^Y~2`#zVI8UTz966e9F!K
z_z{Kq=zTUrVAN-SB0V?pm<5SzsG~Z(wq#-h=7aoqwC|P#I*CSAjaEqSon=ZZ<m&RG
za8xXu6vE8StlW&3&tx_B<YW7QIJga|HIQo|*vkX3c8rBN6G?U_zR>DX6?8SLV(>5C
zHCNC;7v(@ge>e*`y2IJYSTlInWix1vRzraj$N?@60DbZ0COOy*4K_|&V@h1#_?V^l
zb9QwKeit7BKJJtsI2)hpy%iqSpOK~Wf;?^!{bhavh(D#zjlFvQG%1<H9E~A79*iab
z#|mhU>X~+`8L>TkDgS`*(BN3YV6<QXwX{hQ)!AmDbLqB0cwtzUQYFiyJ((f&MmEi|
z62@*1_9{zhjT_WPExR~09@@gY>^v&rq-oBhl1U4Zw>~DDHzdjIUhyx(UjD!z9B_Mx
zNIjJQD=F05EAbF8^x@L9UrKQzIY=eF68}HezB(-Gc3WFe6hTlyKtw<~hL9F1l~NFp
z9AW?^1<9e?qC19=l1>L{hE(a6ZbrHpX^DaF8Q*vB{hqzg+2`Be_5FdDj5y5iiF>Ve
zueI*QDisNuIkmo6fXBA~FsO_M|31Ltvg!wlZa6CkL<Y!^Rp+&@_lg;cAWE_x8ZzUY
zSy}$=-H+njLf0L#Lq((nD^re6h!3yd6u$jQ>{tF#^LI_4Ftm`{FkD{2V%qb3kqbzB
zG{jzF`|@b)eqM%g7rLoz;VjO&hSARMih=u~rVtqi&%4<Az>F<TIM`r?!H$=psq|kq
zSoaG8G&Rq)VtSts$JnQPB0u#3YNl*u@O)97!Q<1{L|kAEg8#SXL!kfSf(L@mMv8$t
zpgHmbD|=%TutvqM(~j%tI*J?>I`UGEcfS1OlGxgE>4qECWH5$?+gl^!R0RBqO29R~
zy(c1YW`nK{+(;ZTn)_fYV@AH0oYs|1merA_5PJXRWFf^gw-%$cwRP70ymr_VbYtW%
zPEoc-3KmP#zXxxBg+lomBCkkexB`B^n*0ZmtZ4{<(Qt9Mo!Nd&!;9V??nU18?{P5~
z-;+vr?oUNB$txeeQ_u#M`r69b)8FZ&|GD>0kGRT+L`wlQF@vhdRUcObu37Oi=w@6X
zfX7*ciF>+G(R25<pH>?W&i7hTqczax3vAVSK$Ay=<TiaGg<T1buq7}DyaR&CuDQC2
z%j*TJ<4eZeLZoS<Gbc@j^MYE4(oIVq8aeD?^$`IhD4W>!@BW6%&&B-aKYy2Kf?nFJ
z+S6koNMUHq<N~S&GLMch8|*N9k>5noi>kNY8<uNloBXbq{75cdda$%nCt9yC(*YXn
zKO6U|b{W=^wyJoAXS6DHI|Ng4hpcLLq+56T<?3U-K(&>Z-hR)N2N+Gv7VA?(0d&s4
z@iyo`I`!;L1LgAHYun{tPJU*^Nn%Kge7RngUfxh~`*0@5u&=oF*}9Y?k@wUG<F0_`
z79^iWx_;PZ$dX#LM*s7z0#Z=uG8-0LN~WWWOq*K3jc%Gl_uJy)U@(v1$AWWQg9SWJ
z<3=$&P}S4VK;dZsFh_q>joN^F1w<nnsm!X3TnQZ|fJ3FfAmnK;|0783EvPI|LEbh;
z-aOqOI5-E&Zjxsb>RmbmhK9_Lw?(}vu@^(XZF;qC(AAig!*7aMUgM1M=*^}@s84wO
zV7~Z1tmP|Hj`jHUvcS;wcZ*7E`8?QcO61FxB8jhrVATBY*3S393t*b2sAYqk0|8_M
z0d7+|h>(DI4Zf~=zWMFfnc|;oRII1yYRvQ>=I9(3{YBl>w?{)+AwezkG1q6a@Y4F0
zCGJda-gZ+t*8_`$2IJuN-}EjHeWP$8_y@0pMH~9znn9l(I-w^M=OBrwzqQ6Dun6{-
zDt5$iumTAWlbwq5xEkwU4l{qRijJ^2DI8()=uk^LGeEhYhm2UYqUgP^JEV3e(nPC&
z>)Y@2%cr}Rhf~OSwMIs6qWjrV!hJ7X<P|vL2bJQsUx-Y8r^tc<W*I<$&v8m}^S95@
z*!(twtxIlza--?Yu)&$&tJi&_rD2lvk;xF*wP*E4LtG-$bzbDv6{j+z<tu~aGmX&^
zkT{jt9g{2I%H^7r{HEgmO=mYy8BG2#VxD~m)C_TgCT|}f>gso(L}sarLb@o0ClS&O
zL;XY6g}G;-Sjo6aey^FPs3B>_lgb-=ex{L?Q2W6<er+%u_p6?-fky}Ooo%M*d9&vY
zVW1cKGH+dcua*2l)gq5>@R!fbc(e*|l-9Gq)dJk$ed{YQt6Jfx+WY~Otbz5xd;uMW
zAr(`McAx{+OaRm$N_UZK<0;{4Y<Zb*1ok?R#yX&oxOWcCm2iCHLGgQt1{oJ1#o4!&
zx41+k;m@y*3t}IP4k0Jb0XvW5nM;z`jDedg#}fU!ujk+N(L;P8o1}lwXUU!&#HHb|
z2q(^Pu=uOP1o<?v4!_>ZSmyQzFWpNP9M@eJ7ETgc7K$2*z7_f0)+(IlF;Jnq{{Df_
zK&73<_e#gsr}5!Ge)7%sCXagu4fZi4?BjY)uBXoqT$6II{u~N=pf$8rOgi^N(#6tl
z;BH0TyXjh|OL*tW`8>X^UNHk{P~W&v9lY+}3jiSR_X4bjl1<i}54$}XOoS+4vgn8P
zL45sya-&r5u^EID+F9M3X1b^VfS8Zj`HH6}ypw)34EKMje<v;f4H935ZC&^WEq>I{
zaAoRiB7MEXVo(}XC9WG`f}E^!(|e7`LR(QTpkjOJxj%GI(EM3J`R#oP4A=FF5{yB*
z{2HYew4eyUHRP($41Y`FXpF@8F5Os3zkp<ypr>t0`6G=pIq!S(+6U&cm9cWsD77Ub
z2e9McI$H`~n*m6QjQd?evHzpPZ>Y1c(nGOW8`^+(^ByzZ*`W&Qmibx=D5`88@wo=F
z@@5V@I5(W%m^{kZm*fCsTK6_a(2RrV!A{mYnY``<dr?<EDk%CvIDO|VK)W(1+MSgt
zPOb&bv24Vf^T40Ir(?%v%SH?pCn$`l1wmXKa4e(IRz1_8H>{MxWz&25HoA}>>Medo
zGwyi#(!;P@nw>_cyZ8F2ny3F-E`8)w@Eo+LI<yz9iP*f@DhW+bzz)3<k(u-GSW`tK
zhV?H7m*^~X+-OWsV0xgmiTFbg#yZ*IpneXFGY(jOK`!~3=9Z@h3BB+pM;DN%3FMh5
z!5_y}#2A1F0HNAjh>w1C0AOB?(VN!k%%i{Q@r`hPu3C#Jg%{EbjR5!YGuV3M^7t_m
zlP7<3`2*Zm5O3oJ9jH6%4RuaG>u7_R@PD;{+~=X<m;aG!IK}WvyZl`A$0VVQmWKvR
z9as_|7exN(3GLX3Rus(RjW~0wSt_}}Sn{A{_-*XR#l~?8K3hvJ1IVu^M*WyC6z0D?
z4pUzNIj!)8f{Gxkq`Wz%t%2T#-@1If|IPj<d_|zWMZ@C*@J1^vLbY@M;MraCw@&J6
zTq5p?U)eEJCUYM2U~znz{`zjO_)ezGB51-bHtxJ15^(E%s?U8ktC~I1N8f+k1Q|+o
z+=Bzh<d3uUZwy2!uFU>#S<ll;1NJ}}g4G`Iqpt0+7ZyO#>ly*J=STNeH>ZPa=qgR+
zru;jzQ=|NGHG`Go9=%#hT2H2C`kFG^w_8sb+M*}q`-;J{%MzcZ7L)npg@d^gM8OKO
zU!jIglN@}%a+OV=u@W~@2(9ki)_Nd@OJuzQ#H0bF)8}0_h9jK5H@Rgv^p)M*k!JB@
zUrwRBMqM`&yI0RpCscl<t0WypPv{3n>kS%NT^W45VGZsS9?mx3R-#+GibO28Ss3Tk
zf6givwb5(foSyfO&&+`e#J^R)*#8m4_Lf2oXiBXZ@PS@Ctm!f-&h!gFLGw_x6_VLO
zb_EYtQXeow-i?*Mc*#W;6ix;uejljU2<no0$-Ga0pXDg3D}n5tS?aK=JM;2oXv|T~
zpK22eU;b$51WKy7qPBba;%_Lv8{o2EAHdFxbZnzPMuk$D$7>(Vsqo!%7o2vl$(<s&
z-1L-MO4sD`v%tH0?>d5=)~Bhw@fgwv<A*`Ywie{VK&{yS?8#aGj-tU-&lin;BuDgZ
zmvP7**agH=;=0?o{}fX3aPTY#f@<$CU629b7V1u~6-mly>U_-=r%j^9%KZgg<Yt)S
zHHNy;GwN0FNWYGk452?JL@pMLV8|laxmoawYLg6;q6DBZa)=EbybYYtKoJKHw+m-F
z)@*Ocfw45-%VfngkOq3yRwKCl#mUw&uXZW?va|I>0J;2CqVL-vP*L5-D&%Sv@Z1uy
z4jh?gztVZhZ=0=qJZeT^_*RzQ@5B`diT($D8y7P>Q&1m_>(+I1P+=!9%VP!>{?>nE
z;nxr-qsv#9fBZv-Odo?C-%DH`HO@VEHTK<yDgTSka+P69kpkwVn(lx)i}|Jaot;yX
zWGf@*ooD*Akdvk6T_6x7tNGH64D#`JZfd~<=Zb&w+uw#%g=K*}_?j#7gc+1rylN59
z#{12kjRlF>N`cJUz<5A1So^f<oqeDzL+`bFeYlWsk0W!&0u&n>RT%|wgPxhX-Ya8)
zGeHcXF+v@bGHZca`k&K(+S^&Jay1LkF@0MW&B093D#fEO=YeJzt=O@<cswghoUuT)
z*H@=5P^-BtlviFD3gomDuq^ub_XC<fO}IpYa({rLChUloe|>=8vI*kt;KH!UMtf~(
z;Mh+~li$q4pQOVG8PcRPmL!}`f?o`lE_2yxysUlh0<N2nAZhG}J?51wC=9DOE+l|4
ze7|;={kmdo;%Q_jmjF|NOZy=)Rb+%Xxh(}J`_rp*qM_Xrq=Yvg;!2C}GH_h^q~}>!
zH5oXJQ<;%E*)3@6NSo#}6wC`Qi?IXR2lZE??!wwv{eG?$zCOhn%8_`Sw~M<0+swd3
zq})*2Z&t^dxV%W9KZS}Ea&rb9iZR@J!|SXF<%JnhqH8d>!-Y8e<Nb{*$`qiY62wGX
zx8=FTUsM^9H5Ld!#kb8$)eB$8vHxI)rJb@5I!e|h#ohXBq_~RaJq`W2ycJ*iJqADD
z*_s<vdHP`fChun&c<-zq#iY7|jZ#5@%cVGNx1O!|yVqa*_XWkB3^pCmB9ZyBgf}Js
zwE;FyT$6V{7?f;igX8?u<ntqd0pL>%dITSsg4alH*j+$+x-8bR6UaS(Er;T7zH9OH
zW<Jzyo108N{IMP5T`p>MGaf3%e>5<J@AiWLI_tDw<RvASez*a4PWEEYXyn)BkpiXc
z1Q8(b*Vyh?_}YdDfYRn<jlbqZh4EJP-l)s$J>+y%;3ER!*>?&QeHE%qpyg2#zW8he
z%Bdd#1dr3K9~0{OY+sfmx#FkNQ+TYON1?7#^(ggNL&5%Q)ZS?6**!2Np5w<Zm@S;{
zwI=uLW6N>Ahh5h3@p7Lrb9gG`he)VCO?Daxlq?rMi-DF3o|5VlfLy=DiL@Tr3yUk_
zig|H08=eHyZcDW5qs5JfG-CGh!1ff2Iy48yg;oBcH3|CZ32zmmYpKpZiniPIH*9*b
zoTj0xa6tj#s#nv9MJrq)_3`hWxH#9JdKN&(qqr0zGuAJgbzpx3C>9@dp;G%Q^e%*@
zp3wd2n!0X|i6^80lFISkSOiXv5wLP^qS>y;+#~ueJGb7wI^3N5<{^GnF13##is-EB
z9-bYLHFwdgDgkQ$IQ8uqzcQiR+S&N`ckp0?VH-7JA4?5yu+u~Wxl~aWR9an<vdLeF
z4*{T0l=6FvwH_$H!KrD*;6rpZP7lK;JCLTJ2KL6)B0tFVaK>A#)2FKp+{$y^5@vuF
z^uJ2~V)(@N`psCAP5<=fcRU{UI2k6OKk-IM?`p0);UXc-z6tFXJdzGVkw&P-igd%3
zQ(@itpQp88UAc*t@u1Fhl5aPqGk&hI3`n0C*;2HaJFNoA<lebm6{#0fNPWg&UpegR
zP{b|Co3aKz`jPXXB{+qj)FL=8z-^NVTKGmDbc^);**{S)wiC@R^+bnD5a+Z-w~)3>
z*m4X6EvlipI;u0*<9E|`9kiaj2K`fkx+%uEoPkk$iYpR7)@}jQ07k^g*L9WRgz$D2
zyI-Q~>&6_yik4t+#auR@gWI{>pGDj{;_%IKe}1OX|DMC*mDQ1=t4C3<K)Um@NjsTF
z?z6Aw>%3-x$Wb&UAOep*yrZdg@RU%%Q;g39iu?^{=QyG%8HMeEko4|K9~qytd$8Y*
zdng2I`_b!wfl<%TuiyW<<xEfp$gA|N$^EP@d@V`z5@@wn!wKsATAy$9=+AzUK5=LK
ztS&#l<)$|Lb19hWdaO7l&|jqx{!;_9pQUb7%Jp>&YUi%w$%RsOpt^B-vPJ~d{^O5b
zWJxvyA7aJK*zw#>zschChZYK+>hArm;ho9wG~~70qwS|MEy^8sfib5w>GKys!ESo&
z(kQ@*B<&Kml!9|2We1a^{pWw-X8q94`z@tVtf9S+NqmVYW`DVBX?IUQlRgGr?z1hS
zp#EQ6u%%)W<UVKc4i>vE_6%;-c7D2u{C++U2tp7BD+m$uTiL0+zp`Ao{FM^nnRanc
zgTKHt!RRJmp>1sWPM(z_5Gn$f`9cba;Qx>hHqAVraS{1)hWAhb-4sjRV0c12*PzSw
zG_Pr#ZSU0&sk3&T)5%&3eN|E=XP`b+sAknlWTNrlRTckEA_YG3`_ETHWLwx{({qrO
z8ofvHP(#n_4&<|{in9|sm79~Yv%4!dg^bNE%1>U$#h8!2P~5t(L2i6x3e*|NzTp&;
zxRS1iU$yM;iMDQx_4-vJ9dJmDzw!;}ejE$_D0vRQANfCO#3?7;djnrc+3hfPH8T+`
zLnr>|NVKgF1mgw(>0@9JX8;;H6#ZMb8bQ4^Od4wN6|f)CD5I(P<a6?WX_R9x^AAsc
z7_Idt-A4iRR24s$6A!xK-MxA1cl39Lo=$Allh_D9D=O;0BV#in1Z!*#4Q52hJi7dZ
zk>nOj_lKT5_2gBJ9JhN}{dQ#C@6z!|0&XbCa%v!Fwo!`#k0NOrT6M8K#bU{I2kscG
zchP|d2J3m|P}JjIG~zB{_-aYJw{F-nC2eA`8Wq&l-c4DaYj$)G0kK(pbzg21#>XNn
zM(8U4MG3WyeRID5#m{SXOtP1wS?1uG+Z1vBv?tqfhOw*?;inQK<vQxr<K@9O#I~9~
zZxC;~Ubc>Z312v-Cw-jQBfT4TW6$My+gDU=;lt0uM`y|3!E|kE(W>AZ5Xuxyx<r*z
z46&C+#?f(wK{AbOGLV2nL3hI=A!ezN`5<bxAtIDfPf+Z&pTXzg&Ai*wt+Ghh-qBvd
ziAvkJf};BSK7?%)QUx>KR`VV7o6<@VbdiwDYPs6}2_3<hby%R&@Pz}395E<S%DW=U
zlKvV&7cQ+Ek>6zn_j*?!7fV`PeZQf&VP`RA|JllWN1sH{-1Vwzu!S<uM@LTRWY>rz
z<sInLCw-*&)7S0PkyaCRdYc==()CCCdZ<b*rGyVc4;1`wtEk>3c4AZP?DF1j2}@Qh
zf8>@R;HjM!H&Jk`NoQF7RIVpJ(g&(IAhy;vRXNEOI^eNlL#~8;uW)d@Iub)2P8!jl
zbLti&|4=KfhPpss&wx^#k85>d-=7rANqwGmnf7fQqUKpjd=yLRq7($B!ZkF-1nrW9
zwowQu=TpF&lPI_ueo*1f2N}-Sg$DyY@#56$5fJbG14&^x0csY@Mf~_Z&s@0ofQkfH
z{iRHH9@6s(^Nd~RoEKz}?9~1B6LvZ!R-by9`|Y{2^YRtn>y^=d3^!G+dG7A?io-(x
z1Fge_kfZ%TUAwhuF?pX(Z3!2&jx?NYH(KCKw?#0<W=RI=8d=o-JQBhh^YT2N?d2*C
z=%Q4mnxRP%ozsXygR?c0!pysd6UG(emX0pd&V?8?wswJN)^;Z-)@|~k!6GsAQ|vJI
z(z1`nM!#-()F$@_K(%<xFJ78hmQoQ!@te;mSPY%AL!3rBzDTNS(;mrIn}#5$OXJpj
z{0j~4KcUaLxuUZ>NZgNHdxpg%qry!)C0wSsRubkSA*51jZ4?gA!IxIq``3mSz`{fx
zNb<m&JzBiw9w2``K_8E{QOpM&lycnxtA@w%UcT`G()EJyovHhgkhIpKCjJv5=&5>2
zlF*|LeYp4O+NxyqR`gP5gsQ-HZ=KW`#{5b01abr|dAgO8x=^k(5soU7;ZBl}6kUt=
ze%d<s$Ku@k$KtR+V{X$4WBI5*i0NPbwYC1Wzi>18`X$4k$qCZ_ZCIzxdz;DPD774S
zC+hFTbudk2Qmk-d1?Djr#JEi-zRgE1KFeM(hI*H^fbG-qtrxIuxn?oE?5gGV^O4Jg
z3a=k@)KdIP%D;Tr9*5V9wo&-gbIb>c-UVL}-A7+|@!KdG+C1o~P_q)oQcQQCCz%*8
zt9c@L^RW(P1YsNE^^I>CFYZ9a@o6G#lomQ>8XH!K*IQK#uI;oDM?>-jShQog3=60R
zr_X*21Yo5`(^IZ=u5$T^?S#a)yx@e^c8QFCiG=hKZaEOTs(j%_!Iwu2vqna5Cv5HZ
zG396}CvXWB7|;m43EZK2EZ1{yil@N%QoGghcYBO@=_Z9LcBEm!jKiQ%`?Qx_6PY_#
z{fMQN7{c25NkrZ}>$EOr_<+4&-J90r0cK7oFBR+gGs5IbJi9ubUOMLRgQ(L-Ny@_K
zurPw)`w~v){~de)&{*-Hr$N1iZF$EMFyq5n?)d(Ed9#fo{L95mJ$00t-4;jejDIx5
z&5QQembuQ}$y&)e%BjR{ttP#vAKF?A)2vS#tV&B4tgoy%S?ed>Yi=x-%!W71)z82m
zAe(gcr{BHyxG)(7Irceva^LJ~WY#Og{&#u@O>@3<Tbg$BY4YB_(U6%EB@I-`*%y`V
z?~T&)c?<G72?}9{!O*qNl_7FvWUfA6zJ73p&Jh|iz-rQgJ($XNIl2QiI-a}(?Lsj?
zyL9@<@V&2tV=Oy;T-8Q_p+2U@L(Q^zVT_re5s>NLlGid1kQXwq(UF`-&0ZgU?f8ll
ziqAh;<qx)Mmh?shX;}L~7~6S%PCvXiKgjJAk?Ru;hPtNvaa1DK{ZCpMp-Iz;QMvGi
z8n5Floy61a6GeHQW=80^lxtB4eIyTyBBhjB)Q0E5d5ix0>Vw742{6Rc$fkWa8DzYJ
zG%~(4o#ny_<7?PfaP5J8BxG7(UjQH8ta3EnDu=uStxYw>3w#Z`{Fp)f)<t+T(`URD
zN)%bdBUiyI^Fi{@SA<tCgU3`n>G+v;7;5X0-f$R9pzF>8tv{Q2U4{{c#d7Htgr8TB
z8#RRYxgGXJLW&VrfUzL??+wPk-|=~c2ShV{cOxKlZ?Yyb*<Qo=c<mz=IwF}GI;-TD
zR%)~c?Vk^@?Z>em3`w$z&Ih@DlGbDVf82xMzdW*I;x2%sMHbQ$n9kX_u*Hz~$NEM{
zouUJE?9h`SDqcVEL2O530el7gzd#rx6km-n-0ux+i;!!IRRXVaz9U?UKE{SgzT+*T
zK(JJM6ZQl_yy0`Q^3hS5hQoo1)|8?%8Indd?t|@?v_M<O7iyynkVU!=7rSpVQYE?U
z+dIT1LyEnUA|Z>D;DZ;wyo}dC2w;Q};{^jK8iEZ0+Z|nhP#g&X=h0l}0pp#2d<Lrr
z)w2IMj@s2q?)WzC2<e7X&bpSxwve1SOS4zzPvdAfwL&^<XHN*CA_bHyJH4w)O~gm<
zuZp>mknKG>ej8<sU0s3C?e*z|rq({_KcX`g@_cT-k~pn<deFec51-_szU!DTNxGir
zmXWp3tx0Se0OL#1Z590gbt<b^pr^m)u2TOA;sS}HjscT~OJM;gMs93njWP%bC*~^?
zee_qRuo5*fr4K?uJ^7zqKnJMdhw>HP-i9&`Bx?NhtB2`HfFp-ai7N~{Uw8Y+WjjWK
zR)1xnNcq&g{ZYdsHpfXkCkJx(lPh%i?F#2mQH2PKhe&2yYfZB@#5|H0*!HMN0deLU
z*ZH8Mt1IDBlT5)&QVfZPhHN#{V@MAqd@58eW0)3hj%|VOi!M<Y!vxK%O-vp6EfYsx
z_6g8r8X+vhrUT`Ls}gLdKl&VPy)N{zD6g%uM6Hij$V#5At8;kiQs-%5Df7IRB;bl0
z)oR<BYGLpz*6Zf=6BSl5ta~;gZtJVEIYRpa=(mBVr^lG;Y)G6Ghpmmb(AkdtkkE)i
zInApl?^r+0Pww!<d_TKsM?{R8jnOtLmq#*d)!nqVBLs`7A-9vN$6;M^adrNv(v}T7
zULN}Ez<F8KC@1Fr6P(G=MAr7-R8H@pK>SGZh3wICtWu9wCSO@6_tk7uHL~>Y0473l
zr~?Yjm}_;@<TVr-&HZ@=t4UX4d;@Y|&6P$QP9q_w#g*5oQAY1deE1^3;XE@-U1%%r
zKuBNmiJg3sVY+WjzOa<)&E+_#KxSeVj&MH^Mli|-`*p8_GNbLb+&58T_L&*$$vm|M
zJ;wT;E&_%^q%4*O`Uh{X&_uAF9WG-(yBWG^vQXc(dYemds7)ueqr{Awb@n>&s)V+X
zcE{vU_FU1cP-9DFv=%#vxg?hTB#?~7m;=MN<JK>o(=;g0SmzjGRmH#*=|?x99SPxk
zF~>p}kO()O*qnmfR?=+`RiYJeUgUd8FPSINcD-j_pt8Sfoy~TAltU8|6DQi}-|l9f
zYzjlj#6oPX(cCUVs|<$Td!Nc)s>!p4uVsYq5gp_PuO>>4stDUma||K5d5KeQvM!xr
zxeiyB-tpV^S&sSq$jP1bKHl&tG24)H!-mpUZ!~V)YDX<4<(-|m`J5#R=DGmi-Pvf+
z`{}LE4$be?;FaK5x_Gto*aN&Kt90&@3xfs9u^0P<!Je!i$<j!GlS*bC#@yX&90{>x
zaCda3Pmp?*zxa_du&BU0IHn;#D)(w{3(2cJk^LR-;es<li^=p)H#pQXpV>&!jq+mq
z$J;+Fr8qYY#lq~x3|X{N^eP@>2HVNisSGrfEvKF1lC-izJb#_?=p4*)j-541c1vTq
z%vWKkbkE(=PGbBJS!5N$widpS<j@<(Q5xG}3e~uqLgl@fDAHzo;LWX5cfVs?sCPd6
zcu@}%QvlJVU?DR!Y|xsXJkdSv)h*xPwD9t8Dw7UOhP0?NG0-qV$x5uQ+&^~#j59{l
z-@8M5@oFT++HgDibel?tpGTh4(B5s7E3V<BL~zAT<J8%DSi{eGgRxmz&~Q@41jJKU
zFJ&q%F_f&2Il+g~r;MFci;oenzLn}8b#?ZCJXF<^xG#c;d{=XilEHfl1s|hTx%fO=
z-~!=;bNJVu0dvtVb`|`gr-z`1v!K?3VPN?Wu3T;J$%CmH{Yc26dR*kMw_?DlQOKy%
z2*$=!AluKf7JtqdE{tUno6di{!c92H=++a1dJ+EfXjh6}A$(tHVJdlIK3mtxq-%am
zt$KGQW$??&Yz@^R=SswMp06bS(?E{$&&YZ8Vk4iF%cp1+so2PO0=xDvR#9`vV`h(a
zjaJy(h$0IHsl#9AC5mF=)nO&_Dv{L(g7%J9vFJliH-6*oo9)!ohB;m<3k#;-1LPN0
zJ4P0k(!z*6ycg7{C8}IbZ{NJ{{6SK#cjX<-UV*E4oC!)+U=SjF54X&#2d@)4V-<7K
z8Xezm&<MrMOjRr7MYUq?oy;cMX70V_(rMUJs;e=z@6kq~6e#4Mlj$JYwFJy~<DB)w
zOI8Of(n9F^H5HN_#S3~H!06|)&L}6E>A@PkSnit;AzOHhLh}RUy$=S0e&;USiHHG<
z{6t49`39WD?NtH4H12o<dxn@#nPC_cML;|nPSxC<+#U$qxIR&gR*g1W71JV;B*>D9
zj@@7u5X<>K7hX}nl`mM}Q@WY%biCPLdS)lO)nxR?s!kkkqR;9~_SV@8QoR(GL@Z~?
z;Rjyb3-8I5@A05}&yE8#U2HfMTG+?#nl28w`$t5#Vmy^vb?qvj9!$T>@`{_j9v%%T
zv~AeY{Ki#h>@Zg06dfb6!_}TZK5>QlZ?yp8^7+$tjyC?11XA>s!+E@otx}Y6;&a+}
z2gYLWZA3r<)gf}XxbSTNsOsbjs-6{I==>5!oAq=>eTV$4cPUkIe3`H02n_Wl7ZbK&
zZme;Mj%rTU&rWHB%P!DzDh*0OzVc`K$a6Rxr4~w_&O5A(zX~bz#6@W_Bg+g^M%Au#
zD6+y{x{NnqMSolZ;VJ##Mw1M3bY>lT0~f1qG|2)daJ{SSoQypu)Ib~cl+I@0S$OS&
zv_3P_t9d>#o=56xj0~mndUeN-xCNJb^i`Mpv^uGJ5h2J=dj%jJ8*>z@>nhg*4(i0A
zjr*SI%3$>yNz$ha2|`wHlRP_8iAmD}3kZJcpu*b%9@g#BLuS4gdt~Q`iB9&6WJYlI
zvh2{uol1x;FP7UBv5gsLcNliiNeE1}&$)OFMH+shK_mTP4KEz1?-@l=8v9D1J@<U4
zzm~bp9R;L@KRzsVXl`Ez^PbxfO$F3Uq!;lj7lJxghbk*pf;WbeIagH=0FE~99r?I;
z?M4>5Z3vB3p1nRDbAoC{Ocrt-E)gt=U5r|W%d*s-mRlbgc{t?+xerQkI@#11oMAj_
zr25rN(FgK6`iA9T=BKD)hyH95!kr#9>l(C$f8ox#H<?VYVNa@~7TMmzo=lJDcL7My
zHw2L!3(DN}v9t1ghiwDxaGYarmzT`JU8jA1FO|oc^5wLApL1;bU4ClU39#&5uIn=3
ze$?v;SL%wZOuW(Ej$28}t|1e)pz)!Bl{XjRV+#veMu@d6<AZv&TGz|b8csA)J3_Sc
z$2HTDn;VH8^7QLrRWu!$Qs6MkFYc{Rs$DJj8j;iu@U3~Z{5|a*f0@r!?$|+c4DF+J
z7+(TI;Lt@>l=hxc*;j@izA#n83!}9=v@4>{g|&y%$j|M=c?SA&IR_EJy<)tqciQhj
zZxkr$f!|cu+A(ZBqcc=jR~<srC(VOm7uF)W3uno;Xi>cO`rL)6pmT7Rybiag{NR#)
z`qXg+xJG-p;}zxM=WhZCiuGfgqD&_%WcY>SB~xfyQ!8b=6i>Y%W5IW(1|qRrT)X_o
zL5QO0q`aM7{2FL@bhAt44%Qo8d88ak!Yjo)qE(QFNjqFa_v~|OP8FpdeqhcHJ5Ljf
z;0a#p{@yL-xCWVWCvo(=t!=>7utS1?bki-fdtD5_3~3zP%=+q8)3(jBv-=YS#^zmo
zB{O~*ad+5u-oc(Mu0|!sU8s$KxXob?zcaY)Blb#MyLYx*dT8A%gU0LN##yiCPsKJP
zXgCeHn}eIZ%PhbXdTL#|+8%^hGo6WAGM!ue^GDV9US;aciOsiILV;R#ajBYp1jN8Q
zYMBQA+Uo~K*B&65<&ur4S>P;`mVrB@a29(@iq6M4RMTEmdQ=a13eS@nx|Q*Yz!Q&y
z8num<5BxT(;v5cgV*zgd_3GHgab5N#=OgMv%zFc~qA*p3-rKCe&r_mj$>tG;x@fbH
zsihfF<T<!7p^6tbe5WUjh|s^!Q$Fo2eL73#)!F@*#F*?unO95Z^?fbb-u2Gi0=oA&
z`hfg`ke7VBs87R}`JqP>zmhREVwF#hDP4lA3v&9)McS$?cIIu(ll7LhrCfdD9KCXj
zr;9Uq>QnD}rNLZPMdeZcixVsTd12F8_D0vM*2CDyUwsLo#Fr%dsfPR&AIp|zNG&PY
zfSyQM#yklzS-CNj%!OdSO8DT;7zkXVKBfCCf}Qy9ZctFQcHNV@jJOf`8Wl!fnPmdB
zFZUf=pI4>z8IQP;hH9IJ+d$vc;_%w0D)G<reo7IYMYZ>{Z;9%7x`?5_>x)nEUwpDu
zcDj9xY3TGno8~Ui;);b1BV+V2R&o6~i0kFSIhztnyI3X`6;29u<SL8QPN?uQrXDMI
zlv5cOm*S%(LJLfypw)0oUot;|F<2TEDY}St?<tunrp%NStiNI+C|ulVQWbNSGe3wt
zEDa-ye0f0SYa9p*6z+^#S^~Erk0rrX<s68KZ-TEs$y9J-tjHc9M>DNODB;aKwiA63
zkcz;GP=DY`j3(Pl$~iDX2N_*kwGNj1D4m<2FDy=eVqK2<H=!eS&z389q<KqwJq$NM
z$Ke{O=<(#vJn);NDuo+Z^@Oe4Fa}u9!OR4;h3bs-*7iA*t*H%9>F|(S6871Xuw!L6
zlld<v1pD8%tG4qMbXoPCy33XOyKL9Mp}1IU@|C=w_fxV>w)3OV1VKf^b-G^i_nt$f
zSqA#L?I{P&tDWmZ=2;d6`-fuiQ%rQYNe5Ho4nfE`LJ0nC4&KKSC#p<~n!Ty>tsY?G
zXg{AFJ=o%|G(eZ?{K=MFd;MAoaA1jL8!eBJqYKtzx8Tjf_BC6$h@eKGr}d@syh85n
z09j<Npfm<SSocF8`*dS;S;8)6x>z+`rrncs)o4&3V-uJ3B4K+R!n-O3CGIz-OXj9J
znIn_mP2#GrNyem$4zNHnqUnmp`+iP`S(hA*<?KosLa~(G!GjA+VwDXXi3VOem_^la
z?u2>g`bZ*myOEC1_5)cj1}@PKm3(gT9u{#FUww>9n!)aEIY*`dL-#mbatuB^<`d3w
z@ZFPbuZkmE()BX#YL@{1Cmwp^KiJ(Jb>zwZ#0%^OmI_)FVOxLtsQREM_LdNa(1R=H
zsKqDM#(FoIYgM(?QX)z60rBO5*52lW_Bp?f_kHhnpAC_cIPv=5Uo1R}*n+zq2DQ#(
z4}GNif_Hkk^)e?~-RT2U59RXPi6L?Ajn=nTS#36SRlNvU44uT|t5sNCX4$=R6kdeq
zTjXpesO|YBW@#7CW~={-cWy((f8HVk-q$>i5h0KR^wFa~D5N{*@Djmm!WI*uzOdrX
z31`9iAnRG@IR?OSIh!Yi_npK*iZf}e*^4$=+7s@pVAk(?oxnV=A|RHvePN)Z12Yme
zRFGki2~|NqG@gI6KSewBWY)ZX#xi}AhI+EHfXfT++~wxGHi7XR;wh-Cw26A?ML*p7
zHcx(|t@?2IKD@YEefj4Lx8rW5?cvzaL$PR^`aR`3<28CJL(BW2I};4h+e~u=08$8W
z=Pft{#%JyezGM|~KD#goi>&%9Xoyipag`e{+bAZQHd>@{zE96R`V5v2FwmUFyGzTH
zD1sarG?PThA&XQy<3FYbV+a<4+6gvSZ<g^~73wG65}Af4N)m1C^7}jq@N6X620nYH
zS8&Z<53N&gTNAZP2g|~#X_9)TpZ72{RB?)AutxFK;Yq2=-rWgDg}91j4}}DQ4myGL
zw_?$g_ZGv9zrqq8IpX6HGUEa7%<Vd$bPE5ZbO;}OVFj-#jXN7NK-ae`XaT8~ST*H}
zW6Gzfmy8A3;0t?uud<xxCiY$$qZ}6cJ3BkyuMjVM3+`x6+5*D5rZ3OvN=#1Ys>6$;
zmmb$$R0=(IDEYPNT%YEG%&jqE?bha6ICU~@D)#SS9&mXiwkv?P3+x8Iirkg;m6vo0
zl%u_#2beR15_jjW2KgKh%-8;UMOzNFvX^O%P%+m(;4XVLRce$^ssD)7-cjbJ81$+6
z#SP#YX#mQRuSgh|8TlhSat@Dhl=(HR_{oF~*L;xvbVUXO)QY^4<|^QSi^b+VLl$K~
za;HS~!(feSc*ToS;eMZGR}P)+%zz9i`iBZ;6jot9#SD!pVxM!MYCEJdxb4u=Z~}kq
zXPy;IMzOl3hOA1qUH07?vPE)>sxNj}<fLAY^c^qeud=1msW(Znsa#GVIXa~nXbrTo
z6GMM%`8D?jivzksw@nM|oIJfDV>za_RWLbs<D^T(Q9f)ukl%aUQ}m#gm?`WKtB-jM
zBog-OxQg54=M@Gy9-haYG#oh^9QGfaG|@;1y-$^Vb%izK*)$dz-|^-pCRcF-@qk?|
zGZ*;Fd8!!lVh(6}Xx--$S$Fd_nj(eLBayX{r-u|>BZ`2@sQ2Ac<$p-)u;1QF-^5Iw
z?xm5`Mo|ge9rHikoygf{MVZ?riQ6H@U(>ruy-D#1Gl_6#E9*ZyTc&6i50+0LvZ<P3
zIsDUKldXF%w)^taTjCyIMu*Yk(B2Ivnl=EM3o+`7@|mi3OO1nLotcZ)F4W|Xf1I@7
zLkfr?o2dFyyXaDiZIW$Xv`U{#7YtaO%aOJ(-d&-%mMz~&%?4ova4T48L;Wt(LH8_I
z+C`m`5t=@mjR&xZ5r;*-{|Od>B`NPTS^xf2)x|8gb)Nt5`?1gwDIElqNA>m!#|C%*
z&54ne<B0A2o{TdXwz)Ue(oH(Lau%vrD`g73Yg_XV6KuaW5p8$TNywt7<`(D7>(k)P
zyQ8&l#h{D4hHQueEfKkI#m`%EUlM{vzJ^<5K)L=W7g&~L#~0B#KO;=C7oaCOD9c|W
z=U4YyPyc7~SjHzD3-~*xOs;u^u8BJEY{2NP?Abxaes1p^h5LmiXJg=(u?y@sy6JsR
z7#z%=M!h)Sze|svs6t%1&8Mo6qR|om@wXSPIhUHn<3K;y8DRMJS75B|*Yw=O?*$GJ
zH`5JHRrtyl0fcsn-dN2<YK?}ISP7$Y8R46ac@J_Z@m)mY06p{Mfb(KtkIP^Ek;4Kc
z$mb{Ewdjf|ZD6x&t>vYWqpUU}bbw|ua%nld*_{VFJnHN%zvec#2i=X-%3$q|;T)l@
zo0r^GWqi?o(wgPdOL`PeOn#ogG_d-D=luKDy|9>XDcp&|k1;%-WH%O{1@A<gamCWu
zR1aO3$O*>SEEZh6RUMCfuii5+3XE39!RH&EkBkdETgC6|Sxy=7rfrkZS}hm9R457U
z)xQI}HH$Mm(}ng+>lNrs|BUmmmV&sbKWpjr=k2ZUUsFy0WWj9cm9!{h#o#RCAwQOY
zHRl9=Sv-{XKd|NwoKPZ#XkuPYHmqOB09Dx%R?Xqp&!UpqyhDC*h`ym#5%W_(_V{k9
zjUIPHai}xh{gIAE@#re8PnSMV!`W$#m8)B5$jwp3)1AKK>Zy0M1I(W=5ub@iW+Ltb
zqEigbBp=q+HM!-ksxJ|wbO8Ji`MTq<_Jsz(mP#Kv^)9J3s1mo|5`L&Gxu79m+Klm(
zzErap3eD2NW-zY&g;fgM4jdi@|4Q)j)~iJ2mHr9`6<mN}?1$XkNf2ZeGc3$?ySuX0
z443tNm7e9=)f)*3v+KKwf9>&g;Ir*K`j7m$g`iuOUu`D~q|{yfb7{FinNw^i&2UGU
zwVtDvWvlE`nRkD+zRPcml2DIbq~ZVU!Zx-u-E-oi;j>Vb&%D}rb3E1Z86W^w1YUO8
z6A!cAOy;Tgh%A~Fv1vM&fE{f*VSqf*+^MLUAMDREUD_8h9Vp;^#g~=xQp}xkf%d)U
zPRr7s={{!|;J>I3CQD?a5PcjC-m3x;BB?_+T^eenh3k(>*3Vv~%Bdff@$<i&X9nR@
z#%K9i-vT~(^SrtW4Z!&!oJRrqPjDV2=mzbEzWHos_VFKV$?s4_5@)AThI;I_$F_9S
z6G61Lr&Z<ULT^p#4cAribCHxko=Wd-1m@K*R=8Nam<v23hPUB%ly9knX~(ab!{Bw_
z1&3G3M^OpM87@^#+ZR|2h4v={nOMwSeUjxWLmu{vZY-a<>|B0SuK>y@uoTn+Wkt26
z*zSN8eZYsWh?vyE^z-tKi_`DRA*)0^mWjcJQsOpL0i@9WuO0K^4hkWY@_@q3w%J3K
zw#AW=cBD(i+S5VO*jweB5n^j1v8BDDz4yeNl17J>iaJUase;D4)5FfGlVzO@A@=NF
zIIRlBl=ezUWy>ztK5VM~wJBSl-;0a3w4_R93}AJSoa^f}gE`BCv($!YG9S)qxsNDR
z(MqvCe;0$9x0g2kw*1h2bR|K0FPYg!>R|`;a+wI)RS9F#p4iKY_R)7kz>bQD)DBWu
zt9yX>RS5NYIE$HMEr4fcJ{&yT{|E3~268&#jbWmW;=vfcOM6?g+k4mReZRL+5Jz0b
z18;a6_lE5_XYK#iVFT~?ll#3KQv3C~F(K}o%OrS&7h*wCO|2j<v-n4L5m0r{qrq#e
z)-}bzw|1Kd^Me&DP1=a#Dg-t|cKATFB>#&NTtu!1`+OI0-@FHmDZU~Oqi_8O7)^qj
zW%49Wi-b_#IlhUH`{t4KIs7*)*Fb(+tnD1Bm104|MLUhJxBFjLqrTq0nei6K%f1EH
zxLwb2USWG!%hV6{Wb=p-gaGXljnXAJjy5k6lBbS-B4MMjY0^##Vx!j#V4WCp@w>q)
z{ViJwT-#Upf$YCCc%WQ9yepnhdiawbn{5NOqD3P^jwDY#Crr?yU#3S4Q(M*N_4Dhc
z{&ZR5v0As%GF!AkOE^6*i(+g@jiDYbb3V+zv>t^*^#g}jzRl2MLkM+xv_@MuCqD<0
zfHuP-;m2>zUosiW*DSFb<Hx#TcL!9mfHJpQshJWAOz>Dh)@(+B68b~c?093`qwuMu
z$aq{wMZKhO5H^?(5-<oH{*Vj_)Z%L)1}^NK*Ra4)e&Ev5{N1f}Rl3tRA4GN$Aau-S
za@IC5Q$?Gdt~~d?&E!3c;lhL)+`59S?>Uv_<ov+zm2C)z1zygWi<>OOfSyv5FR$_V
zjhYDM=K%NpZ6UWfaZmFNBG>Koa4E~<U~?Pf^ZaQQ7djB8vrU0&<(8WAb9<$HxSFD+
zlTt9y)QF;T4^-BywSBrMgVb(Tx(ndyAz|h?MtCd6v~O7Xut+3#QYZx(bvl((sod2I
z9&C4k^&$AFH-yYlFb;NcWzmHj*lx#iJNKVI9_rLMe>xqmb|35o;KTw{L8BREgYM-A
z=zi9(vP+xZieR&gfP`IZ864d>+C(=P(z!1)xUJ^p+z!2jnk9_0H?CaM8(k^``mSn4
z1`?ukAp-Mt2h-6A2(+W#>v;F(P%qHO=N*ALgl@%StpWho@k{iqutm9?fY9XK(2A*q
zHs?s3@z+8X5&TEz@bOq8EE^`8)GvZlE%6u6<BsZlknUqm;*8aJo;{eyMmawaVb24z
ztL7Jet`#+OfTGDvFvZ6G;U3TyAHm#{n6&^p5b!hXL1!4P*tR0b#XD=ctD>(;ojjwz
zegNd5+LK+TIe?}sVn9U-C=YP$r#x<b>!ykZn)Uh^Wp(-290~WWM(=W~1L@%uLtoq$
zpLu-@BUV=dofopS6mf(*=Wv0{uaUrpG&O5HMg$eQM)=bv#-#L`1OnuTitm0U#G%H8
zHyX!NtSRZhpsf6r4hdw0)}L%ET8x!sO(&;kwgb)NJz5As>f7Kd<*b0}nlzwj%x~V4
zWL)h$9^QS+FBtLI1?j4a1`^}*y^(Yh?#pxYK@<?m_x)A;elk%In~?)Rd5y^LaqE=G
zlqP|$3Cbe2B)f0+R#J!a<QCJlD0b=$<`6P&%T~Sb^f=0T*<rAJD{CBIhLg9R2?{$N
zy^zfmMnL?O<0j#SJJ;^u=k3=hi7x{H-Te#Ry^)E;jaotg$>EoRU^Wh-FGHSwhh*=W
zndMBmQlhZ?^}WK<o+$HFui<6(J1k~{byrqTFP0M))DxseM`zT?Azj5Fb-6`kCZBZ6
z`_Du9mD^D!?qpApRr=^S1NSGJs3kfttJM60@n&am%qVpY_E2<E-nE%IIcup`srhBV
zjJ&vpIqqBse6akNS0^34V0jhi-oWg=hzRl<HITewP<$Z@>MJ1s!Ss9S=>`GJy8i`g
zA27Bd8vU;-rb>G4;^(<*6>6tpGy`^XD}Y#ibzt?R!3Hc~|2>^ROhN(&7<(9-XjA>9
z!4G6tdG}L2RMFo%*AeU<Grm-0tNae+AHY6NB5l8pe^{4Mt%;8b$$OUeR+9BuJ5I4I
z{`vkV65Q3Dm@lQhH$-_y&21|=8B!soKiz7)1PV6-L6FQ$_s0n#0;l7@o{&4x{mm%|
zSkxi;xB6}ih!WQ=Bh+rcB9jr31X+hnNbb%2WZhiN0|y+ON**mUp=SJOKsAlZW8PI7
z_XMwU%b{I;@zr~{1qRtzeKdeuEqc5Pv+i5mQbTnLV3VBr5n4-cammc7Owzb#`P>h1
z^u1*c+-nT5`3{NefCh5ForF-)ggIRC&A)uY^)aT<TS8GT({A#XL-|=$9i6e<G}qOa
z#VV(q6AfNV07M}2TJkwNPL(`W+z3-`4d_l3QL#ZSP<qLq2NiH*%d%d8+Jq8sG0BBQ
z;DnVsOTka9DSk&-q4vjLWr0D6@K#!v$3VxpPGz{6@b`jadXmK!>W??0uS))U07k84
zO4U3>`;sY+{heEnwj{omSNp4{2l4(SK<>7n7&NLV+vEZsVUx<8A@9mS|C<2M>Hd!C
zqs$S6a25@CuJ3kxG~1e(Dx-wu7Hq?L45)=l5-qp0rN)3sDilW@;QZ}P-Cm`2T0vDO
zroHS-Z=+Bo?+ZSv2b1uQv_+iQS{LFBc~)O?mfxh`RF#*_J9g&ODtyVY_N$RO2xebX
zpH|afQd(*X%)oDs8t9JiE_njH-`=0FRRnXUWHxlG&rXjQHfu1kz)Uq?oie(Lqkx)M
z7HxAi^j?F)Gcj~+SW3s9=~B>0Y49n-xi>Nlf8Zw7KjY^0`3^82GJ{Hf$Qa%fXL&H?
zf__qJ);)i?lp4+stv_0YxGkso@4hVzicCy|fc}N-u;v~LF#+&Eeg<Z#alYeuYG4FP
zow4kbxDf*nr5J5uEUNlfJunu|WZ?n|;OQ&Z3Y^n~Y^PxZ>U;Tml}Ji1_3WpY70bYK
z>85}&gF?!y`v&qj=B-;emC2Xq!7uR}-+<p?53(aoc;Qg+@iTGU5ic8VGyZ8q9QlMO
zQR%MvzK-Q$47;kWZ%A(6d**kQ9!WJx%u~n&GMO@!Yc%dNsE!94&u<Etg-n0F=Ds@u
z;^Q=zd%GJGP(xQx5Bqd<63}H)iaf>9p0`zh-vvXK2V#!PAKUYi&1~!Tz`&OhnKOs(
z4?^X)A!?ZcR#VlQ2JR~?-2H><qvqnICn*g<;F7pXw!bAiha!tnxJyddBoF>ZFEtHZ
zu_%9>ONT2M`>RX$fU^?;X6Gyi7Z1&@E%#-xaC0m1b}UM?;nsJf*~RHX{5Yxvj88qB
z4dyjzi(qhXRak~y?Ox9amy815(VCdfV21NU_7%$eRO=CTlq{MHLHXudTCsjvn~#sS
zJ9*3RdCf=4&wqG@6wU5Q_1q3LF*EA`qZFMyhLorB9KRA!-Fvqoy`}+5NR<`rmLwFs
zvsZV{P9GPq1E1~wP`lWlxtRI$;8uWQCnIIje+q#gYogLO(a(%z^=-U+B@UM7zI4QL
zdt7m!4@yp0u7Cxa4*qEimZ3uuv|y;|cQM+xCwHJ>TJjshA4DCpVa{WwzOie-Mh~}M
z=1j;>NlLoC0!)VX7-h_d9Gp9%g}c3&VTB>KtOX*f6gG63%7WNqHET&GXcT5gQ4WOX
zRyaQBw=4NqL!=P{kvcmmH8C++7P~cwf26J=!Ghq_yiY0yZ|-?|<t<EA3^qtBfs?;i
z)}<wPUi(xzj(5%Y#(amW-9V1Y$N{VGL_!R-_jt2L1*2Aj-JjU&v-LUbG&EwiT`Jdz
zgajbwmdL?-nRivPw_QYk*Snn50rH#L2}Tz{dY$YwZqFb8*F9&@@L~O1EkHER&QKY8
zs#=a9KNUB@mlQys$NZl_5_sQAmiBt)rqwgzPpj-{00bzj?*gYmfPAXZwvb8E_2);&
zwP7W*uK2W?XY%qKV`TGezz3SxBdG%uj6yT!UxKlwOtG9ADGBv+E*t6(k$1F+QcXdf
zv6L5GtI9(2fyP98q~#$aRQ$B_-6ptW?-_7+?Dzfpr#l8f&o);j{_aEN`zx6N@sikG
zb&K(`JTMtY72WvxWgjEz*KDvU@TZQ9cEIe=#{l3>`!k=waprlP3b)vfrS-*O+T11u
z8R>)HB;YJsLB0)3&R)_k_otjEtkX{qLj-yP?!9DD1N}gSE`_;E<s$|I2SpbSpE#r5
zYG0N*j(|KoHL1QUJRd}S?fj%H=Li*w>_=excVK-AaGPKCPhs2}nFt7&Bo+x^s2xNM
zOxeMCGt-y#<3s%&7`b}#=X#YT59dz=-?__{B<^)9YUx`RQ4R)Ea_2ATWHMz8inSqJ
zB}pRDPBry3!d4Ntge;doX8X|JD70nt^p4g6Ysu(i21<FcUN-_#)ZMluhMeJ<y7g^{
z2PYJbcL3Ra4q#V272ZGJmJ6s77mPt2u_^GQ;R^_8$82-(Lcbz!XaL79JEN0mNp(}T
zOd#2j-X^ec;WYN(v$6u4P+Fh=d6lq=Rq4a>tpX3>K~=*n#ker-9qjSJnuplnb@f%%
zxYUsXDDS4*tm&mdI9EJ42M8e$;Y1S<Q!dv;GfJfGNdQWAH~GG1f!1D$xcxzLA)KI?
z%**l)G+jVpnX(P>p2u+TE3oU45Y?PZB;Xlt{5}wZ{|dUY8;_O;a>Bt3BZCY+lohO8
zNl|fNqcxN!C)`u5m&Uf10Zcp;d2}*np4tweDt{uM>HVPWC|ina`stDfrVctdMe@)a
zhq5|`n&Fkx?uwh$YdnVluog->d7?oe*9J@^U9kqH?jS|bYV;XBjrma+x?JT3u5gby
zD9W@m_6dMurdXy)zBk?@chyczVjuw&rPTf~zPXsspMV$j_Z@kUeHHiySQ8#lau|PJ
z_Mh@sWDk+-bbohOSMiSk^x&pi6U**_u~mv-w1NzGb&Aul&h~m~@2UqhNpccbDY?Ee
zRfwrXdqcq3ln9|$!^?O|sgn8_h0892@%MSGL15Nj=ixGS`sNbdcePI%d1}RMCNtf@
zGq&;Z)~t&WS5i?CIXeFM{6r?twxpe+Dd^CU2nQ6G$H-7o5vBrkj<^$UB(8+xk(ott
zyuzD*IpL9zRG(9n!Ck{jn`BA+mtbz};Q`P4Z8hSe)tkA_8{^G&&%$8EA~?W!r~}_9
zAL#%iW^kM;U3qjKI0os?BDvtK_dN$bY(<=BNF>h5)-m*jIOar><$^xFXgwQL*0ZRz
zVok51tbG@>mrKatMqTVvaBya=rtd(LwiK#{feV#lDJH7MZ8)#+4eQkOn&BK?IF23r
z`p+~H@XG)t3aoxRQ@D6KZ&^?03<#!%f(us(?>Z%*qVBGSQ8;Bnxvt`hA&TqfoV^-=
z`%$N73Va{;2MV!I<L}PI*SLG1VO@0U+{>r&wm>Mn=Dd1#l}4Cr9ho~?va|T<k3a|1
zh8|TlgoIonfqD)5lhWpgI}=a!?Sm0LYsoflJ0HOT!Uc$;dxPqA96`Z#te{-4@LuYT
zHj1S#vQ?6Kg-3|at>@~f`ZkKz0beR`8JJmc=*acYmw_EF%ctrRklQ@Sp`Ja@q~^js
zh?|<Ktx7d*J6)@D_S8$-3pjGRWxqrIOk6g#`6Oy$Z>r29+HrkU)p>n1Qi^TRGY^I;
zxeW#i#UG~M%1u@k6%|#huo{bZ_<U%@*iOMK*<e|}yEdYtSXwLpWCV;+Y`4fsX4R{-
zLEu87V68owiLWN5&aA~zIGlgV>E%g-tF$Fs{G?&vsZySNJ1>?O&hp~)meEJRzqH~I
z^Yy=+rzl8Jur52TC_M9Y-)%bG;-LYUN!EupvYn`~?lO|y3xpMml83jzYwB^x3g)`B
zJM>CW2~)GoRy(dRdL8Zdsqv_$$V5X72BDV&z|7*6-eVBre~aBr@!0G;D9feg3EXC`
z1}ohpIS>IUE>#Q=0exYBWx14qvztxg)~?q93CWKmA>aPX>0yQ5pmA!7&=rKb6y%C&
zPkSF*hd$kS{$Ge8K1S%Q+)edMHY3mt%kj@I-f?MvelTc52|TGNcFlZ^zE)o$%fZLI
z)&4a<C9|2iYGVT6%>}&}5ws^0h~s0yP!wRi^vW{TYqayBMLerOy7d*yFs&7(g3ikT
zP`?|1_+>@{XOZ-N<0A$FdUb0y`TPaYI&fkrb>$jJfye+SiS*V#!@dm2i>NTRs<pBv
zdv3QMa<E%`jTXN^rio-$A*k(UR$U-6VmWnt0}D)j@zDdchE$8&U**AZ1c4q$-*E{q
z<_onk5P#BBu2&=COdzArJW*j2g_T;5cIc5X%-1Mj*t;c&=orzAGinZ^QUE=Gr0qWo
z9d!iF-Mcaq%dFTE#zfUXnMC|Cp;uo8Z0uKu+{)>*tEio6u`Cy7TMpH9J1t)pm*pP}
zZf@P3CGauMv3jQ(z=1a;d2NoVp>$32CO#rHsyA<OXcfjoU_@&dP_xv!_i<&J*FcY(
z0_+z)mLJaYeId}pt_@Lj{bKby85|<JWZ!@{(}um-VEOA}ts9D6xdImJ=@$s91pBF*
zKhsde&HOm=g+O(=vKO~hj2*|X%xc)74aVjFwD;xzP`7RW?I9&f+AJmemR**tlbvi)
zhRT|RjGa&lS+Wla$vy}XG1gMD6Gmj4VkCR^o#*)Iy6*3NU(fY?yZ?ZzpL%JWouBh_
z9^3nPzmE~Xb=}}mI$3mwq?9}1YVA)sEh;zAziDf*STsf;cyfLlta*r@@!|9YZ0PXg
zMBtlw`N>Z1#M2NON(6aHffA=5_NXQ!9@ayU96!j=D6{woO>TA-eM%Scu!B89$;^O!
zy(4!$qyOek4^u^1VRWnXnr;XFXEH_`=^_*gn3LWwxzv}^>5m$5kKw<i8=C*b)z2=?
zZP`;Qi;`4&TPjjL65nA41EwZEy()4*O^Vmow}kt?K4!%Ve811?b}AMzYAb`U`8K^5
z>FSz``?)i)7t}A_+mgS!HMp-L2qo2No5i|Y(H!X9iQ}u>0LO<!9RfE>RwB0pKS=RW
z#u<PNWY2Jz!ch+<*uzN_CN=#WkI?pSbrM`wX8b+OX4cuv=Eld(x+HoRdi8S4v~Ckh
z<)>Z}4O%YNuG74E@9&Mxi8IDpJ~w7E6v^#6a6C<ui@7t4h_tvBZxhPpkuK4GX35IT
z-k@pe4Of|hHK)koppk}TOA)0S&d%W45s|9uU1bS*fk_`LfI`q-Wx0PenqNsgV?ng#
zLLs<vFWw3UTNdf{SDLJ9*Ku@NgPwgYqR&^qH;-7x@J30MIg`9E>OR-k&*F5NwmOT=
z8aUk5#+w8g=wO0WITggY13=bn7_h61@UogDVT-bbl6j?Glae$>5rxA_-R9b8tpMh(
zAJPTgeEpruIXd`dxcvsbH>r*~HdewI*avN%pGzyAn}x=5dUJTBTc;JA(Lcm^k^6N<
zbF`wLW*uWOG$9w`>{z&XR6pnSzaUN$UPnrHXBI_Cj<%Y%U0j<NJR#^B{L*M4!nR}n
zU3$cG?9`7s{v$8yXpg8AB9z%1aK&maIv4^i<BihV5r8<UTnx320IBgxUm|rKt$g}e
z)6Bo?7Up?aE(yG@RjKfZQwdK-F)x;{_0tPj++uW_#L~TgqZ8CFwQ8X{DZW%k&K7?I
zz85GCk6+F`_fXtH3b;xZUlnpon)yysiq16$&9v<=OVcbCDKPDgehMn6tqo0vL=g={
z#GuN@$Ebv-(exyGjM#WOHof6F#oVI9GPI8}jw$B4n^WK12|UdaIb*=<Bf{?YV$AD(
z*b32Fny>eZ-?pORyfS;(PvvQW<#U!$5^q?8UUsdTm}7D9s>|@Q)!cBhDsK?Js@iz|
zTJHLKN2`EmwW)w<d$4JBTmv?Pj=K|sl3J4fq@WskIX|My3ipV^!{X|RIEhP~dO0Lc
zXb)$Lje@n`zi$m;CpU=_tyqVBi~Z2K^Nc>a=0r&gq+m=}%40?9Xm{tTP~z;gS`vlz
zig}%8IWR^GhN<g%SOrg45nF?7x`F@HA$%Gr20Hh=<}?!`^H@*J-Xt74zJROoRnM!8
zCtm;6N?gKKr@y*k+u-M;_~>Z^ZSe|<Gd6A|ON=<Rajn4Ji4e1r#TK2wwKolQd06G;
z0?)GXz*Kf)F78F_WZ!1`^Hw))?Sw|@+wD#3E4DwWo9wDvXxR#H0qzeJ3en+)%?+Ze
zMd%xM#XuTX9ZMeUtiJxCpxHk=_^pP;)4Wn^RH36}dFA~HcIBIan^IgJ^G7R&_#JoF
zKXG^G(5IMUC#TN~Kwo&Zb)WJFzs$6fR<&9C%K*%9r@o)M$7DlMdycxx#$5EIp~|%_
z25>WMr4N*s0M9(gLN5zm?=BXuq+a}kF-klQ4pVaRI4N*kX?N$%PY_jV%0_+A0o7M{
zg0oG_2=*FdnV0he%?>8A>+6=VZb>h9+AEE*r-nZim|q#XJtJn>&?gt#w7OoEsN_Bp
zy+Zt{Pb5uCL!;2R(!|S~^LwwMX#I;ysz!wKhw|eOZTVblD(2Z2ad2y3?)ki`bsS$f
zK}-#*(Dmfu=_{3-ArU)G{T8u%U#AcIJ8|mkZpK~rMy)z~vv2jSGBscg#!r<VPiN}1
z>qfT=_%{$+#1|)Agr^<+mbxSo2`S$_p|6i=A@V)G(r)S%g0_DY^bv~vz{4Q=E-!P4
zE3~sOp4eDb#aGzwJ|SXT8jra>`s!R~c={-PT;rRZxKxwj@pG1A<#K$*p}G`BWe(L(
z-wD`Mll61A+s3-8jseqoDVsaCOd<VAYjf3sG~@SWso&{~QhOiv&xfg#8ayOilt+#w
zm``_kq&fHZL`d-(YFt<#z2eB0xa#iI6gFvC+^C1mi{RH$EOW<0RXgzI;~K(yE{DQt
z#?Sh&JILyiC<dN@_>;buY5ues)Uq?qeo%4!)C)RLQ7XxFO0+zc?m)HYP~{7STkQo2
zW)>r-9TrQ(RquTy@w<m#l~N%D$NzNgX6BP~*`r&QpB@bSOYb01+2q|}XLpw~jjN*-
zU5O>p+f};p6SUY&{pQ1mRln08`5b^=fdXcD1*>X4|8-!+1m$$>9G=F`Q$92#z*)rW
zoso>^{?JY$#(5U<_)p0^kYsRfOFA@)fXFW_4yx|=qr1;eF<bx;jB=7FPgGB@q?}#$
z!G=tk>evss+9Yfa2COE?((g_Wq2pT0`zawZn3+w78OCQMMh+x|4jj=LBWcgx7}-Dk
zAcU%JDxoaZt>V~fD;#WKO{<bcms-DZe^EO}g{i_~)#+8#rFq6Pn$6zVYMYJDtLNs@
z^ybI;@<UQ6*x^ctcn=rw9s~IcWtOBsBJEF+i<lb2O0OjbUF1x?EZ|JfACj6%2ARS<
zeyAppmTx}CN70JZVsr)wVo!-8x<WYV(-LkW1nW;i6J$}rZbFui)fhx|ivvDaz6u!(
zKe*S0baa9U?zX;_G;~<AGRvFg)Icv@-S5y3tsfg_(lID{-^CAwGXkb6E%q++dthsZ
zL`JHKF3Z_GHw~V#__I0|7jr@zgXSN#>@R9G|N2;Y)u>}X-b5wP8DWr6gN_&Hy+4a6
z!TO~6^YSIlc#efr^w{0sp8HITZ5W|8rlLAur@Zu9<e*O`hS?{35ix6GugYgUIP`D#
zU6W^M`N17yWFO10)oVB)63rDj6cwK-U_NnFitz1-e`EiXv(pB=%PqKi<}}-frMc>!
zq(E!-Q8MJ@5P&3ikW$wY;0f&eg?CK)XvLGbLl4>Y4|6%E1E{@ggy<#ll8-4dcI~mP
zFo+T|-Fl6vxl(#Uj(6)6b1XNnPukf;e|}=u6*P%(?n4i)0p~uXJF%3hT)jhLLBe;^
zFF-`yB>do*^k<ifG9%UyhI8Y_=uCN>kwm{cRkWyR6>HE4eMPG9Gx)Z{>xJmfR?~XX
zJfbIY63dnz(&aKv>ZfW?GQ56ae8R!}#&k>RRUv$`b2iTI>vzg&w&^?GI#nrVD#gL?
z3T}MXb#v-JP&tjZ&#p||9FZSwtIWhPo2iBRtSrBmYA>=mva&Sgf|~qzQq<{r)P<Cn
z%2rONNP+yECm}`TPyq2e;0*p|u2)LAp9vau#I2A{;wvxZ;Lgc=F9j@4*ZU-7rs%_5
zxy-GSu?5jl)61=r<MB9tQyWl5xLGZz&W`g{spLplE9aZk%=!aGaecNiPk_@piu?I%
zgQ~6W$WY~?lU*ov2aT!ICxq`7+IF!F-5d@3d}d4{{a_eZdg`tHJE7an3pKsbfCxf)
zY=6TDB-BKF^JCda$eBGl6>}AC<Q(hm5EtoE^x2pz;4&LD4I%-n^<=*ISi!2rg575u
ziiR*fu4Af8i;6B;Kt;a<ydmg-KR=o;?KJ9H?7TEyrmyC!cFRA%&X2KjOQT()=+jvl
zsWGqMo$p!eP%&utreswi{Gf<*WGISz<@-XmGnx8vDW$EH(kLlGkC%k9;>?%md@=8D
zY(2?Zw<>g{L9LV*>d&P&M!J{owSD@WT>+*A!(|oMRRbc}>VGH;4i|Q`o`2q&F2~w;
z?>S+JHIhRXxH3C-DI+5XXiAy2WP=u`S0rC0`JC&iVv`Tjx~rI1N<`?@QaLen7?!^K
z33XUTs`YbMt**{iJ1BZDJzHu*r!ZH_g`ShobrpB|aT@Nk%nd*ncIi-b?e{_3(_6g|
zSIFIybvl=dRSCf*+})U+AEN{Avqjr|`6ZBWcTpMeariO#aFq9`lcp~XJ+QpL82o%>
z7(CTeSlTwxV0e!RNnv}YV!Du3+Z7<msZe;O2=^oh^{%V!oAyI%DFW0ge15CIi7n`o
z8wTb1aN*nhCdRPeV}T!&B*)ASo`3ZjA>~F~S65zVSuw#uCr4bsV)hP)(W>K6Za3Z}
zIM5IFO@X+8qfygsn^KAXV$no9LRr#ujeBu?hroWlT;TFkMYLrWmsd_XC1?ZCKr*Id
zEAPe+K00QD)B@cgEXuF#aX$Aa%Nij7^RUA+o0QE0kWALp8ID#T>&F>B9iW<7u}oBP
zul-(NGoC&a;vHx{lk`=Ctiv~?yb!U{^|`C~Bc#eT#yUF6Ea?nPjg1#8W2nJw^SH}q
z69?uSYB+W5plBmxq+yIL0dN53nG#9_Q9Jq2GKvVq@K_hfY*MCNPl%e_m*jVf-yB*r
zT2n$~a7y84KZ45*)@p-lSm_Kx>5!Yw)JZGIw?@^-=05cXG5@wa{r}=J%Z7molnJ*6
zK|l5FM%qXsHY8`NjYrMpnZh*%D(u1HE}Iv0G#VF*96vN<uW|PjmlzV-PPl7*1uE}T
z-VQc~FPG2z>1<!@`2HqQzUN2qG`7LA5nSIs{wUnu_iOWxeWU$pMeI8>dGiwm=B)6!
zt2`m4vOu;#nL;gyB0HB1tpSWgk?o6Vv1~|~f)hoqw@6LPwQ_;*UlE~^|9>dtbB2)4
zPJEUSIth+-&A|DYg19!bqrU1F!Pbb(*U>5~*<Akg4@zC{U72DQFu9z!E@H~o8t#5D
z1hhG`B^;;Xc`M7BTb(Q2K>WZ;VlMvj2R*R7z!_`Xz5cExB3xKoC5n9%=RgW%MkCTl
z?ME`n^)NkDg4@*JqM@lz(a{&GvKar4{bD`!$E~dZ=^_2**u5H{MDD*v7mOS`(dNSC
zp9ZPdin}5w_;rT)%v-q~k1~3`GIV#mm5zu^!nnev&)YVnLU#kZycwarw9kBDj2*Cv
z6bWtOWrn#Qcko{sW5lM8gX-f1A9w%`8Sntf&f%0(y{Kru*o@5Bsc5Iw>H1H6akzxw
zP(FjvTl%(=EC;jDD=Qg^=C_DRvrQ3}PVV`A_-fz9nI_5sUxaBS29XRDk{QgXTrrkt
zgUN8N06o5plm%5d^7tza8;f8DYW>k%oP<A=aDg;zW0@YBN0eJnyEpZ--mZnDuDJfw
zPANx^g~?5XWmcRh?h#8UpX42i{hEH~#z>$NQ0G=pz0pY2l{%&tfISo2Z?^DS)5>fl
z-lH=3nUGEv+GU=XIfDvQ!@=JJxN;`)XxcxCb8|6ykx)7*qHxYHfVQbqtW(v2lPCh{
zz1DBwT1F)$<JQwCUQc&|n5_^QJSafi=DMHRuS#0xYd9><Ue(ULordFRtxsT1*%$J8
zveeQ!@{LjNCC}Qzoxq_-#vMT{Hv()7$hDV%T$^em4KksN4sp~Qh|R>&9)d7JlLTMW
zL(8IZCC7mK;i_XeU_>2loy8)Z{YMb?q+-ZvY9~=&@gTGmedz*rYhy94>8Ze#t=FT)
zN^|XUxgWM<9af+8Ri8}<6CkQF^kt}SYTcL#q^+UF(`?;K-w*b&f(!>BOtXi6rwms%
zeJy-0vcEuss8uy0DRBD*N#k^;spGVifw*&P)F<Dwd|XF$@yTKu^|72fA2r%WL!U`%
zkBQ(;QKPu0#cl?n?d5{rASv?%$Yr`sZ6s*^)cqhVHw(m+?&yo%lO(A;x>jE4l~ZVY
zugvz_N8d%aB!V|(Rq52;6CzCN2tn32<i)&|d8$sRnpNNWnOO0gW}9af06NWEMy)QF
za74}yLY}+jyYOzU%uFWlP=QV3rH$FNn3$M%Dd}~c*evmBZW7?W=w;Uv;JCD50tT(G
z<;oyFqOGWiwKL5!y7B-^#4?$bikjzDv+t4Cq%7;)gQ}}*o<tSUb=Uhr|K&PwzT3H{
zCv`6a$F=v59Je`Fr&R+<a*r;0Gq7AiGUD#Yj<jlFT6ElS9c|a;c4|<K?$ig_02ITx
zmN2ddoc`kvWdQ;bx=h~#7#iek#$jC4V@b#S;s_G%_q5(y*raZKn$a#GDN}PDcMn;n
z9p-9S?%Rvm^rfR)4e4qAx$dAkT+`V&oWpYp#d8_AHz4kIXE=zJ>b{J`vn44y;`WY_
zchEKX(qRRkqih@YWdO0MIqy7~?f1AYX=GS~^3B0lFor_FtVsx;+E>*iLD4~jrxBGC
zM?{@r_v0{#FdY%OKy7qgWy7x-$#$>#Jo1q9p3XE_5l7@cj5|+Ekxy>*+!j7(*?>kw
zns2UPnHsT6&QlRBJmQT5c}pr4elE&e)Eg*dYyw@P=a~v|i@L>}-r=kU{rabwDZ>*E
z{UDml7vUiXT87M9YRH+G(d3=S@e!AYF_H$PKvOgF1s@)yML19>ldFIO3B*)*u1#EB
zl}i;D=st4jc4$a!1V7db9!^lApZX;?<%O#2T&L|zj-m9HNCC?z;pfW8AwbvRSbq5t
ziucX;=2oFkq+ZMnoD^;&NktHpSZm=JoT9xfoHai9io6~OeIu7EmV`0{bI>D$!CH%;
zi4pK9#M0^W#2_%r{|yDi9MR-H_NGGoq+Y*N21AF@JKN9vb(rC|o4W;G)b6-iHpYU$
zC$U1-$!NC)?9GnrWtbdC>kgx>a`Uz5h|g92@vegbx!>e+OZ*~2;O3B(Kwo~4vqi?q
z4^6In0nJE>sc}kuF!sq0aP~b}q!qYJ3OH3<_wv6hY)x3?Lt)sWjN&N3UGP=&XTOj6
zd%YKoMv;k{KZNMHUm5@>E{I^O^HTSg^?_Ec5G&y2T4|s)R|QySa!858INVWGgcr0%
z%+7vIhk$uFrpX(<x-{{EI<u-#u;7wPePjqxc4i?aah$nwz;%Nb1_6MWVu2n5CC}39
zRLetH$QlfIP+`M?gLCui8Rj=yWuMh=Pzi<4zjWkq)2<&n?zu56+CK8_V!`kNkGo6b
zhu9;jw-=T}2Dp#!!J9bUrrE}o5FRgo)+6i3XyuZK3n$NGYN&G`Sx*!p2jHT@q<@z1
zy_k5Yu{$YNKyZn=UnPOr%k#-K>g>#4_06b+>&wk!mIEo32gSw9Lf4lfLrF_S?-&>$
zaB2Ng)oSR()vPMn3P-vxDH%WP+{E4bq7G^d1ID2?>nuntcdf(Lkvc=LwHZ%360zlq
z2_3}6Z^qimA7&27u{u$9?ZeYhNg?4Y0t<$N;-|o}jwK$59NyaSQzHAmW5>}}Wd&K?
zdD9c^d1Xk9|JVaD{#v!ds>jx!N^LvBoYK@TM8unIPF{e%(6Fg#mArYCJet?DRB5zB
zWyE21qNCN!wdz}e*W|tpOLfLOSuAP+G&M%%0cd+#wuEh%=n23?fF6&N;b}@DO2nBE
zU~YF;Yz)!{F2OJgGLclGRv$6Aw9O{*x_^6NkYBwuRP<HrB;G;)aj6T-^vXilbx?^K
z3wVFl-B4^ZQ~xpe5ef;`BbJh*%L5eK7bh9x7@1hFSPv#Nct*cEQh(P^ym`<$Kr#pN
zlPmErD+BI%H!f<Y-qMPUxNsXLO8g7bG0bJZ13J~P0i$a{r8+37F$OF`AO~i+=EZy7
zF)uyru?Q!BGq%*w`onT<@&I|p)HBs-f*dmH#mf!`=ggOhB)({*tuYx-7iD>^nvRpu
zBcx1e;q$LJZB#)Gl=RZu{vp!S*!<F|mm7U%$iL2)&giT7B?K=Ug>?1)eJ-R@zCmfm
z29<JjO_3}hl=3I)Ldqi$Hypk86n>CQVAs8i^W9t2o7&){$cLx$q+m#~w;Q@5aQDN9
zp^!F%g0JMGG0u)l%BiN66jS?te9Fm#>fzIjPf=XKnPZTcR^4LcK;T?oG`VKQ*TFb(
z>ne4Bq1rj2YesW`a&1p|lwrb>K}UixEo@h{;zxPvll;J!O$&o~QKEasK&Hn#Y2JXq
z^^UE3>{30Vv`(Z^B#?nizeFpbCE?V~L`@1bsTyjg7chCN<mR$gc2n@Bz4gISDKYt$
zt=g4C98ZN6bD!EL(;}g#7oHhZ#zFo_brA}56=_^=(5NpMPj~ip$?z~Ptsk^etjJ84
z)q^K8_)1#W(k}Ij=7Wx9h0cwOJW|lyHi`I=+x4Pb219InmQ9zb^Lrfqjt<t~D8Rwz
ze;@--K#6NpcvtH@y{Nf7R5mtVZLDQ+E8lD6a*t{lO%fW$zGz*MUW>9lJc{1D<s`Uq
z0aFuo^p|E3s&1J4@Z)Q10SMFGV+H}&o42K1@X)~C7EU#On6AB2I(E}#{@BZR-WT1k
zmll;>Uo0=ynVz6eER$)e`e~A#rm_b=%eE#zJNqoge7Hcbz;oQW!VooSoQcjUAlO`n
zp~o&yj&faT67;I0ZT-~Fk4$kWff94Dn(jwTIM)MS&Ax{)KJCf*PxK``0GT}CUE+ry
z94DyoaO29fXG7++^Kb_YI}b$zXS5Lp=9t&M;VETv;@18Hfqq3C@Lus9Np<PkKNs3@
zxjG%xaP?N^4RwlJ1I*BjX_fYq-?($DMJN+pRQgUS)NU~S4kC4?#y9iPkRey)A(|uJ
z^+&i}zFLbxWl=CXz*lG*vg&$`x2pJvI}>*runLy`Xythd0WXM1S0R~*C@O%O@Lxk0
zoOB?QqOk^!9p!kMb0kUQB##55w=R)Ks~Zuyw5Mpk5whL9{J}JwU>j1DtzXxDb3?&1
zNU$#@r02(ggduNPvd=g6haCC@Tp!6Fy%KppPM|(Oa&5Bs{pzl@SbXRQNoeKrrwpNx
zdcPJSzi5J<;dkP&=Y~l6T5M~pAfGGt0+(8cgzuWU#IWYPyhzaFciCmrbB{%I{V5|U
zQFO}B7PlCx>EtpS=`}36e_2A0Q?EjnvB=&jE$gGA&7%WjU4tGshX7={$=}x`n&<7D
zds?&f#bf^G^JfmiEV|1>^xHc`$RMp0|HTeZZST;+79|hiPT<9c>zPx#o@Fr{TiJ&f
zp9y_p`fkuti3*DQSw!#M^<U_{>GBZM%87|<3*)kFr@V2!&Tq%Dnwm3d7*EiT*P|jF
z_d>42giLK}vIaiO?<C7Xz?_77vjLGX7YFQnSp^;c>7GLOw^`pd?`k6qhNY1sQh<F0
zC_``BSoHVLY>Y62Oo}y(;jOsJ3d?w=&klkVPUc8kTGCzar>ab&`yfT;M7s2tzjo>W
zM#FCcL^-JFXE{No!d0+y6qsAcG{N9)Cbr}=T}No9{P)rs4Wz4K>sbzk>P&>~j#Z7}
z8W-o>JvVlhO73yaEuoB>0`pA;O$I+7^Iymse<L++4cLAePrBe`7#~^0dy@iN_x=>S
z2a<yXph@$V`U8*858?6Y{wI&`Z{;{Tkcj3R(w&0EMA+AkGegh&3x06u!yG%1izRod
z7Q;P}LvCIS)n6C_e>3&L@+<<+TAM%?R&&fM5z3c)yX-jbZ0{_Z^~6nh%(vTXk^O!x
zI`!>4^4>xSQIB8zpt5~v%jdsI9;$Dl4c*xx1;uq31cLA8$b87(2>ekH4r$AZUj34v
z4}<)?@hy+P>hNlTL(Qxi^J(A&7$BFU9d7XNbY#^?YrbE6nHr==`<;ULflCMc_hW3&
z(k@S+^Y=VEj~p3dS}_2T{%%l){!=ufJTXI<P`gJ7nUQMGCBIC)ef%9EP>np^I0$W-
zn5wQe;Pp(PXWX6Jq~WpIk;ld&kNlg*rj6n%?!yGVyjDa3)<Ibb*0Jo<Z~O`D&2l8L
z!p(w<MneBiIO`!;R0&zM^S@Zsw*jWv1p-}35ni_HS3`I~c0VTfT-qMU6t!(4>(87%
zK>Fyjt+<8A{yV2?j6;(@Y0|pkJpNU&Fe;kMYX=)EXdMp08AzNS-3z9B4|zK$|7yCR
zWVS$?AgSX0`+~b3(^{6(6bWNkw76<Z&V&uZ194p3sl>SJa2+y-Gm-M|>|y)2A3u?S
ziSFh-g;x0$O@`zsn2~sS*yI(wNQRvx3WuGr{#z|%2eGiu|MG6E$B?9CWKVbgVEomy
zRpA&6OL$OCH-dmdWPwFwcO_x=iieZ0FGTn<1wMESN;LlR8ZHDxK+2)*4?(gW2UHOJ
zxGJ<>e*OI4NOW=_Q!p9&X!z$p{aP0T#)QnvLtqx<S00?(o;M2B1aQt-M6Q%0ZW-CZ
zuk}*lJXOXB&(!|4v;X-2|J=&m2jD#RK6V75&%gchU;ipI1`#t=Bd7l8zt;cjN48g|
zgR}&FUy1I|P5kYL$o|>dpQr!pUHx-vf85#a>+;WC`+r7^9LPTw`X8?8ALsFp^Y~8#
q`Nw(ueVF~ndHk=8C-u;SEvl?t%`H4W5~v;UM;WD|kSlk?=YIfK;N3_7

literal 0
HcmV?d00001

diff --git a/src/04-modality-specific-files/images/microscopy_sem_overview.jpg b/src/04-modality-specific-files/images/microscopy_sem_overview.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..419713006933ca334b0eb2cba5950f4d6b1fb737
GIT binary patch
literal 169378
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

literal 0
HcmV?d00001

diff --git a/src/99-appendices/04-entity-table.md b/src/99-appendices/04-entity-table.md
index 0151c08738..92ae16c1e0 100644
--- a/src/99-appendices/04-entity-table.md
+++ b/src/99-appendices/04-entity-table.md
@@ -36,3 +36,7 @@ while entity definitions are in [Appendix IX](09-entities.md).
 ## Behavioral Data
 
 {{ MACROS___make_entity_table(datatypes=["beh"], auxdatatypes=[]) }}
+
+## Microscopy
+
+{{ MACROS___make_entity_table(datatypes=["microscopy"], auxdatatypes=[]) }}
diff --git a/src/schema/datatypes/microscopy.yaml b/src/schema/datatypes/microscopy.yaml
new file mode 100644
index 0000000000..20e1547875
--- /dev/null
+++ b/src/schema/datatypes/microscopy.yaml
@@ -0,0 +1,45 @@
+---
+# Microscopy
+- suffixes:
+    - TEM
+    - SEM
+    - CT
+    - BF
+    - DF
+    - PC
+    - DIC
+    - FLUO
+    - CONF
+    - PLI
+    - CARS
+    - 2PE
+    - MPE
+    - SR
+    - NLO
+    - OCT
+    - SPIM
+  extensions:
+    - .ome.tif
+    - .ome.btf
+    - .png
+    - .tiff
+    - .json
+  entities:
+    subject: required
+    session: optional
+    sample: required
+    chunk: optional
+    acquisition: optional
+    stain: optional
+    run: optional
+- suffixes:
+    - photo
+  extensions:
+    - .jpg
+    - .png
+    - .tif
+  entities:
+    subject: required
+    session: optional
+    sample: required
+    acquisition: optional
diff --git a/src/schema/entities.yaml b/src/schema/entities.yaml
index 8bcd1a16c1..42db8eab05 100644
--- a/src/schema/entities.yaml
+++ b/src/schema/entities.yaml
@@ -38,6 +38,15 @@ sample:
     The label MUST be unique per subject and is RECOMMENDED to be unique
     throughout the dataset.
   format: label
+chunk:
+  name: Chunk
+  entity: chunk
+  description: |
+    The `chunk-<index>` key/value pair is used to distinguish between different
+    regions, 2D images or 3D volumes files, of the same physical sample with
+    different fields of view acquired in the same imaging experiment.
+  type: string
+  format: index
 task:
   name: Task
   entity: task
@@ -91,6 +100,17 @@ tracer:
     although the label may be different.
   type: string
   format: label
+stain:
+  name: Stain
+  entity: stain
+  description: |
+    The `stain-<label>` key/pair values can be used to distinguish image files
+    from the same sample using different stains or antibodies for contrast enhancement.
+    Stains or antibodies SHOULD be indicated as appropriate in the `SampleStaining`,
+    `SamplePrimaryAntibodies` and/or `SampleSecondaryAntobodies` keys in the JSON file,
+    although the label may be different.
+  type: string
+  format: label
 reconstruction:
   name: Reconstruction
   entity: rec

From b83a72d271914d8cd970ab6b9dbdce1ef9961298 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 16 Sep 2021 19:36:38 -0400
Subject: [PATCH 02/73] Add Link descriptions and fix md formatting

---
 .../10-microscopy.md                          | 156 ++++++++++--------
 1 file changed, 86 insertions(+), 70 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index d2572cc6ec..7deebaa50c 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -19,6 +19,7 @@ guidance when curating a new dataset.
 Further Microscopy datasets are available:
 
 -   In PNG format:  [`data_axondeepseg_sem`](https://doi.org/10.5281/zenodo.5498378)
+
 -   In OME-TIFF format: [link to the dataset - pending]
 
 ## Microscopy recording data
@@ -27,7 +28,7 @@ The following table will be generated automatically with macros after community
 A "manual" table is provided to facilitate the review process.
 -->
 Template:
-```
+```Text
 sub-<label>/
     [ses-<label>/]
         microscopy/
@@ -52,11 +53,13 @@ or vice-versa.
 
 For BIDS, Microscopy raw data MUST be stored in one of the following formats:
 
-- [Portable Network Graphics](http://www.libpng.org/pub/png/) (`.png`)
-- [Tag Image File Format](https://www.adobe.io/open/standards/TIFF.html) (`.tif`)
-- [OME-TIFF](https://docs.openmicroscopy.org/ome-model/6.1.2/ome-tiff/specification.html#)
-(`.ome.tif` for standard TIFF files or `.ome.btf` for
-[BigTIFF](https://www.awaresystems.be/imaging/tiff/bigtiff.html) files)
+-   [Portable Network Graphics](http://www.libpng.org/pub/png/) (`.png`)
+
+-   [Tag Image File Format](https://www.adobe.io/open/standards/TIFF.html) (`.tif`)
+
+-   [OME-TIFF](https://docs.openmicroscopy.org/ome-model/6.1.2/ome-tiff/specification.html#)
+    (`.ome.tif` for standard TIFF files or `.ome.btf` for
+    [BigTIFF](https://www.awaresystems.be/imaging/tiff/bigtiff.html) files)
 
 If different from PNG, TIFF or OME-TIFF, the original unprocessed data in the native format MAY be
 stored in the [`/sourcedata` directory](../02-common-principles.md#source-vs-raw-vs-derived-data).
@@ -71,25 +74,25 @@ Microscopy data currently support the following imaging modalities:
 The following table will be generated automatically with macros after community review.
 A "manual" table is provided to facilitate the review process.
 -->
-| **Name**                                         | `suffix` |
-| ------------------------------------------------ | -------- |
-| Transmission electron microscopy                 | TEM      |
-| Scanning electron microscopy                     | SEM      |
-| Micro-CT                                         | CT       |
-| Bright-field microscopy                          | BF       |
-| Dark-field microscopy                            | DF       |
-| Phase-contrast microscopy                        | PC       |
-| Differential interference contrast microscopy    | DIC      |
-| Fluorescence                                     | FLUO     |
-| Confocal microscopy                              | CONF     |
-| Polarized-light microscopy                       | PLI      |
-| Coherent anti-Stokes Raman spectroscopy          | CARS     |
-| 2-photon excitation microscopy                   | 2PE      |
-| Multi-photon excitation microscopy               | MPE      |
-| Super-resolution microscopy                      | SR       |
-| Nonlinear optical microscopy                     | NLO      |
-| Optical coherence tomography                     | OCT      |
-| Selective plane illumination microscopy          | SPIM     |
+| **Name**                                      | `suffix` |
+| --------------------------------------------- | -------- |
+| Transmission electron microscopy              | TEM      |
+| Scanning electron microscopy                  | SEM      |
+| Micro-CT                                      | CT       |
+| Bright-field microscopy                       | BF       |
+| Dark-field microscopy                         | DF       |
+| Phase-contrast microscopy                     | PC       |
+| Differential interference contrast microscopy | DIC      |
+| Fluorescence                                  | FLUO     |
+| Confocal microscopy                           | CONF     |
+| Polarized-light microscopy                    | PLI      |
+| Coherent anti-Stokes Raman spectroscopy       | CARS     |
+| 2-photon excitation microscopy                | 2PE      |
+| Multi-photon excitation microscopy            | MPE      |
+| Super-resolution microscopy                   | SR       |
+| Nonlinear optical microscopy                  | NLO      |
+| Optical coherence tomography                  | OCT      |
+| Selective plane illumination microscopy       | SPIM     |
 
 ### Filename entities
 
@@ -211,32 +214,31 @@ A "manual" table is provided to facilitate the review process.
 Note: For `StationName`, we removed "Corresponds to DICOM Tag 0008, 1010 `Station Name`." from the description.
 It will require changes to `src/schema/metatata/StationName.yaml` and `src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md`.
 -->
-| **Key name**              | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
-| ------------------------- | --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Manufacturer              | RECOMMENDED           | string    | Manufacturer of the equipment that produced the measurements. |
-| ManufacturersModelName    | RECOMMENDED           | string    | Manufacturer’s model name of the equipment that produced the measurements. |
-| DeviceSerialNumber        | RECOMMENDED           | string    | The serial number of the equipment that produced the measurements. A pseudonym can also be used to prevent the equipment from being identifiable, so long as each pseudonym is unique within the dataset. |
-| StationName               | RECOMMENDED           | string    | Institution defined name of the machine that produced the measurements. |
-| SoftwareVersions          | RECOMMENDED           | string    | Manufacturer’s designation of software version of the equipment that produced the measurements. |
-| InstitutionName           | RECOMMENDED           | string    | The name of the institution in charge of the equipment that produced the measurements. |
-| InstitutionAddress        | RECOMMENDED           | string    | The address of the institution in charge of the equipment that produced the measurements. |
-| InstitutionDepartmentName | RECOMMENDED           | string    | The department in the institution in charge of the equipment that produced the measurements. |
-
+| **Key name**              | **Requirement level** | **Data type** | **Description**                                                                                                                                                                                           |
+| ------------------------- | --------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Manufacturer              | RECOMMENDED           | [string][]    | Manufacturer of the equipment that produced the measurements.                                                                                                                                             |
+| ManufacturersModelName    | RECOMMENDED           | [string][]    | Manufacturer’s model name of the equipment that produced the measurements.                                                                                                                                |
+| DeviceSerialNumber        | RECOMMENDED           | [string][]    | The serial number of the equipment that produced the measurements. A pseudonym can also be used to prevent the equipment from being identifiable, so long as each pseudonym is unique within the dataset. |
+| StationName               | RECOMMENDED           | [string][]    | Institution defined name of the machine that produced the measurements.                                                                                                                                   |
+| SoftwareVersions          | RECOMMENDED           | [string][]    | Manufacturer’s designation of software version of the equipment that produced the measurements.                                                                                                           |
+| InstitutionName           | RECOMMENDED           | [string][]    | The name of the institution in charge of the equipment that produced the measurements.                                                                                                                    |
+| InstitutionAddress        | RECOMMENDED           | [string][]    | The address of the institution in charge of the equipment that produced the measurements.                                                                                                                 |
+| InstitutionDepartmentName | RECOMMENDED           | [string][]    | The department in the institution in charge of the equipment that produced the measurements.                                                                                                              |
 
 #### Image Acquisition
 <!---
 The following table will be generated automatically with macros after community review.
 A "manual" table is provided to facilitate the review process.
 -->
-| **Key name**               | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
-| -------------------------- | --------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| PixelSize                  | REQUIRED              | array of numbers    | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
-| PixelSizeUnits             | REQUIRED              | string              | Unit format of the specified PixelSize. MUST be micrometer (`"um"`). |
-| Immersion                  | OPTIONAL              | string              | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field. |
-| NumericalAperture          | OPTIONAL              | number              | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field. |
-| Magnification              | OPTIONAL              | number              | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.|
-| ImageAcquisitionProtocol   | OPTIONAL              | string or URI       | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/). |
-| OtherAcquisitionParameters | OPTIONAL              | string              | Description of other relevant image acquisition parameters. |
+| **Key name**               | **Requirement level** | **Data type**            | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| -------------------------- | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| PixelSize                  | REQUIRED              | [array][] of [numbers][] | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
+| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be micrometer (`"um"`).                                                                                                                                                                                                                                                                                                                                                                                                     |
+| Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
+| NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
+| Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
+| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][]    | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                     |
+| OtherAcquisitionParameters | OPTIONAL              | [string][]               | Description of other relevant image acquisition parameters.                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 #### Sample
 <!---
@@ -248,41 +250,46 @@ from the description, and replace with
 "from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN".`)".
 It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modality-specific-files/09-positron-emission-tomography.md`.
 -->
-| **Key name**                | **Requirement level** | **Data type** | **Description**                                                                                                                                                                        |
-| --------------------------- | --------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| BodyPart                    | RECOMMENDED           | string                     | Body part of the organ / body region scanned. from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)". |
-| BodyPartDetails             | OPTIONAL              | string                     | If needed, additional details about body part or location (for example: `"corpus callosum"`). |
-| BodyPartDetailsOntology     | OPTIONAL              | string                     | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`). |
-| Environment                 | RECOMMENDED           | string                     | RECOMMENDED. Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`. |
-| SampleEmbedding             | OPTIONAL              | string                     | Description of the tissue sample embedding (for example: `"Epoxy resin"`). |
-| SampleFixation              | OPTIONAL              | string                     | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`). |
-| SampleStaining              | RECOMMENDED           | string or array of strings | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`). |
-| SamplePrimaryAntibody       | RECOMMENDED           | string or array of strings | Description of the primary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
-| SampleSecondaryAntibody     | RECOMMENDED           | string or array of strings | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
-| SliceThickness              | OPTIONAL              | number                     | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`). |
-| ShrinkageFactor             | OPTIONAL              | number                     | Estimated shrinkage factor of the tissue, given in percent (between 0 and 100%) of the original tissue dimensions (for example: `3`). |
-| SampleExtractionProtocol    | OPTIONAL              | string or URI              | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/). |
-| SampleExtractionInstitution | OPTIONAL              | string                     | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image. |
+| **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
+| BodyPartDetails             | OPTIONAL              | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`).                                                                                                                                                                                                                                                                                                                                                                 |
+| Environment                 | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| SampleStaining              | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`).                                                                                                                                                                                                                                                                                                                                  |
+| SamplePrimaryAntibody       | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the primary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
+| SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
+| SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ShrinkageFactor             | OPTIONAL              | [number][]                             | Estimated shrinkage factor of the tissue, given in percent (between 0 and 100%) of the original tissue dimensions (for example: `3`).                                                                                                                                                                                                                                                                                                                                                                                      |
+| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][]                  | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
 #### Chunk transformations
 
 Chunk transformations metadata describes the spatial relation between chunks
 of the same sample in an implicit coordinate system.
 
-- The source frame of reference is the frame of reference of the associated image.
-- The target frame of reference is the implicit coordinate system of the transform.
-- The target frame of reference has the same units as the `PixelSizeUnits` metadata.
-- The chunk transform is described by 2 metadata fields: a transformation matrix and a
-description of the axis of the matrix.
-- Other transformations should be described in derivatives.
+-   The source frame of reference is the frame of reference of the associated image.
+
+-   The target frame of reference is the implicit coordinate system of the transform.
+
+-   The target frame of reference has the same units as the `PixelSizeUnits` metadata.
+
+-   The chunk transform is described by 2 metadata fields: a transformation matrix and a
+    description of the axis of the matrix.
+
+-   Other transformations should be described in derivatives.
+
 <!---
 The following table will be generated automatically with macros after community review.
 A "manual" table is provided to facilitate the review process.
 -->
-| **Key name**                  | **Requirement level**                                            | **Data type**              | **Description**                                                                                                                                                                        |
-| ----------------------------- | ---------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ChunkTransformationMatrix     | OPTIONAL                                                         | array of arrays of numbers | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
-| ChunkTransformationMatrixAxis | OPTIONAL, but REQUIRED if `ChunkTransformationMatrix` is present | arrays of strings          | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`) |
+| **Key name**                  | **Requirement level**                                            | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ----------------------------- | ---------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ChunkTransformationMatrix     | OPTIONAL                                                         | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
+| ChunkTransformationMatrixAxis | OPTIONAL, but REQUIRED if `ChunkTransformationMatrix` is present | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`)                                                                                                                                                                                                                                                                                                                                                             |
 
 #### Example (`*_<suffix>.json`)
 ```JSON
@@ -318,6 +325,7 @@ In addition to the species column in the [Participants file](../03-modality-agno
 the following data SHOULD be included for species different from `homo sapiens`:
 
 -   `strain`: string value indicating the strain of the species, for example: `C57BL/6J`.
+
 -   `strain_rrid`: research resource identifier ([RRID](https://scicrunch.org/resources/Organisms/search))
     of the strain of the species, for example: `RRID:IMSR_JAX:000664`.
 
@@ -359,3 +367,11 @@ Below is an example of a spinal cord SEM overview, modified from Zaimi et al., 2
 ![SEM overview](images/microscopy_sem_overview.jpg "SEM overview")
 
 <!-- Link Definitions -->
+
+[strings]: https://www.w3schools.com/js/js_json_datatypes.asp
+[string]: https://www.w3schools.com/js/js_json_datatypes.asp
+[numbers]: https://www.w3schools.com/js/js_json_datatypes.asp
+[number]: https://www.w3schools.com/js/js_json_datatypes.asp
+[arrays]: https://www.w3schools.com/js/js_json_arrays.asp
+[array]: https://www.w3schools.com/js/js_json_arrays.asp
+[URI]: ../02-common-principles.md#uniform-resource-indicator

From 8e29cd84f64e09431aa5b4173f981c146a8d84b9 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 20 Sep 2021 11:06:03 -0400
Subject: [PATCH 03/73] Fix md formatting

---
 src/04-modality-specific-files/10-microscopy.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 7deebaa50c..5808cd1e8c 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -19,8 +19,7 @@ guidance when curating a new dataset.
 Further Microscopy datasets are available:
 
 -   In PNG format:  [`data_axondeepseg_sem`](https://doi.org/10.5281/zenodo.5498378)
-
--   In OME-TIFF format: [link to the dataset - pending]
+-   In OME-TIFF format: (link to the dataset - pending)
 
 ## Microscopy recording data
 <!---
@@ -237,7 +236,7 @@ A "manual" table is provided to facilitate the review process.
 | Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
 | NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
 | Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
-| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][]    | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                     |
+| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][uri] | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                     |
 | OtherAcquisitionParameters | OPTIONAL              | [string][]               | Description of other relevant image acquisition parameters.                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 #### Sample
@@ -263,7 +262,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
 | SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | ShrinkageFactor             | OPTIONAL              | [number][]                             | Estimated shrinkage factor of the tissue, given in percent (between 0 and 100%) of the original tissue dimensions (for example: `3`).                                                                                                                                                                                                                                                                                                                                                                                      |
-| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][]                  | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
 #### Chunk transformations
@@ -374,4 +373,4 @@ Below is an example of a spinal cord SEM overview, modified from Zaimi et al., 2
 [number]: https://www.w3schools.com/js/js_json_datatypes.asp
 [arrays]: https://www.w3schools.com/js/js_json_arrays.asp
 [array]: https://www.w3schools.com/js/js_json_arrays.asp
-[URI]: ../02-common-principles.md#uniform-resource-indicator
+[uri]: ../02-common-principles.md#uniform-resource-indicator

From ec29dcd8ac7ae78dde06095901d5f75519df35fc Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 28 Sep 2021 11:02:20 -0400
Subject: [PATCH 04/73] Move "chunk" entity at the end of filename before
 modality_suffix

---
 .../10-microscopy.md                          | 80 +++++++++----------
 src/schema/datatypes/microscopy.yaml          |  2 +-
 src/schema/entities.yaml                      | 18 ++---
 3 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 5808cd1e8c..43401820e4 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -31,8 +31,8 @@ Template:
 sub-<label>/
     [ses-<label>/]
         microscopy/
-            sub-<label>[_ses-<label>]_sample-<label>[_chunk-<index>][_acq-<label>][_stain-<label>][_run-<index>]_<suffix>.<extension>
-            sub-<label>[_ses-<label>]_sample-<label>[_chunk-<index>][_acq-<label>][_stain-<label>][_run-<index>]_<suffix>.json
+            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.<extension>
+            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.json
 ```
 Microscopy data MUST be stored in the `microscopy` directory.
 
@@ -118,41 +118,6 @@ In this example, JSON metadata is common for all samples of `sub-01`.
 JSON metadata may be defined per subject or per sample as appropriate, per the
 [inheritance principle](../02-common-principles.md#the-inheritance-principle).
 
-The [`chunk-<index>`](../99-appendices/09-entities.md#chunk) entity is used when multiples
-regions (2D images or 3D volumes files) of the same physical sample are imaged with different
-fields of view, regardless if they overlap or not.
-
-<!--- The following example will be generated automatically with macros after community review. -->
-For example:
-Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`) of subject `sub-01`.
-```Text
-sub-01/
-    microscopy/
-        sub-01_sample-01_chunk-01_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-01_<modality_suffix>.json
-        sub-01_sample-01_chunk-02_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-02_<modality_suffix>.json
-        sub-01_sample-01_chunk-03_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-03_<modality_suffix>.json
-        sub-01_sample-01_chunk-04_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-04_<modality_suffix>.json
-```
-In this example, JSON metadata is different for each chunk of `sub-01_sample-01`.
-JSON metadata may be defined per sample or per chunk as appropriate, per the
-[inheritance principle](../02-common-principles.md#the-inheritance-principle).
-
-In some cases, the chunks can be "ordered" and correspond to the displacement of the
-microscope stage for example.
-In others cases, the chunks can be different images of the same sample with no explicit
-spatial relation between them.
-
-Examples of different chunks configurations can be seen in Figure 1.
-![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
-
-Figure 1: Examples of chunks configurations. a) ordered 2D chunks without overlap,
-b) ordered 2D chunks with overlap, c) unordered 2D chunks with and without overlap,
-d) and e) ordered 2D chunks on different 3D planes, f) ordered 3D chunks
-
 The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity corresponds to a custom label that
 MAY be used to distinguish a different set of parameters used for acquiring the same modality.
 For example, two images of the same sample acquired with different magnification of 40x and 60x.
@@ -189,11 +154,46 @@ Stains or antibodies SHOULD be indicated as appropriate in the `"SampleStaining"
 `"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` keys in the sidecar JSON file,
 although the label may be different.
 
-If more than one run of the same sample, chunk, acquisition and stain are acquired during
-the same session, the [`run-<index>`](../99-appendices/09-entities.md#run) entity MUST be used:
+If more than one run of the same sample, acquisition and stain are acquired during the same
+session, the [`run-<index>`](../99-appendices/09-entities.md#run) entity MUST be used:
 `_run-1`, `_run-2`, `_run-3`, and so on.
 If only one run was acquired the `run-<index>` can be omitted.
 
+The [`chunk-<index>`](../99-appendices/09-entities.md#chunk) entity is used when multiples
+regions (2D images or 3D volumes files) of the same physical sample are imaged with different
+fields of view, regardless if they overlap or not.
+
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`) of subject `sub-01`.
+```Text
+sub-01/
+    microscopy/
+        sub-01_sample-01_chunk-01_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-01_<modality_suffix>.json
+        sub-01_sample-01_chunk-02_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-02_<modality_suffix>.json
+        sub-01_sample-01_chunk-03_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-03_<modality_suffix>.json
+        sub-01_sample-01_chunk-04_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-04_<modality_suffix>.json
+```
+In this example, JSON metadata is different for each chunk of `sub-01_sample-01`.
+JSON metadata may be defined per sample or per chunk as appropriate, per the
+[inheritance principle](../02-common-principles.md#the-inheritance-principle).
+
+In some cases, the chunks can be "ordered" and correspond to the displacement of the
+microscope stage for example.
+In others cases, the chunks can be different images of the same sample with no explicit
+spatial relation between them.
+
+Examples of different chunks configurations can be seen in Figure 1.
+![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
+
+Figure 1: Examples of chunks configurations. a) ordered 2D chunks without overlap,
+b) ordered 2D chunks with overlap, c) unordered 2D chunks with and without overlap,
+d) and e) ordered 2D chunks on different 3D planes, f) ordered 3D chunks
+
 In microscopy, many pyramidal file formats store multiple resolutions for the same acquisition.
 In the case where a multiple resolutions file format is converted to single resolution file format,
 only the higher resolution file is present in the raw data.
@@ -251,7 +251,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 -->
 | **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
+| BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
 | BodyPartDetails             | OPTIONAL              | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`).                                                                                                                                                                                                                                                                                                                                                                 |
 | Environment                 | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
diff --git a/src/schema/datatypes/microscopy.yaml b/src/schema/datatypes/microscopy.yaml
index 20e1547875..0d14474d3d 100644
--- a/src/schema/datatypes/microscopy.yaml
+++ b/src/schema/datatypes/microscopy.yaml
@@ -28,10 +28,10 @@
     subject: required
     session: optional
     sample: required
-    chunk: optional
     acquisition: optional
     stain: optional
     run: optional
+    chunk: optional
 - suffixes:
     - photo
   extensions:
diff --git a/src/schema/entities.yaml b/src/schema/entities.yaml
index 42db8eab05..33cf47ad17 100644
--- a/src/schema/entities.yaml
+++ b/src/schema/entities.yaml
@@ -38,15 +38,6 @@ sample:
     The label MUST be unique per subject and is RECOMMENDED to be unique
     throughout the dataset.
   format: label
-chunk:
-  name: Chunk
-  entity: chunk
-  description: |
-    The `chunk-<index>` key/value pair is used to distinguish between different
-    regions, 2D images or 3D volumes files, of the same physical sample with
-    different fields of view acquired in the same imaging experiment.
-  type: string
-  format: index
 task:
   name: Task
   entity: task
@@ -293,6 +284,15 @@ split:
     [Scans file](../03-modality-agnostic-files.md#scans-file).
   type: string
   format: index
+chunk:
+  name: Chunk
+  entity: chunk
+  description: |
+    The `chunk-<index>` key/value pair is used to distinguish between different
+    regions, 2D images or 3D volumes files, of the same physical sample with
+    different fields of view acquired in the same imaging experiment.
+  type: string
+  format: index
 resolution:
   name: Resolution
   entity: res

From 5e092ca55b8f9061a5b98915e512979ffe79a7db Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 30 Sep 2021 16:44:35 -0400
Subject: [PATCH 05/73] Add link to OME-TIFF dataset

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 43401820e4..6a5a00eb84 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -19,7 +19,7 @@ guidance when curating a new dataset.
 Further Microscopy datasets are available:
 
 -   In PNG format:  [`data_axondeepseg_sem`](https://doi.org/10.5281/zenodo.5498378)
--   In OME-TIFF format: (link to the dataset - pending)
+-   In OME-TIFF format: [`Broca's Area Light-Sheet Microscopy`](https://doi.org/10.5281/zenodo.5517223)
 
 ## Microscopy recording data
 <!---

From d4449af2b9e64d79ac0540eda5fd62775c00faff Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Thu, 30 Sep 2021 16:53:10 -0400
Subject: [PATCH 06/73] Update src/04-modality-specific-files/10-microscopy.md

Typo

Co-authored-by: Chris Markiewicz <markiewicz@stanford.edu>
---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 6a5a00eb84..074f7ab6be 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -41,7 +41,7 @@ The Microscopy community uses a variety of formats for storing raw data, and the
 standard that all researchers agree on. However, a standardized file structure has been developed
 by the [Open Microscopy Environment](https://www.openmicroscopy.org/) for whole-slide imaging with
 the [OME-TIFF file specifications](https://docs.openmicroscopy.org/ome-model/6.1.2/ome-tiff/file-structure.html).
-The OME-TIFF file allows for multi-pages TIFF file to store multiple image planes and supports
+The OME-TIFF file allows for multi-page TIFF files to store multiple image planes and supports
 multi-resolution pyramidal tiled images. An OME-XML data block is also embedded inside the
 file’s header.
 

From b8ad76685824b68aef686041a1248b2187b8adcd Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Fri, 1 Oct 2021 15:02:34 -0400
Subject: [PATCH 07/73] Apply suggestions from code review

Co-authored-by: Chris Markiewicz <markiewicz@stanford.edu>
---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 074f7ab6be..61138a26e5 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -77,7 +77,7 @@ A "manual" table is provided to facilitate the review process.
 | --------------------------------------------- | -------- |
 | Transmission electron microscopy              | TEM      |
 | Scanning electron microscopy                  | SEM      |
-| Micro-CT                                      | CT       |
+| Micro-CT                                      | uCT      |
 | Bright-field microscopy                       | BF       |
 | Dark-field microscopy                         | DF       |
 | Phase-contrast microscopy                     | PC       |
@@ -254,7 +254,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
 | BodyPartDetails             | OPTIONAL              | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`).                                                                                                                                                                                                                                                                                                                                                                 |
-| Environment                 | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| SampleEnvironment           | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | SampleStaining              | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`).                                                                                                                                                                                                                                                                                                                                  |

From 2a5cf259fedc8e0816cf0dde90c6a27fe0e32c61 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 1 Oct 2021 15:18:56 -0400
Subject: [PATCH 08/73] Update "TissueDeformationScaling" field and JSON
 example

---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 61138a26e5..bede26a495 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -261,7 +261,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | SamplePrimaryAntibody       | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the primary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
 | SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
 | SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| ShrinkageFactor             | OPTIONAL              | [number][]                             | Estimated shrinkage factor of the tissue, given in percent (between 0 and 100%) of the original tissue dimensions (for example: `3`).                                                                                                                                                                                                                                                                                                                                                                                      |
+| TissueDeformationScaling    | OPTIONAL              | [number][]                             | Estimated deformation of the tissue, given as a percentage of the original tissue size (for examples: for a shrinkage of 3%, the value is `97`; and for an expansion of 100%, the value is `200`).                                                                                                                                                                                                                                                                                                                         |
 | SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
@@ -300,11 +300,11 @@ A "manual" table is provided to facilitate the review process.
         "Magnification": 40,
         "BodyPart": "BRAIN",
         "BodyPartDetails": "corpus callosum",
-        "Environment": "exvivo",
+        "SampleEnvironment": "exvivo",
         "SampleFixation": "4% paraformaldehyde, 2% glutaraldehyde",
         "SampleStaining": "LFB",
         "SliceThickness": 5,
-        "ShrinkageFactor": 3
+        "TissueDeformationScaling": 97
 }
 ```
 

From a133357c84e013127f42fb5cbd328e76c5312a31 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 1 Oct 2021 15:21:44 -0400
Subject: [PATCH 09/73] Update "uCT" suffix in schema/datatypes/microscopy.yaml

---
 src/schema/datatypes/microscopy.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/schema/datatypes/microscopy.yaml b/src/schema/datatypes/microscopy.yaml
index 0d14474d3d..f3f8bdf1df 100644
--- a/src/schema/datatypes/microscopy.yaml
+++ b/src/schema/datatypes/microscopy.yaml
@@ -3,7 +3,7 @@
 - suffixes:
     - TEM
     - SEM
-    - CT
+    - uCT
     - BF
     - DF
     - PC

From 7f39d4c1f0cb3df34cd168d71abea19ea4157f70 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 1 Oct 2021 15:45:32 -0400
Subject: [PATCH 10/73] Add res-label example

---
 .../10-microscopy.md                           | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index bede26a495..5bb409e24e 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -199,7 +199,23 @@ In the case where a multiple resolutions file format is converted to single reso
 only the higher resolution file is present in the raw data.
 Lower resolutions files MUST be placed under the `derivatives` folder and use the
 [`res-<label>`](../99-appendices/09-entities.md#res) entity.
-See [Preprocessed, coregistered and/or resampled volumes](../05-derivatives/03-imaging.md#preprocessed-coregistered-andor-resampled-volumes).
+
+<!--- The following example will be generated automatically with macros after community review. -->
+For example:
+```Text
+my_dataset/
+    derivatives/
+        downsampled/
+            sub-01/
+                microscopy/
+                    sub-01_sample-01_res-4x_TEM.png
+                    sub-01_sample-01_res-4x.json
+    sub-01/
+        microscopy/
+            sub-01_sample-01_TEM.png
+```
+See [Preprocessed, coregistered and/or resampled volumes](../05-derivatives/03-imaging.md#preprocessed-coregistered-andor-resampled-volumes)
+for details.
 
 ### Microscopy metadata (Sidecar JSON)
 

From 3ca5bcac7ec89f969c3fb17c6cabd445dd267f46 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 8 Oct 2021 14:21:48 -0400
Subject: [PATCH 11/73] Add "mm" and "nm" to PixelSizeUnits

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 5bb409e24e..a7eb189108 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -248,7 +248,7 @@ A "manual" table is provided to facilitate the review process.
 | **Key name**               | **Requirement level** | **Data type**            | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | -------------------------- | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | PixelSize                  | REQUIRED              | [array][] of [numbers][] | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
-| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be micrometer (`"um"`).                                                                                                                                                                                                                                                                                                                                                                                                     |
+| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be millimeter (`"mm"`), micrometer (`"um"`) or nanometer (`"nm"`).                                                                                                                                                                                                                                                                                                                                                          |
 | Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
 | NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
 | Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |

From a63b5b79585a9340bce21d31a96ca1425ff764b1 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 15 Oct 2021 08:52:09 -0400
Subject: [PATCH 12/73] Update "Recommended participant data" after merge of PR
 #816

---
 src/04-modality-specific-files/10-microscopy.md | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index a7eb189108..e750d1d76a 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -331,18 +331,9 @@ For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples
 Additional optional columns in `samples.tsv` MAY be used to describe other samples' attributes.
 
 ## Recommended participant data (`participants.tsv`)
-<!---
-This section may be removed or modified depending if it is included in the "general"
-participants.tsv file in PR #816.
-(https://github.com/bids-standard/bids-specification/pull/816#issuecomment-909343123)
--->
-In addition to the species column in the [Participants file](../03-modality-agnostic-files.md#participants-file),
-the following data SHOULD be included for species different from `homo sapiens`:
-
--   `strain`: string value indicating the strain of the species, for example: `C57BL/6J`.
 
--   `strain_rrid`: research resource identifier ([RRID](https://scicrunch.org/resources/Organisms/search))
-    of the strain of the species, for example: `RRID:IMSR_JAX:000664`.
+For Microscopy data, we RECOMMEND to make use of the columns `species`, `strain` and `strain_rrid`
+in the [Participants file](../03-modality-agnostic-files.md#participants-file) when applicable.
 
 For example:
 ```Text

From f9c21254dc0ae1d71ed9bf172128b003cac49a4f Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Sat, 16 Oct 2021 14:50:22 -0400
Subject: [PATCH 13/73] Resolve conflict with master for entities.yaml

---
 src/schema/objects/entities.yaml | 323 +++++++++++++++++++++++++++++++
 1 file changed, 323 insertions(+)
 create mode 100644 src/schema/objects/entities.yaml

diff --git a/src/schema/objects/entities.yaml b/src/schema/objects/entities.yaml
new file mode 100644
index 0000000000..b5d4339d68
--- /dev/null
+++ b/src/schema/objects/entities.yaml
@@ -0,0 +1,323 @@
+---
+# This file describes entities present in BIDS filenames.
+# WARNING: The entities are presented here in alphabetical order!
+# The appropriate order of entities in filenames is defined in `rules/entities.yaml`,
+# rather than this file (`objects/entities.yaml`).
+acquisition:
+  name: Acquisition
+  entity: acq
+  description: |
+    The `acq-<label>` key/value pair corresponds to a custom label the
+    user MAY use to distinguish a different set of parameters used for
+    acquiring the same modality.
+    For example this should be used when a study includes two T1w images - one
+    full brain low resolution and and one restricted field of view but high
+    resolution.
+    In such case two files could have the following names:
+    `sub-01_acq-highres_T1w.nii.gz` and `sub-01_acq-lowres_T1w.nii.gz`, however
+    the user is free to choose any other label than highres and lowres as long
+    as they are consistent across subjects and sessions.
+    In case different sequences are used to record the same modality
+    (for example, RARE and FLASH for T1w)
+    this field can also be used to make that distinction.
+    At what level of detail to make the distinction (for example,
+    just between RARE and FLASH, or between RARE, FLASH, and FLASHsubsampled)
+    remains at the discretion of the researcher.
+  type: string
+  format: label
+ceagent:
+  name: Contrast Enhancing Agent
+  entity: ce
+  description: |
+    The `ce-<label>` key/value can be used to distinguish
+    sequences using different contrast enhanced images.
+    The label is the name of the contrast agent.
+    The key `ContrastBolusIngredient` MAY also be added in the JSON file,
+    with the same label.
+  type: string
+  format: label
+density:
+  name: Density
+  entity: den
+  description: |
+    Density of non-parametric surfaces.
+    MUST have a corresponding `Density` metadata field to provide
+    interpretation.
+
+    This entity is only applicable to derivative data.
+  type: string
+  format: label
+description:
+  name: Description
+  entity: desc
+  description: |
+    When necessary to distinguish two files that do not otherwise have a
+    distinguishing entity, the `_desc-<label>` keyword-value SHOULD be used.
+
+    This entity is only applicable to derivative data.
+  type: string
+  format: label
+direction:
+  name: Phase-Encoding Direction
+  entity: dir
+  description: |
+    The `dir-<label>` key/value can be set to an arbitrary alphanumeric label
+    (for example, `dir-LR` or `dir-AP`) to distinguish different phase-encoding
+    directions.
+  type: string
+  format: label
+echo:
+  name: Echo
+  entity: echo
+  description: |
+    If files belonging to an entity-linked file collection are acquired at different
+    echo times, the `_echo-<index>` key/value pair MUST be used to distinguish
+    individual files.
+    This entity represents the `EchoTime` metadata field. Please note that the `<index>`
+    denotes the number/index (in the form of a nonnegative integer), not the
+    `EchoTime` value which needs to be stored in the field `EchoTime` of the separate
+    JSON file.
+  type: string
+  format: index
+flip:
+  name: Flip Angle
+  entity: flip
+  description: |
+    If files belonging to an entity-linked file collection are acquired at different
+    flip angles, the `_flip-<index>` key/value pair MUST be used to distinguish
+    individual files.
+    This entity represents the `FlipAngle` metadata field. Please note that the `<index>`
+    denotes the number/index (in the form of a nonnegative integer), not the `FlipAngle`
+    value which needs to be stored in the field `FlipAngle` of the separate JSON file.
+  type: string
+  format: index
+inversion:
+  name: Inversion Time
+  entity: inv
+  description: |
+    If files belonging to an entity-linked file collection are acquired at different
+    inversion times, the `_inv-<index>` key/value pair MUST be used to distinguish
+    individual files.
+    This entity represents the `InversionTime` metadata field. Please note that the `<index>`
+    denotes the number/index (in the form of a nonnegative integer), not the `InversionTime`
+    value which needs to be stored in the field `InversionTime` of the separate JSON file.
+  type: string
+  format: index
+label:
+  name: Label
+  entity: label
+  description: |
+    Tissue-type label, following a prescribed vocabulary.
+    Applies to binary masks and probabilistic/partial volume segmentations
+    that describe a single tissue type.
+
+    This entity is only applicable to derivative data.
+  type: string
+  format: label
+modality:
+  name: Corresponding Modality
+  entity: mod
+  description: |
+    The `mod-<label>` key/value pair corresponds to modality label for defacing
+    masks, for example, T1w, inplaneT1, referenced by a defacemask image.
+    For example, `sub-01_mod-T1w_defacemask.nii.gz`.
+  type: string
+  format: label
+mtransfer:
+  name: Magnetization Transfer
+  entity: mt
+  description: |
+    If files belonging to an entity-linked file collection are acquired at different
+    magnetization transfer (MT) states, the `_mt-<label>` key/value pair MUST be used to
+    distinguish individual files.
+    This entity represents the `MTState` metadata field. Allowed label values for this
+    entity are `on` and `off`, for images acquired in presence and absence of an MT pulse,
+    respectively.
+  type: string
+  enum:
+  - 'on'
+  - 'off'
+part:
+  name: Part
+  entity: part
+  description: |
+    This entity is used to indicate which component of the complex
+    representation of the MRI signal is represented in voxel data.
+    The `part-<label>` key/value pair is associated with the DICOM Tag
+    `0008, 9208`.
+    Allowed label values for this entity are `phase`, `mag`, `real` and `imag`,
+    which are typically used in `part-mag`/`part-phase` or
+    `part-real`/`part-imag` pairs of files.
+
+    Phase images MAY be in radians or in arbitrary units.
+    The sidecar JSON file MUST include the units of the `phase` image.
+    The possible options are `rad` or `arbitrary`.
+
+    When there is only a magnitude image of a given type, the `part` key MAY be
+    omitted.
+  type: string
+  enum:
+  - mag
+  - phase
+  - real
+  - imag
+processing:
+  name: Processed (on device)
+  entity: proc
+  description: |
+    The proc label is analogous to rec for MR and denotes a variant of
+    a file that was a result of particular processing performed on the device.
+
+    This is useful for files produced in particular by Elekta's MaxFilter
+    (for example, sss, tsss, trans, quat or mc),
+    which some installations impose to be run on raw data because of active
+    shielding software corrections before the MEG data can actually be
+    exploited.
+  type: string
+  format: label
+reconstruction:
+  name: Reconstruction
+  entity: rec
+  description: |
+    The `rec-<label>` key/value can be used to distinguish
+    different reconstruction algorithms (for example ones using motion
+    correction).
+  type: string
+  format: label
+recording:
+  name: Recording
+  entity: recording
+  description: |
+    More than one continuous recording file can be included (with different
+    sampling frequencies).
+    In such case use different labels.
+    For example: `_recording-contrast`, `_recording-saturation`.
+  type: string
+  format: label
+resolution:
+  name: Resolution
+  entity: res
+  description: |
+    Resolution of regularly sampled N-dimensional data.
+    MUST have a corresponding `Resolution` metadata field to provide
+    interpretation.
+
+    This entity is only applicable to derivative data.
+  type: string
+  format: label
+run:
+  name: Run
+  entity: run
+  description: |
+    If several scans with the same acquisition parameters are acquired in the same session,
+    they MUST be indexed with the [`run-<index>`](../99-appendices/09-entities.md#run) entity:
+    `_run-1`, `_run-2`, `_run-3`, and so on (only nonnegative integers are allowed as
+    run labels).
+
+    If different entities apply,
+    such as a different session indicated by [`ses-<label>`](../99-appendices/09-entities.md#ses),
+    or different acquisition parameters indicated by
+    [`acq-<label>`](../99-appendices/09-entities.md#acq),
+    then `run` is not needed to distinguish the scans and MAY be omitted.
+  type: string
+  format: index
+sample:
+  name: Sample
+  entity: sample
+  description: |
+    A sample pertaining to a subject such as tissue, primary cell
+    or cell-free sample.
+    The `sample-<label>` key/value pair is used to distinguish between different
+    samples from the same subject.
+    The label MUST be unique per subject and is RECOMMENDED to be unique
+    throughout the dataset.
+  type: string
+  format: label
+session:
+  name: Session
+  entity: ses
+  description: |
+    A logical grouping of neuroimaging and behavioral data consistent across
+    subjects.
+    Session can (but doesn't have to) be synonymous to a visit in a
+    longitudinal study.
+    In general, subjects will stay in the scanner during one session.
+    However, for example, if a subject has to leave the scanner room and then
+    be re-positioned on the scanner bed, the set of MRI acquisitions will still
+    be considered as a session and match sessions acquired in other subjects.
+    Similarly, in situations where different data types are obtained over
+    several visits (for example fMRI on one day followed by DWI the day after)
+    those can be grouped in one session.
+    Defining multiple sessions is appropriate when several identical or similar
+    data acquisitions are planned and performed on all -or most- subjects,
+    often in the case of some intervention between sessions
+    (for example, training).
+  type: string
+  format: label
+space:
+  name: Space
+  entity: space
+  description: |
+    The space entity can be used to indicate
+    the way in which electrode positions are interpreted
+    (for EEG/MEG/iEEG data) or
+    the spatial reference to which a file has been aligned (for MRI data).
+    The space `<label>` MUST be taken from one of the modality specific lists in
+    [Appendix VIII](../99-appendices/08-coordinate-systems.md).
+    For example for iEEG data, the restricted keywords listed under
+    [iEEG Specific Coordinate Systems](../99-appendices/08-coordinate-systems.md#ieeg-specific-coordinate-systems)
+    are acceptable for `<label>`.
+
+    For EEG/MEG/iEEG data, this entity can be applied to raw data, but
+    for other data types, it is restricted to derivative data.
+  type: string
+  format: label
+split:
+  name: Split
+  entity: split
+  description: |
+    In the case of long data recordings that exceed a file size of 2Gb, the
+    .fif files are conventionally split into multiple parts.
+    Each of these files has an internal pointer to the next file.
+    This is important when renaming these split recordings to the BIDS
+    convention.
+
+    Instead of a simple renaming, files should be read in and saved under their
+    new names with dedicated tools like [MNE-Python](https://mne.tools/),
+    which will ensure that not only the file names, but also the internal file
+    pointers will be updated.
+    It is RECOMMENDED that .fif files with multiple parts use the
+    `split-<index>` entity to indicate each part.
+    If there are multiple parts of a recording and the optional `scans.tsv` is provided,
+    remember to list all files separately in `scans.tsv` and that the entries for the
+    `acq_time` column in `scans.tsv` MUST all be identical, as described in
+    [Scans file](../03-modality-agnostic-files.md#scans-file).
+  type: string
+  format: index
+subject:
+  name: Subject
+  entity: sub
+  description: |
+    A person or animal participating in the study.
+  type: string
+  format: label
+task:
+  name: Task
+  entity: task
+  description: |
+    Each task has a unique label that MUST only consist of letters and/or
+    numbers (other characters, including spaces and underscores, are not
+    allowed).
+    Those labels MUST be consistent across subjects and sessions.
+  type: string
+  format: label
+tracer:
+  name: Tracer
+  entity: trc
+  description: |
+    The `trc-<label>` key/value can be used to distinguish
+    sequences using different tracers.
+    The key `TracerName` MUST also be included in the associated JSON file,
+    although the label may be different.
+  type: string
+  format: label

From b2e1f8ade9c6db15e5f3fb27eb83b08bf1cd97ee Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Sat, 16 Oct 2021 14:56:28 -0400
Subject: [PATCH 14/73] Update entities.yaml in objects and rules schema
 folders

---
 src/schema/objects/entities.yaml | 20 ++++++++++++++++++++
 src/schema/rules/entities.yaml   |  2 ++
 2 files changed, 22 insertions(+)

diff --git a/src/schema/objects/entities.yaml b/src/schema/objects/entities.yaml
index b5d4339d68..6781e9d16f 100644
--- a/src/schema/objects/entities.yaml
+++ b/src/schema/objects/entities.yaml
@@ -36,6 +36,15 @@ ceagent:
     with the same label.
   type: string
   format: label
+chunk:
+  name: Chunk
+  entity: chunk
+  description: |
+    The `chunk-<index>` key/value pair is used to distinguish between different
+    regions, 2D images or 3D volumes files, of the same physical sample with
+    different fields of view acquired in the same imaging experiment.
+  type: string
+  format: index
 density:
   name: Density
   entity: den
@@ -294,6 +303,17 @@ split:
     [Scans file](../03-modality-agnostic-files.md#scans-file).
   type: string
   format: index
+stain:
+  name: Stain
+  entity: stain
+  description: |
+    The `stain-<label>` key/pair values can be used to distinguish image files
+    from the same sample using different stains or antibodies for contrast enhancement.
+    Stains or antibodies SHOULD be indicated as appropriate in the `SampleStaining`,
+    `SamplePrimaryAntibodies` and/or `SampleSecondaryAntobodies` keys in the JSON file,
+    although the label may be different.
+  type: string
+  format: label
 subject:
   name: Subject
   entity: sub
diff --git a/src/schema/rules/entities.yaml b/src/schema/rules/entities.yaml
index c36b591b72..be2784520b 100644
--- a/src/schema/rules/entities.yaml
+++ b/src/schema/rules/entities.yaml
@@ -8,6 +8,7 @@
 - acquisition
 - ceagent
 - tracer
+- stain
 - reconstruction
 - direction
 - run
@@ -21,6 +22,7 @@
 - processing
 - space
 - split
+- chunk
 - resolution
 - density
 - label

From 7a904be9d4f467f6244e19996cf85226f58d6bc9 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Sat, 16 Oct 2021 15:01:53 -0400
Subject: [PATCH 15/73] Update microscopy.yaml datatypes rules schema folder

---
 .../{ => rules}/datatypes/microscopy.yaml     | 53 ++++++++++---------
 1 file changed, 27 insertions(+), 26 deletions(-)
 rename src/schema/{ => rules}/datatypes/microscopy.yaml (54%)

diff --git a/src/schema/datatypes/microscopy.yaml b/src/schema/rules/datatypes/microscopy.yaml
similarity index 54%
rename from src/schema/datatypes/microscopy.yaml
rename to src/schema/rules/datatypes/microscopy.yaml
index f3f8bdf1df..cb821d68b7 100644
--- a/src/schema/datatypes/microscopy.yaml
+++ b/src/schema/rules/datatypes/microscopy.yaml
@@ -1,29 +1,29 @@
 ---
 # Microscopy
 - suffixes:
-    - TEM
-    - SEM
-    - uCT
-    - BF
-    - DF
-    - PC
-    - DIC
-    - FLUO
-    - CONF
-    - PLI
-    - CARS
-    - 2PE
-    - MPE
-    - SR
-    - NLO
-    - OCT
-    - SPIM
+  - TEM
+  - SEM
+  - uCT
+  - BF
+  - DF
+  - PC
+  - DIC
+  - FLUO
+  - CONF
+  - PLI
+  - CARS
+  - 2PE
+  - MPE
+  - SR
+  - NLO
+  - OCT
+  - SPIM
   extensions:
-    - .ome.tif
-    - .ome.btf
-    - .png
-    - .tiff
-    - .json
+  - .ome.tif
+  - .ome.btf
+  - .png
+  - .tiff
+  - .json
   entities:
     subject: required
     session: optional
@@ -32,12 +32,13 @@
     stain: optional
     run: optional
     chunk: optional
+
 - suffixes:
-    - photo
+  - photo
   extensions:
-    - .jpg
-    - .png
-    - .tif
+  - .jpg
+  - .png
+  - .tif
   entities:
     subject: required
     session: optional

From 32496fd6e21d54fda8cb521652c44e52df9e87c2 Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Wed, 27 Oct 2021 14:16:43 -0400
Subject: [PATCH 16/73] Apply suggestions from code review

Co-authored-by: Remi Gau <remi_gau@hotmail.com>
---
 src/04-modality-specific-files/10-microscopy.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index e750d1d76a..33268a0263 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -190,9 +190,12 @@ spatial relation between them.
 Examples of different chunks configurations can be seen in Figure 1.
 ![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
 
-Figure 1: Examples of chunks configurations. a) ordered 2D chunks without overlap,
-b) ordered 2D chunks with overlap, c) unordered 2D chunks with and without overlap,
-d) and e) ordered 2D chunks on different 3D planes, f) ordered 3D chunks
+Figure 1: Examples of chunks configurations. 
+- a) ordered 2D chunks without overlap,
+- b) ordered 2D chunks with overlap, 
+- c) unordered 2D chunks with and without overlap,
+- d) and e) ordered 2D chunks on different 3D planes, 
+- f) ordered 3D chunks
 
 In microscopy, many pyramidal file formats store multiple resolutions for the same acquisition.
 In the case where a multiple resolutions file format is converted to single resolution file format,
@@ -209,7 +212,7 @@ my_dataset/
             sub-01/
                 microscopy/
                     sub-01_sample-01_res-4x_TEM.png
-                    sub-01_sample-01_res-4x.json
+                    sub-01_sample-01_res-4x_TEM.json
     sub-01/
         microscopy/
             sub-01_sample-01_TEM.png

From 711fdace53101767cafd340534781bb42a18e9ff Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Wed, 27 Oct 2021 14:30:41 -0400
Subject: [PATCH 17/73] Fix md formatting

---
 src/04-modality-specific-files/10-microscopy.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 33268a0263..e678e99f6b 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -190,12 +190,13 @@ spatial relation between them.
 Examples of different chunks configurations can be seen in Figure 1.
 ![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
 
-Figure 1: Examples of chunks configurations. 
-- a) ordered 2D chunks without overlap,
-- b) ordered 2D chunks with overlap, 
-- c) unordered 2D chunks with and without overlap,
-- d) and e) ordered 2D chunks on different 3D planes, 
-- f) ordered 3D chunks
+Figure 1: Examples of chunks configurations.
+
+-   a) ordered 2D chunks without overlap,
+-   b) ordered 2D chunks with overlap,
+-   c) unordered 2D chunks with and without overlap,
+-   d) and e) ordered 2D chunks on different 3D planes,
+-   f) ordered 3D chunks.
 
 In microscopy, many pyramidal file formats store multiple resolutions for the same acquisition.
 In the case where a multiple resolutions file format is converted to single resolution file format,

From c33c6f69696696e7a32bdac21c681509c2bcc06f Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 28 Oct 2021 12:00:38 -0400
Subject: [PATCH 18/73] Make protocols.io an example in
 SampleExtractionProtocol and ImageAcquisitionProtocol

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index e678e99f6b..cd70d5cac0 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -256,7 +256,7 @@ A "manual" table is provided to facilitate the review process.
 | Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
 | NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
 | Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
-| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][uri] | Description of the image acquisition protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                     |
+| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][uri] | Description of the image acquisition protocol or URI (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                       |
 | OtherAcquisitionParameters | OPTIONAL              | [string][]               | Description of other relevant image acquisition parameters.                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 #### Sample
@@ -282,7 +282,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
 | SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | TissueDeformationScaling    | OPTIONAL              | [number][]                             | Estimated deformation of the tissue, given as a percentage of the original tissue size (for examples: for a shrinkage of 3%, the value is `97`; and for an expansion of 100%, the value is `200`).                                                                                                                                                                                                                                                                                                                         |
-| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI from [protocols.io](https://www.protocols.io/).                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                                                                         |
 | SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
 #### Chunk transformations

From 8ccf4defe20097dd16c829c0a349168859f3e5d3 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 4 Nov 2021 16:16:53 -0400
Subject: [PATCH 19/73] Re-wording of chunk-index section and chunk
 transformation matrix is recommended for ordered chunks

---
 .../10-microscopy.md                          | 65 +++++++++++--------
 1 file changed, 37 insertions(+), 28 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index cd70d5cac0..bfe59541c9 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -114,8 +114,8 @@ sub-01/
         sub-01_sample-03_<modality_suffix>.<ext>
         sub-01_<modality_suffix>.json
 ```
-In this example, JSON metadata is common for all samples of `sub-01`.
-JSON metadata may be defined per subject or per sample as appropriate, per the
+In this example, the JSON metadata is common for all samples of `sub-01`.
+JSON metadata may be defined per subject or per sample as appropriate, as per the
 [inheritance principle](../02-common-principles.md#the-inheritance-principle).
 
 The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity corresponds to a custom label that
@@ -131,7 +131,7 @@ image files from the same sample using different stains or antibodies for contra
 
 <!--- The following example will be generated automatically with macros after community review. -->
 For example:
-Brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three stains
+One brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three stains
 (`stain-01`, `stain-02`, `stain-03`) in three separate files.
 In this example, the entity stain is used to distinguish images with different
 stains in separate files from the same sample.
@@ -163,9 +163,26 @@ The [`chunk-<index>`](../99-appendices/09-entities.md#chunk) entity is used when
 regions (2D images or 3D volumes files) of the same physical sample are imaged with different
 fields of view, regardless if they overlap or not.
 
+In some cases, the chunks can be "ordered" and correspond to the displacement of the
+microscope stage, for example.
+In other cases, the chunks can be different images of the same sample with no explicit
+spatial relation between them.
+
+Examples of different chunks configurations can be seen in Figure 1.
+![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
+
+Figure 1: Examples of chunks configurations.
+
+-   a) ordered 2D chunks without overlap,
+-   b) ordered 2D chunks with overlap,
+-   c) unordered 2D chunks with and without overlap,
+-   d) and e) ordered 2D chunks on different 3D planes,
+-   f) ordered 3D chunks.
+
 <!--- The following example will be generated automatically with macros after community review. -->
-For example:
-Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`) of subject `sub-01`.
+For example, as illustrated in Figure 1b:
+Six chunks (`chunk-01` to `chunk-06`) from the same brain sample (`sample-01`) of subject `sub-01`,
+are named:
 ```Text
 sub-01/
     microscopy/
@@ -177,26 +194,18 @@ sub-01/
         sub-01_sample-01_chunk-03_<modality_suffix>.json
         sub-01_sample-01_chunk-04_<modality_suffix>.<ext>
         sub-01_sample-01_chunk-04_<modality_suffix>.json
+        sub-01_sample-01_chunk-05_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-05_<modality_suffix>.json
+        sub-01_sample-01_chunk-06_<modality_suffix>.<ext>
+        sub-01_sample-01_chunk-06_<modality_suffix>.json
 ```
-In this example, JSON metadata is different for each chunk of `sub-01_sample-01`.
-JSON metadata may be defined per sample or per chunk as appropriate, per the
-[inheritance principle](../02-common-principles.md#the-inheritance-principle).
-
-In some cases, the chunks can be "ordered" and correspond to the displacement of the
-microscope stage for example.
-In others cases, the chunks can be different images of the same sample with no explicit
-spatial relation between them.
+The index number can be assigned arbitrarily and, in the case of "ordered" chunks, the chunks'
+position relative to one another SHOULD be defined by an affine transformation matrix in the JSON
+sidecar file of each chunk, as described in [Chunk Tranformations](10-microscopy.md#chunk-transformations).
 
-Examples of different chunks configurations can be seen in Figure 1.
-![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
-
-Figure 1: Examples of chunks configurations.
-
--   a) ordered 2D chunks without overlap,
--   b) ordered 2D chunks with overlap,
--   c) unordered 2D chunks with and without overlap,
--   d) and e) ordered 2D chunks on different 3D planes,
--   f) ordered 3D chunks.
+In this example, the JSON metadata is different for each chunk of `sub-01_sample-01`.
+JSON metadata may be defined per sample or per chunk as appropriate, as per the
+[inheritance principle](../02-common-principles.md#the-inheritance-principle).
 
 In microscopy, many pyramidal file formats store multiple resolutions for the same acquisition.
 In the case where a multiple resolutions file format is converted to single resolution file format,
@@ -285,7 +294,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                                                                         |
 | SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
-#### Chunk transformations
+#### Chunk Transformations
 
 Chunk transformations metadata describes the spatial relation between chunks
 of the same sample in an implicit coordinate system.
@@ -305,10 +314,10 @@ of the same sample in an implicit coordinate system.
 The following table will be generated automatically with macros after community review.
 A "manual" table is provided to facilitate the review process.
 -->
-| **Key name**                  | **Requirement level**                                            | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| ----------------------------- | ---------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ChunkTransformationMatrix     | OPTIONAL                                                         | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
-| ChunkTransformationMatrixAxis | OPTIONAL, but REQUIRED if `ChunkTransformationMatrix` is present | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`)                                                                                                                                                                                                                                                                                                                                                             |
+| **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ----------------------------- | --------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
+| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`)                                                                                                                                                                                                                                                                                                                                                             |
 
 #### Example (`*_<suffix>.json`)
 ```JSON

From cab50db18fa202aba3ab259359d484aaaf352f4f Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 4 Nov 2021 16:53:39 -0400
Subject: [PATCH 20/73] Fix typos

---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index bfe59541c9..4c3ab5218c 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -200,8 +200,8 @@ sub-01/
         sub-01_sample-01_chunk-06_<modality_suffix>.json
 ```
 The index number can be assigned arbitrarily and, in the case of "ordered" chunks, the chunks'
-position relative to one another SHOULD be defined by an affine transformation matrix in the JSON
-sidecar file of each chunk, as described in [Chunk Tranformations](10-microscopy.md#chunk-transformations).
+positions relative to one another SHOULD be defined by an affine transformation matrix in the JSON
+sidecar file of each chunk, as described in [Chunk Transformations](10-microscopy.md#chunk-transformations).
 
 In this example, the JSON metadata is different for each chunk of `sub-01_sample-01`.
 JSON metadata may be defined per sample or per chunk as appropriate, as per the
@@ -317,7 +317,7 @@ A "manual" table is provided to facilitate the review process.
 | **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | ----------------------------- | --------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
-| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `['X', 'Y']` or `['Z', 'Y', 'X']`)                                                                                                                                                                                                                                                                                                                                                             |
+| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                             |
 
 #### Example (`*_<suffix>.json`)
 ```JSON

From a4a5771ee45bc0b9149c7509b2a1e0a4d290cab5 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 9 Nov 2021 09:32:27 -0500
Subject: [PATCH 21/73] Fix wording

---
 src/04-modality-specific-files/10-microscopy.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 4c3ab5218c..6af2ba8c56 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -45,10 +45,10 @@ The OME-TIFF file allows for multi-page TIFF files to store multiple image plane
 multi-resolution pyramidal tiled images. An OME-XML data block is also embedded inside the
 file’s header.
 
-In Microscopy-BIDS, we accept different file formats to accommodate datasets stored in 2D image
-formats and whole-slide imaging formats, to accommodate lossless and lossy compression,
-and to avoid unnecessary conversions of the original data from a non-tiled to a tiled format,
-or vice-versa.
+The BIDS standard accepts microscopy data in different file formats to accommodate datasets
+stored in 2D image formats and whole-slide imaging formats, to accommodate lossless and lossy
+compression, and to avoid unnecessary conversions of the original data from a non-tiled to a
+tiled format, or vice-versa.
 
 For BIDS, Microscopy raw data MUST be stored in one of the following formats:
 
@@ -63,7 +63,7 @@ For BIDS, Microscopy raw data MUST be stored in one of the following formats:
 If different from PNG, TIFF or OME-TIFF, the original unprocessed data in the native format MAY be
 stored in the [`/sourcedata` directory](../02-common-principles.md#source-vs-raw-vs-derived-data).
 
-Future versions of Microscopy-BIDS may extend this list of supported file formats.
+Future versions may extend this list of supported file formats.
 For example with the [OME-NGFF](https://ngff.openmicroscopy.org/latest/) format currently
 developed by OME as a successor to OME-TIFF for better remote sharing of large datasets.
 

From c66687f023668d084530afc289371d431ee78b50 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 12 Nov 2021 10:57:15 -0500
Subject: [PATCH 22/73] Fix tif extension in
 src/schema/rules/datatypes/microscopy.yaml

---
 src/schema/rules/datatypes/microscopy.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/schema/rules/datatypes/microscopy.yaml b/src/schema/rules/datatypes/microscopy.yaml
index cb821d68b7..3af2fb86d3 100644
--- a/src/schema/rules/datatypes/microscopy.yaml
+++ b/src/schema/rules/datatypes/microscopy.yaml
@@ -22,7 +22,7 @@
   - .ome.tif
   - .ome.btf
   - .png
-  - .tiff
+  - .tif
   - .json
   entities:
     subject: required

From ed408c122a92bcb8ef42a9634ef8636a5dafab18 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 12 Nov 2021 12:02:19 -0500
Subject: [PATCH 23/73] Remove duplicated text in stain-label description

---
 src/04-modality-specific-files/10-microscopy.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 6af2ba8c56..d63fa81a5f 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -133,8 +133,6 @@ image files from the same sample using different stains or antibodies for contra
 For example:
 One brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three stains
 (`stain-01`, `stain-02`, `stain-03`) in three separate files.
-In this example, the entity stain is used to distinguish images with different
-stains in separate files from the same sample.
 ```Text
 sub-01/
     microscopy/

From b95163aa687f53c81e1f532b4a860d29217fcf8b Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 12 Nov 2021 12:41:34 -0500
Subject: [PATCH 24/73] Correction of the name of "Fluorescence" modality to
 "Fluorescence microscopy"

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index d63fa81a5f..8997298844 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -82,7 +82,7 @@ A "manual" table is provided to facilitate the review process.
 | Dark-field microscopy                         | DF       |
 | Phase-contrast microscopy                     | PC       |
 | Differential interference contrast microscopy | DIC      |
-| Fluorescence                                  | FLUO     |
+| Fluorescence microscopy                       | FLUO     |
 | Confocal microscopy                           | CONF     |
 | Polarized-light microscopy                    | PLI      |
 | Coherent anti-Stokes Raman spectroscopy       | CARS     |

From 6c595caaeb2dda8850fc0fcf98fbad06a9a04dab Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 12 Nov 2021 18:02:14 -0500
Subject: [PATCH 25/73] Add figure and example for chunk transformation

---
 .../10-microscopy.md                          |  38 +++++++++++++++++-
 ...copy_chunks.png => microscopy_chunks1.png} | Bin
 .../images/microscopy_chunks2.png             | Bin 0 -> 6837 bytes
 3 files changed, 36 insertions(+), 2 deletions(-)
 rename src/04-modality-specific-files/images/{microscopy_chunks.png => microscopy_chunks1.png} (100%)
 create mode 100644 src/04-modality-specific-files/images/microscopy_chunks2.png

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 8997298844..e8ee952319 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -167,7 +167,7 @@ In other cases, the chunks can be different images of the same sample with no ex
 spatial relation between them.
 
 Examples of different chunks configurations can be seen in Figure 1.
-![Figure 1](images/microscopy_chunks.png "Examples of Microscopy chunks")
+![Figure 1](images/microscopy_chunks1.png "Examples of Microscopy chunks")
 
 Figure 1: Examples of chunks configurations.
 
@@ -317,7 +317,41 @@ A "manual" table is provided to facilitate the review process.
 | ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
 | ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                             |
 
-#### Example (`*_<suffix>.json`)
+An example of chunk transformations JSON metadata for `chunk-01` and `chunk-05` of Figure 2
+is shown below:
+
+![Figure 2](images/microscopy_chunks2.png "Example figure for chunks transformations")
+
+Figure 2: Example figure for chunks transformations.
+
+In this example, there is no scaling and `chunk-01` is at the origin.
+`chunk-05` is translated of 5 um in `X` and 3 um in `Y`.
+
+**`*_chunk-01_<modality_suffix>.json`**:
+```JSON
+{
+        "PixelSize": [1, 1],
+        "PixelSizeUnits": "um",
+        "ChunkTransformationMatrix": [[1, 0, 0],
+                                      [0, 1, 0],
+                                      [0, 0, 1]],
+        "ChunkTransformationMatrixAxis": ["X", "Y"]
+}
+```
+
+**`*_chunk-05_<modality_suffix>.json`**:
+```JSON
+{
+        "PixelSize": [1, 1],
+        "PixelSizeUnits": "um",
+        "ChunkTransformationMatrix": [[1, 0, 5],
+                                      [0, 1, 3],
+                                      [0, 0, 1]],
+        "ChunkTransformationMatrixAxis": ["X", "Y"]
+}
+```
+
+#### Example of sidecar JSON file (`*_<suffix>.json`)
 ```JSON
 {
         "Manufacturer": "Hamamatsu",
diff --git a/src/04-modality-specific-files/images/microscopy_chunks.png b/src/04-modality-specific-files/images/microscopy_chunks1.png
similarity index 100%
rename from src/04-modality-specific-files/images/microscopy_chunks.png
rename to src/04-modality-specific-files/images/microscopy_chunks1.png
diff --git a/src/04-modality-specific-files/images/microscopy_chunks2.png b/src/04-modality-specific-files/images/microscopy_chunks2.png
new file mode 100644
index 0000000000000000000000000000000000000000..81f3c721b1094adc0a4415cf26153f966c2f07b7
GIT binary patch
literal 6837
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
W_@Jhgdf|I0<f@7`CRfSy#eV>K%gGA>

literal 0
HcmV?d00001


From f4c16fce9d0a65a0525252baba3754c7d74198f3 Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Sat, 13 Nov 2021 11:56:52 -0500
Subject: [PATCH 26/73] Update src/04-modality-specific-files/10-microscopy.md

Co-authored-by: Julien Cohen-Adad <jcohen@polymtl.ca>
---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index e8ee952319..594f5da000 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -325,7 +325,7 @@ is shown below:
 Figure 2: Example figure for chunks transformations.
 
 In this example, there is no scaling and `chunk-01` is at the origin.
-`chunk-05` is translated of 5 um in `X` and 3 um in `Y`.
+`chunk-05` is translated by 5 um along `X+` and by 3 um along `Y+`.
 
 **`*_chunk-01_<modality_suffix>.json`**:
 ```JSON

From 545b19571991b0f8f8b2377fe8fd87053e916c20 Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Mon, 15 Nov 2021 17:34:05 -0500
Subject: [PATCH 27/73] Update README.md

Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 69fe0beb5f..3ac31ba5ed 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ BIDS currently supports the following data modalities with more to come in the f
 - behavioral
 - physiological
 - PET
-- Microscopy
+- microscopy
 
 # Formatting your data with BIDS
 

From e0771869fc8ec9f583ade948f9dccb91dfa1f4fd Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 15 Nov 2021 18:00:52 -0500
Subject: [PATCH 28/73] Add full OME-NGFF name

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 594f5da000..d540482f11 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -63,8 +63,8 @@ For BIDS, Microscopy raw data MUST be stored in one of the following formats:
 If different from PNG, TIFF or OME-TIFF, the original unprocessed data in the native format MAY be
 stored in the [`/sourcedata` directory](../02-common-principles.md#source-vs-raw-vs-derived-data).
 
-Future versions may extend this list of supported file formats.
-For example with the [OME-NGFF](https://ngff.openmicroscopy.org/latest/) format currently
+Future versions may extend this list of supported file formats, for example with the
+Next-Generation File Formats ([OME-NGFF](https://ngff.openmicroscopy.org/latest/)) currently
 developed by OME as a successor to OME-TIFF for better remote sharing of large datasets.
 
 ### Modality suffixes

From e65b7f46b4f42c05bb2d97447935e286d8aaf8cf Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 15 Nov 2021 18:13:00 -0500
Subject: [PATCH 29/73] Correction

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index d540482f11..46ae4c1289 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -64,8 +64,8 @@ If different from PNG, TIFF or OME-TIFF, the original unprocessed data in the na
 stored in the [`/sourcedata` directory](../02-common-principles.md#source-vs-raw-vs-derived-data).
 
 Future versions may extend this list of supported file formats, for example with the
-Next-Generation File Formats ([OME-NGFF](https://ngff.openmicroscopy.org/latest/)) currently
-developed by OME as a successor to OME-TIFF for better remote sharing of large datasets.
+Next-Generation File Formats currently developed by OME ([OME-NGFF](https://ngff.openmicroscopy.org/latest/))
+as a successor to OME-TIFF for better remote sharing of large datasets.
 
 ### Modality suffixes
 Microscopy data currently support the following imaging modalities:

From bfb027bd37fa09b1bcd8d7f294decb83dbab2364 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 15 Nov 2021 18:23:51 -0500
Subject: [PATCH 30/73] Fix formatting

---
 src/04-modality-specific-files/10-microscopy.md | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 46ae4c1289..a919a465b8 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -104,8 +104,7 @@ Microscopy data and is used to distinguish between different samples from the sa
 The label MUST be unique per subject and is RECOMMENDED to be unique throughout the dataset.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example:
-Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`.
+For example: Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`.
 ```Text
 sub-01/
     microscopy/
@@ -130,9 +129,8 @@ The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity can be used
 image files from the same sample using different stains or antibodies for contrast enhancement.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example:
-One brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three stains
-(`stain-01`, `stain-02`, `stain-03`) in three separate files.
+For example: One brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three
+stains (`stain-01`, `stain-02`, `stain-03`) in three separate files.
 ```Text
 sub-01/
     microscopy/
@@ -178,9 +176,8 @@ Figure 1: Examples of chunks configurations.
 -   f) ordered 3D chunks.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example, as illustrated in Figure 1b:
-Six chunks (`chunk-01` to `chunk-06`) from the same brain sample (`sample-01`) of subject `sub-01`,
-are named:
+For example, as illustrated in Figure 1b: Six chunks (`chunk-01` to `chunk-06`) from the same
+brain sample (`sample-01`) of subject `sub-01`, are named:
 ```Text
 sub-01/
     microscopy/

From 60ecb3d1860648751abfa48eb2b31b72ba0dc645 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 15 Nov 2021 19:15:04 -0500
Subject: [PATCH 31/73] Make BodyPartDetails RECOMMENDED

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index a919a465b8..8ca6ec2a3b 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -276,7 +276,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
-| BodyPartDetails             | OPTIONAL              | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| BodyPartDetails             | RECOMMENDED           | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`).                                                                                                                                                                                                                                                                                                                                                                 |
 | SampleEnvironment           | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

From d93aab94c7e5454317efa06e5899a5518fd91c73 Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Mon, 15 Nov 2021 19:31:46 -0500
Subject: [PATCH 32/73] Update src/04-modality-specific-files/10-microscopy.md

Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 8ca6ec2a3b..5494bfb4ac 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -159,8 +159,8 @@ The [`chunk-<index>`](../99-appendices/09-entities.md#chunk) entity is used when
 regions (2D images or 3D volumes files) of the same physical sample are imaged with different
 fields of view, regardless if they overlap or not.
 
-In some cases, the chunks can be "ordered" and correspond to the displacement of the
-microscope stage, for example.
+In some cases, the chunks can be "ordered" and, for example, correspond to the displacement of the
+microscope stage.
 In other cases, the chunks can be different images of the same sample with no explicit
 spatial relation between them.
 

From c3dad748462a8b5d2b11fcbd107432277dfdf0a8 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 09:54:47 -0500
Subject: [PATCH 33/73] Clarify stain-label and SampleStaining text in Filename
 entities section

---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 5494bfb4ac..51b9d06196 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -146,9 +146,9 @@ stains in separate files from the same sample.
 In the case where a single file contains different staining in each channel, the
 `stain-<label>` is omitted.
 
-Stains or antibodies SHOULD be indicated as appropriate in the `"SampleStaining"`,
-`"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` keys in the sidecar JSON file,
-although the label may be different.
+Stains SHOULD be indicated in the `"SampleStaining"` key in the sidecar JSON file,
+although the label may be different. Description of antibodies SHOULD also be indicated in
+`"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` as appropriate.
 
 If more than one run of the same sample, acquisition and stain are acquired during the same
 session, the [`run-<index>`](../99-appendices/09-entities.md#run) entity MUST be used:

From dca2763b104e17d6190438e981a67dc01985bc87 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 13:55:33 -0500
Subject: [PATCH 34/73] Update examples with real modality_suffix and file
 extensions

---
 .../10-microscopy.md                          | 67 +++++++++----------
 1 file changed, 33 insertions(+), 34 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 51b9d06196..19b932d6d6 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -104,14 +104,15 @@ Microscopy data and is used to distinguish between different samples from the sa
 The label MUST be unique per subject and is RECOMMENDED to be unique throughout the dataset.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example: Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`.
+For example: Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`,
+imaged by scanning electron microscopy (SEM) in PNG format
 ```Text
 sub-01/
     microscopy/
-        sub-01_sample-01_<modality_suffix>.<ext>
-        sub-01_sample-02_<modality_suffix>.<ext>
-        sub-01_sample-03_<modality_suffix>.<ext>
-        sub-01_<modality_suffix>.json
+        sub-01_sample-01_SEM.png
+        sub-01_sample-02_SEM.png
+        sub-01_sample-03_SEM.png
+        sub-01_SEM.json
 ```
 In this example, the JSON metadata is common for all samples of `sub-01`.
 JSON metadata may be defined per subject or per sample as appropriate, as per the
@@ -119,27 +120,28 @@ JSON metadata may be defined per subject or per sample as appropriate, as per th
 
 The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity corresponds to a custom label that
 MAY be used to distinguish a different set of parameters used for acquiring the same modality.
-For example, two images of the same sample acquired with different magnification of 40x and 60x.
-In such case two files could have the following names:
-`sub-01_sample-01_acq-40x_<modality_suffix>.<ext>` and
-`sub-01_sample-01_acq-60x_<modality_suffix>.<ext>`, however the user is free to choose any other
-label as long as they are consistent across subjects and sessions.
+For example, two images of the same sample acquired by bright-field microscopy (BF) in PNG format at
+different magnification of 40x and 60x.
+In such case two files could have the following names: `sub-01_sample-01_acq-40x_BF.png` and
+`sub-01_sample-01_acq-60x_BF.png`, however the user is free to choose any other label as long as
+they are consistent across subjects and sessions.
 
 The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity can be used to distinguish
 image files from the same sample using different stains or antibodies for contrast enhancement.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example: One brain slice (`sample-01`) extracted from subject `sub-01`, imaged with three
-stains (`stain-01`, `stain-02`, `stain-03`) in three separate files.
+For example: One brain slice (`sample-01`) extracted from subject `sub-01` with three
+stains (`stain-01`, `stain-02` and `stain-03`) in three separate files, imaged by selective plane
+illumination microscopy (SPIM) in OME-TIFF format
 ```Text
 sub-01/
     microscopy/
-        sub-01_sample-01_stain-01_<modality_suffix>.<ext>
-        sub-01_sample-01_stain-01_<modality_suffix>.json
-        sub-01_sample-01_stain-02_<modality_suffix>.<ext>
-        sub-01_sample-01_stain-02_<modality_suffix>.json
-        sub-01_sample-01_stain-03_<modality_suffix>.<ext>
-        sub-01_sample-01_stain-03_<modality_suffix>.json
+        sub-01_sample-01_stain-01_SPIM.ome.tif
+        sub-01_sample-01_stain-01_SPIM.json
+        sub-01_sample-01_stain-02_SPIM.ome.tif
+        sub-01_sample-01_stain-02_SPIM.json
+        sub-01_sample-01_stain-03_SPIM.ome.tif
+        sub-01_sample-01_stain-03_SPIM.json
 ```
 In this example, the entity stain is used to distinguish images with different
 stains in separate files from the same sample.
@@ -147,7 +149,8 @@ In the case where a single file contains different staining in each channel, the
 `stain-<label>` is omitted.
 
 Stains SHOULD be indicated in the `"SampleStaining"` key in the sidecar JSON file,
-although the label may be different. Description of antibodies SHOULD also be indicated in
+although the label may be different.
+Description of antibodies SHOULD also be indicated in
 `"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` as appropriate.
 
 If more than one run of the same sample, acquisition and stain are acquired during the same
@@ -176,23 +179,19 @@ Figure 1: Examples of chunks configurations.
 -   f) ordered 3D chunks.
 
 <!--- The following example will be generated automatically with macros after community review. -->
-For example, as illustrated in Figure 1b: Six chunks (`chunk-01` to `chunk-06`) from the same
-brain sample (`sample-01`) of subject `sub-01`, are named:
+For example: Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`)
+of subject `sub-01`, imaged by confocal microscopy (CONF) in OME-TIFF format
 ```Text
 sub-01/
     microscopy/
-        sub-01_sample-01_chunk-01_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-01_<modality_suffix>.json
-        sub-01_sample-01_chunk-02_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-02_<modality_suffix>.json
-        sub-01_sample-01_chunk-03_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-03_<modality_suffix>.json
-        sub-01_sample-01_chunk-04_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-04_<modality_suffix>.json
-        sub-01_sample-01_chunk-05_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-05_<modality_suffix>.json
-        sub-01_sample-01_chunk-06_<modality_suffix>.<ext>
-        sub-01_sample-01_chunk-06_<modality_suffix>.json
+        sub-01_sample-01_chunk-01_CONF.ome.tif
+        sub-01_sample-01_chunk-01_CONF.json
+        sub-01_sample-01_chunk-02_CONF.ome.tif
+        sub-01_sample-01_chunk-02_CONF.json
+        sub-01_sample-01_chunk-03_CONF.ome.tif
+        sub-01_sample-01_chunk-03_CONF.json
+        sub-01_sample-01_chunk-04_CONF.ome.tif
+        sub-01_sample-01_chunk-04_CONF.json
 ```
 The index number can be assigned arbitrarily and, in the case of "ordered" chunks, the chunks'
 positions relative to one another SHOULD be defined by an affine transformation matrix in the JSON
@@ -348,7 +347,7 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 }
 ```
 
-#### Example of sidecar JSON file (`*_<suffix>.json`)
+#### Example of sidecar JSON file (`*_<modality_suffix>.json`)
 ```JSON
 {
         "Manufacturer": "Hamamatsu",

From ac49f2d417ef31b43b5f5bf2370999fae566ffc5 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 14:04:57 -0500
Subject: [PATCH 35/73] Clarify text of chunk-index and chunk transformation

---
 src/04-modality-specific-files/10-microscopy.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 19b932d6d6..497be14173 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -194,8 +194,9 @@ sub-01/
         sub-01_sample-01_chunk-04_CONF.json
 ```
 The index number can be assigned arbitrarily and, in the case of "ordered" chunks, the chunks'
-positions relative to one another SHOULD be defined by an affine transformation matrix in the JSON
-sidecar file of each chunk, as described in [Chunk Transformations](10-microscopy.md#chunk-transformations).
+relative positions (in terms of scaling and translation) SHOULD be defined by an affine
+transformation matrix in the JSON sidecar file of each chunk, as described in
+[Chunk Transformations](10-microscopy.md#chunk-transformations).
 
 In this example, the JSON metadata is different for each chunk of `sub-01_sample-01`.
 JSON metadata may be defined per sample or per chunk as appropriate, as per the
@@ -299,8 +300,8 @@ of the same sample in an implicit coordinate system.
 
 -   The target frame of reference has the same units as the `PixelSizeUnits` metadata.
 
--   The chunk transform is described by 2 metadata fields: a transformation matrix and a
-    description of the axis of the matrix.
+-   The chunk transformation is described by 2 metadata fields: an affine transformation matrix
+    and a description of the axis of the matrix.
 
 -   Other transformations should be described in derivatives.
 
@@ -310,8 +311,8 @@ A "manual" table is provided to facilitate the review process.
 -->
 | **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | ----------------------------- | --------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
-| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                             |
+| ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 affine transformation matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
+| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                                                   |
 
 An example of chunk transformations JSON metadata for `chunk-01` and `chunk-05` of Figure 2
 is shown below:

From ab149a524f6bd965e4f069ec95cee37e6fddfcb3 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 14:22:45 -0500
Subject: [PATCH 36/73] Update BodyPartDetailsOntology as URI

---
 src/04-modality-specific-files/10-microscopy.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 497be14173..eec0b8035a 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -260,7 +260,7 @@ A "manual" table is provided to facilitate the review process.
 | Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
 | NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
 | Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
-| ImageAcquisitionProtocol   | OPTIONAL              | [string][] or [URI][uri] | Description of the image acquisition protocol or URI (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                       |
+| ImageAcquisitionProtocol   | OPTIONAL              | [string][]               | Description of the image acquisition protocol or [URI][uri] (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                |
 | OtherAcquisitionParameters | OPTIONAL              | [string][]               | Description of other relevant image acquisition parameters.                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 #### Sample
@@ -276,8 +276,8 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
-| BodyPartDetails             | RECOMMENDED           | [string][]                             | If needed, additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | If applicable, information about the ontology used for specifying BodyPartDetails (for example: `"UBERON (https://www.ebi.ac.uk/ols/ontologies/uberon)"`).                                                                                                                                                                                                                                                                                                                                                                 |
+| BodyPartDetails             | RECOMMENDED           | [string][]                             | Additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | [URI][uri] of ontology used for BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).                                                                                                                                                                                                                                                                                                                                                                                             |
 | SampleEnvironment           | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
@@ -286,7 +286,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
 | SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | TissueDeformationScaling    | OPTIONAL              | [number][]                             | Estimated deformation of the tissue, given as a percentage of the original tissue size (for examples: for a shrinkage of 3%, the value is `97`; and for an expansion of 100%, the value is `200`).                                                                                                                                                                                                                                                                                                                         |
-| SampleExtractionProtocol    | OPTIONAL              | [string][] or [URI][uri]               | Description of the sample extraction protocol or URI (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                                                                         |
+| SampleExtractionProtocol    | OPTIONAL              | [string][]                             | Description of the sample extraction protocol or [URI][uri] (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                                                                  |
 | SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
 
 #### Chunk Transformations

From fd75df8791fe141dc45d18a9e8673795b0c50297 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 14:40:14 -0500
Subject: [PATCH 37/73] Correction to SampleEnvironment values

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index eec0b8035a..f0a7433aff 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -256,7 +256,7 @@ A "manual" table is provided to facilitate the review process.
 | **Key name**               | **Requirement level** | **Data type**            | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | -------------------------- | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | PixelSize                  | REQUIRED              | [array][] of [numbers][] | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
-| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be millimeter (`"mm"`), micrometer (`"um"`) or nanometer (`"nm"`).                                                                                                                                                                                                                                                                                                                                                          |
+| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be one of: `"mm"` (millimeter), `"um"` (micrometer) or `"nm"` (nanometer).                                                                                                                                                                                                                                                                                                                                                  |
 | Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
 | NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
 | Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
@@ -278,7 +278,7 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
 | BodyPartDetails             | RECOMMENDED           | [string][]                             | Additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | [URI][uri] of ontology used for BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).                                                                                                                                                                                                                                                                                                                                                                                             |
-| SampleEnvironment           | RECOMMENDED           | [string][]                             | Indicate if the sample is imaged `"invivo"`, `"exvivo"` or `"invitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| SampleEnvironment           | RECOMMENDED           | [string][]                             | Environment in which the sample was imaged. MUST be one of: `"in vivo"`, `"ex vivo"` or `"in vitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | SampleStaining              | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`).                                                                                                                                                                                                                                                                                                                                  |

From 3d50db2af46fc5d3b6dd521950e787e472252393 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 16 Nov 2021 14:53:21 -0500
Subject: [PATCH 38/73] Fix md formatting

---
 src/04-modality-specific-files/10-microscopy.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index f0a7433aff..b42f9568b6 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -276,8 +276,8 @@ It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modal
 | **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
-| BodyPartDetails             | RECOMMENDED           | [string][]                             | Additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | [URI][uri] of ontology used for BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).                                                                                                                                                                                                                                                                                                                                                                                             |
+| BodyPartDetails             | RECOMMENDED           | [string][]                             | Additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | [URI][uri] of ontology used for BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).                                                                                                                                                                                                                                                                                                                                                                                                            |
 | SampleEnvironment           | RECOMMENDED           | [string][]                             | Environment in which the sample was imaged. MUST be one of: `"in vivo"`, `"ex vivo"` or `"in vitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
@@ -309,8 +309,8 @@ of the same sample in an implicit coordinate system.
 The following table will be generated automatically with macros after community review.
 A "manual" table is provided to facilitate the review process.
 -->
-| **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| ----------------------------- | --------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| ----------------------------- | --------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 affine transformation matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
 | ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                                                   |
 

From ffa7088e310138d32738a98a285ee26f84eb513b Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 18 Nov 2021 14:26:58 -0500
Subject: [PATCH 39/73] Add mention that "session" is optional

---
 src/04-modality-specific-files/10-microscopy.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index b42f9568b6..02ca82fae1 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -98,6 +98,7 @@ A "manual" table is provided to facilitate the review process.
 In the context of Microscopy, a session ([`ses-<label>`](../99-appendices/09-entities.md#ses))
 can refer to all the acquisitions between the start and the end of an imaging experiment
 for ex vivo imaging or a subject lab visit for biopsy procedure and/or in vivo imaging.
+Consistent with other data types in BIDS, the session entity is optional.
 
 The [`sample-<label>`](../99-appendices/09-entities.md#sample) entity is REQUIRED for
 Microscopy data and is used to distinguish between different samples from the same subject.

From c735f313e6a6423a165341308270efe56a8f3197 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 18 Nov 2021 14:38:05 -0500
Subject: [PATCH 40/73] wording: replace some "can" with "MAY" or "MUST"

---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 02ca82fae1..7ef6fcd6da 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -127,7 +127,7 @@ In such case two files could have the following names: `sub-01_sample-01_acq-40x
 `sub-01_sample-01_acq-60x_BF.png`, however the user is free to choose any other label as long as
 they are consistent across subjects and sessions.
 
-The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity can be used to distinguish
+The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity MAY be used to distinguish
 image files from the same sample using different stains or antibodies for contrast enhancement.
 
 <!--- The following example will be generated automatically with macros after community review. -->
@@ -396,9 +396,9 @@ sub-<label>/
         microscopy/
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>]_photo.<extension>
 ```
-The file `<extension>` for photos can be either `.jpg`, `.png` or `.tif`.
+The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.
 
-The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity can be used to indicate
+The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity MAY be used to indicate
 acquisition of different photos of the same sample.
 <!--- The following example will be generated automatically with macros after community review. -->
 For example:

From 9a23a8bbbf36b34b1f056b861d421c496cbc3b4c Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 18 Nov 2021 14:57:58 -0500
Subject: [PATCH 41/73] Clarification on participants.tsv file

---
 src/04-modality-specific-files/10-microscopy.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 7ef6fcd6da..6f2bc7112a 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -375,8 +375,10 @@ Additional optional columns in `samples.tsv` MAY be used to describe other sampl
 
 ## Recommended participant data (`participants.tsv`)
 
-For Microscopy data, we RECOMMEND to make use of the columns `species`, `strain` and `strain_rrid`
-in the [Participants file](../03-modality-agnostic-files.md#participants-file) when applicable.
+As for other data types in BIDS, the [Participants file](../03-modality-agnostic-files.md#participants-file)
+is RECOMMENDED and MUST contain the column `participant_id`.
+For Microscopy data, we RECOMMEND to also make use of the columns `species`, `strain` and
+`strain_rrid` when applicable.
 
 For example:
 ```Text
@@ -385,6 +387,8 @@ sub-01 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 ```
 
+Additional optional columns in `participants.tsv` MAY be used to describe other subjects' attributes.
+
 ## Photos of the samples (`*_photo.<extension>`)
 Photos of the tissue sample, overview microscopy scans or blockface images from cutting
 MAY be included for visualization of large samples or to indicate the location of chunks

From 0055ad6a3656ecbbcc7e29e61b39a755e68cf32b Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 19 Nov 2021 12:11:32 -0500
Subject: [PATCH 42/73] Correction to stain description in entities.yml

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 src/schema/objects/entities.yaml                | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 6f2bc7112a..6769d71c18 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -151,8 +151,8 @@ In the case where a single file contains different staining in each channel, the
 
 Stains SHOULD be indicated in the `"SampleStaining"` key in the sidecar JSON file,
 although the label may be different.
-Description of antibodies SHOULD also be indicated in
-`"SamplePrimaryAntibodies"` and/or `"SampleSecondaryAntobodies"` as appropriate.
+Description of antibodies SHOULD also be indicated in `"SamplePrimaryAntibodies"`
+and/or `"SampleSecondaryAntobodies"` as appropriate.
 
 If more than one run of the same sample, acquisition and stain are acquired during the same
 session, the [`run-<index>`](../99-appendices/09-entities.md#run) entity MUST be used:
diff --git a/src/schema/objects/entities.yaml b/src/schema/objects/entities.yaml
index 6781e9d16f..9c5d5b1ffb 100644
--- a/src/schema/objects/entities.yaml
+++ b/src/schema/objects/entities.yaml
@@ -309,9 +309,10 @@ stain:
   description: |
     The `stain-<label>` key/pair values can be used to distinguish image files
     from the same sample using different stains or antibodies for contrast enhancement.
-    Stains or antibodies SHOULD be indicated as appropriate in the `SampleStaining`,
-    `SamplePrimaryAntibodies` and/or `SampleSecondaryAntobodies` keys in the JSON file,
+    Stains SHOULD be indicated in the `"SampleStaining"` key in the sidecar JSON file,
     although the label may be different.
+    Description of antibodies SHOULD also be indicated in `"SamplePrimaryAntibodies"`
+    and/or `"SampleSecondaryAntobodies"` as appropriate.
   type: string
   format: label
 subject:

From f067bc492932f702fbde8c463b294085fa2526ad Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Tue, 23 Nov 2021 09:06:05 -0500
Subject: [PATCH 43/73] Update src/02-common-principles.md

Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
---
 src/02-common-principles.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/02-common-principles.md b/src/02-common-principles.md
index 5ec5b9594b..da89aab67c 100644
--- a/src/02-common-principles.md
+++ b/src/02-common-principles.md
@@ -56,7 +56,7 @@ misunderstanding we clarify them here.
     1.  `ieeg` (intracranial electroencephalography)
     1.  `beh` (behavioral)
     1.  `pet` (positron emission tomography)
-    1.  `microscopy`
+    1.  `micr` (microscopy)
 
     Data files are contained in a directory named for the data type.
     In raw datasets, the data type directory is nested inside subject and

From 7edf319cc9637cfe5a1704d8c8fbd2290a8830d2 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 23 Nov 2021 09:14:25 -0500
Subject: [PATCH 44/73] 10-microscpy.md: Change "microscopy" data type for
 "micr"

---
 .../10-microscopy.md                           | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 6769d71c18..0b8b8528db 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -30,11 +30,11 @@ Template:
 ```Text
 sub-<label>/
     [ses-<label>/]
-        microscopy/
+        micr/
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.<extension>
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.json
 ```
-Microscopy data MUST be stored in the `microscopy` directory.
+Microscopy data MUST be stored in the `micr` directory.
 
 ### File formats
 The Microscopy community uses a variety of formats for storing raw data, and there is no single
@@ -109,7 +109,7 @@ For example: Three brain slices (`sample-01` to `sample-03`) extracted from subj
 imaged by scanning electron microscopy (SEM) in PNG format
 ```Text
 sub-01/
-    microscopy/
+    micr/
         sub-01_sample-01_SEM.png
         sub-01_sample-02_SEM.png
         sub-01_sample-03_SEM.png
@@ -136,7 +136,7 @@ stains (`stain-01`, `stain-02` and `stain-03`) in three separate files, imaged b
 illumination microscopy (SPIM) in OME-TIFF format
 ```Text
 sub-01/
-    microscopy/
+    micr/
         sub-01_sample-01_stain-01_SPIM.ome.tif
         sub-01_sample-01_stain-01_SPIM.json
         sub-01_sample-01_stain-02_SPIM.ome.tif
@@ -184,7 +184,7 @@ For example: Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (
 of subject `sub-01`, imaged by confocal microscopy (CONF) in OME-TIFF format
 ```Text
 sub-01/
-    microscopy/
+    micr/
         sub-01_sample-01_chunk-01_CONF.ome.tif
         sub-01_sample-01_chunk-01_CONF.json
         sub-01_sample-01_chunk-02_CONF.ome.tif
@@ -216,11 +216,11 @@ my_dataset/
     derivatives/
         downsampled/
             sub-01/
-                microscopy/
+                micr/
                     sub-01_sample-01_res-4x_TEM.png
                     sub-01_sample-01_res-4x_TEM.json
     sub-01/
-        microscopy/
+        micr/
             sub-01_sample-01_TEM.png
 ```
 See [Preprocessed, coregistered and/or resampled volumes](../05-derivatives/03-imaging.md#preprocessed-coregistered-andor-resampled-volumes)
@@ -397,7 +397,7 @@ in a sample.
 ```Text
 sub-<label>/
     [ses-<label>/]
-        microscopy/
+        micr/
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>]_photo.<extension>
 ```
 The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.
@@ -408,7 +408,7 @@ acquisition of different photos of the same sample.
 For example:
 ```Text
 sub-01/
-    microscopy/
+    micr/
         sub-01_sample-01_acq-1_photo.jpg
         sub-01_sample-01_acq-2_photo.jpg
 ```

From 8414e89a64cc0ed313a0f9b50a9b2b6120fd99d5 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 23 Nov 2021 09:21:05 -0500
Subject: [PATCH 45/73] Update datatype micr.yaml in schema and fix macro in
 entity table

---
 src/99-appendices/04-entity-table.md                      | 2 +-
 src/schema/rules/datatypes/{microscopy.yaml => micr.yaml} | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename src/schema/rules/datatypes/{microscopy.yaml => micr.yaml} (100%)

diff --git a/src/99-appendices/04-entity-table.md b/src/99-appendices/04-entity-table.md
index 92ae16c1e0..a85776f5a2 100644
--- a/src/99-appendices/04-entity-table.md
+++ b/src/99-appendices/04-entity-table.md
@@ -39,4 +39,4 @@ while entity definitions are in [Appendix IX](09-entities.md).
 
 ## Microscopy
 
-{{ MACROS___make_entity_table(datatypes=["microscopy"], auxdatatypes=[]) }}
+{{ MACROS___make_entity_table(datatypes=["micr"], auxdatatypes=[]) }}
diff --git a/src/schema/rules/datatypes/microscopy.yaml b/src/schema/rules/datatypes/micr.yaml
similarity index 100%
rename from src/schema/rules/datatypes/microscopy.yaml
rename to src/schema/rules/datatypes/micr.yaml

From f280aba0225ad9ad1db09b94dc89bc0e9dfaa7f2 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 23 Nov 2021 11:34:40 -0500
Subject: [PATCH 46/73] Clarify usage of samples/participants tsv/json files

---
 .../10-microscopy.md                          | 30 +++++++++++++++----
 1 file changed, 24 insertions(+), 6 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 0b8b8528db..9c5df885eb 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -369,25 +369,43 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 
 ## Required Samples file (`samples.tsv`)
 
-For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file) is REQUIRED.
+For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file) `samples.tsv`
+is REQUIRED and its associated metadata `samples.json` file is RECOMMENDED.
 
-Additional optional columns in `samples.tsv` MAY be used to describe other samples' attributes.
+Additional optional columns MAY be used to describe other samples' attributes.
 
-## Recommended participant data (`participants.tsv`)
+## Recommended Participants file (`participants.tsv`)
 
 As for other data types in BIDS, the [Participants file](../03-modality-agnostic-files.md#participants-file)
-is RECOMMENDED and MUST contain the column `participant_id`.
+`participants.tsv` is RECOMMENDED and MUST contain the column `participant_id`, and its associated
+`participants.json` file is RECOMMENDED as well.
+
 For Microscopy data, we RECOMMEND to also make use of the columns `species`, `strain` and
 `strain_rrid` when applicable.
 
-For example:
+Additional optional columns MAY be used to describe other subjects' attributes.
+
+`participants.tsv` example:
 ```Text
 participant_id species strain strain_rrid
 sub-01 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 ```
 
-Additional optional columns in `participants.tsv` MAY be used to describe other subjects' attributes.
+`participants.json` example:
+```JSON
+{
+    "species": {
+        "Description": "binomial species name from the NCBI Taxonomy (https://www.ncbi.nlm.nih.gov/Taxonomy/Browser/wwwtax.cgi)"
+    },
+    "strain": {
+        "Description": "name of the strain of the species"
+    },
+    "strain_rrid": {
+        "Description": "research resource identifier (RRID) of the strain (https://scicrunch.org/resources/Organisms/search)"
+    }
+}
+```
 
 ## Photos of the samples (`*_photo.<extension>`)
 Photos of the tissue sample, overview microscopy scans or blockface images from cutting

From 1ec7905f87ba58ce29089cd045077da92fd17df7 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 23 Nov 2021 11:35:26 -0500
Subject: [PATCH 47/73] Correction to "ex vivo" in JSON example

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 9c5df885eb..18a8653e67 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -359,7 +359,7 @@ In this example, there is no scaling and `chunk-01` is at the origin.
         "Magnification": 40,
         "BodyPart": "BRAIN",
         "BodyPartDetails": "corpus callosum",
-        "SampleEnvironment": "exvivo",
+        "SampleEnvironment": "ex vivo",
         "SampleFixation": "4% paraformaldehyde, 2% glutaraldehyde",
         "SampleStaining": "LFB",
         "SliceThickness": 5,

From 00abe1deeafd2c355b86b9abdd1e3e967734fa7e Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 23 Nov 2021 15:07:17 -0500
Subject: [PATCH 48/73] Correction samples/participants tsv/json file sections

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 18a8653e67..a2f367d03c 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -370,7 +370,7 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 ## Required Samples file (`samples.tsv`)
 
 For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file) `samples.tsv`
-is REQUIRED and its associated metadata `samples.json` file is RECOMMENDED.
+is REQUIRED and its associated sidecar `samples.json` file is RECOMMENDED.
 
 Additional optional columns MAY be used to describe other samples' attributes.
 
@@ -378,7 +378,7 @@ Additional optional columns MAY be used to describe other samples' attributes.
 
 As for other data types in BIDS, the [Participants file](../03-modality-agnostic-files.md#participants-file)
 `participants.tsv` is RECOMMENDED and MUST contain the column `participant_id`, and its associated
-`participants.json` file is RECOMMENDED as well.
+sidecar `participants.json` file is RECOMMENDED as well.
 
 For Microscopy data, we RECOMMEND to also make use of the columns `species`, `strain` and
 `strain_rrid` when applicable.

From 886fd149e837cf7df61de6ef2904e36dafdfa281 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 29 Nov 2021 17:43:50 -0500
Subject: [PATCH 49/73] Implement macros for examples

---
 .../10-microscopy.md                          | 138 +++++++++++-------
 1 file changed, 85 insertions(+), 53 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index a2f367d03c..92a6334ec5 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -104,17 +104,22 @@ The [`sample-<label>`](../99-appendices/09-entities.md#sample) entity is REQUIRE
 Microscopy data and is used to distinguish between different samples from the same subject.
 The label MUST be unique per subject and is RECOMMENDED to be unique throughout the dataset.
 
-<!--- The following example will be generated automatically with macros after community review. -->
 For example: Three brain slices (`sample-01` to `sample-03`) extracted from subject `sub-01`,
 imaged by scanning electron microscopy (SEM) in PNG format
-```Text
-sub-01/
-    micr/
-        sub-01_sample-01_SEM.png
-        sub-01_sample-02_SEM.png
-        sub-01_sample-03_SEM.png
-        sub-01_SEM.json
-```
+
+{{ MACROS___make_filetree_example(
+   {
+   "sub-01": {
+      "micr": {
+         "sub-01_sample-01_SEM.png": "",
+         "sub-01_sample-02_SEM.png": "",
+         "sub-01_sample-03_SEM.png": "",
+         "sub-01_SEM.json": "",
+         },
+      }
+   }
+) }}
+
 In this example, the JSON metadata is common for all samples of `sub-01`.
 JSON metadata may be defined per subject or per sample as appropriate, as per the
 [inheritance principle](../02-common-principles.md#the-inheritance-principle).
@@ -130,20 +135,25 @@ they are consistent across subjects and sessions.
 The [`stain-<label>`](../99-appendices/09-entities.md#stain) entity MAY be used to distinguish
 image files from the same sample using different stains or antibodies for contrast enhancement.
 
-<!--- The following example will be generated automatically with macros after community review. -->
 For example: One brain slice (`sample-01`) extracted from subject `sub-01` with three
 stains (`stain-01`, `stain-02` and `stain-03`) in three separate files, imaged by selective plane
 illumination microscopy (SPIM) in OME-TIFF format
-```Text
-sub-01/
-    micr/
-        sub-01_sample-01_stain-01_SPIM.ome.tif
-        sub-01_sample-01_stain-01_SPIM.json
-        sub-01_sample-01_stain-02_SPIM.ome.tif
-        sub-01_sample-01_stain-02_SPIM.json
-        sub-01_sample-01_stain-03_SPIM.ome.tif
-        sub-01_sample-01_stain-03_SPIM.json
-```
+
+{{ MACROS___make_filetree_example(
+   {
+   "sub-01": {
+      "micr": {
+         "sub-01_sample-01_stain-01_SPIM.ome.tif": "",
+         "sub-01_sample-01_stain-01_SPIM.json": "",
+         "sub-01_sample-01_stain-02_SPIM.ome.tif": "",
+         "sub-01_sample-01_stain-02_SPIM.json": "",
+         "sub-01_sample-01_stain-03_SPIM.ome.tif": "",
+         "sub-01_sample-01_stain-03_SPIM.json": "",
+         },
+      }
+   }
+) }}
+
 In this example, the entity stain is used to distinguish images with different
 stains in separate files from the same sample.
 In the case where a single file contains different staining in each channel, the
@@ -179,21 +189,26 @@ Figure 1: Examples of chunks configurations.
 -   d) and e) ordered 2D chunks on different 3D planes,
 -   f) ordered 3D chunks.
 
-<!--- The following example will be generated automatically with macros after community review. -->
 For example: Four chunks (`chunk-01` to `chunk-04`) from the same brain sample (`sample-01`)
 of subject `sub-01`, imaged by confocal microscopy (CONF) in OME-TIFF format
-```Text
-sub-01/
-    micr/
-        sub-01_sample-01_chunk-01_CONF.ome.tif
-        sub-01_sample-01_chunk-01_CONF.json
-        sub-01_sample-01_chunk-02_CONF.ome.tif
-        sub-01_sample-01_chunk-02_CONF.json
-        sub-01_sample-01_chunk-03_CONF.ome.tif
-        sub-01_sample-01_chunk-03_CONF.json
-        sub-01_sample-01_chunk-04_CONF.ome.tif
-        sub-01_sample-01_chunk-04_CONF.json
-```
+
+{{ MACROS___make_filetree_example(
+   {
+   "sub-01": {
+      "micr": {
+         "sub-01_sample-01_chunk-01_CONF.ome.tif": "",
+         "sub-01_sample-01_chunk-01_CONF.json": "",
+         "sub-01_sample-01_chunk-02_CONF.ome.tif": "",
+         "sub-01_sample-01_chunk-02_CONF.json": "",
+         "sub-01_sample-01_chunk-03_CONF.ome.tif": "",
+         "sub-01_sample-01_chunk-03_CONF.json": "",
+         "sub-01_sample-01_chunk-04_CONF.ome.tif": "",
+         "sub-01_sample-01_chunk-04_CONF.json": "",
+         },
+      }
+   }
+) }}
+
 The index number can be assigned arbitrarily and, in the case of "ordered" chunks, the chunks'
 relative positions (in terms of scaling and translation) SHOULD be defined by an affine
 transformation matrix in the JSON sidecar file of each chunk, as described in
@@ -209,20 +224,31 @@ only the higher resolution file is present in the raw data.
 Lower resolutions files MUST be placed under the `derivatives` folder and use the
 [`res-<label>`](../99-appendices/09-entities.md#res) entity.
 
-<!--- The following example will be generated automatically with macros after community review. -->
 For example:
-```Text
-my_dataset/
-    derivatives/
-        downsampled/
-            sub-01/
-                micr/
-                    sub-01_sample-01_res-4x_TEM.png
-                    sub-01_sample-01_res-4x_TEM.json
-    sub-01/
-        micr/
-            sub-01_sample-01_TEM.png
-```
+
+{{ MACROS___make_filetree_example(
+   {
+   "my_dataset": {
+      "derivatives": {
+         "downsampled": {
+            "sub-01": {
+               "micr": {
+                  "sub-01_sample-01_res-4x_TEM.png": "",
+                  "sub-01_sample-01_res-4x_TEM.json": "",
+                  },
+               }
+            }
+         },
+      "sub-01": {
+         "micr": {
+            "sub-01_sample-01_TEM.png": "",
+            "sub-01_sample-01_TEM.json": "",
+            },
+         }
+      }
+   }
+) }}
+
 See [Preprocessed, coregistered and/or resampled volumes](../05-derivatives/03-imaging.md#preprocessed-coregistered-andor-resampled-volumes)
 for details.
 
@@ -422,14 +448,20 @@ The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.
 
 The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity MAY be used to indicate
 acquisition of different photos of the same sample.
-<!--- The following example will be generated automatically with macros after community review. -->
+
 For example:
-```Text
-sub-01/
-    micr/
-        sub-01_sample-01_acq-1_photo.jpg
-        sub-01_sample-01_acq-2_photo.jpg
-```
+
+{{ MACROS___make_filetree_example(
+   {
+   "sub-01": {
+      "micr": {
+         "sub-01_sample-01_acq-1_photo.jpg": "",
+         "sub-01_sample-01_acq-2_photo.jpg": "",
+         },
+      }
+   }
+) }}
+
 Below is an example of a spinal cord SEM overview, modified from Zaimi et al., 2018.
 [doi:10.1038/s41598-018-22181-4](https://doi.org/10.1038/s41598-018-22181-4).
 ```Text

From 44e6992261021bf5f4e99d668a3706f34054197e Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 29 Nov 2021 17:47:49 -0500
Subject: [PATCH 50/73] Correction: replace <modality_suffix> by <suffix>

---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 92a6334ec5..a6d32d1587 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -351,7 +351,7 @@ Figure 2: Example figure for chunks transformations.
 In this example, there is no scaling and `chunk-01` is at the origin.
 `chunk-05` is translated by 5 um along `X+` and by 3 um along `Y+`.
 
-**`*_chunk-01_<modality_suffix>.json`**:
+**`*_chunk-01_<suffix>.json`**:
 ```JSON
 {
         "PixelSize": [1, 1],
@@ -363,7 +363,7 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 }
 ```
 
-**`*_chunk-05_<modality_suffix>.json`**:
+**`*_chunk-05_<suffix>.json`**:
 ```JSON
 {
         "PixelSize": [1, 1],
@@ -375,7 +375,7 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 }
 ```
 
-#### Example of sidecar JSON file (`*_<modality_suffix>.json`)
+#### Example of sidecar JSON file (`*_<suffix>.json`)
 ```JSON
 {
         "Manufacturer": "Hamamatsu",

From a7e34a37e78dda6937ed91266dc79a55cd2a1f25 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 30 Nov 2021 17:35:52 -0500
Subject: [PATCH 51/73] Add microscopy to schema/objects/datatypes.yaml

---
 src/schema/objects/datatypes.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/schema/objects/datatypes.yaml b/src/schema/objects/datatypes.yaml
index f17e8feb9f..58c40e39af 100644
--- a/src/schema/objects/datatypes.yaml
+++ b/src/schema/objects/datatypes.yaml
@@ -31,6 +31,9 @@ ieeg:
 meg:
   name: Magnetoencephalography
   description: Magnetoencephalography
+micr:
+  name: Microscopy
+  description: Microscopy
 perf:
   name: Perfusion imaging
   description: |

From c778029e9a2225358bd55fa3221581e39b0eb79d Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 30 Nov 2021 17:38:41 -0500
Subject: [PATCH 52/73] Add microscopy suffixes to schema/objects/suffixes.yaml

---
 src/schema/objects/suffixes.yaml | 71 +++++++++++++++++++++++++++++++-
 1 file changed, 69 insertions(+), 2 deletions(-)

diff --git a/src/schema/objects/suffixes.yaml b/src/schema/objects/suffixes.yaml
index 7449da2470..1552d357d3 100644
--- a/src/schema/objects/suffixes.yaml
+++ b/src/schema/objects/suffixes.yaml
@@ -1,6 +1,14 @@
 ---
 # This file defines valid BIDS file suffixes.
 # For rules regarding how suffixes relate to datatypes, see files in `rules/datatypes/`.
+2PE:
+  name: 2-photon excitation microscopy
+  description: |
+    2-photon excitation microscopy imaging data
+BF:
+  name: Bright-field microscopy
+  description: |
+    Bright-field microscopy imaging data
 Chimap:
   name: Quantitative susceptibility map (QSM)
   description: |
@@ -11,6 +19,22 @@ Chimap:
     Chi maps are REQUIRED to use this suffix regardless of the method used to
     generate them.
   unit: ppm
+CARS:
+  name: Coherent anti-Stokes Raman spectroscopy
+  description: |
+    Coherent anti-Stokes Raman spectroscopy imaging data
+CONF:
+  name: Confocal microscopy
+  description: |
+    Confocal microscopy imaging data
+DIC:
+  name: Differential interference contrast microscopy
+  description: |
+    Differential interference contrast microscopy imaging data
+DF:
+  name: Dark-field microscopy
+  description: |
+    Dark-field microscopy imaging data
 FLAIR:
   name: Fluid attenuated inversion recovery image
   description: |
@@ -31,6 +55,10 @@ FLASH:
     When used in a file collection, it may result in conflicts across filenames of
     different applications.
     **Change:** Removed from suffixes.
+FLUO:
+  name: Fluorescence microscopy
+  description: |
+    Fluorescence microscopy imaging data
 IRT1:
   name: Inversion recovery T1 mapping
   description: |
@@ -66,6 +94,10 @@ MP2RAGE:
     different flip angles and inversion times to create a parametric T1map by
     combining the magnitude and phase images
     ([Marques et al. 2010](https://doi.org/10.1016/j.neuroimage.2009.10.002)).
+MPE:
+  name: Multi-photon excitation microscopy
+  description: |
+    Multi-photon excitation microscopy imaging data
 MPM:
   name: Multi-parametric Mapping
   description: |
@@ -125,6 +157,18 @@ MWFmap:
   unit: arbitrary
   minValue: 0
   maxValue: 100
+NLO:
+  name: Nonlinear optical microscopy
+  description: |
+    Nonlinear optical microscopy imaging data
+OCT:
+  name: Optical coherence tomography
+  description: |
+    Optical coherence tomography imaging data
+PC:
+  name: Phase-contrast microscopy
+  description: |
+    Phase-contrast microscopy imaging data
 PD:
   name: Proton density image
   description: |
@@ -164,6 +208,10 @@ PDw:
     In a gradient-echo acquisition, PD weighting dominates the contrast at long
     repetition and short echo times, and at small flip angles.
   unit: arbitrary
+PLI:
+  name: Polarized-light microscopy
+  description: |
+    Polarized-light microscopy imaging data
 R1map:
   name: Longitudinal relaxation rate image
   description: |
@@ -213,6 +261,18 @@ S0map:
     [the tedana documentation](https://tedana.readthedocs.io/en/latest/\
     approach.html#monoexponential-decay-model-fit).
     S0 maps are RECOMMENDED to use this suffix if derived from an ME-FMRI dataset.
+SEM:
+  name: Scanning electron microscopy
+  description: |
+    Scanning electron microscopy imaging data
+SPIM:
+  name: Selective plane illumination microscopy
+  description: |
+    Selective plane illumination microscopy imaging data
+SR:
+  name: Super-resolution microscopy
+  description: |
+    Super-resolution microscopy imaging data
 T1map:
   name: Longitudinal relaxation time image
   description: |
@@ -347,6 +407,10 @@ TB1map:
     multiplicative factors such that FlipAngle<sub>effective</sub> =
     B1+<sub>intensity</sub>\*FlipAngle<sub>nominal</sub> .
   unit: arbitrary
+TEM:
+  name: Transmission electron microscopy
+  description: |
+    Transmission electron microscopy imaging data
 UNIT1:
   name: Homogeneous (flat) T1-weighted MP2RAGE image
   description: |
@@ -544,8 +608,7 @@ phasediff:
 photo:
   name: Photo File
   description: |
-    Photos of the anatomical landmarks and/or head localization coils
-    (`*_photo.jpg`).
+    Photos of the anatomical landmarks, head localization coils or tissue sample.
 physio:
   name: Physiological recording
   description: |
@@ -558,3 +621,7 @@ stim:
   name: Continuous recording
   description: |
     Continuous measures, such as parameters of a film or audio stimulus.
+uCT:
+  name: Micro-CT
+  description: |
+    Micro-CT imaging data

From 5978a95a129e669007851990a5ae23bb6a6dca11 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 30 Nov 2021 17:40:31 -0500
Subject: [PATCH 53/73] Add microscopy to schema/rules/modalities.yaml

---
 src/schema/rules/modalities.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/schema/rules/modalities.yaml b/src/schema/rules/modalities.yaml
index 9127db93e7..04b24489d7 100644
--- a/src/schema/rules/modalities.yaml
+++ b/src/schema/rules/modalities.yaml
@@ -22,3 +22,6 @@ beh:
 pet:
   datatypes:
   - pet
+micr:
+  datatypes:
+  - micr

From a6d6ece4ec386108badcda88529f4fa2975cb0d7 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 30 Nov 2021 18:03:29 -0500
Subject: [PATCH 54/73] Add make_filename_template MACROs

---
 .../10-microscopy.md                           | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index a6d32d1587..0f9d1b2ac0 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -23,10 +23,7 @@ Further Microscopy datasets are available:
 
 ## Microscopy recording data
 <!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
--->
-Template:
+Intended template:
 ```Text
 sub-<label>/
     [ses-<label>/]
@@ -34,6 +31,12 @@ sub-<label>/
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.<extension>
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.json
 ```
+The current MACRO list ".ome.btf", ".png" and ".tif[.ome]", is it possible to have "<extension>" instead?
+If not, ".tif" and ".ome.tif" should be 2 separate lines but are concatenated as ".tif[.ome]"
+-->
+{{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["TEM", "SEM", "uCT", "BF", "DF",
+"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM"]) }}
+
 Microscopy data MUST be stored in the `micr` directory.
 
 ### File formats
@@ -437,13 +440,18 @@ sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 Photos of the tissue sample, overview microscopy scans or blockface images from cutting
 MAY be included for visualization of large samples or to indicate the location of chunks
 in a sample.
-<!--- The following example will be generated automatically with macros after community review. -->
+<!---
+Intended template:
 ```Text
 sub-<label>/
     [ses-<label>/]
         micr/
             sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>]_photo.<extension>
 ```
+The current MACRO list ".jpg", ".png" and ".tif", is it possible to have one line with "<extension>" instead?
+-->
+{{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["photo"]) }}
+
 The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.
 
 The [`acq-<label>`](../99-appendices/09-entities.md#acq) entity MAY be used to indicate

From de73132fa2345406d2e539d4927f73b2e9968990 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Tue, 30 Nov 2021 18:16:19 -0500
Subject: [PATCH 55/73] Add make_suffix_table MACRO

---
 .../10-microscopy.md                          | 30 +++++++++++++++++--
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 0f9d1b2ac0..3313a02116 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -73,9 +73,8 @@ as a successor to OME-TIFF for better remote sharing of large datasets.
 ### Modality suffixes
 Microscopy data currently support the following imaging modalities:
 <!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
--->
+Intended table:
+
 | **Name**                                      | `suffix` |
 | --------------------------------------------- | -------- |
 | Transmission electron microscopy              | TEM      |
@@ -96,6 +95,31 @@ A "manual" table is provided to facilitate the review process.
 | Optical coherence tomography                  | OCT      |
 | Selective plane illumination microscopy       | SPIM     |
 
+Can we remove the "Description" column of the table in the MACRO?
+-->
+{{ MACROS___make_suffix_table(
+      [
+         "TEM",
+         "SEM",
+         "uCT",
+         "BF",
+         "DF",
+         "PC",
+         "DIC",
+         "FLUO",
+         "CONF",
+         "PLI",
+         "CARS",
+         "2PE",
+         "MPE",
+         "SR",
+         "NLO",
+         "OCT",
+         "SPIM",
+      ]
+   )
+}}
+
 ### Filename entities
 
 In the context of Microscopy, a session ([`ses-<label>`](../99-appendices/09-entities.md#ses))

From 68b91286d0daf6f932c20290c92196b5131c1137 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 15:31:54 -0500
Subject: [PATCH 56/73] Add microscopy json metadata to
 schema/objects/metadata.yaml

---
 src/schema/objects/metadata.yaml | 185 ++++++++++++++++++++++++++++++-
 1 file changed, 183 insertions(+), 2 deletions(-)

diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index 873f69a357..2f9e1fb43f 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -250,8 +250,19 @@ BodyPart:
   name: BodyPart
   description: |
     Body part of the organ / body region scanned.
-    Corresponds to DICOM Tag 0018, 0015 `Body Part Examined`.
   type: string
+BodyPartDetails:
+  name: BodyPartDetails
+  description: |
+    Additional details about body part or location (for example: `"corpus callosum"`).
+  type: string
+BodyPartDetailsOntology:
+  name: BodyPartDetailsOntology
+  description: |
+    [URI](/02-common-principles.html#uniform-resource-indicator) of ontology used for
+    BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).
+  type: string
+  format: uri
 BolusCutOffDelayTime:
   name: BolusCutOffDelayTime
   description: |
@@ -323,6 +334,33 @@ CellType:
     Values SHOULD come from the
     [cell ontology](http://obofoundry.org/ontology/cl.html).
   type: string
+ChunkTransformationMatrix:
+  name: ChunkTransformationMatrix
+  description: |
+    3x3 or 4x4 affine transformation matrix describing spatial chunk transformation,
+    for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]`
+    in 2D for 2x and 3x scaling along the first and second axis respectively; or
+    `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x
+    scaling along the second and third axis respectively).
+    Note that non-spatial dimensions like time and channel are not included in the
+    transformation matrix.
+  type: array
+  minItems: 3
+  maxItems: 4
+  items:
+    type: array
+    minItems: 3
+    maxItems: 4
+    items:
+      type: number
+ChunkTransformationMatrixAxis:
+  name: ChunkTransformationMatrixAxis
+  description: |
+    Describe the axis of the ChunkTransformationMatrix
+    (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`).
+  type: array
+  items:
+    type: string
 Code:
   name: Code
   description: |
@@ -1081,6 +1119,13 @@ HowToAcknowledge:
     This field can also be used to define a publication that should be cited in
     publications that use the dataset.
   type: string
+ImageAcquisitionProtocol:
+  name: ImageAcquisitionProtocol
+  description: |
+    Description of the image acquisition protocol or
+    [URI](/02-common-principles.html#uniform-resource-indicator)
+    (for example from [protocols.io](https://www.protocols.io/)).
+  type: string
 ImageDecayCorrected:
   name: ImageDecayCorrected
   description: |
@@ -1093,6 +1138,12 @@ ImageDecayCorrectionTime:
     TimeZero in the default unit seconds.
   type: number
   unit: s
+Immersion:
+  name: Immersion
+  description: |
+    Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent
+    with the `Immersion` OME metadata field.
+  type: string
 InfusionRadioactivity:
   name: InfusionRadioactivity
   description: |
@@ -1524,6 +1575,12 @@ MagneticFieldStrength:
     Nominal field strength of MR magnet in Tesla.
     Corresponds to DICOM Tag 0018, 0087 `Magnetic Field Strength`.
   type: number
+Magnification:
+  name: Magnification
+  description: |
+    Lens magnification (for example: `40`). If the file format is OME-TIFF,
+    the value MUST be consistent with the `NominalMagnification` OME metadata field.
+  type: number
 Manual:
   name: Manual
   description: |
@@ -1708,12 +1765,23 @@ NumberShots:
   - type: array
     items:
       type: number
+NumericalAperture:
+  name: NumericalAperture
+  description: |
+    Lens numerical aperture (for example: `1.4`). If the file format is OME-TIFF,
+    the value MUST be consistent with the `LensNA` OME metadata field.
+  type: number
 OperatingSystem:
   name: OperatingSystem
   description: |
     Operating system used to run the stimuli presentation software
     (for formatting recommendations, see examples below this table).
   type: string
+OtherAcquisitionParameters:
+  name: OtherAcquisitionParameters
+  description: |
+    Description of other relevant image acquisition parameters.
+  type: string
 PASLType:
   name: PASLType
   description: |
@@ -1821,6 +1889,31 @@ PhaseEncodingDirection:
   - i-
   - j-
   - k-
+PixelSize:
+  name: PixelSize
+  description: |
+    A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]`
+    or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the
+    depth.
+    If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`,
+    `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in
+    `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and
+    `PhysicalSizeZunit` OME fields.
+  type: array
+  minItems: 2
+  maxItems: 3
+  items:
+    type: number
+PixelSizeUnits:
+  name: PixelSizeUnits
+  description: |
+    Unit format of the specified `PixelSize`. MUST be one of: `"mm"` (millimeter), `"um"`
+    (micrometer) or `"nm"` (nanometer).
+  type: string
+  enum:
+  - mm
+  - um
+  - nm
 PlasmaAvail:
   name: PlasmaAvail
   description: |
@@ -2096,6 +2189,40 @@ SEEGChannelCount:
     Number of SEEG channels.
   type: integer
   minimum: 0
+SampleEmbedding:
+  name: SampleEmbedding
+  description: |
+    Description of the tissue sample embedding (for example: `"Epoxy resin"`).
+  type: string
+SampleEnvironment:
+  name: SampleEnvironment
+  description: |
+    Environment in which the sample was imaged. MUST be one of: `"in vivo"`, `"ex vivo"`
+    or `"in vitro"`.
+  type: string
+  enum:
+  - in vivo
+  - ex vivo
+  - in vitro
+SampleExtractionInstitution:
+  name: SampleExtractionInstitution
+  description: |
+    The name of the institution in charge of the extraction of the sample,
+    if different from the institution in charge of the equipment that produced the image.
+  type: string
+SampleExtractionProtocol:
+  name: SampleExtractionProtocol
+  description: |
+    Description of the sample extraction protocol or
+    [URI](/02-common-principles.html#uniform-resource-indicator)
+    (for example from [protocols.io](https://www.protocols.io/)).
+  type: string
+SampleFixation:
+  name: SampleFixation
+  description: |
+    Description of the tissue sample fixation
+    (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).
+  type: string
 SampleOrigin:
   name: SampleOrigin
   description: |
@@ -2112,6 +2239,47 @@ SampleOrigin:
   - bile
   - amniotic fluid
   - other biospecimen
+SamplePrimaryAntibody:
+  name: SamplePrimaryAntibody
+  description: |
+    Description(s) of the primary antibody used for immunostaining.
+    Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue
+    number of a commercial antibody.
+    For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the
+    host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or
+    `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`).
+    MAY be an array of strings if different antibodies are used in each channel of the file.
+  anyOf:
+  - type: string
+  - type: array
+    items:
+      type: string
+SampleSecondaryAntibody:
+  name: SampleSecondaryAntibody
+  description: |
+    Description(s) of the secondary antibody used for immunostaining.
+    Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue
+    number of a commercial antibody.
+    For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the
+    host-animal and immunogen used (for examples: `"RRID:AB_228322"` or
+    `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`).
+    MAY be an array of strings if different antibodies are used in each channel of the file.
+  anyOf:
+  - type: string
+  - type: array
+    items:
+      type: string
+SampleStaining:
+  name: SampleStaining
+  description: |
+    Description(s) of the tissue sample staining (for example: `"Osmium"`).
+    MAY be an array of strings if different stains are used in each channel of the file
+    (for example: `["LFB", "PLP"]`).
+  anyOf:
+  - type: string
+  - type: array
+    items:
+      type: string
 SamplingFrequency:
   name: SamplingFrequency
   description: |
@@ -2220,6 +2388,12 @@ SliceEncodingDirection:
   - i-
   - j-
   - k-
+SliceThickness:
+  name: SliceThickness
+  description: |
+    Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).
+  type: number
+  unit: um
 SliceTiming:
   name: SliceTiming
   description: |
@@ -2423,7 +2597,6 @@ StationName:
   name: StationName
   description: |
     Institution defined name of the machine that produced the measurements.
-    Corresponds to DICOM Tag 0008, 1010 `Station Name`.
   type: string
 StimulusPresentation:
   name: StimulusPresentation
@@ -2482,6 +2655,14 @@ TimeZero:
     This should be equal to `InjectionStart` or `ScanStart`.
   type: string
   pattern: ^(?:2[0-3]|[01][0-9]):[0-5][0-9]:[0-5][0-9]$
+TissueDeformationScaling:
+  name: TissueDeformationScaling
+  description: |
+    Estimated deformation of the tissue, given as a percentage of the original
+    tissue size (for examples: for a shrinkage of 3%, the value is `97`;
+    and for an expansion of 100%, the value is `200`).
+  type: number
+  exclusiveMinimum: 0
 TissueOrigin:
   name: TissueOrigin
   description: |

From a1bd2a05ae87fdf15b21c899b889d4f2edf7bd0f Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 15:38:27 -0500
Subject: [PATCH 57/73] Add metadata table macros to 10-microscopy.md

---
 .../10-microscopy.md                          | 108 ++++++++----------
 1 file changed, 48 insertions(+), 60 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 3313a02116..871cb71a68 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -97,6 +97,7 @@ Intended table:
 
 Can we remove the "Description" column of the table in the MACRO?
 -->
+
 {{ MACROS___make_suffix_table(
       [
          "TEM",
@@ -284,64 +285,53 @@ for details.
 Microscopy data MUST be described by metadata fields, stored in sidecar JSON files.
 
 #### Device Hardware
-<!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
 
-Note: For `StationName`, we removed "Corresponds to DICOM Tag 0008, 1010 `Station Name`." from the description.
-It will require changes to `src/schema/metatata/StationName.yaml` and `src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md`.
--->
-| **Key name**              | **Requirement level** | **Data type** | **Description**                                                                                                                                                                                           |
-| ------------------------- | --------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Manufacturer              | RECOMMENDED           | [string][]    | Manufacturer of the equipment that produced the measurements.                                                                                                                                             |
-| ManufacturersModelName    | RECOMMENDED           | [string][]    | Manufacturer’s model name of the equipment that produced the measurements.                                                                                                                                |
-| DeviceSerialNumber        | RECOMMENDED           | [string][]    | The serial number of the equipment that produced the measurements. A pseudonym can also be used to prevent the equipment from being identifiable, so long as each pseudonym is unique within the dataset. |
-| StationName               | RECOMMENDED           | [string][]    | Institution defined name of the machine that produced the measurements.                                                                                                                                   |
-| SoftwareVersions          | RECOMMENDED           | [string][]    | Manufacturer’s designation of software version of the equipment that produced the measurements.                                                                                                           |
-| InstitutionName           | RECOMMENDED           | [string][]    | The name of the institution in charge of the equipment that produced the measurements.                                                                                                                    |
-| InstitutionAddress        | RECOMMENDED           | [string][]    | The address of the institution in charge of the equipment that produced the measurements.                                                                                                                 |
-| InstitutionDepartmentName | RECOMMENDED           | [string][]    | The department in the institution in charge of the equipment that produced the measurements.                                                                                                              |
+{{ MACROS___make_metadata_table(
+   {
+      "Manufacturer": "RECOMMENDED",
+      "ManufacturersModelName": "RECOMMENDED",
+      "DeviceSerialNumber": "RECOMMENDED",
+      "StationName": "RECOMMENDED",
+      "SoftwareVersions": "RECOMMENDED",
+      "InstitutionName": "RECOMMENDED",
+      "InstitutionAddress": "RECOMMENDED",
+      "InstitutionalDepartmentName": "RECOMMENDED",
+   }
+) }}
 
 #### Image Acquisition
-<!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
--->
-| **Key name**               | **Requirement level** | **Data type**            | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| -------------------------- | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| PixelSize                  | REQUIRED              | [array][] of [numbers][] | A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]` or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the depth. If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`, `PhysicalSizeY` and `PhysicalSizeZ` OME metadata fields, after converting in `PixelSizeUnits` according to `PhysicalSizeXunit`, `PhysicalSizeYunit` and `PhysicalSizeZunit` OME fields. |
-| PixelSizeUnits             | REQUIRED              | [string][]               | Unit format of the specified PixelSize. MUST be one of: `"mm"` (millimeter), `"um"` (micrometer) or `"nm"` (nanometer).                                                                                                                                                                                                                                                                                                                                                  |
-| Immersion                  | OPTIONAL              | [string][]               | Lens immersion medium. If the file format is OME-TIFF, the value MUST be consistent with the `"Immersion"` OME metadata field.                                                                                                                                                                                                                                                                                                                                           |
-| NumericalAperture          | OPTIONAL              | [number][]               | Lens numerical aperture (for example, `1.4`). If the file format is OME-TIFF, the value MUST be consistent with the `"LensNA"` OME metadata field.                                                                                                                                                                                                                                                                                                                       |
-| Magnification              | OPTIONAL              | [number][]               | Lens magnification (for example, `40`) If the file format is OME-TIFF, the value MUST be consistent with the `"NominalMagnification"` OME metadata field.                                                                                                                                                                                                                                                                                                                |
-| ImageAcquisitionProtocol   | OPTIONAL              | [string][]               | Description of the image acquisition protocol or [URI][uri] (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                |
-| OtherAcquisitionParameters | OPTIONAL              | [string][]               | Description of other relevant image acquisition parameters.                                                                                                                                                                                                                                                                                                                                                                                                              |
+
+{{ MACROS___make_metadata_table(
+   {
+      "PixelSize": "REQUIRED",
+      "PixelSizeUnits": "REQUIRED",
+      "Immersion": "OPTIONAL",
+      "NumericalAperture": "OPTIONAL",
+      "Magnification": "OPTIONAL",
+      "ImageAcquisitionProtocol": "OPTIONAL",
+      "OtherAcquisitionParameters": "OPTIONAL",
+   }
+) }}
 
 #### Sample
-<!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
 
-Note: For `BodyPart`, we removed: "Corresponds to DICOM Tag 0018, 0015 `Body Part Examined`. For example: `"BRAIN"`."
-from the description, and replace with
-"from [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN".`)".
-It will require changes to `src/schema/metatata/BodyPart.yaml` and `src/04-modality-specific-files/09-positron-emission-tomography.md`.
--->
-| **Key name**                | **Requirement level** | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| --------------------------- | --------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| BodyPart                    | RECOMMENDED           | [string][]                             | Body part of the organ / body region scanned. From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example: `"BRAIN"`)".                                                                                                                                                                                                                                                                                                                         |
-| BodyPartDetails             | RECOMMENDED           | [string][]                             | Additional details about body part or location (for example: `"corpus callosum"`).                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| BodyPartDetailsOntology     | OPTIONAL              | [string][]                             | [URI][uri] of ontology used for BodyPartDetails (for example: `"https://www.ebi.ac.uk/ols/ontologies/uberon"`).                                                                                                                                                                                                                                                                                                                                                                                                            |
-| SampleEnvironment           | RECOMMENDED           | [string][]                             | Environment in which the sample was imaged. MUST be one of: `"in vivo"`, `"ex vivo"` or `"in vitro"`.                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| SampleEmbedding             | OPTIONAL              | [string][]                             | Description of the tissue sample embedding (for example: `"Epoxy resin"`).                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| SampleFixation              | OPTIONAL              | [string][]                             | Description of the tissue sample fixation (for example: `"4% paraformaldehyde, 2% glutaraldehyde"`).                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| SampleStaining              | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the tissue sample staining (for example: `"Osmium"`). MAY be an array of strings if different stains are used in each channel of the file (for example: `["LFB", "PLP"]`).                                                                                                                                                                                                                                                                                                                                  |
-| SamplePrimaryAntibody       | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the primary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`). MAY be an array of strings if different antibodies are used in each channel of the file. |
-| SampleSecondaryAntibody     | RECOMMENDED           | [string][] or [array][] of [strings][] | Description of the secondary antibody used for immunostaining. Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalogue number of a commercial antibody. For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the host-animal and immunogen used (for examples: `"RRID:AB_228322"` or `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`). MAY be an array of strings if different antibodies are used in each channel of the file.        |
-| SliceThickness              | OPTIONAL              | [number]                               | Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| TissueDeformationScaling    | OPTIONAL              | [number][]                             | Estimated deformation of the tissue, given as a percentage of the original tissue size (for examples: for a shrinkage of 3%, the value is `97`; and for an expansion of 100%, the value is `200`).                                                                                                                                                                                                                                                                                                                         |
-| SampleExtractionProtocol    | OPTIONAL              | [string][]                             | Description of the sample extraction protocol or [URI][uri] (for example from [protocols.io](https://www.protocols.io/)).                                                                                                                                                                                                                                                                                                                                                                                                  |
-| SampleExtractionInstitution | OPTIONAL              | [string][]                             | The name of the institution in charge of the extraction of the sample, if different from the institution in charge of the equipment that produced the image.                                                                                                                                                                                                                                                                                                                                                               |
+{{ MACROS___make_metadata_table(
+   {
+      "BodyPart": ("RECOMMENDED", "From [DICOM Body Part Examined](http://dicom.nema.org/medical/dicom/current/output/chtml/part16/chapter_L.html#chapter_L) (for example `\"BRAIN\"`)."),
+      "BodyPartDetails": "RECOMMENDED",
+      "BodyPartDetailsOntology": "OPTIONAL",
+      "SampleEnvironment": "RECOMMENDED",
+      "SampleEmbedding": "OPTIONAL",
+      "SampleFixation": "OPTIONAL",
+      "SampleStaining": "RECOMMENDED",
+      "SamplePrimaryAntibody": "RECOMMENDED",
+      "SampleSecondaryAntibody": "RECOMMENDED",
+      "SliceThickness": "OPTIONAL",
+      "TissueDeformationScaling": "OPTIONAL",
+      "SampleExtractionProtocol": "OPTIONAL",
+      "SampleExtractionInstitution": "OPTIONAL",
+   }
+) }}
 
 #### Chunk Transformations
 
@@ -359,14 +349,12 @@ of the same sample in an implicit coordinate system.
 
 -   Other transformations should be described in derivatives.
 
-<!---
-The following table will be generated automatically with macros after community review.
-A "manual" table is provided to facilitate the review process.
--->
-| **Key name**                  | **Requirement level**                               | **Data type**                          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| ----------------------------- | --------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ChunkTransformationMatrix     | RECOMMENDED if `<chunk-index>` is used in filenames | [array][] of [arrays][] of [numbers][] | 3x3 or 4x4 affine transformation matrix describing spatial chunk transformation, for 2D and 3D respectively (for examples: `[[2, 0, 0], [0, 3, 0], [0, 0, 1]]` in 2D for 2x and 3x scaling along the first and second axis respectively or `[[1, 0, 0, 0], [0, 2, 0, 0], [0, 0, 3, 0], [0, 0, 0, 1]]` in 3D for 2x and 3x scaling along the second and third axis respectively). Note that non-spatial dimensions like time and channel are not included in the transformation matrix. |
-| ChunkTransformationMatrixAxis | REQUIRED if `ChunkTransformationMatrix` is present  | [arrays][] of [strings][]              | Describe the axis of the ChunkTransformationMatrix (for examples: `["X", "Y"]` or `["Z", "Y", "X"]`)                                                                                                                                                                                                                                                                                                                                                                                   |
+{{ MACROS___make_metadata_table(
+   {
+      "ChunkTransformationMatrix": "RECOMMENDED if `<chunk-index>` is used in filenames",
+      "ChunkTransformationMatrixAxis": "REQUIRED if `ChunkTransformationMatrix` is present",
+   }
+) }}
 
 An example of chunk transformations JSON metadata for `chunk-01` and `chunk-05` of Figure 2
 is shown below:

From 202d507e5814d0d8fea4da21cd7a60d89f14b061 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 15:39:48 -0500
Subject: [PATCH 58/73] Adjust StationName definition in
 01-magnetic-resonance-imaging-data.md

---
 .../01-magnetic-resonance-imaging-data.md                       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md b/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md
index aa5c2c7f12..3185b86191 100644
--- a/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md
+++ b/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md
@@ -17,7 +17,7 @@ by Ben Inglis.
       "Manufacturer": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 0070 `Manufacturer`."),
       "ManufacturersModelName": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 1090 `Manufacturers Model Name`."),
       "DeviceSerialNumber": ("RECOMMENDED", "Corresponds to DICOM Tag 0018, 1000 `DeviceSerialNumber`."),
-      "StationName": "RECOMMENDED",
+      "StationName": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 1010 `Station Name`."),
       "SoftwareVersions": ("RECOMMENDED", "Corresponds to DICOM Tag 0018, 1020 `Software Versions`."),
       "HardcopyDeviceSoftwareVersion": "DEPRECATED",
       "MagneticFieldStrength": "RECOMMENDED, but REQUIRED for Arterial Spin Labeling",

From 9376c7284fa2a4bf6b674edb9bcfb4e64bbca8dc Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 15:40:44 -0500
Subject: [PATCH 59/73] Adjust BodyPart definition in
 09-positron-emission-tomography.md

---
 .../09-positron-emission-tomography.md                          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/09-positron-emission-tomography.md b/src/04-modality-specific-files/09-positron-emission-tomography.md
index 134512b81d..70e6d77f18 100644
--- a/src/04-modality-specific-files/09-positron-emission-tomography.md
+++ b/src/04-modality-specific-files/09-positron-emission-tomography.md
@@ -143,7 +143,7 @@ which we divide into several categories:
       "InstitutionName": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 0080 `InstitutionName`."),
       "InstitutionAddress": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 0081 `InstitutionAddress`."),
       "InstitutionalDepartmentName": ("RECOMMENDED", "Corresponds to DICOM Tag 0008, 1040 `Institutional Department Name`."),
-      "BodyPart": "RECOMMENDED",
+      "BodyPart": ("RECOMMENDED", "Corresponds to DICOM Tag 0018, 0015 `Body Part Examined`."),
    }
 ) }}
 

From f13ed591833f61e9f00d0f9c853b12594025c041 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 17:58:15 -0500
Subject: [PATCH 60/73] Change "recording data" for "imaging data"

---
 src/04-modality-specific-files/10-microscopy.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 871cb71a68..dd21fb74de 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -21,7 +21,7 @@ Further Microscopy datasets are available:
 -   In PNG format:  [`data_axondeepseg_sem`](https://doi.org/10.5281/zenodo.5498378)
 -   In OME-TIFF format: [`Broca's Area Light-Sheet Microscopy`](https://doi.org/10.5281/zenodo.5517223)
 
-## Microscopy recording data
+## Microscopy imaging data
 <!---
 Intended template:
 ```Text

From 48d9ba9833104cafff61a3abe8b10570bb068de8 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 2 Dec 2021 18:03:54 -0500
Subject: [PATCH 61/73] Remove unused link definitions

---
 src/04-modality-specific-files/10-microscopy.md | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index dd21fb74de..821fb3e0a3 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -490,11 +490,3 @@ Below is an example of a spinal cord SEM overview, modified from Zaimi et al., 2
 ![SEM overview](images/microscopy_sem_overview.jpg "SEM overview")
 
 <!-- Link Definitions -->
-
-[strings]: https://www.w3schools.com/js/js_json_datatypes.asp
-[string]: https://www.w3schools.com/js/js_json_datatypes.asp
-[numbers]: https://www.w3schools.com/js/js_json_datatypes.asp
-[number]: https://www.w3schools.com/js/js_json_datatypes.asp
-[arrays]: https://www.w3schools.com/js/js_json_arrays.asp
-[array]: https://www.w3schools.com/js/js_json_arrays.asp
-[uri]: ../02-common-principles.md#uniform-resource-indicator

From 877e92016d32f570403f436bf9b1b6b27f9b43a2 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 3 Dec 2021 10:45:09 -0500
Subject: [PATCH 62/73] Clarify samples/participants sections

---
 src/04-modality-specific-files/10-microscopy.md | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 821fb3e0a3..42ff9b75d5 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -408,21 +408,18 @@ In this example, there is no scaling and `chunk-01` is at the origin.
 }
 ```
 
-## Required Samples file (`samples.tsv`)
+## Required Samples file
 
-For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file) `samples.tsv`
-is REQUIRED and its associated sidecar `samples.json` file is RECOMMENDED.
+For Microscopy data, the [Samples file](../03-modality-agnostic-files.md#samples-file)
+`samples.tsv` is REQUIRED and its associated sidecar `samples.json` file is RECOMMENDED.
 
 Additional optional columns MAY be used to describe other samples' attributes.
 
-## Recommended Participants file (`participants.tsv`)
+## Recommended Participants data
 
-As for other data types in BIDS, the [Participants file](../03-modality-agnostic-files.md#participants-file)
-`participants.tsv` is RECOMMENDED and MUST contain the column `participant_id`, and its associated
-sidecar `participants.json` file is RECOMMENDED as well.
-
-For Microscopy data, we RECOMMEND to also make use of the columns `species`, `strain` and
-`strain_rrid` when applicable.
+For Microscopy data, we RECOMMEND to make use of the columns `species`, `strain` and
+`strain_rrid` in the [Participants file](../03-modality-agnostic-files.md#participants-file)
+when applicable.
 
 Additional optional columns MAY be used to describe other subjects' attributes.
 

From 79091c9a40baf915d4e11fe009bfc66b02b66234 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Fri, 3 Dec 2021 15:18:12 -0500
Subject: [PATCH 63/73] schema/objects/metadata.yaml: Apply review suggestions
 and add restrictions

---
 src/schema/objects/metadata.yaml | 30 +++++++++++++++++++++++-------
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index 2f9e1fb43f..a2a6d9d955 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -344,15 +344,25 @@ ChunkTransformationMatrix:
     scaling along the second and third axis respectively).
     Note that non-spatial dimensions like time and channel are not included in the
     transformation matrix.
-  type: array
-  minItems: 3
-  maxItems: 4
-  items:
-    type: array
+  anyOf:
+  - type: array
     minItems: 3
+    maxItems: 3
+    items:
+      type: array
+      minItems: 3
+      maxItems: 3
+      tems:
+       type: number
+  - type: array
+    minItems: 4
     maxItems: 4
     items:
-      type: number
+      type: array
+      minItems: 4
+      maxItems: 4
+      items:
+        type: number
 ChunkTransformationMatrixAxis:
   name: ChunkTransformationMatrixAxis
   description: |
@@ -361,6 +371,8 @@ ChunkTransformationMatrixAxis:
   type: array
   items:
     type: string
+    minItems: 2
+    maxItems: 3
 Code:
   name: Code
   description: |
@@ -1581,6 +1593,7 @@ Magnification:
     Lens magnification (for example: `40`). If the file format is OME-TIFF,
     the value MUST be consistent with the `NominalMagnification` OME metadata field.
   type: number
+  exclusiveMinimum: 0
 Manual:
   name: Manual
   description: |
@@ -1771,6 +1784,7 @@ NumericalAperture:
     Lens numerical aperture (for example: `1.4`). If the file format is OME-TIFF,
     the value MUST be consistent with the `LensNA` OME metadata field.
   type: number
+  exclusiveMinimum: 0
 OperatingSystem:
   name: OperatingSystem
   description: |
@@ -1892,7 +1906,7 @@ PhaseEncodingDirection:
 PixelSize:
   name: PixelSize
   description: |
-    A 2- or 3-number array of the physical size of a pixel, either`[PixelSizeX, PixelSizeY]`
+    A 2- or 3-number array of the physical size of a pixel, either `[PixelSizeX, PixelSizeY]`
     or `[PixelSizeX, PixelSizeY, PixelSizeZ]`, where X is the width, Y the height and Z the
     depth.
     If the file format is OME-TIFF, these values need to be consistent with `PhysicalSizeX`,
@@ -1904,6 +1918,7 @@ PixelSize:
   maxItems: 3
   items:
     type: number
+    minimum: 0
 PixelSizeUnits:
   name: PixelSizeUnits
   description: |
@@ -2394,6 +2409,7 @@ SliceThickness:
     Slice thickness of the tissue sample in the unit micrometers (`"um"`) (for example: `5`).
   type: number
   unit: um
+  exclusiveMinimum: 0
 SliceTiming:
   name: SliceTiming
   description: |

From 7b63f8eaaf1da2ab5f30e2a5a4236938b502ba15 Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Fri, 3 Dec 2021 15:23:08 -0500
Subject: [PATCH 64/73] Address BEP031 macro requests (#945)

* Allow table-specific numbers of duplicate suffixes/exts to combine.

* Only combine compressed versions of extensions.
---
 .../10-microscopy.md                          |  4 +-
 tools/schemacode/schema.py                    | 12 +++---
 tools/schemacode/utils.py                     | 38 +++++++++++--------
 3 files changed, 31 insertions(+), 23 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 42ff9b75d5..ceb1190f09 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -35,7 +35,7 @@ The current MACRO list ".ome.btf", ".png" and ".tif[.ome]", is it possible to ha
 If not, ".tif" and ".ome.tif" should be 2 separate lines but are concatenated as ".tif[.ome]"
 -->
 {{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["TEM", "SEM", "uCT", "BF", "DF",
-"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM"]) }}
+"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM"], n_dupes_to_combine=3) }}
 
 Microscopy data MUST be stored in the `micr` directory.
 
@@ -459,7 +459,7 @@ sub-<label>/
 ```
 The current MACRO list ".jpg", ".png" and ".tif", is it possible to have one line with "<extension>" instead?
 -->
-{{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["photo"]) }}
+{{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["photo"], n_dupes_to_combine=3) }}
 
 The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.
 
diff --git a/tools/schemacode/schema.py b/tools/schemacode/schema.py
index f4ec722d69..9547c8ddd8 100644
--- a/tools/schemacode/schema.py
+++ b/tools/schemacode/schema.py
@@ -226,15 +226,17 @@ def _add_entity(filename_template, entity_pattern, requirement_level):
     return filename_template
 
 
-def make_filename_template(schema, **kwargs):
-    """Create codeblocks containing example filename patterns for a given
-    datatype.
+def make_filename_template(schema, n_dupes_to_combine=6, **kwargs):
+    """Create codeblocks containing example filename patterns for a given datatype.
 
     Parameters
     ----------
     schema : dict
         The schema object, which is a dictionary with nested dictionaries and
         lists stored within it.
+    n_dupes_to_combine : int
+        The minimum number of suffixes/extensions to combine in the template as
+        <suffix>/<extension>.
     kwargs : dict
         Keyword arguments used to filter the schema.
         Example kwargs that may be used include: "suffixes", "datatypes",
@@ -298,7 +300,7 @@ def make_filename_template(schema, **kwargs):
 
             # In cases of large numbers of suffixes,
             # we use the "suffix" variable and expect a table later in the spec
-            if len(group["suffixes"]) > 5:
+            if len(group["suffixes"]) >= n_dupes_to_combine:
                 suffix = "_<suffix>"
                 string += suffix
                 strings = [string]
@@ -314,7 +316,7 @@ def make_filename_template(schema, **kwargs):
                 ext if ext != "*" else ".<extension>" for ext in extensions
             ]
             extensions = utils.combine_extensions(extensions)
-            if len(extensions) > 5:
+            if len(extensions) >= n_dupes_to_combine:
                 # Combine exts when there are many, but keep JSON separate
                 if ".json" in extensions:
                     extensions = [".<extension>", ".json"]
diff --git a/tools/schemacode/utils.py b/tools/schemacode/utils.py
index d6d95b6fc3..aa0676b1fe 100644
--- a/tools/schemacode/utils.py
+++ b/tools/schemacode/utils.py
@@ -23,29 +23,35 @@ def get_schema_path():
 def combine_extensions(lst):
     """Combine extensions with their compressed versions in a list.
 
-    This is a basic solution to combining extensions with their
-    compressed versions in a list. Something more robust could
-    be written in the future.
+    Valid combinations are hardcoded in the function,
+    since some extensions look like compressed versions of one another, but are not.
 
     Parameters
     ----------
     lst : list of str
+        Raw list of extensions.
+
+    Returns
+    -------
+    new_lst : list of str
+        List of extensions, with compressed and uncompressed versions of the same extension
+        combined.
     """
+    COMPRESSION_EXTENSIONS = [".gz"]
+
     new_lst = []
-    # First, sort by length
-    lst = sorted(lst, key=len)
+    items_to_remove = []
     for item in lst:
-        temp_lst = new_lst[:]
-
-        item_found = False
-        for j, new_item in enumerate(temp_lst):
-            if new_item in item:
-                temp_item = new_item + "[" + item.replace(new_item, "", 1) + "]"
-                new_lst[j] = temp_item
-                item_found = True
-
-        if not item_found:
-            new_lst.append(item)
+        for ext in COMPRESSION_EXTENSIONS:
+            if item.endswith(ext) and item.replace(ext, "") in lst:
+                temp_item = item.replace(ext, "") + "[" + ext + "]"
+                new_lst.append(temp_item)
+                items_to_remove.append(item)
+                items_to_remove.append(item.replace(ext, ""))
+                continue
+
+    items_to_add = [item for item in lst if item not in items_to_remove]
+    new_lst += items_to_add
 
     return new_lst
 

From c303ce4d14aab3e9703ffce9e5150ff9765624a0 Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Fri, 3 Dec 2021 15:26:31 -0500
Subject: [PATCH 65/73] Update src/schema/objects/metadata.yaml

Co-authored-by: Taylor Salo <tsalo006@fiu.edu>
---
 src/schema/objects/metadata.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index a2a6d9d955..14c13ce6f3 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -352,8 +352,8 @@ ChunkTransformationMatrix:
       type: array
       minItems: 3
       maxItems: 3
-      tems:
-       type: number
+      items:
+        type: number
   - type: array
     minItems: 4
     maxItems: 4

From 8691bfaf6cfa95f4e09a14f3ddb4d2247886555b Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 6 Dec 2021 15:02:12 -0500
Subject: [PATCH 66/73] Update names of bids-examples datasets

---
 src/04-modality-specific-files/10-microscopy.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index ceb1190f09..92c251286d 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -13,8 +13,8 @@ update to 'https://github.com/bids-standard/bids-examples' when examples are mer
 -->
 Microscopy datasets formatted using this specification are available on the
 [BIDS examples repository](https://github.com/neuropoly/bids-examples/tree/bep031)
-(`microscopy_SEM001` and `microscopy_SPIM001`) and can be used for practical
-guidance when curating a new dataset.
+(`micr_SEM` and `micr_SPIM`) and can be used for practical guidance when curating
+a new dataset.
 
 Further Microscopy datasets are available:
 

From c264f7489a38865d022bfc1dada6578640839ae5 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 6 Dec 2021 15:18:13 -0500
Subject: [PATCH 67/73] Remove comments about filename templates

---
 .../10-microscopy.md                          | 26 +++----------------
 1 file changed, 3 insertions(+), 23 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 92c251286d..0f6b1a06ba 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -22,20 +22,9 @@ Further Microscopy datasets are available:
 -   In OME-TIFF format: [`Broca's Area Light-Sheet Microscopy`](https://doi.org/10.5281/zenodo.5517223)
 
 ## Microscopy imaging data
-<!---
-Intended template:
-```Text
-sub-<label>/
-    [ses-<label>/]
-        micr/
-            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.<extension>
-            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>][_stain-<label>][_run-<index>][_chunk-<index>]_<suffix>.json
-```
-The current MACRO list ".ome.btf", ".png" and ".tif[.ome]", is it possible to have "<extension>" instead?
-If not, ".tif" and ".ome.tif" should be 2 separate lines but are concatenated as ".tif[.ome]"
--->
+
 {{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["TEM", "SEM", "uCT", "BF", "DF",
-"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM"], n_dupes_to_combine=3) }}
+"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM"], n_dupes_to_combine=4) }}
 
 Microscopy data MUST be stored in the `micr` directory.
 
@@ -449,16 +438,7 @@ sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
 Photos of the tissue sample, overview microscopy scans or blockface images from cutting
 MAY be included for visualization of large samples or to indicate the location of chunks
 in a sample.
-<!---
-Intended template:
-```Text
-sub-<label>/
-    [ses-<label>/]
-        micr/
-            sub-<label>[_ses-<label>]_sample-<label>[_acq-<label>]_photo.<extension>
-```
-The current MACRO list ".jpg", ".png" and ".tif", is it possible to have one line with "<extension>" instead?
--->
+
 {{ MACROS___make_filename_template(datatypes=["micr"], suffixes=["photo"], n_dupes_to_combine=3) }}
 
 The file `<extension>` for photos MUST be either `.jpg`, `.png` or `.tif`.

From fbea1317cd583aef0c58576e0ddc17f461fddb44 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 6 Dec 2021 15:20:55 -0500
Subject: [PATCH 68/73] Remove comments for modality suffix table

---
 .../10-microscopy.md                          | 25 -------------------
 1 file changed, 25 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index 0f6b1a06ba..a3ecf69d63 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -61,31 +61,6 @@ as a successor to OME-TIFF for better remote sharing of large datasets.
 
 ### Modality suffixes
 Microscopy data currently support the following imaging modalities:
-<!---
-Intended table:
-
-| **Name**                                      | `suffix` |
-| --------------------------------------------- | -------- |
-| Transmission electron microscopy              | TEM      |
-| Scanning electron microscopy                  | SEM      |
-| Micro-CT                                      | uCT      |
-| Bright-field microscopy                       | BF       |
-| Dark-field microscopy                         | DF       |
-| Phase-contrast microscopy                     | PC       |
-| Differential interference contrast microscopy | DIC      |
-| Fluorescence microscopy                       | FLUO     |
-| Confocal microscopy                           | CONF     |
-| Polarized-light microscopy                    | PLI      |
-| Coherent anti-Stokes Raman spectroscopy       | CARS     |
-| 2-photon excitation microscopy                | 2PE      |
-| Multi-photon excitation microscopy            | MPE      |
-| Super-resolution microscopy                   | SR       |
-| Nonlinear optical microscopy                  | NLO      |
-| Optical coherence tomography                  | OCT      |
-| Selective plane illumination microscopy       | SPIM     |
-
-Can we remove the "Description" column of the table in the MACRO?
--->
 
 {{ MACROS___make_suffix_table(
       [

From 7f3b35d7f440e755a3e58d339a43368c7ae37e2f Mon Sep 17 00:00:00 2001
From: mariehbourget <54086142+mariehbourget@users.noreply.github.com>
Date: Mon, 20 Dec 2021 13:27:37 -0500
Subject: [PATCH 69/73] Apply suggestions from code review

Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
---
 src/04-modality-specific-files/10-microscopy.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index a3ecf69d63..cb4e4bc762 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -37,12 +37,12 @@ The OME-TIFF file allows for multi-page TIFF files to store multiple image plane
 multi-resolution pyramidal tiled images. An OME-XML data block is also embedded inside the
 file’s header.
 
-The BIDS standard accepts microscopy data in different file formats to accommodate datasets
+The BIDS standard accepts microscopy data in a number of file formats to accommodate datasets
 stored in 2D image formats and whole-slide imaging formats, to accommodate lossless and lossy
 compression, and to avoid unnecessary conversions of the original data from a non-tiled to a
 tiled format, or vice-versa.
 
-For BIDS, Microscopy raw data MUST be stored in one of the following formats:
+Microscopy raw data MUST be stored in one of the following formats:
 
 -   [Portable Network Graphics](http://www.libpng.org/pub/png/) (`.png`)
 
@@ -89,7 +89,7 @@ Microscopy data currently support the following imaging modalities:
 
 In the context of Microscopy, a session ([`ses-<label>`](../99-appendices/09-entities.md#ses))
 can refer to all the acquisitions between the start and the end of an imaging experiment
-for ex vivo imaging or a subject lab visit for biopsy procedure and/or in vivo imaging.
+for ex vivo imaging, or a subject lab visit for biopsy procedure and/or in vivo imaging.
 Consistent with other data types in BIDS, the session entity is optional.
 
 The [`sample-<label>`](../99-appendices/09-entities.md#sample) entity is REQUIRED for

From ed19ddd46b03c253f0aac40aa3db05225db0b17b Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 13 Jan 2022 09:37:18 -0500
Subject: [PATCH 70/73] Update BIDS-examples link and remove commented lines

---
 src/04-modality-specific-files/10-microscopy.md | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/src/04-modality-specific-files/10-microscopy.md b/src/04-modality-specific-files/10-microscopy.md
index cb4e4bc762..efb1542c52 100644
--- a/src/04-modality-specific-files/10-microscopy.md
+++ b/src/04-modality-specific-files/10-microscopy.md
@@ -7,14 +7,9 @@ Please see [Citing BIDS](../01-introduction.md#citing-bids)
 on how to appropriately credit this extension when referring to it in the
 context of the academic literature.
 
-<!---
-The following link is temporary and points to the bep031 branch of bids-examples,
-update to 'https://github.com/bids-standard/bids-examples' when examples are merged.
--->
 Microscopy datasets formatted using this specification are available on the
-[BIDS examples repository](https://github.com/neuropoly/bids-examples/tree/bep031)
-(`micr_SEM` and `micr_SPIM`) and can be used for practical guidance when curating
-a new dataset.
+[BIDS examples repository](https://github.com/bids-standard/bids-examples#microscopy-datasets)
+and can be used for practical guidance when curating a new dataset.
 
 Further Microscopy datasets are available:
 

From 8062d19b5923fc015b03fa554ff08c8b92f20e35 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 13 Jan 2022 10:35:23 -0500
Subject: [PATCH 71/73] Add "samples" to
 src/schema/objects/top_level_files.yaml

---
 src/schema/objects/top_level_files.yaml | 31 +++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/src/schema/objects/top_level_files.yaml b/src/schema/objects/top_level_files.yaml
index 12e1823472..88c9204d58 100644
--- a/src/schema/objects/top_level_files.yaml
+++ b/src/schema/objects/top_level_files.yaml
@@ -77,3 +77,34 @@ participants:
 
     Throughout BIDS you can indicate missing values with `n/a` (for "not
     available").
+
+samples:
+  name: Sample Information
+  description: |
+    The purpose of this file is to describe properties of samples, indicated by the `sample` entity.
+    This file is REQUIRED if `sample-<label>` is present in any file name within the dataset.
+    If this file exists, it MUST contain the three following columns:
+
+    -   `sample_id`: MUST consist of `sample-<label>` values identifying one row
+        for each sample
+
+    -   `participant_id`: MUST consist of `sub-<label>`
+
+    -   `sample_type`: MUST consist of sample type values, either `cell line`, `in vitro differentiated cells`,
+        `primary cell`, `cell-free sample`, `cloning host`, `tissue`, `whole organisms`, `organoid` or
+        `technical sample` from [ENCODE Biosample Type](https://www.encodeproject.org/profiles/biosample_type)
+
+    Other optional columns MAY be used to describe the samples.
+    Each sample MUST be described by one and only one row.
+
+    Commonly used *optional* columns in `samples.tsv` files are `pathology` and
+    `derived_from`. We RECOMMEND to make use of these columns, and in case that
+    you do use them, we RECOMMEND to use the following values for them:
+
+    -   `pathology`: string value describing the pathology of the sample or type of control.
+        When different from `healthy`, pathology SHOULD be specified in `samples.tsv`.
+        The pathology MAY instead be specified in [Sessions files](06-longitudinal-and-multi-site-studies.md#sessions-file)
+        in case it changes over time.
+
+    -   `derived_from`: `sample-<label>` key/value pair from which a sample is derived from,
+        for example a slice of tissue (`sample-02`) derived from a block of tissue (`sample-01`)

From 5a58d60cf7966f98431ac6e004c56d028a41bbd2 Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Thu, 13 Jan 2022 10:42:11 -0500
Subject: [PATCH 72/73] Formatting in src/schema/objects/top_level_files.yaml

---
 src/schema/objects/top_level_files.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/schema/objects/top_level_files.yaml b/src/schema/objects/top_level_files.yaml
index 88c9204d58..0277d43fbd 100644
--- a/src/schema/objects/top_level_files.yaml
+++ b/src/schema/objects/top_level_files.yaml
@@ -103,8 +103,8 @@ samples:
 
     -   `pathology`: string value describing the pathology of the sample or type of control.
         When different from `healthy`, pathology SHOULD be specified in `samples.tsv`.
-        The pathology MAY instead be specified in [Sessions files](06-longitudinal-and-multi-site-studies.md#sessions-file)
-        in case it changes over time.
+        The pathology MAY instead be specified in
+        [Sessions files](06-longitudinal-and-multi-site-studies.md#sessions-file) in case it changes over time.
 
     -   `derived_from`: `sample-<label>` key/value pair from which a sample is derived from,
         for example a slice of tissue (`sample-02`) derived from a block of tissue (`sample-01`)

From b0b144b1003dc4c2dee9f9a1a1a943b08238402a Mon Sep 17 00:00:00 2001
From: Marie-Helene Bourget <bourgetmarieh@gmail.com>
Date: Mon, 17 Jan 2022 09:16:18 -0500
Subject: [PATCH 73/73] Fix link to sessions file in
 src/schema/objects/top_level_files.yaml

---
 src/schema/objects/top_level_files.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/schema/objects/top_level_files.yaml b/src/schema/objects/top_level_files.yaml
index 0277d43fbd..79eab838c0 100644
--- a/src/schema/objects/top_level_files.yaml
+++ b/src/schema/objects/top_level_files.yaml
@@ -104,7 +104,7 @@ samples:
     -   `pathology`: string value describing the pathology of the sample or type of control.
         When different from `healthy`, pathology SHOULD be specified in `samples.tsv`.
         The pathology MAY instead be specified in
-        [Sessions files](06-longitudinal-and-multi-site-studies.md#sessions-file) in case it changes over time.
+        [Sessions files](../03-modality-agnostic-files.md#sessions-file) in case it changes over time.
 
     -   `derived_from`: `sample-<label>` key/value pair from which a sample is derived from,
         for example a slice of tissue (`sample-02`) derived from a block of tissue (`sample-01`)