././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0718036 pymeasure-0.16.0/0000755000175100017510000000000015203313301013245 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/.flake80000644000175100017510000000021615203313266014431 0ustar00runnerrunner[flake8] exclude = .git,__pycache__,docs/conf.py,build,dist max-line-length = 100 max-complexity = 15 per-file-ignores = __init__.py:F401 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/AGENTS.md0000644000175100017510000001315615203313266014570 0ustar00runnerrunner# AGENTS.md This file provides guidance to agents when working with code in this repository. ## Project Stack - Language: Python 3.9+ - Build system: setuptools with setuptools_scm - Package manager: pip - Dependencies: numpy, pandas, pint, pyvisa, pyserial, pyqtgraph, qtpy - Testing: pytest with pytest-qt, pytest-cov, pyvisa-sim ## Build/Lint/Test Commands - Install in development mode: `pip install -e .` - Run tests: `python -m pytest` or `pytest` - Run tests with coverage: `python -m pytest --cov=pymeasure` - Lint with flake8: `flake8` (max-line-length=100, max-complexity=15) - Format with black: `black .` (line-length=100) - Sort imports with isort: `isort .` - Run single test: `python -m pytest tests/test_file.py::test_function` ## Code Style Guidelines - Line length: 100 characters (flake8, black, ruff) - Physical units are handled with Pint library - Comments are only used to describe non-obvious reasons (why) - Follow PEP8 style guide and PEP257 docstring conventions - Function and variable names should be lower case with underscores as needed to separate words - CamelCase should only be used for class names, unless working with Qt, where its use is common - It is allowed but not required to use the black code formatter - You may add type hints as you see fit, adhering to the guidelines set out in the typing package - For typing use Python types like dict, list, if applicable ### Instrument drivers - Use property creators (control, measurement, setting) for instrument parameters - Getter and setter functions are discouraged, since properties provide a more fluid experience - Given the extensive tools available for defining properties, these types of properties are preferred - Instrument classes inherit from pymeasure.instruments.Instrument - Adapters handle communication (VISA, Serial, Prologix, etc.) - Use ProtocolAdapter with expected_protocol for testing instrument communication #### File Organization - Place instruments in the directory corresponding to the manufacturer - Use lowercase for all filenames to distinguish packages from CamelCase Python classes - Update the manufacturer's __init__.py file to import instruments - Add test files in the corresponding tests/instruments/manufacturer/ directory - Add documentation files in docs/api/instruments/manufacturer/ #### Property Creator Details - Use validators (strict_range, truncated_range, strict_discrete_set, truncated_discrete_set) to restrict property values - Use map_values parameter when instrument commands require non-physical values - Implement boolean properties using maps with True/False values - Use set_process and get_process functions for value transformations (e.g., unit conversions) - Use preprocess_reply for string processing of device responses - Enable check_get_errors/check_set_errors for instruments that report errors #### Channel Implementation - For instruments with fewer than 16 channels, use Instrument.ChannelCreator for explicit channel declaration - For instruments with more than 16 channels, use Instrument.MultiChannelCreator - Channels should inherit from the Channel class and use Channel-specific property creators - Use the {ch} placeholder in command strings for automatic channel ID insertion - Override insert_id method for channels with fixed command prefixes #### Testing Instruments - Write protocol tests using expected_protocol context manager for communication verification - Create both protocol tests (without hardware) and device tests (with hardware) - Use pytest fixtures for device tests to enable easy configuration and skipping - Name device test files with "_with_device" suffix to distinguish them from protocol tests ### Measurement and GUI - Procedures inherit from pymeasure.experiment.Procedure ## Documentation Standards - PyMeasure documents code using reStructuredText and the Sphinx documentation generator - All functions, classes, and methods should be documented in the code using a docstring - Descriptive and specific docstrings are important for users to quickly understand properties and methods - Use triple-quoted strings (`"""`) to delimit docstrings - Start with one short summary line in imperative voice, with a period at the end - Optionally, after a blank line, include more detailed information - For functions and methods, add documentation on their parameters using the reStructuredText docstring format - For properties, start them with "Control", "Get", "Measure", or "Set" to indicate the kind of property - Add type and information about validators (if applicable) at the end of the summary line - Example property docstring: `"""Control the voltage in Volts (float strictly from -1 to 1)."""` - Docstrings should only contain information relevant for using a property/method, not internal details ## Core Architecture Patterns - Instruments use Adapter pattern for communication abstraction - Procedures define experimental workflows with startup/execute/shutdown - Workers run procedures in separate threads - Results stored in CSV format with automatic unit parsing - GUI uses Qt (via QtPy) with Manager/Experiment pattern - Parameters and Metadata system for procedure configuration ## Non-Obvious Conventions - Instrument control() method strips command formatting and uses format specifiers - Dynamic properties allow runtime parameter changes using naming convention - Channel system uses ChannelCreator class for hierarchical instrument interfaces - ProtocolAdapter for testing without hardware - Validators throw ValueError exceptions for invalid inputs - Instrument properties can have error checking (check_set_errors, check_get_errors) - DATA_COLUMNS parsing automatically detects Pint units in parentheses ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/AUTHORS.txt0000644000175100017510000000325015203313266015145 0ustar00runnerrunnerColin Jermain Graham Rowlands Minh-Hai Nguyen Guen Prawiro-Atmodjo Tim van Boxtel Davide Spirito Marcos Guimaraes Ghislain Antony Vaillant Ben Feinstein Neal Reynolds Christoph Buchner Julian Dlugosch Sylvain Karlen Joseph Mittelstaedt Troy Fox Vikram Sekar Casper Schippers Sumatran Tiger Michael Schneider Dennis Feng Stefano Pirotta Moritz Jung Richard Schlitz Manuel Zahn Mikhaël Myara Domenic Prete Mathieu Jeannin Paul Goulain John McMaster Dominik Kriegner Jonathan Larochelle Dominic Caron Mathieu Plante Michele Sardo Steven Siegl Benjamin Klebel-Knobloch Markus Röleke Demetra Adrahtas Dan McDonald Hud Wahab Nicola Corna Robert Eckelmann Sam Condon Andreas Maeder Bastian Leykauf Matthew Delaney Marco von Rosenberg Jack Van Sambeek JC Arbelbide Florian Jünger Benedikt Moneke Asaf Yagoda Fabio Garzetti Daniel Schmeer Mike Manno David Sanchez Sanchez Andres Ruz-Nieto Carlos Martinez Scott Candey Tom Verbeure Juraj Jašík Max Herbold Alexander Wichers Ashok Bruno Robert Roos Sebastien Weber Sebastian Neusch Felix Thouin Ulrich Sauter Guus Kuiper Bernhard Lang Armindo Pinto Frank Wu Heinz-Alexander Fütterer Per-Olof Svensson Karl Komierowski Alec Vercruysse Matthew Zenaldin Canyon Clark Connor Carr Jannis Kleine-Schönepauck Douwe den Blanken Till Zürner J. A. Wilcox Nick James Kirkby Konrad Gralher David Ziliak David Sun Kévin Petit Félix Thouin Orion Smedley Samuel Simpson Isha Sharma Dawid Maślanka Felix Thouin Emmanuel Ferdman Johannes Rothmayr Fred Gillard Dimitrios Simatos Dongkai Pan Julian van Doorn Jörg Wunsch Falk Korndörfer Henk Vergone Sergey Ilyev Alfons Schuck Lucas Braud Patrick Mischke Sung-Chieh Chiu Przemysław Piróg Haotian Zhang Maduka Ariyasiri ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/CHANGES.rst0000644000175100017510000013745415203313266015077 0ustar00runnerrunnerVersion 0.16.0 (2026-05-20) =========================== Main items of this new release: - Add support for Python 3.13 - Change policy to allow type hints (added already to instruments core) - 25 new instruments - :code:`Instrument.control` does not apply :code:`get_process` to a returned list anymore, only to a single value. Use :code:`get_process_list` parameter instead for processing a list of values. - Improve implementation of Keithley 2400, with some changes in functionality. Legacy implementation has been kept as :code:`Keithley2400Legacy`. Removed ------- - Remove support for Python 3.8 - Remove deprecated Adapter and Instrument parameters :code:`preprocess_reply`, :code:`query_delay` - Remove deprecated Adapter methods :code:`ask`, :code:`values`, and :code:`binary_values` - Remove deprecated Telnet and VXI adapters Deprecated ---------- - Replace :code:`sensitvity` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`sensitivity` - Replace :code:`filer_synchronous` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`filter_synchronous` - Replace :code:`query_operation_mode` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`operation_mode` property - Replace :code:`query_system_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`system_settings` property - Replace :code:`interrupt_sequence_command` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`interrupt_sequence` - Replace :code:`sequence_program_listing` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`query_sequence_program` - Replace :code:`digital_out_enable_data` attribute of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`digital_output_enable` - Replace :code:`query_output_waveform` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`output_waveform_settings` property - Replace :code:`query_measurement_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`measurement_range_settings` property - Replace :code:`query_response_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`response_settings` property - Replace :code:`query_data_output_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`data_output_settings` property - Replace :code:`query_io_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`io_settings` property - Replace :code:`calibration_init` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`init_calibration` - Replace :code:`calibration_store_factor` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`store_calibration_factor` Instruments ----------- - Add Aculight Argos OPO laser system (@BenediktBurger, #1046) - Add Agilent 33250A waveform generator (@PeterPirog, #1425) - Add Agilent B2980 electrometer series (@Falk3579, #1296) - Add Agilent E5270B (@Falk3579, #1340, #1359, #1365) - Add Agilent N8975A noise figure analyzer (@Falk3579, #1397) - Add FormFactor Velox Waferprobers (@Falk3579, #1385) - Add Ilxlightwave ldp3811 pulsed current source (@fg-lumentum, #1367) - Add Keithley 2510 Sourcemeter (@fg-lumentum, #1239, #1333) - Add Keithley 4200A-SCS (@Falk3579, #1332) - Add Keysight 81160A Pulse Function Arbitrary Noise Generator (@ilev-sergey, #1250) - Add Keysight PNAs (@Falk3579, #1356) - Add LakeShore 3xx temperature controllers (@DF9AS, #1334) - Add Oxford Instruments Mercury Intelligent Temperature Controller (@JAW90, #1198) - Add PTW Diamentor DAP dosemeter (@Falk3579, #1302, #1449) - Add PTW UNIDOS dosemeters (@Falk3579, #1279, #1442) - Add Santec TSL-500 series tunable laser with TSL-550 and TSL-770 (@fg-lumentum, #1253, #1390) - Add Siglent oscilloscope SDS1000XHD (@lucasbraud, #1325) - Add Spellman XRV high voltage power supplies (@Falk3579, #1329, #1440) - Add SRS LDC500Series (@fg-lumentum, #1278, #1346) - Add Thorlabs mbx series (@fg-lumentum, #1361) - Fix Temptronic tests (@ilev-sergey, #1277) - Fix HP3478A: use :code:`write_binary_values()` to request calibration data (@dl8dtl, #1263) - Fix docstring in Keithley4200 (@Falk3579, #1339) - Fix parameter ranges for Agilent33220A (@Patschke, #1342) - Fix Keithley 2000 :code:`voltage_nplc` and :code:`enable_filter` (@d-el, @chieh0517, #1360, #1393) - Fix :code:`read` of Racal 1992 (@BenediktBurger, #1355) - Update old docstrings to new style (@BenediktBurger, #1247, #1243) - Update Advantest R624X driver with sequence builders, hardware-verified fixes, and documentation (@wichers, #1408) - Update Agilent channels (@BenediktBurger, #1089) - Update Agilent 33500 properties and add SCPI mixin (@ilev-sergey, #1245, #1246) - Update Agilent 34450 with :code:`local()` and protocol tests (@Falk3579, #1427, #1436) - Update Agilent 4284A with new correction functionality (@Falk3579, #1304) - Update Agilent B1500 with SPGU and CMU module support and new documentation (@ilev-sergey, #1380, #1344, #1412) - Update Agilent B1500 SMU class to inherit from :code:`Channel` (@ilev-sergey, #1387) - Update Agilent E4408B with SCPIMixin and new docstrings (@BenediktBurger, #1438) - Update Agilent E4980A with tests (@Falk3579, #1300) - Update Keithley 2400 with a major rework (@fg-lumentum, #1347) - Update Keithley 2450's docstring to inform that buffer handling is currently unsupported (@dsimat, #1238) - Update Keithley 6221 with delta mode (@panasee, #1242) - Update MS464xB docstrings (@Falk3579, #1352) - Update SRS 860 with better method names (@panasee, #1289) - Update SRS 860 min ampl (@chieh0517, #1426) - Update Yokogawa Aq6370 series with sensitivity control sweep status, and with connections and traces (@fg-lumentum, @BenediktBurger, #1138, #1234, #1286, #1354) Instruments mechanics --------------------- - Add :code:`_write_bytes()` and :code:`_read_bytes()` for Prologix adapter (@dl8dtl, #1259) - Add handling of SerialException in :code:`list_resources()` (@hvegh, #1287) - Add :code:`get_process_list` and make it dynamic (@BenediktBurger, @Falk3579, #1291, #1313, #1315) - Add typing to :code:`expected_protocol`, adapters, and :code:`Instrument` (@BenediktBurger, #1084, #1331) - Add concrete hint to property creators in docstring list (@BenediktBurger, #1281) - Add SCPI mixin test for devices (@fg-lumentum, #1391) - Update Prologix documentation (@dl8dtl, #1272) Automation ---------- - Add qtpy dependency for Qt version shimming (@Benbriel, #1285) - Add :code:`description` to :code:`Parameters` (@Benbriel, #1211) - Update procedures to emit results in batches (@jvdoorn, #1256) - Replace numeric constants by respective Qt enum values (@dl8dtl, #1265) - Use :code:`np.frombuffer` for removed :code:`np.fromstring(sep="")` (@BenediktBurger, #1330) - Update BooleanParameter to accept numpy.bool (@Falk3579, #1373) - In workers, check should_stop after :code:`startup()` before `execute()` (@breakU1, #1445) - Add vector parameter input (@Falk3579, #1376, #1377, #1382) - Replace :code:`load_module()` by :code:`exec_module()` (@Falk3579, #1415) - Add file size checking to :code:`Results.data` property to skip reading file if data hasn't changed. (@mcdo0486, #1429) GUI --- - Add a console widget (@breakU1, #1431) - Update custom_ui and image_gui examples (@CasperSchippers, @Falk3579, #1266, #1337) - Update managed window with support for multi-selection for deleting and removing experiments (@breakU1, #1451) - Fix 'Ohm' units in examples (@Falk3579, #1338) Documentation ------------- - Update documentation regarding type hints (@BenediktBurger, #1324) - Add sphinx-autodoc-typehints extension (@ilev-sergey, #1406) - Add AGENTS.md file for AI coding agents (@BenediktBurger, #1372) - Update Read the Docs to Ubuntu 24.04 (@cjermain, #1419) - Fix documentation typos (@ilev-sergey, #1249) Miscellaneous ------------- - Add related projects to documentation (@BenediktBurger, #1335) - Add uv.lock file to gitignore (@maederan201, #1453) - Add Python 3.13 support. (@BenediktBurger, #1173) - Add dependapot configuration (@BenediktBurger, #1307) - Remove deprecated parts (@BenediktBurger, #1268) - Remove support for Python 3.8 (@BenediktBurger, #1317) - Update copyright (@ilev-sergey, @Falk3579, #1248, #1402, #1414) - Update pandas dependency to <4 (@maduka-ariyasiri, #1424) - Bump CI actions versions (@dependabot, #1327, #1328, #1351, #1353, #1386, #1417, #1418, #1408) - Fix ruff configuration (@ilev-sergey, #1236) - Fix formatting (@Falk3579, #1267, #1269, #1316, #1375) - Fix raise errors to show full stack trace (@BenediktBurger, #1270) - Fix failing CI (@CasperSchippers, #1454) New Contributors ---------------- @ilev-sergey, @Benbriel, @fg-lumentum, @dsimat, @panasee, @jvdoorn, @dl8dtl, @Falk3579, @hvegh, @dependabot[bot], @DF9AS, @Patschke, @d-el, @lucasbraud, @chieh0517, @breakU1, @PeterPirog, @maduka-ariyasiri **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.15.0...v0.16.0 Version 0.15.0 (2025-01-15) =========================== Main items of this new release: - pyproject.toml replaces setup.cfg - 12 new instruments Deprecated features ------------------- - The FSL class imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py` is deprecated, the current version can be found in :code:`pymeasure/instruments/rohdeschwarz/fsseries.py`. Instruments ----------- - Add Agilent E5062A (@AlecVercruysse, #1146) - Add Hewlett Packard 8753E VNA (@Sionwage, #1004) - Add Keithley DAQ6510 (@Aphelion82, #1128) - Add Keithley2281S (@PfannenHans, #1054) - Add LD400P electronic load (@RobertoRoos, #1168) - Add Philips PM6669 Universal Frequency Counter (@dirkjankrijnders, #570) - Add Rohde&Schwarz FSSeries class for instruments such as FSL (previously stand-alone class), FSW and others (@jnnskls, #1156) Previously, the instrument class FSL could be imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py`, which can now be imported from :code:`pymeasure/instruments/rohdeschwarz/fsseries.py` alongside the base class FSSeries and FSW. - Add Rigol dg822 waveform generator (@fthouin, #1159) - Add Siglent SDS1072CML oscilloscope (@fthouin, #1080, 1195) - Add more Thyracont vacuum transducer device types (@dkriegner, #1143) - Fix Agilent E5062A: docs + rename `active_traces` to `visible_traces` (@AlecVercruysse, #1174) - Fix AnritsuMS2090A: Confirm SCPIMixin (@icchalmers, #1191) - Fix race condition in test suite due to HP8116A tests (@kpet, #1145) - Fix description of :code:`Keithley2000.measure_resistance` method (@J3NZ0L, #1193) - Fix test for Keithley6510 (@BenediktBurger, #1135) - Fix Kepco BOP power supplies documentation (@JAW90, #1199) - Update AFG3152CChannel to docs (@ssimpson-ens, #1176) - Update Keysight E3631A with added :code:`output_enabled` property to individual channels (@inonRAAAM, #1209) - Update Teledyne with VBS methods (@RobertoRoos, #1166) Automation ---------- - Explicitly set encoding to utf8 when writing and reading data to file, allowing the use of special characters. Previously the encoding was not explicitly set, this could potentially disrupt loading old data-files; if this is required, the encoading can be changed by changing (e.g., monkey-patching) the :code:`pymeasure.experiment.Results.ENCODING` property. (@CasperSchippers, #1123) - Add :code:`has_next` method to Procedure class (@Did-Mas, #1185) - Change logger from root to module-specific logger. (@mmerlo, #1165) Documentation ------------- - Fix a couple of typos in procedure.rst (@kpet, #1141) - Update contribute.rst also for GitHub Desktop (@bernhardlang, @OrionSmedley, #983, #1171) - Fix documentation errors (@msmttchr, @kpet, #1133, #1148) - Update InstrumentKit reference (@emmanuel-ferdman, #1187) - Change copyright year to 2025 (@BenediktBurger, #1210) Miscellaneous ------------- - Prepare for v0.14.0 (@BenediktBurger, #1104) - Add "Reveal in File Explorer" to browser item context menu (@Did-Mas, #1188) - Update numpy 2 test (@CasperSchippers, #1126) - Add an install group for building documentation (@RobertoRoos, #1180) - Remove setup.cfg, replace by pyproject.toml (@RobertoRoos, #1182) New Contributors ---------------- @Sionwage, @bernhardlang, @Aphelion82, @kpet, @mmerlo, @OrionSmedley, @ssimpson-ens, @Did-Mas, @emmanuel-ferdman, @icchalmers, @fthouin, @PfannenHans, @dirkjankrijnders, @J3NZ0L, @inonRAAAM, **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.14.0...v0.15.0 Version 0.14.0 (2024-05-22) =========================== Main items of this new release: - Add support for numpy 2.0 - Add support for python 3.12 - Improve academic quotability with an up to date Zenodo DOI and with citation information. - Add default :code:`queue` method and a :code:`FileInputWidget`, allowing to more quickly get started with the PyMeasure user interface (:code:`ManagedWindow`). - Add a :code:`SCPIMixin` base class for instruments instead of defining :code:`includeSCPI=True` - Instrument manufacturer modules are no longer imported in the :code:`pymeasure/instruments/__init__.py` file. Previously, when importing a single instrument into a procedure, all instruments would be imported into memory through the manufacturer modules in :code:`pymeasure/instruments/__init__.py`. Removing manufacturer modules from that file lowers the memory footprint of pymeasure when importing an instrument. Instrument classes will need to be imported from the manufacturer module or explicitly from the instrument driver file. For example, :code:`from pymeasure.instruments import Extreme5000` will need to change to :code:`from pymeasure.instruments.extreme import Extreme5000` or :code:`from pymeasure.instruments.extreme.extreme5000 import Extreme5000`. - 17 new instruments Deprecated features ------------------- - Remove :code:`TelnetAdapter`, as its library is deprecated (@BenediktBurger, #1045) - Replaced :code:`directory_input` keyword-argument of :code:`ManagedWindowBase` by :code:`enable_file_input` (@CasperSchippers, #964) - Make parameter :code:`includeSCPI` obligatory for all instruments, even those which use SCPI (@BenediktBurger, #1007) - Setting `includeSCPI=True` is deprecated, inherit instead the :code:`SCPIMixin` class if the device supports SCPI commands. - Replaced :code:`celcius` attribute of :code:`LakeShoreTemperatureChannel` by :code:`celsius` (@afuetterer, #1003) - Replaced :code:`error` property of Keithley instruments by :code:`next_error`. - Replaced :code:`measurement_time` property of Pendulum CNT-91 by :code:`gate_time`. - Replaced :code:`sample_rate` keyword-argument of :code:`buffer_frequency_time_series` of Pendulum CNT-91 by :code:`gate_time`. - Replaced MKS937B :code:`unit` to use :code:`instruments/mksinst/mks937b/Unit` instead of strings (@dkriegner, @BenediktBurger #1034) Instruments mechanics --------------------- - Add a SCPI base class :code:`SCPIMixin` as replacement for :code:`includeSCPI=True` (@BenediktBurger, #905, #1007, #1019, #1047) - Add :code:`next_error` property to SCPI instruments (@BenediktBurger, #1024) - Make :code:`query_delay=None` the default for :code:`wait_for` (@BenediktBurger, #1077) - Fix :code:`expected_protocol` using empty dictionary as default value (@BenediktBurger, #1087) - Remove auto-importing all instruments in :code:`pymeasure/instruments/__init__.py`` (@mcdo0486, #919) - Add :code:`find_serial_port` to find a serial port by providing USB information (@BenediktBurger, #982) Instruments ----------- - Add Agilent4294A (@driftregion, #998) - Add Agilent 4284A by (@ConnorGCarr #1079) - Add AimTTI PL series power supplies (@guuskuiper, #942) - Add HP11713A Switch & Attenuator Driver (@neuschs, #970) - Add HP437B power meter (@neuschs, #979) - Add Inficon SQM160 SQM-160 multi-film rate/thickness monitor (@dkriegner, #991) - Add Keithley 2182 (@ConnorGCarr, #1043) - Add KeithleyDMM6500 (@fwutw, #963) - Add Kepco BOP 36-12 Bipolar Power Supply (@JAW90, #1086) - Add KeysightE3631A (@OptimisticBeliever, #990) - Add Kuhne Electronic KU SG 2.45 250A microwave generator (@jurajjasik, @BenediktBurger, @1108) - Add MKS 974B vacuum pressure transducer (@dkriegner, #1034) - Add Proterial rod4 (@ConnorGCarr, #1044) - Add Racal-Dana 1992 universal counter (@tomverbeure, #798, #1012) - Add redpitaya board (@seb5g, #1010, #1035) - Add Teledyne HDO6xxx (@RobertoRoos, #868) - Add Yokogawa AQ6370D Optical Spectral Analyzer (@jnnskls, #1059) - Fix property docstrings of several instruments (@BenediktBurger, #1018) - Fix checksums of hcp TC038D tests (@BenediktBurger, #987) - Fix Hp8116a (@BenediktBurger, #1088) - Fix Hp856x to append amplitude units (@neuschs, #977) - Fix Keysight E36312A confirmed SCPI functionality (@Konradrundfunk, #1107) - Fix Stanford Research SR830 output conversion (@dkriegner, #1069) - Fix SR830 missing get_buffer method (@seb5g, #999) - Fix set command of SR860 aux output (@wehlgrundspitze, #1048) - Fix Temptronic test to use ns perf counter (@BenediktBurger, #1109, #1110) - Fix Toptica Ibeamsmart referencing removed adapter function (@BenediktBurger, #1065) - Fix typos in docstrings for Keithley instruments (@V0XNIHILI, #1071) - Link Keysight, Agilent, and HP documentation pages. (@BenediktBurger, #1021) - Update Agilent33500 Series from :code:`.ch[]` to :code:`.channels[]` (@AlecVercruysse, #945) - Update AWG401x driver to use 'channels' (@mcdo0486, #944) - Update HP33120A with new burst modulation parameters (@mzen228, #1056) - Update HP34401A with new remote control command. (@Rybok, #992) - Update Keithleys' next_error (@msmttchr, #1030) - Update pendulum CNT-91 (@bleykauf, #988) GUI --- - Add a :code:`FileInputWidget` to choose if and where the experiment data is stored. (@CasperSchippers, #964) - Add a default :code:`Queue` method for :code:`ManagedWindowBase` is implemented. (@CasperSchippers, #964) - Fix :code:`ScientificInput` to be locale compatible (@pyZerrenner, #1074) - Fix exception if loading result file with an empty parameter (@poje42, #1016) Miscellaneous ------------- - Add support for python 3.12 (@BenediktBurger, #1051) - Add support for numpy 2.0 (@CasperSchippers, #1026) - Add codecov to CI and to readme (@BenediktBurger, #1037, #1052, #1099) - Add citation file for PyMeasure repository (@mcdo0486, #1092) - Add release CI (@BenediktBurger, #1039) - Update readme with permanent Zenodo DOI (@BenediktBurger, #1095) - Bump CI dependencies to: pyvisa 1.13.0, checkout@v4 (@mcdo0486, #1097) - Fix/pandas futurewarning (@CasperSchippers, #1062) - Change copyright year. (@BenediktBurger, #1032) - Fix typos (@afuetterer, #1003) New Contributors ---------------- @guuskuiper, @OptimisticBeliever, @fwutw, @afuetterer, @poje42, @Rybok, @AlecVercruysse, @ConnorGCarr, @mzen228, @jnnskls, @V0XNIHILI, @pyZerrenner, @JAW90, @driftregion, @jurajjasik, @Konradrundfunk **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.13.1...v0.14.0 Version 0.13.1 (2023-10-05) =========================== New release to fix ineffective python version restriction in the project metadata (only affected Python<=3.7 environments installing via pip). Version 0.13.0 (2023-09-23) =========================== Main items of this new release: - Dropped support for Python 3.7, added support for Python 3.11. - Adds a test generator, which observes the communication with an actual device and writes protocol tests accordingly. - 2 new instrument drivers have been added. Deprecated features ------------------- - Attocube ANC300: The :code:`stepu` and :code:`stepd` properties are deprecated, use the new :code:`move_raw` method instead. (@dkriegner, #938) Instruments ----------- - Adds a test generator (@bmoneke, #882) - Adds Thyracont Smartline v2 vacuum sensor transmitter (@bmoneke, #940) - Adds Thyracont Smartline v1 vacuum gauge (@dkriegner, #937) - AddsTeledyne base classes with most of `LeCroyT3DSO1204` functionality (@RobertoRoos, #951) - Fixes instrument documentation (@mcdo0486, #941, #903, @omahs, #960) - Fixes Toptica Ibeamsmart's __init__ (@waveman68, #959) - Fixes VISAAdapter flush_read_buffer() (@ileu, #968) - Updates Keithley2306 and AFG3152C to Channels (@bilderbuchi, #953) GUI --- - Adds console mode (@msmttchr, #500) - Fixes Dock widget (@msmttchr, #961) Miscellaneous ------------- - Change CI from conda to mamba (@bmoneke, #947) - Add support for python 3.11 (@CasperSchippers, #896) New Contributors ---------------- @waveman68, @omahs, @ileu **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.12.0...v0.13.0 Version 0.12.0 (2023-07-05) =========================== Main items of this new release: - A :code:`Channel` base class has been added for easier implementation of instruments with channels. - 19 new instrument drivers have been added. - Added tests for some commonalities across all instruments. - We continue to clean up our API in preparation for a future version 1.0. Deprecations and subsequent removals are listed below. Deprecated features ------------------- - HP 34401A: :code:`voltage_ac`, :code:`current_dc`, :code:`current_ac`, :code:`resistance`, :code:`resistance_4w` properties, use :code:`function_` and :code:`reading` properties instead. - Toptica IBeamSmart: :code:`channel1_enabled`, use :code:`ch_1.enabled` property instead (equivalent for channel2). Also :code:`laser_enabled` is deprecated in favor of :code:`emission` (@bmoneke, #819). - TelnetAdapter: use :code:`VISAAdapter` instead. VISA supports TCPIP connections. Use the resource_name :code:`TCPIP[board]::::::SOCKET` to connect to a server (@Max-Herbold, #835). - Attocube ANC300: :code:`host` argument, pass a resource string or adapter as :code:`Adapter` passed to :code:`Instrument`. Now communicates through the :code:`VISAAdapter` rather than deprecated :code:`TelnetAdapter`. The initializer now accepts :code:`name` as its second keyword argument so all previous initialization positional arguments (`axisnames`, `passwd`, `query_delay`) should be switched to keyword arguments. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept arbitrary keyword arguments anymore. Use the :code:`v_kwargs` parameter for arguments you want to pass on to :code:`values` method, instead. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept `command_process` anymore. Use a dynamic property or a `Channel` instead, as appropriate (@bmoneke, #878). - See also the next section. New adapter and instrument mechanics ------------------------------------ - All instrument constructors are required to accept a :code:`name` argument. - Changed: :code:`read_bytes` of all Adapters by default does not stop reading on a termination character, unless the new argument :code:`break_on_termchar` is set to `True`. - Channel class added. :code:`Instrument.channels` and :code:`Instrument.ch_X` (:code:`X` is any channel name) are reserved attributes for channel mechanics. - The parameters :code:`check_get_errors` and :code:`check_set_errors` enable calling methods of the same name. This enables more systematically dealing with instruments that acknowledge every "set" command. - Adds Channel feature to instruments (@bmoneke, mcdo0486, #718, #761, #852, #931) - Adds :code:`maxsplit` parameter to :code:`values` method (@bmoneke, #793) - Adds (deprecated) global preprocess reply for backward compatibility (@bmoneke, #876) - Adds fallback version for discarding the read buffer to VISAAdapter (@dkriegner, #836) - Adds :code:`flush_read_buffer` to SerialAdapter (@RobertoRoos, #865) - Adds :code:`gpib_read_timeout` to PrologixAdapter (@neuschs, #927) - Adds command line option to pass resource address for instrument tests (@bleykauf, #789) - Adds "find all instruments" and channels for testing (@bmoneke, #909, @mcdo0486, #911, #912) - Adds test that an instrument hands kwargs to the adapter (@bmoneke, #814) - Adds property docstring check (@bmoneke, #895) - Improves property factories' docstrings (@bmoneke, #843) - Improves property factories: do not allow undefined kwargs (@bmoneke, #856) - Improves property factories: check_set/get_errors argument to call methods of the same name (@bmoneke, #883) - Improves :code:`read_bytes` of Adapter (@bmoneke, #839) - Improves the ProtocolAdapter with a mock connection (@bmoneke, #782), and enable it to have empty messages in the protocol (@bmoneke, #818) - Improves Prologix adapter documentation (@bmoneke, #813) and configurable settings (@bmoneke, #845) - Improves behavior of :code:`read_bytes(-1)` for :code:`SerialAdapter` (@RobertoRoos, #866) - Improves all instruments with name kwarg (@bmoneke, #877) - Improves VisaAdapter: close manager only when using pyvisa-sim (@dkriegner, #900) - Harmonises instrument name definition pattern, consistently name the instrument connection argument "adapter" (@bmoneke, #659) - Fixes ProtocolAdapter has list in signature (@bmoneke, #901) - Fixes VISAAdapter's :code:`read_bytes` (@bmoneke, #867) - Fixes query_delay usage in VISAAdapter (@bmoneke, #765) - Fixes VisaAdapter: close resource manager only when using pyvisa-sim (@dkriegner, #900) Instruments ----------- - New Advantest R624X DC Voltage/Current Sources/Monitors (@wichers, #802) - New AJA International DC sputtering power supply (@dkriegner, #778) - New Anritus MS2090A (@aruznieto, #787) - New Anritsu MS4644B (@CasperSchippers, #827) - New DSP 7225 and new DSPBase instrument (@mcdo0486, #902) - New HP 8560A / 8561B Spectrum Analyzer (@neuschs, #888) - New IPG Photonics YAR Amplifier series (@bmoneke, #851) - New Keysight E36312A power supply (@scandey, #785) - New Keithley 2200 power supply (@ashokbruno, #806) - New Lake Shore 211 Temperature Monitor (@mcdo0486, #889) - New Lake Shore 224 and improves Lakeshore instruments (@samcondon4, #870) - New MKS Instruments 937B vacuum gauge controller (@dkriegner, @bilderbuchi, #637, #772, #936) - New Novanta FPU60 laser power supply unit (@bmoneke, #885) - New TDK Lambda Genesys 80-65 DC and 40-38 DC power supplies (@mcdo0486, 906) - New Teledyne T3AFG waveform generator instrument (@scandey, #791) - New Teledyne (LeCroy) T3DSO1204 Oscilloscope (@LastStartDust, #697, @bilderbuchi, #770) - New T&C Power Conversion RF power supply (@dkriegner, #800) - New Velleman K8090 relay device (@RobertoRoos, #859) - Improves Agilent 33500 with the new channel feature (@JCarl-OS, #763, #773) - Improves HP 3478A with calibration data related functions (@tomverbeure, #777) - Improves HP 34401A (@CodingMarco, #810) - Improves the Oxford instruments with the new channel feature (@bmoneke, #844) - Improves Siglent SPDxxxxX with the new channel feature (@AidenDawn 758) - Improves Teledyne T3DSO1204 device tests (@LastStarDust, #841) - Fixes Ametek DSP 7270 lockin amplifier issues (@seb5g, #897) - Fixes DSP 7265 erroneously using preprocess_reply (@mcdo0486, #873) - Fixes print statement in DSPBase.sensitivity (@mcdo0486, #915) - Fixes Fluke bath commands (@bmoneke, #874) - Fixes a frequency limitation in HP 8657B (@LongnoseRob, #769) - Fixes Keithley 2600 channel calling parent's shutdown (@mcdo0486, #795) Automation ---------- - Adds tolerance for opening result files with missing parameters (@msmttchr, #780) - Validate DATA_COLUMNS entries earlier, avoid exceptions in a running procedure (@mcdo0486, #796, #934) GUI --- - Adds docking windows (@mcdo0486, #722, #762) - Adds save plot settings in addition to dock layout (@mcdo0486, #850) - Adds log widget colouring and format option (@CasperSchippers, #890) - Adds table widget (@msmttchr, #771) - New sequencer architecture: decouples it from the graphical tree, adapts it for further expansions (@msmttchr, #518) - Moves coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - Fixes crashing ImageWidget at new measurement (@CasperSchippers, #790) - Fixes checkboxes not working for groups in inputs-widget (@CasperSchippers, #794) Miscellaneous ------------- - Adds a collection of solutions for instrument implementation challenges (@bmoneke, #853, #861) - Updates Tutorials/Making_a_measurement/ example_codes (@sansanda, #749) New Contributors ---------------- @JCarl-OS, @aruznieto, @scandey, @tomverbeure, @wichers, @Max-Herbold, @RobertoRoos **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.1...v0.12.0 Version 0.11.1 (2022-12-31) =========================== Adapter and instrument mechanics -------------------------------- - Fix broken `PrologixAdapter.gpib`. Due to a bug in `VISAAdapter`, you could not get a second adapter with that connection (#765). **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.0...v0.11.1 Dependency updates ------------------ - Required version of `PyQtGraph `__ is increased from :code:`pyqtgraph >= 0.9.10` to :code:`pyqtgraph >= 0.12` to support new PyMeasure display widgets. GUI --- - Added `ManagedDockWindow `__ to allow multiple dockable plots (@mcdo0486, @CasperSchippers, #722) - Move coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - New sequencer architecture (@msmttchr, @CasperSchippers, @mcdo0486, #518) - Added "Save Dock Layout" functionality to DockWidget context menu. (@mcdo0486, #762) Version 0.11.0 (2022-11-19) =========================== Main items of this new release: - 11 new instrument drivers have been added - A method for testing instrument communication **without** hardware present has been added, see `the documentation `__. - The separation between :code:`Instrument` and :code:`Adapter` has been improved to make future modifications easier. Adapters now focus on the hardware communication, and the communication *protocol* should be defined in the Instruments. Details in a section below. - The GUI is now compatible with Qt6. - We have started to clean up our API in preparation for a future version 1.0. There will be deprecations and subsequent removals, which will be prominently listed in the changelog. Deprecated features ------------------- In preparation for a stable 1.0 release and a more consistent API, we have now started formally deprecating some features. You should get warnings if those features are used. - Adapter methods :code:`ask`, :code:`values`, :code:`binary_values`, use :code:`Instrument` methods of the same name instead. - Adapter parameter :code:`preprocess_reply`, override :code:`Instrument.read` instead. - :code:`Adapter.query_delay` in favor of :code:`Instrument.wait_for()`. - Keithley 2260B: :code:`enabled` property, use :code:`output_enabled` instead. New adapter and instrument mechanics ------------------------------------ - Nothing should have changed for users, this section is mainly interesting for instrument implementors. - Documentation in 'Advanced communication protocols' in 'Adding instruments'. - Adapter logs written and read messages. - Particular adapters (`VISAAdapter` etc.) implement the actual communication. - :code:`Instrument.control` getter calls :code:`Instrument.values`. - :code:`Instrument.values` calls :code:`Instrument.ask`, which calls :code:`Instrument.write`, :code:`wait_for`, and :code:`read`. - All protocol quirks of an instrument should be implemented overriding :code:`Instrument.write` and :code:`read`. - :code:`Instrument.wait_until_read` implements waiting between writing and reading. - reading/writing binary values is in the :code:`Adapter` class itself. - :code:`PrologixAdapter` is now based on :code:`VISAAdapter`. - :code:`SerialAdapter` improved to be more similar to :code:`VISAAdapter`: :code:`read`/:code:`write` use strings, :code:`read/write_bytes` bytes. - Support for termination characters added. Instruments ----------- - New Active Technologies AWG-401x (@garzetti, #649) - New Eurotest hpp_120_256_ieee (@sansanda, #701) - New HC Photonics crystal ovens TC038, TC038D (@bmoneke, #621, #706) - New HP 6632A/6633A/6634A power supplies (@LongnoseRob, #651) - New HP 8657B RF signal generator (@LongnoseRob, #732) - New Rohde&Schwarz HMP4040 power supply. (@bleykauf, #582) - New Siglent SPDxxxxX series Power Supplies (@AidenDawn, #719) - New Temptronic Thermostream devices (@mroeleke, #368) - New TEXIO PSW-360L30 Power Supply (@LastStarDust, #698) - New Thermostream ECO-560 (@AidenDawn, #679) - New Thermotron 3800 Oven (@jcarbelbide, #606) - Harmonize instruments' adapter argument (@bmoneke, #674) - Harmonize usage of :code:`shutdown` method (@LongnoseRob, #739) - Rework Adapter structure (@bmoneke, #660) - Add Protocol tests without hardware present (@bilderbuchi, #634, @bmoneke, #628, #635) - Add Instruments and adapter protocol tests for adapter rework (@bmoneke, #665) - Add SR830 sync filter and reference source trigger (@AsafYagoda, #630) - Add Keithley6221 phase marker phase and line (@AsafYagoda, #629) - Add missing docstrings to Keithley 2306 battery simulator (@AidenDawn, #720) - Fix hcp instruments documentation (@bmoneke, #671) - Fix HPLegacyInstrument initializer API (@bilderbuchi, #684) - Fix Fwbell 5080 implementation (@mcdo0486, #714) - Fix broken documentation example. (@bmoneke, #738) - Fix typo in Keithley 2600 driver (@mcdo0486, #615) - Remove dynamic use of docstring from ATS545 and make more generic (@AidenDawn, #685) Automation ---------- - Add storing unitful experiment results (@bmoneke, #642) - Add storing conditions in file (@CasperSchippers, #503) GUI --- - Add compatibility with Qt 6 (@CasperSchippers, #688) - Add spinbox functionality for IntegerParameter and FloatParameter (@jarvas24, #656) - Add "delete data file" button to the browser_item_menu (@jarvas24, #654) - Split windows.py into a folder with separate modules (@mcdo0486, #593) - Remove dependency on matplotlib (@msmttchr, #622) - Remove deprecated access to QtWidgets through QtGui (@maederan201, #695) Miscellaneous ------------- - Update and extend documentation (@bilderbuchi, #712, @bmoneke, #655) - Add PEP517 compatibility & dynamically obtaining a version number (@bilderbuchi, #613) - Add an example and documentation regarding using a foreign instrument (@bmoneke, #647) - Add black configuration (@bleykauf, #683) - Remove VISAAdapter.has_supported_version() as it is not needed anymore. New Contributors ---------------- @jcarbelbide, @mroeleke, @bmoneke, @garzetti, @AsafYagoda, @AidenDawn, @LastStarDust, @sansanda **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.10.0...v0.11.0 Version 0.10.0 (2022-04-09) =========================== Main items of this new release: - 23 new instrument drivers have been added - New dynamic Instrument properties can change their parameters at runtime - Communication settings can now be flexibly defined per protocol - Python 3.10 support was added and Python 3.6 support was removed. - Many additions, improvements and have been merged Instruments ----------- - New Agilent B1500 Data Formats and Documentation (@moritzj29) - New Anaheim Automation stepper motor controllers (@samcondon4) - New Andeen Hagerling capacitance bridges (@dkriegner) - New Anritsu MS9740A Optical Spectrum Analyzer (@md12g12) - New BK Precision 9130B Instrument (@dennisfeng2) - New Edwards nXDS (10i) Vacuum Pump (@hududed) - New Fluke 7341 temperature bath instrument (@msmttchr) - New Heidenhain ND287 Position Display Unit Driver (@samcondon4) - New HP 3478A (@LongnoseRob) - New HP 8116A 50 MHz Pulse/Function Generator (@CodingMarco) - New Keithley 2260B DC Power Supply (@bklebel) - New Keithley 2306 Dual Channel Battery/Charger Simulator (@mfikes) - New Keithley 2600 SourceMeter series (@Daivesd) - New Keysight N7776C Swept Laser Source (@maederan201) - New Lakeshore 421 (@CasperSchippers) - New Oxford IPS120-10 (@CasperSchippers) - New Pendulum CNT-91 frequency counter (@bleykauf) - New Rohde&Schwarz - SFM TV test transmitter (@LongnoseRob) - New Rohde&Schwarz FSL spectrum analyzer (@bleykauf) - New SR570 current amplifier driver (@pyMatJ) - New Stanford Research Systems SR510 instrument driver (@samcondon4) - New Toptica Smart Laser diode (@dkriegner) - New Yokogawa GS200 Instrument (@dennisfeng2) - Add output low grounded property to Keithley 6221 (@CasperSchippers) - Add shutdown function for Keithley 2260B (@bklebel) - Add phase control for Agilent 33500 (@corna) - Add assigning "ONCE" to auto_zero to Keithley 2400 (@mfikes) - Add line frequency controls to Keithley 2400 (@mfikes) - Add LIA and ERR status byte read properties to the SRS Sr830 driver (@samcondon4) - Add all commands to Oxford Intelligent Temperature Controller 503 (@CasperSchippers) - Fix DSP 7265 lockin amplifier (@CasperSchippers) - Fix bug in Keithley 6517B Electrometer (@CasperSchippers) - Fix Keithley2000 deprecated call to visa.config (@bklebel) - Fix bug in the Keithley 2700 (@CasperSchippers) - Fix setting of sensor flags for Thorlabs PM100D (@bleykauf) - Fix SCPI used for Keithley 2400 voltage NPLC (@mfikes) - Fix missing return statements in Tektronix AFG3152C (@bleykauf) - Fix DPSeriesMotorController bug (@samcondon4) - Fix Keithley2600 error when retrieving error code (@bicarlsen) - Fix Attocube ANC300 with new SCPI Instrument properties (@dkriegner) - Fix bug in wait_for_trigger of Agilent33220A (neal-kepler) GUI --- - Add time-estimator widget (@CasperSchippers) - Add management of progress bar (@msmttchr) - Remove broken errorbar feature (@CasperSchippers) - Change of pen width for pyqtgraph (@maederan201) - Make linewidth changeable (@CasperSchippers) - Generalise warning in plotter section (@CasperSchippers) - Implement visibility groups in InputsWidgets (@CasperSchippers) - Modify navigation of ManagedWindow directory widget (@jarvas24) - Improve Placeholder logic (@CasperSchippers) - Breakout widgets into separate modules (@mcdo0486) - Fix setSizePolicy bug with PySide2 (@msmttchr) - Fix managed window (@msmttchr) - Fix ListParameter for numbers (@moritzj29) - Fix incorrect columns on showing data (@CasperSchippers) - Fix procedure property issue (@msmttchr) - Fix pyside2 (@msmttchr) Miscellaneous ------------- - Improve SCPI property support (@msmttchr) - Remove broken safeKeyword management (@msmttchr) - Add dynamic property support (@msmttchr) - Add flexible API for defining connection configuration (@bilderbuchi) - Add write_binary_values() to SerialAdapter (@msmttchr) - Change an outdated pyvisa ask() to query() (@LongnoseRob) - Fix ZMQ bug (@bilderbuchi) - Documentation for passing tuples to control property (@bklebel) - Documentation bugfix (@CasperSchippers) - Fixed broken links in documentation. (@samcondon4) - Updated widget documentation (@mcdo0486) - Fix typo SCIP->SCPI (@mfikes) - Remove Python 3.6, add Python 3.10 testing (@bilderbuchi) - Modernise the code base to use Python 3.7 features (@bilderbuchi) - Added image data generation to Mock Instrument class (@samcondon4) - Add autodoc warnings to the problem matcher (@bilderbuchi) - Update CI & annotations (@bilderbuchi) - Test workers (@mcdo0486) - Change copyright date to 2022 (@LongnoseRob) - Removed unused code (@msmttchr) New Contributors ---------------- @LongnoseRob, @neal, @hududed, @corna, @Daivesd, @samcondon4, @maederan201, @bleykauf, @mfikes, @bicarlsen, @md12g12, @CodingMarco, @jarvas24, @mcdo0486! **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.9...v0.10.0 Version 0.9 -- released 2/7/21 ============================== - PyMeasure is now officially at github.com/pymeasure/pymeasure - Python 3.9 is now supported, Python 3.5 removed due to EOL - Move to GitHub Actions from TravisCI and Appveyor for CI (@bilderbuchi) - New additions to Oxford Instruments ITC 503 (@CasperSchippers) - New Agilent 34450A and Keysight DSOX1102G instruments (@theMashUp, @jlarochelle) - Improvements to NI VirtualBench (@moritzj29) - New Agilent B1500 instrument (@moritzj29) - New Keithley 6517B instrument (@wehlgrundspitze) - Major improvements to PyVISA compatbility (@bilderbuchi, @msmttchr, @CasperSchippers, @cjermain) - New Anapico APSIN12G instrument (@StePhanino) - Improvements to Thorelabs Pro 8000 and SR830 (@Mike-HubGit) - New SR860 instrument (@StevenSiegl, @bklebel) - Fix to escape sequences (@tirkarthi) - New directory input for ManagedWindow (@paulgoulain) - New TelnetAdapter and Attocube ANC300 Piezo controller (@dkriegner) - New Agilent 34450A (@theMashUp) - New Razorbill RP100 strain cell controller (@pheowl) - Fixes to precision and default value of ScientificInput and FloatParameter (@moritzj29) - Fixes for Keithly 2400 and 2450 controls (@pyMatJ) - Improvments to Inputs and open_file_externally (@msmttchr) - Fixes to Agilent 8722ES (@alexmcnabb) - Fixes to QThread cleanup (@neal-kepler, @msmttchr) - Fixes to Keyboard interrupt, and parameters (@CasperSchippers) Version 0.8 -- released 3/29/19 =============================== - Python 3.8 is now supported - New Measurement Sequencer allows for running over a large parameter space (@CasperSchippers) - New image plotting feature for live image measurements (@jmittelstaedt) - Improvements to VISA adapter (@moritzj29) - Added Tektronix AFG 3000, Keithley 2750 (@StePhanino, @dennisfeng2) - Documentation improvements (@mivade) - Fix to ScientificInput for float strings (@moritzj29) - New validator: strict_discrete_range (@moritzj29) - Improvements to Recorder thread joining - Migrating the ReadtheDocs configuration to version 2 - National Instruments Virtual Bench initial support (@moritzj29) Version 0.7 -- released 8/4/19 ============================== - Dropped support for Python 3.4, adding support for Python 3.7 - Significant improvements to CI, dependencies, and conda environment (@bilderbuchi, @cjermain) - Fix for PyQT issue in ResultsDialog (@CasperSchippers) - Fix for wire validator in Keithley 2400 (@Fattotora) - Addition of source_enabled control for Keithley 2400 (@dennisfeng2) - Time constant fix and input controls for SR830 (@dennisfeng2) - Added Keithley 2450 and Agilent 33521A (@hlgirard, @Endever42) - Proper escaping support in CSV headers (@feph) - Minor updates (@dvase) Version 0.6.1 -- released 4/21/19 ================================= - Added Elektronica SM70-45D, Agilent 33220A, and Keysight N5767A instruments (@CasperSchippers, @sumatrae) - Fixes for Prologix adapter and Keithley 2400 (@hlgirard, @ronan-sensome) - Improved support for SRS SR830 (@CasperSchippers) Version 0.6 -- released 1/14/19 =============================== - New VXI11 Adapter for ethernet instruments (@chweiser) - PyQt updates to 5.6.0 - Added SRS SG380, Ametek 7270, Agilent 4156, HP 34401A, Advantest R3767CG, and Oxford ITC503 instrustruments (@sylkar, @jmittelstaedt, @vik-s, @troylf, @CasperSchippers) - Updates to Keithley 2000, Agilent 8257D, ESP 300, and Keithley 2400 instruments (@watersjason, @jmittelstaedt, @nup002) - Various minor bug fixes (@thosou) Version 0.5.1 -- released 4/14/18 ================================= - Minor versions of PyVISA are now properly handled - Documentation improvements (@Laogeodritt and @ederag) - Instruments now have :code:`set_process` capability (@bilderbuchi) - Plotter now uses threads (@dvspirito) - Display inputs and PlotItem improvements (@Laogeodritt) Version 0.5 -- released 10/18/17 ================================ - Threads are used by default, eliminating multiprocessing issues with spawn - Enhanced unit tests for threading - Sphinx Doctests are added to the documentation (@bilderbuchi) - Improvements to documentation (@JuMaD) Version 0.4.6 -- released 8/12/17 ================================= - Reverted multiprocessing start method keyword arguments to fix Unix spawn issues (@ndr37) - Fixes to regressions in Results writing (@feinsteinben) - Fixes to TCP support using cloudpickle (@feinsteinben) - Restructing of unit test framework Version 0.4.5 -- released 7/4/17 ================================ - Recorder and Scribe now leverage QueueListener (@feinsteinben) - PrologixAdapter and SerialAdapter now handle Serial objects as adapters (@feinsteinben) - Optional TCP support now uses cloudpickle for serialization (@feinsteinben) - Significant PEP8 review and bug fixes (@feinsteinben) - Includes docs in the code distribution (@ghisvail) - Continuous integration support for Python 3.6 (@feinsteinben) Version 0.4.4 -- released 6/4/17 ================================ - Fix pip install for non-wheel builds - Update to Agilent E4980 (@dvspirito) - Minor fixes for docs, tests, and formatting (@ghisvail, @feinsteinben) Version 0.4.3 -- released 3/30/17 ================================= - Added Agilent E4980, AMI 430, Agilent 34410A, Thorlabs PM100, and Anritsu MS9710C instruments (@TvBMcMaster, @dvspirito, and @mhdg) - Updates to PyVISA support (@minhhaiphys) - Initial work on resource manager (@dvspirito) - Fixes for Prologix adapter that allow read-write delays (@TvBMcMaster) - Fixes for conda environment on continuous integration Version 0.4.2 -- released 8/23/16 ================================= - New instructions for installing with Anaconda and conda-forge package (thanks @melund!) - Bug-fixes to the Keithley 2000, SR830, and Agilent E4408B - Re-introduced the Newport ESP300 motion controller - Major update to the Keithely 2400, 2000 and Yokogawa 7651 to achieve a common interface - New command-string processing hooks for Instrument property functions - Updated LakeShore 331 temperature controller with new features - Updates to the Agilent 8257D signal generator for better feature exposure Version 0.4.1 -- released 7/31/16 ================================= - Critical fix in setup.py for importing instruments (also added to documentation) Version 0.4 -- released 7/29/16 =============================== - Replaced Instrument add_measurement and add_control with measurement and control functions - Added validators to allow Instrument.control to match restricted ranges - Added mapping to Instrument.control to allow more flexible inputs - Conda is now used to set up the Python environment - macOS testing in continuous integration - Major updates to the documentation Version 0.3 -- released 4/8/16 ============================== - Added IPython (Jupyter) notebook support with significant features - Updated set of example scripts and notebooks - New PyMeasure logo released - Removed support for Python <3.4 - Changed multiprocessing to use spawn for compatibility - Significant work on the documentation - Added initial tests for non-instrument code - Continuous integration setup for Linux and Windows Version 0.2 -- released 12/16/15 ================================ - Python 3 compatibility, removed support for Python 2 - Considerable renaming for better PEP8 compliance - Added MIT License - Major restructuring of the package to break it into smaller modules - Major rewrite of display functionality, introducing new Qt objects for easy extensions - Major rewrite of procedure execution, now using a Worker process which takes advantage of multi-core CPUs - Addition of a number of examples - New methods for listening to Procedures, introducing ZMQ for TCP connectivity - Updates to Keithley2400 and VISAAdapter Version 0.1.6 -- released 4/19/15 ================================= - Renamed the package to PyMeasure from Automate to be more descriptive about its purpose - Addition of VectorParameter to allow vectors to be input for Procedures - Minor fixes for the Results and Danfysik8500 Version 0.1.5 -- release 10/22/14 ================================= - New Manager class for handling Procedures in a queue fashion - New Browser that works in tandem with the Manager to display the queue - Bug fixes for Results loading Version 0.1.4 -- released 8/2/14 ================================ - Integrated Results class into display and file writing - Bug fixes for Listener classes - Bug fixes for SR830 Version 0.1.3 -- released 7/20/14 ================================= - Replaced logging system with Python logging package - Added data management (Results) and bug fixes for Procedures and Parameters - Added pandas v0.14 to requirements for data management - Added data listeners, Qt4 and PyQtGraph helpers Version 0.1.2 -- released 7/18/14 ================================= - Bug fixes to LakeShore 425 - Added new Procedure and Parameter classes for generic experiments - Added version number in package Version 0.1.1 -- released 7/16/14 ================================= - Bug fixes to PrologixAdapter, VISAAdapter, Agilent 8722ES, Agilent 8257D, Stanford SR830, Danfysik8500 - Added Tektronix TDS 2000 with basic functionality - Fixed Danfysik communication to handle errors properly Version 0.1.0 -- released 7/15/14 ================================= - Initial release ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/CITATION.cff0000644000175100017510000000040715203313266015152 0ustar00runnerrunnercff-version: 1.2.0 message: "If you use this software, please cite it as below." authors: - name: PyMeasure Developers title: "PyMeasure" version: 0.16.0 doi: 10.5281/zenodo.595633 publisher: - name: Zenodo repository-code: https://github.com/pymeasure/pymeasure ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/LICENSE.txt0000644000175100017510000000205515203313266015104 0ustar00runnerrunnerCopyright (c) 2013-2026 PyMeasure Developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/MANIFEST.in0000644000175100017510000000025315203313266015015 0ustar00runnerrunner# Files get pulled from Git repo by setuptools_scm, we only have to exclude what we don't want prune docs/_build prune .github exclude .gitignore exclude .readthedocs.yml ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0715125 pymeasure-0.16.0/PKG-INFO0000644000175100017510000015073415203313301014354 0ustar00runnerrunnerMetadata-Version: 2.4 Name: PyMeasure Version: 0.16.0 Summary: Scientific measurement library for instruments, experiments, and live-plotting Author: PyMeasure Developers License: MIT Project-URL: Repository, https://github.com/pymeasure/pymeasure Project-URL: Issues, https://github.com/pymeasure/pymeasure/issues Project-URL: Documentation, https://pymeasure.readthedocs.io Keywords: measure,instrument,experiment control,automate,graph,plot Classifier: Development Status :: 4 - Beta Classifier: Intended Audience :: Science/Research Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: MacOS Classifier: Operating System :: Microsoft :: Windows Classifier: Operating System :: POSIX Classifier: Operating System :: Unix Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Topic :: Scientific/Engineering Requires-Python: >=3.9 Description-Content-Type: text/x-rst License-File: LICENSE.txt Requires-Dist: numpy<3,>=1.6.1 Requires-Dist: pandas<4,>=0.14 Requires-Dist: pint Requires-Dist: pyvisa>=1.9 Requires-Dist: pyserial>=2.7 Requires-Dist: pyqtgraph>=0.12 Requires-Dist: qtpy>=2.4 Provides-Extra: tcp Requires-Dist: pyzmq>=16.0.2; extra == "tcp" Requires-Dist: cloudpickle>=0.3.1; extra == "tcp" Provides-Extra: tests Requires-Dist: pytest>=3.3.0; extra == "tests" Requires-Dist: pytest-cov>=4.1.0; extra == "tests" Requires-Dist: pytest-qt>=2.4.0; extra == "tests" Requires-Dist: pyvisa-sim>=0.4.0; extra == "tests" Provides-Extra: docs Requires-Dist: sphinx>=5.0.0; extra == "docs" Requires-Dist: sphinx_rtd_theme>=1.1.0; extra == "docs" Requires-Dist: sphinx_autodoc_typehints>=2.3.0; extra == "docs" Dynamic: license-file .. image:: https://raw.githubusercontent.com/pymeasure/pymeasure/master/docs/images/PyMeasure.png :alt: PyMeasure Scientific package PyMeasure scientific package ############################ PyMeasure makes scientific measurements easy to set up and run. The package contains a repository of instrument classes and a system for running experiment procedures, which provides graphical interfaces for graphing live data and managing queues of experiments. Both parts of the package are independent, and when combined provide all the necessary requirements for advanced measurements with only limited coding. PyMeasure is currently under active development, so please report any issues you experience to our `Issues page`_. .. _Issues page: https://github.com/pymeasure/pymeasure/issues Project Information ------------------- PyMeasure is tested with continuous-integration on Linux, macOS, and Windows for all supported Python versions. .. image:: https://img.shields.io/pypi/pyversions/pymeasure :alt: PyPI - Python Version .. image:: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml/badge.svg :target: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml .. image:: http://readthedocs.org/projects/pymeasure/badge/?version=latest :target: http://pymeasure.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.595633.svg :target: https://doi.org/10.5281/zenodo.595633 .. image:: https://anaconda.org/conda-forge/pymeasure/badges/version.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://anaconda.org/conda-forge/pymeasure/badges/downloads.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://codecov.io/gh/pymeasure/pymeasure/graph/badge.svg :target: https://codecov.io/gh/pymeasure/pymeasure Related Projects ---------------- - `LECO Protocol `_: Open standard for laboratory equipment communication using modern protocols - `pyleco `_: Python library implementing LECO for distributed instrument control systems - `Python Lab Automation Landscape `_: Curated collection of Python tools for laboratory automation and instrumentation Quick start =========== Check out `the documentation`_ for the `quick start guide`_, that covers the installation of Python and PyMeasure. There are a number of examples in the `examples`_ directory that can help you get up and running. .. _the documentation: http://pymeasure.readthedocs.org/en/latest/ .. _quick start guide: http://pymeasure.readthedocs.io/en/latest/quick_start.html .. _examples: https://github.com/pymeasure/pymeasure/tree/master/examples Version 0.16.0 (2026-05-20) =========================== Main items of this new release: - Add support for Python 3.13 - Change policy to allow type hints (added already to instruments core) - 25 new instruments - :code:`Instrument.control` does not apply :code:`get_process` to a returned list anymore, only to a single value. Use :code:`get_process_list` parameter instead for processing a list of values. - Improve implementation of Keithley 2400, with some changes in functionality. Legacy implementation has been kept as :code:`Keithley2400Legacy`. Removed ------- - Remove support for Python 3.8 - Remove deprecated Adapter and Instrument parameters :code:`preprocess_reply`, :code:`query_delay` - Remove deprecated Adapter methods :code:`ask`, :code:`values`, and :code:`binary_values` - Remove deprecated Telnet and VXI adapters Deprecated ---------- - Replace :code:`sensitvity` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`sensitivity` - Replace :code:`filer_synchronous` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`filter_synchronous` - Replace :code:`query_operation_mode` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`operation_mode` property - Replace :code:`query_system_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`system_settings` property - Replace :code:`interrupt_sequence_command` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`interrupt_sequence` - Replace :code:`sequence_program_listing` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`query_sequence_program` - Replace :code:`digital_out_enable_data` attribute of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`digital_output_enable` - Replace :code:`query_output_waveform` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`output_waveform_settings` property - Replace :code:`query_measurement_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`measurement_range_settings` property - Replace :code:`query_response_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`response_settings` property - Replace :code:`query_data_output_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`data_output_settings` property - Replace :code:`query_io_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`io_settings` property - Replace :code:`calibration_init` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`init_calibration` - Replace :code:`calibration_store_factor` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`store_calibration_factor` Instruments ----------- - Add Aculight Argos OPO laser system (@BenediktBurger, #1046) - Add Agilent 33250A waveform generator (@PeterPirog, #1425) - Add Agilent B2980 electrometer series (@Falk3579, #1296) - Add Agilent E5270B (@Falk3579, #1340, #1359, #1365) - Add Agilent N8975A noise figure analyzer (@Falk3579, #1397) - Add FormFactor Velox Waferprobers (@Falk3579, #1385) - Add Ilxlightwave ldp3811 pulsed current source (@fg-lumentum, #1367) - Add Keithley 2510 Sourcemeter (@fg-lumentum, #1239, #1333) - Add Keithley 4200A-SCS (@Falk3579, #1332) - Add Keysight 81160A Pulse Function Arbitrary Noise Generator (@ilev-sergey, #1250) - Add Keysight PNAs (@Falk3579, #1356) - Add LakeShore 3xx temperature controllers (@DF9AS, #1334) - Add Oxford Instruments Mercury Intelligent Temperature Controller (@JAW90, #1198) - Add PTW Diamentor DAP dosemeter (@Falk3579, #1302, #1449) - Add PTW UNIDOS dosemeters (@Falk3579, #1279, #1442) - Add Santec TSL-500 series tunable laser with TSL-550 and TSL-770 (@fg-lumentum, #1253, #1390) - Add Siglent oscilloscope SDS1000XHD (@lucasbraud, #1325) - Add Spellman XRV high voltage power supplies (@Falk3579, #1329, #1440) - Add SRS LDC500Series (@fg-lumentum, #1278, #1346) - Add Thorlabs mbx series (@fg-lumentum, #1361) - Fix Temptronic tests (@ilev-sergey, #1277) - Fix HP3478A: use :code:`write_binary_values()` to request calibration data (@dl8dtl, #1263) - Fix docstring in Keithley4200 (@Falk3579, #1339) - Fix parameter ranges for Agilent33220A (@Patschke, #1342) - Fix Keithley 2000 :code:`voltage_nplc` and :code:`enable_filter` (@d-el, @chieh0517, #1360, #1393) - Fix :code:`read` of Racal 1992 (@BenediktBurger, #1355) - Update old docstrings to new style (@BenediktBurger, #1247, #1243) - Update Advantest R624X driver with sequence builders, hardware-verified fixes, and documentation (@wichers, #1408) - Update Agilent channels (@BenediktBurger, #1089) - Update Agilent 33500 properties and add SCPI mixin (@ilev-sergey, #1245, #1246) - Update Agilent 34450 with :code:`local()` and protocol tests (@Falk3579, #1427, #1436) - Update Agilent 4284A with new correction functionality (@Falk3579, #1304) - Update Agilent B1500 with SPGU and CMU module support and new documentation (@ilev-sergey, #1380, #1344, #1412) - Update Agilent B1500 SMU class to inherit from :code:`Channel` (@ilev-sergey, #1387) - Update Agilent E4408B with SCPIMixin and new docstrings (@BenediktBurger, #1438) - Update Agilent E4980A with tests (@Falk3579, #1300) - Update Keithley 2400 with a major rework (@fg-lumentum, #1347) - Update Keithley 2450's docstring to inform that buffer handling is currently unsupported (@dsimat, #1238) - Update Keithley 6221 with delta mode (@panasee, #1242) - Update MS464xB docstrings (@Falk3579, #1352) - Update SRS 860 with better method names (@panasee, #1289) - Update SRS 860 min ampl (@chieh0517, #1426) - Update Yokogawa Aq6370 series with sensitivity control sweep status, and with connections and traces (@fg-lumentum, @BenediktBurger, #1138, #1234, #1286, #1354) Instruments mechanics --------------------- - Add :code:`_write_bytes()` and :code:`_read_bytes()` for Prologix adapter (@dl8dtl, #1259) - Add handling of SerialException in :code:`list_resources()` (@hvegh, #1287) - Add :code:`get_process_list` and make it dynamic (@BenediktBurger, @Falk3579, #1291, #1313, #1315) - Add typing to :code:`expected_protocol`, adapters, and :code:`Instrument` (@BenediktBurger, #1084, #1331) - Add concrete hint to property creators in docstring list (@BenediktBurger, #1281) - Add SCPI mixin test for devices (@fg-lumentum, #1391) - Update Prologix documentation (@dl8dtl, #1272) Automation ---------- - Add qtpy dependency for Qt version shimming (@Benbriel, #1285) - Add :code:`description` to :code:`Parameters` (@Benbriel, #1211) - Update procedures to emit results in batches (@jvdoorn, #1256) - Replace numeric constants by respective Qt enum values (@dl8dtl, #1265) - Use :code:`np.frombuffer` for removed :code:`np.fromstring(sep="")` (@BenediktBurger, #1330) - Update BooleanParameter to accept numpy.bool (@Falk3579, #1373) - In workers, check should_stop after :code:`startup()` before `execute()` (@breakU1, #1445) - Add vector parameter input (@Falk3579, #1376, #1377, #1382) - Replace :code:`load_module()` by :code:`exec_module()` (@Falk3579, #1415) - Add file size checking to :code:`Results.data` property to skip reading file if data hasn't changed. (@mcdo0486, #1429) GUI --- - Add a console widget (@breakU1, #1431) - Update custom_ui and image_gui examples (@CasperSchippers, @Falk3579, #1266, #1337) - Update managed window with support for multi-selection for deleting and removing experiments (@breakU1, #1451) - Fix 'Ohm' units in examples (@Falk3579, #1338) Documentation ------------- - Update documentation regarding type hints (@BenediktBurger, #1324) - Add sphinx-autodoc-typehints extension (@ilev-sergey, #1406) - Add AGENTS.md file for AI coding agents (@BenediktBurger, #1372) - Update Read the Docs to Ubuntu 24.04 (@cjermain, #1419) - Fix documentation typos (@ilev-sergey, #1249) Miscellaneous ------------- - Add related projects to documentation (@BenediktBurger, #1335) - Add uv.lock file to gitignore (@maederan201, #1453) - Add Python 3.13 support. (@BenediktBurger, #1173) - Add dependapot configuration (@BenediktBurger, #1307) - Remove deprecated parts (@BenediktBurger, #1268) - Remove support for Python 3.8 (@BenediktBurger, #1317) - Update copyright (@ilev-sergey, @Falk3579, #1248, #1402, #1414) - Update pandas dependency to <4 (@maduka-ariyasiri, #1424) - Bump CI actions versions (@dependabot, #1327, #1328, #1351, #1353, #1386, #1417, #1418, #1408) - Fix ruff configuration (@ilev-sergey, #1236) - Fix formatting (@Falk3579, #1267, #1269, #1316, #1375) - Fix raise errors to show full stack trace (@BenediktBurger, #1270) - Fix failing CI (@CasperSchippers, #1454) New Contributors ---------------- @ilev-sergey, @Benbriel, @fg-lumentum, @dsimat, @panasee, @jvdoorn, @dl8dtl, @Falk3579, @hvegh, @dependabot[bot], @DF9AS, @Patschke, @d-el, @lucasbraud, @chieh0517, @breakU1, @PeterPirog, @maduka-ariyasiri **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.15.0...v0.16.0 Version 0.15.0 (2025-01-15) =========================== Main items of this new release: - pyproject.toml replaces setup.cfg - 12 new instruments Deprecated features ------------------- - The FSL class imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py` is deprecated, the current version can be found in :code:`pymeasure/instruments/rohdeschwarz/fsseries.py`. Instruments ----------- - Add Agilent E5062A (@AlecVercruysse, #1146) - Add Hewlett Packard 8753E VNA (@Sionwage, #1004) - Add Keithley DAQ6510 (@Aphelion82, #1128) - Add Keithley2281S (@PfannenHans, #1054) - Add LD400P electronic load (@RobertoRoos, #1168) - Add Philips PM6669 Universal Frequency Counter (@dirkjankrijnders, #570) - Add Rohde&Schwarz FSSeries class for instruments such as FSL (previously stand-alone class), FSW and others (@jnnskls, #1156) Previously, the instrument class FSL could be imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py`, which can now be imported from :code:`pymeasure/instruments/rohdeschwarz/fsseries.py` alongside the base class FSSeries and FSW. - Add Rigol dg822 waveform generator (@fthouin, #1159) - Add Siglent SDS1072CML oscilloscope (@fthouin, #1080, 1195) - Add more Thyracont vacuum transducer device types (@dkriegner, #1143) - Fix Agilent E5062A: docs + rename `active_traces` to `visible_traces` (@AlecVercruysse, #1174) - Fix AnritsuMS2090A: Confirm SCPIMixin (@icchalmers, #1191) - Fix race condition in test suite due to HP8116A tests (@kpet, #1145) - Fix description of :code:`Keithley2000.measure_resistance` method (@J3NZ0L, #1193) - Fix test for Keithley6510 (@BenediktBurger, #1135) - Fix Kepco BOP power supplies documentation (@JAW90, #1199) - Update AFG3152CChannel to docs (@ssimpson-ens, #1176) - Update Keysight E3631A with added :code:`output_enabled` property to individual channels (@inonRAAAM, #1209) - Update Teledyne with VBS methods (@RobertoRoos, #1166) Automation ---------- - Explicitly set encoding to utf8 when writing and reading data to file, allowing the use of special characters. Previously the encoding was not explicitly set, this could potentially disrupt loading old data-files; if this is required, the encoading can be changed by changing (e.g., monkey-patching) the :code:`pymeasure.experiment.Results.ENCODING` property. (@CasperSchippers, #1123) - Add :code:`has_next` method to Procedure class (@Did-Mas, #1185) - Change logger from root to module-specific logger. (@mmerlo, #1165) Documentation ------------- - Fix a couple of typos in procedure.rst (@kpet, #1141) - Update contribute.rst also for GitHub Desktop (@bernhardlang, @OrionSmedley, #983, #1171) - Fix documentation errors (@msmttchr, @kpet, #1133, #1148) - Update InstrumentKit reference (@emmanuel-ferdman, #1187) - Change copyright year to 2025 (@BenediktBurger, #1210) Miscellaneous ------------- - Prepare for v0.14.0 (@BenediktBurger, #1104) - Add "Reveal in File Explorer" to browser item context menu (@Did-Mas, #1188) - Update numpy 2 test (@CasperSchippers, #1126) - Add an install group for building documentation (@RobertoRoos, #1180) - Remove setup.cfg, replace by pyproject.toml (@RobertoRoos, #1182) New Contributors ---------------- @Sionwage, @bernhardlang, @Aphelion82, @kpet, @mmerlo, @OrionSmedley, @ssimpson-ens, @Did-Mas, @emmanuel-ferdman, @icchalmers, @fthouin, @PfannenHans, @dirkjankrijnders, @J3NZ0L, @inonRAAAM, **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.14.0...v0.15.0 Version 0.14.0 (2024-05-22) =========================== Main items of this new release: - Add support for numpy 2.0 - Add support for python 3.12 - Improve academic quotability with an up to date Zenodo DOI and with citation information. - Add default :code:`queue` method and a :code:`FileInputWidget`, allowing to more quickly get started with the PyMeasure user interface (:code:`ManagedWindow`). - Add a :code:`SCPIMixin` base class for instruments instead of defining :code:`includeSCPI=True` - Instrument manufacturer modules are no longer imported in the :code:`pymeasure/instruments/__init__.py` file. Previously, when importing a single instrument into a procedure, all instruments would be imported into memory through the manufacturer modules in :code:`pymeasure/instruments/__init__.py`. Removing manufacturer modules from that file lowers the memory footprint of pymeasure when importing an instrument. Instrument classes will need to be imported from the manufacturer module or explicitly from the instrument driver file. For example, :code:`from pymeasure.instruments import Extreme5000` will need to change to :code:`from pymeasure.instruments.extreme import Extreme5000` or :code:`from pymeasure.instruments.extreme.extreme5000 import Extreme5000`. - 17 new instruments Deprecated features ------------------- - Remove :code:`TelnetAdapter`, as its library is deprecated (@BenediktBurger, #1045) - Replaced :code:`directory_input` keyword-argument of :code:`ManagedWindowBase` by :code:`enable_file_input` (@CasperSchippers, #964) - Make parameter :code:`includeSCPI` obligatory for all instruments, even those which use SCPI (@BenediktBurger, #1007) - Setting `includeSCPI=True` is deprecated, inherit instead the :code:`SCPIMixin` class if the device supports SCPI commands. - Replaced :code:`celcius` attribute of :code:`LakeShoreTemperatureChannel` by :code:`celsius` (@afuetterer, #1003) - Replaced :code:`error` property of Keithley instruments by :code:`next_error`. - Replaced :code:`measurement_time` property of Pendulum CNT-91 by :code:`gate_time`. - Replaced :code:`sample_rate` keyword-argument of :code:`buffer_frequency_time_series` of Pendulum CNT-91 by :code:`gate_time`. - Replaced MKS937B :code:`unit` to use :code:`instruments/mksinst/mks937b/Unit` instead of strings (@dkriegner, @BenediktBurger #1034) Instruments mechanics --------------------- - Add a SCPI base class :code:`SCPIMixin` as replacement for :code:`includeSCPI=True` (@BenediktBurger, #905, #1007, #1019, #1047) - Add :code:`next_error` property to SCPI instruments (@BenediktBurger, #1024) - Make :code:`query_delay=None` the default for :code:`wait_for` (@BenediktBurger, #1077) - Fix :code:`expected_protocol` using empty dictionary as default value (@BenediktBurger, #1087) - Remove auto-importing all instruments in :code:`pymeasure/instruments/__init__.py`` (@mcdo0486, #919) - Add :code:`find_serial_port` to find a serial port by providing USB information (@BenediktBurger, #982) Instruments ----------- - Add Agilent4294A (@driftregion, #998) - Add Agilent 4284A by (@ConnorGCarr #1079) - Add AimTTI PL series power supplies (@guuskuiper, #942) - Add HP11713A Switch & Attenuator Driver (@neuschs, #970) - Add HP437B power meter (@neuschs, #979) - Add Inficon SQM160 SQM-160 multi-film rate/thickness monitor (@dkriegner, #991) - Add Keithley 2182 (@ConnorGCarr, #1043) - Add KeithleyDMM6500 (@fwutw, #963) - Add Kepco BOP 36-12 Bipolar Power Supply (@JAW90, #1086) - Add KeysightE3631A (@OptimisticBeliever, #990) - Add Kuhne Electronic KU SG 2.45 250A microwave generator (@jurajjasik, @BenediktBurger, @1108) - Add MKS 974B vacuum pressure transducer (@dkriegner, #1034) - Add Proterial rod4 (@ConnorGCarr, #1044) - Add Racal-Dana 1992 universal counter (@tomverbeure, #798, #1012) - Add redpitaya board (@seb5g, #1010, #1035) - Add Teledyne HDO6xxx (@RobertoRoos, #868) - Add Yokogawa AQ6370D Optical Spectral Analyzer (@jnnskls, #1059) - Fix property docstrings of several instruments (@BenediktBurger, #1018) - Fix checksums of hcp TC038D tests (@BenediktBurger, #987) - Fix Hp8116a (@BenediktBurger, #1088) - Fix Hp856x to append amplitude units (@neuschs, #977) - Fix Keysight E36312A confirmed SCPI functionality (@Konradrundfunk, #1107) - Fix Stanford Research SR830 output conversion (@dkriegner, #1069) - Fix SR830 missing get_buffer method (@seb5g, #999) - Fix set command of SR860 aux output (@wehlgrundspitze, #1048) - Fix Temptronic test to use ns perf counter (@BenediktBurger, #1109, #1110) - Fix Toptica Ibeamsmart referencing removed adapter function (@BenediktBurger, #1065) - Fix typos in docstrings for Keithley instruments (@V0XNIHILI, #1071) - Link Keysight, Agilent, and HP documentation pages. (@BenediktBurger, #1021) - Update Agilent33500 Series from :code:`.ch[]` to :code:`.channels[]` (@AlecVercruysse, #945) - Update AWG401x driver to use 'channels' (@mcdo0486, #944) - Update HP33120A with new burst modulation parameters (@mzen228, #1056) - Update HP34401A with new remote control command. (@Rybok, #992) - Update Keithleys' next_error (@msmttchr, #1030) - Update pendulum CNT-91 (@bleykauf, #988) GUI --- - Add a :code:`FileInputWidget` to choose if and where the experiment data is stored. (@CasperSchippers, #964) - Add a default :code:`Queue` method for :code:`ManagedWindowBase` is implemented. (@CasperSchippers, #964) - Fix :code:`ScientificInput` to be locale compatible (@pyZerrenner, #1074) - Fix exception if loading result file with an empty parameter (@poje42, #1016) Miscellaneous ------------- - Add support for python 3.12 (@BenediktBurger, #1051) - Add support for numpy 2.0 (@CasperSchippers, #1026) - Add codecov to CI and to readme (@BenediktBurger, #1037, #1052, #1099) - Add citation file for PyMeasure repository (@mcdo0486, #1092) - Add release CI (@BenediktBurger, #1039) - Update readme with permanent Zenodo DOI (@BenediktBurger, #1095) - Bump CI dependencies to: pyvisa 1.13.0, checkout@v4 (@mcdo0486, #1097) - Fix/pandas futurewarning (@CasperSchippers, #1062) - Change copyright year. (@BenediktBurger, #1032) - Fix typos (@afuetterer, #1003) New Contributors ---------------- @guuskuiper, @OptimisticBeliever, @fwutw, @afuetterer, @poje42, @Rybok, @AlecVercruysse, @ConnorGCarr, @mzen228, @jnnskls, @V0XNIHILI, @pyZerrenner, @JAW90, @driftregion, @jurajjasik, @Konradrundfunk **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.13.1...v0.14.0 Version 0.13.1 (2023-10-05) =========================== New release to fix ineffective python version restriction in the project metadata (only affected Python<=3.7 environments installing via pip). Version 0.13.0 (2023-09-23) =========================== Main items of this new release: - Dropped support for Python 3.7, added support for Python 3.11. - Adds a test generator, which observes the communication with an actual device and writes protocol tests accordingly. - 2 new instrument drivers have been added. Deprecated features ------------------- - Attocube ANC300: The :code:`stepu` and :code:`stepd` properties are deprecated, use the new :code:`move_raw` method instead. (@dkriegner, #938) Instruments ----------- - Adds a test generator (@bmoneke, #882) - Adds Thyracont Smartline v2 vacuum sensor transmitter (@bmoneke, #940) - Adds Thyracont Smartline v1 vacuum gauge (@dkriegner, #937) - AddsTeledyne base classes with most of `LeCroyT3DSO1204` functionality (@RobertoRoos, #951) - Fixes instrument documentation (@mcdo0486, #941, #903, @omahs, #960) - Fixes Toptica Ibeamsmart's __init__ (@waveman68, #959) - Fixes VISAAdapter flush_read_buffer() (@ileu, #968) - Updates Keithley2306 and AFG3152C to Channels (@bilderbuchi, #953) GUI --- - Adds console mode (@msmttchr, #500) - Fixes Dock widget (@msmttchr, #961) Miscellaneous ------------- - Change CI from conda to mamba (@bmoneke, #947) - Add support for python 3.11 (@CasperSchippers, #896) New Contributors ---------------- @waveman68, @omahs, @ileu **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.12.0...v0.13.0 Version 0.12.0 (2023-07-05) =========================== Main items of this new release: - A :code:`Channel` base class has been added for easier implementation of instruments with channels. - 19 new instrument drivers have been added. - Added tests for some commonalities across all instruments. - We continue to clean up our API in preparation for a future version 1.0. Deprecations and subsequent removals are listed below. Deprecated features ------------------- - HP 34401A: :code:`voltage_ac`, :code:`current_dc`, :code:`current_ac`, :code:`resistance`, :code:`resistance_4w` properties, use :code:`function_` and :code:`reading` properties instead. - Toptica IBeamSmart: :code:`channel1_enabled`, use :code:`ch_1.enabled` property instead (equivalent for channel2). Also :code:`laser_enabled` is deprecated in favor of :code:`emission` (@bmoneke, #819). - TelnetAdapter: use :code:`VISAAdapter` instead. VISA supports TCPIP connections. Use the resource_name :code:`TCPIP[board]::::::SOCKET` to connect to a server (@Max-Herbold, #835). - Attocube ANC300: :code:`host` argument, pass a resource string or adapter as :code:`Adapter` passed to :code:`Instrument`. Now communicates through the :code:`VISAAdapter` rather than deprecated :code:`TelnetAdapter`. The initializer now accepts :code:`name` as its second keyword argument so all previous initialization positional arguments (`axisnames`, `passwd`, `query_delay`) should be switched to keyword arguments. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept arbitrary keyword arguments anymore. Use the :code:`v_kwargs` parameter for arguments you want to pass on to :code:`values` method, instead. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept `command_process` anymore. Use a dynamic property or a `Channel` instead, as appropriate (@bmoneke, #878). - See also the next section. New adapter and instrument mechanics ------------------------------------ - All instrument constructors are required to accept a :code:`name` argument. - Changed: :code:`read_bytes` of all Adapters by default does not stop reading on a termination character, unless the new argument :code:`break_on_termchar` is set to `True`. - Channel class added. :code:`Instrument.channels` and :code:`Instrument.ch_X` (:code:`X` is any channel name) are reserved attributes for channel mechanics. - The parameters :code:`check_get_errors` and :code:`check_set_errors` enable calling methods of the same name. This enables more systematically dealing with instruments that acknowledge every "set" command. - Adds Channel feature to instruments (@bmoneke, mcdo0486, #718, #761, #852, #931) - Adds :code:`maxsplit` parameter to :code:`values` method (@bmoneke, #793) - Adds (deprecated) global preprocess reply for backward compatibility (@bmoneke, #876) - Adds fallback version for discarding the read buffer to VISAAdapter (@dkriegner, #836) - Adds :code:`flush_read_buffer` to SerialAdapter (@RobertoRoos, #865) - Adds :code:`gpib_read_timeout` to PrologixAdapter (@neuschs, #927) - Adds command line option to pass resource address for instrument tests (@bleykauf, #789) - Adds "find all instruments" and channels for testing (@bmoneke, #909, @mcdo0486, #911, #912) - Adds test that an instrument hands kwargs to the adapter (@bmoneke, #814) - Adds property docstring check (@bmoneke, #895) - Improves property factories' docstrings (@bmoneke, #843) - Improves property factories: do not allow undefined kwargs (@bmoneke, #856) - Improves property factories: check_set/get_errors argument to call methods of the same name (@bmoneke, #883) - Improves :code:`read_bytes` of Adapter (@bmoneke, #839) - Improves the ProtocolAdapter with a mock connection (@bmoneke, #782), and enable it to have empty messages in the protocol (@bmoneke, #818) - Improves Prologix adapter documentation (@bmoneke, #813) and configurable settings (@bmoneke, #845) - Improves behavior of :code:`read_bytes(-1)` for :code:`SerialAdapter` (@RobertoRoos, #866) - Improves all instruments with name kwarg (@bmoneke, #877) - Improves VisaAdapter: close manager only when using pyvisa-sim (@dkriegner, #900) - Harmonises instrument name definition pattern, consistently name the instrument connection argument "adapter" (@bmoneke, #659) - Fixes ProtocolAdapter has list in signature (@bmoneke, #901) - Fixes VISAAdapter's :code:`read_bytes` (@bmoneke, #867) - Fixes query_delay usage in VISAAdapter (@bmoneke, #765) - Fixes VisaAdapter: close resource manager only when using pyvisa-sim (@dkriegner, #900) Instruments ----------- - New Advantest R624X DC Voltage/Current Sources/Monitors (@wichers, #802) - New AJA International DC sputtering power supply (@dkriegner, #778) - New Anritus MS2090A (@aruznieto, #787) - New Anritsu MS4644B (@CasperSchippers, #827) - New DSP 7225 and new DSPBase instrument (@mcdo0486, #902) - New HP 8560A / 8561B Spectrum Analyzer (@neuschs, #888) - New IPG Photonics YAR Amplifier series (@bmoneke, #851) - New Keysight E36312A power supply (@scandey, #785) - New Keithley 2200 power supply (@ashokbruno, #806) - New Lake Shore 211 Temperature Monitor (@mcdo0486, #889) - New Lake Shore 224 and improves Lakeshore instruments (@samcondon4, #870) - New MKS Instruments 937B vacuum gauge controller (@dkriegner, @bilderbuchi, #637, #772, #936) - New Novanta FPU60 laser power supply unit (@bmoneke, #885) - New TDK Lambda Genesys 80-65 DC and 40-38 DC power supplies (@mcdo0486, 906) - New Teledyne T3AFG waveform generator instrument (@scandey, #791) - New Teledyne (LeCroy) T3DSO1204 Oscilloscope (@LastStartDust, #697, @bilderbuchi, #770) - New T&C Power Conversion RF power supply (@dkriegner, #800) - New Velleman K8090 relay device (@RobertoRoos, #859) - Improves Agilent 33500 with the new channel feature (@JCarl-OS, #763, #773) - Improves HP 3478A with calibration data related functions (@tomverbeure, #777) - Improves HP 34401A (@CodingMarco, #810) - Improves the Oxford instruments with the new channel feature (@bmoneke, #844) - Improves Siglent SPDxxxxX with the new channel feature (@AidenDawn 758) - Improves Teledyne T3DSO1204 device tests (@LastStarDust, #841) - Fixes Ametek DSP 7270 lockin amplifier issues (@seb5g, #897) - Fixes DSP 7265 erroneously using preprocess_reply (@mcdo0486, #873) - Fixes print statement in DSPBase.sensitivity (@mcdo0486, #915) - Fixes Fluke bath commands (@bmoneke, #874) - Fixes a frequency limitation in HP 8657B (@LongnoseRob, #769) - Fixes Keithley 2600 channel calling parent's shutdown (@mcdo0486, #795) Automation ---------- - Adds tolerance for opening result files with missing parameters (@msmttchr, #780) - Validate DATA_COLUMNS entries earlier, avoid exceptions in a running procedure (@mcdo0486, #796, #934) GUI --- - Adds docking windows (@mcdo0486, #722, #762) - Adds save plot settings in addition to dock layout (@mcdo0486, #850) - Adds log widget colouring and format option (@CasperSchippers, #890) - Adds table widget (@msmttchr, #771) - New sequencer architecture: decouples it from the graphical tree, adapts it for further expansions (@msmttchr, #518) - Moves coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - Fixes crashing ImageWidget at new measurement (@CasperSchippers, #790) - Fixes checkboxes not working for groups in inputs-widget (@CasperSchippers, #794) Miscellaneous ------------- - Adds a collection of solutions for instrument implementation challenges (@bmoneke, #853, #861) - Updates Tutorials/Making_a_measurement/ example_codes (@sansanda, #749) New Contributors ---------------- @JCarl-OS, @aruznieto, @scandey, @tomverbeure, @wichers, @Max-Herbold, @RobertoRoos **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.1...v0.12.0 Version 0.11.1 (2022-12-31) =========================== Adapter and instrument mechanics -------------------------------- - Fix broken `PrologixAdapter.gpib`. Due to a bug in `VISAAdapter`, you could not get a second adapter with that connection (#765). **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.0...v0.11.1 Dependency updates ------------------ - Required version of `PyQtGraph `__ is increased from :code:`pyqtgraph >= 0.9.10` to :code:`pyqtgraph >= 0.12` to support new PyMeasure display widgets. GUI --- - Added `ManagedDockWindow `__ to allow multiple dockable plots (@mcdo0486, @CasperSchippers, #722) - Move coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - New sequencer architecture (@msmttchr, @CasperSchippers, @mcdo0486, #518) - Added "Save Dock Layout" functionality to DockWidget context menu. (@mcdo0486, #762) Version 0.11.0 (2022-11-19) =========================== Main items of this new release: - 11 new instrument drivers have been added - A method for testing instrument communication **without** hardware present has been added, see `the documentation `__. - The separation between :code:`Instrument` and :code:`Adapter` has been improved to make future modifications easier. Adapters now focus on the hardware communication, and the communication *protocol* should be defined in the Instruments. Details in a section below. - The GUI is now compatible with Qt6. - We have started to clean up our API in preparation for a future version 1.0. There will be deprecations and subsequent removals, which will be prominently listed in the changelog. Deprecated features ------------------- In preparation for a stable 1.0 release and a more consistent API, we have now started formally deprecating some features. You should get warnings if those features are used. - Adapter methods :code:`ask`, :code:`values`, :code:`binary_values`, use :code:`Instrument` methods of the same name instead. - Adapter parameter :code:`preprocess_reply`, override :code:`Instrument.read` instead. - :code:`Adapter.query_delay` in favor of :code:`Instrument.wait_for()`. - Keithley 2260B: :code:`enabled` property, use :code:`output_enabled` instead. New adapter and instrument mechanics ------------------------------------ - Nothing should have changed for users, this section is mainly interesting for instrument implementors. - Documentation in 'Advanced communication protocols' in 'Adding instruments'. - Adapter logs written and read messages. - Particular adapters (`VISAAdapter` etc.) implement the actual communication. - :code:`Instrument.control` getter calls :code:`Instrument.values`. - :code:`Instrument.values` calls :code:`Instrument.ask`, which calls :code:`Instrument.write`, :code:`wait_for`, and :code:`read`. - All protocol quirks of an instrument should be implemented overriding :code:`Instrument.write` and :code:`read`. - :code:`Instrument.wait_until_read` implements waiting between writing and reading. - reading/writing binary values is in the :code:`Adapter` class itself. - :code:`PrologixAdapter` is now based on :code:`VISAAdapter`. - :code:`SerialAdapter` improved to be more similar to :code:`VISAAdapter`: :code:`read`/:code:`write` use strings, :code:`read/write_bytes` bytes. - Support for termination characters added. Instruments ----------- - New Active Technologies AWG-401x (@garzetti, #649) - New Eurotest hpp_120_256_ieee (@sansanda, #701) - New HC Photonics crystal ovens TC038, TC038D (@bmoneke, #621, #706) - New HP 6632A/6633A/6634A power supplies (@LongnoseRob, #651) - New HP 8657B RF signal generator (@LongnoseRob, #732) - New Rohde&Schwarz HMP4040 power supply. (@bleykauf, #582) - New Siglent SPDxxxxX series Power Supplies (@AidenDawn, #719) - New Temptronic Thermostream devices (@mroeleke, #368) - New TEXIO PSW-360L30 Power Supply (@LastStarDust, #698) - New Thermostream ECO-560 (@AidenDawn, #679) - New Thermotron 3800 Oven (@jcarbelbide, #606) - Harmonize instruments' adapter argument (@bmoneke, #674) - Harmonize usage of :code:`shutdown` method (@LongnoseRob, #739) - Rework Adapter structure (@bmoneke, #660) - Add Protocol tests without hardware present (@bilderbuchi, #634, @bmoneke, #628, #635) - Add Instruments and adapter protocol tests for adapter rework (@bmoneke, #665) - Add SR830 sync filter and reference source trigger (@AsafYagoda, #630) - Add Keithley6221 phase marker phase and line (@AsafYagoda, #629) - Add missing docstrings to Keithley 2306 battery simulator (@AidenDawn, #720) - Fix hcp instruments documentation (@bmoneke, #671) - Fix HPLegacyInstrument initializer API (@bilderbuchi, #684) - Fix Fwbell 5080 implementation (@mcdo0486, #714) - Fix broken documentation example. (@bmoneke, #738) - Fix typo in Keithley 2600 driver (@mcdo0486, #615) - Remove dynamic use of docstring from ATS545 and make more generic (@AidenDawn, #685) Automation ---------- - Add storing unitful experiment results (@bmoneke, #642) - Add storing conditions in file (@CasperSchippers, #503) GUI --- - Add compatibility with Qt 6 (@CasperSchippers, #688) - Add spinbox functionality for IntegerParameter and FloatParameter (@jarvas24, #656) - Add "delete data file" button to the browser_item_menu (@jarvas24, #654) - Split windows.py into a folder with separate modules (@mcdo0486, #593) - Remove dependency on matplotlib (@msmttchr, #622) - Remove deprecated access to QtWidgets through QtGui (@maederan201, #695) Miscellaneous ------------- - Update and extend documentation (@bilderbuchi, #712, @bmoneke, #655) - Add PEP517 compatibility & dynamically obtaining a version number (@bilderbuchi, #613) - Add an example and documentation regarding using a foreign instrument (@bmoneke, #647) - Add black configuration (@bleykauf, #683) - Remove VISAAdapter.has_supported_version() as it is not needed anymore. New Contributors ---------------- @jcarbelbide, @mroeleke, @bmoneke, @garzetti, @AsafYagoda, @AidenDawn, @LastStarDust, @sansanda **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.10.0...v0.11.0 Version 0.10.0 (2022-04-09) =========================== Main items of this new release: - 23 new instrument drivers have been added - New dynamic Instrument properties can change their parameters at runtime - Communication settings can now be flexibly defined per protocol - Python 3.10 support was added and Python 3.6 support was removed. - Many additions, improvements and have been merged Instruments ----------- - New Agilent B1500 Data Formats and Documentation (@moritzj29) - New Anaheim Automation stepper motor controllers (@samcondon4) - New Andeen Hagerling capacitance bridges (@dkriegner) - New Anritsu MS9740A Optical Spectrum Analyzer (@md12g12) - New BK Precision 9130B Instrument (@dennisfeng2) - New Edwards nXDS (10i) Vacuum Pump (@hududed) - New Fluke 7341 temperature bath instrument (@msmttchr) - New Heidenhain ND287 Position Display Unit Driver (@samcondon4) - New HP 3478A (@LongnoseRob) - New HP 8116A 50 MHz Pulse/Function Generator (@CodingMarco) - New Keithley 2260B DC Power Supply (@bklebel) - New Keithley 2306 Dual Channel Battery/Charger Simulator (@mfikes) - New Keithley 2600 SourceMeter series (@Daivesd) - New Keysight N7776C Swept Laser Source (@maederan201) - New Lakeshore 421 (@CasperSchippers) - New Oxford IPS120-10 (@CasperSchippers) - New Pendulum CNT-91 frequency counter (@bleykauf) - New Rohde&Schwarz - SFM TV test transmitter (@LongnoseRob) - New Rohde&Schwarz FSL spectrum analyzer (@bleykauf) - New SR570 current amplifier driver (@pyMatJ) - New Stanford Research Systems SR510 instrument driver (@samcondon4) - New Toptica Smart Laser diode (@dkriegner) - New Yokogawa GS200 Instrument (@dennisfeng2) - Add output low grounded property to Keithley 6221 (@CasperSchippers) - Add shutdown function for Keithley 2260B (@bklebel) - Add phase control for Agilent 33500 (@corna) - Add assigning "ONCE" to auto_zero to Keithley 2400 (@mfikes) - Add line frequency controls to Keithley 2400 (@mfikes) - Add LIA and ERR status byte read properties to the SRS Sr830 driver (@samcondon4) - Add all commands to Oxford Intelligent Temperature Controller 503 (@CasperSchippers) - Fix DSP 7265 lockin amplifier (@CasperSchippers) - Fix bug in Keithley 6517B Electrometer (@CasperSchippers) - Fix Keithley2000 deprecated call to visa.config (@bklebel) - Fix bug in the Keithley 2700 (@CasperSchippers) - Fix setting of sensor flags for Thorlabs PM100D (@bleykauf) - Fix SCPI used for Keithley 2400 voltage NPLC (@mfikes) - Fix missing return statements in Tektronix AFG3152C (@bleykauf) - Fix DPSeriesMotorController bug (@samcondon4) - Fix Keithley2600 error when retrieving error code (@bicarlsen) - Fix Attocube ANC300 with new SCPI Instrument properties (@dkriegner) - Fix bug in wait_for_trigger of Agilent33220A (neal-kepler) GUI --- - Add time-estimator widget (@CasperSchippers) - Add management of progress bar (@msmttchr) - Remove broken errorbar feature (@CasperSchippers) - Change of pen width for pyqtgraph (@maederan201) - Make linewidth changeable (@CasperSchippers) - Generalise warning in plotter section (@CasperSchippers) - Implement visibility groups in InputsWidgets (@CasperSchippers) - Modify navigation of ManagedWindow directory widget (@jarvas24) - Improve Placeholder logic (@CasperSchippers) - Breakout widgets into separate modules (@mcdo0486) - Fix setSizePolicy bug with PySide2 (@msmttchr) - Fix managed window (@msmttchr) - Fix ListParameter for numbers (@moritzj29) - Fix incorrect columns on showing data (@CasperSchippers) - Fix procedure property issue (@msmttchr) - Fix pyside2 (@msmttchr) Miscellaneous ------------- - Improve SCPI property support (@msmttchr) - Remove broken safeKeyword management (@msmttchr) - Add dynamic property support (@msmttchr) - Add flexible API for defining connection configuration (@bilderbuchi) - Add write_binary_values() to SerialAdapter (@msmttchr) - Change an outdated pyvisa ask() to query() (@LongnoseRob) - Fix ZMQ bug (@bilderbuchi) - Documentation for passing tuples to control property (@bklebel) - Documentation bugfix (@CasperSchippers) - Fixed broken links in documentation. (@samcondon4) - Updated widget documentation (@mcdo0486) - Fix typo SCIP->SCPI (@mfikes) - Remove Python 3.6, add Python 3.10 testing (@bilderbuchi) - Modernise the code base to use Python 3.7 features (@bilderbuchi) - Added image data generation to Mock Instrument class (@samcondon4) - Add autodoc warnings to the problem matcher (@bilderbuchi) - Update CI & annotations (@bilderbuchi) - Test workers (@mcdo0486) - Change copyright date to 2022 (@LongnoseRob) - Removed unused code (@msmttchr) New Contributors ---------------- @LongnoseRob, @neal, @hududed, @corna, @Daivesd, @samcondon4, @maederan201, @bleykauf, @mfikes, @bicarlsen, @md12g12, @CodingMarco, @jarvas24, @mcdo0486! **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.9...v0.10.0 Version 0.9 -- released 2/7/21 ============================== - PyMeasure is now officially at github.com/pymeasure/pymeasure - Python 3.9 is now supported, Python 3.5 removed due to EOL - Move to GitHub Actions from TravisCI and Appveyor for CI (@bilderbuchi) - New additions to Oxford Instruments ITC 503 (@CasperSchippers) - New Agilent 34450A and Keysight DSOX1102G instruments (@theMashUp, @jlarochelle) - Improvements to NI VirtualBench (@moritzj29) - New Agilent B1500 instrument (@moritzj29) - New Keithley 6517B instrument (@wehlgrundspitze) - Major improvements to PyVISA compatbility (@bilderbuchi, @msmttchr, @CasperSchippers, @cjermain) - New Anapico APSIN12G instrument (@StePhanino) - Improvements to Thorelabs Pro 8000 and SR830 (@Mike-HubGit) - New SR860 instrument (@StevenSiegl, @bklebel) - Fix to escape sequences (@tirkarthi) - New directory input for ManagedWindow (@paulgoulain) - New TelnetAdapter and Attocube ANC300 Piezo controller (@dkriegner) - New Agilent 34450A (@theMashUp) - New Razorbill RP100 strain cell controller (@pheowl) - Fixes to precision and default value of ScientificInput and FloatParameter (@moritzj29) - Fixes for Keithly 2400 and 2450 controls (@pyMatJ) - Improvments to Inputs and open_file_externally (@msmttchr) - Fixes to Agilent 8722ES (@alexmcnabb) - Fixes to QThread cleanup (@neal-kepler, @msmttchr) - Fixes to Keyboard interrupt, and parameters (@CasperSchippers) Version 0.8 -- released 3/29/19 =============================== - Python 3.8 is now supported - New Measurement Sequencer allows for running over a large parameter space (@CasperSchippers) - New image plotting feature for live image measurements (@jmittelstaedt) - Improvements to VISA adapter (@moritzj29) - Added Tektronix AFG 3000, Keithley 2750 (@StePhanino, @dennisfeng2) - Documentation improvements (@mivade) - Fix to ScientificInput for float strings (@moritzj29) - New validator: strict_discrete_range (@moritzj29) - Improvements to Recorder thread joining - Migrating the ReadtheDocs configuration to version 2 - National Instruments Virtual Bench initial support (@moritzj29) Version 0.7 -- released 8/4/19 ============================== - Dropped support for Python 3.4, adding support for Python 3.7 - Significant improvements to CI, dependencies, and conda environment (@bilderbuchi, @cjermain) - Fix for PyQT issue in ResultsDialog (@CasperSchippers) - Fix for wire validator in Keithley 2400 (@Fattotora) - Addition of source_enabled control for Keithley 2400 (@dennisfeng2) - Time constant fix and input controls for SR830 (@dennisfeng2) - Added Keithley 2450 and Agilent 33521A (@hlgirard, @Endever42) - Proper escaping support in CSV headers (@feph) - Minor updates (@dvase) Version 0.6.1 -- released 4/21/19 ================================= - Added Elektronica SM70-45D, Agilent 33220A, and Keysight N5767A instruments (@CasperSchippers, @sumatrae) - Fixes for Prologix adapter and Keithley 2400 (@hlgirard, @ronan-sensome) - Improved support for SRS SR830 (@CasperSchippers) Version 0.6 -- released 1/14/19 =============================== - New VXI11 Adapter for ethernet instruments (@chweiser) - PyQt updates to 5.6.0 - Added SRS SG380, Ametek 7270, Agilent 4156, HP 34401A, Advantest R3767CG, and Oxford ITC503 instrustruments (@sylkar, @jmittelstaedt, @vik-s, @troylf, @CasperSchippers) - Updates to Keithley 2000, Agilent 8257D, ESP 300, and Keithley 2400 instruments (@watersjason, @jmittelstaedt, @nup002) - Various minor bug fixes (@thosou) Version 0.5.1 -- released 4/14/18 ================================= - Minor versions of PyVISA are now properly handled - Documentation improvements (@Laogeodritt and @ederag) - Instruments now have :code:`set_process` capability (@bilderbuchi) - Plotter now uses threads (@dvspirito) - Display inputs and PlotItem improvements (@Laogeodritt) Version 0.5 -- released 10/18/17 ================================ - Threads are used by default, eliminating multiprocessing issues with spawn - Enhanced unit tests for threading - Sphinx Doctests are added to the documentation (@bilderbuchi) - Improvements to documentation (@JuMaD) Version 0.4.6 -- released 8/12/17 ================================= - Reverted multiprocessing start method keyword arguments to fix Unix spawn issues (@ndr37) - Fixes to regressions in Results writing (@feinsteinben) - Fixes to TCP support using cloudpickle (@feinsteinben) - Restructing of unit test framework Version 0.4.5 -- released 7/4/17 ================================ - Recorder and Scribe now leverage QueueListener (@feinsteinben) - PrologixAdapter and SerialAdapter now handle Serial objects as adapters (@feinsteinben) - Optional TCP support now uses cloudpickle for serialization (@feinsteinben) - Significant PEP8 review and bug fixes (@feinsteinben) - Includes docs in the code distribution (@ghisvail) - Continuous integration support for Python 3.6 (@feinsteinben) Version 0.4.4 -- released 6/4/17 ================================ - Fix pip install for non-wheel builds - Update to Agilent E4980 (@dvspirito) - Minor fixes for docs, tests, and formatting (@ghisvail, @feinsteinben) Version 0.4.3 -- released 3/30/17 ================================= - Added Agilent E4980, AMI 430, Agilent 34410A, Thorlabs PM100, and Anritsu MS9710C instruments (@TvBMcMaster, @dvspirito, and @mhdg) - Updates to PyVISA support (@minhhaiphys) - Initial work on resource manager (@dvspirito) - Fixes for Prologix adapter that allow read-write delays (@TvBMcMaster) - Fixes for conda environment on continuous integration Version 0.4.2 -- released 8/23/16 ================================= - New instructions for installing with Anaconda and conda-forge package (thanks @melund!) - Bug-fixes to the Keithley 2000, SR830, and Agilent E4408B - Re-introduced the Newport ESP300 motion controller - Major update to the Keithely 2400, 2000 and Yokogawa 7651 to achieve a common interface - New command-string processing hooks for Instrument property functions - Updated LakeShore 331 temperature controller with new features - Updates to the Agilent 8257D signal generator for better feature exposure Version 0.4.1 -- released 7/31/16 ================================= - Critical fix in setup.py for importing instruments (also added to documentation) Version 0.4 -- released 7/29/16 =============================== - Replaced Instrument add_measurement and add_control with measurement and control functions - Added validators to allow Instrument.control to match restricted ranges - Added mapping to Instrument.control to allow more flexible inputs - Conda is now used to set up the Python environment - macOS testing in continuous integration - Major updates to the documentation Version 0.3 -- released 4/8/16 ============================== - Added IPython (Jupyter) notebook support with significant features - Updated set of example scripts and notebooks - New PyMeasure logo released - Removed support for Python <3.4 - Changed multiprocessing to use spawn for compatibility - Significant work on the documentation - Added initial tests for non-instrument code - Continuous integration setup for Linux and Windows Version 0.2 -- released 12/16/15 ================================ - Python 3 compatibility, removed support for Python 2 - Considerable renaming for better PEP8 compliance - Added MIT License - Major restructuring of the package to break it into smaller modules - Major rewrite of display functionality, introducing new Qt objects for easy extensions - Major rewrite of procedure execution, now using a Worker process which takes advantage of multi-core CPUs - Addition of a number of examples - New methods for listening to Procedures, introducing ZMQ for TCP connectivity - Updates to Keithley2400 and VISAAdapter Version 0.1.6 -- released 4/19/15 ================================= - Renamed the package to PyMeasure from Automate to be more descriptive about its purpose - Addition of VectorParameter to allow vectors to be input for Procedures - Minor fixes for the Results and Danfysik8500 Version 0.1.5 -- release 10/22/14 ================================= - New Manager class for handling Procedures in a queue fashion - New Browser that works in tandem with the Manager to display the queue - Bug fixes for Results loading Version 0.1.4 -- released 8/2/14 ================================ - Integrated Results class into display and file writing - Bug fixes for Listener classes - Bug fixes for SR830 Version 0.1.3 -- released 7/20/14 ================================= - Replaced logging system with Python logging package - Added data management (Results) and bug fixes for Procedures and Parameters - Added pandas v0.14 to requirements for data management - Added data listeners, Qt4 and PyQtGraph helpers Version 0.1.2 -- released 7/18/14 ================================= - Bug fixes to LakeShore 425 - Added new Procedure and Parameter classes for generic experiments - Added version number in package Version 0.1.1 -- released 7/16/14 ================================= - Bug fixes to PrologixAdapter, VISAAdapter, Agilent 8722ES, Agilent 8257D, Stanford SR830, Danfysik8500 - Added Tektronix TDS 2000 with basic functionality - Fixed Danfysik communication to handle errors properly Version 0.1.0 -- released 7/15/14 ================================= - Initial release ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0705125 pymeasure-0.16.0/PyMeasure.egg-info/0000755000175100017510000000000015203313301016651 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275456.0 pymeasure-0.16.0/PyMeasure.egg-info/PKG-INFO0000644000175100017510000015073415203313300017757 0ustar00runnerrunnerMetadata-Version: 2.4 Name: PyMeasure Version: 0.16.0 Summary: Scientific measurement library for instruments, experiments, and live-plotting Author: PyMeasure Developers License: MIT Project-URL: Repository, https://github.com/pymeasure/pymeasure Project-URL: Issues, https://github.com/pymeasure/pymeasure/issues Project-URL: Documentation, https://pymeasure.readthedocs.io Keywords: measure,instrument,experiment control,automate,graph,plot Classifier: Development Status :: 4 - Beta Classifier: Intended Audience :: Science/Research Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: MacOS Classifier: Operating System :: Microsoft :: Windows Classifier: Operating System :: POSIX Classifier: Operating System :: Unix Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Topic :: Scientific/Engineering Requires-Python: >=3.9 Description-Content-Type: text/x-rst License-File: LICENSE.txt Requires-Dist: numpy<3,>=1.6.1 Requires-Dist: pandas<4,>=0.14 Requires-Dist: pint Requires-Dist: pyvisa>=1.9 Requires-Dist: pyserial>=2.7 Requires-Dist: pyqtgraph>=0.12 Requires-Dist: qtpy>=2.4 Provides-Extra: tcp Requires-Dist: pyzmq>=16.0.2; extra == "tcp" Requires-Dist: cloudpickle>=0.3.1; extra == "tcp" Provides-Extra: tests Requires-Dist: pytest>=3.3.0; extra == "tests" Requires-Dist: pytest-cov>=4.1.0; extra == "tests" Requires-Dist: pytest-qt>=2.4.0; extra == "tests" Requires-Dist: pyvisa-sim>=0.4.0; extra == "tests" Provides-Extra: docs Requires-Dist: sphinx>=5.0.0; extra == "docs" Requires-Dist: sphinx_rtd_theme>=1.1.0; extra == "docs" Requires-Dist: sphinx_autodoc_typehints>=2.3.0; extra == "docs" Dynamic: license-file .. image:: https://raw.githubusercontent.com/pymeasure/pymeasure/master/docs/images/PyMeasure.png :alt: PyMeasure Scientific package PyMeasure scientific package ############################ PyMeasure makes scientific measurements easy to set up and run. The package contains a repository of instrument classes and a system for running experiment procedures, which provides graphical interfaces for graphing live data and managing queues of experiments. Both parts of the package are independent, and when combined provide all the necessary requirements for advanced measurements with only limited coding. PyMeasure is currently under active development, so please report any issues you experience to our `Issues page`_. .. _Issues page: https://github.com/pymeasure/pymeasure/issues Project Information ------------------- PyMeasure is tested with continuous-integration on Linux, macOS, and Windows for all supported Python versions. .. image:: https://img.shields.io/pypi/pyversions/pymeasure :alt: PyPI - Python Version .. image:: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml/badge.svg :target: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml .. image:: http://readthedocs.org/projects/pymeasure/badge/?version=latest :target: http://pymeasure.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.595633.svg :target: https://doi.org/10.5281/zenodo.595633 .. image:: https://anaconda.org/conda-forge/pymeasure/badges/version.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://anaconda.org/conda-forge/pymeasure/badges/downloads.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://codecov.io/gh/pymeasure/pymeasure/graph/badge.svg :target: https://codecov.io/gh/pymeasure/pymeasure Related Projects ---------------- - `LECO Protocol `_: Open standard for laboratory equipment communication using modern protocols - `pyleco `_: Python library implementing LECO for distributed instrument control systems - `Python Lab Automation Landscape `_: Curated collection of Python tools for laboratory automation and instrumentation Quick start =========== Check out `the documentation`_ for the `quick start guide`_, that covers the installation of Python and PyMeasure. There are a number of examples in the `examples`_ directory that can help you get up and running. .. _the documentation: http://pymeasure.readthedocs.org/en/latest/ .. _quick start guide: http://pymeasure.readthedocs.io/en/latest/quick_start.html .. _examples: https://github.com/pymeasure/pymeasure/tree/master/examples Version 0.16.0 (2026-05-20) =========================== Main items of this new release: - Add support for Python 3.13 - Change policy to allow type hints (added already to instruments core) - 25 new instruments - :code:`Instrument.control` does not apply :code:`get_process` to a returned list anymore, only to a single value. Use :code:`get_process_list` parameter instead for processing a list of values. - Improve implementation of Keithley 2400, with some changes in functionality. Legacy implementation has been kept as :code:`Keithley2400Legacy`. Removed ------- - Remove support for Python 3.8 - Remove deprecated Adapter and Instrument parameters :code:`preprocess_reply`, :code:`query_delay` - Remove deprecated Adapter methods :code:`ask`, :code:`values`, and :code:`binary_values` - Remove deprecated Telnet and VXI adapters Deprecated ---------- - Replace :code:`sensitvity` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`sensitivity` - Replace :code:`filer_synchronous` attribute of :code:`pymeasure/instruments/srs/SR860.py` by :code:`filter_synchronous` - Replace :code:`query_operation_mode` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`operation_mode` property - Replace :code:`query_system_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`system_settings` property - Replace :code:`interrupt_sequence_command` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`interrupt_sequence` - Replace :code:`sequence_program_listing` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`query_sequence_program` - Replace :code:`digital_out_enable_data` attribute of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`digital_output_enable` - Replace :code:`query_output_waveform` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`output_waveform_settings` property - Replace :code:`query_measurement_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`measurement_range_settings` property - Replace :code:`query_response_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`response_settings` property - Replace :code:`query_data_output_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`data_output_settings` property - Replace :code:`query_io_settings` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`io_settings` property - Replace :code:`calibration_init` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`init_calibration` - Replace :code:`calibration_store_factor` method of :code:`pymeasure/instruments/advantest/advantestR624X.py` by :code:`store_calibration_factor` Instruments ----------- - Add Aculight Argos OPO laser system (@BenediktBurger, #1046) - Add Agilent 33250A waveform generator (@PeterPirog, #1425) - Add Agilent B2980 electrometer series (@Falk3579, #1296) - Add Agilent E5270B (@Falk3579, #1340, #1359, #1365) - Add Agilent N8975A noise figure analyzer (@Falk3579, #1397) - Add FormFactor Velox Waferprobers (@Falk3579, #1385) - Add Ilxlightwave ldp3811 pulsed current source (@fg-lumentum, #1367) - Add Keithley 2510 Sourcemeter (@fg-lumentum, #1239, #1333) - Add Keithley 4200A-SCS (@Falk3579, #1332) - Add Keysight 81160A Pulse Function Arbitrary Noise Generator (@ilev-sergey, #1250) - Add Keysight PNAs (@Falk3579, #1356) - Add LakeShore 3xx temperature controllers (@DF9AS, #1334) - Add Oxford Instruments Mercury Intelligent Temperature Controller (@JAW90, #1198) - Add PTW Diamentor DAP dosemeter (@Falk3579, #1302, #1449) - Add PTW UNIDOS dosemeters (@Falk3579, #1279, #1442) - Add Santec TSL-500 series tunable laser with TSL-550 and TSL-770 (@fg-lumentum, #1253, #1390) - Add Siglent oscilloscope SDS1000XHD (@lucasbraud, #1325) - Add Spellman XRV high voltage power supplies (@Falk3579, #1329, #1440) - Add SRS LDC500Series (@fg-lumentum, #1278, #1346) - Add Thorlabs mbx series (@fg-lumentum, #1361) - Fix Temptronic tests (@ilev-sergey, #1277) - Fix HP3478A: use :code:`write_binary_values()` to request calibration data (@dl8dtl, #1263) - Fix docstring in Keithley4200 (@Falk3579, #1339) - Fix parameter ranges for Agilent33220A (@Patschke, #1342) - Fix Keithley 2000 :code:`voltage_nplc` and :code:`enable_filter` (@d-el, @chieh0517, #1360, #1393) - Fix :code:`read` of Racal 1992 (@BenediktBurger, #1355) - Update old docstrings to new style (@BenediktBurger, #1247, #1243) - Update Advantest R624X driver with sequence builders, hardware-verified fixes, and documentation (@wichers, #1408) - Update Agilent channels (@BenediktBurger, #1089) - Update Agilent 33500 properties and add SCPI mixin (@ilev-sergey, #1245, #1246) - Update Agilent 34450 with :code:`local()` and protocol tests (@Falk3579, #1427, #1436) - Update Agilent 4284A with new correction functionality (@Falk3579, #1304) - Update Agilent B1500 with SPGU and CMU module support and new documentation (@ilev-sergey, #1380, #1344, #1412) - Update Agilent B1500 SMU class to inherit from :code:`Channel` (@ilev-sergey, #1387) - Update Agilent E4408B with SCPIMixin and new docstrings (@BenediktBurger, #1438) - Update Agilent E4980A with tests (@Falk3579, #1300) - Update Keithley 2400 with a major rework (@fg-lumentum, #1347) - Update Keithley 2450's docstring to inform that buffer handling is currently unsupported (@dsimat, #1238) - Update Keithley 6221 with delta mode (@panasee, #1242) - Update MS464xB docstrings (@Falk3579, #1352) - Update SRS 860 with better method names (@panasee, #1289) - Update SRS 860 min ampl (@chieh0517, #1426) - Update Yokogawa Aq6370 series with sensitivity control sweep status, and with connections and traces (@fg-lumentum, @BenediktBurger, #1138, #1234, #1286, #1354) Instruments mechanics --------------------- - Add :code:`_write_bytes()` and :code:`_read_bytes()` for Prologix adapter (@dl8dtl, #1259) - Add handling of SerialException in :code:`list_resources()` (@hvegh, #1287) - Add :code:`get_process_list` and make it dynamic (@BenediktBurger, @Falk3579, #1291, #1313, #1315) - Add typing to :code:`expected_protocol`, adapters, and :code:`Instrument` (@BenediktBurger, #1084, #1331) - Add concrete hint to property creators in docstring list (@BenediktBurger, #1281) - Add SCPI mixin test for devices (@fg-lumentum, #1391) - Update Prologix documentation (@dl8dtl, #1272) Automation ---------- - Add qtpy dependency for Qt version shimming (@Benbriel, #1285) - Add :code:`description` to :code:`Parameters` (@Benbriel, #1211) - Update procedures to emit results in batches (@jvdoorn, #1256) - Replace numeric constants by respective Qt enum values (@dl8dtl, #1265) - Use :code:`np.frombuffer` for removed :code:`np.fromstring(sep="")` (@BenediktBurger, #1330) - Update BooleanParameter to accept numpy.bool (@Falk3579, #1373) - In workers, check should_stop after :code:`startup()` before `execute()` (@breakU1, #1445) - Add vector parameter input (@Falk3579, #1376, #1377, #1382) - Replace :code:`load_module()` by :code:`exec_module()` (@Falk3579, #1415) - Add file size checking to :code:`Results.data` property to skip reading file if data hasn't changed. (@mcdo0486, #1429) GUI --- - Add a console widget (@breakU1, #1431) - Update custom_ui and image_gui examples (@CasperSchippers, @Falk3579, #1266, #1337) - Update managed window with support for multi-selection for deleting and removing experiments (@breakU1, #1451) - Fix 'Ohm' units in examples (@Falk3579, #1338) Documentation ------------- - Update documentation regarding type hints (@BenediktBurger, #1324) - Add sphinx-autodoc-typehints extension (@ilev-sergey, #1406) - Add AGENTS.md file for AI coding agents (@BenediktBurger, #1372) - Update Read the Docs to Ubuntu 24.04 (@cjermain, #1419) - Fix documentation typos (@ilev-sergey, #1249) Miscellaneous ------------- - Add related projects to documentation (@BenediktBurger, #1335) - Add uv.lock file to gitignore (@maederan201, #1453) - Add Python 3.13 support. (@BenediktBurger, #1173) - Add dependapot configuration (@BenediktBurger, #1307) - Remove deprecated parts (@BenediktBurger, #1268) - Remove support for Python 3.8 (@BenediktBurger, #1317) - Update copyright (@ilev-sergey, @Falk3579, #1248, #1402, #1414) - Update pandas dependency to <4 (@maduka-ariyasiri, #1424) - Bump CI actions versions (@dependabot, #1327, #1328, #1351, #1353, #1386, #1417, #1418, #1408) - Fix ruff configuration (@ilev-sergey, #1236) - Fix formatting (@Falk3579, #1267, #1269, #1316, #1375) - Fix raise errors to show full stack trace (@BenediktBurger, #1270) - Fix failing CI (@CasperSchippers, #1454) New Contributors ---------------- @ilev-sergey, @Benbriel, @fg-lumentum, @dsimat, @panasee, @jvdoorn, @dl8dtl, @Falk3579, @hvegh, @dependabot[bot], @DF9AS, @Patschke, @d-el, @lucasbraud, @chieh0517, @breakU1, @PeterPirog, @maduka-ariyasiri **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.15.0...v0.16.0 Version 0.15.0 (2025-01-15) =========================== Main items of this new release: - pyproject.toml replaces setup.cfg - 12 new instruments Deprecated features ------------------- - The FSL class imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py` is deprecated, the current version can be found in :code:`pymeasure/instruments/rohdeschwarz/fsseries.py`. Instruments ----------- - Add Agilent E5062A (@AlecVercruysse, #1146) - Add Hewlett Packard 8753E VNA (@Sionwage, #1004) - Add Keithley DAQ6510 (@Aphelion82, #1128) - Add Keithley2281S (@PfannenHans, #1054) - Add LD400P electronic load (@RobertoRoos, #1168) - Add Philips PM6669 Universal Frequency Counter (@dirkjankrijnders, #570) - Add Rohde&Schwarz FSSeries class for instruments such as FSL (previously stand-alone class), FSW and others (@jnnskls, #1156) Previously, the instrument class FSL could be imported from :code:`pymeasure/instruments/rohdeschwarz/fsl.py`, which can now be imported from :code:`pymeasure/instruments/rohdeschwarz/fsseries.py` alongside the base class FSSeries and FSW. - Add Rigol dg822 waveform generator (@fthouin, #1159) - Add Siglent SDS1072CML oscilloscope (@fthouin, #1080, 1195) - Add more Thyracont vacuum transducer device types (@dkriegner, #1143) - Fix Agilent E5062A: docs + rename `active_traces` to `visible_traces` (@AlecVercruysse, #1174) - Fix AnritsuMS2090A: Confirm SCPIMixin (@icchalmers, #1191) - Fix race condition in test suite due to HP8116A tests (@kpet, #1145) - Fix description of :code:`Keithley2000.measure_resistance` method (@J3NZ0L, #1193) - Fix test for Keithley6510 (@BenediktBurger, #1135) - Fix Kepco BOP power supplies documentation (@JAW90, #1199) - Update AFG3152CChannel to docs (@ssimpson-ens, #1176) - Update Keysight E3631A with added :code:`output_enabled` property to individual channels (@inonRAAAM, #1209) - Update Teledyne with VBS methods (@RobertoRoos, #1166) Automation ---------- - Explicitly set encoding to utf8 when writing and reading data to file, allowing the use of special characters. Previously the encoding was not explicitly set, this could potentially disrupt loading old data-files; if this is required, the encoading can be changed by changing (e.g., monkey-patching) the :code:`pymeasure.experiment.Results.ENCODING` property. (@CasperSchippers, #1123) - Add :code:`has_next` method to Procedure class (@Did-Mas, #1185) - Change logger from root to module-specific logger. (@mmerlo, #1165) Documentation ------------- - Fix a couple of typos in procedure.rst (@kpet, #1141) - Update contribute.rst also for GitHub Desktop (@bernhardlang, @OrionSmedley, #983, #1171) - Fix documentation errors (@msmttchr, @kpet, #1133, #1148) - Update InstrumentKit reference (@emmanuel-ferdman, #1187) - Change copyright year to 2025 (@BenediktBurger, #1210) Miscellaneous ------------- - Prepare for v0.14.0 (@BenediktBurger, #1104) - Add "Reveal in File Explorer" to browser item context menu (@Did-Mas, #1188) - Update numpy 2 test (@CasperSchippers, #1126) - Add an install group for building documentation (@RobertoRoos, #1180) - Remove setup.cfg, replace by pyproject.toml (@RobertoRoos, #1182) New Contributors ---------------- @Sionwage, @bernhardlang, @Aphelion82, @kpet, @mmerlo, @OrionSmedley, @ssimpson-ens, @Did-Mas, @emmanuel-ferdman, @icchalmers, @fthouin, @PfannenHans, @dirkjankrijnders, @J3NZ0L, @inonRAAAM, **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.14.0...v0.15.0 Version 0.14.0 (2024-05-22) =========================== Main items of this new release: - Add support for numpy 2.0 - Add support for python 3.12 - Improve academic quotability with an up to date Zenodo DOI and with citation information. - Add default :code:`queue` method and a :code:`FileInputWidget`, allowing to more quickly get started with the PyMeasure user interface (:code:`ManagedWindow`). - Add a :code:`SCPIMixin` base class for instruments instead of defining :code:`includeSCPI=True` - Instrument manufacturer modules are no longer imported in the :code:`pymeasure/instruments/__init__.py` file. Previously, when importing a single instrument into a procedure, all instruments would be imported into memory through the manufacturer modules in :code:`pymeasure/instruments/__init__.py`. Removing manufacturer modules from that file lowers the memory footprint of pymeasure when importing an instrument. Instrument classes will need to be imported from the manufacturer module or explicitly from the instrument driver file. For example, :code:`from pymeasure.instruments import Extreme5000` will need to change to :code:`from pymeasure.instruments.extreme import Extreme5000` or :code:`from pymeasure.instruments.extreme.extreme5000 import Extreme5000`. - 17 new instruments Deprecated features ------------------- - Remove :code:`TelnetAdapter`, as its library is deprecated (@BenediktBurger, #1045) - Replaced :code:`directory_input` keyword-argument of :code:`ManagedWindowBase` by :code:`enable_file_input` (@CasperSchippers, #964) - Make parameter :code:`includeSCPI` obligatory for all instruments, even those which use SCPI (@BenediktBurger, #1007) - Setting `includeSCPI=True` is deprecated, inherit instead the :code:`SCPIMixin` class if the device supports SCPI commands. - Replaced :code:`celcius` attribute of :code:`LakeShoreTemperatureChannel` by :code:`celsius` (@afuetterer, #1003) - Replaced :code:`error` property of Keithley instruments by :code:`next_error`. - Replaced :code:`measurement_time` property of Pendulum CNT-91 by :code:`gate_time`. - Replaced :code:`sample_rate` keyword-argument of :code:`buffer_frequency_time_series` of Pendulum CNT-91 by :code:`gate_time`. - Replaced MKS937B :code:`unit` to use :code:`instruments/mksinst/mks937b/Unit` instead of strings (@dkriegner, @BenediktBurger #1034) Instruments mechanics --------------------- - Add a SCPI base class :code:`SCPIMixin` as replacement for :code:`includeSCPI=True` (@BenediktBurger, #905, #1007, #1019, #1047) - Add :code:`next_error` property to SCPI instruments (@BenediktBurger, #1024) - Make :code:`query_delay=None` the default for :code:`wait_for` (@BenediktBurger, #1077) - Fix :code:`expected_protocol` using empty dictionary as default value (@BenediktBurger, #1087) - Remove auto-importing all instruments in :code:`pymeasure/instruments/__init__.py`` (@mcdo0486, #919) - Add :code:`find_serial_port` to find a serial port by providing USB information (@BenediktBurger, #982) Instruments ----------- - Add Agilent4294A (@driftregion, #998) - Add Agilent 4284A by (@ConnorGCarr #1079) - Add AimTTI PL series power supplies (@guuskuiper, #942) - Add HP11713A Switch & Attenuator Driver (@neuschs, #970) - Add HP437B power meter (@neuschs, #979) - Add Inficon SQM160 SQM-160 multi-film rate/thickness monitor (@dkriegner, #991) - Add Keithley 2182 (@ConnorGCarr, #1043) - Add KeithleyDMM6500 (@fwutw, #963) - Add Kepco BOP 36-12 Bipolar Power Supply (@JAW90, #1086) - Add KeysightE3631A (@OptimisticBeliever, #990) - Add Kuhne Electronic KU SG 2.45 250A microwave generator (@jurajjasik, @BenediktBurger, @1108) - Add MKS 974B vacuum pressure transducer (@dkriegner, #1034) - Add Proterial rod4 (@ConnorGCarr, #1044) - Add Racal-Dana 1992 universal counter (@tomverbeure, #798, #1012) - Add redpitaya board (@seb5g, #1010, #1035) - Add Teledyne HDO6xxx (@RobertoRoos, #868) - Add Yokogawa AQ6370D Optical Spectral Analyzer (@jnnskls, #1059) - Fix property docstrings of several instruments (@BenediktBurger, #1018) - Fix checksums of hcp TC038D tests (@BenediktBurger, #987) - Fix Hp8116a (@BenediktBurger, #1088) - Fix Hp856x to append amplitude units (@neuschs, #977) - Fix Keysight E36312A confirmed SCPI functionality (@Konradrundfunk, #1107) - Fix Stanford Research SR830 output conversion (@dkriegner, #1069) - Fix SR830 missing get_buffer method (@seb5g, #999) - Fix set command of SR860 aux output (@wehlgrundspitze, #1048) - Fix Temptronic test to use ns perf counter (@BenediktBurger, #1109, #1110) - Fix Toptica Ibeamsmart referencing removed adapter function (@BenediktBurger, #1065) - Fix typos in docstrings for Keithley instruments (@V0XNIHILI, #1071) - Link Keysight, Agilent, and HP documentation pages. (@BenediktBurger, #1021) - Update Agilent33500 Series from :code:`.ch[]` to :code:`.channels[]` (@AlecVercruysse, #945) - Update AWG401x driver to use 'channels' (@mcdo0486, #944) - Update HP33120A with new burst modulation parameters (@mzen228, #1056) - Update HP34401A with new remote control command. (@Rybok, #992) - Update Keithleys' next_error (@msmttchr, #1030) - Update pendulum CNT-91 (@bleykauf, #988) GUI --- - Add a :code:`FileInputWidget` to choose if and where the experiment data is stored. (@CasperSchippers, #964) - Add a default :code:`Queue` method for :code:`ManagedWindowBase` is implemented. (@CasperSchippers, #964) - Fix :code:`ScientificInput` to be locale compatible (@pyZerrenner, #1074) - Fix exception if loading result file with an empty parameter (@poje42, #1016) Miscellaneous ------------- - Add support for python 3.12 (@BenediktBurger, #1051) - Add support for numpy 2.0 (@CasperSchippers, #1026) - Add codecov to CI and to readme (@BenediktBurger, #1037, #1052, #1099) - Add citation file for PyMeasure repository (@mcdo0486, #1092) - Add release CI (@BenediktBurger, #1039) - Update readme with permanent Zenodo DOI (@BenediktBurger, #1095) - Bump CI dependencies to: pyvisa 1.13.0, checkout@v4 (@mcdo0486, #1097) - Fix/pandas futurewarning (@CasperSchippers, #1062) - Change copyright year. (@BenediktBurger, #1032) - Fix typos (@afuetterer, #1003) New Contributors ---------------- @guuskuiper, @OptimisticBeliever, @fwutw, @afuetterer, @poje42, @Rybok, @AlecVercruysse, @ConnorGCarr, @mzen228, @jnnskls, @V0XNIHILI, @pyZerrenner, @JAW90, @driftregion, @jurajjasik, @Konradrundfunk **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.13.1...v0.14.0 Version 0.13.1 (2023-10-05) =========================== New release to fix ineffective python version restriction in the project metadata (only affected Python<=3.7 environments installing via pip). Version 0.13.0 (2023-09-23) =========================== Main items of this new release: - Dropped support for Python 3.7, added support for Python 3.11. - Adds a test generator, which observes the communication with an actual device and writes protocol tests accordingly. - 2 new instrument drivers have been added. Deprecated features ------------------- - Attocube ANC300: The :code:`stepu` and :code:`stepd` properties are deprecated, use the new :code:`move_raw` method instead. (@dkriegner, #938) Instruments ----------- - Adds a test generator (@bmoneke, #882) - Adds Thyracont Smartline v2 vacuum sensor transmitter (@bmoneke, #940) - Adds Thyracont Smartline v1 vacuum gauge (@dkriegner, #937) - AddsTeledyne base classes with most of `LeCroyT3DSO1204` functionality (@RobertoRoos, #951) - Fixes instrument documentation (@mcdo0486, #941, #903, @omahs, #960) - Fixes Toptica Ibeamsmart's __init__ (@waveman68, #959) - Fixes VISAAdapter flush_read_buffer() (@ileu, #968) - Updates Keithley2306 and AFG3152C to Channels (@bilderbuchi, #953) GUI --- - Adds console mode (@msmttchr, #500) - Fixes Dock widget (@msmttchr, #961) Miscellaneous ------------- - Change CI from conda to mamba (@bmoneke, #947) - Add support for python 3.11 (@CasperSchippers, #896) New Contributors ---------------- @waveman68, @omahs, @ileu **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.12.0...v0.13.0 Version 0.12.0 (2023-07-05) =========================== Main items of this new release: - A :code:`Channel` base class has been added for easier implementation of instruments with channels. - 19 new instrument drivers have been added. - Added tests for some commonalities across all instruments. - We continue to clean up our API in preparation for a future version 1.0. Deprecations and subsequent removals are listed below. Deprecated features ------------------- - HP 34401A: :code:`voltage_ac`, :code:`current_dc`, :code:`current_ac`, :code:`resistance`, :code:`resistance_4w` properties, use :code:`function_` and :code:`reading` properties instead. - Toptica IBeamSmart: :code:`channel1_enabled`, use :code:`ch_1.enabled` property instead (equivalent for channel2). Also :code:`laser_enabled` is deprecated in favor of :code:`emission` (@bmoneke, #819). - TelnetAdapter: use :code:`VISAAdapter` instead. VISA supports TCPIP connections. Use the resource_name :code:`TCPIP[board]::::::SOCKET` to connect to a server (@Max-Herbold, #835). - Attocube ANC300: :code:`host` argument, pass a resource string or adapter as :code:`Adapter` passed to :code:`Instrument`. Now communicates through the :code:`VISAAdapter` rather than deprecated :code:`TelnetAdapter`. The initializer now accepts :code:`name` as its second keyword argument so all previous initialization positional arguments (`axisnames`, `passwd`, `query_delay`) should be switched to keyword arguments. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept arbitrary keyword arguments anymore. Use the :code:`v_kwargs` parameter for arguments you want to pass on to :code:`values` method, instead. - The property creators :code:`control`, :code:`measurement`, and :code:`setting` do not accept `command_process` anymore. Use a dynamic property or a `Channel` instead, as appropriate (@bmoneke, #878). - See also the next section. New adapter and instrument mechanics ------------------------------------ - All instrument constructors are required to accept a :code:`name` argument. - Changed: :code:`read_bytes` of all Adapters by default does not stop reading on a termination character, unless the new argument :code:`break_on_termchar` is set to `True`. - Channel class added. :code:`Instrument.channels` and :code:`Instrument.ch_X` (:code:`X` is any channel name) are reserved attributes for channel mechanics. - The parameters :code:`check_get_errors` and :code:`check_set_errors` enable calling methods of the same name. This enables more systematically dealing with instruments that acknowledge every "set" command. - Adds Channel feature to instruments (@bmoneke, mcdo0486, #718, #761, #852, #931) - Adds :code:`maxsplit` parameter to :code:`values` method (@bmoneke, #793) - Adds (deprecated) global preprocess reply for backward compatibility (@bmoneke, #876) - Adds fallback version for discarding the read buffer to VISAAdapter (@dkriegner, #836) - Adds :code:`flush_read_buffer` to SerialAdapter (@RobertoRoos, #865) - Adds :code:`gpib_read_timeout` to PrologixAdapter (@neuschs, #927) - Adds command line option to pass resource address for instrument tests (@bleykauf, #789) - Adds "find all instruments" and channels for testing (@bmoneke, #909, @mcdo0486, #911, #912) - Adds test that an instrument hands kwargs to the adapter (@bmoneke, #814) - Adds property docstring check (@bmoneke, #895) - Improves property factories' docstrings (@bmoneke, #843) - Improves property factories: do not allow undefined kwargs (@bmoneke, #856) - Improves property factories: check_set/get_errors argument to call methods of the same name (@bmoneke, #883) - Improves :code:`read_bytes` of Adapter (@bmoneke, #839) - Improves the ProtocolAdapter with a mock connection (@bmoneke, #782), and enable it to have empty messages in the protocol (@bmoneke, #818) - Improves Prologix adapter documentation (@bmoneke, #813) and configurable settings (@bmoneke, #845) - Improves behavior of :code:`read_bytes(-1)` for :code:`SerialAdapter` (@RobertoRoos, #866) - Improves all instruments with name kwarg (@bmoneke, #877) - Improves VisaAdapter: close manager only when using pyvisa-sim (@dkriegner, #900) - Harmonises instrument name definition pattern, consistently name the instrument connection argument "adapter" (@bmoneke, #659) - Fixes ProtocolAdapter has list in signature (@bmoneke, #901) - Fixes VISAAdapter's :code:`read_bytes` (@bmoneke, #867) - Fixes query_delay usage in VISAAdapter (@bmoneke, #765) - Fixes VisaAdapter: close resource manager only when using pyvisa-sim (@dkriegner, #900) Instruments ----------- - New Advantest R624X DC Voltage/Current Sources/Monitors (@wichers, #802) - New AJA International DC sputtering power supply (@dkriegner, #778) - New Anritus MS2090A (@aruznieto, #787) - New Anritsu MS4644B (@CasperSchippers, #827) - New DSP 7225 and new DSPBase instrument (@mcdo0486, #902) - New HP 8560A / 8561B Spectrum Analyzer (@neuschs, #888) - New IPG Photonics YAR Amplifier series (@bmoneke, #851) - New Keysight E36312A power supply (@scandey, #785) - New Keithley 2200 power supply (@ashokbruno, #806) - New Lake Shore 211 Temperature Monitor (@mcdo0486, #889) - New Lake Shore 224 and improves Lakeshore instruments (@samcondon4, #870) - New MKS Instruments 937B vacuum gauge controller (@dkriegner, @bilderbuchi, #637, #772, #936) - New Novanta FPU60 laser power supply unit (@bmoneke, #885) - New TDK Lambda Genesys 80-65 DC and 40-38 DC power supplies (@mcdo0486, 906) - New Teledyne T3AFG waveform generator instrument (@scandey, #791) - New Teledyne (LeCroy) T3DSO1204 Oscilloscope (@LastStartDust, #697, @bilderbuchi, #770) - New T&C Power Conversion RF power supply (@dkriegner, #800) - New Velleman K8090 relay device (@RobertoRoos, #859) - Improves Agilent 33500 with the new channel feature (@JCarl-OS, #763, #773) - Improves HP 3478A with calibration data related functions (@tomverbeure, #777) - Improves HP 34401A (@CodingMarco, #810) - Improves the Oxford instruments with the new channel feature (@bmoneke, #844) - Improves Siglent SPDxxxxX with the new channel feature (@AidenDawn 758) - Improves Teledyne T3DSO1204 device tests (@LastStarDust, #841) - Fixes Ametek DSP 7270 lockin amplifier issues (@seb5g, #897) - Fixes DSP 7265 erroneously using preprocess_reply (@mcdo0486, #873) - Fixes print statement in DSPBase.sensitivity (@mcdo0486, #915) - Fixes Fluke bath commands (@bmoneke, #874) - Fixes a frequency limitation in HP 8657B (@LongnoseRob, #769) - Fixes Keithley 2600 channel calling parent's shutdown (@mcdo0486, #795) Automation ---------- - Adds tolerance for opening result files with missing parameters (@msmttchr, #780) - Validate DATA_COLUMNS entries earlier, avoid exceptions in a running procedure (@mcdo0486, #796, #934) GUI --- - Adds docking windows (@mcdo0486, #722, #762) - Adds save plot settings in addition to dock layout (@mcdo0486, #850) - Adds log widget colouring and format option (@CasperSchippers, #890) - Adds table widget (@msmttchr, #771) - New sequencer architecture: decouples it from the graphical tree, adapts it for further expansions (@msmttchr, #518) - Moves coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - Fixes crashing ImageWidget at new measurement (@CasperSchippers, #790) - Fixes checkboxes not working for groups in inputs-widget (@CasperSchippers, #794) Miscellaneous ------------- - Adds a collection of solutions for instrument implementation challenges (@bmoneke, #853, #861) - Updates Tutorials/Making_a_measurement/ example_codes (@sansanda, #749) New Contributors ---------------- @JCarl-OS, @aruznieto, @scandey, @tomverbeure, @wichers, @Max-Herbold, @RobertoRoos **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.1...v0.12.0 Version 0.11.1 (2022-12-31) =========================== Adapter and instrument mechanics -------------------------------- - Fix broken `PrologixAdapter.gpib`. Due to a bug in `VISAAdapter`, you could not get a second adapter with that connection (#765). **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.11.0...v0.11.1 Dependency updates ------------------ - Required version of `PyQtGraph `__ is increased from :code:`pyqtgraph >= 0.9.10` to :code:`pyqtgraph >= 0.12` to support new PyMeasure display widgets. GUI --- - Added `ManagedDockWindow `__ to allow multiple dockable plots (@mcdo0486, @CasperSchippers, #722) - Move coordinates label to the pyqtgraph PlotItem (@CasperSchippers, #822) - New sequencer architecture (@msmttchr, @CasperSchippers, @mcdo0486, #518) - Added "Save Dock Layout" functionality to DockWidget context menu. (@mcdo0486, #762) Version 0.11.0 (2022-11-19) =========================== Main items of this new release: - 11 new instrument drivers have been added - A method for testing instrument communication **without** hardware present has been added, see `the documentation `__. - The separation between :code:`Instrument` and :code:`Adapter` has been improved to make future modifications easier. Adapters now focus on the hardware communication, and the communication *protocol* should be defined in the Instruments. Details in a section below. - The GUI is now compatible with Qt6. - We have started to clean up our API in preparation for a future version 1.0. There will be deprecations and subsequent removals, which will be prominently listed in the changelog. Deprecated features ------------------- In preparation for a stable 1.0 release and a more consistent API, we have now started formally deprecating some features. You should get warnings if those features are used. - Adapter methods :code:`ask`, :code:`values`, :code:`binary_values`, use :code:`Instrument` methods of the same name instead. - Adapter parameter :code:`preprocess_reply`, override :code:`Instrument.read` instead. - :code:`Adapter.query_delay` in favor of :code:`Instrument.wait_for()`. - Keithley 2260B: :code:`enabled` property, use :code:`output_enabled` instead. New adapter and instrument mechanics ------------------------------------ - Nothing should have changed for users, this section is mainly interesting for instrument implementors. - Documentation in 'Advanced communication protocols' in 'Adding instruments'. - Adapter logs written and read messages. - Particular adapters (`VISAAdapter` etc.) implement the actual communication. - :code:`Instrument.control` getter calls :code:`Instrument.values`. - :code:`Instrument.values` calls :code:`Instrument.ask`, which calls :code:`Instrument.write`, :code:`wait_for`, and :code:`read`. - All protocol quirks of an instrument should be implemented overriding :code:`Instrument.write` and :code:`read`. - :code:`Instrument.wait_until_read` implements waiting between writing and reading. - reading/writing binary values is in the :code:`Adapter` class itself. - :code:`PrologixAdapter` is now based on :code:`VISAAdapter`. - :code:`SerialAdapter` improved to be more similar to :code:`VISAAdapter`: :code:`read`/:code:`write` use strings, :code:`read/write_bytes` bytes. - Support for termination characters added. Instruments ----------- - New Active Technologies AWG-401x (@garzetti, #649) - New Eurotest hpp_120_256_ieee (@sansanda, #701) - New HC Photonics crystal ovens TC038, TC038D (@bmoneke, #621, #706) - New HP 6632A/6633A/6634A power supplies (@LongnoseRob, #651) - New HP 8657B RF signal generator (@LongnoseRob, #732) - New Rohde&Schwarz HMP4040 power supply. (@bleykauf, #582) - New Siglent SPDxxxxX series Power Supplies (@AidenDawn, #719) - New Temptronic Thermostream devices (@mroeleke, #368) - New TEXIO PSW-360L30 Power Supply (@LastStarDust, #698) - New Thermostream ECO-560 (@AidenDawn, #679) - New Thermotron 3800 Oven (@jcarbelbide, #606) - Harmonize instruments' adapter argument (@bmoneke, #674) - Harmonize usage of :code:`shutdown` method (@LongnoseRob, #739) - Rework Adapter structure (@bmoneke, #660) - Add Protocol tests without hardware present (@bilderbuchi, #634, @bmoneke, #628, #635) - Add Instruments and adapter protocol tests for adapter rework (@bmoneke, #665) - Add SR830 sync filter and reference source trigger (@AsafYagoda, #630) - Add Keithley6221 phase marker phase and line (@AsafYagoda, #629) - Add missing docstrings to Keithley 2306 battery simulator (@AidenDawn, #720) - Fix hcp instruments documentation (@bmoneke, #671) - Fix HPLegacyInstrument initializer API (@bilderbuchi, #684) - Fix Fwbell 5080 implementation (@mcdo0486, #714) - Fix broken documentation example. (@bmoneke, #738) - Fix typo in Keithley 2600 driver (@mcdo0486, #615) - Remove dynamic use of docstring from ATS545 and make more generic (@AidenDawn, #685) Automation ---------- - Add storing unitful experiment results (@bmoneke, #642) - Add storing conditions in file (@CasperSchippers, #503) GUI --- - Add compatibility with Qt 6 (@CasperSchippers, #688) - Add spinbox functionality for IntegerParameter and FloatParameter (@jarvas24, #656) - Add "delete data file" button to the browser_item_menu (@jarvas24, #654) - Split windows.py into a folder with separate modules (@mcdo0486, #593) - Remove dependency on matplotlib (@msmttchr, #622) - Remove deprecated access to QtWidgets through QtGui (@maederan201, #695) Miscellaneous ------------- - Update and extend documentation (@bilderbuchi, #712, @bmoneke, #655) - Add PEP517 compatibility & dynamically obtaining a version number (@bilderbuchi, #613) - Add an example and documentation regarding using a foreign instrument (@bmoneke, #647) - Add black configuration (@bleykauf, #683) - Remove VISAAdapter.has_supported_version() as it is not needed anymore. New Contributors ---------------- @jcarbelbide, @mroeleke, @bmoneke, @garzetti, @AsafYagoda, @AidenDawn, @LastStarDust, @sansanda **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.10.0...v0.11.0 Version 0.10.0 (2022-04-09) =========================== Main items of this new release: - 23 new instrument drivers have been added - New dynamic Instrument properties can change their parameters at runtime - Communication settings can now be flexibly defined per protocol - Python 3.10 support was added and Python 3.6 support was removed. - Many additions, improvements and have been merged Instruments ----------- - New Agilent B1500 Data Formats and Documentation (@moritzj29) - New Anaheim Automation stepper motor controllers (@samcondon4) - New Andeen Hagerling capacitance bridges (@dkriegner) - New Anritsu MS9740A Optical Spectrum Analyzer (@md12g12) - New BK Precision 9130B Instrument (@dennisfeng2) - New Edwards nXDS (10i) Vacuum Pump (@hududed) - New Fluke 7341 temperature bath instrument (@msmttchr) - New Heidenhain ND287 Position Display Unit Driver (@samcondon4) - New HP 3478A (@LongnoseRob) - New HP 8116A 50 MHz Pulse/Function Generator (@CodingMarco) - New Keithley 2260B DC Power Supply (@bklebel) - New Keithley 2306 Dual Channel Battery/Charger Simulator (@mfikes) - New Keithley 2600 SourceMeter series (@Daivesd) - New Keysight N7776C Swept Laser Source (@maederan201) - New Lakeshore 421 (@CasperSchippers) - New Oxford IPS120-10 (@CasperSchippers) - New Pendulum CNT-91 frequency counter (@bleykauf) - New Rohde&Schwarz - SFM TV test transmitter (@LongnoseRob) - New Rohde&Schwarz FSL spectrum analyzer (@bleykauf) - New SR570 current amplifier driver (@pyMatJ) - New Stanford Research Systems SR510 instrument driver (@samcondon4) - New Toptica Smart Laser diode (@dkriegner) - New Yokogawa GS200 Instrument (@dennisfeng2) - Add output low grounded property to Keithley 6221 (@CasperSchippers) - Add shutdown function for Keithley 2260B (@bklebel) - Add phase control for Agilent 33500 (@corna) - Add assigning "ONCE" to auto_zero to Keithley 2400 (@mfikes) - Add line frequency controls to Keithley 2400 (@mfikes) - Add LIA and ERR status byte read properties to the SRS Sr830 driver (@samcondon4) - Add all commands to Oxford Intelligent Temperature Controller 503 (@CasperSchippers) - Fix DSP 7265 lockin amplifier (@CasperSchippers) - Fix bug in Keithley 6517B Electrometer (@CasperSchippers) - Fix Keithley2000 deprecated call to visa.config (@bklebel) - Fix bug in the Keithley 2700 (@CasperSchippers) - Fix setting of sensor flags for Thorlabs PM100D (@bleykauf) - Fix SCPI used for Keithley 2400 voltage NPLC (@mfikes) - Fix missing return statements in Tektronix AFG3152C (@bleykauf) - Fix DPSeriesMotorController bug (@samcondon4) - Fix Keithley2600 error when retrieving error code (@bicarlsen) - Fix Attocube ANC300 with new SCPI Instrument properties (@dkriegner) - Fix bug in wait_for_trigger of Agilent33220A (neal-kepler) GUI --- - Add time-estimator widget (@CasperSchippers) - Add management of progress bar (@msmttchr) - Remove broken errorbar feature (@CasperSchippers) - Change of pen width for pyqtgraph (@maederan201) - Make linewidth changeable (@CasperSchippers) - Generalise warning in plotter section (@CasperSchippers) - Implement visibility groups in InputsWidgets (@CasperSchippers) - Modify navigation of ManagedWindow directory widget (@jarvas24) - Improve Placeholder logic (@CasperSchippers) - Breakout widgets into separate modules (@mcdo0486) - Fix setSizePolicy bug with PySide2 (@msmttchr) - Fix managed window (@msmttchr) - Fix ListParameter for numbers (@moritzj29) - Fix incorrect columns on showing data (@CasperSchippers) - Fix procedure property issue (@msmttchr) - Fix pyside2 (@msmttchr) Miscellaneous ------------- - Improve SCPI property support (@msmttchr) - Remove broken safeKeyword management (@msmttchr) - Add dynamic property support (@msmttchr) - Add flexible API for defining connection configuration (@bilderbuchi) - Add write_binary_values() to SerialAdapter (@msmttchr) - Change an outdated pyvisa ask() to query() (@LongnoseRob) - Fix ZMQ bug (@bilderbuchi) - Documentation for passing tuples to control property (@bklebel) - Documentation bugfix (@CasperSchippers) - Fixed broken links in documentation. (@samcondon4) - Updated widget documentation (@mcdo0486) - Fix typo SCIP->SCPI (@mfikes) - Remove Python 3.6, add Python 3.10 testing (@bilderbuchi) - Modernise the code base to use Python 3.7 features (@bilderbuchi) - Added image data generation to Mock Instrument class (@samcondon4) - Add autodoc warnings to the problem matcher (@bilderbuchi) - Update CI & annotations (@bilderbuchi) - Test workers (@mcdo0486) - Change copyright date to 2022 (@LongnoseRob) - Removed unused code (@msmttchr) New Contributors ---------------- @LongnoseRob, @neal, @hududed, @corna, @Daivesd, @samcondon4, @maederan201, @bleykauf, @mfikes, @bicarlsen, @md12g12, @CodingMarco, @jarvas24, @mcdo0486! **Full Changelog**: https://github.com/pymeasure/pymeasure/compare/v0.9...v0.10.0 Version 0.9 -- released 2/7/21 ============================== - PyMeasure is now officially at github.com/pymeasure/pymeasure - Python 3.9 is now supported, Python 3.5 removed due to EOL - Move to GitHub Actions from TravisCI and Appveyor for CI (@bilderbuchi) - New additions to Oxford Instruments ITC 503 (@CasperSchippers) - New Agilent 34450A and Keysight DSOX1102G instruments (@theMashUp, @jlarochelle) - Improvements to NI VirtualBench (@moritzj29) - New Agilent B1500 instrument (@moritzj29) - New Keithley 6517B instrument (@wehlgrundspitze) - Major improvements to PyVISA compatbility (@bilderbuchi, @msmttchr, @CasperSchippers, @cjermain) - New Anapico APSIN12G instrument (@StePhanino) - Improvements to Thorelabs Pro 8000 and SR830 (@Mike-HubGit) - New SR860 instrument (@StevenSiegl, @bklebel) - Fix to escape sequences (@tirkarthi) - New directory input for ManagedWindow (@paulgoulain) - New TelnetAdapter and Attocube ANC300 Piezo controller (@dkriegner) - New Agilent 34450A (@theMashUp) - New Razorbill RP100 strain cell controller (@pheowl) - Fixes to precision and default value of ScientificInput and FloatParameter (@moritzj29) - Fixes for Keithly 2400 and 2450 controls (@pyMatJ) - Improvments to Inputs and open_file_externally (@msmttchr) - Fixes to Agilent 8722ES (@alexmcnabb) - Fixes to QThread cleanup (@neal-kepler, @msmttchr) - Fixes to Keyboard interrupt, and parameters (@CasperSchippers) Version 0.8 -- released 3/29/19 =============================== - Python 3.8 is now supported - New Measurement Sequencer allows for running over a large parameter space (@CasperSchippers) - New image plotting feature for live image measurements (@jmittelstaedt) - Improvements to VISA adapter (@moritzj29) - Added Tektronix AFG 3000, Keithley 2750 (@StePhanino, @dennisfeng2) - Documentation improvements (@mivade) - Fix to ScientificInput for float strings (@moritzj29) - New validator: strict_discrete_range (@moritzj29) - Improvements to Recorder thread joining - Migrating the ReadtheDocs configuration to version 2 - National Instruments Virtual Bench initial support (@moritzj29) Version 0.7 -- released 8/4/19 ============================== - Dropped support for Python 3.4, adding support for Python 3.7 - Significant improvements to CI, dependencies, and conda environment (@bilderbuchi, @cjermain) - Fix for PyQT issue in ResultsDialog (@CasperSchippers) - Fix for wire validator in Keithley 2400 (@Fattotora) - Addition of source_enabled control for Keithley 2400 (@dennisfeng2) - Time constant fix and input controls for SR830 (@dennisfeng2) - Added Keithley 2450 and Agilent 33521A (@hlgirard, @Endever42) - Proper escaping support in CSV headers (@feph) - Minor updates (@dvase) Version 0.6.1 -- released 4/21/19 ================================= - Added Elektronica SM70-45D, Agilent 33220A, and Keysight N5767A instruments (@CasperSchippers, @sumatrae) - Fixes for Prologix adapter and Keithley 2400 (@hlgirard, @ronan-sensome) - Improved support for SRS SR830 (@CasperSchippers) Version 0.6 -- released 1/14/19 =============================== - New VXI11 Adapter for ethernet instruments (@chweiser) - PyQt updates to 5.6.0 - Added SRS SG380, Ametek 7270, Agilent 4156, HP 34401A, Advantest R3767CG, and Oxford ITC503 instrustruments (@sylkar, @jmittelstaedt, @vik-s, @troylf, @CasperSchippers) - Updates to Keithley 2000, Agilent 8257D, ESP 300, and Keithley 2400 instruments (@watersjason, @jmittelstaedt, @nup002) - Various minor bug fixes (@thosou) Version 0.5.1 -- released 4/14/18 ================================= - Minor versions of PyVISA are now properly handled - Documentation improvements (@Laogeodritt and @ederag) - Instruments now have :code:`set_process` capability (@bilderbuchi) - Plotter now uses threads (@dvspirito) - Display inputs and PlotItem improvements (@Laogeodritt) Version 0.5 -- released 10/18/17 ================================ - Threads are used by default, eliminating multiprocessing issues with spawn - Enhanced unit tests for threading - Sphinx Doctests are added to the documentation (@bilderbuchi) - Improvements to documentation (@JuMaD) Version 0.4.6 -- released 8/12/17 ================================= - Reverted multiprocessing start method keyword arguments to fix Unix spawn issues (@ndr37) - Fixes to regressions in Results writing (@feinsteinben) - Fixes to TCP support using cloudpickle (@feinsteinben) - Restructing of unit test framework Version 0.4.5 -- released 7/4/17 ================================ - Recorder and Scribe now leverage QueueListener (@feinsteinben) - PrologixAdapter and SerialAdapter now handle Serial objects as adapters (@feinsteinben) - Optional TCP support now uses cloudpickle for serialization (@feinsteinben) - Significant PEP8 review and bug fixes (@feinsteinben) - Includes docs in the code distribution (@ghisvail) - Continuous integration support for Python 3.6 (@feinsteinben) Version 0.4.4 -- released 6/4/17 ================================ - Fix pip install for non-wheel builds - Update to Agilent E4980 (@dvspirito) - Minor fixes for docs, tests, and formatting (@ghisvail, @feinsteinben) Version 0.4.3 -- released 3/30/17 ================================= - Added Agilent E4980, AMI 430, Agilent 34410A, Thorlabs PM100, and Anritsu MS9710C instruments (@TvBMcMaster, @dvspirito, and @mhdg) - Updates to PyVISA support (@minhhaiphys) - Initial work on resource manager (@dvspirito) - Fixes for Prologix adapter that allow read-write delays (@TvBMcMaster) - Fixes for conda environment on continuous integration Version 0.4.2 -- released 8/23/16 ================================= - New instructions for installing with Anaconda and conda-forge package (thanks @melund!) - Bug-fixes to the Keithley 2000, SR830, and Agilent E4408B - Re-introduced the Newport ESP300 motion controller - Major update to the Keithely 2400, 2000 and Yokogawa 7651 to achieve a common interface - New command-string processing hooks for Instrument property functions - Updated LakeShore 331 temperature controller with new features - Updates to the Agilent 8257D signal generator for better feature exposure Version 0.4.1 -- released 7/31/16 ================================= - Critical fix in setup.py for importing instruments (also added to documentation) Version 0.4 -- released 7/29/16 =============================== - Replaced Instrument add_measurement and add_control with measurement and control functions - Added validators to allow Instrument.control to match restricted ranges - Added mapping to Instrument.control to allow more flexible inputs - Conda is now used to set up the Python environment - macOS testing in continuous integration - Major updates to the documentation Version 0.3 -- released 4/8/16 ============================== - Added IPython (Jupyter) notebook support with significant features - Updated set of example scripts and notebooks - New PyMeasure logo released - Removed support for Python <3.4 - Changed multiprocessing to use spawn for compatibility - Significant work on the documentation - Added initial tests for non-instrument code - Continuous integration setup for Linux and Windows Version 0.2 -- released 12/16/15 ================================ - Python 3 compatibility, removed support for Python 2 - Considerable renaming for better PEP8 compliance - Added MIT License - Major restructuring of the package to break it into smaller modules - Major rewrite of display functionality, introducing new Qt objects for easy extensions - Major rewrite of procedure execution, now using a Worker process which takes advantage of multi-core CPUs - Addition of a number of examples - New methods for listening to Procedures, introducing ZMQ for TCP connectivity - Updates to Keithley2400 and VISAAdapter Version 0.1.6 -- released 4/19/15 ================================= - Renamed the package to PyMeasure from Automate to be more descriptive about its purpose - Addition of VectorParameter to allow vectors to be input for Procedures - Minor fixes for the Results and Danfysik8500 Version 0.1.5 -- release 10/22/14 ================================= - New Manager class for handling Procedures in a queue fashion - New Browser that works in tandem with the Manager to display the queue - Bug fixes for Results loading Version 0.1.4 -- released 8/2/14 ================================ - Integrated Results class into display and file writing - Bug fixes for Listener classes - Bug fixes for SR830 Version 0.1.3 -- released 7/20/14 ================================= - Replaced logging system with Python logging package - Added data management (Results) and bug fixes for Procedures and Parameters - Added pandas v0.14 to requirements for data management - Added data listeners, Qt4 and PyQtGraph helpers Version 0.1.2 -- released 7/18/14 ================================= - Bug fixes to LakeShore 425 - Added new Procedure and Parameter classes for generic experiments - Added version number in package Version 0.1.1 -- released 7/16/14 ================================= - Bug fixes to PrologixAdapter, VISAAdapter, Agilent 8722ES, Agilent 8257D, Stanford SR830, Danfysik8500 - Added Tektronix TDS 2000 with basic functionality - Fixed Danfysik communication to handle errors properly Version 0.1.0 -- released 7/15/14 ================================= - Initial release ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275456.0 pymeasure-0.16.0/PyMeasure.egg-info/SOURCES.txt0000644000175100017510000010422015203313300020533 0ustar00runnerrunner.flake8 AGENTS.md AUTHORS.txt CHANGES.rst CITATION.cff LICENSE.txt MANIFEST.in README.rst RELEASE.md codecov.yml pyproject.toml PyMeasure.egg-info/PKG-INFO PyMeasure.egg-info/SOURCES.txt PyMeasure.egg-info/dependency_links.txt PyMeasure.egg-info/requires.txt PyMeasure.egg-info/top_level.txt docs/Makefile docs/conf.py docs/index.rst docs/introduction.rst docs/make.bat docs/quick_start.rst docs/about/authors.rst docs/about/changes.rst docs/about/license.rst docs/about/related_projects.rst docs/api/adapters.rst docs/api/display/Qt.rst docs/api/display/browser.rst docs/api/display/console.rst docs/api/display/curves.rst docs/api/display/index.rst docs/api/display/inputs.rst docs/api/display/listeners.rst docs/api/display/log.rst docs/api/display/manager.rst docs/api/display/plotter.rst docs/api/display/thread.rst docs/api/display/widgets.rst docs/api/display/windows.rst docs/api/experiment/experiment.rst docs/api/experiment/index.rst docs/api/experiment/listeners.rst docs/api/experiment/parameters.rst docs/api/experiment/procedure.rst docs/api/experiment/results.rst docs/api/experiment/workers.rst docs/api/instruments/comedi.rst docs/api/instruments/generic_types.rst docs/api/instruments/index.rst docs/api/instruments/instruments.rst docs/api/instruments/resources.rst docs/api/instruments/validators.rst docs/api/instruments/activetechnologies/AWG401x.rst docs/api/instruments/activetechnologies/index.rst docs/api/instruments/aculight/argos.rst docs/api/instruments/aculight/index.rst docs/api/instruments/advantest/advantestR3767CG.rst docs/api/instruments/advantest/advantestR624X.rst docs/api/instruments/advantest/index.rst docs/api/instruments/agilent/agilent33220A.rst docs/api/instruments/agilent/agilent33500.rst docs/api/instruments/agilent/agilent33521A.rst docs/api/instruments/agilent/agilent34410A.rst docs/api/instruments/agilent/agilent34450A.rst docs/api/instruments/agilent/agilent4156.rst docs/api/instruments/agilent/agilent4284A.rst docs/api/instruments/agilent/agilent4294A.rst docs/api/instruments/agilent/agilent8257D.rst docs/api/instruments/agilent/agilent8722ES.rst docs/api/instruments/agilent/agilentB1500.rst docs/api/instruments/agilent/agilentB298x.rst docs/api/instruments/agilent/agilentE4408B.rst docs/api/instruments/agilent/agilentE4980.rst docs/api/instruments/agilent/agilentE5062A.rst docs/api/instruments/agilent/agilentE5270B.rst docs/api/instruments/agilent/agilentN8975A.rst docs/api/instruments/agilent/index.rst docs/api/instruments/aimtti/aimttiPL.rst docs/api/instruments/aimtti/index.rst docs/api/instruments/aimtti/ld400p.rst docs/api/instruments/aja/DCXS.rst docs/api/instruments/aja/index.rst docs/api/instruments/ametek/ametek7270.rst docs/api/instruments/ametek/index.rst docs/api/instruments/ami/ami430.rst docs/api/instruments/ami/index.rst docs/api/instruments/anaheimautomation/dpseriesstepmotorcontroller.rst docs/api/instruments/anaheimautomation/index.rst docs/api/instruments/anapico/apsin12G.rst docs/api/instruments/anapico/index.rst docs/api/instruments/andeenhagerling/ah2500a.rst docs/api/instruments/andeenhagerling/ah2700a.rst docs/api/instruments/andeenhagerling/index.rst docs/api/instruments/anritsu/anritsuMG3692C.rst docs/api/instruments/anritsu/anritsuMS2090A.rst docs/api/instruments/anritsu/anritsuMS464xB.rst docs/api/instruments/anritsu/anritsuMS9710C.rst docs/api/instruments/anritsu/anritsuMS9740A.rst docs/api/instruments/anritsu/index.rst docs/api/instruments/attocube/anc300.rst docs/api/instruments/attocube/index.rst docs/api/instruments/bkprecision/bkprecision9130b.rst docs/api/instruments/bkprecision/index.rst docs/api/instruments/danfysik/danfysik8500.rst docs/api/instruments/danfysik/index.rst docs/api/instruments/deltaelektronica/index.rst docs/api/instruments/deltaelektronica/sm7045d.rst docs/api/instruments/edwards/index.rst docs/api/instruments/edwards/nxds.rst docs/api/instruments/eurotest/eurotestHPP120256.rst docs/api/instruments/eurotest/index.rst docs/api/instruments/fluke/fluke7341.rst docs/api/instruments/fluke/index.rst docs/api/instruments/formfactor/index.rst docs/api/instruments/formfactor/velox.rst docs/api/instruments/fwbell/fwbell5080.rst docs/api/instruments/fwbell/index.rst docs/api/instruments/hcp/index.rst docs/api/instruments/hcp/tc038.rst docs/api/instruments/hcp/tc038d.rst docs/api/instruments/heidenhain/index.rst docs/api/instruments/heidenhain/nd287.rst docs/api/instruments/hp/hp11713A.rst docs/api/instruments/hp/hp33120A.rst docs/api/instruments/hp/hp3437A.rst docs/api/instruments/hp/hp34401A.rst docs/api/instruments/hp/hp3478A.rst docs/api/instruments/hp/hp437B.rst docs/api/instruments/hp/hp8116A.rst docs/api/instruments/hp/hp856xx.rst docs/api/instruments/hp/hp8657B.rst docs/api/instruments/hp/hp8753E.rst docs/api/instruments/hp/hplegacyinstrument.rst docs/api/instruments/hp/hpsystempsu.rst docs/api/instruments/hp/index.rst docs/api/instruments/ilxlightwave/index.rst docs/api/instruments/ilxlightwave/ldp3811.rst docs/api/instruments/inficon/index.rst docs/api/instruments/inficon/sqm160.rst docs/api/instruments/ipgphotonics/index.rst docs/api/instruments/ipgphotonics/yar.rst docs/api/instruments/keithley/index.rst docs/api/instruments/keithley/keithley2000.rst docs/api/instruments/keithley/keithley2182.rst docs/api/instruments/keithley/keithley2200.rst docs/api/instruments/keithley/keithley2260B.rst docs/api/instruments/keithley/keithley2281S.rst docs/api/instruments/keithley/keithley2306.rst docs/api/instruments/keithley/keithley2400.rst docs/api/instruments/keithley/keithley2400_legacy.rst docs/api/instruments/keithley/keithley2450.rst docs/api/instruments/keithley/keithley2510.rst docs/api/instruments/keithley/keithley2600.rst docs/api/instruments/keithley/keithley2700.rst docs/api/instruments/keithley/keithley2750.rst docs/api/instruments/keithley/keithley4200.rst docs/api/instruments/keithley/keithley6221.rst docs/api/instruments/keithley/keithley6517b.rst docs/api/instruments/keithley/keithleyDAQ6510.rst docs/api/instruments/keithley/keithleyDMM6500.rst docs/api/instruments/kepco/KepcoBOP.rst docs/api/instruments/kepco/index.rst docs/api/instruments/keysight/index.rst docs/api/instruments/keysight/keysight33250A.rst docs/api/instruments/keysight/keysight81160A.rst docs/api/instruments/keysight/keysightDSOX1102G.rst docs/api/instruments/keysight/keysightE36312A.rst docs/api/instruments/keysight/keysightE3631A.rst docs/api/instruments/keysight/keysightN5767A.rst docs/api/instruments/keysight/keysightN7776C.rst docs/api/instruments/keysight/keysightPNA.rst docs/api/instruments/kuhneelectronic/index.rst docs/api/instruments/kuhneelectronic/kusg245_250a.rst docs/api/instruments/lakeshore/index.rst docs/api/instruments/lakeshore/lakeshore211.rst docs/api/instruments/lakeshore/lakeshore224.rst docs/api/instruments/lakeshore/lakeshore331.rst docs/api/instruments/lakeshore/lakeshore3xx.rst docs/api/instruments/lakeshore/lakeshore421.rst docs/api/instruments/lakeshore/lakeshore425.rst docs/api/instruments/lecroy/index.rst docs/api/instruments/lecroy/lecroyT3DSO1204.rst docs/api/instruments/mksinst/index.rst docs/api/instruments/mksinst/mks937b.rst docs/api/instruments/mksinst/mks974b.rst docs/api/instruments/mksinst/mksinst.rst docs/api/instruments/newport/esp300.rst docs/api/instruments/newport/index.rst docs/api/instruments/ni/index.rst docs/api/instruments/ni/virtualbench.rst docs/api/instruments/novanta/fpu60.rst docs/api/instruments/novanta/index.rst docs/api/instruments/oxfordinstruments/IPS120_10.rst docs/api/instruments/oxfordinstruments/ITC503.rst docs/api/instruments/oxfordinstruments/MercuryiTC.rst docs/api/instruments/oxfordinstruments/PS120_10.rst docs/api/instruments/oxfordinstruments/base.rst docs/api/instruments/oxfordinstruments/index.rst docs/api/instruments/parker/index.rst docs/api/instruments/parker/parkerGV6.rst docs/api/instruments/pendulum/cnt91.rst docs/api/instruments/pendulum/index.rst docs/api/instruments/philips/PM6669.rst docs/api/instruments/philips/index.rst docs/api/instruments/proterial/index.rst docs/api/instruments/proterial/rod4.rst docs/api/instruments/ptw/index.rst docs/api/instruments/ptw/ptwDIAMENTOR.rst docs/api/instruments/ptw/ptwUNIDOS.rst docs/api/instruments/racal/index.rst docs/api/instruments/racal/racal1992.rst docs/api/instruments/razorbill/index.rst docs/api/instruments/razorbill/razorbillRP100.rst docs/api/instruments/redpitaya/index.rst docs/api/instruments/redpitaya/redpitaya_scpi.rst docs/api/instruments/rigol/index.rst docs/api/instruments/rigol/rigol_dg800.rst docs/api/instruments/rohdeschwarz/fsseries.rst docs/api/instruments/rohdeschwarz/hmp.rst docs/api/instruments/rohdeschwarz/index.rst docs/api/instruments/rohdeschwarz/sfm.rst docs/api/instruments/santec/index.rst docs/api/instruments/santec/tsl500series.rst docs/api/instruments/santec/tsl550.rst docs/api/instruments/santec/tsl570.rst docs/api/instruments/siglenttechnologies/index.rst docs/api/instruments/siglenttechnologies/siglent_sds1000xhd.rst docs/api/instruments/siglenttechnologies/siglent_sds1072cml.rst docs/api/instruments/siglenttechnologies/siglent_spd1168x.rst docs/api/instruments/siglenttechnologies/siglent_spd1305x.rst docs/api/instruments/siglenttechnologies/siglent_spdbase.rst docs/api/instruments/signalrecovery/dsp7225.rst docs/api/instruments/signalrecovery/dsp7265.rst docs/api/instruments/signalrecovery/index.rst docs/api/instruments/spellmanhv/index.rst docs/api/instruments/spellmanhv/spellmanXRV.rst docs/api/instruments/srs/index.rst docs/api/instruments/srs/ldc500series.rst docs/api/instruments/srs/sr510.rst docs/api/instruments/srs/sr570.rst docs/api/instruments/srs/sr830.rst docs/api/instruments/srs/sr860.rst docs/api/instruments/tcpowerconversion/index.rst docs/api/instruments/tcpowerconversion/tccxn.rst docs/api/instruments/tdk/index.rst docs/api/instruments/tdk/tdk_gen40_38.rst docs/api/instruments/tdk/tdk_gen80_65.rst docs/api/instruments/tektronix/afg3152c.rst docs/api/instruments/tektronix/index.rst docs/api/instruments/tektronix/tds2000.rst docs/api/instruments/teledyne/index.rst docs/api/instruments/teledyne/teledyneT3AFG.rst docs/api/instruments/teledyne/teledyne_bases.rst docs/api/instruments/temptronic/index.rst docs/api/instruments/temptronic/temptronic_ats525.rst docs/api/instruments/temptronic/temptronic_ats545.rst docs/api/instruments/temptronic/temptronic_base.rst docs/api/instruments/temptronic/temptronic_eco560.rst docs/api/instruments/texio/index.rst docs/api/instruments/texio/texioPSW360L30.rst docs/api/instruments/thermotron/index.rst docs/api/instruments/thermotron/thermotron3800.rst docs/api/instruments/thorlabs/index.rst docs/api/instruments/thorlabs/thorlabsmbxseries.rst docs/api/instruments/thorlabs/thorlabspm100usb.rst docs/api/instruments/thorlabs/thorlabspro8000.rst docs/api/instruments/thyracont/index.rst docs/api/instruments/thyracont/smartline_v1.rst docs/api/instruments/thyracont/smartline_v2.rst docs/api/instruments/toptica/ibeamsmart.rst docs/api/instruments/toptica/index.rst docs/api/instruments/velleman/index.rst docs/api/instruments/velleman/k8090.rst docs/api/instruments/yokogawa/aq6370series.rst docs/api/instruments/yokogawa/index.rst docs/api/instruments/yokogawa/yokogawa7651.rst docs/api/instruments/yokogawa/yokogawags200.rst docs/dev/coding_standards.rst docs/dev/contribute.rst docs/dev/reporting_errors.rst docs/dev/adding_instruments/advanced_communication.rst docs/dev/adding_instruments/channels.rst docs/dev/adding_instruments/index.rst docs/dev/adding_instruments/instrument.rst docs/dev/adding_instruments/properties.rst docs/dev/adding_instruments/solutions.rst docs/dev/adding_instruments/tests.rst docs/images/PyMeasure logo.png docs/images/PyMeasure logo.svg docs/images/PyMeasure preview.png docs/images/PyMeasure preview.svg docs/images/PyMeasure.png docs/images/PyMeasure.svg docs/tutorial/connecting.rst docs/tutorial/console_output.png docs/tutorial/graphical.rst docs/tutorial/gui_sequencer_example_sequence.txt docs/tutorial/index.rst docs/tutorial/managed_dock_window.png docs/tutorial/managed_dock_window_popup.gif docs/tutorial/managed_dock_window_save.png docs/tutorial/managed_dock_window_side_after.png docs/tutorial/managed_dock_window_side_drag.png docs/tutorial/managed_dock_window_tab_after.png docs/tutorial/managed_dock_window_tab_drag.png docs/tutorial/managed_dock_window_top.png docs/tutorial/procedure.rst docs/tutorial/pymeasure-estimator.png docs/tutorial/pymeasure-fileinput.png docs/tutorial/pymeasure-fileinput_complete_directory.png docs/tutorial/pymeasure-fileinput_complete_filename.png docs/tutorial/pymeasure-fileinput_disabled.png docs/tutorial/pymeasure-managedwindow-queued.png docs/tutorial/pymeasure-managedwindow-resume.png docs/tutorial/pymeasure-managedwindow-running.png docs/tutorial/pymeasure-managedwindow.png docs/tutorial/pymeasure-plotter.png docs/tutorial/pymeasure-sequencer.png docs/tutorial/pymeasure-tablewidget.png examples/.gitignore examples/README.md examples/Basic/console.py examples/Basic/gui.py examples/Basic/gui_custom_inputs.py examples/Basic/gui_custom_inputs.ui examples/Basic/gui_estimator.py examples/Basic/gui_foreign_instrument.py examples/Basic/gui_sequencer.py examples/Basic/gui_sequencer_example_sequence.txt examples/Basic/gui_table.py examples/Basic/image_gui.py examples/Basic/script.py examples/Basic/script_plotter.py examples/Current-Voltage Measurements/iv_keithley.py examples/Current-Voltage Measurements/iv_yokogawa.py examples/Notebook Experiments/default_config.ini examples/Notebook Experiments/script.ipynb examples/Notebook Experiments/script2.ipynb pymeasure/__init__.py pymeasure/console.py pymeasure/errors.py pymeasure/generator.py pymeasure/log.py pymeasure/process.py pymeasure/test.py pymeasure/thread.py pymeasure/units.py pymeasure/adapters/__init__.py pymeasure/adapters/adapter.py pymeasure/adapters/prologix.py pymeasure/adapters/protocol.py pymeasure/adapters/serial.py pymeasure/adapters/visa.py pymeasure/display/Qt.py pymeasure/display/__init__.py pymeasure/display/browser.py pymeasure/display/console.py pymeasure/display/curves.py pymeasure/display/inputs.py pymeasure/display/listeners.py pymeasure/display/log.py pymeasure/display/manager.py pymeasure/display/plotter.py pymeasure/display/thread.py pymeasure/display/widgets/__init__.py pymeasure/display/widgets/browser_widget.py pymeasure/display/widgets/console_widget.py pymeasure/display/widgets/directory_widget.py pymeasure/display/widgets/dock_widget.py pymeasure/display/widgets/estimator_widget.py pymeasure/display/widgets/fileinput_widget.py pymeasure/display/widgets/filename_widget.py pymeasure/display/widgets/image_frame.py pymeasure/display/widgets/image_widget.py pymeasure/display/widgets/inputs_widget.py pymeasure/display/widgets/log_widget.py pymeasure/display/widgets/plot_frame.py pymeasure/display/widgets/plot_widget.py pymeasure/display/widgets/results_dialog.py pymeasure/display/widgets/sequencer_widget.py pymeasure/display/widgets/tab_widget.py pymeasure/display/widgets/table_widget.py pymeasure/display/windows/__init__.py pymeasure/display/windows/managed_dock_window.py pymeasure/display/windows/managed_image_window.py pymeasure/display/windows/managed_window.py pymeasure/display/windows/plotter_window.py pymeasure/experiment/__init__.py pymeasure/experiment/config.py pymeasure/experiment/experiment.py pymeasure/experiment/listeners.py pymeasure/experiment/parameters.py pymeasure/experiment/procedure.py pymeasure/experiment/results.py pymeasure/experiment/sequencer.py pymeasure/experiment/workers.py pymeasure/instruments/__init__.py pymeasure/instruments/channel.py pymeasure/instruments/comedi.py pymeasure/instruments/common_base.py pymeasure/instruments/fakes.py pymeasure/instruments/generic_types.py pymeasure/instruments/instrument.py pymeasure/instruments/resources.py pymeasure/instruments/validators.py pymeasure/instruments/activetechnologies/AWG401x.py pymeasure/instruments/activetechnologies/__init__.py pymeasure/instruments/aculight/__init__.py pymeasure/instruments/aculight/argos.py pymeasure/instruments/advantest/__init__.py pymeasure/instruments/advantest/advantestR3767CG.py pymeasure/instruments/advantest/advantestR624X.py pymeasure/instruments/agilent/__init__.py pymeasure/instruments/agilent/agilent33220A.py pymeasure/instruments/agilent/agilent33500.py pymeasure/instruments/agilent/agilent33521A.py pymeasure/instruments/agilent/agilent34410A.py pymeasure/instruments/agilent/agilent34450A.py pymeasure/instruments/agilent/agilent4156.py pymeasure/instruments/agilent/agilent4284A.py pymeasure/instruments/agilent/agilent4294A.py pymeasure/instruments/agilent/agilent8257D.py pymeasure/instruments/agilent/agilent8722ES.py pymeasure/instruments/agilent/agilentB1500.py pymeasure/instruments/agilent/agilentB298x.py pymeasure/instruments/agilent/agilentE4408B.py pymeasure/instruments/agilent/agilentE4980.py pymeasure/instruments/agilent/agilentE5062A.py pymeasure/instruments/agilent/agilentE5270B.py pymeasure/instruments/agilent/agilentN8975A.py pymeasure/instruments/aimtti/__init__.py pymeasure/instruments/aimtti/aimttiPL.py pymeasure/instruments/aimtti/ld400p.py pymeasure/instruments/aja/__init__.py pymeasure/instruments/aja/dcxs.py pymeasure/instruments/ametek/__init__.py pymeasure/instruments/ametek/ametek7270.py pymeasure/instruments/ami/__init__.py pymeasure/instruments/ami/ami430.py pymeasure/instruments/anaheimautomation/__init__.py pymeasure/instruments/anaheimautomation/dpseriesmotorcontroller.py pymeasure/instruments/anapico/__init__.py pymeasure/instruments/anapico/apsin12G.py pymeasure/instruments/andeenhagerling/__init__.py pymeasure/instruments/andeenhagerling/ah2500a.py pymeasure/instruments/andeenhagerling/ah2700a.py pymeasure/instruments/anritsu/__init__.py pymeasure/instruments/anritsu/anritsuMG3692C.py pymeasure/instruments/anritsu/anritsuMS2090A.py pymeasure/instruments/anritsu/anritsuMS464xB.py pymeasure/instruments/anritsu/anritsuMS9710C.py pymeasure/instruments/anritsu/anritsuMS9740A.py pymeasure/instruments/attocube/__init__.py pymeasure/instruments/attocube/anc300.py pymeasure/instruments/bkprecision/__init__.py pymeasure/instruments/bkprecision/bkprecision9130b.py pymeasure/instruments/danfysik/__init__.py pymeasure/instruments/danfysik/danfysik8500.py pymeasure/instruments/deltaelektronika/__init__.py pymeasure/instruments/deltaelektronika/sm7045d.py pymeasure/instruments/edwards/__init__.py pymeasure/instruments/edwards/nxds.py pymeasure/instruments/eurotest/__init__.py pymeasure/instruments/eurotest/eurotestHPP120256.py pymeasure/instruments/fluke/__init__.py pymeasure/instruments/fluke/fluke7341.py pymeasure/instruments/formfactor/__init__.py pymeasure/instruments/formfactor/velox.py pymeasure/instruments/fwbell/__init__.py pymeasure/instruments/fwbell/fwbell5080.py pymeasure/instruments/hcp/__init__.py pymeasure/instruments/hcp/tc038.py pymeasure/instruments/hcp/tc038d.py pymeasure/instruments/heidenhain/__init__.py pymeasure/instruments/heidenhain/nd287.py pymeasure/instruments/hp/__init__.py pymeasure/instruments/hp/hp11713a.py pymeasure/instruments/hp/hp33120A.py pymeasure/instruments/hp/hp3437A.py pymeasure/instruments/hp/hp34401A.py pymeasure/instruments/hp/hp3478A.py pymeasure/instruments/hp/hp437b.py pymeasure/instruments/hp/hp8116a.py pymeasure/instruments/hp/hp856Xx.py pymeasure/instruments/hp/hp8657b.py pymeasure/instruments/hp/hp8753e.py pymeasure/instruments/hp/hplegacyinstrument.py pymeasure/instruments/hp/hpsystempsu.py pymeasure/instruments/ilxlightwave/__init__.py pymeasure/instruments/ilxlightwave/ldp3811.py pymeasure/instruments/inficon/__init__.py pymeasure/instruments/inficon/sqm160.py pymeasure/instruments/ipgphotonics/__init__.py pymeasure/instruments/ipgphotonics/yar.py pymeasure/instruments/keithley/__init__.py pymeasure/instruments/keithley/buffer.py pymeasure/instruments/keithley/keithley2000.py pymeasure/instruments/keithley/keithley2182.py pymeasure/instruments/keithley/keithley2200.py pymeasure/instruments/keithley/keithley2260B.py pymeasure/instruments/keithley/keithley2281S.py pymeasure/instruments/keithley/keithley2306.py pymeasure/instruments/keithley/keithley2400.py pymeasure/instruments/keithley/keithley2400_legacy.py pymeasure/instruments/keithley/keithley2450.py pymeasure/instruments/keithley/keithley2510.py pymeasure/instruments/keithley/keithley2600.py pymeasure/instruments/keithley/keithley2700.py pymeasure/instruments/keithley/keithley2750.py pymeasure/instruments/keithley/keithley4200.py pymeasure/instruments/keithley/keithley6221.py pymeasure/instruments/keithley/keithley6517b.py pymeasure/instruments/keithley/keithleyDAQ6510.py pymeasure/instruments/keithley/keithleyDMM6500.py pymeasure/instruments/kepco/__init__.py pymeasure/instruments/kepco/kepcobop.py pymeasure/instruments/keysight/__init__.py pymeasure/instruments/keysight/keysight33250A.py pymeasure/instruments/keysight/keysight81160A.py pymeasure/instruments/keysight/keysightDSOX1102G.py pymeasure/instruments/keysight/keysightE36312A.py pymeasure/instruments/keysight/keysightE3631A.py pymeasure/instruments/keysight/keysightN5767A.py pymeasure/instruments/keysight/keysightN7776C.py pymeasure/instruments/keysight/keysightPNA.py pymeasure/instruments/kuhneelectronic/__init__.py pymeasure/instruments/kuhneelectronic/kusg245_250a.py pymeasure/instruments/lakeshore/__init__.py pymeasure/instruments/lakeshore/lakeshore211.py pymeasure/instruments/lakeshore/lakeshore224.py pymeasure/instruments/lakeshore/lakeshore331.py pymeasure/instruments/lakeshore/lakeshore3xx.py pymeasure/instruments/lakeshore/lakeshore421.py pymeasure/instruments/lakeshore/lakeshore425.py pymeasure/instruments/lakeshore/lakeshore_base.py pymeasure/instruments/lecroy/__init__.py pymeasure/instruments/lecroy/lecroyT3DSO1204.py pymeasure/instruments/mksinst/__init__.py pymeasure/instruments/mksinst/mks937b.py pymeasure/instruments/mksinst/mks974b.py pymeasure/instruments/mksinst/mksinst.py pymeasure/instruments/newport/__init__.py pymeasure/instruments/newport/esp300.py pymeasure/instruments/ni/__init__.py pymeasure/instruments/ni/daqmx.py pymeasure/instruments/ni/nidaq.py pymeasure/instruments/ni/virtualbench.py pymeasure/instruments/novanta/__init__.py pymeasure/instruments/novanta/fpu60.py pymeasure/instruments/oxfordinstruments/__init__.py pymeasure/instruments/oxfordinstruments/base.py pymeasure/instruments/oxfordinstruments/ips120_10.py pymeasure/instruments/oxfordinstruments/itc503.py pymeasure/instruments/oxfordinstruments/mercuryitc.py pymeasure/instruments/oxfordinstruments/ps120_10.py pymeasure/instruments/parker/__init__.py pymeasure/instruments/parker/parkerGV6.py pymeasure/instruments/pendulum/__init__.py pymeasure/instruments/pendulum/cnt91.py pymeasure/instruments/philips/PM6669.py pymeasure/instruments/philips/__init__.py pymeasure/instruments/proterial/__init__.py pymeasure/instruments/proterial/rod4.py pymeasure/instruments/ptw/__init__.py pymeasure/instruments/ptw/ptwDIAMENTOR.py pymeasure/instruments/ptw/ptwUNIDOS.py pymeasure/instruments/racal/__init__.py pymeasure/instruments/racal/racal1992.py pymeasure/instruments/razorbill/__init__.py pymeasure/instruments/razorbill/razorbillRP100.py pymeasure/instruments/redpitaya/__init__.py pymeasure/instruments/redpitaya/redpitaya_scpi.py pymeasure/instruments/rigol/__init__.py pymeasure/instruments/rigol/rigol_dg800.py pymeasure/instruments/rohdeschwarz/__init__.py pymeasure/instruments/rohdeschwarz/fsl.py pymeasure/instruments/rohdeschwarz/fsseries.py pymeasure/instruments/rohdeschwarz/hmp.py pymeasure/instruments/rohdeschwarz/sfm.py pymeasure/instruments/santec/__init__.py pymeasure/instruments/santec/tsl500series.py pymeasure/instruments/santec/tsl550.py pymeasure/instruments/santec/tsl570.py pymeasure/instruments/siglenttechnologies/__init__.py pymeasure/instruments/siglenttechnologies/siglent_sds1000xhd.py pymeasure/instruments/siglenttechnologies/siglent_sds1072cml.py pymeasure/instruments/siglenttechnologies/siglent_spd1168x.py pymeasure/instruments/siglenttechnologies/siglent_spd1305x.py pymeasure/instruments/siglenttechnologies/siglent_spdbase.py pymeasure/instruments/signalrecovery/__init__.py pymeasure/instruments/signalrecovery/dsp7225.py pymeasure/instruments/signalrecovery/dsp7265.py pymeasure/instruments/signalrecovery/dsp_base.py pymeasure/instruments/spellmanhv/__init__.py pymeasure/instruments/spellmanhv/spellmanXRV.py pymeasure/instruments/srs/__init__.py pymeasure/instruments/srs/ldc500series.py pymeasure/instruments/srs/sg380.py pymeasure/instruments/srs/sr510.py pymeasure/instruments/srs/sr570.py pymeasure/instruments/srs/sr830.py pymeasure/instruments/srs/sr860.py pymeasure/instruments/tcpowerconversion/__init__.py pymeasure/instruments/tcpowerconversion/tccxn.py pymeasure/instruments/tdk/__init__.py pymeasure/instruments/tdk/tdk_base.py pymeasure/instruments/tdk/tdk_gen40_38.py pymeasure/instruments/tdk/tdk_gen80_65.py pymeasure/instruments/tektronix/__init__.py pymeasure/instruments/tektronix/afg3152c.py pymeasure/instruments/tektronix/tds2000.py pymeasure/instruments/teledyne/__init__.py pymeasure/instruments/teledyne/teledyneMAUI.py pymeasure/instruments/teledyne/teledyneT3AFG.py pymeasure/instruments/teledyne/teledyne_oscilloscope.py pymeasure/instruments/temptronic/__init__.py pymeasure/instruments/temptronic/temptronic_ats525.py pymeasure/instruments/temptronic/temptronic_ats545.py pymeasure/instruments/temptronic/temptronic_base.py pymeasure/instruments/temptronic/temptronic_eco560.py pymeasure/instruments/texio/__init__.py pymeasure/instruments/texio/texioPSW360L30.py pymeasure/instruments/thermotron/__init__.py pymeasure/instruments/thermotron/thermotron3800.py pymeasure/instruments/thorlabs/__init__.py pymeasure/instruments/thorlabs/thorlabsmbxseries.py pymeasure/instruments/thorlabs/thorlabspm100usb.py pymeasure/instruments/thorlabs/thorlabspro8000.py pymeasure/instruments/thyracont/__init__.py pymeasure/instruments/thyracont/smartline_v1.py pymeasure/instruments/thyracont/smartline_v2.py pymeasure/instruments/toptica/__init__.py pymeasure/instruments/toptica/ibeamsmart.py pymeasure/instruments/velleman/__init__.py pymeasure/instruments/velleman/velleman_k8090.py pymeasure/instruments/yokogawa/__init__.py pymeasure/instruments/yokogawa/aq6370series.py pymeasure/instruments/yokogawa/yokogawa7651.py pymeasure/instruments/yokogawa/yokogawags200.py tests/conftest.py tests/test_expected_protocol.py tests/test_generator.py tests/test_log.py tests/test_process.py tests/test_thread.py tests/adapters/test_adapter.py tests/adapters/test_prologix.py tests/adapters/test_protocol.py tests/adapters/test_serial.py tests/adapters/test_serial_with_loopback.py tests/adapters/test_visa.py tests/display/test_console.py tests/display/test_inputs.py tests/display/test_plotter.py tests/display/test_windows.py tests/display/widgets/test_inputs_widget.py tests/experiment/test_listeners.py tests/experiment/test_metadata.py tests/experiment/test_parameters.py tests/experiment/test_procedure.py tests/experiment/test_replace_placeholders.py tests/experiment/test_results.py tests/experiment/test_sequencer.py tests/experiment/test_workers.py tests/experiment/data/__init__.py tests/experiment/data/procedure_for_testing.py tests/experiment/data/results_for_testing.csv tests/experiment/data/results_for_testing_parameters.csv tests/instruments/test_all_instruments.py tests/instruments/test_channel.py tests/instruments/test_common_base.py tests/instruments/test_connection_configuration.py tests/instruments/test_generic_types.py tests/instruments/test_instrument.py tests/instruments/test_scpi_mixin_with_device.py tests/instruments/test_validators.py tests/instruments/activetechnologies/test_AWG401x.py tests/instruments/aculight/test_argos.py tests/instruments/advantest/test_advantestR624X.py tests/instruments/agilent/test_agilent33500.py tests/instruments/agilent/test_agilent33500_with_device.py tests/instruments/agilent/test_agilent34450A.py tests/instruments/agilent/test_agilent34450A_with_device.py tests/instruments/agilent/test_agilent4156.py tests/instruments/agilent/test_agilent4284A.py tests/instruments/agilent/test_agilent4294A.py tests/instruments/agilent/test_agilentB1500.py tests/instruments/agilent/test_agilentB298x.py tests/instruments/agilent/test_agilentB298x_with_device.py tests/instruments/agilent/test_agilentE4408B.py tests/instruments/agilent/test_agilentE4980A.py tests/instruments/agilent/test_agilentE4980A_with_device.py tests/instruments/agilent/test_agilentE5062A.py tests/instruments/agilent/test_agilentE5062A_with_device.py tests/instruments/agilent/test_agilentE5270B.py tests/instruments/agilent/test_agilentE5270B_with_device.py tests/instruments/agilent/test_agilentN8975A.py tests/instruments/agilent/test_agilentN8975A_with_device.py tests/instruments/aimtti/test_PL303QMDP_with_device.py tests/instruments/aimtti/test_aimttl.py tests/instruments/aimtti/test_ld400p.py tests/instruments/aimtti/test_ld400p_with_device.py tests/instruments/aja/test_dcxs.py tests/instruments/ametek/test_ametek7270.py tests/instruments/anaheimautomation/test_dpseriesmotorcontroller.py tests/instruments/anritsu/test_anritsuMG3692C.py tests/instruments/anritsu/test_anritsuMS2090A.py tests/instruments/anritsu/test_anritsuMS464xB.py tests/instruments/attocube/test_anc300.py tests/instruments/danfysik/test_danfysik8500.py tests/instruments/eurotest/test_eurotestHPP120256.py tests/instruments/fluke/test_fluke7341.py tests/instruments/formfactor/test_formfactorVelox.py tests/instruments/formfactor/test_formfactorVelox_with_device.py tests/instruments/fwbell/test_fwbell5080.py tests/instruments/hcp/test_tc038.py tests/instruments/hcp/test_tc038d.py tests/instruments/hp/test_hp11713a.py tests/instruments/hp/test_hp33120A.py tests/instruments/hp/test_hp34401a.py tests/instruments/hp/test_hp34401a_with_device.py tests/instruments/hp/test_hp3478a.py tests/instruments/hp/test_hp437b.py tests/instruments/hp/test_hp437b_with_device.py tests/instruments/hp/test_hp8116a.py tests/instruments/hp/test_hp8116a_with_device.py tests/instruments/hp/test_hp856Xx.py tests/instruments/hp/test_hp8657b.py tests/instruments/hp/test_hp8753e.py tests/instruments/hp/test_hp8753e_with_device.py tests/instruments/ilxlightwave/test_ldp3811.py tests/instruments/inficon/test_sqm160.py tests/instruments/ipgphotonics/test_yar.py tests/instruments/keithley/test_keithley2000.py tests/instruments/keithley/test_keithley2182.py tests/instruments/keithley/test_keithley2200.py tests/instruments/keithley/test_keithley2281S.py tests/instruments/keithley/test_keithley2306.py tests/instruments/keithley/test_keithley2306_with_device.py tests/instruments/keithley/test_keithley2400.py tests/instruments/keithley/test_keithley2400_with_device.py tests/instruments/keithley/test_keithley2510.py tests/instruments/keithley/test_keithley2750.py tests/instruments/keithley/test_keithley4200.py tests/instruments/keithley/test_keithley4200_with_device.py tests/instruments/keithley/test_keithleyDAQ6510.py tests/instruments/keithley/test_keithleyDAQ6510_with_device.py tests/instruments/keithley/test_keithleyDMM6500.py tests/instruments/keithley/test_keithleyDMM6500_with_device.py tests/instruments/kepco/test_kepcobop.py tests/instruments/keysight/test_keysight33250A.py tests/instruments/keysight/test_keysight33250A_with_device.py tests/instruments/keysight/test_keysight81160A.py tests/instruments/keysight/test_keysight81160A_with_device.py tests/instruments/keysight/test_keysightDSOX1102G_with_device.py tests/instruments/keysight/test_keysightE36312A.py tests/instruments/keysight/test_keysightE3631A.py tests/instruments/keysight/test_keysightE3631A_with_device.py tests/instruments/keysight/test_keysightPNA.py tests/instruments/keysight/test_keysightPNA_with_device.py tests/instruments/kuhneelectronic/test_kusg245_250a.py tests/instruments/lakeshore/test_lakeshore211.py tests/instruments/lakeshore/test_lakeshore421.py tests/instruments/lakeshore/test_lakeshore425.py tests/instruments/lecroy/test_lecroyT3DSO1204.py tests/instruments/lecroy/test_lecroyT3DSO1204_with_device.py tests/instruments/mksinst/test_mks937b.py tests/instruments/mksinst/test_mks974b.py tests/instruments/novanta/test_fpu60.py tests/instruments/oxfordinstruments/test_base_instrument.py tests/instruments/oxfordinstruments/test_ips120_10.py tests/instruments/oxfordinstruments/test_mercuryitc.py tests/instruments/oxfordinstruments/test_ps120_10.py tests/instruments/parker/test_parkerGV6.py tests/instruments/pendulum/test_cnt91.py tests/instruments/philips/test_PM6669.py tests/instruments/philips/test_PM6669_with_device.py tests/instruments/proterial/test_rod4.py tests/instruments/ptw/test_ptwDIAMENTOR.py tests/instruments/ptw/test_ptwDIAMENTOR_with_device.py tests/instruments/ptw/test_ptwUNIDOS.py tests/instruments/ptw/test_ptwUNIDOS_with_device.py tests/instruments/racal/test_racal1992.py tests/instruments/redpitaya/test_redpitaya_scpi.py tests/instruments/redpitaya/test_redpitaya_scpi_with_device.py tests/instruments/rigol/test_rigol_dg800.py tests/instruments/rohdeschwarz/test_fsl_with_device.py tests/instruments/rohdeschwarz/test_fsw.py tests/instruments/rohdeschwarz/test_hmp.py tests/instruments/rohdeschwarz/test_hmp_with_device.py tests/instruments/santec/test_tsl570.py tests/instruments/siglenttechnologies/test_siglent_sds1000xhd.py tests/instruments/siglenttechnologies/test_siglent_sds1000xhd_with_device.py tests/instruments/siglenttechnologies/test_siglent_sds1072cml.py tests/instruments/siglenttechnologies/test_siglent_spd1168x.py tests/instruments/siglenttechnologies/test_siglent_spd1305x.py tests/instruments/signalrecovery/test_dsp7225.py tests/instruments/signalrecovery/test_dsp7265.py tests/instruments/signalrecovery/test_dspbase.py tests/instruments/spellmanhv/test_spellmanXRV.py tests/instruments/spellmanhv/test_spellmanXRV_with_device.py tests/instruments/srs/test_ldc500series.py tests/instruments/srs/test_ldc501_with_device.py tests/instruments/srs/test_sr830.py tests/instruments/tcpowerconversion/test_cxn.py tests/instruments/tdk/test_tdk_base.py tests/instruments/tdk/test_tdk_gen40-38.py tests/instruments/tdk/test_tdk_gen80-65.py tests/instruments/tektronix/test_afg3152.py tests/instruments/teledyne/test_teledyneMAUI.py tests/instruments/teledyne/test_teledyneMAUI_with_device.py tests/instruments/teledyne/test_teledyneT3AFG.py tests/instruments/temptronic/test_temptronic_base.py tests/instruments/texio/test_texioPSW360L30.py tests/instruments/texio/test_texioPSW360L30_with_device.py tests/instruments/thorlabs/test_thorlabsmbxseries.py tests/instruments/thyracont/test_smartline_v1.py tests/instruments/thyracont/test_smartline_v2.py tests/instruments/toptica/test_ibeamsmart.py tests/instruments/velleman/test_velleman_k8090.py tests/instruments/velleman/test_velleman_k8090_with_device.py tests/instruments/yokogawa/test_aq6370d.py././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275456.0 pymeasure-0.16.0/PyMeasure.egg-info/dependency_links.txt0000644000175100017510000000000115203313300022716 0ustar00runnerrunner ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275456.0 pymeasure-0.16.0/PyMeasure.egg-info/requires.txt0000644000175100017510000000043315203313300021250 0ustar00runnerrunnernumpy<3,>=1.6.1 pandas<4,>=0.14 pint pyvisa>=1.9 pyserial>=2.7 pyqtgraph>=0.12 qtpy>=2.4 [docs] sphinx>=5.0.0 sphinx_rtd_theme>=1.1.0 sphinx_autodoc_typehints>=2.3.0 [tcp] pyzmq>=16.0.2 cloudpickle>=0.3.1 [tests] pytest>=3.3.0 pytest-cov>=4.1.0 pytest-qt>=2.4.0 pyvisa-sim>=0.4.0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275456.0 pymeasure-0.16.0/PyMeasure.egg-info/top_level.txt0000644000175100017510000000001215203313300021373 0ustar00runnerrunnerpymeasure ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/README.rst0000644000175100017510000000544115203313266014752 0ustar00runnerrunner.. image:: https://raw.githubusercontent.com/pymeasure/pymeasure/master/docs/images/PyMeasure.png :alt: PyMeasure Scientific package PyMeasure scientific package ############################ PyMeasure makes scientific measurements easy to set up and run. The package contains a repository of instrument classes and a system for running experiment procedures, which provides graphical interfaces for graphing live data and managing queues of experiments. Both parts of the package are independent, and when combined provide all the necessary requirements for advanced measurements with only limited coding. PyMeasure is currently under active development, so please report any issues you experience to our `Issues page`_. .. _Issues page: https://github.com/pymeasure/pymeasure/issues Project Information ------------------- PyMeasure is tested with continuous-integration on Linux, macOS, and Windows for all supported Python versions. .. image:: https://img.shields.io/pypi/pyversions/pymeasure :alt: PyPI - Python Version .. image:: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml/badge.svg :target: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml .. image:: http://readthedocs.org/projects/pymeasure/badge/?version=latest :target: http://pymeasure.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.595633.svg :target: https://doi.org/10.5281/zenodo.595633 .. image:: https://anaconda.org/conda-forge/pymeasure/badges/version.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://anaconda.org/conda-forge/pymeasure/badges/downloads.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://codecov.io/gh/pymeasure/pymeasure/graph/badge.svg :target: https://codecov.io/gh/pymeasure/pymeasure Related Projects ---------------- - `LECO Protocol `_: Open standard for laboratory equipment communication using modern protocols - `pyleco `_: Python library implementing LECO for distributed instrument control systems - `Python Lab Automation Landscape `_: Curated collection of Python tools for laboratory automation and instrumentation Quick start =========== Check out `the documentation`_ for the `quick start guide`_, that covers the installation of Python and PyMeasure. There are a number of examples in the `examples`_ directory that can help you get up and running. .. _the documentation: http://pymeasure.readthedocs.org/en/latest/ .. _quick start guide: http://pymeasure.readthedocs.io/en/latest/quick_start.html .. _examples: https://github.com/pymeasure/pymeasure/tree/master/examples ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/RELEASE.md0000644000175100017510000000663615203313266014674 0ustar00runnerrunner# Release ## PyMeasure package 1. Pull the latest `master` branch 2. `git checkout -b v_release` 3. Update CHANGES.rst with the changelog * On the repo page, go to Tags->Releases->Draft a new release * Add a dummy tag name and select "create tag on publish" -- we will not execute this, just use it to autogenerate a changelog * The button "Generate release notes" will generate Markdown text with all PRs since the last tag -- copy that into CHANGES.rst * Adapt the format and structure to the previous release message: * Divide the entries into categories and try to begin entries with "New", "Add", "Fix" or "Remove" as appropriate. (This could also be automated by the above generator with some labeling effort on our part) * We also remove the PR URLs as they clutter the log and condense the new contributors list. * Helpful regex entries: * For the PR URLs: `by (@[\w-]+) in https://github.com/pymeasure/pymeasure/pull/(\d+)` to `($1, #$2)`. * For new contributors: ` made their first contribution in https://github.com/pymeasure/pymeasure/pull/\d+` to `, ` 4. Update the version number in CITATION.cff * On the line starting with `version: `, replace the current version number with the new version number 5. Push the changes up as a PR 6. Verify that the builds complete 7. Merge the PR 8. Create a new [release on GitHub](https://github.com/pymeasure/pymeasure/releases) * Add a tag name in the format "vX.Y.Z" and select "create tag on publish" * You'll have to paste in the changelog entry and probably edit it a bit as that form expects Markdown, not ReST (probably just removing `:code:` tags will be sufficient). * Publish the release 8. Approve the _build and upload_ run under Actions. This will create the wheel and upload it to PyPI. ## PyPI release - manually Official guide [here](https://packaging.python.org/en/latest/tutorials/packaging-projects/). If the upload action does not work, you can create a PyPI release manually: 1. Fetch `master`, build and check the source packages - `python -m pip install --upgrade build twine` - `python -m build` - Check the distributions (`twine check dist/*`, version will not yet be correct) 2. Ensure to have a git tag in the format "vX.Y.Z" 3. Build final packages and confirm the correct version number is being used - `python -m build` - Check the distributions (`twine check dist/*`) 4. Upload the wheel and source distributions to the test server - `python -m twine upload --repository testpypi dist/*` 5. Verify the test repository: https://test.pypi.org/project/PyMeasure 6. Confirm that the installation works (best in a separate environment) - `python -m pip install --index-url https://test.pypi.org/simple/ --no-deps pymeasure` 7. Upload to the real repository (`twine upload dist/PyMeasure-*`) 8. Verify that the package is updated: https://pypi.org/project/PyMeasure ## conda-forge feedstock 1. Release to PyPI first (the feedstock pulls from there) 2. Pull the latest `master` branch 3. `git checkout -b v_release` 4. Get the SHA256 hash of the PyPI source package at https://pypi.org/project/PyMeasure/#files 5. Update recipe/meta.yml with the checksum and version number. Important: Work in your personal fork of the feedstock repo (the conda-forge tooling requires that) and create a PR from there. 6. Push the changes up as a PR 7. Verify that the builds complete 8. Merge the PR ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/codecov.yml0000644000175100017510000000006415203313266015424 0ustar00runnerrunnercoverage: status: project: off patch: off ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.952998 pymeasure-0.16.0/docs/0000755000175100017510000000000015203313301014175 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/Makefile0000644000175100017510000001516615203313266015660 0ustar00runnerrunner# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = sphinx-build PAPER = BUILDDIR = _build # User-friendly check for sphinx-build ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) endif # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " latexpdf to make LaTeX files and run them through pdflatex" @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " xml to make Docutils-native XML files" @echo " pseudoxml to make pseudoxml-XML files for display purposes" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" clean: rm -rf $(BUILDDIR)/* html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." dirhtml: $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." singlehtml: $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml @echo @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." pickle: $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle @echo @echo "Build finished; now you can process the pickle files." json: $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json @echo @echo "Build finished; now you can process the JSON files." htmlhelp: $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in $(BUILDDIR)/htmlhelp." qthelp: $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp @echo @echo "Build finished; now you can run "qcollectiongenerator" with the" \ ".qhcp project file in $(BUILDDIR)/qthelp, like this:" @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PyMeasure.qhcp" @echo "To view the help file:" @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PyMeasure.qhc" devhelp: $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp @echo @echo "Build finished." @echo "To view the help file:" @echo "# mkdir -p $$HOME/.local/share/devhelp/PyMeasure" @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PyMeasure" @echo "# devhelp" epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." @echo "Run \`make' in that directory to run these through (pdf)latex" \ "(use \`make latexpdf' here to do that automatically)." latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." latexpdfja: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through platex and dvipdfmx..." $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @echo @echo "Build finished. The text files are in $(BUILDDIR)/text." man: $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man @echo @echo "Build finished. The manual pages are in $(BUILDDIR)/man." texinfo: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." @echo "Run \`make' in that directory to run these through makeinfo" \ "(use \`make info' here to do that automatically)." info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale @echo @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." changes: $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes @echo @echo "The overview file is in $(BUILDDIR)/changes." linkcheck: $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in $(BUILDDIR)/linkcheck/output.txt." doctest: $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." xml: $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml @echo @echo "Build finished. The XML files are in $(BUILDDIR)/xml." pseudoxml: $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml @echo @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9535365 pymeasure-0.16.0/docs/about/0000755000175100017510000000000015203313301015307 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/about/authors.rst0000644000175100017510000000073715203313266017547 0ustar00runnerrunnerAuthors ======= PyMeasure was started in 2013 by Colin Jermain and Graham Rowlands at Cornell University, when it became apparent that both were working on similar Python packages for scientific measurements. PyMeasure combined these efforts and continues to gain valuable contributions from other scientists who are interested in advancing measurement software. The following developers have contributed to the PyMeasure package: .. include:: ../../AUTHORS.txt :literal: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/about/changes.rst0000644000175100017510000000011415203313266017457 0ustar00runnerrunner:tocdepth: 1 ========= Changelog ========= .. include:: ../../CHANGES.rst ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/about/license.rst0000644000175100017510000000207615203313266017502 0ustar00runnerrunnerLicense ======= Copyright (c) 2013-2026 PyMeasure Developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/about/related_projects.rst0000644000175100017510000000124115203313266021402 0ustar00runnerrunnerRelated Projects ================ PyMeasure is part of a broader ecosystem of laboratory automation tools: - `LECO Protocol `_: Open standard for laboratory equipment communication using modern protocols - `pyleco `_: Python library implementing LECO for distributed instrument control systems - `Python Lab Automation Landscape `_: Curated collection of Python tools for laboratory automation and instrumentation These projects provide complementary capabilities to PyMeasure for building robust laboratory automation systems.././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9536781 pymeasure-0.16.0/docs/api/0000755000175100017510000000000015203313301014746 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/adapters.rst0000644000175100017510000000346715203313266017327 0ustar00runnerrunner################## pymeasure.adapters ################## The adapter classes allow the instruments to be independent of the communication method used. The instrument implementation takes care of any potential quirks in its communication protocol (see :ref:`advanced_communication_protocols`), and the adapter takes care of the details of the over-the-wire communication with the hardware device. In the vast majority of cases, it will be sufficient to pass a connection string or integer to the instrument (see :ref:`connecting-to-an-instrument`), which uses the :class:`pymeasure.adapters.VISAAdapter` in the background. ================== Adapter base class ================== .. autoclass:: pymeasure.adapters.Adapter :members: :undoc-members: ============ VISA adapter ============ .. autoclass:: pymeasure.adapters.VISAAdapter :members: :undoc-members: :inherited-members: :show-inheritance: ============== Serial adapter ============== .. autoclass:: pymeasure.adapters.SerialAdapter :members: :undoc-members: :inherited-members: :show-inheritance: :private-members: _format_binary_values ================ Prologix adapter ================ .. autoclass:: pymeasure.adapters.PrologixAdapter :members: :undoc-members: :inherited-members: :show-inheritance: :private-members: _format_binary_values ============= Test adapters ============= These pieces are useful when writing tests. .. automodule:: pymeasure.test :members: :undoc-members: :show-inheritance: .. autoclass:: pymeasure.adapters.ProtocolAdapter :members: :undoc-members: :show-inheritance: .. autoclass:: pymeasure.adapters.FakeAdapter :members: :undoc-members: :inherited-members: :show-inheritance: .. autoclass:: pymeasure.generator.Generator :members: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9553957 pymeasure-0.16.0/docs/api/display/0000755000175100017510000000000015203313301016413 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/Qt.rst0000644000175100017510000000032015203313266017536 0ustar00runnerrunner########## Qt classes ########## All Qt imports should reference :code:`pymeasure.display.Qt`, for consistent importing from either PySide or PyQt4. .. automethod:: pymeasure.display.Qt.fromUi :noindex:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/browser.rst0000644000175100017510000000020015203313266020632 0ustar00runnerrunner############### Browser classes ############### .. automodule:: pymeasure.display.browser :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/console.rst0000644000175100017510000000017315203313266020622 0ustar00runnerrunner############# Console class ############# .. automodule:: pymeasure.display.console :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/curves.rst0000644000175100017510000000017415203313266020470 0ustar00runnerrunner############## Curves classes ############## .. automodule:: pymeasure.display.curves :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/index.rst0000644000175100017510000000045015203313266020265 0ustar00runnerrunner################# pymeasure.display ################# This section contains specific documentation on the classes and methods of the package. .. toctree:: :maxdepth: 2 browser console curves inputs listeners log manager plotter Qt thread widgets windows ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/inputs.rst0000644000175100017510000000017415203313266020503 0ustar00runnerrunner############## Inputs classes ############## .. automodule:: pymeasure.display.inputs :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/listeners.rst0000644000175100017510000000021015203313266021160 0ustar00runnerrunner################# Listeners classes ################# .. automodule:: pymeasure.display.listeners :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/log.rst0000644000175100017510000000016015203313266017735 0ustar00runnerrunner########### Log classes ########### .. automodule:: pymeasure.display.log :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/manager.rst0000644000175100017510000000020015203313266020561 0ustar00runnerrunner############### Manager classes ############### .. automodule:: pymeasure.display.manager :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/plotter.rst0000644000175100017510000000017215203313266020650 0ustar00runnerrunner############# Plotter class ############# .. automodule:: pymeasure.display.plotter :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/thread.rst0000644000175100017510000000017415203313266020430 0ustar00runnerrunner############## Thread classes ############## .. automodule:: pymeasure.display.thread :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/widgets.rst0000644000175100017510000000315315203313266020627 0ustar00runnerrunner############## Widget classes ############## .. automodule:: pymeasure.display.widgets.browser_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.directory_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.estimator_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.fileinput_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.filename_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.image_frame :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.image_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.inputs_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.log_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.plot_frame :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.plot_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.results_dialog :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.sequencer_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.tab_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.dock_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.table_widget :members: :show-inheritance: .. automodule:: pymeasure.display.widgets.console_widget :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/display/windows.rst0000644000175100017510000000066615203313266020661 0ustar00runnerrunner############### Windows classes ############### .. automodule:: pymeasure.display.windows.managed_image_window :members: :show-inheritance: .. automodule:: pymeasure.display.windows.managed_window :members: :show-inheritance: .. automodule:: pymeasure.display.windows.plotter_window :members: :show-inheritance: .. automodule:: pymeasure.display.windows.managed_dock_window :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9563255 pymeasure-0.16.0/docs/api/experiment/0000755000175100017510000000000015203313301017126 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/experiment.rst0000644000175100017510000000040415203313266022050 0ustar00runnerrunner################ Experiment class ################ The Experiment class is intended for use in the Jupyter notebook environment. .. automodule:: pymeasure.experiment.experiment :members: :undoc-members: :inherited-members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/index.rst0000644000175100017510000000040215203313266020775 0ustar00runnerrunner#################### pymeasure.experiment #################### This section contains specific documentation on the classes and methods of the package. .. toctree:: :maxdepth: 2 experiment listeners procedure parameters workers results././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/listeners.rst0000644000175100017510000000022615203313266021702 0ustar00runnerrunner############## Listener class ############## .. automodule:: pymeasure.experiment.listeners :members: :undoc-members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/parameters.rst0000644000175100017510000000040415203313266022033 0ustar00runnerrunner################# Parameter classes ################# The parameter classes are used to define input variables for a :class:`.Procedure`. They each inherit from the :class:`.Parameter` base class. .. automodule:: pymeasure.experiment.parameters :members:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/procedure.rst0000644000175100017510000000015615203313266021664 0ustar00runnerrunner############### Procedure class ############### .. automodule:: pymeasure.experiment.procedure :members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/results.rst0000644000175100017510000000014515203313266021373 0ustar00runnerrunner############# Results class ############# .. automodule:: pymeasure.experiment.results :members:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/experiment/workers.rst0000644000175100017510000000021615203313266021365 0ustar00runnerrunner############ Worker class ############ .. automodule:: pymeasure.experiment.workers :members: :undoc-members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9571502 pymeasure-0.16.0/docs/api/instruments/0000755000175100017510000000000015203313301017341 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9574144 pymeasure-0.16.0/docs/api/instruments/activetechnologies/0000755000175100017510000000000015203313301023220 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/activetechnologies/AWG401x.rst0000644000175100017510000000101315203313266025012 0ustar00runnerrunner################################################################# Active Technologies AWG-401x 1.2GS/s Arbitrary Waveform Generator ################################################################# .. autoclass:: pymeasure.instruments.activetechnologies.AWG401x_AFG :members: :show-inheritance: .. autoclass:: pymeasure.instruments.activetechnologies.AWG401x_AWG :members: :show-inheritance: .. autoclass:: pymeasure.instruments.activetechnologies.AWG401x.ChannelAFG :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/activetechnologies/index.rst0000644000175100017510000000061215203313266025072 0ustar00runnerrunner.. module:: pymeasure.instruments.activetechnologies ################### Active Technologies ################### This section contains specific documentation on the Active Technologies instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 AWG401x ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.957688 pymeasure-0.16.0/docs/api/instruments/aculight/0000755000175100017510000000000015203313301021141 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aculight/argos.rst0000644000175100017510000000027515203313266023024 0ustar00runnerrunner############################## Aculight Argos 2400 OPO system ############################## .. autoclass:: pymeasure.instruments.aculight.argos.Argos :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aculight/index.rst0000644000175100017510000000054415203313266023017 0ustar00runnerrunner.. module:: pymeasure.instruments.aculight ######## Aculight ######## This section contains specific documentation on the (Lockheed Martin) Aculight instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 argos ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.958084 pymeasure-0.16.0/docs/api/instruments/advantest/0000755000175100017510000000000015203313301021332 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/advantest/advantestR3767CG.rst0000644000175100017510000000034515203313266024754 0ustar00runnerrunner######################################### Advantest R3767CG Vector Network Analyzer ######################################### .. automodule:: pymeasure.instruments.advantest.advantestR3767CG :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/advantest/advantestR624X.rst0000644000175100017510000003652215203313266024605 0ustar00runnerrunner######################################################### Advantest R6245/R6246 DC Voltage/Current Sources/Monitors ######################################################### .. currentmodule:: pymeasure.instruments.advantest.advantestR624X ********************************************** Main Classes ********************************************** .. autoclass:: AdvantestR6245 :members: :show-inheritance: :member-order: bysource .. autoclass:: AdvantestR6246 :members: :show-inheritance: :member-order: bysource .. autoclass:: AdvantestR624X :members: :show-inheritance: :member-order: bysource .. autoclass:: SMUChannel :members: :show-inheritance: :member-order: bysource .. automodule:: pymeasure.instruments.advantest.advantestR624X :members: :exclude-members: AdvantestR6245, AdvantestR6246, AdvantestR624X, SMUChannel :show-inheritance: :member-order: bysource .. contents:: ********************************************** General Information ********************************************** The R6245/6246 Series are DC voltage/current sources and monitors having source measurement units (SMUs) with 2 isolated channels. The series covers wide source and measurement ranges. It is ideal for measurement of DC characteristics of items ranging from separate semiconductors such as bipolar transistors, MOSFETs and GaAsFETs, to ICs and power devices. Further, due to the increased measuring speed and synchronized 2-channel measurement function, device I/O characteristics can be measured with precise timing at high speed which was previously difficult to accomplish. Due to features such as the trigger link function and the sequence programming function which automatically performs a series of evaluation tests, the R6245/6246 enable much more efficient evaluation tests. There is a total of 99 commands, the majority of commands have been implemented. Device documentation is in Japanese, and the device options are enormous. The implementation is based on 6245S-GPIB-B-FHJ-8335160E01.pdf, which can be downloaded from the ADCMT website. ********************************************** Examples ********************************************** Initialization of the Instrument ==================================== .. code-block:: python from pymeasure.instruments.advantest import AdvantestR6246 from pymeasure.instruments.advantest.advantestR624X import * smu = AdvantestR6246("GPIB::1") Simple dual channel synchronous measurement example ==================================================== Measurement characteristics: Channel A (MASTER): DC voltage source + current measurement Channel B (SLAVE): Pulsed voltage source + current measurement .. note:: For dual-channel synchronous mode (``PULSED_SYNC``), use ``auto_sampling=False`` in the ``sample_mode()`` call. With ``auto_sampling=True`` (the default), the auto-output data contains the generated/source value, not the measurement result. .. warning:: ``CurrentRange.AUTO`` and ``AUTO_*`` (limited auto) ranges cannot be used for pulse measurement or pulse sweep — the instrument returns error 00211. Always use a fixed range such as ``CurrentRange.FIXED_BEST`` when configuring pulsed modes. .. code-block:: python smu = AdvantestR6246("GPIB::1") smu.reset() # Set default parameters # Ch A (MASTER): DC voltage source + current measurement smu.ch_A.voltage_source(source_range=VoltageRange.FIXED_6V, source_value=5, current_compliance=2) smu.ch_A.measure_current(current_range=CurrentRange.FIXED_BEST) # Ch B (SLAVE): Pulsed voltage source + current measurement smu.ch_B.fast_mode_enabled = True smu.ch_B.sample_hold_mode = SampleHold.MODE_1mS smu.ch_B.voltage_pulsed_source(source_range=VoltageRange.FIXED_6V, pulse_value=6, base_value=0, current_compliance=2) smu.ch_B.measure_current(current_range=CurrentRange.FIXED_BEST) smu.ch_B.set_timing_parameters(hold_time=0, measurement_delay=1e-4, pulsed_width=1e-2, pulsed_period=2e-2) # PULSED_SYNC with auto_sampling=False (critical for correct readout) smu.ch_A.set_sample_mode(SampleMode.PULSED_SYNC, auto_sampling=False) smu.ch_A.enable_source() smu.ch_B.enable_source() for i in range(10): smu.ch_A.select_for_output() # Select channel A (FCH 01?) smu.ch_A.trigger() # Trigger (XE 1, syncs both) Ic_a = smu.read_measurement() # Read channel A measurement smu.ch_B.select_for_output() # Select channel B (FCH 02?) Ic_b = smu.read_measurement() # Read channel B measurement print(f'Ic_a={Ic_a}, Ic_b={Ic_b}') smu.standby() # Put channel A & B in standby Program example for DC measurement ===================================== Measurement characteristics: Function: VSIM - Source voltage and measure current Trigger voltage: 10V Current compliance: 0.5A Measurement delay time: 1ms Integration time: 1 PLC Response: Fast After operating, the measurement is repeated 10 times with a trigger command and he prints out the results. .. code-block:: python smu = AdvantestR6246("GPIB::1") smu.reset() # Set default parameters smu.ch_A.set_sample_mode(SampleMode.ASYNC, False) # Asynchronous operation and single shot sampling by trigger and command smu.ch_A.voltage_source(source_range = VoltageRange.FIXED_BEST, source_value = 10, current_compliance = 0.5) # compliance of 0.5A smu.ch_A.measure_current() # Measure current smu.ch_A.set_timing_parameters(hold_time = 0, # 0 sec hold time measurement_delay = 1E-3, # 1ms delay between measurements pulsed_width = 5E-3, # 5ms pulse width pulsed_period = 10E-3) # 10ms pulse period smu.ch_A.sample_hold_mode = SampleHold.MODE_1PLC # Sample at 1 power line cycle smu.ch_A.fast_mode_enabled = True # Set channel response to fast smu.ch_A.enable_source() # Set channel in operating state smu.ch_A.select_for_output() # Select channel for measurement output for i in range(1, 10): smu.ch_A.trigger() # Trigger a measurement measurement = smu.read_measurement() print(f"NO {i} {measurement}") smu.ch_A.standby() # Put channel A in standby mode Program example for DC measurement (with external trigger) ========================================================== Measurement characteristics: Function: VSIM - Source voltage and measure current Source voltage: 10 V Base voltage 1 V Current compliance: 0.5 A Pulse width: 5 ms Pulse period: 10 ms Measurement delay time: 1 ms Integration time: 1 ms Response: Fast After operating, an external trigger input signal is pulsed to measure the channel operation register. Reads the fixed end bit, captures the measurement data, and prints out the measurement result. .. code-block:: python smu = AdvantestR6246("GPIB::1") smu.reset() # Set default parameters smu.ch_A.auto_zero_enabled = False smu.ch_A.set_sample_mode(SampleMode.ASYNC, False) # Asynchronous operation and single shot sampling by trigger and command smu.ch_A.voltage_pulsed_source( source_range = VoltageRange.FIXED_BEST, pulse_value = 10, base_value = 1, current_compliance = 0.5) smu.ch_A.measure_current(current_range=CurrentRange.FIXED_BEST) # Fixed range required for pulsed smu.ch_A.fast_mode_enabled = True # Set channel response to fast smu.ch_A.sample_hold_mode = SampleHold.MODE_1mS # Sample at 1mS smu.ch_A.set_timing_parameters(hold_time = 0, # 0 sec hold time measurement_delay = 1E-3, # 1ms delay between measurements pulsed_width = 5E-3, # 5ms pulse width pulsed_period = 10E-3) # 10ms pulse period smu.ch_A.trigger_input = TriggerInputType.ALL # Mode 1 enables the trigger input signal smu.ch_A.output_enable_register = COR.HAS_MEASUREMENT_DATA # Measurement data available smu.service_request_enable_register = SRER.COP # COP Set when a bit in the Channel Operations Register is set with the Enable Register set to Enable. smu.ch_A.enable_source() # Set channel in operating state smu.ch_A.select_for_output() # Select channel for measurement output for i in range(1, 10): while not smu.ch_A.operation_register & COR.HAS_MEASUREMENT_DATA: pass measurement = smu.read_measurement() print(f"NO {i} {measurement}") while not smu.ch_A.operation_register & COR.WAITING_FOR_TRIGGER: pass smu.ch_A.standby() # Put channel A in standby mode Program example for pulse measurement ================================================= Measurement characteristics: Function: ISVM - Source current and measure voltage Pulse generation current: 100mA Base current: 1mA Voltage compliance: 5V Pulse width: 0 Pulse period : 0 Measurement delay time: 0 Integration time: 1ms Response: Fast After the operation, repeat the measurement 10 times with the trigger command and print out the measurement results. .. code-block:: python smu = AdvantestR6246("GPIB::1") smu.reset() # Set default parameters smu.ch_A.set_sample_mode(SampleMode.ASYNC, auto_sampling = False) smu.ch_A.current_pulsed_source( source_range = CurrentRange.FIXED_600mA, pulse_value = 0.1, # 100mA base_value = 1E-3, # 1mA voltage_compliance = 5) # 5V smu.ch_A.measure_voltage(voltage_range = VoltageRange.FIXED_BEST) smu.ch_A.fast_mode_enabled = True # Set channel response to fast smu.ch_A.sample_hold_mode = SampleHold.MODE_1mS # Sample at 1mS smu.ch_A.set_timing_parameters(hold_time = 0, # 0 sec hold time measurement_delay = 0, # 0 sec delay between measurements pulsed_width = 0, # 0 sec pulse width pulsed_period = 0) # 0 sec pulse period smu.ch_A.enable_source() # Set channel in operating state smu.ch_A.select_for_output() # Select channel for measurement output for i in range(1, 10): smu.ch_A.trigger() # Trigger measurement measurement = smu.read_measurement() print(f"NO {i} {measurement}") while not smu.ch_A.operation_register & COR.WAITING_FOR_TRIGGER: pass smu.ch_A.standby() # Put channel A in standby mode Fixed Level Sweep Program Example ================================================= Measurement characteristics: function: VSVM - Voltage source and voltage measurement Level value: 15V Bias value: 0V Number of measurements: 20 times Compliance: 6mA Measuring range: Best fixed range (=60V range) Integration time: 100us Measurement delay time: 0 Hold time: 1ms Sampling mode: automatic sweep Measurement data output method: Buffering output (output of specified data) After operating, make 20 measurements in fixed sweep. Detect the end of sweep by looking at the Channel Operation Register (COR). After the sweep is finished, read the measured data from 1 to 2 using the RMM command. .. code-block:: python smu = AdvantestR6246("GPIB::1") # First we setup our main parameters smu.reset() # Set default parameters smu.ch_A.set_output_type(output_type = OutputType.BUFFERING_OUTPUT_SPECIFIED, measurement_type = MeasurementType.MEASURE_DATA) smu.set_output_format(delimiter_format = 2, # No header, ASCII format block_delimiter = 1, # Make it the same as the terminator terminator = 1) # CR, LF smu.ch_A.analog_input = 1 # Turn off the analog input. smu.set_lo_common_connection_relay(enable = True) # Turns the connection relay on smu.ch_A.set_wire_mode(four_wire = False, # disable four wire measurements lo_guard = True) # enable the LO-GUARD relay. smu.ch_A.auto_zero_enabled = False smu.ch_A.trigger_input = TriggerInputType.ALL # Mode 1 enables the trigger input signal # Now we set measurement specific variables smu.ch_A.clear_measurement_buffer() smu.ch_A.set_sample_mode(SampleMode.ASYNC, auto_sampling = True) smu.ch_A.voltage_fixed_level_sweep(voltage_range = VoltageRange.FIXED_60V, voltage_level = 15, measurement_count = 20, # 20 measurements current_compliance = 6E-3, # compliance at 6mA bias = 0) smu.ch_A.measure_voltage(voltage_range = VoltageRange.FIXED_BEST) smu.ch_A.sample_hold_mode = SampleHold.MODE_100uS smu.ch_A.set_timing_parameters(hold_time = 1E-3, # 1ms sec hold time measurement_delay = 0, # 0 sec delay between measurements pulsed_width = 0, # 0 sec pulse width pulsed_period = 0) # 0 sec pulse period smu.ch_A.enable_source() # Set channel in operating state smu.ch_A.trigger() # Start the sweep while not smu.ch_A.operation_register & COR.END_OF_SWEEP: # Wait until the sweep is done pass # Read measurements for i in range(1, 20): measurement = smu.ch_A.read_measurement_from_addr(i) print(i, measurement) smu.ch_A.standby() # Put channel A in standby mode ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/advantest/index.rst0000644000175100017510000000056415203313266023212 0ustar00runnerrunner.. module:: pymeasure.instruments.advantest ######### Advantest ######### This section contains specific documentation on the Advantest instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 advantestR3767CG advantestR624X ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9605162 pymeasure-0.16.0/docs/api/instruments/agilent/0000755000175100017510000000000015203313301020764 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent33220A.rst0000644000175100017510000000034515203313266023650 0ustar00runnerrunner########################################### Agilent 33220A Arbitrary Waveform Generator ########################################### .. autoclass:: pymeasure.instruments.agilent.Agilent33220A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent33500.rst0000644000175100017510000000042115203313266023543 0ustar00runnerrunner########################################################## Agilent 33500 Function/Arbitrary Waveform Generator Family ########################################################## .. autoclass:: pymeasure.instruments.agilent.Agilent33500 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent33521A.rst0000644000175100017510000000056415203313266023657 0ustar00runnerrunner#################################################### Agilent 33521A Function/Arbitrary Waveform Generator #################################################### .. autoclass:: pymeasure.instruments.agilent.Agilent33521A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilent33500.Agilent33500Channel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent34410A.rst0000644000175100017510000000027415203313266023653 0ustar00runnerrunner################################ Agilent 34410A Multimeter ################################ .. autoclass:: pymeasure.instruments.agilent.Agilent34410A :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent34450A.rst0000644000175100017510000000035315203313266023655 0ustar00runnerrunner############################################# HP/Agilent/Keysight 34450A Digital Multimeter ############################################# .. autoclass:: pymeasure.instruments.agilent.Agilent34450A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent4156.rst0000644000175100017510000000037115203313266023474 0ustar00runnerrunner################################################## Agilent 4155/4156 Semiconductor Parameter Analyzer ################################################## .. automodule:: pymeasure.instruments.agilent.agilent4156 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent4284A.rst0000644000175100017510000000062015203313266023574 0ustar00runnerrunner####################### Agilent 4284A LCR Meter ####################### .. autoclass:: pymeasure.instruments.agilent.Agilent4284A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilent4284A.Agilent4284ACorrection :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilent4284A.Agilent4284ASpot :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent4294A.rst0000644000175100017510000000034115203313266023575 0ustar00runnerrunner########################################## Agilent 4294A Precision Impedance Analyzer ########################################## .. autoclass:: pymeasure.instruments.agilent.Agilent4294A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent8257D.rst0000644000175100017510000000027415203313266023610 0ustar00runnerrunner############################## Agilent 8257D Signal Generator ############################## .. autoclass:: pymeasure.instruments.agilent.Agilent8257D :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilent8722ES.rst0000644000175100017510000000032515203313266023726 0ustar00runnerrunner###################################### Agilent 8722ES Vector Network Analyzer ###################################### .. autoclass:: pymeasure.instruments.agilent.Agilent8722ES :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentB1500.rst0000644000175100017510000002636415203313266023576 0ustar00runnerrunner############################################## Agilent B1500 Semiconductor Parameter Analyzer ############################################## .. currentmodule:: pymeasure.instruments.agilent.agilentB1500 .. contents:: ********************************************** General Information ********************************************** This instrument driver does not support all configuration options of the B1500 mainframe yet. So far, it is possible to interface multiple SMU modules and source/measure currents and voltages, perform sampling and staircase sweep measurements. The implementation of further measurement functionalities is highly encouraged. Meanwhile the model is managed by Keysight, see the corresponding "Programming Guide" for details on the control methods and their parameters Command Translation =================== Alphabetical list of implemented B1500 commands and their corresponding method/attribute names in this instrument driver. .. |br| raw:: html
=========== ============================================= Command Property/Method =========== ============================================= ``AAD`` :attr:`SMU.adc_type` ``AB`` :meth:`~AgilentB1500.abort` ``AIT`` :meth:`~AgilentB1500.adc_setup` ``AV`` :meth:`~AgilentB1500.adc_averaging` ``AZ`` :attr:`~AgilentB1500.adc_auto_zero` ``BC`` :meth:`~AgilentB1500.clear_buffer` ``CL`` :meth:`SMU.disable` ``CM`` :attr:`~AgilentB1500.auto_calibration` ``CMM`` :attr:`SMU.meas_op_mode` ``CN`` :meth:`SMU.enable` ``DI`` :meth:`SMU.force` mode: ``'CURRENT'`` ``DV`` :meth:`SMU.force` mode: ``'VOLTAGE'`` ``DZ`` :meth:`~AgilentB1500.force_gnd`, :meth:`SMU.force_gnd` ``ERRX?`` :meth:`~AgilentB1500.check_errors` ``FL`` :attr:`SMU.filter` ``FMT`` :meth:`~AgilentB1500.data_format` ``*IDN?`` :attr:`~AgilentB1500.id` ``*LRN?`` :meth:`~AgilentB1500.query_learn`, |br| multiple methods to read/format settings directly ``MI`` :meth:`SMU.sampling_source` mode: ``'CURRENT'`` ``ML`` :attr:`~AgilentB1500.sampling_mode` ``MM`` :meth:`~AgilentB1500.meas_mode` ``MSC`` :meth:`~AgilentB1500.sampling_auto_abort` ``MT`` :meth:`~AgilentB1500.sampling_timing` ``MV`` :meth:`SMU.sampling_source` mode: ``'VOLTAGE'`` ``*OPC?`` :meth:`~AgilentB1500.check_idle` ``PA`` :meth:`~AgilentB1500.pause` ``PAD`` :attr:`~AgilentB1500.parallel_meas` ``RI`` :attr:`~SMU.meas_range_current` ``RM`` :meth:`SMU.meas_range_current_auto` ``*RST`` :meth:`~AgilentB1500.reset` ``RV`` :attr:`~SMU.meas_range_voltage` ``SSR`` :attr:`~SMU.series_resistor` ``TSC`` :attr:`~AgilentB1500.time_stamp` ``TSR`` :meth:`~AgilentB1500.clear_timer` ``UNT?`` :meth:`~AgilentB1500.query_modules` ``WAT`` :meth:`~AgilentB1500.wait_time` ``WI`` :meth:`SMU.staircase_sweep_source` mode: ``'CURRENT'`` ``WM`` :meth:`~AgilentB1500.sweep_auto_abort` ``WSI`` :meth:`SMU.synchronous_sweep_source` mode: ``'CURRENT'`` ``WSV`` :meth:`SMU.synchronous_sweep_source` mode: ``'VOLTAGE'`` ``WT`` :meth:`~AgilentB1500.sweep_timing` ``WV`` :meth:`SMU.staircase_sweep_source` mode: ``'VOLTAGE'`` ``XE`` :meth:`~AgilentB1500.send_trigger` =========== ============================================= ********************************************** Examples ********************************************** Initialization of the Instrument ==================================== .. code-block:: python from pymeasure.instruments.agilent import AgilentB1500 # explicitly define r/w terminations; set sufficiently large timeout in milliseconds or None. b1500=AgilentB1500("GPIB0::17::INSTR", read_termination='\r\n', write_termination='\r\n', timeout=600000) # query SMU config from instrument and initialize all SMU instances b1500.initialize_all_smus() # set data output format (required!) b1500.data_format(21, mode=1) #call after SMUs are initialized to get names for the channels IV measurement with 4 SMUs ================================================= .. code-block:: python # choose measurement mode b1500.meas_mode('STAIRCASE_SWEEP', *b1500.smu_references) #order in smu_references determines order of measurement # settings for individual SMUs for smu in b1500.smu_references: smu.enable() #enable SMU smu.adc_type = 'HRADC' #set ADC to high-resoultion ADC smu.meas_range_current = '1 nA' smu.meas_op_mode = 'COMPLIANCE_SIDE' # other choices: Current, Voltage, FORCE_SIDE, COMPLIANCE_AND_FORCE_SIDE # General Instrument Settings # b1500.adc_averaging = 1 # b1500.adc_auto_zero = True b1500.adc_setup('HRADC','AUTO',6) #b1500.adc_setup('HRADC','PLC',1) #Sweep Settings b1500.sweep_timing(0,5,step_delay=0.1) #hold,delay b1500.sweep_auto_abort(False,post='STOP') #disable auto abort, set post measurement output condition to stop value of sweep # Sweep Source nop = 11 b1500.smu1.staircase_sweep_source('VOLTAGE','LINEAR_DOUBLE','Auto Ranging',0,1,nop,0.001) #type, mode, range, start, stop, steps, compliance # Synchronous Sweep Source b1500.smu2.synchronous_sweep_source('VOLTAGE','Auto Ranging',0,1,0.001) #type, range, start, stop, comp # Constant Output (could also be done using synchronous sweep source with start=stop, but then the output is not ramped up) b1500.smu3.ramp_source('VOLTAGE','Auto Ranging',-1,stepsize=0.1,pause=20e-3) #output starts immediately! (compared to sweeps) b1500.smu4.ramp_source('VOLTAGE','Auto Ranging',0,stepsize=0.1,pause=20e-3) #Start Measurement b1500.check_errors() b1500.clear_buffer() b1500.clear_timer() b1500.send_trigger() # read measurement data all at once b1500.check_idle() #wait until measurement is finished data = b1500.read_data(2*nop) #Factor 2 because of double sweep #alternatively: read measurement data live meas = [] for i in range(nop*2): read_data = b1500.read_channels(4+1) # 4 measurement channels, 1 sweep source (returned due to mode=1 of data_format) # process live data for plotting etc. # data format for every channel (status code, channel name e.g. 'SMU1', data name e.g 'Current Measurement (A)', value) meas.append(read_data) #sweep constant sources back to 0V b1500.smu3.ramp_source('VOLTAGE','Auto Ranging',0,stepsize=0.1,pause=20e-3) b1500.smu4.ramp_source('VOLTAGE','Auto Ranging',0,stepsize=0.1,pause=20e-3) Sampling measurement with 4 SMUs ===================================== .. code-block:: python # choose measurement mode b1500.meas_mode('SAMPLING', *b1500.smu_references) #order in smu_references determines order of measurement number_of_channels = len(b1500.smu_references) # settings for individual SMUs for smu in b1500.smu_references: smu.enable() #enable SMU smu.adc_type = 'HSADC' #set ADC to high-speed ADC smu.meas_range_current = '1 nA' smu.meas_op_mode = 'COMPLIANCE_SIDE' # other choices: Current, Voltage, FORCE_SIDE, COMPLIANCE_AND_FORCE_SIDE b1500.sampling_mode = 'LINEAR' # b1500.adc_averaging = 1 # b1500.adc_auto_zero = True b1500.adc_setup('HSADC','AUTO',1) #b1500.adc_setup('HSADC','PLC',1) nop=11 b1500.sampling_timing(2,0.005,nop) #MT: bias hold time, sampling interval, number of points b1500.sampling_auto_abort(False,post='BIAS') #MSC: BASE/BIAS b1500.time_stamp = True # Sources b1500.smu1.sampling_source('VOLTAGE','Auto Ranging',0,1,0.001) #MV/MI: type, range, base, bias, compliance b1500.smu2.sampling_source('VOLTAGE','Auto Ranging',0,1,0.001) b1500.smu3.ramp_source('VOLTAGE','Auto Ranging',-1,stepsize=0.1,pause=20e-3) #output starts immediately! (compared to sweeps) b1500.smu4.ramp_source('VOLTAGE','Auto Ranging',-1,stepsize=0.1,pause=20e-3) #Start Measurement b1500.check_errors() b1500.clear_buffer() b1500.clear_timer() b1500.send_trigger() meas=[] for i in range(nop): read_data = b1500.read_channels(1+2*number_of_channels) #Sampling Index + (time stamp + measurement value) * number of channels # process live data for plotting etc. # data format for every channel (status code, channel name e.g. 'SMU1', data name e.g 'Current Measurement (A)', value) meas.append(read_data) #sweep constant sources back to 0V b1500.smu3.ramp_source('VOLTAGE','Auto Ranging',0,stepsize=0.1,pause=20e-3) b1500.smu4.ramp_source('VOLTAGE','Auto Ranging',0,stepsize=0.1,pause=20e-3) ********************************************** Main Classes ********************************************** Classes to communicate with the instrument: * :class:`AgilentB1500`: Main instrument class * :class:`SMU`: Instantiated by main instrument class for every SMU * :class:`SPGU`: Instantiated by main instrument class for every SPGU * :class:`SPGUChannel`: Instantiated by SPGU for each channel * :class:`CMU`: Instantiated by main instrument class for CMU All `query` commands return a human readable dict of settings. These are intended for debugging/logging/file headers, not for passing to the accompanying setting commands. .. autoclass:: AgilentB1500 :members: :show-inheritance: :member-order: bysource .. autoclass:: SMU :members: :show-inheritance: :member-order: bysource .. autoclass:: SPGU :members: :show-inheritance: :member-order: bysource .. autoclass:: SPGUChannel :members: :show-inheritance: :member-order: bysource .. autoclass:: CMU :members: :show-inheritance: :member-order: bysource ********************************************** Supporting Classes ********************************************** Classes that provide additional functionalities: * :class:`QueryLearn`: Process read out of instrument settings * :class:`SMUCurrentRanging`, :class:`SMUVoltageRanging`: Allowed ranges for different SMU types and transformation of range names to indices (base: :class:`Ranging`) .. autoclass:: QueryLearn :members: :show-inheritance: .. autoclass:: Ranging :members: :show-inheritance: .. autoclass:: SMUCurrentRanging :members: :show-inheritance: .. autoclass:: SMUVoltageRanging :members: :show-inheritance: Enumerations ========================= Enumerations are used for easy selection of the available parameters (where it is applicable). Methods accept member name or number as input, but name is recommended for readability reasons. The member number is passed to the instrument. Converting an enumeration member into a string gives a title case, whitespace separated string (:meth:`~.CustomIntEnum.__str__`) which cannot be used to select an enumeration member again. It's purpose is only logging or documentation. .. call automodule with full module path only once to avoid duplicate index warnings .. autodoc other classes via currentmodule:: and autoclass:: .. automodule:: pymeasure.instruments.agilent.agilentB1500 :members: :exclude-members: AgilentB1500, SMU, SPGU, SPGUChannel, CMU, QueryLearn, Ranging, SMUCurrentRanging, SMUVoltageRanging :show-inheritance: :member-order: bysource ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentB298x.rst0000644000175100017510000000132215203313266023706 0ustar00runnerrunner########################################################################## Agilent B2980 Series, Femto/Picoammeter Electrometer/High Resistance Meter ########################################################################## .. autoclass:: pymeasure.instruments.agilent.AgilentB2981 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.AgilentB2983 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.AgilentB2985 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.AgilentB2987 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentB298x.BatteryMixin :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentE4408B.rst0000644000175100017510000000030315203313266023676 0ustar00runnerrunner################################ Agilent E4408B Spectrum Analyzer ################################ .. autoclass:: pymeasure.instruments.agilent.AgilentE4408B :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentE4980.rst0000644000175100017510000000026515203313266023610 0ustar00runnerrunner############################## Agilent E4980 LCR Meter ############################## .. autoclass:: pymeasure.instruments.agilent.AgilentE4980 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentE5062A.rst0000644000175100017510000000065515203313266023704 0ustar00runnerrunner###################################### Agilent E5062A Vector Network Analyzer ###################################### .. autoclass:: pymeasure.instruments.agilent.AgilentE5062A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentE5062A.VNAChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentE5062A.VNATrace :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentE5270B.rst0000644000175100017510000000061515203313266023702 0ustar00runnerrunner############################ Agilent E5270B SMU mainframe ############################ .. autoclass:: pymeasure.instruments.agilent.AgilentE5270B :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentE5270B.Display :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentE5270B.SMUChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/agilentN8975A.rst0000644000175100017510000000051015203313266023723 0ustar00runnerrunner#################################### Agilent N8975A Noise Figure Analyzer #################################### .. autoclass:: pymeasure.instruments.agilent.AgilentN8975A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.agilent.agilentN8975A.AgilentN8975AFrequency :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/agilent/index.rst0000644000175100017510000000137715203313266022647 0ustar00runnerrunner.. module:: pymeasure.instruments.agilent ####### Agilent ####### This section contains specific documentation on the Agilent instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. If the instrument you are looking for is not here, also check :doc:`HP<../hp/index>` for older instruments or :doc:`Keysight<../keysight/index>` for newer ones. .. toctree:: :maxdepth: 2 agilent8257D agilent8722ES agilentE4408B agilentE4980 agilentE5062A agilent34410A agilent34450A agilent4156 agilent4294A agilent33220A agilent33500 agilent33521A agilentB1500 agilent4284A agilentB298x agilentE5270B agilentN8975A ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.960942 pymeasure-0.16.0/docs/api/instruments/aimtti/0000755000175100017510000000000015203313301020630 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aimtti/aimttiPL.rst0000644000175100017510000000257515203313266023130 0ustar00runnerrunner.. _aimtti-landing-page: ############################################# Aim-TTI PL Series Power Supplies ############################################# .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PLBase :members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PLChannel :members: :show-inheritance: .. All explicitly documented members are excluded so that there is no duplication, .. but we still get docs for all members that are not explicitly enumerated. .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL068P :members: :exclude-members: ch_1 :undoc-members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL155P :members: :exclude-members: ch_1 :undoc-members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL303P :members: :exclude-members: ch_1 :undoc-members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL601P :members: :exclude-members: ch_1 :undoc-members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL303QMDP :members: :exclude-members: ch_1, ch_2 :undoc-members: :show-inheritance: .. autoclass:: pymeasure.instruments.aimtti.aimttiPL.PL303QMTP :members: :exclude-members: ch_1, ch_2, ch_3 :undoc-members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aimtti/index.rst0000644000175100017510000000053115203313266022502 0ustar00runnerrunner.. module:: pymeasure.instruments.aimtti ####### Aim-TTI ####### This section contains specific documentation on the Aim-TTI instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 aimttiPL ld400p ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aimtti/ld400p.rst0000644000175100017510000000025315203313266022377 0ustar00runnerrunner######################## Aim-TTi Electronic Loads ######################## .. autoclass:: pymeasure.instruments.aimtti.ld400p.LD400P :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9612024 pymeasure-0.16.0/docs/api/instruments/aja/0000755000175100017510000000000015203313301020074 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aja/DCXS.rst0000644000175100017510000000040215203313266021375 0ustar00runnerrunner######################################################### AJA DCXS-750 or 1500 DC magnetron sputtering power supply ######################################################### .. autoclass:: pymeasure.instruments.aja.DCXS :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/aja/index.rst0000644000175100017510000000056015203313266021750 0ustar00runnerrunner.. module:: pymeasure.instruments.aja ################# AJA International ################# This section contains specific documentation on the AJA International instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 DCXS ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9614685 pymeasure-0.16.0/docs/api/instruments/ametek/0000755000175100017510000000000015203313301020607 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ametek/ametek7270.rst0000755000175100017510000000030715203313266023144 0ustar00runnerrunner################################ Ametek 7270 DSP Lockin Amplifier ################################ .. autoclass:: pymeasure.instruments.ametek.Ametek7270 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ametek/index.rst0000755000175100017510000000051515203313266022466 0ustar00runnerrunner.. module:: pymeasure.instruments.ametek ###### Ametek ###### This section contains specific documentation on the Ametek instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ametek7270 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9617603 pymeasure-0.16.0/docs/api/instruments/ami/0000755000175100017510000000000015203313301020107 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ami/ami430.rst0000644000175100017510000000022415203313266021646 0ustar00runnerrunner#################### AMI 430 Power Supply #################### .. autoclass:: pymeasure.instruments.ami.AMI430 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ami/index.rst0000644000175100017510000000047115203313266021764 0ustar00runnerrunner.. module:: pymeasure.instruments.ami ### AMI ### This section contains specific documentation on the AMI instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ami430././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9620306 pymeasure-0.16.0/docs/api/instruments/anaheimautomation/0000755000175100017510000000000015203313301023044 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anaheimautomation/dpseriesstepmotorcontroller.rst0000644000175100017510000000117215203313266031510 0ustar00runnerrunner################################# DP-Series Step Motor Controller ################################# The DPSeriesMotorController class implements a base driver class for Anaheim-Automation DP Series stepper motor controllers. There are many controllers sold in this series, all of which implement the same core command set. Some controllers, like the DPY50601, implement additional functionality that is not included in this driver. If these additional features are desired, they should be implemented in a subclass. .. autoclass:: pymeasure.instruments.anaheimautomation.DPSeriesMotorController :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anaheimautomation/index.rst0000644000175100017510000000064715203313266024726 0ustar00runnerrunner.. module:: pymeasure.instruments.anaheimautomation ######################### Anaheim Automation ######################### This section contains specific documentation on the Anaheim Automation instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 dpseriesstepmotorcontroller ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9622984 pymeasure-0.16.0/docs/api/instruments/anapico/0000755000175100017510000000000015203313301020753 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anapico/apsin12G.rst0000644000175100017510000000030115203313266023075 0ustar00runnerrunner################################# Anapico APSIN12G Signal Generator ################################# .. autoclass:: pymeasure.instruments.anapico.APSIN12G :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anapico/index.rst0000644000175100017510000000051715203313266022631 0ustar00runnerrunner.. module:: pymeasure.instruments.anapico ####### Anapico ####### This section contains specific documentation on the Anapico instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 apsin12G././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.962723 pymeasure-0.16.0/docs/api/instruments/andeenhagerling/0000755000175100017510000000000015203313301022454 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/andeenhagerling/ah2500a.rst0000644000175100017510000000034715203313266024264 0ustar00runnerrunner########################################### Andeen Hagerling AH2500A capacitance bridge ########################################### .. autoclass:: pymeasure.instruments.andeenhagerling.AH2500A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/andeenhagerling/ah2700a.rst0000644000175100017510000000041215203313266024257 0ustar00runnerrunner########################################### Andeen Hagerling AH2700A capacitance bridge ########################################### .. autoclass:: pymeasure.instruments.andeenhagerling.AH2700A :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/andeenhagerling/index.rst0000644000175100017510000000060615203313266024331 0ustar00runnerrunner.. module:: pymeasure.instruments.andeenhagerling ################ Andeen Hagerling ################ This section contains specific documentation on the Andeen Hagerling instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ah2500a ah2700a ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9634473 pymeasure-0.16.0/docs/api/instruments/anritsu/0000755000175100017510000000000015203313301021026 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/anritsuMG3692C.rst0000644000175100017510000000030415203313266024127 0ustar00runnerrunner################################ Anritsu MG3692C Signal Generator ################################ .. autoclass:: pymeasure.instruments.anritsu.AnritsuMG3692C :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/anritsuMS2090A.rst0000644000175100017510000000034215203313266024132 0ustar00runnerrunner########################################## Anritsu MS2090A Handheld Spectrum Analyzer ########################################## .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS2090A :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/anritsuMS464xB.rst0000644000175100017510000000155615203313266024256 0ustar00runnerrunner####################################### Anritsu MS464xB Vector Network Analyzer ####################################### .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS4642B :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS4644B :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS4645B :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS4647B :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS464xB :members: :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.anritsuMS464xB.MeasurementChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.anritsuMS464xB.Trace :members: :show-inheritance: .. autoclass:: pymeasure.instruments.anritsu.anritsuMS464xB.Port :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/anritsuMS9710C.rst0000644000175100017510000000034215203313266024142 0ustar00runnerrunner########################################## Anritsu MS9710C Optical Spectrum Analyzer ########################################## .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS9710C :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/anritsuMS9740A.rst0000644000175100017510000000034015203313266024141 0ustar00runnerrunner######################################### Anritsu MS9740A Optical Spectrum Analyzer ######################################### .. autoclass:: pymeasure.instruments.anritsu.AnritsuMS9740A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/anritsu/index.rst0000644000175100017510000000063715203313266022707 0ustar00runnerrunner.. module:: pymeasure.instruments.anritsu ####### Anritsu ####### This section contains specific documentation on the Anritsu instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 anritsuMG3692C anritsuMS9710C anritsuMS9740A anritsuMS2090A anritsuMS464xB ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9636676 pymeasure-0.16.0/docs/api/instruments/attocube/0000755000175100017510000000000015203313301021147 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/attocube/anc300.rst0000644000175100017510000000046215203313266022701 0ustar00runnerrunner################################# Attocube ANC300 Motion Controller ################################# .. autoclass:: pymeasure.instruments.attocube.anc300.ANC300Controller :members: :show-inheritance: .. autoclass:: pymeasure.instruments.attocube.anc300.Axis :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/attocube/index.rst0000644000175100017510000000052315203313266023022 0ustar00runnerrunner.. module:: pymeasure.instruments.attocube ######## Attocube ######## This section contains specific documentation on the Attocube instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 anc300 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9638605 pymeasure-0.16.0/docs/api/instruments/bkprecision/0000755000175100017510000000000015203313301021651 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/bkprecision/bkprecision9130b.rst0000644000175100017510000000032115203313266025400 0ustar00runnerrunner################################## BK Precision 9130B DC Power Supply ################################## .. autoclass:: pymeasure.instruments.bkprecision.BKPrecision9130B :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/bkprecision/index.rst0000644000175100017510000000055715203313266023533 0ustar00runnerrunner.. module:: pymeasure.instruments.bkprecision ############ BK Precision ############ This section contains specific documentation on the BK Precision instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 bkprecision9130b././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/comedi.rst0000644000175100017510000000043415203313266021346 0ustar00runnerrunner####################### Comedi data acquisition ####################### The Comedi libraries provide a convenient method for interacting with data acquisition cards, but are restricted to Linux compatible operating systems. .. automodule:: pymeasure.instruments.comedi :members: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9640465 pymeasure-0.16.0/docs/api/instruments/danfysik/0000755000175100017510000000000015203313301021151 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/danfysik/danfysik8500.rst0000644000175100017510000000026115203313266024041 0ustar00runnerrunner########################## Danfysik 8500 Power Supply ########################## .. autoclass:: pymeasure.instruments.danfysik.Danfysik8500 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/danfysik/index.rst0000644000175100017510000000053115203313266023023 0ustar00runnerrunner.. module:: pymeasure.instruments.danfysik ######## Danfysik ######## This section contains specific documentation on the Danfysik instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 danfysik8500 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9642313 pymeasure-0.16.0/docs/api/instruments/deltaelektronica/0000755000175100017510000000000015203313301022653 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/deltaelektronica/index.rst0000644000175100017510000000060015203313266024522 0ustar00runnerrunner.. module:: pymeasure.instruments.deltaelektronika ################# Delta Elektronika ################# This section contains specific documentation on the Delta Elektronika instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 sm7045d ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/deltaelektronica/sm7045d.rst0000644000175100017510000000033115203313266024517 0ustar00runnerrunner###################################### Delta Elektronica SM7045D Power source ###################################### .. autoclass:: pymeasure.instruments.deltaelektronika.SM7045D :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.964414 pymeasure-0.16.0/docs/api/instruments/edwards/0000755000175100017510000000000015203313301020772 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/edwards/index.rst0000644000175100017510000000051415203313266022645 0ustar00runnerrunner.. module:: pymeasure.instruments.edwards ####### Edwards ####### This section contains specific documentation on the Edwards instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 nxds ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/edwards/nxds.rst0000644000175100017510000000024315203313266022511 0ustar00runnerrunner######################## Edwards nxds vacuum pump ######################## .. autoclass:: pymeasure.instruments.edwards.Nxds :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9645965 pymeasure-0.16.0/docs/api/instruments/eurotest/0000755000175100017510000000000015203313301021213 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/eurotest/eurotestHPP120256.rst0000644000175100017510000000036015203313266024660 0ustar00runnerrunner############################################# Euro Test HPP120256 High Voltage Power Supply ############################################# .. autoclass:: pymeasure.instruments.eurotest.EurotestHPP120256 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/eurotest/index.rst0000644000175100017510000000054115203313266023066 0ustar00runnerrunner.. module:: pymeasure.instruments.eurotest ######### EURO TEST ######### This section contains specific documentation on the EURO TEST instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 eurotestHPP120256././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9648404 pymeasure-0.16.0/docs/api/instruments/fluke/0000755000175100017510000000000015203313301020447 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/fluke/fluke7341.rst0000644000175100017510000000025715203313266022644 0ustar00runnerrunner########################### Fluke 7341 Temperature bath ########################### .. autoclass:: pymeasure.instruments.fluke.Fluke7341 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/fluke/index.rst0000644000175100017510000000050715203313266022324 0ustar00runnerrunner.. module:: pymeasure.instruments.fluke ##### Fluke ##### This section contains specific documentation on the Fluke instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 fluke7341 ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.965035 pymeasure-0.16.0/docs/api/instruments/formfactor/0000755000175100017510000000000015203313301021503 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/formfactor/index.rst0000644000175100017510000000053015203313266023354 0ustar00runnerrunner.. module:: pymeasure.instruments.formfactor ########## FormFactor ########## This section contains specific documentation on the FormFactor devices that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 velox ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/formfactor/velox.rst0000644000175100017510000000057515203313266023413 0ustar00runnerrunner############################# FormFactor Velox Wafer Prober ############################# .. autoclass:: pymeasure.instruments.formfactor.Velox :members: :show-inheritance: .. autoclass:: pymeasure.instruments.formfactor.velox.Chuck :members: :show-inheritance: .. autoclass:: pymeasure.instruments.formfactor.velox.WaferMap :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9652681 pymeasure-0.16.0/docs/api/instruments/fwbell/0000755000175100017510000000000015203313301020614 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/fwbell/fwbell5080.rst0000644000175100017510000000035115203313266023147 0ustar00runnerrunner################################## F.W. Bell 5080 Handheld Gaussmeter ################################## .. autoclass:: pymeasure.instruments.fwbell.FWBell5080 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/fwbell/index.rst0000644000175100017510000000053015203313266022465 0ustar00runnerrunner.. module:: pymeasure.instruments.fwbell ######### F.W. Bell ######### This section contains specific documentation on the F.W. Bell instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 fwbell5080././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/generic_types.rst0000644000175100017510000000046415203313266022751 0ustar00runnerrunner############################### Generic Instrument Types Mixins ############################### You can use these Mixins as additional parent classes for your instrument. For more informations, see :ref:`common_instrument_types`. .. autoclass:: pymeasure.instruments.generic_types.SCPIMixin :members: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9657247 pymeasure-0.16.0/docs/api/instruments/hcp/0000755000175100017510000000000015203313301020113 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hcp/index.rst0000644000175100017510000000055515203313266021773 0ustar00runnerrunner.. module:: pymeasure.instruments.hcp ############### HC Photonics ############### This section contains specific documentation on the HC Photonics instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 tc038 tc038d ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hcp/tc038.rst0000644000175100017510000000023215203313266021515 0ustar00runnerrunner###################### HCP TC038 crystal oven ###################### .. autoclass:: pymeasure.instruments.hcp.TC038 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hcp/tc038d.rst0000644000175100017510000000023615203313266021665 0ustar00runnerrunner####################### HCP TC038D crystal oven ####################### .. autoclass:: pymeasure.instruments.hcp.TC038D :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9660177 pymeasure-0.16.0/docs/api/instruments/heidenhain/0000755000175100017510000000000015203313301021435 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/heidenhain/index.rst0000644000175100017510000000054015203313266023307 0ustar00runnerrunner.. module:: pymeasure.instruments.heidenhain ########## Heidenhain ########## This section contains specific documentation on the Heidenhain instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 nd287 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/heidenhain/nd287.rst0000644000175100017510000000034415203313266023044 0ustar00runnerrunner########################################### Heidenhain ND287 Position Display Unit ########################################### .. autoclass:: pymeasure.instruments.heidenhain.ND287 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.967938 pymeasure-0.16.0/docs/api/instruments/hp/0000755000175100017510000000000015203313301017750 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp11713A.rst0000644000175100017510000000112715203313266021622 0ustar00runnerrunner########################################### HP 11713A Attenuator/Switch Driver ########################################### .. autoclass:: pymeasure.instruments.hp.HP11713A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp11713a.SwitchDriverChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp11713a.Attenuator_11dB .. autoclass:: pymeasure.instruments.hp.hp11713a.Attenuator_110dB .. autoclass:: pymeasure.instruments.hp.hp11713a.Attenuator_70dB_3_Section .. autoclass:: pymeasure.instruments.hp.hp11713a.Attenuator_70dB_4_Section ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp33120A.rst0000644000175100017510000000031315203313266021612 0ustar00runnerrunner###################################### HP 33120A Arbitrary Waveform Generator ###################################### .. autoclass:: pymeasure.instruments.hp.HP33120A :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp3437A.rst0000644000175100017510000000027615203313266021552 0ustar00runnerrunner###################################### HP 3437A System-Voltmeter ###################################### .. autoclass:: pymeasure.instruments.hp.HP3437A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp34401A.rst0000644000175100017510000000022615203313266021620 0ustar00runnerrunner#################### HP 34401A Multimeter #################### .. autoclass:: pymeasure.instruments.hp.HP34401A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp3478A.rst0000644000175100017510000000027015203313266021551 0ustar00runnerrunner###################################### HP 3478A Multimeter ###################################### .. autoclass:: pymeasure.instruments.hp.HP3478A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp437B.rst0000644000175100017510000000022315203313266021460 0ustar00runnerrunner#################### HP 437B Power Meter #################### .. autoclass:: pymeasure.instruments.hp.HP437B :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp8116A.rst0000644000175100017510000000032715203313266021546 0ustar00runnerrunner########################################### HP 8116A 50 MHz Pulse/Function Generator ########################################### .. autoclass:: pymeasure.instruments.hp.HP8116A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp856xx.rst0000644000175100017510000002572315203313266021757 0ustar00runnerrunner################################## HP 8560A / 8561B Spectrum Analyzer ################################## Every unit is used in the base unit, so for time it is s (Seconds), frequency in Hz (Hertz) etc... ------------------------------------- Generic Specific Attributes & Methods ------------------------------------- .. contents:: Content :depth: 3 :local: ^^^^^^^ General ^^^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.preset .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.attenuation .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.amplitude_unit .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.trigger_mode .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.detector_mode .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.coupling .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_auto_couple .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_linear_scale .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.logarithmic_scale .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.threshold .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_title .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.status .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.check_done .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.request_service .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.errors .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.save_state .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.recall_state .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.request_service_conditions .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_maximum_hold .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_minimum_hold .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.reference_level_calibration .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.reference_offset .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.reference_level .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.display_line .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.protect_state_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.mixer_level .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.frequency_counter_mode_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.frequency_counter_resolution .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.adjust_all .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.adjust_if .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.hold .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.annotation_enabled .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_crt_adjustment_pattern .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.display_parameters .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.firmware_revision .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.graticule_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.serial_number .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.id .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.elapsed_time ^^^^^^^^^^^^ Demodulation ^^^^^^^^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.demodulation_mode .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.demodulation_agc_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.demodulation_time .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.squelch ^^^^^^^^^ Frequency ^^^^^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.start_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.stop_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.center_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.frequency_offset .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.frequency_reference_source .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.span .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_full_span .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.frequency_display_enabled ^^^^^^^^^^^^^^^^^^^^ Resolution Bandwidth ^^^^^^^^^^^^^^^^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.resolution_bandwidth .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.resolution_bandwidth_to_span_ratio ^^^^^ Video ^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.video_trigger_level .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.video_bandwidth_to_resolution_bandwidth .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.video_bandwidth .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.video_average ^^^^^^^^^^^^^^^^^^ FFT & Measurements ^^^^^^^^^^^^^^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.create_fft_trace_window .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.get_power_bandwidth .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.do_fft ^^^^^ Trace ^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.view_trace .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.get_trace_data_a .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.get_trace_data_b .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_trace_data_a .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_trace_data_b .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.trace_data_format .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.save_trace .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.recall_trace .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.clear_write_trace .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.subtract_display_line_from_trace_b .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.exchange_traces .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.blank_trace .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.trace_a_minus_b_plus_dl_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.trace_a_minus_b_enabled ^^^^^^ Marker ^^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.search_peak .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_amplitude .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_marker_to_center_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_delta .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_frequency .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_marker_minimum .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_noise_mode_enabled .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.deactivate_marker .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_threshold .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.peak_excursion .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_marker_to_reference_level .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_marker_delta_to_span .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_marker_to_center_frequency_step_size .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_time .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.marker_signal_tracking_enabled ^^^^^^^^^^^^^^^^^ Diagnostic Values ^^^^^^^^^^^^^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sampling_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.lo_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.mroll_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.oroll_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.xroll_frequency .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sampler_harmonic_number ^^^^^ Sweep ^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sweep_single .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sweep_time .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sweep_couple .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.sweep_output .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.set_continuous_sweep .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.trigger_sweep ^^^^^^^^^^^^^ Normalization ^^^^^^^^^^^^^ .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.normalize_trace_data_enabled .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.normalized_reference_level .. autoattribute:: pymeasure.instruments.hp.hp856Xx.HP856Xx.normalized_reference_position ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Open/Short Calibration (Reflection) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.recall_open_short_average .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.store_open .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.store_short ^^^^^^^^^^^^^^^^ Thru Calibration ^^^^^^^^^^^^^^^^ .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.store_thru .. automethod:: pymeasure.instruments.hp.hp856Xx.HP856Xx.recall_thru ------------------------------------- HP8560A Specific Attributes & Methods ------------------------------------- .. autoclass:: pymeasure.instruments.hp.HP8560A :members: :show-inheritance: ------------------------------------- HP8561B Specific Attributes & Methods ------------------------------------- .. autoclass:: pymeasure.instruments.hp.HP8561B :members: :show-inheritance: ------------ Enumerations ------------ .. autoclass:: pymeasure.instruments.hp.hp856Xx.AmplitudeUnits :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.MixerMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.Trace :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.CouplingMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.DemodulationMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.DetectionModes :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.ErrorCode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.FrequencyReference :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.PeakSearchMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.SourceLevelingControlMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.StatusRegister :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.SweepCoupleMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.SweepOut :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.TriggerMode :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.hp856Xx.WindowType :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp8657B.rst0000644000175100017510000000132315203313266021556 0ustar00runnerrunner################################ HP Signal generator HP8657B ################################ *Note:* * This instrument does not support reading back values, as it is a listen-only GPIB device. * Other instruments of this family could be implemented using the dynamic ranges feature. * Optional pulse modulation feature is not supported yet. Glossary: ============ =========== Abbreviation Explanation ============ =========== AM Amplitude Modulation FM Frequency Modulation dBm power level in dB referenced to 1mW ============ =========== .. autoclass:: pymeasure.instruments.hp.HP8657B :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hp8753E.rst0000644000175100017510000000027215203313266021560 0ustar00runnerrunner################################ HP 8753E Vector Network Analyzer ################################ .. autoclass:: pymeasure.instruments.hp.HP8753E :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hplegacyinstrument.rst0000644000175100017510000000062415203313266024443 0ustar00runnerrunner###################################### Support class for HP legacy devices ###################################### Currently this implementation is used for the following instruments which do not support SCPI: * HP3437A System-Voltmeter * HP3478A Digital Multimeter * HP6632/33/34A System power supply .. autoclass:: pymeasure.instruments.hp.HPLegacyInstrument :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/hpsystempsu.rst0000644000175100017510000000174115203313266023123 0ustar00runnerrunner################################ HP System Power Supplies HP663XA ################################ Currently supported models are: ===== ======== ========= ===== Model Voltage Current Power ===== ======== ========= ===== 6632A 0..20 V 0..5.0 A 100 W 6633A 0..50 V 0..2.5 A 100 W 6634A 0..100 V 0..1.0 A 100 W ===== ======== ========= ===== *Note:* * The multi-channel system power supplies HP 6621A, 6622A, 6623A, 6624A, 6625A, 6626A, 6627A & 6628A share some of the command syntax and could probably be incorporated in this implementation * The B-version of these models (6632B, 6633B & 6634B) are SPCI-compliant and could be implemented in a similar manner .. autoclass:: pymeasure.instruments.hp.HP6632A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.HP6633A :members: :show-inheritance: .. autoclass:: pymeasure.instruments.hp.HP6634A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/hp/index.rst0000644000175100017510000000122215203313266021620 0ustar00runnerrunner.. module:: pymeasure.instruments.hp ############### Hewlett Packard ############### This section contains specific documentation on the Hewlett Packard instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. If the instrument you are looking for is not here, also check :doc:`Agilent<../agilent/index>` or :doc:`Keysight<../keysight/index>` for newer instruments. .. toctree:: :maxdepth: 2 hp33120A hp34401A hp3437A hp3478A hp8116A hp856xx hp8657B hp8753E hp11713A hp437B hplegacyinstrument hpsystempsu ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.968225 pymeasure-0.16.0/docs/api/instruments/ilxlightwave/0000755000175100017510000000000015203313301022050 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ilxlightwave/index.rst0000644000175100017510000000055415203313266023727 0ustar00runnerrunner.. module:: pymeasure.instruments.ilxlightwave ############# ILX Lightwave ############# This section contains specific documentation on the ILX Lightwave instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ldp3811 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ilxlightwave/ldp3811.rst0000644000175100017510000000030215203313266023703 0ustar00runnerrunner#################### ILX Lighwave LDP3811 #################### .. autoclass:: pymeasure.instruments.ilxlightwave.LDP3811 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/index.rst0000644000175100017510000000276515203313266021226 0ustar00runnerrunner.. module:: pymeasure.instruments ##################### pymeasure.instruments ##################### This section contains documentation on the instrument classes. .. toctree:: :maxdepth: 2 instruments generic_types validators comedi resources Instruments by manufacturer: .. toctree:: :maxdepth: 2 activetechnologies/index aculight/index advantest/index agilent/index aimtti/index aja/index ametek/index ami/index anaheimautomation/index anapico/index andeenhagerling/index anritsu/index attocube/index bkprecision/index danfysik/index deltaelektronica/index edwards/index eurotest/index fluke/index formfactor/index fwbell/index heidenhain/index hcp/index hp/index ilxlightwave/index inficon/index ipgphotonics/index keithley/index kepco/index keysight/index kuhneelectronic/index lakeshore/index lecroy/index mksinst/index newport/index ni/index novanta/index oxfordinstruments/index parker/index philips/index pendulum/index proterial/index ptw/index racal/index razorbill/index redpitaya/index rigol/index rohdeschwarz/index santec/index siglenttechnologies/index signalrecovery/index spellmanhv/index srs/index tcpowerconversion/index tdk/index tektronix/index teledyne/index temptronic/index texio/index thermotron/index thorlabs/index thyracont/index toptica/index velleman/index yokogawa/index ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9685102 pymeasure-0.16.0/docs/api/instruments/inficon/0000755000175100017510000000000015203313301020766 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/inficon/index.rst0000644000175100017510000000051615203313266022643 0ustar00runnerrunner.. module:: pymeasure.instruments.inficon ####### Inficon ####### This section contains specific documentation on the Inficon instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 sqm160 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/inficon/sqm160.rst0000644000175100017510000000053715203313266022566 0ustar00runnerrunner################################################# Inficon SQM-160 multi-film rate/thickness monitor ################################################# .. autoclass:: pymeasure.instruments.inficon.sqm160.SQM160 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.inficon.sqm160.SensorChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/instruments.rst0000644000175100017510000000067615203313266022511 0ustar00runnerrunner################## Instrument classes ################## .. autoclass:: pymeasure.instruments.common_base.CommonBase :members: .. autoclass:: pymeasure.instruments.Instrument :members: .. autoclass:: pymeasure.instruments.Channel :members: .. autoclass:: pymeasure.instruments.fakes.FakeInstrument :members: :show-inheritance: .. autoclass:: pymeasure.instruments.fakes.SwissArmyFake :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003200000000000010210 xustar0026 mtime=1779275456.96881 pymeasure-0.16.0/docs/api/instruments/ipgphotonics/0000755000175100017510000000000015203313301022047 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ipgphotonics/index.rst0000644000175100017510000000055015203313266023722 0ustar00runnerrunner.. module:: pymeasure.instruments.ipgphotonics ############# IPG Photonics ############# This section contains specific documentation on the IPG Photonics instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 yar ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ipgphotonics/yar.rst0000644000175100017510000000026115203313266023405 0ustar00runnerrunner########################## YAR fiber amplifier series ########################## .. autoclass:: pymeasure.instruments.ipgphotonics.yar.YAR :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9715815 pymeasure-0.16.0/docs/api/instruments/keithley/0000755000175100017510000000000015203313301021157 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/index.rst0000644000175100017510000000117115203313266023032 0ustar00runnerrunner.. module:: pymeasure.instruments.keithley ######## Keithley ######## This section contains specific documentation on the Keithley instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 keithley2000 keithley2200 keithley2260B keithley2281S keithley2306 keithley2400 keithley2400_legacy keithley2450 keithley2510 keithley2600 keithley2700 keithley2750 keithley6221 keithley6517b keithleyDMM6500 keithley2182 keithleyDAQ6510 keithley4200 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2000.rst0000644000175100017510000000031715203313266024044 0ustar00runnerrunner######################## Keithley 2000 Multimeter ######################## .. autoclass:: pymeasure.instruments.keithley.Keithley2000 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2182.rst0000644000175100017510000000051415203313266024056 0ustar00runnerrunner########################### Keithley 2182 Nanovoltmeter ########################### .. autoclass:: pymeasure.instruments.keithley.Keithley2182 :members: :show-inheritance: :inherited-members: CommonBase .. autoclass:: pymeasure.instruments.keithley.keithley2182.Keithley2182Channel :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2200.rst0000644000175100017510000000064515203313266024052 0ustar00runnerrunner################################### Keithley 2200 Series Power Supplies ################################### .. autoclass:: pymeasure.instruments.keithley.Keithley2200 :members: :show-inheritance: :inherited-members: :exclude-members: ask, control, clear, measurement, read, setting, values, write .. autoclass:: pymeasure.instruments.keithley.keithley2200.PSChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2260B.rst0000644000175100017510000000034115203313266024153 0ustar00runnerrunner############################## Keithley 2260B DC Power Supply ############################## .. autoclass:: pymeasure.instruments.keithley.Keithley2260B :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2281S.rst0000644000175100017510000000105315203313266024200 0ustar00runnerrunner################################################################# Keithley 2281S power supply and battery simulator / characterizer ################################################################# .. autoclass:: pymeasure.instruments.keithley.Keithley2281S :members: :show-inheritance: :inherited-members: CommonBase .. autoclass:: pymeasure.instruments.keithley.keithley2281S.Keithley2281SOperationEventRegister :members: .. autoclass:: pymeasure.instruments.keithley.keithley2281S.Keithley2281SMeasurementEventRegister :members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2306.rst0000644000175100017510000000044215203313266024054 0ustar00runnerrunner#################################################### Keithley 2306 Dual Channel Battery/Charger Simulator #################################################### .. autoclass:: pymeasure.instruments.keithley.Keithley2306 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2400.rst0000644000175100017510000000032115203313266024043 0ustar00runnerrunner######################### Keithley 2400 SourceMeter ######################### .. autoclass:: pymeasure.instruments.keithley.Keithley2400 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2400_legacy.rst0000644000175100017510000000036215203313266025374 0ustar00runnerrunner################################## Keithley 2400 SourceMeter (Legacy) ################################## .. autoclass:: pymeasure.instruments.keithley.Keithley2400Legacy :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2450.rst0000644000175100017510000000032115203313266024050 0ustar00runnerrunner######################### Keithley 2450 SourceMeter ######################### .. autoclass:: pymeasure.instruments.keithley.Keithley2450 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2510.rst0000644000175100017510000000033515203313266024052 0ustar00runnerrunner############################# Keithley 2510 TEC SourceMeter ############################# .. autoclass:: pymeasure.instruments.keithley.Keithley2510 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2600.rst0000644000175100017510000000032215203313266024046 0ustar00runnerrunner######################### Keithley 2600 SourceMeter ######################### .. autoclass:: pymeasure.instruments.keithley.Keithley2600 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2700.rst0000644000175100017510000000037015203313266024052 0ustar00runnerrunner###################################### Keithley 2700 MultiMeter/Switch System ###################################### .. autoclass:: pymeasure.instruments.keithley.Keithley2700 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley2750.rst0000644000175100017510000000037115203313266024060 0ustar00runnerrunner###################################### Keithley 2750 Multimeter/Switch System ###################################### .. autoclass:: pymeasure.instruments.keithley.Keithley2750 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley4200.rst0000644000175100017510000000064415203313266024053 0ustar00runnerrunner##################################### Keithley 4200A-SCS Parameter Analyzer ##################################### .. autoclass:: pymeasure.instruments.keithley.Keithley4200 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.keithley.keithley4200.SMU :members: :show-inheritance: .. autoclass:: pymeasure.instruments.keithley.keithley4200.StatusCode :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley6221.rst0000644000175100017510000000037015203313266024054 0ustar00runnerrunner###################################### Keithley 6221 AC and DC Current Source ###################################### .. autoclass:: pymeasure.instruments.keithley.Keithley6221 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithley6517b.rst0000644000175100017510000000033115203313266024223 0ustar00runnerrunner########################### Keithley 6517B Electrometer ########################### .. autoclass:: pymeasure.instruments.keithley.Keithley6517B :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithleyDAQ6510.rst0000644000175100017510000000047215203313266024406 0ustar00runnerrunner########################################################### Keithley DAQ6510 Data Acquisition Logging Multimeter System ########################################################### .. autoclass:: pymeasure.instruments.keithley.KeithleyDAQ6510 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keithley/keithleyDMM6500.rst0000644000175100017510000000061015203313266024407 0ustar00runnerrunner########################### Keithley DMM6500 Multimeter ########################### .. autoclass:: pymeasure.instruments.keithley.KeithleyDMM6500 :members: :show-inheritance: :exclude-members: ask, control, clear, measurement, read, setting, values, write .. autoclass:: pymeasure.instruments.keithley.keithleyDMM6500.ScannerCard2000Channel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9719024 pymeasure-0.16.0/docs/api/instruments/kepco/0000755000175100017510000000000015203313301020442 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/kepco/KepcoBOP.rst0000644000175100017510000000043015203313266022605 0ustar00runnerrunner############################################################# BOP Bipolar Power Supply with BIT 4886 Digital Interface Card ############################################################# .. autoclass:: pymeasure.instruments.kepco.KepcoBOP3612 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/kepco/index.rst0000644000175100017510000000055315203313266022320 0ustar00runnerrunner.. module:: pymeasure.instruments.kepco ########## KEPCO INC. ########## This section contains specific documentation on the Kepco Inc. power supplies instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 KepcoBOP ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9732423 pymeasure-0.16.0/docs/api/instruments/keysight/0000755000175100017510000000000015203313301021170 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/index.rst0000644000175100017510000000115415203313266023044 0ustar00runnerrunner.. module:: pymeasure.instruments.keysight ######## Keysight ######## This section contains specific documentation on the keysight instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. If the instrument you are looking for is not here, also check :doc:`Agilent<../agilent/index>` or :doc:`HP<../hp/index>` for older instruments. .. toctree:: :maxdepth: 2 keysightDSOX1102G keysightN5767A keysightN7776C keysightE36312A keysightE3631A keysight81160A keysight33250A keysightPNA ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysight33250A.rst0000644000175100017510000000040515203313266024260 0ustar00runnerrunner##################################################### Keysight 33250A Function/Arbitrary Waveform Generator ##################################################### .. autoclass:: pymeasure.instruments.keysight.Keysight33250A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysight81160A.rst0000644000175100017510000000063715203313266024272 0ustar00runnerrunner######################################################## Keysight 81160A Pulse Function Arbitrary Noise Generator ######################################################## .. autoclass:: pymeasure.instruments.keysight.Keysight81160A :members: :show-inheritance: :inherited-members: .. autoclass:: pymeasure.instruments.keysight.keysight81160A.Keysight81160AChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightDSOX1102G.rst0000644000175100017510000000030615203313266024673 0ustar00runnerrunner############################### Keysight DSOX1102G Oscilloscope ############################### .. autoclass:: pymeasure.instruments.keysight.KeysightDSOX1102G :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightE36312A.rst0000644000175100017510000000057115203313266024373 0ustar00runnerrunner############################################## Keysight E36312A Triple Output Power Supply ############################################## .. autoclass:: pymeasure.instruments.keysight.KeysightE36312A :members: :show-inheritance: :inherited-members: .. autoclass:: pymeasure.instruments.keysight.keysightE36312A.VoltageChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightE3631A.rst0000644000175100017510000000055615203313266024314 0ustar00runnerrunner########################################## Keysight E3631A Triple Output Power Supply ########################################## .. autoclass:: pymeasure.instruments.keysight.KeysightE3631A :members: :show-inheritance: :inherited-members: .. autoclass:: pymeasure.instruments.keysight.keysightE3631A.VoltageChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightN5767A.rst0000644000175100017510000000027215203313266024334 0ustar00runnerrunner############################ Keysight N5767A Power Supply ############################ .. autoclass:: pymeasure.instruments.keysight.KeysightN5767A :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightN7776C.rst0000644000175100017510000000027215203313266024340 0ustar00runnerrunner############################ Keysight N5776C Power Supply ############################ .. autoclass:: pymeasure.instruments.keysight.KeysightN7776C :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/keysight/keysightPNA.rst0000644000175100017510000000102215203313266024115 0ustar00runnerrunner##################################### Keysight PNA Vector Network Analyzers ##################################### .. autoclass:: pymeasure.instruments.keysight.KeysightPNA :members: :show-inheritance: .. autoclass:: pymeasure.instruments.keysight.keysightPNA.MeasurementChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.keysight.keysightPNA.Trace :members: :show-inheritance: .. autoclass:: pymeasure.instruments.keysight.keysightPNA.Marker :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9735327 pymeasure-0.16.0/docs/api/instruments/kuhneelectronic/0000755000175100017510000000000015203313301022523 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/kuhneelectronic/index.rst0000644000175100017510000000060015203313266024372 0ustar00runnerrunner.. module:: pymeasure.instruments.kuhneelectronic ################ Kuhne Electronic ################ This section contains specific documentation on the Kuhne Electronic instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 kusg245_250a ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/kuhneelectronic/kusg245_250a.rst0000644000175100017510000000042315203313266025221 0ustar00runnerrunner######################################################## KU SG 2.45 250 A - 2.45 GHz ISM-Band Microwave Generator ######################################################## .. autoclass:: pymeasure.instruments.kuhneelectronic.Kusg245_250A :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9745736 pymeasure-0.16.0/docs/api/instruments/lakeshore/0000755000175100017510000000000015203313301021316 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/index.rst0000644000175100017510000000224215203313266023171 0ustar00runnerrunner.. module:: pymeasure.instruments.lakeshore ##################### Lake Shore Cryogenics ##################### This section contains specific documentation on the Lake Shore Cryogenics instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. lakeshore3xx is a general class for Lake Shore temperature controllers of the series 3xx (like 325, 331, 334, 336, 340, 350). .. toctree:: :maxdepth: 2 lakeshore211 lakeshore224 lakeshore331 lakeshore3xx lakeshore421 lakeshore425 .. _LakeShoreChannels: LakeShore Channel Classes -------------------------- Several Lakeshore instruments are channel based and make use of the :ref:`Channel Interface `. For temperature monitoring and controller instruments the following common :class:`Channel Classes ` are utilized: .. autoclass:: pymeasure.instruments.lakeshore.lakeshore_base.LakeShoreTemperatureChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.lakeshore.lakeshore_base.LakeShoreHeaterChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore211.rst0000644000175100017510000000031315203313266024260 0ustar00runnerrunner################################## Lake Shore 211 Temperature Monitor ################################## .. autoclass:: pymeasure.instruments.lakeshore.LakeShore211 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore224.rst0000644000175100017510000000031315203313266024264 0ustar00runnerrunner################################## Lake Shore 224 Temperature Monitor ################################## .. autoclass:: pymeasure.instruments.lakeshore.LakeShore224 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore331.rst0000644000175100017510000000032315203313266024264 0ustar00runnerrunner##################################### Lake Shore 331 Temperature Controller ##################################### .. autoclass:: pymeasure.instruments.lakeshore.LakeShore331 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore3xx.rst0000644000175100017510000000032315203313266024500 0ustar00runnerrunner##################################### Lake Shore 3xx Temperature Controller ##################################### .. autoclass:: pymeasure.instruments.lakeshore.LakeShore3xx :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore421.rst0000644000175100017510000000026015203313266024264 0ustar00runnerrunner######################### Lake Shore 421 Gaussmeter ######################### .. autoclass:: pymeasure.instruments.lakeshore.LakeShore421 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lakeshore/lakeshore425.rst0000644000175100017510000000025715203313266024276 0ustar00runnerrunner######################### Lake Shore 425 Gaussmeter ######################### .. autoclass:: pymeasure.instruments.lakeshore.LakeShore425 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9748855 pymeasure-0.16.0/docs/api/instruments/lecroy/0000755000175100017510000000000015203313301020636 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lecroy/index.rst0000644000175100017510000000071715203313266022516 0ustar00runnerrunner.. module:: pymeasure.instruments.lecroy ######## LeCroy ######## This section contains specific documentation on the LeCroy instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. If the instrument you are looking for is not here, also check :doc:`Teledyne<../teledyne/index>` for newer instruments. .. toctree:: :maxdepth: 2 lecroyT3DSO1204././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/lecroy/lecroyT3DSO1204.rst0000644000175100017510000000055015203313266023763 0ustar00runnerrunner############################### LeCroy T3DSO1204 Oscilloscope ############################### .. autoclass:: pymeasure.instruments.lecroy.LeCroyT3DSO1204 :members: :show-inheritance: :inherited-members: :exclude-members: .. autoclass:: pymeasure.instruments.lecroy.lecroyT3DSO1204.LeCroyT3DSO1204Channel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.975474 pymeasure-0.16.0/docs/api/instruments/mksinst/0000755000175100017510000000000015203313301021031 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/mksinst/index.rst0000644000175100017510000000060115203313266022701 0ustar00runnerrunner.. module:: pymeasure.instruments.mksinst ############### MKS Instruments ############### This section contains specific documentation on the MKS Instruments devices that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 mksinst mks937b mks974b ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/mksinst/mks937b.rst0000644000175100017510000000105415203313266022774 0ustar00runnerrunner############################################ MKS Instruments 937B Vacuum Gauge Controller ############################################ .. autoclass:: pymeasure.instruments.mksinst.mks937b.MKS937B :members: :show-inheritance: .. autoclass:: pymeasure.instruments.mksinst.mks937b.IonGaugeAndPressureChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.mksinst.mks937b.PressureChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.mksinst.mks937b.Relay :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/mksinst/mks974b.rst0000644000175100017510000000052415203313266022776 0ustar00runnerrunner############################################### MKS Instruments 974B Vacuum Pressure Transducer ############################################### .. autoclass:: pymeasure.instruments.mksinst.mks974b.MKS974B :members: :show-inheritance: .. autoclass:: pymeasure.instruments.mksinst.mks974b.Relay :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/mksinst/mksinst.rst0000644000175100017510000000047515203313266023273 0ustar00runnerrunner################################### MKS Instruments Abstract Instrument ################################### .. autoclass:: pymeasure.instruments.mksinst.mksinst.MKSInstrument :members: :show-inheritance: .. autoclass:: pymeasure.instruments.mksinst.mksinst.RelayChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9757855 pymeasure-0.16.0/docs/api/instruments/newport/0000755000175100017510000000000015203313301021037 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/newport/esp300.rst0000644000175100017510000000072115203313266022615 0ustar00runnerrunner######################### ESP 300 Motion Controller ######################### .. autoclass:: pymeasure.instruments.newport.ESP300 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.newport.esp300.Axis :members: :show-inheritance: .. autoclass:: pymeasure.instruments.newport.esp300.AxisError :members: :show-inheritance: .. autoclass:: pymeasure.instruments.newport.esp300.GeneralError :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/newport/index.rst0000644000175100017510000000051515203313266022713 0ustar00runnerrunner.. module:: pymeasure.instruments.newport ####### Newport ####### This section contains specific documentation on the Newport instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 esp300././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.976082 pymeasure-0.16.0/docs/api/instruments/ni/0000755000175100017510000000000015203313301017747 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ni/index.rst0000644000175100017510000000060215203313266021620 0ustar00runnerrunner.. module:: pymeasure.instruments.ni #################### National Instruments #################### This section contains specific documentation on the National Instruments instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 virtualbench././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ni/virtualbench.rst0000644000175100017510000000234715203313266023207 0ustar00runnerrunner################ NI Virtual Bench ################ ******************* General Information ******************* The `armstrap/pyvirtualbench `_ Python wrapper for the VirtualBench C-API is required. This Instrument driver only interfaces the pyvirtualbench Python wrapper. ******** Examples ******** To be documented. Check the examples in the pyvirtualbench repository to get an idea. Simple Example to switch digital lines of the DIO module. .. code-block:: python from pymeasure.instruments.ni import VirtualBench vb = VirtualBench(device_name='VB8012-3057E1C') line = 'dig/2' # may be list of lines # initialize DIO module -> available via vb.dio vb.acquire_digital_input_output(line, reset=False) vb.dio.write(self.line, {True}) sleep(1000) vb.dio.write(self.line, {False}) vb.shutdown() **************** Instrument Class **************** .. autoclass:: pymeasure.instruments.ni.virtualbench.VirtualBench :members: :show-inheritance: :inherited-members: :exclude-members: .. autoclass:: pymeasure.instruments.ni.virtualbench.VirtualBench_Direct :members: :show-inheritance: :inherited-members: :exclude-members: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9763749 pymeasure-0.16.0/docs/api/instruments/novanta/0000755000175100017510000000000015203313301021007 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/novanta/fpu60.rst0000644000175100017510000000031315203313266022510 0ustar00runnerrunner##################################### Novanta FPU60 laser power supply unit ##################################### .. autoclass:: pymeasure.instruments.novanta.Fpu60 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/novanta/index.rst0000644000175100017510000000065515203313266022670 0ustar00runnerrunner.. module:: pymeasure.instruments.novanta ################# Novanta Photonics ################# This section contains specific documentation on the Novanta photonics instruments that are implemented. Novanta contains also Lasers developed by Laserquantum. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 fpu60 ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.977268 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/0000755000175100017510000000000015203313301023156 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/IPS120_10.rst0000644000175100017510000000110015203313266025070 0ustar00runnerrunner############################################################################## Oxford Instruments Intelligent Power Supply 120-10 for superconducting magnets ############################################################################## .. autoclass:: pymeasure.instruments.oxfordinstruments.IPS120_10 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.oxfordinstruments.ips120_10.MagnetError :members: :show-inheritance: .. autoclass:: pymeasure.instruments.oxfordinstruments.ips120_10.SwitchHeaterError :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/ITC503.rst0000644000175100017510000000042215203313266024567 0ustar00runnerrunner######################################################### Oxford Instruments Intelligent Temperature Controller 503 ######################################################### .. autoclass:: pymeasure.instruments.oxfordinstruments.ITC503 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/MercuryiTC.rst0000644000175100017510000000076315203313266025756 0ustar00runnerrunner############################################################# Oxford Instruments Mercury Intelligent Temperature Controller ############################################################# .. autoclass:: pymeasure.instruments.oxfordinstruments.MercuryiTC :members: .. autoclass:: pymeasure.instruments.oxfordinstruments.mercuryitc.TemperatureSensor :members: :show-inheritance: .. autoclass:: pymeasure.instruments.oxfordinstruments.mercuryitc.Heater :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/PS120_10.rst0000644000175100017510000000105115203313266024764 0ustar00runnerrunner################################################################## Oxford Instruments Power Supply 120-10 for superconducting magnets ################################################################## .. autoclass:: pymeasure.instruments.oxfordinstruments.PS120_10 :show-inheritance: .. autoclass:: pymeasure.instruments.oxfordinstruments.ips120_10.MagnetError :members: :show-inheritance: :noindex: .. autoclass:: pymeasure.instruments.oxfordinstruments.ips120_10.SwitchHeaterError :members: :show-inheritance: :noindex: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/base.rst0000644000175100017510000000052315203313266024634 0ustar00runnerrunner################################## Oxford Instruments Base Instrument ################################## .. autoclass:: pymeasure.instruments.oxfordinstruments.base.OxfordInstrumentsBase :members: :show-inheritance: .. autoclass:: pymeasure.instruments.oxfordinstruments.base.OxfordVISAError :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/oxfordinstruments/index.rst0000644000175100017510000000066315203313266025036 0ustar00runnerrunner.. module:: pymeasure.instruments.oxfordinstruments ################## Oxford Instruments ################## This section contains specific documentation on the Oxford Instruments instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 base ITC503 IPS120_10 MercuryiTC PS120_10 ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.977559 pymeasure-0.16.0/docs/api/instruments/parker/0000755000175100017510000000000015203313301020625 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/parker/index.rst0000644000175100017510000000051315203313266022477 0ustar00runnerrunner.. module:: pymeasure.instruments.parker ###### Parker ###### This section contains specific documentation on the Parker instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 parkerGV6././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/parker/parkerGV6.rst0000644000175100017510000000030115203313266023172 0ustar00runnerrunner################################# Parker GV6 Servo Motor Controller ################################# .. autoclass:: pymeasure.instruments.parker.ParkerGV6 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9778786 pymeasure-0.16.0/docs/api/instruments/pendulum/0000755000175100017510000000000015203313301021172 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/pendulum/cnt91.rst0000644000175100017510000000030315203313266022670 0ustar00runnerrunner################################ Pendulum CNT91 frequency counter ################################ .. autoclass:: pymeasure.instruments.pendulum.cnt91.CNT91 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/pendulum/index.rst0000644000175100017510000000052215203313266023044 0ustar00runnerrunner.. module:: pymeasure.instruments.pendulum ######## Pendulum ######## This section contains specific documentation on the Pendulum instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 cnt91 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9781718 pymeasure-0.16.0/docs/api/instruments/philips/0000755000175100017510000000000015203313301021011 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/philips/PM6669.rst0000644000175100017510000000034115203313266022422 0ustar00runnerrunner############################################# Philips PM 6669 Universal Frequency Counter ############################################# .. autoclass:: pymeasure.instruments.philips.PM6669 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/philips/index.rst0000644000175100017510000000052015203313266022661 0ustar00runnerrunner.. module:: pymeasure.instruments.philips ####### Philips ####### This section contains specific documentation on the Philips instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `.`. .. toctree:: :maxdepth: 2 PM6669 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9784632 pymeasure-0.16.0/docs/api/instruments/proterial/0000755000175100017510000000000015203313301021342 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/proterial/index.rst0000644000175100017510000000056015203313266023216 0ustar00runnerrunner.. module:: pymeasure.instruments.proterial ######### Proterial ######### This section contains specific documentation on the Proterial (formerly Hitachi Metals) instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 rod4 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/proterial/rod4.rst0000644000175100017510000000044115203313266022755 0ustar00runnerrunner#################### ROD-4 MFC Controller #################### .. autoclass:: pymeasure.instruments.proterial.ROD4 :members: :show-inheritance: :inherited-members: CommonBase .. autoclass:: pymeasure.instruments.proterial.rod4.ROD4Channel :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9789276 pymeasure-0.16.0/docs/api/instruments/ptw/0000755000175100017510000000000015203313301020153 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ptw/index.rst0000644000175100017510000000056615203313266022035 0ustar00runnerrunner.. module:: pymeasure.instruments.ptw ############ PTW Freiburg ############ This section contains specific documentation on the PTW Freiburg GmbH instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ptwDIAMENTOR ptwUNIDOS ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ptw/ptwDIAMENTOR.rst0000644000175100017510000000026215203313266022774 0ustar00runnerrunner############################ PTW DIAMENTOR DAP dosemeters ############################ .. autoclass:: pymeasure.instruments.ptw.ptwDIAMENTOR :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/ptw/ptwUNIDOS.rst0000644000175100017510000000027615203313266022460 0ustar00runnerrunner################################# PTW UNIDOS Tango/Romeo dosemeters ################################# .. autoclass:: pymeasure.instruments.ptw.ptwUNIDOS :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9792163 pymeasure-0.16.0/docs/api/instruments/racal/0000755000175100017510000000000015203313301020423 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/racal/index.rst0000644000175100017510000000053215203313266022276 0ustar00runnerrunner.. module:: pymeasure.instruments.racal ########## Racal-Dana ########## This section contains specific documentation on the Raca-Dana instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 racal1992 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/racal/racal1992.rst0000644000175100017510000000030115203313266022570 0ustar00runnerrunner################################# Racal-Dana 1992 Universal Counter ################################# .. autoclass:: pymeasure.instruments.racal.Racal1992 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9795125 pymeasure-0.16.0/docs/api/instruments/razorbill/0000755000175100017510000000000015203313301021341 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/razorbill/index.rst0000644000175100017510000000054015203313266023213 0ustar00runnerrunner.. module:: pymeasure.instruments.razorbill ######### Razorbill ######### This section contains specific documentation on the Razorbill instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 razorbillRP100 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/razorbill/razorbillRP100.rst0000644000175100017510000000053215203313266024570 0ustar00runnerrunner################################################################################# Razorbill RP100 custrom power supply for Razorbill Instrums stress & strain cells ################################################################################# .. autoclass:: pymeasure.instruments.razorbill.razorbillRP100 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9798317 pymeasure-0.16.0/docs/api/instruments/redpitaya/0000755000175100017510000000000015203313301021323 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/redpitaya/index.rst0000644000175100017510000000054015203313266023175 0ustar00runnerrunner.. module:: pymeasure.instruments.redpitaya ######### Redpitaya ######### This section contains specific documentation on the Redpitaya instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 redpitaya_scpi ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/redpitaya/redpitaya_scpi.rst0000644000175100017510000000061015203313266025064 0ustar00runnerrunner############################################################################################ Redpitaya board for analog signal acquisition and generation as well as digital input/output ############################################################################################ .. autoclass:: pymeasure.instruments.redpitaya.redpitaya_scpi.RedPitayaScpi :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/resources.rst0000644000175100017510000000034215203313266022116 0ustar00runnerrunner####################### Resource Manager ####################### The :code:`list_resources` function provides an interface to check connected instruments interactively. .. autofunction:: pymeasure.instruments.list_resources ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9801235 pymeasure-0.16.0/docs/api/instruments/rigol/0000755000175100017510000000000015203313301020455 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rigol/index.rst0000644000175100017510000000051015203313266022324 0ustar00runnerrunner.. module:: pymeasure.instruments.rigol ##### Rigol ##### This section contains specific documentation on the Rigol instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 rigol_dg800././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rigol/rigol_dg800.rst0000644000175100017510000000043615203313266023242 0ustar00runnerrunner############################## Rigol DG800 waveform generator ############################## .. autoclass:: pymeasure.instruments.rigol.DG800 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.rigol.rigol_dg800.VoltageChannel :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9807262 pymeasure-0.16.0/docs/api/instruments/rohdeschwarz/0000755000175100017510000000000015203313301022044 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rohdeschwarz/fsseries.rst0000644000175100017510000000577615203313266024452 0ustar00runnerrunner###################################### R&S FS Series spectrum analyzer ###################################### Connecting to an R&S FSL via network ------------------------------------ Once connected to the network, the instrument's IP address can be found by clicking the "Setup" button and navigating to "General Settings" -> "Network Address". It can then be connected like this: .. code:: python from pymeasure.instruments.rohdeschwarz import FSL fsl = FSL("TCPIP::192.168.1.123::INSTR") Getting and setting parameters ------------------------------ Most parameters are implemented as properties, which means they can be read and written (getting and setting) in a consistent and simple way. If numerical values are provided, base units are used (s, Hz, dB, ...). Alternatively, the values can also be provided with a unit, e.g. ``"1.5 GHz"`` or ``"1.5GHz"``. Return values are always numerical. .. code:: python # Getting the current center frequency fsl.freq_center 9000000000.0 .. code:: python # Changing it to 10 MHz by providing the numerical value fsl.freq_center = 10e6 .. code:: python # Verifying: fsl.freq_center 10000000.0 .. code:: python # Changing it to 9 GHz by providing a string and verifying the result fsl.freq_center = '9GHz' fsl.freq_center 9000000000.0 .. code:: python # Setting the span to maximum fsl.freq_span = '7 GHz' Reading a trace --------------- We will read the current trace .. code:: python x, y = fsl.read_trace() Markers ------- Markers are implemented as their own class. You can create them like this: .. code:: python m1 = fsl.create_marker() Set peak exursion: .. code:: python m1.peak_excursion = 3 Set marker to a specific position: .. code:: python m1.x = 10e9 Find the next peak to the left and get the level: .. code:: python m1.to_next_peak('left') m1.y -34.9349060059 Delta markers ~~~~~~~~~~~~~ Delta markers can be created by setting the appropriate keyword. .. code:: python d2 = fsl.create_marker(is_delta_marker=True) d2.name 'DELT2' Example program --------------- Here is an example of a simple script for recording the peak of a signal. .. code:: python m1 = fsl.create_marker() # create marker 1 # Set standard settings, set to full span fsl.continuous_sweep = False fsl.freq_span = '18 GHz' fsl.res_bandwidth = "AUTO" fsl.video_bandwidth = "AUTO" fsl.sweep_time = "AUTO" # Perform a sweep on full span, set the marker to the peak and some to that marker fsl.single_sweep() m1.to_peak() m1.zoom('20 MHz') # take data from the zoomed-in region fsl.single_sweep() x, y = fsl.read_trace() .. autoclass:: pymeasure.instruments.rohdeschwarz.fsseries.FSSeries :members: :show-inheritance: .. autoclass:: pymeasure.instruments.rohdeschwarz.fsseries.FSL :members: :show-inheritance: .. autoclass:: pymeasure.instruments.rohdeschwarz.fsseries.FSW :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rohdeschwarz/hmp.rst0000644000175100017510000000031315203313266023371 0ustar00runnerrunner###################################### R&S HMP4040 Power Supply ###################################### .. autoclass:: pymeasure.instruments.rohdeschwarz.hmp.HMP4040 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rohdeschwarz/index.rst0000644000175100017510000000060315203313266023716 0ustar00runnerrunner.. module:: pymeasure.instruments.rohdeschwarz ############### Rohde & Schwarz ############### This section contains specific documentation on the Rohde & Schwarz instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 3 sfm fsseries hmp ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/rohdeschwarz/sfm.rst0000644000175100017510000000046415203313266023401 0ustar00runnerrunner###################################### R&S SFM TV test transmitter ###################################### .. autoclass:: pymeasure.instruments.rohdeschwarz.sfm.SFM :members: :show-inheritance: .. autoclass:: pymeasure.instruments.rohdeschwarz.sfm.Sound_Channel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9813113 pymeasure-0.16.0/docs/api/instruments/santec/0000755000175100017510000000000015203313301020616 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/santec/index.rst0000644000175100017510000000054315203313266022473 0ustar00runnerrunner.. module:: pymeasure.instruments.santec ###### Santec ###### This section contains specific documentation on the Santec instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 tsl500series tsl570 tsl550 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/santec/tsl500series.rst0000644000175100017510000000037315203313266023627 0ustar00runnerrunner################################### Santec TSL-500 Series Tunable Laser ################################### .. autoclass:: pymeasure.instruments.santec.tsl500series.TSL500Series :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/santec/tsl550.rst0000644000175100017510000000033215203313266022414 0ustar00runnerrunner############################ Santec TSL-550 Tunable Laser ############################ .. autoclass:: pymeasure.instruments.santec.tsl550.TSL550 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/santec/tsl570.rst0000644000175100017510000000033215203313266022416 0ustar00runnerrunner############################ Santec TSL-570 Tunable Laser ############################ .. autoclass:: pymeasure.instruments.santec.tsl570.TSL570 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.982219 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/0000755000175100017510000000000015203313301023412 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/index.rst0000644000175100017510000000075215203313266025271 0ustar00runnerrunner.. module:: pymeasure.instruments.siglenttechnologies #################### Siglent Technologies #################### This section contains specific documentation on the Siglent Technologies instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 siglent_spdbase siglent_spd1168x siglent_spd1305x siglent_sds1072cml siglent_sds1000xhd././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/siglent_sds1000xhd.rst0000644000175100017510000000152715203313266027506 0ustar00runnerrunner############################### Siglent SDS1000XHD Oscilloscope ############################### .. autoclass:: pymeasure.instruments.siglenttechnologies.SDS1000XHD :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1000xhd.AnalogChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1000xhd.WaveformChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1000xhd.AdvancedMeasurementItem :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1000xhd.MeasureChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1000xhd.TriggerChannel :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/siglent_sds1072cml.rst0000644000175100017510000000071415203313266027504 0ustar00runnerrunner############################### Siglent SDS1072CML Oscilloscope ############################### .. autoclass:: pymeasure.instruments.siglenttechnologies.SDS1072CML :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1072cml.VoltageChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_sds1072cml.TriggerChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/siglent_spd1168x.rst0000644000175100017510000000030215203313266027174 0ustar00runnerrunner############################# Siglent SPD1168X Power Supply ############################# .. autoclass:: pymeasure.instruments.siglenttechnologies.SPD1168X :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/siglent_spd1305x.rst0000644000175100017510000000030215203313266027165 0ustar00runnerrunner############################# Siglent SPD1305X Power Supply ############################# .. autoclass:: pymeasure.instruments.siglenttechnologies.SPD1305X :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/siglenttechnologies/siglent_spdbase.rst0000644000175100017510000000106015203313266027321 0ustar00runnerrunner############################### Siglent Technologies Base Class ############################### .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_spdbase.SPDBase :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_spdbase.SPDSingleChannelBase :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_spdbase.SPDChannel :members: :show-inheritance: .. autoclass:: pymeasure.instruments.siglenttechnologies.siglent_spdbase.SystemStatusCode ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9826777 pymeasure-0.16.0/docs/api/instruments/signalrecovery/0000755000175100017510000000000015203313301022375 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/signalrecovery/dsp7225.rst0000644000175100017510000000032615203313266024250 0ustar00runnerrunner########################## DSP 7225 Lock-in Amplifier ########################## .. autoclass:: pymeasure.instruments.signalrecovery.DSP7225 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/signalrecovery/dsp7265.rst0000644000175100017510000000032515203313266024253 0ustar00runnerrunner########################## DSP 7265 Lock-in Amplifier ########################## .. autoclass:: pymeasure.instruments.signalrecovery.DSP7265 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/signalrecovery/index.rst0000644000175100017510000000060115203313266024245 0ustar00runnerrunner.. module:: pymeasure.instruments.signalrecovery ############### Signal Recovery ############### This section contains specific documentation on the Signal Recovery instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 dsp7225 dsp7265 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9829807 pymeasure-0.16.0/docs/api/instruments/spellmanhv/0000755000175100017510000000000015203313301021512 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/spellmanhv/index.rst0000644000175100017510000000054615203313266023372 0ustar00runnerrunner.. module:: pymeasure.instruments.spellmanhv ########### Spellman HV ########### This section contains specific documentation on the Spellman HV instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 spellmanXRV ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/spellmanhv/spellmanXRV.rst0000644000175100017510000000066115203313266024474 0ustar00runnerrunner###################################### Spellman XRV High Voltage Power Supply ###################################### .. autoclass:: pymeasure.instruments.spellmanhv.SpellmanXRV :members: :show-inheritance: .. autoclass:: pymeasure.instruments.spellmanhv.spellmanXRV.Filament :members: :show-inheritance: .. autoclass:: pymeasure.instruments.spellmanhv.spellmanXRV.UnscaledData :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9838655 pymeasure-0.16.0/docs/api/instruments/srs/0000755000175100017510000000000015203313301020150 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/index.rst0000644000175100017510000000070115203313266022021 0ustar00runnerrunner.. module:: pymeasure.instruments.srs ######################### Stanford Research Systems ######################### This section contains specific documentation on the Stanford Research Systems (SRS) instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ldc500series sr510 sr570 sr830 sr860././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/ldc500series.rst0000644000175100017510000000121015203313266023110 0ustar00runnerrunner##################################### LDC500 Series Laser-diode Controllers ##################################### .. autoclass:: pymeasure.instruments.srs.ldc500series.LDC500Series :members: :show-inheritance: .. autoclass:: pymeasure.instruments.srs.ldc500series.LDC500SeriesLD :members: :show-inheritance: .. autoclass:: pymeasure.instruments.srs.ldc500series.LDC500SeriesPD :members: :show-inheritance: .. autoclass:: pymeasure.instruments.srs.ldc500series.LDC500SeriesTEC :members: :show-inheritance: .. autoclass:: pymeasure.instruments.srs.ldc500series.ThermometerType :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/sr510.rst0000644000175100017510000000023415203313266021565 0ustar00runnerrunner####################### SR510 Lock-in Amplifier ####################### .. autoclass:: pymeasure.instruments.srs.SR510 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/sr570.rst0000644000175100017510000000023415203313266021573 0ustar00runnerrunner####################### SR570 Lock-in Amplifier ####################### .. autoclass:: pymeasure.instruments.srs.SR570 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/sr830.rst0000644000175100017510000000023415203313266021572 0ustar00runnerrunner####################### SR830 Lock-in Amplifier ####################### .. autoclass:: pymeasure.instruments.srs.SR830 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/srs/sr860.rst0000644000175100017510000000023415203313266021575 0ustar00runnerrunner####################### SR860 Lock-in Amplifier ####################### .. autoclass:: pymeasure.instruments.srs.SR860 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9841623 pymeasure-0.16.0/docs/api/instruments/tcpowerconversion/0000755000175100017510000000000015203313301023132 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tcpowerconversion/index.rst0000644000175100017510000000062115203313266025004 0ustar00runnerrunner.. module:: pymeasure.instruments.tcpowerconversion #################### T&C Power Conversion #################### This section contains specific documentation on the instruments from T&C Power Conversion that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 tccxn ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tcpowerconversion/tccxn.rst0000644000175100017510000000055615203313266025023 0ustar00runnerrunner################################################### T&C Power Conversion AG Series Plasma Generator CXN ################################################### .. autoclass:: pymeasure.instruments.tcpowerconversion.CXN :members: :show-inheritance: .. autoclass:: pymeasure.instruments.tcpowerconversion.tccxn.PresetChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.984596 pymeasure-0.16.0/docs/api/instruments/tdk/0000755000175100017510000000000015203313301020123 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tdk/index.rst0000644000175100017510000000055415203313266022002 0ustar00runnerrunner.. module:: pymeasure.instruments.tdk ########## TDK Lambda ########## This section contains specific documentation on the TDK Lambda instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 tdk_gen40_38 tdk_gen80_65 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tdk/tdk_gen40_38.rst0000644000175100017510000000040715203313266022761 0ustar00runnerrunner######################################## TDK Lambda Genesys 40-38 DC power supply ######################################## .. autoclass:: pymeasure.instruments.tdk.tdk_gen40_38.TDK_Gen40_38 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tdk/tdk_gen80_65.rst0000644000175100017510000000040615203313266022764 0ustar00runnerrunner######################################## TDK Lambda Genesys 80-65 DC power supply ######################################## .. autoclass:: pymeasure.instruments.tdk.tdk_gen80_65.TDK_Gen80_65 :members: :show-inheritance: :inherited-members: CommonBase././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.985056 pymeasure-0.16.0/docs/api/instruments/tektronix/0000755000175100017510000000000015203313301021370 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tektronix/afg3152c.rst0000644000175100017510000000047615203313266023356 0ustar00runnerrunner##################################### AFG3152C Arbitrary function generator ##################################### .. autoclass:: pymeasure.instruments.tektronix.AFG3152C :members: :show-inheritance: .. autoclass:: pymeasure.instruments.tektronix.afg3152c.AFG3152CChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tektronix/index.rst0000644000175100017510000000054415203313266023246 0ustar00runnerrunner.. module:: pymeasure.instruments.tektronix ######### Tektronix ######### This section contains specific documentation on the Tektronix instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 tds2000 afg3152c././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/tektronix/tds2000.rst0000644000175100017510000000023315203313266023226 0ustar00runnerrunner#################### TDS2000 Oscilloscope #################### .. autoclass:: pymeasure.instruments.tektronix.TDS2000 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9855106 pymeasure-0.16.0/docs/api/instruments/teledyne/0000755000175100017510000000000015203313301021152 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/teledyne/index.rst0000644000175100017510000000166315203313266023033 0ustar00runnerrunner.. module:: pymeasure.instruments.teledyne ######### Teledyne ######### This section contains specific documentation on the Teledyne instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. If the instrument you are looking for is not here, also check :doc:`LeCroy<../lecroy/index>` for older instruments. .. toctree:: :maxdepth: 1 teledyneT3AFG There are shared base classes for Teledyne oscilloscopes. These base classes already work directly for some devices, the following are confirmed: * :class:`~pymeasure.instruments.teledyne.TeledyneMAUI` * Teledyne LeCroy HDO6xxx series (e.g. HDO6054B) If your device is not listed, the base class might already work well enough anyway. If adding a new device, these base classes should limit the amount of new code necessary. .. toctree:: :maxdepth: 2 teledyne_bases ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/teledyne/teledyneT3AFG.rst0000644000175100017510000000060015203313266024250 0ustar00runnerrunner############################################## Teledyne T3AFG Arbitrary Waveform Generator ############################################## .. autoclass:: pymeasure.instruments.teledyne.TeledyneT3AFG :members: :show-inheritance: :inherited-members: CommonBase .. autoclass:: pymeasure.instruments.teledyne.teledyneT3AFG.SignalChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/teledyne/teledyne_bases.rst0000644000175100017510000000133215203313266024703 0ustar00runnerrunner################################## Teledyne Oscilloscope base classes ################################## Teledyne Oscilloscope ##################### .. autoclass:: pymeasure.instruments.teledyne.TeledyneOscilloscope :members: :show-inheritance: Teledyne Channel ################ .. autoclass:: pymeasure.instruments.teledyne.teledyne_oscilloscope.TeledyneOscilloscopeChannel :members: :show-inheritance: Teledyne MAUI Oscilloscope ########################## .. autoclass:: pymeasure.instruments.teledyne.TeledyneMAUI :members: :show-inheritance: Teledyne MAUI Channel ##################### .. autoclass:: pymeasure.instruments.teledyne.teledyneMAUI.TeledyneMAUIChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.986233 pymeasure-0.16.0/docs/api/instruments/temptronic/0000755000175100017510000000000015203313301021525 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/temptronic/index.rst0000644000175100017510000000064515203313266023405 0ustar00runnerrunner.. module:: pymeasure.instruments.temptronic ########## Temptronic ########## This section contains specific documentation on the temptronic instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 temptronic_base temptronic_ats525 temptronic_ats545 temptronic_eco560 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/temptronic/temptronic_ats525.rst0000644000175100017510000000027215203313266025561 0ustar00runnerrunner############################## Temptronic ATS525 Thermostream ############################## .. autoclass:: pymeasure.instruments.temptronic.ATS525 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/temptronic/temptronic_ats545.rst0000644000175100017510000000027215203313266025563 0ustar00runnerrunner############################## Temptronic ATS545 Thermostream ############################## .. autoclass:: pymeasure.instruments.temptronic.ATS545 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/temptronic/temptronic_base.rst0000644000175100017510000000050115203313266025443 0ustar00runnerrunner##################### Temptronic Base Class ##################### .. autoclass:: pymeasure.instruments.temptronic.ATSBase :members: :show-inheritance: .. autoclass:: pymeasure.instruments.temptronic.temptronic_base.TemperatureStatusCode .. autoclass:: pymeasure.instruments.temptronic.temptronic_base.ErrorCode ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/temptronic/temptronic_eco560.rst0000644000175100017510000000027215203313266025537 0ustar00runnerrunner############################## Temptronic ECO560 Thermostream ############################## .. autoclass:: pymeasure.instruments.temptronic.ECO560 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9865308 pymeasure-0.16.0/docs/api/instruments/texio/0000755000175100017510000000000015203313301020471 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/texio/index.rst0000644000175100017510000000052215203313266022343 0ustar00runnerrunner.. module:: pymeasure.instruments.texio ######## TEXIO ######## This section contains specific documentation on the TEXIO instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 texioPSW360L30 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/texio/texioPSW360L30.rst0000644000175100017510000000033515203313266023470 0ustar00runnerrunner############################# TEXIO PSW-360L30 Power Supply ############################# .. autoclass:: pymeasure.instruments.texio.TexioPSW360L30 :members: :show-inheritance: :inherited-members: CommonBase ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9868393 pymeasure-0.16.0/docs/api/instruments/thermotron/0000755000175100017510000000000015203313301021542 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thermotron/index.rst0000644000175100017510000000054415203313266023420 0ustar00runnerrunner.. module:: pymeasure.instruments.thermotron ########## Thermotron ########## This section contains specific documentation on the Thermotron instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 thermotron3800././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thermotron/thermotron3800.rst0000644000175100017510000000024415203313266025022 0ustar00runnerrunner#################### Thermotron 3800 Oven #################### .. autoclass:: pymeasure.instruments.thermotron.Thermotron3800 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.987424 pymeasure-0.16.0/docs/api/instruments/thorlabs/0000755000175100017510000000000015203313301021157 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thorlabs/index.rst0000644000175100017510000000060515203313266023033 0ustar00runnerrunner.. module:: pymeasure.instruments.thorlabs ######## Thorlabs ######## This section contains specific documentation on the Thorlabs instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 thorlabspm100usb thorlabspro8000 thorlabsmbxseries ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thorlabs/thorlabsmbxseries.rst0000644000175100017510000000036215203313266025464 0ustar00runnerrunner############################################## Thorlabs MBX Series Modulator Bias Controllers ############################################## .. autoclass:: pymeasure.instruments.thorlabs.ThorlabsMBXSeries :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thorlabs/thorlabspm100usb.rst0000644000175100017510000000027315203313266025033 0ustar00runnerrunner############################ Thorlabs PM100USB Powermeter ############################ .. autoclass:: pymeasure.instruments.thorlabs.ThorlabsPM100USB :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thorlabs/thorlabspro8000.rst0000644000175100017510000000033115203313266024567 0ustar00runnerrunner###################################### Thorlabs Pro 8000 modular laser driver ###################################### .. autoclass:: pymeasure.instruments.thorlabs.ThorlabsPro8000 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.987877 pymeasure-0.16.0/docs/api/instruments/thyracont/0000755000175100017510000000000015203313301021354 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thyracont/index.rst0000644000175100017510000000055615203313266023235 0ustar00runnerrunner.. module:: pymeasure.instruments.thyracont ######### Thyracont ######### This section contains specific documentation on the Thyracont instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 smartline_v1 smartline_v2 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thyracont/smartline_v1.rst0000644000175100017510000000031615203313266024524 0ustar00runnerrunner############################### Smartline V1 Transmitter Series ############################### .. autoclass:: pymeasure.instruments.thyracont.smartline_v1.SmartlineV1 :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/thyracont/smartline_v2.rst0000644000175100017510000000114515203313266024526 0ustar00runnerrunner############################### Smartline V2 Transmitter Series ############################### .. autoclass:: pymeasure.instruments.thyracont.smartline_v2.SmartlineV2 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.thyracont.smartline_v2.VSH :members: :show-inheritance: .. autoclass:: pymeasure.instruments.thyracont.smartline_v2.VSM :members: :show-inheritance: .. autoclass:: pymeasure.instruments.thyracont.smartline_v2.VSP :members: :show-inheritance: .. autoclass:: pymeasure.instruments.thyracont.smartline_v2.VSR :members: :show-inheritance:././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9881666 pymeasure-0.16.0/docs/api/instruments/toptica/0000755000175100017510000000000015203313301021004 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/toptica/ibeamsmart.rst0000644000175100017510000000046515203313266023701 0ustar00runnerrunner############################### Toptica IBeam Smart Laser diode ############################### .. autoclass:: pymeasure.instruments.toptica.ibeamsmart.IBeamSmart :members: :show-inheritance: .. autoclass:: pymeasure.instruments.toptica.ibeamsmart.DriverChannel :members: :show-inheritance: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/toptica/index.rst0000644000175100017510000000053415203313266022661 0ustar00runnerrunner.. module:: pymeasure.instruments.toptica ####### Toptica ####### This section contains specific documentation on the Toptica Photonics instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 ibeamsmart ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/validators.rst0000644000175100017510000000100215203313266022246 0ustar00runnerrunner.. module:: pymeasure.instruments.validators ################### Validator functions ################### Validators are used in conjunction with the :func:`Instrument.control ` or :func:`Instrument.setting ` functions to allow properties with complex restrictions for valid values. They are described in more detail in the :ref:`validators` section. .. automodule:: pymeasure.instruments.validators :members: :noindex: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9884567 pymeasure-0.16.0/docs/api/instruments/velleman/0000755000175100017510000000000015203313301021144 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/velleman/index.rst0000644000175100017510000000052215203313266023016 0ustar00runnerrunner.. module:: pymeasure.instruments.velleman ######## Velleman ######## This section contains specific documentation on the Velleman instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 2 k8090 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/velleman/k8090.rst0000644000175100017510000000045515203313266022467 0ustar00runnerrunner#################################### Velleman K8090 8-channel relay board #################################### .. autoclass:: pymeasure.instruments.velleman.VellemanK8090 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.velleman.VellemanK8090Switches :show-inheritance: ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9890172 pymeasure-0.16.0/docs/api/instruments/yokogawa/0000755000175100017510000000000015203313301021162 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/yokogawa/aq6370series.rst0000644000175100017510000000175115203313266024066 0ustar00runnerrunner#################################################### Yokogawa AQ6370 Series of Optical Spectrum Analyzers #################################################### .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6370Series :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6370E :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6370D :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6370C :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6373 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6373B :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6375 :members: :show-inheritance: .. autoclass:: pymeasure.instruments.yokogawa.aq6370series.AQ6375B :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/yokogawa/index.rst0000644000175100017510000000057615203313266023045 0ustar00runnerrunner.. module:: pymeasure.instruments.yokogawa ######## Yokogawa ######## This section contains specific documentation on the Yokogawa instruments that are implemented. If you are interested in an instrument not included, please consider :doc:`adding the instrument `. .. toctree:: :maxdepth: 3 yokogawa7651 yokogawags200 aq6370series ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/yokogawa/yokogawa7651.rst0000644000175100017510000000030615203313266024071 0ustar00runnerrunner################################# Yokogawa 7651 Programmable Supply ################################# .. autoclass:: pymeasure.instruments.yokogawa.Yokogawa7651 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/api/instruments/yokogawa/yokogawags200.rst0000644000175100017510000000024315203313266024322 0ustar00runnerrunner##################### Yokogawa GS200 Source ##################### .. autoclass:: pymeasure.instruments.yokogawa.YokogawaGS200 :members: :show-inheritance:././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/conf.py0000644000175100017510000002410715203313266015512 0ustar00runnerrunner# # PyMeasure documentation build configuration file, created by # sphinx-quickstart on Mon Apr 6 13:06:00 2015. # # This file is execfile()d with the current directory set to its # containing dir. # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default. import sys import os sys.path.insert(0, os.path.abspath('..')) # Allow modules to be found from pymeasure import __version__ from pymeasure.instruments.common_base import CommonBase from pymeasure.instruments.instrument import Instrument # Include Read the Docs formatting on_rtd = os.environ.get('READTHEDOCS', None) == 'True' if not on_rtd: # only import and set the theme if we're building docs locally html_theme = 'sphinx_rtd_theme' # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # sys.path.insert(0, os.path.abspath('.')) # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. # needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.autosummary', 'sphinx.ext.doctest', 'sphinx_autodoc_typehints' ] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. # source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # General information about the project. project = 'PyMeasure' copyright = '2013-2026, PyMeasure Developers' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # release = __version__ version = '.'.join(release.split('.')[:3]) # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: # today = '' # Else, today_fmt is used as the format for a strftime call. # today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = ['_build'] # The reST default role (used for this markup: `text`) to use for all # documents. # default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. # add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). # add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. # show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. # modindex_common_prefix = [] # If true, keep warnings as "system message" paragraphs in the built documents. # keep_warnings = False # -- Options for HTML output ---------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = 'sphinx_rtd_theme' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. # html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. # html_theme_path = [] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". # html_title = None # A shorter title for the navigation bar. Default is the same as html_title. # html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. # html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. # html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". # html_static_path = ['_static'] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. # html_extra_path = [] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. # html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. # html_use_smartypants = True # Custom sidebar templates, maps document names to template names. # html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. # html_additional_pages = {} # If false, no module index is generated. # html_domain_indices = True # If false, no index is generated. # html_use_index = True # If true, the index is split into individual pages for each letter. # html_split_index = False # If true, links to the reST sources are added to the pages. # html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. # html_show_sphinx = True # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. # html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. # html_use_opensearch = '' # This is the file name suffix for HTML files (e.g. ".xhtml"). # html_file_suffix = None # Output file base name for HTML help builder. htmlhelp_basename = 'PyMeasuredoc' # -- Options for LaTeX output --------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). # 'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). # 'pointsize': '10pt', # Additional stuff for the LaTeX preamble. # 'preamble': '', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ ('index', 'PyMeasure.tex', 'PyMeasure Documentation', 'PyMeasure Developers', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. # latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. # latex_use_parts = False # If true, show page references after internal links. # latex_show_pagerefs = False # If true, show URL addresses after external links. # latex_show_urls = False # Documents to append as an appendix to all manuals. # latex_appendices = [] # If false, no module index is generated. # latex_domain_indices = True # -- Options for manual page output --------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ ('index', 'pymeasure', 'PyMeasure Documentation', ['PyMeasure Developers'], 1) ] # If true, show URL addresses after external links. # man_show_urls = False # -- Options for Texinfo output ------------------------------------------- # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ ('index', 'PyMeasure', 'PyMeasure Documentation', 'PyMeasure Developers', 'PyMeasure', 'One line description of project.', 'Miscellaneous'), ] # Documents to append as an appendix to all manuals. # texinfo_appendices = [] # If false, no module index is generated. # texinfo_domain_indices = True # How to display URL addresses: 'footnote', 'no', or 'inline'. # texinfo_show_urls = 'footnote' # If true, do not generate a @detailmenu in the "Top" node's menu. # texinfo_no_detailmenu = False # Automatically mock optional packages autodoc_mock_imports = ['zmq', 'cloudpickle', 'pyvirtualbench'] # -- Options for sphinx_autodoc_typehints --------------------------------- typehints_use_rtype = False typehints_defaults = "braces-after" def setup(app): app.connect('autodoc-process-docstring', gen_channel_docs) def get_class_name(cls): cls_str = str(cls) first_idx = cls_str.index("'") second_idx = cls_str[first_idx + 1:].index("'") return cls_str[first_idx + 1:first_idx + second_idx + 1] def gen_channel_docs(app, what, name, obj, options, lines): """ Generate channel documentation for instruments with channels """ if hasattr(obj, '__bases__') and issubclass(obj, Instrument): for attr, channel_class in obj.get_channels(obj): if isinstance(channel_class, CommonBase.ChannelCreator): channel_name = get_class_name(channel_class.pairs[0][0]) lines += ['.. py:attribute:: ' + attr, '', ] lines += [' :channel: :class:`~' + channel_name + '`', ''] elif isinstance(channel_class, CommonBase.MultiChannelCreator): prefix = channel_class.kwargs['prefix'] # Generate list of channels from prefix and channel pairs channels = ['``' + prefix + str(id) + '``: :class:`~' + get_class_name(cls) + '`' for cls, id in channel_class.pairs] lines += ['.. py:attribute:: ' + attr, '', ] lines += [' :channels: ' + ", ".join(channels), ''] ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9894168 pymeasure-0.16.0/docs/dev/0000755000175100017510000000000015203313301014753 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.990416 pymeasure-0.16.0/docs/dev/adding_instruments/0000755000175100017510000000000015203313301020654 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/advanced_communication.rst0000644000175100017510000002007415203313266026115 0ustar00runnerrunner.. _advanced_communication_protocols: Advanced communication protocols ================================ Some devices require a more advanced communication protocol, e.g. due to checksums or device addresses. In most cases, it is sufficient to subclass :meth:`Instrument.write ` and :meth:`Instrument.read `. .. testsetup:: # Behind the scene, replace Instrument with FakeInstrument to enable # doctesting simple usage cases (default doctest group) from pymeasure.instruments.fakes import FakeInstrument as Instrument .. testsetup:: with-protocol-tests # If we want to run protocol tests on doctest code, we need to use a # separate doctest "group" and a different set of imports. # See https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html from pymeasure.instruments import Instrument, Channel from pymeasure.test import expected_protocol Instrument's inner workings *************************** In order to adjust an instrument for more complicated protocols, it is key to understand the different parts. The :class:`~pymeasure.adapters.Adapter` exposes :meth:`~pymeasure.adapters.Adapter.write` and :meth:`~pymeasure.adapters.Adapter.read` for strings, :meth:`~pymeasure.adapters.Adapter.write_bytes` and :meth:`~pymeasure.adapters.Adapter.read_bytes` for bytes messages. These are the most basic methods, which log all the traffic going through them. For the actual communication, they call private methods of the Adapter in use, e.g. :meth:`VISAAdapter._read `. For binary data, like waveforms, the adapter provides also :meth:`~pymeasure.adapters.Adapter.write_binary_values` and :meth:`~pymeasure.adapters.Adapter.read_binary_values`, which use the aforementioned methods. You do not need to call all these methods directly, instead, you should use the methods of :class:`~pymeasure.instruments.Instrument` with the same name. They call the Adapter for you and keep the code tidy. Now to :class:`~pymeasure.instruments.Instrument`. The most important methods are :meth:`~pymeasure.instruments.Instrument.write` and :meth:`~pymeasure.instruments.Instrument.read`, as they are the most basic building blocks for the communication. The pymeasure properties (:meth:`Instrument.control ` and its derivatives :meth:`Instrument.measurement ` and :meth:`Instrument.setting `) and probably most of your methods and properties will call them. In any instrument, :meth:`write` should write a general string command to the device in such a way, that it understands it. Similarly, :meth:`read` should return a string in a general fashion in order to process it further. The getter of :meth:`Instrument.control ` does not call them directly, but via a chain of methods. It calls :meth:`~pymeasure.instruments.Instrument.values` which in turn calls :meth:`~pymeasure.instruments.Instrument.ask` and processes the returned string into understandable values. :meth:`~pymeasure.instruments.Instrument.ask` sends the readout command via :meth:`write`, waits some time if necessary via :meth:`wait_for`, and reads the device response via :meth:`read`. Similarly, :meth:`Instrument.binary_values ` sends a command via :meth:`write`, waits with :meth:`wait_till_read`, but reads the response via :meth:`Adapter.read_binary_values `. Adding a device address and adding delay **************************************** Let's look at a simple example for a device, which requires its address as the first three characters and returns the same style. This is straightforward, as :meth:`write` just prepends the device address to the command, and :meth:`read` has to strip it again doing some error checking. Similarly, a checksum could be added. Additionally, the device needs some time after it received a command, before it responds, therefore :meth:`wait_for` waits always a certain time span. .. testcode:: with-protocol-tests class ExtremeCommunication(Instrument): """Control the ExtremeCommunication instrument. :param address: The device address for the communication. :param query_delay: Wait time after writing and before reading in seconds. """ def __init__(self, adapter, name="ExtremeCommunication", address=0, query_delay=0.1): super().__init__(adapter, name) self.address = f"{address:03}" self.query_delay = query_delay def write(self, command): """Add the device address in front of every command before sending it.""" super().write(self.address + command) def wait_for(self, query_delay=0): """Wait for some time. :param query_delay: override the global query_delay. """ super().wait_for(query_delay or self.query_delay) def read(self): """Read from the device and check the response. Assert that the response starts with the device address. """ got = super().read() if got.startswith(self.address): return got[3:] else: raise ConnectionError(f"Expected message address '{self.address}', but read '{got[3:]}' for wrong address '{got[:3]}'.") voltage = Instrument.measurement( ":VOLT:?", """Measure the voltage in Volts.""") .. testcode:: with-protocol-tests :hide: with expected_protocol(ExtremeCommunication, [("012:VOLT:?", "01215.5")], address=12 ) as inst: assert inst.voltage == 15.5 If the device is initialized with :code:`address=12`, a request for the voltage would send :code:`"012:VOLT:?"` to the device and expect a response beginning with :code:`"012"`. Bytes communication ******************* Some devices do not expect ASCII strings but raw bytes. In those cases, you can call the :meth:`write_bytes` and :meth:`read_bytes` in your :meth:`write` and :meth:`read` methods. The following example shows an instrument, which has registers to be written and read via bytes sent. .. testcode:: with-protocol-tests class ExtremeBytes(Instrument): """Control the ExtremeBytes instrument with byte-based communication.""" def __init__(self, adapter, name="ExtremeBytes"): super().__init__(adapter, name) def write(self, command): """Write to the device according to the comma separated command. :param command: R or W for read or write, hexadecimal address, and data. """ function, address, data = command.split(",") b = [0x03] if function == "R" else [0x10] b.extend(int(address, 16).to_bytes(2, byteorder="big")) b.extend(int(data).to_bytes(length=8, byteorder="big", signed=True)) self.write_bytes(bytes(b)) def read(self): """Read the response and return the data as a string, if applicable.""" response = self.read_bytes(2) # return type and payload if response[0] == 0x00: raise ConnectionError(f"Device error of type {response[1]} occurred.") if response[0] == 0x03: # read that many bytes and return them as an integer data = self.read_bytes(response[1]) return str(int.from_bytes(data, byteorder="big", signed=True)) if response[0] == 0x10 and response[1] != 0x00: raise ConnectionError(f"Writing to the device failed with error {response[1]}") voltage = Instrument.control( "R,0x106,1", "W,0x106,%i", """Control the output voltage in mV.""", ) .. testcode:: with-protocol-tests :hide: with expected_protocol(ExtremeBytes, [(b"\x03\x01\x06\x00\x00\x00\x00\x00\x00\x00\x01", b"\x03\x01\x0f")]) as inst: assert inst.voltage == 15 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/channels.rst0000644000175100017510000003144515203313266023222 0ustar00runnerrunner.. _channels: Instruments with channels ========================= .. testsetup:: # Behind the scene, replace Instrument with FakeInstrument to enable # doctesting simple usage cases (default doctest group) from pymeasure.instruments.fakes import FakeInstrument as Instrument .. testsetup:: with-protocol-tests # If we want to run protocol tests on doctest code, we need to use a # separate doctest "group" and a different set of imports. # See https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html from pymeasure.instruments import Instrument, Channel from pymeasure.test import expected_protocol Some instruments, like oscilloscopes and voltage sources, have channels whose commands differ only in the channel name. For this case, we have :class:`~pymeasure.instruments.Channel`, which is similar to :class:`~pymeasure.instruments.Instrument` and its property factories, but does expect an :class:`~pymeasure.instruments.Instrument` instance (i.e., a parent instrument) instead of an :class:`~pymeasure.adapters.Adapter` as parameter. All the channel communication is routed through the instrument's methods (`write`, `read`, etc.). However, :meth:`Channel.insert_id ` uses ``str.format`` to insert the channel's id at any occurrence of the class attribute :attr:`Channel.placeholder`, which defaults to :code:`"ch"`, in the written commands. For example :code:`"Ch{ch}:VOLT?"` will be sent as :code:`"Ch3:VOLT?"` to the device, if the channel's id is "3". Please add any created channel classes to the documentation. In the instrument's documentation file, you may add .. code:: .. autoclass:: pymeasure.instruments.MANUFACTURER.INSTRUMENT.CHANNEL :members: :show-inheritance: `MANUFACTURER` is the folder name of the manufacturer and `INSTRUMENT` the file name of the instrument definition, which contains the `CHANNEL` class. You may link in the instrument's docstring to the channel with :code:`:class:`CHANNEL`` To simplify and standardize the creation of channels in an ``Instrument`` class, there are two classes that can be used. For instruments with fewer than 16 channels, :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` should be used to explicitly declare each individual channel. For instruments with more than 16 channels, the :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` can create multiple channels in a single declaration. Adding a channel with :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` ******************************************************************************************* For instruments with fewer than 16 channels the class :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` should be used to assign each channel interface to a class attribute. :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` constructor accepts two parameters, the channel class for this channel interface, and the instrument's channel id for the channel interface. In this example, we are defining a channel class and an instrument driver class. The ``VoltageChannel`` channel class will be used for controlling two channels in our ``ExtremeVoltage5000`` instrument. In the ``ExtremeVoltage5000`` class we declare two class attributes with :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator`, ``output_A`` and ``output_B``, which will become our channel interfaces. .. testcode:: with-protocol-tests class VoltageChannel(Channel): """A channel of the voltage source.""" voltage = Channel.control( "SOURce{ch}:VOLT?", "SOURce{ch}:VOLT %g", """Control the output voltage of this channel.""", ) class ExtremeVoltage5000(Instrument): """An instrument with channels.""" output_A = Instrument.ChannelCreator(VoltageChannel, "A") output_B = Instrument.ChannelCreator(VoltageChannel, "B") .. testcode:: with-protocol-tests :hide: with expected_protocol(ExtremeVoltage5000, [("SOURceA:VOLT 1.25", None), ("SOURceB:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.output_A.voltage = 1.25 assert inst.channels['B'].voltage == 4.56 At instrument class instantiation, the instrument class will create an instance of the channel class and assign it to the class attribute name. Additionally the channels will be collected in a dictionary, by default named :code:`channels`. We can access the channel interface through that class name: .. code-block:: python extreme_inst = ExtremeVoltage5000('COM3') # Set channel A voltage extreme_inst.output_A.voltage = 50 # Read channel B voltage chan_b_voltage = extreme_inst.output_B.voltage .. testcode:: with-protocol-tests :hide: with expected_protocol(ExtremeVoltage5000, [("SOURceA:VOLT 50", None), ("SOURceB:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.output_A.voltage = 50 assert inst.output_B.voltage == 4.56 Or we can access the channel interfaces through the :code:`channels` collection: .. code-block:: python # Set channel A voltage extreme_inst.channels['A'].voltage = 50 # Read channel B voltage chan_b_voltage = extreme_inst.channels['B'].voltage .. testcode:: with-protocol-tests :hide: with expected_protocol(ExtremeVoltage5000, [("SOURceA:VOLT 50", None), ("SOURceB:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.channels['A'].voltage = 50 assert inst.channels['B'].voltage == 4.56 Adding multiple channels with :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` ******************************************************************************************************** For instruments greater than 16 channels the class :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` can be used to easily generate a list of channels from one class attribute declaration. The :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` constructor accepts a single channel class or list of channel classes, and a list of corresponding channel ids. Instead of lists, you may also use tuples. If you give a single class and a list of ids, all channels will be of the same class. At instrument instantiation, the instrument will generate channel interfaces as class attribute names composing of the prefix (default :code:`"ch_"`) and channel id, e.g. the channel with id "A" will be added as attribute :code:`ch_A`. While :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` creates a channel interface for each class attribute, :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` creates a channel collection for the assigned class attribute. It is recommended you use the class attribute name ``channels`` to keep the codebase homogenous. To modify our example, we will use :class:`~pymeasure.instruments.common_base.CommonBase.MultiChannelCreator` to generate 24 channels of the ``VoltageChannel`` class. .. testcode:: with-protocol-tests class VoltageChannel(Channel): """A channel of the voltage source.""" voltage = Channel.control( "SOURce{ch}:VOLT?", "SOURce{ch}:VOLT %g", """Control the output voltage of this channel.""", ) class MultiExtremeVoltage5000(Instrument): """An instrument with channels.""" channels = Instrument.MultiChannelCreator(VoltageChannel, list(range(1,25))) .. testcode:: with-protocol-tests :hide: with expected_protocol(MultiExtremeVoltage5000, [("SOURce5:VOLT 1.23", None), ("SOURce16:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.ch_5.voltage = 1.23 assert inst.channels[16].voltage == 4.56 We can now access the channel interfaces through the generated class attributes: .. code-block:: python extreme_inst = MultiExtremeVoltage5000('COM3') # Set channel 5 voltage extreme_inst.ch_5.voltage = 50 # Read channel 16 voltage chan_16_voltage = extreme_inst.ch_16.voltage .. testcode:: with-protocol-tests :hide: with expected_protocol(MultiExtremeVoltage5000, [("SOURce5:VOLT 50", None), ("SOURce16:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.ch_5.voltage = 50 assert inst.ch_16.voltage == 4.56 Because we use `channels` as the class attribute for ``MultiChannelCreator``, we can access the channel interfaces through the :code:`channels` collection: .. code-block:: python # Set channel 10 voltage extreme_inst.channels[10].voltage = 50 # Read channel 22 voltage chan_b_voltage = extreme_inst.channels[22].voltage .. testcode:: with-protocol-tests :hide: with expected_protocol(MultiExtremeVoltage5000, [("SOURce10:VOLT 50", None), ("SOURce22:VOLT?", "4.56")], name="Instrument with Channels", ) as inst: inst.channels[10].voltage = 50 assert inst.channels[22].voltage == 4.56 Advanced channel management *************************** Adding / removing channels -------------------------- In order to add or remove programmatically channels, use the parent's :meth:`~pymeasure.instruments.common_base.CommonBase.add_child`, :meth:`~pymeasure.instruments.common_base.CommonBase.remove_child` methods. Channels with fixed prefix -------------------------- If all channel communication is prefixed by a specific command, e.g. :code:`"SOURceA:"` for channel A, you can override the channel's :meth:`insert_id` method. That is especially useful, if you have only one channel of that type, e.g. because it defines one function of the instrument vs. another one. .. testcode:: with-protocol-tests class VoltageChannelPrefix(Channel): """A channel of a voltage source, every command has the same prefix.""" def insert_id(self, command): return f"SOURce{self.id}:{command}" voltage = Channel.control( "VOLT?", "VOLT %g", """Control the output voltage of this channel.""", ) .. testcode:: with-protocol-tests :hide: class InstrumentWithChannelsPrefix(Instrument): """An instrument with a channel, just for the test.""" ch_A = Instrument.ChannelCreator(VoltageChannelPrefix, "A") with expected_protocol(InstrumentWithChannelsPrefix, [("SOURceA:VOLT 1.23", None), ("SOURceA:VOLT?", "1.23")], name="Test", ) as inst: inst.ch_A.voltage = 1.23 assert inst.ch_A.voltage == 1.23 This channel class implements the same communication as the previous example, but implements the channel prefix in the :meth:`insert_id` method and not in the individual property (created by :meth:`control`). Collections of different channel types -------------------------------------- Some devices have different types of channels. In this case, you can specify a different ``collection`` and ``prefix`` parameter. .. testcode:: with-protocol-tests class PowerChannel(Channel): """A channel controlling the power.""" power = Channel.measurement( "POWER?", """Measure the currently consumed power.""") class MultiChannelTypeInstrument(Instrument): """An instrument with two different channel types.""" analog = Instrument.MultiChannelCreator( (VoltageChannel, VoltageChannelPrefix), ("A", "B"), prefix="an_") digital = Instrument.MultiChannelCreator(VoltageChannel, (0, 1, 2), prefix="di_") power = Instrument.ChannelCreator(PowerChannel) .. testcode:: with-protocol-tests :hide: with expected_protocol(MultiChannelTypeInstrument, [("SOURceB:VOLT 1.23", None), ("SOURce2:VOLT?", "4.56")], name="MultiChannelTypeInstrument", ) as inst: inst.an_B.voltage = 1.23 assert inst.di_2.voltage == 4.56 This instrument has two collections of channels and one single channel. The first collection in the dictionary :code:`analog` contains an instance of :class:`VoltageChannel` with the name :code:`an_A` and an instance of :class:`VoltageChannelPrefix` with the name :code:`an_B`. The second collection contains three channels of type :class:`VoltageChannel` with the names :code:`di_0, di_1, di_2` in the dictionary :code:`digital`. You can address the first channel of the second group either with :code:`inst.di_0` or with :code:`inst.digital[0]`. Finally, the instrument has a single channel with the name :code:`power`, as it does not have a prefix. If you have a single channel category, do not change the default parameters of :class:`~pymeasure.instruments.common_base.CommonBase.ChannelCreator` or :meth:`~pymeasure.instruments.common_base.CommonBase.add_child`, in order to keep the code base homogeneous. We expect the default behaviour to be sufficient for most use cases. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/index.rst0000644000175100017510000000222515203313266022530 0ustar00runnerrunner.. _adding-instruments: ################## Adding instruments ################## You can make a significant contribution to PyMeasure by adding a new instrument to the :code:`pymeasure.instruments` package. Even adding an instrument with a few features can help get the ball rolling, since its likely that others are interested in the same instrument. Before getting started, become familiar with the :doc:`contributing work-flow <../contribute>` for PyMeasure, which steps through the process of adding a new feature (like an instrument) to the development version of the source code. Pymeasure instruments communicate with the devices via transfer of bytes or ASCII characters encoded as bytes. For ease of use, we have :ref:`property creators ` to easily create python properties. Similarly, we have creators to easily implement :ref:`channels `. Finally, for a smoother implementation process and better maintenance, we have :ref:`tests `. The following sections will describe how to lay out your instrument code. .. toctree:: :maxdepth: 2 instrument properties channels advanced_communication tests solutions ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/instrument.rst0000644000175100017510000003666715203313266023652 0ustar00runnerrunnerFile structure ============== Your new instrument should be placed in the directory corresponding to the manufacturer of the instrument. For example, if you are going to add an "Extreme 5000" instrument you should add the following files assuming "Extreme" is the manufacturer. Use lowercase for all filenames to distinguish packages from CamelCase Python classes. .. code-block:: none pymeasure/pymeasure/instruments/extreme/ |--> __init__.py |--> extreme5000.py Updating the init file ********************** The :code:`__init__.py` file in the manufacturer directory should import all of the instruments that correspond to the manufacturer, to allow the files to be easily imported. Add test files ************** Test files (pytest) for each instrument are highly encouraged, as they help verify the code and implement changes. Testing new code parts with a test (Test Driven Development) is a good way for fast and good programming, as you catch errors early on. .. code-block:: none pymeasure/tests/instruments/extreme/ |--> test_extreme5000.py Adding documentation ******************** Documentation for each instrument is required, and helps others understand the features you have implemented. Add a new reStructuredText file to the documentation. .. code-block:: none pymeasure/docs/api/instruments/extreme/ |--> index.rst |--> extreme5000.rst Copy an existing instrument documentation file, which will automatically generate the documentation for the instrument. The :code:`index.rst` file should link to the :code:`extreme5000` file. For a new manufacturer, the manufacturer should be also linked in :code:`pymeasure/docs/api/instruments/index.rst`. Instrument file =============== All standard instruments should be child class of :class:`Instrument `. This provides the basic functionality for working with :class:`Adapters `, which perform the actual communication. The most basic instrument, for our "Extreme 5000" example starts like this: .. testcode:: # # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument This is a minimal instrument definition: .. testcode:: class Extreme5000(Instrument): """Control the imaginary Extreme 5000 instrument.""" def __init__(self, adapter, name="Extreme 5000", **kwargs): super().__init__( adapter, name, **kwargs ) Make sure to include the PyMeasure license to each file, and add yourself as an author to the :code:`AUTHORS.txt` file. There is a certain order of elements in an instrument class that is useful to adhere to: * First, the initializer (the :code:`__init__()` method), this makes it faster to find when browsing the source code. * Then class attributes/variables, if you need them. * Then properties (pymeasure-specific or generic Python variants). This will be the bulk of the implementation. * Finally, any methods. Your instrument's user interface ================================ Your instrument will have a certain set of properties and methods that are available to a user and discoverable via the documentation or their editor's autocomplete function. In principle you are free to choose how you do this (with the exception of standard SCPI properties like :code:`id`). However, there are a couple of practices that have turned out to be useful to follow: * Naming things is important. Try to choose clear, expressive, unambiguous names for your instrument's elements. * If there are already similar instruments in the same "family" (like a power supply) in pymeasure, try to follow their lead where applicable. It's better if, e.g., all power supplies have a :code:`current_limit` instead of an assortment of :code:`current_max`, :code:`Ilim`, :code:`max_curr`, etc. * If there is already an instrument with a similar command set, check if you can inherit from that one and just tweak a couple of things. This massively reduces code duplication and maintenance effort. The section :ref:`instruments_with_similar_features` shows how to achieve that. * The bulk of your instrument's interface will probably be made up of properties for quantities to set and/or read out. Our custom properties (see :ref:`properties` ff. below) offer some convenience features and are therefore preferable, but plain Python properties are also fine. * "Actions", commands or verbs should typically be methods, not properties: :code:`recall()`, :code:`trigger_scan()`, :code:`prepare_resistance_measurement()`, etc. * This separation between properties and methods also naturally helps with observing the `"command-query separation" principle `__. * If your instrument has multiple identical channels, see :ref:`channels`. In principle, you are free to write any methods that are necessary for interacting with the instrument. When doing so, make sure to use the :code:`self.ask(command)`, :code:`self.write(command)`, and :code:`self.read()` methods to issue commands instead of calling the adapter directly. If the communication requires changes to the commands sent/received, you can override these methods in your instrument, for further information see :ref:`advanced_communication_protocols`. In practice, we have developed a number of best practices for making instruments easy to write and maintain. The following sections detail these, which are highly encouraged to follow. .. _common_instrument_types: Common instrument types *********************** There are a number of categories that many instruments fit into. In the future, pymeasure should gain an abstraction layer based on that, see `this issue `__. Until that is ready, here are a couple of guidelines towards a more uniform API. Note that not all already available instruments follow these, but expect this to be harmonized in the future. Generic types mixins -------------------- The :doc:`generic_types <../../api/instruments/generic_types>` module contains mixin classes for common types. For example, if an instrument complies to SCPI standards, you can add :class:`~pymeasure.instruments.generic_types.SCPIMixin` to your instrument: .. testcode:: from pymeasure.instruments.generic_types import SCPIMixin class SomeSCPIInstrument(SCPIMixin, Instrument): """This instrument has properties and methods defined for all SCPI instruments""" This mixin adds default SCPI properties like :attr:`~pymeasure.instruments.generic_types.SCPIMixin.id`, :attr:`~pymeasure.instruments.generic_types.SCPIMixin.status` and default methods like :meth:`~pymeasure.instruments.generic_types.SCPIMixin.clear` and :meth:`~pymeasure.instruments.generic_types.SCPIMixin.reset` to :code:`SomeSCPIInstrument`. You can check whether your instrument can safely inherit from :class:`~pymeasure.instruments.generic_types.SCPIMixin` by running :code:`pytest -k scpi_mixin --device-address ""`. Frequent properties ------------------- If your instrument has an **output** that can be switched on and off, use a :ref:`boolean property ` called :code:`output_enabled`. Power supplies -------------- PSUs typically can measure the *actual* current and voltage, as well as have settings for the voltage level and the current limit. To keep naming clear and avoid confusion, implement the properties :code:`current`, :code:`voltage`, :code:`voltage_setpoint` and :code:`current_limit`, respectively. Managing status codes or other indicator values *********************************************** Often, an instrument features one or more collections of specific values that signal some status, an instrument mode or a number of possible configuration values. Typically, these are collected in mappings of some sort, as you want to provide a clear and understandable value to the user, while abstracting away the raw data, think :code:`ACQUISITION_MODE` instead of :code:`0x04`. The mappings normally are kept at module level (i.e. not defined within the instrument class), so that they are available when using the property factories. This is a small drawback of using Python class attributes. The easiest way to handle these mappings is a plain :code:`dict`. However, there is often a better way, the Python :code:`enum.Enum`. To cite the `Python documentation `__, An Enum is a set of symbolic names bound to unique values. They are similar to global variables, but they offer a more useful :code:`repr()`, grouping, type-safety, and a few other features. As our signal values are often integers, the most appropriate enum types are :code:`IntEnum` and :code:`IntFlag`. :code:`IntEnum` is the same as :code:`Enum`, but its members are also integers and can be used anywhere that an integer can be used (so their use for composing commands is transparent), but logic/code they appear in is much more legible. Note that starting from Python version 3.11, the printed format of the :code:`IntEnum` and :code:`IntFlag` has been changed to return numeric value; however, the symbolic name can be obtained by printing its :code:`repr` or the :code:`.name` property, or returning the value in a REPL. .. doctest:: >>> from enum import IntEnum >>> class InstrMode(IntEnum): ... WAITING = 0x00 ... HEATING = 0x01 ... COOLING = 0x05 ... >>> received_from_device = 0x01 >>> current_mode = InstrMode(received_from_device) >>> if current_mode == InstrMode.WAITING: ... print('Idle') ... else: ... current_mode ... print(repr(current_mode)) ... print(f'Mode value: {current_mode}') ... Mode value: 1 :code:`IntFlag` has the added benefit that it supports bitwise operators and combinations, and as such is a good fit for status bitmasks or error codes that can represent multiple values: .. doctest:: >>> from enum import IntFlag >>> class ErrorCode(IntFlag): ... TEMP_OUT_OF_RANGE = 8 ... TEMPSENSOR_FAILURE = 4 ... COOLER_FAILURE = 2 ... HEATER_FAILURE = 1 ... OK = 0 ... >>> received_from_device = 7 >>> ErrorCode(received_from_device) :code:`IntFlags` are used by many instruments for the purpose just demonstrated. The status property could look like this: .. testcode:: status = Instrument.measurement( "STB?", """Measure the status of the device as enum.""", get_process=lambda v: ErrorCode(v), ) .. _default_connection_settings: Defining default connection settings ==================================== When implementing instruments, it's sometimes necessary to define default connection settings. This might be because an instrument connection requires *specific non-default settings*, or because your instrument actually supports *multiple interfaces*. The :py:class:`~pymeasure.adapters.VISAAdapter` class offers a flexible way of dealing with connection settings fully within the initializer of your instrument. Single interface **************** The simplest version, suitable when the instrument connection needs default settings, just passes all keywords through to the ``Instrument`` initializer, which hands them over to :py:class:`~pymeasure.adapters.VISAAdapter` if ``adapter`` is a string or integer. .. code-block:: python def __init__(self, adapter, name="Extreme 5000", **kwargs): super().__init__( adapter, name, **kwargs ) If you want to set defaults that should be prominently visible to the user and may be overridden, place them in the signature. This is suitable when the instrument has one type of interface, or any defaults are valid for all interface types, see the documentation in :py:class:`~pymeasure.adapters.VISAAdapter` for details. .. code-block:: python def __init__(self, adapter, name="Extreme 5000", baud_rate=2400, **kwargs): super().__init__( adapter, name, baud_rate=baud_rate, **kwargs ) If you want to set defaults, but they don't need to be prominently exposed for replacement, use this pattern, which sets the value only when there is no entry in ``kwargs``, yet. .. code-block:: python def __init__(self, adapter, name="Extreme 5000", **kwargs): kwargs.setdefault('timeout', 1500) super().__init__( adapter, name, **kwargs ) Multiple interfaces ******************* Now, if you have instruments with multiple interfaces (e.g. serial, TCPI/IP, USB), things get interesting. You might have settings common to all interfaces (like ``timeout``), but also settings that are only valid for one interface type, but not others. The trick is to add keyword arguments that name the interface type, like ``asrl`` or ``gpib``, below (see `here `__ for the full list). These then contain a *dictionary* with the settings specific to the respective interface: .. code-block:: python def __init__(self, adapter, name="Extreme 5000", baud_rate=2400, **kwargs): kwargs.setdefault('timeout', 1500) super().__init__( adapter, name, gpib=dict(enable_repeat_addressing=False, read_termination='\r'), asrl={'baud_rate': baud_rate, 'read_termination': '\r\n'}, **kwargs ) When the instrument instance is created, the interface-specific settings for the actual interface being used get merged with ``**kwargs`` before passing them on to PyVISA, the rest is discarded. This way, we always pass on a valid set of arguments. In addition, any entries in ``**kwargs**`` take precedence, so if they need to, it is *still* possible for users to override any defaults you set in the instrument definition. For many instruments, the simple way presented first is enough, but in case you have a more complex arrangement to implement, see whether :ref:`advanced_communication_protocols` fits your bill. If, for some exotic reason, you need a special connection type, which you cannot model with PyVISA, you can write your own Adapter. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/properties.rst0000644000175100017510000005663015203313266023626 0ustar00runnerrunner.. _properties: Writing properties ================== In PyMeasure, `Python properties`_ are the preferred method for dealing with variables that are read or set. .. testsetup:: # Behind the scene, replace Instrument with FakeInstrument to enable # doctesting simple usage cases (default doctest group) from pymeasure.instruments.fakes import FakeInstrument as Instrument class Extreme5000(Instrument): def __init__(self, adapter, name="Test", **kwargs): super().__init__(adapter, name, **kwargs) The property factories ********************** PyMeasure comes with three central convenience factory functions for making properties for classes: :func:`CommonBase.control `, :func:`CommonBase.measurement `, and :func:`CommonBase.setting `. You can call them, however, as :code:`Instrument.control`, :code:`Instrument.measurement`, and :code:`Instrument.setting`. The :func:`Instrument.measurement ` function returns a property that can only read values from an instrument. For example, if our "Extreme 5000" has the :code:`:TEMP?` command, we can write the following property to be added after the :code:`def __init__` line in our above example class, or added to the class after the fact as in the code here: .. _Python properties: https://docs.python.org/3/howto/descriptor.html#properties .. testcode:: Extreme5000.cell_temp = Instrument.measurement( ":TEMP?", """Measure the temperature of the reaction cell.""", ) .. testcode:: :hide: # We have to fake this silently because the FakeInstrument cannot do # a measurement property, it only mirrors values that you sent first. Extreme5000.cell_temp = 127.2 You will notice that a documentation string is required, see :ref:`docstrings` for details. When we use this property we will get the temperature of the reaction cell. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.cell_temp # Sends ":TEMP?" to the device 127.2 The :func:`Instrument.control ` function extends this behavior by creating a property that you can read and set. For example, if our "Extreme 5000" has the :code:`:VOLT?` and :code:`:VOLT ` commands that are in Volts, we can write the following property. .. testcode:: Extreme5000.voltage = Instrument.control( ":VOLT?", ":VOLT %g", """Control the voltage in Volts (float).""" ) You will notice that we use the `Python string format`_ :code:`%g` to format passed-through values as floating point. .. _Python string format: https://docs.python.org/3/library/string.html#format-specification-mini-language We can use this property to set the voltage to 100 mV, which will send the appropriate command, and then to request the current voltage: .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 0.1 # Sends ":VOLT 0.1" to set the voltage to 100 mV >>> extreme.voltage # Sends ":VOLT?" to query for the current value 0.1 Finally, the :func:`Instrument.setting ` function can only set, but not read values. Using the :func:`Instrument.control `, :func:`Instrument.measurement `, and :func:`Instrument.setting ` functions, you can create a number of properties for basic measurements and controls. The next sections detail additional features of the property factories. These allow you to write properties that cover specific ranges, or that have to map between a real value to one used in the command. Furthermore it is shown how to perform more complex processing of return values from your device. .. _validators: Restricting values with validators ********************************** Many GPIB/SCPI commands are more restrictive than our basic examples above. The :func:`Instrument.control ` function has the ability to encode these restrictions using :mod:`validators `. A validator is a function that takes a value and a set of values, and returns a valid value or raises an exception. There are a number of pre-defined validators in :mod:`pymeasure.instruments.validators` that should cover most situations. We will cover the four basic types here. In the examples below we assume you have imported the validators. .. testcode:: :hide: from pymeasure.instruments.validators import strict_discrete_set, strict_range, truncated_range, truncated_discrete_set In many situations you will also need to process the return string in order to extract the wanted quantity or process a value before sending it to the device. The :func:`Instrument.control `, :func:`Instrument.measurement ` and :func:`Instrument.setting ` functions also provide means to achieve this. In a restricted range --------------------- If you have a property with a restricted range, you can use the :func:`strict_range ` and :func:`truncated_range ` functions. For example, if our "Extreme 5000" can only support voltages from -1 V to 1 V, we can modify our previous example to use a strict validator over this range. .. testcode:: Extreme5000.voltage = Instrument.control( ":VOLT?", ":VOLT %g", """Control the voltage in Volts (float strictly from -1 to 1).""", validator=strict_range, values=[-1, 1] ) Now our voltage will raise a ValueError if the value is out of the range. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 100 Traceback (most recent call last): ... ValueError: Value of 100 is not in range [-1,1] This is useful if you want to alert the programmer that they are using an invalid value. However, sometimes it can be nicer to truncate the value to be within the range. .. testcode:: Extreme5000.voltage = Instrument.control( ":VOLT?", ":VOLT %g", """Control the voltage in Volts (float from -1 to 1). Invalid voltages are truncated. """, validator=truncated_range, values=[-1, 1] ) Now our voltage will not raise an error, and will truncate the value to the range bounds. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 100 # Executes ":VOLT 1" >>> extreme.voltage 1.0 In a discrete set ----------------- Often a control property should only take a few discrete values. You can use the :func:`strict_discrete_set ` and :func:`truncated_discrete_set ` functions to handle these situations. The strict version raises an error if the value is not in the set, as in the range examples above. For example, if our "Extreme 5000" has a :code:`:RANG ` command that sets the voltage range that can take values of 10 mV, 100 mV, and 1 V in Volts, then we can write a control as follows. .. testcode:: Extreme5000.voltage = Instrument.control( ":RANG?", ":RANG %g", """Control the voltage range in Volts (float in 10e-3, 100e-3, 1).""", validator=truncated_discrete_set, values=[10e-3, 100e-3, 1] ) Now we can set the voltage range, which will automatically truncate to an appropriate value. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 0.08 >>> extreme.voltage 0.1 Mapping values ************** Now that you are familiar with the validators, you can additionally use maps to satisfy instruments which require non-physical values. The :code:`map_values` argument of :func:`Instrument.control ` enables this feature. If your set of values is a list, then the command will use the index of the list. For example, if our "Extreme 5000" instead has a :code:`:RANG `, where 0, 1, and 2 correspond to 10 mV, 100 mV, and 1 V, then we can use the following control. .. testcode:: Extreme5000.voltage = Instrument.control( ":RANG?", ":RANG %d", """Control the voltage range in Volts (float in 10 mV, 100 mV and 1 V). """, validator=truncated_discrete_set, values=[10e-3, 100e-3, 1], map_values=True ) Now the actual GPIB/SCIP command is ":RANG 1" for a value of 100 mV, since the index of 100 mV in the values list is 1. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 100e-3 >>> extreme.read() '1' >>> extreme.voltage = 1 >>> extreme.voltage 1 Dictionaries provide a more flexible method for mapping between real-values and those required by the instrument. If instead the :code:`:RANG ` took 1, 2, and 3 to correspond to 10 mV, 100 mV, and 1 V, then we can replace our previous control with the following. .. testcode:: Extreme5000.voltage = Instrument.control( ":RANG?", ":RANG %d", """Control the voltage range in Volts (float in 10 mV, 100 mV and 1 V). """, validator=truncated_discrete_set, values={10e-3:1, 100e-3:2, 1:3}, map_values=True ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.voltage = 10e-3 >>> extreme.read() '1' >>> extreme.voltage = 100e-3 >>> extreme.voltage 0.1 The dictionary now maps the keys to specific values. The values and keys can be any type, so this can support properties that use strings: .. testcode:: Extreme5000.channel = Instrument.control( ":CHAN?", ":CHAN %d", """Control the measurement channel (string strictly in 'X', 'Y', 'Z').""", validator=strict_discrete_set, values={'X':1, 'Y':2, 'Z':3}, map_values=True ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.channel = 'X' >>> extreme.read() '1' >>> extreme.channel = 'Y' >>> extreme.channel 'Y' As you have seen, the :func:`Instrument.control ` function can be significantly extended by using validators and maps. .. _boolean-properties: Boolean properties ****************** The idea of using maps can be leveraged to implement properties where the user-facing values are booleans, so you can interact in a pythonic way using :code:`True` and :code:`False`: .. testcode:: Extreme5000.output_enabled = Instrument.control( "OUTP?", "OUTP %d", """Control the instrument output is enabled (boolean).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, # the dict values could also be "on" and "off", etc. depending on the device ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.output_enabled = True >>> extreme.read() '1' >>> extreme.output_enabled = False >>> extreme.output_enabled False >>> # Invalid input raises an exception >>> extreme.output_enabled = 34 Traceback (most recent call last): ... ValueError: Value of 34 is not in the discrete set {True: 1, False: 0} Good names for boolean properties are chosen such that they could also be a yes/no question: "Is the output enabled?" -> :code:`output_enabled`, :code:`display_active`, etc. Processing of set values ************************ The :func:`Instrument.control `, and :func:`Instrument.setting ` allow a keyword argument `set_process` which must be a function that takes a value after validation and performs processing before value mapping. This function must return the processed value. This can be typically used for unit conversions as in the following example: .. testcode:: Extreme5000.current = Instrument.setting( ":CURR %g", """Set the measurement current in A (float strictly from 0 to 10).""", validator=strict_range, values=[0, 10], set_process=lambda v: 1e3*v, # convert current to mA ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.current = 1 # set current to 1000 mA Processing of return values *************************** Similar to `set_process` the :func:`Instrument.control `, and :func:`Instrument.measurement ` functions allow a `get_process` argument which if specified must be a function that takes a value and performs processing before value mapping. The function must return the processed value. In analogy to the example above this can be used for example for unit conversion: .. testcode:: Extreme5000.current = Instrument.control( ":CURR?", ":CURR %g", """Control the measurement current in A (float strictly from 0 to 10).""", validator=strict_range, values=[0, 10], set_process=lambda v: 1e3*v, # convert to mA get_process=lambda v: 1e-3*v, # convert to A ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.current = 3.1 >>> extreme.current 3.1 Another use-case of `set-process`, `get-process` is conversion from/to a :code:`pint.Quantity`. Modifying above example to set or return a quantity, we get: .. testcode:: from pymeasure.units import ureg Extreme5000.current = Instrument.control( ":CURR?", ":CURR %g", """Control the measurement current (float).""", set_process=lambda v: v.m_as(ureg.mA), # send the value as mA to the device get_process=lambda v: ureg.Quantity(v, ureg.mA), # convert to quantity ) .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.current = 3.1 * ureg.A >>> extreme.current.m_as(ureg.A) 3.1 .. note:: This is, how quantities can be used in pymeasure instruments right now. `Issue 666 `_ develops a more convenient implementation of quantities in the property factories. `get_process` can also be used to perform string processing. Let's say your instrument returns a value with its unit (e.g. :code:`1.23 nF`), which has to be removed. This could be achieved by the following code: .. testcode:: Extreme5000.capacity = Instrument.measurement( ":CAP?", """Measure the capacity in nF (float).""", get_process=lambda v: float(v.replace('nF', '')) ) The same can be also achieved by the `preprocess_reply` keyword argument to :func:`Instrument.control ` or :func:`Instrument.measurement `. This function is forwarded to :func:`Adapter.values ` and runs directly after receiving the reply from the device. One can therefore take advantage of the built in casting abilities and simplify the code accordingly: .. testcode:: Extreme5000.capacity = Instrument.measurement( ":CAP?", """Measure the capacity in nF (float).""", preprocess_reply=lambda v: v.replace('nF', '') # notice how we don't need to cast to float anymore ) Checking the instrument for errors ********************************** If you need to separately ask your instrument about its error state after getting/setting, use the parameters :code:`check_get_errors` and :code:`check_set_errors` of :meth:`~pymeasure.instruments.common_base.CommonBase.control`, respectively. If those are enabled, the methods :meth:`~pymeasure.instruments.Instrument.check_get_errors` and :meth:`~pymeasure.instruments.Instrument.check_set_errors`, respectively, will be called after device communication has concluded. In the default implementation, for simplicity both methods call :meth:`~pymeasure.instruments.Instrument.check_errors`. To read the automatic response of instruments that respond to every set command with an acknowledgment or error, override :meth:`~pymeasure.instruments.Instrument.check_set_errors` as needed. Using multiple values ********************* Seldomly, you might need to send/receive multiple values in one command. The :func:`Instrument.control ` function can be used with multiple values at one time, passed as a tuple. Say, we may set voltages and frequencies in our "Extreme 5000", and the commands for this are :code:`:VOLTFREQ?` and :code:`:VOLTFREQ ,`, we could use the following property: .. testcode:: Extreme5000.combination = Instrument.control( ":VOLTFREQ?", ":VOLTFREQ %g,%g", """Simultaneously control the voltage in Volts and the frequency in Hertz (both float). This property is set by a tuple. """ ) In use, we could set the voltage to 200 mV, and the Frequency to 931 Hz, and read both values immediately afterwards. .. doctest:: >>> extreme = Extreme5000("GPIB::1") >>> extreme.combination = (0.2, 931) # Executes ":VOLTFREQ 0.2,931" >>> extreme.combination # Reads ":VOLTFREQ?" [0.2, 931.0] This interface is not too convenient, but luckily not often needed. Dynamic properties ****************** As described in previous sections, Python properties are a very powerful tool to easily code an instrument's programming interface. One very interesting feature provided in PyMeasure is the ability to adjust properties' behaviour in subclasses or dynamically in instances. This feature allows accommodating some interesting use cases with a very compact syntax. Dynamic features of a property are enabled by setting its :code:`dynamic` parameter to :code:`True`. Afterwards, creating specifically-named attributes (either in class definitions or on instances) allows modifying the parameters used at the time of property definition. You need to define an attribute whose name is `_` and assign to it the desired value. Pay attention *not* to inadvertently define other class attribute or instance attribute names matching this pattern, since they could unintentionally modify the property behaviour. .. note:: To clearly distinguish these special attributes from normal class/instance attributes, they can only be set, not read. The mechanism works for all the parameters in properties, except :code:`dynamic` and :code:`docs` -- see :func:`Instrument.control `, :func:`Instrument.measurement `, :func:`Instrument.setting `. Dynamic validity range ---------------------- Let's assume we have an instrument with a command that accepts a different valid range of values depending on its current state. The code below shows how this can be accomplished with dynamic properties. .. testcode:: Extreme5000.voltage = Instrument.control( ":VOLT?", ":VOLT %g", """Control the voltage in Volts (float).""", validator=strict_range, values=[-1, 1], dynamic = True, ) def set_bipolar_mode(self, enabled = True): """Safely switch between bipolar/unipolar mode.""" # some code to switch off the output first # ... if enabled: self.mode = "BIPOLAR" # set valid range of "voltage" property self.voltage_values = [-1, 1] else: self.mode = "UNIPOLAR" # note the "propertyname_parametername" form of the attribute self.voltage_values = [0, 1] Now our voltage property has a dynamic validity range, either [-1, 1] or [0, 1]. A side effect of this is that the property's docstring should be less specific, to avoid it containing dynamically changed information (like the admissible value range). In this example, the property name was :code:`voltage` and the parameter to adjust was :code:`values`, so we used :code:`self.voltage_values` to set our desired values. .. _instruments_with_similar_features: Instruments with similar features ================================= When instruments have a similar set of features, it makes sense to use inheritance to obtain most of the functionality from a parent instrument class, instead of copy-pasting code. .. note:: Don't forget to update the instrument's :code:`name` attribute accordingly, by either supplying an appropriate argument (if available) during the :code:`super().__init__()` call, or by setting it anew below that call. In some cases, one only needs to add additional properties and methods. In other cases, some of the already present properties/methods need to be completely replaced by defining them again in the derived class. Often, however, only some details need to be changed. This can be dealt with efficiently using dynamic properties. Instrument family with different parameter values ************************************************* A common case is to have a family of similar instruments with some parameter range different for each family member. In this case you would update the specific class parameter range without rewriting the entire property: .. testcode:: :hide: # Behind the scene, load the real Instrument from pymeasure.instruments import Instrument from pymeasure.test import expected_protocol .. testcode:: class FictionalInstrumentFamily(Instrument): frequency = Instrument.setting( "FREQ %g", """Set the frequency (float).""", validator=strict_range, values=[0, 1e9], dynamic=True, # ... other possible parameters follow ) # # ... complete class implementation here # class FictionalInstrument_1GHz(FictionalInstrumentFamily): pass class FictionalInstrument_3GHz(FictionalInstrumentFamily): frequency_values = [0, 3e9] class FictionalInstrument_9GHz(FictionalInstrumentFamily): frequency_values = [0, 9e9] .. testcode:: :hide: with expected_protocol(FictionalInstrument_9GHz, [("FREQ 5e+09", None)], name="Test") as inst: inst.frequency = 5e9 Notice how easily you can derive the different family members from a common class, and the fact that the attribute is now defined at class level and not at instance level. Instruments with similar command syntax *************************************** Another use case involves maintaining compatibility between instruments with commands having different syntax, like in the following example. .. code-block:: python class MultimeterA(Instrument): voltage = Instrument.measurement(get_command="VOLT?",...) # ...full class definition code here class MultimeterB(MultimeterA): # Same as brand A multimeter, but the command to read voltage # is slightly different voltage_get_command = "VOLTAGE?" In the above example, :code:`MultimeterA` and :code:`MultimeterB` use a different command to read the voltage, but the rest of the behaviour is identical. :code:`MultimeterB` can be defined subclassing :code:`MultimeterA` and just implementing the difference. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/solutions.rst0000644000175100017510000000355615203313266023470 0ustar00runnerrunner.. _solutions: Solutions for implementation challenges ======================================= This is a list of less common challenges, their solutions, and example instruments. General issues ************** - Small numbers (<1e-5) are shown as 0 with :code:`%f`. If an instrument understands exponential notation, you can use :code:`%g`, which switches between floating point and exponential format, depending on the exponent. Communication protocol issues ***************************** - The instrument answers every message, even a setting command. You can set the setting's :code:`check_set_errors = True` parameter and redefine :func:`check_set_errors` to read an answer, see :class:`hcp.TC038D ` - Binary, frame-based communication, see :class:`hcp.TC038D ` - All replies have the same length, see :class:`aja.DCXS ` - The device generates garbage messages at startup, cluttering the buffer, see :class:`aja.DCXS ` - An instrument and its channel need to override `values`, but it has to use the correct `ask` method as well, see :class:`tcpowerconversion.CXN ` Channels ******** - Not all channels have the same features, see :class:`MKS937B ` - Channel names in the communication (1, 2, 3) differ from front panel (A, B, C), see :class:`AdvantestR624X ` - A family of instruments in which a property of the channels is different for different members of the family , see :class:`AnritsuMS464xB ` - If you want to document the type of your instrument's channels (with a clickable link), check out the source of the :ref:`aimtti-landing-page` page. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/adding_instruments/tests.rst0000644000175100017510000002504115203313266022564 0ustar00runnerrunner.. _tests: Writing tests ============= Tests are very useful for writing good code. We have a number of tests checking the correctness of the pymeasure implementation. Those tests (located in the :code:`tests` directory) are run automatically on our CI server, but you can also run them locally using :code:`pytest`. When adding instruments, your primary concern will be tests for the *instrument driver* you implement. We distinguish two groups of tests for instruments: the first group does not rely on a connected instrument. These tests verify that the implemented instrument driver exchanges the correct messages with a device (for example according to a device manual). We call those "protocol tests". The second group tests the code with a device connected. Implement device tests by adding files in the :code:`tests/instruments/...` directory tree, mirroring the structure of the instrument implementations. There are other instrument tests already available that can serve as inspiration. .. _protocol_tests: Protocol tests ************** In order to verify the expected working of the device code, it is good to test every part of the written code. The :func:`~pymeasure.test.expected_protocol` context manager (using a :class:`~pymeasure.adapters.ProtocolAdapter` internally) simulates the communication with a device and verifies that the sent/received messages triggered by the code inside the :code:`with` statement match the expectation. .. code-block:: python import pytest from pymeasure.test import expected_protocol from pymeasure.instruments.extreme5000 import Extreme5000 def test_voltage(): """Verify the communication of the voltage getter.""" with expected_protocol( Extreme5000, [(":VOLT 0.345", None), (":VOLT?", "0.3000")], ) as inst: inst.voltage = 0.345 assert inst.voltage == 0.3 In the above example, the imports import the pytest package, the expected_protocol and the instrument class to be tested. The first parameter, Extreme5000, is the class to be tested. When setting the voltage, the driver sends a message (:code:`":VOLT 0.345"`), but does not expect a response (:code:`None`). Getting the voltage sends a query (:code:`":VOLT?"`) and expects a string response (:code:`"0.3000"`). Therefore, we expect two pairs of send/receive exchange. The list of those pairs is the second argument, the expected message protocol. The context manager returns an instance of the class (:code:`inst`), which is then used to trigger the behaviour corresponding to the message protocol (e.g. by using its properties). If the communication of the driver does not correspond to the expected messages, an Exception is raised. .. note:: The expected messages are **without** the termination characters, as they depend on the connection type and are handled by the normal adapter (e.g. :class:`VISAAdapter`). Some protocol tests in the test suite can serve as examples: * Testing a simple instrument: :code:`tests/instruments/keithley/test_keithley2000.py` * Testing a multi-channel instrument: :code:`tests/instruments/tektronix/test_afg3152.py` * Testing instruments using frame-based communication: :code:`tests/instruments/hcp/tc038.py` Test generator -------------- In order to facilitate writing tests, if you already have working code and a device at hand, we have a :class:`~pymeasure.generator.Generator` for tests. You can control your instrument with the TestGenerator as a middle man. It logs the method calls, the device communication and the return values, if any, and writes tests according to these log entries. .. testsetup:: generator import io from pymeasure.adapters.protocol import ProtocolAdapter adapter = ProtocolAdapter(comm_pairs=[ (b'\x0201010WRS01D0002\x03', b'\x020101OK\x03'), # init (b'\x0201010INF6\x03', b'\x020101OKUT150333 V01.R001111222233334444\x03'), # info (b'\x0201010WWRD0120,01,00C8\x03', b'\x020101OK\x03'), # setpoint = 20 (b'\x0201010WRDD0120,01\x03', b'\x020101OK00C8\x03'), # setpoint == 20 (b'\x0201010WWRD0120,01,0258\x03', b'\x020101OK\x03'), # setpoint = 60 ]) class FakeIO(io.StringIO): def close(self): pass def really_close(self): super().close() file = FakeIO() .. testcode:: generator from pymeasure.generator import Generator from pymeasure.instruments.hcp import TC038 generator = Generator() inst = generator.instantiate(TC038, adapter, 'hcp', adapter_kwargs={'baud_rate': 9600}) As a first step, this code imports the Generator and generates a middle man instrument. The :meth:`instantiate` method creates an instrument instance and logs the communication at startup. The Generator creates a special adapter for the communication with the device. It cannot inspect the instrument's :meth:`__init__`, however. Therefore you have to specify the **all** connection settings via the :code:`adapter_kwargs` dictionary, even those, which are defined in :meth:`__init__`. These adapter arguments are not written to tests. If you have arguments for the instrument itself, e.g. a RS485 address, you may give it as a keyword argument. These additional keyword arguments are included in the tests. Now we can use :code:`inst` as if it were created the normal way, i.e. :code:`inst = TC038(adapter)`, where ``adapter`` is some resource string. Having gotten and set some properties, and called some methods, we can write the tests to a file. .. testcode:: generator inst.information # returns the 'information' property, e.g. 'UT150333 V01.R001111222233334444' inst.setpoint = 20 assert inst.setpoint == 20 inst.setpoint = 60 generator.write_file(file) The following data will be written to :code:`file`: .. testcode:: generator :hide: print(file.getvalue()[:-1]) # to strip the last newline char. file.really_close() .. testoutput:: generator import pytest from pymeasure.test import expected_protocol from pymeasure.instruments.hcp import TC038 def test_init(): with expected_protocol( TC038, [(b'\x0201010WRS01D0002\x03', b'\x020101OK\x03')], ): pass # Verify the expected communication. def test_information_getter(): with expected_protocol( TC038, [(b'\x0201010WRS01D0002\x03', b'\x020101OK\x03'), (b'\x0201010INF6\x03', b'\x020101OKUT150333 V01.R001111222233334444\x03')], ) as inst: assert inst.information == 'UT150333 V01.R001111222233334444' @pytest.mark.parametrize("comm_pairs, value", ( ([(b'\x0201010WRS01D0002\x03', b'\x020101OK\x03'), (b'\x0201010WWRD0120,01,00C8\x03', b'\x020101OK\x03')], 20), ([(b'\x0201010WRS01D0002\x03', b'\x020101OK\x03'), (b'\x0201010WWRD0120,01,0258\x03', b'\x020101OK\x03')], 60), )) def test_setpoint_setter(comm_pairs, value): with expected_protocol( TC038, comm_pairs, ) as inst: inst.setpoint = value def test_setpoint_getter(): with expected_protocol( TC038, [(b'\x0201010WRS01D0002\x03', b'\x020101OK\x03'), (b'\x0201010WRDD0120,01\x03', b'\x020101OK00C8\x03')], ) as inst: assert inst.setpoint == 20.0 .. _device_tests: Device tests ************ It can be useful as well to test the code against an actual device. The necessary device setup instructions (for example: connect a probe to the test output) should be written in the header of the test file or test methods. There should be the connection configuration (for example serial port), too. In order to distinguish the test module from protocol tests, the filename should be :code:`test_instrumentName_with_device.py`, if the device is called :code:`instrumentName`. To make it easier for others to run these tests using their own instruments, we recommend to use :code:`pytest.fixture` to create an instance of the instrument class. It is important to use the specific argument name :code:`connected_device_address` and define the scope of the fixture to only establish a single connection to the device. This ensures two things: First, it makes it possible to specify the address of the device to be used for the test using the :code:`--device-address` command line argument. Second, tests using this fixture, i.e. tests that rely on a device to be connected to the computer are skipped by default when running pytest. This is done to avoid that tests that require a device are run when none is connected. It is important that all tests that require a connection to a device either use the :code:`connected_device_address` fixture or a fixture derived from it as an argument. A simple example of a fixture that returns a connected instrument instance looks like this: .. code-block:: python @pytest.fixture(scope="module") def extreme5000(connected_device_address): instr = Extreme5000(connected_device_address) # ensure the device is in a defined state, e.g. by resetting it. return instr Note that this fixture uses :code:`connected_device_address` as an input argument and will thus be skipped by automatic test runs. This fixture can then be used in a test functions like this: .. code-block:: python def test_voltage(extreme5000): extreme5000.voltage = 0.345 assert extreme5000.voltage == 0.3 Again, by specifying the fixture's name, in this case :code:`extreme5000`, invoking :code:`pytest` will skip these tests by default. It is also possible to define derived fixtures, for example to put the device into a specific state. Such a fixture would look like this: .. code-block:: python @pytest.fixture def auto_scaled_extreme5000(extreme5000): extreme5000.auto_scale() return extreme5000 In this case, do not specify the fixture's scope, so it is called again for every test function using it. To run the test, specify the address of the device to be used via the :code:`--device-address` command line argument and limit pytest to the relevant tests. You can filter tests with the :code:`-k` option or you can specify the filename. For example, if your tests are in a file called :code:`test_extreme5000_with_device.py`, invoke pytest with :code:`pytest -k extreme5000 --device-address "TCPIP::192.168.0.123::INSTR"`. There might also be tests where manual intervention is necessary. In this case, skip the test by prepending the test function with a :code:`@pytest.mark.skip(reason="A human needs to press a button.")` decorator. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/coding_standards.rst0000644000175100017510000001040115203313266021021 0ustar00runnerrunner################ Coding Standards ################ In order to maintain consistency across the different instruments in the PyMeasure repository, we enforce the following standards. Python style guides =================== The `PEP8 style guide`_ and `PEP257 docstring conventions`_ should be followed. .. _PEP8 style guide: https://www.python.org/dev/peps/pep-0008/ .. _PEP257 docstring conventions: https://www.python.org/dev/peps/pep-0257/ Function and variable names should be lower case with underscores as needed to separate words. CamelCase should only be used for class names, unless working with Qt, where its use is common. In addition, there is a configuration for the `flake8`_ linter present. Our codebase should not trigger any warnings. Many editors/IDEs can run this tool in the background while you work, showing results inline. Alternatively, you can run ``flake8`` in the repository root to check for problems. In addition, our automation on Github also runs some checkers. As this results in a much slower feedback loop for you, it's not recommended to rely only on this. .. _flake8: https://flake8.pycqa.org/en/latest/ It is allowed but not required to use the `black`_ code formatter. To avoid introducing unrelated changes when working on an existing file, it is recommended to use the `darker`_ tool instead of `black`. This helps to keep the focus on the implementation instead of unrelated formatting, and thereby facilitates code reviews. :code:`darker` is compatible with :code:`black`, but only formats regions that show as changed in Git. If there are conflicts between :code:`black`/:code:`darker`'s output and flake8 (especially related to `E203`_), flake8 takes precedence. Use ``#noqa : E203`` to disable E203 warnings for a specific line if appropriate. .. _black: https://black.readthedocs.io/en/stable/ .. _darker: https://github.com/akaihola/darker .. _E203: https://www.flake8rules.com/rules/E203.html You may add type hints as you see fit. All type hints should adhere to the guidelines set out in the `typing`_ package. .. _typing: https://docs.python.org/3/library/typing.html Documentation ============= PyMeasure documents code using reStructuredText and the `Sphinx documentation generator`_. All functions, classes, and methods should be documented in the code using a docstring, see section :ref:`docstrings`. .. _Sphinx documentation generator: http://www.sphinx-doc.org/en/stable/ Usage of getter and setter functions ==================================== Getter and setter functions are discouraged, since properties provide a more fluid experience. Given the extensive tools available for defining properties, detailed in the sections starting with :ref:`properties`, these types of properties are preferred. .. _docstrings: Docstrings ========== Descriptive and specific docstrings for your properties and methods are important for your users to quickly glean important information about a property. It is advisable to follow the `PEP257 `_ docstring guidelines. Most importantly: * Use triple-quoted strings (:code:`"""`) to delimit docstrings. * One short summary line in imperative voice, with a period at the end. * Optionally, after a blank line, include more detailed information. * For functions and methods, you can add documentation on their parameters using the `reStructuredText docstring format `__. Specific to properties, start them with "Control", "Get", "Measure", or "Set" to indicate the kind of property, as it is not visible after import, whether a property is gettable ("Get" or "Measure", e.g. for a :meth:`measurement`), settable ("Set", for a :meth:`setting`), or both ("Control", for a :meth:`control`). In addition, it is useful to add type and information about :ref:`validators` (if applicable) at the end of the summary line, see the docstrings shown in examples throughout the :ref:`adding-instruments` section. For example a docstring could be :code:`"""Control the voltage in Volts (float strictly from -1 to 1)."""`. The docstring is for information that is relevant for *using* a property/method. Therefore, do *not* add information about internal/hidden details, like the format of commands exchanged with the device. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/contribute.rst0000644000175100017510000001465615203313266017711 0ustar00runnerrunner############ Contributing ############ Contributions to the instrument repository and the main code base are highly encouraged. This section outlines the basic work-flow for new contributors. Using the development version ============================= New features are added to the development version of PyMeasure, hosted on `GitHub`_. We use `Git version control`_ to track and manage changes to the source code. On Windows, we recommend using `GitHub Desktop`_. Make sure you have an appropriate version of Git (or GitHub Desktop) installed and that you have a GitHub account. .. _GitHub: https://github.com/ .. _Git version control: https://git-scm.com/ .. _GitHub Desktop: https://git-scm.com/downloads Make sure :code:`git --version` works from comand line. If you are using Github Desktop, you may need to add Git to your path in each terminal window. On windows anaconda prompt it would be :code:`set PATH="C:\Users\\AppData\Local\GitHubDesktop\app-<#######>\resources\app\git\cmd";%PATH%` In order to add your feature, you need to first `fork`_ PyMeasure. This will create a copy of the repository under your GitHub account. .. _fork: https://help.github.com/articles/fork-a-repo/ The instructions below assume that you have set up Anaconda, as described in the :doc:`Quick Start guide <../quick_start>` and describe the terminal commands necessary. If you are using GitHub Desktop, take a look through `their documentation`_ to understand the corresponding steps. .. _their documentation: https://help.github.com/desktop/ Clone your fork of PyMeasure :code:`your-github-username/pymeasure`. In the following terminal commands replace your desired path and GitHub username. .. code-block:: bash cd /path/for/code git clone https://github.com/your-github-username/pymeasure.git If you had already installed PyMeasure using :code:`pip`, make sure to uninstall it before continuing. .. code-block:: bash pip uninstall pymeasure Install PyMeasure in the editable mode and select optional extras. .. code-block:: bash cd /path/for/code/pymeasure pip install -e .[tests,docs] The ``-e`` will allow you to edit the files of PyMeasure and see the changes reflected. The square brackets include extra groups that allow you to run tests and build the documentation locally. Make sure to reset your notebook kernel or Python console when doing so. Now you have your own copy of the development version of PyMeasure installed! Depending on your Python installation you may get an error messages saying that the file setup.py is missing or similar. Updating pip may solve the problem. .. code-block:: bash python -m pip install pip --upgrade Working on a new feature ======================== We use branches in Git to allow multiple features to be worked on simultaneously, without causing conflicts. The master branch contains the stable development version. Instead of working on the master branch, you will create your own branch off the master and merge it back into the master when you are finished. Create a new branch for your feature before editing the code. For example, if you want to add the new instrument "Extreme 5000" you will make a new branch "dev/extreme-5000". .. code-block:: bash git branch dev/extreme-5000 You can also `make a new branch`_ on GitHub. If you do so, you will have to fetch these changes before the branch will show up on your local computer. .. code-block:: bash git fetch .. _make a new branch: https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/ Once you have created the branch, change your current branch to match the new one. .. code-block:: bash git checkout dev/extreme-5000 Now you are ready to write your new feature and make changes to the code. To ensure consistency, please follow the :doc:`coding standards for PyMeasure `. Use :code:`git status` to check on the files that have been changed. As you go, commit your changes and push them to your fork. .. code-block:: bash git add file-that-changed.py git commit -m "A short description about what changed" git push Making a pull request ===================== While you are working, it is helpful to start a pull request (PR) targeting the :code:`master` branch of :code:`pymeasure/pymeasure`. This will allow you to discuss your feature with other contributors. We encourage you to start this pull request already after your first commit. You may mark a pull request as a draft, if it is in an early state. `Start a pull request`_ on the `PyMeasure GitHub page`_. .. _`Start a pull request`: https://help.github.com/articles/using-pull-requests/ .. _PyMeasure GitHub page: https://github.com/pymeasure/pymeasure There is some automation in place to run the unit tests and check some coding standards. Annotations in the "Files changed" tab indicate problems for you to correct (e.g. linting or docstring warnings). Your pull-request will be reviewed by the PyMeasure maintainers. Frequently there is some iteration and discussion based on that feedback until a pull request can be merged. This will happen either in the conversation tab or in inline code comments. Be aware that due to maintainer manpower limitations it might take a long time until PRs get reviewed and/or merged. In general, review effort scales badly with PR size. Therefore, **smaller PRs are much preferred**. Try to limit your contribution to one "aspect", e.g. one instrument (or a few if closely related), one bug fix, or one feature contribution. If you placed your contribution in a separate branch as suggested above, you can easily use your contribution in the meantime -- just check out your feature branch instead of `master`. Unit testing ============ Unit tests are run each time a new commit is made to a branch. The purpose is to catch changes that break the current functionality, by testing each feature unit. PyMeasure relies on `pytest`_ to preform these tests, which are run on TravisCI and Appveyor for Linux/macOS and Windows respectively. Running the unit tests while you develop is highly encouraged. This will ensure that you have a working contribution when you create a pull request. .. code-block:: bash pytest If your feature can be tested, unit tests are required. This will ensure that your features keep working as new features are added. .. _`pytest`: http://pytest.org/latest/ Now you are familiar with all the pieces of the PyMeasure development work-flow. We look forward to seeing your pull-request! ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/dev/reporting_errors.rst0000644000175100017510000000046515203313266021131 0ustar00runnerrunner################## Reporting an error ################## Please report all errors to the `Issues section`_ of the PyMeasure GitHub repository. Use the search function to determine if there is an existing or resolved issued before posting. .. _`Issues section`: https://github.com/pymeasure/pymeasure/issues ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9912944 pymeasure-0.16.0/docs/images/0000755000175100017510000000000015203313301015442 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/images/PyMeasure logo.png0000644000175100017510000002714715203313266021030 0ustar00runnerrunnerPNG  IHDR\rfsBIT|d pHYs btEXtSoftwarewww.inkscape.org< IDATxw]e{ιuztRi ]AQA+.]˲vwWtյ`YAT !gL$sOwܹ>2;oA!B!B!B!B!B!B!B!B!BB*UZ,ldT=PD+e*OB;kAP{!jKMqzt[\H{Z@__ q |GÇs+D;(uKYvm8yBL(Z-\;Umr6"_QCIOyn%+J?2 !&]CVs )s~R)'Y 1z~ĒR@c|t~2bӚ6e绑`^6NWq [}Wk=&v "g쎾:Z@kj7B c.kFPfBw5wD!Đf5sƒPz !Bx%wdOՅcQu7=!p?afmXTgC2!8{_Q&DxOM?mv:;Bd=}|po})Α#K4_{=9"sdtؾy?o_>h r$Df/H82[77< Y26Wy;_)M-!!2PFh$Ѱtw=8N9"3edOa#^~+6$?CBd -׵O߇:ɹ"3e\W+__Ȋ+U[J{>%!GBd Zk`Nm 2_@.c|_^5ٽsN]"#X@4B|K}å\tž4lbws[[hz9TQWYK}U5>/O[6$?ny.JBKG;+7allʆ-4n—R2NsN=E N#?'7Wl_y4sO_ȕ2'^1IWښ-yï0 <`Tl_*RGtTOӫѡiYsExw{jEO|V֮\we)c;׼s˗bj78~g`(l3 0Gmv kXa \}|=WR?mZZ^{-V'djb5O_ad65}6vFk W`ixki3>ڕHnAے_{W'<E(F(40RT !ݣюfƔ|9 R1mC_>ai`\yr"xkMgz ̷RW|Y[vnz'& ]|K'p{>;E1z-|;ZJ N31lcy#,ͶJ_wTgi~p@[ҟKyI8[}J8;?J%<-ɗ/NKG{5fi+Yreq͝M8[gb/ 7L=j ;ؽoݝ=4liyBZK|2`G۶{'/o x)9}#޼/TTeV`Iu-VHJ '3mϼ|.:չJX5K_bfSyo)f[(Cq`mR$qś%8VsV1s)&H̪HWṆ~ 8п6JBt-D(S=ձ knwO?|t-ڼYg@l7"D9D907B)OK{SDHI򛯒[_ sF#5nX>w#Kattw~?Y "^ZqL|A6tn;~Mg2=(]=Q ѱ'Vfk} ? 3g"bw VAOo/yc긐 jc6n|YQ5x?OS!:t gY00Vz`PTŊ9#F$zykTzʯ׫ &fh]`ي}=>fa١akʄw41rFEEAKPXZ$ uoP9}ľ6h\UBA[4vDY_'J?3<(M<<¨7Dڲo`c69w#^~0&ZYdgx>K~@k$jg ")[[ָ@o>͖8{<9|=7п9 w%oR`)zzYyCҞ3VDRMriڢ G XVl'{z'wO[x}M6 ")^]߲~Ho<˕g_ʹB4kǍqhtc)$iYz(/=(yn#w^©s{5k#`&`d+Xe]ڞ% @n{[[ o8R'm]VL]O2ȂNhJmf @n7_;R#|#j<'>>{ԔTa9o$4[0Xؐڌ Ap+(95#`DA>mTcO 6H]&!@*bj׍Ss|SWVз2ӓs{Δ<$^[p3|`g̅8x^i3iތaz)hؿ{q \ׁL8WmB.,k}^_Qش]6}+D_)PLKWU`8ig^){NȗXX?ϡc#D;I$4P4ߑw \g>4bd)_mt[}h0pXI^w] >{̬ͭӧ m:8h h oF{+6'!ڑ~NDxaRX/+4(ȁu .C/ќ sy_wwmeOq mQ;V.h~:>Ϫ .><>tho%%XE&^K1R8ֱu8މ,6+93S;f}s /YFxo^#[2J.m`ǚ9 …gSWVsҶ }MpEs[ 6EfbF²~/]zPDcAaP^UB?LKs[ɕp;sKk/pMQTSa4Q'3#ispcA_sUTfr yY9K4jcYs,%o5Bf; azZEaq~{Hxn3ko\:s |3RMftw& ˴8{=tioo-챉cM[{Y's)qRE=5vh/A9 &n^]SgYO?P3(wpL0 άeӺBQ?oFU=3ijٕ/1 'CAN ;ۮ{~M;9=!tu:? @ٓK'P4Ǥl`Yv@a`q}]7#Ub)l^Hdl r˸b%s`B*(\\w6c~hhE8&z 7.!2#>R0o5HR=ʡc`iXL?εN7귣Mu_CpAȿbwh&"@Xm3Y}6_3r @O #_3X&(Ŏ]|gr?=!Rc%V:s*mn֡޳18_ 9t˦nz5 [3O$;H㎣A?o}_mRD ð{5J) K|6>0)Ӫ my~Oj!51jXEOX;g/?[C Laq>EÖFK߅TH8m;ZKs 2RԶyOa31@CMiφj&'/YQ.|2<& bT^$0L߉G[d`0̞?)ӪS6-71 {$ւyhLUQŀ<ѵdJ=:E% Du;M!G=460<#}c``mzKDk8,>ӏG) Q:Rs Y$qo)''^"kB_@ǚCyAـݨ^LM-6cNeoVz颯kMx}SYSJG[ӝ̽ٴ"lvkytz}Qj[;_rö+vG5<yaPPǬyS=qܪZ&RkVmoIu͍-Yegҝ]3m=^OŌ깬֑Tq݅d$ صow|lޱ #̷mC{ح˜Y^M?eU=*0ȅH Zkz~c|f`)ʊu¦]6n`Ix8|:GP+@ÞF~e(oy`{>`!L0߉;^ҁI@AC3&jۘAwy*lE( ٌ*V!z2MN` Ó0I5iwO=#>A(FY 4 8g9AE_HzsZtO3QF$W,/K5oFYT&9?v&́q,DztڐMt&`|^/eUx&3϶(13?CӰ/I]X?s0 'H`hMkYqon\ޮ!g wCa3"m֜3!{An[[ضg'wlMkYi-ͭ-El)-f&^EmX!*"R}^J `$P?6s_#wa.ݍtvwm0O1"/ճL<5J4;~),~sͬU'IH>ڻ:ꢹ ͭ-oi@k3݃ޯ e`fA iUIs=5 ]j?q񰗚I0Kc%evhؽ5[6а:;iNڻ:DTA*#g+*K *qg.|sfG :[^Ԋ)̭~LVv d .8^`Ɋ޲nr fz5}nքz5B,0 ëП/QT+ l?~͆+h툽X4tT3IP8S/?/=+qc ˔!㎣ G&phB'** r3jQlKޢ̬x}v2!&! wO?o?ZP>Ġpɜ#|7 Cߧȋha;۶kAwC${MDl=bkB;mR\wF0 9gP$̃<įx)VWd0ʠؽ:ywfS&v'G; Ch^ ^*|^Fܾϡ9IkeC3gqߓ8,}u_@Tx+M<5ʧ(U̬54#5mG:>@-B, W1FQNwtlݮpNMO~Cצ/(Kr& 'C?gmlW:oMlWbŴ*im۟U$EkP^PI#G;|O?Uf~/̪5;Q(lDk_ iΞs:̍T]&_xzً(¿ *Jw~& obwhWq%Hޢym5_o)VA^0`sP6ΰLãߪ9T ﴉw p7I`kl2)I~Ѓ<¿ (L3X`ubx,6᝱Nc$tAQLII/3G 0 (fd4hs7qD 6^x\NTR^~ V=?Pz03 !=J!eZ7yp se$M>߿a;6f,'U1п9Jt+naNQ%UV0H̤ pA[gĠ`Zўtk s շPrsȒI3=o_m୳(W̚r|~w_276NXSSZWBIJ)j\Ρ8֤ oǿE?$?G1=J;"6Z񡋮crwRbwrMh}^vTp߉#KaR3N&46N︖14MӤԥLȳOfFlET-o0 IDATȡ^5K8piW֔ 3)@[g=3Ps3LCL)npc/re유Iw?@ 7#5E5&MxOl /4yrK KaWل{sOb]c% C^>jR192X G>_a;QθG;I92pBtl7z\pb.9B?Qaq>ťc3@e3Ҋg=pӅ5vnq9y;,.:<򳒳")iMߏ)5'[_kp4N&th1-N5sżqo5e2:,6^qG_x8^ݫqz5NőfԹ,:u ?W)E>K ҳ"!gqlQ'X׃,o d3YӘ]=q?psʴ*r yI jiTp~ӧ>0B'顼b ʨ,,cj* S7>毖]~SlG/ vdde{/Y ^KaN>y9fKQv>yiuRJ)i`@ĆU[$f '~PaԗPU\IYA edJ`/tcuӫ/}A~F"dhbkD`\M͜d'צi2mV-ٹc7a _ڰj3n҄lr@/٧RWV3>H 3jdO*V 74j5ĶBCq^!q1;sL3EYe 5i!b&lȮ01hNw$CNN [3 XN؄ YC8t pcsygr#ۥUs鮸)CEa&lѬٮipb_F5oug>5Lrܓ!&l4Ǟhb3Ʌ?[̪έ~T3̄ ǎh lZ;L5 e1x>*(,ɗ2Єvfjh ۓ<>i3~dBwU_+lˈۓgk\ȭM(.-(OVM6h`.oMU3O?N& ,yO06lޥiH8xMCyA)w\o{< 9ArsP .ꠒ"»m^d3 ;ϋ? +;(UIfdX TV֖e 4x,<^+k/$R:9o"Μuʸ<xiy, CI 0 уAMaN>=𑛗Mn~,?GoTV>w~J)(ʓ"$$( kΝsr%MTPBF:HIHݥdqc+(*ɧTzEJHH@h{lo+{zSU_8ENΩ.Su:J)J+.{r5b{\w>&㱨YKvSd& qvp4 簠~Ψ|L5r= #QMxws/U9AΚ"_#Dt9)e /_3 Ck"{ہ =?lIub@hc "7G^^A3t;?[Ouv\7@̛2}aPSWĜt+klG{?CcTg5:8HpEW'toqYl9 =R>|՛٤ ځQ|(,^4)*IbD: qwsC?{ IcGzϝ2|gBWȰ`ރ|៾enfŲ5ΨL=xtƄμx,J ;iV}Onڟ$ddk4 i›^C?h$wեQ܊ڍ44yeg>'?6W_Wnq3,yf9zq.sWpIB5̄iSc-zjO&ɶooK?͖ ;R!I"^\oppk3!qvˁTge (D)|ˮ(}$@$3_*,OY:/37}a\~ҊbWLEywqb q`ߕtN?{_lWHSʹsUe;8%˭O|AwjMp s|ʚW# B$`|;XtΊ+$lM|kzX/Q7" <^q&/™yLuVF'-e׼#YI: B]_9irB 0MnZM:;JɌRp{? t]5c:S6ݭhcIM7B kSZ3\ 5,^ NF"cƚ}Ji~fB˚[~!JZ%^k2Jx#hLRj̇%\m8_՞nP٫ ^ )u[%dZuKd/ þr:ӭz4X > b0aJDeݑo׆ OJ"h$brTuslm&*+ s`[ ͧENJ)|!Ҟ+P2jW'Q);Dkv|R@1ho#DhTJ5ꌦTI!B!B!B!B!B!B!B!B!B1.MZ6IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/images/PyMeasure logo.svg0000644000175100017510000002467215203313266021043 0ustar00runnerrunner image/svg+xml././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/images/PyMeasure preview.png0000644000175100017510000014773715203313266021561 0ustar00runnerrunnerPNG  IHDRաsBIT|d pHYs B(xtEXtSoftwarewww.inkscape.org< IDATxy\U߭ޒtgOF }UvawDęwqwGDGd\QAv"ְ}#$KU@#]u}Tխ$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$IU:U_ GA<&lc*!xe&yl#]$I$ICآx~bވ1Wx*?P~8-w F$I$LAKP>|hts+Tbd$I$jcb3X*ޱ2m|$I$7&^_8!J!I$IRoL֩Be@s㐆(╕A$IޘWQJ )qJ I$IRoL֯*4D7q[$ITuL֫1Aj4$I$UHKC̰JG I$IҮL*uKaH(t $I$R/~J!I$I$L*e7p'7<+XJ#I$I4Tj=yoc H$I$I&+s- X¿_xH$I$I&֬_~V,Gq$I$I @ v}?S"$I$IT ?W>l:I$I$i;/KPU\5I$I$i;^s#>{eϮ$I$I#Jsk_n#$I$IҮL*R~{M$I$IRzL*m@I$I$IOq-CD$I$I @y)K>w96$I$It-b/Kljxnz+%L12U|k=ukiߺn::馩¨#:qZtȒ$I$-*ɵ?<6y߯p3gBT|O-^>.Odr֭b Iq0cʾ N8X?h +c$I$ QPy,ϻҜsSN=\֬|.8d~KSK'O?篏'sEi"\(MBL֘bg ; sGtsy+ά BCN\P8$I$Iڑ :UW?D'>198yG˃rcS vJEوL[Df8dFdED%~E;b6{cͼeWÁLo>$IjdN\p9~]=iM Wkp5z5Yz%mb/>ȍȌȎ̐m)RYY &bLEu+ػDŽs2(I$IFf]/_RO@-"76KfTDvD~ʶFd[sC~en|kI89hL.L4ґ @I$IR5T:U|.fY}3sC{k‡96mL,Îkql$rMh96G-E y'mґI$ITLj<²g? =TُW_h>YY*^YrdӲl޺~\wK$IVW(.[J1ˉ2͇ʺA,a]O{Q(y۫^W$Ն8ǏRL89n~B,$I'%6zǃ77>hʶtn咫I[2Anb_\ 5/;aՅs~J Q|1Q'u%*.xUU89F141LJ$ *X(Ll*} *j $I5.17L}gFGyVLK}QuFQ8WNvԹNtP9S* :H$)xvRbplUO1t/)u~]O)vPh /Xa}Ti&q\yܶۧ}Jέt%J!IdLJC-ŸiY[^9<1WUqŦ`zNk/<'0)M?\M1ߔ9mwMlԑG5J0HS$.ｓ)w~GQmTv>C~uqŝ;erz-_:QNHTw֯O|Jv pp(,CQ$.ϯ% gƍ ^^Sh15@ B O''͛2wQFUޛcLt$IJ4{>MKSm*DX QpYvuySE\7ynW:U 꿋\'8%I^_KJӼݩǎ:Hׯ1t=g;YӭE^5R0%Ceسa/BU_Fښ8ᔹms:ѣd'U:2iX $I40&!"cy>ٿ}ˀ?q 1qktԽ$`,Îm !05Sz/ l%7vsھU0TIk%V$I{bP"^؍dNWˀ>rz{ mib[i=LsAGaCG;7}{ AJ}">8V8TuQAͪĦ$IҐbP"=tfw\DKi$(n| >Ŏ 7.Cfcm'|pۍ[8?1un+JYB$IgP"/c07ඦ93qG|ʌ"z^6mٔK&yLPUfo*$I4tphvz!EuE{#a5/3c~2K}~ iM5c=ҁjC}_I:{KMIu'ECs^;% vcm;<6 j{Yj<=KYMt>)&;:2#\5;&C"w=W^Wڣs Qq#D K-@l)ҡ*?t ) AH$)&!`hѿvlBga}Lo_\,$jx$7>È_~vt(8Jt ۯOsʩsh)[ IQ vr0=\:;>A=G?%IT3LJC]Ks?: =9y7s d"cc(ֈuE0}JZv[q~4z\G _v f2g±TVU: %I:T673O2zo p/gغ@]}C-:G+ҳŽ;_g⃈A{}֔FPmottpt$IRzLJuG w`/6iʽ$_¹ŘGz(n$`-|= G#O,[ri| e;XT@Vt$IJ @{^L{;wKUǞF)vV> =ӏ噪Gm| -9JsM*ܪ1/fW:8H$)]&:7{!+44xzqWLy&F`ɊŊƢY wGa|{wUm=NfU:I$TǞYkWܼcNq~Qg񳏦<ŭMfZ"zyV5 S\qaǧ jfJ@-5,ITLJu 7:CSËסi$mtMTd ڿ%I3f=W.j +W,Uv|}4uN˔Tm _ JR $I>Rm CԒ }>%s/=8Zay!lЏ*7 lJu޸nڮ֪^ Lt$IJ @Nuvurc"f% {HBX?NsM,-մsJQZݷP$I{aPSw?]=dGAsc?b{`x~9 :", ~4+ nO.\S ӛK5nO~gwoTI+ ͵=Y !VMџ&r VE{3pzvyqY\$;!qr̈J 1=kB⯸9x0N=D8e9 Ϸ3n=ͤ!$[(V̦+F |9`e'EwiܶZ9uN۬84ciU__-T^U183F'iڇ?8_&G=p1B"Q:4bogퟷm2{Z^ 4%'"$(Wz*,'{P]B{AV'(f!w*J/YGxP!X)asƫ G7)"g^Ѝw@n|lfO תmhkiQѭL1%qE9qׯOƭϣkUUŰg==t/-7./pÝ=a$^ui%:6n2e !Sٴ`.?((WSWQ)2ӚD$7ĔcIS忿> g\$v'.PI @_ ,$rDtJhPU߮f)*OcmC ޴s-Dܸk 7>H*"TPIj20(ՙV ɴD6ŷy(qWHsE~&&OnX0z\ox{ qWL3yCyCy97j '-0{>q}KT5QLۗb61a+lecǥ3[ҏoz$JLH|u8.~8NX(:?N!T;^OWR~BH]8JubIL?wy/3.8Ώq/!m? _GRhn"rc?|:(D @i /HsxKqEE*^N 8cIKDD^< 簁WնuV[V'W:>3=d$"aE1՛*YiLEhwe GRyj3mQFQG5ah򃴎_)Ηb(Dwi oI)IϬ{S^ٿ@,nKmL7y2{Xa[8,|b 7C &b.Ӛ.kluܶ'&)|/9r]&5u%aRLX4:jeϵDܿ s?ܵϧ Mc.|u$nÑl޼w gF2OH w<-͎"T<{UM,th,ͼZ~/!uM/Iys!Kx-Bh `B/;XM|Θ$|֝LMR+9Q?zm! Nx/y[+}uE!ǪkY9 @Owb__/kM$1sҔxo{> oZi-i5@~P<<@Oegg5lDh239.'T,.q,Bߥ ]}caʛ]@X'Bi)}<= sӄfa6 IAK?8{f M~m~OXXAHBxN#4DرRa>zpı>t*Ia sy+ո']af`[b9&c|d2&OG̢mWqLwWϠWU&IN( Q; ݯ!4`8}270@$Y{.@*rx3PeB@o*Vt;aO4%:;z+5*.$$QBl'ݪ=4OPwᳩ*%4ęIx$!྄cAH(_Ef-"ЕSd9H i1P۔p"sB@IaU1Rk~~GfK9"YFa؉d{KܣYǁ̠-u]+Y>:U}q&PpUʐGg8ٲjoO 䗩5Ȋ"Pl]JsK1paR KZ}yMYpBžG%)ĴOPzr7 ӀOv 1o ,Nj4ڋ$Ko:eZYw_)Ƣ7$Ee6ukra+ 7P$.e`K7cTLJ5G`!O`asv6mkT8w{yh<kjnb}8 2㨶MCK,!ҫ3n3KlZ9+bꏯrXEXXJu~}=FH DeGx7fيεPiđ9"|/ &Yv$,V2(ը|_3,vlk *WPྌhrѳ8y|lg!KOݫȶq49r&K\mo%g8] 6OG}Wjs @1j=~ә,~aZʛ,9 MPZCo%/,M G SΥ{ˈRX*t vՄ`x/ 2{Lǥyp+s@r",sᜱ:r3T%LJ5{^%' EX}H5-8{j{pWM Lw"=}BsKi7' Is.xjJߎ)oYC(~'$q)uX??&d2IJ' {Օ^~8nף$OJw͞',>V%6޽g[ Id/uI\DH !Aso/tskh8/j}:O)9\}yߘpHo\UR z`øiYZG/nc=X*NIQ\ f{(VQf7a4yڏQ{SxK^Gscȉٸ`Mm(Woz(e@\ǤT]C[frWѡH<~8ţӝ\e.^6B^Ujp?NXJl$*Na{ oQ*l>}ո =He+'$j̋՜_'4aOّ5?F#6I4<Ku3TLJ5f݆|t) 8iq=1 yha^FǛb(8e^44BF`A9{]6r3gO#`1L0#Cl&u_c(:eJ)ov߱n*eĊu<'K|)Y*6Jc(Vs]%Y|˚u1bz-Y. ;iD9@N߇sѳu~sGŰ Y~&shi_RJT ~dXbj@"x&5_-]cí58n;Yca$=w:.N/aIp"SqM|4{F2U\좄]#bDq"݀.2OE1w$ˀg3$X/N8τI8LXnXÀc`LJiyBNInz:Pͭ:bPr+֮~<|?j`„oLmNj,\QXaą͢!RA0Sm(/mXު5S|K6yS0}X >|eNgR[LkeWZ]18yblJ8o^nL8F' {%ւ"ɖ6P am'Tղ !ĥ\:%'S]d+!iR"Ɣ8f2! X-ݩR}u@&q $zp]1M}oJ?U @ yFOYrDiFhZ. b bظ6</9-MD}%֐̚tc!BL&C< Ѵ8b&0 )qe[`QWOgS0f>8f@̻5QcWWRzH?d/=y)'>!,{N6Rz1 X.q\]f * |%X':P_R\n6Kw& @>_t=鷬YsΎh?G5 ZEhhU٪p=s_nS,0zFfiax haKekcmGq]L͘}odPCN7]ִ]u/k.R ۜ'~ehT^ jn_ (q<U☥@ Hz1K%I @/e@ߝzWC Ǎ&Tx]U[.tHr(6&0RE.Yʍwc>Q12rZS"FGd2}/^ܸ9AE+Zӎ8yknipj?YɳL @8~^Sz(8һO@eN8I I7\$if1Pڙr,fy1ÀҭnNhf#Uo܋&W猅cdLRXn-k_NJVX9\3+rjxsXCk~Pֶ$}riLǖʜ'^]!Gyom6j݅\u/<8V./w* nw%'O$ifN yBY%KV&T'o)I~0fsD>GL=ФJj&JaR;9cH1!#_ȳMlбV[c}=5EdeȴDdÈL2ebD.wEVM(Ĝz {l0u E%UFi|swRnzKF΀Ry%ɻ/ณ)}lY-HVu'np:rmE*S0R sKH(~ !&l۩jX !Ҋ5xxxyjb6m( LS3jLs0 e`ȈI"ƴoG;`ʝS<(d8gV//rח8/Riřw&+x}~EϧR5$x./%GPrX˟k՚cjbnt2ps sR-)7 CW R[G,'9C5Ʋ+᎛aT8] f:@WgL֘n-]1y.#2 ڡr2.1vã xt/Ïgȱ{|n6jL/z2 _~Oʋ:n2'f Qu>6iSz<ՄKIJ ܗCȳ7{ IDAT\[Qo oSzv ygu¾W)CUVOo9C5Oq?s'?ϙc/<1jzO6j~DӰg_ꉷЉ;BƵE%uBYXg^wW464@rx0r23oG w\Uם5  -t M!{*"(EAQ: HRH dwmf3d̝;s<`g읹~眳)pWySM /\O8le[oxv!}< dqF5V6ݶ@dg:J?7՜$^Mα}dݡ"r{̘ L2 rw3$IJJN G"xb'd;7Z\Fn/Rrtv'_ÛR{|'4"p{̸(_63$JJ;opod銏V;  UNXaCHah mޞ7NC!,)(+% CYa:oE R[UA;P4G%v}+V.[x㺺+Vj?-)_c cL>`=0(6䶎O?\bn4p6a=Xѯ_idl2RwՍ#$A$阑%%gllnncM  p0aHǃQ CK[IpaCKv]a0%!aZ:>z >ⁿ狊((Kwd"/W-n]w0bnx u'`sm*mjz4|ow lw"%SFxm~ u@#p~=VŶ{<)V(x?oC[==ACes P[ %xUWޏJ%"Vúk.б,JͰl?%jU9*9n5CGVl[ٞ7=qNNPp<:R''͑@2wYb_><17MfMhXcW[ x$I~1#1=O\1|wDQ()Mnw rYoxUNouQ:"q>&ܮv6xqx!Ԉg^ZH'ز\;q{v _uA4j{\,8V]0Br SIv^Jޟctvc%k7A$t̐dM\|gpBFآ(ku o4ȠڄQY]Dbj]"t"o6K| <,9p{Y͠cJ=Vol|"~r&~dI,3e.,0(w yb-p v~뀭}a #bZT|CK:fHAQPYx酼RR!UL`Pon~+?5|!-䟁;vžS 0hH Wy=~qdkCkoY˱y5W@V`Nd pm#` E=9[ nVC%E`0_hIתUi< K&U5>P|8;Wa<`bu̐ SPΚ?^ȇu( 9 0eLbf{+ -^89"Ew ms`d}MG}^chS K0dD A4Qy֧?w2ڀ7խoˠM{ @0v:cT9Cbq|2bIE w"[!>" UV1 u>\Рe[() 0kb&x -QɿUQŸFf ).J\@WJovX/Onrȉ~w`T} ;l>A=yox߉d>ׁ_T`Bm yV[3|c&o#:\$StH *%k۸\z>P!ʠ8dxguzpqmj5t&=-t~E"; eiLDnT1Gv٢DucR)ﻱU3%IXY5׊$< >i" e&Jf}(d+pZ=誴DLrs!HV[ 80MءȋF3u)O  \ГE-Gu"B?+6Q}+▎ ,U&W}`C l=)HQ; H{Ot&pYI1t``HFqp~kZB#V,nfs826'b&@SmrE+\YIylo޼ ܅;Sjl24x}6p vxH6k*lNa ]J﮻&{Ie[(rzCU9lhV++"t,t|a6I>rHd 0#֜@/l L&P]|fJVkoOn9QR?&+ +!n/G`؛V#OV w`>:(13$GG|7Ǎ'PU@1PSiIU2c"90oc龁.lzڣ@h0spҽoyDI:MɊ_ {AO\l;Wlpf0W1 m=p6JKp/0 Y6Nv"Lrsh5DIJo667~BJ& ;L0v ɖ6U´C۫t~osLL~/@0dd0#[/qpM腆\tO5.Kf5yElM2y6.M4^ % [6o%KbǾu tA,Hrsp"PP|~'kP4<@hDslQkQZIda܈z.9"MtQCT'EBNfb)2_YV+f"=-KM=G ux%n "->-tl ܌P. Olc%=zi% s7rRfU&/bh Ba=N\d߬(Qۋ-jlaѐ9ԃD=O5 8$ɶos\e<"?OρSb/؛=/߅I3((׼+n8P2-Ĉao+wB8)Ad}t6D(/)cA 8})oݸ6&j<8 4 8Ods͔ؿR`.⶚cOO_&үaG Gdp.0 Gԓ"c]KYzZ0}|uZZU&C[aZ_c Le~]f~ldZ5\4yÃym vp5[0h>NM-p LM.ze;8)}"Gބ"A'='U\XrRPz磥pBC1{R@a i+I(j9X|BU 0ڃHE$]8'0Ⱦء;MγԍAIi"N@X }5`>1V-޸.~=$?־$[.`˶xHq O®+8 Ԇwxn' hڀ]s1Cr1/:Ͽ?ʆk1LK!=ϣf: w؛ӾR믻*Y"56p][w% &\h~4y>+^pNs};ey )wC'ݮV{e;3$@ wBaÊ)\{,E FVְ5gJS_L9B5Jt]#m5D[zuX*b֤il3q+4AUOuU?CS_=XD2/DN8KF^[9ps59:)][0=^UDΫ%F%x} ˌh_]p?*+ G$=_@P^3ڲ{aF^i0`:bk͠ȔT76?GaTVU56]Y}pJ*%s .f=o.8 zxqz_xvކ|($ۼ4|BڣX.)]v1*pH*[*h!l+L&, fxPFIБ jorn~a\2vxmOʻprXu u%`)Pmn+Z3a\(P/+qWzccO#I%%>۰S~}Kݧ !^%`:UTUPYZAUy%EŔSRTJyi)%b**\UKME Ue;QC"" .hz֓@0'cUuOG T+/{W +'.ږEU]$ۀ>>Hit΋J JƜ. R<w7JՃdDU]b2Rp/.J'6Wu-1axg:2Qؑ=0DC,b8 {;9H}|2vank妨6~HnH| ;IIMdӒC:)ony1_4")(i <^y?BGf2 :WG,-)el;y63N2+R;qC-ŻTݺoyO.[ mθKM.W/=Pwq`@/H,! =!U>ΛE+6-b"ҧ`CEYiWދЖ_6mic&s!q9?fA qڶy+)-aڬJe{| aE_5uL^'v.0\&_̄s>́J{/Ktrnw]RQ]#\a,"SPҮhHҾ+;#f m6I&o|w;Mߎ`sL=rM/"ό17@qtܥyRA,=lU[`+: ٧.4 o]g+ l;Y_]ۤ]o^tPcp]߁HoL"Y),*G9u |-ibcy֗D G'^G|#ӼqBANcԱ؋仆 utw> },ހY45~$ (= oԖ" X! q^Gq1iԸn7[ R9S:a\=81Oۗ-e"`c 'm"]oM;QZZӛ!(uCGso8Ny3'0aBEZG;p?wk;2<nwvvByrRK.0˓h7x; 8*(XbpVֽLvα6;_.^Fv%//gj&c헱LǮK+16njl=W;P~sJJkDhIs_ZhaԭYrbFmfOgITVB&"2eq<ܖ_&8Zn2VN@?㰫+g[le[q(JQƇkhy"Be؋lrp˶"Ge $bGYS8'>&b?p{CfIEMdj{Ʈ^)I6[m }:АbAKc5vwwj5{Rh#^.Qu,e %`?"JdۅI>}@>̖ճ^'ĝsImnjoaW!划W {8?3+"Y%@$ -Ҵ) ~0v7NKy+-+nHfm;Sj2H8I%I [*[n:lҬӃ A[Z[@ٸ_GH"0VOXbWq^ cLoxmT }o>wIڽ [}~V#3>a=k6v;H#` R& IDATn4SP.j46@;afpGMq*ʩ;s0sF=Dd@[b 9%ջ*``WfpG}9؋?a+\]dzQ;-[ެ<8;#^) %} $ocn}~AL}y! ls*,~Vu>?<\Q_p^||^3}IvsC4V#llO"uQꆌCN#n~;PQYFye9UTVW GD7]U}7Sӹc~VcQE&;= [1;~x;W_ISI`^.~}^c!*Uo;`Wܝܻi.Vy0v/ dTw5}oH`G] xWo:a S1 ;il#P*2`0*w;T)n_5cWrnjHQ͖njD3Jvz_ځSrІ&pSPr鄎w# [,@PQP(H E%Et5=Wwe+ᤞsō[$:{wq;|O/ Ra/RǧP7A`zQ^&n!lub3l%Q&&m&-ҙl px- ׯ`6}!} ǀ>fc+S,D; n;LK˵mEE!K)-z%(*)'"Y};ZWrV;v[\}]#*\s+E{ǪkUDWV-6o.q` ғy%;a8Xblek?2z'}TZ \ 4fϝ7!j*X?j@1SK8R4+)UNyb ^|<ỹX#VeEj Xd(Ufd]vSJ'M7UcyF ]aCR;/5L2ĩc:b0%EnCD$S>xp_cӋ>M"c}Ka/TrJOD 6>aj?l|O=UP9nI6R[a[2-fȽao;b.luV6~b:m "k;]ڱsNN(yD @IKc8jTUR_eLjG*Һ8"ߌÍvKt(y!0ϱ$ [Q'l>l5=D/[*&q?#w`?+sɾ*;} l5@?Q0KnjIbZ_cW_.4PPrN3CP7dl~ǡ~H͚Hyd+'x7$5W{>a٦ ]C=3āޏlNî<`˶ tMbmͶpg>]؀]|@^!H Ov|[r][[ / tn(dʌ 5TsHA1<ȡa'~H^'0Xv?76'2 `d2?](nTζZo>&/}=WdO m|]|&ղ91-y{<njcw5#~xG)  La\Q^QƤic5ϟH?V/Xw aV鴷;9Z:\u 9wcׁdSHK9vж[۰;3dl|w`+&uu9v\o }دJ5tw01C [5 3t6 7 46w'vqd%2v}Zcghۭ*۰ ls=vߔc2PT$C'6ՄM4a/b/䒭Fa67;oL.[!X&_î4z0C!}nR쿓@P%}Hv_&^]-}o cj;M&J)63&[=fTa?nj~EgJJN0й:J(]J}iY SOD k)i s'Ih#B*ȅՃ3 x!<߁No?V;ʆHNXD {ٕCj[Tbt 9 E_h4%%6C(%E%j8D ~Ha3|٣^^en(Y-%6JUY_gRmkW3l4E&"C"E 86nO$UJVk0 Hiqi튊B0:]aWWp7W|kzoLQPV1Jd}Cڎ0P \sMZ[C$EC^e[/RPBēyP;:]I-[ݧ{?hpDrثj&9ˋxaQ3^%"""""dÔ 8mۄAǍLcdnk> |/<.1<n0%%0tp^G8NmG(IǙ,:|WW/ֵuߔbH"""""%%t,`:a_`ȱ +-+Ѫyý>3oDrWMwseLJ&}ϚR KDDDDD|dFCgCR퐤֍T䎖V~_cևG$_Y= 85u)^Q_"""""%%{h q󏠦*U JV~ʢSq|w^_w8"Ygak=ODDDDD2L @+#D Lf;'vX-QH׋?|fdK(m WEoiL ((Y!й"J(PCk,Kct(fwH"qՏ8~qnn`J/SP|g D "Hm `_/gcc3}zs?ሸReWV]VwUAc/haVYwEͷ@rk ;q"""""⃐t,m2~oRmLqIQ"\{+8 mEL9D:\H]Qy1<8Ϯ۰c_IYʉQ8G{8eT?]M [DDDDD2K @Ux]Ώ#qA 8AF Kct y$^j*Id@Q&>Y,pfVUDҽR+Ӽ!%%"li7t±Ftaͦw|Z S5I?07n|9ﻧq9 jRK9rHگqzaæ mODDDDDL @IO/o5<"gXja\y>;!lz;Cz_~!"""""QI.Gy6}V~w8"=D1{C7/l DDDDD[JHA01q\iin;$A9zb3JHA褥y~"wv; s̊E>;^۳EL5PDfZÈs 68DDDDD$M7z.t!G|ߡ:Yjƻ}CDDDDDH @/w㖾,2^p|s%Ş+8c8m @DDDDD2C @DUM%svwァ'8AGwuƎO-!`O[o2Ɯ}ھd"W~\;~e!>lݨ=om"FʢJ %H3sc[u__1)("9E.pDfLmgaâgj"""""=ApՋ;PD\p?Cƹtdņ߽δoODDDDD"sfl=%WϼsE5vN6q`̍MwZLj;ܢ՜/sGh`Z_U;&pq'] 5HRPD^(dYGgP3pD`V6VK(XQ9puqjp(ǘ6pZpd us,%""""";2sߡděK77EDDDDD"O?:PDDDDDDDr"U+Xx {)HSPDF<= 9PDDDDDDD*cQ$vp!@1 czc)4Q`Zw"f$g ~!""""""O s""""""WA:CPDDDDDDDz`[c; wHoc1?;pJyl˓8v oEOwDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD+$aP@W`*00 _1{1 0ַDD π=I6i؆d2<֯E'""""Hwu"Lnxq9[^ t^e+q.""=B/&fgz m*R7Xoe}EDDD$e0 8pp20Ǹzs1=O@;]}(Z>^`۫t{\-/tl@ fm, (+ :-?''Kc+p6PO=|ĖkD^W4@@g\=sVܭ͵lw*"df7h`aϖƟ؛;_&6y_#;)p.,o{\|{&.ĉ69ޯ;9Q ~krH^"RȪ)~~ {ons@$FB8s.O}E6@0`9xhGI,qgBax&=߇I{$Ю+,6Ӂv$H.;Ӵd+wN(Ѫ *='Mua_#Jjzv6k?9_Pbl&Nl^u80\c<L x8[Eq3qmH m?X?J݄I;m={!"R@V{d 7|v@x׈/[$T~!"&af=]?c9}aJ}[oms lSD$/\-n0rы:_#L*%3s_SH^;(Jh8[*vNO*nW(H.Zĭ [.ҥc}awd54X+~ޒIn2򇱓YD▆hd?]H.wd5T(5>W\_vASD$͚/Kk"P']#Lh0.ps}fvŮxW,XN<.I~~Xg[}y<m)bq?KqE9<"`=4`M{-' ?FG*ma%^?]&։@E_/`ߟ{0K> :|/GS{p4p$6_|܇(~^.2 ;d ,gg؍}eO$ ؿ؅j؟H'C=p`a.Y^- G[,oOӧ]K.!X\bF`n]?~xOATga_z' FcV}1ŌƮJ<_sv/|cs`a߇A@-hzCwމ/ڒ#睱sw_C[)s"EZlsv_:|kw{ҵhjz~ӧ l~ 7k" O7 IDATɚ_NrӴT`?}>s>Q󵃱}vJf$ c~!{`ߓ S'~wݯL<{bʰ7?==ft۫b1܏,+ǎ:#_Nӛ`{`onv{`5b]>#xǻ&ON_`WOS;6 (챬e1v78Qdz=ݟH}o^u7{'r>.ؿy_J5]~qߖOC}߫|y {3O9V6/"m`~1+e+ȼG3]ll ~f`O$ލعwrg}>{ݮf_P=w6;`'^[ڤje~DWq{"_a*ÞS=Lnm(m,fV??8"GgydUs=Va;wv\]7'؄Toq{kp/} tA96Y4йDmM%w{{sCl+quI״t{[_t#G Y$ͺއl4{]9@boD$-oDn^|Qmk/tIwc68PFR6'zED C2l`Su O*~G$^,&˟xwcJ]F!&GE[ Uv?i{0Q$/od =A '%K7H/$'= ' 6aݗBJfzf>V{@3صQتO.v3Hep`s@Γ:H bVI%~GbT2u9v:,cq}=ď MDlo9 |]7zgEe_'Ğ=/Mt[wR`0.DKIFHFh]ء]Fa+;r"p3[T{7i vBחj׽𶗰QQl,;3menaثZc u5lUԂGP ~2st&@ =7pLV 4Mx^$Xl^uF[vٞ\M]l~ [ڌ=a܉}R@Q@A * ((w]u9'L.ʢHF 1 $I|InooNɬ z߅f ʞMd s<6"}%z6MFor" "xrb/r[6*whzއhgDP.%j|}ı|"pH;{u{qQث~)=`~DgXFfsb_Ƕۈ*<w0M qsQ|p~>C2wA cC|vZDitbڍgeD;{77Sn /#~f{%}XfuO\k3n$uc~y)^D-$28aٜ8&~s^}.%v{6{"0=8lԛs sURT&6Qgc"w@Ll{d}mN\/@zͷ~qx}oWw݋?֢n|}kMo{`;4qME6%.E1y7]kwy'^W69k!IsIS4d)I ۉ\Փ5f1KL` Qnr8Mԛo)cf NRP~9A u+UӤM`LڌN U((l=(Oa\d=D0#>ۂZ" 5 K5. |>'o5iܛ e_3WP#2od{(߄K<x(3ϠX=$MucNS{8p1qS?bb~oRnb:1l^Ǽl5?̯{6,Z4뼩yT"0{+YA,+q]龕<ئ뚚>5KSg&8A':AtLMjhͽ:LfU|tYm4]LvEp t˪OֱK &C\2A\;55~S2:zgӥ7>f۵|/=G^r؛S486n 室k|^kq7ͨ˟~@( X*-@:|}=˄9e o_nA472hQ) 2=2i0{]@~7idnMr6o.mmxꛋeMЅQG)`"˧.:mІߗL>*pR vf!2Y_X"e)gNTk1DRUMq~LԆi3|>`\15`稳1V4gTiz "#?3zTդv 4܏sWLcI?_f9gOvLA>b~Ok,^sN&˕˚:V E* z3^ K_PlTet'_ ӯF1Ku)4نb4,k)~3$>gHu '/yu'7vU,XH ~~(l/˼1)OtU (wPeۊmys9}2kPȆlATmOS*x _2;'寠6WGtXfASQ5=pۂaF653'e_0ɴ Ve:-8;UL6nYgͰ嚺FϦ]J}kVi q˶ =@lֶi9KSu.q qTDK7mdC[C (9y(qt(_dػŴgQb˙^A1HxwT$&ivn#P!= wK(w,by[&ԵD?vUx-#}vA)h~_X}زDW*n"Vc5y߱-AW2]kxeXF/ϻG[Q϶&<3yWP|p#ݘ^|?uKQrAoMǘt4ŋ@~?5K[7]=b1L0UD.|}wlٴK}L`{N ..&N5G]>jӴo:lJٴh.yXmXAdsՓ_~Զw9oӲMAڴꘖ>МE:#%J՗h?C(fɑȞg}p-.ۖQ5(f\AfÅ]]5]Q y)g>BJٮ#ʟG /3-+x\IOLnjKAUAɺc҇~Q[D3> zͷvtmS^?>aP3J"5ёr]t[y 2p澿`Z&Ho@׮j[{'K0_ٵ*D>X⨒mlϧzMƁDSt4꺋ulAdv}/v6TzZD1`8ǨanuǶG09/DBLw!4ou>s)7Sze6EqtgRg6ɽϺikS>od8y߯ {Df\:<8vɀ ߡm%3u͗Gti1l]ݩ ŬDп+ iL^iP7}/|M_A:S%P PIi]{1?Ժ'y>xc _Z]AmSҾl#n$j5VFS1]7"2E4<n6 Ǩt?F7Ǩlmmz!X=&@m@[S3~D{ ZD3֬͵kO]1rj;3R~9+s=9[\}R3qͷ kD~L\+L%L~Ĉӯ"crfiԨ-!2sJ4xw rW5H mMi?2g=W{J1CL!}3囧5ZD4KۏᝫIt~$ŧ[Aw|w#n]2[Qzx~aeӇ@?*<9z};/:8bbQH pJ\87̵cn[{F;"ΥCfoGo6vŮ$^{]Dtp,eF§'?!y 勰'Q=rlz18ʴa ]5S,qD|o9 O qD #5}忘[IQHmG1"n~|A8X<`MǹnYAbPjû_>A43fo6#QQK@$F$|nK3 @DC(^B9|}yu9 (qʪtJoQ}EU|͋ y98(H;KJ?"̍u6S |z` ]\;^izpO")L"Ghx&|ɇKIGU_(=oWo_{^DQv{=P̷!aw9ՓͥM{OC#8Mui_j+Tf-#2]o%OY6gk$50qެ.]%=Zs9[sW%FQܷ?KdݍiSa/7LOޯǨt=Cs>+K{68H=Dd{srR+FA 0Lڽ3An#3 U w),Nk1ml5y:,x~O1#ŦUStt @!,ݒZ '&;71ۓ].f|r~`888d6ftVٕ?RqTL1+TL;s湹WHMٕy8(l~6pTZmgu-t53aF%֦^0A4XxxXȠ9X}y<1y_ ugod4w;)^ʓmze qiGiQbSхDΩ[QT66(f*N&me0Ay~~q>H[YlGd]Me}ڇlܑj]YnIK(fxEߨknDq8f-hZ3r>|F!&(oLӲ jEtLD?2]E}zBʤ'ei9 MnhʙGQZ~:gV% /)-ʬB4^߄=kc[kS@`,(>&KGKN 3 7m_9r]m`G.Ô^h$gv".|ҬÈwPn/b6'FkuE~nlC4Q{tC=@5ӝKyCP܄hu'Q '2aҲC)6[]Cc6[3>:Va TqLX[e XMi4,騸{jKM  Aة"\G9#޲^+>ؖќbⵄ8[SG%yiU&.NӲg 9.g2+[|5}ZSfrV'::~МE2߮#:)ߦo7T,]DnC$\/Nʴ㺤\~ʏ Ov|U~d%>)L١oS1D@%~~r6D~%LlU͘"TDw/"?N}x*O/Nܘ,g7M}Q[x2e{'Gôw$eܡ3BbHZ8v} ~צ޸|׶(e~VlAӯZQ~*LC0 ~~~+uꢤă 15k ndWwc?;5C\N^v6hAoKS[i~+)v2LPN*}wb mIy;1(o !Yku IDAT-YTOY~>Cyg7'%>7(XrdmR@CmrZfȖ} |jMo-yFR6D|3oD\[g/%p)ޏ>;z1h 6%;k/fh @cUp+"{t0F.2y8!.LEmQH^.r-yL6sZٺU뱪y^y_[񷣈 ~)_eK;+9zٞu8>}6S@]"$nTVLӔ53[7ui쵄;[\1) EpMץݸZ|bR; 6US>Υ@7S \⅔f(Pb**gX晕=8##L%,58eC*+ u/Sr]bY' DZ6oG|k+~כ~oꯕA\?B:8?Y3ߺo4+[z&s%{|gSH7^tz@ѝb]Uvz}}fO'>k=[7`U C^FT7n{^Wѭӕ=yrrU6#6+!hsXګK.k˓s"-/G\S,)s$ckw'1 ΤDF j<4O+ iߝ<^mnS{?bfIä|ۛdM7dm.v2{I.B>[t؎|s)ֹmG&W&eԡ,D䇈ݦ}D6}nD45 4_AdfG{Om^Jt4ߵo'|s ٧su?.}wX*%zMۉ~1@|\̾>){D?K>CY`7~zXBd=I}n[plی%L|viվ4~(_K9W Jy]K[i}3m}6u9rϿ!=mGDkv{͎MduєjhGkjKb &{]BҤ~P֧>LOΈ^nۡ.ZZJtݑz{i[$L]%sd$mY/|c:hV_]HtҦ׶tK1Ye]xQwxڊؾ.)6砗rHu8aqú3q"[(x*{ڰlH4ݲۈiԏ4]e+? ty7jYjke#ӰB%Y|"85r.ۑZnL\$J4}wlކo$ndx}qѽ=qqyQQ5o;AfO#.:Dp67(ؿSV%mcB"Jo;\&$ 4 nD3L̙-786?C˯3AEqh cw[`6X@DZg᥆g-b]ߛɖ)7,?_l <&?U.!e+3|AFeCb[7qpϤ8J 7'2JW-<E$I$ ͣ(f=HJ&q]$I$IsW)4$M)Lw=$I$Iد͓KLwϣs$I$u6!HCf9h#I$IG1w1$i@H$I4 ܏7)ބ.Y$i{eF[I$I\sŀ_z&I+q]$I$Isvc4I){$Iip2d#$IF]I$I3>NM#$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I7 H wCιˁs0_Ά6*$Iq ը+![{CN|onYn-p!C"G[ p?`QWD$i揺fuWgP4}ˀðfY7omu$I$if|bpHk$)5.R>f$I# 4wI#./I4x(Is7+4$%I&U}7w^]=wͅvM?tg!.# \sm l,!:]]4I 4p/b_HˇT]v-1Cj` kbqy =r%lƷ_{66&_GBiZ惁݀M:74m}Kb`(~t ǾՉbaKe>q۞8D{N%C}nY^0ydDZqAĺʎ" a2-ћ߉$IҌ8ax-&F+ݩ|%n(חZ.äL4} y5aIoShYDo/}bikd&G=&nｼbKujl"Zn'~y}VgUu5<<_zs򷵁C~Ҫu"0Qg-[Dg7<.{Q3529 f_|9n&Uu^Aa`._ˁ^rW{}?z;bi~:`>- 8K>AܰlB;<%{'uljkm cMÉUqok(wl|؞Lb9D"^kPj$ڧ;&?o&Xb~'K[wӝbp "f|OݪM}`u|2+&ö˪^CWU ~qqsl |qxU}vM\5zbg{u>!IUL qO}Ǻ-$uYL㪬 | qnAm,m&v-7%1C;+}m<xoM@62SQ Ct3TfHyL5x=qeVk#" إli]F+7wD%^uAa7:Dfo(K}tx́ŽWV|ȤïjXntgnFlsu;LjqB9t nFqd >w4x UhAxS==o$+:Le/ 21A^uC$IoLe#b{q2mڄ& 45ɴSع+Vl}mMrlO9t$}u.߫C~c? >je<8X_H1`){'tlom]DKz/A}v5qsk>TKhpً lFlUd~MwܛND4|;V''Is_[&tRjen |3xx1| !~{/&4IxS} tYʯ;-$e ͭ<<}̎`l9m&/n"k:?:MH'oX` yovOi6h'=fiK>oNo?E\W?KICcT u?N7ѕB>gY/xzuO-⸞b$IR)G˪c)bnDs֥ؗ t]DQ9OuzeJ1]7e݋QSvJgAک?P')֬)㲤QٔboKTkl'^VQ>7mQ7g.'&[}i>mDɺ~#3OOSKk;&@d|ϲz{9lN? 5)?i x!b3?,""I 7пY*ݧ )N9 }'}^ѧ VoQ[:j0$G9K[}eh I$M<ʃXe%idVLd7C xHWfG4 dҮ/(f|a4o̰ߢkB5'|o2whɶ'@RiU@R wvR- %)w^r`b߶I{~U{XV}xS|1a /;PwfiL  7n[Hq*g70XYD߬Dd}6e.a/&L9%mYbe$I(uDôQMfoo*匲LoaY.>k*ئc0o̪޼}6)הqu/A :9Wi /1]2I56=$ C FN OA,$gKdڶ̀l9ݫ[M94v e6d{q]&ӷ"4g\ƎI E%Ӿr+s$ijɰ4CPFLS[>d10;;LFY]ڏlDii[Ձ:^e~M2I7}跭o9l"mbʩY7[\ߎ@s0+]V7iĮob[(SPl:39y?"qiCsuxmAlHlt3`>yC֠ I4tX<:zb.4-L11_&DutpkuI޷Tw\.ҦSM}Mu.m_wSq)1Nf-qfkΣdZF<ȫ~'k4S7~K97? Դu;odc?ܳǐ;MyS|h1 b!4ütF$Pl'm/tW7_dr g*_JM[Wvf4ev b[b].jx-َED3fcb4wlj.YڏLjٳ[hR~_Հ7mε})w[p}~j37u9֧1v)N%]$rMYUҠҦ);н-yWbrP;k+>0J/?N1Ozc7]YL5hRb .cCCsB Vr"xr41pƢ[ @3mz} 7LPv.86{q. ئ!KձnUD `Q!=, ۷Nq:\F)}K޷ \ 82ΚOq_D,IV5REQYYJ0w#?:ӥ_K?fobf579g}QADOMGmU߉ ƦA3n#[ fJ:M#h}hCv?A}VszmYÁg,W/xGg2`1Xp:.gNDFQC_$!m3fZz\M}N`U(U瞮fUCޯ|R{b]$tHJ8;ϿQ{x.`O:FcA_9ۓ+c`*btzw#q_fl ?63='}h]:e쎢ady>3ʭnˬS}ؾo%Z_LScK9C:Ӽ̗{ "y"@1S5UM}^F󍬆g ɓ5^HoTtz࿉&UGgr5}=)jwif861BqpA>< I'y~J=w0|?C7IX3hVrK'l+s e&ae%I,d`M4 mgw(6e#7d:&7Qݦ:n=o܏t:b?1bg:|b)'LlWC?(6͞;8e8bV;TL:qlFq Ϝ:H˥33[s>AD-IDAT7,]N:^|9ʣ{}rirZMPPMBbq6?2V'2h_Eol׺%L^h&'٢̓i:ڗeZ|x4 "6'Hd#g\{9-e;' <- FswooB~IozM}7MJܹMی$IRf#J${Nɚn@4gϦʃlb*_Nov%O}꾣V#2ǖ'e.[vlPfUy>dkQԪu\dwX͓&mQkQK-$_yطO&} 7x.zõ; )uW>ye5ӯA<@Kz@E.݉[QʧǷ~d:, |4LS2$I M+_k>[/MM½Nd3#N#o&2벀# ڔZ9/A2DId%>{6gD5D󫍉lJ@?+:|MzqC䳃 ѡ㙼za&87 g>{5L!oޗlO"[6hb<"]Hd-Yo8Rh!T#^F^dPfsboY~}0 ivZD ^2l~%|'˝D2uL-q Ӊ>dl1xthb_pٛEv7v ORb=Hd%~3tŝC}ߊS̞\ |z9q~xs߈o?=;O _DN#BKKtbhM:.v콿Y}qpKEzbݞ^3$I4]TUfC^Ls60)w+tf~xi[EkqC=zZJ1{Ab⦲LgB jQseMYJ)5efTpz~3|2!׷Nxd5 @Jc$ 2id}Uy)1@ T7pZ@ yN]ssSYzMMg*ʎs qBR"`$Im@d/M +fi?lG3Ȟ/5Ӧ՛YDtc0Yu%DSf'2gFmj BdXSפҧ\&>XHdeW0LyhŸe !?o\6é=fC P }AOMӘxT!i۪W>-nHt-/bd4ʿE{\݆^LMI49Ҩfږ͉77%nO8pf7ࡹ7)gj}h(v%\jDyMDP^ݿM4Uzy,z3 DPMOڌʎ7)tQ!SO/o6^J;oJdWDmMx gbЛ`)v皲%q|W_ʧMw'߉| )vYm9#LE?Ezp {u*_Ӂ$I9/l}&ٖLW.8I3hٸKhU gR鿆[EI$ivHSi+iRYF\iXEDf`g|֥k I4 8AaX)8s*"wTD83h.d#If  _]6bh$)A^D~hx]6|$IY-m4Bf[GfPxh1o詫G FƖ$IV:x,1Bm/9IxG%8i$Ifpl,#q_T;ĤxMz b$IJ4 image/svg+xml Measure Py Scientific measurement library for instruments, experiments, and live-plotting ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/images/PyMeasure.png0000644000175100017510000002066315203313266020103 0ustar00runnerrunnerPNG  IHDRQP]FSsBIT|d pHYs[[tEXtSoftwarewww.inkscape.org< IDATxyUSӳdLE B!,JHA@QAYPQ$n{A% 5 JAY$LI&d2]ם%ydj?|`0 `0 `0 `0 E U>u6 lJmS _91 BtSon|uO|w[a0FIUiK9>*4 sf хl+14ŕ#0H*D|l1G72"^)g@Ow+yҲ?|>|=>!m.kyq73՝<ΣTs3к+BifQ][5ج%yn'Q,?9`ȈQ3u!35KᢻϣvVoPhmU**ZV35Yiu7Wj_ʱm[ ~ ~S?mڦ<2BT#Z yDfq3B0b 9Nt4u-TW$o}'zi ׷姑9@, _ k"\T#ݾAPH csp$ PaDBtOSV2 v۷ݽ?`E` ٲi[  7s5T'g4aL ї6e=b|0j^mcm-B|r?S3C+4j!5˃g s2A<QǘZk:;c΍a8~_GdKB*?Sowb[cOVHʹmuVj>k Zl^vE[?)ƧBfq4`#75`qf]C,-O?A(ԆӖV c$o㒶Z{۸):J,R}r۹od8x c QǘD}i~64i5Ət).(bq/R ISui|59k/kټeI(~qR(8wږ& Lqh` W~0i_U-3)l*´'˚OhW~`qPM,$/žRTQ|kx@٠{`L;:9"r)-+`WUm_}߁*R|TV}#53?aq֚7!HpW7ƊZ˧N8P]K:.zn+ؼ퇃8ű|6pgMp̆rDDlF< <8^:W! r`!|T :dTs:^`=ҿ<BWFpF5$n*)y03&^LK.zqoʢJ.Y kyc;(:8HYOSiQN{X5>Ba8O!9ÿ!˗"BN#hj Q #`v?P |1 reuRǷ#D`)% 5[ 3d,q,̅W`+\ܛ(#BkB\^F陵E]&&2&~(.L^*,eYS?s 1W^Ǟ-%Tڲ)z{ rXoTҌ*ۼvvS[3< E8֗. A+ ш"ݩ> {2K8xd<8g_RJݏ}x6VW,wǜ]׸["D,)CYҽrϞeyw.X{z{\t}U5/yRjnc85!yf:qpk]&v+HD2a 2tYvڄBVdX8&܏d!޳V>GVonㄻ89eEοjGtÁZ0APH=sA>~S<6"gXOƜsW4`IoZ+R~LTT3{i+m[>:;CzQ 7l\.N+,?1˨P3V)JtCC4Ҩ 9cb#rlu Q@ 7 /M bw "ȵ ӈݛh{đQLC'hD8;v.Z LeBkg!wSx?ElN#K^ELDUii*{w 9>8U:c}fw躍d˽Ɋ M:ݚ&G|̺geZ4( u?Yn '+?|aa_J|H\O5Y?)FTC̓ w(8<Ԁn&'v؎ 39Y)\˩MO*ľ6Xʵi _jlm kx݌zu]Mwt4֝D[*9q-.g6݈葖azF{C鸀g@Vug) D< .@L||N< y!jZΕG*TB 8I5a}B/"#v=LGԉ~{V˻7^7d==azlzBal^'AT\iŸ[aOi(+.<ʩ9Zrj}mT{~ p)糌o{פPiguRY,rMgҡ2 sTCnk D "#{$Ҥ=p)*1׬`覅Hf\oO[ބh(WV߻(J\Twٚmm]6EaSME(k rɱ`in;4h(liTwek ]=OU[[^yt#qn$ZV߾~a1 'tUl{?, /{O%{-$@gߏ;>Mvm>7F$~u\Ue;*yv6s-Kild#5^ؖKZ<2﫯ONKDJJ->zСЯixņǶ.3}ϲp7,\\r%)Ov}*, 3Ed'/X"8T$Vɪjd6]8%?gVD  #Ow %Oi "[^\rϿO8fMw_nJCCcagU_rnXܚ'cAhsu40#Qsg[.ܲ>MDmo_ٓ?~uO hNm/$zYFB^BlFL a[hZ 9?BlWy5@"Ɉ#BtKs(=p;4[Z֣1.<*& G>״JSG^!߱saUsgM8 kҶRuG^W<s;" /,)?-ۉz2 *c%02pgMȢ=Gh#~xAnzU$oMbPyke΄h_Wv vRRhܑ"v5,Yx]9.HpS*: ފf7tH&uvRei&M"DQ;;HrO ]s*X t+b9 9D,]V#KO#6ۣK-kynpv)hKNIDpYVc՛Gn)\8jYSG[aûWZ9khR^0B$s%/Grt^/F9y)/@$'|Udq%W$B@yJfv(i*gڎ\yW8EXxF NVT4Jky5d}!>i9:_G>#f2&x+Iqo)A8\CF:NMn^>/!ÇgMɕ&jwk vRPžm93eBM¾8yY N6}m*D+ΚrkՁJ8U^ i;[H #Maq,rKoHݓ}T܅YB`,s`6Q۶*n7c v | |J}%W񑙳U;_2ꦹk1' vbP6[)N$u4@#{;Y;Z 9qMU 5=wkn[UK7&~Ҟ7)]=*kw~zd{)v&c; TYڭ 2m֔U 4 4 .@"P(T)]^F<峈[]ŚYֈ>/M-Dfky3>)@4^Gy^L&$.%Owo7"@Ѧ5yfb+9SgLƕWe,@-bf|7ĕȓI|w!~C~YAb&L+$(^2qx3EH2{7I]RЋy52i5q-s{J#A;2:f$SjI3%kccH}S"! 7$tOmYj&p0~lŃ*le߅V\^iZڐ禬 P>ߐ\s'BٟozNHzi&hėw4]琢9S픽 ln),qrG2e%OffQ;uRIٺ=σ#ɩ*, CğEH|z q-L}{IA/g"i^Ðѿncl cmXH_XCF4`/4ο9H\ s8#!saXBl%NtU_hGx &֚-;'V9f>K/ } PTRDqIQƵA Q?U<ݚ[i*)Z5p;q 4i@B9G @{q/@2E엥*1D`KNRr3#Ǣ_HPR ޜ܂hN|Č$jx!莛.^E>*' A "h υ)y]$TfBD:aQ&GUu JK]st0!ŗ湦:兏eBlHukՉ{mG4\mG{d9ՃLD c>؁hQM{8EIm0FN8YNTNWl@|MMe|s'TA:U#Wa([t0i)?šc s-D'ڹ܅}#ŬMsdh^`m G!Zfoay#5MbnMt˛_CbSkR -΀j^mBԳ9%oDufzi=c*˲9qut}k>=짴LD5j"Û V_h:F`Flg'!B=GO /aR$խ#/%q^7v"7 AOl[> 3-"#QwmolxG߫tf /gV/6#I$uASȽiN~S̜ 񏷘4QYo`qlSDz Q9?.k9%r$y(dNI0FBs0!Ch\g#-\CSCOIљ\7h W~4.Lt$] EL'YSBI~[ClG웲9I^,%UMVҶ+$6XUx4wd2&BSX3MAtaWw4K A ksV ǠUA6:˕ևtzٱLJmS _9ҍ1 `0 `0 `0 `0>nq_VBIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/images/PyMeasure.svg0000644000175100017510000003057515203313266020121 0ustar00runnerrunner image/svg+xmlMeasure Py././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/index.rst0000644000175100017510000000561615203313266016060 0ustar00runnerrunner.. PyMeasure documentation master file, created by sphinx-quickstart on Mon Apr 6 13:06:00 2015. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. ############################ PyMeasure scientific package ############################ .. image:: images/PyMeasure.png :alt: PyMeasure Scientific package PyMeasure makes scientific measurements easy to set up and run. The package contains a repository of instrument classes and a system for running experiment procedures, which provides graphical interfaces for graphing live data and managing queues of experiments. Both parts of the package are independent, and when combined provide all the necessary requirements for advanced measurements with only limited coding. Installing Python and PyMeasure are demonstrated in the :doc:`Quick Start guide `. From there, checkout the existing :doc:`instruments that are available for use `. PyMeasure is currently under active development, so please report any issues you experience on our `Issues page`_. .. image:: https://img.shields.io/pypi/pyversions/pymeasure :alt: PyPI - Python Version .. image:: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml/badge.svg :target: https://github.com/pymeasure/pymeasure/actions/workflows/pymeasure_CI.yml .. image:: http://readthedocs.org/projects/pymeasure/badge/?version=latest :target: http://pymeasure.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3732545.svg :target: https://doi.org/10.5281/zenodo.3732545 .. image:: https://anaconda.org/conda-forge/pymeasure/badges/version.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://anaconda.org/conda-forge/pymeasure/badges/downloads.svg :target: https://anaconda.org/conda-forge/pymeasure .. image:: https://codecov.io/gh/pymeasure/pymeasure/graph/badge.svg :target: https://codecov.io/gh/pymeasure/pymeasure .. _Issues page: https://github.com/pymeasure/pymeasure/issues The main documentation for the site is organized into a couple sections: * :ref:`learning-docs` * :ref:`api-docs` * :ref:`about-docs` Information about development is also available: * :ref:`dev-docs` .. _learning-docs: .. toctree:: :maxdepth: 2 :caption: Learning PyMeasure introduction quick_start tutorial/index .. _api-docs: .. toctree:: :maxdepth: 1 :caption: API Reference api/adapters api/experiment/index api/display/index api/instruments/index .. _dev-docs: .. toctree:: :maxdepth: 2 :caption: Getting involved dev/contribute dev/reporting_errors dev/adding_instruments/index dev/coding_standards .. _about-docs: .. toctree:: :maxdepth: 2 :caption: About PyMeasure about/authors about/license about/changes about/related_projects ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/introduction.rst0000644000175100017510000000532715203313266017471 0ustar00runnerrunner############ Introduction ############ PyMeasure uses an object-oriented approach for communicating with scientific instruments, which provides an intuitive interface where the low-level SCPI and GPIB commands are hidden from normal use. Users can focus on solving the measurement problems at hand, instead of re-inventing how to communicate with instruments. Instruments with VISA (GPIB, Serial, etc) are supported through the `PyVISA package`_ under the hood. `Prologix GPIB`_ adapters are also supported. Communication protocols can be swapped, so that instrument classes can be used with all supported protocols interchangeably. .. _PyVISA package: https://pyvisa.readthedocs.io/en/latest/ .. _Prologix GPIB: http://prologix.biz/ In order to keep the corresponding numbers and physical units (e.g. 5 meters) together, `pint `_ quantities can be used. That way it is easy to handle different orders of magnitude (meters and centimeters) or different units (meters and feet). Before using PyMeasure, you may find it helpful to be acquainted with `basic Python programming for the sciences`_ and understand the concept of objects. .. _basic Python programming for the sciences: https://scipy-lectures.github.io/ Instrument ready ================ The package includes a number of :doc:`instruments already defined`. Their definitions are organized based on the manufacturer name of the instrument. For example the class that defines the :doc:`Keithley 2400 SourceMeter` can be imported by calling: .. code-block:: python from pymeasure.instruments.keithley import Keithley2400 The :doc:`Tutorials ` section will go into more detail on :doc:`connecting to an instrument `. If you don't find the instrument you are looking for, but are interested in contributing, see the documentation on :doc:`adding an instrument `. Graphical displays ================== Graphical user interfaces (GUIs) can be easily generated to manage execution of measurement procedures with PyMeasure. This includes live plotting for data, and a queue system for managing large numbers of experiments. These features are explored in the :doc:`Using a graphical interface ` tutorial. .. image:: tutorial/pymeasure-managedwindow-running.png :alt: ManagedWindow Running Example The GUIs are not restricted to the instruments included in this package. Any python instrument may be used. For example, `this script `_ demonstrates how to use an `InstrumentKit `_ instrument. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/make.bat0000644000175100017510000001506315203313266015621 0ustar00runnerrunner@ECHO OFF REM Command file for Sphinx documentation if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=sphinx-build ) set BUILDDIR=_build set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% . set I18NSPHINXOPTS=%SPHINXOPTS% . if NOT "%PAPER%" == "" ( set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS% ) if "%1" == "" goto help if "%1" == "help" ( :help echo.Please use `make ^` where ^ is one of echo. html to make standalone HTML files echo. dirhtml to make HTML files named index.html in directories echo. singlehtml to make a single large HTML file echo. pickle to make pickle files echo. json to make JSON files echo. htmlhelp to make HTML files and a HTML help project echo. qthelp to make HTML files and a qthelp project echo. devhelp to make HTML files and a Devhelp project echo. epub to make an epub echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter echo. text to make text files echo. man to make manual pages echo. texinfo to make Texinfo files echo. gettext to make PO message catalogs echo. changes to make an overview over all changed/added/deprecated items echo. xml to make Docutils-native XML files echo. pseudoxml to make pseudoxml-XML files for display purposes echo. linkcheck to check all external links for integrity echo. doctest to run all doctests embedded in the documentation if enabled goto end ) if "%1" == "clean" ( for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i del /q /s %BUILDDIR%\* goto end ) %SPHINXBUILD% 2> nul if errorlevel 9009 ( echo. echo.The 'sphinx-build' command was not found. Make sure you have Sphinx echo.installed, then set the SPHINXBUILD environment variable to point echo.to the full path of the 'sphinx-build' executable. Alternatively you echo.may add the Sphinx directory to PATH. echo. echo.If you don't have Sphinx installed, grab it from echo.http://sphinx-doc.org/ exit /b 1 ) if "%1" == "html" ( %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/html. goto end ) if "%1" == "dirhtml" ( %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml. goto end ) if "%1" == "singlehtml" ( %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml. goto end ) if "%1" == "pickle" ( %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can process the pickle files. goto end ) if "%1" == "json" ( %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can process the JSON files. goto end ) if "%1" == "htmlhelp" ( %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can run HTML Help Workshop with the ^ .hhp project file in %BUILDDIR%/htmlhelp. goto end ) if "%1" == "qthelp" ( %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can run "qcollectiongenerator" with the ^ .qhcp project file in %BUILDDIR%/qthelp, like this: echo.^> qcollectiongenerator %BUILDDIR%\qthelp\PyMeasure.qhcp echo.To view the help file: echo.^> assistant -collectionFile %BUILDDIR%\qthelp\PyMeasure.ghc goto end ) if "%1" == "devhelp" ( %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp if errorlevel 1 exit /b 1 echo. echo.Build finished. goto end ) if "%1" == "epub" ( %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub if errorlevel 1 exit /b 1 echo. echo.Build finished. The epub file is in %BUILDDIR%/epub. goto end ) if "%1" == "latex" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex if errorlevel 1 exit /b 1 echo. echo.Build finished; the LaTeX files are in %BUILDDIR%/latex. goto end ) if "%1" == "latexpdf" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf cd %BUILDDIR%/.. echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "latexpdfja" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf-ja cd %BUILDDIR%/.. echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "text" ( %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text if errorlevel 1 exit /b 1 echo. echo.Build finished. The text files are in %BUILDDIR%/text. goto end ) if "%1" == "man" ( %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man if errorlevel 1 exit /b 1 echo. echo.Build finished. The manual pages are in %BUILDDIR%/man. goto end ) if "%1" == "texinfo" ( %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo if errorlevel 1 exit /b 1 echo. echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo. goto end ) if "%1" == "gettext" ( %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale if errorlevel 1 exit /b 1 echo. echo.Build finished. The message catalogs are in %BUILDDIR%/locale. goto end ) if "%1" == "changes" ( %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes if errorlevel 1 exit /b 1 echo. echo.The overview file is in %BUILDDIR%/changes. goto end ) if "%1" == "linkcheck" ( %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck if errorlevel 1 exit /b 1 echo. echo.Link check complete; look for any errors in the above output ^ or in %BUILDDIR%/linkcheck/output.txt. goto end ) if "%1" == "doctest" ( %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest if errorlevel 1 exit /b 1 echo. echo.Testing of doctests in the sources finished, look at the ^ results in %BUILDDIR%/doctest/output.txt. goto end ) if "%1" == "xml" ( %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml if errorlevel 1 exit /b 1 echo. echo.Build finished. The XML files are in %BUILDDIR%/xml. goto end ) if "%1" == "pseudoxml" ( %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml if errorlevel 1 exit /b 1 echo. echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml. goto end ) :end ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/quick_start.rst0000644000175100017510000000465715203313266017306 0ustar00runnerrunner########### Quick start ########### This section provides instructions for getting up and running quickly with PyMeasure. Setting up Python ================= The easiest way to install the necessary Python environment for PyMeasure is through the `Anaconda distribution`_, which includes 720 scientific packages. The advantage of using this approach over just relying on the :code:`pip` installer is that Anaconda correctly installs the required Qt libraries. Download and install the appropriate Python version of `Anaconda`_ for your operating system. .. _Anaconda distribution: https://www.anaconda.com/ .. _Anaconda: https://www.anaconda.com/products/individual Installing PyMeasure ==================== Install with conda ------------------ If you have the `Anaconda distribution`_ you can use the conda package manager to easily install PyMeasure and all required dependencies. Open a terminal and type the following commands (on Windows look for the `Anaconda Prompt` in the Start Menu): .. code-block:: bash conda config --add channels conda-forge conda install pymeasure This will install PyMeasure and all the required dependencies. Install with ``pip`` -------------------- PyMeasure can also be installed with :code:`pip`. .. code-block:: bash pip install pymeasure Depending on your operating system, using this method may require additional work to install the required dependencies, which include the Qt libraries. Installing VISA --------------- Typically, communication with your instrument will happen using PyVISA, which is installed automatically. However, this needs a VISA implementation installed to handle device communication. If you do not already know what this means, install the pure-Python :code:`pyvisa-py` package (using the same installation you used above). If you want to know more, consult `the PyVISA documentation `__. Checking the version -------------------- Now that you have Python and PyMeasure installed, open your python environment (e.g. a REPL or Jupyter notebook) to test which version you have installed. Execute the following Python code. .. code-block:: python import pymeasure pymeasure.__version__ You should see the version of PyMeasure printed out. At this point you have PyMeasure installed, and you are ready to start using it! Are you ready to :doc:`connect to an instrument <./tutorial/connecting>`? ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9965432 pymeasure-0.16.0/docs/tutorial/0000755000175100017510000000000015203313301016040 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/connecting.rst0000644000175100017510000001260515203313266020737 0ustar00runnerrunner.. _connecting-to-an-instrument: ########################### Connecting to an instrument ########################### .. role:: python(code) :language: python After following the :doc:`Quick Start <../quick_start>` section, you now have a working installation of PyMeasure. This section describes connecting to an instrument, using a Keithley 2400 SourceMeter as an example. To follow the tutorial, open a command prompt, IPython terminal, or Jupyter notebook. First import the instrument of interest. :: from pymeasure.instruments.keithley import Keithley2400 Then construct an object by passing the VISA address. For this example we connect to the instrument over GPIB (using VISA) with an address of 4:: sourcemeter = Keithley2400("GPIB::4") .. note:: Passing an appropriate resource string is the default method when creating pymeasure instruments. See the :ref:`adapters ` section below for more details. If you are not sure about the correct resource string identifying your instrument, you can run the :func:`pymeasure.instruments.resources.list_resources` function to list all available resources:: from pymeasure.instruments.resources import list_resources list_resources() If you know the USB properties (vendor id, product id, serial numer) of the serial device, you can query for the VISA resource string:: from pymeasure.instruments import find_serial_port resource_name = find_serial_port(vendor_id=15, product_id=0x12e5, serial_number="sn56X") For instruments with standard SCPI commands, an :code:`id` property will return the results of a :code:`*IDN?` SCPI command, identifying the instrument. :: sourcemeter.id This is equivalent to manually calling the SCPI command. :: sourcemeter.ask("*IDN?") Here the :code:`ask` method writes the SCPI command, reads the result, and returns that result. This is further equivalent to calling the methods below. :: sourcemeter.write("*IDN?") sourcemeter.read() This example illustrates that the top-level methods like :code:`id` are really composed of many lower-level methods. Both can be called depending on the operation that is desired. PyMeasure hides the complexity of these lower-level operations, so you can focus on the bigger picture. Instruments are also equipped to be used in a :code:`with` statement. :: with Keithley2400("GPIB::4") as sourcemeter: sourcemeter.id When the :code:`with`-block is exited, the :code:`shutdown` method of the instrument will be called, turning the system into a safe state. :: with Keithley2400("GPIB::4") as sourcemeter: sourcemeter.isShutdown == False sourcemeter.isShutdown == True .. _adapters: Using adapters ============== PyMeasure supports a number of adapters, which are responsible for communicating with the underlying hardware. In the example above, we passed the string "GPIB::4" when constructing the instrument. By default this constructs a VISAAdapter (our most popular, default adapter) to connect to the instrument using VISA. Passing a string (or integer in case of GPIB) is by far the most typical way to create pymeasure instruments. Sometimes, you might need to go beyond the usual setup, which is also possible. Instead of passing a string, you could equally pass an adapter object. :: from pymeasure.adapters import VISAAdapter adapter = VISAAdapter("GPIB::4") sourcemeter = Keithely2400(adapter) To instead use a Prologix GPIB device connected on :code:`/dev/ttyUSB0` (proper permissions are needed in Linux, see :class:`PrologixAdapter `), the adapter is constructed in a similar way. The Prologix adapter can be shared by many instruments. Therefore, new :class:`PrologixAdapter ` instances with different GPIB addresses can be generated from an already existing instance. :: from pymeasure.adapters import PrologixAdapter adapter = PrologixAdapter('ASRL/dev/ttyUSB0::INSTR', address=7) sourcemeter = Keithley2400(adapter) # at GPIB address 7 multimeter = Keithley2000(adapter.gpib(9)) # at GPIB address 9 .. _connection_settings: Modifying connection settings ============================= Sometimes you want to tweak the connection settings when talking to a device. This might be because you have a non-standard device or connection, or are troubleshooting why a device does not reply. When using a string or integer to connect to an instrument, a :py:class:`~pymeasure.adapters.VISAAdapter` is used internally. Additional settings need to be passed in as keyword arguments. For example, to use a fast baud rate on a quick connection when connecting to the Keithely2400 as above, do :: sourcemeter = Keithley2400("ASRL2", timeout=500, baud_rate=115200) This overrides any defaults that may be defined for the instrument, either generally valid ones like ``timeout`` or interface-specific ones like ``baud_rate``. If you use an invalid argument, either misspelled or not valid for the chosen interface, an exception will be raised. When using a separately-created Adapter instance, you define any custom settings when creating the adapter. Any keyword arguments passed in are discarded. ---- The above examples illustrate different methods for communicating with instruments, using adapters to keep instrument code independent from the communication protocols. Next we present the methods for setting up measurements. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/console_output.png0000644000175100017510000012401315203313266021643 0ustar00runnerrunnerPNG  IHDR@sRGBgAMA a pHYsttfxIDATx^Ql$O~yg${V+[UnH^J] C;~Ia$  F' $  KHP/'>4UζR3FNVRo'YȌ̬̪dM"##3#~9ۿ۷՟ٟ??5_7yoW~KO$Rjfffԧ>e^3|I>߾~~[j?f0L0 n8A"@eF2PO?g*C(TQO_u?ࡘ/w}[ܟ?PҏԿQ܆$O}??/2~s?>Ϫ/TSmwcff5$Nb[?5O?'2>~'OyoNlWӷ_ 狼7d"uv_k?CR7YF-_0w+?^S_? =/Ouq _U_U~!x`~6ec%Ͼ^w'z}ߚ,z3_S<#;\T`OOz NOW~%{\WoQ#v9ݣ 2%:%Q֏؏yqo ?o.>G&m2f}Sk^^o!uaw~W:-/Ͼ]w(̶-}K| }'F< u( /ϟvm^|>OjeeooGo~W}7:74f-3_Z3;MD}!o-e.z4X_S-}n~'!_VLfԺ:7_Wtot4t "%Q_W[yS}V%"d~0ϫC}[s(}k_W_1o^W3_oz2i~!4OS:`/7u:~o_֗7C= Jb7.UoH <T pgy?\>jgg\({'U? [ȗ}x+&g"CdHZLǒO~K4-_x%t~׳*:V;3^0iClRU5gTӧOՏQu?~LJzN93Xpdy2}sT)o|)u`Q9Q޽ &0WU~Vׂ`Կ,/sIYv_V/}G}r("-`˨T;.BFlw3o*EyߌM ܉" @?g,\~~w,GGe% 5^_|k)T:_$_?{2)R32T ]&\3ax3s[}Uo UJ DYUr _`s9ɷ-?P;/eѾ~>$~tCoZ i|74vE>5u >y_ضkbW2K߸P~ޮwI}+2>{I|;5p@l3?wn_M/:T7|M> LouF;_W/SO {`p9?b("s0 W <F2PQ (T`*C0 !@eff+[1@eF2PQ (T`'?F0 @Tր(@e H}zd<}g$F pJOB0 OR3_|wǏÇoŠg*C0 !@eF2P/>{v;WGkko{)=PQ (T`*C0 !@eF2[VWt_mQ<_* Fmӫ+u53]=[ffԖTHt-57s7f_zMPޛ!0I3O 0mퟚ:T8˃r|q[?6B7N#OTQCuƺZv(孤lPzff~~V+tM?7{$]d(?ur|9U[yz{==b^&U?SEo#nƄ5/-smRUqJ[lTzMIi'kҮG~}K`9UYWYDTM^_nݩZvwIz'\UjWqlVHt7dR%yR׷316 v=vjul_Rp4Ct~pM/9IWWz0u:\mu쿁2>VpnZĖI},׋5?iףi>ޡ %l_z]u@mtUｷlnǦ_lxYϐ[}B ,NdRމ.|`/_~`g_N<%^o#=e ;ʕۤ|<1o./<޳3p׻+^\߃ce+G]'lҎǬn,~9u :'!Oye7leŷ%^9~;ח7%iz(#)eU_Ǐ~~Ϩ/3gOqPk7/^ݢT}%}؊\qAq'2?IBWfڱE#͝Z~){Ƶ[^ɦj }Y2Lԋ.G=0V~mw_wxEu7Uu\m%6p1b^Gы4O{dc|S^a/v0ɚ>g^^WC˾^p fQOWQyZWǵ^g烊ܰa+Oc?Ԁ4LP~:SCjR7/OhlƇ/5떞c1(oz]TAPZLzLCR/P_IxD˟b{e_hƆNKO;3Oܯ?]?u{]4w0{ޫ?,4,kqM ==ZM5ޅ_RެU7xו9J.fJ8RyW1KX_ IӐX|^C<""S RVDz-cpXI\]aI8ߖXv-oyӓU뗻i/Y\r﯌wOg?'x,SeFbޫ7&%G{Gz 7ɲS_-K*\ӕU\\si44:Ma~].ԦgBڝRχn{u8p\^3'cWl],:߼/YokKy|c6Vz2s>eg! Lp~cҎ*=]ڌts:j6ɲdϠ翼X^o^9xKTp]3z)$Jރ u'(w$s7'=+zP؃(W >q܍& v~]ǃrҒ.2[iud9y\Zwm,+]u{Kg J7r8,X fU_ܻ"u|--(Sz2wQ8J VVTd;u3apqRT׭OOVyχ|N+]8_J3icEj ՌhGR'0C'1롪^g;`ԇWU8hdP[nCӟ}z?Dץkaa ..ۺbW3jGntTk>ۗ' ITeK)? i7ͻ.~};au* A7K /a{uTX[^kgU|^ +i.G^BA``c?>z],Z&%~(4DdGK7w[n5<#Q0~6f^!zBe^'IXKx!aktݕYzyFFׅٷ7lg_V˓Wd=P[`QݑAO;eHKģ<  Vo~օM)ӺR:C ;};JO/OZ#e`?EJO{2ƽogBqnsc$k#a'mʖ7Ѯs_oiuXza+͜i3w+ 3v|]eʽhYmO;lD==H~ xĄ`fbLʱ&v~Ėp~s4z7rzfҎ*x=u>žNU}Ҕ^(>WdD^U*z4_ӧ=}λaBz$Fef~CY㏐O#M9*mpXGxBmcȄzJGa4dAJMd?۟oBzSxhOJ z)m/ ޔU;<͵Z>)?ؿaCK ϡߑ?^׆^$e0<}K;?)~o][xҕPŴOWy_1~J޸3+^zKy.8&ǏՇߊ\.;A^Dh/*AUׇы2^3IOGQO3~w ck6 Kڕ.e/>6.ߍ\);pMմe>cʳYoP3|Į5ޅūH:LmWM'YvݿERb=e p"?WϷiZs Td)e&K-8~J) #%/Cʵr[>+u.%h]-uem%.&x")?%ׇEYy^^rNSv \k=hQw!bڤXd{q>2?}-u!&`{Fql&Y=*:1]uv&xঽ?4jq>$|w=+LT=$8bQ>NhOL{3 QTl!& ?zF =0F2PQ (T``*mӭ97<4`,+uuffwﯙ}u>6~:U[s?N_FMGOw<}T& p 斷4&_N{4nOrA9ݰ9Uڒυck~1oGӡJO60<PIM_y4*ܖgnt6,oQIR|#ZmNI ؞ױ5#^Iu$_6eVA Hqn`lj5Uojˆپ(;iNL49Ի :] \4icqMT7eF=|Cgii_j_Q}!ڸ} ̧,n޾'dq&-Ay0vCw`wJL}sN>l_']tʚ{2L yV==Pϟ?7~G7(=8/:fiU_X2Ft⢷孾qm3僚gvsGyyOAgQ^f:MݴIj i<}C7Z)j[zojN떾6ɥT*]'_wkP]/={Ǝ|G'Tߐk\mٖQ%P e^gWί7Z3hTnWu8:3w-C~Z%WuZA%\%2(]^[3StzW HW׎tq}~vMK *ʵN%Iϓ+J'GWy'YqFzY7:a#g re$ :$ 4X޼ ^m,ٿm8R7.~;u*ܔEAﲽ.?Nyp_׏t_>G߰2$z}&גb>6WTgcMrM^z> 865@& FIOΎâg*ڈ33sUW]r/YX@fi{~v9e!n^6=JrE '<); 42Gޥ93'.,=V&2/zJ1.mk,% kM%_6(c3W~\Wo|3޼Tء3uQcɍ.L+JD͡0]:fx~ϨT{ K;I^2?nԶU [KdZ6#w_9NƺΚ?=^- ܩ5y鑊7-R]Feb{;2I9dRy+e S:қlfe'yo|xO +4q I{/st2iEjdN4r>[PZc Wʙan[oxFU >T&iNiYmCeL""c? 6)|~?a>2TKXG΂$aG~9Ȑy㺿˞2|O\x<7~߬yUŻyo2u܃wqSL`..mFP-Nn `\^U:UȽy&:~T6zzHű7TrUzI*ͤ zFu/lp^BQ͟T7oU$%^OWMG" A=tww;:QKLH0i<n!f7I(Xz 31o#=edcm;*#?6IkfK'ea^QK^{s FyjakS~\WuӍx{ϿoX1C.M Lh0PXjKI"Q%p޲wzbt#Hy̝;ɓ5*=Y3 B 3nQYz~N kF[hO'gO]{mxP{^&_n$ɼV7\ȣڼڱO/~{Ȱ7FczJ}-yG24?׏2Y0S^m:ڕ^/05aysI!A``5M9y,\O/'`VPU LIzs.[lt^wz>3dg5є2/G=l/'a)L`ޔF& !{ۦ[in6y4LF+ a};ɶ4闉7Od8yҠ<{vW7~L i  fLϷyP|o1|x_z d*#=0A?!͓JݽzY//s+VN$)COxEe`6EwX;_r)RmsuaQF'T62+?Y#sogvvyFL|y%u,J_V4=^YsI[Xvǹ~GbD&07A*:7Ԩ?hU8b{1Ie,)i1wY ټѕqQ %)7b=|V1fȚXwXe33lP~/!;M/o}\Gҽ+C>?LzWloh:~1x>H)oYu{r)N{;7p==ust?4aQ"iC'!#3nY1()$;> z3>yக3 IbzabuՌNd-;oXK{pIwnF&y{ +pyܮZeX̛T|7 o(ijO42oۆHp)nQ^vvtӱq1YԉYN Gݮ>Ux̾W5g?'C.rO-`r=}$W: 2Tҽku(N 0S/uHhϩ> \>e݃mu>wRޞL%Z yۓ5*M>W#=!ƾ|G'ޔ69k K>e[{T2 Q&(uvU{S>o5sGL䶪O`eRtqtfcOROr^kUσa>:K^eQf!kūH>1# NO.Ê|thqSjcrݿvT0VS9.=3]1/[,xs8Ϝ#X,Ӓu:]e5?,oI3"8cjrݿeOo#U^6WL_RXS׼O8.M@-P`R`l(zkC.N{ġ933O2{M}'!WwaّݿR3צr5gPI.hw7Cd">1eO"FƱw}^]z>3zD{l+n.Zgaݞ0TVru (Xy+ lsM͝ﺼ+'S>Wn9yǻK{ }O؀|^_3KDi58G\ϲjH꽐k~]~u?]>'z*|~ez}y!_sʽy^StKyf&tx) ӥ6r=*Ӽ^ٰC8%m+_j<{kCưq҂>8k{4piԤEGN޴Hu+ዔ rȤvW3A+]M6N SOEڼgTt=@AWhF'ֻtFҟ !CO͟_V L JD[.wo½E05q}%G"9P%=nҋ@'(}gxnfj|{OcloppZ%%_&56:v².牿Fʺ~FtGh5?*=?'xw%q///34+U76ח)| Yxͳ,v=*3ZRypYnY{G% SpB޼7:vٻX ӥhJ|bzaC*'Ct5}O PST Qck:9y?]>'zT5^?8]Cx{ϿoX1C>V4Ukf,%O:xEJկ|:]SvO:ωD~r0Eҝb'JΙ^c,`Wz ըu )zwM^Je{VOF'T3赐Gyc2_l4MH:'#YǑu{~z^YzLWs\8ɖ`cLk _|r,[͏0gWY>1ǻm8 (|[er2[rgףbWTwZOlQ#M)e^o锞hVL`ޔ\&0Č9٘[;D@*ʅp؉N-~e"G(%Ae'N4(>1OgXDM`]eAeHKe糪ͯwY{rFM5vt72gKoׇCRWSZa7ٺa[=O[64*=o+S̹?+0lLVyxP{>TU>vhLMLZ-K+|{ח暟U2ڿ%OQ׋IXeLRZ8?īo-g*Ꮸ/,xZ5Dyr{+FIlox]N0^g7202uy;,oDM_S-!B&Oh觿~/Mb먴XZ;\ɓG PLK]u+|7~Ѯ7 ><ǿp%L"?. HɓL@*^yb!`/oi~1iʐIz߆j?x˅'dMkצߞq8 g9WIEU#|>L(kTxזv:\YORU̪|KO #3i#o9]\_R,u]>G%_/&>c+<_,N G^$dF+ޏ0;$?晲=+a4 Mo}EJF14z"INNӈ JOTdV,ߝuObb糊151k<= /ܱL?P |n:Y#\_*R1>0}<]M=׮ywsknpTU>'}8޽"_#e2Ϸwu}KNϒ[2˧$g V|+FgEO+g.ǦcEfzcU3;>|i,I JtQRwzǺgxP̓el=-$ ^.f$zEECd^ ݡg`Ȅf~3z\)T.D zV}D($g(T`*C0 !43OښLSu5@Fc}5C_zoZ޿RWW,~>|VH(s' D }ծ7j# FVW_׀F3OR{%6\t5si\c+KF:?͟TMվLɣZ ?BOYiZ^?%tuw6\8y=@sk窵\=_mp8Ns@F/w]lӻxy_귱˦t^߸>%A;(cn3T`C=qh`+ke7A, KިՁX\ֿqTc}pAz~μƾ閞]󨟎Ϣ*6 FYNS7-]]}1jz?<~RL(~H珔!ɣn\1=z:\BtSOJA=Zcݡn$=BoV:d]uxT*YMO-kfҺ]t7CkjfѠPQuw .Iz<7^W:v?t^R;ɲ䏫$tE8J>KZʤ%HdSO#/gk?V8̳!6Jӟ;O?oMO\ԕ/? ?<4mׯs?!x?eY/?NlpIڣsվ_NYnKy7r>Z~.<\w_ViWxUp=xHɺVIL.}d_mIZJn{4k<e` [ 6̜<?&g_r7҂w7lpQJI7/_`'eQ^ ѓ}k2ǤC3=RZq.H'㕓m|m& K*ܭf! ԋKowz$K{ `fg]nl; y 2v;' [>7~e{Ie;[wg/?\7Dr|_ïG^XȞ͗?SK蠏{8^nzՑ*J&7^JJCzLG{ek[{ vncv5|b_dXZcgMןzt=NG(:=RqykՊ+&#QC&OP_Rv 2u_ ɟ4-u`{sy(1 #+AY7L>j^a `Bf~6?̫d{pt{ap l{AweN5ݽn8lX6/Pys;l92C"{ɉn7F-N0 d'?&-f;m:v{ߑ8*'YˏT~s=߹|?َ<<NjQzRFoʥʘuY>OOy뉮?\{zx>}Շާt{d'}\<]ڌteHc~5 `\^U :U;_&ްj4&UOOS8ʙȡ1cÕT^A7v^n~Qw 7\$lyg֪{koɶ$[zg"XS㶮 ֵ6HM"VqlgKzʾ*4鿽VGZ!@j{cʃ.Y_Z݃ذqZ;v`cY74/t2m!yyj\r?cg/?Nϸȟ\WQy/?޾aFhUuh0JĂP#Wx7 읷^)Fav<9ȏTև=IL H_=*=Y3wCR3nQYz~KsIxCQ)/3?j$ C2u *؊ WQeo~/*߼U*_TBOJm\-SdYA"a{V/;7ГWb(-\r\}Q9ҟ?޳'cg_UO+NjQ-Kz\w~w#-Z=i0G7=Op#V7q~*|n_p56'`[Lc9{z.rku5TIZUCC?Mo5ߢnfoL![v찝a3a!h&37}b~ Lx{GW6ص =2}vOdQf ROmnoVfxGz?˘"ҟ5=iduQX%*xrqwEʣ7$"|gzI91ӑ]`q|XhQCD>~]zT?eKn?6@ΟU\N=9{2I>^2#n=d2hJG-.'a)&g87O"^@f8T|G,Ml/NdȣerPXxIl[gR0c*ɲ -RbC37Sp=};֬Ok TlWz $aؑ+{'me4]r~(CO7 {g,Q=lI{Ғ-R'D[\ )?C-qe{| ;NR$ծ[D\d?t= 97u! PͣG0:^ؓӯ4bB& :1k%/w/-yxBcf'`O)}>|id  tZ⩩ե1kg^,d2 dhYпȱn>im{#<,!4Ӷ&YQ!.S~Ү/y8N{|e=N@Tqs^ ͛?y_A]4fQ"iC!)!YҺ iNPv=},{Or+6 ڑ^+qx(L& <wmҎGGzN_[ut.iI>~>|VH(w/,S-f.(Gm^W]5OsW2ol絻#K{8(F(`w=M'ج{[Ȟ-3o"52W(6 p5id.Zr T1sPv=AfD($g(T`*C0 !*63Oښjmӭ97<4pF}5C_zo򾺺z q DDe& =}.oXFܲZߑ]X荒mu~}뿓̜ZQ+:1^<\_Qy%7||X& iL]6o!^ u}O2AҸyV&)"\w.: YtvutNoJ];[er26ٴu8Gt?~T>|+FgS ԛmu z[WVfR/7Tte o'Ûd.u򹴊\鱕f#\1 O*_j_Q}A-τޟ} ̧lu-::;j.N'A^s|5U(cñce\W+]ޗ[\O]tʚ{Ѻ@ɂ`)1z{?׍e8wzs0ӕٍcV%~o{sW@m,.z8Pk>`؁`?g^cuKwWyOAgQ?l_GݮtUx̾W5g?I?R#eH(=AvfzV ID~IaePM(^k^rLe[ $ Q&(uC[jTT&S[eF_W2VjLuZAKz%2(龾f![z\^?/Lw#]\; >?T Zi{ xcyzkMg+޼,KzHGYtQկl]eZy&۷Ne`Su<te̤[o2lМy?]IwHXΚ ϝ~H(O:5az鑼\7W:=˃w(oV<ʖ~WiOFn:u 9Iz^cOS!6뼹+>^!J)ϓ\ Ⱦ\bOu6"SHe{4+:e1(эh#zJў̣+ECj6%w ,-xw{Q q =~R] /U8=o&+#L:4C,7azK0J=R/.;Mxd`lMf0FcpINa#Yn0d%ߥ+Kt6ڒ?|JȲv7.Lj^"̰0@ $9.u1e /Y̧6^8:1f+=il4u;3vN0ldg+˛aavKJyp<볋.^6+e_鱴 ZYhXƆ9O»N*mSw=]D7~oꬽ2 ,c#z>қ&S>8ƯM20E&0O6A(]Y9:^s4sW9}qq{}VzT+xþjLT==Me*gz-*w$eWRfRy zF%/lp^BQ͟Q[a5>}$RܰYVxmjyaTYeA9 m)Iٷey{.Kv`Łzc|R4$c^|&cyWɟ~GYs.]3!y$N:3c_=̻NԐE&W 0@PodVh(S4%%bA(yב+[ΤwW#=j0a9ȏ4f=iMnk zaTz$fj:gzݎɣ4PZNyVea葡/N zuWӐ<-K4!!?BAWśN|k2}t U`/e˚yRlMa9^us&H[Wа u{'zdx0̾oD{a^(kX&#n([*wADH%U->lN({56Qs^e5=r׼D֡CǡCğoQA7~3TO7-;kv̸ømP}'Oo.}oأm(۹^̥6>IuhU$;oGSqO9$`{qxޤpf9H f*dnXV%k>\zG$?ɽ9y0r!G) w8m7(\"Uy믦Jf 0\wVRGO#e׻ס{#ay7Y+cj㽈V{/?S r}a=!ΓiϞݾ}UPM  S <L ?+=T^ iXGAZO2 OQD]JMO<HCG*z.,2߲ FmjT/-5h)Q2gdI^>i/sE& #ЕIʳʃc ;7le_%SֿI|V!޶adIH_տ. Os/?]\ʳ~i鉗?+5s>|Q} ̯fa/iAA5Fi1wY XQ%(:]iCobx7YnW$h"dMOdY:- ,_XȒ>'e^y@e?oyv)e !aiu?э矤]7R@ҋ{zaqs: =!LGHAF%1i2"?K&eNJ T$3 t6ъ S3Ûv^w$yh %k$VPϨ!Q4&d޾~1tA=6]>EQۦ7]]5O6'Pd0;8WK{pIx/6-E +;O}$eik+HbKauxm{9;x=A{pwDT#@eF2PQ:3sjJ]┽dnTnaȃ`Uju5b{@efy_]]]I}yJi5 D:=C>LmR|ٳ۷Z_ixqٮj_o-iۅe:V׷;̩OKϖ5X~{_ɻP׷4I@,͓ByU{:jc( ߽?,~.}SjfnKVa)œ;+ulQӊ-7.fft2y/{_ 3y/?S>t'a6m݃S[1"=LOf(%tle 4ۺ ̈ZK<^/ ҍf(%mjb9n4awzu5eheJLj\V竭QO;slJ J#SB ի{}9Q?ly#b@^)`t1{{?׍q8wzs0ӍэcV%~o{sW@m,.z8Pk>`ؐ`?g^Epޥuau&=mmԯ GݴΎt CKKQ6gmY Vke3ڟ^=.6#jsE ?3tsiWeű *+eU0ɚގN kJQXzaP.fEHg/3gԋˠGhpk{e›uA;T{8,UerGzKI.vP=gSH#A##=KFI.lU>Q^ϝ^Grrfi uc5]zZrz?&%=yJ2ގ0xP=dR!?qhuռR|S:d5ePHC-vd0s]ZCRءPi ͆,/iD hx %5_P 8Sh:Uv 5$fzpŶwc  rYcemJ7nޡY{Ge8>ӃoޛL$8-bf47;Y#&ׇjUN @o^nƟDjLd<=Mycd2cÍ̶d]QA/7?ب^M.K6|X?Pho>kuZUiOcB3O 3æ0̚Eֽd 6s㬧-bd7TFo!]Vg^gW 0@Pod?,@4%×bA(yؑ+[g #T]쓕$u"(i{)3$ysWUmo^`O kF[BO'WўEzXL%p279ڕ^89mr'{0?W/$ϸw*ze|^&Cni}/I(}}J~| d{ uVmFIg&%A; {B'-VޖdoRf2̐@T9M"!H4OUJak e7) q #/mRLǙ3;1:oVN?ϳhCf|dRzY ӻ8Y7WGr[dIx .${)ƍy̻~OǏÇoňL`~}j 4v4M~zNOsђ_{   ε2Y@yN![7tz7^6{xO+v43lM6ʚ@췵6љ2D΍+1i2"?K&0Rgw}R+g}3 F1lEyҟ꾒ڰy=oa@lFpv{R2\PMY>lڗ/8ggdW>xHINRz-ne2ø ʫ^\~ĴSHϨsZ}u1 Fj7ޝLO7j//UMTgcQ=\7ޥ&X=t.=/ZL0/w&)*{yn(Gu]@m,zܾI_)\?zީ:,a,aӾݻVR Ց*Ci_LZsc'm Gfdj: vu 6U=iOO%!yz,Fڏa4=){9i p]>^SՇ=$Ҕq<}$3O ;L=Wz9Zټzޫ72P* ˳|˳|ش/_>U zͯ&9iQ ^o.nAj/70Vy^ZеΞz}|^_LEi/?Ӟӟ=}iyV,Gr%;n|`~.J!\<^H+XP͝ͱ#2\jh!zCOcvXno ct, H^K (].{b<~buWa*GoՂ_ DN/')\~K.tiWxkxܽVB?Y^c̣1Kn[Sz:^[5%|Iokm D -g5we2fPꋫT&:).],o"]GYe9,׺z_1h]Pz#9S0E~ُ&6D<ˇ<ˇMM걭s}͍?_ I$\#{\Uև'l_WNJ5ʬϸU I> Q/p rleڛFvNC/ʎgygy_W\wvԊ~( ԟuv!w???)dqɟLZs"( LF59?ćYMC:hL{U"0#Z7:#}akuI3/;?Pl([]0=68a@.1\W~d69˜6%d.UMdW'ɛD{E|_MZs%˄ͦ]2bS'!E}aP5gSvW(PVM7JzspFw= x3]&or+`O~0ச7\5E2y}!=wkYY.nx@A$/?q^~O&9i 3.G:%(mnr3gSv7("3\x ̯Ǝ(ύlAJ$#e[N,}qUM+^ L֪캼:hYH?ae{:iꤗ9YycmA&3%?7c_V9 ͗džY>Y>lڗn= xoތ.o+DFi/si?aeǪfHO2#4$M=02E ғ+>/~٠jϴg%w0JAW˶Z'UqЭೱn[(Xv+(9:3={i6;knԣ~(v΅̷~t'r7sϙmE3DrY><HzƲwYzO1|Dwf^$,oqwX~8c^O˒F8ZO\ 2lغAvr?WY.C +?N}&Kz_n 9fW1Ov~p\Io +3'E7=Lfc%CdF3.-B?mu:?'7gRˇٓ9 5=UկJϴħ yǞ6}oo=\U2gn߾ 3}R$ .oI[5M !?L,gUѐ< ?~T>|+ƽ3w@]5OseX$  Wk ƽ'`6v!p_ƒavz?jǛ^ 990F2PQ (T`ezN܌.LSu5nT\OL"Qf_zMPޛ(3ꊊnx^CO\$\ffԖd9=xnΌ~TObhS0Q"9sG4r>=WUN/wsnwK/n/JW!կX>D*QQVg?sz?H9_.̣\(?(ܖڑ@T@w\w(^n趂aS_"XW( ReC9*Hw!;Uef{.9z߶uKO=Xq<|bze#_P,{2u/Kykױ_KP9:?7Ϋz8_*xd??n[,<.|;ow99Kz]tN}=K*LJTTORb`r$L)E@0J.e7б7/_{=wzq6j샳MOWKwGM2<[%d}oGIi\ ƙ S:'g1=R f $MI$-a^.s>ܞ/=wvΛ~ixo.Ӳ / ,I xt%vM͆ 򳾒x9+dnEҢՖ_t\㫪t7菬G]5/b=<>o:yob+"VP= s+}qq{}VbzA/L>mM5i)oz [&yE"6?mV3&C=m`2=叐2<6Nb͆V:Ѵ芵M~.sRv{}m0vr1VJ|FБ]~ r)?ӯz筼3t^$s瓥u@ 6,Bnle<9;J{=޶A+XWycTsuQ~y˙%KyW'I9wx>__C aaMCY|u6':|\ӯ*^ :d8GHPAn^&@<.[ёMw^W7M4=؁鑹 ]_i|o*˛V'Oy({v;ssHLo''OH0|^!COzȇWwaӓer Nd^"-Kȓ miHR&ݞ.o26{`ݖdEwN|!=.kDaSx\`Ske_FO,?Ϩpũ8?8w>pyi%ĵwvHϨ97vUgw[q|Q}Q&mݨ~DMM^_UW[W+K˶j6P15xos(;<&9:M3݀թiir=pNOY\/vdޛ5M ̅iIm4q~/g3Y^~|7i-'ϋ#eYd.Su8ak4'֩%i1s y`'ಽ"KmǕ՛K6+keH7aA鿅SdݿyʛKGʳ⮯`+߃W^LAB;M_ׇM}nO;o-m mLOJiz驎SuGs$ʐ+'lx=ά4`:6]j nQmh~ړ!z$ "A XK"T/\^)7zw}V~mw7d i]˛Rd:q.Aݎmt.3idyIg8dud9kfkyF;6A/Є[]zΧ\{=8jw\Cӟ}z?VXHݳBɞ|e[7kaBZડKܸsɪL)'9_;ٿy*zjI,roǗdt367;/_KsI7rNJVރ'=n5<# zfbxC=7"V(4]z珑?ESCuZ5C7,C'ۈ $0`ZCOtf.9[dfS6 I1(Ir qc)OGq8A&o~օM)$<+;ݷ޽Uo$swt) Æn.^*?eҸmQ;.uNq?̰g6xe˛h7O&#VU_1l2mQ[_>E˲l~ڹ_g[&>Z=df/PLt{GyXi$ȵ)%7Q(=ް(2% sF#ͰI^^&M3=Rnyc3VCzC]6w9.+;A>S_>}?)e?s99?(wؿyʛk|R~VÆ۫/=,ϓC#!g .??>#2<~Tx/r]#)=^UJ*UkU]G(Hz:꠰kJyl4딟dXO7oɰ]^V"dqvnl岽xCݮ~_v6<ۛ5|nmcsY*?YI@l0LmL\tݿERb=e@p"?WϷiZs j 3.{]L۞ z@糘.^2|_)g]fbym&YϩUgGL6ag}3dpy-`л{3 Qޜ:D($g(T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@e>{{@|3#P.zF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@e>GG@@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (T`*C0 !@eF2PQ (8O ;(8K 8 T@.Ө@ '7p *8QpQ`rF(fPYQ`ƒ5%F2PQ (T`*C0 {?O4>ϚW>~OD}sSw=S>|sg?~}Zͨ?Cۿ[w~>3/Ќɘ?ӯ?~c=V>>gԧ?=쏪?~?!|?QiOt渟ޒ}{{~_@kҿV~w?3?w~wW_J5}IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/graphical.rst0000644000175100017510000013070115203313266020540 0ustar00runnerrunner########################### Using a graphical interface ########################### In the previous tutorial we measured the IV characteristic of a sample to show how we can set up a simple experiment in PyMeasure. The real power of PyMeasure comes when we also use the graphical tools that are included to turn our simple example into a full-fledged user interface. .. _tutorial-plotterwindow: Using the Plotter ~~~~~~~~~~~~~~~~~ While it lacks the nice features of the ManagedWindow, the Plotter object is the simplest way of getting live-plotting. The Plotter takes a Results object and plots the data at a regular interval, grabbing the latest data each time from the file. .. warning:: The example in this section is known to raise issues when executed: a `QApplication was not created in the main thread` / `nextEventMatchingMask should only be called from the Main Thread` warning is raised. While the example works without issues on some operating systems and python configurations, users are advised not to rely on the plotter while this issue is unresolved. Users can hence skip this example and continue with the `Using the ManagedWindow`_ section. Let's extend our SimpleProcedure with a RandomProcedure, which generates random numbers during our loop. This example does not include instruments to provide a simpler example. :: import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) import random from time import sleep from pymeasure.log import console_log from pymeasure.display import Plotter from pymeasure.experiment import Procedure, Results, Worker from pymeasure.experiment import IntegerParameter, FloatParameter, Parameter class RandomProcedure(Procedure): iterations = IntegerParameter('Loop Iterations') delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting the seed of the random number generator") random.seed(self.seed) def execute(self): log.info("Starting the loop of %d iterations" % self.iterations) for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } self.emit('results', data) log.debug("Emitting results: %s" % data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Caught the stop flag in the procedure") break if __name__ == "__main__": console_log(log) log.info("Constructing a RandomProcedure") procedure = RandomProcedure() procedure.iterations = 100 data_filename = 'random.csv' log.info("Constructing the Results with a data file: %s" % data_filename) results = Results(procedure, data_filename) log.info("Constructing the Plotter") plotter = Plotter(results) plotter.start() log.info("Started the Plotter") log.info("Constructing the Worker") worker = Worker(results) worker.start() log.info("Started the Worker") log.info("Joining with the worker in at most 1 hr") worker.join(timeout=3600) # wait at most 1 hr (3600 sec) log.info("Finished the measurement") The important addition is the construction of the Plotter from the Results object. :: plotter = Plotter(results) plotter.start() The Plotter is started in a different process so that it can be run on a separate CPU for higher performance. The Plotter launches a Qt graphical interface using pyqtgraph which allows the Results data to be viewed based on the columns in the data. .. image:: pymeasure-plotter.png :alt: Results Plotter Example .. _tutorial-managedwindow: Using the ManagedWindow ~~~~~~~~~~~~~~~~~~~~~~~ The ManagedWindow is the most convenient tool for running measurements with your Procedure. This has the major advantage of accepting the input parameters graphically. From the parameters, a graphical form is automatically generated that allows the inputs to be typed in. With this feature, measurements can be started dynamically, instead of defined in a script. Another major feature of the ManagedWindow is its support for running measurements in a sequential queue. This allows you to set up a number of measurements with different input parameters, and watch them unfold on the live-plot. This is especially useful for long running measurements. The ManagedWindow achieves this through the Manager object, which coordinates which Procedure the Worker should run and keeps track of its status as the Worker progresses. Below we adapt our previous example to use a ManagedWindow. :: import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) import sys import tempfile import random from time import sleep from pymeasure.log import console_log from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow from pymeasure.experiment import Procedure, Results from pymeasure.experiment import IntegerParameter, FloatParameter, Parameter class RandomProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting the seed of the random number generator") random.seed(self.seed) def execute(self): log.info("Starting the loop of %d iterations" % self.iterations) for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } self.emit('results', data) log.debug("Emitting results: %s" % data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Caught the stop flag in the procedure") break class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=RandomProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number' ) self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) This results in the following graphical display. .. image:: pymeasure-managedwindow.png :alt: ManagedWindow Example In the code, the :class:`MainWindow` class is a sub-class of the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` class. We override the constructor to provide information about the procedure class and its options. The :code:`inputs` are a list of :class:`Parameters` class-variable names, which the display will generate graphical fields for. When the list of inputs is long, a boolean key-word argument :code:`inputs_in_scrollarea` is provided that adds a scrollbar to the input area. The :code:`displays` is a list similar to the :code:`inputs` list, which instead defines the parameters to display in the browser window. This browser keeps track of the experiments being run in the sequential queue. As a bit of background information (for basic usage this needs not be known): the :meth:`~pymeasure.display.windows.managed_window.ManagedWindowBase.queue` method establishes how the :class:`~pymeasure.experiment.procedure.Procedure` object is constructed. The :meth:`~pymeasure.display.windows.managed_window.ManagedWindowBase.make_procedure` method is used to create a :class:`~pymeasure.experiment.procedure.Procedure` based on the graphical input fields. Here we are free to modify the procedure before putting it on the queue. In this context, the :class:`~pymeasure.display.manager.Manager` uses an :class:`~pymeasure.display.manager.Experiment` object to keep track of the :class:`~pymeasure.experiment.procedure.Procedure`, :class:`~pymeasure.experiment.results.Results`, and its associated graphical representations in the browser and live-graph. This is then given to the :class:`~pymeasure.display.manager.Manager` to queue the experiment. .. image:: pymeasure-managedwindow-queued.png :alt: ManagedWindow Queue Example By default the Manager starts a measurement when its procedure is queued. The abort button can be pressed to stop an experiment. In the Procedure, the :code:`self.should_stop` call will catch the abort event and halt the measurement. It is important to check this value, or the Procedure will not be responsive to the abort event. .. image:: pymeasure-managedwindow-resume.png :alt: ManagedWindow Resume Example If you abort a measurement, the resume button must be pressed to continue the next measurement. This allows you to adjust anything, which is presumably why the abort was needed. .. image:: pymeasure-managedwindow-running.png :alt: ManagedWindow Running Example Now that you have learned about the ManagedWindow, you have all of the basics to get up and running quickly with a measurement and produce an easy to use graphical interface with PyMeasure. .. note:: For performance reasons, the default linewidth of all the graphs has been set to 1. If performance is not an issue, the linewidth can be changed to 2 (or any other value) for better visibility by using the `linewidth` keyword-argument in the `Plotter` or the `ManagedWindow`. Whenever a linewidth of 2 is preferred and a better performance is required, it is possible to enable using OpenGL in the import section of the file: :: import pyqtgraph as pg pg.setConfigOption("useOpenGL", True) The filename and directory input ################################ By default, a ManagedWindow instance contains fields for the filename and the directory (as part of the :class:`~pymeasure.display.widgets.fileinput_widget.FileInputWidget`) to control where the results of an experiment are saved. .. image:: pymeasure-fileinput.png :alt: The filename and directory input widget :width: 24% .. image:: pymeasure-fileinput_disabled.png :alt: The filename and directory input widget, disabled to store the measurement to a temporary file :width: 24% .. image:: pymeasure-fileinput_complete_filename.png :alt: The filename and directory input widget showing the auto-complete for the filename :width: 24% .. image:: pymeasure-fileinput_complete_directory.png :alt: The filename and directory input widget showing the auto-complete for the directory :width: 24% If the checkbox named :guilabel:`Save data` is enabled, the measurement is written to a file. Otherwise, it is stored in a temporary file. The filename in the designated field can be entered with or without extension. If the entered extension is recognized (by default :code:`.csv` and :code:`.txt` are recognized), that extension is used. If the extension is not recognized, the first of the available extensions will be used (default is :code:`.csv`). Additionally, a sequence number is added just before the extension to ensure the uniqueness of the filename. The filename can also contain placeholders, which are filled in using the standard python :code:`format` function (i.e., placeholders can be entered as :code:`'{placeholder name:formatspec}'`). Valid placeholders are the names of the all the input parameters or metadata of the measurement procedure; the valid placeholders are listed in the tooltip of the input field. As the standard :code:`format` functionality is used, the placeholders can be formatted as such; for example, the filename :code:`'DATA_delay{Delay Time:08.3f}s'` gets formatted into :code:`'DATA_delay0000.010s'`. Both the filename and the directory field are provided with auto-completion to help with filling in these fields. The directory field contains a button on the right side to open a folder-selection window. The default values can be easily set after the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` has been initialized; this allows setting a default location and a default filename, changing the default recognized extensions, control the default toggle-value for the :guilabel:`Save data` option, and control whether the filename input field is frozen. .. code-block:: python :emphasize-lines: 13, 14, 15, 16, 17 class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', ) self.setWindowTitle('GUI Example') self.filename = r'default_filename_delay{Delay Time:4f}s' # Sets default filename self.directory = r'C:/Path/to/default/directory' # Sets default directory self.store_measurement = False # Controls the 'Save data' toggle self.file_input.extensions = ["csv", "txt", "data"] # Sets recognized extensions, first entry is the default extension self.file_input.filename_fixed = False # Controls whether the filename-field is frozen (but still displayed) The presence of the widget is controlled by the boolean argument :code:`enabled_file_input` of the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` init. Note that when this is set to :code:`False`, the default :meth:`~pymeasure.display.windows.managed_window.ManagedWindowBase.queue` method of the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` class will no longer work, and a new, custom, method needs to be implemented; a basic implementation is shown in the documentation of the :meth:`~pymeasure.display.windows.managed_window.ManagedWindowBase.queue` method. Customising the plot options ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For both the PlotterWindow and ManagedWindow, plotting is provided by the pyqtgraph_ library. This library allows you to change various plot options, as you might expect: axis ranges (by default auto-ranging), logarithmic and semilogarithmic axes, downsampling, grid display, FFT display, etc. There are two main ways you can do this: 1. You can right click on the plot to manually change any available options. This is also a good way of getting an overview of what options are available in pyqtgraph. Option changes will, of course, not persist across a restart of your program. 2. You can programmatically set these options using pyqtgraph's PlotItem_ API, so that the window will open with these display options already set, as further explained below. For :class:`~pymeasure.display.plotter.Plotter`, you can make a sub-class that overrides the :meth:`~pymeasure.display.plotter.Plotter.setup_plot` method. This method will be called when the Plotter constructs the window. As an example :: class LogPlotter(Plotter): def setup_plot(self, plot): # use logarithmic x-axis (e.g. for frequency sweeps) plot.setLogMode(x=True) For :class:`~pymeasure.display.windows.managed_window.ManagedWindow`, the mechanism to customize plots is much more flexible by using specialization via inheritance. Indeed :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` is the base class for :class:`~pymeasure.display.windows.managed_window.ManagedWindow` and :class:`~pymeasure.display.windows.managed_image_window.ManagedImageWindow` which are subclasses ready to use for GUI. Using tabular format ~~~~~~~~~~~~~~~~~~~~ In some experiments, data in tabular format may be useful in addition or in alternative to graphical plot. :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` allows adding a :class:`~pymeasure.display.widgets.table_widget.TableWidget` to show experiments data, the widget supports also exporting data in some popular format like CSV, HTML, etc. Below an example on how to customize :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` to use tabular format, it derived from example above and changed lines are marked. .. code-block:: python :emphasize-lines: 11, 12, 18, 44, 47, 48, 49, 50, 51, 52, 57, 59, 60, 61 import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) import sys import tempfile import random from time import sleep from pymeasure.log import console_log from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindowBase from pymeasure.display.widgets import TableWidget, LogWidget from pymeasure.experiment import Procedure, Results from pymeasure.experiment import IntegerParameter, FloatParameter, Parameter class RandomProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=10) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting the seed of the random number generator") random.seed(self.seed) def execute(self): log.info("Starting the loop of %d iterations" % self.iterations) for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } self.emit('results', data) log.debug("Emitting results: %s" % data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Caught the stop flag in the procedure") break class MainWindow(ManagedWindowBase): def __init__(self): widget_list = (TableWidget("Experiment Table", RandomProcedure.DATA_COLUMNS, by_column=True, ), LogWidget("Experiment Log"), ) super().__init__( procedure_class=RandomProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], widget_list=widget_list, ) logging.getLogger().addHandler(widget_list[1].handler) log.setLevel(self.log_level) log.info("ManagedWindow connected to logging") self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) This results in the following graphical display. .. image:: pymeasure-tablewidget.png :alt: TableWidget Example Defining your own ManagedWindow's widgets ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The parameter :code:`widget_list` in :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` constructor allow to introduce user's defined widget in the GUI results display area. The user's widget should inherit from :class:`~pymeasure.display.widgets.tab_widget.TabWidget` and could reimplement any of the methods that needs customization. In order to get familiar with the mechanism, users can check the following widgets already provided: - :class:`~pymeasure.display.widgets.log_widget.LogWidget` - :class:`~pymeasure.display.widgets.plot_widget.PlotWidget` - :class:`~pymeasure.display.widgets.image_widget.ImageWidget` - :class:`~pymeasure.display.widgets.image_widget.DockWidget` - :class:`~pymeasure.display.widgets.table_widget.TableWidget` - :class:`~pymeasure.display.widgets.console_widget.ConsoleWidget` Using the interactive Python console ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sometimes it is useful to interact with the application live while it is running, to query the state of the instrument or control the instrument. PyMeasure provides a :class:`~pymeasure.display.widgets.console_widget.ConsoleWidget` which can be embedded directly into the :class:`~pymeasure.display.windows.managed_window.ManagedWindow`. You can expose variables, instruments, and modules to this console by passing a ``namespace`` dictionary during initialization. Because :class:`~pymeasure.display.windows.managed_window.ManagedWindow` places its default widgets (like the plot and log) at the end of the ``widget_list`` parameter, it is common to manually append the :class:`~pymeasure.display.widgets.console_widget.ConsoleWidget` after ``super().__init__()`` if you want it to appear as the right-most tab. .. code-block:: python :emphasize-lines: 1,15,16,17,18,19,20,22,23 from pymeasure.display.widgets.console_widget import ConsoleWidget class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=RandomProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', ) self.setWindowTitle('GUI Example') # 1. Create the console widget and expose variables to it self.console_widget = ConsoleWidget( "Script Console", namespace={ 'window': self, 'device': '', # replace with your instrument instance 'np': '' # replace with numpy if imported } ) # 2. Append it manually so it appears as the last tab self.widget_list += (self.console_widget,) self.tabs.addTab(self.console_widget, self.console_widget.name) Using the sequencer ~~~~~~~~~~~~~~~~~~~ As an extension to the way of graphically inputting parameters and executing multiple measurements using the :class:`~pymeasure.display.windows.managed_window.ManagedWindow`, :class:`~pymeasure.display.widgets.sequencer_widget.SequencerWidget` is provided which allows users to queue a series of measurements with varying one, or more, of the parameters. This sequencer thereby provides a convenient way to scan through the parameter space of the measurement procedure. To activate the sequencer, two additional keyword arguments are added to :class:`~pymeasure.display.windows.managed_window.ManagedWindow`, namely :code:`sequencer` and :code:`sequencer_inputs`. :code:`sequencer` accepts a boolean stating whether or not the sequencer has to be included into the window and :code:`sequencer_inputs` accepts either :code:`None` or a list of the parameter names are to be scanned over. If no list of parameters is given, the parameters displayed in the manager queue are used. In order to be able to use the sequencer, the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` class is required to have a :code:`queue` method which takes a keyword (or better keyword-only for safety reasons) argument :code:`procedure`, where a procedure instance can be passed. The sequencer will use this method to queue the parameter scan. In order to implement the sequencer into the previous example, only the :class:`~pymeasure.display.windows.managed_window.ManagedWindow` has to be modified slightly (where modified lines are marked): .. code-block:: python :emphasize-lines: 10,11,12 class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', sequencer=True, # Added line sequencer_inputs=['iterations', 'delay', 'seed'], # Added line sequence_file="gui_sequencer_example_sequence.txt", # Added line, optional ) self.setWindowTitle('GUI Example') This adds the sequencer underneath the input panel. .. image:: pymeasure-sequencer.png :alt: Example of the sequencer widget The widget contains a tree-view where you can build the sequence. It has three columns: :code:`level` (indicated how deep an item is nested), :code:`parameter` (a drop-down menu to select which parameter is being sequenced by that item), and :code:`sequence` (the text-box where you can define the sequence). While the two former columns are rather straightforward, filling in the later requires some explanation. In order to maintain flexibility, the sequence is defined in a text-box, allowing the user to enter any list-generating single-line piece of code. To assist in this, a number of functions is supported, either from the main python library (namely :code:`range`, :code:`sorted`, and :code:`list`) or the numpy library. The supported numpy functions (prepending :code:`numpy.` or any abbreviation is not required) are: :code:`arange`, :code:`linspace`, :code:`arccos`, :code:`arcsin`, :code:`arctan`, :code:`arctan2`, :code:`ceil`, :code:`cos`, :code:`cosh`, :code:`degrees`, :code:`e`, :code:`exp`, :code:`fabs`, :code:`floor`, :code:`fmod`, :code:`frexp`, :code:`hypot`, :code:`ldexp`, :code:`log`, :code:`log10`, :code:`modf`, :code:`pi`, :code:`power`, :code:`radians`, :code:`sin`, :code:`sinh`, :code:`sqrt`, :code:`tan`, and :code:`tanh`. As an example, :code:`arange(0, 10, 1)` generates a list increasing with steps of 1, while using :code:`exp(arange(0, 10, 1))` generates an exponentially increasing list. This way complex sequences can be entered easily. The sequences can be extended and shortened using the buttons :code:`Add root item`, :code:`Add item`, and :code:`Remove item`. The latter two either add an item as a child of the currently selected item or remove the selected item, respectively. To queue the entered sequence the button :code:`Queue` sequence can be used. If an error occurs in evaluating the sequence text-boxes, this is mentioned in the logger, and nothing is queued. Finally, it is possible to create a sequence file such that the user does not need to write the sequence again each time. The sequence file can be created by saving current sequence built within the GUI using the :code:`Save sequence` button or directly writing a simple text file. Once created, the sequence can be loaded with the :code:`Load sequence` button. In the sequence file each line adds one item to the sequence tree, starting with a number of dashes (:code:`-`) to indicate the level of the item (starting with 1 dash for top level), followed by the name of the parameter and the sequence string, both as a python string between parentheses. An example of such a sequence file is given below, resulting in the sequence shown in the figure above. .. literalinclude:: gui_sequencer_example_sequence.txt This file can also be automatically loaded at the start of the program by adding the key-word argument :code:`sequence_file="filename.txt"` to the :code:`super().__init__` call, as was done in the example. Using the estimator widget ~~~~~~~~~~~~~~~~~~~~~~~~~~ In order to provide estimates of the measurement procedure, an :class:`~pymeasure.display.widgets.estimator_widget.EstimatorWidget` is provided that allows the user to define and calculate estimates. The widget is automatically activated when the :code:`get_estimates` method is added in the :code:`Procedure`. The quickest and most simple implementation of the :code:`get_estimates` function simply returns the estimated duration of the measurement in seconds (as an :code:`int` or a :code:`float`). As an example, in the example provided in the `Using the ManagedWindow`_ section, the :code:`Procedure` is changed to: .. code-block:: python class RandomProcedure(Procedure): # ... def get_estimates(self, sequence_length=None, sequence=None): return self.iterations * self.delay This will add the estimator widget at the dock on the left. The duration and finishing-time of a single measurement is always displayed in this case. Depending on whether the SequencerWidget is also used, the length, duration and finishing-time of the full sequence is also shown. For maximum flexibility (e.g. for showing multiple and other types of estimates, such as the duration, filesize, finishing-time, etc.) it is also possible that the :code:`get_estimates` returns a list of tuples. Each of these tuple consists of two strings: the first is the name (label) of the estimate, the second is the estimate itself. As an example, in the example provided in the `Using the ManagedWindow`_ section, the :code:`Procedure` is changed to: .. code-block:: python class RandomProcedure(Procedure): # ... def get_estimates(self, sequence_length=None, sequence=None): duration = self.iterations * self.delay estimates = [ ("Duration", "%d s" % int(duration)), ("Number of lines", "%d" % int(self.iterations)), ("Sequence length", str(sequence_length)), ('Measurement finished at', str(datetime.now() + timedelta(seconds=duration))), ] return estimates This will add the estimator widget at the dock on the left. .. image:: pymeasure-estimator.png :alt: Example of the estimator widget Note that after the initialisation of the widget both the label of the estimate as of course the estimate itself can be modified, but the amount of estimates is fixed. The keyword arguments are not required in the implementation of the function, but are passed if asked for (i.e. :code:`def get_estimates(self)` does also works). Keyword arguments that are accepted are :code:`sequence`, which contains the full sequence of the sequencer (if present), and :code:`sequence_length`, which gives the length of the sequence as integer (if present). If the sequencer is not present or the sequence cannot be parsed, both :code:`sequence` and :code:`sequence_length` will contain :code:`None`. The estimates are automatically updated every 2 seconds. Changing this update interval is possible using the "Update continuously"-checkbox, which can be toggled between three states: off (i.e. no updating), auto-update every two seconds (default) or auto-update every 100 milliseconds. Manually updating the estimates (useful whenever continuous updating is turned off) is also possible using the "update"-button. Flexible hiding of inputs ~~~~~~~~~~~~~~~~~~~~~~~~~ There can be situations when it may be relevant to turn on or off a number of inputs (e.g. when a part of the measurement script is skipped upon turning of a single :code:`BooleanParameter`). For these cases, it is possible to assign a :code:`Parameter` to a controlling :code:`Parameter`, which will hide or show the :code:`Input` of the :code:`Parameter` depending on the value of the :code:`Parameter`. This is done with the :code:`group_by` key-word argument. .. code-block:: python toggle = BooleanParameter("toggle", default=True) param = FloatParameter('some parameter', group_by='toggle') When both the :code:`toggle` and :code:`param` are visible in the :code:`InputsWidget` (via :code:`inputs=['iterations', 'delay', 'seed']` as demonstrated above) one can control whether the input-field of :code:`param` is visible by checking and unchecking the checkbox of :code:`toggle`. By default, the group will be visible if the value of the :code:`group_by` :code:`Parameter` is :code:`True` (which is only relevant for a :code:`BooleanParameter`), but it is possible to specify other value as conditions using the :code:`group_condition` keyword argument. .. code-block:: python iterations = IntegerParameter('Loop Iterations', default=100) param = FloatParameter('some parameter', group_by='iterations', group_condition=99) Here the input of :code:`param` is only visible if :code:`iterations` has a value of 99. This works with any type of :code:`Parameter` as :code:`group_by` parameter. To allow for even more flexibility, it is also possible to pass a (lambda)function as a condition: .. code-block:: python iterations = IntegerParameter('Loop Iterations', default=100) param = FloatParameter('some parameter', group_by='iterations', group_condition=lambda v: 50 < v < 100) Now the input of :code:`param` is only shown if the value of :code:`iterations` is between 51 and 99. Using the :code:`hide_groups` keyword-argument of the :code:`ManagedWindow` you can choose between hiding the groups (:code:`hide_groups = True`) and disabling / graying-out the groups (:code:`hide_groups = False`). Finally, it is also possible to provide multiple parameters to the :code:`group_by` argument, in which case the input will only be visible if all of the conditions are true. Multiple parameters for grouping can either be passed as a dict of string: condition pairs, or as a list of strings, in which case the :code:`group_condition` can be either a single condition or a list of conditions: .. code-block:: python iterations = IntegerParameter('Loop Iterations', default=100) toggle = BooleanParameter('A checkbox') param_A = FloatParameter('some parameter', group_by=['iterations', 'toggle'], group_condition=[lambda v: 50 < v < 100, True]) param_B = FloatParameter('some parameter', group_by={'iterations': lambda v: 50 < v < 100, 'toggle': True}) Note that in this example, :code:`param_A` and :code:`param_B` are identically grouped: they're only visible if :code:`iterations` is between 51 and 99 and if the `toggle` checkbox is checked (i.e. True). .. _pyqtgraph: http://www.pyqtgraph.org/ .. _PlotItem: http://www.pyqtgraph.org/documentation/graphicsItems/plotitem.html Using the ManagedDockWindow ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Building off the `Using the ManagedWindow`_ section where we used a :code:`ManagedWindow`, we can also use :class:`~pymeasure.display.windows.managed_dock_window.ManagedDockWindow` to build a graphical interface with multiple graphs that can be docked in the main GUI window or popped out into their own window. To start with, let's make the following highlighted edits to the code example from `Using the ManagedWindow`_: 1. On line 10 we now import :class:`~pymeasure.display.windows.managed_dock_window.ManagedDockWindow` 2. On line 20, and lines 32 and 33, we add two new columns of data to be recorded :code:`'Random Number 2'` and :code:`'Random Number 3'` 3. On line 44 we make :code:`MainWindow` a subclass of :code:`ManagedDockWindow` 4. On line 51 we will pass in a list of strings from :code:`DATA_COLUMNS` to the :code:`x_axis` argument 5. On line 52 we will pass in a list of strings from :code:`DATA_COLUMNS` to the :code:`y_axis` argument .. code-block:: python :emphasize-lines: 10,20,32,33,44,51,52 import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) import sys import tempfile import random from time import sleep from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows.managed_dock_window import ManagedDockWindow from pymeasure.experiment import Procedure, Results from pymeasure.experiment import IntegerParameter, FloatParameter, Parameter class RandomProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=10) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number 1', 'Random Number 2', 'Random Number 3'] def startup(self): log.info("Setting the seed of the random number generator") random.seed(self.seed) def execute(self): log.info("Starting the loop of %d iterations" % self.iterations) for i in range(self.iterations): data = { 'Iteration': i, 'Random Number 1': random.random(), 'Random Number 2': random.random(), 'Random Number 3': random.random() } self.emit('results', data) log.debug("Emitting results: %s" % data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Caught the stop flag in the procedure") break class MainWindow(ManagedDockWindow): def __init__(self): super().__init__( procedure_class=RandomProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis=['Iteration', 'Random Number 1'], y_axis=['Random Number 1','Random Number 2', 'Random Number 3'] ) self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) Now we can see our :code:`ManagedDockWindow`: .. image:: managed_dock_window.png :alt: Managed dock window As you can see from the above screenshot, our example code created three docks with following "X Axis" and "Y Axis" labels: 1. **X Axis:** "Iteration" **Y Axis:** "Random Number 1" 2. **X Axis:** "Random Number 1" **Y Axis:** "Random Number 2" 3. **X Axis:** "Random Number 1" **Y Axis:** "Random Number 3" The list of strings for :code:`x_axis` and :code:`y_axis` set the default labels for each dockable plot and the longest list determines how many dockable plots are created. To highlight this point, in our example we define :code:`x_axis` and :code:`y_axis` with the following lists:: x_axis=['Iteration', 'Random Number 1'], y_axis=['Random Number 1','Random Number 2', 'Random Number 3'] If one list is longer than the last element if the other list is used as the default label for the rest of the dockable plots. In our example that is why we have two **X Axis** labels with "Random Number 1". The longest list between :code:`x_axis` and :code:`y_axis` determines the number of plots. In our example :code:`y_axis` has the longest list with a length of three so three plots are created. You can pop out a dockable plot from the main dock window to its own window by double clicking the blue "Dock #" title bar, which is to the left of each plot by default: .. image:: managed_dock_window_popup.gif :alt: Pop up a managed dock window You can return the popped out window to the main window by clicking the close icon X in the top right. After positioning your dock windows, you can save the layout by right-clicking a dock widget and select "Save Dock Layout" from the context menu. This will save the layout of all docks and the settings for each plot to a file. By default the file path is the current working directory of the python file that started :code:`ManagedDockWindow`, and the default file name is '*procedure class* + "_dock_layout.json"'. For our example, that would be "./RandomProcedure_dock_layout.json" When you run the python file that invokes :code:`ManagedDockWindow` again, it will look for and load the dock layout file if it exists. .. image:: managed_dock_window_save.png :alt: Save dock window layout You can drag a dockable plot to reposition it in reference to other plots in the main dock window in several ways. You can drag the blue "Dock #" title bar to the left or right side of another plot to reposition a plot to be side by side with another plot: .. image:: managed_dock_window_side_drag.png :alt: Side drag managed dock window .. image:: managed_dock_window_side_after.png :alt: Side position managed dock window You can also drag the blue "Dock #" title bar to the top or bottom side of another plot to reposition a plot to rearrange the vertical order of the plots: .. image:: managed_dock_window_top.png :alt: Top position managed dock window You can drag the blue "Dock #" title bar to the middle of another plot to reposition a plot to create a tabbed view of the two plots: .. image:: managed_dock_window_tab_drag.png :alt: Tab drag managed dock window .. image:: managed_dock_window_tab_after.png :alt: Tab position managed dock window Using the ManagedConsole ~~~~~~~~~~~~~~~~~~~~~~~~ The :class:`~pymeasure.display.console.ManagedConsole` is the most convenient tool for running measurements with your Procedure using a command line interface. The :class:`~pymeasure.display.console.ManagedConsole` allows to run an experiment with the same set of parameters available in the :class:`~pymeasure.display.windows.managed_window.ManagedWindow`, but they are defined using a set of command line switches. It is also possible to define a test that uses both :class:`~pymeasure.display.console.ManagedConsole` or :class:`~pymeasure.display.windows.managed_window.ManagedWindow` according to user selection in the command line. Enabling console mode is easy and straightforward and the following example demonstrates how to do it. The following example is a variant of the code example from `Using the ManagedWindow`_ where some parts have been highlighted: 1. On line 8 we now import :class:`~pymeasure.display.console.ManagedConsole` 2. On line 73, we add the support for console mode .. code-block:: python :emphasize-lines: 8,62,63,64 import sys import random import tempfile from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.experiment import Results from pymeasure.display.console import ManagedConsole from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * (i + 1) / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super(MainWindow, self).__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number' ) self.setWindowTitle('GUI Example') if __name__ == "__main__": if len(sys.argv) > 1: # If any parameter is passed, the console mode is run # This criteria can be changed at user discretion app = ManagedConsole(procedure_class=TestProcedure) else: app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) If we run the script above without any parameter, you will have the graphical user interface example. If you run as follow, you will use the command line mode: .. code-block:: bash python console.py --iterations 10 --result-file console_test Console output is as follow (to show the progress bar, you need to install the optional module `progressbar2 `_): .. image:: console_output.png :alt: Console mode output Other useful commands ##################### To show all the command line switches: .. code-block:: bash python console.py --help To run an experiment with parameters retrieved from an existing result file. .. code-block:: bash python console.py --use-result-file console_test2023-08-09_1.csv ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/gui_sequencer_example_sequence.txt0000644000175100017510000000023615203313266025055 0ustar00runnerrunner- "Delay Time", "arange(0.25, 1, 0.25)" -- "Random Seed", "[1, 4, 8]" --- "Loop Iterations", "exp(linspace(1, 5, 3))" -- "Random Seed", "arange(10, 100, 10)" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/index.rst0000644000175100017510000000026615203313266017717 0ustar00runnerrunner######### Tutorials ######### The following sections provide instructions for getting started with PyMeasure. .. toctree:: :maxdepth: 2 connecting procedure graphical ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window.png0000644000175100017510000023115515203313266022552 0ustar00runnerrunnerPNG  IHDR94SsBIT|d IDATxwx !zU`7UT,`E16*&HH^I# $0}ܛݝ9]<333&fѣG.~!}ԨQ*&={,DDDDDDDnj; 3IѣGF%""""""r?>G6n,]DDDDDDŒݻw"""""""7 fLN"""""""%uDȍ.ys>] 3o]\;"%""rxn8R 'JySqGl;߻5i 0×z"S39&W~B,98g-)Ǿԡ*F512jrtt?QF纾K뇇 ̞=|0u)QAžEZv$Ki%J,;KY\(9)ad%yzPY,ei(ߺj{O5M.AnP&DER8&%^vYyKCNNٳׯ/HJ,X;aÆt5 clX{$s JجVl #%wa~GJT tf35iO5rV]ʰbH_A jMacb@SwNu{NGHtlKN~W2v$8b NaxҢ]ײh Rhz4 r*wv>c`і 1```)go9 PU'Oa$}aܹENùs]W{ｗӧs\2`ݰHQG9Ǫi[щ8Y/s,YzVnxnF=gYrfP6*v480-[6pBYn\=;V+=H{3g7eUWB3'0qrXkԥf#l;9OԨbb#0;[P: =Ty<~S廓þլY{hFEDDO#s#7)))WO>$%%%V7ߐ/#**@ %{j ip9#M?X*v^uqtH}E엎g6Rϰ3i2L69`&Knm(K )vb',Vwu8)f6`nJQ6qq/K= Iu'Gf;!tW'274gcc8פLb pӡ:7Nq'I\(x^|ￌSB?@ ͭ@(QOHHӓ=zh"ׯVU׹HIڼXF~DGw=ILO3{Es$/LޭT̾Ϝ1)8EUlR1+XHMH;?`ۑR2٬ 3f,*޾JR*XL&OMi$%1;a70L1=$ .&R 'rI=;gWLNɕ2u)~??z v/vxJJJk?Ά ׯJo&G@@͚5lٲf H3!āC_ʵn0 ;+n.&qg O򆁑EdYqױiK&6: kl`wr#_ ƪ')U+wwi^}Bf3&[opgdda˰bK !9.n\]1c& )Y'EDD(z ^3s&}u!C]U=22듖Flll&+Ҡ^G6b3KFgiaju?vn˂R t"Q%jѐ O0L 1 }qcDì[Sُj돑^/czjn͆ ''Rfpl̑_<߸t=o?#!v'kꔷر`Sꄺfulv l%!2Fp)QFݺu½{>}ffә3g ȵc!i7z9O8fJRFNft6:?{ӱJvt\Kj$G7bt1>L l9nFl7:TrZ_'R љ87-TAuZvlפ1۔UE#湇/ ^ KZTJ=ɸUlAupMO=Keդ؝(S.8Q5o(cr fҧO,KFMaaaFvsP"""%R)患aǖa%=%s֬)=(ꌃ6+)I$$ap -q$D#59%GF*q~xH"&نC)_<&*ɄnNLt%Yq(=>4W|W]F }k}i>mWZ;^fY;iqGnB` }zcLcY̐ySYm56uƎ5枉z߫W>m_2kavxg#:ՆX5odA 7J=Ê=u;<4ߟcp Эe=7Z1}$^9҃v?2Ts#""""""7jwװ;) 87}< ;#OS B=ywJvX;?9՟fw7/5۶Z*-u&;ALڀS"NKDXpא8^'Z~w7; m+q ʯc2?^|;N&=>էdw(+,0ypSc\)3(W#vi;FwMhMIQ9x DGGw(%/T\C?Q7=o`gg7u~xOn\ypjEcF6f.>EBʩd Ȯ؄gŊxg'X9d9ăXW[fpM88v0"LҮ$c[F=._#ߡ4y{0-^Dq׻*.8x fw(%͛9tu3a2]3;QQة&/3a\Hdmq&ɪ.ʆ01,\?[{М]Җ<5`/wnG^vA5h7̋c[o QV'ko^{(Fue j[ ^nYK\#>cwRA6CX 9 nL&v=za6 ȑ#Mf  yw뵋GDDDDukV=^⇯pj[,|܎޶ ~ՙ'<@Z:Fzےx֠Ԉg -grs&30LpI0ԤB/[1|A.jchO@un{~)s5XL~ y'OfStmPZͻL.""""7%%"]wڝVHYK&{DE=8ykh?>OLXz4v,kJcgvkߵlSg#q~;٣ <5 bG5 #M X,fLi;t[#};`.1W00r4]ՠj gN.[|Dg֪ETfR1-` hJ{fѵ{i{Mno\5[3l8]դJ+F>i:?E浩V>]|ρt5cIs~; #nQhЎ{'ʙ앭G]4^{In<50/"""r]P.R^z&xg}yrp5L&J}0wv2R2gyY|a 5<qJh@Li~Tw~x |Vti\gpYZ(e:2jpk'51續z?'y%}{o'`$-gL߰=FyH #__}oܞdY}g2A7b2K+/wѬ#a  2;g&dv/}!=; |& >pZ Q|;uN\ͻ1a}-=՜R똫cH;8c X~DZze.u4V?ͪ ə<}XуR.yLG0Wݷ`t(HwPɄsv3vv,;ٻ]rD4W}˺?YkY~3eݔG5e׼Efv }&^fLnUmDDDD`sE b~U@|"Nq!f OFS9"9nuK: wǔx#3NOgE4/[`If_XMD*gqԵJL~ oi{qF{R>=sd?q.FdlgYL4+)s*%J8 r^o|uvMX v0#܎ 'S, دFR4~_?ϸ(b3∎s#0m>]u{""""rmiD]e`v㎲~/ \ O^vv~{իx'p[ n`&0"}ߛD#xnY4ő8a`K"\ս0i̞iֳ#9x6#哾"[/gNdnlۛR}qo̳+sNvɞnp$ք_N@&m~J wK8Kwx{|Dç剈ܬ9{lA)gW*桯"g#8VYh ǣ{؟eOn2RIKK,V-u{>ZΩtmbSNrkǚl; H?qRnhHr#MRAg&6<&nt;ʿ~47A/t{gɱ3#W[391#w0#ɣb˛R9m㗴"3؄q_'8E!Sr/&t9g_Ǡ&O_6U|>{|Ga(fSW>+_pűl aV .}M?]{fHb 3\q\V\I^;?LvيA+p* e5I(/֍R|ijba4nܸh\f̘"r#9Nle8GY8m )9T""""`=[Μnr%Ly=nu*ԅ];šCDDDDu)RE6)rDDDDu)R6ho&'""""rQ."EfQa\7٬%D@@ׯ/0?Xreq """rԩSS."EUVH0o޼|/A J CJh֗iUDDDDDDMm{ض6ON/j#cgݤUh mIПliji*e?qʥC^C2:!"""""" Y:ziR|@*&Anĭ7^HM~4 !\D݈:P'45[1荕~-_ߺ5+ZWLfzmEy/U*Rm<9 iWlYԝ3 cf IDATuVGĻiU#К- f[yi<ۥ&#X?3FҭEUD[]'oxe&h{qlc{4zheB7kH02n'j ͬ]D݈c4iv #ߍ_1q~[ɋ~?0yDf [?~-lv _]A }k}i>mWZ[8\^wp$/-O\~^WVtr[//Ⱦ#; MZB[+tl^l'\]#e߼ mV6|2}ʖٿ'X&3UӺQEME눈H rmu_Uo#,>9;Z [4.HG u.e+#nV])F +AFׂ٫f Veqws~ Ӭ+f6TYbmTJۚCy'f\҉gqfLH9"-dV7&̔:=_%""""""7٣ JeKZV\;'et[RB}HSm'fx1zrjwL%{s,XvX}x:{NGou;y ms5IM9Gp*3Գgi>)u6?L= f{L$Qh8ΜM׿LLo'fo|2z.{Q#:k )q;.XN@GW5g~m5CEb|?)v~=O޺itM~%)l HHhXf\Uhذ!r >(UT)v 4e5dɹ5}|>XJw?[O/lS[x02[Y4Yi?ՐRg$i6]dQ?:nƤ'X:u"gTvېCJ`Sj;BF#ΨY7+{Jۊ+m]6^;{Z>=݊հsrۖOG׍ ϰrej-X/"""""Eg֭9r͛3e\$5F@PPPf0 =4MkVa|rf:΋R=;JJjFmiU5F?$w{>灧~/>ipmIêx 1I^R*q,>F8c\-i67N#ǬO}`}i;C9[7]i[NЯQeB֠c{(:ډٷXq һwo~^}"kfY`EZ=WK1[r%={ײ#GnvϜ?zj>|-?o<:u͘1=G]DDDDDDFѼysϟ_$u+Q)er"O&wlw"""""""׆FEDDDDDDJ%"""""""%uDH D]DDDDDDQ.""""""Rjr¬NDDDDDDSQԩ$11¬ZnRxzzRrEDDDDD(Dfׯ_Mȑ#:tEݻ%**C???|||UVqRb/II 5QOLL}Y>>>^Ðb{n222hӦMq""R [laϞ=JQ_."ק uMw[7X6lXaXF)0J"r=*~PGED STTaw""WEӼ3/UqJEDO}H(QOx"r1LB\D'ݏ5"""""""\D=rK@ .K~ fp*Oa؛zm"|J^ƈ:ݘz^,QbJ_hqkl,***%$ h~kl(7nGzWz{(b \ǢrTɽa-> 㡗 W@+?y7"JƱJGB}<ڈb5hZכ+kc|)c3QҔ MX Úp[wЩ;;o7֬זx^ǡRKA|٭<sh"JIJO~ޕ*O/Pcԇ*_(\df8;;Ot5 w8@Ω?݃{=.)V6؈6Cu=)g3i꽸OEf.ũ菼MθUߥ_yvNX;ڥ0U"jOU.oyŹ@Қ7xiG{Ny,o:l3ɟ&\ȁSDߏvoog ?Q?^qٝGmnTwǡRKAD~2_Mcz]ؚhf<>rlQDmg)؉X*wزX5MEJqCd.u7-|L ?NU'UkR[>*s}|/_ʈ-*ڿ,Z8fo{<d:65YF؏3g(݋5m'쐲iJ@T~lNOQʽ̉.-N s4ƺ]|س6`~=o>ڒ*Qޝ]x}'ai[3jtya~kpc>p#kʦqh4nQ}Ц֓I1}7L 40u1lgYz_\}XM/5csx]e(%v8~&n:!rkՏbA\\>kr+Ҋ/*[7Fwʏuvy/;- a@X_fJɓ'a3LXϙcy#a>]ǜ/{p8'2^Tw2uwC5&C+`]1w'bPpC5=Ngy QKrh ->TIpSGVp_&:(.ٺo7K1)?Mӧ]7>/gie<0o'OlJKxyH닯/ .?3DMfiL\єgG5sfTY5a@;pf-uia9 WƲ)вTsi {τsjRRjh4k>n'دL_pp jVIv|P5>Y`F|ԅoiE^88uOmkݧ9cZξ2NwaNESywK5[ 3ӷq6in a;:U3jHᏵi<Ngݾ~v57@y~iB|Φ5'..9#0Ѥ/jʚ rfx!+D݄[)WRSFr2)R*)"-'-{%}4 he+B@4\3e:3aRK͠poԽѩB(e/⫅;ƛ*+n3'/3yrqcwn_,#;&O=]*#QZ .Uhת#oN-YlŘAUpk=cwX p=ù!.5$ RJenݺѭ[}RP΍FlE >?< ó;aP'Ykg.؇tb[pϵ\56%tET}&+]+D=Ljށx{yQG>Ra` nN8aƯM{$!<{ܡ }J9'w lɣ|M \0;3F-DGy~iLP t[2Tж[tN*C{S C:ҾJ8O53 =ˋga}]K| ٖ͊kZ1y6ti _eqwsrv(V\~0sZ3;N(.^UA=]`wZn}Oxn'F4K[̉_S7iFjԅ7&|;?BRCfտCq,sޘЇzWfЄ)LP=' ϥqOւ‰H.U0`ӖjIXRr~=#~+_6$l!2eM!4[T~7g- _Fa3*``7S:f33rIܢEr*?=5VikClLlE7#sus!h},)>Y*#dۼ@c^ ̓<)ʁKr00tN>hwOvf9x``V/>Zξx 1֠{o̾gXXJT=~돯9 ðwPٟ $vDf냟WVG\=nb1.=x70nߛt^_ӊA&}S=m`/Z#97+Yeb-!kcBH9Wer-rc&x!*ƔLpTƗ{nѐSLg\JE ơ/fZz5OOc2i]d$:f%ɿwa.:ps -q3<^&䙨goABmP_[G]W{y+9,Jl~#t#+S?`ݾa` ;4=wxMp>\'"խ[7UFjՊ돷K$^NVdE~24 o~1/bDpG$Wtuf6eg=ml}&ExW~}S%}<:}?ӹx%437ƒ=j|j~ܸs4qSsBhY漆>\)Y{th7v2u;8d2aϰbm/Pv"np=|xN1ۘѷE?@4翹+5r\~w0 73rlÇNs]+"Wf?5އ^K _OC9sj{\R`Ŝv'fq<'|23k|rw`z*;UGRVҭ3fx`ķt8{`p˷s4"hR^%qXt.\z`ذ=1e~ _ԛ]g@EUV7bXjj D}y%ڃgjyړO>!lq^\ٵ60{R~lV ;=ϰWQWn<=%k@j^XH؂ElDMX _MeK#(?M[BBh>Sc'?Oᇤnם 25'GzwSlmVJ$ɮHNڏK<_ޞ3tʠOXw,l~4K_&pb[;bد+ݑ5|j}ynxf`ooM=q+B-GysՕ]*Ֆrw 69ms|1) oBչSG*m򮗼^y77eOP9.*y=[[t.{..۶C]4Y V}|R{\ >ߩ*AeQ ,Pʕ+s!V^MtttaV-7)___<==\rq"ݞY݄HDfݎOqR"/MI ®RDnR>>>ݻ5j`2}nw^%Yԗ$㺙Xua׮]l۶GD$_|||N:J\D7%W."%tEDED P."""""""uDH D]DDDDDDQ.""""""R"׹C!5k֬XU.rhժUq """"rC?4Ɓ;SH/fRVD|u^\Mm{&??P[>Wiq{(ťL_'gȫcPR٪ɟO!Ob†sSDFeꝥ?DDFyG6Trfለ[+qJG?f83v+gjVCa%Ѹdm#j5o jOXwp-3kI^0u 4hKV688d,gã(>gKzO@ $HE*JQl"c9*vQA9(H^C {:jdyu;<[cٳ| y?2zkf1߽3=XYx03Fa"M6&y;;0ҹu?%,-ۍ*BZV2m]j"""""""S=d4?ӕ Ld.IkNigҎR<Y/2wf^b#vz5ҽU]~m :Ք eёlAֱml?Dx1^}Xrp&ې|šs<ܳڇV~D Ks<^u?x"""""[ԝ'| Wjэgn wxzt+>؟^h>r"SڀnŐZۗ}p[ {,7ЫO<]Êh\о3 LQ?Zӈ[?pt 8u>fƼjj;k ?rMY{'] 1&MI&g7nܸ`*bVZHQ&O/+dBDZ5/}(߿gbn~_)-;|s7a?- { _Z3oMA49#/?l+D"R |CO*Ƅ\;%"""""lugĵr7]G R8vlFCzΔNgdrɈ?Dp)8EDDDDnLE2{c -M Uzǔ63~A=6 f Ow<-w{G"""""7,QľZq\\;2n^^w\~8ӝ2],"rV͚5;R:KE (ARwӻ@NǨHAe7hYwp;ODl߾)UԢ.r]w_X+> -g}l2\g'p: )xTr\*Z0lK \NќW +\*/\^\*WUOKc~]}Ma…t6l?ORRӦk֬y`/Y{g+]r7fҤI :VZHZr%M6:Vko̙tM:UcEn\<1!f 8rw."נf͚JEDD Xv}_p5! wMJ1'^Ti;.^- ޺xzrSvd~x"r3]YsQ)&jSmWt#aj+K/o_^ۄa^&>áJ]EDDDDEQmك^[#ł PH88h/S; f؉0Q9oUwDDDDDnFm HӬ"""@ǨWRX,YBBBBAV-7@|}}RJqR0L.Б.L;\hح29,<u'Ÿ8m9ID7<8SߦYEDD &)t.f<<μ Y3Y<$l&L(`DDDDD4=MY|F^zq /Oű.g;h/LKLބ"""""BHa%Ũ |Qq\<У95)_DDDDD@]E_yzQh ]n|:mDzEg)E4뻈HS.RA<0MGY-<1!f 8rw.""""R,](|<8t 1̸yLx!6a@\&ɹE|{~$/XvߞA"IDDDDDDݶUZzKp y{R|LX0 7-8e?onX""" b)V5k,DDDJjVLhզt ۮ٣ p{jlhUtwE9XJ+FyntyjAF /FU&.\"e.Dxv:4#gƦt|VDDD(IߢnaOy ?IYd l*әL 3}]9Oe?!8VH&κ;e*o8D\e[𑝖JnN~?>B=Dj4뻈H+ |зSdă5fde*׺Q?Ƒ;C=ć_c(*UNۡcwrDd;x\jZQ48B|>J:E4+XcZ?E_ؙ#ЙxQmK swGdDU8>ag@UM?eCLu3Yfg;7+~E9{[:Ο1Vgo3X5yEUiK:np i}oecL,kϗ'ZLОɫcػ3n2,~>g {Y9tm=6%.n+??͇?OwwỘvcۧw=W{k1LsAH;qLZv|:~M`۞/v|gvzbv,)OZrr [(u7FY=#Գgs'Mk68L G".w׀\C"""""Ţu Fe kMc}1ЦaLJ;FFdK= ` h7sI-CiopN6mH=Lf>}I x!pog*u8raFb&Le|=[ mܮ J=}h;T,@ʻ18T.,]jk5xjgLb/dzYi]wK9`ğwg:EDDDDEQFo}OubAy\!OǮ0DlnU:i6|6s50[8p$AH9m4r I >:i.CH &` LV|NdXX8/Ը%|?d72q2!?[{f Kϯf'u'3qrjVlgZ*N7DPw'9Ep빚ͼm;aGdi<2G2WK}zvvC֍mkE1 f؞.dPY{Ẻ\hvk{uYXOlG H)WSWy2ᑿg;IK$TQ~a칬ɪ Zƚ/?cCg>f~.fكedc 8~ȸM!Ѹq_ƶ d咴s6ӗPfEޛ;Lܖf";w'tLZs<~M;q\ |:ITyV5!&5bynp(M˛lL:S2}6ILg괥˾UKۂ>HV[Quw/DGG}B[\r+έ y/{ދxVL%s7Xv 4Wb~)ݼ[(ƒd#Z e]mh?>T^;=]Mll)/sCD\ן 5y請5/:Z#98| x{#*}-| 8n/0 zA|7L۶KGezOXLK%nQ=y~+:>ϴ_b+C@7>2{R lfs%p4.U~+?K"sukk^YWHcˋ ysyr80q/jF=WN!C~nYNJI@)|+RDTfݷZȱ 3'F@fH 8WZNfEt\ngbp%I&`Rڬ]Ciٲk%ܐ+!WCgJE w^L% B5+.+Y%{"A%Npە-6)X<,LK"""""%ubXM`vt' -+09:\K:F_s,N¼ \|{ۻȿD]H8HNҴoM/JR*َ-, Vj Wh'dc -iU=_T͇jql3щW^ɉ[JE-lBy'sTOo Ng q"nUe@~CXд-K/qSU;"uMȍϏ2p#p?>ޥ5^)Q\Chx{v"""""7%"7u?NVFDDDDDP.r2BYځĝdMIy.D4m kRb9҈[Om!A svn&bgBnFTrYXOlG WHbX՞+-fTy#R߶U[ўTQ]u3C`em&܃ssT*GH@yL=w4WD]Femݾ ѧ ~ nǙk2~jdclG CqO(OeL/?=j{zw Ĝ%s./-Reߪ%mCNGW3wJiOwm{r<0'Pg?05"H/E;ju-Xt# N~kJkpYXOZ=0͂r_p4őVuQzLL $%%trח1O|78enw;I?x bGٸr/I rd_{rJtRN.}L!z.|uBbV#5t!JR|݉-φb>wm`vڰAo$6l6 Vdbas¥rtJkB ]fj6yy#f[ީ֮snJ#b`ϳٜ`1ȳ33xN|q]Ü;Mg)u5:Y?wޚtXJM] έ$.vH!q#m5>|CK~bfnX(IXXl.G^v%Ջ^zѽinPF,[Ұ;s9m+aHşKoS`.z[؝BEؕ3]͒ǓIIݷ/ssP$rrь7a109lM4v:Mboqӿh4|jҪY"|>ѶAEB˓Ydێv"!S#kHNwԭg5_XjYд-K/qSU;"݁45Iu7}]WݬN)LAo[?WKlX#]-| g, -zt>[Jvm.?)-. ;0z묀64N_X|hԾ^"%unӼ4O3- 5c?a;jEV\ O*ԅJ7]XC;SТcBr&``BLJkP-:Srs-ot"M3L5H6ֈB[r_hqGqu|/Ƒy",{qb%ZO}Bi|x֥:lF["(wp :߯c&GhVJ}\ ZE6.NDβfK-X &T3xEnjt_5Kԝ)}._eB$m2v=EWV8H:-__4׼JȏoUugPlvNOăטe꫿(#6e~j>z~#&tp"5 H(Dpţr\hY>z}Xp8w4z? na^frP3gQiloʝj`X05Dr8&6{sq1s cW.EDDDDnLͺQǽ`t^a5g2v:udL҂^~LK6łlguZvF"`wӨc+kֈ:\/~jcvr5yH(fg<;zJJY? Z]ז 5җcYvV<ڗwhElۘvw6,)1{L&46o|6-WDDDDXc$q x#CK3.t )Y Bts6ި_is4u6O=`$0E,KGO}Gѱm,n.}33s'ȍ[sz w @gH5W1W0im%[>glkx4//3_9ȅ؜V\\p˟ZEDDDD]$ritpw]xus!b>.Nq鎽8/,C=,)v GܬM P.""""""וbHsK,`A^>Sv?$Jw#MW}0uT V*{v-1~km+X,lS~]M?oIe""%Q&꾾_ aݺuw"""\_G#of9 yoFc2K&a;f+mgexR40~'n\"y#'4]D$*Y###ٳg-")) ?DFFw("""# 9Ӻ ieaIo2qV|?*HZQTǀ77a.#`?ٯ_C亰pBw~MӦk֬yx_"""""r+WҴi+cZ˻fΜIԩSբ.""""""R(Q)A JEDDDDDDJ%"""""""%uDH D]DDDDDDQ.""""""R(Q)A JEDDDDDDJ%"""""""%uD5|DdžC>flM>!ZRnMܜwKe|AÎ|k֣B/~e.qxz7LcU`lk_"500L<07#؃NOpQqz,-WUڎKkl?AaMQÑ2 ~Txd.g#r&NTԔ we-|' cs\}cgt7'|%uq&2p>ȔXזoR8׋xNWd_%OI#~ͫ/q_UN|bW5ELVq8%chf_]G}Jy,̼*m&z)vlMK5U;2ؿu&lioce-젍rF2Gi춁?T"oĤwR{tWDv\:L?txb9iYx !n_ǎfٛxN<&00䪝 %j46Jx~]hРAaR*5loggg_sR/TR 'ixz{ <ݳ:33ӅN$%3AȔ.t;v:z >tVq0ώݥ%_'*XwY_0zG/ڢb& Mө~7rF3o5&n:1dׅiƻbbv,ЉݎQw a&#/^x{:HO/y5' 8N HKK+xWZZ?#2Ow23NC[*Q="1iۥ'*%φjw0W6,@9JK9۶₫_%*39b!OY\\@okOOȞt_N's`֧Ӊ^$˗\J>OԦcȽL.Q ۷3gŰpeE?qps籁50k;9swXģğޙKn3Lb&+Dz}])&B"*cwdYl'l$uk ,AV_8:FzK~%f-bք}wK߰+Ni|6jPcΦMشi^izԷpG?QGhz&5p߷ػc0kcġc_pImՃ`>rlKwc 22a|Æ)2a9+v,MJMxejm /bٵ/*%?Q=]s{,""""r-ܚι4JAeƁqG~Wz6/aJ:*Q뻑&O:f /v(Lt_W z;9*u&.Ł9Ɉ°թF6Ø#DF^3I=L%X8bϷ rIܻ ֲv6Nf89I_mRdW r#d ۙLW5~/8 `#q_ nؘFuL#BI汃zWnTA ^jӠA|J8S-$|\/[yɿl<6bg`O a.K{o#g|v]i;' .s/7c{_ImQ%$=?+XH=Ir޹u~ tpٳ,$ⴧB_^+MFBN'8LX,&3yaP;F88ϋNRB*> =pJv⏝ yPj?#~9gvNG9v7zW8"Z-xH:DNJ[8H?zX0M&6[y+V˹+f[y'fwtlI%=JBB1 _l{o?{EP@AEERzOH# );? @I6:<;lgnB夋%""""""rnnMԭmi.FS΂RMI'Qm Sv))0&y8saņ%'ׅ1ÙV &.D:"{w{oc摹w9Fq%:$\Ja?`^ˉ:HŪ q}`oy99/גRٶz ɕ6?/ٸg!3}ŏ IR5tdp|8l6+9YG SEDDDDDJy'%;F'2 ~;q5B/g^Ϥch?g:l9ZuWL4'᯻;ACya~xٖG&=Ѡc`_ >)aoB4$IcY!M 3B)ZɺT Q/,c?a|?a$x@J+//,Yx4`w[v%eCKDDDDD*JE|ZxCRz+|ڶmDDDDD;Q r*͘* ł"((y>OγCϊa6laSrذai IDAT~7#""B繘\.ݡgNزe V"%%4c4 ..Q`׮]dffbt/ԨQݡg5G^zDDDDDD,VXAVJeߖR٫H%m6tR*DJ򴘜Hyj*oNvx7>|xGH)Y4!H jѢ-Z ::CZDJwe˖K=TD]DDDDDD"RQW."w""rD]D=5D1 !;E"qw=9"""""""zEf24#ڞinq|v#xw󴳗KgyшHq:{=F 7T"UzE*o$Gpl0t|n Eh8sV\Xxq'^لnG_Jx'JwX)Qh{kI7@)&-#ϙJE*~9nbzמ$.-'g=JiGuy9 F?e&%:VRqѫI|5g?v%|K3r>.vL B7qG#1}.?7M,.+ܱ?8B3iKQ}G**,D]lƘ׮`ݓ0J^{h._~vEωzkĘi݈$\l`,_@^ FD.8nLـY%>:. J3c&&vbsuXvoͿtû5%f8q]&fOZ^hkQF n wv^D jb̌X?_:G"(>Y~_GP#W>I QAWQ?F|n98,-c-i/%~ rű Kdڴ $4œ; ZDU%Ot%myxTtKhM8z𽀑_M> VQ)㒔?prcEno3/}Gۤ]("h97txmMceur^\yGnlВd~[=j8v|ǘ.Vx k~1bV :./Wu%_xEоN RVxIS.R {Ɲgrx/~av\>'#3c< S÷֝PxJ_yx`fn;=A4[xc:wnN-qs_6b#ZskXkkjĂbQ3{>]~žackd|nK`ncÛo-=>[޽12W?=_fLcGY0fmbycn|b?NFҐחd׊H%4䋧mE^#0o}T.!!!㏧gFCNҸיg4 ѢȑQՓЎ}y%fj}ㆳG~0yO=̊ } ;o<Ă6aA7ma!~Z.w]~2lJ(7͕)AeV0%"0-t h(EX 7 &13%?2{+˝s۹n49Q;m38Lqf37E^45 $=n2^aQ< ,vNّӕoM68ؗP4l{-0"{ZwcD8]ӟZӓqٵQgӁ]xe=]O|vNxy9cVn]ӣGcsYSh:[0q̀~e99 Þ䮎Tv֜J%)_~vj9_-39 nzAՋs B[5z\Ջ 7n o] xNT;"ck8 [~_c`W-DTgN"{?(eU$%"AZ=wb/gV1W?{=4'"~ _X`0}+WYw#76;}R`?LKME.rT80v?VY?&Ι/pstҍn<Â<WpA,!Պtp8ݗjRX4$L&(" [Q=xlVlv bE|~x>阆D.,xUh8y A!>chiIKdb6iCݘbb6f,x_혚XCxJ**kjܙhxZro͓K`ٳ 'صh"S-#j|.fVn|V4r+L+1E#.I`17cTR&x D*<' g]#y nrҐILZѓ^gAw1\4i:{BMabc f\@Nnو4q_!#y<[zN( m&u `m/1犷w3-LݶAX|І `pDlFOe2+=4'!5It 8C~TDh-<ﲨǜQ gZi~|asgj2)B=4ulIp>Xǡ&Hj\4o&\wa`'Vׯק~րT'+@ߢNdV,JB ˟Ga5wH|>y~Us>aVp_"W=GRl.uc>wCe] pl"CY%E="k$z+a g{y>>J(<Ů&5\^&5kW ILµ{cƦr;zoyOvf,\ߔhHQ~}L旯?*:VG-N]_G` n8y.vMΥ='r~~3\];IffGsKaeA7sk=~Tp?=,}/bG$҃93)_o=8_Oד0g? qw=8wȽcEϐqKTߊc̙GKuwP=15d7>Wr$ޑ̡􋵞{ҾB-o3/\ݨ6F5t?H>z F&Vg/OE ?eбP75)b?}ӯU'zȋqʹ(mMyovݮp|DwM{yW="kҤߣ#D1DCTTC)L\܂+8iG! 22qONJJ 'v O%\˥+"RX,fΜYߌLuTDŭv;yyyի9_7aQ\9N\D*wYJE\SND*"['S].",Q)Gԣ."zaD"Ru2"RѸR."Vpp0.+ZHD*ł"88ݡ E)u)ٰa 60sADp\lذAz"Rєz\[7fڵ$'';b &88ƍ;rAuT4W."""rUEDDDDDD%"""""""urDH9D]DDDDDDѪ"ҥKHԶm[WH%СCw """"R,^mwrDH9D]DDDDDDQ.""""""R(Q)G#JEDDDDDD%"""""""u*w&7ý6ru!8;qqxTsXDDDDDDM ?Gr:ÿ&"5JPǏM6nݺv.fׯ4M5jPDDDP.R嘸.\FKnC~z2.">WJ|CGUɹH(Qjr3>!H%D]!vBITYl:Uo//aL,>,TH~z֭[0DDDQHUqm n`< n#JEDDDDBHf)#u#c4ZUk;m惉+9phDDDDDu*ȴ[Zc0{0_kӨQ#w!"""TU OYuQ7| uP.RU/>-_s-czEDDhHUe}ّEvvGIZU.""""R JEYx^#1x{{(ž4 }<{ښ`1N"PsEDDDDBHUJa%r?gDv`j"DDDQ.RU962㗬3w|+\D]DDDDTU=x~*?i%s64tS\"V}D 햩XDDDDD&%"rGY,pw$"""""Uu*gWY0 DxA .."""".RUyxub19bZX-=HŢUEDD)Qj\Xn*F Y'$$;6l&LsIqnw`v)2 ,6;l_oJa%w؜ c=ׯ?5ڮq;iQ.vmvmvmoᔨ[X4 mG ?Ț$W IJXSʁػ䬅uJv%3jԨݧHyTN/m۶g}n'//X>}:z:&Lu2a&:"yٜ $je׌cw>Jƍ`hwLA@v&GR _s18nM^$ <548D4aT,HYpeR=(<ܕvsme3j^ݘq]IL`֭'ʶI="ed߬qpZqt{s3;Z]-s76X;杢^՟}`2Gu)iJEʊ3#E?efebaُQNDDDDDΏ#JEʘq5 /+^ZMDDDDS.Rl _ujtrpm{+җ@BB)q."""%JHYrf15QwEqvOZ^QGnX}JsHll,CDDDDbr"etaw{"!>{HEUEDDG]xx[9V abIqX`-Ӹr-t7^^x+ØYH6[ßKϢy)CRm,/﹋:=6 ƣBv?tuP.R|rJ>qwEֿ:pAv勈YhH2!~V_/FB&QWYYRѪ"""RҔ%=oͅ0eW=6DҚ+a(ރZsEDDDDBCEʒa7=)'nfG5 ,Xr Nn9"ŢUEDD)Q)Klv^M. &.(3*I0,_5}ZR_sEDDDD %"ea4^/½2C/˩g:~6'ܻLÊgϙ@H}wO!2Ƈ~Y9ږEjnY2Wϗo !C&/굮{c xm AƯͬ,\il_Gd=bB=-he.?K<ν4XQֽ͉yR璐KݐCF9}?*%"eѪo(ywV;a#lϪϝ2K;WwyKx#:b/*X>]av4;KϸF˟_`v֧$osP.R>f"nbߏ6բr2yQ׎*t8Oj_z ?r/ߙu< js`BK0xl-[ ;J2|7!gTdJEʄoE?k%ͣ/'ɋ;\gϟ6.:[͆5g$)""""R(Q)+8?ޥV/Y 3n[w|ې:bL=+ϲH5L~MjZ.~."""")Q).Ri{Umڞ%)d2&;/Yky8tIg,5['ūPCƁլOYG:SǮc8U^۷%iφimwl[Mk{Q5m7w$w NQϔTU!%SxѕΖd-K;N*FHU0-zWsw0"""""ru$N5J7.dmyۆd-I:¶X9l?[t[0N]0&7[g fNtmfTTrGtBtAg_wX^'-j~}]xWoH+)f6.aɚ6nuԊ0g,^ ﰆ\ح-V;Rnfo87 jhJHUeoMw0zX| 6}SLߖfQu4dÜ_ƠZJ1ܼE\|emgsY^}" ÜOR'C`MYq#Ԯrٱd>;1O?ibBIgQw`Hybi}9#H^ 3lz v52wwM\6(?;~k*3\[/]sػGfUkzƠ%pWvORY*]Jr~a=i߉z S2M2v"vS@6%beߎC5nJ Okշ}ANɁƝh_//=(9Iw)n)΃Of5XjN|n+u,O@%aU+y'-q4jxPI"3:fZRώezS){ogrrpP7pHczR.IzE*^f'/Xh^/(xEh ?}.Vi - ٗJ6kHP?[23Hw{"0#2LchןYs5Wz!X-4hfRq30u[2 umt  [&4Y=Y4qk4}+ xTYG54 O_7q9ڬ'6VӁ 4X8p8lح'R.ݎՑÄEsٿ|100TJ f;1b[qvz_F 4O:v=zMٲh) 7ӕ uX?%"UIցMlܕF+ȟr [%#Z6 yp4lؔW16l6牴˕fVdGYv0^}\egaw8(w9|l']17hC5'Sa{X6p:qp,rpڰzu !-S/p\4}S;j/:NM[[y&{W3$S.Re9@I8ڝdSWFt ȟ#ppp/(V-?rؚaIzj:Epnѭo ã3 &iRIM?ԭٓΡI79sv`Bj jCrJߑ]P8H'?r8jR`хJ vƷDy@ q훲p#VciѸC\7)s(~N>ȒҾg{jv]wÆKe`"m\~G^-䑗GuCHeA:l\.V>9H;8o ٘bؤ^3!C0dNG_͎,u6XN3kT>M,m ` %#$c:9s 3#/G%vvI?bk'i';vrZD)]G\I$}(6c%_>Yvŋ=<]%3oƗcN+UWlG:'cWs%izԲy{KLW:,Fj9^KTgoቕm7w$w >¡=g0 BÊaˮ:2Ҽ{3~w`7ĞGt@WzuojQjQ4 {ٳߏ\&AM:}!?O\צU4D1%"U1^ ם8`s=k8e8No7P u)2|Ӿ?uڟݟK%akoSY&AK^[[ J=2)졍ueӶ[:rյq@,06q33,=nֈX:sM87]Kld'p Gs%<ө[]gh"""""nu*BxY3\/;^`n#: NzE,N`\< Jo[sXEDDDD&%"U\Aw0]+n& Wj̠]"""""nD]q勷q lX[xUM劈樋T5$oť݃1^i7~m߮5=HD]q0xxЇ>C#QY5k&vمXiޣ9EHS.R[UW>%}HD]G{RqH4G]DDD*L//C@dƣ%|8.OS0Kx8V?ISO=șʐU[#"qfn3yZx¬9HD]DDD* +ƑlNg'=f,Ad}>Vd;q8sӻ "-QC-ObQu)U}ED*' >l]dKo@Qs\WkHPbʹsэL݋ cW=' }@z?+)VrEĨցgb:WDxK֡Cw ""A)C": 'ƍ䡭aNv\C3 l6Kf)+3;-ѿz&~#&/?_HĥhRc^=CYșƍ38DX^^9s0pbWRRR89_tR )a/m۶g}n'//X>}:z:&L9jӰw)o4]4 }FTi2."""""卆K"""""RިG]4 }FTi."""""卆K"""""RިG]4 }FTi."""""卆K"""""RިG]DDDDDDQ.""""""R(Q)G#JEDDDDDm.ny+wu%&2Sa \ژ?ohO V 8x\ [G2qhU_Bw(쭓y0<@bzC|H|# u275lzm'W/˚us0M~e-,3_.Y=12;]^4-9v+~\ɀ)lߑjfaٰ{ErM-[c׹C^o]Hϐ5)?h;ߓN%Ոe ,xժ9dO0>U. 5kWP%Vwo ~X RMÂ`?͗b`+)Dx{ފeل]{zc lO_E7_qvACsUL]9,%.Nz~䧼Vbƒi#6:k%K7Ъ?'.:ѧh۳9-kZCI58XFsz$<nHF}Yy۶'l|0j뷜2ݽBnyhԝ|՝/Vɛ{g ;m[}Nv.f5,YYd 5"hK 5zB>qC?UJC~%Ҥ&_1_9JǦן庝ze tqZ_Q."""""rVdf>2V)Ps[7n%V-NaY;ZSySvwa\ro|{K? i/w98 GRq'çV]nYذ:uϱ2=6tw4cwtL/tpojyy&kogӊ.mwt0™ٮyL D]DDDDD,DDWǵet+˒T⍯O |p󇇹9$lz:| Mp枌&xˏw^ɳB'238LVi˭įZ V/r?ԩn;p{~2NxǕɼvr|\[NpmdΔ?ٞ>̖mkؑdwP[;#k:s xw7~q ͞_r8|^׍s\o6nVM%""""""Ş_40)&`~f!C(a1ncHw†c]= !{݀ƌ_\t\ gYP=/K_XٖAi8ݞjU9K̠2>GS :uބ?Rk*UѼD[ٳ{ ,51T I )êX^gRF\_sW5&* 1#%<Ȝ̩T%rUp*6ɛm۵i䶦cspcǚC t"œ9s۷y{睫.<)))L.Y֭[_DDDD<|;9t\UKP]tYx:B˲Zp}8VښSg'>>cq8ojԩSڵ9?~| z#ԋY[ebY:W]߱'57f̃Wi/"""""lufJOGQRx:Bfr?a7x%""""O= IDAT"""^DQ.""""""Ex%"""""""^DQ.""""""Ex%"""""""^Dy:=%"\\\C"""""""^DQ.""""""E\˗ӬYB9u uVڷo_(֪"$8NzaH!9r$/.cG]Ņz:)@˗/gDDDpSzB9zE I,]JZ IDDDDDf͚Ѿ}{/^\hI:(Q)46A~yǘ0ACEDDDDJ }-""r&JEDDD.@6m """g""""4ș(Q)$NO?cɒ M[JJ 'w+DDDDD"4i҄mrwShQ.RH~is$c8ZLNDDDD[\m۶ѲeKz- R(Q.RH,It"""""R4iB&M^:,D]ɉ ."""""CӦMy9rd_jٲ%?c[d޽rl%"""""""^DQ.""""""Ex%"""""""^DQ.""""""Ex%"""""""^DDfڵPDDKxx8aaaz:\DoǕZv-N{: b ֭[d"RޔlY^O٢ _Jq*^U2v+c[h`urϷϑ'')Q)j:7'2<ϓ䳿c&4LFyD <_iVidf$ya]S!$&rNx}f!07=Õ!%6ob8XDS>X/s+͂܋872ɀf5X_Fk?f5ٔ#mb8;FwIx-L:u^ VQ)⒘ȴiXz,r!ZWqs^{cPd>M5NŢH;WJkUk I?qs<0iV9} /**RJ,]GZSGhӯrm1\\ŴQD?**U=^Д L;wz,xm0S~eŊ]W>Kf.60ks{4Y+8׿ŰٳóymȓeNc~ڏ?]X8 ϟ]oWn2qυ/fpϬ;|O0nM3\6Σ3.|f2-`Ʊ\wbͯ_#\rOό<:ıo0yyV I#&џmz0 &N?xׄa32@*s~Wclo>̂_~ClX([5[ԠL.|]~B,9Y^==4WBY=^F@I4ޚghd͞z2J^i`"3SdWFh7{Rf}>ǎ)-DT:O$S:e ]2>}^&_7̓|qUEʆR~ 0Mti\,D}8bm=cbmEޞ˝_; 5?A7 01M'OcW;Q~T^Lc#ǵ֢ (o]iQB絀^f ?3I#ۏvNxusfneY+O5ϼ_;'Y{HڄY0BZ2O9XFiꠧM$e|WkNUE^zѫWsn;\(ߦwP & =SQ)RTxAR.Ra3 iwOW=f泏/_̮ w1c )!`P\cij2fnntt['ԟWp] [q}$%K3If.;fȭ;Ѯ}G:^, &XQ!;XVn7+@"*9֐+O9 ɔ-(Abbvq=z\+6{0!GtZZMܮ|^G~f|.>Θ阆xU8xn,-q5W ,-GYh j֨A1xw+YWFe,"<%VT6jܙE455<6[d.)[X\k"+Uu_sv7n$jbfVb;rS3궿W|rmyj~SO,=*ER ݞMs>s3' 4Oc.[*]z3g沉S36*[,®73?crrFDV sU~;iFux9WM_sϭdWoXcm(qd6FLL<۴c4ܾ`F&V~ |C;.S_J :ۏm7 3o!JM&}BMD\fyIaZC)VFNHؕ;yryߊ7zvԮ]pr)@h`M`V1,N=w/|j&ӳ~ | ~͵s:V}x WW>OBl./.u9` Z>k?UԳ'%FQE;bνg" j*Z+1`̽?o9qS&`]ʕWӆ|ݍ{xFIw1n,O;WrO&nlnH@/9|,K/dmaT:r2IT%v(Vr1m:tFyw_~47fv| V{'w`En[|ѓZ7{b~G*ˋȻEj$Xn'Na7zr⛏Y䄜Lh*ȧ<]nɊw^bΞlMX+^HQvmϝLft- ˫>4_塕};ncoS~r7,c!XB(P\Ωr˘(uAIu(ܝ7JR%aLXRfM*(YǣgO5Enydk4,l\[V\ә~cn;f&,ݱ>gt׮S4+EQճd2Զ7s,aGVNtdk^OLe=taj5<0(:C<{'tDZs;=U%pL#o`TR۹ghq|݈d{xdb*CWt1ɑkq5aA#5;NQ׾ˇ}lZDTL^v83 ]gxC)OLo5*4ɧ1a<~t1Z71zQ.n~CY&y|~̡BJONGr9kh^"*VՈߨ<%OO3Ǝk2q s̡o߾w󤤤0aBNj>FI0uT BWH!X,̜93J2"Ro=nq8u̩Sҵks7~xQ-j\['S]."ō,%"ԸHTHq:KsEDDDDDDzEīFD#['S]."ō,%"pG?EDX,n<WP]."ō7JEk~z֭a~pݬ_^z"RxC=D]DVYf 7ɞGD伄F=WP]."ō7JEī+"R.0Z]DDDDDDċ(Q"JEDDDDDDu/D]DDDDDDċhwbnɒ%ADDDDDy[t"""""%J||έ"""""""^DQ.""""""Ex%"""""""^DQ.""""""Ex1S1[Cnv͜ɞn_􃞄:eSl5*?D]rӹ5xm&}VXۓ+} TƍEn޼yX,֭[iԫWӡ\%"DH"˝nWJdM0JEDDDDΏF:&n єou3X3,G.g[0`8m}<Hu&g*C31^XRAGG](.2s`f:HreXEsƎ`B:hwJE+ƟE3pk与L7 ZŮ"XK*޸;Ook]cfaX9},eTe9%"Ea_f9poڍY{[7o|+QL"@HqD]ǻSqHQH3 0Wg7EvaGC֭[wG:qk{AoOHHO=G>{2_k.)ڮ|9 })ROGH{~ }.ehp g"E"66VEDDXR.Rt*'oq)Ҟm_?֜+a/FsEDDDD=?ϻޠ2u"EE+ 5=B娕ɞ=;d[,+\ X*5Ae,"""""rzE҉g47>~'%p(ofIq*pV.~L3U;x"E,ww=BD@*8e}[6"z >ՉnWפrT,>&naݞ 0FӪ"""q1bOqVjxi+ʠom蟔 IDAT_lJ7-uqEs?=k7K.dAvi^ٿ)ᔨ]1pe{C {]Esk6.mHXx ĚٓXcLq"=#GaS.- %˲eh޼yWސA9?S.RD#92bafCռ"&MSk+~2Mpm6n'V6N,;Soe,D5&6d8QSKş˖-[t_yɗr6z!gGD](69_ޛ}lI9zmg(psu{g9ļ'JUs9^֒Fg7HwS#Ghu)0 8SEDDDDkUY61;ۤG25E\LZ1Q'*Η=SO# z)Yw:ql'U VÉ &ƍ+।Yti{vl)|ސO9?8S.R$,8IQP.i>ex0|IgC\,Xrf&۸l6vSp9\l&޾7Q.RT 1A>K~E9f~) [|]ja>8Rv4zWڝew?RT 2lRr ҰwHHpd'ڪĝitEKnƆ+ۂH%mоn+KEjV;Lj#iDDDDD+%"Ewc8#md4غh [WЮ]t0"""""ru\* $oXȼ%[Iq݂NRZX>@5M:ұaN]07i#MpBܠ-E%\n]}!0:ӼY)i t.QRXW3ݍ܊A",^l{twGv 3'~^2+ҎqT/SHb_Ϩ-y:R.RZ㸥7FjAT l @1SaLjY?g:VU_0 _w!"|;XV~#N|Hߗvv/5mcYĵTSeylQy񔻦 5|M?؜E#J>~]U #y f.HP/7)]i`)η޻[iTa⟘WEw-]?I .o1 SHi31vnPL>_nk'6$6̎a ndmFYP/@\n?H k`-SFl|or`%~[Z b`/M9Jwz(n)LF XjLl.6q任;u- qlR]Ec5|(ߠ ّyʎ=^kqǦTcFT3998Q>?tHcPYO-[,`V]y}^Ә1 /7IO;DPِc%,{IuC:HKw 9oaLTo3g"S)\%F;G!?BCK9)o4NO##:GHl!I'% Ǜ !t ۚL,1-;WLh8vJˬx++bj'W?mQԪ=(Q) oh&6$O_7q:Xm m M,M86)nt4!n\-gW W3Ds:ql'5Fv+NǑޮouG*#p9`a:q2#6\$أ QXzؤjdKpdI驛ױ;%%۵ ޯHPFjF0N"1S&',.~.η]ֹ(%UC6}ZD+/6ʱ2QGKI.j5 SLemتUjRƇ5#H\rLYo6UWB6c Lܤm_Ѻk-ܧRannb]r$5"RIr'`V،XN\0̄XzK=Fp,[&3wWc!Z3:5)_K!6K˜?!$ag:WE;n%5{%CzNNo?_;d]2[#拿]uJIf qF>o sb/ͥl+3ݻtBr4ښziF(tx[IIqv=DY :<}!LXWY&GFix1%"52]^0swe8=.o7R=j/2֪7Z=؞Ci[ԱFA4=u_4]D:=NG&^^;m5 =hM&vvf9#cc5"v tߒDJ+[}?Ֆ7\qamۄVͮ4`PHeRwX#\?;~LS#ok%wnL%ݢMDDDD)Q)uC [:o|+x <RNHiۋw|iYL??@HdzȆ>{'ow)|補/'>B:.wl֋晹wӗWm*S(JEDD}|egMvv:;=EY2U8=E$󋑼<ӡS>pm|>_"iK*)"r^T]H e#NnC+xVTFԽ~7 ><].%f]YD Ҭjej5lIQ߱?wwwy}Pf.~,KRM ٷWݯ+4-ErUӮQMb:>卐kv(>ԡʈ9^Ĺ/k[֥jpjty׆ LٕKנVL-~_vQ^TO_D23{/υRJEDDrn2OKYfb<6`ǎ<#7lf\<>{$~ǔlZɬ#qm뇳姬ܼMfps}w0 6Ig!7ܳ>pKX^z  ՚ ~.z b2LsRu YxkSbk6㱃sWP;ȫ3~ G43Uْt(GPزSzܙە勈1vXsȐ!CX3g}=}sE'%% :s%Kкu>.>>cq8uSҵks7~xx%"""""""^DQ.""""""Ex%"""""""^DQ.""""""Ex%"""""""^DQ.""""""Ex%"""""""^Dypnz˛ί&8=Q RSaKFOD?e*֧`du&ep =nyoB)D&r󎚵 noMŰWc;KI7ly5qbc9`e\W9bαc$׹aE˄Qh~5=vo^ndjiI^IȹL}5[[/fNLܚF_OmLl#]3=FmZ$8Fq .GIx?_' qu8$~7j6$,R걂'^[wS."""""rf4א!TB:Eвߪ}=4gyƄۭ]r }maLhv Pzw.o݇0( ƊJ}WQߒH%!(`Xuu]u]uTltUPTEi"B {g~$ ~^3<7ܙ3gΙ3gsf}N7#;7n N+Ӊ鄍o`󹓹 F:.ށnwk`R#r)J7ʭ$;WuQu=\U?nyr7|:q8i<ʴ7|Z@@]DDDDDJ~14]lIKbe lHF}wVdنL(`OS̨jߙ%Xs|7Uw )ϧ q|?L&L:#ܬ1Fy}Ue׵} ;vSEt-ʌߢfxqXiJVn#*=I${jc ^>DpХʴOdb~Z-@H RlLL;`RP䋿߁wauEf<79n]MqgtQu,\KyO(m5ݛ랼vڞy GwO8Sٙh oڞk[m{ V<8~*kM 1/x8 0ח'cܙ,2h;<={ 5E/I8eZwOfӶ̷""""""2+$ (,WLaсSXH M^^̻/!roΞLNaK$\f<^y|u9D~r^ L="+/-vyp~l{jOyͷ Cﾇ?Fmc/*27(,'Fzv7nvOSq}xOrBXR0xMwui= 0ϯ.Q."""""R/~*lOׄ,6ouM NL$@u^ Oc@`m{&_ʟWR-tq/KRp'Â=gpۼz7-f ~|q٭cU+&ĮKȶqO$Ty Cۿ!Wqì' g{f!kزrw$})]y֍K2P_Y@~ :*NLB<۶fSY4e{(9n:#7>;>-f)[ޚ7:W1d~z9;K01)J欧۠x_^d*o/f`8;ЮW/ `d.eYwi/}Bu70J.xؽ=w;{\Go_C^QSu{~ O2e}Kob(+sUOƦXxO%lD{O+BwRg~[-+1C0AAAv z 4H? 6'ڡә}G7꟣`$NO~ĿN1<9ض{3kGK^8 T6;Yt!8f0w9s\>̩?Қn{ޙwa>=8F'`h'˾<8iMtt4ѭ J Iy\Axx{Θ?V`Yq`sS%|gg,.=jٍ~-EL'bܫ GrzIJ(LI&7(^{WEN['гl3} 34BV,YK¨tvR`#rYIZoesx úf._5ovv0Vq503kH^g1dՃ<(7iD]HXvb$$:`m&`# " 'x*WF13LJVzwyaOn>F79BfF6m)-/^x&8dP11mu={|4wf$Uo6XiP;-Q~eEОxrH"[h-~%;Mdx0L `62M+UL[vcdaG`3'<].ێ_pP٬Mj *C(Ewl5CPHL_2&QQG|s B[UޡY)8P.{l#S~ktʯ& q%<Ǣ0a7K[oO!< hQ EACIۢLl&wz4tVO|}.JPC'0ۮ< Kdhk~rJ)wԺFdcl`MGibev-6P7L\VM׳ygMls(ϏۅSHֆUTd@`Ӭ=Kþ\ 2=ꟛDZÍebֵJqdyUz& L{!i{Waa`(řݝJNUd\ 􌺈5 qnjvABH 3ӄPm}sQffOjZىopQ.i=0[6 hs@]4JlL&i(5+pEgUv:K1L+f)%.N pe4( ?{Edf6z]i$m" 3<l#ʳfg+>7&+;N'*΁VÁąaelqiw۽+kJ^=Yؚcnx0sco`?7c/g?<tÉӯ5_u][jC׮M vcPDʶwKJؿaUˬ㳈_M=[?wuc&aOFF~&0طC8~^5*JF*Z-i_/¤$/R܆* =#! 7w? Tƞ̛Og[f iא|Qi$wwa;S(v&>6.ռ_Dѱ;$׊Xl& 0E! k44; -f4M/֢Շ>E!-uFS)GB>Ea-kQ})Pi:=ur$XZT֢ՇX.""""""b!Qisgs·Yp! ᰮp.!kާ>/`dR,C#"֢;>pDʮ14Gpzu'դn06_"痙2?Q!DҹL~kk h4qrUN [?&FDWyLsUSO` AAЏ /9{ݧ-aN̅OLabqN:G2'Z?S-iu־؞u1qo`4l~5;_Xbr $uΌV ~0*}lj4Z>&]oκekz]`tذ?["$Θ- -ujh EIڗqbyg|./wKܹs;w-dM{fpo=>OilQ\3/ܜT6/zƗ7i|yMN疐/H CuɼbMyoڥvӯşc<^ FopQ~a/xbD/_t.ZdYtirrsMQ-`ϳ)KcSLzi}6[CV~p3tn7;_JGíѷA*(PiWJ2t ?8Apf 0l~ Fg!op""{_K_6S\ 11eֲ/˕p%+7mu>#G1US}W#km;p8&_p]Q9p|~#{/MBb\{*+M7nfxvDGsﰱ|ؓKtlwκ+yLL#/˔en݁_^`iՆ^MeIQgO ?1miПOHN/`b$8qO`$\F:o_~y >v:ݻ?}쬵י11t4k 1᱋㫭3WWz^1]]G{?a5|(]˾/X. F\tv m,,_}mt>p4-?dΕ`aY;~2˶/F窩 3iOJ9.?ٵ= .| |?&܍wP:HjSY~02imIb;Xq睼̚g2ky1a;Vs?]eyv%fw3=\;-[?c\ڳzHڬ+JLܛ_{֐GyBT\tޗ^LW~~sq?g-Z_{!?;l/O4?/铹{Ps7IK_ϟ_]vr2Mx%|g2?]K;Iv7ԼIgnwRP5/^ʓ'}|6WWo_4^uFxx< "QwL.Ԏv?)Vx^^e` dXz=rЃc`:p0Qg0,^isU\+Eg%eI<54gΜZs2gΜjqO||<]zn(_0G_sŔQ8 |]KXsvϢӃ2Ncw~\{Nօ`=TNId>WyNO@BOfx?GgH ï;ÇDk/4}3&NV` a5SSK*3DŽޞ@ƘL20<] >#y$ix۹s>\\D|㼀c'?ЉYnKm: f-XC']5L:Ēl>}/%~tarm;/x23O/κ )OY2/]N=`xwdI)o55LVV&fY>}6 KL)Q6j[~ӆ$遐L45]@Ri*|‰⫲IDAT6<(No5/h!'qM|S*y**WqxYza:m|0z֏=4^>PZ[\ʖԛ?-3/;of}IY^+˯ċ~)Ouw&wON>:{~RmT} S^2`7qb~veKT!3g5PjwP' eƁQfuھY~W0Y?{<3_ĵ/wsI/ :^Q L#ÕNZQQo -c-8`[EDd/xHS Zݙycg i:q^n]d^~gYmԷ:P1íOZ ay{HKI#[xGٗF)%!WgVQq d7aײۖaeUcռO}a]Uژp11Cqn"#ן2Gf/4 %Uyw0~MSHn /]߽-!{1O?y!Wtmz(1{_s׷ wnW@]9;`XCOx?5>[s)p礅_^#o.w`f#t쀇=)x`iu*WIsڂ ?~M5n*F^t/}7h&9gjڇSP"y ޹80v} oF֦( =M $*wY00 7H} L L7}ɔ1\zμoz^Egv^χ~`U$άO_өf#p3@ma͎*'lr m7_=ȕR޻,^ilH"}RٻAe))䄝H3"$`d%Ō 2)`d٤rbCܲYVuX߱([J{A&KfdJUS`mC1hEwNzD8QȊ;sc}їy,!/c{_/wd}cqTy(anJL9/`2kz5[t)uIY<7-=hqQj-K}m~LJN1{Xll߃.&>B޾ E&&+#1d-wVDiLCnY}X>b;+bJ2x\Mťxp9i—$3%pH8SXƋ,Mb۰ 9-,;f,d֜-n2ս9:-R[{z <Աj5(̠(+="|b+ԊMSieDžVK<{}rw5=5oŭ!;λo略&]ڰm`%W19 퇟?jT-/r+v'fPeu[)úl Vd{0v[_^5꧶Γ~]3TBnms!=2ݵdM, }mh:4N X/?{9;&23Cn#i3Z w]#2|Ǔ0!vO^q_a-.)aϘ0dLglĵ;>LLg&T4N~&WcR3e 806kwnĵ@1 ule?;_'SͭTrON^3MA~6\޺=O㜞't۰ț( 0_<0 |b (xKNs<09n%;sƓk2>ȩଛoyW`$^?33 cIW>XE[{0vDv}|0M{I,k(qq$ g~W8@y^pƸØq<'VZڪטEUe^F'0-L;n|GrUx '_PJfBW A8{+^Cg b_u9/'S߾V6h>54۴i7x"UK.eРAxB&|~?| ^v6mDbbbsgEZ&_L޻l\.o@jZ C `8|d!5_0:Ny4jbS4e˖1xIkzF]14U11;^4UI94bfanZ<e3xwe7<jaVy~>̼rNm*m :^IK@]DD&-#6Yjڝ}k:j8JDZygT:7T/Tia4FB=W6ju4#]#Ѩ-OZ%~ZȊ~)9QCid#HeTGUx%-uFPZZYh.K'E>Ea-kQ}HK@],^Т߿ -kQ}XZT֢Ԡ)Picǎm,HYhQ∈Xu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(Pgsg@xhѢ΂P E; """""҂w Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu Q.""""""b! EDDDDDD,D(P"""""""@]DDDDDDBXu q̞=!"""""""JB䴥~sIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_popup.gif0000644000175100017510001014342715203313266023763 0ustar00runnerrunnerGIF89a81 & 2$C+R c #3"-K%?e.#.=P.Pq./0,101G1449=>''>AL>Xp>l? ?@]@BD:7H6%KFJKPaLPQR'TQURVuXTZT][p\__\gw^]_OIajbrbyc>cedddee).edfdgH0gfgghfhigiilomd^m{noptx{vw|T7}уeKrXƋΏ(#~rŒ!0{Ww̧ݫ˯ǴûĸƩɱ ŪɿʩACη! NETSCAPE2.0!,8 & 2$C+R c #3"-K%?e.#.=P.Pq./0,101G1449=>''>AL>Xp>l? ?@]@BD:7H6%KFJKPaLPQR'TQURVuXTZT][p\__\gw^]_OIajbrbyc>cedddee).edfdgH0gfgghfhigiilomd^m{noptx{vw|T7}уeKrXƋΏ(#~rŒ!0{Ww̧ݫ˯ǴûĸƩɱ ŪɿʩACη@K3a$\!Ç#B("ŋ3bܨ#ǏC)$ɓ&S\%˗.cœ)&͛6sܩ'ϟ>*fH*U 0"5jʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ È73c)  ĠrE˘3k̹ϠCMӨS^ͺװc˞M۸sͻElKSaL2jTУKNS νcNySbAPo Ͽ(h& 6F(gfv ($h(,b乂)asb+yH@)DiH&d}/6PF)TViXg)pa*ˍ":2hlp)tix|矀iv[w)¤޷efڇJ"ZB^*ꨤjꩨꪬ bBU()歈Ψ歼\+kd^j)*i+3竤[bi|nl'"k覫kff2(뜮bJ(,l' 7G,WlwZ/ *")(ر(rh(.w* 3(ˣhw(-w ,z2 ̷z 褗n騧nق1d!?H"HL& 0D(fAYP-n6;Wo0@GP\bD b~t;$< !"| bNF:򑐌$'IJZ$48LM̆C.D_!AYXnN,gIZdY&I)P"E("sc $3<%dAJ`D'LjK b代$Ԩ@EwvdNK,NHE( Lg{JDtj@XD:ѪZXGJ)T`11NIxW blXO`e~ɺ `KMb:d'KZe.(Q1UbT1A0-f Q^"#9bh1πMBЈNF+:b$;8Gٓ0"1f2"c(! bd(q[xS']:J4i/MbNf'c&l,D(n \' UyֳL8G{Mz7 |?"! 84TD&PE@߮gU‹6J?7Cv6[O 30g_? *',x1=7&>nPԝyXϺַ{`NhOڍ L,DQTl(nQ ^}ڕ.k c-, jLXfڮp' ?se֚LnMқOWnm:-:ӎ~o=ԓеOqO$Rۺ'++VU$$aiEұK<%$q O`b}OϿ|'|5n '>SZP ؀XG{\Gd|Y~P~PX&x(*8vmׂ` MRg"H}#؂8:<؃>@B8DXFxHJL؄NPS(y ِZP P @ Y (*ɐ P #IPP ` P ;y  F E Ő F%iyXZ\ٕ^`b9dYfyhjlٖnmɑy |GWI;tIzw 9Yy9 i @  @ F&ɒ. 9A Г;>ɓ 0K`M9HY9)rYșʹٜii@ iy$i *yə0 XCiy=Iٞ0 ɀ `YV Zz ڠɗppP: OGy Y. ;#ɞ) }WI *9:DZFzHJLZZ5 0 0 @ % @ W Y wP/i)   :i 8 &99 C9t  ` p Mzک f Xj yZX P @  `vp  ]ڥY: @ )Ay 0 !꣸ i Zz蚮꺮`1P P @ 0 *   xY N@ jp P P̐ [ J ð€ ГnnP j @ ʐ yOɮHJL۴EĚ Q0p 10 N`S0 &pf PpХ  P@)@ܐL PU@ `QZL0 e@ T 6P   `) `jN;[{j p &P# |`@ n L` Q D )ܐ ͻ !0`1 P  @ (p' 0p  ! #%'*,)ٻ3 }L9 ܋ !P k@n) J 0 P !p0[pAPe :p Q@ 0 U ` x`Ȑɒ<ɔ\ɖ|v@tB c\I[iZ.ʬʮ۰S pd kA>  ` ;n 4:DiȬ@p @|@[ 'P[ P 0U ,`ǬP `kpASP z7UT Q <"   M^;y ֝O p fYP N @]Y&Pp`Սť '=`NPzSR p 4p {> {J:uMl~owr>t^v~xz|y)>脎J2IГJܠTm Հ* P ǚ<{ !iǐp K Pňl7 ų0 ǰ 꺐 _ܒ1:s.pPw-z ڠvMxuyqsyv#sNEy.}}-@ y&Z *w;:ݥ pO < < Y = t2 ǯe . "?X쳰w>P.?mxy.nBFYOqAERoc]O @瑗pr/!0f 6i0zYvwy闸ptP*Er~{ɗs] ۮ u P@  M  װ poxk?ewaU qUT#.XotjNy0<_u@QV\p%pA s!-YD]v"1H3 -Z>t9K5męSNv`NPtTiS?lڴϟ6gR'4mMuhx!e-Z\Ck^H̯41e\MGW˫5#H#D2I%dI'-{Yx%( ,` x//Qy>AFA+d(+ 1K%@DY#@1r1CX\Ԍ4XNaFDz1GCҮApK]wW_6Xaw9)a=K F ~y PxQƟc~xA %hyoe1&hvB@m&AYjQ92/R1$> ZKO^NԕSQuE1nXaCZ sa+"^F\.ּAYF:ifzbI٦Y1G~DAp b%  (% |qf-i&֞B_X`'lk6(9ЕVN°QDvEX=LŖYVfK%SzY=wq XTlnN(#RA ^*e0ȁ$:Wgy矇ɧzެ686'}Ń*=oiN@|!FT8J1Gh s` P',(&FA VPN(q-$ `%f0VT*047V1@"! #ZpÀY9:10 `8B3Sͭg=2ьgD4'{V7U`8XG LF $q7x؏ U P8F i |ܣ 7W$$@ Zk" 3 EV,z6"0J,`bpE<ܐB (1a")%, s4"~3nƢm$ @ -X8 0Frc>O~7-|O}(P9 Me,$pdc 10#~ l *@  Pp P;M]_>@XBp`VDXFxF@ "(dW=PV@h /Lp2ch'x%4!{Աld P Tf4h8j0qC gR#N;΅hK3,qmä8Shz& RnY̩+8SH" V8 1 X, PWZ lu ^ @% N>Pp` 8s3*PTB #v&w>/;a W@/7.*hc&3:q:@$&Jx0 Job\ʌ Ġ0A~o| k " p#^Q?, )h+K8@}Fyj]@E{!H0oFWnU6L^,p&H@ C[O{Jt5dزZ'` 0bf< Tf4X.AHzI X Є ݇ÁܼЌaU T(ĀX@ \q r x+ъ2aT6!^V[0&Pf(l-`G 06Kw+! @U/DL$,@aPw9N<r`/aÎ׀3vEoW8x72|Î2>)lxqԆ)L@&( DP]&T@%T|jٽjo<bp%N b}E1b8t+'SWbc_B!$p˧hiW1,?@Rr3y>Pa,xeIZY: i/d(Q fm,B vBDxŧN +/8+rV(d+)Q W$#M7P3Є+ [hX7#@_gtp9pS:@=  sxNbti@ Y.I/X蛷1|J;сZAًiϡ9TN +Ba,4{ tk  T' = xp:y \]H0*gZVA{WxZ B l!?b РAXdPBȋMUdVd-tE&oZşk5[ORoad@[tCpE_F_LdJ D y\h!I0XTudRZOkG$f\\kE^t_t2}L[{tf9aF{; r!Œ0 HЈy4ɓDɛŔs`WЅbHnXQTJbKR;KhPlڻڅa3?mAA@?;FKر%۲5۳E۴U լԬal] }] WQ'H6X ?0$(V)Mȃ(RRI-G!=p(BbXЂ$0 X2N`rȂ2?X2ZM:gZdh ,!԰]TZ\Pt^{|[uعغ-ՊX(S(<80s`8M#J9&xE=沁`Ix'@Vs(mHHX҄5H= ;8VMrG`;VwZx_`mbmh:!a8=)y: !&"6#F$V%f&v'(%FN޸([m 0Ȁx XZ PH07%?,EcH(`DlvXhznXΪ: FxHRxh5@7@Dh[兏ZRlZU>^ueׯaf[\]^_`aeb[ T9c=GEqfA9'xeRfh""MP+XmX 02fVKJYFWSxWȃ7WHW_q}-޷ZlPu{QuQuQfhih>&6FVfv闆阖陦隶&>fWzIdeb+an8*>0ncsxB(s`cgcs*Єj&E.^Y insm0l,MgZdf@DaaQefp$P#8#lͦ=&6FVfv׆ؖ٦ڶmcCaަ[HU0D$`*VH%hV -N ." 0?vQ_T dP)Gq Pq_!hgVwWXY F`І$G.s^`^hU݅h4ED^(@vbИvvWzY`8\Q Y`\hvf`Y\A商N?"0P'! Txq&Peu__`߉_(ZƕQ=iG<YeW@ZvZvYYЅaׅn'Y8^0Zz=!ad=Z\=UG@e0Ox7uTW x{!FcTX~?yUމ`e[h]Ѕd`Fċ=zk'z] Zw0RbGշv`Q\ hВ&xhP7GW0ZuU(vo\Y~'E`uGH v*65x` eTypeF)X!?$2kѬQvڷ7r#Ȑ"G,i$ʔ*Wl%̘2gҬi&Μ:wYR:a(ңpū-_RzZlҥ,\vՅUZ%%pYz.ުdiekj]^|Il-XXȒ'SlXCeY@2,FhW_5زgӮm6ܺw tơE.m4*fn V,]fuVoɥ;o^{Ll֬Zx5Yo]o>~7w .Ak : J8!F}cU9TQ5^YB_RމXrMuW."5ָ_#`B -t2 zf!I*$$QJ \SZy%Yj%]z%aI%Jf8͆1!r6hՌ6ʙT(y'H@CE^M*(:*ӗ9)Zz)^dfphrXDž(yz*g*=hC& Ed>+FD}N:):!㩚Ɓ"z-ᲊ:="$dCFΡ{EI7hۓUB;0, U{,)*H -xR Ti1{1!<2%lXw[+(P$284޻3Ϯ?:x̾s?PI;4QO1 צ鰶mQ8re}6i6m6q=wۃH'+k)P ^Ss787=ε< O3XO9衋>:Y:ꩫ:뭻:>;eGY7 NK%-T1)oKz;< uDw[]FeZ5q)RV"-r^"(124\>55ʨ=~# )A[$5* ܡ䂮4BYgјF3AqE*P2JJk\$,]Jg8ge]򲗾%0)a,e8AN(J|W:8axrV>qs<':9BKZJgtW#Wjڔҁxx7I>)hA0WZ4{% b6M|3],g9өխzq;շjHB= \O"v-BxH#k_Jܨ4##cHL k?Y)8ZRXI4U3n w|U;*jS(MCEl晎$~bMb< d\.l8Usr*4 OUWOϰ&G6:ҪR'o((HI޵L Sɛh`F=ٗN}7 ZZϸWD!Sw=RSm85l I[d +f]eMԂmdh.*nu[6p+"7e&Ӆ/e]DnJXo)Sȩ  2ĆҀk$$vu ̑8>_]u0Qj`e <ՙ"F hR1G,~ {㦿8\θԅq2 *fcFlH#8IqRDrMLa?٘YЎe3~6-mbAs %%h೴?ܑkF}h0^iw *~)SJms[F,TQm#Õ \/xoނҗF,`+l8@!̡*byGq*9j)1A l3(1 > 0 \F1A-dđ0DA5,(|'1yA01 . Ơ ֠    1-@d5x*H8 7LI ØD偒0@<&ID4]}C0t/Hy(_7@\2 9lE 7PE ڻ䃨MߜЊ b7@7p4 J5t\4lݴX9EA 4 1 &ZB.$C6C>$DB :!D=C>TC@26ÖԱ$B,C*141 O)C,(C59<lB4e5Q *2 4 dVfb~ _%``,4CE^"m/(i919hehh&ii&55~JFɊi_6C,*$x@ݔ;PA@|@, 8+\#l,)tBh/씆D=1D @ & T@3@X%B(P2 (@($ <BD>(FN(48 V$F<3 7/0My9x\%3@C+Ht @C'u@!*gjD孝9B7#07@8@$B+$21A0A,l TAT0/ 1C#@ DA,@&cVB*\@T8AT@-0Ѐ, *@C(*BeN8)HC0xC'@& xV(ƪ ֪e(` ab"9p,dDfQe*9Ch6tiV^k6f;Okkfmb2X@ *Mq \|@)@7< s$)%3$+D= 1'40A,7t9TB7 (A) ") D0H H!@)C,- V $m#/P$3'<@!\(DC:P9c)0A;xBBЀ*tBt0/B!C#dfDf4̤%.,A)#C t&7T@ B*@ ,̀Op-h: hB'( #XWi L3d j1)3p@70c!0Ch/$lB'LA7\ 4Ò*2`-VB`0dno0A( 0!f0QBUN8(q&7)a/gjշ ?檩l ^C: NA6T26@ @,<#x<@ <@(ɽA;TC3\ 2tH_x((Z!8/@|,lB5.T& @"t7 (i#L@$<~1qD/:!E$AtYb*( 3H% B"<@[ T|de2<3T((&1(Bp|).xCl")f &A3H3X@+30A;0+sޖB7ph p1BB4^9&4:11d/03,%Pq_q5$ D@gm0|* B5ܔD٪:@D$@!PA7CA;'G hA<1*+3tX,C{r/TG7 P(fAh%Xy{@ C/Z/A$0 ,B,B,4.s!10ةުf:w<7(4*w~o<aij?1-52HM=CB)H'A9py'@,L?+VI{ $;%2#x0*3!0C\9&p +$A<336TUW)uϤl<$CO2zb8@T$h. n:Dæ<' )+T[%x:Knj@l"F a+a 6fM7qԹgO?eQGY˙EjUЅ7:[ ZjKl[F7W6dwv;pGW\aÇ'V⹏!G-'k쨩P@(ĉLpBJ3$axAV苠 D%X RZ9 Uz1Lb1'J饚K"mlp,:h哂2]v f‚&(("0- bRƖjHd0jQemYVii%*beJ 4BK>{+Ȑ0d~'w&0~kL}M X4,kNKm`{mdэ7ӼqU4㪁GUud^9|Eh'ggf<.;F)^_dنehQevؑ?fj9Z~!^b!b`vd.Es!f.z[K:Xx \pvkhdBƛhplel1Yo9qh&h)v)%aڑŖRHiXdaa\iXbigRb^n/ed1zoڡbyYaFx`FX:?lR^z_pq^zHDE0@.ErrZK!㭭|+_ Β- C /I&< 5 qXt` g ӠF5~0&71M8k 5g8F6Ū x4q:.!Q.dG\/\ܑ_1HB]e-d9%F|t#!IIN%1IMn#yAҨQIiQ7"i (f4FRvKa/n\b#]g>#.]E2jA^(r|Ŵ,LՂ$-lNynS@bsF"I5@mZ- y4.e B`ei !C|吤%5IBZa f#AXƜԘ*AӕѰ;Kэ9EFw,HDgVe5&F :R܍Ua|*?YWrT.LsEZn1LT---Y> ml. )qB- 93gWqL6U#.PEԂYa[ْ5kZʥq 5B?4R.%!RaED7UL7T.at+U07]{_Η}߄cr=b]"wa2[/8$Q1-%-aAZbgg_%/["؇Zeo\`D(\ǘ#h_a3)j1~MpzI5 򕱜e-o]f1e6_T:Fn38*_Y,p|e ßj Fą6mZ7*-~,\T%E8q8u`vl@x6a `*^@ `tN b|hA"@J!   `"S)!:!ؼ?? t3CJ*)NuZZZ5[55D;PDEOCG``V`B`Rh`6:@:z(&f f!`PB,>$ Z!.@NQ6! ʀ|)46t2BjYѡ*2guvgyg}g6hvhMC ˑ-Maީ. t!a `_.`t` H h`lZ!aP l@ ^f `aDBQ"W]N6Rr@yea6$C3!Pc6s5ws9s=sA7twh48D<@ja ! `J V:L $5m_nyP P@ N` H,!q(7qL_62+*LNtw~~~7itCtÕikOuug! mQmM:!@4A!3aϢB zo!awA re (II|wq` 2!!B208x2Ow #83 <@ 8  "* HA#ޠ8! ,@ J;&c n_! ) T8Q@`! U`ajKPÐe22Ё " oc8UyYҔi7W\\:1Xb`h@V {g@ T!$A|Hf#F6~˸QFh3HU .`OD(QERJSTRQՃ"Hb&V>ȓO1~34lMb]!M Űdc@>6e&mUg|V]SiZlvsMGfffjVumw7C D{WA -d>y( 0%΄GmDR'^i&; L>JY(jT6GOS-V}. sLT*p lJpl,MSTLr #Hꓹ2h0tӘ꤇,vΐړ!iIIaڱCG1k)ht,&(xDlt: ߓ=g?KYbȏkZꊸl¤[8DHƄGG䁔hG5-Mc>F bI,`4vU(Տ\dcҵ?2L͠aW8(IKZx!';YP-h1 WZ%K t$ ci$#OAG!l?U^#--^PU9)ڇckAF;n&55utELge@'{dcD|]zb [2+x1^w*R::os=K,W_'Y'^l>, 9nǓuC?m"PB40 :'Nɩe'XhQ BXhv"F3r5;%Mu#2z2X$g :яwPmW "%Od3bВ\滹Ixժ)wLe.jv{e ߼k}o`1!D@5!9wk2! %/le p3F[!9L`ǎdЀV՞R[}~ZNh@-CZ͏1|.qkiaŨ5Ѡ.g"=dwwMY L C(= l9 2q_gNw fw[# 3d8&{, 059r-H@tZ۰q;cQ&w5Si9с*.~6,7 d3cDC2+S:5`,-yw @ S q@  ;{0 C``Zs='lĖC'CW|^ht|`  (Ls L  FF|~d&~`_ffx~ՀnҀ[ 0 9hׂ,9(=Q  j@c:a"?[2Q &JH::! FJ=" *s!hK=&!'2"#B~xt]A7|BllFH^6W c`(s&@ `c(vex붆onE ~p|@Y|w-48.:>@JaX1!pk h 2# i:d(C(>aIJb$}XE@86KfOEGG||x -6 pzN PذaabvBnuf5PIDPByf5'kWh 6`p&&%f;y+NrԐiQ-F0)qj,hQ5 2H+(#'d<,Y$ )HsJy0y5# 0njA%XH7}n Ֆ3[8 (eC &cWfhPg` j? 3p[TYPUpY2a\ @1>GH>Zb@ciI pEOI+a8J'a902>g@a :I3( K5 ]Pr椌y(Rf^p `[ т t"ouhz)@ @ Z @ vmX3P }pP0+!\(/h-Bxa5Z:2G5*7h9$G }-[ G= so W2Ӡa:cJ|xYk '`& @ A N pkG,g2f& @Hzn )gnn Olা:bHҪ_2 #P%-AUvʳ =rD>%"r4rqcJYq`* &1Zg3w1ePq & @ w 0} éP+wkd'4 vi'`~Q @DYE+RK{+S)SY ! 0x <ƒ Љ5!Ay,.=9$ZrQ! X5 yL :*B\ aF&=Z۝DǵI_&$-  } OI ʟ v_@p+o " 6  "7`Ȼ)++Ġ3a_@ JؠAneR˳;aGq2:2P к9#;)6!*6.ka\N!-ZN?j1 ʐ"[G̼0 qv`x.NnN7.0GBpf{P-U'$JJ4q ).ݮ]3BV N.d26B6x=(=PT>>J;h!#O2a-@" :+2騪-JV❮6 /#O%id旕TP#lXj1BMG(pa`)&^ aSIKMO/QOO/W_X?߳,<2C>+*^hq0@ZeAE"@ E$d&nӞ"oeuC0PnW7w0JL [ +p.ZoY/+Y/ǚ2oObnWww$nKKk_H"0Bx-ߔNӰ-ۑO& P_?/5CH)S`D,5l#^c/t4nO2FM4*^8~UԈΟt.Y\)/>}9 OA%ZhQmGx1SQN:ugΜ!C^>xGYiծe[OiS9"t!ÎN.]O\aU cȑǯb>ڽ{ZFGr2G9/<բt#2 2 ;+c0A4)hw;bpK6jxD$&QƸюv YL{֥y<%J}`FasU$mpG&0oH/;ӿG%0NSw XbFsюxdGS `,p$=(IV3|p<,`RRR% [  vP`KX#,/;U 4-sgSTgN)IKF;1b`E#|ZZrNPe8ҌxZC>XG;ϯ|3E\BgH߹,`\'8"-x `E78MHnsΞ#9[B;$sa]+^ 6p OKSBWP# :!Os~fŀ+ Z+lI/W][_K3.mx]釅e`!YWZYUZ}GA^<iF1ȠhQF%)["9Qp}&as.q %nc3@E- ZB.C w .rc5g;)b`xmHc [-0d9V-ǀ20.!AS0@iF+]lC3 _aMA|gX^p(XH0F5@_v03xnB6[@1Xx7/ xRXH@,MhH`6ȂW>J(;\x>$?,@Tv̠) PcĂJH-J(?:PԈP&TJ KpV,HXz],{ԁr}k&KKK4o%i@HƭƥRLop\;r,AAG|Y@KPM0HdDdd`'0$8XxrMpC wD2`؅jd`>82XX*`(J3d|Xxɞ)0E%kč ~H P-8P@0hh;d8 p{&0PhjP֨8 I 4@gዘ+pQQ"lxȉmn KkA$MR%MRq #H?8G`ThpJBpׄM4Hx.X n88(f8WX^(dh7H`M7e0,H|MxЂWPNQIk>LOLYDaOQ(Of ~o89Sɧ?pq@x~@e*Rph:; MVTP3LKQiM mhp&ry  WqרѨ` ML!]L$ GUC ֖XRz&%AJlZGf WH'0W(ӈ,dp'-QN\VMNLXNDx)R@GxA<[`WXWWB_HTTy#U(PS0STʙ9x96(;6cx_`N0d #̶0g$Jg[i& CNᔝ y 0Lpp 2r)/: cW2u QyzM]Eq|r̰š2R̻7D`Np%}2-$pvh$`R7Hp?X@3(^HPM(U`;<`& e 01eYDO])!؄3*(S:UKYS |@ HLD5783X؇P003~ # W:#vL`=r<\)\8|H\(iZy ΀ScuX< _Ʉufp P؈:AWP]5֣WsWW* )\H1Y^Ԝ[I[xr1B2[]EjmɁ6MZ[a@2SP7OY*=؃GqG\l`f!"`[KZ]ވװ(i9KԄ-BfWІjUdi ;F0k.k1@>knk~kk悴kk>.klNk&lNl>lnln봮lflFkͶlFk>mNm^mnmFaɞm&>mm^݆mln6ahʌhh2 iI?i2NdiI! $pKḛ0E8w` ˄Cp^ZҀy]c} ?pGNpoz͗Mtp op gp$p O pc /q?qOq_(pgЅiЈbaq/(v(mYC%nTd:$ĝ^%VVqO(⒡TonB7P<8Uf7Pdʆ0Pub%=q{m7Gs0h^~W8].B$%wV! G%Y%iNU|ep9Ђ0"&y\,teCu]?paW~cS>%y$tB+(|eR_,E(a.@u8^_`owywyW] zdE4herulvgWh)1!ݸD!!QU5 `HMt}wъ2BӀ#'?"O'vD҃_gݒv^xt"XWx bo; 8m)t8gpy|G/v8~Wt6P*)/|?|÷i>(|ȏ|^?OTilP"JaE7 H'ih"XSx38eAi;O}>JZ3?PmiPS>Gp0_o[@7b L0.~.(v60@O?x?x:pa V{&P`iJ0a-.\nUW[ /EYx )r$ɐN&+7lFåK <~@!Ǐ!D/Ѯؾ1زfUSe2[b',ݺvŇTA+x0xo 'ƎEgѰjhys]2~8>%M-0cxkپkc#+]/6C_}hxeZx !sG22(tD<Èyt /U2xؑ 2ؠt@!!brءZ8H&X@ ETWH)SPЃRAY]UW`Ev:hu`3xt}"H6‡2- 46JVoN5Kљ7͗bMoYxr25t J]xF?A6Q ?͉{7@7P~DQT"FK%J˒RJ%)tR[brHN'{QER?SQC;urh%N1J)#d4| j ,x0ď{xŚM:A/Hf2JP2mf 2v#!1Lq%Oх<^#f Ȉ"D*`Zη~=e ѨWwW= ۷B箨.S@TP[FoghË5)PJ!N2w7aL̘ʁY0wȲeR^:bF2^ʄ>se޻? =1Xl>_QM^;/TZH%rG!fez}i+F'X@A-{x.]-2x%^kdx@ .@xJ"O5 ),[z7w 랇Ttjc!אbHYagC(ؤtІ%n:ӁbQEh,˛A74 ?[[ AYH<8Dx`" ]0E/ ދ>B $p]Blbb1CeoPC(PЇ3D07Y pÑ S8R(:OX\4Nto1o{ GDCÐ\F%p`!,>^-H3xvxJd,46/'4l 3XAR?Y 8=q35ޢp bO1/| SPZc`OІ_X^xCQ ȗWDThQ4K8S+F1 # gԎcAuGmNA5!Wxi[6R xhYQryTp*'gO.+'>!ZåHA4(Q%1Ǝ,.c 1`W fH7hnR!tSn\5#q\bqs2T(D\6[4 gk,Aс,Yģ1i)?!xC^-Fך($&;܊R9a=8$tX Gui嫽cf $Ka!SYkѥ5ƫH #ѱpdАt8͜Tr0a H&TJ 3(D@X)Xaql뒲$TDAܚGvIG<xB J1;'WM2T-5eO|QZeٮ{cm j?'EɲNpF{Q +lUhؠ~&)~A,Cśp>x\kݺqjx"uӮ&8ڹX_׾ŷ,0e'J5is/v¹Zڍa%2 F_NsG> T#Bڡ0tB PE[:p5}둓[,;8aI().5]=ssK#;sU[C<Ij֘^&$ZYfFcN8kx%Q(dx,lP\@ Z=X^E 5G`A`Hs>Ҡh#: %V d-sO7|&S>C\+ ;P0@(7B+,.Ԃ7@BB_e-ǹ@Vх; z@ `BFZaFh(`2LBM`q9d#X@!x>4T7A+6HCC TAucx_ Y9;0CĀ& C(&(^)E"]bc!AZކἡ4d` Zh/C8A ,Bf4!#KĚC40  78C\Xnb75= R%x8Y8 > hVj>2dC,GTՙIBP^&C'X@<\ D0,"XB2x8%ؠCvF6jpW 8R9c:XpB&^7TR#c:cfE@A~Q<X(BVYo@$oO*^dbYCK*TC$PB0,4pe0B,X@Z.NdWd8T 9c6d8fhY78MA _Zfl6kP<xUiyl8Ă6ء8(&gd$e:Q\fPBcQzfhfR>U5\3(0)g&m{& &=zhC2g[>'CDM<>CjI/Յ7$Il6g7''aUtg'8fYHh`C?pӇB=N:/BO5$fk}7'25?dCuh)*D.\F>MʨXxe4dO~#$VE}@~鑦Y^b*>N)>dB801Ŝ~82C /  f*М:g*ԝDŨ>?hꃂ(#&e.lg}VJ~R`*rk"&;)t@)j5`6L>TAVMu]FC1b2pc,*/k k(-k6>+|Fk(U`lk,7A hBa+؀8 (?8A ,TA)$A܁L,8AD H4 0i/\B,BM5I:`Ci؆ h~r5 mmέY!H&O7:*gF*"Pj%E7l"D+$ H. C+8@*@lC&P.l;l'$ B+!8 X-ڞE,d$hƒV7.n}Z'C"\/I?C#d.%,'5P<ĝ9Cav ,&+@L;D6 ZoU)D"DPp p _$lNfeblf&V~oh/ZEn%X+,l7P BuV@$90*ԁ"tUn#ÛI%rODD.CC00qr ,Djo|j~ǂ;.CZ%dn+(\C<AB&@o$t9* B \CC8R${D%B`/`/ #s2+2!Gjf0#;r5MRvBP*؀(2L/4@B5h2 C,DKTSu%JkjNF753uXG`EQƒ|lW8(.aovp+6CO@q#wcW4fN+Fcg2r#owuGbI/ ܌u{7ae-j0tq'y2/|ju#O#w}}/]bsTw ߬74s,|G7pfw;Ix[?z_{@757XCx -Pcxxdn{?w&x3Yy x [/x;;/  xx879y_L1O锺8rړ`X3`LȎűJycy'o9{9uy+z9pV9z9A]Y7Yxbw7npckys:}/zjb]$S6$E`5ǘeS>F< +v"Ry]U9 yn`ȅZQg"MzK6{ӺWy{;ƮEהg`:F,{Ge(-1lWWC#OxùCxqZdCt'#| ƃ]$q6Y#p\Ri5CdqѦ;`\ik$_XER ƣPYzi;7;ýƻEz_|?`}ՠPы`8å$?L݀Cm5&J8`@O9S܋{A:?u˿}>E=sTC?$V !IZC>*2p`>g96g7 gjF2!?2x~;C[D 7[ic-.\nU׭[ YtfL3iִygN3턻 (tG!(&҈D"$Tډ|%|jHJ*z***U\]|eBsXBNNHe'bkp1C_f`5&(Ŝ PdG &Y:G}MxGmq)^؄SsAUB$`&8~X BhlgB 7~Y-L&b0,^Pǫ 1 ǚ]:RZi`by雠"(D ,ݖnpW-&G~wy'} QcUsBi qG +~Q3D<%Gf1B_T) UAjHPGjN($<U—lqśKq^yx@9dy5VfshבzIZ7~垛٦<_楥`>őE ?_|qODA;`p҉G#p@*g%qk"]eݯ m! >$#ml> wX@ -|ɣghX PEmB_FI,v: %O*rؤmB`_a$z$XSP7#&8EJ4h(`5A_05!~i(*v0L `b7aB9yCp"#2q` D'>8l7D!Ys眕*JeviTF7/@b Go &&a44(>  ƫ8v_lʠ"h;xFb'~,h9UBy+;;T ?qJ Qp>MB XtTs!(F p mxZ7H^$+DJ^ȋCL6NwB:hA/EE@G3+^.Y@b4ġ4c3F9* 3pS , R$G[YH*%, E?UkNGh mCx" @6Af)O{E О .AfA#ː5b׈!o|P!FIÈ +a'H|7\dd){x/^o8$< bDqY;a3X`A~ʯHPSF&4(Fz'aG;:p2xmo#8EJ NtLmA wx#aP52`YofDGk1;}bil!jV 5JӦ6[6ġJTբv[e+_Y<ۤpo (5ps@"|XQpI1iYٖ iTc_1E(,<6ъRѸXx +"|ՀGlp$tlr r|a *^ڡ hA|AlAc!a,uЅ\"22Aq`3!Aq3]A1W2 !rеP0 =R7w7{-*F,,VG%W%"&͢+j2,p'EB%a(2r, cg!r!2<#cr`$m3!9dlz̀N   `(VVנa<@,@1YDqD!2!>12A`A(a<L!D\ST+6%( g 7}IJ}S&u78!9_2Ks!-`KB$ô,ȴL]*+=ul%2D9P(> b`@_ T4aN JA{t ^A ,`j5CcC4N%L!|3a<BaNARA!RSCHHYk66t TXX7r%u%l94"֓MU=NETN!|d?!J! lXJA R* @:ϚA0Us!sހ^bSZVN*!j\hF$"6aDaba'n2a!ޤH{5b6XsVgwߐgs35=uMGZ>ߑa[eaOt3 ԕ؎ ꠎPH@4N@seE4b6`GpiaZ!*AB$ !Na">!e#oVoe_Sb f X/gOuSw~YMrQrZAN4V[mZJ̀ AUH8!\A!xAUwƗ| o=To37sg>P3gm7\#FAdO!(r7|ns4"r6[ **6Uu+؂/vXX]=kћDpvv?M73 8olA :`XA 4&`́ @!@^AW `+ daTk{ru|X;`[p8bG!|aqaA8vqa?!x!>!$/w|ew"faW덁!Mg1XmDʄփU=U p(8mo *(aN]a$A``aM .Ab;bxA|)ْ/olof|3궱D!\!B$AxoDGALaU$8֗9#u5AIB)*(yydW+?WZ9/d=af9bxavf40٘%x9SZ$r!Wg9w'RwF:%jAfpa|s$Zѹu⎕"tDj@&ګMIРC+aU:gv!P2f f|x|ooRr }}x#J$ ۰39j!\g$xj2;&[mfҩpos{#?z1C±!{`!b!a%Ws%; g#9kھ{-a!+YB=;[QێU[sZ6ªg[Yj{uҷ9H`N뛦kjkz!kb4[-[Ѳd%D&(e:bsC!!Gȇȋȏɓ\ɗɛɟʣ\ʧʫʯ˳\˷˧|O, Zl" ['4\Õ:X&-&\:UBk"}w"i\j|X;s\kZYha#]'+/3]7;?C]GKOSYں]!%tkazAt&xaf\څ\ׇ`A<(s*t♪!2#`R@؍ۻۿ]ǝ]ם޷@" z1 &zvד=&A"Bajم@'*>䵩aC^GKOS^W}Ձl~mmx^@o2UyA2q^꧞꫞Ѽ(=*~6BǫZ<(!9^},B2b@{d&p >&`a@&'_+/3_7UgBsB)4]`:2gic_gko>2, >9?XG5|[bH!*r%=`_>_ǟ_qހ |A"v!qO& (GIRLsGX`ZY5k̥.k&#%3x0Q2f:ЌfS\&kxlCt}itLHb1B .x#:):h" PJԢ)3Ć>O{7eJUDԦ9N.'JֲhR9#CBե:KUCr2FDy DCK`KikL[ymt~t,쪘#^z hت=Qk$QנegW.nwޖNeK)?{ml ( a Wַͮv M.V!T LyWw*V׺|K:m8iּz-9ѝȑs"g;կpJ\C75 4IbGwlVr)5 xvZɱwF+;[Q [N5Hˆ5I^R:LK cdBv.{`L2yvH6pL:xγ>O PgNFYϐ'MJ[x''d7FpG=F* n6d+L $03Ƹεw=.tl}p(b=X~f;ЎMj[ͮn{dG&0N U-ם%k2$T|@G~+X bG=sD?| ;uM) ܝn-k\v{\!n/,;&ƢX\(3\yn ;gv@Ї/5q7Uǧΐ%#CȐ-LN\擹_rӰGCpgȮO3='޸w˜>9qdpŃéK*6 6cЌ48IY#{71 g _كdwl>f=lL^;؈#ĝ3{S_lE[^?' ';9z#_D>-oѐ}6kU[`&tӐ3x3'{Gt!E%&w8;9ittu_}q@ Ȱ~Y7u)xx:xW#y$}AyyV/@$ {Ǡz`b谀{E@|p{}'|נ 0 {s| )M7[}G)'}E}0h wهw| 1Ep`U9~~Iw&q Ts g G7sHz р8/wǁn!huXGI)Xx@7 ް([q=6Dx  p p  İ}nvD@ r ʰp C p zɠP РP D 8y@7Lt p f~s $t H `ro P  =Sv" pr@16 &@ rQҰBQXE = g0 t pu@]` % ` 1ސ(Ր wIzp d ~0 O`P 0@]`zY y&1tc9) l程N7aDVaudn#I$Hgrgo&ސ@ QR L`7p[' @@1~( ` 0 @ (( @ pMՠJ$ r M$ p  Q 3 W $1 ` c 0  p  & EB:WEp vx3F T@=e I1@ #A@VA @ x j)     נD)  G YDP ĐH  ̐uZ D Ġ i&`P D:ZQ/ǀ-iEM6wpuڊ*w q j@1 J σ@ X@ p PȀ6Հk4W@1֐ Ր  i*tܠ :  pP X `t @= (MX @9 à Ù2 (9( #1|P |P IG[Fʪm6wqiIr'Xyi``l1{#@J@e 0 Ip T @ ˙ n P) l 4@ j I& &NPL`&K )` . \ * 0U N L`DY0 3`& L0 9Ȃ<Ȅ\Ȇ͐ ffm[sN(.' ` ( P`p 6 @1Aa: j0@ b @0) Ip'@P&kJ )0Q L ɐ &0 `UpJP`14 аQ@ `o `ڻmft[; e}g`Ɓ5ƾ$hj9 T# Đ < o |` @͊2 IPr0( i & 0ɰ L P4 `U k`Op  !`̀0p (pP N ! \n 1` Ipf 6`r | =]YK x0=I 5aqlՀ 0 Lҳ ! L@  Z p  @a˸0S  P 0 ` n y 0nn YpP}9 N  ֜0 Pݠx=p'p f ~uIڽH}X_P10]o Wt *,. 0dYrڜ5! `Ҁx'|` @ az0 < N?   M @  AP a @2 {l)x@ |ٙٯn!P ,PAQ0  6lN  Ǡ ~Z]K vo` vgݶps 0 ̩` jp kz M`,@`ZP P ~`# 0Y@ ``ښ#>W :Z@ N. } +n/ 6в3K(p `kP]pr?t_vxzq 1we g. YkcH(9 ΐ 6 & p U6 yP `𔚔ٰo=DK '  p nP 4 ދ A p }(: `xPL˙ u @ o 0 Չ*d׎"v,X(L| F,1=~RH%MDRJ(x XGٱo|:SJ)Y TJJaX<'oe͞Em5tt4jc*Z^RDtʋH&T7* HA̶zTqcf WT:fHXɂC$Ī]@ՃGИIU 6݂,mU_ 0\Uba6W U[ݽ^x͟G{fWc2r ?;r!@kႋ[|yB'B /0C 7C?B;` p,d9# ^F[!IB UIs,PJ_-΁BGpDjvʆp/-9a`@h AVBCv"&f&0%"醏4"Xb13(faD7pB#E;Np3pJ1Y</ qFaݰ HqdrrC  D*`! ZB&1e.uK^җf09Lb@&2q[-Lw1 mA Px8nvӛ' g (Bъ*w9O5wP y 4@ѨL@ E^XED`LKt{Ò dAp$,@ +D/7 YYC "(v3pHE@0CnP6a5X(D.La14aMVխok\9ņ>F8DaR.up= tp-P͒t[LpY 0j[&ʻ2Kù,"\Bl1!_dQZlaڭڮگfDPaUNY!pHٸ`QZZ^|{PčC-̾}Յy[mcF-}[[W[g[uFGt[7uׅؕ٥ڵ\pCkX0'5:SBņopZ6p8OZD@o[ht@TNRfR~hXneqEemP\]\^`a&b6cFdVeff^d4HCSmHk.[rg@P>@EH}gD&hMiM6mN悶P >~6iVfio^dfcjnhk&Bơ*\މm&Vi6:礆ꨖjy>KhV|:'Ȋf6FVkvnԵ븆k4ji=貖&6fjnkfhV&5EX>~޳DpFXD86FVf6Dؖ٦ڶ&6nvm>fv^E`GDo@ɦcl=> p@phfY'7ocFgw pNekX7nff>oNcCpgwopph>Viq.G^)*+,-e >#5#$'%7&(sU:;r=>0qVsk67wrHIJKL=sC_D^o7G'f[NtHbteZ[\]oNj k3/7oRi6SU VV~XepTel,GVmpt_?tP/"?vdheXfYez燺Mjey:tqr:7*'w0OtGs#gkvwFxfyzgYWewTqOqGgߏ v2GJblތv7uVF_8Ox| d@w0 _otumHZ&xgoXxao7OefyLJ( yHeYC@xXo0pO0yWzo4'TO{wzz,'Y`5qPeX>mo1[rƷ}GPoޯzwsoG:ggt[`~(MU^`NЃ_{?xtQ0w~`~!?Dɯl7E~xtU*Tj,@U7yS0G,i$ʔ*Wl%̘2gҬi&Κs'P+jQE2m*EߦR*VSY g'ذ`kqrW[bjv-ܸrҭk.޼z+Npߜ!k-[3dG1dȎW\u5G L'q ѴI06ܺwϧQ3ٷVjEk\f}Ǔ/o<` #Vqȓ+KhHyO  MjUJ#>FsZx!/!y!q8"%x")nhP<8#5x#9긣 ڈ8x#?GF>EEXA@;h:\ve;\jNZkS `t!'uv5yԌc%qF? ,DB)cJE/'M6Έ?2.ZgOC 8CT6TIw4TŕWriw wq}y{,ҕ`b'Y&}?c$@?aP!\!!{$. <02S8AY*8K6ߵe[ҊS s :<TEE8ἥ~O#:>1z~8#;=<=$3C:.31[+2,{ G>8Б:o:ro3o6(CFf(} L$ͨT`2(M%F@) +GSlu:* a 6 D >cG y?b02\ ,]BEI"1f4x౱82lօ/{v#; `ZǙ)H2 @_;&6-C晕  c0M^ PǘʑHHH[+RfHCP*WFCI5F) /$On6;鱬e; oU/ pn܊5M|,dq"·:#&)ZA JhTJMρmd@Pu-nsoJ"k %:" EpF71 ׈gzPi_i&4ɺ)]%UEH!U ,`f9$ q0)찄:rSPӚ"d`F6aK-4[}k^]s; c#n9Yli$ފA1il3Z@ 8n::xN~29d(iL/Ges:vF3f>3-gd q9˹tL~ęJ3-A FLӔ*DQ<&udZPcڬjM*i#=uW2Hdi_ɕ\5uC~ߠp: >`GJcF6$GHLa~qm`񭬑X&6Yu<,9g[o,1 _+qSd 2JK9#Q`QC2;&f[x$g\p~S&&9c˽#D֢mG/{۽-^m_1HjKHӨIԧVCF֥S8#Lz~G;K34fD"v$(LQ:DHGto6b˽-f7w3q?Dg"DKըhBMɒ% 3P9̩J! }HCOwXc=/|#h>>Qx 2٠>">gr~sC g?_#*c9SZ &FٞMmx%j426\CJߐ lҥ쓣~D HĢԤ"m @̈+>(DXA^5m)[JLMbuE"?D ɄH _򝤙M36LL$MΤM$Hp%D &eE"ALa :5Let (5tduE 2<ͩECY2LZi"*b6]|A̸̤9.fIbtU !xe&^?YK@_@X@0H)XOX7PdEMFFq$\1aRٜtpWi 4@Hr.FP4dQ}lQ ;IH%ˌ q:CC1eȌDX=,Y$uť|IݜX'%Ax9pм ɔ^I4?g` b&b.fccJfce^&Xf:edfy@LΨC'@,8dI<稩 mhMtT]hXLKjd}eR t<< X!HĨ@**z*ެª4H<j Gt,M6hOf lg֔H6>+5;DTyzkok$@:>A EI(F-.Mh}m(FZyN0Z+ţD r,ZHg6F侔nMl:jcb=솦EjJ>l< (2IllJU";DC1Dj"pH*1->/FMV,phmp-cBIR/I7@Cάyc r5i"k܉xFٌɐ֜t."0袔.j,nS]JV.Rn0hk}nZh=ep`bd1԰ p  `Cgn 0T>(fkI4.̯%>n^Q݂+ڌ<>bmȑbɳT`VnO`EH&RJL`E5rڇkTC-* (:S%^aC87LDZG~.WD-6+F/hIr0up017pH2,  1șB*$A tŭ@ITQKgDZp8Jp)CʃtOðn0Hgq|/qT58qɐmA;Ûس`$u-vmQ}W3CK2!mFIL4.tAE=rV 3p1?u! K  @VS_3Do; ZZw D4PNtjQUa4x~lQ$aRZ\v>_dk+3Jh.t4q`mHkaĴƼ8_0xK804C7nId5nIO4h I6`7LmH?yΎXlvgH] jr.xDxRW=s65A{106 43;s #@A )8@ÉUD[kr,mu^{^?>DtW^]4ULCZka6)g؈Fn2 V1Q3 DI;xDC): 1I̯5+;\ ś3 9ßs zfm`X; `rf|= |b[+25{,/^zJw62U?@&D:)G6)4 3@A)BGЏk'|B(ϽA''(x:|'''|B3>};~({BdB&xB'1<TB(~`(Ԝ>B3&4>Ϟ{B>~&{>GH>o'~o~>(D>((' Ji??(X:dgB*!1 5ǃϿ=@X`p@I`A2X`…?Q]V~ʷ%>,l<ٽ&.4Iڢ%$M[I BOڰ9dvP}~:=-P֟~-;ˇ6׆\!neJ)ܴ)SOEn ˷O8͚vPܽ&̙AGL[""?2I GZ 1P8pEE .nGEYQiqQy%o&f!&#~AB R0CGAg$q,S}1$flxIG0äo î"A O&1OAP %?]I(F!mLv 0‡{e(k/Rơx) i(C,wtPxޙ wK`|g['c֓w X[ibA6k{tҟ ,cO3ﻃl".:>jI> ~Ihlm F g/~)J@i}$1v8mv8,fԡH#4 G>P ddIOh œK*'&,懴VDG$Zixֽ0Ʉ~ jaN -RCg4Ee|^ ,Aƈ)a8!GhBK.L1)Lbl`QDqm"NF" I@C8C\ЂO$m$  0PJ\#p97Mߍxk,b7~Or6lS{q@aKX.!L=fW Nt]2B^:Bұ(IfPc}e3kYe`6 _B(_dNMVdj q e(ëm0+VEjhȥd'Fa'nV> ϰH+h@$/5poG>HhE*QPͷk@J \J aXhc0NBD `捦!܏(@.O@g8p OONhŮS ,aA4 8 BaS!jlB2i'2)VD) MQѦoyiޢ D-iǩʜH~L` H uz ~8N ; L0LbEX8 Ҍ.1!At.vԐ)1pΤ!QT  !~!ap׶62 d A$IdAAg%NA%tL6Krr$pr*ڱIڈ(2)r))q WckzbE$r+y3~!   Kj\ +}: `(5  P1pa` o.D^n$pe!(]OM)# ڄh !0.  1NX*^$!0PBY|΄!rM$ Kĸf&!Fr&τ'*4JzR~2(r(r< )<3=} 370*2_*Kz>FpIA葔AK-묊 2&aA(3OtO=a!C*gL>5Qs!?  R Nf\BۀIB!ҁ0+!VcU^)D-.hFoE} Nm$dFk (GEOY9 eRsS@.Ӛt[[5gs KcH!vBt2RS1IHN*0!0B` `#OUP_+> 5UQ%v+s?Rn &E, 41V ԘL5ЈVڀ&)0X(60Ϟ4ivna!j6j6j3,mEkbAl/ V-Vr1􁼺tPvH欂 K0Fdbw6q!7rLaCPsb97uxI`_ldIVLVI1 @\T#TB&TfVkaxvDqhh5PƔvzՈim*J.ЌHѪ{bEЁ. !%W fTƠL(֋f(V.qeΐ.Ar(a`q>ũs1+vI jtQWwd!.B!\RFwQUrѩ<4tvWWzոLjg8 ֋_h鬘!L18 |J1R8Rnx<dю! ʁe( QdH L,( 7a(`%y).ؼ 3ȟ,_A jj7-$1%>xti8i)kZ X+.gSZ:լ[~ ;٨ 6g);2$P"U!D\tގ">L-?|Rv$ aOw-҂w>(Ek602`3:N15WZOA!HacO!C"=b(â,?k-WnJ(wBIdFBWb-dQfiuiF[^~ fbinI?Br0ޓUuOO$8yģ0)1{ C y5>d䣏@ic;Zs/t8<:G l'dH(ydi_jyo~d3F~e \ig{첷68s/G DpVR2<m5;rBH#wafaAJ62/픧 U -9N3oT޶? Pc` 8 ;r3ѶpH+ `SMO(1pzrD8Cԕp~+s 3Ӓf(JaP(B C Z-1on0P` $X<>YC,đN|P@N !NDq %-oD pH`=InExJ/!AL08J@BdIR6d(|  9&3&ˡ2"NG%b aQ phF6rg2 _jGA-X8˻F~/P ~o~! b jtͨ?`хtHMR  Q?R Ә40iMOӛ@L ԠDQsQEES UJ(jPTW"TuEJZuTZʿ~(L+\7 ꕮE{ut*IM=Ys[$Ⱥn>Ql8ə_H7$^GЩ-.">!RC1 |pʗA bE;"wm.s+JwԭuA ͮw v7-oxw.E+7f}w/v- * ^0}]>׹+ 7;\ᆡ=,CX#"QݦIcxvF6 AX;M 'qw@;8R-^w(hB00YYP\Ό4,c^߬6C[bgMlg @3ȐFu(GNnC"ȷ`DS7O~H(Hyլsg:^fTqcSq33=ߘ7&@'8D6m _y8L*"1=Q#lC:}7-":4 }Y_QPm ?Βo}!֑(y{GPNpoq< \$Yuh&6X}!4{H0 б~u)b-C,87CG "ͭj'ij#q (ёqq%"Nҡm'+<칾̘GW Olh#(Ol x ~i0OPՠ/\5=A0!7͠/s?jc v}'$'~2ryG y9'8a( тBP42 `.kHג *Ƞ+(44.! C!~p  ! 7 S7zs ow$lB!T ,3"K}Ryfx@'3l5b7h@?m; Ƅ{1 {7`= |{ MI`>P -xW @ @ d 뒰Qx0ezз j  @=Ƨ} + r0 nrY38xysϞD*Ջ /jqV 3zL8Ȑ MΟǁ nҟX%_:~r^l۶lS W)pu;p7 V0`tqZ\u-̏5ogСE&]iԞҋ 3Ȕ1=t ؂;PC$sJҺvz.Ea,(w$ҞckHhĄ̃)xЋ!KoiɈ.SP) !JpB Z*n0&:l.,5[tEcZ{-j-z-CǸ ,X_8 R; ɪʥ3˔Ҥk="ȟ|J4*3SL>CY!8$ˇ8Ё“C<S1N20tFPCuTR;`sF6l7zU߀so$s op`%)bKD(6Y PZ 3z| wMI&g^'kr#SиmA-j_,%R,-1S6URVxa?;5U[1YHt=.9zxq IFd{Wi]Yg!mvBoeq˕}fR]ߡo7J*T^W0E$4M{lA}Usti ~<&ŝs>6ojJnv~%P(|r+OF`5aO}tI;[UVu|GY}Wǝn.(h.2rOH2<ęU! qq|xj\ќs K|OXu[w\(9|l >? Q'2A E DɺġiH-xaDѥ"Ѕ|#$̗6bØ`4J20A r# 8! ,PO=IDNҠ`xE,RK :8y/+a(nm%'HG<ࡐ|hCPE@RLtqTC6rqP$#Id=fh0ѡ-"qZ1(ڎWmtn%Y6%&}&z,|@HBJ ,XSOUO X wb`[?)2.VX s` 8h &$0A b`,k5 oPAI17\@we+8WV,acX"|"dlw`" ,,QiV}d=;`);)|q T!a8+^t98G<#~$_|F f:@@$o W\wWP90Xd "_@ }@$P@ ` ՀGh5ă&p3z0˅dhEUuٌjl==tjl9ǐ@*~*>s|Rhi7M#`2Gd`LU8! s"x&L A"4CXE"OzN4='FBZ;D3| JW^YFThMs4(f.4P;` p  0P bRP*]hj@,K+l`BhS# LH+ *i8 l’xiWqH8.<~Xa\hb~w88g*\QLg(`vcO(-& PFD2|+~\р*>8*1;V4.]m!ڶdx!u'w Wo ̀ yc$_Gz} N|hhk Z%w/Lf~L~ה1^2]EA@v3Bx0ҫk:53x7(t@H{%s8@ޫx (x58Y>q{R(m҄t8+v;k4 ?'J<(43B.8Uv @<)hꂇapB<$VZꮖڹ[fCR8+hx o:)t:|:x\2&_`kʈmXXGcBYd$|b4G{B]fbBBˆYLFj"ohPh m$}k*th4p@}@y#0lXFv)lpm l#x}q0 dTF\94KS]YR8;ƈLI t0}-x \qȆua}4!JxH\JESB\lB8 IKI ((dJAƜ| ~ɒ˱K>H&HKb\8K®$4<"KX'b lŜ~ˊE#р(,,\ILOLjBܰ!0OPMsOH\PF 4YܴDL$P P뻩PX2ȇoy@ (|#x%Ob8^F8!, =R$ЇubE%sbm%RрͅTNII*PЇ3$S9 1A)nR0@,ԅ80= 1mOK<ӽPRN<9TPu&SphEx~@hBuEGE-PQ2QJM ]L M,TP}VhfPTP[%]}eh̄#l`;+})qxiHTkHc0Uhy[bc F6ObOchmX "HL@ለNJ}yr!"aHnMՇ4t8͡ cBF`T2IXRe-DɇYĸ |k#lxk|hM~ll@QYE`Gqw$BkǦe`ژp@HJlZ 8=S!NfӠ-\S@W'`g0 8"i``k4 P0`V0(B  d$jBE\U w]px@i2~e2X pxX&t&X^۹H[ؿ\HV7J=\_FI$/  c>_X*0wGEj`X pR)0l (sXPXZ'_@cփw2(h:b@oЂ`@*p,`lȆM}N`Q֛} 5_5^c߭uGP$k"Y}$dhbjz*؄xiNXvHR8sxF8,0ÁXjp|00M~H^I^-XI8gnPb_!u ;(ewȃ .[(5PuUPւ*M 0jY_i[fk_+慵n^jx 3llơ_( X>K`*h*{R ಙH|xL><(7pncHR~*E‡`iiiH}w0XP*8kl=Pv8XP0s5XXXiH38 f.cƒ\kjmp Uт$aPl@0}؛15XbZjNx> nP; H tv:PakqKժp[jHp8dNЄ,h㖍_`_pTlieU N~qTp0o0h-v%~X؇h jo(kmxZ|xSv8=Pozl| lm|؈֮dȆhmX %xh`opSpVhrhRV28_we_s;J04cLtO_xQv9ԚMȂ=w*PhԮ' W@0Ux / wЂN]Xp@)x6u8Hag >S0HK‡ `XS.o` k x.mhvTڞNex',ɪQl@q/E BwH*Z}É `FyǙ\与S7Y&IUo|}9jƌx6~l{֑Y̬m{ưW! wVïhE|P|yR K*p89Ȉp)*=]oPɈwMem>}Æ X!:kʨ1c-.\nɍ&OLr%˖._Œ)sL^* 2g>);2ǐ@z RǏ0BuVbͪu+׮^ +v,ٲfϢMv-۶n+w.ݺ\E 8mۗ/_x鴽{.^Xӆqt/O2dDB%NVbʎC,Is6ڶoΝfJ:ytT(QH{(iRR.}:֯cϮ};y`q}ӧ/6q_̯ڰF(toQSdF(Htn 2ؠnJOA QI-\<ם#X'+bUXU<#8ɓu}A?c(_UXiI kzd`l BXWbi'Q܅ix\rL9a,k٦o"hA^t?_?۟??/ H0\:0+H Z0c;0"! Kh0)t!5)qnW.ս{^֡ QhE/J\"OoDD/ ǰ^j/B'ِ6)L ~(r#h;1z#?2cN]i\$#GB2$%+iKb2$';O&hF35drO3VpWR b$a"m_3&1iL`O%3gB3Ҝ&5oT07Jrq",)Y~ceF4q< /ac3'??2(Ai̓"4 ](CiL,e3oS##9;Z%tڈ6 xӍp(C җ42)Mkjӛ4:)O{ӟz'Qjԣ"5(%qTFǩy4)-A#!bD:4j]+[ۺ?5r+]o N88qьrĪ5ܞV [1\'X:Vz()+kb6,g;ς6-iKkӢ6]-k[6-mkkvӰH< P(8-^հʽ :}RFm8nNz;T*w7/ykޢJ 4"ʐaMuR[.}X8WӸ)N]`8 ^0C80+l c80;8"1Kl8*^1'l&H͠]|GC7.A5Qx KP2:c_ / cXl"l+c9Z2P`XQ ^D7j^3 CNiS,|];;qp3E͊^4ݞDU$m8];O:Ԋl)U8g7M.[t Ox [<;σ>=Koӣ>Ú#" Z` x xzC?"Cf&1 {{9(#mx6<) .??ߟ4c{UH66]=qֹ@:PR`Zb?ð4rW2.5_ ` BE8X8ƑrE2 eH:BaJ!EiV ! !& @MaaLvnGua!*!Q ab >4 fU~! J L%!&"v# >"ˑay&/朗U,,b--Oҡ얜`Ušb9"_!yC**:c )am"w=q3jcE&q!+#a$W[ӈ;c<>!:)}_jS3nc?}&!8 c9z9xñ]?J 5C6vW/cD0\GzGdHHdIIdJJdKKdL~$*d/U'fA"$)$)Cf!QAR*R2eS:SBeTJTReUZUbeVjVreWzWB( xi#,e[[e\\e]]e^^e__f` f\2&47dqd(4c):~$`Ž[.rfgzgfhʢ#d5#x&Ifkkfl"CTB& M&59vIi''*'2)|O64CdF G|. i8H1I<4H}C:H jbXUX3/ثO(ԖTت7TCBQ3BZFSCL i,߅ j6<Vf6^C_F4eîƒb>,t5DѲZ4 C5)1kE44ٸ~JF0E*7I3!ێ";T5"NN:7mҕ22Ģ5m< C:X1H;T֑N-Xz^5Ьl:E>V:)1-^CV;/6(C5//CW)C<-G"5xf-:VC:jo{Cmʐ)]ML .:g4L5x7*,*Fz2\댽>PBH2S4 2B7D8 {ض뺰;x)B<(04;DW/4j .*O84ǥ_(<0+r,,d#y5p/b;i2x4Z9/17LB,T]C3ΑA 4#s""C3BB,A|@9+&:GC< KC+2m8oaj9* lڶS,B5GqOPB)0+Cx73C"1tC# 9d B3B\C[#KSC+C7//,8k^)C0h#H$T%B;-Y4lCzK| 5HT]|e58@CT@(2@@,(1 "D<[DeA*$,k60(*dl4hB5B A1$+| 0C@)L=_&L@$ 8A)CpA /D4b>E@5Vٯn>xP$V TW,p  :(ke'0#a(eʂ;[=E;ڴf[lXcɖ5{mZkٶu{7sys׭vW4kN.ŋ-Ʒ(3|sf͛9wthѣGl'\oٚ!s Y4#<Զ Ǐ!CtpjQA0jҰaᒙʼ2 S.Lc"$YE8xz|fě^Ф >P%(% 7ƨf%HVJe~1xsDڤwJ(^VXY@ )fCQ<0*k(<8e_i`<^~%bJSM5ƚR/ ;,1Le\~e\L 5Xs 6hv7yH_M?P FA,_X17_~yGMkNO hb.iŁ>z%Fbs$ b>i8%2Ãs5 'TdEHن:676&-"acd?,fx')Jg*Ii&˦T襟ziƩ4|<:AofRǟhbRA_‚ Yu7ꤌ;-=j @nQ؄*! hT.%( ":Њ5| 8ܰMW(ŨP_(ZR&T#%^ѷj0C!Ѝ ZsT1 p -VFibiTF7+xXS ,+KO &3'd*S3CTen5l4fNp±v D,ld# `Pj'HZGXc~(2Qc4#@_F ebC;P0M 0AA Lb`tUtEbJ+j״|@a l<8At"I!+a'3cD_p+L3E PAb"ĐgI9!HIZRCo4Q.5Hj2l8#G0/v@D H@!~V8 JTH?1LN~#Nד9N ;pP Njъ6a;ܰ`Ua [ f 4g#&VtYPbf!.x>bLb\TH 3@ 8UMǸ-r\AbR]S@G_4`cp82@1\Y!\>ie3I$6kCwy k\C,q(@2܂;SbCx$񎛲jcSn02*XCo֜D2nNE kX\ O_s딃 |"BxD9Y#։^uPT!!,l  FTQ=.픩\9m`*e|߈3*0V%A3@dC )p@&$wT x/cտ(P  ED&LײAGͪ(:XZ;Mx, 6ax( beHP,B<+ PM4f |ɐ(_moI GcLA&>ddٲt-SH&5s,{H%,_ 7"J$,hE'1SHzFb VߐCFQOe%@tDY P6X` 8X`o(D7ldyx@A,da8@ Ò)!hb6t:QEf` 3x`hE&|1 #Gd}܁ _x>Kg^Sд/f5<RyXcB p^}@+X8@+Noh)ݵbGfHA`5+ 3PkqXd"LX^돶1 jBkhC‚NXh+h B(э$|D/4n}(1 bp" h #P'+/]yn~k//-ޖ[4̺gf J! Plr `<' K,"~(!j@hjA@, L[0 h@6 /lo D L΁ @ RN8"!L` N@Rl lN SQW[_qXd B,4!zZDa)THڡ$ H` J!Bnк: "FdBȃ ,< J8m(rX^ 7r-A a " JKx!P `؀%`%_&cahD ee^(R1g&o3hlla|9A8&8f0lSyraj rDgVdyv!laxi/$xavLCxtA/alavfaA`IxAd$S2pJjrkk7sS7w7{78S88S7ePk':!!:35!A5z)AARmfta*z!hA0YKhlAra%np!dzhlanA3#$s?{A"faF44iaXS3wa%stLT3]0g5sTYHYS8eHH_6o2Kv0͸2M((K )C)+lpRt<ޡ5Ἦ/ֲ9a|̆Má!T1sBc2$Qm!>!1gTCm!@sa>R2KQ,S sPwAaB?Cs4 jSua1QKV55H49onW{WXUXXXYqu>M6%903:]CZ_5,A9A\33lF1:UuauD}AD5 CJ4BwBq!0tBu`CiFk1q.YBi!nF0d5-zTdeSVeWe[eqUI'dN0(-KwgefKKi0R,-'M!N9AN[/ra1e?t5cuQ3^]x6Dl%SQM1{5P`a?Actx`]G?CT]1;UHe{r#3R2-ZUZu[ s̕k!Nx!]1UTFiTTsSS_!drW2TSavbwa]UlvD;F#Bl  Tb|l3sFi7nud1KvX%}w16Վ`Sj' t~{gs!hrhôhcAd&+:6jUtc8&kaklqaye!mm׶1mWn-ndwV!S LUcK5GUl]5VYqY~8}o2|sAs7O)\utMttcu\`W2Wqw12ea{uwvqsW1wa7yB'yizi6BlDP{glmvyy1|UY}ܷ'o(K13(wK7*toX58=/hcXWVSV2;5uYU0nWVJyb}!kAW[w el3J/C;C52f`3`qUeY6sJK7gU8Y?yhT=TYsS/t!|anfiyYwmTsUSZߖ9!L':4n"C2n1y3se23a92x9/CeFڪZګZǺsaja7'ْUZkFu=L*Yra ۰[۱#['+۲/3[7mGk/0\W[Yc[gk۶os[w{۷ssa$A%fzJWg皹:z))AyLI[![Ǜۼ[כ۽[盾 aۿ*d*\#\'+/3\7;<9yW3K[Cos\w{S<ȏɓ\ɗ{~M1tYK_K6Ƈ麛\ǜ\לͧɑ;ʕ۟Agܺm] ͥ4QU#]]qfa\-iƫ[m<;?C]G]ٸ%ե\f s]w{؃]؇؋؏ٓ]ٟٗٛڣ]ڧګگ۳=M[yrXS˝1c3}S˴]]ciUY=="~!*/3^7;?C^GKOS^W[_c^gkom~ģg>~50^꧞^뷞^Ǟ^מ^Ё~^\Չ^ҍ^h :#_'+/3_^:c_]\ ?=?~_c_gkos;?#^>KO1]u_۞?܃>ɝ>_ן>}+Iq ?**#8mtH͏88i?Ӯñl2@~CnXdvp. SbaNצҊ)2J*2w%,lM'57t=pGWt8K3BD8J[ j%eUgж"*?SM>Ƞ94A-'u-Ω>G/W=s4KrIN1_:뷏FmcO%\nB!~1BzRX:0#K|&5gaz?r!@yx(B02r?GC#z[=|/9(@0HDbD|拢Hm%ˌ)Pl c#-vĨEt# P|?8B.1,Q5VLLV"gs$' hDc|h&7Nz4"1L%*W >HFOk\#LJЂԠU3|@2ԯ D%J6HD3jэc$;Ac%}=T-UQ8AJ9pj ā (c+gNˆ5K7GSH_z$Ytok ;DHcZ b tPp hE+QHsrQԧ>] =ѐpD~vc y'r:c K& ,1qD_;YΩOd@~{V ?N' ncOI~'bI|$21O{|V5?ϗ>Zq OB"(<Z+%zL|??m&}cگ.BPBc- Q  0 ~^@`0m]YcQU0p!ՁX> I 0 p 0 ذXvx v٧ @nwt> Ń8 :xwOvQhH~@pGXLXgyV_ ~'nV xvwwրgy@1vA~Pzkz{8v؀ C >y#p Ec@ p wSjuLgGw牀q*7MUM]TU_]34'Uf7]wQe0}q<V@ @ tKteGu\)tt*`'z،؈vxm'u svwwyt|wwv AxFXzxy'yPu@{AzpG ܧ}4 ~i~ Iw7wGwGhߠ i tw44B 0wGq9); =iGЇ "ÁR'( !]m]PJXXXɕr7 0 7 } w$Pw |D tpmYOЏ~ t iWx~vW? m}dؑ0)XZw~*ƅ'隠bGuj*f~WZ׆}7uxOրtHׇqu~pZpt F0xp "x}wθ '+/`rP,6sss @Bn&$lE#@1Qg!/0 S :vf_cehD92šűG=г@JWEVd= Ud9j/p~&3DP=EI]:IUrҀ__enYprʀ I!J dɠI 1j.ɡ O|z u΀& Ұo * ~Jl ZǪoFգZ~Zk*qV@lL+aLq̵oi2im@ @ ᐣR=-ʢI,dd eWBsh z  a_ 3j/1h/z&:O p%a aq G&!.PRӲQR"0Qm@?mP֚JMԳ pJ5/VF{Hp'<#k.VCOllгkbj3ECYbXkej{kl+=]=q;n'uK6254pIP XSqGN:vd'r9U(s]Qs"sՠ* wo# +P VCg Ǵ p 1)$k8[Pm?hC;Ջn 姝R;[SIK*h{-R;Kc;֭7\C/6=K=[k,ֶ#p 9C DRȡ ;qGr7%>yڱUz֕0ǹ6\  zsȋe j'fQ֠q@tk_Dr{p-г .;R,>jr̽ـ7T("'lLk 'T/PsȈȻs0 Yِp ǰAC*<>Zh/+rMz9á[\!ľdP #t AE`dt171 =hjJi* M3)#¿ѾLv\OM+ã ͬ</<[p8ӡ9!˰v!"߃ :b@ P ɀh 5T| @usS8K=W(lS e}Ѥ նڬڮ XD>0֠Kt۸i.dI&&+#&B=AƼ9+;5[2a8Q5Z*Y PzCȋ4˯c ergj!:q=`kP {t P ٭(2` q`  ՄK5kP{C 5% XPO]DրmA>@^vJXSPoE9#Z 3u2Couנ }jC.} םбim :ݥC#` EC:5;Aͬ0mf@>A;iF=Pp <.ؾH.OwO<   ck?ֻ֫ ۀ뀾_p*7u92$=6<$A*se>`NZd_ټ/N֠ v!7;O7@=-@ދ P @ hdaP_䂢[ L۪ Q0` P?ӀQr/rIzڧ ҰcOc - .RʈȿP > >CS.gBd?s1_۠qmqAEC`4zD\! RͥԱ:24%D"B`0HHB@ E?G; ~wp|vpnP mR /S4owCv>ڴaW̚`0\UTUl#:eȐQ,XW͞EV5Ȑqdwݶ6]x⣜w]#l~=gX_>ƍ?vO`>y!fΛthѢխ;NֵS:ٱi6mXp>iCr |^>xդF[6q3h۷j͟uoxLpvr.|#@D0AdA0yAX&i܊h x3 R `ƙc$zB1hl@:0 D'-G gx)h)8ĉ;KF $kXjI&H(9ynN;uJjO? OEtlq JCz)oZQQG%TUUW_UuQul}:4_K/g|ʲ }l~;N,*k{q&)'9FMo{/>/%_8`@ 1ԐCbBqc(4ie|ƕB ~ɚw&e)TI' 0d)Ș'KA)-A)օ:*j-)ePh(fxȫlva1H#;pg2JrȼԴEJjfafyqƝA9+ldasf9<8.Ҡqȁ=ve7 *+;mY)wj]xF>3^O@{? <8 =\xx X!4\ y 9Yށ < ]fh9̆ap2~bDm?ңp&8DM94,OSK UȨ,;h$dld 64C"^d( r"fp'8QZW$[us^r/rpt6ըÍ`:Z׺1v]wpWC? 0fl;`C4y޼g/\O_ _&5INh|*_!!}B QP4cїH&y#4\ r ",RmIvڰcx n(/`s9 _!6ٲx /2r.zӞPC2~!B"TmeGq Q߈RuE AȹrX8!J$@ c2ё9(F\TRƥ cLL01 u)̍ѧ;p"ҠoJ js׻ )zU޾:Uv_$P(!R B++۳?Y򃖶ԇ4$%@Tphʅd?xc(0 7Mvֳ[ɏs~,xw|cglx蓟K?=#FȀ;ლ* hG2&P\`.:iK@Ҭ*ix˛+3Eҋ4%)m[||@M/p 6Y쟠oLUU-zy0*C ņP?"!Wf+B|{ff]5CLD$,5IӲ8Q*hĀCf<Hs҈F0ҔG25z[%^[ O5n:hH8u n?zT^jl*wlB[jࢆa[&N nZ0D7>Ne &6f\Xh^{ꭌxS^9F:"pP->dX.&1}?3I)Wt#$ezjʥjc6d(&iq fNRGc9[amn;ۼP_oj72ݴdl()&~pck8HyH,X7#;#;L»4A~ѻ\;iR"sw;ٶ,*PjP4hhȭkJ *=' 13si#4>;>Hw(3 ,?0`vxiBA蟳H:/{͉ " 1{Nv((* :)-bi@9a)rްٳ:@kQ 66+K:edFI0kUh6ij j Xp0BBa|Ȏ4IhxHr*D ~\txp0(,~8f' 9S092CH, (R5,i) /ɘ/P/`hk`S4+ ~`˜<5K+p3F.,7 k.?`@`@aC;elƴTKO 1 Ɔ9AXAZ}<@1ŠڛƃZ-!Xcx\p`a0:ć򎈴(\B3@ k*e`o+BiQqCASIKd11>NlbJAJ{{xPJSyJEoi$).=Y  ǰlbD˵$f|FۃG@#bpit,LAa k9bJ^C'hjȌpI!c8* q ?ѫ` #!\}@# |<ȧHr=gr {kPɸ "00`> -S'5Nv3?8J hpf.ȫO(O/2TBQ|P TOKc,=ˬ"Ի;P66 Rh"m1ЧɈ: QRwpLS=+:Ƭц_(Ôf,'#bOZO}''7 thkD ɒ,C4}zH8Ō;ČMD(6]voj>M ĨAMBՊCmD Ig I}y!KNYԷ|6AM>X(@i$,Ơ0 "XH]-pw{Pθ`U -cQLڑn}5C11sy~[ `؈`ZM 2$\/I,1 ٔ( /p =I\FXKXT5+] #h I J~VJMBZ+43lȇPxd S}ʈr L G\Z1eX3.J!xI -Aup hh  4(\Dh鄿/FX?JAȵ7Q nT\-JOJJƐ=vՕ<$%+ݞSUcZ;*Km(_O~HNHrqd5) vB3=`-ɐȒrpY9ju_ׯ 쓱xD#dɸ9D(KDG"\c4&M5M$0#< Rʰjaa0Ѕ:b#b@4x 2TcfhEdCcHFhR01GKg] p_y ;4B dK:9tVguy}PB&ð9B)F`dFf\JaKTL΅cO6iB쁋]=8xne|cDxp8d ~Ybg]4. .|\ɦΕ K9K8@|hxyn⒌!~s25}ҠR+׹Ȃp v\i-5bK=UO~6 $(R:A]UPa|S8WM5^\M=VJVr))"J_!k+ J,(&N >9ӣ^[8֑g蔈l@|v̇ N &'ȸ,W@^ Gm IkϝYaK"apQ v!0$MhAW埊%lIp0XQiv 4 xXIi@>) ؜}8# r4$ `泫Z24)giEux@4 {)J}t_HapӱSsx?B7t=CWEt@e`&6t)9p"(T=U+Fll٤/3YPc8`hGWHsZPh$Aq1xPvS P-2f4q!i'r# $k)4 &onoiKRΰYe`yv }xL1 r|:SFg~Ho+lMgMk(y {UHx6t 1͵Όu>zfnbhn0Pi_*Ɇ ~1¢qwrp+"iO BцO,U4{.y pwl^܎cȌ.[m"\&޶9HgQ I'6hx6Y(؃BylwvPdHWxR' OM gˆ% jT =gXzozz">noR@DY2mm`Ŷ):ibx걷lv`snb-8[ǎ2eK/t aӦ-|Ǐ"G,i$ʔ*Wl%̘2gҬi&Μ.DgѷB fPtZ\u ꭬Pr+ذbǒ-k,Zځ[6iȐEk ?dX)Vʣbn qBѡAy>oĠ// M莹'YM\;`9Nk!ͅ߻| \h8-Ny;vѧKg7LiNfk,/O^ѿFN\Ć ɂ _O?S̀ md蓏62DsM< z%OG!jt%x")"'I@)FQH S^IEUXiA 9$EZ^V\s]y #P A HCa- 67cIF1D1UdK"ֈbJi蓚j EHsP1dCGK9 jɩ-mqwz:[A$juAw 8뙷*GR<N4dO82R0TA:N<'Csa(p߇{9"j-zL/7E%vRMucUW=G;/ U]- \t%@@ BAl39>)LM5- B$'%O(O8#?Y,lqN5`ҞcEcl_8E#8hi-O#O6-6ym)i#L2쐁<8GX44sT4͵f"-N< ē[k.nI2hA.W:s/W6/x A {AC@AJ D0L%)<)~,Npę栉"J&2b6 馍1'y1]|_EFȆ x2PGF5!Q-6k[;AS(P1sQx8Q8q.+q:e&!S E=@th*Q\')RQHۊ(+)¸ SLB"4`@"ޡjtBpnB2 A~D"!D&dr3(K=73ţ7םMnSdHT8Qm'yLȈ{GLÐİ1>!I p0SeI%+1#&8?ùKѺx:|'3~p0}"F 0#4:ȏS f fE <:A_Ou%f3̮TfKID=Jg S8Ֆx8SF:Q=J1Tm!DCζ-6k؆WVlt4kԪҋNqk4~a EBT_HIctx{2I!X(#},+2Չ5| QߨD—Cf8#!2l-Ac&h$o{ܙjII2=?`"s5Z":[V(rN&ws^5_=c9L*ߐDn@ : \ @)`at,/3|އQ1H?!hCzB]ǁ8Sđ0 hÑ""Foi$3m£pDU[Mt4# J+鎮KF]e%S>p:K#xy'ె;V2/(q_<0dF,N Q&.n6QL3\Ӱ~8ኪ׸wo8B.<$S򁳼.9Ƽ6C{|Ѵ5΃.Kc"9ғ>n$aHMVLd3^υ/{Bi?@Bzhia.|mnT^5( 8$w?] 3`xŇA 3k^ Z3._yȓoїUh=)oǾ=GzK~=yy|ν|3\h>qkǾ ]>?>|$]֯agمi T[^A ۅP݉ Ҡ>L᜘`Uج[u߱Svr[L?S(`40bt[DAX \(A!BC" DpZHhD8?q("ȳIC!jf"(LU"#"9%A_vlN)\ט#8x7]qHD3z).b#"%%eQ''>8( )Y="<,`^@ #@|"Tc#4pAL*:~˫B<`#"^΃CR9jR>{lndɔf8F'B\H7D\ZJc bt%Ĥ49.XF>!NdYcP TQU?@ SD:y+L$DFD8dm-4r l2ILDJ?6:HtO>KZ4kE$Yq\lg`!q緤/]6t8tCxh劈'Lfrcgw⿔We#^ApI 5uH|> C<(>HG<'F 1D-'A0d5HЦ̂zڔ#LNl"`AC*8.(s%A|hA}:R( h78aA^1Bx6:$ȧ4-;> ,܁iD }"N>E+$fj*] ܣӗgg%hJC22®,ܨ5l`?@>\#e!B<H(4.r08A(%5<4C00' 'Y-+d"ZC/*-$#G" >tB/~lD'L21A(hC& ?k-L +L16xF*\l>#B<igžn%`C3( H,`'ML~2jId"@Tm2p/zV <P( B$y 2@(61؁/pT4- PI&DG.Ay(4\4",AzK\z DC6(AU#щEx"4(%F %,7P̂8T<(2r7$'@& \ BȊ,8. |H(7+xC/A4DBCC*pO,4+$? *VjTd~>BPL *L0^ \YגhV-Ђ+,+Z#: Fk 7^> (Cp0ɃR:h.d(C+5`f?h8!TpG:x*< C 6|,0+6"2A, > $\;T"jilb;(F#́iQu7+)6iC/A,C5ȁ2>$U6"¶涸C+A,<0C>A*4DQHjOjba9}r6YD] j\ 7p:H&>،n%m%&t0h6tp'%23)C+A*ԫ&?rNN*:1~2YS3s2;Q4>C2 B',"\`]pgdT,,78{pHJ!ÇG ?а CBL:V( GtB:B~ n0 5`1d!B!h|D$PR}K``;(K{DV7\7HH3D> #;Cs3̂z f8‡1)H5f%Oo,WײbrӖY(20ujƵ\s+>܁m$BeBC2/48Qt?'4;B +; 3K84K|x+r>24ԨA'F8v6\1)@V 68<蠇ys{o -1hƀ<0w ! )h'(03! ر?C/02?|$H:9T0|oG;z%xW2bүX/8{/?@e5\+sbxo]@ *Q0,IHB5B!CY6gN<0 >\V VE1G#4?BJDC-,3B/C?_ߴ4 !((85@/ #ii`d 2dFy²0X(A-8pttt(`$; !2\B5BAw(A56%C+p`ͷTD@$8\4BB,; L?pC\'(2"OLndD'f/&.׺ߺP-fN#3|K+[ R{r57awCT dy(r<܁1IǞ,B*)hɰeƛA B4T 1lw2""DZ8<,|C2Ah,^[@$3C(C{<%4%8+@yH8p&TaCg < ;raKPbI~QT֟p+S26LYZ8;Z [n ThSOF:jUWfժWT;}˖ hfƐ!@09IBt ۇZ >lp H!/Z}Ƴ&YdϏWmxZr1[6La"D  -;< !b1Lu3!h'KJ8gv*YIR!p,gZ MEKv.TŤ(<hS Ήe` Bd}QS>va 00 δ)V)pƒJq %~i;rIWmC!&WcEnjEl|"5=8*&LbGhaţ/rcuhhǓK=HB}8Ɔ5*3s t(AB@eY>{*' q4kh7|[Vp!$2*.ypԈx9敺FQBm"%!&\.n69@ &baU!P}q',Aeޑ)&PXUP;Xj5 21Nc79>*І5!U. 7lPHvgLUcu,P`7m.R4Hc-0 TV@ 濗xo,ฃ8@!~f8 HW< HVPE+l|@P`7&؄*wUx@qBtW0F$$'0AMxC8NdT X@ (qF(Ev H0& %kjځ>rqYgɁ |]rs1U` XA @9XBpP$*@`d P9>Lgi4ߚ0\BlO: hx H`HHU9 8"j781jl|魟ѠLt9νQ&zSt:E$ A/]uOG/ 3\@(P@t0 @3M!l"> V<A!T T! f VnL ZXB!4FTF`ꎔnofj|jVpmc6 ^ V.<,$`!n (A:Ol": R@  '! T A#@" *8` 'z59Zp`hp$bn-65a U!b ,P B~B` "&A3P ^ E HAH஀̜,! o ~A~!A jV40lq![Hq"T+4COr$=Aa&!L ~<ۘ܀*b,@! 锠i,nt!>`aA>` l 52I2/(*hn(20"Q12?#?(o1c7e7a >! <@"R@" bl ֠ .mg܁  @P;! @!@l >!alݡZ`܁H.i֠ J!!s!%*kO0+072u$s@#C2CTŴDU. b!咼,$;TA6쒶(#DA!j B4AA:x!N[Bhn4FaZ"SR@/eo(3sK0s~usLU"CAMEe2[I!P6%;CԤ,7P}Eg.5E00[z-8 X\ PC##3b ătJDr>ADKQ"?9?T@?uVTD 5P>  !T UYKS~&i1mUd$kS5l eecl wrG!תF⶟RnnK#o'soIg)!$r5p qoNqq]llLYwwCmywu!vOUvvC w{xF|yiv0wqW0kWL7f7|D|"T#2v70W#]l|%w~|Tw}w{}m{e~ x~KW}۷~~)8xŀw3E|7ϵk'{yGȂ/]W^BF5Dd(2t4rbbI#0PDT.2! ^A:CHdDl. *Y* Bb!!! YnZaO~K%.I^tLQ8at\kD?Qx^!vcYXA46h4B r Lp5*Jɷ !RxL@P@aa:` `~AA*`.,*@h@!L ~Ap` 4AI4Pɘb'ƙY}#xz 3>T  Z daPdW!b!28RC5? (!$&ځTy9ۏ"~!`h`aW~a A4 A EWC@!P&LBg RJh AbN. t @f@LTah RN f7wmzO6i0Z{YgKN@l5P!Ada3! Lª!RL a0D=Yle ؠ8A! `"@.~!5 LC/9B QĀR}4TA%aT!a"`,@9KAR !a:ހXZ`  d!8" [ S` c$x}k;Rť,~U`. R:Cc!@!X!!w ᒖ!*xbo% x*Uk1K1Z9] }C+>Fԉ+uDldZc*tݱPZ5 }!{>~}i֬a [8;ʚ-[ [nܹtڽ7޽|];`9s Y_׎!cǏ!?*[EYC/ѤK>:լ[~ ;ٴk۾;ݼ{ iP-[(6tr{\Ml n|<޴̡M6 R" 0)$Q8QK?T0@ {(s2r 6O3CO>`Ϣ!(T#< ?`!< O0`㏢TJ,4B*(>Obـ 2L:QJ 1HcެT/@SM6N jvUϧ BFd[uUXK$[n׻YKo{֖tuib1dyfg}.p? qOLk>%drrڄ&d#N8ƙ,qيǡ}šC\s 8%C2BAc<#QΣ8#v(ǃ8 s p*AH.Y.wz-sbBVh/x?ywq39q2#-cj4#c?\8i6ڏ?!MLkP(2B5xqؼ2ȥU}db=WO%~~adcv0OOHglsiYiY>BcY54NA>2VV'w$Е1n+K‡.;K1n}[Sw$*qLlt@aL88.̀K/5 ^P-4AP4"4 a¥@Hrqm[Whxp_Co`DDB'jr'?yhsx2NnR*mXJW$+tٽFrzdY"y>!`<"&Ad*s̤q=7č*Q)HWZ17j9[ڍ,| `Q`3\wfs=Ylp&8)N͜-(^Щiy%ψJt=X2ejАt.-LNVơƄE_ Әt65O0O ZR/o ]ϸLmS ؔ7uˁt jPJY R3մuluTq 6%WHCk8u-ansiO Yuam'1t8g? ZmU)e5d^XѬ$vo w-q*wms JwԭujwMD"qDdETݨ\JWڵk%9&a w x.+x n KxF}?3*Xg{?UJo,n_ x4o߸%mF7|" .r/E,Tײ EU(KyT,ky ~WBC 0[ϢZ"yWz/JZI̦tKzҔ/L#W$,i4njj&>_ XWo\z׼ ` {.d+;WpAuzSm)=?"{0hjwe xSz|{A x^j2dDg{vYÁc.qt0Fҁ G.|,o_sm qWZj<˶iH#K}Tկk}\׿}d/ώ}lo}tMTؼZW|\rx$e(^XI% 橞ɞ@ٝoѓə퉟扞ɟ JN)j M^¹ *چJZʡ !*#/J')'j+/ 1*-*5j7I9ʣ=?s; CJEj>%GKʤM7IQ*SJwF GZ%y0I @IYz" YmC^ `9@iנwʤ @ *Jj:o0@v ৉Jj |: Zʨꦧ >ʪZʩ}qFZ Vg Se P 8GjNJz ce:/êڭꬲڤpFમʮ7kZ }Зgw:Q jY"Jgy1E vPfvQx .gJR+t{)K% qg +zD:{g`<6vg0[5[We gK;y > z@vk  Ҁk\ b|d"4΀ vpkWih=c Accc` kp$a{}c!{ w;Y{$ڤ\4 {ѵV^qnL˺OFl _ gUeַ4pU+C_; b+Ff{ж;6ͰฏkN 2h;ր]P`U $E}k q ְ[_K |뽴ڴ{ۺ) {lAfU\ylKy*?z+t0~`A0 @4 #--Ґ0+! g U<ykW]U p 0p Pu Ր g~  k{k 9;  P ՠ # F   \+j ], a O ^{]l"$ű] ޠx'p 0 ` r0 ||1D\ ` Y lB ׀bA0  bg JR|`k{,v0{ų @ L n x)u pՠ Ǡ  ` "jwm p 6`zDžG{*%M`flʰY, 1ʛ 8łз, ^Š o /@ ,h {5]v> ߬ 8 p0 5 * Lȭ" H= $ر NL Q| b\źl؈] @ 0 @J-ްP wڏ@Ѡ(  f m`X͐L p@ $b @ 0* `ܿx@ =L, fկ^a=ֶl۸n3@ pe0  m  f]ށsSz^ҋM à1` > 0 wpp ,P0  &Ķ ` S!]ł.RM є t4p1M ɐT{ ̐ltM ` ` P mon3^ R0 ? F} (p N  k30l-` I@a઀-޺m~&@ рl`(.e< 6P0  {@ teU L 4P }p YP8P +`R`cŰm氉ᵝUL - 83 1  pj0  Io .~ WP U y0 0 QpkPK ÀL !Z]Ez0NP % 0V np į1 nM_PR - P AA  =N |f# ' IO p@z@ PUhPP2La6@ ,P )   P J"F,XA s+C}9VŊ!ͦjb)hRZ9d-(3έyIZ5eʄYY-b1c*i1aNZUYnWaŎ%[YiV+ ΍%Y_1sRTXgS b"9'1erƊ 喯Po^[iԩ%RKYYcv&ED2h¦,IB\EO(Y$AWlAqDBB 䠐4f$aԶoVXg Q:InH41IbWd0`*Q[0 ЄXM:=Ҍ֫2ᆅ+" ir"@ d`7X‚ P5>(aQUh$1y U.#c4ղrK.K0T+=84Ӡ$EINX`'^N`\*QJp+<-ѰsRJ+*{/kvIfayntXBn -b(3" T 4E"V D n2*\/hZીMv&MsVA-Pŗr\n[IcLDM9Hŗh vZ$ŗ7Dd/\ ^e%_x!*l@&p]Q&(BI:4YetfkfsY_a@A_F(:*^h,`;Ej"ylⅢAhMcM: Rʸnl`M 7_౥ <&a&Ktėa&`:߼B-;zN;5ORNs y $`fZh!Ɩ;.x)Nw\=s찊c~qPf#uE! hf1$e h0gTFX9Rh'3̭ ,!Jec`@LӞ=aL8+2B/q:3 2 ъ8Vs-$izcKgDP<[Ngk Rw[; H@BUT x/l 'XNPN/"f9[dysBwf/XC0 6*ʑ]Ѕ7Z D': ?Hx^.ع]`ڣ:7?Ѓ:BMtP@ \8JL^ o"FpPIBU`Z  Q$g9͙ 딧 F7tX hP HJX<ebsNO6xkRJsDs=YbHa bbxE-x5dB+b!\(b)^!Hb /x j.xHOTn[-$S XbĘ,ޱ Y"M2^ Xb lQ _/R_2$9UtuK\ E\c1 K-qqUFemqa"*:ъaӮ+DM{ZԦKGMRAWan(l6D;Hx,`02K T2 ݌zV|q,dA mhKDjSɠ,~4xGY abt0ܧIiq1錦7{Qx5W:Uw늅ysaڤ+]d c4SNlf"ԗ^zI;0kOct5nR퐖C.NoZ ^!0 -"{0@acn 5~C>.w,t ~!ҡخ[d*x.c\nZ4VTg kʤ,bQ|[j7V?h @@p#'`3 6297C;@5ݛ?St49[XILtdAi>Q7:6L8hDtLǾk ID1 ^NJuG:Dp͋@DuClH|Hȉ8HH:ȌH:EHR|PZpA(IH,IItțIIIdȀDƪ,LXȡI:8(9;:8\JAHăK*,I|||K˷tKlʩKK,ChYH$̼"̲"FqlLlL*#bkfi{q5` E6>+;;&d1e GcMp)ĬMۄ(l*͙;  #F1oM:2,kҌN@*#Y`I,ͪάL$`POLO\(Ob4F@P:4' P!\ $@lPe=tE6D;8Ђ7JƙI< Q  ]mQ@EQ1QQQ09@UNGQ }ž R$MR% }ݒ%YARAR-R.R/R0R1 S2S3R@?RA7 ,23S:S:S;S=S5R5 TATB-TC=TDMTE]TCRj]r[M_JYjEV`!V0]pfHci(Qw )HZ>L fp8m]b=N=F^fdiפX͞5Xk  ,dOXLhjZf c_cXc-^d@no(  $6i\kO.k̈́@d)v^ep *fh-hnEeNZ@ëhce$f8Z c_(mauUdxBm] 5f`@d֠ZNh[eŵiuB`%l^hFPFb26hmc@$A†ldt\pm`H~w.ރ]jdgd&MfmptNXEb_8mpdQjfZ./0RC}$ &^_-j!1J 0)j8X쩆c V 琮l-]f>_H\ήэ`YdvY2ݜo؊pc@uebH 4% V!xڗkb _@n.hپXd0Ixq8ndmnhViHMZ8Nₐ=`$ mn䭞cpcnMl"Zny*C#J؈Dqkb*HljO0lbȆ7ܰq kJ4k)EhEPYAppkV(jocY2XPQ0ę MqaPg^s&fW*g&ugE˵ZV&7C\N nޞ f+>/_ȉ"?p"?kY 0pSxkmVnjExUxbH.褝tkUAtYj"nmsvm'rE:rw<@^`~p2vHQ"Ol_@Gڦ G*0pWvɩ0qab p=OZi@ ޺pq.?)%[0C뉥!>dXЂ$ d a=:ib30A]`UjB3|q[HȉSBeUkΉjads®* +؄UЁ[J  X(fhȉRtXPopdkx xYCgǏk >e߮u@9\Z|J؂MijHx mp̉V (U(ohvktUdr8M(jR|hh(sX &-1bҚ5;V1s, @aՒ QY(WRlSF׬i,d5aکRuX4ƒF'cKt)ӦNFD,4e6bS5i邩u7aJ«n# b;LXycS֯&ã^D!cLXyhц1z 4! )ҦOvW֮_U [n;6޾.|8Ə#O`ǘi \hk҉ Z!weAC9IVp> f|14/HT9:\ 6l'PF;e@ÍQD $Ӌ ,) Ї@sXM5I!5t?CT 0p`$d1B$6ܱB2tP@ 3TavlM XP*0 (! Ri}H5M'BL4¬D!)T`Jb,cBhQ"VwYUt L5$@`w)P '$}Z &b YM\,oXbxKL0u4A"M5 CLCLcU)RA"hG6,8AIx0|L@s ؠGwPL/:q)/$Ì[ lI Y YD@ ". 8)c;E/ПR$qCRNPB)&|M+bҁ`%\`&xP9y<@IElbHӿ0  h@  U6Rqy(N)7PIA+:qB iE`WL"w .] NFLTH` ^PJPB ^ABPB p^pB|A J#|HG`΁E'*U z&@^$:lB> [$эR@!J=,CỸ *1 )OMf ITw8B0v`  N )8u`F.@`HX:H:Y8:M dB9rI iԣ">qgܸF7PuUjիb70R"x+r]`d2=#7dnBHLDk2 ^6,a; ?0.|1`8b*`A*1a Pm x 'd#` $(I`,f&p J/6.qk".@Np kXP <HAJK[ LNXG8[.̱ 0xHWhdj&ހ_t^[)a'`0?8*F0x:{-]6: hZ0N0'yg\ËEP _Ĩ6X|R.G9bjs.0 pɃ}5 +HHD"ad/RWH :A)fQS܆n7񒭘C 4xh*@v5/pI/uM@JA 0C궰$*leY1 ,,M "xE2q8@ 4 V \,^Q3Ƣ;N橅jVm{{8. UMbq9'@;gFrE(:@9[ 5qXY0jyXmeT8VZBNp98A wtyiY"b B?߻_c Zp,r&Hb)9sBV"D` ^H$##w8Fw$ty@$ &xxA$pa_@E9ħN) `0J?㞸E{/+lBq78!d'ň" h̍ 1$& @~ŤB]>((QB\Ku&щ%Hы&1BXA$"T3PP¶1'ĀtЕB؀+tgK@$Y&,&@xxZ$k} 1 靀T.*PA14)^O(+ЌAB \ 8AJ8+8'Ղ,ֺ‘ЛT[ ۾gI| D3tB_O})H-ep9/ $`,fm p[B)<9Z!q ()[+V5,]QAC2\T"!2Nႝ% +,DB꼁 4kuԵY#(-3B,TCO E ]k /C20'*\uCzB;4I$^)*)@AU0B>r$/^7XB7@iBhh3pܱDx(Bى,"YZX@&@JT*Cg8@ #i;,h0|D.V@DB*BzC@,3B6@BkU |գ.D9d[9eڦ@͂]B1҂*x#8؂6t@Vb/'t7d\X$* 5̀IC/hD؀F()0 ~&aG*'=NNT3RguZ%3A*0b<_$N-A<7TdD5(+-`"/8`f4b t A-̍8'0UĀ-̀0u\' C++`1t^gr#2)I-/#TB(p+AT6ق|+#B'%\!8E!B=Cc`՛~ނ@+B 0gj6B*T#$P"B;L()..kh)F$ %gp+n$ +@TA/cB."X'ȂALB)P$DZ#x+CHTDX$A*A}*4N,+ FtWb0BA)`P48B1B!\2CJ'$Dq:;iklZ3ĒHEB$Ȃ+P-6:B@X@(B0*y0&d d(@"X@ M:k&C$q$H+, T+lH/BqB&(\( N1B.B`sI' 2- BC9, fH1,88U08 f#3B(g])~~-!yA+ \؜#dXn)D.B02Af^H") +6mpz0P<@,Hy19]-<@Br_v*@@,c#<$tT$"H MHЀ-t0@ pi9 նB+̀w$%B:$ |E/'h "@At@@IAHY2#&E&A,i/ձ#/85)P*+m8@֒4B3B--9) QV&pA0^n;₧k9p~ws3-40`PWR+xO3A'cq+h[8Fwlm.rl\sZCvL4+82B4|;R 6BLBEtS'2oy.5nFEl8h-[_xC9-8osZpCSK9L;ScfUyyF#Chv7_s.l Q-P#53Z]q%h //7e+hSzhp'e2lP #D0Le£l83A#t:ﺭsMOvy߷ۂTe3@+Ls|ty9g{krmi@,uJOUGU$相Wӻ;;w{{|0 o<2+|".(2)v_zd,S[z7Fç@/1+.:||ͫ1'#Hwa}|7q+G;'4r{K¸#b(B)k:5s}{׃=;76Rȣ$ ,ýۻ=)}=߿ };#~+3>;CGK~SO~"X{ӂ++~>>,}>>}ݻ};)B*,}K~[~'c>+o;ߧ[7ws-~ヿ}.|=ı\ 4.|*x A)VxcF9v?1yeJ<() &L9pдgJ9s?5ziRK*T9xCkL0kΌYs+V_,ڳb7rԭNP{wo` 6|ɧx{7)W>\T/TT9w3sځitjիY6fhSٳi׶})U@6&\aDÉ7~yr5wz~Ȑ{v|q.}z7GK ׷~>P_tPq֋ #/xɇC =tItGёFp'pࡑGm\  ':"ПWDxnE7r T2<Mǚ:Pn뮽:<~Af D]F}H%&Ubt84P$ C?E5c UdGeAٱ`N%JqV*W}Z E4ݖn9cD=ŋdNE|1By(ɦ9>S85@䧁"TؠTpxހ)K`-x7f8d;&K^Ye#ޠC}P$W; Vo9SRO3eePWFlqFx'xfkŠ)la^^ݪ2k˼etыPtzt1wp:d7sA7:›{WE5A>8j,#L85Nu3Y b_uG[=Ѧ+ٺ~Yҿ3{Yy v٦|Z I)ŁofZA40˳1-z:@ j㠆x@rP ۛp ruND]8!gHp;pva _.ka4i966˂P@.&Gwyt\p|$+B"w+1uTE7~c?yck`b8 9A`,p$PQ{.oШLDA% ߘ Nw5% [WY2c>l>}c1$jrK"K@%)5iCт\kNVǁdK/Zg-f `!s֑" $QIg) =(+PF:ȇ"!pGtBtEHpC0ZwF:FA>.5+H tc>C:uitN~H 2V_Hl^R<~xGE-~ql9OM $ LXD340 dC-Ǟ; mPuhE&" B4꜔T=m2`K+CR]aEbsd$h< T!̤.u(Q&~<jm-ԏiu#$mu0Wٻ:h 68gܕu^%wb~#9C0ֱEd!I1TlS"R!bF0$ spB8- lW8B w"|Go vM (&!MPAМ!gXÚPP4iT-E+`l`E8!>lq<( 1 'Q@/!*[, 7ԕY0Rsa"j;O^1B?^`ˎ)ҿg FFW4D:I:8>2,D `&X `э5  @!~/&(p'.@ o L , .0  *  < ,@Al $ l@l@~AE('z(annV 6  @"Aa2|T` 2@XP ]p bF> 0A TA fZ!`o<$@8H! dA! ^a >\! !@ m@(:"L` d+a '7銮"zLǬ( Π8 | N'] a 0O'p @bMl. .!  .RHa#pWP @bm! T=A>o^DR @ !ޡ8! A ` 12fi"l ݖ:7с`n NoQX%  br: F.⤁ P:!!d2X^`B.tT,'p2)pG,Gybhp 4|Pr̄T ĬI2HoGJtJ~gafq(s a ұ@mTba l NT fzQYdLFitJweuft6!H5`@H`ƌP,*Th [eqiui\K &` $@MYa FmN gAEA1oաQ1_&2< gWP:,VmUV[@b@4AALWZ7=,; \ӁՑ]<0a@ `^җo  ! @a`~Lf5b@ @!l@ p N Vod5k"gftJRJ*Lz0H4 rn d T d8JA( f3 6k'XqU! ma kA8vOcCb,@AѪGRnqR@~a8+AG!`S!*`  `} p@p7zoAZxxx `yuZuz;7 ^b X6 SZ!.TTA"!9A:2A  ZL ~M; ! EMse}4x*6J)ʌ:5 (̇(Ί9 N琶 3AyXfA< V TVPr gA&x Y!/Y `0h(p,l ax9C B `ͭ!F!`k␁+RVaat@ a\:AY@tDwIw1+B7! OBy ysow;< b X ^@l^.`M< b`P$ j "@ ī@fb!L4@ L/ VtNJ&Ԡ{EZZK(y "!:*}Z8':G)@aL0^a  kP:f@!cA @` .l8j`RU#N !!Z@+j< a^t!! ZA #!l` 59u9-:q:-ѹe#FP & zOɑeFA$URA]F ^ $jes6!nA dPefE = JḌk\z|[H)7_AZ1j8+=w^aEUA!Ga^? Dln}!dE DhIA<|aP f<2K!|VV@ā3!=A 󐣡BaW[jPvePk=w7ѳ[=!~! Ȁ.`eILj0h;ުlFf"F8.JZ {OY?9u^ߚA|LhU O\|'N KM[„1EtI?qM\ɲ˗+k 83ɳϟ@(NA1(]ʴN*8iR߾V>}TÊK6ƄiG۷/A%:&d߿&&LVj/FJ#K,_2k9W-.\nuKӝS^ͺװc˞MηRnw*>|.d!Cfe`?;9,PCSb0>DQDH_HR<a݅ރcIH eaovXagVZfxۊ,0hn5Ms5ĭDIǡ? uYݒ݉\E܇3ǔOe5%{Awԙg2՟  fPDװEx| sl$Fiɨ袌6hkF82яsZBEy'qݩL:ɒR6΀P"pP*B믿ګk뱴KA>+BfvH(h覫EZ#W@é8#M6ȈJ*JMݓ*%aU *G,WlDw K$$l("V4̨NCڌ4?$t>4Rܡt oxC72|g=4B}ɎՅa?%oO?D0o}JZov LX23'HAE̠7nЁ$X6 W~!kDI! w>jhX8H䞤&:PUCDҐ0X<.z`SSe%b6 cgxE4q{j>PHHяL"=+4a!'i1̤&D!7IRq A%*gIZֲ$,w.Y &"q]70f‘^+IM *ә̦6McV,IrSr*o"+Izol9BW8IЂd:iEDJъZ4[霍7!QBG HGo BdGWXLgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZ5JYOz4/JֲhMZֶp\J׺xͫ^׾ `KBi~u b'KZͬf7z -`WǚMjWȌL;]KͭnY pKMrV utKZ;.vz.xKa,/z6T/|K./~L37N"'Sΰh { q:,(.&!,H*\ȰÇ#Jkŋ{"Ǐ)rǒ&;LQ KcʜI͛8sɳϟ@ JѣZ/Sq*^Vfjӯ`ÊKٳhӪ]VGux.\@^|LÈ+^̘0IS<)@^iޜUϞ5M:ӢQN-jϪU{r۸sͻ1 h:μУKnG\سkν V7yrӫ_ϾO/_(_& 6u9(Vh v a!h(50(X,h8cDh:TV[f)0P+4,CADKApʎXf>FG+RJݰ0@p'P[b @"BP+&DJL Al袌.x]BCXfPu#P%Db&rP)$2Й%*ЙS6j뭸(A&3* >] )N!IO J$@03zJ&4:X.xBAji+t Ђ'Q=$*mD>4A@  AdN[$xv )ӐRflɼ;`@clQ*+1r  \ۧujgpex3/`~z0$TjDH.(mhY IBL"F:PϴM֓XI詍 (GIRL*WV1ә,gIZNҖe*fɐ\Җ 0F!2f:ДK4IjZ̦h(ù5A q:H:׹bXх|(pp #QEq2wХ3n#ܞtq03l)eH?M쓻"GJ5 VV@L"9Nrj[?d 9L'6JrBZ 'ˤ`3j tp- p1^|a[#);ɯB;UȐ}/4ڱv^C 5QFg8 [ SdC~(joeɿY]t(P "w| 30R}Gk/ +yu'&ǁ(o2 B$tְ؀ k ) ց3uאi0e'0w9 P2+@!GtKg YXpS!t cG0PQS(!&PFaeluxt} aaꐆ%`aayFi1{_cP &S逈`88aL涋Hv`nӴWxXƘ88ʧX}eڸэ'pxGaȎX8Akɷ{Y@kn ^0q 0 ADžesvVQ ؐi :Evv`Qta e5@C@#i .P< ;A v 0 AF`<BYBC0 PS8 |N4' b'0N N Ř@ l9 %RŠ Ϡ npx* a ' `B:9 M9qmic0 i אN ͠-q<p P^+f7i iD-zb`( h0y˰ P:7 XF րA~P yB!>6j'w4Y+ôAj q7 7D"zEQ(DN` Z  gPPPy B S rbZSqq~p1%h q|`cZ dG'A: b9 `;dc /A ~3 ¢$ p }qq  Q=IӶX_|0@:4l1գ\cź_C0IBJzi_D0@:H|}hw C<:DУ1*AEZxG ?`DB@I*K  iyz!ѭj{A᧿9="+!;&!'=qQ,912[=6A<B[F AL1 T;U{XZ\۵^`b;d[f{hjl۶npr;t[v{xz|۷~;[{+k@kBx [:`bR  W`` I@}+ @䵨 z`廿z4hչ{O0 kذ2 j_k0j&ˁ3ؾ+/3fK3x+Mk~gĆX {9 ́@ |-\}V: @B=h-HI*ʋ7újAUV]?iQ P0.=0 | )ɔ'd֖\ \P(׫&kP -7 a׿1` ?zx|!mي c&M2Rn3i ຤]8c:iXR_8`h `͝5V]h!,jJ]i .:>, &iYx 1!1 oh9!)/܌d >A HaLvr aI7bg 80 ` %eӉP1 j Ylqxpx>1?JZ>) V.hnȞ|] gB š  |>t` Ӑ5m 9R>.sې Q y-s (.ǥsʽǭr_.t]8WѪ6Ƴ`pz+ IWR]оgX PAz?t mn!k1;\qjv'QĢf\Zۍeű1}O@kaipchQ0P ,X.n-lӠ а0~S8?zV-W-?ϭi@] e(V@L鈱 Aҹ  O~0g 0 ɚ~}1ygfC0 b 2Q-`@zn*_:p8okѼY2YX_^_P й5D6q8D>/ ڿOԹ  v㕾% ^N< n `K߿~MQF=~RH%MDRJ-]SL5męSN@qFS4?@}|jTVŚ2cDq]}MX`y7n6Ҷpόjn=W^}X` F1*H6հ˯,+;1c=7&1Kw٪Dr4Zl%J:n޽},1oʼn6x_GRĞ ZpF9tݱ~k gXUʯԁ9XN.@<μo5dt;ZXh!%X?t.{콪@CU QLqEgF˲;:Pk2H!T1Gl=F񦤲.2qFZQʯhE:D3͕ӮBM9 A: #<̉O?4OS=8O QG4RI%"J/4S.6TE=3TQ#@ DGeM;[5bUάZwW_U`uXcXeeauV$ 'UZl7\qyv3V;S7^y7rMB~&`u5دG_۫8cExqɂ8(dOcy"x &yeoy@s-GfJ0EyF:iyiXjl0>iڥF\Kq&l:;ZN߆{M&n&;XP o:w(Ypo>å5Axͅ'x㏗vgyڕw>z_z>{׾{/{'x7?}}߇X\<i?S77@0@?6Ё!8A VP/`5Ab$`EhA#Da 9xBЅd e8Ő7!lCx(aHvC"xC4b~\b}Kb+2p_cpD'gDzb1c8GbGHG>1aЅ0~ ʐ Y%ZD 79InU\/jK0 dDdࠑfsG!8I^Q#n2 `/*C4yt&B;"@܈\˶2Laa[] c`$C9B 3J ]@2"ԅɅ]P_X'E6(l\.l00,Z[DÒbCDNþ $ ؁J\x fpc]`嗈@DNے>?Fs}B^N0N!IvaVWXN"Hw`Hf@hbI>佈0VY6n3/?061%>{Po =(ta!oȐ7`sCA9`0l `<&a kɋ.bp1E0‹Cf!{ %2$2!i(!Rl"E-FSb(11ͨ5n|#(9ұv#=~# )A<$"E2|$$#)IR$&3Mr$(C)Q<%*SU|%,c)YBd oˁb! v BТ0/\B}"nѨ[ĂRfI3E-)Nk E.q~$,`NvT*#F-buֳ#g,Jx(z" !B#j9,mJ.IbLG<<*l#J)JS0d*})L %k*׶ri+^V!}^W t5\2}S)ؒv!)d3‚PT XJ5p-l`Zm%;[򶷾m,= ^,ܔ sR7Up[w\=vӫU`{C azqJ?̃Я!,!H*\ȰÇ#JHE*vǏ CIɓ(S\ɲ˗0cʜI͈ ϟ=y ړУB0)QD*U)զXƢEׯ`ÊKٳhӪ]{r@}K7nݹv{^| fKÈ+^̸qKp#KL˘3k2ϠCMl=^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOy1\5.H2`x&NkA$! AW-D\HAԂ(فjBpb"ʊ1BA+"Di$r&"i~B X,SAJV` M.RA&~ˑti'oKĉ/oep@!q@ @8P53B܂P EI% [)ꨤ'A $iBL0PZģM<d61A{,J4D@X1L(<{P"L 2vjgK3)T;P-2_,j~I ,k76oN6(~K; O.~JKR :+0AC$gH'tJ)*􊋰*DAz˖.,rTVB/-tOtAو\Y-]r@9eMR'K)3]kREHB]gCySn}] 5}z=LР=.ݚ{**r *;)*)Ȳg.~ /o> w,_2 Hd gPpȠ7k (L W0 gH8̡w@ H"Q{HEu&:PH*ZX 2 %` 92M={4F3pH:x̣> IBL"F:򑐌$'IJZ򒘄"2>Ȥ(GY+EHVH H(]IZp\rb^</tbL2f:Ќ4IjZ̦6nz 8IrL:Nfhl jơ H!Rt c87!fȂMN]'.f3jV}UhMZֶҏ \J׺xO׾k^ `Fb:lcG n F-zы9! hG̚Mmj1 zsZ^,\q[H pKMr:ЍtKZ-gC  f.xǛyc zv7i"7KߋT\~@m.Ur9`:H1:FcpY{^+!{XpF?LN )kRϦ^wuhSέ6]M̮w ZWuIFf;ЎMj[ ζrM4]T N'V"q7gH@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy]xhf W`@ ˜obKcV2k^PЀю9h`uYI)9 y i۰ ' _Ab`% I'$ƛlK VsK ryL]0ZKYq=Й pdaq dyAgy2sZV'1𠂿<1JggMɣ%ʢTiPi['椋YG$ZLإ`b:dZ&cfJHVa['+ڦ% sԞq` 'e8ڥr&fUltO0tJ:jF:ѡvrZj˒*eaJ7`PӰQ?aj^g,)In 1 >&Ց#`ASl jPy/ꭦ^|*Ѯ=miA{?^)0#W,waU h$ 1۱4j S6@ˤM+ ʟrt#Nj3 1 w8x; =[t 91!vbWa@[[bеhĈGd{jGl۶|pGr;xTvkGxt|+G~pF[^`2YkzDax99k? {4ys{yĺ[G{sGۻokF;;뻯 ۼ;[{؛ڻ۽G;t@K o{44(1{c[7ۿs4;B@C,IJjG<԰M'OT\ edQ\]Qtz1$P %jܑ$p\v|xz|~ljƼ 9vPFNfb*1 9lKP(A qb l<*Ƞƌ R+!ɉRLIװ]9-ۃ!(A d8 p! { 1e< 0e7$iր sX ADY̖ A.1p`xLg4@SjA!Q2;l 12p! I pD /#͠5qӰS/3$b!/ME6G?иS1^K*E}Ҹe q. Mm àR6ńl@ a3 EL@Q0T`!@gXO(y[hmz!p#+x*sPz cY{mܲ R #K (Jm#BcK a&Mb U4 $!5'pܬ}MLLwJ86pnQ%Q KA =Ofg~ק``)0ܹܲ 0 ~M;;aVc@3]; @.dH 0 [sRt Z|%.@(ⴵK5!aZ1>/@>D>rBaa MEnV<"5JNN NK$7K'\1n>; ]n327P D8cko>>tKJ 6N\N'oR22%ckn_<9sMylφ~뺾뼎yV.Ȟʾ`k^~؞ھ>Ja>N:1J33 -怫2`6fArЙ / !L  1d8 Ib.?G1PR?T_V,x@&Zc@q ^Q&`'0ym[ Ћb. ET\?V``՞7qJɐRZfeVq>Qa]M?{yMOŸ_Քɪ?uku/Jb^@a ѫ/kq?` .Cen/5A  #9!Y v@@ DPB >QD-^ĘQF=~RH%MDRJdSL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\u'0]}X0JuXobƍ?6oő-_ƜYfo8Zh L1cԸҭ]?ٵmƝ[4\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_| ~A0$@緁g@ '+A R' ?1DG$DOD1EWdE_1FgFo1GwG2H!$H#D2I%dZA`h $H*p2K-&B(D-$S7%~ XkKm[o7\q%\sE7]ue]w߅7^y祷^{7_}_8`&`F8afa8b'b`AFsb<j?&yKKf9ɑ[~2ySfwg٬g&hF:ifi:jj:kk;lhlYlUm߆;nN@S{m;HOA= g|:pqɓ{<'ǜ/#qq&TA9StEbpZvApB[r7^FO"p"dH'y# e'lϳ?r3ڞGG {'j9 /,3 D0+8 v@,hbc HbRЄuE*D_ 5."T6|FR QKZո]_YժWŪ5mԺV2i[61W`!k}fik`v^îuU`^Uش΀ld%;Y^41iFD;ZҒSVҘe-kX4B[ZޚU^_3׸53anː4`;]Ȗ[2kk\vw# @-A׸k˨վf-02 8 " eH{GsbFce\"¸@Q dPsXwH0 EA2F0D\X.@ VX?rF-"eŐ,f X痗 db̮ftRVfNZۇ@.[E-rQ Z8ЅLZ #Ʒ]e;3{ _8,j cEsn/|+U;uiVkqn!h,J1 XCcmW|E1qgw,"^]"h zݷysGW]"{>9;1da]#/luzSx0MԠGbB` 1^}oxQ5ԁ́)*P=y Dv8 ͷ>#$8/Zy7Յ?= ca/χ~?}W~}w?~Gտ~W-[|q-"ApA)p?s`^CÖ('2[l S(a`n Rp@*$xRh# AA5A AAT_J*j!!;B+.B0B.B*$0<1|+tBPNu6 CjP؀Ü؀;dـ@̊ĘCCCLHI0ZD PG$N\9Ğ9QID0"XET/9REр \ \EN_^,K4>p =\&> Da,\\kZdk [FdGPj$8+ W Pf$nGrampDqpLM IZ "EuG_ŇHzG!Gqd n$+ HX ǗȈ FLDCtIh(EGrI4ɔ, ř (H4 @JTJʜJI ʍv$Kd,KLDHKED 4PJ1˅ˈKĜɽHKIK pKtK<̰,8lM<ĀҴDŽ̢LLJ|=LM`NΊ ͨIȁP$ (]N  L䙔 x8LO8 ~HϏ! !, H*\ȰÇ#JHŋ {=cC1Iɓ(S\ɲ˗0cʜI͛8s@د@ ZpТFLt'SKJիXjʵׯ`uZՓfӪMkk[m߾+w-ݺl -a LÈ+oǐ#KL˘3k̹ϠC]1ӨS^ͺæ_˞M۸sͻ Nȓ+_μУKNسkν{sqËO9@IIW!H CIE"IJfG,l)Kz2RR9)WV򕰌,gIZ̥.w^ 0IbL2f:ЌO(jZ P5 [Bܜ Gp Cbv’'l;}9 gی1#m?aߦFh*V¸-hKpc N1MZi s,oGvq^*(i} D`+XU2d">ͫ !H'SSI@e^L28>s20}xγ+=π.<]0ЁOMېN|.@ b` Axݟv2c)CA{c44Fx`8y~ TI;Z-Kx@ ,Jj8ĝ#@AkYFL1pؖ$~,Ȑ0 A@2d&=I9 8@^1[hCvLAۚmNq#|dwQi!`p Ƌf4< Ad$@ܢH.x!OP(a",IVSN zEM m P2"0iAk ]j}; ?##1 ngkC,{ D;)7cz:>wof>ѷoc?_3O[Ͼ{OOOϿ8Xx ؀$AY &pzdKIjP &K@ KU0K5 @% ذt8H0vSC(zHJJRXYTXX(YZb^X`vdXfxjXl؆ ctXɢHvxX|؇~8Xx؈8Xx؉8Xx؊8Xx؋8XxȘʸ،8Xxؘڸ؍8Xx蘎DSȎ1}?ԎHUj2^dЂ5  ]P_c]@[ `z!Z .0 )xŊ6 Tj8ah Ԓa @pp ba1wHbTIvN1]V\5fr[@-`!D,idfd0 C[`52$y9x xY` iEԵ99lq!ܠE4VF'AXcuD  yoE$IٛaIw锋!0mG0L)SyK)SʹF{ Ձi`j*ќI~ 1@%z $D_%^,A'nTA9% pږ4:8@S* iҕ":,96 Ē ZU0jsql 3XcXr[ivw PCLY&B%ҁ] ]H:abZzB9Ѫ:E:QTDzWzjWJZWJW:Wɺ*W͊WZ WպvQ$ʛbȭ!ah歂D쪮R41dDMԯ DJA{j KA ۰ A:{@IwUGU > Bx";ı*۲U.KA0+3{8:<@I?>W8S'{F۴N$^&~(*,>g]_D!s":B=>f#~4,V%AMLUKy$t@XZ\^`b>d^f~hjlnpXr.) cZa `u> [а"BqĿH%:&3LLG 2dI 19dDy^.N0PeċT9o ꁑ  Ga٘# +GXE8pξ N~>3V~JN<&^~/mV-HR/ZľUi@|zb~M鄡mNTHU1!["K]PSŢH'Q8>OIB3?Y7o*`EL?"4XOabdҙ,q˸  go^]2~VDNAƄAE{$ad}$ xP)84ċ)O_0`2?_ȟʿp6a_A.? }9𿀬 | & !  DPB >QD-^ĘQF=~RH%MDRJ-]CęSN=}TPEEZxK(-ԤU^ŚUV]~k1\VL57þW\ukJqx`]Ҩe6bƍ?Y0^~{6/eҥMFZjƉ OEm/}}\pÅ+\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DOD1EWdEIEgQ:qb1Gw-kGHQ Z1I' p pW F(K &X KVMM7+FqBY g|7כm3 Q"p0Oe4R⼦qY@ g$O88AFq =2 >mVj =m%"j` %c8u c#@6\qO_5h3,q߅8_[~B8` %PÂ(x#O8D"x8EgvVbG/@"@(S¼1dgy>q!`DXhWٚ&=EyB @!?PhCGoǝ4FϽw߇'?rw~<晏^GoѕN{ޅN|O|S/Mt8@D @6Ё`%8AU8C(/,H\t7![b`/TB 7aeH99b}8D0G$bwD!POuE*NRb/wP_F2͉х h5эYkcCF:юwcG>яd 9HBҐDd"HF6ґd$%9IJVҒd&5INvғe(E9JRҔDe*UJVҕe,e9KZҖe.uK^җf09LbӘDf2Lf6әτf49MjVӚf6Mnvӛg89NrӜDg:չNvӝg<9Oz'a8/|A{h~$rQڂP`BZsʡZ,j!ʓH)^QI$Hp+iKUR3iMiSvTtP5!pXATuhQէRuP*SZխԫ_f2FV8+PJPV.dm4WծbZ !r=_⎽Ғe+p  {KIMl:I(d9pH EȀA4ڄֵxmla;SAk"DmHֲ"-HjKr rv @! e-wk[ 5HV*zq3\75̫ZoAǗ,B$ E@oQUd \-[b 0BL'D$&[8!23hcVn畯9b8C&0CKN2ʃ%M,d&([ed`ظ+{b2"(", oD 7ci $DKXX i|AI=p XZ) ՒU¹YvYE7?y !f΀!, H*\ȰÇ#J.3jȱ#ŋCIɓ(S\ɲ˗0cʜIMz v@} JѣH*]ʴӧhIjիU-bjU+׭^^ +6+XiH.pʝKݻx>L74H`^ƐKvL9rɖ3˹ϠC-ӨS^ͺwMÞM۸s,{ Nȓ+_μУKNسkνËOӫ_Ͼ˟Oۜ ja2B<4JC}F(aK bTJ7 =B $H+P !P-8'(8Q< NۥC0a)AA$MBK$AAm)8A IYl"7C<@)uM&enT@e,bA; Kt# (P!BVPmv駰' MG%i %h(AhT\R~&p%A 4,$ 6+ @ 0Qj-S er "![*t: ZI-BKMM]g/>G_ HLB: 'HZцÄ@D!I2BP(8dip(!@(8A )̡w@ H"HL&:PH*ZX̢.z` Xi@FB0F0fkI#HHb؅.YF:򑐌$'IJZ̤&7Nz (GIRL*WVBo,Y2ฆ.s)[ҕ@-zˍB-?X!bGLCF#Wi\c&D@bKC*"p͐BJZT990+#Ƞ*iA_bJ%:h3d_F8+$(Y_(yTtN򥨬MwӞ@՝J{YT:P 9ZUoAUjEh5!XՅ LZֶ\J׺xͫ^׾ `KMb:dėZ6kfii:!x|C jAu klg)jnwpsQ_za ].x0SW\#V^wnwUvmY;~%OjKwBc_'HFq^;86[X8pi[ Ov=; ñ41y7$bZ*e;V;A1_0C(q&Er&+1*ɫ 6S&cF1އ#UƲ)q<\yOm}ެ R#!Ak,gl#x8!cLψK:*;#ĹYf'MJg4\!D ᇓ5Mj!uW͒cìg ָ5j\^u.Q M?>I40]}u0t\0;x` P 큌v _>@|Ecd+H4~fjb ,z}E8J1 է1CW%F &abAA !\u?|v6yT0!7?[{Pi#.}І1 `^A4ӀGgk='LD-P!(C19A61ct%,zC:}i:;i =kcBb s((6 e=?@Βd(g&>: :kWw""#R{c(COa k'1r""WxhJ|A,(Tm/H6/MOQۅ1 =/Z[jj!A oY~mQ'{7J&Ԧ׀D H(WUjGp08GF G  ,Ȃ.7@0@y1:؃!8胝 lH<(}JTXVxXZ\؅^`b8dXfxhjl؆npr8tXvxxz|؇~8Xx؈8XxgHwX]YY%])) Ŋe:}IgE"e(og Iנh{{AXIwVs%P0I ōa`  `dwvFIx֦jswI`[PuZP Y ِ Z% ,5 ȑ  %Ge~&^,2y53YXg7<ٓ>@B9DYFyHJLٔNPR9TYVy8XUZWՕ^U`H5dTfy?jSlٖ;pRr9Uv Qx|IO~LYtyKԘK4Jyٙ9Yyٚ9Yyٛ9YY.[wWќwyйT&F3؝CAwaVej y֐wy=] ]t]@] zrܔzXPơ *@ WUgu;wp G@\x6S$bppQю R0s3 Qdm;: E]`w'Y)(z 1J5DU QY:gjSl:pjh u]Hurچ~zXPv Q$`8ezi5yj*\D?R :PHG@} C#FZZ@ᐏ>&R|^QJ:FJ_An"uqQxj|   UDA% ʑ FixPx wd ;1cp Ucq$KDd+KD`5{Eۚ% @K@; !u` *Dž% ]ԴP$6^K!h !fжno[a00at/%!$e !n[ʣ(i𰸋B$ѷxZc*fR\E#&Dɹ\YEū{ټʙ#&k[p *$ 0 g B蛾껾[B;%bpe\a b`1p eGa <\<@lJLD+' D"<>T&C(:,B.2lA4\ t8@:>\@@\޺ 0Ġ+\ءF_7QO9$A?`3d\?f|j=lp;r<%fB$9|L? 6&; ltLNJ,?%ȖSə?Ȟ ɦ|A ʬ|ʥ Lɐ,˞ȃʸL? ?# #iu@P'fܾ.Pĭ= qک۹-Aq-ݎEؘ( =V= m5 =K&*&[ Vf MߤIF]א 170r[E 1abڠ3M D} XЂ RLڅ p) 0 $D ) 01 ؠ] Cr ` Q~R5 " tۢ! E PC^ P #1߀ ACNa#ct{HZhw 8+!Pΐ隞:@Q徤 o,eYxqD21^t "^pN! ޠ(>ZL! p[[X-W@p .=B ʰqR5l 9]ð RI SHo2Q ` .SFp 2l' 0H& Wj" "@azVFQ .QD-^ĘQF=~RH%MDRJ-] ] =}TPEE RM>UTU^ŚUJ[~VXe͞EVZ8پW\uśW^}X`… FXbƍYdpu)_ƜYfΝ=}hҥMF]Э][sjڵm]n޽}#[pōG\߹?]ztխ_Ǟnvݽ^xOG^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DOD1EWdE_1FgFo1GwG2H!$H# %dI 2K-=jv3nTLnXK"klēp'y? ?|e R9ip64NS} kSR-Hm3i4rTgNmZ$KG~Nh:iHiAى~HʈP'O"dh=!`6m2n %#cHgڥdA#4^w(\1}]EaTa'5ĥ8ck8!G&YŎ/ْWfē1egn wB]á>hJ`{&MxP!uHdnkQ:0wh'QMa5 h:'jꟸ#UuЇH!|-d-xW)uG.gіw^|]1;{/'k^'^'lr5_}lvt#/@ӌ5@| 0NP1VPD@48+'HQ4FB=؈$28@cHX'G;H~Јa2H#6qCINuRDΉW$E~id  bP1umD4J)ن:9clHq@ZF5@PѡfFZωd%5 Knғ$}2IRnNKVJV.1H^鐸#fvYL !bf4yLA)3a #60jVDgFţOzs'O~hPjEPfӃ QIU+Cچ˅fE zсe!mˆ mCv1H)pS ^+D0 qU p̌4* @k;&W -81!]: ֧!p"o~X\8c{Plq r0ɫ`,6¸I3AGTx8`A)r`Op[7( u ucU<{WJc88p8,@@ P-0gln& c*7e'0D@ fx\e2cZ( x-A2yBg DAQ0+EY;:AB @ ECWzAfZQǧo1YKzAp&KA0 tM=k)F Q\ֿFP:Ɗbv#W=mjWh gxv4 i oQ}ϽnX!.=eCUHo! wF'7 )lb7Nͼd"@ 0 C8q+yȾNœUnnt-|ayā~yx]23p; )QXCy._d+1wy<7/m/Q?yǼ\~w~-Es~ #vԷ+ge?@8=UV{K2}9!Jv7$2/U.0i>p"}7@?#w+B|~/eKdId$@D8d@k L@]$4DTdt !$"4#D$T%d&t'()*+,-./01$243D4T5d6t789:;<=>?@A$B4CDDTEdF?)G* @s@HDZp ^^k[RdBM$ Zp8[AXXEYNE\`]HeTOh̅bF^FO ZZGO,X(ltGCUW(iRXG{{G}GǂH H Hv<: 8l <ȊHHHȐHȏȒLI$ITYȬOrɚ,40ڀ؀IICR ؋JɕЀ LɄҤLPpShЬ|DTʇ ̆MLTNM}# CN,)ʬLL (JNNMOϗЃ͈8͆HP J 0M ͤ+ OX\ m X#PmNpЇhxN|u}QuI WZ,-M φhpPĀl+QHRDZ!"}mP%uL&5MEJ1N8mL9]Ӗ@RraQ7uU @ґ}q:^#)RTpS TBu'yFEKS :TTJeRHŀ? UW?uU(!NU&ŀW^ ͈R=1mY]SPeU@V V&M՝@VAVTkpQsVTou (`tK{u\ |Y`8E S.~`ؔP8[!,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\yR˗0cdI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝ3TxU˷] LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(`U`0&!C F(CḮf8@ Sh($hu;0@hI窂33V*&' œv|;n:H'V$3oMv`\~@ @\1[xfL{\u $Exҧ+|E `"mhk!6yOҟ r[(,Q7H]6I`ξRSJ R`lpP 2'xA}Y %P r p͐lx8H2q`697 "pwq !̔VP2qT20 Q؂=v;Q3nᅒs1 zabzazzx/ x x0#WHXр&w{xG0hUvP3w7'a&HghHKHj:81vX (X#Oçx9XXN̸<:QΨژcMq푌1 hY8U過XPIrL0E%:JVm9)!PBoaVs"9$Y&y(*,ْ.0294Y6y8:<ٓ>@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`?Ƞhbjlٖn p)%EPts#δky6{ٗc | W#ib3)6٘J @ ?CHy5y5ؙ u  Isٚ<"90^I0#y/L S0U4 /m"̙.3"j:i/yډ.ٝ-9¢ Pfт)-ٞ+9Ry*)J)Zr ) ҠqL5"Eo s>#`cq]":)CGP |\2 P V( P 9 'R L1IY S(p Xn`b:4ODhjlڦnpr:tZvzxz|ڧ~:Z xwGYBkS~N2;8=$c A@izo%4\!ګ8: h0tj=Ra @Щ2:\m_p'wԐ,qʮ:%êΚگzڏZ&(r>3o& À0pCAx3ɱ5 @ $p Z1+ˮAز;!jBI=a#AQ%A#]1'3R3 **H "1ӵQ:WӉ]chjK1nUl H22z s!@ KJ^ ib1᪪P4 ɐp#Pi£&!cky1л; isQiFi@K ڻcۻ%YRBc%{VBR;%E %Eh$km@+0+a۾@^ @p@lKj @4!f8`qz ArrjlBE!dϋ?OA_M| !M 4FQ_-H cj 1@{lU si tLp0; XȘ*ڴȐ<*#1ɖPq  {1HB\_Ħ>i?, 1 bMYs$ǻ<"-$lÜ2i rȬ<\7|Pw`B#,RO% tC ElӰ0I YT#L0$B1uDbUB@ Wd RJT/uLwPKLeN`Q' Π @Ee IDD 3w,א Y&. 1hP-3+J`W ΐ S ;dq 3ϐ")@ ,`0FSŌ3( YHT>ϴq Xl IT/9FԠ `RUl(OM'=Șp;6@mGŽ}l p{xlP w$^͉ͧ` c mv&-}: n9j{/@->[ ieK > aFPm+dzN(o A|1q#|t&2}ChwD9pD~=v YuH 12.6 GˠQqz%z  )ay%-Le+6*tCT.P~Aofq! Y9˪z ܀| ؕN`!MM 1LdQ>^~Q`_}Qn~m`QP o UTU^ŚUV]~VXe͞EVZmݾWKquśW^}X޹ FXb?Ycƕ-_ƜYsbE=ZhҥMFZͭ][mƝ[n޽}\ōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DO WdE_1F؁k e1tґȓԑH1ҧ~G~JH p 6Ң& 6H1 1H I$ZI4j3}0O ЈE4QE%7d̊(]Ӥg6M&i:)L33>AJR7ZKOgF[U2+i<]GMig R'~Iԋ(eTJ kMH; %ttץ3VDuTA(aStQڧј%#c!j EiA ߏ Q 79v?X?V8V{/R0hmY9ƹ"[:&hohfZM:j/Jzj>j`;l?$l׮0m߆{A㦻;o"=uՍ#"Q g]'z]rdwߑ]ww*שx䟇>'!b>z>{ݯ>|IG?#O}Zsߧ?}~%a_hoD`I 'դc `@P?`A7i]AP4 U@Ѕl eȿr3!zjb9xv ADw(ТWF%vp0&Mыԩbw&07bF #^%)519l܎ bd@1DGh4:8a8#X '(օ`Da``R:' !d*uU^ށ/b` 3Sҙoe+X-[Z8"5 9Բ] gUIǫv$xI<$R_jLmpNjaֆlO 5EDm:.cPxcY*e{R:n<7 g9#"CKf:NߛP-< E_ӑUڠʸGDK0/\H'B2R:boҬ>Aw#͈VBOv\~MV;Ŵn)%yZ8JLG)Ӧk_\o%̯T`d<4m=nl}mqF6wKnuDvw7oyB^elj7h)^B-8Ƿ8' nWA(Oky 3ȮcqІ7p;#XxR ?+È_!л3 k!~f; y $"?)B8À!0y A1D°|384C 0iy@8ò>D`5ATIJH-Q\H iĢIYqح9j;c9%]Cy,#:Y>eڠ؇KLD@dPP;*SlTW 1hYZ<OŴӓM$h&A_0d<ӊ3ʼnF;T3jkd%!:n;^Ūl%vc-p*ZGiKj2eHkɸJw$ԕ>{ݐd+.x)γ}'z9vdlﳀVr_=mFHXu%~Y_a8ut~7+: & -U E82XP!(,v·$!R 8P*l9-(<!VS ьf a ,ʙnQԠ̩~m1n~s*,RҹΡ3;=g~$AۧEg͌&F*U-B{idVo,JM:;8 e>JcYj6sm]B+u|k NrVHO˞nh[ζn{MrNvMzη~NO;'N[ϸ5t@ DgV&z_sFG!`\4E/ uc)Â9֍ ^/1NݪNpkmtW>+MVuYߢ~UE-»÷SO2ߪs~U|B/S:=GՇcߩ~S}rK='%Gߨ3Qo2!|ϏS_ςٗ I`i ]?s劌Hy/ +Q@ t  ] j86ǀ X L$؁ "8$X&x(*,؂.0284X6x8:<؃>8V-V(]i D[PQ#Hj2gW^h [0Y(@fXhxjl*B  D1B^~_`r=ex08('%5x؉ VXtH "QdN Qۅp Pjqȱh 3~! :Dx!& C`rjЍP`D61f5mb]oƎ_0Q1@hYSF2+`E A˲1 +((iqw~% @ C#ZPaUrCl&R b pkRyT V Oѕ6TdG;0>mPP*b {s6 `& Fx@' Qs0j>8#ďA $ֈu4 pFb$=9#1"Y+ry"ʹ%Ҝ!2XPlԙ eh Yv" A@ݹ A)yBZ^Pw1R 24! )$Wl QUzzoy:_F6#Q'1*4Z4*65j$#zS:xw`y6(aaa MNOZb`+$ڥ^ٚ`"9=@fJ{Ԡ;k #Crz6eˀ@UIuyu'qJ jʨ2`zک:T2u ѨJh J@_ P Rv" P R׫ dxFjŀ ZJ)& 1ڭ:%  ʮS Z Űx:Lj7S JtZm; Z{ʯ!K;Q KV.",{*37%K⑳a@[B{SEGkDұ"-;R;NRH{ܑ\b;d[f{hjl۶npCqr[_jQD~6@ t ˑjD[ yKʑMQ;Wyۺ;[{{ƚjy;[{țʻۼ#p;[{@+!`ǽ;[{蛾껾۾;+%_b!4caD ˾;h5 JQ  p AxcL;|; P ^Qܱp(b_@#% !|DLC\G,EL$%aȡT\V|T3%;a! Q.&>qIYH||ż($A  ڐ l#x(qZ jW۠ jʔ I#TDL0˴\˶_˼왯!PΌǼӐZP||la]xeeh엀(wvc0_X<Hm <]M^% 㰨 ÿsѯ&_;U=Lݘ%] aZFVV;造0' pwLbp 5נ@E|R@4ʡ3c 'Ze-B4 jjyLv}V}z}# PA PUULYcmŷش wx}٘}@}6#ALA=` P ֌̲=۴y`>UM_ ||ɨۤix YMťٜ W441A舾MΖ.ݘݙ~dl  c0ܦ..  P٠3 ^/Nĺ Y 9 O5؞0> }<ܘly( Nޚ^̞MR]-8`2.5h=`=0S `Y9> =lwˣ,;A< #,Qtۼ 5(H9L<G˿YV:]_X}Z_f_hۍk N,މl}x"h!Kqsék a /ِ .e~ zާϮE7t'FqU 4d0vx$6uc۩A.*+ O{ڨ5]C|(gFgZ#0c9FsYlʳ NHIS #>7яΛZ:t5=K/ț-)L,?0>6D&i[0[JZ^ēӿviyF阇` c ɸȄ(^ 6!#5Q":[w[ SZFw KpH'.^P `B/NfBfN [<6)h%Z#z(q pr4>g<NxitH~:q[(x%Q!o%ɥ>=|AIy7q\C pBa !'1B iCBx)aC<Z Y?ݺ.c /&U )pD?` idz_xJl_BZEG.!hlkk%JnJZ|A9CZo{GP jT7UDCJlҐf۠|cp͇| D]݃о`HӋ, ̃c11 #yh5 t;9 #ãH[ȃȃb@* +< 2lhp<[?\@txx== pW(BA@=?Zsc@)D4* T9n{X` P`EhZ30.&`C-0`0pT H1ȋH -G.XHpȐTǕԱ\ @Gq$Y m@& ,@#D3_J(scɥA;:ƻG|"@\(Þ˻x4D)Ds Iʪd `&0ʀ*M3䒳L|J³%bP ȔL #̶ tL ,ʌJ dM"MT1ClڴMzM Ǽ)͒`E ۠Dl̼APL1"[ʃdJ1$OO^ ,4\t"m腇p"ߨ}X]~Lye ؘcZK %:)4HuxSa|H`PixlfR`h'Em `ʊlЉX8y HC#H,v4 fJxSlRy|Ù~ɋb~Їlh-aщ }X#V@lm(bu x%&] Qc4~Pmx Pxeh$`MTp&Yp* qk8x`xXP ` e@Xh/J0Mxo08NxoN$H|xH^*khXYx>6g=c&Ђ} 8\%e``OHfPic25Wk0UiXVApHtRRPif>p~Ѓa0UxY8γ9|TpW0Yȇ|ЇohІ,P`h*k@E`(`hVXw@؃xpg* Hrf/ܡ<^xn+@d݇'XUhhb=xUik9Rsj8ˇC0`(gx(Yhnk*@Qx*XHX@>d6>mxtX X}$XC lxGSMi@Hne+~PUfhwT8ٖ'CYf3q&~wHXPAB~`-,$_Xy@,Um H gt`oY asHYx}kys8kf%,C<t?'Hm*H[% s pz|Ђkp(~A0=0X@`$Xpe5PU~hxVmtc?I  p'߹b*t5P|p 0R'pkwo` v;y7f$C[N?dk8:0t'e女BRwx > l#(txRpLke%wlSP͂SXxaZpVHW&Xk`)lynp Y&:qp0M@S5h<0QwgcPlxO<` jPRXueM>ph(~o2Xn`tNQ:-f P" p Ď視:XJp<HY(HpfV@pxx 5mU=|3xh56p@xЇ#|H Hچh6JdN@JHYXX@< ly,h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*7.iKR%xI6e֢[>iI lɲi-`LŘ:M6_#<0gsAt8~8+8;8K>9[~9k9{9+]襛~ޤ:뭧M>;װ~;/ ;<+<&>7K/?` .?(< 2| #( R 3 r C(&!(!F<"%2N|"()RV"-r^"(1f<#Ө5n|#ؑ^б#=1~A*/{$$"E2|$$#)IR$&3Mr$(C)Q<%*SU|%,7LC,BLC4"f,HXl*$d@ Bf $!jAMJ 0VcXbu D5EVğM) o0t f)B a4X@A xBUF`'A> ox րfqD Y-x͓ NMAo`)lD# @AhAh Ei(ѿ xDQkb ( J’d8}pPׁ@ؐ\$u4(DBJt:Bwªp\C [s]  l**-J_ XR3(j`ڂĘev?I3xaZтa/K4--` F nBK -[-x1G"E[DRk^׽2lF)L ͷ=0FW0p0,aS^vUHKU<,ij&>1S.~1c,ӸƕfA&@f~*"<ࡧ־‘ ٿ?nQ%]{X$4#0M#&}L%`V<Nh!}/漹#E0{~>E h"$ `D 8і^~ctDҼ9f !,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\i2˗0aI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷p5x˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f a㩦*C* a@?1P ˨4*ok֚Ͱ:Я,쵸q @ ᦻZp"A$8fn|{@< @X#j00AFg8)\P{|g\o7 4&2A 7'53:mkBߐI8yL@iM'q*@.H#o=7!C#ȴv [K$8MbXЉ@YżA-,3ݮ {}B60 CД9A0)@ԍDvG$AXy4MX/\c*a*M;ՍsmqP4!v&AOr+R 2t.7)@:sC;4s3P3ݘ"C*6ib \0c<Ӆ ƹHA `l@Ht(̫FBF.La,bưcVx&> "al("FL"_&…NZ(*VX.v^ V(2ZfL#T6:ncR(:vcP>~ M(?1s !XX@wT (\xIN eG0)Rj/ PR!+gT2Fv\y##^HȎ-ᴽvLE+MeI3`d5_)dC|6Mp"r#<<7N?v Y@NӜe=)yO*`g(SS$BЁ!j14 83QCG;z CI*%8+X@1f,mRTdȢiN4`m06VI0?ҧIUo)tl*VJ ,%fƵ- "f!iD!Ҍ42 U<pn Ќʀ`/AA(V -pB ߽fJ̠3A o{]#fN;'Laɥl  M5%/&m8}gL&č[,>YdL"HN&;PL*[Xβ.{`L2hN6pL:xγ>πMBЈNF;ѐSI–6|92my%CmZL]O%LZLëYcɒXT]M_%ŞR`ݛl(e"͖Zi[3.ݤjsM8>n%K:7u.=$H7o!@7}$3F8".qQ0xF2U7HSن;HB9Df49vCx@`?o6T)뤷Fdyza@ ʅ R|hOpNxϻOOƯ><C~DSɭO9Ch:Lg>O4@{~D`@ !qH5&y>/?4F/OF"$C hp~avtBةvxI%.5*v+O?W:8 ȇ_&~ ȇxhei` Py86*2XlsqY RyTo@A`bFV4crV;-(` 7H{#Q}2 \ A Ѕ^WGc V8(Z(b(҅) . g\ Ї҆X6X1'1'.@E{VQ豉dҀz^Xx{W 0s Ϡ ɰ}  7ڰq؊zg xpb'Xg͸ҨXqhڸэ(1x쑎 '؎W g\QXҐ p2Xv(X )T!MtYȆՑ XU8,(02 ,6?;  @TE/"H PR9C)faԔZ 0_Aq_Olnٖprɖb_uyExqٗs~nYe5yYG4٘vIh,ffZxlf-q Ո!uyjYy5™ٛ9YI1y>1A0u bD^% 0jAkB eZ΀ es BB75A՝YDI[ SYwE DL =$5eZ jD5a 0) kW EP y8Dϰ @ عWL !ME*zv٢  Ƞ7 A驠IjFHQyPTĤN[1dbÝi 9naIif|:Bv Jw7\ ʨ1zZکj:zڪ:ZzWq@bTɫ:ZzȚ63Ьz ZzؚzM:Zz蚮꺮$ٮQ; !@Ⱄuگ;[{j ;&԰;F& sJi ڱ ";$[&{(*,۲.0Z1P#Qy* `9 G+o{3|۷~[y Qv fG3ˑl۶rx6ABk[mLU$*ֹAAi#Uy;ΰ\ Ϡ28 :3ػb 0˫Qq;[7r1: ɠ=Y)Vt2H {`!4i[G@ 0 6nL}<\|1z% n&0 [y1*<+p!1 #Ž?Bnf qU& qz(|>s7Lz'_`$:|eΐ;"Yr ^̄^܄^'/h Һ:LЀWzLuwǔrn ckA̵U;K ˳Ba A aJ  XK%|栊X_,M!ܸ5L,1̪Ka!̛\ (%8ّ1] U< d< v, !e  Sby\̶k M,{6<MM#}! %}`;`I5hQ2΃̂Eh*L #eAӥCѡ/$L YT+V{xH-4 &0 J;۳DmrY-^bJN m`+xk]%@ @ N@Ci=h׀lx{IiA ГQ ']y2(`  Zuى=@ fC#8|js m БfAکw-wm<'Ѓ T0=ɔ׫f HxMFLC ŠޡC v dkQg ьm!a}ޱ ݑ `F-M\ BT& @k?c#P 0㯐 o Z` S@>a9L`x]+))  M `6gΒa<:  xQ>Xd~wfՃ(`QN-p{udɬ= 1 ͬFuO `p #Nw{==RD ⰼ!GN!3@ (`Nࣨ.h Ɛ !&A >pa\`6b拜]~ $RwP a b ,Vs)@mP{o* Ξ8, - M۠ v= zIpت^L aa`] oݍ1oW>+~ w(2 _!5! unO/) ^U( @ !Оw? ]hjbP_\[jde9-X_A .uZfoyYn?꯿؛KQ?u}L` DPB > S$^ĘQF=~RH%MDRJ-]3g2mw M< TPEETR4>%ԇQŚUV]~[iXI%VZmݾX)͢ X`FU^bƍ?yaɕ fΝ=-h颒/P[쐢I+n[pkPōG&i57=Yglrݽsk}yݿ/*|Q~~$@D0dAХ#B /İ 3C?oCG$DIDWdźRt1Fg)k1GwLF2H!qH#DR"dI'3\I)J+2K-4n2L1,2D3GM7߄3~⤳N;3O=O?4PA%PCE4QEeQG4RI'RK/4SMܮ y4PCM\LQG%HNK5O׃պG=WkmuSa Z]^%HU}S^Cv; Tpյ ~sU[Q%ܯGdgGf{ GkI&t1kdyŷ~eZuxmUdGlgqVkgei6&a≗ev37fG}GuQu~g}fYǬd&Of4ub7'^'GgLqFez 'd j3mo*%Wb`'XRbVyHXbYF|"*X<1A ek?V pN &ffx@Z)h㿧^NF0ny6xe>(x Ik=XuvȚHD>"Hx\h> ۩p0\QD(C J@l i,h f M,#Ca [~ )؆5'TT0xC~7L`#b\>p \aAQdlc5q 1 x8a >lBD0 -"YLHA%c7Bpdb$H8 84067'Zi;n lB6X2-@V,@7pX8<sf4?MX q- JX: Vd PMLt"DNhq8C1˰*BPEnDP*XP-0)d!?JӣBo-`f XAC6B#> yXO'oh9y .P@ %ͻ B[ o(HպքX.0I @+"_# J0 P @G4H)[\!H>rRư$,P `e J0A0+&`LZۀ+{x@ =S2W`C!88w$@N  x lBx]@ y.6wD a@ (*Tx!< @ HA9 o Rĵ=MS&q?(^+ )(K$a_GdaRDOX_CD4*Ss`Q C<'+[_@M[tYWhȂeW8;2Xx MF _@Gl|\[]HᲅZZH`$^Z{ L Z(_[G')G$ ,[IY 3DA!ɒLS(yTI,GxXIɜIɗ9 7 0??`8%ʪʫʬʭʮʯ˰˱H-0C뺗?`8K9$ICbKD5$\ SػM QLdJB{LL !,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\i2@.`ʌI&˛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ L?I!$Ř6˘3k**͠CM4PL^ͺװc˞MLlͻ賈ȓ+8i`GKNqZ[νwСB=ӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,! 4X0/P@ɡ10 d)P*R BD6C tN)b hyߘ @j)g{ , @0/-0˜&j,YvP-͠bfz-B˙ b /hjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l?!33M8#2@0\P *L 5,|5$ܡ+\2״L20l?lr9PGIOGD$m@Vcdcċ-r6 Cp|6ؔmEj2ڼ 0 ݄}xtn8#nC](ͱ N+d-z~yqG.9儗.Atn{uCD.@rr 4yO'zG=z@|@6co@C3Y_B8Ua R="#cUǃ;  \2WP=~h(Hq\ns@P! 6@KTd7<:0`pYoxR ^܂ԛG8?4JL8!YdC]bH @ IGq hm,#>dKK"C8㱨G q#dA\r k&h"IɮpF<!=I?AfC#J2I:zyG:#@%RPr%IS(U gdf*/Q)O>y`D-+$ЗA͙g~_`CG@JP.RUO* 1HԹY@*E/t0vQ[#6EvemĥJmPLH451GU"Nר2y?k-! ʈPR^ Z9~:lq(%T&EdoUⳠ mh1Ӻ^,oݛPֺ35lږ7nuv6pYW5=rG:}ta۹Z2ͽvRz/xW.=z-}o䠋դW;eK^ Ѕ.h1N׿eE,UwT}[_H-a< JCl` I-8Qd1JEcVW@0Z~ac3b-Cp|hj_vЃҤnek5z@!A 5 :iPlԗ`/ յ dL1Қ(P9&b%֌񳍂<‰@plNeƐ8T0zQ֦я#Hc |//UG1:nM3ŧ-8OGFqzׇ3D`8Aok!n Ş/ѓtNԴy Pth\cb/_Mv]:)#C ;ogXz߾x[! ߝ~p 0nW// 0#e/!+$6 =}W!S8FwNQrgϹ@ߢEs8g;e41~ 4A@0a!~p7XssX&t6E 8|CWSAV&5&1G B';j7" y p |a 1 =x'"-E~@PS ՁQ,noЄ1OV0rR8T$Eq27i Xshu"+9Kmxe@tWau Z=$ P) Фg@!   ap vPOA%aeCQnqd 2 R& )p(P P_̨9{TuSu]0xxݨ/((Y:BmQ `8pSyJ7HvuQu(PuVf c8Xer̘xS %!GF0 ^9&wH&H0ҥ4Dq=p!tYq:]qE"SkuPؔP{8hᆔ”E yQm41\ybwy v!} )tf !逖׀ ,ey ~yq`mijYjrECA(9!V?qf9Yyٛ9Yyșʹٜ9Yyؙڹٝ9Yy虞깞ٞ9Y ͑Y6p Y: j9P dJ6 Ҡ 8D  0w1 )U .z~* U 8`}XQ*0T T<E5 @zBj FZ1E. M|Or&E*`T @LJ[JBQ2:ɐ>b76g )>k7rfʧQ``PuBI99! @Bk #*'O' oj40aɯ3/U , /3/{/۱ k/";R&+/(,..2.4[r8k.:ҳ>+.@2ACD,Fo nOK[,MLp6R Q(xg ͠n hXp(qr װfQ pdHM%)QJ0 طO& Q j:# e Ǣ!)Ź{ۺ;[{ۻ;[{țZ¢ 𐫲 KtX0uK( ΛQŔR p 0{2k{% {*0Ai|} #`| /; qn^K5g*|,-.,2<4\6<6B7B%l!>`ckjD< y M5/U{hju*1~zl<;^s}RaDzp~ٝˮAPPs !u^X}kњ&L3jAf1.Ι9A3.`W >Iae0@!92x/ZnY!ܞ`ƣe}@0fԐ)a %AsVnZQ !pb>fW4 `SW6.b0 (bP"ꨎ>N>ap^Ǟ6q7P Bm{ӣpmQ{*>2(˶fNn^-"i ӎv&sl}u ^vQn!F@PB{1>i~W @yc; qӐV];0}4CB )Ogs|)#}\'eqߦh ׀X`)+@, ql?YkqmNm-q? P "ox!T*.=ti8MԄ5f>~/Y[No&=(઱ 0} YBA 2B^jSR?!+/[D08p >QD-^ĘQF=~RH%MN@q']SL5męSbhI\pPEETRM>UTʐV]~u]ƂEVZmk281[uuX`7Q[XbƍEdʕ-e˝=F`7ХMFm2BS#'kI>Ɲ[7`r\xY$4\r]tum7o6սOW/]YGi6ݿϨ kǟ_~z ?D0A([p1oA 'B ;'ϻC?1Ģe>1EWdE  tFoqAg!s2H!H"G'#DkJ+|"TɘĒ+]0D90EjI}ɗg}Ҍ 4ijO?[7,ny?G!\4RIssr,I23"q0Ǚ#&IzSWe3- '8jtnMS2գRUWaUM9ZT&G~dSbgvZk 6J(@|l" @ȚZ۷R7_}6b+~M8h`a$`ÛPE4k_ոc&#p' hZ^0MH>coƙ8lix7$i Y%lVi_AH1dI!Fe%zd~Z$F;\GIxXAމ<7"A"ZpfyeGO:q4o&$`% X&%$:!!JYl?ULt9nJn蝿$yp{?؃)Ο(tF屘&~5t>hM8@ЀD`@6Ё`%8A VЂ`5AvaE8BЄ'Da UBЅ/a 5kІ7t kic8bC!UFD#6щa8EDW Q .vы_|8FQ#5$cȕkocF:֑.ckd F4ѐ GD6ґ'AUq+JV#5Ɍ%(+IR"@e*UJSҕAbY֒%)%J^CJe0^!f2LfܗdD4) aӛvf5Mr1 ʹN,3kdg&\e^!wr*Pe2f2.gNsz5e7wBڲg>]$$+uM|x)f0̘<狗"NwӟAfT"ER-CAS I*S7uFc"s6x`!b>LU9Dv=mjWǼLb'!4q1qgS;&[cE|ꓷ䊹oc ZA1pɸ3l4|d@q;4fXu9W<&'y80,V+yQoM)3!zgu #\~Htb,yM!dG>ޱ>Aa:GMuo;Bzw2g^w9#vN 7|ю,,Ũ6ФǷ G!c8}Sozӣ/=;O&z}~/<"bXR#I5|' o`D!:O=va8f zGz]b `H*j0ؽ?ރ+k_C {qN|78:yao(YbD`3@us.;HtOຉN)<^ BA45mAZ!nyᢅgQp< LD|s7@)c E$ W$;%Jq EH)sc[eLi,.0 }Q"$0p1\۲QwAL!5uF6@44hK4hg1mdȄ~9xI kľɆppɑmEAÙŇ@SDEâ0dZXAX3Q".{cvÕ9IyI1z C;QK}qyylPqRKI{kEY[7`K_l x Ⓠ~($~ȚIcI :FdAŁqBi\KPܺqplwhք@st"M4L5]F̿C$LZ4ɆLC{@$4H‹=#t=p DHxTdȻ~lB/v dAKI؅]pT kȃ_[9Dpt dJ9bJ(9Pp,h18e!%x@i|ʙ;yLa@[A9t@a",$,URe[Р,PRP,H* 31R5S 4#vkӉjeIR>Ey@:x4Jw K<σh1LRxHXJ&5R͈+'d7!dUMbIbePXvU0emH8ѵISm"pq y b;Ag˯q@O!UdRud'cu@zzze3.hQ섈.x VHjĆe؆qdkR˾O+A6(;7Xm< VcM:*ZI$2UR+KCPX؅b40%5;P IPQIQPtQOOPeZOhZM [M || ̓QLWZQaPTK =dōPOHڪeZQXERQZpMPɨt\X]qڮmڧک\ZM][-[U][utx\۵Zu]Zuݱݰm]$[P`[\̭Z lTHQxQpQ m/Th̽uPؔQi@P@6Mx߃6"%v`J`^Lk@PX[QPCMv[5cJ0lRRyPO `PQ``x\Qi%ˆQx_R΄QhT^T.bqUXXƇh4@H3|pua|`?0-cbJiRlhd2PJ``_ed1Z$PI#ڏ_Qxq[43|QnϴZ=`uZq^_s]tZ5 ݜ$^ڕZMެʼnx9|]?XPq"0\Sf]lڬ]^ }^$$i^y`qdMdedU`|uܭ\Mc\q\΍ff]Mi~~O]\kF|u^t ]i{iiiMN`^V^^bjPWȚ.xdg^KfwPJiIZ8Q8ΦE\`pΕ\T`^"^k^D.vo[xM0TUJbdK0)L@Qq`Q >bFa.EZu(R-Vۖ۸=dž{c0 6x4 %qUbUڠ$WmibayQ@qEgk}dpd.dib-cxp̈́PP62PݴT^]ڬhpMJP8`.>f&f5fb5 g~fՄLpqgg曕D;qMtЂ3O$. xD=@[ikkx!epC4v[XqhTcl[BOFs~ۼv`c<»ƄTTU7V!j!L:صL{Q$Ew8,LdAN-A;܇ۡlb\~m8m4{E?7 B> 4,0 ( 0 zӅ$?}#O:NE-uS<$r6St HI#"K$%ME14W4VQPZ6܊.8$͘⌳WPWydI0t6 ƏG&NEjJه0&:&ԧBm}N?oSBYJcI|p^ nF)GiqئKXui$* iEB|v) ~#K4#Z2A =4E`@6(\rjOaTŠb`3 Uh0`0tD/G٧<7]^^+ΒS3k9#t }P%a8J( HW&!w0Pg1'!04qsM?aAi .7!(!׺S $,"aD89Hqc IT.fYRXm<s ;=#+" )AGTVPeR5zoQ d<Æ_ #()3'Dk$BҲ%.9%H~Rx9VVAVf8M*ֱf)/} L D )q Jn,41h/('#8,b{Xa.]_\ *R ZKZõV\1$^tC4M;^X-nّU??HH 81/JU/Iy<JWC+-vh+!)~BTeq \Ӎns;!ֶkt8X6(X-p@z)K:COzq돨v2w+Q8i2J[v2d܄x˙܂4>7as0| Mq3NOЩt#5oG>sVׇVu6zӮvkW\v;^g]Ê]kb)3XQnG%ǥA=_bj.&oUo:US+ ~ 1>[n( >sF;jol_?_?lA>`df%} mk%!F!I^!`vZ~!!!! ơΡ!!!!  !!"."#6#>"$!r`$V%Z4\&nYC>, '("))"**"++",Ƣ,"-֢-".."//"00&0\u\`JDD_3@dcM1cc<3F7LXʗMIT#E6lHsQ:8 E(aGaèchC8_X0lC{CDQ3$C83a8O$0EDUU^$B TOP0 &0$C>*(!d6|0XC3*H$7 $:|>L@n7|2X9B EC++f@%C 78$0 Aw't* B6 *$7(,a6XEBH)dbB 8|+7 `:@"/LC1DB$@@6ȃрC)^f?C'@),)i7*lC3,|* ?|*<*pC+X@X,a@C'H0F?|@P T3 D4l'\);AzR0l,,:DD@$/ARkwF *E`R3k 3@$@@ $@0lB0l-8@)<ϖxt0*7(:07C̭3 !D0DBq@T,\;D@714ؖwm6TA3D+'@(B`Cլ SP6+tL&+B,PԂ!7P`dCx, ?L#$0HC>|CGgsiB B+\) Xl 3D D-C= \4hA/*C"zC(L,6/.4DK3DC>?0 p@%$ t@x@zB:C3p3@h3O;7W7;L>I2pd2jC<C:`d<\4Lãпz4lm7h>Dgu?XBhd8.X6 l pFnP@%%dW7Il\4<83,ylk4<(hJoCvxI DyFtra~#~/>GO>W_>go>w>~8B~>>үǾ커+4>3>׾4?~GOC/L!2 1D5C<?1X3\ ?% C}0L/'D;1?ÞDu,d@[/Y-aC!F8bŊѰI#GSʬ}8"  2QRIƔ9fM7qԹgO?:hQG- "L:1L^%tj B:dZ Z*8$ X8h(Ck:SC!!|s GqG ):{h I:!h(tΡtf<և(uh񆮆0*r#`? N6sq30h ?R%,1 ׫B;ΐA :&E5y@4#"mHtsP_#EqX2q`4c(hdZ@!,$*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0c>a8s.ɳϟ@ JѣH*]ʴӧPJJuͪXjʵׯ`Êm*"ĂVeʝKݻx˷߿В a+^̸ǐ#KLyW3k̹s^UCMӨS^ͺװc˞M۸sTD̤= Nȓ+_ṬK7UaR.s|aTN;hI[Ou;)(%)>DAgQv * Vh!_&ۅvo ((),)$&t4h8cB- H! I1&C*PF)T@0+(V"+bdD elIG)-u9Zm Y"i="(6њjG6'X "P(؄@ĩBgHi!ꮼ$4ʰ+ʱ&6F+VkfvlC" | (z |"h, | "k'p*G,Wlgw k/Cʭ~4( W,*"g8L<3(@qH'L7PG-TWmXgmB DdBkH[`!:md+4|O曾" b)B* y#ɿ I'T(-M砇.:ߚx>騧ꬷ.n/o'׮DW? b_e.4=fB?iB/g E3,Qb"+D"(@ܠD{̠;D& *-iB!N $"h A C|!T=!:2DH7HqqIԏ`TNcХ@CT HoO/ Ca X3H)<4C# EBh &L*#FBh`BfUM1#j- W$a[U:E`ZB{e`B`$D 2v w @3bM,X2A[Œ01rQ c 8Zd (4kEr!…!0#.:[({2|q _ }-Жuh&Bp!ʄ{ڞ@Nj[4"?mHta Sz^PTJժZXͪVծz` kbhEYKδ$\JלBky4׾Jp_KFd:PB6aVZs0f`]& Қ85EHcmeRYHnw[W ndȚ Mr:7ttKנ5K8ú5Aؚl *~d|32oE/+"&0|0y0z ` 05_xp~E`Kx(NW0gL8αw@^J !ez&׵-f1 :_EZ`a b`,SeLh*2jz >Oi3U'Q]Ojg\{TgAڥe7E4-;R/t/]iKs/CiԨN[tկn+ktָsΣ߯=X@w36dкYE2ax,1ex5 7_%`z@4< ds3+1Н>لA`$j_e4 Ed! ~{"@raw# u9xZPKm+P '# $D 3( %𵋐 #WαYF# |F|ױCyDT!ty4]?Dڸ WTȲ @j"BD"#ذ] d&pE.Fko B3@pix\"xE aL!2t E<>+>&E΋ Q חW?G a| sմ7sIooF 4S Ӵ ݷQ $ 0v za 9?ppmŐ U8'G+ 3x:{ R Z"CTK P }u04 `o h"  &r3&Q q 3b}G?BE~ a NrpHDs%puqx)P wPD}ATcgAmxrz(. CPͰG]R Ps w]D(  p O` ӨG8,U ,5M HPD  nGj? @R`}A ݇v Q~s Qv' =E Z jOʜXIV (  1%KJ):x d2PS:2x@J ` Ͱ?g=!z j ,{ RѨ5!*kٍZfPK\#Ch)^t*Yf)k!DZ xY ZP"zU&A'2p` 1kq87TRr @Pz`kOYzPQy#*6?]¯RN Q PQbb8 `n±8c68*"+?1f(8˔Ұ`1<0 QFYamXAk<^`Ґ')&]k*Q+*kqQ`Fp: 0΋s˸\bw0.x0V@m@CmX۵}p85  qE(PЅUB-0<0QA I38Jl 9DL;ʘkyp v ? w@A EС# QXL=0^:e'd9|!f` p“:P Ѯ wz:}x!qf!H<8pN|F{w}ұ :YNjy<ǫ?]݉5ar " 1< @Wx+ 3<]ޠ+wpBY. <P= ވ;8vp=) ЄL ݱSQ)@Y*0~k1 8ۻ=۫^=&p &18-^CB X/3O;_ˎ ]K䫣jfn85 6Y:``Fɰ pEL9Nvp ,n;!Q 1/s.%qGG`Nҽ<Np\@y.P_no^^Թ&!^2B DЛQ ~!H*~5p Q sl^w O !;,]0 q,24EFo 0Ȧ5r s8CqHP 1*{rV + .%ۑŸ␶#gЮI   @ѵ&"0pj{ s`@| HL @@ J`VIpʠ@]蚘QF=~@@)iP]xSL5męSN=}t6Ќ Mv'TTU?V +@ D @J+޽9r&+X`… .F \kXdďc,p Ăh"I-W](b=8kVlZ0R?.IdÍ,~\9˝ Ćm"l{];LX$Ҹ#P5KFX0 u/$@Dp'ln 9D C1f")XPh& @XE%%¼ۈqrGR iyH%;XXo  C (׺o`#+ϖ%?⏣3E2\S,N<sO$OA"F Xf bT @z Z P]jQS Jy5;]rM ^lQEQt67BCXg׿zU0`J:EZf5#](H=ԮiCRsg9Fdg5ǁ &*Y^y{wߞ708QuIU^r3BJ"ȟtbJG&yW]x"?BR'dɸdo9gw晠 GJ)Πq{.iiAri B `(&lF{q:l%(离n nH&p(o?>}˚r/7p~[Լto~POgG xsuowH;c}#~aGȎ{ ^#{~ާi;/Hvg?%xT AHe$ d xX{HF8O 8A JE %ť%F @O" )P1Ѕ"aAB aÁLO?Dǀ8|3$bD&Z_S1IQPx(,Fp"(]ogL$ 7CpAh0qI5/l4Wǁԑ:HINd@2Sl@~GߜЕ G2򖿜,8KQ̥@x9$_ә:&F=t@1 y$C##89ΞE%9Yy8, 9OS=/wRC̈<M#>:({OBf8)kt"aDENiVQ& CQ@:A, -A DKiP TR|Ts'IlD'Md,xE*PGs7 @4tD l#j5"`eB05;c\:j7d[`>`"0Blf |jrR>T 0E$R~xֵlYZ} 'Q&2WָIdcs$bN|F@},q&MS7wDٚ,ãAq-h'(U>t! !FtsDHnn-AL1ywi|rBpV4JvFdcXkvǣLjAfߣ ѧ qE@f2?-}| !DAj-V`~AӒ]hYg7eA (>`US!]pp>b꼑%9X<6ѫ@ר9?gǝ8Im8Oq^i*2x㥧@b@ki kpha !cA5+ p(,ȇs_HA TByY$ ؄“PX+ ip` iihK L98\m`ha ( X08U8ɘ _h\pC@*TIB9e[XsȂ0;RBX8V@YP {#WȏLah!ȔXG`tx Yx‰X(YEOy) $$;aGqH ȩx[ B8h4bFJ**7G1q4ȳGO_(bPTS:ȏySp*ylr{ CCh^Č-98Ӓb Jl\ތ*4CeA7N0U-IpkYFW{ep0(g>NT4axRhPcӈ n, 3 06+ɩrCSx)& Jb0L|Y{X>ed%c[p a8͉ DzCcXa.kjehBݏYlZ_ 䁰0oHbkki|YJiZhmxA윸 E34qY$XܿeXʌ0IɅ.`W{2n|ŋ ]h4j eɅ X[D1:Zhrk/i_)ppVK+qepoodqS[h  ]Ho6 0k Wq Gj&7Z' +Yܰ I`QZq12gBN} vTqM-td93OtsHIP rDuQGTw#u3Z/XS]'\7uZ`'UGsa7auJcgd!JohgdVkvu`nߓg_vownsrvtgwQ4ox_wzOz|'|~+jguxwj7GxaFؑic +H!1 !x cQ@9x@7n0j88'20/P.rKhns膂?*؞枣1ݠȆE/z}⥖./{/&dQdT0  '× G gLJ-nx/ rkh|xP$o]^͞v"F l *ehyP7 پz牖A*Hcvgئ)/`=U&0hѳLj(PΏv0~g-x,h „ 2l!Ĉ'RhbBqøP@~zBL0mȴ1摢2gҬi&Μ:wa Cy me1()֬Zi*pʃ7-Ɨm >7Sqo۝_ć ;x1Ȓ'KN6 _y1)G&ӥ 4qԪ)NZM0TAؠ b:xB8P`J 0[S2g]37'P偣)zPUS(6/o|]@6(,Zhx^br27Δ׊3M.Ԏ;R<#?iC]S9.YZ/  nMPxa73+>d`א1AYzkJ2-mB" س#N8G& N%uPN<AR9-QK=u7"jq1bxNP=G)f3 ]\`<-/q= Ptdxt _RvuDfPoɿIP Da$Fg $q> ӷ6Dl@= , >k(C&]C $HI_:h<&4!Lr9 $FnYn ći1c@c!f3v3ڔ&Yұin}W+O)rjEdyW s}abV+{ d#2"uC*ĸ5IoHaqRdlCb-np[vbu*ܶe#u+B ji}c'Še],N$]PMdb=#ڸEz6tU&b0{ ʷ#09; 98a, ~# ;0%a sx.0-Ln tC;^ mZW,@׹3qjL 1zqal}'%1c,kS.ұde"A\+'cS҇ڋs喍\lNg\ϔdιeL?^(<s`;/yFsZàe`&#:.D`QNIF!=dCd,B$&5G28H#Ե~v܈Md(˗ҧ0HfihSQx+bl W;y| p Jn7nVѣLUC%p qɝ疍x`, 8bo k$/De<3cC1nyy0?=%r'2iv/^kr}9iq>?Aᯆ}9/>/7>[xHïK#yg6p$ QEQAj6h8B."3CI`h,a& BBdD :@@<& U/B0C j`,,@Z@VG HYA`ax^`"!C 5J$t@ Vzȃ@AA5?0bAt1n>'łHFE?44L̃&hD]4"ATLA?,OdB$U .DH/zIdB-H?La1 $OP` vN$Q`PjQ.%S.#BP^ eS^%VrB6UdVXJd%ZV28C/er)Z%]^>.V\%_FDBd\%bj`B]Ka&dք.Qu3ܣAc.BPdb]x&dkHȃԌg*VGkkMAI 0Mp@@AP? Uno^g5DWD< AD0E\?H 6hRA:M/ GDbUA&vA,*CBcY@4B@7$T8@AgN4M`DZ!5 '@HCH[EAyA,AtAp4Cd~h鈊|@{2@̒%A D>aLA&D :P^D̎~.)bĄ6< A,Ö@$F@@cR>i7XaIZ&B0Ae@ ٛD\z3/FN/V^/f/:v2V E/h///Ư/֯/Ca8A-X1|[B'x?:HPD0Kenxɕ1~4xS,WćKC pA@)sSLk*D X@Ā|#l3.M"J)AZŪu @{[jb8?=zso ,P Olp(<ʺE 19co> q0J EY$4QqQGF R!,#LR!wl')7:R-/ S1,K+LSM\7S9S6S=?}A -C-TDmG!4E%TM9OA UQI-TO/MUթ#(UauSi[q=U]_Ha-cMVemgM6ikSGmo Wq-sV]:]wWްڝ{W_X~.Γno\)ӹX9=YIvI KNYYIXY/g)eYyex'yY~:}~ y?|xRGHx |'}i5˔/H(|iH@%@ :Sz.0G%|8G9Ƒp\81yCN8 $I~r'3>̆Z#HBt#:K"/TA,(WZPK+7HxT"ChC<,(kxںe-/N,ml6XFl ,9`tsd$\1>NE[D] =.ry)4#̄(qQH Ȕ0Fh`Yaսp/*\ ¸ <( xL-Y=vWQA5:g=-5)J؍|U"_mU~-`$0V!b60{ x!!B@>` Є$ T` +7$BT, ? 1 l"c8 `9 ! D@)k P`'L (hE(l#DO25>VNgg1f Wf1#f__ *@ ((CR@}tafԅqTgQ%*U!IJ Y  _ @PdC5D9P1cChRBx*,cIaik!$}o۠ݶZig蒝egEN!,g1Z 0]_a`$1|&֝n@jNN vp eǒt ׄ~C 7!\`[3~cN[8CӰF- IEV!{+}%5]Z q ţ%"2 LM郏/3g2?4hC,3st<ӡ^"}@/fcaˮL$8яi,R)]`#G!Ni!źYDDoD)O|B^&_Q&"~ $E/Ώ OO0!b nBO|O!Ȏ|R' HHn[m[-ݸ`HD2!hLB N%P¬ptafFp20m A"ux\)ԋ .ǎ%P4k NF(P20F/ᶥ`%ִ°[  eu$K?[ jB>רP2 Stem  @~܇!ab[(&$%`o1$1Uj B%Z'u`guAA[rNciA 3  q'̀a !A  C!  ´bA,\@J\ !Dm % <L[AaA ΕM+Nd.:&d2$4%`؇¥r!'Dt" ,k*0̬ \% M$7Z/ " **kW FF DGRf jR"##KFI./%.z(!SRyy'Sc!2b0 5b$0U nk F"%͊Ih JRgs;(!جHs=3!aA>!lr0cw0(Чp2n3dr vn& ޠA6i9.%"wZ:G!;DD(8MaEEqӊSxq9A6?Խ _8A!0 E6g.bz!h$".&*&LÆT"!?tM1HHM0IGOh7J! LztDKsl@Bpa>PSQ At\ M-24.y tB@ BQlFfX4>"!g('/uVu"SAN9NA Bj` 6%@Re?s(.eBhYVñ,3m l"Y FQXR7dZu(@*j  |b)R` tA&&]6(WO!J!!\@WMBTHa4TVG|zπs``%rW  jA': $f%z|Bc%c+c*u 2!z! #!u}Hz,ffu$\d{$j ؀ 2,!:Z3fJ@]s:TH8uk6liV$\3? J"X 1eaf%m+6*n 6A@BoW!"nV!a*T% @ B Pw2V T7^7u%ZWr"WN6$w{@6BSQN[8%tyw t+X6 lg  qoyb@G/7{l{{q$ȷ%$}S~@~*?NUB Wz_ !rKp8! Plr'BAL.dQ #恕2XUlw] "g[B3Ȩ Ho2b B,Wۋ@U#~ Ax2}x # &J!T&!`qbX2JahzFr(4j  aה:n)c'\ ʀ 5sФw~1;2¡AA!2  r !aV(BC' b/8 bDhCvW+7lv ̠Zb⊫1Ɓ{ÔՕ׆&$%-p5Y@cwb)U!:bAy2P`9~$Y^䩧T%2!"Y2A bzP2F5oyx-fzn0QRrqaua%!Xq %^Z2xy% p`*}#E@؆Zy9ڷ/Y(z:z;{ ;[2z3)b2zAʳ5#{=[]Gs3dM` "`".N;lZ !!:I;`) B2"؆{F{B ".` <+c"J!x[¼<(ǩ^۽ Ћabv`n@s"V2<`85\^8)6MM{7Qk:e :&҆霴h ɏF%X8Ϲ "R˜ˉ :c@ n^>{ /~3^ 灢Ei]NaGWiZ>Nh9?~rC~wՄ,jded!+j^1 bZ$$ R.aBtG+t> ]GN~ B쁳^!^|؆~>h ze(~cB'|,ԇ{, ~}b zq-vsSb5?(z-Q???eS?#IſRO_O?NL0OGC0… :|1ĉ+Z1ƍ;z2ȑ$K<2ʕ,[| 3̙4kڼ3Ν<{ 4С0AH$@R(.H# 5ԩTZ5֭\;AH@@ر]˚=6ڵlۺ=klCl}7޽| 絧&/Ō;~ 9pEH[6ɜ;{ :h:լ[~ ;ٴk۾;ݼ{ <ċ?<̛;=ԫ[=ܻ{>˛?>{2ۿ.]`ȒG` .ȠC @x`^ana~b"Hb&b*b.c2Hc6ވc:c>dBIdFdJ.dN> eRNIeV^eZne^~ fb 6u jY8Ad]iftF0 MO8Ť3\]s 5 )3Ls犛L1@7P1vs~41OI#4ic@v 5HC664"t˩0Y3B("2<@cgB 3|VgJ& t\)(@;70nCR$@CHK!SYLCnX*.:w^4CBż'u@̬ 3!*  &Ψ Ol$D<`ND2P4($ C1@6_X$4@uI@ (X=5Nd А0sLܾe4**+޲(PO] e=Poc}Tt* epY59 : RQ)5 CK,z MaJ a*g>3 *BD B(0 l,i[)!6BB4 &XЊP3TI#ː 15. z ;k̘P"K7p"I1ekB7`CԨt[B7[BBz1 }#˨EˆQڇ(ư'Xm.+iEt!^{[|dp-Td)eSS,CY(#(H…>D.ACYH걖,ELY--gB c0jX5!.z34Pd`u3DLw!UdC[\^5T(|b>2,CѮC 7+H?PTI6w L pB!o`r"]ֆC#]o@ ʥ 0r0B :{@0fDaـIhD`@AH|@rZd+67DbQDliB pA7E DH*kҔ/1MȅxE1>Dp!nĤhV(Ѐ,PA!hpeg\k5#@ S:hЍ'p l`qC~ AB ]6[+o1_  ,<cozz<> ` MHXNC"(B.*3KA" Ɗ i Y-`ʵ !@ roŰCHy9ljde 9@Ne@PͿ#NfRa \1qx z1/!õhт.!0;@A9B1!r.P)G eE.v>70ⲅ@fPJ?DXǐy lA` ^d(2ƺp=*{SoP [~BQ `QFHe !u0BlH"6(&x_g)\yF 'Pː^{1 c 6[x `b@w q"' @ 3}C8qx 1w>K3;(0 fH,)H| 9- IqNഔq .)1t`뱍"HYDY@Q`YOdB pS pd>; S "ĩ90 ɹ@ ٙ ;10s@v7yi yzv6v)c7v)0v:V9 QAቡ9d J*Q*J''Z+z QP%pQ6:;>j2;*PFGFJ (, QB2@:V=2ʤ?EJIzZkXڣ!b WVYU`#ʦ*nh:**j2z uz|*-!,a >꧙bA:Z?AA*24P 1%aj BӚKP0W@!rʬΚW0 pP# A1vbXJ{躥KPKP`Pa19P ( z4Z-]& !7K@:<;AW*QpMM gPuj aWkXkPv vpn 7@&TЮ3oƅj6JaK1@]g Ep2pQ `B6.56 Eed 4#%Kc ! /t/ 0be o f p!Z{{۳ʰ!ú⪽ q 1m ;.f  5Kvx` /d7 2D'2zj pRY뽂K*@MpK %Qz ~_a[H+0krgZz` P*-@:\=v m./ʭbj߻ڽ [P a m>  a LÝ3:<0mmku01{a*3ʻ fA=+]k Ț Q=[mlv5w,2P5|A2 a:0 @נ]Z j{څ{ڥTɡ,ڻƫ<ݛS - 1ېڲ,6Yk*  :z0)P $Q̵P*; $ +  1 M*<m@+md?kOmq7)[];bMܽg]au\ y= q\-mA !{hA rMzPp s[!,@0"\a JHqŊ/jqǎ ? Irɒ(OLr˖0_ʌIs͚,Q'N?*(ѣF"]ϧ BU TwWŠKٳhӪ]˶۷pʝKݻx{߿  È+^̸Lj KUW(k̹ϠCMӨS^ͺװc˞MSHVŻ Nȓ+_μsЖKNسkν{wËOTӣ7ϾuOϿzr nJBnР r n^6 *^z^hE0l6c8E- w0bWiū,U#pxAa1pTbl IdlƯ-w .hA\c18<̤&7Nz (GIRL*WV򕰌,gIZ̥.w^̖Ib742f:Ќ4IjZ̦6nz 8IrL:v~ @Z&S ևІnRJQ8Vmp[E7agn,&ђ/X[HjҖ>n3ҚTJ mӞ@ PJԢH8&岃TJU0WPjUz` XJֲIF<.6]]7':/iu6FxY#]c# m|ǻX bíx X;=,B,rVF1FҌ5֓.;̺  D_bI }2) D9}D:Aq ،2׫&YW MM6Woƿ K0_A w @!^#[2I,CU X0Ƙ dk[_7EM6ߎwd*fDiGN/_1 hv 4A[,` Фl$0sqTȕ1BUM D8U|hwF7lFl7N+ !oNAښL%V2Qj De82"mY@d1 l 1|!fآX,z[IYc2M@(/} #Fkլq@ׁщCҋB_ swrVܨQI$@Ȝvĸcyq ]U`(퀁vZxO*1sߣF=jv/ⳊO#Ώ~/ث&k'O~.Oί/^KOMAnbQWgR`; pF CUBXRfE!Z'V PdHRpq+ %f QPG$؁hC ZL`5Wa Tq#-# cSy3f`PT$= kc %fPY'3x$M$X Q`T'C23t 3R;Wp(.`&r7&RdžjNX$4 2P kwHQ3Q0Y'v &Sd ؈Gn$"an􊞱, ((W@dˈ.i@(`0uKڸb a 퀎ʐȋ6ǎ~! ب0>"W_ѐ)>im}Qt@!>#Ibd-ɏ24iµ(<ٓD;)m؏C酔LFɔ4 E) dTؐ )l@j@cW2diR NccnԈY rp\%@PEwV<8 BmU(L"OEgX 0kg0` @ IW9ڠ/n Oe 2@w` dj)iOIš6 It.y OQsӒ cO()3X^ ϠrL0 yY.P Ĝ^`EV iase\e6`. PJV ' @oxPG5 `8JG,?@0: % dU갤BC .P :@( ^DRyr+ VQ8:-DZAʚv ., +ڐGH:W0bJ/`ꉏҌ+ʩGګ'J, Ɛˊ8⣩qڨc@[,IѢ!c5Ф_j0  PeZ!5C%I ݊ŚT ˰х]QY|;+H@Bவ:,KB`V2ɦ-KI2k )^E7Ӑ_14_UW?YB+ @cUG]hP!wJKT9+jG;r[VPdЧHi>#l=TondEH=kaH ?WѤ5JNV S,5{KT=V.0$VQkRfP<{=@:K.fHQu" -֏3T W%ƀ\o$HP.1OpSm+`! = y r >F2d-O=-l]Tm/KK+Mڂamܩ ]]Ͱ5izWy ̃U}ZVpMmrMVWڱ߃D%]Z+Aa?_lV1 }@2X!?eÖpA n^ C7q^ƾN%*q-n/.TY5z_~j豑@?Wv #@_jn鳁?% "\ny Ӏ t`nri겁C `WmmPm{H=5JC׮^\9䎔~2n~+yn~MzJ{8> 3)BI۰ | L~Awb1co):1-aAc'(8YRM`*oy @wN#3(ʑ^h0^p c6z1:zcp8O*XQ` p08WӀ /JPfyK3^W,@Dz€,< +*` ,#c[=R*騋WA]1q Ұ YU;ֶ c-<썣*?.V pS<0WV&Si¿#cR:ů+P z[@8Y] `n: @ ^3C@@ DPB >QD-^ĘQF=~RHQ Ppտ)Aແ,TPEETRM>UԃؒU\IhYC%'b0YEPZ$GU\uśW^}&w7#=@ @,kE Yl[f 0/MFZj֭]fnm'׏`܁ ԧ[`m l!5խ_Ǟ]vّ0Ǜ4~5@7 YO R?h]#@D0A#!dKG )Lek!/YA& U/bdE_1FjLhI4 U(q QQOfD2I%dI$ip`& `K/3L$ ,*&A M !JTFL?4PAUfq *FH+6V SKєPO?5TQLȁ`V 5Y ,qT_6XaB dJ `:ݔZk6ۊ4Z, ŗ,[ @6^y祷Z_USnEe_OE8af(Rp6w!a/8ce$eōG&d k_be_9fŘg9gwv2^9h&hF:ifiGMi:kRд;lpN;mזgV臁~;  g nzOOkIgJD[z x'xG>ygy矇>z~Uƹ7:Vd`/h{g}߇?~ GWQX: K4-. l%p|y&Av@@xDa Uͅ+a e" la gCp*8t}8D"1( @lƈOb!ҷ@4(E.v}H E/ьCBߨ2эoD9юwD!i@0я @H=Ґ(B`Dd$%4iq {@= d(E)#@ v Qҕ1#$4KFf0/EІDf2E5uTf4)%*Q HH ivӛ:! RMrӜDg:Qp kD1kHԙg>չ0n/;TL7>p>t@92 O ذ G/֐oO HFGtXE @W.E0`Ti(P IDf). d ̃EmZ",e3v# dLZ )8FnC5ЅlT] hS5K]#H:DXu E.vY8E>Z+LgshxDj][Yxcz.j!K]Q,Lь[򂏊-&?i)|?‰"G ZQ̄@KD6RThA [Ԟ/ȑϔ/߰wQW}w?~Gտ~?$4DTdt <#x-j,  @ l.qv.`,/cC u|4\1/ȱ!\b "%Tc* ,-./0L464$#T6r8C@UQ(hc8A0KPCil!#܇D;mч=D/ T'2YDADkчGl00  <'T(<@1 HsA\,EըG(w BH*C` k ?CӘFh4 H$4d~b$rɤEL/hlF~쭃z|}蕁ȂP# x POhȐE̾?pp†x úHxɇ_xDa qHQGpԙP= x}dȧtʼ0>z `8aTX T xpd~xDQ): JKx< &6 ǂv/ADoDjD"h}ԸG2h2 3̊xńAK$0j~E6//.@Ą~ƃL@iŹLMALT\[lJtvpAiz~x㴖$b8 8m͆W̠ԍ9uNk9؂P W(.p"? ͉4"Y xN 2O͡' эA648 MyP`ɤ"C, ˡMoQuY{ x4"pЍ|Xy؇)R WLx̃M~U*_KU†#%y6P4[ NrS ,A;a#N!AtrTs\C:=EG̤Tڣ!P QUSES%U0NuAPtoˌAqW! #MԁZʐE Td 0ҦDU]F*Fk@H3hU/ł8s pXYhU Wp׉ uXxiwxu,A(h U Dt4*y@PёH҈1L0̂J//2HJeQ`тHGZXehzhDV*ؙ &yhɄ)`8ӡY0xA Q  `uװ Y۸uZ?$LDXx*`)QҁXW胭 0`P\8 Qi[h֨˕)1?uYͷ% 8EQWMVC ҍX]d\՘G0![4Q;WxW8 ^^%Y3 ތh\0e%'j b3Xeu_(LiReڎS]f`٠Ђh K\& ~ !M" \_] ٍ #!!ljىSF`μZ-݋3D\HgPxs>_\u"E8띑3g@( pLიb;m(P>`#.'%_a%k!DIENeFe݋ Esc8q؊3 g0df:Y؊u Y ڋ9@%*:H5X@۽x upϫY_eL9 SaH` GH7:R[A¨x9(@]MfY8=0fHkxP YgKN;hih0ԋ*ՋN ^pܥ雖V PP}f[$ yP^ddFiP (Rj]]= /R t`10k&zȺ%(8v ]Ѕ>/(O#T󔄯lkdp-܌w0xxW pYl} 0`-hB8H'8fIîmldl>@A2LcjN?~n`pbt `=6Ho* 0SXm0) xP n.xJ\vඵu؆dn xxp 7K> q օ p!Gr=v$s&w.-Goqr.b>s_@2#36s39+9osE3O 鈚@PȊnB 01 *nqhGPJ^hfpoD1 Woh(w'EGij_H45wz1SW`(PR`іˇc(=bX-_xW YJXkz0j nMXUppYx mqj?W8v9J`p,+@u@xJa eUP\u N(|؆qX} ~hqXq'S{ x~}/Wy8\O}ڷ'~`Qaw'7GWgwg4t,h „ 2l!Ĉ'Rh"ƌ7r#ȈF,i$ʔ*Wl%LfҬi&Μ:w'РB-jiG2m)ԨRRj*֬Zr+XԜQ7S@jaײm4۸rҭk.޼z{35q3-lx(Ê3n1Ȓ'L3uk3ТGJMأ̖nMزgK6 6ܹiuڴ.ʗu9ҧSn:ڷs;cz-L׳o=kӯ >~tx~~ 8 x e&a: DL8i8Bƚ!8"{ $"-^E\Sx#9#=#V0j)[MJuQJ9%U P]z%Vn8!ifgYfl9Hp's)'uy}瞁)(Z(*z袉2BԤ`Zz)4bj$)fakRDN0p!AfBɐ&^MTq "\iM'Ԥ@&h:"4E8fRY0,J jL)Pwp&;^Md4%Q_Nl((,,(!Ǜtk+ d 5F ud3iM@x`3AGW(&/:( @J@)r 2L)9Nd6^(0BfF(#' ay"pJ4h(.Ey`:FR EM1\U)' vm4Px9&#\,NXGͧqI(I] zhr @5BOsBQLM@n)L &fnE0nw& ̙ N&D 7&(O*kǚP̉ pV rLU\'uЊ;B (vRJ2kxclh HEzW RDԖ&)jT3Ҥ5w-]:HnuAbK~6-iS־6mS?BLgo>7ӭu~7-yܬ m}WN-7p!;_8#[U2s85~;I#US򕳼99 nr 69s>9Ѓ.:LfnLN?/y#G{.u`c|ЇڎRxa*-F<8AgQ0 mv`U!BIf #Y@?sd/?k}8~`Q x0?,x,.ї,Yğ5`ZJ8DQ?> `D vr PC?_[6hC2\ME 80B\5*+ k@|aP^OS8pEY>P f_D~!~QDdL^?C?8 M838Q< jCrb &b+I:cFf"RcR$N$b@EOAFbOa f%Md+>D4>X+jkp>:ø@+ALAO'@ai`)(h?%$%p&$'C:8'j:`C($j(`î8hlȖ*>~򃜢8'Ŋ8**lB>C~B&T^&m&mm*lÛ>$_΄k:C*;0=@>T)`PĊ_6l`5د.o}-!nj"5|*ƺ3l뒩+ $l.b'nRrSL9J@J~*G, |5|)fO\?H! fʊ!M!DTZ!;%NXM=G1z;L2T;[_wQd6OϨ(fg@ڜvDC[P+ݏOİ3yu;D=v%&m@!M@8?>D}ThVBN75J!V~Bi#(O5&M@CMZ΋|.fd&;"+t8D$x'@c%C]2.D9^w??_CC ԟ?}N=W}ՃƁr}jVUDg@(N`APp@ӥ{1bʼn%TlCA|`\ɋ%Q4IrÃ!a_M mcmxC!lHzoi~ ~ )AT{M=?Am.Jc!EɌ='I%BAB#MM= QbGBwkg!SA5UN Ӫ.[qU׭jQJʅ[ BQ_pz(X3>eI;G=YӪqs"NAa{M22AnSF>QzY8TִXc.Vt9czmʊM &qM`HbWn |Ppt1T09mۛ<,> _rwÔc=i4[)쨰^lyUmwB՝ND?*鄐nʴ*|g )bƸ!8 -sXI/2o*&DzGB @.!>jTm;Aȶo!q az\Sݐ.ڤ;ۯщ)Ę';jl1rg}Oq-UB|KZd iTxd((9  iP! e& 5r ќ ahEe pCGP8 0CРi Ijcy@sB`C^Cq̭HjjkyUu&lj9bE1lR[x! &!x:x[?7Z'sX'6Mj*U ȇf 8tR)S~tG(>Xbi(lC`0>2U#?evMVNH7%gJ S$m _hR,&]NBH+5H S!hh  ;$F5C[LASvdGZSVϚII< 2s JhյnLL6_OtM QĈJnL8=tG-Z`haPee?p VfĎ܄G ?k@GԟuܭQ)O +\T5)+HG; Fyc_T5'EOs|lXi5)z 2^iC>aÉxq |3G0&e3?7OF/G^4by  =hnCcP7*I 'n塎l5̸nl@s!09VX7vdc>z0v&#.ݥ5  @(8MJmzZiT`x1xC;ћGEq g06A qp$ט5N`wԨ5 a 'S;\69Ln| 0֪< qE4 2 CҘr1MmgDA 7ΰ|g2yHoph#ZV/ʦ4Uʚ%޸oDS#8Іݵ1,o2vf9<Ώ$92;#(F89EmmSԦՎuBUe͘qFMLkP#g҅4PqkoxWcOFw2Or+5^pFMx :2U;iɐ5j`F-NbN۞D, P$.∮0A^ځ %|ZnA!!LCDc`2n2 ֎bMb`)J!|Aaa!8g(\,.|&Rpvk^D F&|c3 InĮځ ١ Hg %1!i3~枨2mjah4N!qJ !\LJ;'Fyga 0EʜA h3(JJ0m1Ĩqd@uBLب0G ,6L|b܁ Ƞ  w #ŧ V ɮH ' MNhx_8N!(jB!tŒC;H0A,D,dn)LCIRq l.+xdtBval" +L)LLȒ -@֠ )jxtTͷF!m~f q:b {V<5D{6ǞB;11!mDÌ@,dC#z[׶<Qq3wD ^Af}B& 3%%3!F,|~ Hlc41,䫽|C8Q}.P p"6b|isoև}`(&&"\*!J@4*5BĢ2xR`@Ub6 4L.ey"P32B .iߖXҽ4YN-bl%A 3kl\E's3}Gw#! ރ!cҤH>-)DQR'~!w ! r=%tLE,8a;8ġ\;=45 1RN&Rz=kT(qtkTJMM2Tb q9, 1b: hÿ*ތ*&%>#6 Q,|CH0j!V^j8s^V&7$~ݣ,1AeQ+ Gt-u !n/)xwaayn1''b=x74NCRqv3$x2ӌ65DaBoA^xbucOphŸxcLrX'L(.+f !TuW*_ srW1!X5m q7h3в+$5X#$,k"|İؐǷAJ!W1LT:zaᶊG q'k6@1+ُ O9YQ!,Z=),+'89oE&BkBTx3ykUז)s$y@Ry#!Նf+%!H!'Cޡ+O!Ea[c{E!z@Z@+a,gQtt80"+A!!PzCBODz#:I`/CA;@u!a|">ơ*y:UL,n٥)DC6-DG#ti#Tz a"\* ^J.f&w3bri'b(w(rM59=[W$Tx+Z'%TAz&;AaC;Dw;ir (?;ed'b!~?AY!,X[OU68`@!{+Jd!"?;mNtc%4:WA} d!!!{̀q:B!ACY $E~_7zAW#Ț<b[!*AIqk:ރ\4@LF;>!P>@5!~b Zp]Ir'Ze>ٽU;w7l\Z#Z!0wH>j!$pچBc ͘'R!ʃ -%pEBB݄.qcR-8Do%KfCH u(4By;{ :[ #z 1sC;wg{fy`P]6={Vڻ{'-VkTddշ#K? )БR~ oPIfWP@4΂mOZ=IgigKIl9rIhsih.h!hNJ颐Vin⥜~ j騦jkj kPJkEd2kO`ү4S ʓr,KFKm 0]|f;rL20?옎8#4㨃kc8͎C6ۨs5$UH6>X֜3;J8?o4+ǓM6`?5^< 2HL͐ON'cCC̷xD ON F` oYO%(a'D(=@` .'*%G@V[!+@ }G7Pe$#'X b6AF`"U 4X.`' pf J UG0lO,:{sN0Ak(P)P@1>5h)o8RIJq gܳ t@>@;V@?[Hw;!hE6jMn&KC$Lc6t<HG:hNS9@c$`D>P4X !޳ }h"rp@y 8Ϯ8 C Gh Vb8&mT"YX7 x):<2oa-#@p#pF`LR$:P*^ft(5$5}3m#lؙBUc 8]`p\C 8 -Z `z*p36 ^LV@(Y3a$E8P&h< B  T !!`LE23 cokg2C 5`+2[ 9I p `  ɉ EZ G ]&` i Ű 0 6:xSKGq б3° {۩ kU o;P gY k ' qf5k } [`abJ۸IїS+P +E{dZ l˸kLb{"й +Kk狾髾˾  [k{ [п0ܿK=Q~"Y ( L<  ak_++<$L{,,VQ >陖v:Íkž1l{q׋İ 2e @a=:8'ALa $Ztax!,8 hp1 ڰp<ɯa0Y0 : `JYmla4& QqKX; 7#J N: a Ey a o4 &Q wp*P+ * 1 'ai1}IAA|P aP`6 RiMѝ\6p1Pn Tp:a kA=|Z QPF4>) Rfo*|Ǒt `lE0`z:4 aZf͜hJv{gG }T%M A  @띟e\W̌pU p-y: eFeɷ aE lpy!rA~ Sϰ 02 ^ηpy 6I~՜N x>K{A ˺{ͮR~n.;.=:k, / P Ѫ%" :0?2#_ 0O #9A 2^ Q!y !pIP~KOYS_yRe_~\soFa%Ep.il(%*/!%o1"{o~_(@ 1?q/ @// ;\__*IR*"# 1%dP(? *2 X0 .DXB%NXE5nG!E$YI)UdKt`O'nШaA. ң@NZUYn+K4TNQr T4 (zu gH]/ӄB5!Acȑ%O\4MIS-ָUȖb[I>) \U(ݠt _ܷ aETp4Z\ߧ  2@#(BեZwŏ9f~ nKf"VHD!,^dDP" ("8r¨, ` 2 d9o *1SqE[tE92O&%y.' /">  `IPP *"ł!*;07 Hn Сr/6A=\+, ` @tPB 5*R9( 0Al: NR x-ƃ#{#H[Ҁ ;G8o$itXPb5XdU(Q1F N BŠN LIAmYN:!/V(5rР& z03U_1VU&0~xb++s'p֠: tU!xrlhN, ?"[}2U;^0H RA> A3ij齨m%Y,5(vm(ccuJfjٓxU7pGGM锏'czXv(. .tZkֹzmG\œA .y &K~xj'7vo9qƩ)YP/(0Z7L,HF~{~&ُ}k%iDYu_Iޗ?FPbFAp#T;"Ԡ}7+It9 P+dBP tFah9@QC$M^XLj BJD0G{"AZD(K!"b Qc$c/rD3zGMX<.sc@;JR@$ G c#YYE#K$ $A:ORa) NRde+ӛAdN? RD !, ``*\(KJHqŊ/jqǎ ? Irɒ(OLr˖0_ʌY͛8sɳϟ@ JѣH*]ʴS 翫Wm{ʵׯ`ÊKV)ֲO݊۷pʝ-݅˷߿ LÈq:*ǐ#KL˘3/$ϠCM馧N^ͺװc˞Mۍ{ #w&?μ _ %]l*Ë9j|S7B)aP5ʢX߀HPy Vh!d<݅GK~c1XJ"tn&!0ƈS#b<-#|M@6PF!Xf喕`)fsihlp)tix|矀*蠄j衈&袌6裐F*餷“.4,B駠< sS"ꪬz,Kҋ+Wk@1PN첃U 5ҍlbTGBw+k٬ dLBl P;7ƲAr O:laH Tж $mծ@Ƙ@3\u77IAb bTبP)N>)A KmF́e$&@(P )pb@LLA `Zuax!٢4#LЭ@ bEqYo2j<,+@YB~ d |??'&(A<9BN"U!Vqʶ"@=yU' 2 c@r,pfX̓z  @-Q X WKtd %qㆡ Dn4hk (,2\!=/ rVA;7^CqPrh>. d`nF.j Ynoo}0]KV(BxhCG!SMkAYs g`#\дOX maNf;n%!DƙMl{6Vo6$BB!f / ηiQ ~3&x(c{!Ʒ©l\yp_ģ NJqS=!V/qG!"9 dC-,0G vg.t' Oe0~W]o@jqη8AQ H7@*0H (AlыQLik9N*! (7*VBhBZ ysRC@!gH 1:B7"Loz{OTX<~Td޻֭C{r)ꈾ Zd_F5_v#*èwC& P+#worCqj1o3'vD qE3$x=1-(0A(u'fwlh`0 NA(vH(@ ѡ<]C]cAA5 (l1,b:QfAHsGbPN!  ۰ Fp'5_sW]WTh ]86~x?(0-8;fx |A2@m 1v"hnD*P$AvHspw lBDԋ|!h [GtK(.cED8& /D/&ꠌ=!ĨC $xDR(3/ր $q|hI`djҎ@aB4B(Ѥ$ w8%@Z:tHbB8@!" D))(c` 3%, pg)Dx`<)KװxKcbd@!˰[nTwr piXD$X[ a  M#BP Q\DqE{ )9o\҂$S  ꀗz%.> K DJ)p l~a? `Hh/Ës 3K &5p %I-H@#l,Nq`=a+ ;IE0yh H9Yk t _ S5\S<ȉ4 rЈ Y%7=_TT` ;&PT Ki#0;81i写8E6Q (nL#vPVzXZ\ڥ[=0J`e낕S?XCp47-K(i< !$ Zal5 cĐ]7HqHpH`FpDwAqJw9qn>t? Eu0Y=᪑ğlxI>G4le@ 62Ϛ~z2I*8d; @$dd@Zhj J<O{d<֡` ~ 9 Z7 dPbvjaAZ-V](ф T}B% *#`/H & f ="r ! }>1PI-0 )8a-ըA<9 B.P8Ea?aE "  q1 P ヴ?.Pl]2(_ 4tk8Qbwf*0<hv !B+U!( j(@ H}AV!G8+'(`Z{~S**S Ul r  1 5+ҫ<A!X y`L@p Q,t@2:F+6!p̚PPv*FE*n n aʐ)0  u=1 '-ѓD =G:!VnK [ ID8 Gy7 p+|dhf<Xr c=݆"a!"a@f b {Mǀadzmff{8ŵQxQl?As*<@ ahʽ(CF`%ʨ{~'|+7! H˝j̋" ̈QK#l͏QдCʈGTѻn0L!yY\φ ͙ЈW0 ?Ш(ڀEгPK=\EYvʽ}Sj\(-*2=#Wm I JӁ8-J;=Ӆԡ4F}C9HJM?`oQmF+8@UXHxyceH`s֋0l}Ќ|y6r9XBL a!s ^8Q _ـ4mgeu@x8! pZwלGP% ,6ny-'N")`ځ  ^P L^a܊ U6! ܽFR PP03[!R}Oe9ج|l L->H:AnsNp 6$o&~*m, 5yoWQ0Џ69Z *@1|(8I7gٍRnxI 6弨6Z/d^Q: ``v0_6!_5I -?^v^ |n `_CxK  P/H B `RY6fS0 Uѹꬮ Y3e ``}L+µ  m3)7FM/` Iz;S~. APQݓ K@4Qz "`0DÛW Mق-_AU?p? '@ o ur6Av O(tM3 l;JɒHO Jpxj A0)87+G)4: pgY!و"ʐt#7 s،,66 7 !r( Pg `Ѳ8 ~1 [! ֢wqx8@ LuVcXh1 GC`װw\ ` 0 54  @/4`|x/6p5 -Ч" шW 3PB >HHD-^ĘQF=~RH%MDRJ-]<0N ,( &Ja-V(MܹFRM>UTU^Śjs9\CPVAR00Ug!NtW\uśWދ~L=ܤ[f ࣓`| C:5XA 'R=ZhҥbA- -f) # n޽}\xGb)k4dn%5Ybl)^svݽ^|I]U;`S^|,kWF[?$@1cxE\*>'B /mZp;1DG$&[hĦ(E_1Fgj1Gwǂ$1H!$"q jdI'.g (2K-L12L1$s% :La$ՄӡkgGp qk3NCO*PJGS^Iҗz(7 GlTRO5QML> rO*W"pq֔Ih`Z `U#g3 jtqFbUH9gV%_~le\su\u} _e `]17_}_U! z_F8z 'b/ء3c?9dG&dOF9eWfe_9fgfo9gwg:h&hF:ifi:jj:kk;l&l&f-ykΊɴmfo `N(g2uF%}Xi1Hi!H䂗D&N)ARUFqZZQ{$gYȮi Ǚ≷ӗtUr S ͂E> r F>'U8(E™R|,  JA;xp@( ,א06o 0b"0H̐oDzAp!*A=kFAQ*^e`C* 8P` )"N ADFV$`(]QD!nQb P1/0`>1Ho!p@бCpIC A p0H1:F|+0VQKvlIv0-)$0s"9,3.28$<~ In+9D#A J2#:BI ?j4?|_cc~RZ2ho!(Hܳ#'`H`8P <t,Iy q-&,W:Ap|_LI RW!pk-e-js$ SMb?Al@@u g_BQ ^P͆$B`ȇBt))RD4# D,Ae FDAؑb56mP䙆~"a֘ů܂bAF)!S"X ]c-e1ZK ,bee7`[09Cjb 5x_0qulZ%9a/hg,` ^\zn""n2]".p[.ȃ2a&Ń`qo`·/ oDQCbS^SbOHYrdPF%H*\,EKjAۇovL jv8 .t 8-<;9Y}t=hBЇFthF7яt%=iJWҗt5iNwӟuE=jRԧFuUjVկue=kZַuuYd$?}acG?1cWDh>m jg l|!hPHV<1r߯ȇ!exc  Yc7xp7x%>qWsixٵOmk47{?\4 7{`rc !АmC7'ȜYnd3݊^΅'y0 0s gd`z.yThWd H;<)v y I<yϮM})|[@wg\#X@F ƣf!wIBM|w&(oI ~!DWvC| o xHpBY}.g/RPMHBi҄3J/HZ=0HTpcǣ6b$ÛBJ_?Ù# 베?4?+v``:myh&0?4 L~X`30  $l @qO2:Ȼg &l0oy9bB=}{m Tt4\sb"C91bc~91 A5x/\0 3yPB<b B@:{)C ;< bB  6l@K:đ374n RYNS?&Oĺh:XFka4FOtE F&qddC g|"B.B(Fo|5L1@w|hйŠBuP:Hĸ`GUǁG$ȃah$Ԓ?> T9U@Ӓ0@-4<%7p8 qx6O6d :MTNT@/ S動܈âKD8ǒXճUKH>#U|PO.ٗeH֬XJ[]4`7Sqք T!.֥a YlJH+}pňcess} ֝)SJdWK,@FsIfu&~CA6Q Zb IIcX\*IІu itW]' yVHό Ui|a[VHͧ@dŌ̊@0 9@4ZJIĊgҼJ <}XHX-ږ!R Z9qOZhLk uT,g#[ 99c\V, ],U]au]h]0ץ]]@iuϝx[_)e Qu^LXM  )Pu5ЩdY(]__kk[eߍ_߅[)'`_[\q1b.( x @V׳$X ^X" Uk"0HH_^_]ԩIOS\6 5NZGV@2LPkZ(N)8͒Uay[Ȇ&c8`bW{cQCFE4dEdHdGmj^LdP&cdZ஄cR_@g8Tf?.]@Y&Fe(]69-e19c%c6[H ]g9>ql8ލ@5  FɄjf< 9p$qЂ܈!2 *p!B}Ї=g]d U@A@#шY,C- }VmNh]#;z^SZ6@C"rx0^Xfӆa^[Z`: Xk >Pq~(H %Xw MW &_> 'xBȹEk@8GrYkHC0NpH^k]$x6dЇo'U*ZׄMJ`B @3pl[[93Dd?b&g%_`Up`B(1aCmc# b5 0OCO@)?Jh!iP?WK]ϩû;^9DbJ=3hc=Q ι mxϵ_TwH]a~R76^jlf !'"7#G$Vr[e&G'y,-./01'273G4W5g6w78s7ϑ*/>rYe<󢉕tx?=9u)tCqpH>?F/EJ7UF03PBWѬPQ'R7SGTWUgVwWXYZQ7 *I Hw$OtAvH_gE?v1 rf' =ViˇmI|vr7wuq$օxAVjfS gHpx,?Ʌv|ʉȊx|ƏyF7yCWGwgyjI@Y#[w!X7F׬v%҆g 0Yp7tRcti<Kg vf ag0OCɆpx@%YԬd_aizHЩ' ltv|pYf h-v% l n`y` 7 7q| g%Y G/  8)ȇo}jaa%*+ (po~:'SZU81Ҹ gl%jz)`v'+K,h „ X1YdŌ $P#Ȑ"G,i$ʔ*WT*M&΂r'РB-jb=',dJLWH;ibZ¨EW٭jײm6dԼ.޼zk4-AT %v8q,L0E ͠ТGEy-nyMF5زg^hPV1\P0rSр_4trl7Չ`Y3;_*9 p 0׳o}qXp L%-@A4e191]tBnp"E5,-]0yh@U ` "-t &} 5t+QNPĀ( AJlEEsBe]Q/@1)X]zɓ%_* 1܉y&i$-ࢹd9rKK8>:k9Î~;ķ><|y;3ۼCk}B0@p?>jr>髿>>??n8(< 2,"8 $ 3 K C(6J.`ƽ6![H氇VK (!F<"%2ш>|lxA@/k"-rVhC0QU8#Ө5n|#(9ұe]X*ⱏh )A<$"E2#$rHRdh1b$(BPm<%*SJr|%,c~ %.s.)aJd/He2fHcs&6MOQ!$?~l<7of)y;?Գ^| '@ЅEeAARMCKudC *Ba&%HFZ?qҙҔ)=80Z,#eM*zfT!?!0AB! P ,rGa ]qVPQ0N SUpMg06 h;e(&^ۣD1- # p-͞5 H(ե>;u~8I"5!(oԒChgBӌH0D!+Q A- >+ھWO $ś΀bAqØ)Ʊ-yL:) QCH o+ J\RĽ! QLSx>PM: %@1e!N*chT ^NauP^ETL8 d L8c?!E,>ag!z D(B^G},#XVa}o< ) 0+1h|c3qpw?Csy+X Lid?.#MXD4B H4oTR`6m6x8AqܱO {xT/ E\ x2D^Hj@(-!i5;|a굞2p`uA`:,8x-AUD4ARA@A`} @6x z ^(ƥ= D M|((Ac A.$C$ D-@ҩJXh>EY!SC &ED2(aLOGfG~L$N  HC76䩰#JÏ!cN&eE @JȂ4`9R*VOjM\PFt9pVe Q ;9K12z_<ae]4&AX%c>TD\ _cf`@¬Tfhj]d"I,$aF@jަ&*D6nEdKHC' q 'sV#RdCbsVIYAdD$IXZ'xU d)|@VhoFxQZSgOBCdJ|VHAgBމ#?t= !^>(Mq^[X(~(( @'g_#i`IS`Z' PD*L'Pc%y5dDD Lih 0LC& ET8(P DBQ,$灰2( 5—SL!C_KRՙDyMj4E"!$?ïL@MbjPMѰpŁ%AP+y*O>*$-éQ6zAJX ȃmFel*֐ uR"iy$z*\鱪 c)g<+dBF%atj_\ƶSJ,FN,V^,fn,v~,ȆȎ,ɖvǰD2_ɾT@$ {,κ,4DlDjm : |:o0,Vm0hAC\N_OڶEU=ھĮ.H@A4@8,[d jB>QN>T>3??3@[Ta62pAJJ0 0Ȃr6m1 ,`5GG# 7mA64$^ëc38+jq02CFkDC12D4_tmLTB|0AX2@@8Q k.)@x>B-HĂzDCF|,tigP臉AlJ??ETG$$ @T@A<r@TH!STBB !F8bE1fԸcGA9dIE3We mxuI7qԹgώDu&lUù d%qU{ x 8Qs`غ expϝp lX33$bJY+zA\=c0[˗1gּsgƌQL4ukׯ%kɬ_aT@ALؠazY%ƹN3$@ml`lDkQ*"'s l 0`]YI׿&([Jo"M̰v<78D#<@,Lj >mgKzLCm,hͶa&*@ `(&$2ʠR\hؓh ^#bXڂss"& `,؃dY'\ $*;Jh\aBx@]mQNYe%_l%Zh%h%+e Wf@ _Zj<jE[b9k\ktY%OpEx\Fg[̚pQSib]C:OݢZj;tEl`rٝ=$2C(sb14ȗK򴤼 %"Z`yhojb`z6?-Wf @.0IJ)da1Y0EGA n*XT&"4a-fB#(+^ѩ049>j9D!Z1.b%t@_!A/d_ݏG$ݷWE]-U p8!01!*aa4P02bA$p!,  * `A. JHqŊ/jqǎ ? Irɒ(OLr˖0_ʌIs͚,lxN8{*(ѣF"])ӧ ńJuժXjuï  سhӪ]˶۷pʝKݻx˷߿ LÈ+.jǐ#KLraU3c̹ϠC<*mTSovװc˞M۸sͻ NpWNμУKNkUMͽËOӫ_Ͼ˟O>|QcϿEi߁& 6F)VHa~vᇅZh(~siwW*(4X)<@)DiH&L6PF)T*yP: 8e)"Jb(v F.ta8bmWG_fc \ֵ+-jgK[6]lkނ,v72}ml*&MqK%u]`w x58X rMzW^ծC^qݛn?SVL?^@J\y^bΰ%gց`xSGL⾦([R.~c,Ӹ7q_cm,d?Fqa|d!/O OX}Aq`3g"2f.35mys,g8v^ Lgҋt=jBЧFti?ѯt]jFӑY̖]-cbڔcO;ˍ1 a4 T[^ @]VG{qXW5k3S.;x O8*_Hh=Oz/ֳ^%5T!۾=|oz~?5.F8aH>@|nȆk\es#}sP }FΩg oKR lD:A3` w3ep Z-0 Q Ȱ ~pP =}((  M4@zF' Wa 9 @ 0ha'J`.xCD]F!w#X6 pOPLUU:lq{0BWgD[PpA  .#!` a4 %)A(NVP5kX($('0Nn0Bn@K ^%ا?Ͱ` WghQ`aP 8ڐA$@K aPK5h\XQZ؉ 6@ᆆ p{rVF`AgatT`O Dwp 0pq]p #THÍ1N#(a ?e`b ` Ȃ04p:0`0 Abu;X$K,n!'_w]F}=)I 41PP ɄDuޠa `PS& 0D M 10uTQ!1_Q @ ( :Pi8[ ڰ!~05Q`eqa_21PL >tDa UOS N-yP ѐ K5(OGfb VsD[0 f 8=iѕ rwѠ$n( `X)Ip:' 0P 5E?%` 8pwLyݠ gK AN+r?xTq[ı [*$$k*A+ #+Բ/+6$=47۳yqH *D")sV0NpA kH ?pV :ôO;s ʈL =#dnqk] a`QPy0n  Ju5)5i[_ pLPyqALp@ \Ii~m5 5<>{"g I=@`&,}A[$ r=> DL>D1g-34-Bu g q=BP =xa& I~N=jJ kpXwڀ=2}BD#}ai =<=x-B-D@ッP 0qHܤw-,<J]. zi`<~ [N}J= 8e ֢{3.d>+ @A〤pٓ q0L*1 y< r.mk]}~ p>=]A@h჉Зᰠ˽(;=C0g#˿^>O ^;D1~ kA=K=m^0 &\|ܞ~?=̿l ~m  3_a|{?-ˌ~{,tL:sH`GpQyL 9SOpk\.M+H)~7п@??^G K?F:,po=GSBP.*oVٞe @!S $l{^` ϐ j9N?_n1 @\s"A $S7? p?A+ $PB >QD-^ĘQF=~?y&k#A0iRL£SN=%ZyQWRMPh,1Gf~H †nuVZmݾu8Fc WD ] ^… ݦ"WD krBaca4U;Y` lRHq6{!$@V*c\xp}eG\r#d{"N,81CW \H[\M#>Q 1.?0B '(m B l 30Cmjh gy~dQGD/c4y THh<0s" s x!ƚhJ%hHhqSPX檌Z8~GI~Zk q1+!Ygp ¶\`%=p ˇL ^&̐eܙu!S& Ja/y :1[X܊~8aHPo$cGyLVq%yd&R`v"JZqȓzB+"XD׆PZl 2"%>87`(pi&˰'a쏝`R& '&1c ih`ֈ(<(*I%pmmL9#$p(k| @CrWgB bul(c|E[jq^r\f|R{ŖY`[j=]u98!Z{$H|-`F_6gTd?l85A ]k ^! 0=I3  _Nԡct(` U™ b ´#din@LF؋SSpA ,m" uqAG򱐹*AG&>lݐ_cH18F[aB~xD 0Ɂ ~0#rE2Tv-/ѐmdD^8DB`>0H .DҔ$"UGҕ)t*a pUWҗZ*_Sl@PbD? Ƅf4 Sfpd37Ƅ8m٬H!ѹNPs dg&F_J.@U0u3!>B 0ՠխoV)2/FRʤ2'ekU#mvI$Jc: N*DJՊ^" 4<+R$y5 04j9L6$Dڏt%~np *Cƒ\_ mYr}BWznv{ӨBnA6;&$oz#]rЕz;xv!n|_|j8[귿F06c7bQ]7!썰[36fpV*L~QbCX0Ajb$#<Jc#ffcxZ91̺!C^r<5AF ylL&c[F'& f6_1\"9r偠#nP;X*QzRȇT /[tYӮҌv"`>p!f)`\hxAΡt`gHH$:T1DձFvr\X'*{ \6̲lpQ%[4r@B]n~E !wYH4! 5b F4@GfW\-ſXlnhdN0uMe( xw8|T5)b @9#aiг˅ Cw5yGF8އCAGzALa'wZ G|ugߺj. QGkvwG{ϻh?xGSG|Oyx7>TxW^vO'u/{_EeE@J;>q3Ly׾ercByɣ~!@zu,_ywK3nzGp q`N_-})4Ed+jݯןS08tlgQF?m$Sy蒈btRyй%?@Fi}3PPP iВЃaQP? GIKIn 8?Hf  XpPpR7A XwH<ؒm@`0ouP8Nת䄳0T&ߐ`#"ÁJD2$~P@ֳ џaZT|cH\XhCņDX-p,7XZq@#TLDUt~@C0Y@ XP1:STugH)1igDizsE:l$HK.r:R:6xdHh*HbHā(n,-PCCņd XxXzSx[`PLpDl1 k?pªD'jɭtyxpه~i}8,yP Cq =KiyCT)cʄJdʫ4L L j k@81@Tax5bI`5k bPM$jHDpJiiߜ Z37zùrq,cq >[k0dtb́)8Oa@D :΅8萆@ÁMɄTMJ  i E %*fxF$Uϩ\LxXS U5!,d!NPL[H_x "E5@OxxQ`8_8O_J(aRQ#5hj]y G6Vax̠!3ScPP;3 `w+!*ċb ;ZKN'YT& Nr(@bQ 99~D\5$ 4̐jP^Yb SUZe[g$]B!\`WZVU\qe@ PEo 8g%x # $WbZ}Wq~}{]UkV~׃U'!3:؉؋،؍؎؏ِّ%ْ5ٓEٔmG / nʤwdٚ r,{וٟU}ϫ('E2ڦ}$ /qp.m9"H&!'*\/M*B!$ڶe dϫZR+LLL}ګXY+ '/X~F pW^YZeQe;]n)caa`e_6eNPdff)f[e[nlm."PcngRp&壆N}1UCl*r}ګ͊x>(|0ty>ʢ#Q4L)hz CjMLLΈA.) Ъ$~i0yP@t$@#Lph6%6%nY3^X7'Μv pl8,~pum5g"iQ? x8iN{NWbTMd ̗% H̰i6 ~ eȵ$U-ΈhYX@t@ ahpoX`8^օuܴ9vf~DkMt{@сb`~ZqP(j#L(iT(8ІLQZ^J.|Ѝ,0,V:nqApp[d87̈UX݁MHv4vHGlH)MTX(n "J;Mvo XZHxukވl@݈x 5 ePu |JA%Ip?bhOц1) qȂ .Voq0QЂ6q d`v38E80T UX^N8IF!Rb(IUu%- ̰r:ω.4%Xkn0mBh`@uXB%0^ 8@l+HtV`l\aw4PHxژ!b8^(Z X^rF-)zӇX8Gu DO2vhTM'1ֈ`Щu'?f$0voqO gu@%5a W ؄:5l 3Io?PrTEfvRXw]jMXy`i)j@ER܈a k`p'd@|ɞbZP"_ ^{X_bЅ(oLGNY،[z͈hp ]4ԅv Vk@q (C[\[şDžb D{ &<{v XUp8x93)|C5`gh\\ne` 2T!['Rh"ƌ7r#Ȑ"GZLȂmͪP1 %C^8Ka(-j(ҤJ2m4VCmNNe.\ȵ5-k,ڴ]SVAZ`RKW5jW.l0b "npfì wUYXǚ7sLmc[v-0jϪWn⅌_֥ 'ܹŎ7;A3o gC0Уك g𿈍_c@,q]FL;{ӯB LT%2(L>1>;;pio?:-ME.U,B:@3d8f1J( 7lcNus1#OuYW!vE㘮g >m15;KQ:%sBhpB]<*4<;E3s`3<\7SmB8|Rs}>8,32_Х;Ey?@FbL_f6n!]w-VmL)qlz&0yPmG4996jfF; *>6AMcv!-8 Rʈ] 5٘. mB`';&f 1aC\Ia(#6>ДBžu[bISl)X%cHC`14P$3/ `fcz|N>pHD6FG"U\Άp%GwDc<^ _^%s6gd!)eCxl"?F${`Pd7'&ԠnMCKxF2~PM2D(ꞩ'2bX Q'(zR l!JCk7T2U#51O"԰CӉ O͊)ЀR"r(,ٴ(Ս qi4|*$YP C@s$1  aR b:NqmC҆#"G 袅mj!$ A=]lc@hEFd*WiJI w)7n cl ;qZFSU "z 7#G!2nz #n8{LdHdD&mX#wiaSV!^ hlF g16Sve !Sb $ dk1O&-@QI?XN s@&U!# \cLCX 4X牳UU" A ,h?@4ul!;XB!H-1i}Mz!!כiD"x5qr °P&Qg6mL+[3M0D.5aLRe~rn|axHĄʐIo>xHT0rd vY #(p!r.D6_B*mkӼZZ@s7tZ׺2fDz7PXb(iٱyz|GzUчT4~W#Ġ)Z8ܭ"TBДeD.lJ!$Hp!x3x΃F ǁu(Y$(c@?Dz3xl< @)|nVm]n?z3@ghB>-v3r?!r?!l3}_ l6-&I!C"2",:"C S䟙u.0DHC6Ж-2X2aC|y`M+Q|e-m&61@DGC~'<U? JO =15ڡ56ޔ@(X@6Ș~(RQL46$D0,?dC2`Ȩn<@RX"@DǑ0T=dQ 1ΰ3bķɤT: 6@6\%YLSnТz ZY%ZNuE%\ƥ\e\&$T.*>.*,D[BA :}WҳbCDeXeF8,,_upD&+h@hh$bjJfdIk_b (٠@ip'qq&'rgPDAG4tuVu^'vfs6'Z@wwgusotfYPE 8FV.[}HBDeBf{6l'Gܧ%\hWEE&0h%YbhzEhFgBCT Fq zEDX@Dt5&br,]YiȠ" 2DzX0(bh Xe 8F8z-J\Ih6 C iE1!I0BEpg CdGh<%8`x$@260$jF 5tA>~튂|*,(`X6 BB2Dcl*Uઙ$CozjN-X)cƇ8vC#P-A#$( )܉zBT2&gje'@a?XC&b8ÛvF ½6$~ǸZ˚**KL+8![:d mc||:FV C+R\֎f޾hs\5.t(*lB.sخ8 &/˔n+lgiN/0/8/g@R/ 6^^BzN&ĔZm8 /:KJ8kL,@e*BHoZX;Gp]]%E{uC ) .肟ZGЌ,lRCB;pBQS  -B EABH"SM` S F1@/ *$t,(9t0Rd2F!1C0qQ$B[BXqC1 qȯ2Xx#?ذ60I et(D1#7K'qC8P'Dh!Rh<2,Eб(CEB QC7\@R$ԊFxX*B\(CxCd :D!0 tb}<,10g3F 67@,+/%!7.)O6sl2RoAIE̜O/pas:GI^#4DRhxNtm/G4C;gC8d GG )_FaG_?X4JVTI`G4M;JL+t4Y4ONCPERVȱjR?OS[uB1TV{5E,XFVd\O/B/D\2F'Vܵm@^΃&Sf\? [vC 6a3_Msc\,4TCvdg\Q3EW@gȤhxf7f vkwu|66Guvcl#RlC05A1B~[sT;t̙8 S#a]>탃=ETHG ok[;xu^ċSE>y hP;d00.@4<'/<7?!G$w?HZ|okDgcD_[DW5Sv}iCW|u}~ ~#~[8L1hۊ-[c~ks~{ԋ~5 ΦcJWs67F<;aOW;?g?7Cgw??6ǣD"tCJ}r5aʑN+!@8`&T0AFLDZѠF z\H$!D/aƔ9&Ljtܵ?:hQG&UZOpM[:jUWfպkW_6ZYg͎UXm}\lޕ[T/^}x`w2Yڵoz7ޫI|,'fϡG>:XױgnT{wܽxۋ/^=z|{ҩxu/9 , qIzF )|'*PA 5̐) 1M$U Qd9Q:fyG#LAlH&l(',Ē. %s GtlS9锓52 O MO S/CB.E*rhڳKz381OC)qXt2RKWJYI[dU]c PLS" cMVelba_VkͶRo(q ܗ%\uauEWxm^{ews qxNm\(~7{ux_9Xc kp&pyC[iuay>=Do^4FwH%MZ_BdmiY4A +g9lֹl:ò?[n[p9Jd\ow,pi1\ͧ9]I/n)YoaWq]fW}/תڋOoKo^z~럏~UZ]ѥ]_g])d@KdAm,@Py?m`32QGLELV FFLN8C<`2c0^rCd2%|T~#Pgrr_>hk\>" ` xyf,<i|#0YdQ>Ƒ7h+$fg|e "Xp 2U @2Il12AK!c/ن'Yh$q0*q2Np&D7XzR-)CAӈ`2xI$5ĤW7RN0;ũUC&KgpƤLehMafc&x,k cJk'<%h1G;mxC Hd1dx <đ̠X#@Y3T( ~2˙&h~RR4(+U&a"bJx+`"Sx hh x({#fRs@ A X  T醎,t5,VH %>"SØ0<`&/^ (@PS4/CeT$Nj5F*QP8& QS&ا:#ŚCM^b@AjQ*d-L: 0H)(!9X[ְZ`aRJ8U9%T@$ tMk$a7,iɄ xT.q@-\@Ѯ] 8.p1v}שu<_Lubo='xO_|hl$Qzկwa{Ϟ/` z^v|7|/_!wop}/o0 ş~+x^?th{/pPCPt~-105p9=A0Ep'ptJ|TbY]a"RPs"gqp{Nr}pw/~v0~` g"! n* " 0 +Ȱ !p e &% հ  P=e b)1}dBa8 -G&Ae.AqG!+BqY@ baauq`a2(ء`q1  ڀ1"͑& ` +Ho!@ }H(B(Q Aj!!a*!$- #b!P`R < HrQ<( %%c(P2 MRA@ b.ώR)(q&yg(,q).'D'#rn&&Zb ]A*`^F0$y*Fa2)2-s3&"3!3A34AS3/+( RLjb+.k.(qa* 3 b.&^L@ZUbI%s*89: !D$!" OAN'3LDP%(=3>m(&4>$?Ih3^hA5;I,E@!&ƒ'@4+(25A 6iB6 6_u!ZC@ k}&)drab܁o4a#zG}4H{vx'_ cIG8R(hs/MBKGI8LQyT&<+6Z , 1 3V!-(BAN%@!:a'>!&?!R?RF4&t+4DbA  Ϋ R"1Ea1PD!RCa1tG^TRӬW]@.&2U+TP!:" @ 3(!~%p%x"A \S]GQ?X_Xۦ6 aP \!p'2\AuBc'+Q"@蕕4(%gAn xL\/v&W[Qw"&f_:2^bSJEfL A\Ww(bfxaig76MjS ~!  K`Rg]5jxqn k6rkkM! @JhAnn!L9v)nXK/a R!D&{  \uav V  ( +(6%` -sA!nLyOcSWzBrzwza[ƀ {(|( w!*R-7|zHia~{H1bSܶ&a0|B 0A#3H!:}p~!pcb)+8!Bg!+u.8w(s\i6&AaG"? & WB&($!xa\R^gR}Gix⮚ط|B^]GwA{ǀuE$ U8*,@-I&`x_u`ui !G%^B#K-y&j&I䁉cc v!^b4Nx8Abgru_bÂK9܎Crq~brabziyI1_"Űf|لe J|9&N2x.&&P2d ׹mw 2DϞyj c"a>8d\!:O e&pY&0Z)`4[So5u)x@ @%i+&[%*b:nZ(~@`{x&\Bn&B!e 0)J}!bIAUe8ͺ:3z񶨃bd`|b* d4Tt5 C\&dv'q4tv=&J%v ng!&&% |,9% &va>_v]Yvn@'1rѕr%P4έ!p<&:YUh!!B;r\'*g26ەd +nJƄ}:@tj {?4@W-c6!}?j:^h裘bU3G b af^CcEAbb!(!]q߲x'!+nH?4V'tq?_)_ <0… :|1ĉ Bx-@bI'_ő$J6Й*aFȒ4kڼIRNp8{ ϧСD+9PfѥL:} 5ԩT5kŌ<(PC`&KTصNC V"R(ڍڻ| 8pxfmic.0J"a6:'П˛oxۻ?Kz}`H`` .`>aNHa^ana~b"Xu$b*"D&:Hc6ވ㇨=g_dBIdC OE@jqTdRNI PIZne^M:$Z<ejɦté&, B $A~ hqJ y3Pt@!@$ 42pp`ls~ j4@lc-(:@4IB5 kd4j *р@4 =!@I@x8~e,=3LL"䪶!:eA/p*@o ApDCpP PM@4 3Ad6@{("UB d )1Όupd(BT9]WM07$\uc/a@A3$slCYlc!@L2D-I> 3H5OXߞI 9js 3Y᠎4I۰LdN=3BW1$Ԍ#M}#^{ ɳ: !Sᾤ~ '95O8 3$2? 228y$ q6Ap {0h hbo@dSQ7Ld{= 6JG4L{8,▪Cu(у^,XЌC8^rb sF2qz\)qĊwg(n@|"gHBJrLY<D.~'?Yqn#T&,3[DIErR\-o{d#˅J\ s FKSl3R|5dڰf*R&3Ic|0'0ɩ!3&ԑ ý!,g0 P6^fM?π*t8Om\Em@42xѐg}3zԜ KC 4m "ȗ;#B:sبʋ֢>ꎥ;myz6Ǜ:u\%R Ȝvud!ƲujE ׸L\Wy_ U-,|:O*v lJ7md/8gRϊvqΒveivkG:P@v OB!@noܒ$G@Jwv,wx`ҺV流ǻT7L}w x.+x np{Kx/ kx? x$.Ox,n_ x4ox< yD.$jLdgPc烍gX9-HcOȺ8CR2}Zgt9#uMqj91@!Yƞ2j7H@YKZ4M!bX@4> J5A K%3Дj D42q0dP Q@ #ՒE"i4H*fP ba%,IsK> 1Bb `W N,2u$d ,ʃ`ϱm;Yp#[ Š0Cz %+A"̈́fd#0qo;чl"e[H8'd@ ,AF{tp$[8HC@ !ܸJF P1PHd.>ڀF$ !`I &tG4aD Ha ذp쉉)VJi9:! U_ bPHkfH!MK#[(4BAEp8@ fPeH CH1"Ҫ;)C L 0dIx"kl!W$P'rYtZ8#Sʕ'a ~et@  0 vS iƠ8r |P b ~#Xy a`~Vv @ p i4x}A ( Fx~p  P2 n' % -HH;L2xz@xЃA   TXp &W0 o &H pz1Q kh {p QK ` ` @ .`5 ;v  ]H|` x~q 6x0 ` ?cdx`D؉LsR X( aza8I8O Nq( ` {MڸDSؘEihQH$J ɐ  )Ii"0 \$ia$--2Da%& =>)5Y2$9) cSeMI NeSISǃYڐ ]sfgiaU-n cu 0uIw]R} P6fmlhiz,6 ptAc΀) ЕUڠ PksY[Ț xbg&kWciY 9i 9F V54vI7v) P I 6ty5ѝ i`9.bƜY 0q$h A (ogm`' 62xwcgg0 )Z0 tY9 ZZ76?&EXwr-y@ b'jp6. Y֐]F@FØ/:c@_%Oh2 o+ sb0Sy 4@rZz 's%@| Q Шp(DA|ShM{}-!o`0|9q-bu00r`/}j(Px{  #YKz]GN {%g IiW51P .2  Gq$4{qЧwP Ksa+b6npZ0e1h'N3pUQ0y qP v]x&֦y2}2D`Wia4 k`pc{(w'! 1P1 H X(p` 3v6Q8kv~06 @p1 ;X  + axP>+ n  ib!PM#w{la/Ā|( p @vq{49|(P[>Z,0YrC&D xK-A9Kc+,# [оP?so.b g#f'W{:pu( "&} ahWt_z'1 %7 *MRK8 x 1m xpQ0! o Jb2P . ! ) a | Q PYR6u wRpt%*i ʐ#pu1xaq Q 1 6|;*bx mqa Vo K PH H @ mX*b5Z ;  8 a sh 8( ~ oxP5i   ! a& .p Tx\ |.{0m qmռoX ݨ @  2X/ Vx =vA `ϋ{(8n a"{0ζ0+R 7 p|,!Üv[-c=pUa ̋ pm m O e! ΧײԧՄ {i}`}7!Q = .ٸ M Ʊoܱ o̽0,LCȍ`\ `< `s۾3so= yp{Mo0~mq  || 7x1#M-17E%./0E2~4.4~0N5$3BEG^CB^BIJ QMYW?;jW`Z^FL_Q~AfRynn NsN.$VTg ?B=E~ p脞C賦DXaLQ^>pT]S@$^>BH^J`@Za:b鯾AqV88QHQ Fߎ.'p˗Ȏq4.nyR랞/A2 !_|z0.~+kҒ)S q=$QgpA!6bBpԅ,A@ NWG!AAC4˔Z@&Qʏ2W<`˘8`4k.@<ՃWaŎ%[Yiծe[qΥ[]l༎D &1<6ojp'#ޱ'+=*c ,7|lRGE+B9Z É* k% `⁃ ԁД?ѥO^uٵomD Ƀ2X0<p-‰:CjJʹ j;HٮPI83Jb *q kazO[܃V"w@&P d`H6~dr+KWo`=A!,0 *\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cL_8ɳϟ@ JѣH*hӧPJTgłKjʵׯ`ÊKlSfӪ]˶۷pʝ+R ڍUE߿ LÈ+^"R#KL˘#C̹ϠCMiwO^͚hMߤ_o6>B0իNN:aνD̉+Ej{BMξ=\;T PxXB" E''~7J~='zE(Rl7y'%@sȄ$Jt B * TB̕X MD F#<&܍ }Ex 6#a\F4I$!Z}]ڃ чP#(fBGH#D (Z~rȠD`F$&BزF:"+pHx1HFǦC$ &9}J*rt(ĵH-eFT᫼b96tB&gEЈ!Nfw(b.KFjJ`L j~.pT@.z,.„BI&|p~f^~œ+ ǤU\qP $[ ʂS6:Ӝ#AE3ļ!cxaǚ/z>;f t37ʗ!픺mH%΀L{̗OJzߺk6Ԋ*1 Xl|}w ^E tkAH=*9-A &LaTQGU 8X&hT(o,؁"!H28Q-8)ȃ&#$2(h'h8quhf& wk?6 :tE:CUtyA׆&фHSoDH x6 ewF8Tf~HV؈xeȈL8X舘XH8QȊ芖(HHxp膋7}y' y!}ҷQ| Ǩ"rhȍȋHhȎ(莹(刏稏n| Ԩy yĈV1~{A| DJ4Xɂ!i#ك)+-9Y/y351ɑ77 B9D92[HYJI&ANPt`RYOIVYXQ\y]b Qf9h^)moɕqsiudw){9gIG ԰\ -cfɘ9bٙ;Ay@;!:1&`A_d a 6 b pCѤH9S᠚_y0Qɚ) DO@ƜR~ 8Nd ǵ>';9u9A:zj ڠ* *q Zѡ* :Jj ʡʢ ʄʰI$ d& p:ÙM Tk 6q_1ui xy;ӝAoJ Q r$ 1  slj_`n1 qv=Is!Ӡ UP_X3 k F= =G d A a?͐v 6 J@ z1h#kpCs&C3>g`NRu01u:uZq tdfGaP 1hG EAofp? iUtǭ .@~} t a` 8]; Z@Q f>Jr0  gIr6Nԯ  7P 1 0*K` Ća:Ұ >Q %F<О q`w \ A Pb60 Z P m"Q0 ОLTFh0 T9$6 &YF[(|eф  tNyt tY5 D~U CC@C0 7PQJѺk0D;F@ Q;IoM ͹ < 1a_Q̫DKҋ0  Lӛ\´]A 6˼D0 F<24\6i9R@ >A5 Rx\I+ 頼 Q<fn_3bLm?pζoDŽKl3s\;.0aǎI1\@YW{Ȝ1lR8Vkʪʬʮʰ˲<\i[;BK[Q !ɑ១Y:u6 ؜ڼ¬0) ȥ{ V ty c|=]}=l0C9fxx  "=$]&m ] /xW ! kf:S<Ƅ5@ħ9fEO`0  W Ԕ\ .Vـ yN.c@wt\0PV q veM ׀iPMy5:lX եExFO€ ȅ=-H݉ a9.- um P D`aYţ=ec 5-Z-Ӯ2[զu a 1.j`hT=Y=׀$SI o:`P oް T4E<{@: -)- Q2 1m?e @gލC6@:Pm'xpn6L 9H!Ϫb !W5  p?tem[ȁݼRA aN Yd VrYݦ 39u [dF JgOp/0 }9 \CYP Z;:@6PܮB amraZ*\?.Z$Е f Afڍb{Btwjc%6 Umv 7@:sY0vP = k ɰ PȐ7S 5€f[-N^O E0 aZ)~{e}ڝvI`= |DޞW RaR^ F %Q^F9 qAZRX Y$ p A P&` XeEP `O.͐P ːqA: iRuE|qR5nUTPs=d0m`vC80.ܧD՜nG y@ o3s_z t c\(F/m.O䆚 RѠ\p MPٛC FO=(6+ j !-@` ZU>QD-^Ę1f ,%KH%MDRJz*C2+h!qTPBC*.ȃ-@Ғ=>J%^j"\%`ʌ+.^E FX8Sf pMñ:2gfKfruK׭:I[v/aDk^ԕ{ P?e~hҋD $<[][+W/ݽXnnkݿvFDY}ǟpq1:J?l@D0Ad0z$t7B?1DG$DEEzFo1Gw|E4)F8H#D2I%tGÄ2J(#1@*%b3$,J05 ȸ sN;3O23L4PA%@> RDQG4RF9RM7<)!PPOE5UU{ @UAL_V[o T\ $RSw6XaMIWb3NYeYg5~u6[m#v[٘RV-%\sŨUtQkՅ7^yLw^89]^z^vI]fav$|8c76 b/uj?F9eSlu w\gYckߑgHq裕X`Rc^P `l~>ZX&XLʵ[ڞO&Rb:ok-{6 @V-[^WfFyH~.G2D1=GmtЮek.#]d F_hTe{gwN|=x ;pمuUWqQ_Q~~<xǗT]$z^^Iys m|r rI $8A+Bhw9zsDcƀ 3/6"3iw;a-`Yi1I1X JH=2t'2E?v: ԢTCjc>U "t(̈́4},!T]E"Pt - FՑ `O6' #:54FԺ&k NPLAVD{? rm$㏥5kPAC7g8ivPp ,v$Տk_k\Ljm7⌴`㉀$.?i̵bC%Q֨q++D* ud[t%B>+vd ?nw1 R>$ jrl y|z3 FyH4Ca`L@D݉`#yM-"0GhQr L 2|WcWiL,IhpH<ëE9(v rG pD@q[}\蕈XN"PyfcJ8yzVd'~HcXE>hQ@D|jh,"&ZOBôCq_R->;v[k$"UJxqC0=犅P3SH h3CAEJv-k$RBGbir]S.pU]ToX g_;dꁄ+*l(Y(Zu]`w| Eq#7yQl/1 !h= G@:k\|)-J'|ź˜O$ G7PކP>2!fzTW{ApJq=B;}u{ܿQD0m4"W2h$@?Pv@qGCқAZe3h(=1~xuw?ן3{F'3 AC)Zc0/xpP ݉k@>vJ?$+4t9@ A($2㾁h>yaO3~!@Yeb@;k %г+@#Ѱ%w'yХv0;y,$#"PCAC #BDۆ~DLS=7|؄خEy2 ; ?$R4SŠDĨIE$;}A=DM S e@vE*Q@1v&BBQ?7qe\9|p&F >CB#)bP=s@ iGZW9E(`8)QJ<E5l,zG; #hq@1 QȅmB؅] IZف@Y ! Z=SFHIPixP5(CGI=Dɒɜ(B,kʄ\| 4cpK ?=Ɂ@_e(#_ex![ ^P)SQZ~| Q@J˼@/ˢ؆4DTdɜqpP%9[2x JG(p-`O׬[`ā p^ ;xZ BL_9̌0@T_Nf6* S(x?(X0@O87hNYH@A5ݕc9@v* *R+-.+%ʡ܌\`MHӉuNhӇxӉ(a,I.D> 䔎< I15dNs4 4LEMNOP(ň}Sqf@%(2@+3@%x_tMt^XH k(OZ 3%| .@lTyЕ@ lmnoV*'l%H!2 TD87 JX`yfxXe[}XA`Hy7  UxhmPD{!2'$hEOWp868VxY7u_h ~ LpF(F ASXAv%k3}_!0\įh%Z_(Fx_t?5{[ف0VP>Oч2O=(tF%2sY5EظLbXSXPՁ^Y!e0]U󙅏L8 Ҷ\Zh9X`\"ed,q^ȊpV*AzHTHݚ ͍p\̇Yph$uJ:: 1013I ` & 1 MUPu•+pcၚ f,ƒ 1#&_-gE[vau+EV <՘ qb 5)_uLNT?c`AcmT5֍r1 #0b^;6E7ژY>.pegvH94Ư͙a9=0R8y@hߠNХ\CCGсf6Taڈ0%5ƙ͹@p>ޔ;eȱqk&TJ64Ñ< *ʮtx@Tgkk*fW)6*S)XQ~p rx\i.xDT-ȡȀ@+&;w rF&RBՊ]uXƿИlM؈Lf *Dqo1 vEyF ^ (NfnR*|0>@r# D% ? gEʒf' |iu}`q ~qކ*Ri(s(IXr rsUrHp>ox@;X?27o56p@׈Nv$H>:bpC/BABtn ;K5[HO8[h8POPu`x ?ʖg[O Z[GvuvIw`Gul]wmgm&fgHhpꙕbH=srswpm_o?~}~gx7ف؄l'E8@yk9݇x W- :p@ijh@Dz &4-»w ʰ_48{&w(NJ tF{|q G|5_8?GKwǿ'dɟ{1|& zy(/#ᇈ荇p` gJ׷j}}T bӡB1|yA{r}} l0,-"-},zW;e##Lj+O(|/Bg`"$r7,h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G^~7p6Ve7=QJy 4B-jԢ8ِkѨRRj*֬Zrͨʠ2 P*MƍSMDuX  _BbugO.l0Ċ3$3JR1:XdEج?$ Y(-YQk7]~./xgo9ҧctPVn-:_U@D ;<T6M>i@L'3\AaHT\8(rO*jD0 @#NP7Ґ<,cWnt RPX!J5(%{l\c*;/ڋ຅  аImrp5<CyѨ@DbA)1@:Y3fU.|39g%M#O17kI5IEIe:+WN2ڌ Z6]#4\?5?C3eVg:n2cESv7[TmOk@62 DxM`Af< +͈V N(@1mS2XO ġ83`Rw #2QMX;lODI!ΐ S5zQď?DyWs(<}CB<1Ș@1J=!pAƱX}a,hL )7# [K|! c n{XA^b|TXAѭ)<p?}i2 ()RA5a1"fa ,+H`5Ȑ Aa!YO H+0N($S (E92, #H0ˠǁ )AZL<#iIV2 lp<D,II$El!aV!Pe2o\fTfAzA, Afa@;1&FNuƋ ",t\fҳvB cB0 x [  ],%Bq \t:5XFэr.R9JYZ["EP~:*ә4x\)"L4"*C*\T5=*RԊ3R*թRU(TխrD0ձfEQϪֵn}+\FqxOv+^ݪ浯~+USNg"t2r|6pRR!*r͙36ђLղAԨhkc++msrE-p+\Pl=.r72ͽPERwΨ.v;\pGuɈW=/v.;"/~+_ A/ 7>0^,#. SثP|/ s5|J嫉sj [lи4pRX>A~,d#dCNXYX^)a @Ph^1wYd32 }sQx:`\5A?p3;g:G#ԣc=S,g}$ m偀ҕhP!5=t wLǴ8rTwH:@fKXlhDM6 lMq6l/ؐaE O`ؼVjdz:-%#H l/Ԙ!2mX gYmވ,!m|Ƿ|B{2y 51 xLҸA0*dS?0!iI 5.eØb2: H߮4JVژ\1icJag)1D-߸' &,byA2 g8"1ۇYbCDrdpY)эe2'/uMvzZ()}ψ5nq[9 "dLb|9$O% R 4 \00س q H W@kXdv( 7iC܁Ƚ[TFX" 8V D @5,YDG -BȇD@\2BМnB-DM @@ AA_AhB@ Yh@9BO@ T6i7PC?x@` \@DAS:tE0@) + 8 (ȱ 4Ж@pB`A@ ` AJ,qX @,A;!BW8+ D ^C;-)D3`|@H!^} ,Zmh2`TD @`L4K%@t\=5d\ʼ͒@<  T@ lRB +.,tz% !8&¢FADB8ʕ0A^0D$#vL@@D4`K8|JGP<#, DЖq/AC2V1lNBdJA@)xF D'!B3H_Xc_2Raj`u ;N)B %E`KDbL`@$-6K=N$ 14UAL2CM(,$ARAL@*5CdP V *<@:@@LA,x%Yp l h 7CGBA-@,!_d@l'@ %(X/(Ăh A@$*”h.ݔj}2LaF@+ $B` BL*: 2B\!H3T@$ dlYD2C@ _*PDH%ef&CHA0"8&@hLDfA/TPB0\73,ŞD<<̓Gpk.0%D2d'/N%邪 qC-Vj2OB@ՊTHꡬjxkjC,lA/.,rá" \G÷x-G*F-.(ON:XijCME-Ġ{B@Vlώςm0yܞˊ$FdV0En0͂շ$n)%Zڂ΂TBq1|SD6.hɨ.D-a CV,J1Ԃ/J --ERdCA/B-GXE /Z@UZNV+F0p},R z.t0l ;3 C 0 0  L 0011'/17?1GO1W_1go1w1VjM`Kjp[;DZ7q#>D4rrHC( #r#wzq$p2<\% Izlr29De%z)%'!*2, '|2t[.6+یtEm>2u2 c/r M@hA^,33A`}Iz8NJsx+tx@s~)@D <HN=sW@ƨoqTAܥC83Bc768G?Lt~ Q,o4HR?dU4A[AA؍J@@t_I?6(6H$B @@Ok+>:OA*b!_(8xMzKw]5=#_D;(B\|}EFtH0[+14[luV(Ll8Lt@u1jȃKs4(vDd5hs9̶eǶ[HøtE vsH>C>, AkrLlCCwiadEgPI7sq]\7s̒tB8s#DO'DvqwKRO΀gMF\W|sXIvRDW isKtjϴe B3w5O|6N?psH(8$WXÊK>LcE'ەGD@Fo>Yw5wDC CݬwF(K(E ap8!=|  uE@IiʓcB?1yC#/jwrFAU76T ?(S4; A AGXȐ rSXE>XCT8ʦgIIJMe3Wz':]?ās?IW4L^)@AW^DBo?~wx0:ve@48B:eA+{D{4_o{!mC|Z\K G DgדI8ːs$`§RD(|'إphAN?@ /2}wA_9D;D-gQ$&|0LUXH\C?S_iJ^F,@<Kg41|K?M $@?}ѻph&dn &B7l3V@(Cm),<|>ChB 4Q_=Qt~R<_MڧDˏ&fTBfa(G>a] |Zq,UN:5Zoƕ;n]]vdȐ5QIdޕmKl:3ڽoܶ|*1dϟAT ڟчckȩM vm۷q Q@ ?~CMjss~C..92ȝ\%@.iD7o-_n~׏_~ / N"$&B1 6jtB QH.)vPD1v RLČmqpyQ֒jmL(9"Ϣk=QJ Ż §@iJ//,34@ʗ;RGPe#&-?T6?ա1uG!Tj# y(Q٢OIQm:&xgYiu\i  HV(@O ,QRV2ҁ @p ո:DUԥow3B c 2>'p ] Bƚx~-vqG 8d5Qg1Nލ9)heUP"Z|FQHجg":8iʭDߊhɪ QR秡뚖:)z92W]BHτa 椦QfO.M*;ۇ ; ƽo4j[ yyf ǩz p \s< Iy|h\>X^y(Ņi_hyb vɷ-H/ie:۠y;^]6{ ҮvGR\+R3^7 Yd75aV0y EdC]NWե.u܊p)aw]wJn#żyqMc~ J0,b7s#&A=ʗ v 9aH ob͇CX0Qb8"@ځAFV¦Q҈ϙB Bn}vY'i<ۅEI(rx`>\Uj$sJc'm KxIBiy ?xӳOVra7 $ 7`Cׅ@d̰ӊV iy HEM;6N895RB1^di$-!0=6͢[ iL;K "[Ip@sse\CBlԶD=f\7dTg{`QdE2Jr^u:l,^a '3کF< ՍW~sG V*`R=5H (8xQ'_:7kOq;NUÌy#..#QB1 h֯ 7X|<6/"W8#!+/j@)'liDDEamOn4"k\/C[#di`FxBA!d & VAo4$(;D6,f3iEJPf`r(aF&T" X?² 6fh$`-bέM,-0uLmt'! I0Bi>a!$@!)m7 s$3)px+-.Q P8~ V"!rQ0$v@278:eޡ&cD#m YGq{Q1)BQnRo,-q#P g 1 "A . rc"5ҝ r 1α 7bF$U:1#rp%Q?h&i%1 1|'>n(D'"53@bt,"Ll*#m#A!!m+ږ"Yi  -L2$ Bh*%,.&*2 挒/ .z"B,.dzA^07bV!:#b2^$ M4AarF L4]s dLR aђN2m붌A"b1%!'3Zca"",`!"  tN J F f`O6 " LX8s$3UA LhA b K \!AN n"J Ԫ: B \s <B]=r@>!Ll!Zs)F%%.3:"nEa"nR B"C-# IHP#!Ea.l!1uGu 024R"Xt"a zB=!Bc r V"?T4"vGy@RE>a,"b/!DѲBBqa A B 0k Q qU p,aEB,T#Sz8M}?[FUZAYa"'B!ja#B7 b^G^Lp I U7USG?6M9 ` @8!(:&V` "T  ,$ aW nasv[A?9qKro'+a*Z=:"QcAϞB0#N(~Ja|8aqJv5Jm1h1U8 pg?dBgnv6:0bhBfTo`q | "6NHq l$ĆrDqMsM=atr9GP$!2tisMqaS q5rawGRFuղwV35an[xwku3wxwZv3[Ax|yzr7%ɗGdB :{n7Hӷ?62~d}q״" WTW 8s=,bjo@!4^t1Xnlb3p2݌s([ 3xŦ˔ZmSF Z{MX~SxYnRp!xu8~s#8 ^2®"Ixj"^ rAs|x9VBI8!8 šRO#KXt8iju $2#v"ʖ eIJX|`bq w%a?EUw#` >s"c@%jT*" @ҁѓؔY2\!"~!Z!b$ `! -ldU,o$aLN(YutIy6hK y s m JEjbd ewrY{Vw*繢WbF"Vh(a4fO'~Yը`t 2l  0,bY ]!aZ".ژY٢&0#U--+V4e 5 8̅IZ T V. `5@!X'OUz%ZYmwy X!Ao B>eAe'%" zB%FVBVᙡ9ŽKf,bRmbY@5 30(zJ+` ((\8wQ3R  da "BFV  BeAmO"U{ڇ;%*! DZ"` d3 |nV : YYDQb:@ fR%d8Z@]"@U`DN(#dD p#lj b4⟍xvUKmIE†g(S|fZŹ"د3IE*w-<" D"ʅ#Ic:K{Y[#t| :fCZf2&")YkLxOd #= b+}η0]yd'?C} }V"3L|8 [}Eֹ\7hn+w}{]!8d#٧j=9ڽ}]"]r+}}ާ}ާޏ]AjA~ʧ b,*[Vk9,Ae,A"H?9U~YIa^[Ua~U B!pR=i#c>sI^CQ~u꧞"^`;~%y"8Ⱦ>~پ>~>G륾~ !"=>."6_,ޞ?G_۞OW_>#< ~ ,"H Juy}?;?C?*O-ZX+)R+ɿ?ٿ?_!_" R;0B \É"F"D 5.X#CE&$YAURcY%L׮ LgT{ 3СD=.!0TZ5֭\z 6رd˚=6ڵ`a 7ܹtڽ7޽| 8 ~ 5(8jג:~ 9NlX4S :ѤK>=ZլYl شgӆmkq%$ S;]e>{ \>˛?~pM7.h Nd#7@b}ag|7    zaFGa~6]C]a~b{L$H"I:RXn1H59ȑ="F ]mdN> %$WQwuII%L\~J`vҘzi&hYӚl&f9&`XQɧQJdJhO'~AdE(Gb4)ENtC6iAihtj kJk}dkR*d- l!b,&ˬ@l*KmJlZ-jm.;rn.ꢻ.v-l;okK:l *ÐL_qoq r"Lr&r*r#(8 |z)3=;Ay|IHpAA,ROMut t~5K5][5ak:6e{z6ֿVͶN wrMwvߍ$6!DAD@CT4kx/xN8dT6]  Xx袏Nz馟NQWzN{:9G5,O|/Y9?}Oo{o}/Γ6柏~{(*NszOoQRô6${,`iQ**p IJ@?( | ,aAy΄,liD+Ѕ i>GUȦ6B,?:!F1!Ck< ih::{xgXGm<#{iP {2(lhOQH#ρq~Tiτ*GP{|Y`#$+X Q 4#K$:+QRFAAE4)$dk|r"f\@pƣJFL b|c2*'"=h $UMS .5Lx褞J*OdԈV2u fxU'C`#n:mh# P%cXd!pK,K]R֘F2 [T ꘟ8HB;( `Ȃ D=!"ҀC*$  t4t` )¤ y@Z-J1AAS`BEjGy]h=UwpEkc@1ӂ-L`J6#:rTЁb ABT` !\}@ @@ 4D aC~[9AqBLؠ܂"eIR2, E 0G("e8NB: LF͆;i4C F B !X4D5>BSD@[8&!}p"H$ZQ:pB 6-$q3"C)l6$,>+|IY7(s-'RA.̜ cк!HA3oxQ Y k9$50 ʐ' P Gy&IU8A}oJӰRzqLnBQn Дc ٚ Mi1 ƀykY  7 KA ƐJ=N q5$2*NyؤH@a Y,Q q Y7ss8g (98C8" BSfu 0 Ii Fi Мk@ He hKX fZ F:Vi KI *JjʫꫲVYd49KU*GpHZ\*Z4_y0 e٦7ǕZ2X9 S*3JY I @ 6M ]0`Cx$a Ia VIOI1ު %){DGyK%%۪[+˲% E ۮCcڲѲ;˳=? A+CKEkFк't~* QK` R+aY ]۵T{XUK^kgCCT %< pڶyk(<*v +Kk˸븏 +($:@yPz빅·+Kk˺뺯 +kK7뻿뻼+;5`Njɫ˼ +˼k ,˽ +Kk ث˾ +K 8V8yڛkl; L{1E8L L%l7D>%0&,38SPD;mE0 4E Kĺ@ N`E|{MY+ڀ 0e %Al$ 9 [& ؠSfy,"iL&ƑC  P 7ǍЁLɗlə0Q < QP ȱ]dqb0q   \oTn&c^ L<`0h@]@REƀ `4 b@ !E #̮ `0ɷdm`  P=`qE"T4P P ꠽Z@ e zϢ;R7@-A{BKԋfSMUՉ@J#AIR$p /;2 fPWK;  ~M؄ Q,`$0*ҥP3* :u/ KsMS` (E؎3HK*! !]olټ5\I!Ctt` xxqp|mVىTT 9HΚ8^4pgMLDdF\ TM ,m1޲ M9э  ϸ AN as =Г=ɿ%056,STI]0P0 |Q඲ "˻ nA ϯ p `` ` 00*n?=}| ]\+ Nƭ(>M{R^e#Ϥ `z 28 *Mє  5 ζP@aSgj  {+SD저hh>NIA"&ɾNGxZאҤp @  }rlfyN?RA*Jr.i#-$ p*H*P*lk+Lh, ֨ H &  롰&. ̭@9m^o  (`N0 N`=A'-H=S l/: ,W$ kLu } 0*p1<UE@ pLDO>*/ p } `@ 7d!c*l NoXa0nO`oDAY#8^! 0 `QM xt woɟ3o+R#(0A .dC%&t{v0gChMD)UdK1e΄Ipe&-kNH?d`Wx-FS2x d2`’I3Yiծe[4<87!ݸy#Vqg㒍&Maĉ/i!N<  .2Z O3E8h !2q2t*o'.wqW;o޾}˃`Gvx `=Eŏ_!=Q@|N~ϗ/}Aŕ*򠓄9)1q>HkʳVl-'D/"4435󚧶gki 0柩O@kQ{C%qxG$ B*pl@CuTRi['SbgvVmUWW UsآR7iGWTmTbEkЄ &3B;ꬑR!*fI'؄0\tu(}.pŃ lGώ2 jΒ ~Ne̕fdUa'B!eMt$hIhJG(٨GR9 ^I]nxfC݆ś|sj=VApSd cYfrj%!(dm!Ɵx!7 \v&dnY)P}QsL|b P,_)GBH1QD:ekA׺j*@\Zx=$~[0™jUX;ht! lYn%si)AZe-C85hA|ҕ\dC9 ÃPc G8k$$IG5Աe#|%Y?$C#K/uVA hCm 6UR4A/dX9 @QH$)6`'thUf(sP6%ֳ'x4+/2EI GBiHhSGeN1F ' wU| 9%آ8޹89IWάQq# vf9#K/\;B|P/!qd;f ؐ[?,#B)8@2x ܨD- F{[~YhlW)2a*OjlL)9"DJz}p2f1QttS%KʿVCrsTˑґx싒La,N8U-_(\!\b2"msCЗJlQt %X`B92s$ `{k[]"(|Ku&d.'kWA'epr }HJE \݉Zw!q0؆7ȃ=ƈ fq~:b.v"NED[H5?%Ogm<){-nT8e6 $M泅.!ăXDyS<jh!\mhPBK$ p= ųO3Vs1APW%Y}J /aU.v OY%0X!\Y|thY| @ꃁ@XJ 0 !78   =ZSb;?(0y@t!ǘMh% k9Y"IC10 2h r}H!( w[ 닣̒A0 ܸK(ȶ[ c[#PP0;Kp*+qN#S,陔{WD[EDq " MPOOOO2贊Ḣ ~ Q) LIZ7:AYȱdRJ] %YuC !`To]ЅTp׃T~3ȹ<})d8Өu=,V4ȢhUP Z*yPJ} ,d JJd؆PG::adRݲVD S*=}y[m zjșyMpΫ֜ AՌYni0 R[+:[ 2(M2ۺ͉ƅ\M\uMEō\]ɽ\̝%\ϥ=ϥ[ÏqpY]#u֍H1ݘU ]ݭz}hڍ GrExS0yxp4 ]]ޭެ2:Y8*zHí6RꨇD}_Y{]˅_$(UʮpHT`HizmYM`^F^;o8[FAs$]$cRgd(6>Sf bD>kӺ`h&F'Hk(0clmI@`@?ne,@σX+V8$Be;C)yȇVpH&_On PH&*)fe\\`ܯ, VFF5g@cX%(VD>Bd`@@xi#'Uo%gsFg>KH.TX}]Jc^cXلpC X<轵sVt ƒpH@xY@C*X@.=m3%Ifijچ|*`h)=]ZlhCJ:#`eUșl0~Jiћ.fEPY+.Mmm7rCL~z+hYԎw Qq*zцwC`H3Vf Ȩ!Fn-n=nfn.R}x% @ΑZnhl.aje VFRr؃:V$ay*(p>@H8N +P(8nO;ER/ue_H[~(^?xivDOgbײ*1eh@?pj=>^D8YHux8ږx*WIe膆d_vMPg[r}w7rT8}v0l0=n>>7Nwt ixcYv3!vϐrP?vvy"/ʇ%pa izNxkPyPas?z|-fPnaF@Iox5x:^B(ІB5|}npdJ`Pz}u|Gvd8;6G\c` @m Z`)B( @ dH`("ɒ&OLr%˖._Œiڨ> *t(ѢF"Mt)ӦN _`y U?V7ubz] [y2M[w FG2^yf @7MC MuS2Ξ?-z4Ң Nb"q OnNtQ^y.q.}D7sI};޿/>)tbSwpXV-s6"ee`fBRX&#N[cO?#>Q?"Tv?ZAv;2 v<CY.͌u}(QX"C'Bb,FL2T8wISkhMf9 1{٧6*)љ?y砋2ڨBtZbriBtfyzZZ骯 SjiګJzk["JjBF,DRrۭE6뭸[.2ۮ;[.vۯIyD 0 3ܰH lR0]cE('rtdFX$2Ӭ7㜭4;KECSH4OCuPs[sݵ_c]gkݶos]w6흷JtJ*HJ*b8Cv/ D@K/袋呃ТA,'/޺_#^㞻 _#3߼CS_cs߽߃_磟 ?h"G:o8/$hӗd~c`d\,A$xkXP1 `idp8#TcH-rkArŲ—$p *# ɆQ \l? 5 !3: `i>-iL5D\cĸ _%@5nД1bnq1} `Y 1n 3/d "M2P[F1dB&xӌC2Y+"< \1 &{)'N"CPFD)JiZD\qCpAD`5IB?sk<"HI!RHNd@F>BEpN Iv0Xj +f13:*0Ḟ`, {BƝdlY7DM @F5j #8H+#t"`HO t0$LcJƠFJDgl A [$:eH)b82%⇈"KA,DdFKRÃ`"K`Ba y&&-q'٫ k["Y# ,^@;,z!WFgK*nT~ p -Ѿ#E/l!X(08_¸)Вq /A~1 k4ļ-ZŀK\6Hq܉L~ПS\"(/ //>\pX: k\)#ҋ8[[LBE$U9r1]pȺE.Ȍ |ARwHY"m0eA]{fs˲'b܄92k^r x5|xRޠhnx%9E0K-'H[,E1=iz"#ȟ iˠMDjUf $Cv]Gg͖.8"ծM ams;^7"񞷁 ރw M 8Io2>Ⱦ>A@<wBhc<xdODDzI0EנtDZsŲasY$413BqBo9CaQA ә>Sia4QiHaWn82C6f6B*~JTM: K$vŰ:BS`;ٜ!,+\cG&Xb|BD^;ף`( 5"CA͵4>b̐i_>x7> e?{LAYQ|8$)! d\CJ7We)lБ ⳤX9F6Y0(ZC #Q02<ϑQLyD[D_߁ JHC!%`Y3Û~KPNmDJq乆5XC0<`Z2P B,SKp`C1cT 1QO6,^3RDAABIYD9~_I!ChhAЀ,X2 O;DUU4VrQL7E4t$U,C]x-æMDDU-'B-,t_4DC6,20DXmO A٩֐%l*z/ )j#R_̢O3QEKVDC.2ED70D l42A(I,0N]c+-A,0 H1$!w(])D$@c JDi!AxxQ[)\ DRIlZ cDT@0DT] $dDA0*8ATO|KXIJC/`,]"0Dl*K40g('$BPScALD\@=H,-\4A,F-"CR@^DAA@TV6A@D#*6 A$ADD/4"UDBE@E2D9:f?B%"0!$YEZ3@c(HBhVEY9B`΂7Ƅ1V(D')DT-T)te@ZeDOTmEt l7urB3@IF тo*A,>j,:PA BY ܂!mN '4DE B$.ٙZ)!lDWb*A\A&C4:BT]At hpBĶ'0C@P^-PIBZ$r7H,܂.HC-4$!0|eZBCn,J(CBW.,LQ2 #,,[i&yBjh,p@E\((*PxB)0ľU+Îw1nBuFS9Eɂ+@`R'!D "h-iBٕ)dYNAd-D$,CH2BFxDgud)&)D1 $'A< 圬>@O D, @%ĨQԁ/ND3gDD##2B(6kIB[F3q/%A@4D<LD %층(CAL$BA,AS(HrPAFKv8@D-}0A%uY>> qBe&$;}A1pD4-jA2,Cԁ926RrDYβI( XAL>a12,qZ=\#D /式/.DB8;b/TP^AD.-QI-qUdu/0BY3oJJDŽvEOs%MYޙ/P1X5KG.BA+U-.h1-La->UQ3amX@2LqN-y./|aDRO.,LB3xA#E#I5-8,6Տ?_Sδ-uR-Xu4idOvZK@dPPZL/ A8zY/ԂDK-D4AuQ1մ(G3K^X=s6F#-B-DwJ,0B†}n]gDXhQDyCdF^D.\hv33JQgDxdITu[oa-0xQcvLt7PTrDLxTYD{T˖~7t#wB)ේ*Ω)wzK\gK8wأIU++A=‘+Ԃ“G’\4oyybvATA)rLJy9tlP:,ܞ :lȡPxp A~`JDTĥ[z:jG:yKl@CDOĬk:I`z qZ$:uzD z:{{gL B LƱCDɴDŽ[;C;CxzI@;A4 KӚi <~z[ĹC ൉dzĬ{8;N|,Ɍ,, $C[Hq$C|Fh@[J>?AD~I($D,t3&ҡ,=Cȴh|pi@Y,d!XH}N81 5@D8Dl覸2~8;K> K[D|bH#AgPD$47BO&a;>d9h?Pe2B 4Dix0@"zCyp HU_@{xeJ+dȠ!C ,iaI3g S˖>Ό l)px.B!0VVyTMc֮BYkٮ7m\sֵ{o^{Wn:IL@=#!\3-+6Ź S| b8&7&J EFxwρ0;@hŊxIk8I%r~}ld۹w|xs@@O^87" <6IJ<A >hmJbor) Tx#>x%tH"viCRpYj laYr HHX1+&|( '*SfP9HB4!o27iRmB"Ok6lC>h1(?ةb,+C5 )5ݔN=PLI~X;H (9hՃ%AID(yh|!!H + PC- F 2PV kږb O.؇s 2 tq:Q:|ݗ~&(UՇf~V IƚxjUx1(eWdџ0%W:Q;4 WV஥EVg:=eW,2uY5,_ghbiꮽWCu}GIxh V`XlRUe p1jm;S~r9\=tN!#g8~bEcVxu;\urGhO8?䕿+egaWX|~Ce0XpʀnV׃],WOwdYR@| @O,$ֆ?~!a {q)=58@ 08@Ó԰/ y@mL6B#ITbJ-+^Tu'8*`tpaXƾ%OZN(. >0:dx4"HG>$ht (EMm#Wi 6b 쓞 ORoJ (-c VғP$iY(K[K |@5U?T7K dd8LKg>s<!,  *4h0Ç#JHŋ3jȱǏ CIɓ(S\ɲ˗0K2\Hs͚8o(⿟@c JѣH*]ʴӧPJիXRhTWcԳhӪ]˶۷pʝKSx˷߿ Lᣪ+^̸ǐ#Ko@f1 e0D´ Z06K(E#E3n1YآE0la0;C7/{0. GYC8.H"nS ]b ־&B TsDWj < `61m1G\DE)Z iFLfl7BF~ e @2hm"[  Ńb,ƄLCؐBq.DH0H,P%!Mb.% l`Bj)@6 򌁴c-Dz`*K,P W@z'4ϣ(p pH/ 3/ jD`J!op*?|?99B >3RM03{OOC(a!֦) @ 7#cBAC F%3m D 4n @q 05]a@{8Ar QA0 saCCpa45A9@X "PP4x@S|@UPTpTfb-Y7KyQXS@# iUR4'K 7 S d=1ce(BX84 '\ 4) 6e~sY n@E (X Ј tv_4BPfaA#Cu38393 PwPЉb*!vz'z@?}@ E FeP  V94zoTqs4v$G@p.;0Đ7\1 uS ` ?°8 {C q W:Mx'D0s1u 2LB=   P) C`ٗqScyq90N$H8(D ~cL!@ZĀFU9z\)Nə N#!Y OԘaW) i)H ɚ  y8pCٚ5^9}Qᒝ  G)-ƝIVl"Iy?ɞyMG9YPzడڡ : :- J0YV /04Z6z8:<ڣ>@B:4' -) daTZVz1vG,IzY. qimʦ)ҥ0Q GpUf:W/v:+*) 0J: euPo 6:Arjok7L|^A VH )1^cl^uJ qꢗuVp85*'0v.Pڧ?\ҐJ_\խɬJ*ʪ!> -خA \/` 5-ܧdYJډG+\90PY6 s=XsS lS?^LU.s0aD" |֯G\v3 5\{'P ;& w =D8MMm O;81 PF8FcL{.2N{*|J  6`[儳^)Pu j.8 ?ۊiEzXҀH P7P7P%s^M:S @`kUaT߀@5 7_v$# -h13`g#[-d`1k3s+{Y R ! eF@F0G7?@ Fk20f AA4L9ý  O;pP¿*ao5U taƕx5hH3%lEK ǬݠqQT,+NX Y%6flc]cTeƎl2$ ckq0 Y`futIď 1zŝ N ;0 cTE7$\c ki?!=?rX!j$ĺ3BjaT&_Ԑ l mQGkD  H0<#=GҥYD}g%pV*Y] `9q h3J-=\![. >"* ZM׹̏ ;.}V v ܮ ?f*=Ԏݮim1я=ڨ]0٩|yمڴ0͒. ͵<ۼ-]/{}-/-~.}}⒕ōܝݩښ .ڍۺ=++ϝ*C܄߫*J Fl9lP(o`q̶߱>b:up Z& _HSON EuQ7FubE7 Q7 ~fAma&%> ,H~ܪc <*F.^Hz2=^.ܳE}n>#d]tl. =ll=_0;iV%_^`@t| Qa_ `Mb >mgꁞ^QžOQ?bG )4nRna (bͮNfG.Uўj1q(u.>a 氁 ~P.r QtP/:,> p@~"O.Z nK<6D5.[DI4O^}PF \<Rwy` J$P^AѸ8. ( e[@gV +@vO@ /{NB\<'<` a!q\s( }Lol #IAj/a Pnx QV 0^kQo`T'H/wR/@ DPB >QDTĘQF=~RH%MDQ^A(P@6ձ QP]J=}".H6m?>UvJŚUV]~q6i+ dV|u :p@8j]… FXbƍF0@o'ǝ7d/"{ 8S@J#V;l?mƝ[nޝf/@{[C/D6.S v^xA^5ϝ9BK.vc7~MӮ0AH0*0Bg+d r&t; joRG>FDLvJfDdF7=d3#7~LL"` CU0$RqƩ1x+~.$S4HZ,AJ7Rlh~v4Б@s "J JA#s 9 !;4SMJFPfmx,U*ꮓM<ǻy5U])!$(HwTbB8b5xeGV<6[C l6l kMj+/Q~6ٚ^#HV{D)* ]|a0Ёȃ!I)^7o%yr=5JVdW7 #je4HyMNjȖ5!ȘeHeKY4"$m@њvr l}:V*&cBn{3@^ ]0 c pF\##k3"D56GHqEFf<%(r1j} La薂Yj)[hC\cxwwdeRtjTGEy*^6}E r{ RŗX`@p@k @bኂ0!27w Y@F AzL#*P$&ŝ \x!Æ6!-XJ8 Bķ 9CXWH Aa 0MGq<CfQP+q!H% П d hA.o><XA`A2itVG v%9vx e, ZbQ'r Dc]Z0`&A<[hpxYI紑\&'}ʝ;Ozh`; /،N@A(0Q! ڻU4" o%A"q>2jdKH7ҏDNU@gJUR 4FN2!99bp{@@~*41E(A  `jQHA({H>耇!+WsO cĻE""!@, dH@7, ef`Y)%*q`!f.Pω`@;5Yvֳm#T<&Ej}r, bbh-lz b \pMUc%%ؼ2E,~BüE/Aл^׽]:!NJKE@N6GYXp&$P&\${A^;<jA;~SplpAF0g4B1$o=`8wVrpp=s+\$xqn,EנIW1A g(VP `܏q@qjK12&6dI!&q#5rTjb+F%h7E 2vX.g;(蔺ץb.Hc0鶷}x˛ s 8A9YVfymo4'OBAZa, q :)^Iӈ@"]b |1lKb% 8#A|7ǹI"GFl{Y@i&ޭ'WW ZV=Ɠ LXI@3t$MFS\w{R?|fx?xX}n{r$ĕ$)a7 }"т![zq@z4k=ˀ« H4pgH1ЇAXV:@?_bz +"~7|T ?[ΎW?yߐq;@`ۍs;?UQڒx𿆀 9spHxj@tTh -0)Rg C7!4Bd0@H*(L;*Bwi@t@B*+C5cb :C"(=†7cCȴ? $8wੁpZ"#<J iM*X GZx.sH0QqЇXXS&6B3Xȉ؉WdTFJZ `ĂІIpy@[q$ݐky(xHQJ3,zĐ/ț{~Ȁȁ$Ȃ4ȃDȄTȅdȆtȇȈȉȜȎHe5ȁH4 LxHI}tIɜ|pEƁ11ɥDmpdIdʩGk 0DAȆiʂȆ J:$ڂH 0a6k+BS˅ȕ<%*۱dʂP0 8x oЁ+<:'0(ɾ$M49,yGȼ(2m IJxiD`CZ pU0i:EZ*(`Jg+M8$ `Mb5Nع4"H3o`΁|Hb>0O4JJ3p՜N,sA=(Hiͽt'Uʩ@Z SX~J u3P,%PшdUk :DL(G3|:> `K2N%ωRx8X<<Z?x PkI=Ã)Ȕti. BUUXȇ|m 4˰?̙ ص3pKymh  qlb33`='Hx/}Љq@\vڱ4PփHXUH}p}AY„8z{ t% 0l?ք!SK׈}Ml̓X,d kS` 5Yh u=Wx?<ٞM(;dh DU2{LY`X (لMOYڰ)2_HO [P ۹U홆t#[(i@TӭȦ`݊`í\m*ZH \_X@ujɅ \խZ\`5ť*ٵݻÅʽ- ֚8q9Ub]絴镴tųSﭳJ3%,E%q^ M__'tt6`p;Fd ~2AFa@f.^FXm~p`ޔpiP'caF '(?FjAg,OD.v/ .b6+`5^XQb!/."~q44`x9  jdximpxe`>6a('8NpRqt4j`e O:kuHsL}p֎QxRy߄Pʆ2ƌ\TDii+dd+ih}=-|=iUEe6k1݅k #Bm[;$`xxx1)9[JmoxZP`:oc E2^ў;Sx+<`px>BN0vuL9p ^%$Zv)k{&<{7 Nu͂duiF~Ih\$UU@fXM.(P^F+7-؂1J*vg.e@P,t$?cV+ 4EQ&WxZi(Ć4}P.HX#ivGOmed?A80L 6DH[ n>3҇v`rW(tXKS<{eDC@ i8XE)=$ܹ5/ZW.(%+0CP^@)õ:=M +sM@_~y0& `I8U3$dTA !`7")O0/bK02D*긣B-~yIR-x$I*$M:$QFiUZi%D$%]z%a9Sy&h:m&q9yGt'}' :(z(*(:(J:)Zz)j)z):*z***:+z+++ ;,{,*,:,;-Z5j-z-F9<{(.;"Dn?/4ZݜBc 4;(P;Ug=X@6 1_<$1ܰg}UvP<{7n> tesu;WLmCg ix 6ӌ* i3sE{F>3@9Bʴm?Fi@/uؽ-Bx)k68n4򀥎갏b?| >~$wZ~ H À#T<5=0eFGt#_1Gjѫ S(yryFÁhȃZC@…z X@6\8DzYF!)N!(>%^%^b(@aKtS>w8C|g.x dC=Tm%ȇDcVF11doBp `PPU G%ІAB@$cB` n!! !. '%$+eEP,SaqSB]:5H&)0` !PW?c3vaUяQZD@B\P̌{`U BTH8{7΁Lڐm쳞ↅLrgWaI a 'S#' h*P`N$Y%&RI ?X `g !(DL]'!uQEӊt h?PLUB` [$UHPs /aXxOkڔJe  -P%Dv/4 T?Zd"Sjx*X-gZ{*ly@kBlP;Tpc(\c#H(D@6Ci) 4Ád Ya-/=e]fEdמfdd/22P]͏)-t@C&" `ˮ"H-ёylHh\4! /a",aziS!YW-6a)|qBx9g~e"}l~ tx౮@͑A WHXʝ)Q%DXY\@r[OCϹޜ `PAZE,@M֠B@JɖDLC  D0@(D1_V0 nK/-BUUL@ aU8#r DU ID@ 1haT(F@a!:oÙ|T! ~GD"0HH#`R X3d@0ȡCAE"*@*S"Bba),J(bfb-b),+*#11&c*R262U#BCa D&$@@5-$QcCA `F< Ą##>`6D%NhATB3U#B] @n:F͢,8%$FBd{`՗ B,➔]n }X`<\dfdF.DyddSC8V1D:Рhġ%R&%:D8ԿCKM ØdM>>jĴ% 'D qS BB(A,e`C1(J T& R&8HI:@ $q&Œ Aaeen nC"Fv%T*TMLYz}a zBQX[&1I6pl6!_N>Id8 LBq}dq- (G ʃP2aniz $J#xB#{yF5p#B,&ȃ}AyW6-p(i$$BC#R?N %BˆI-X@SG" ,Gie)LR.:)RBԎ J?(\Bq+%B[@V1@%#&'L#$D<*@-X^ <Ꞙ[^J㳼A,`!x G(4`z!uh$y5.BAx\ LJ 9ixNV۹&Ħ2yꓢ D@+xT%*KB+[>ҫ'V}B'.2iBP}-2,֓+֫*r ,@Bgf,6,~+ҩpO ,N*~*Rn:,ԬZPZ:l)|C>Pю~*-BiN-MjZ@ )ds-Ulܞiea: FŴlB8&&.`j-}@@pCKa@E8C<+m@Klj D DD&5AD<2D,84*+?h''cɐWC2hͿ?L1܌C9-D.??Tr2&e)L P28W8/lR$<:ӋcZD;ZssЈO>3=4?#to@W!f1AAC#B+CsFF4uF|8MIL/DK4HIkI;TJJt tM󫂽P tu/w-3į2p|L55SFcmsE|hhV[T<}ѠD 50_8R>$6<?HCEÍiŠuZ=Ҽ#E@B_%ă:6D&RSta(1D/e#D+ F=h',BpOj^@2CГ 36vg؋Ս=A*B2ClX2040 e@!vo"(6dv^ M./DR"@8Ḏ^WPhv= T&D+)Bt@lq7rU8?oC7'@w:6~[ 3p<\LfAi#|S!5P ?t<|@̇5ax~o6M$LxZ8s 1C?u@7@#T5$T 5$Dr8B(LK.-C*@BB+7d*+\@ |$rK޹P,5ZDCLU,Ch/CBm2Ń7?>GO>W_>go>w~ >_藾x>ꧾ>뷾>+郾Y350) ۧl>dکBL;wr:GO?W_?gO>W H==#`u?05? TjC|D?׿??~?@8`A&TaC!F8k(8(9dI'QTr%H/aƔ9fM7qԹgO?:(PQQ+iSOF: BbVZv UlYgǦ5ZmᲕvn\w死/_]=%UÇRSqcǏ!GV ᰝDۃX F+ 64/q@\K!M<r BV`4@ 49Yu[+@ /`C"z(P2A$7ޠ/9dF(&j @a ubF<0DI$[,0AQ 0&Cl7ĸ (gLt3IB T,, B* Qô,` O"n!M R )*BH4!@Q7hf d~L;16ybH2e d8AL h<Pa h7AX@ XAvL& ! :B9 ,%2YdN$VXH a>׽ xBX  DF7 BQ@ bJG "x8|#ِG8Lt bJD. r3wJ&HsNN E0A[(r-rQa -] YE5,^袑}oAOf%Z$]+J Dp$$z!`|AjIfr DP"(fvrH",<*[ P@N#zZ eh:tfg#rGn@N"Bza0Ԑ 6K AznI`un bJp %\\`#R@$`! 0& Q!`Pd“"q\.#^##:zOnN_ !SЏ>0@p   ‰0 m0`pQAvAɊbަ%^$SN P!!H!jabD! `x @,NZR̃j.EOeHOg oJpi!ܫ406(v)XLyRtbJPSb&D2(%``[0 ." ret!za@ o )R*pDbdo.2%< Я,*6"! 1ub1p0`(s3k2w 3TI4MCb4Us5Y5]5a36es6i6m6q37us7y7}738s88839s9993:S5Rf::@0;S?R;sdU,4 SeI(b@ `g cd#BRfiD[L^jC"#6UH \a^H^A`aԶGBq 7rc# !T @VW Hw&@b"@Cc@!'7 :fD#"XRkn/`5|jEI"vbdµSCB0<6L 874 0 P@_bS|WS[/ \$x)<;%@ }s DMoCp!ѣ7PA*_T (ƝfNF ·iEZ$\w?$o=΄S'" Y5h Z<"8Z ۽[p ]R*Gs%r+_%ǝwvg(Cu~["Ta!ӷuVA>KV;S"] K}P@= XTC/'$X~%ž+>bY *sr bB?:  H H"[ '6  ĉ L2p 1C׏hʫ] 쯽*i\57:k:9kVmIA`P @<5;V?˯I /(`&VpbZ:~^p7PlV=YqM1C/9#+8p;p\c{Xy1 IP|;@;X @Hy:j:R1QK5{D2#QORJ,֩wM(a#xj3zn<@wxC?@m! bRDb}xJ4 ݟN" Gznc3ĵpӵKxaGw- 0b*A$A0J3ȑC(᭻P@Di@7 9J$xAT^5ۙG6}Ac7 E213`ȂjtWPgzh IW8A+OHI$Qf& 6Cs`Y <$ !Mƒ@Y~v򍁸 [ $5--Ir QdV(P)`hüu : PF׾6ZiC+$6TjdM( ~^dEkcJ B J4$b<Б+"4_2%TO&_C gg&^C(%"يebsܬ4 2K!E4FJAns7 H )G*ۉ|T8YH\  >Є8[ B/ь҉*g-H$-IsQ'x7|wҘt!,P%OJ@PuD\+ 6Ip'Q zt( E[GST<4ָHY!\d22(L1o`6 $&]R('ÒIVu`+1 =#UlCDF]]0Y#I@NN`f;:D F8r AF  D)H*80RC A wb+^T; ) `֮F6=  UZb ,$(r a@+*K1q@PNd-\ʾImAP 1OX!{'`GH,aNBF(x"`_v\.t]B"?J$5I$DjA 2  bb0!=No^ ỷ&ݓ/y )3En*cHÈ@d8/2u- H 20a Ts0TX5 HZd6ə}M $ӹ,5892 D0pkTKFaϳ&cd>BH:fAX/-J7{)w1rlȓ6m["8GfF2%)O~W$Fyy 27 hKD6PWs2g]yЏi94T' \zŮN3^/[?ޫ`!;Fɝx;[ $ӈo!}L{9r)ЗgCSi)i/)993Ә*tVTy:w4ͥ )7e0i9ɛ8A i'ʼnfiĩͩy)i ԩɉ)yiI~D)I T~rE iUL#IoGـHw *98sI*''U *ơR'#+ʢ-/ 1*3J5jbw}`x.s>Q 0 \iͬ[a 䵧= r 1S0: Q `'Py1$b ̨dX'E İ p0a! &~`E k qN ƒ>I0kE\ RF. K!˯oak Qn@ n z`x ~  `U2C%NXE6x3kț~مV-+*AzŴB`C"lV '^ -( @RJ ,+3X+67Psu` 6B,H6-l!9Qf^ aH "4,H XnO%0 @&2"-!?(a`!:! ^{H<(fm~_z?%b)JEwH ` o,B1 * h*N[ KfͮQqdx5Pd!KLss\ CnrlfdAc"c#f|fʂxsy2 >`#=z;pYede "Prl\ 8ԑ2t, "r]mcXzȲƈ4xP&DD(GD1b7 YLX7ְ`i"tBLAQDD4(l$bdFv I^|Z.urj9:"8@%rIDC !M>@f3!Ch}YcEm,`Ҩa@# ?]@1!un ]) $0:&j*:p{=3#$:G  q5<Diҩ\{<`؁a0*lРi# C@ECE @p ڃލZ_'xciVI%C@@.r@9gl~|{ 'Pfg+Bx)/1CRS81S=ˠzhlm p 3F>Q3C@<)3(lsk2,qʃի{ԛкA鲌&8+(G((s)pb8@A3eɇ9A(I =d 3& ͨ? в,B葹Ж胂0WxRxHv0Z8?ޱ ²B>AE,$5dA|=ۯ+olxKTOiІ2R(@Ї@BVTԫX 5VE葝8 XȰ|yU?} }`=[B Æ1 W\Dp eӃKF0ue{eƊ@E/<㇘{~; iGL>FlH|{|0~>Gǂ x I IH\IT. B,ɖII+-3 G@ʇJJ$ʫJJJI KKR"(˲z$K|K,w˂˼KK˸ ͭ  niF+޺=Nb]<  }/f4Q5 4R D2w OM$*%(e Ow zPgpV|osF0FPFJ5  _0V;\pup[D*1 "1D0@-_0 GXJH@Q Ox@U tq ]w6# <}A.0TfX5@Sp@!]>)@j` p'CiHFaH:P_G X'z?p8؍>[8N;!A7lN/ ) a6<ya(x!x@SX?@ً툐&`c w:֘C@v"lG#V,`Fg!0Y&>P4O'?y66ٸ0 =RYFJ/8rs\sѕ] `ɕb96Wf镒S a `oaavyxz|ٗ~9Yy|T`BɔXɘteY@j9YyYiٚК )Iiٚ– ) a`GJqٓ)! fiTל *y?)!tٹy)yPq9! LOtW6 ddb9 qtQT) :HDA9'Jɓ!JV480 y)w!JGנ)!!p Z!Ġo8:9FI^a% R`,r qqނ\y`t@tɍ Q Azu32(u8!m  00xpp (V*|qJ b0a % 9{QuBCX+%ږQ!d2D So` K{U ΐ)SR0 ŀY@'Jŀ2^a O+q0QD tL J(Ԡ%yѤ! L4 lk%{4#͂6 7w8QL; vtpP ;sA FNvoZ $'#JVKz5`!9K Hv(2 0(FIꓴraaIy r &ҳ]cL^# )( !0(+| :'D Ly& :IaKd`k!%A 8">, `PU C/^$ IdMPJ+'pk6,`yF/X,CZf,0 Px ͠43ГPQQJam˿9w6!CX2Y0 % ˍgFeCm =`u).Ót#Б7`\' j4䫘[!l5r B/ LK":홹 :Pŭ!7)b)^N:c)e+6ƖR̹.rLL'ebKOqD@+Ȉ*Ȍ) aō<ɈJɘl)MɊbɐɢ(a |ʁbɨʈUʰ'˴,˗lǵr2˺pn˾XRzа|9\ |",ѱ|#,a"]̜D*yR vcDt K$H}L =-u;c  8:E }udC1+y 9]I }UWY-u_Q؜uGH6 gC@7 :}ͦ /a퐯q 1ivxZDp'h6okD0v9DSaצ֩m'nLR֖xBJDQQC#+'ؔ VGD emN q~,GICo܃4C |&DoۜUe]m5͹Y^0Mu}"5`&YM"@c0㑢t.h}M0!.O '@ꬮj!C. BpяNwО ⏂>NٯKx,.N%!AOmn>c^䔂1Q!a?l@`3;($pclx0|~b M[M&_/GIj0 m,P0+ڤnҰ ȹ gٔ"&'U_a[,Bp)mda "C! pd zU: c //fg1+n)} Fr iO>Sn'oa1 0\]@QaM8y DPB >/' ^ĘQF=~D( .%MDYƍ#L5męSN=}:Ss޼EsN3-F{JSU^jB+Ȥ ReEVZm1NsYC 0,9MҜWpIcL5X50d )crXfΝ=7O1d!1g1ݶmܸY+gm"&h 1ެ(ᐓ2 #dwǞ]ьq5a˦}zz`B\hx,A_t4[%`QH@FI^ Y A$vC( ?1D}kċ-}Ld&c[HDJEh^ `@ j!8(e:1 Ȓ4h ]IHoDH  YĹ2M5dQ=6߄󢨈à@(2\ѠYJJàN:!74RIJà/ RSJi &IM z(Ö|IeԠM1T-GeYg3v bgZs2‹l6^l Z"` Gx nb#+ln9օxd6%/iF8ahٝJTئX* @x%tPT1-$1[e>bpe( 3x;2"e`ɹhF:b.=R&fxաf.`hQO*eX1h,@?Hl<(o(hCr33aj6ڮ ?)b!M 03a шED"&p"̡Q:=2XŜP#4_2NMLøF胍N8H;5 1Ǫ B 8HBҐL ̀HF6ґ$J.HVҒ!ׁmdғ%odQ.~4pҕ6-^}c~~ ;HV%BDfp }%3- R eQ'8f̏0g'hGh"l)0:JLcH_:HdhE''|%ؙS,xG֔]DugDuBRjČ!HAhE1"A RliQD' yh'V2H,lS?LbҀN cP=㌧V'BT4B[UOլBmӬT:W0U QAmZW8,X !Ph )z@Y`%;٢ }AVN @d&uljU0T"!m\q&snqJ( nr{'$I;a*82B\vCCǪу pUz5A|}{0le="#O߁{eߌ״fb U GF<"1Ue C'n7$HF2*7 QxBKWڸǑ<;9O2d,rEHe.w!K @V)rĩٰ[f6ӵT Ќ$ )ed=;5V`7!҈)! %=iɪA.@{ >=ό-J8 hH"qULjA`,,ô0H"L>vslf? 2aCg܁^ ?w!9 1ٳ0DV0;ZQmӠK0$تMšL)`hpK%BFhayC wӸ}?>r3R%GyUr/ye>s7yus?9DNzҕn#,ї>uD=H'#}pl=6>vD:׽ɰSa|ģxFBZy:e؆!{o-iG2sPB-ʽ5zw77y HVu~3B uA&y҃(ah!]r`7(dnw0~z{!A!:!xUBoHPrxmk,uB:"5[A8KU=@<O@g0؍ p>4`H'e 7@U|h``{Aa;[<kt8BAe!%<+B_0"Y Cl @3e@ȄJ)@@R(: IlHtx6&C"C@ &IQ(h-`4h˃wPq1`?9B+ض?DEK)J7'm;"l)@/{:3 A_0Y@b5Н4˾l_ = +>hɃ$%PɎ 4LLIZ(bPg a_5 K-@ՍI:C,|V bXL -iؾY{A8`قx†܈nd͑LȮhv xL*6Pvٶ` Y0Y T2VO5 I Z%aYe8Up0_ƒpЂ X%8%BcV %ish.4 )()eB>88VIahP* u]¤NAX1B0/Zob}H xG8Y8:P4KH( faHZp;2`LhW܄0새۾3- SKsJj2/  -XNC@PIo8ņdxX64X ::Y(IQތHw_+mm:3;4U?8!nU2YDJbBă4 xN VDWhH4FN*8#5.@$_b4H)w, |6*&]E @&Ӓ]B-tGXv m$AhCQ(ĦuJ$j^TY㣝z.@E3œ@ɕnhքO]TD@l(z~n((`S@PJ4'UZRa:z*N!1C*P41A0+w0fo\i`CӳZf)<[.6xbJQ0 l^VBchJ4ׄ#<פRca6 ԒA|1 KPYk̹d}O6e]R9|=H@5$ca.zpiY]i1@SMku1MD6M|\wEqR؜s6J: oҴqwF6v45I7+ADG) hlд~g7F0RG@HxN4O9뭧# ~ A5nE Y<6vNQo'F>DNs@h7s3<@Mha11;n.+ D&4Q9ұ[JZN)A =BT`!+Ȃdmx!TMq\AVa'Bh)"-r$&La+sLHbM#ev䑤@ !2)M8HLQ!d4mS,$e8: F!E6rbTgE5'@)O2i " 2 5vA\._DэĐ IhAiز3@7FNJ`7qCg)Gs 7 ҈7K TdhuF2#-B괪[O "!8΂!f?r m*jյj4d@0EYAf '_(heU\@:q!sXfl_xdnb";x"J8DqЖ= mkԡ)l+mqႶ6iAV(cťQ^#1LW uJtiW!Fx d}.zӫޚ| % koEhYcȢG8x@xލd @v 0ErW/ tZAP_C<n.`>(Җ7:+j/IY̱@!RFV_>4Q+lϽ ɐ³b!@0Sֿ~?/cgUc}0!I>'ϥ?%I^B *NA_DAT_^ j._Q D2h3^ ^G1R B8J?Aĝ &D @>!H\"TD`Ve! Naʃ>̃ITqaaIX W.haY C@hTƹ H12mC [ V"Y(AQ X@Ā XDU|3XAȂ D #DD@T;8`bz)U%^4L- @AC,d@4ACD*/~@ăPdH)S8i6l?i@#$uʐ=+能aIAT&G?Dz<&2'ҠxoU6o@o^@0&?WOp6w0~eNp}p pz08W pwyo!D l Nٰ%1Sh7-qԄ:1CC,am1w111111'1E03L]1!2"'"/2#7#?2$G$O2%W%_$&o2'5TA|r' c)2**2++1)orln9z: k'jሙ `R"6b!/ @ 2;  `(d Ŧf+HY(0{P)^q # K* a-%$ ` I `2ʼnW44(2x">H)V3dA Nf**)K1Ԡ; e *azDGPh ^!a4!!#3LI~IA_Qe蓁A$&XFhq=B,ЄNX"w&R& Ox hN""`dlV .`8刉2 GQ͢Z0c * *!V\H2@AP ]eà#iˁ 5 2A H僉lo6!~#$,*?ȂX1x/p„\1h!S$[,gy ya.jȖ!FYd7Z*fBeB `vq)YB'hajfbzEaQF\ ef]rU^,\~dnJVS&Ufk Tj%^fE^naR XfA1-ZJG^paHs^v; dx|9wxK`Q eB圗A nF1p6T lˈ2|AYtw9LYZ "b^خ ,$_.  1pC \V -QA(@]@d9 C#e"AdFE.`DF0qiv[NxHA . ]/$ZxQWI7\вl674&3̜5Bt|;c22+H-M49Y)㒉 pXz^I#2(q`xU^-LtK!^3;  ęT @2ZĦU(ZCz5:x3d&B ;COJвE9zS-.HAɼt]W;pH9r/VΕ@v*R+Iࢪ}5aX.6Ao XNe1YngAZю5iQZծuka[Ζmq[o\5q\.us]R81]nݍ8[z5t+\#8{*h/Aʗ/jM~. 0P gP8p` o}E Հc鸰~;bئ '?lb T&/ /M&. P0,8od-oS'X,Xe5{+]P@r=cW󟧻@ r:1VV?:hIAC0װ83 #ީQ-Z0`]`GŽT3ǻ@5@( oglU| ivCw^cdAdh6!pv"],c!_{@n0;ٕfҎW+ w8$#ӏc#Cd ě3+t rr > }އq>NncG?$+$P@A#ĝ[@/βc%췿o:AnwpOHv.8C y~#`ǯE(0X@ ox(Q yY'' QFi;di#XPfx밑y [G.W!bx\/13zBX LqD@6+0ш*g4_"t8Qq,m6W AGAab`. #`"@Jc Pi!bJf hP  +g"!`-!Pڮ#2>H6  CxaPV|k" "@ -M %A<"\  p"/B>c[, rx "v`A5 Q!؈ /a<A6"%bP">]1֩!,Lbc!0P#7AA7!W  f T L@j,_МQ7⃲!FKбRVPڬ. 2!P!qLqL2o VAVma#$M#@vv@ n@pD!K2*zDJULr(5C&+b mV 2T Aǰ-+HR)5] 3% R,a+"R N PbNO-7h @ "y2!`r& -An& ,+܉+D 0FRRJ: *"B47&IF 2\`&)+2nRO;ƁP B6a+C2+. :; 6E V`To|!Ĥ$1qF*+a9N:/#D "4Q;;  6!`< bS m lS735!6+b9 b9ABAA  `Qi(b` Ha$=4Py$%FK 3#2FCm42pTGK]k*-" haCTS" ϻo N;b ̒;>{ dtK5G"]`71B J!N5,̝K5˽*LTcRk.MA# q'*PRNs0 t r2@'l$; 5V-bV BQ@ B` O B>4 `5?J3AM"uGǔ dH;DJT H%,7lD3#5٠5RwL'"u!; ѳ$a@jP7bO T#Y`>RvbK "1+)f@Kc6#!4ng%bV(g%kA6#PZm S!,bnt6 fe J$\! !0 Bi1!" wnKg``-tLv! Ze ̒ UrngqndOSL\ Z F[un"s P5d+ 2"1*w'bp*V JA `v Q: q.4bX"wz'\bl Xƺql1FbL2mUVn"`wy B$B b G:Woz_'jM~up2nnax. #6!ֳ |7x!d7"*bj4"Xo*,0$B!2f f|p#u!wF};86 T_WJ|n_3"٘ 9T]V` p"7vC7@Bos |T <\BA<-"馡1$aWRfA##@ tQ,p!G!xvkS 0)'yA{.YD:n!a A:B`:ޘ)1J)A`q,YxB@9"I'"qɉ˹-!x+"褳+֘J!гjp 6}|1uU\u۲Y!svv o*t (ߛab"\@6r¹Eϻ\&Ć{ یv஌ ^D%Nwá+4@3+3e[ d$x1$ƫ``HBO "+@ r[Fόk8&"䡆늱 b\!dAz^%8ܫ`O蚽ùȑ<P@rO<zg[Ƶ6k߈ѽJ@/|Y..ecԵE-ͱ4TC`}7@{&pP  sj]`W!Dű0A|F{}yn~-]5B e(|J 0'wT ; \ Ra R]\\RL+S}cq3b8$)E[CiR$Q ۥʽrDDkL>!#Dkajk39S^`R>gT&}%pK>Ÿ~#a `׾ ~>﷬~YB e3B,`. #;R@~^ c%&\!Xo`E|ፎ3f#܀!~M ">?δ"!e_+"7qB < G06+Z1ƍ;z2ȑ$K<2ʕ, ?Ν<{ 4(FSjiiwqUP3v*4֭\z 6؅/c.3@ͱlۺ} n0 %}msZ8o=8Ō-+!Mi[9s6 <\0e+HiQ<ѱU̴k۾;wEgӮ <`vqN  x a`y SS[ FୋD?$yK^[ EC Mzv>9tC3ijEmagAhۇ&'F8E!0BBP%@>jES08L 1'eRNd7DeZLA H1XPtDB%'[s,DIx Njmh.jшjhR$JTJ'HAЃY$9A_%A* iAP` kYnPOFrJP<_uDCGϭ> -bm΍Enc@ZU>/-ăAL:EtmXU<{w4ZD+xܢoOѴR : q"K&r*;k. s2W6[&?OssЇ,tF;[J/t=tROMuIWuZo(\ vbGf}h/Zr:Mtq~Tp 6BkrS# >Ge#9q@xNz+ 8@Ds[TPM̰e`8PMvF4AX7OsZ9X@.A }AEDXHbы~;E_LvC)\ L>P PB2Hs r jPzBx^Aلj 0t |!HD#ڠXwD4])R|8 W)H'0 2 JS /2YaADaZǿ !B;$<U 88D8@|${8y$ʠ$/)6AXHRJ\!PGH#ŠLsȟ:L eo8eˬeG72X5P|,O f(P R;u#WX  e`cYX.yBIT>LI8yU? I9A@ 0 Ph7P,ht^bΔD&˨G6,6Te0ȏ$ %48h$ G+p)LqAi|T%- ՠŠ~m!HC]2(AQqs)LG:b* <Ԩčay֬`Nڇ8~aC UA!(uНOR xi!z'! !B}@Й Nӌ, + B)j߉0D ޑ,xxGFt>vOQz+xH4?I/4 2 !tM") $0#c70z( YE@0"x B }G @$@ G@UːJ¡"@UgW~V ° 0s$   ,! BTW,D@WO7 grS~`{HjH~,+X#l x|a `GStA@'bTyN!G`sH ? [ pð &b AG{b W P P @  d Āpxl7l[艖sz+HSS2`6 @牋2@ `M! M7 WX ʀA,0 h1 h+8x(E X` 8e `pHhΨ piƐy؎S2& ` y`t8m!  I* p9)YaH g+ VfI a2ilĠ P ,pP xh@YDF~ .gI `Õ Bfm vyy Y^j%ӂɘ阏 ) 0Yy򙔹%@i_ad_opo톛@ny/@BVy6p y׀ yooUaUę7oF Ґo /RuWCv6Un/@~%M8lNfpy_(d(*I]|60  s('Qx  lg $uЂl c 2IӨ) ELjC7@PmGaRv#Z D P 0Ӡ` FBrA FtAZPzEZv"p&rV?RvP)НfQ?AMyg6pQG!yIV T2pML" W) 3XJ qEfx!R7)p "e g<{a=* nZ | ! xEҤ!XGw$?L"e{5eDi ?Oa=Jvp8% D zh a8ta1߇znB ye7~^N 엤q[@@ T@ 3Te !4&G7Wakv⁜0@zz P ѠX9 V, a=6@ApABx N@ {[R7ǔ\vtL ʴ rV7 `u |~WA݃ M'߇n0 R96 FTy 8$:Q S )>@KM[nZyTe0!Ű`A9} *rL$Ѝ'AQ}^9c{ה) ! B IIP 0h;v DJ` 3z!zD&/DA p ` 1WBO3b G;yP yI wO Wx~'X F{;="!F"! qE0YIS ! :p X  Z~zѤ&t"=n`Q zpz%adR|LG't2!l` ' KEa9 l. 10Tt; j0KQ!H` UZ`$RLV j w]е !*X~Ɏ [D`#AktsԸŠxE@ M@ S gZ0 { tA P܌ : aso-A cKp/z` J0v-RAsQvp|uHm@KVpR '\}1 tbaAgde1 `09tF` @]P ]1fEa1hH@ ْ&; (nY h0 w㱰-A?~ `  `Ҵp hS )\b nXQ N (|ɏ%pH)`q S8ܾK"{{~j K/oUk$1 /e2H pD.?l2Q%8 F-/&hf#eV `>T 0b 7 r5_n xD?|'1JU ]x=3Ћ^6]Ao`cp!fmngOԩ{1((>e:[Z"JQQOaU#ojSmE1 O6G_Q?/Pa ?nC*o2o"GPm"q_ՏEdu/A .dC%J01Ϩ`Œ C*I)UvTK P-M9uOA%_QX8Ӕ6AIPnWaŎ%[و)6!0٧:̨!C~;>qa Nf0P !O7 (iOQ3[iԩUfmr\ۃV;h*!<ؖE^|L xDnX+WojT)BHrQfA)0kŭ(hCh I g䀄nA(Jj.Uza N!FJL*D'Ńdi! BCKhĘ!=.8쐡CspQ%CJ,Ԓ!,*3%"`JQJ=iN0r,*F+cȗ 9G!dh gKL3tSNGO$ (mBȶ`HPSH1`JVn|!CB*G@cO3 :mQkv[n{ZhxWj/Y$୷]kHQm5Hr4%73#5Pc6&3[&5a VydKϛ! 'RPDdZރdQda--6:C:# УFzjN0;*&h#i*]ȄQIҧ8fNgBuL|,U-7=RFs|٦jn&kr^6u7$DInT>tu;8=hX5dH KHmV晸ͺm/&g~{W韣DhR"l OPJ 0"_h?-yO$` r, FtUy`7A fPDFO>\eȓ_5SGA,U!+Ν('.Q{HԤE L5`(DOϿVt4I~D$J5G ԈDzeQY!݂va[(2%1Ё@Dxy@`H(<FԘ=a J( 4!bD(jXf MI' Qhi&rWD#xiYߙx#<@(Z'Env硴H%Ԥ( (K.$݉mѿ #ʹK/HG-Ԧ@1ԛ,VS`_usAl,:pKB(F,BY `t"PJKbn܌7 @)-$9XG4ݎ:޸c,R ,Y09jp -KB{n5Qh@F(3-@!̐)ɗ' ?DlII>Е~Xb: $'a0 ~ !L"~E)Bp" (!p&P: ec/l7#!P 2ŠiXC 0tA _D#HbE!ZPq"afIGĨb$ŋbxư,'@a&L/xZq h.L6Zd]#bGBH4Z6 E⏸XdlCH.zA\r*|`>#8/f< ^,1rnJkă.tQ/] H D0QLx d ğ5u\%-baE ^ X"MZp77ڠ`M:jqh{60 ğ7H^p]-F΄0>L6M(͵XDj28 -'wJ j"R,PT "=HTR0Gf@Jջ0Gdc oa@.bqh#Y"ɤ80=]CA%<'VH. )2$yp-L (TAJ Ĭ4 ܀^V@Y #D 2:8'oY˨SĔHL & ꒐uٗ$9A'r?NDElA`=D( H7e @Bw  [UCdj=ڑ؄NVRmBS& "n;";+6!m¢k=!Pfox"oj'ɋP&$;Hӄ`Hސ@ .1 F+.)H@%^n2ԚS2IFH8QU2JЯQLp$SF8m<- L!01X|tkv<F%&1 ([ AR瀗 SF҄d#EŁxH +Qx{iț wiŢ(&zh_WPb)CB/<Rlw#=>H9Wu0*{ՁE #*j6mK R:F—V,7tw&w“RXNFT4 & ]&0WG] *M  w2P 6P&x(w,hт-028'X6X8;h=8?A7XFHCȂMHKhOSx`SQq'0TndM?Bz)!rS@cF #m iB91<@ 49 \⹠H=7<4gE!aP 9 YТZWn 94uvj a: wFu Q?6Їѣ @9*aJVP @o m0 : *Kqy?JDzd sB#*B 7H0 P/J50=B< LP 5g`, P%e+ &%P(Xڂ 0\Ws;xB Đ9 P e 0 S p J "H6-t  0/t p r{R4MIJCH5qw `:*@BK[$F{c3 p3 d!|54_/ʵp k:` NqFŀ6{ KCp? @.!۵MpE6kt3p/z"A+[/T ޹<з?B@ 00 ηJ*9S:k!JeN6P <D0ٛ&N [*JJͅ Cк$5W<)M \¾d{H.!JS/9qxf A+?0 @t&L5A\F|HJLNPRc!3!y<,! t*34 EGI}K6 28: aZ\^`bQwYaI: QEc|~׀Ձ}!XnM=--x1rvXS= P Cߐ ف=۴]۶-DZ!ϼ,͠Uoy=]}؝˸qv -F` `LK܀"Q >^~ >- ҅b`A|=`E( 1&!K ׂ :Qa6lٖǏ]ؖ HL&̪g)%L ! pEp; 2IBG y @  V TU^ŚUV\M7PVtmm*|lJ%u`,/$zX`…_56Y-bK-@e z@S @L,exwԚՋr͝g<@괂{|(5663^ݿx6,$p.ʨZH* F g.!q0[lh`re E^f%ct%YŘEwGN*%Jf:#&F[n喁xQH/(ZiV X[oM[qRV qkeqmAA^{pU;77E 7a'Qa`>Ҳmu19d4VdO1he(9yYQ~Oc8 Zg{9趨 CF}J!>U}j.jjj5YF;mFe=5{;oua2ݻfsGynW~0qy駧^Wjp=Ǿ{zZ ?}/L|#|ߧ~_rT7?z`•j3; @J ܔ@VЂCD@D !1h , ǽ Ѕ DvA݂IA#Z|&P y7io{ax<(Ez%UE-|Ur[b;"9] ,eSTInw2)(iТ:.D$vRQ DhDVҒ27Frx+%E9JRKul])UJVʈDLV+V;v <}#fPiHcE%4]6兆LC8?X*!x:}(DV"BNr>BdjAυ|4I;PHdH  xPt\}C@(Pq H+ .#g@pB$SB@!`7j$yx80<O "G|b|Rҋ0$ lЄB *TcqAgɃ'[H-!GXï@m$ԥNۛ2dBji9h$҉D ˸eDpu5X_"tꥵy!ɞ8!@@Ʊ dlЇ?uV3oH8<Xg ]rB- ܜH6>p(*(¬n޶y K{߇| ]-"x y䜫pBqt/ 7ڜ*䨾p&!-U񇈣cfAQʎH?q?g۸yN3ʨnAAuՀAn;-\غL. ƀ#"uW9Wo{-6p{ExCqoY 5Ae7,lH>6_Li?^Bڭ7z݀!ȼDS`lfn< gxIaӏc*"(ZX{GT=*y'ACF}3"?xA&㬸靔Xl=@ c2ux0p}&yp@F!@18bK@AqлI6eA42)AA!A(5xA U"/ɦl C{J?рm@>~ὥ} =`:Ɂ(6ƻG+,BhK $1,| ?_<*̛6R `URH?P@Otc(kA`<ˑDԁ 4& m`2CQBAEj6y&hzE([@ " (!HA_ж]Ğ5,Xe% BKNb̸CKHFQT?sh>di@1e 8BUXp1ciLz .ȇ;n: DG hG\)Hpvph0EHP$Ec0k$.\Le0[ '1xB(Z!ZFQ_(hh$ZZbJJ (S|9(`*p{/rklO R(X '80  &JʯP: 1RI+|RDTyX,kRWJXKՌ@B( „pN͂ hhOЄXěWCl:H?/Ld\10x452hG 'QZH|> G@0-ΦؚR(&(`?d0$Э2ILps oуX xC+"p0MCp$@ {̅hЅ-BeD $M( "atݓ9::(f8Ԅеp?kfNTM ءU` x$12=pkhTH`B6-};[UV"3EM]o A 7|Of7ЫjDG!!"`,.t3v y x)& bxbF)Zy i`6C(IQ68f] : M@, X{Ff?bcAF͔OplP΅p$x  @n߼}t;:Ky!P4 Q|Gě.MI<`Dg8;T" `HAep?}1ĐJb]W X>A8'IN熁;sf ?3Pl dB3ksRԂ袃=CEkWLE?poDFzDXeRd(u|r[#*#UuZNx=0cH򚨃f4 NI0rXAS//rg'Џ/"ir> D8mq#U+~OgPKx!B~w`3W莾@BxkxGkq.yj?gvy'_pt^r\= qzsj(Vҿx3WJ|ztz2PE(/zp._{3v{Bw6'go3v }"zQ/.Ih`0 On !>ƻɇ4OۆP&66{~Q 5@#Bf{W%aZXLn%$ n<ʠ#߿kiuP vZ|(xpddž$ g #% jg`LeK_ &, < 9%,0 %vP! VJbD>[R4 Bx)w'РB-jt!m)ԨRRj*֬Zr+X(ד">& P(K-!0uzITPĪpE(U4F;016q M(+;@k 39 m4ԪWn5+j`?l~rҗ/Fcnzd wK$_bOLq&&wշ)H O6ӯo>{@CBIDVO%4JJ(d 0x$e v $ JV`fKx\@71_J0tWxPGK#=#A 9dW1@(4Az@ K/‘D%*&T,l ,&C$H$Ot& 0VBx[2/-DMB"PiD:(J:){ OA % ?|Yw5A\B0h=cx%vQ[:41a9YC?(83 56%*$%51)NXz.骻.zUBQmQ`Dhc]Aﵯ* :Ғ/YĠ)'.$K{(ħB[:;DS'!;+<gH4N X. <> NN{Ht|CB+4>?㐔c~Sv-I"Ch@C-Ar$[E,A l`/Ѕ.">8[)'Hq@28G4lй7*n`H"PTDz@Fb4B*0(DuJeAO0 K yzQ @L!=0A(TdqEŶU5 q8(DBX-쨅Iy`,DC+ E%H`,z@B CH hI3qqUBpCL$0BX@$ 2+$ ND)#ą@&82`=I1DT#$ àxD2"SdN,17K -x/DC B f-МD-2/i$BTP/10B<샱APC6h506,Úi/L)1B>:/ C-Q-D.gJMQjvHPC-1 ,T&82XǕNHE-|,.lJHوbi!EfrE#S%g!lB4X٬hܬkQdl-.DǞ2BQ]{pS"EJ,܂-l/4-P.4,B&P)d]YB`VV`!F)kZkPl.D*flfI$އBZjНDPOPBi.JDv^ٔR&%>o /u=m^/8PW|A~lUU///Ư/֯///00X&0 dkGBpOP_po&0B0u *d M0 0l}(:l.BBOFhpUh pqq\7C՟!qΌWVs"b lI5Q]d5s:/D(DD;;;Eg3|܎ih-s$sSȃ=DsU'OL@@UwHkhtB"tl(4hp|Mj~NESBCl4:BKD1U-} FvG3eCT@A?ukKȃ2H]<Ò[, {<83BuP&+cN@dG];5hiP}tNȷ|6kDw?L7Tw3BA @]qF,2MoCBFsPdU[VD4CtAx$6 ün-74Dt E!{7OO 4VU<3W8`v1܈KDwgUN8?yB4QrVhBvjW 8tŒ3yO@B T hJSZ xA?(7QtLҘ6TSP?NJB;k<tL`σFKğQUU ;UF _\˕OXҳSP~V7x7Ql&P CN'G'>tB$+?C}B|/.CJ{AeDнGƒs{YD+l=B>CԿlhYP &;5x (h@<{ `CC'#( F ;~2 N4董ǏE .LPԹgO?:hQD<pEѐ(UH5ܶu:uGiL h?}x Xwm_p}: ~kl]Cs/4yĆ-./<ޢ\pqe{(uo߿>Cxڰڎ20P:OkKpu4{ 2]*9܏`sY P ,]ajhV}٦!56SpImBk'4j{(p^AA/,p`VfQi<~TWL>HE(`W;n^`n +Uv涆CWu4)RыR3A *B)A%")C6x)8ڰP0 dniC4e4HxFT1AiTb?*! @L40-Pq%G^܈D}EA!!E7FrR%sG$$E2G(Lh %{dd RKc&">d-t@n!Ćj#X + -8}A˪A,dTe›V^L$k,!9wKt9"SZp SX&uv: MlSGe0;B @!1uFGPr!XP>F}R@%(1?"pbD9ÙhMG$c9d#GENN>R.;&&JE"P(P^ QzTZC-?*A< %{Sͮ^ȩO}ꐕ k_XaqUiCJ1!@mPGk oa C#u֘humP9rp79ٙ\b:BUԵ1V[ې̂+[) ц &csx&+@7zhMM:܂bd h"(pӺERu훗cA$Uk[6m Z$IɔCntϛ]dQk ۉz p vϿhGvD6ANQ풗<. '-fQM&mj 3\$HnQ+b ~g<e^11Ԅ0P.H>?=sXblx$^x|CeA÷skD o'`NN`f% p]!dae gD haA,8ث!2/@A@X!o!o$D#H orv;&h,a$^BDId:ej# ybxpx`) '%j7r(\4P)@ ND Bǂ/C41 F!DF N!?/o(OJ!-t!TRH!*m'Fe"aT`dl!$X:F 8L8!A[ !dA\A#x!*`Id$@ID !Ƒ`\h@=T!OL1r 2TaC{dB`Ͽ !LB~c#mކ"-7dP6AFA4aDLc!~a4bH^A!F 78& p)"B&q@^'f&,H>>D;İ-]-"Qn.ӇbD';2311.b*.@L3FS5']S8<1Q4b!6b47߇-7fS.#/Sr|#98A8Ţ 0:4B;iJ:k.ъjS<ٓ!l(vSo~spZ>s2B#2! XsA3)6(!n#|9!^H;CA;tD%?C. ` HcD}c^FD(T2H4CmH!tBF"tJDO6 [4J%yGs(V "THt'VK'tI fK@t%qA&ba$CB84,,MՄ0.'/Q'렃!3fcA* ,DOK%MuA$TW4>-_@&C@b>!h!b *!15 !L#L #f`A9CI+tzaS?SON?s7!7,v|vf!wu6m}!b?a4R'x_w7Tm?4}48M`fׄՅIe7qYax4,O`wV)Osxvv݂⁏mIˉXDؾ!  l4ؖ5f,8؋@8+Ԇ+4},‡]dtAuAf6&:UNw9yr9,,SfP0!IJʸ!29NZaj.:.C%uS Ogc9m>T?u7`7YXЃ'<D3"h.2cA8=E#a3]s{ d""3"!'IA0Q`Rf(\Sј9CUa/u6!ڂ1!/B "@eB@fϓ}w֛5:cSvBp' zdR(V ex#P-z1Z7 @D!&%3a. t{w . `!̀;G9] `'!_S!{/am0{BD!8A4B Vd # nV!1* 4 V!^!XA$!WԱ9G#%v`wZM9fСFViU5A0[Ggy"!Cs+}Xe!ҐO3);P#{ cm,!4R1GJuۧ%c<ܣBbXncYb\>RF΄3<0A24CG鱞K9% ڕc<=gSS,DD[t3Suρ p=[AF:O.ƔEwJ]Fb!`s2#ݧ ]I%f"01a| ~PqC&Y1!~B;DV31^5~8O<>@8E!&1+Q>ug>,k=w~uiuB艾k 靾I"o~s޷ZK`s`1>4 ~^)~Kpsi?d!?5x='4CTY_yQ?gid(v yHw!??k?[裿(Eroϥ(aVrDٿ?? <0… :|1b+Z1ƍ;z2ȑ$K<2J  )53Wڼ3Ν<{ 4СD.]p)m i:qLJM5S\z 6,Idˎ WfMlۺ} 7ܹtnQ2G`jE81^;~ɔ+[9ݤ_CzXbͬ[:v$;ݼ.V"`ʤvrн;ǽ<%m?%ܻ{>P3%>C"4}|So?G`jX .2cNHa^!]CQ1TEk=`!b.w#jtE@Pd"_1dBI$P3fTcE7C<0y0XdV^e1QCbR0ejfqyc0d~ h2Eri'> iNRdxP jayr) k?Fi{ʫO lъvʪ>+f뱭BGemBIѭwRޞ(.Nf$n"knދoQP$E{fJ>Lq [08r$QYq"ܦ?0%3[E|6_9C6<`Ñ4pMv4Ld.'(mM?]UO82֢- 6Gj ӄCLnW9N#19Mu`5M#6á5Ի !a|6M~r#[EMd'75`e "h mq׈4Q5jH3oTF<MpsHܱ ©i)%I q#O[EE( )/%Ѩ29LXl) ;6 x1DFd 2,K(.!0q , ~L"Mda!*dol#p\EYW^d[6Hf :5dcD,-hRDAf,J)"H@HPD#40FYk` !@@"b-/b- FDvj`"ELq\k@Ed0 ዒn#>ơ# qC%E;y(Ȭ! aj f0=}RA}(PSȈ3XP0U[d$)7(rvEQ1H- Z6Щp"^_h@Ë++,0PRm@ZĠ6 T$#)2N<2"Р)JV'.c\" I*@a%Q2̢99*;Bv UZfEQd~j+`*0)FWD8. 5trv l$,EqT"Y[shp`gAD! pE wHqJc^$hI/ tFΡ"?+4b  )Lz#}ȭ# h^'f'B]9 cDabzYp! maRE&ӕv4 ͰuuopGp=D!tl,|A^3g`Q^ (L03uxB&ŀ WQ ăҠ78Cb#qK ` Q e 0 v0 Ġ 6 u P ' C\8 H0X!0 xyĐuu @+D[C3}"[8 eeRvsZHh 6 HV|ȇ@ f  p ZZsh ?Ec*$P 4d$A^OȇHʠ H` 0 ð 8h.即0"3 Q6 sxq#Vb8vql53!\IM718Np$q D wӦ 1 Xsą@W9HA1T8 ` 8 @v(Y` d #B.vRGґ[$@:  8W|菵 9vӆ9;i xH#ZЕ:it'٨P(q^e` HR9 ʼnlY]yh8|ȋC#y0яDuI))Tc!]* ~֘8M&i} H!ޘ@aA |X 񙒋7i>]9C9% I:/*QpaA Ƈ) E31H &Y+).1J5ڕ-:#7 i=?ҠAz0aIIB TMJUjWY[ʥ]_ a*cJejgikʦmo q*sJujwyRaq{*$O¤f Jr"y@P9q׀ א{ $JRI N328R `Lp|pʫj2J  !ʬJ9SRk  AS $?z*  A jl*׀  `  Jr ˰q   ڰ!+^њ 0`fP a  89:S4 +([@ `Ȑ  n:D]a{1xZk AoP K;Y}~ }KP1jJl y@@ ?{ pQ+i+ t~ >MW~QKś^^A1`hу 0;@3@M` VzY 0  `  3i;_,L<K L %ˋ39w:K+@ ` or@ `'SP/u` e CK l 8s x#y*Aï P ` 0ČWFl[AȆ\lCHam9iiE, @\* ;C@&<@ `/X Q`1DTz|L Ҹܸ l@p"AZ,\` )zYBۥlE|5 jb @ IL>/, ib+&1 3 ]dF3͟|A԰4eRl.<}$ Q &Ű  x` z2 @ źY4 08s!%hϰ g![4Cpʧ5;݊ Nд(Z@ 㠬`{]+|1[!{c;] U_={C="!A@AL w0t .گ[P)m Ƽ   !Ur U) @!]&QstΠx ﺪ ,`ߜ`m߯ K)νa̷}Vu@Gmεly0G  o= ZM7jQ4np`$,Z] D[7P7c@ S_ %N 1a.C<*1}bQm@c1Sza4"C[NQ\ULU)8!li-;"Z5p޶t>wKA#0ctnomA Ҽ.˚ac^#.3; с%<L$N"Q#J!1ԆŎa>D{`:-{p!.p>>SK8}e7^Ql1 ' ܂Xta^aC^{z ) GQ ?.$@k8ݣ@ `7 i/ N7;G"B< hF? IO!1o<2:AUSU23נ (Lȋ_1͟Cz D0.ֿf/[&pp3.W7Qm<r<3C^7`钯)L"!n_'apِL b ?Yš @ ǒ,^<2 $XA .dC%NXEq)GP6j)hd @ht7& l1]F2PZPI.ejq/_48춗=,rqΕK.φr _&,cȅP$eBq]")\lXɝUf fkd93ۂIL4\8}o}l]CvӠ^e8CG&_yևEQ@HP` o_ZQ窂ҹ 2#,rF2Œ!Ad˟lK˶z 88V @Jg 41 ΠjǘZ)xHu0tI(,k1R ="@Q"eÁ*|2H.~JL)3,&bre&Iӡp38l1.h lFj(l",h4y-?CuTRR/+a!A"pe?qv ]KB0R'9,~E7q^-Țgͥz,(0Dagڊ1L؎ }u]x U a Hw$j7n#-bu x4(27pLw̼q& $8 w 2,3`p!k9xH/]զcR=t `I2&+ICkG%T6닸{r훉ic/#Xf`]ћjgtGq ǟ}[5qt"UBdcKh~|j6rԝRJ l.ʋ Y0 wgǟ$ԛw~) R "Zy{,Ia wQfpfqAgo|wH=uYJz?-ڳy~iQYqEo?<U{"!4YD6+iC2J-Dlh,#Tdd"H{QoW$h<7 Go>G5mM6e|pc9 B3(*Ms1|ZɂD-|R"xE!e(`"%SdC1 Ak}c CtRʯ~TfyKQp? >t2ƅ0HcA3cCY;YF0kcw$>Rxf7XS$A1e iL \ЯqJ; ;xK~ yPP/;Ȑ.:rG4ࡠ@;]@jofTgG=S dz A ᱏ96ү1ieIx"z it}r. ӌlTDjSjĀTAT7cH'33cfPlu1MtfaRQթ2 F?8hIB.zkcyT=. @O84sQдDNw mi?ҁL1!P jb0>7)eHBŽu+8Z !%- !Vɴ]{KƢ!?"lBi؀D޸n QҭOag-G{/5G9Bv +R$4`'Gh5>2n=h!B@1_bUBSK?l?bB1J)/Cpƒ/!xiP:8HB C4_1JS)(  CİH5!DlDQCg^4h\ Uz!Q|h0b@UEJ2pjT 5D7dƸ!Hp,-+=!_-tyD pmxM~L{XRj0Axճ?HdF9ȑ$CiS|ȅȮ`'`UyH >g=Xӕr59!LL>H)Y5Q <ꑈCxIwY ˘ fdjIl*9Xm{JQlĸLAT  ǀ<0Y9(>"䂦)AKaZa)qpJ!],%8~̧|Ȣt)@ H98'=g 5)?M&Z?mD̈WhD ЮYp <娄݈A0TYCYxM(x,|NJK-aWF @ȳ̧X@hɁ(,%}P E~x%iph,ּ$8RyCp #P u{ŠLg,!P#AEh'Cx4~x cS d`qЋ SL p lp< yC|Tgd)X/2'9{*싒ip8 pRD )'$-ΌXpTІ~P6]?2EK)U eUfmU—Uՠli$Ch _TQV b-KIgQQ4* TlURrWaU2W 'zk5|H`,XLt؁X<ä*VҦסLɍ$=ؔ}Y9XĠօ) ڃYYhYCYM؄%|eRxox!]FqN1Cp<[Z_YQXHY"ڄ!} ڳ[(Z{EZM w pD9&][m\[YֱPzW\ 9B|F҆\ץǎ5{ul`kQo]pق =^ؕ֙=ښ\}&XP]V8kZ@$_[U%_LJ̅0%N,,_ 8-\܆5`xaȁ_hA( )?-HP/ s(-e`vU]]V LᄠFhap]6`f^~b9I8,U)k07p0o`6\bՅ[-E_7b(pbp8_ )8m  +_d=qccȐ㋜\NMPjxG8PN?H >`k]8?~0ۂQ6`OFBcQ._oHxt)1_\@`>fGTvo9ݍρő(=`&j(֝uJgwR赚 |b7" )NX2ӌ>[.de9~5mXȠm%v-~8Ve餎8GBxd؍g ImƥNqP)˔ڍoYYeoGM,X3ֆvqp@{ F gMqHN^rn.]AnNH̓PVV>-I~rU&r5'0e1D֮ 0ʭ#,&2 d/] P95s44_sHGNANU灨JpZu#S߁!NHDL-sek%Hu":~icvA_?X`@+W0^דA= RuZuoeSt\'eރB|0phC pUUr8cCPEW>sGv2?)8%7f^p^UxXF^nGo](`/5xY @FfdAizMO'ے7Zw`1^aYvze@*y@++ c5`<[n_xop@IiZkb'g +GF+QuG{o|@n Yȇh M x|x,mp}8e4^цڹ_zv9kHh mPi^}щt IM9zHz7op~DWYYV/`[u 7/}0>}ϞA!? f /dyIL qܸɒeb?6o̩s'Ϟ> *thX*RNB*u*ժVbͪu+׮^4BfŌ9zDrdFx`%އ2i ,x0ឺJ \C>.,y2ʖ/cάy3gu,z4N'FXMMÎ-{6ڶoCU[ZܾZ1; |9ΟC.}:᪋:޿/~C?}" 2؀ؠRX qrءi>'+hآ3X;أ?#v@YG"镐I2٤OBҒQRYW8%[r٥7a5Y_٦o~f-p3P5\s  I2:8iM6}RZbrکZ٨n)1AաxWq=C6I D$@7A$`R|C&H$"$/bs<Q`槕q #\b aW  n 8HBX 8QBB p"ArE*zQ `Pb@J> F93‰w&I4R7>d4&O$ w aY,z.Ɩc/A0!GIc.h&c݅1 at3/؈BW.u0/`Bwj‹:OMDtQ ^bδ/xAY .B;^70Y\&U/L>dwİqte FV[x_-]♴}-(0>8&ab3, Bp1DfqFnEP}!gHQ>Ǫ!EIV1N&\dX!g I{"e2JfG6XeL?gt,.@й0; *gF͉^ҹ0~3 i !E-:Md9SDTj=ղZ0D=a5pk^;65N;=C@ D @vAt'~m@P;ƶS&\ 2D;FB jt/NЈNԀ4 n()8+nLK8Չo8)gP 5H̝Ao.9I =cn;BdH:v"LGu(J8;v67NIj];<%۸i~N `9-ŧuc::ѾCە>9DC'h800i kAl+ЇM^ϓ_8,E;=>#[U¾fLq}l 1而'$C\\DYH,P]1z B``| fIGQ5` |/^WT̂OS0O=D%_J$&iA=lZHH2\Ku D)ŒhQ5aHPC)\|8V>d2CȂ7TT.` De1RTن}Cᬂ,4Jm0 B47O4;DbL*O]D4\ɟJ;5CHb-&aT4d>]I YYL `M <8QCC3$n@>q44abP 34 a<!P8@%hFU|0,%x0遭SF4.A4BTD$ί  WH4@+Y,'DDR̂,C$B'!Le.C$,l͂f<l(D\>M'UEeZSi9@XA%4S/h+-Q*iQ6#PQL,$`+.7A>$PL@WpT),DD@RA@+"ԂǓRXݨz!XȂ, W\PIfDt@v H$l)$Iީj> <J\RNo~,Dtt35"R3R kJl>D}A7d2[l9C/ 5ĜZ<đ O&Cp.\@a>Df-8-BrH?z -P/b-dBhU.Di*~ET|p@Pl{c=?`hN*AD7$7 L@TJ/CD 4xaB 64^Hu0+ =?"_ȹv&ۘG^8Q#]dƑ,y[B0@>1#*XHC,"?؈81#r"x=IFR{|GBP !YJS ZD!b< R[r AvbR4f2/ 4Jk^&IXIWQe,53:Nw3io|eEb+k\,#F>S ?)B}T  BzP4AJQtVF9ZoF2:hّUf5(=@XRX^:Sp > 2tAPZʹ+?,p.4e?!U!U$ !,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjݺ1`ÊKٳhJ˶۷pʝKݻx˷߿aU @RR^̸ʵkK|PA̹ϠCC4P%Ŭ_˞=ADEضz pa MУҳkνNR `Q⽫_Ͼ{ >Ywߏ>OYCA߂ 6Tf"0(@ D!sҐh(t@ DEki1HC <iQDi$[h G6P%dbɌQf\t% Udih.咋HRKBxךm ./(T&\gI襘fV/)F4gA"ĩ*MKBY˨*-KL/B BK16'jB@3 A/Nj.BL, #K0. u39I)S0 , c@DG m.A0%R3) bAeXR D,P)4`J)pJ%"!B0 ,KPytH@ Ą P,8@4 B,H /FmfB2)] Qd=&̂@HBGq3P+tCrxd .=Q$vFt9qG/@}r .Q1 J:s$ˆar8A>d6R$1@SD ,M~BmO<]p@P 0Nd# Ad+ x"HAHȚ m- {Mk ҫ@~U=AԌ[q+%bC_ܢxr>m 9m{yuAF+8H4B^,a'REJ9M6yL6y1L䘜QI5X3!kdlP!xLÓq3B\'l \?(LfK ,#?AH.2͑@5 (`@ D݌<bJq"]ށ")DBh t 0¹ 8 ԂAb1X0 E+V!Hsu$ &@%@Z£!).!l`C׀GBl\+)YID1;BbQЂ:%*x<,X\1CġR- ն( -VA 65Uxʃ`N"[B0Q񱐍l">",f3+rd"ZRmjSː^ heYrֶŭfOZVַ'`] 6nhꋖ:)AG 7ן:! v!"^񒷼=/zz^׾}{٫ox^}s_2up _ }5_ q=\a_FU0 kYmim|Yǵm["ǽ5o\$5Uc'8y."^,0]>35nfC,Yjvs׼g4s g:ˇ~p5BːQg45q̒'ntMAReW]jծ~5c-kSӺ֤5u]k^ׯ6k[ع>6jfZv%k:Yr*Wz&l]=:-J%),A _T $ce)L%!:kg>jbll#ī]ZAC{u=`<ݪ\'ov̟e|7xm>c)X1RX@,*fi_7 ^bٶ'jk`عd<9gya~v]o'yM>w/ky^w{w{>x>0)Hl(V%amU:V)jA}g}OWֻgOϽ]%dJxE"r 6| 6hA_-nEOO|- h .djDBt|5$k I}mE2p<$y a@QQ`Vu 9 3kks>|3 29ޠFK6CN ;A1ay?30uSaUdU DPi\؅^`b8dXfxhjl؆npr8tXvxxz|؇~vT+.u  qB C 7\ -`6t1 b 63Wf! N0c ""  xPAD@W3.& pKRyT4BT S}X4 #4B" E5.` r S  YB 2 g JxEShc *G 4, 9 e(q uO 1*I.9O 6I5t A1yB wB9GDyH]ILٔN&u0wPYVyXqWZXFIdWq`ieWpY !u "Rp)ZkzSmYdA\5QWC@  JP%U&T<0NL/q(Y F UL>*RHh)i  u593#\6 uuI0 )։d0 əL%O $ $PY qѩ#ytJ& DArٰY %1aQ$3 QyQ P)Q WY$@FlB%:>7 Y р!84| ʠ9 ؠU/P GWఘ ,`;yL;xxUf@4 X I2/ A` P %+ Y7QH5!ڐ @Ju'1 k rP<*?uI,fOϐ L5jfJ $KP3?!6hZ ,6S>@\.V* ́5dT21Jz3pr eZ:Aj#` 4qntPazD @qC _vC{O` =ڮ6{8ayi@a(* A *j @I[$߳8d! @- @ 6SQ$}5a4d qaXT1 B0*  9qM OSAL_L  oE 0B\q^=Z1 aK,p`6zy9@>YXB8z` Y6!N?П{`40K)h 3jS>%; SQO lk з fq 40 ?u kxB x@ )٫-K@q 9$0 ! *Es-?PRJhYא Tذ0: A++0 Lso=X߀x@? ʀa Ћs2ǯ%R4 `Jz^9&K` K&@ U (U?YL UT0Qp,QF) Ǣ FD*lb'ujP(*\@FAEt ):D . Љ?'г, 3*W ZL;龮"ߦ)|YB -D Ag)0CCFˬyc &&X.KvjiYMщ4M!=3*Ҧ)>DH&y`yЪ05-71-Me%FIՑc?'kM,,RMX5K* sE z|W}ֳhA1#!v؈}v؎؅fo@ vZa՞٠ڢӀM3A9 b*QM 1۳B): V\?=]mܙtŭ=].׽O4M& !޼ U{;.E]7E+ P$.WC/s)z ^q>$m . e` lN.N 4%^J]@ !> $a/:9a KA ?N݂D2P7< `< ws 09DLT&ݘ0b` `1/1L`̫m1*k$+C " @ # P ֺP #Fi 2),,{0^G,"O žƒ;О\?* aھ+%`2t{ D\N$@ =$l"n$ !T69 ڠ 4R_  +0 %o&_ R@79b`/zB,*o+146G|,]Vm$ΑD:dm0Wp&//bGiI~X1ߔ yIj c>;cd0?/?}=I X3 1PRJ/ϾO^$&Ug/ A+o d 8/4CΤZ$ߴ{T>n\ PR?3V~4@@@ C0?pe ,A-^ĘQF=~RґDRJ-]SLl'_1=}TqL ġM>߿U^ŚUVLUXe&MlNmfMV\uz7ߴ>}*ڄ'M U_Xdʕ=NLeNN]gS-֣Ѥ]lO6aB?|̿DI1mŌQѥqFvg*j|BpF DR.)6PF$){OfA#h) G2ПNz3O=mOّ~AOF3.~ǻF\H 41b"y#(RLM,"ǟe|0Kժ^…Յru <{Ex "X GayT#oڧɂڡ1 3hqT"\]IޫhD\=;|-MSC2[1?ү*~?+'_ţ)3`Ɓd8$VЂy/v:I68B&,aL"+/cNȩbіjȷ_BE.jC"d)Fq|ģ{I,ZՆ1B&V Eh#g ħ}TfZE- _  ] q-,R SY͸HFB`C,Q;. PD:(P *x1 Y 5Td#uicm|7r (@ R|H30ORPeی 3ӜFjy%W0@$a6n c0" s 0Qa\v "RD _:ӢEktPtKh$ 0@ ТP@ QJ @1 wUEjRċҧP@ Z)O6 ( Xn,d12yJ(ծw KJtfX&ї A`iFaɋ` H)҈bk0C -@IFNյE@h@V II9" ! zD 2J xީ"Əl%O/t1[Be*.xV 8hYŠ-P] H^ .,]bjIСczo^w4ԀE`⾈}5Y ]:r߂.$"HXq?mP)qxE>r'GyUr/yA{dIF#sPV>JoTmHX5OϟV) F8"f20'Q9;in'L6`9 WdiWIetfܧ#򼚈Qh_D;;3<WyR ?󠿴"?z0OKMSoo~i6&Ovsp4b*Gk)S^CP>: d/Horw(N@&8@ď~HCIl%˿@(;@3>K YXXp#+@ -q 1-x@ +P1$@?BX1Ӡ"B%ta'&")$‹B.-@0/$CC"CA!<;C.lDB EfH:H'g@I$PPIykIлIPp ؃3 lʩJtdžɠtġƬ==pAPtHL ʧG#{ԡZJX8ˌpK ɑK˹Kmɟ# 0 VOj d|JU+KhK[x(eIAYk،iX2dXd@tLMplM|͖\Ga،4HH ׋*dǼt$a2fxX4qd aȆo(H,ЧO9yςP Kϭ> %+V,( C0~k K W'Y1~?JuL#uh&HC&QZj a$ D0͊_҂5R^hLNGRE`L1S2U#J7a(Y]Rg7"G_>Lu{@]ʅ_<%II#>uL/X;r++`06 13|QC_`Lb% Q݅\PT}4`]McV@/82ɅemVMa}k%8/]2/M֏ rW8WjeWky7U ~5XG=؆_7aX3DX؋X؏s ّ5F*ٓUY(JٕujٗٙY ٛYٟٝ ڡ5Z)ڣUZIڥuZiڧZکړګZ{ڭ^گ[ ձ5[-۳U[M۵u[mېk۹u|o۰}F[[}=-;u\гȕɝ\̵ܾxk۽ LNɄn\2]ѕ0]CA]܋ [ٽ][۽]%ᭈyD^^pH}]3[%ލ]]i]?Y^'04ݍiނxLl^΍iu$pІk9ޑh-݂%_kH<2EÍ;io4Hͬdavjߙ]kн@0YaUQZ$w@k8M ΁d0Ud%3~P tid>* `; \QgjYkȇ &ޭ^[; `шCȡaJa@ _0^O)St(D4^3,~!a_k(c|bd(bR_3ɲU.*:ՌmR%NP +w(ON4R4JNI,^&0.8}:kc(:cXieP#{推 !.;ވhxh=`u(ߠPʔ=%` -(^9ͺhxPZRX.-WP Ja1=?%d` XO(-nw.ų$PX06bK@T#6Wfn+u\x7Ylwyp`xi|jl \?2`e\֐eT\0Pgg}RTeq\9r7rb#呠"bՁ.]X:\WsPչYx^]xD4_:nS[={X^**nŧ8hW8xYEI|W[çDi Aˎ3m,QwEo:[o)]~~p07[爌 jKP-qǘ)雅 ^X}h1!p,h „aB~ & "ƌ7"ĥ#Ȑ"G,i$ʔ*Wlcj͌&Μ:w'Єw2%l8 )ԨRRh*֬Zrkʡ`vWaj-H-ܸr)šܑj.0Ċ]<Ȏ'Sl93Р/.mr>nujղgӮm6dc^ w‡z8ʗ3gX9yK xڷsB_=<׳*}yӯo>~? 8 ne *": J\Xx!3!z!"%x"X-^"18#H.ָ#=(SEy$)Uh$QJ9%mK8!]z%NDa&mXn9'uZg'yg^V' _ܠ*h2(WqJz)VG)F:p1)EbD *~>TkBq.# 6;O8*p&B&@e <zKBQ@|.+I{B:a/"4 / k/4oBo`sk:\1%S1A+b25*IJBo $8K<4$ᬧXbPE;tHG4ţ>l 5a$5T/=<Ў;un3BeNt;%m?\ HF@cfj:B_DBEAcMPkM,!~Lc}w/~udSP,E [@Qp(a(n c"snj.l 1 p;'“b<'@1φ8a]eE.ƧB q8ǧҘJ#Khb` 8桍T+ScK,&2$e2(:3)M@sּt0V%52nk2ӶNKr6Yxd"ܤ8K2 e,o @ e&j>zdHT߅S@3ѵc@Q]s@Աd14u!Ҵh?RÐtSH͵n+H;2,$؆:pRu gOӮG2/l LtjU"|b5*WTᡁ\AT9y,ΩD]YrD[ W٦’\K K谱uIA$Rj QM[s.%d UFA:MGKږCp֪q.W\u)Ε-uM7.xKսs ]w$4i8 APwd=U])G>xSޜɿ&F'ˆjU+iHwtb T,8@V튥! ~S<\A8"C5˩d6 9;8ktN~2cvX4ʯ2 ,_^27Z#xW&5Wgbn^3f,aCU"8ͣ3=9$ih8 KE:4IS:#Z5= tg4|9VZS"\_i3κ`U5,v\cӬ;Z:y^u3sx|,R, " Dw'kS<2wRBv4?mTk7X؇B_o4`Ĩb vɍ.ہRT uf*|AeĬm1> @4|JFf6ZHz'wH/Q0@uŒjVjf6Ɉ[+ /!H X:Al!vI1V$ gGk|6f֔d+@RZ`Z< ?Ul7Q` jgD|r:Q@K=Vu+*j8E5)\ujUNݷ>D?}M?C/ /MԼ/LX6 &. Q^ ,"ӹ(@ 4v.ɆxQ,U~y`M `XAĠ *J/|DdX1 nHDVX@@B+@ӄD<A8$D>J/D A@BABF4r]FCA$t@ &$ APG< 0^xˆm' @!L&28" A,H&&RZy!*"Z@D)٨<թ:aB8?C<"(#3"N-6#4~Ia4Vc 5Z63n747c.Bx098C/S;c\/cP#=cc>?$A-`J@.d?@2PCFT(DfT`FJDG>G~d0DHJSIcDd@Cý?$V42$D$PI eE0Q&NL*elC2VXIZIN%U  S|qVaW~XXB$W$[FڬC'JE+ʥZM$e]"MHhŃRn#|=@%8Dt`+@6@Ƀ;HAV\Z`hfmqWzhHG<@f?SJ%0!2lf8?L"6O>Eju[erV`֦s&@>tR\'5XjKw6gxxJyyf'4xBJ{{J|z@M${ΥPg@Fsg`.(f(Ȇv(6$G(|('kvިWp$Eď(ck Ǩ(D(Dhh ] )JAA<)XIDrn5)*Ij֚)E"dBijک9ibiiI*A웠jS5>j)^)FdC2"Ψ95 i:̃F[azJ#8v V~e'9I:x0p_֪P 8X\2Hߨ꟢.FĘ2޵N  븊+$D }53ʦl^!h,le̬jN<+-&.-6>-F-V5`clF4؆؎-ٖٞ-ڦڮ-۶۾-NzlF&($ ciBվN%`Pn[c x Ernɚ,m #QAx-Fls}mݦQϺ6jmRjKAhZM6D8LM@Q D>|QCp C@J5EpzC C8\ThQAؤjB5IheH0"i84 8CXa4,¥W1`62@:7a\"D@B#-,\5=k1@-JۋC[/]-1t,„/(;鏛.<45@8=Aj+/\/p=DuApBL?D.>@ 0Y+@c !F8bE1fԸcGA9dI'QԖ-[iRGQ%6bM8lW\z ̵4`"&}80)ҥBfպHl|6;3"di:pf5 `LH[W ,,c(ҫxqcǏ!G (^Ĵ"E)֩ZKvmX&+hp 4@wJ +ϡG>z1!C[8JL{ h7 4~}K{\LE^ LP..2４)pE@A Q3 [PDqaŖ[Z0WEYL D,#1rP;/< 3$R-/N'AB2d ;#9;S,L'O ,CMTEݪ2 TmK1TM9Q&#!MJSQMUUYSCu5[[qUW#_PQ%ua-c Wb vJVieH)o W\:S[`'qwWm6Iy_f=g'npvs&GI9kYʎLPHuqƉX)?Yis̈Kfƀ$^AGIkNZ饙Vfryg Fbָ[lɒ,I4zVFD޼λ#m8KfpιkdV! &~ٯhNy"O]?kżG "> ߁__}tzG"vFa@0CC}|o_VY7$HA-Zx v؅0to`@l#h)\(0-tHXԏ.\>qxPšEd24=C$fT^,h! dPCPBVB8".e4uhDPoH7!؏B qXJQ+Y[\F"(0AX& =R2~em45Te6d@ 59D3("/:}(1Ib"- -yE,0Bp2P[cP;O3<4Rnv((dnJo28N4ɢ(9qzdA j @A0!ODqm hڱ~씧=Dg C5jD3T.5L] J3f7?`Т@3&p[?|ŸEi$՛n';KؕS}E$"̓FIi]X.tT U7’8Ch"^L<֪R9Rm\窕z*,zEIbh6!nwUm·HBdg8Ȯ6?Ȓڐ!6ky-4a AC[1P>ρC'\'r͏#y" lwzn3Vs\nCˑ͐T4i0 @"}}$yyq' 1ZlT4(:ݠ @($,P"D~5q'BǕ Zʗ yE{WyiΈ`8"\!^\.ADŻ1KYqDz 98ṭن8hOyX"C=)%Q0&WD9dn7bYQ1vԍ/W#z\У?vm`Զ(acW6ȟ; cd/\sy2b&Z8#3ofg#iHe^uD?`˶EʝGW\yYS3# wc:%%"G@pvu̞̣:| $ ;xEq1G>"'HlZl @>,Çn]h4͆ 3}sK ف   EoCc6W;^m\#z[){h"@=HХ'Q#H(9zw ;\c{㾷bcB&B#V0%E@?щ~.H`嫞婳=Iaܻ7! D$yb~GP} "Q뎃w 1h*a@nlfڞa #"Ѷ!"m$j9!  pOo# 6"ompl"A(B  c"b0@kBG\B W/$ޭbЅpʯ  QZ1!"H' Hk&;BI 0υh!t#dq^Vor6q /pPD7:l+"Z#!Xs:3S(#*S#a+Ǔ#IJ1/"+.3\3>ْ@ ;;餓,|*B%tB)BqAA,"@-S(&Cc70 p\DRDiDY/rBE;F/=F[FoHp5f=F3"hG,@Fmae&Ŏ4+"xA^:&D 5g BK$t^j:#B "BaAc ^*!!I3dJ#Pm/ pEcAS2K&^%M(FZ5'4V+D|Ui.j 65ZYalY0Gc |q\? LKAXU2A;%/^U8 !U: 55_@`%$: a+a,塪cA%A3240F/+nA :TQ^dzd& ZwCl K#Cn.vRD{AgAy"t.+NwsPhkZ6:b&C"dlk6L/!Lm(#!bT5nvgmdvpoALpp7 #A"#+Wi CN(!.0tI/ba !Lѐ %Zw,>r&s'2l%(:t!j}TRA!Ik"$moaEuaxi$t'*4ԡ`%º n AU9زv|%|Wq_@r6h!&ʗz WM3!HA)el &Vm,r Gxax1 ($". N` (R!:Z (ZyӅ"@` ` t "~ >~!>%~)-1>5~9=/s>Rݼ !,K~Q]ܫ#<JAfT$d]"Z"el!!3q=a"dA"$x_2EeLz,2^"@ANq"r^+ ~ardof!?8!$#*AY <0B8-|Ad JTL 2;.\ű=41ʕ,[| 3̙4kڼ3Ν3e}3(@ *@w| 5ԩT*3Xj% +W&2qT n @%)"APLlU˸-\FXY;7 >8 4 POSR96$ VsD pMM`:ش+ X :'/]s D(0 9ܻ{p@ k.lcFӷFEP@IG_9`qsU1aQVm`W{$2A @<MጾQ+*;\v?%bJidO}TH*+1[D$ uF/.A^d# FFͰ#~ a,%~B0 2!uM2b Sc6FYmbs9@3\D`h$rFܑ` 4YO0h?S6Hh~1 a1) Bp P O T^LI2d jk#H<jA( ^4.3~5>De"ȍB:wj,BV_HڢQP H񌙪 $ bx`@'MR%{,ABZ`. 5 Ŏ/NE%RCW\sJ(cN--X!8$T @ C2a*wms J׹ 7 )AQ5@)yS o` }I2d!FHlAX  JR 0 P\ a V*ฆ  `BZHcBւ  j!"/ ]CMfoVbI\"R`*##yLn (;#x'kPANђfFڄb[j# oJGP6y2Qˆu+(2r xθthe@bR*X B㰫Hi(WԨ#@7*S`$-ž1o L_Ciů}%hp# &FbjgM좐M.ύt{V3lY>CA`*ib$>Se06&t5Uh\:[3jœBap!;vQZ*Oqr_w e+!Rm$S 5lp0߉ !^V-dZhBm?%$8}2_I6q/L GD7XX^Pu$S a(M"pò$SB{T6/o8YA+k! hHZ"QpP@7TQAAjaᮇE-XǼ(Pru0g tH/Ώos$Z.b(˥oOp- ʠ XTf0UA P y! !' r)`'bQ %8`kE *(i63 Y,.G "!L1 ƐUބ Ӄg|R/ 2F\qqp1 P fNUp a``.hU0 R tZ @%4 0U0Z;"q!QQ 6 Xv`PhAyP~Q  k }2tp.xR Q OSQs])a F 0!3&" 1*e` 2xm\3"V$)2Z 0a 0)dWAAŵkq4a@P TҲ gxY@!i8F0@R>3* O`/F׍k<R @rhV4bJ> 2 R?);T1%h P ; 2<2 1 /c @ 1mi, // } l@ Co2Smq30  `S;2So#38 m,q)3 n; ԓ p-S3P A S޲2 @ c?I9Qs9ɞQ31tA 0Z#2)eCq"3*c?jԣ8 9;Q9~: Z7#2JOIy3,:-㎝-1 12t#u|<;jA Imʥ2:-Jӟ'Z&*ਆjCP 1pc<|J1o191dJo છ C o9rz*Jjʬ*  :1_ZnyPpv*Qa*]Zʮs =r @-r: !c0hTQX`k˱ !kEaK#7"N+ +5&!бECI%۲nL-TP a"аMCLK 4Q1W;B[D{`dC'jTr5$4ѷLk뷕` 0kJAAT`ø$;Yk@8k) 610"ó0KB1L!<^#{ K$pIxV4p+9&A:p g!!AU(P 1a/qOC@KAy01a K:gqr[;" #zZ0Av"ޛ30|l1! n$ KE2/pg@+E0-CA` U% v P;$KUpL3T70pfUx  FwB\|p|gEp+šXƜț(,cgc} ɐV ,*U`Sa*K*t\(جCNAAnӜB|;!M|y~:.eM<-AO+;N1A;An^@N p""0|K6ܾ^@ҎCq|ˮ)O>. TP14@?#A見O߃%HI .Gf/)_9\; |LOOC'SOf)hUY?PW]_/cCaOgQimCfq/!sowAu{}_>/o;/㇯kOC3!,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ -cʜI͛8sɳϟ@LEJѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻ#U˷oS~ F+^̸cLeL̹QR<Өc>)׌Eɞ- /]`(ȓ+_*ͣKNzAn8H&Ó(-C}{)W`ٻu P#߁}ʂ(u-Y^qHP,x}b',H⊔Y&D'(AaP,HW&@ D6]LRcL6pŸ$TVi7M\veOZ~)`BPӒ.cʡ9SJl©|.rc#ᒋ@碌6JٟfƘYX覜v BKK-w@^B 40xj뭸&u* @p@jhzQXB Vk@91,A Bb_3`4 ԍBH9  'P1 T@| rP .Ƕ+g *Pͅ~#C4 ,vTʥ˱EAr+MA[0(I2\wuIPK) 0mXk| P3 ,!--3 i_n,Т,4@D: P:I2oq4CΜz DDE*$I и -'ګLO 4&p[6A&dq#pFtAwｘ (Z/KR0 @2@ˢB(BGv @/febxѨ Y+!M81Pu;(1x# خ`1P5X Ȁ4.4txhRqEJh0`A48.$ Y؁#ɸC!!$$&7$#FX#$r'?rdH%L S!˲?D(AXY}Dx` @*YgAWЀ D8iJ` 6iєУY\4 .1+ME˱ĢziFv oȣc^bA?DGFyX /^AS>T 68ͩNw9P*ԡF)Rӥ2թIQ:TէL *VSp[ͪU:֣$5*RNgJ d]M^ dD?DX.},d+:!,f3{Yp b7fִEdU Y6ֵ%-gaX"G4\niYϊ.h[ָٞEjZֹmi[[6npm!-NūԳFռSEoU{U~Zu/W VdůYV׿o@5{\`0~0#,aS05\aK1 v3|x/p7,6Faoq@r["""F62,%3N~,e*?LrH^,f.M&d` Ǜyl1!vBf0}><+:ˇr2/̏Ns6W 39g|P+A`a b\,"@ c"fV:ۚk Jneq  !@!AP Բ14[[2Rƴ2 YUR F3ƾ<,L!ɢC]Yk[H*`e[p J$}dO@ AI"%,n{!|K D 7B, B_|Hh+lyA("p@z>  \hOpNxϻOOx$sIa qA7(؀v\U 0 >bT6XBВ+c!H.(Q⣞ܚd@0M,  X D"p UO(/F. Ẑ[Ǣ j>&b  >+s?'Ԁ rtׁ\ P+Hp yR& R+s rB q P+9 x 'zA:R0P I"ap j} 1<@K01H*p a' i ?ޠP ` `9)zjb eC=P¢<akE+(G9(*T AD'j6BЧ@! ˀ rp ФZ찏0m*: :ם :f&M ٦r~c. & rCo4tv`1DHy`&4X , Fr䚇dJװV VЯ<ꀉrBl `.Mu `)jM3 eR @Slz"T :XWз  R*l X{r'e"*{@VZ\;z2fZ˺A1q;2tć7'&T]cB»a pțʻۼ+['{Cؙkڻ; {] =ܫ@վ%1$=QPkE V30&3&`Kk`E{ ؀ Ev 3| "<$\&|(*Z +l’2{AX15 );Y ; G` P!OQ`9! 9jQ<Ǝ>E3c=R*WpD?Dd\` ' a RR 2@+<|"\EUkRj7u+@40 ;C0nHlTv `.p|s 1l2. jOhC 0#HirHb,M,`5G ]ţ@ 0  갧LDL Lzv(Px@-l#b,gB ?yR+=S͓Ó+Ԍ . \@c';,< k{" ,]1\!/@u5#A?,HB)PhǴ#aDdDiayOSMV-FN`HEIm8A1T]ߚVlw)ULdpE{kMK$@VsK@ \}c@]0P4-oppysEyQ Aڙ-pQEUCG =ݐ$@}=޶P(15톔B=m[Mg]]~|Q!.!a {ڏ߶ Pa%ݞ$>ۧ?M+V(Id1 )/=PfPpo"  ޞQE`R0 @^$CP0 PX% `AV>UXH`JcN%}BZܹB_P5ؔ "M|~%Nܳ|()ʑ.%D| Mz^Cmc`uDR{8D `p:k݈}( bD1— JH4In>3+(+Dxʀ0Q .pYN1?>or!rsM_$޴wĈm [aR-!6<3>_]|1A @G\E) X/.B.Wb?@ Ђip'W+q pꀍH1@ >!0S}8>>M~4SD(-/-ࢮp[`&zP;Tɞ0vYOf DPB >QD-^ĘQF tЗLup f m!$Fႃ}:ęSgp6vETRM>UE~B^ŚUVn:\PB+ źЗBS(U^=/? FXb??X)p E\i"OV{L7d@^Cug\t9Ğ]v٫ Rb,u V MJa^ 9!`2 <7 0zȚ7(?1!DOD1yBdz [~]ty)]RJnѥa챿ƻ%\SR$ZR?zEIk%.sk0(zFppX۲M7߄3N9|Fҥ!;S#)ӡ=,K&aR! 4RI'9y%ЦpK޼SQG%TSOE5U ulU҉UgV[o5X lt6Xa%Xc#XeeYgVZk6[mJP[q%\sY ΅7^yUSzb]\K^ `+l:X\F0V9ֶh ?fRZpi*y#ieemdk#%q$Lm߆V5nMx9o E冯]ni׉䛾x`!"IP !dU&xFGMy~?xsM}Z/7uQ BHQNLGRlyAqPh|+hB Y[(9 ІS1B<nшt*A8<"1AqD*Vъ e`QABא}gD XN'HH)d2юwT d!"2DŽD^x8%ܠ9IJv. xQ2Vғ M1aGA:e, &-!2!DhkYd9LbnxH a5 癮τHMjVӚf6Mnvӛg89NrӜDg:չNvkqg<ՏD)Ug>i~H2BƯ9Pj,hB:c hD+e&c?hF5 "T!ɈFE:#:RЉ$iL!T֢oa7&'/iPq@,W|h~*T,8Gw8jSZ^D@)V=+mMUf?¥ϵծSqfE.ƕmlT]{;@8T61MuldQ!FF2,dEL#DX`B O`<)6!S ٨ѻbH h[mHhIGrclpbV!QFu g XFAw p[DE"& RLg5x`@, X2 bg/y%_VxeX%8RFk pB y_ \XH7N4THB=F;}GΘD!P0d`,b1|[  C yX`B rMUnkeθ慫uuυ޶S+ѕ/%+:8xHRoխƴv'XpUlæ;UMv ̈e7{dBN1lS1{T,~XA! GϘpb b1a&qH#W2qa#x&52 "|D׀ԟIu2p p0|WWl"]H 2 0B1I!3g.f&zi Y{Ӌ(|S0X`?@ <:hpsXj3 ;2Y#-0SoXa੽Z Z?KYbA/ˈsB'H`heX$MR%8 %PIzY(+P3Hx1BYPY 3@8"eА'|($ԐC17bv@RADj_P>$ 7@(KDXhLpDtQЏ2ТWYشDW;:A+JS|e 0A-L@BB PtBzmT -)8X,HC …`wX%2s8G 3-X"ǒmǷu8tli 0 0‰U8pNBЄÃXa4'>HS h*SUH"0,ȁIIHa$"d(M&Ȏ"{$I:)HGX%@Ƀ@Sn87C0UtF )\h7EFDELQnX@KŃЁGp/\(̃ E̋oqy˦T4 9X%H80ۓȼɵx )bx5v҂1x4p;?7 8\|鴋sHQ዇q\& ƒ,@IL(یH< \K<>R+-ʃh|Mp xI " jߚ^kX _X;+^^؅h?J$|\ \2}P 2Y\Z2 >LQAY02^UG?Q',@--i0ӉhR=a_ S\8fNh ɵi5Y"TdؿLpDYYR=T;-"Xm̨f `]Z^ CCZYUbXIޙa-̉ꀅhhjݨZW?{]u_VtUp@֋3pHmta45 [x ah X@&@׈xPRY] ْ5ٓEYؕeٖ&q٘ٙٚYYtٞٞ=e١%ڣEڤUڥeڦuڧڨکڪګڬڭڮZڱ%۲3۴U۵e۶u۷۸۹div[[[o[[X-h%U U\hbr\ 6b\܄8>hMRX܃АM=]ԭ" vYŦ}AOfO} >0]M$mM^$=խxq}%a^i[uE~HCߎxȇ Qaiwhsh8 L$0@1@.PCfǚإߡ)|pPUH\\ V Xp[y+\ (Mau1Rl8bg PP2xiMO+'ք$5U\e *$9*88<Ω<>?@A&B6CFdmk6HFvGdRcaHj&亙MqQFTVUfVvHWvKdeYd\Z6,^.<( 6X]ݙ*@eM7YahVR bŰcl>,xӉ!! 3>:dgtR1Xs挡頙{7~gS 1&yVfN"Zd)^Ni bH&eֲieFAgEέmhi阞iϱf髞>Pޒf 6@)"j8X׫j9JrT Bk.E:g~듎1携nmȇXkc F؇iCz ѐ~0Ц }?hg΍= MxUe L~Vk4bQxzjW4JE[ɰ℅kG9k[m^CR7jfT9 > Dqp7j]nnahe dLQ Ȇy_+Q~i W:l9?p8Vppy(3 67q rR//6v0ipwtRq_6(pf!/fבjQGx-^6fr r}i"uXyȇxX-cm c&]8O ٹM ?1>; Ëpu$tj߆NR@5FWؙJKnttIu͋0y@(+tT9>% ͉7 #CАIga ]N뇳yUkloGvnp_'n?Wq?T7sQaЅrWwmww_7uwwzwyw#H~XI鶫^wG8xoQgrx6nϊx *8(yvxW sJXy>yk ^yxy_  @Oxy8z?$}Ą@xjR@J Ps {{qm3\ g{x|H.%HqHmRY چx9qyJ|_M6犳e||У̭ѧ> kbw}}S}ǜڗ(8h/YW Fُ7!W?#!W7vOhG „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*WlR@ |i&Μ:w'РB-j̙km)ԨRRj*֬+ذbǒ-k,ڃ\*-ܸrҭkεxРt];(A3n\UȒ^KH8E=G<.\p2ԪWg5ll`6 c;6nHԨ%6}b =9ڱ;ǏN<׳i>ӯo?{ pm} 8 :_E< ~J8!~F5ɓz!b"%xb#"-(1"5xcY1V=#MHьAy$I4D?$QJ9BLJ$TP$[zae5ם9Qik uy'y'}' :(z(uiQ8,zZz)j)z):*z*ji6)D:(z?: Ѻ+A,~Tү*n]rKRZWOEtv;זًN.$O:FC@.6MC3$TXa{44H3PX Ab/<ӄSo6B 1DC|R3g F8n ncڄӔ4=O8!3DLM:3Yf>iի Mcl@LS3  kN t1mѽMw-2ΰ~C-YcMZk>M ns9$# 5 l,P#GdFTW*?2 CRM?C H Bh/`n  k F4|%tkd `sI 0qS !# k/v zL@aCPR H2,8Z0dA q(@'T&8*ps` H倁 o/#cHfQ `aQAS,3:0 IAь,pyEr@DBAQ_kC| )%2@ " C~ @̐8rH. ^$$2U1!#MQ ō'@ <l"8/~ #W1P*$;-M1hAx7c eb-bA)2bð֎LB 2} r@D 1ra8Hb. B!k+P> QJ эBPB,7V8d"A M7¿0!S8iu aD˗"fV2HT!TACtRo{ ṕ Jb)P@p wPR Y*E8! qBxu8@!t!KӸ0 b  IS\qx$Eq LHrgȅ1k @0E=bFG !cS e"H""!_%  $"ҹna<c ^V:RE+. F$v(lD1"(ȀQFr bh/$`ȁ|0D"Z 8PDv5$B #m ;?|ENwؽfx(tS(R)x[(#4~/+/?1B0@6* (0Db4:Bm#/Z((Fn݆%,Ђ3±5ȃcAPPU%Ed . *DAm&.6Li(()B4FjE_ăH쩪T-?īNurЭ'ID*`>L+Vk\Dت[A~;B *F`Et@ΫDE$\?,jKA(BԀ6`1[)iD2|6M:8@Ħ9@5CB f<ȩMHl+C+/!9E3lB65d$*!jӺpj2(:L/`-JnmdX,t &!.N;7DkI@+۪* DP`mjfm?<j2c88j`u.ۖ +*?f֮>dZ꬝ /Mr)A4l2fPa3V/(C4DSZr6)+AHh|^L)(Z7>H/\LH:#j )3 "BQ힦>`3-CA@ Tpc5pA 6X~EBdS:/NC<0p$p^ B,9kS0Nj hAGQoB޸Ά87I8MRl#[Xjo>$X𦣖xkuUnBD%`񋄁a.AbYqOQ%2A0M$$ i ->߄:@q*u2))r)sdB2lA-ϲ+ -O-cC]rx1#s](3._1(>D<34wD׸*s$I,,nBB.;8*'+{I1D):;A%8oP(E-" s=;4B?43 .3DMC+,NH9QtEԬC2` GaH AC?m\ASt*0z(HS`-cA Ttz'N8 A@mP`>DBK<;A,\6[(LuO0r 5$ u3 =s33F<,F<7@h< C~qcCt9G}Q6J8Q!U'K=l7Dh6D %^w='wH׽===6#D\3>J}}}7>c6]G_>g o>Swų3~Ht~>D w>Xu>kЏ?'/?7??GO?W_?go?w?K ;ď柳??ǿ?׿???@8`A&TaC!F8bE1fԸcGA9dI'QTeK/aƔ9fM7qԹgO?:hQG&UiSOF:jUWfպkW_;lYgѦUm[oƕ;n]wջo_xqǑ'WysϡG>zuױg׾{w?ޥ.|{'-4UDԿ׿$K&+gt @ @BpIP ) 1P 9j: QdFLQE뤑g&mHǢ(1i EFb,Iyh"fah@NDZ%7WI sF0d!8p1F\'6!&E -@b>FT%.ށ6)ge@Ȅ9 ėfZ X0dDt._'bٛ( fE2f>HBX;u=܂ [~V (d:ݳm ?!x=$"T2Dvۡ,أtC rAGLn(r0&\ 010!B88] FMQ$SDbsǫ v! w `-& a\#g0@A1k И`V ":'P !@L04Y J!@' =Q%xH" `YRDN Cj5d1 c`OXwY،2aPzxǀb$ l _#@vh,L(@i"B! _h!0'u;<ل)/rY.A)#s -ȋ}s@`آ0F4wRJ4ryBAu.7kR&LbV$27T"?ZbDrC(y)BhqѪvۅDU5EXTFk%2Vε4Z]W}_X5aX.ucFvDd .O`_Hј5mHiQ{ ծ'N8`[~6j 5[^Y5\Aqq{\cbLcԥnt,-ЍʘV]*ImoL@d[^\zIzIpB\mf tU7g ~Ra orcB&q*d2z/BX HªDI XlpYcYceEEyooL(7v7 Q9'G@q(*u_\ xW=i&sQQ ;LAc#7 CrY={,TX]BAi <9ˆص &0a Ѫo> U|0 wHnOF7j5.D&uA\Q6  iT3!U/5i!iT 'Xd8FdAd8aNIE ]f 2+:" p b:` y  (~P" 3ȗlr#K I`+TM^2"Fd!(} 0)z)EJa "DZ0E`X0$Jv(Asv" t!,"!E-HOPI!GtFWB|B 2 Xj'kŨt2, c2 ʧ Ղ@9|kRZZ ?] k v^PW2tUg!824%J @Y:"*a |`cA8! -;"frl`wro HfN, - bza\@ ƦR|b&f` ! KDAKhP!rAb:@bj~0! R!>!>ll$39#": ?pp ! j0\ &32bD*B Srj{z zAs̃lˢ˦lAj hlA3kA](; fvAL*| ( fj~J aj>$:]u A?: bbhn$B'4=Fxl@S 6J r~1jIp!vp᥌t D ##ghAL 5$8"L+|b$RG" lafsH( NF: "QCN"+?bjE1T] P5%RO /8 v!2 r"VP7c ] 2)AjQH(WbU) SU-U\uY[/Z 7n!(e]57`,6avaa^abAێLc@c}C8S8V#τT#d*e'"c'VBb`;` `%rvgwbf j/b( iviiggV `f"i6kVi`6* al @bbAm!dnLkcn,vo]cA!8J w(6pFnd*7obpcp1wqq@(wtKDtB*tUo t+viA*K +<8UU;fǝ<"~7)#-iCSҏs}iIo9[޼1zSSӈehZ;֐f5qi^sZמ5]ꆨ 96bQ/i_$&mq<[w_{qonvC~DNp?8!g8#pP xq; 9E^p'|7yU.qUjY?ArsЇN!FO!t3F:ԉ. VԵu7N՗.!fz=k8NR t8~}!~{Oo]Gvn<v“f1v?D "ve@8%!JH"[آ_.P<߷b~,LQ"6#Q>g/,D KD̐sPt)twRoj$ғRi !tMmb~QwXx؁ "8$X&x(*,؂.0284XZ 8{O}8k20D Q8HzPXA&D b k`W1 j W( * 09`'i%}E"<(Q ` SH>؈8Xx؉8Xx؊{&  I3  qBSlxQ z`ߒ89 mu6sUP >X1,$5UExNp )3E QA8U gr 0 @ s7 <3r @ 0 XBQ@;#2 S@&.Đ=C0c a m|a 1& g"b ! l1ٔ ^3e3s"'d2A Ā cN\? "` f8Q p niIư :hi^?=oF}|IFّYy٘}  ԰[Pΐ܄y{W|ٚ1Ǒ旘隴 tYPyٛ[ƛ4Pٰ[$YY/8ڐBřp Bɗ1zϙ0o3zSy 1PJq1GDsJ*ei3Ba `R&Q(1 9H)%j y+ pa"DΠcŢP \C ?' gRJ  4 ,Z"cBH"# rIB԰ 9E!pI jC~0z-T Sa ;/0& @QwI23Aq4ITf:EM L7`}Aȥw:#` 21gD@p oA" ڊy~ëP,yj@ԺzPKJ4 aО[ ",VU9C/ *E iHko.s0-Z ΦO: ìU)a #;+>)dG4>pw#q͠MJ*{B,0`0d*$M[ڰ 0&`WJ~a5C.[#P'fE a n1d4({;~ &P.YH s /&tk٦ Hk-Ө 'V;B ׀ Z0^pC *À3S&p6j2` z ʀ(>¢ jQ(|Z p P( ["u%0  DI%" wP5U*ɐ z{g ,%Ð &! Y&uqJ#Zғ%,@  *R# '>@؄#! 0#-cd;쳝iq C" -}p"+2[\* 9@|gGzTnlp,JpQzA'[1࿏l ƔlȎȐɒ +p:C?Q"`Q ƘH 0m J4uiqf Plϧɒ & Y' L>c2@mĭĴ 3F1am}@ q18 +0޳!Vߵ< t}m A} uA!]|zhc-lTޝQ {McA+~iP6Ԇ բ0.*N(bך t|`@cTV10U0@>Wn]q;n|1v 0o.! ohwu}Fka騞 -CP궞1Z~.> ! ^.]Y30..,5Ls~׎>,`.LX.>Ӑ T}t%/wX,%ڐTNcСmPR2‚@0qa1 װOu O.dy .W12_mihB^fN@?RM 0,ޫ** דsy, Z9Ş麞lM2{-!u4ϰ - MUXhhOkMI?$ɞL`UNmRI1Qp"¯GoInڿ/?_3Wn@@ DPBq >QD-^ĘQF=~R/oJ-]S44&Wl(%K;9/D"KT,5/?YVUXe͞EVZmݖmF,Ta@0.Eb2AWndʕ-_ƜYfUУ(j3p@NmOtk\pōy pB66d7&sC潻zݿ2.(:'_-\ 0;O(dA=]x  *(Tjn[z pH)%YR'#s2H!$HixEh M @q `cʁqeGf&a!A3tP:3O=ț#hX0D*Q%RN ? jT9CJ`%#(Dc39AGNʒtFE5UU%~bQZ*=|EbnE z!ry-^p\_^3]eՑ ym%z鵽&Pz~2_'Vwpwg)qC ǿ0'E2% @u#Z_8 wcU7u@G : #*9_!􎣬"-"W&H*JҒ{%HMv2N 60ODeSD@&Ԩd*e9Kc?\E"`0h9Lb~qE%VbτfqL<`!Qf6)7aLD~XtY6NvO+@Ӟl`"! '>:Pr r!?DԡM%_2̓ #(4:.(GA:Rm%EiJvRԥ6cKe:SsŔ7lStH;iP ըMzT6u8KujToÁTu)TUP^VUv&PղU3\8 unū[Ёه>NYRհf]Wz$wZ YNֲ-Թ ] _3nz,hUHxJjeq-u8r$.ehCio\ 5#* ɅX D\B1b@4JL$4DTdt,͊dEJЂRL*S$(GFb,`a21f4Dƙt&(ah4*Ke`=((+PaNLT:%0V #

Z ҼK8"&[NBV^FVfv臆舖ri./c菾 j6q6JNia,n=iHqP>%Fꤦ+VjU.4>~7//hI:}`u`cn8z$lhjxɋ;^H;ti0}"6jľgHix޶tll"q8lǮq&m.0Xmv׆ؖgF_ږef*e`|q 6m& V¯$~(s꾟XJ eooq@ԩ[`EnDن>nQn HU#'p"7oX<:n 'n /BXg>mD!t)y8xYFҠFBc \bho"l3Y9hȄ@H 0ʬx l#lXb:H(Qf抪N hF#7 y~Ps }s6s@o'Ag1tD7=AwtH=tJo=KsLNOPuROEr4xVWuL|F^Put"4D'@!CXRnu4rɃ`ȂksH /v3 GD.k(i@e!w 3uo341pƊ'wS>pSؖXӇx ؆C3{_<^';EEa'^ͷy+0ћ_;Ȗ{Zz8)/zvo̖zzɁ:zsA_${3G#ϣW{wzGNؗrm:ܻ{!9goH&p؆tyu|@=ˀOg^ b޸7txH8^g Yg g}۸x؆_ }ʀPEg g7_j~OOoN?~_ Gwr懬*\q(h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*Wl@/gҬi&Μ:w'РBH(ҤJ2m)ԨRI*֬ZrJQFbǒ%+ڴ4m-ܸrSk.^psal0Ċ3nxчxl2̚7ۙԿTm4Ԫ]T®gӮm6nc7SXz8ʗ3]ҧSnѯs;x5K]C}˖=?!~7 PW Z @0 :ky$2!+8]CM!xQe"-xՉ"5xcO1 5,#AEy$I*$M:$QJ9 yas%]zeCYNTYi &i`k9'9fyww' *z(Jv:(Zz)mM)zզX)z@ZI*9*jPkkz++ ;,{,*,R5IyakuT-.-ኋbzz0N֊Ǯx3= aK.C=͖S5hg@<04 cAQt4t,5 @:>3BI[oqAdA,:kONk2] \3={*&7<;Ŵ6tZb^緭xYBiDM#L0^Q8w/HV5a#4m5cM,j 1@TLM͒2HL#$OQ/vۺ i#78'ynaY0v,Gd`n yA'|aA ϐ*;wO]AD#iMQ` d 9ŎT"90aTr"B8qFई\B6ƀAkU P3Le3K6 DHF nD*ޖU5A( [Ґ( BUC f bH%RX)҂P" ; bda, "n<BD$a=mF}xi! q0^40dP)Bт p &a@ :Di ^B(wT @yxb>R 2 _l(@mGB .M!$ ۆp4")0PAE0)9bN,C81`FD 7@[ xALP[js<6 mxv5S6C</$[ [0 F ga</ۂ#3/Y pdY=wJux!mlыSy.2|QNE LZ@%pI[baj[ʬ-\hBT4eDG׬Qgp&FN/\~bƀ, \$(0}aφwa)YW%hІ4b;!vBbmY!P/r, 5Btoa;YabFw!c7H;s}?c#, 9#_O>Ϙ);.s_-/iC???/ZЂw4XFk .Eƛ ȼN`O_B0-JR`NX B``iA (t -^D D@A@ 6h8A/#C@?$&a 6 a/%(@\8 a.!n@1PC2`x>0aF?0-!!*6#@B1C: (B "D:>0@B#bF20 8!<(΃hAW0 + -3C:pa(%~bAC"3"(C4bA@ W;&G޽B-DD& ?;*B,B$(  (--0%R:;OAV%D^Q : -@0/ B .aAA\"]>fBA;a12" 0"9Daș@j*<0Ɇ: 054GDiRcZt;eD]z|<r *F)A2+GmEk ʉbMNADmAtAC5`}jAכh(&ܚJ ]AC"mK8UXV:pR.E B,~.DnAX$\LntAnRmE6$ʃ":.T6k-a/V62N/VM+v~/Ϣ/u/zJF6*)hޙ>K! Լ2`pAPA_1D 'G_y}Vr8uqqPCk Gr.2/.ho/g/2@s1_1GmI<䯜0s1gh%E:1_qBP3A?qRx/p k۳&3U@AOAlBW3S3/RuPﹲD;DEC/FoIKA@)PlP444V?K] QtIPtmlYȥ&$,lWQ<ϴ><mD%rOX5 c5(6W;4hA,8X,N /56*5mMd8^1CŸ_''PcWt#5[6gDA -vgoe|B6klF-q6n#ELWnvmdO$?ajO2.#`6ENb"wn@/^@+P7/\+b׈SDHMV  !BPt)DTĢsBx 9NAsj >8)HyLAE::D+<)`l_C8ɎnB~znk0hKD(YBpB>eL C % $rE8HPx9f)CbkD8MTy_5C(23A8lk7D`t>T<\o2^H*;0\CO'E>sĬ'>7D7(O>C(=O>3e>/9w~C2藾>ꧾ>뷾>Ǿ>׾>~r(7>]?ӏ7?'/?7??GO?W_?go?w?????ǿ?׿???@8`A&TaC!F8bE1fԸcGA9dI'QTeK/aƔ9fM7qԹgO?:hQG&UiSOF:jUWfպkW_;lYgѦUmW\Y;n]wO8)oҋpaÇ˝Ni1qRKoǑ'W.Ylp7M`fiU'YAm#Y`+9[>>l շ*.@Ȼi:e*JbdĂ x@Xk QĒ/f@F ~  D) @Y8J#nBQ(!DBDΐhi!Hr]bF.E J@$V $Dh$*HìV 9.@P2NT)b)JO4QjJA0%Ɂ:h !PP#E_i;RDSmo`꤀C @V%(p[Fd9G _x wL#*f@b ")(_0%xg dc\&wIV[j0H 241\FC&yFi5Ld(HE0(e ` `b$nM(L^ 2!3h('Jylvp Ih"%R 6!ւz%3 '!BAh&;"O/j ƆZ_ah!aۤUȆD=JCk9hs`H]r,lh _K]r)}2*8 =$I`n XC|C/ðLu H@Rt /fq@ },  0IMzRgb"bM˜A #`AV XsQoaE11 \"fD;ŠE/[bR ]^B H0 *B⛄bR,%p XPu'5E=rq h&H ZX{5ᜥ.~-HeDWଉZgA&R1opCPq#4>hk 0.@y-? m}kƌc!(8w#4 @$,-/1K bDc@Oadx R&1S 渗$D9Ӑ09c')#kJq}7\33:ڄ%Al>۞'FzEp0k&P^)OXަaYYqv`W¤84C$6I1{A8 XV2E^6# )W$q-@ v@ DM(Ɗi D؄@Bf8a ؄oU%H\Rc-@GqLcAjQԥ6Q-ꄜ@ r`-i#bY C#0ڝD>:$N,hd0ae9"v=GDc(h< b&t"nVߦaHBy&W_20a@hu_In VҢ Yйl Ob T!(41^EbABB{4*"aO ;>] eS%Z(p"5œHaB)lj!E;MF+ELC;CO!OuPTMX U buQ$5*RRA"R9R=URASCSETITG5U#,`^11|1(hQmuQoW"U(~WqUX VuQYXoXP)oBZ (u0@ZZ%P555^^U^_N\E_0_!0uA,Aa`UB@b)%_1vF"$5d5cGD3>6 R6J e[ebd  deBgffSVBfmhihB$i63b hi6k #c/66 HkB +Ja" hkUbǁnld bmmhAb4D6n`cd  N<@+¶!8Vo"m JB2W!Ft9ap B0 Bn7ou `Au nb Pw!jso ivW T v \*$oW&ls-+at% A)A*%`{W/Jw Kyp@$&!4-8@T $a @Vh($i"Cw x"SK 6seuAF:L'!5#‡ XWbCC p'Q Bzb%b{`v  2{5v3@nǘgb  'F xoȲAjjC؈ Ut(zD+ x \z 1x5%« 9&tA "sxkBb၏¯m6!$a}! 2'AY8nBn78"xv88Auo k xalV!A ZK m2Ġ+NN"*ye%"X 04!B"DHXa< Bx*u^hy*W$`osb| p<).xBz{4!+2NN R`nBL *r 7a-zbq'\$|ŠC!w 8` D":x) ;{;cbW'a d*X b!L\O Fz)a8yWdAحo":-4 J&{%8`K|%᤻;![{(x[ZEi{{ -z#y>0{#v w{[ w9"{{0\{>:D@E@'b! 8 \ ;ⲕCh&9u/96[l9`b^i~Q#J\ RU>,M ^ܝቁ#b"Bnk!b5wA3WE`7k_ǡ`ʉ# !,H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\20cʜI͛8sɳϟ@kzxѣH*]ʴӧP%իXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿:$SB̸qW%˘3'$9@#BD@rB-SneW˞M+EmsԤpP,ȓ+_< Q}")@ͳkν{G"$GϽ_o3ZtB? A߁z7")8P aP#f؀v 9!Yq(x,IDdGk䐅 i"Y$#6 IPEI\vR0iP}i_lJGJЙtix$%ZB 蠀i衈~$(&*[KK/-R /.PK-jꤰ*a\:Х*é1K-.jΪii -䒋Bl-͆+XbK jAvj(FTBKc,Gͻ@@rK",zP1@-rA駕-,L,\һb;,@(iA?ds/ 3/P[$L0ody#$ӑ1 K)Dq43,LQm%,-v@9xDC6"$aobxr/ޘg^a+)4DK){@4crG@9ʚ/|/pR@0^,`2$;FW n/P)A!-D>B @GА, TtHکA0@7Ǒ *EmL ۄDHH\%B**)$BW&;3-@  ` @`UAʇ @[pX,% x[,K02ebbF`p_"k!Z ^_V%%7ɗKͫ~9إfBY-uGRD#$2q%.Rim]ٗ.&*[kdEvI < cfkj 8Ir4id̍f:IOi X~S=zH " !#BM%T1QmEPV(jf|-!@ \@  x=\u!HA'6`HFS*6ˍ^%bQ QmJ죇Ny7n@1MCXE8k9+W}`-FHi-lft_%gcARB%+ 1+Q-B/R E.Ok?_YMLn$` 7~. h?NC8YyYϼ69s+9c.t7FgғOys>uWD/eu\#a Fl4Yk{Qyٝ m-(>6F]¾3ĄNBqaH[> )oǽmz޳O+SsS|K/ww_~{߷|/Iś#nY't]rsu (u HuhuuAuuuhȀ!#%('HvЂ.0h43X4x8:6>ȃ@?DX q-؃AȄ>;8(5H98Gh1Bht@aWt w0ql؆npr8tXvX+Dwjg ))r2q `XఉJĉTM(q &!0S-qˆ7SVȊ e ! ^A7!sfv͘Pָؘ(qCKR DX D0a*@ K aV *0ٸ(Ȩ@[Yp>`?^ 0 ʣ fj0XӋ*q !cgN b@j0IPaet:L*A@'DLB@*Y l- 4 >k&&;K`A`V aD9Y@@P82#ňh\ "C)P4`#?ƓYN:Ap;U;# ؕ9 2IJP ` 0q9Yyٚ9Yyٛi5 o`a fgp4Ai6w{ip9)`EtP P8$#GQF o&S1Ip f T+ )kf`WP yKF ʘڟ N" ymr5s Z3r2b ,ϲ ~/祢 pmQ)@5t@ N!E  ,t d ϸt  €yAt HK)aGt 0Z3F@6R$ P6FʦzD` R32#03 qXzI@,qc Hzt +q0Zz8٪ ph T% āSjSyRʬO`X*.L6! 0pш *0$ m 00rOH*0 fh0Ͳe[yE v!:` aM:8zⰶ ݠ6fT3 0B(PS3s:phr9^&Sb00T kE;)IjcKאp`T0 Fⰺ19 @ `D@sP)f26E gV 26nlE0Tk~) ~ " -a &|`E{K)L) ? #+;pO6$ a f W{kX y{B+ŶWt )VP0 `Z;QA>&cgT6 K$ȸ;řcߊM RW 64#FL=\ | 8f /O<AE#$G q[ nSA?׫*TKV$f Ȑ Ƞ  đ1 8$\Q K;ú CEսW͐c 0]{ +,;1^kA (6,p^Lb$ рB/< M$`i6Cq3,%<L\$ LߔQ E eY;Tt s6 ecPb ~0 @@ M5nƶb )x#'PZCeLiZhPb.2 ?/,1M:M\t)s;eѦ` d3Ol! ` )+ 1MJ ;#7p6_:{ Kv:Z ^FJ1FS)!#n%3 b# hؚC z ؛T D3,ʔ:Tʆ LLkȸ 3,P+@A jߕ*4/T0>LF0Pv1-(KF-:.mM9`Wp Q$eĝT+~@y) 3.| L*Jْm0?BT~}=ؔZ2 L*p gwGg 2 GK53#Q;v6tL0n.|zNT!v>^j`.gd"9A>됮ꗡ7.: n= ԯ|՞~׾I /R^}>I~ Q^sgd}Œ22o~(؈FtU~ч ^q0"e > 4_.3_:Ǿ9@>?Do=C_JzKK1c`+r2ROnS7p5J \{%a l/(]jv"ssSAok:b73 _4,B  &(6^S9*ٳk!!إ4Fd?=e2Fn ,dGy 6|/q 3R]r c.TqQ  _)`i @ S)U1D4L@@ DPB >QD-^ĘQcE_&VRl KUFLV/' cQNcHBqo TW`4M>UTU^ŚUV]V W.f 8 21?@ Ĝvk!0"YA@.|A`Pڠ|yOT?p8lQ#p!6CCH<RR2Dhz$/d0htc'xC߃5i%ʒdȐ1 QL2!"@@7QA= 4TZYV ;a3Q2JO9L<)2l&tHQ3}nu)戩1cNhT3Q2u.hoʇfdYvЕ3^8Ys.gqXF.xZ@kI:d<.$GLW?O p R.DA:Ԥ䝧ʢkKgR"3zJWDN*+=iMg#vlO{ʪ44`#s'CD/'^N5CPzzH]WKA/E4{q )-n dhFA 3k!l* B/G>jn>=B|D!@$! 8eiցB zַu7r L Ʉ@RP54l 0HqH`aR6ĪеX4CEoz7 <"B 1@ܐX }PHB 8`BD p)rY!`VL@C pAn X/mF#gyq2$ ETiֱ,\׃H~ GV rA\fl9IkhQT,`/A8AbY8*R5.r t t6{0aow m@zዟxb S&CD 5E {==BmerXg`A \lZ0Aq<<BZ~$ nr'.xڳ~9pf b@> /r "/oEN]YXVC"^n[/7& p܂-|^`|Y:ȫ+r d &O_ B Efyu5Y2w>tWP@1󄜷O:bW[#!!tru;E_'~ tOGR8JtN*S@uY;u׈˵ VHoY,}J^۟Щ&D Q;.ԍWS}06(FG#$Ç}ÍCCҀ@@id=a x X- ;Tz1(Cmdq¿ȿLL= LTEېQ1«pR4}lQ;qLLppW[êYFdT>` ۰)ol\҉X!a~Ys<q|4NCwԜ6s`ж| {4G4)ȃȵH((4-;LI$W8v ;U#ɘ\v4*Y`H,c{Fʪ-IU8Em[ʩ~lX…xXbʲ:t"j]ܖ"HXAYBKɽ&A¼A4|AT@tLd칾AȌLUT\̹L. i(" $A@T ٢~~A\M.qxI`pDdBZ04NpԬiA|N!`^pBx00Bxyzt$,K3DcNoD+ lXR ctPK Bn 9nT iPq(ܰM Ay(EЏ~| -#uC8ycyHѫQc Z@ "-@Q8FJx늷 mmppXSgRK҉l9x0Őy`6ug`Sc4 S:u>P~hOy@ D uІipyA85R6}"\t{}qx Im4ՈHT0rSe[d `p dUdB>*iX$$xiN؄o 8T;diU-eS_`i(`WgփU*pGqM1׌ibt,$k@bsloeX{Ir噓YJX ;lQ82X(5#Aٔ=uWሯnPVP0W_6*ړEZTZiH +U"o脂1i풣 [U5%. -X:Ce2ۻUX\8XPV8X bH[DuYf\ &heX@Uk - "D ko@`"^@a bմ }ѐ,0^5ȸx X(_(w݉=}3Z [ Z7X ^ߌ_Šۢ_#`'W  `3E6Ɗ˲3 GaaN>e6bGa)#v_ i'bHE;*._\ ^*2.644V6F6v88::&b?9A>>&CCFEEfGFGIIK6KM^MO6OQ&cR6e/SVeIUvehW$ \e2k_&a`]+8eexef:hYN3՞cV]Xf@qFQ&#&#qfvvv'mn&f^g۬g!) %&x{"gJ耮ЁV7}iQ@hp/M^eZq f +c6VnVh&y\ņ^kpj?@[iԟ -BZ@jSEi(6=,^lhpPe@k H;8iоW٣58=z gYuW#՜pSnꑠeǑ>꥙ͪfQ d c/ ؄i'0al0ǥ0>mk-l`kki kxiB91.p+dXdj엲ưBiV;[oxN` d^֋Ul.PUYX@kpz} b'08YPod@Unxox[nM`ہxp`k*&opD5/*Sی0TH7:Nc9YVd`r&Omj+E h@IP=уH˳]r=0Lp)|H0H0T89Uh@R(D a}:y$.kr'ט~ެ[_phk5w5YbDX&(sYu2gL[`HljPXPX8bcnkk1%@5e]H@ PVY`T F &~) ɆيYpn4UЅ(0E;VG*Ոa@H;YyNt'7Gzww㞪)犤k{NPs8sЁ28zX+0H 9EjioDozj,zw<8X@2op+Ps8Pl] a } ?Ǚ7 2 G;f݁X(+JHowvH5,ӄ_Ph?&͒60(Z XH W кTOwovwoƃj'X07^D(EWD3x˕p`-f|C/bF,i򤉈"68~8+8;8K>9[~9k9{9衋>:饛~:'~ꭻ>;S.{M۾;. ?% @8<ۏW'oo7 J@A1nɟI'>:SA?ÁO X ..G*a?A64S %PNAF-hЅ1#O=[bY(E}d<m4 ( ?C5vЇALh1M2S,5K8TX5yPK#"d(X֓cEAgl=[%95O{I@AД&4O'04HO V9lA PP6.emOp>E(@>H}lh3P|B5 (XֵtI!D8a,c%Xlض`5@ $p:Yhw' @.a{Xjbrpt@Pa}m(1Sb %c,;%s x.?Q>:qM2sB Z~+jÜG υBmYndcX9SP8CI7?]\5Om=o{-C z#̒p8 Sno~.$ 48 1 9rX\ )9O򖗼4y+\΃y<:gn΃8|դS}i&zimI]Uzđ<rm 4mW.xcW pp^'*+J񏘂[;᩾U @VŃ)z#tQ~F~&cMD];'aJOfmr*xڷroFkiI .WDJjD~D!SnM ;98i蚴~DǯWH5x]D_DX? - )E( $,i&`NO5><8YzD2^nat>aDaa!  ROяG &"!!">"$F$N"%V%^K&n؟2O '1[,0x(D``(^.MX I?":R%Vޤ;dVv WzXjUڄT%Z:4EY<\. 2le^N\e"=*K^.\2eD|`V~Gb*b)rW1EeZhfQ]hrP4CdfjkO?مnGo&4< (;h;( ak5!a\D$ElXqqj=GcD DJJ0SpzRNnƅyF[mg^f9hEH@DB<.u>hhI'DqI1(^vK" :y~qhrN g$l6$'- Fh &0E>(M5)v*%>KV+ƹ AFBCxAuF/BNV/nvo~//ӝzuE !֯/&5tPcҾn[@ x:-M 0QSX€8jo0[Tp0@  E ϰK- Ll^ $f00!]M[-10n$zNo#5<!$"d[ؔ(B1_OLWr\$ O 8d=010Oq0a28`o_l\KseXrh-< 88TX2D'2++2,Dz,2-r*R 1NQܲ/]d2քc :86-\#^KB``MZ:"E8$*2D\4X5$4jrNЕ0Dh5`.MCGF :`C 0_M4f.H?$4s::54pZ>h3H4P=DT`0OۃxLOCz2IH15;B3vu<ۘ,T4uI5;ImD5 tc^eMpLW]5NÒ:HA\x<Е\' كDKF uPDb.tGG=eI87iIBK*8I|@ş0(@API,QyiTr,-u웯"f4MP 5DD1w;0 ,2:J@ʂ x* 6l!E '\8)x,F05DFC=:dMyD0;E1C2`7yS-|Ȃ x+D]+TARZI<@YIdTy$D0T^tK@%BD<~IlzA K hMD1 uLáO-FtApcCA'C^,AbhMH:O8@7d`E7bUy{hl#\x D+@05$DEM8T0XÆ@DXCy4Ĥ4  #E.6y FXx3 ̧ 1BHd B dN&tSIԁNh[D $NgZ|kElA IpZxD+A0줤l+x@|/4D3|AD(XP|NaV1CHy@H\8@(@ 0`5$頉81(fQ\s"c +eK/aƔ9fM7qԹgO?֌FpFSTUWųYUςA[$`fJ 'tAT07K&/Y 1 P'9)M-ֱ\&W zuF( ֽwo߿VPݵxR>KyryؖX PYUk0pUV Yf+zEeLpp(eVpkƙIFnaϘ\x!en)"Yh`o%X`= aHϫnᥗ ^lQ%l'2mFp+HkIFlfpȚ绪Ƙuz &az1ϘaYs%YxIvQG!%̸ J`e :YF#'E\B[)lɾ"A=WE/QrfZR]i^o~;p^/]}֑o^Sw^>u^/u@_~_x`Z@~_~c t!(0#aAB'yL aC&, j8@ D!q{6HP ǖE)N3@~ 5@(Ze4Ѩ+"P\  M( \G=R@#c`@b#!FN2vdAA p<\ )JE24%H_#`Sv$-qٵTNG:1Ao4fl)c.San pPAf’ُoWΔ0!t\yP@ʕt3!=#N|QL A` iCa{ K;thy>MDlNqX@ 0@GʉJgSQ&#]K.B!~h!\x D:S. )MIGD Z .e(" 6e$5 8Q0+FZ{f` a + [㝮jKyuH YD0"@A& %D!yv'QR4>` d Ú(@(-!ѽdõo``PCnF`zЎNr.toLE,^/Ax{_  CB18,u #K7`9dۇA4ioHL#6я"(!'pF<,565ؠ6&xqg腌aG|^ @nj7µI@Ђ,| 4%'<#:>kJ#H'9+!TsV`yI ukR5)0{w4/@+xHƇsW/ܓ҄ 9@.a4Dd'F} pG@08c1 x|o=px咧OB49E*z1 ihP~ oyD||q̃WZ/z[Z ~TJTվ\ͤf'h|҅~&: @0'X 00/!⏆+pǂ" &0u/&` .) %D7HDj #b4C32z: oJB)a\mlT !$B\h" y "^ b־k ) .pp4n:4nh'' q!1G$1q+2"p ,Ev8FQq-R aZ1CG*Bd1ukJ1ָSv1gJqF )0P ! vuڐyqKpG̓.qvqA'8+aQ~ !1vQ 9{o )!A( M'!p!!в$#En Gl1#L`ub bw >"@%"Bc"`"w0!Txї +Rz'CB 4l $ p D+p|]c|c" J* bDY(}X` 8,{b;t@"ʴ "06#& \3=q"w4l` @"a(s :3 $Xbp)B{kb%!Aiw9R]#95e!b7(!#XFNpp`$Q1"x F֊8~a(AqiKXyI" СFR 48 7RE}4 &"+lHHWb$*6#@mP8U"l}Ws:6-R#s0ށ*#y"!!}V'0̥rC(Pfa.+X CXe!_qB(q!z@Bѡ)/9' h#Ȣ b5AzY]a:ezimq:uzy}:74΃a: LԁBzH",jµxM $<֪:>c` Z!w< ݺ|:!"ՑB"JG z/sw%"J‚ǥЁ{zsgh ჳa} 3.*`0;mPrN3y@"Tyt7Br R$,B `[vd FlQƁ*BJjٻtuP&a4Z{篲08zS.^hMM ?s BraU=i!I!>ga0wQRc\r؏WZ؛1'x;کȈڳ}"yCYb#;=!r,쀁D7Н'aV!$ aD{W!d2L$-5"A!VCVLI+ x'p5W R =6eG

a bM9 B}8>0.@\amP"% `XgƬ@"dJ" Hf %bH!Fw)Z:3BRt8>4#,/8]71z "X7` Yka~Ѫ2VW D" dq :[;!,aC'"fPt%_>"`( :bP屯!="x S ^ow` Jv{<"@dN15ڵlۺ} 7nZbf@/w `e >8AkBS\PP hASd 6A1N;ݼ{Vlsg&D]q̛6̡O"v bG˻2hM/7DPWRFi@6F,)p}`w'` 愠UMKCP)TC~DANHPH3-=&\dBIĢ0.:EląA..`N> ey B BLJe/'2dK0V-b/-DKB2-3,vewzkхP1Tg9L ,Ћ]Fbc2S4rIImeʪOɅBWP3/ j@=:ċA0>k2.pKFJ.@> '-ЅRlX o΋,<@.8s/rGF$2|cNSk‹? d.." p&,e$l2 ,#-Lse˶5A(3C/ԋ.#sJ/k$3Rl4.&S<⮻[vK-) dr Ws#6-G۽w΢`x#DKΎ?Oo_say梏Nz馟Nii{N{w{ﾟ{qN|o|?}$-_}S~0~_ AyH Aޏ A"_/"H[?JWhf b?p$,!О$N8^(p4TabR8C;a z$$*qLl*ɆEph4آ"v$B|2q-N|"FĘ9j"7R 2A <"hL#bŝ#pއ` ^q:#HCː22 gcOaCyd] 2aAipƩq?Q2@AƋ(41 В $YÎLtl 9̵R!j-GRQ1̈3qtrT2l-,f aR #13A- Ѐ t-AЁ&[P-pG'ѐ s'pq! ضi9bG6!Ās P 1)Rb8rc1; cr}r!bʰk` u1& 1`s0nā #8;1 - bVp+_rt@ ppv PS5B C/łqo -x!p$ rw16`v`  K}4pQ.a#!,Aux@7n DŽ߅y(`%P(p&h~86 )ZbQ#Ap яR,lw B Pz!'Ԣ`Gt q'p@ aL@ gxxT09(]vAs,PPpR @ѓkua"!f`q`i!):?& M"R ncn({q07P s0uq7Y p(`4 :A-r0 +^R)⛙B P,@ "w85Gu"+1cJh ( r B 4RW,87j0 ͒|63 r P' A Y)Pilo9@.Eٞ 5:3c3ã5⛠);ua uAꒊ378)3Ř4/q(z)R'ҙrz55O1: ( (޸k& aB(J3dv=X '~# 69}i&zP# :WӛŒ8 ;Q )HڛxC<#9=s*߱ nZ*3՞j nb-܃49A.j9' D33 pb1<2VSٞJjzʮZ`lQfVj=oe,Z*JZk { kal Hnjub* g +$;%'&˲)kkf% K! j&v0?vJ9ABpy0?`@rPoPsSPKto q+kKv{+yз!Q;ѴR˸nK6p1 ۰ Y+= J -d4+k꠻iR q+˸P;`<+΋+〺[h3OR+ Л[< k;۰N[+@x`A ;1 [ Q,ØV 7p@3>/;/ ٻBL N3= h0D'L0!|F\ 0˻L,OB//dB K'!J+>t4'|gPdlƇ2a&P}2a=d]Q|6pR {@|@pM5$!ѥΘj Ofo /OИ=[p\ɜp`,R #p0Ъ  l/@el)kVm 6- *[ 0eRD ("RPأ J0=pV6PNr֓ӌMp!=*_'PhԐM$ܔaUоf׺x@3aIp ;+  !xA оBR;lZ-<  J-nM7\!J'j F.n6B! 2+ K0#Od- g7.D,9֐M2喌Ka6].N՘qJ$mLRntl븊v9 k D` R q iA [<{pJ*z޿k 쳳 “%/l>/~N9qKPS>o>Q~.~6L1n<]p@ N$'/~+o6/D`￣ . DO.}A/NJ_@oWYXO:/8`=.DKJtD84L L-\,@C7j (44m P@4DK4uKlDB,,a': SHc/} d@n+ȆzJ@P)P)mRt&AT!MQ¦Ale"|tA&J,; bA&4P@t3B pd:DLL1Msm),#.2LAd&hcZd-Wf-lβ-Zyʵx0k=0,ImrKkVLݒ sPKr@2}r /GOP.r-AK tY~78#:OA 8?X0PKm~KH2 q ۠b@Z*+ ‱kar B&8h <2P E*T3f ! D 5pY?j_ %D )H2A?Lc`O(K( xrB nJ!"*dAeF:2-p*m(y0 TPA R bAXܫ,48 Y` Ը PUJXb"MBdbx," 8 ,?DH$jcB+"+B.h-GH}%P`b Z H9Ύz),h@(wQ/b\C@"ggK%. @@ 0A PdX3F@$WXFB O,,J#1eM:3E]A !(@8jA:X=:$$;U!:v!NRr{5pI*)\gL䃚,$ ~@6Uي!lH6ZEd@N3UHγt|rp ;Wx q BIf"E܄p7;UH-]qci pTd`0 l*b (%zɐ28Qy<H5l!6Yċ@D M#8T,$a@3Q6h`\0@rD#بd9WO)vYU2<) TTKln8f;B ,:;H< y,9"#!5N˴yGM"""BRfr}+s1vrl##2U)(Q=w!!fEKZ)~X=V6DiS־mg;~6ݐq!FBn[v=j{v# lrAxM@8'*p\1'/*) Đs{r#HW10W9DbӼ6s?yo>tΓt3GyqtOW_: et*F;!fwBҞuWoz܉>wh7{]zޡx^}._א[򘗼I ?vfvms^ڟwwzyޯw{}מ߳E{җG=at78o`>"[~!}h/䓿~)??~~~@ p  x؁"8!Xxp ం,X+u21`%,؃A@уDXFhpEHA0%3X Aj% !^_xJ8dXEh(f8FVG  39̃Vfn8a~8#P)0s'NsG Sbr(xn*B$"KP01D2"DBO8" $x"R '؋z`DB,юC8 Or+-2B "ZINrn6 ` :l "9"I  +r-` lb ";#9Y $\ˆ. >H@%]Ay4H4yȔPɍ0`Q &hxXOY& ɕ`dYqh|f yЖ"?d( =3 ë: i ՚0nM zr?tC\!BD>/ 4`ʜzKj ߡvAa1-; č禞.>.M_˻,y~묑n0߱W; 퀿 kNa P^Cp.N/p.Mc{h@ .!PRǛF>"I@.@!X/#,2H YTp_2? oZ!P^1 ^BF_6U8O`}w4GOIOq8O:_BQް;2_>3F01=  %`b/j~?pPP fZ:oq!$WO@}!?B` Qߎ+cHg OTIp Pq5V >]LY-@ PU (XS5oDLY`.@ W\1qXaZh4KgQ8!m.^l1d\Բ  $g ơlQD-^ĘQƊC ƑDRJ-]SL5m(N=}t&,U},$W>).\I` ȂVXe͞E;3]ړؾ^v+T,cA"7u |l\`ƍ?Y2LR&_xma׆FZj֭][vaRAŲ}\pō?R ?]tխO6Dc xͥۮG^z0W?a0@t~b; /T"B uԹCg-"hN Gw&~>1, eD(rG1[hM"qI~<p/@I/D/0J :B]pH̉~3N9bz10>6$ Ad1:q"~d> r}dJBҗ.( "p/㊪Tf4#aj]hG2Iz&ta2zXE"!J N0'Q$g>O~ӟh@ωhG4i H4ʹ97N I9'*HR#a/Z"b8w8IW]숙WJ*4>O ͡  * 0@[bZTƨU fd :MHX+!S:8¡EUIpVACSskbXr.]䣚jlfXvֳ gA;ZҖ)5mjUZml-Zֶmu[斷.V}\w5nr{Y#]Sr_%]R!s3f߅?t N: xq\BUy޵׾ly{׿ў@1,򿭭}}`s 쳲~/PA QÇBD0F #H7We eKx@ ac.t,bW.HMJC]F2b}u{~?|G~|7χ~?}W~n[}א&ʿbJMf)yÿ?$@Jqk+@J ,b6g` Ik@RJ/Azp7( { e%aH8‹HL A&O0 $`{ةPRw8^,й)x@(5,CƸBe`,<œY+TD nȂ ̠" I$@b%6ANl(0U豊828A*SHuX^D8 nHaӢL qb`M'Q,`JPDPiш6BhL΃$` F;PB``@BZg+QH lԈ 0=Enp̈7bXYиD&xCPTYYàpr`TpECxɂ((ɲHH e ȓ\6jW҈XķKXK oZɈȫ2yяlqLmxm<[8"[[D:HJZH'_(b!ǻ 8)Zh̫D 8Kud<͂xƉx lpE 4 hT̚:$Y\cXͻЅ,`:̈ڌypB ]Hɓ:? llHk$lʙa @^@ad :N_ ⏁a9Մȥ@uόn"M =PU1mpXAN0ֈ< }OP)шF7 ]: ZYЂȅeQȸPGk?p Ӌњ8R&݈#҉eS+,-]5Ip@\ĴE\`҃HD &TKMGEpEu]]pFMSEU\؋ϰ@UcSmHTIEU;M^_`a%b5cEdUԪghijklmnoGz :8?9 WrxVVhWrTW9({ysW9W:W|sWv{Wu5W؉؋،؍؎Xq5fU&$ْ5ٓEٔUٕeٖuٗ٘Y$ME=I@ڡ%ڢ5ڣEZY٥ퟦžڪZڬZ`P%۱E۴Ue[ڔ [ۻEەx[X۞m݈?ۺE\u ŰA\]\uU \ʭ\J]\ܼՕ"e ڮӝ&սM\]-%ݙ] ՈY  ^ޞ^^UnL ]%݊x_N]a_ץ Kсd -(n  Z{j_Y@`ĉy-4@YqG& QrRQ`F _%`F&s*4]S蚝^Χ %C%m1/F9/gc``brb07~ЧXwb00.@DFvvpvbI-2`y@> .Pj:F q'ʔ4 v%eQ$ AbHL^1//.nʋb.ݑxqx`02e0M@yhܭa>x,-V̉H.r8(cdH_fȆMj7Eh-Kэ܋x8KKn2h/hމH x΂Jm 6gI`es aP@chh{N4hXEDȐqІ@2V }c2Q"^ [B&xJmhkP^ߍ~@$1sx91džj$QceuHwamg~ /c2&1Nl7Al &v m.gN0&d~ u~ֈTT&Qj2J5Y/(]NGPnQlQZ Y0'𿖌kh 0aQN5Qmy5niQlGW׉@p FGg` upb2/0.y~dN v1s;!Pe`e$wNWBj\9IeqUq &q y8#\3yr?~rqtx 0h a.Etul/ OP/^ A0L Vg`kD @܈2ّ4BvP`}ptq^kps͈xpǵUKPWnog$cHwXvPmz0ΓRaU h~(+xug ``S d:TjItL&- wH h % OlŌR*y(zz6zzB0;6s h; 1fv EYh@f0 N } ?6z͝؄&ߨKlxq̂߉.$q0$dyVCoG X~h4iY Ƿh <6_y@Kqp8y2b4hcbRpp*Ixc(4_ nW&#>/&>|a׏< EN!0R`Ō7j/Ƒ,Nǔ*Wl%̘2gҬi&Μ:wI\k>Yr(R<)ԨR{A@2c]V j ԁ4Iyl/Th. laMFl2v1R9Va1Q7׸"E ^̲gӮm17\/kwV_~Ef$mΙkǓ/o>}慻`x=EMLAwx}) .F@J MCjif  ~MR$^%@Z|TSH9#=a` '*#u(hҐIsQGf5Pi$%]z%L@j4II`Q7FcA!ؚ}'BVdMd)*H)z)jנ  v(Qe)NCBIu_83nD >jي* ;JzJ4PQľd@M$S&qkEw44O:{.fj@ClD@i U @  qW/$ [50`jkOj4{yƺ5LG( / M3pRjM`cX5;%AtUXB{sGO [}5ֲLЧ} b1% 0WYDq: =l8J6 ?|1D9PK8[x.mE<$.?3>nlw:PCDoF8c4i6 T 4Vya a޺FhHK5>`zEpF㈒W%2p sUm&Z(C2r!G1F#60QGt[?9Q{D-("BqTq&rCL"c \E2\hFR^(F$(C)Q<`>XzcI$.$td`<&2^$ xDz 0]br"q7˹x +au.:At'>YQ3FւZ0"T2t *ш% Uh1ltC}(H1 0}@8:ԡ})J9*S6͑xbGn*ԡaAkT)*թR0B`p

my>>2/p!hA `4.=2&C`} x8  Dx>p=eb$(''l11 0N(gnQl/k6B Q v6PtI8` 1"8)e33&(-  1)҇! A8"zBGK8XxȘʸ، g95ԈPqxO؍X 1 e(h9H ؍xH8ܸPN%8h ɐ嘎 Ii uNy"yN$Y(iN'-Y QX9+Q8"ɓ ) 53I9;i+I#ɔ. 0)=I?iACYGEy] MO)QiSUW2 e sABq {11~'9 q91٘)Iqvvh'H.@+p €9yKɖY[_a cɚe)gII 2.Po Aʼn9͹ٖљit-"1p dyA )I㉏i婏穞ɏ鞌Q#YyڟQzj J D8 :ꡄ"Z$z:)-ʢ(j4ʢ.89<BC 2zED =Z/Nڣ8JЋ[Y]ɥ_*QagJqsʞu wjo ᦇNn<0ڨ:Zz!l{ש1nQt2wq2р ia W- 1gUgs@k1'@ {N mA f-wbr! ˀ 0eR  )n! @mRũB 0 xm "i!H؀ ;}bA @rPh#xx! ;. 02 ~ K0yw1{-92 -2sKy;M|G663Ѥ6!dA &0I LNN< ~еv`k dd8V;/Lj ` ` .Tdrq|~x[mqiѸ{c1{_۹;[{8+\Ⱥ &KhdxU+a PWup 37XL!:1ƼNқ XK! [Ơ ְ :pKr;]j>`0X ֿ''+)p@K 10'&A ,QYA yWy*A)00&HQ"P+*r[vs)%R95 1| mm0S12Q BW|SVsS<B SgGI|(X @/UZ g @2ΰ"LqPa0cE$ƈȌȎȐɒ<ɔ\ɖ|ɘɚɜɞɠʢ<ʤ\ʦ|ʨʪʬʮʰ˲<˴\˶|˸˺˼˾<\|Ȝʼ<\|؜ڼ<\|<\|=]} =]} "=$ࡾ|%圲L Ҁ1SгܲDpBi' -3dhʓ Dcq ( n gx.   Sf `Q < à N  `C>k0p> Ct I~T{0Jk@k[0 '&hX&`Cm P层T <++  4 FطP 1 l6WQPl`Pl  o;pF @ Ph EFExDT-f @ ~GFj%Kѵ,>^~lA; P t0n!,ǯh!V@Ի{g*`a -.AS6Ƨ ,`$H 73ݕB£f!,e`}H*\ȰÇ#J4xmŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ> PѣH*]ʴӧP&L&իXjʵWɨ~KٳhӪ`ѵpʝK]˷߿U}È+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|%<?硵蠅裱)@BjikR 襜:5hiiS骰z꫱?4j뮛+Z&ٰ,d.b>+Vkfp뭶+疫+k&4#+3Τ7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\wub|m,8bmhlF t'wݗ0ހނn'7c&LWngw砇.褗n騧ꬷ.n/o'7c6{ uJЋmATib  A#DE3 120Ofu-R. /`?/#؅@]/bE. b[b0H J^1 ] R (R)[ZA(y0!]>T!DF<&:PH*ZX̢.z` H2hL6pH:x̣> d$Q =!?ъq I%L6rO'C)12@ %{!ir=^m̥.w^9. c2.S::QS h:1gRgG^"qlC޼8"t5|^y䥠|>g?~(,?ࢰ:hCʓO eD7уRT' :}h(}GA:& gZRJӉ'8:<$#3)MoӜbR XPJTT@:Nͩ@-VE)Vsςh ;kj6PZxͫ^׾ `K-/!X-B|L {$j H`BBU $D၁$@Uv + 2f;i,AGA8!D%"*rR!JW„s aG~,tviEe5|` 㘇@q\(?R ߹W"@` 4(lV!'aDd{Pa IP@:H¼ҏySd]'BЏOQ UG:E3R}L*[XVݫ(=Ӏ.Y&ɖA^/<s\f9͋a1y\.T3I$qlAX~8z##"Y!^Id<a09No5H['H*F 2 "Y 04BUDD/A⁂ dBt Bk $͐  aOc7o%@Mx"|*A1 ܗi-rJ@_ oıXci`; 1l8.H8Y8ܓH8qm ɞV%3hk M8pt+aa}G@ka2Ja L H+c @Jߏp$(H0{C' nJaw; @<|C1,kغv-=Q(HP>dT#H,j_ q|>& ؀8XJ5װ؁n "ȁ1#X&(,.1Ȃ31 ~]- B8 Q5hIxAKUϠ;(OMȃY[(_HahceȄ}Qb#l؆n(rȆq8rXvxt|~}8 QpXE8 {ȇh8xXV䈛(؆hhAX㉥ȉ(Hh(Z8pvB(dPt!8x؈ڸ؍(8hሎ|q V-@(aÎt!ȊhɋHR 7@ 0xxXhHȑ  (zg(]؃1-357ɅgP@B9DyAiHyJCٔNO9T)qXZ ?@X3A`hYpk9mgYrtI`xwyYs{y~Yf)iiln m)ɗYqP524`b(dHfhhЃ 1A4Iɚ8.0i <D<Q9Yy虞깞ٞ ^ +oQ.Prp› W7 X#B;7xQ 1)PqL` +7 T0y'Ұ V3G b 7%6 -%4 v 9ɰ=" ` & 5e0 t) R {Ez 'Z1 À @ *:{npy >J]^Q p7@ zs7` 0r q@Z+p60㢥x}`3.%/F F3.3d` $ p>13@/S P p 0ê1z0 0 r@ $ */5$00B70 j d "qXRp 'dJ :;P4>QQ+ 4 k+۱; >Lb&{(ky+ hA0[2;cQ68\<>XBkD[RqH JNѴNR;T[V{X:sgZ\۵`b WhAh@ciJ av!/ d;W Z$ j;iF` @iڠY|k3Z8Iݤ81X8˰ +'qm T\&!H(0m0r#p rq(=T*"P<`%btkk@= 6pN yaɳa O@ Zѷ&n 0x'"`t_x ࣽ<^~y\qJ0a\."U)Q~\nW'=`iuV'=ǔW=r zG Eg_v1*S4 !,a_H*\ȰÇ#JLxċ3jȱǏ CIɓ(S\ɲ˗0=n$pkbɳϟ@ JѣHGVZ%PUqIJJիXjʵ`-YuKٳhӪ]xKݻxM g LÈ!ZĐ#KLϠC]w\ LװcfLZٸs;۽ Nx^Ɠ+_μУKNسkνz}Oӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔VS,f!vJ! Z j_,P٪}+}*{kzly.lw>+-vNkm~0O?#ж 5zD6یiٵB~ ? 0kparm>3X =֙owW2>#x@qC tlO7lpiPu7mYB7A@=OS|ge=?@ >u&A7W2?䓏@43A `d]}@ T@+r 4&@MΛ>P2@38C-G.@%#zBșFq>@h?+g/ :PP0ڧߓWNyPJ3s s@ x#g??[ HAHP`Y0n U!f&LU &.Ƞ g w@ H"HL&:PH*ZX̢.z` H2hL6pH:x̣> IB@8" 'K0rw:|$'%Qro @"/7j(GIR򔨤0J,gM C@/v^ xb2E(f:AftAe-i͂T4Iu:':l….za آ$S0| P?JЂMBІ:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwSdҔ,$U)D.Q@8 i5_g^ ' , \骣eX‹U" ,֚'ro&ArW,W1"Ѕ|uE%]iq 6Zwa Xh؅UeYفl}]9Xo,` `(0 4;D_{P6_ vGL(NW⍴a qX7A1QYD5mC y+2wExˑ┘2rH+(e0np@xs3g@z~20,9ѐm ZV2N{ҕʥh*ӨtEFO_]RMkPZ*?ҡ_!zuo=\+o"lZy٩~vTr;;mTk*# ¶s'awC-?NO>1>8yX9c6rb.9ԕ8I9Z9"d NP@,ps 8Eq7L )'H⒍e=9T 􁄁ʎЗ<qiƑ' X*D@!̀ep,!S':<}IANя4%x_ (ȯ wowvwc~~ʒ;QqS֦..&GAa 8x=&BQ9stv9"%' m&/2XX'bI!逄 10A0>6 19IWu0(a=Qqo1;Paa38?88c@3a)0 C {4'~` V'Q1 r a4rJ7tIaf 9 YXy6_~ 1xy ea7N _+a<(l`2p3F \ !xwP97'ވ$tx pb2ݐ86-GQxd"t&7p ?0w9'!5˰ |7װh P.0 ,Ȓ?3icPMq xSӠvMް{-{0.RrAs'x  e/ :{q"y_38x`h-GP @#!t.iJK UAP L 1 q.9B` -S2 P1cDHiӄ@?l0׷ _ @) A7ᐝq|Zzڡ "6` ϐzqఢ,jG,04ڢQ5:8:2z>BDjCzL(֐ɐI0JڣDA>ʥ;8 9 G*U'6qtKrj> ˸;{?AS< GкQ{ۻۺŻvKY50 a!|Da{K{;k˾{廽;۾{+ۋ˽+L<˿{a?E,MGBr;t{#%N['|+lQ,@@2~-;ܶ=?A<)LElG,!k8ĭaDK ţVZ\^`bRQXZ]nA_u J4hflnk1t~ϐbwny|c4{(ޝihĉ9/@`p3Fh cQW0-!#0zpS;6~pKnE @\)LյqLr;mNdk`p@f%> pb@ _U5Ѝ6.ʘwB1ԣe~ZX@B]Y1Zm\F% ҐuggTG\$(?͞[%/1#/fj0[.!!Y(_1691'@O3BO_ƀNv 3vq^ _71 .e>X U8%K T@ca d+_EkeېU%`?P 10ࠀ z.0| AU/l? c@mF,_ ؟ڿ?_?_@@ DPB >QD-^ĘQF=~RH%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DOD1EWdE_1FgFo1GwG2H!$H#D2I%dI'2J)J+2K-K/3L1$L3D3M5dM7߄3N9礳N;3O=O?4PA%PCE4QEeQG4RI'RK/4SM7SO?5TQG%TSOE5UUWeUW_5VPb(&׆(bzXHW`!&_t`5ڂf[zVo{!Zqm6]oǵv ueX_| xwz}7wa ~uW\pŖ[%'8ak߰c%6x6_6bFWMeWf_n5fgι A蠏6?D@IIlfxyp @q 9g&[VF["jkmf{9^[g&쁐Wa'b Gܡ-/b/fmfsax-f֖F m` U 9^SW 4!^1t%*p$` ƝБ{s$Y 𥉉0\2ESB=B}N HTwI`l| .!b z v 6&㊁B#)?И`JcA,?0ΨcmP:Fß8-Cȓ A r yh "nƹ!ri! -vYN8ࠆ& 6Z F Vfjv 8$AFO>a Q:L9c::@J6d2dJ?O?.OA@A8ϋ췸-۬r;-Eȣv{$&:eKP2, ۼpFr 0(4B!gkP2?cʥq\Y !Cfϣ˫<AZT2BJK8P AlK,yB-TкH>t3a GM8kߖ*C:6O&]d=㨥7 3#h]I`J:Zr 07Ɲ+{7G/Wogw/o觯/o HL:'H Z̠7z GH(L W0 gH8̡wC@ HD9HL&:PH*ZX̢.z` H2hL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:vugJӚv4۱NgӞ> PytD<Ԧ:P!9bG8. ^A/iGAzpC;AB8Aq yP#qve}v9h;(]yA$Z-lAXF% hCKz8KmcOZI-LҶIJMms+݆ip;ܶ.Kmr{e-R׺G9⡊<+ޝ.x"^Eozޢ^~ J=2_w('UUx'Hߣ{mpo9 kאp.?"(NW0gL8αw@L"HN&;PL*[Xβ.{`L2hN6pq=ӹ~3 AЁFIhA۹х~4gJYҍ5gL/:&# Q׹ԣUhTOӉ]ilָu^Z"5a>ldGٿ~6kFqXζӢn_["6íq>ӭnvΣy;"^7 p[=r1F m" ~o[v3A/B-~KFN(K򕏼.7cnмo3yֈk⠆Ї^-1n\wpgg5d pε\; A;CԾ+ ;Bmk@ J`2mj;Vv=xb>؇N8<$"?<3s|C/zCA_O~}_|}?#?[>{|㛿5M<˺4M׿ugmMj(j~h8Xx؁#9e`<T  G?Ȁ 2 P3 ɠ8lS9 6ڰC4@.WPQ/B> ᰃу q%AC w M@ 1(Qx fMx^ِ 5X6?Ӏ e!؆ X0 T} 0 p{؇ T 6 EQcp\! @`  H A4Ȉ2A[@j Q d`  >lX)Ћ!y@ pT IݠBYpːQ@u)W  &p(A3  Q561)0r,@ äܘ   zB@ Qp T@x ?P ?c`@' &(iP>;1I0 |  GJ1>@Y͐ap1᳗a 6%З = xaAr=}ha ᐇAȅ4a 0 0 P=c  ҩ޹ <9 ( @00 )Aٓk{q ည, P @ PQ` =0 О `@Y Hc8XQ,`+a a-ZʀQsMz I#惃] Ӡ#bJʰ Tz!W` йTZ VpZ p 8N( .Yp:1ʩ᩟:Jj:ʪ*1j cTp 8nQ کڪ Ѭ*J `E>J :JTc7E dq*`ѯ\1{X k ۰T+;PQ{LVKR" $[Nq(QѲ.2;c\4{8:<۳>@B;D[F{HJ*[E@BVh UZ7\(}(m 0b4h8<@)䐃HL6PF)TrҕWV\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+kVT,%!C' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmwNTHa <p7걎G$%IF2O Ćy8Yp%HGQlX&?iOtnCANB4?4$H$3QVTK!m䃤?Zd&fC,R|uڞ1~@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:6d'8P,f/NCBђV9-j^3dmkAKZֶfuYrִ8 [RָMl{ZJֹeHq\Cͮvzw+풷=/z-)כҗo|Ż旾n_^u`Xo[`VXaNp a'p5X8,3Mwc,d,ȹl %3!N6 F@Yp;bwY 򗹼beq۴3bN3La9{`fH b<&n.[LWehѹn%[J֐ȴ7i@ӠC QӦ>jTիvcݐYgH^z6!Ml^Nvfvkh[Оw-_o;"Ma[Nmnqю7m.͵q\Fw{o?ލ i7vx!^iWn7{ GN(OW^Ad#P60 N4 X SZ =7:`3ޠnC`)ld=pө~.q ;_t1D {AU`E񌱫3V$*nN5q08=2 md^(97 4غ@Nl @MtP!< 3!s| @W'(0fE*  CL#"A( A1@Z1zO w.L 0|t 0Gwq  L.(a P  |g}{O  -@ z s0 }Ϸ Lg Jp/ ' qR Q0` Q pQ] S@-' xqT @ }P .H/Y@ ({` pg O}A 4OPP"'$'01J W@ A|ߐ&@}s WP ;H S ?-7s s8;g @xE Ұ ؐ !zW 0?s(p ?8  `.ڗ ` Yp PY ` Y ܨq *I 49Y Bwt88t@u P4K)C 1 @ 8 =IY 2 0 9 Y)@ʘbybِa |vtrT69Y =9 (I.(P9#w.Gw GAQhC Ř! hT P À` v) ¢vQ|˜?H ȉɓ, / ِИ_ӝ깞 ɚBYIv,7ٟ:Q Zqj ":$Z&z(*,Ԣ026?u&!,n\H*\ȰÇ#JHŋ3j|8np6N?%O0N@(IfK8sɳϜ1_ѣH*]ʴӧPqJ-!P0Wk)4ͳ3](۰QʝKݻx&ĉTydXuS S5ǐ#KLE/#˹ϠCע&7_CPX۸sKάy Nȓ+_μУKN񻊽ËKӫ_Ͼ˟OϿ(h 6)cM<fati Ԇ@]h(;4";7)O4CNГGd"EHR6ґU5(v^,G?2{^-Eq>0IL@1e2|2"MhRt6ِm@rs(g:vs|DھD)-M>Rh|NT5MGӒ2?miO_*ӢHMRԦ:PTJժZXͪVծz` X %eIy5A u\[᪵k'(*! j,(+5J׫9#`ld#mZbh,I XE3AeC"`28{U(,b (H"`^H32 w L04ۮC![,` Hl\ N d `Gd`0 pAGwv j{#C x!/A1WTÕ@|bC[CU`"P@$ DW@jbbg b@q-& P@^ "=> YF(0 "ŕyA]ʨE-z ^b 6 ȚY?E c 0Ho?C/x̢τ.-,f!b*۶xޙ,eDś# Y"H/BL.ԼhCL["ٳbϸ/ >y|s}$;f)n`XufrC=vMzη~NO;'NCXϸ7{ GN(OWr5-٥8Ϲw@Ї~**&;PԧNutG]1q\cNhOpNxϻwѼOO_xE=qϼ7{GOқOWֻgOϽwOO;ЏO[Ͼ{`O~$OϿ8Xx ؀8X6@I[Ё!,H*\ȰÇ#JHŋ3jȱNjaIɓ(S\ɲ˗0cʜI͛8sܙϟ>y JѣH*]ʴӧPJJիXjʵ+KU`ÂJٳhӪ]˶۷pʝKݻDSݫ߿ L*Tǐ#$1)ɘ3w<(Nr(*ӨSK|(QU˞ըרB%p*p媒H U++ *m|F% UvRo{Nu7gWTM۱i˟4ㄼG]6m]ryAG߁$ Q0DlQ4PG40ue1R›+m[(݀lUҊ'JTUGc| )M6t[hQ81#VwЀ6ڐTV+}8Q &R+YP''PfJq| (~,NǛ(QxGg詷ց'VF*GZD[7JZ81IN  ΐ aL꫏bK)0aXzPp LL :Q&N2!jǍ9&HN(+BD't@"N8-p 񶭃ϫtDRݘ`V+ 0 {$Z͚ &!NP$L$LdZ`≖k0LT' ~ 7Zu8f87nT+\*8DJZl&SQ`K+!ʆ≈Z1kqd %L(ABa$8TLJ"'&K(5&[gpИ(aJ@uIP&@(,gyIR _*'ۂ}pH~,vc,-b1[D^1TA&}&TₒA``6epƄJPBV{Û6)A:D$ ?~bDaHB %Ix_ JTB>:AVi{4 P؋ `5eop& N=(zP L %403P8/)D' M*:>W`Zx{IlT&b@s%>3]d!`[B NzhHQFRb ' jW"j "xE-^YP4ĀB7Wb 'BO !ER?T!ՈJծbO6O@$JХYB_̈́%( Lhh [OLdЄ[@`(ձ&ːA~\}jb'kO QHO)!S'Q,,eWKo)[ V\ Mԫ[9ZILbҖ 2"1zD] :НoՆT b51V]eb\nfKym%rV #0޸ d[^@ U+ v'La7ΰ7 G[ఈGLy L`0|pX8α # vL".1&;,OL* +{` ъH"hN1 `p*( πF3/~'8a(#ʐh'Mib BdGcViA0LVZķgMZָεw^MbNf;ЎMj[ζn{MrNvMzη~NO;'N8 pPA y y} p!FWNs[8!p@51HOҗ;PԧN[XϺַ{`NhOpNxϻOO;񐏼'Oƕϼ7{GOқOWֻgOϽwOO;ЏO[Ͼ{OOO2ѐy!8Paː!t5@j0  8 0sP qC@j!@*T *HуBX<>Da +h7(I[1 (P+^8pdhhrjRцZ8gxvUa  ϰ uH(rwxm H0/؈V舓80ahH 3׉gHy׊y7xx؋GHxxxHh(xx؈w(׸wٸwO8Xh縎؎8Xx؏9Yy ِ9Yyّ "9$Y&y(*,ْ.0294Y6y8:<ٓ>@Bx(7FyHJ KPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy٘9Yyٙ @ @ ؐfPq؀ g7w pfs Vs)x m`s ᠁)Nr)39e ry虞깞ٞ9Yyٟ:Zz ڠ:Zzڡ ":$Z&z(Kل2 3:d:g>@}Bj+ C ѣK5*7E*R\ʥ&ѥḃ 0Hpr:tZsjvz9!|ej\lʅnڨP ?{7ɰ0 @ r1  rjn@ & =?Ġ 0 P i.hw ON iA%ܶ hAe` = w $Ʀ1_ .&yF j !kpQ' _ P  /{N){8sam- 0 _+@Zr/ r1".-^ĘQF=~RH%MDR.]ye b[#gAElV] +5VaDTRM>UT &Nkײ] [lc3vk.cYT63/UśWo^%L[-iڄ+ă|Θ dʕ-_Ɯ٩l_^ӌQrF[R)QpDì P-nޭC~vpeRԝr͝?.TyUPܵk_׾_]ݿ_|ǟm/@$30AA;#/0C 7L A?1DG$DDWdE_1cFo1GqG2H!G"D2I%d3#2J)J:2K-2L1$43M5dͰt3N9礳Ίд3O=SI<4PA%PCE4QEeQG4RI'RK/4SM7SO?5TQG%TSOE5UUWeUW{&}fU[o5Xi5W_V}U}E6Ye#}]6ZiŬ~"Gj۩6\qU),rE7]fu 4ƀޓhc uŷm7_vi`fa8b'b/8c7c?9dG&ddWemY9fgfo9gwg:h&hF:ifi:꛱'k:듰1Wk;l&lF;mfm߆dq;oIGosN矿'pG{=zsBqԙ{GMg2OS̭?/e?۷r?@)|+`Ё`%8A VЂ`5AvaE8BЄ'Da UBЅ/a e8CІ7auCЇ?b8D"шGDbD&6щOb8E*VъWbE.vы_c8F2ьgDcոF6эoc8G:юwcG>яd 9HBҐDd"HF6bd$%9I9]d&5Kvғe(E9JRҔDe*UJVҕe,e9KZҖe.uK^җf09LbӘDf2Lf6әτf49MjVӚ׿f6MnvӛߴUW!0Ѐ3sԐ4aNvӝg<9OzӞg>O~ӟh@:PԠEhBP6ԡhD%:QVԢhF5QvԣiHE:RԤ'EiJURԥ/iLe:SԦ7iNuSԧ?jP:TըG @ ``M}STVժWjVUv2 d@!,H*\ȰÇ#JHŋ3jȱLX:(ɓ(S\ɲ˗0cʜI͛8sٱ@ JѣH*]ʴS^ ]Ojʵׯ`ÊP`҄V&#A}"Kݻx&JbKÈ+^xI-8I$˘3k̹g*MӨS=K@Ѫc˞MmU• Nȓ+_μУKNسkνËOӫ_ϾG˟O0-OKW( Rˀ|񦠂6`p D˃x"`H vgBP+ˇق,"&bA4ָ^/ L/b#CDI,қ 9$PF)rJ,WJSv嗨]儴d_J)`曄q%B[N) |ɕj@s>ɦ@bK,裐Rt/5Z)B)P,h&LDjꩨ`&jvUj @K[S)&lQ d1\iRS3!18P)1`5'8&(0Koirjb5'B1L3>!"HLHH*~fȢADb}V ic1Α6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WVJ{,ǨYڲ@:ry^V0'x l%oL2f:ЌՒ1~HGnF&7I>b g9'b'1x̧>k}3J@ԇFA 2D'JъZͨF7юz3GGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMbJ*d#RR3YrF,h V=RSڤG}-l* *ns pKMr:ЍtKZͮvz xKMz|Kͯ~LN;'L [ΰ7{ GLIJ@d t*V#Xŕ83C -#&P ^*=8I6tĞT^$?A~X9̓?6pL:95>/dtgC"C QI ZȅHF;ѐ'MJ[Ҙδ7N{ӠGMRԨNWVհgMZָεw^_1miNYa$Jxڲal'`dA.ndgլ$ ,H vo!,R v@ B[ p4Ȃ:a|A3!բ2ް1bk !-#a؂ FmBcCD(.A g_mX2Qkdc06L aPPa#0^7]x!hbVUDۂh{(s}(S#<hCF6`v@:م1tC|dDW@Ҿx@"&t p P7cl[o XFlZο7'q65Z@fÕ| wEh}]͘w-ЩpGg~~Yo! f }Ār'?u dbym} "8$X&x(*,؂.0284X6x8:<؃>@B8DXFxHJL؄N8Q0N@iIkvX0XTZX@f1^MO 'rSg(2`۠b ezHO!9 9h8ySP-$HT}(xNJ!]|؋؋xȘg[8ԸT` PhЍc`Pа  HQ|WF:HqL8ȁkGN6a3E{ HB^ِ0 "Zx(eX,IQؒܡZ* 8fQ>h:)<@(C99@pVLiD ;醗WyYy(Haicie)XmoY،~hwy9(d y+)C 11 bedٚ9Yyٛ9Yyșʹٜ _ Ey@:ky0~ai64z x a cHp~@09)1XùT'߰5ٛ ZpN Q`bM0|jH90/:4Z6z8:<ڣ>@Q8DZFCJLڤEP1QZVJZ\zb*VjSPMʦJNgeje*Y FW_ʧD ]Jsju  :Zzꁺmxٜ yrZ x ' y\|{p XGD`!hH'm۷~] =ܹ#G@`"q"&HMA e ]}>^]!wM:G *Xawr b= 2Q|A<  !YLV%ңD/F|8~g!,H*\ȰÇ#JHŋ3jȑ+I`Hɓ(S\ɲ˗0cʜI͛8s܄0@&<JѣH*]ʴӧP$JUX8+`ÊKٳhӪRO"ݻx˷ߊ#)YJhg+^̸ǐg$݃#3iB,pϠCM鄚5Y4iRA#O˞M۸FHiw Nxq[q2μУKNسkνËOӫ_Ͼ˟OϿR)ҋ&EKA1(Vh9bvaB|($&HLAR,2p5P.h@,@N\}$VD&䒦e%VTV+`)\veTXmUX~ih外l5;n,iigVTLV ʝZ& "Kr 8VA`U)PR@(*dB7SUTR@L 9ꬴNG ;t!yr“0i&8)PZJ+ԑUTIW@ 4LЫ@T }:v X*$!ˤ@XJ 7W8( J)4(,K%Hg#{M:a5#6#5 L% J,?9-d ,,O;D ,d0ү[9@#P8:IipC#U-DcE`(5؈'8`cvQYeըA#KYuPd GV褻td!)ޑ'EF~Q =-}+.Ɠ* GOtHow/o觯/o HL:'H Z̠7z BHBҥc_KB]#-˜Q6M2̡w@ H"HL ~cPL9X(ZG:.z"Hoh!yHl#P':x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:v~ @JЂMBІ:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\JWV`h9A+Ae aOQ $D4 a(nу 2&]Y7B, (Ati nH.` Z( 6` 0~{IC Ge<&2L|`@9:*FeؖN/m-X }EF :ȹmA߁lfHK, :&T )0Adi9;V_ ;N-:E-r1\&H83lJ2$S@뗁y3!`c<b6-Hۅ(7AcSO;'N[ϸ7{ GN(OW0gN8 2~@0fә6a i? XR^8:;t~Ly~4>I8D{-ul!~65EaP#˧>uS!g(*~BZe3>񐏼@O[W7{vxbm؋Qxunw2Ȍ!~1xؘڸ؍8`w蘎`؎Ȏ؎8qя5tiȐ(ȏ 5\ iH H#ɑ\5Ӓ.09- 4I6y0:<ٓ1@29AFyʕL@ =):I7i8YF3\OCɕ; QISiUWY)Ioɖ])c[I/)yDiaɗ5YU6B Дј9ɘyٙ 1s0h~YyٖH9Y.eYUT6w{}ɜ J锼R)3)i)) i\)1 y)ٟ:z \J: 0"!J#*%#Z(* 16::z0@J4ʢ&ZD*3)ɞI+ɤ Ii뉥MO*Q] UJWjY[_*npr:tZvzxz|ڧ~:Zz::֨*Q[shݕ &*Za[ܕ 4iuJ  : iAv:ZzȚʺڬ:Zzؚںڭ:Zz蚮꺮ڮ:Zzگj#]C[{ ۰;[{x ";$[&{(*,۲.02;4[6{8:<۳>@B;D[F{HJL۴NPR;T[V{XZ\۵^`b;d[fۉl۶npr;t[v{x2#zۈЪ_۷dȷj۸[Q ;h+zk:Ra1gga {mh[ ;:ܪ!ۻ;[{țʻۼ U3 o٪ ˁʽUa r" {bu_v !,!H*\ȰÇ#JHŋ3jȑf4 DPLǓ(S\ɲ˗0cʜI͛8s3㫃`IѣH*]ʴӧPB*O$ Uׯ`ÊKٳhf$PdAJA j$m˷߿ LX &nvH2qǐ#KLeC]|ϠCMz#ݷ 8]װc˞ԏhͻ߿q ԥ ȓ+_μУKNسkνËOӫ_Ͼ˟O1(hr " F(!iJ{l5v ! Th@q("K80Ƣ@y+\%H&ٙ JF)TVi9c,NNͨ2OXhJyfĉb ii'f2PMь^4@ i/A0d!tA$!P\fip@[9B+!r@ f.e)AChhHl뮯akA@~"PJ eJ" @+dBH$kYRnR@n{`Q;UUǜ0.uAWUI,< 7,ذJ9ZK1CStJPft@XK@"P!286׈(FtXP*҈iBL2@A0&q@,+D`3 ;,fO @ *H[K3 -HS8z\K+A\*仪Nͪʙ -,UPvMƯoUL*KKע׺vM8Y-tҁ x@UD\6n.gz٥ g+[UdއkOPbֶ(FK_1DZIE6Kh*2A CT0 gH8̡w@ H"HL&:PH*ZX̢.z` H2hL6pH:QW@=ď| )BYjC:򑐌$'IJZT@N"(GIR0*tRc:X̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:v~ @JЂMBІ:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'KZͬf7z hGKҚMjWֺlgKͭnw pm8\*#͍tKZͮvz xǻ^Mz|Kͯ~LN;'L [ΰ{klxW@Ƈ55K7J1$bD 3>0h. ,X:|$ "?IUE-qY!/v9)2>y&TTysA*6!3 b1QsQ*腈#".C7r#FEx b -a$p~S}ܼ .~,>v:O3?&a;dH廳WV%UE($6!Z15-9;5_ӓЏ>N3O['O{_*P/y>P?4 mhCІ]  @{ J׀w x8x&R!z#W0/x8"Ex:x<(>ӑyy w}NG aHLP'S8G.I7ZXQȅ煯Ichyaf|HɠI!eHadY|{x8|xCȉ*ԉa ,| B*PЕR8Xx؋8XxȘʸ،8Xxؘ {P|H蘎(؎8Xx؏gaYaq I ِi )y ё_ m y'I)+-/G51y9%ّ;Y? 3AGJLiєPQ9TٔVyKZѕ[` 1dy_fg \ٕmoyqIsYb9u Ŗw y}閁 )Ii_i{ɘ ɔi闙)\{Gd!yٚ 隰9yɛ雱I{{58|ɜ霈 Y)iWv @ HiIiIɞgWאHp DٓFY4ɟ&*I,i.0_Р Zz ʡ $Z q _ -/. @6 4: ;ڢ@?*AʣF*<:JCz=RS8z57ZR^j\JbcVz ʦ 2):s*>)iI<ɧ:{*y@iujBڨ:Zzک:Zz** /3ġ`+qzF F`rKѪJ A ڬڬ@ >azjyJ:Zz蚮꺮ڮ:Zzگ;[{ ۰;[{ʎ۱ ";$[&{(*,۲.02; H* 篱ǯ@B;D[F{HJL۴NPR;T[V{XZ\۵^`b;d[f{hjl۶npr;t[v{xz|۷~;[A:Bj^۸;[{*"m[{KOӺۺի ;(`sA }>ǻ7[/r^H ˯1;[{蛾껾۾ 7mPp J wkA!,H*\ȰÇ#JHŋ3jȱ#L>䱤ɓ(S\ɲ˗0cʜI͛8s(r`$w JѣH*]ʴӧ4?R%(h0 ׯ`ÊKٳhb"9i`&M@IВ%pE7߿ LA37(&MH=L˘3klPPM@vL)/޻S^ͺװ][R۸sͻҵmQMȓ+'+W^ЗKNسkνËOӫ_Ͼ˟OϿS]X`#K·HA FxY/f8vh^p$h653V(0F-yH~<-tAH&I/3P1iTVie}tu\vi.^*ediqeWip@՜q瞃y|*PMVH(F*@TŲ@&/*+/pEe%BAv]:FE31ӢS`V8鈣P#P+ .@{dQ,jJ'8F*"nutrK:k{T x"4L`@8P/@l+pB ,Ȝɳ5 E+ԪA<@-|B<OGRIf)ͪ-2=3F@ǧ4K=w5YOG$t?BιhC;5:'H Z̠7z GH(L W0 gH8̡w@ H"HL&:PhdȎX,fw,zp[v eb6pH:q5؆>Aա$0zƶH2h$ԶIZK&7NF %a6QEa<*WV򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:v~ @JЂMBІ:D'JъZͨF7юz Hxv&&JS͕.}i5c*iҴѼ)NTT=7*ԓ$*RzԥڴN)TJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'KZͬf7z hGKҚMjWֺlgKͭnwF2 AMrptkM`28ml/?]7My]^-{7}OsŸ/Q P^a;'L [ΰ7{ GL(NW0gL8αwtFA1 xd0L2d`E)wVYe!l-;00ш$9'-ZAt*U"S1!p#$7[UA)HEJtEbc`H-_ԂF/(Y#@xqZF,A 9/e5ldCm2(eH/ l =yȔȚAƨD#*)5\:v0̲ 3ވ'Ê򘇼%yo^'zяOWֻgOϽwOO;g@ 4C <=RGkn>Q qp >XHl H PSL !1   M's! 1Q0N(U'~,؂5^02.!3x0X:8ȃ7DxXHw JX"oO8TXVx16X! #~[!h@}]i0h8^Іj@P p'l&(7l 6\ܵ4?F/x0X2q)3C'xHb؊XFD((}B>8%Q&x(0qHو؍ꐌXx]Gh8Ȍ]Ka^QxߕϐyٌHD1!   `"y6:<ٓ>@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`bU8f(Gg⸖N薫ryxz|ٗ~9Yy٘9 Iy阜ٙ)I c 񚰹ii隬فbɛ)iɜb2Y ֙ کٝI9Iؙٞ<ٛ9IY'ɟ9iz ڜ'I jYb(PF(yɞi1:3 5ڝ7 e@ (*IKMzOjQZSs:"%QFzjʠgi kXjX1H p ¡AxJ|E ѧy1~ZFG&:Zک1ZJ*1F!@:PJګ:*@Ŋ:zǚ:*Jqڊڭꭻڬ ۊЪꚮ:.&CJ*LJNjPRTʯVj,aJc emj !;[{۱ [YBJ/'9P!R;+;Qց299WTmdzB@#VȰL0 Ӑ2"Bd X Ek i*! _U nnkJp0HB ;`h1lUp d ? IvNf 6Vm [ qk tIa ,[ad0H!`0?16jc;l` d4jqB! ؋ཌis5G p vɽap{27@jc+f Fa K2Yʤd 3bd t \l  |0"|.\v&F 4\6|8:<>7L `? Ăg@vзIR$^&~(*,.02[G r6r< ` @ R1 #g *W4{t$P;npQGQ^bcsa~ve.V!,H|H*\ȰÇ#JHŋ3jȱGmФ M.ǜ˗0cʜI͛8sɳϟ@du)eghvBJJիXjʵ׊`۶daSm^_ʝKݻxn,0]̸ǐ#K.˘3k٢Π"MӨSS~%uװI{`tgͻe 08ƃ+_μJ.سkνËNӫ_:a˟OϿ(id}6&sfF(!ghN<d̈́vapȓWm@Y;mዘ U`[Lg~5<T-@6U(PX6.v[,y(ГQ1:&]$"Д> )'$nAB@(Ts8BXj T<}bgU8iO$Nڛ"PX}ꓘ8IP4y2M<"O?lÏ(#=# ؄2N8:j$϶{%6ӘQP%C'O& c(WsMOiN0I?P8d&dNU\qMu$\"*vF: cGy`,mNC0@(}# 5\ )M5sM XI'1  b0Pa1DJh6lZcI(K8\XPBIӇ@A5L3T$U^cGYPl4!>-9ӈ/ѼFnH>ro%z@3Jf$>ؼK͸$1|,?(!#{҇H&T[6͌ZϺ8ӏ@;<5^Lj6o͍DG.ǻG$C81<TbX!9vYO"q4 0 ӢeiRR#ۨ $^KGP\䷩P&Ә?}kJ֔ESHZײTq0?2FxJF2x#Lwp ,tӠ|YG8dL)34eT*j@1&YdOjS+l3&mQ\Ry% ND7Auh0֘1C Ap@͉V &Annd~Ә/tMyxL(,Upf̞-.7-h?r68m<z LziAZָεw^T d ^x׻BAZpbV5iEY8@HP̆4qniF8Kzη~NO;oLV9ɝc{ GN#vQ_mF=h5´rd_CFڕ]tr@)dHF2! g.ַ{`NhOpN]VFk(O› F0^0jpgO瓟FGolo"f7,t"ϽwOO;Џ{;sX!E,^AO7C0t ^ź,Bsv 0 7 00 P P ' "8$X&x(*,؂.0284X6x8:<؃>B ?X?lw};}wfkq7~ Z\؅^`b8dX^ o v   gF0r8uHrH4P 0 h p @ W 0P X ؉8Xx؊8XH]ehxնcdJfS!kxW\8Xx֘ظ؍x\،abPShPVe8XhZ`(XZ@hb0I8 ِ9Yyّ "9$Yi rQgu@w؆W $:<ٓ>@ +$@+:PBRKzmʳQEJ dK0;Ь۹;[{۹ xk 0  d- 0 0[{؛ڻ۽ޛ|K0 ` йZ U xZk ?ki บ; 0 ` | 0W 철@{˻p |` 0 0 6|8:l=@,*;; \Uȣ' l9Ѧ{ ; b< 5f|hjLC @ ` 0 p :< eBK p,˜ƒ<ɔ\+Ƙɡ˷̷s [ž`6>Z=y+; Z  Ư0ȓ .  y\  L~ Ǡ Ԭ ܼ BK6bۭb,wk xɛkʧ zmʗQnԬďJ͌ͯ P  "=$]&}(*,.Ҙ0̬ &0͟ q  Ϫ J-~\V}XZ\^`b=d]f}hjm$=b K҄ @kP- sڬ`} Ы r ֔]e=ٜٚٞա l`  ` L  P Hџ}ȝʽg-=ԟ JL  0m\ DșbR\2y* [< Mݚ=m>NL .^ ^>^.` ٔˆ M= -<W2]<>@B>D`͸# :Ռ ݡ ƐԔrZ e; Э0 T< T-Ɍ ==t^v~xz|sU n q 犾钞  J ߧ ۯ p @ , d G }mנE^~븞뺾@N^ N @=\.~'dnقf r.T.׃M]~y w薠 P{{PߵM,/ ?sNƮ\bq(z@tIF'E^K2>xn{-v͸ >ǜH XZ\BݭƞaP{ 6TܙZ5?(*J ƌNYU{_>|/O\<꤀ Gϡv ?_}>Ŗ0  A{ѯ@ H 0235>~jF/ϪJ?_؟ڿ` U\?_aIL RȒ&J'5Qā-^ĘQF=~RH%MDRJ&UI%45qy&Qbz勗0jESn\M>UTU^ T%JSGRZmݾW\u}r AX_H(8)]ƍ?Ydʕ_v7b#ZhҥMFZu _mɓlÏB)ԦR͚E&KVi8͝?\+W_fY,^Z^x͟G^|ZؒcSMlLǟ?#ƖI0 D0AdA0B 'B /Aq6{~ƶFqJf^Kv% jyeeQci**֞xav ׽,N׀'Bs59HЂ`8*>\SP* ޖ <Na2 $c{;, 6ŀZ.֔qkzD&6щ JQ,@ F$Py[ȴ8Mx m<ÎϠ@@1zѓ؞8HBҐ2SІ.$: *PYŘ61LaJTjVC7Ʊsi*$:d.uK^(P$C_ GPd-z!b8#k)Cƹ payG<*P?c/չNv9G21?eb"3`66d8ei>ӝhF{i#y>F\(4mAP"Tc*[JԎ9-Qԧ4_8qRIs */qPp$C7\*Ppt$'NUџլgHjT{&99)*҂: `L:Su9%+Z;XZFE=wl5+Z־p1u@c,`[P\nMߋ[^W'Fqh A a*) U"E/* US$?&OF^֫vxXk^T[z] Fwսnvw=o!ĵI cS4ooʇy-q7x%>q;pqYNJ^~;GtJE>rw' qf $yeNt ~M ޸My+nJٵe˕t @ ʒzLzE1P>vAGo'7vz+Wza  HE|Q"p GzƣNs=wgv{ޱ~hϚxҗ~bcCTȗ\k^ b s8De~?|G~@ . "<U۔1m} 8"Gտ~{KW=W:{| qD1x RI|٦/F7p389iZD|TQPAGs=ɯͰ۸ͮ} NԅŽY[A[r.͋U[cKYŵܟb\M[,ܶ}80m;6ξu)]s<]uT]{5}m\ٝ>Խ:n(5] ]^udH^k]vmK-8͕Z-=_QߨH46-EMѕ5h`d8^nNघ_..r% .0NZdC10vxv`af >aMMW]eȓ 0^w#^//001&c2.h k^^bݭz:cv`5Gp=:zznAvP*VތUHxЂEEhTpOp_@a!rqc Gd'J&XTS*"~`d^U_qh>S˄a5b_tPajD4&}tlz-dܽ*g~YirUffgakw\)btNz:bL` Q+PgEe i~*Ye}<vGC'r&[ҔVgЂo[)*-d~Ym\>pcyjMߥۦg&h0 ^lj~[j[Y L k2kZ݆gn떸nk 06knڥ84pfN>sNe4 ǖ>>Fl=jzl'y>mi />hj2V6J^ |Y뉛ug9wF>"Ttbi(ykVoonaƗWZXaXvX.o^io{R`4@VpN{nXh4&Cj] ϔ3.i{:l `nxvaq&nUguXcPa97&kM긡Urv-(G)T[*W+'z4G0PP'c^o5sesa~1'_9:s<_>?7tCwtH ^BGwH_=g>7EKPLsM?֠u=M/t2ST_QoNuTsS8gJWu^uN `vvQpR dO\U/VhiuvlLm_zrǞowJ7iAt@DUv6v zwxKPfcwdR}bQuvM+@87[d~u閖%6wZx4.`'PlWtw1y{vo/dGP $ajF.L{f(L\ȅO lx~0s,y-|7Dz'>_POf%ɭ\5 wqG4/zKw4{P  /w/<{]zQh4abx cgWPÄ0Ђ2Pʟl"mЧNCpDeHv}I{هHwLRf0Z d ;ԲϷu/JoO(R[J⦘P.x~o{bkN(M~؟zY,, 5\SWSyglV~1W!j!F(J,2 2 ?< qM9#= -S3,#I܏QJ9%UZShD . Kdɽw%i&fe_dFA{'}u,5(hId`#dy#J:)&^*ʨ:*~bʥsg*ꦠv(r.JY땙' ;,źvjYqNJ;-p+آ/$)9l՚{.t*nz8.{/.^.v*|0¯m쯐&<1*> !_ N5P8(c8A x6iT? teGHR[ҋskZe5Z[M0`bCa-Þ +Tl aOwHEZ@I<~Z\t?oz_'c|G1xc|ys] IdP&X`* Mp@HChLȠV2h!+~Ȑ6Y>b1DG2%;Z`0la Vp-c [n{̅(Gbf2Ӭ5n~3,9<3,;}ß A Є>E+Zy~4#-ISҖ43M8O8]\81T`P4H>Y" <׾5-a>@"&!anp6k>7ӭu~7-yӻ7nB 7ME |?oB #pC|xqsC"79O._[˼&DL`B"b-{miiYR(sTkhm[V:ֳs^z<$ /"݂`kw@`N0̺x/?<3<#/S_3s qOD" FN 1B#"$I!,2.#3Z3>324N#5V5^#6f6n#7v7~#88#99#::#;c;hB!B0` |@%J+B+ HB+ \@*X+o4<䇪 ?%(+F#&J2J$KK$LΤL$MdL6 &PBOdOB!1BR%$RjX+>%T.M'tFtN'uVu^'vfvn'wvgq$&B+ $0B'@g7H $f' /d,'*FN*V^*fn*v~***"*&@4AD|93Hp7p)$ ,@, gWҵ)+f(T^+fn+v~+bd쥂1#z zSQ+*?ޫf˾+,,&.,6>,FN,V^,fn{>&O)a"9DB@.9A"& XA|AX:4(D2흢&2yUݩzR|¿&izf-4؎-ٖٞ-ڦڮ-۶۾-ƭ-֭--ߺ-R)$d3Ap09BAۘ4"@)N&A0 ED!v+-mn(+jm k + )?++}&/&./6>/FN/V^/fn/v~/./(CUxԂA(BD&,A Vm3:::3;;/Գ=B-" AAkp.. A/BVC74C DGDO4EWE_4FgFo4GwG4HH4II4JJ4KKt122 5,3,308C1Ms1h15_c6lhk -T&OP=/3?dpWA#@&_r1 8ZZ5[[5\ǵ\5]׵]5^^5__5``6aa6b550 5L5cRX584,624HsH4X0JFj200?. m-C#"H 7qq7r'r/7s7s?7tGtO7uWu_7vgvo7www7xx#76c2HhO5PrM'Nܻx˷LÈJU;NL˘6̹Ϡ#:@TC^ͺ5H԰aMmsN%SNq+_秚KN"SHB;vRoGE |}uk ~HG=(I]vG(DʀFyJa`~*&'(fV^y]-c08(q#)㏉g_8PvRXcyd'ʍr#*^]X#*RJ(]nU 4J(<"+@)ZRiX!eئybyJ(5覛,>$圐FZ(4B bU"WLqBxTP 0$"S)lD ’3 Nh²,8doZe #(4BB+M(&AL밓jq1Fd)X*l&[xE`vjrQd!F%gEƮOrإNE's |S( V 5C NՄyZj&~ZX9Wiv\l| q  :L5+nja 8f˲8n W-bx3a!9T18LepLTβre~D0NhDBְL:9#M\8^#|H|.;./j}F;YEDtAJK$EF, N{ӠHCMRԨNWVհgMZָεw^MbNf;ЎMj[ζn{MrNvMzη~NO;'N[ϸ7{ GN(OW0gN8Ϲw@ЇNHOҗ;PԧN[XϺַ{`NhOpNxϻOO;񐏼'O[ϼ7{GOқOWֻgOGS_%>}O|_O~P|;'[$@2{$PWd,׏,8!~+엓-2};G`GA(P( ]1 8b||P#0}_1rHO{ȁh"$|L%"ׂ1h}P!76x:Nу@( ' rFH(\(Q~%(|| s&'4`buh +ilHB8׈`yh鐂~ m8.hTd} 0 vA~c` x { 7bFb8ۦ{7)x^A0Or`` P8hnwnX׋"h8 Jqx}8 hGX ma h vPq 9׏xb/a֐Xm T  t PaC8LY( ( H"ɔm]0 0Ϡn  mHHw7i `Wv} 6 hd> 0ov)0 x~2ƈyHB~x t@ d`h ꠑ 0 ٰ)hpRP ؘו6)am_s d h`@d  ݩ丛雮8Ⱐ@~b\n7m8d`   i` @ᙎ Lo{0 x :%3ڛ|9Ș00  ` gi `xЧK"nЅ(?p0 PDŽ}Q)l:(z闅ʗzkJ|Ѕw `qy؀ !: xJq`@j  ?'g 薨ѨJQaКz֩H9kGP:7 `ʫ0 @ *znZ**dGX 詔kW3 #j vɳ@ ډdi ; Z~[걊:!K#˭%[**K,k.gۮIH=[pTK` h@cP# R V ѭP`Oh)ʚoX溡 r}m:}0_@[M{)X@qn뵎 $k0)h;ƗI煩 ː[ڼ0 w ~ ;I9h cplX۵+~f.֩2똢* َ4[{J^iVJ;rj  )yW<0@ j|*YNnj^\=ULN C؈w&Ǯ8Wπd>  ` >` ˰݂&Q>{9޻O5"agGn$ p!!`r@ f@ˏ|J`M˳=1n6~[Dz} 1q-^h8~cF%3iRJ-]scDgzAcdO:TRM>UTFjUڑ]~%/?j&Hɓ~($`Bӌ?.9XSbƍ? cȥsYsDumsg0d 8x\N ?0O6yLoޤ83ōWs6L;u{o.1]ݽ^* #3j&#0B 'l,l< M)k|hÉ/y 6`'I:~Ӊƚ4#nCq`X&̸ vdI'ܱ.aZXJvt'pF8dG&&Ma0fx'Ԗl8MҸA3?z3L&kgfP2'#Ѥ~gYtbR"ղ̺8vTÈՊRy D2rOG%X"%$ 'Ld$׈dlSG./irlA;z.|պ{_Iڻge~;qdL^q?,Njd~'*qDPby`+:fR`Wx.a}C8e8æ̟CC0d$ #3I"Ҡ_w(9, F9ΊEBDP%.E8(]EX1 Xa/qt l'9ђ1#5PF0(lÈBQuEQ \ bYC1 L]g&iΈ/VN 6yJ)b"ot9W]Bg.] g%K#R̭VԢ%y&ĢǯIGPc,&Nq󈿹hL}qsC;ȓL >c9y;'As)ӃjD:CmhHGA]2իh4Ѱ|4&8:Q `CF9*wS19x'_F<ie6u倶9ФV15/f$(p?ymxE-3jcy4KdI:!k\(C,JĮLmp7~tf򠗈aghC8,%QYv-ɾ$Vlf-]^UǟlWUA\0"yDlKR4}HB ``l#r/|^7`(<Jkclb/XFUY@Lލc9ή"Y T?@!4%TU,r#`˗-Vx#Y 0$Iʀd:ꅰ<6Fp>@i`íBt^FNŦ.Z~Wge\cX1}glȷj%N}Q4P(V<#HgfW#G<37ټ*RXGDE !mo4aUPM;lW2)YY2MszɷN-:Rϛ:V c@-XC֛Ѝ\"ܡȣ405HIqdhKIyHc 8B !\9ɶT&|B4 ()C 0(H pb@@P#< TlfD*g<7쌴116P3: , xxXɂF!D pk*Eى;sWD' cqJ03@QpL0/j 1|0xɐɑd0FylP蛍"Ï@IɑIIǪɟʠxxH"qघʦW4Hȋń)oȇUH@\8Ə(ʹsʆiTB J{}8ihuEA=`m?J` 1"dxy8\,*xO-c9N*u%ȱJB֙& 130eȇoX`Zr:܈diG@҂xx8heb+p8P̻نQGBޜ#Xt@saC䉈PE ͋Bc&z=H1(rΈɜ NPyh;c @)+gT  0xF5Lvyqlp0O$H<>P R}x:DeQk1xeHI8r 5 gCP-*!4 LTDQ"]*#( y4rk`⎽yS6'Y' 086}ط:c"bEݐ)ae(,a@Fs A37RU/TLeACN6pȮtV\5~:C q T– RFwt[WLSh(=J*lf^$<`(q`x@0+&X1x ~x+UxWi0Ԩ@c,!4qgx3Y[B0uՁ4;/_=X)w-|v(X@`(b@g;yyEÝ=}I%cg(YY L3zE'ڔ]e4ZYܩgX2HګĀ F&h/Q @W kX>9&(UȆEkXQ@Ur۽ܤ-yq9ypVe8e8s\ǜ䈶.ޥaa@זP@ Lׅؽ}2ӈ] k( kK7xؐyel ID: Ke凪Gm@&ZmύmHݦuh9?tHU; v`(ݍq(PSOUHkC0A.d'qĔ%*}Ez x}Hgt|c>;n]wX)5%VZث6AKfa4֟4-7Q?b c`eۭ vxنhiG@ L0ABdmL&d#J ~ \J/HdmdGA_%`8~<|e:(~b}T啀 ˍ}r BlS]%L^ՙ!c  `u0=baЏjqfn~FvRvz%1"۔A^^ULI q|% TFrڽ[qB6b~@jZo譵9v0APYZFY/\G 捈Ȇ}"U0䦢>jCa_Rh~SgnmkYWBqz Qx!` !HkPpHH<QbTXC7оR~ο 1V"ω!zu@8:&QKk&*dlT>6 u8X~bZm^ߕxhQ!Pɮ]!2e nU><@GbȍsqH.J&pqԜ򎑵A620vtTOh WS낈XwV A09x4zI-\J" 8J>p۞]"! nؖx:a@ 80I~T%tMޟJO,V3yAi4Xy*'_hLv[&?^?Ktm'rixT-阈,P^@:?_&=xz}tXNI6et]ob[,N8$QbX8u{KDeWؘu8ȌGpۅ(!v+oZJZ掇0vٵ!(+07yW9?pt(msug,yNi'A8 xRj(dNJ| l8 ~r/? PܘHyxϚ_!@RMH{qCYWxب[#PjwփQKr8*l}>z/LV†-ZoDzL$O\d_Ճ匆M@! LjvHX(GyȟhZYxp%y^H[Ktklk!۷]7!C  l2lPmQLOF"?"I7$ʔ*Wl%̘"ARqD vɃo_q锇M-ۖ^$V(.l0 . DXG opY`  ,xeIJgӖvJ[֎c ] p~Ln-t ki2雧O[~Kwn~ jjԆ:unϟqcA<fNKx3O>OxP#M6ӼCc]z%:e"BdKGR^GPA_$y)RU73L#osA(BUhcy)|3My합6ʐLMe~z+$&eBC gKrCghG1mr5Hn(4Ƅ: Tq?MɣVϜV Q><$(c?.9DE)P@g\ӌBKyא5iv[طnw R@^\ q:7M11 k TV!@`,sf>`jj$ C(Ff"3JFMrIȜO:5~ ^8,b{/}c(Y0!%3mL3*ڇ*+-Ģ;!K!XɈұѫ$fq] lH3tLRNP +]bs+-D@M!bX*e+Rqs D(qlЯN<`#`3n Ug7΂%BYZVR$f;qxfbv]=\g6JaMxrug)zd1XIF#2_ aPB xPF bYa aE*^49Ε@$"KLT_fJNԃq 2@6c`Gq3)|xCz+JʘƀJ| .EzނPwȠ<U ]B  XE/J83@F[3"lIAPOsVIgyXwϐ0 C>T] 6 ihjPGuJBikL(ld&yQ0>d C2~ctTOͪVt8 3  ĊDihpX?ߎ'xDn_!{Ә̒qa7؆Ic9J!**/z3&Δ)@j!4Ovb3kX@p/PAE0A8$N?Ds7uG.:$|~Q$W[?jy`Ec;*+~EЎ-?D|vh6,X$:p Mզ%S&u ~  $f@qD0ȉ%B3p+*,8L#42(݆K(a^0]\ԟmRD,YP<T TC? > VR?ȟY3Mm`ͅ:\RUBQ!U $T LH %Y $A Ѐ88&(BCԠ8 m*J]VIb M|ȈMd]5G8"JWN|rC[][!U˥!2ؔ XAqK%YRD 0$ ƠcBCٖcS56㋩pىC<5Ch%\u|>V| G)BWD8[@#N'|BKpdEԔ@XeT.D鈠c<'ă6 )"|[@ҽΙ@ə"m6RCI8 86xC'H&2<+C.5 Edq_|6@<\R],1؅xViRE:\xFn$5R[ F\ ѥ@&dN)XY%L%f 6l:DL?\ ˜) m56D]Dَw沝gfY%CMKHLjnG$Em BHeD\CCPEBD 88gJU'IgV@D=ȃ$'e hULAoTJ E"KmdQHcoDVXM(iv( `c fJcBC";h\_fķ!&j:(ƈ\V@Tq`?<1Uv4׍RN=,ǣҒ:iK8*H* 4ML8Q)|_:ătEjS<9]*\&:L;B],&nJ/?v(*z6׊Ȧl y.MpL(-bN-*n 1($J@ʃȤ |'<)ҺvNdM·8I;wTlY.Jn!vn.~0M Anl?Ȥ0 J .*/ 64,*Z/ܔ/ (|.o큾\)`HE*A%8o3z<>FuL/"CA;0Upڎ'h ~,p4 XӰ=p< êh"mJ03oX^;pWH5TTS 2"hfC\T@ U)Ƽ /1e1T8trE68<0DNMM䉭$2/g(7f,$UZ pt''"RE)'*/$M8CN2-CZYr/k0 *4 *dY SɑdH;+o|ԍT"1CŮ~(CH4Ә;~p1D&ň5D,/8T2?ueǶciY펕$T^SvT3j7R܈ E8Pn0lyHU Vk<$4&<RPY6z =51LTs&B* KٖuKUDmBn^gp[ 9sH̜w7GaG8A({%Bgq\βxiC5`S2?@ jqV W8o>DRU@~xL+N9Bx,xK9+v.yllꓬx"(C 4X*QwSt*C818,膒+W[iSyjWkr:zf7Ɇz-:a7UDpT<;- B1HyFdW":R8C5+QV8ތ  ]+Rw0($, 8>S;mxKT:rZ $-X@(IC8 q%XaCAr<\C8uǑT8 =6䑴5Zzs3Sk;D+Zy /Bx,@$/A,~B*$*,8R6(CH%5DQh^O|7yXȻڶCk͙|k|'3N\:d5\7B#B* BA-5=o PeA`TT5@z`A&TaC!F8bE1fԸE~%ǯ_?B>{/^;d` 6% ,N]quv:Ԣ']'/8Oj7TUfWQZ;UXgѦUZApHAuЈ] 7A Űl= wgŤ[;re˗1glQ>x!1lXӥKy: qm82ƖS7ζtB}:^<#YϡG68p.^^(-Zڒ=$NK׿ '1&2*H~immH?tmP7lŒʢrY:;B~AGoБy(!T츥LtqF^AkQ)mFy# 0pYABG|ʊ2䇾q3IK\HE,Є^N.nt!5xzǛɆ7EbH%30G,@UYi%HSgdT+6FG3q @4׬ZsΐgFD>g PzPfE1gG*h҃idt'[,`>,CEXe)q"{wNXn!X)1buu*,? ɟDcf}yj)i9mgx-\#Jt i]s1IٵJx` P DlfV`[d>fu҇iц';si|\P@\㥛~t騫.%tͺ]'^{T}᷻]/0'x*c| )i,*}{r \|A$&}!@OԻź4j;z ucꐆ&gdC{nXA n̘<}$ʔ`BV~O| Ηo}0߄qxbG{H$'JH';ZA0[C?r7> ^јF5x{T>ҽH8T6 ta .Y4d N$7T)32c=l$.:ֱ)Fi'㺪Uɢ |s4ְ3Z/%F/C@P4ءB0)}S!">Eq!!9ģɣ %0V?Z82Rγ"u2HY\5RTY yt΂DC!Q8tR>=옆1攽gGs#-A5 G;Pˉjtdiz#De>ORt(Xm#fLU)42: e^R5k(IxXq,v04Q5/ozOPꔧ}Oa$5tC (I/&,(&Y˧N[YhֲRC{WqՖ# O:y5s$*Yvrt+< O.!UF ះ}={T6kuE.;^nKRH2.cᤑ5M-J2[v&0;՜K(/I]O5uBK.JDE'ظp܄+#Xz;RO4)4\ЪT+6y!=f;6wteI>lt K] _p8a1Yb!;3&ۀWhQ@)vfF =hAa `hTK594& J)S2t[)]TR\v'Af2ԥF[VuP/i2!e2GR1%@r]0| _*4=6AihC4adC@h\Yxi+q_yzidFYeQQ+>q#98α#A f0Br#ɂ$9yIF#O.f[!n<Ǒ!t 厺VZa* U*E@!&"²,r,$,ȓ,و$3H+.'!82hq*^$y}҉2(f( !@a*=vf+1M1R$"r1+N,)ֲ56WR'738s83'-F,I.FDAF7b''1Mg#`gaJ!AC*U2 ==`>>=3>3?s???T>R @4AtA>A!4B%tB)B+4 B%TA9ATCA4DE4B4 PDEU4EYtE]Ea=E  *3GutGy>sD# l?{HHH3IwT *TD3UTE@TUˆ !:i.ou2&:d@1 /M+q6qa,a52P6Kӗ‘8QO b j'y}KxF̅Fd M:èB!DVo&6&fW&&F`a!Sw(TR5<>FH~|unjՃnusr5\ X5bXxg ]X;IU'bxU\'F_p\^ !b+  !"""!_&@u-Xu"Z4i_sVGWa/6e5cR5dFv"J.0)ШR|Jxk)ɞvxG|`a:$H6i:xE$@c}mjlb !@ @6VҡlTVx6a7c0>EFQtq̀n0+L=̀BWBlA#=A Bbmvh/h2!ԈJ!<zwn 1T.w4&Ws,j!>cKV$=h w!pŷNz!̃a@c&wu7dyW@!|cAyTN! ̵rv\zj'dࡁ`gd4gs7yH&7N7BkDa6n8!3WG`a!@sy'JbNA3%in`v 5aAz; ^A$VtndD!t38X-:z#@VӕGAh da Hz:T% #$NB!Ha3(a|!|AaczƈCA3'bAvn&5(,! a>€0MYQ|x*v!No7gYa!wYeaulӁc8f!ޱ"o3'!HRHAh!l ! FbP!1 ~ǘ鰙Ө`,!eg@! o8b!Df$n|6ę?&b|$1M |Y=#{^?f@hb)!aLs:FZrdH Y!b@FME ,P^2^>eޤ`AĀ!{dzK)L >э~A`Vaa"$d*lh@A,`@Ȃ>&ya35՞؞h^eL.`5x$>XGUx r?*?g&5ɽg+.=|aM l`"L`$`"`  ` "(@, V!e _{{:5L-ɔ )vPHHE0CB\G,L[@V$~QZiUNIeVmWE] fbIfZqO?A%,ŔQ;jh Hr N[Aj>fNJi^Nn)YWUuJjjf27k ;*6DC x`$Q5LD` $ǐҞ:Ij~?KnYUn렪Ms N<383M2DL r".##|M(7y.2όr3cU6Z3N3NM|#D/5֌6}ɳM2VDsZl^2p,f7G8V3U3mMCX1MRӭNU_چx4`O]x喫<X_3sk+O|!CN7cU?\N{&9N>{w7V.zS>N̫WY}ϕMVّt>䔃>LSvߏFqޓ,;o+vo-Ur /T\NBvp$,& P\FIpbze!aeꐂ(£0'lvDpІ"LK@`R+FqZ"O0SD h!cl>E07e^Hm[Zx2. 5,fl(Goduddxdc4#y xXKf4R3 pP Lu J͐3 `U e ! j1u YKY2$a k"0 S[`10ΐ40D70 n8 r=`,tȐ $*0pT 81vB LcLʗC7V,0k@e9){٘DhJ%9y}qp Zti J: ^ u371H )<i25(J5/2W rJ16;EsC7 bs.Nq< KJ`ck+ZS~@ I 鐼şX^U[ <C. @ | @n׎ٮ.Nn΀ .Nn/Oo_ Y |z 0 V1\.Ɗr#/&Kz.O9Q9;=\@Ͻ>OEoGIKMOQ/SOU`iNc>Y_Uٰ nHphgkgF`#[)sOuowy{}/Oo/O&u-/!І ]/Oo/O/m~0v = 5o7c*~= A .dC%NXE஁ 1\l%VҤe"m{dΤYM9uOAQI.I)PMJ-t4jDWaŎ%[Yiծe[qΥ+tY~ u`A&\[=jˆM2Yٖ%\4˞Q(SСE&]iԩI?*5gDEfi:gŐo'^qɕ/gsѥON]?{%wVٶln91BC}p@ 4@TpAtA#pB3ˏB;CCqDK&B)qKƓqFkpF~` b؁\.&ҮI(rJ*-i+qK0sL24,yC3-;qN:GmA # lHݦJklhCgP;alnC 6=$bxD$&QKdbD(6QqJ+y9% c$cxF4QkLKFҝP>{{^^RJ¸Q9  yHD&Rdov H\F,EN'=IP1GT $FѼ>=[@[ P=#Ha]."d&Sdf3IhAӤf5yMlf3f7YM9A$g9yNtSdg;u~Df %2M("0ςSvBMFThE-zQfT< R:[AZJ:rm yR_L$ᝩ&:E A uDCP YT8O\ig^I Q|t4() iĬak[VKHڱҕՏ ҃Isi6 q`#^5`dqD2(F#$JJ(u IRM{Z5"S5q0EH01V 6kYl0$Z4Yy`Ȇ:dVģVɻfZy=)_uqV0Xn. ^#umY7.y?xpq "ZFw&p;`4K< >V@m}G}qRʤ8>x5/$*6 8XSqIe2i$YnCWY'0oLG Y4,-q8EH*֤&^rOlxd%ԐwXu]c'{~v!,h_~ci2\}F8k()#4hx2ѡ i-X4exX#0*hi@87-bO(Wj6j;<+@6!:ÆFxiw[>4az1g 2Q 0:Vƀ\F_v Ă ih}¯d{tS epl<_ۺd`p +pCi(8?m Cfx)X>ě"rB;",B#10Sxt`%04t@0kh##@K3!:?Uz듆it(e۷8+gUHa( ƛ!dXd3 VKWEYEZE&-oX~snH ~g?6D< `$Ubb83?nl x(`*!deG(+`5ȁU7 k>kHi o+`+("ۆ<07@` E%Hۡ z:)J"!>jh',I[Z1Yww ((@ k ǐ 7l 8tO@& y ?ی=e bA\?DD=`XjiЊB{ g| o6W0؀9dATJ_YW!sWt{TAiG> 'XUK>L$"' jbH!EO!̡70IkpTSbiV`Q2X>,wP(@:0ho' s؄NSy 9h d [06aDp)X00HR@s`&Do P 8[h Ђ H'(0&[>py\sP_A,n(pp18'5S$H@opR= `@axE&(-LKTLTMTN}Ejd7;apEd7/Y.K'P``HeyC`|h"}W?PVPtX ɴ:؂U5S````Uh$Q&Z<:n`*( S:eS_sp*wU$c8S*3R(U,X%( pHPk(F_=KO$DL"TŤQUhʃnLgLZPli8X HUX|07N@f7ЃXxJ(Y0Y$xUH4QQiopJ6xTb@ `oX(NA]uX@nT81-A@OC'pkes\SД_h=T  0YXCH\$0?^^b;ôp Vl=Juʝ\&/h*Yh'wp%g]7MdOT`k HXx(NX8XJA3@MXOPGp=[X80sȂTe0ĥfHHt]~]$I0[L)8 p7 DKXQ-N ʬzEnlc7~c8c9c:cntL;e:SEUUZA8K> _UxHZG`o@(N20`8Nw@AF[x%H%fbXuLHe&XAX8?o<[@6bEUS5xS]Yjm I(ahpPNP0]5iq(I3~4h.h7x+Ւz$yi^KtP xR%-DeuPYH8C |EiZDcT8Hh`U8)xU@-dX5l\5pY>q6-k,fXnViWxJ7xox7psnx఍ڵ5YFn6?bV_ic~lȆȌlʮln<7߅>?aF3AmﰴhUG$H0|8S5fp2XcFMe2˃uXn< ȄJpCH&phjoMpsJ8ChEX@?m,AmܵJD  pXaxJY\%EpA(Qi„YM3X)p0p`90%H( H:(DJ)5-l0`l8p¦ q QS7[" Q$q!b\a,Y~]%ił4/†#Nx1ƎC,1`apWea,I'N"0`m[檂UY'%̲d:=+-LyP&S:ТfbX C6uC@8SR%Ѝ:ZW|u$ģ :M46TI>ԲTK" Lp C %N] L)J)D30"`?CYdU$u1٤ 2qeo[r٥_cYgkI5ds 8lJ" 6QL2ذ,#37TtQH49\$EL,&AK0, X'Y` 10-$UH9zXuA a/K(( &(ь+6D`TbNK{ bpbC&0 A%ܒE8`017:TLĢf# 3ܰCS\ 2p1DؐM1|R,٨M4X23 fX8x`'&p <;k`ȝN8qQRP*#Z"5-qD(ҁ!:!R+'ʨeb2Dt4ָ< QXJ% pCFj%Sj_jժZ "Ck/Ḡ5 ,a[Âu5b Vld)[Y>],`ҥ8ioJRlD0ņMMӓT:-DF7t/|ָbDE.r1֡"q. [,g ַAu0{zЏ*vZU53~̌fjQ񪕬ekBVS(_"ULULX/"8 ^1M~s1 c0! kL{ܣKlb !oE,rQ ZX}-`8Qʋ}c؃1*p'wm_**8Z2/9b3cKnmifVpv3199zγ3"D6xf4xȶ84ch+͋|hg‚D|1-)ZІt=i6rWʎ]oXh[:go_,386%@s07f3ƈA d,C6\bȱtms;^7w;7qԺxCnkw/@]| hF85C|8+nS|8;񇣛<5~Kn߷;p[K!<{~77ы.#=J_:ӛ#͸xgjy 8Ի=t*i+1Fa N!yɿB_@Zק*f/}w}{C?ҟ>7{px>m/Ѣ\cZ.APiT?` `)2`:B`J)!<-Cq`¼/<!M` ` :`E]Y` `='t_`BX(UZ@AɏA!Iqِ .Axva!aaz!~aa  a!! ""!2b"6":b$B$*b%>%BB(**m(BXBDA–hBh(jB^i (lj*|vzI6+X/l v.8<“&h(pfdgT8N$j*gB(hBhBxVBr&*~B(j'$ꯒdhI&*8A(krD#(lI$2Mj"l*2l:[#\*%&+T"$BB%t(h)p)죮vk()PZfk(鳂ꠎ+ -lljA˂|B&8M ee 3Il*R,rA@pAn_B(Ac+tBB8hb Ы'h!X'`pAF!hAB%$&-Ʋm+(*BmYL-L+mFiIBlrmŲ'*pX)rjn\"md'd 'A(k++%Ah%T2A$A)̭^n/I(- 麫hp5nTfIخ:5b:A+`B&DBA),n߾B2/2r*u,0Kg (TjryIav` `'ˮ{&xIcsc7fmD'$:A)B:X;"AiP%̭jBmEbgɴvItc3b#jetOI:ubJtS_gIuo vKwv[bVwt3&n7Wg&`*˖5!)hB(측BZJrA(h(L=7[w'vhBIk&ɦr8wkbj vw8u{wx_wwksf[fB& O/O%$8/4Cy$0[Bp'иx% 9U5kޘsbffbrs 8_w3&wS(yߝ&8où%LBd7&d&X2v8brB,L;;tgq҂{Zycy/旜wwwvwq:wI$hBzK& qɝ—j^[ƅs::Ol:/szf­:zyy{(sg bla0S9Sc{:g#H縯0Ӊ'Py't3}λ:x8;Ǘxz|nҁ@@&ë{\b\fxI($'PBV|]{o8ȗ93MA+;:d 1sB4C+\ lIj*Lsk ;G3}W,1s ڳ}r;h4NBݘ+;s;{}Wѣ=#~&0x'L%=gO#=$}{~雾4B H,%V>П~~}[wy@`0#;Zc=to>~cߝ4"LB,sc|>?;k\@˿D}D(,?8?ƍxp`~'aDMxc9vdH#I4yeJ+Yv-8G8iygN;yhPC5ziRx(ԨTh k ,xņŊi٦]n\(!M?p` 6|8 Ҩ)(Uh%,+8q*|Y^؈{FuNQ6϶='Ο6}it ظmhEqq7wN^?<~{v۹wxdʖ sԠEۘn۸ҭAcյek{Nx&8*9唋A$ - 5O@e.,J,G2Հ>g'civj0&6 Ƚ8,ܒ.P>|FtOT,f{fytoFؼ1!P4@P$DHc @6(9J-L5 2i4Kd6b2Ux)M#qvi6袍4(hi.E#lTd+E*Q6lݖn%O-<57*56SӈI3BI0՝ r1 nxqTeTS zҬ-$n%Tsד d.U 0ƚxG48 effUG@~Ywd\ʦꨥꪯE53gSϵP0Ce!^kvl2HHi+xG{]\ڧ>_,Ѩun%^,x&#mFhel`08'iF;ͣOHJߝ}=N} ] w֩՘Zy'k`j4&yhnLJ4@e'w!vp$h|eWyEgf&GࡌY* dcđ9x!Khb܀|D.gcp>(#mڰ6TfG1baXD#EZ`F^2[]qhX`LC@IZRAɡB1^0,%Q!)IZirDK[Q*^:=%HюR00bg0 ըiU+A?bMjpE&zTZW"F"(Bc_Ea7qkUIT ,uizW^p4nUJT"\. d,UbY[:}]SJ8јC`@) Қv`lr RC瑫mu[]^$1T 1Qe$3U@_ [.+v[_ $&ANcb0-6D-u{+8XbE-Q^dDV1FؗdYR? }S#bd@7 BA;<TJC .D;bHZK"C4c:pHM= L4MEt%JTOT 0%cNt3cQ'RS :<dI:(T eN{h%<JUVsV7=U> Sا$K/fY/Vj <آbL4R4HGpJIU\D|d*RT#pBQ-,4#]wZu\:L?oKu9"`UiD^U_58Ra_JZBo"JcL]J$i[OV$Xbccvd,ԴcKXw6:Vf1{ndqGg/Vig`VhL6\_V hiOX]VjVQ6Vv}X`AFlVHL68b6Lvp2f4[ bpn3B"^ooj Wr7p}ur3*]Ve5t/sw^qCujtSvq"u_B6,t voסdbum`H=q7j4WR)x7h-Z¡WycIW$xeHk4xIײ@8'uLHFK}[Xf_i [vs؇X؈X؉X؊X9hыhcI ׸0mX瘎؎X؏Y ِYّuK#b8X0C!?'f)pa5…@SYW[ٕ_cYgkٖosYw{ؚٗA&y39?<y9!Y9ǙYaϙyY9!y5E !y@,;jkE"}>"Zv/a*:;k`z$*Gb:BaAld!Xa V#~#R@#Z ZZ]#aJPm9~ *APL!z!AdAAnA!b^A!aNŅ!S#e AfUd޺",椓9] DbD4BC\)M-[@ Ha:` L    @!46>@ԥ$A @A`@` v!  L! *>A ߖ##ۥ!9ܻ&)@ (a " @T2>FL!!:  Z !@" * VV|@"z Ad!A@V! aNaVAjAlK(2 >$Z`(aك%`{(']A!R@ $# R(c |aA`` Z.!Xa ^b=&)NTRE (\Xс$@An}Օ <A^`¡! `2 ûCBW`#ݤBDGa> :4``Axa` ^a#! aaA .aСWa#A#bAP$$b   !"`$@R a!>` g!Z@ $@# nG96=\|>C" c`. RAnL  Va = a  ĵua!`AЁ ,@dP 0@)[WXXZ -ŋ3jȱǏ CIɓ(S^H /_ʛ8sɳϟ@ JѣHwZ4WN2#+ e`cV,_xF okebpӌ!:&7tj@zg #BӦ-. wfTwe&"9ΕRQXFYqIIX&T/FIs͛$)-dTȓ+_μ_I`+_x+b" 5b-)k>x&-KY{Ūx<3 ncA% ij6% UO?s'kEt $9jh:#t\Ku HfJ?6PF)T˕X+(Ӈhr-R$MӊJHH1tR@ P3M+2K&ҠG#D 28P *DcM)4JuxC BJ%(a)`F1D5L̤SĢ4$HFp$ &iђTW+HfvE+nԢ. J‹ 0)d)YT@b  (@bC`,4pO8͒+'$IFYdJz6pO%Wx?8Ï4،;t H0T .7G\0WO2 #L1Db- L1Ŝ5`#5i# 9>68)<@#А,tH<عFupCC@7L ,"5MMY3F.tÄ8̡wCd@}el{h,bH#4a 1x8xc02ƌ#R`2p@E01_h".<Bt *#y_0#B Ebx $'IJjt4, i@< `f<,daCC눑~Cꀝ-A"K2%/(1f--LСbGH 8RDh6nG8‘l15PJy2`e_\XΒ#ĥ.y_#fb?~D4q fᆂ d`BfIX{qbHN<_Aah8R2lMR>wb5*@?ă$ 4ӰbHA򨣎K-8:(Џx8# $m*8Z`#6^:<+q0˨ijWȥ~6kyƐ+d`ц9ӎ1^ͩ?nM6 8da;\JX,0xM2Ia4H@;d!81?`, |oijƍ,Zo4oL?+哏@X@3t/>.s4s:$ӥ+Gq1h3l5hԼ2C@<5vUnTO:nNL2@m@,# <=JȌ>PTψ@23<88o#9^Y?0C;?k3+H4?ã2 y^G#^ yXX8Zq1X T z"엌kErb!0^-v •@A | I` h!DV@xj<yP \Gюl i1ԞD@GpEl爐tS6*fSSZD~pG&F8hX> ,C x H@@I$Ei;pkrbYkb (gCΠȐ@ ~,D&}M+ASMX+I*{%=OZu\ 1d71J݌yG̀j>$d)Y֒ z%!4i*Am=!(6JdwlM=F=@ӟcQv` l`,?,HG)DBSBHIQf%38g$&Em@Wд+xd)I n iN82C+F*ikN3u0 !?x$DlzÛ ].,0$%RjyNXE^'ry. 4hF:&,'VG91dG% %K?PFin@ ۸S\D5/U3uw@:^dMuD:hHHQ4 H 䭩}EO\UJakb!0Tg%Gwc FcLJf =-&Z9Xv7|Ţ%}"n%GKd'Ia3!c:llcDCʙ6983Aa9wcֻde,iO3Uyc6<)/^t,qE=K/8a~x%GeM51PZ@` \XLCMG⪎h鱥Œv=hq<)a~Q\Mm8KAƊqU64~x$Vx ~?нQ"tE ?A@FÀ{V?Qsmo6xnC} t(/G.&G۞pEdYCH/P $ -yJLOY $>|ge^8 ]#ZJeؠ+Fx鸧dF$PG<1Rx|H2P  ~ Gb#{/a?¡wxֵoKӮ2m^Ř~Rto8Dw6eD|0b}kd?wmvj c[-͏|ESܩ&yE)Hq i9' }x`Xap &PP1# L}go~?n Ȁ%mֱ6Bkx'4s mܴsw~@/+p }0 xPy;fm@K 99[]K@@s0X~-- c`qi-F` A8Q  0% l#Sx#W AԷ)Yur:dw0f^8l}{hZS?K!(ȏyo)qc=h>6@{ !֡1f@{͗>P3  N4g$}q Ws<)YmaFgBq\#V @8 My;PG6d0 M3eI6j U0cGYe5 #V4da"wl$Ii ðd~r#9'u!A Nx q)$ CC` %4~ᄶd9 t)͗ %R;|sɩo(V9 4C2$4S}b,ՃF`28 0Ɂpn8#t*Ehd`NafYN@AP:jz bנ9h@C :j;r9k@,":vVyW&v{;-! 0t6.S;z11Iw)۰mנ0@% 9Vi .-& ( ː]q7 mV#u$F1i`0q"pY ~9d¦6 sJĀy Q}&eovB:!'&f$4 3v6݂9KD!!Cک9}i4DbD R3U#ÑgVV"@w;^/ 7UHڬ2gD:pLCb+}a%}#k( @` : N! ";PYc1(,%I7D[~#jLkm 'S UK  p' \.+)f,k уO194/~s9>p `9z0cUF r{']  k+Q#.BdF3KHV!9Od p}d 0uM%xh*- 5&f ̣˯xyQ4m>І}ぢIU*]`P70H>6rrB `k) Xй`gYbН4صGTdl$ < zKof%KAJDd¥4㺄f ii$#ñmxgnh&3 0FnrHHܱ @R` &p 0̲yZrj$S.` TimF4O3RBYulm%U2'amh$xͻ4 .dD1ANrjvnذ tܷ<246c7Uu<|xx ` +]ţȎ,A+#<ӹ+:?k 4p@Ґ\=ž$[:$^qfXB:ojiP#>)dF H'9*pa?Y֑F- [} P rJ2 } @`v2M`ӏS~4=Ua@3>D@ f␖t-ysn k!`  40 ˛3dZL񦚾2*'IL\%`Ұ Spvؔjk , ~ }0 p@RV3h!3I6i O-F, 4 " o x [byM8{wD5)`ˀwd]W ( K,n.p &?9.vL@@ PI؄0N~փO d= \I06Zz!Vl(hXMVFr +8ktա  A$l9 S~ޗd鉎Uؐԩm֤0M<B.?\qia᢮ Ӹ bd 0f >pb܍D0nf0-ּ)#FWoV,}STT > -tE#܉kT;󊢲5.N#vDOH k &0~r(tuלĒSdBdt $Ͷ8P~ 8@`= Ԡ| +]Eӓ6K vh ~`w2(_"O~SFk?0X֐/%jm._dP^ >QD-^߸q+_;2PQJ-]Sf2ܶkc̘ā{MM>UT gbfD1zVX[<`Bځ-Y?kf*\HV/QoN|Ėwbƍ&a!WmAH0l$-o(rq!|"iy̑7='x9q51ƗwƳLgPRG`EMOeHi8jʖ"JNi!IRN(Dy&?^e8F m8H2 T)Wo'y&z:>Mi[}mکHꆪjΆhk #N `Ý졓g\71i{p Jom'~"m\%>zq]G##ƚA |;>|qǭwIy2F@ɟx?q|8ASV 5́j >e@q W ?d($N0#!6WBk(0B~VBD BHJ21P[ϣaCX{)9ԸeAІW0Ӏ7ԙ 3 \B@@P0, eI4|&cBo$\QF;|#"M#ؗ8ƑLpd*p@O2BI<$#*VQGN gxB3hC>CI,әT4%X^NɬqL865yLV܈( 81 } D" i NpǐRE< LvDQXgPJe= yP!ˢ,kQp d%L`Bݵ QFb wԦ5Muh ]boOpd6)o4'n (%l;aO+| v{ 356M / [Y!&9 xIjtG q8.0[^0@ A\rUbckt&~Nuc"?DԠb7l9ۗV+ bT8t@I qkA]xZK`(aQXPKҌn_ѓ7{#\t>p,",!i@" XuE09pBx R@+*$"(brnj'A[C%9DL M NTXl17ꘗb6CyH 0 ke<S('hxx_v,bÄP:e6fHv@؁5Gw)([2$Ȇ<&"&Æ[ѱ Ǎ҆}D+UHI4!THLJ4@Ć͋.]9xwsٖT(J|BˢdGd@ԍ9rjM{͠}nHED8ڻ D>~xqؐݱ>~ Jadc69'dHH\^dHDˌ>@eO(x 4P+5J(g{ln 4íU6hu LBQM Qi!X4r5.xi7aS$ݔY#$C$S< lH}S6]7:Sp)R^4Q3S\5m]sL'7QhA~ippU@/ ԔT"rEOC]8GҠ?U%I*%W/-U9FUEV;ՁPOxgpU'r]+[=iXPJɮg@I}h%p R}MvC00'`iL jGA8WPXX=`c8ס4gX#L!&zXmRM1!XH@Y& ]$נg:x؇pJV k8@ XWL0Wk뻆Ky?J5Ku[X+UuW8+ wPB-\ Q.ՠA8h(`@\HUYx3ѽ9\Qixk!@kDYmihmч?^6x%^ q2@lCqXorPvHqJZ&.p4aO1ar0 aPƜԽ2ڐO;M`h7G?1x#vMȐ%Sc`)qJLMQ7hMLWipH ؏DʦG5e{(..hi !'kÒ9F;,̨k7S6g1sp,%~_&(̆ Ng˖Ӽ#~b~ "'Я54)hT20R_2Ȇr;;9mɌ ]5ϮUqPc !OIP׾ I~Gr$Lxݎ`.KR5o\CxUy]zA1eİ ܸ yUFj>Z^oCR/?͡-xPiX0v Kt ~P>pv"o(u> Nq A^q肬d*q=>¡,pC(LcDIX q 0)eV_r/Xͳj ڡXђr":#(s3w1iBG&VC|%Mwi 䆜*yINObVFtC?']DqtYn *C\9 OD.`&l,q^&K2_<Ok,y8\"rk7; r@O&v whux(oX2_~*ovUwD i_U>Gљp2uyȋx6)?`1zgvTG˚PLAډvphC/ eHzӟx8[L!oP vpx-~/?~xrmro\$uicOߛ'iɞ CA Ǎgq?~7rLo6 ;,i$ʔ*KU˕2gҬi&Μ:w0C1i(ң6M)ԨR(?*ŋ5TRdCj>Jum-ܸrҥix*YHBV u3nx?lg~Z#fMl=oaiGmvZKhY,99VAyQ7s#zZnfS@a&Oֹzw6o>jV2R 05_BeuD^iP:Gԃ>a逳k !~K#?|SYՇe"9ڵ_?(0! v`a180>']I7$]XuiWaxcK"4:LC؞Jau;&ٓ8+R&lN;nǷ_QJ2 <iaFF<qqadĵ%|)-AA1a7sG;'^;'A M>>D#c]7<#=KC4ei Me'OFuFN}SM$JNq|cݰ':?~3ؓMoٙPs|h(ۛGlC3])Oo6x$#qqFc"Y+_:V7o1z` R=9*Q ^ ?ha< f5!l.DFE7ATa]qp<0a0С E !Ddypγ@ ;`8sd / qPp1\\k< B 5pA `|#0`yP7;hC-FY@dH4ҥ9E3]C~C# oDPRf:ae5wU!ز,QɸF ,;!F btcZ"pHOx^P22C87et"2*;j`hUHcqig~TcpFFJV*1X6 < WB!Ax"`,}Ă;A+ m6 (而TbPsH@\w̉BGxy|eV zJZkm@pF@i5 ( xx$Xd(Ցi`}tp Ee}.y ie'yyHهJJU5v]P;5gX |C,1EBC8, Q6C%P5B^M>0));#`cClcI̓7jCTdHe 5C<B$,@|C<0DB$B>xPF4l%%^^~3C$<@)xLA2C+$A0;,8(C0x@#@*8A F&8!C<j&kNtF,x @  8i \ e@fn&'0`C2CD'& DAkJ#\v~_v7;@ TxC\';Dp@2:TB:L Tmou.oG6|gTFC@$ԧȂ t*t@)p(fg"D'C'T&B4hY2(p)hETH5X6H<I<a~;D6H}64>FOC86AH 6XdUZxFY8~ME**D1><q&*'V+zAgx"x"EI8PDfVeiku+^Ȳ_B@BHkg`0\*D~kα+ήjeURDy}qk,˾ jl lϽN@Ī^,T,~,dCl,bǖ,:ɦl,B ެήlf, -ѢIl&-6-0^>8-VC]Z-v-1׆^!0u *tضī 坼ޭ*eu$8D)l h )>ADX@Q~f~.膮.C(/mtY C,.҅...//&./6>/FN/V^/fn/v~////քNlί///00'/07?0GO0W_0go0D!u00 0 0 0 ǰ 0 װ 00011'/17?1GO1W_1go1w11111DZe@qB @*()@({((2B"\&2Bp(p'Do(%{MAABم~rr)K"*-ojfATr- &3.˯B.0E*Y8A.;D0!'B2o (dIC:;ԐB(3Bꧾ>뷾>Ǿ>׾>>>>?? ?7??GO?W_?go?w[5Eb=MA UQ{;$> TWdI$* ̰Zf JI-ؑ8 SmgE5 U5S#Gg]HuUPֹKn y :-ZL-h-6Y=/XG<-ZRRЇ[pܵұf]dA֭йЈ_mbBNYYne8 V5!?O7 `̯-1_NZ饙ni4Z1X ,?9z0|udYf]֖$n{?-/!O\oPɟTQ5`k "i9 zK[Yz;;i"iO<[lEځTa\~sϙ_(Cgs yVoX>Lo!% ^|8ѳ÷Gq%_yinux+8E k\&-&AAlhCeu[W/,w%d i:vԓl-eK.[-_ 4/vѻÈq<ӢۜE- b&F^؁I| j`Cula:miҐ6 gh&Emg ;͵p21 k6ѝnuvng䡘.A_7AM`$6%y+r2Q҅ܿ%&?9e;{Ϣ6挍iԹ%7Qr4 C7!U@x%-Yx{-)TO/mzsd~ eD}E4d ߢ} SCl5,zX:<2iy'6j)3˱}o{vO"x҅_8s G?>_E1n Ђ/zhaf!^T*k1ְaaxN:`ADpIpma¡!>6DPH, .ތ0 p mӮn6⡀"!BE}xJp -MJLPD)!-o2aMpo M.̀Aݺ-a-11'wbH2aOhOd pFWh'ԂJA ^n!pva 'baTAzl tpaxP=6aͱ1a@d QN&0aa휍{pNtL!"12#5r#9#=#A2$Er$Mp"ph jXwTx!PAdnd$^`T!t!p٦С$MKaF0 VA! J4p1n ֠ 2G/30s0 s$~S!U+RFkNAbOj\wBGT" |B araXOB7-O` LP (Q,yPTa Il! L8]ܒ-  `An!IN@<)?4@t@ @ @4A"KM#!Jd@><{|AjnȰ(= P +AHp+r+4,+R"A`-Վ"֒.0tMٴMt-S1S`A *3AN2/!"!43[`d !A:$` T!L4b ."T! P`&!bm"|ٞ|,a >:j:  lV ,A,N X  LA1RQ ^` Z*.  " @Pd!@@ Ll $*A<?TAA6dEvdIdA@ T!#`b ؁ F`XfL :$t` 8N:JN_ # L*DzM,Fa !<` L "Rh \@H!,@.n. *  "@hI P8Q-A @`tU l ,> 4l@<`H-A!\ Lvq7wuwwK0X6e(R za@ a"OKbP 5ܯ4mQ9/W nsv hLDoL*f@D١ .Tbf@RV#"Wt` V!Ad*`8@bZ+6.!fi#`LA! qU-A_ahR`P ! hY`^@b JAWs6Rey8X!`@4B/j:@` jJAL@hai J bdj@kAk@D\`abPC%n:!n"SApLaJÓЁPB;a)9a,@mD!h`A,R̀s;لCKa8yMf 881Gxsg%77!ȀOz7wz{QhQEWW4WZS&r E4'\!h9, 8aB`# hz{h{qX A 8@ $--Vat/ ڨ` La7T͡c9 u<_+!ؠB7A`xT^9!J=?p9 yYbv#daqT=` X !Q8 LdfDZjA @ b*Nn S*N ` z}!8q >ښ7Z՚W@j"lA >s)g & A v%KYMV(:j|vPzb:S$|#չ? faaB`*`8@\`aᮜ-"e6;>A СdYR@ aU[џU}!e@<9a| AAg=B!`qf} ;二RɿUZ1~#z<\$BJBV6,Pj XyPʗ[}2dH;Ȋ#vhlbbv&Ur`1&NX#ؐ1@̃_R LX>(sB sj@BNJu8ycS [$ň" lLdMY4_6%KV4b˖} -aZ)[9͜;{ :ѤK5S_Z9CV`p}k*(Y %TR <̛;=ԫ p*(䓐4(̏!?ʏ2"CaTdR" zL3z`)ts@t M2ИI2 /!GR1ÌWp4LR@!Q$܄`'P'ZXPI-IDJ'\Ta\'O7L` :PAf 1NTJ%Ҍ+e|#a%T KpL-D7eq"0#h.hba8f"GP,zJ2tJ`E DT!4x8 Gfʫ.!-ȡJx" `DOjHa@8B%7s ecW (qF3 M1$6\0J,I"||J(W1Kb#"nhoqǡKmVP6[m`2&۽J}s:se]5r"~0y?G W})lB /(0ܒ68a ,LMa8qK LbKB]/vv7:l/,`X!D#'HA@Q!`Lt,ʘz4&a 1xH L ;,J4ь/ \XPb (P")"X3:e~~OKV8K^/ ;ئWhF+T,j v '(*eAX( `^W$ȄqX.:\k̊%rń(m6 rD\"Ŝ3qAw؅} Cɤ=od. _`'=[B.0bq^-tT_/#BBz i5ȅ/xbjxD.$+yLn (뢧6r0P¿Gً" s/1e%q}!Ϣ/| #-a~ŵA"[$¸0.~a #E-2fd^ OOTzլn_ Xzִ){J\ʽd#&弢-]U;yʃGSEL6S6r{_⬿$r-adS,0LB;U$2IZoa/np̿羪ĩll3t4=fA}ӭ/bW -~| U{W{Gh Ȁ Q|B7uPu  Ч_wuEvKCJRC^צmǂ7~7]p$Vb5h79;ȃ=?ȃ@ ŤPBIKȄMOQ(SHUhW@XbI 7sxg4ikȆmoq(s$vi! C\V ā|KKKZmvp@]7q(Ha8yV芯(Hw@2` z8d-AuH4 ]$x&8^},XL.70y٨ȍ(v}@騎Ȏ񘎃BG @v@)Ii ɐ  )v` T֋~huG3԰`llg(T(pH]c*8J{X^^? A)yGeBr$cKɔMO ' A SuƑ( B u]җ]ɁV1ֈj+(mٕ]_m]0d> (X[l͜ P b]sڶ= q-s= `X ؁-؁=m=؋؍dd0~  m@d0S=ЈJˌfa* T ۡ`w ĽtdlH٭݋-ԃ-؆5h]= M 0p`  =kSȫk̜ ;]gpж=OKN ͬ;!.d8l')+f k+2Lװ= A.CND>`pI`m0,N Ϡ > e>| xHЋdБ U`º pnKp O \*^#n^U\ό  n꧎n Nn뵎뷮 X<]N$= ۬{| Z> Md|- evJ~h ouU}ا0\ɗ Ūp m^.0 { wM`iMk wz?xO  ( (135/6 ,O.5_:KEoGIKG 0 S=CY[]Bۀ @goikm{ sOuouoڬɐ/Ho%l[@A {<\ wILlppP L *go%鰻pd`v*P]~߰_ݏ(BOo?A~$6w>Y /`$NXb.^mG!Y7NݿTdK)aΤedN9 -Hhџ<%I(ip1ҶE{_pZYhm/\ ]y_&7VSDѝwC"BąRj:ԩdkgsGl:p|L'%tQ.y=/Ao=ggyAI%l:CCCTG9lRŨZl Fwagq#qQquq"'..J0/(!FdQyHd 3d'5d*4uFq''=36?tOF~iƙG~g*q~4ҩN=早M@tHyT !pRQpG]T܆mEbKV%r3qbRaM$Vq٧Q~чH2xICȚά鲛9ۢZ˭RdI4Y0 6`;, A .2"$㬅)eLSM5XG3J)Fd5)߳ĠfیhsN<#pf⠣ϷÃ:t@.N/NB;@+VksYG Wu&[bS0%ESrqbJ0I/̨J+12ͫ#vlȍn8Bvfɉ597pB36≧KxiAOmxgMu*VnU-Tu}:g:e_iTGpwKDՂ֢q0&}B<}c!Y1`c6׉?Lh´Mgja t,a3a mؗ)1h!Yc `ф4# @S0hH+Ov1ig'"X46{+x!c i-YlƤMg~̣8Ȱ2- 8:ERHFD:0.KC2IdJG/!xTqL@+])NjTřNdg#OU-^5 Gqf>=no+ڵkֹ r;_NѵkC1ә^NJ&p |/D h> |l+M8 p12Odb*12! P"an݊x$2> cE(F*B,l"ŢP \ qYɉ,b6ovlw+ BR :#+# g8#] U5"rA g:a4ai4C1,ȐtP9ˡ(s32ଖURe^CёEc1 k^ +95.lR"s~mA }qel1dP;-?d?Q1\࿿3`p"PZcӄi"Z؅PxJˆPPh"2MȆmJMDax-2=d ;"L>1[*bн+ R;dҲ3aa(Q`K`C9MO >X8>^ ly2Oh[:JxPaX!ݲq,t/@,v H7\Ū9{ӡZ!#c*c\08@8Q8~`8ep0,z#A Аm@l@< aAphPWXi2n"RX 0[ca)aHh1qQ| Bɓq8|> <'& |ډ|Z4t$n yxJ"k$=k+uKZ ~uD(PǨ`}~ЇiXIʭt#̚}qwyE|]4^F*~#Fጀ +&j҇pmFpUmh|ѢУk,1a(K Ȇ8IxW'PkHiцYX')Yׁ1Q݈`r=+I˒I4;A\q 9~a!lɓF+e Q*3 M1(1|aSpӔpG -e>'`&lh; )Lݐ3Uq('Gt%ZLęԞ gSh+qd@g>=:ezPL0uiNy?"MKl!~ x\:΂I ErN8{ 셼pNx`G8 OېqqOrLy@Vds DWmi`Їp@نbةbYX`r^c-exSe&VVȷimNb Ɍ#ڄ\S WDӄJi0WNT $cA}|)}pvf6`$D`HkHb y>)&;Um>s)ZmF[PnqNn^nq(~W26ɠ *樘%GIJ2X6+.;JlbMh0k$kȖ*̈́L`a~O- .pY0k,dZe q^,lP;Rl6 Rn ^k Vnz^a7 !?FV D<88x9v+pkiKKhuXv(JIJb&b̈́_\muitA@B/tCpmntGw H>nJtKgn' /hSۀ&ZnOuӰT-FcPJ:y Ɲ v`Y46Xge_uљjCxrRp_N_ɨpi=8 MIq> Vu2^Bwpe^B(>@YXY$0"(d4n PU=0F ˌ=y`׆}1pYcѦFIMx&XXn6[Xgw+w7(0Hp#pM?{tqXpzc^b%y*iX=lxypp[1 .zsUGuۧz'p A"L_M?yGزe`?~r%˖._۶-ŚeSs%KKO1dni;cۧ2*̪%ḫ^ U`~?ŋl1K+7n;v̹v }tI 1&Xqye?v8n+Rokq\F*Ҧ2¥k5^0 0Sڶoέ{7޾.XE՞ѡA~ !"PJA1Ę!-Z2VjnFxM[Y@Qi0m.6k2 E5]8f<%c>2f6lsc|W'VQ$MYt<4#P2cU 8$hESd|` C6QsIXA 4<fYhL`s<[ʴe;mMZh^ >C阌@Qyi4,&DHs PY Sj#}q7q\# 2H?D$ Iu@ [C 4bL-ry6`K!KS)#a$qoL@ZFmh!#\c" 30.ִQ# 8Ύs E :CiYnh&T]LMLn8<#m]~)g3f:LWV<(Wcad8F_];u4Z@i O3>4nZcQY4 멨Z*jn[@-sp@C@D0x"y;߈a $3onDC]c4 "E]B+T`*0*R6CS?ː͂#HIN@X GsJedBGxN`6 T@Ga 8ȐEM'Q "I:Ad$}BK?GT>G76m6q mSnyL<@.Ӥ ;`~aMLr~P&o) u$ NIi S:x"b@%j̃>X'מ%-mk[Wu?\k`CDꓟ'@+'Jgr0hEx4rG#Bq&$Lyةl?я` }pS'OT7 Rc(>5D!8WR2VSa q C"rlZۼu0nFbត/8:+x)@r;t%aFve?& ʲG{8/70J& mYh-69r3[6o QqNZ@BBd1ns®^I1x 60gJ+'RѐJbYi7ֈ5b(NmQbڰL{v {S2jmCJR;Vk&7 mXQ%p^ {S"5$C,a.5[oW՛b8uc-h^vKG7YNtL{2'>N PG¥0!}I0>dvKKw=O`GR%*;Jb ~c(c&2gUҶ ey2&-&T eQXK^83s&ͻ㸓4}kUj7 p>cx5hA'n*PgGz{>yo0'%4#4 Z(xQzK6J2J*r25dH0cuϓ~f?oI(6@TՄo8:,EH ǵCHMLZSmYLp[\E ` tC86| ` .ZщџXXd-^J a( m4`@T 0/نDyaJMTi5 éu0[`tEH_mn_ @d3(Pu }@M$CN 4 Y;xD꤃6gg ƈՆE$v _S \+]7t v2VHdO/!.\--Tt\& B8.TaPLtLUZ@T$)%>D_SF- 'W$oDʇ ͌D%i͈=6 7Yb`RDMfgkII.4Y߽OӰ7pAӤA(] YvaĨO =0)ғZ0ŠfVUZE} 8 cDY*mZOF(71D 2ŴEeTO[E1Q5J;p%8}A2M*źuăR;(@66Lܦ،L,XDh12,J`v\Oά7ōmEܡRm+vPyp83a41ߴ(ȫmkStXAAgx\s\Tvn1-]THnBB8X5C[45\ iNN ۖֆ;v&QJAب\T 7:C3tC@CguicaHډ.\2RDZΒ.#uioM9NOᶊnd5pF9/͕.hamp!U2+B-A][]DEdlJŢA)E1XJxxLCaWO+8?|ٗ1`A>C}SZgI4t{ gi>LقSKC((WawY,u.*ߜW'l(Frnpt0U:gx<7H U}o?V3@,yw hNNTTXD4@)2x,M%8lUB\z.aol"JBſXce,6dCl7n;D? waB=/7rܹc /`ϟa\ 2k9®#qE⒋D*,:,#x1(̄"pacjمL;m(}Ă<`2Q'`Q'k9DW%8pukdrL5ݔN9+ILU$[U g™VW_ux':>4Gvj"v8 fylfҢѤG<ꙞJ\Q]]Jze{5|R/<R1,!,2"hS+9TG(yxjyC7*YEy+P8j&@DT(IR}蠅޴/pTO-5ŦRըg[_'W^1L Ula&XGkQƚxj69e5U~qs:<(|^\*H߷.cK0! HFH|M7Eʗ> 3`@^P6ц#lqvf硥Sǒi):l,ƥpJ]|~[JBg֦dG5iIfĀG%PZC,'I@*jʻT%i0}T4 (8E@\ %(cҎx(=i.5XDёn1(Ç) a u0֦W̮vPa< X<0*ˏ`)7 )ͨ&b_H"/@#1gPHֲV3 p<,2P\8^1 VPl ciI!ýPI雄H#BP(Ċ6aXd]g&7ck_7\ kC( lFB-98C %5+ AXuGtJ[Ma=;D兞U٥$>@p]4v;f;-c `jLJ*9)s)3any[ bo[\Wr[18ts]^׺E0\9xw^Wo| _7fPoyܦw0u\` F\ p)< Wְ7LavaE\b)FU~#q,JS2by, A00f`@˼)Pt:l6,jCF,;(eXe2NR>^)!B0FSl@;Ҟ:IMȴzc#?HSpl7XֵԸ|76}"a+t%#. Nix XNXE22C(l96y5$ud$Qs4VMRr:-{ۥ1AoMq%ӂ񷧮Q].59 `Ž'q0b!N!jOL $a v:$( [ e"avg؇'#0 _0"Z4aw\ Am%F^|AAZFw~ќ .QPwZXP h!>jB |l8"wHh J,Ԑ" 4 Hz=aankQY! JNXo܈d eb ߠKC ϐ! !6z5/ 9 iQܢ6sd/(-m1 f.@Mh`k f!A6`1 aV A0r5LD!a %%!,>aA`0A-5!䑶4S-^2inN QD1P!Ӡ>A  'BAa=`~!Ha;  -¢&"aADsa ^ n`* @&/Ē,2B-H2M,.dL2MZ@鮳>K(""JR&nA?1s-|3*p  r!6!?e@%AD3RQaā̆"T7O/p+C|AA:qhA(;I$%I$Oa4a !A@n d CG#l`aP$^A4y.Īj\@Qqt/txsr-4.!+I.׌`/qI?f(bhb![д H&We"VgT)e:6u8d*ҁ%TaN. VQ_=&uh6jb05sPHNJ*A?VuvgYnNBaSysz C&T#dgp(ae)#>q?h_!N!PA! qv(^% ڇa,G%vb/qH&1ICcc?vdx!d*e:! dRaY nVP`Og!D3e?j"p'AnueZ&n h!^܎cu6R3/`& f]asԨ?sܱbLCޡKca Du@ iOXgg r>fPO_#~a)|ZTB8Fj#"d!baD ^AK;%7`%sƲabzQ{c4|[JAH3(,a.)!hyW7g) H7:fZԈgY%w%xH@*1[kKs0q sxjVZi7BX6t ^YKeAX-Hw!"3N*TAP!k,$ ʙ)#Xw!\TkJ>`ڣG Lׄ#z ,9G#֓gb{LyI|?fJ4 `/BWAdx>B4^Z hX5B@A !T%ǓQGF/Ad >zGw|'aڃ hBa5-N,P(ԡ!! j 2dBf)A*Zbws"x>@k|ۜ([jkh!,29-䇩xeB!"kJA e` /,VTpa3yGz+7{+v$c$GYV!lᶸ!@!RA^%¡?73IHijBvjAMHW``!A 2И-[Ba4!AUf'.~88*!@aAR 8<'US?s)񨐛 rD+aTL0tuA‹QhkϯOk& fC, ;f|H j-Mbv#j3,y'eB+#xva[l7묿M^Ӟ즇D󡫯 Ze BէjG P0XAr˭qLb)e[Rzaz"iemwxN%Wh}"~ ٮ +ωgeRk<ǧ7>RԆ?( P)V؟2;'I3lW83k 2qCWwCᬙ[︋cyA>xg.G/=˟P*矓YOuCScq 6 et!J01NWDl.z#LNJ(#1`F:R6 X8:ZI\"DLZEBA( AEu(3?J(˟qor'DPzˋ¬4+$c8яpִaRPÅ!~.iG"N}"0ϛi~NW?Jm-^3ez/HX@`0#]zY!dZZoOD'0ARg/\i0"#K8us\H"&IJժ韣@:P@R[#eBrJ6a <᪌$eGz+'q* OT9}ˣ of1 $_2i4Aٰ j4+ _p5 iZ  P f` av  @!0p K XF @Mg k CA\ڪldj `ljcPk$Sz|j+WڌWh^cDx#?#` `E]y 4`!cKPgq aou'@ ˰ ` !q P57hҀ 0 &-`Kc175]Yj>ZLK   @E 104cFYHXL B0PYQH#I1&!']I5't931x:KGI>9 Pq^,K @.+@07g_Dt7O<˵GRR2BKz1GH.L l(O; 'S[r:Wۓ1^S)L1.W =ƶԩ|PWJ%73SҝIDY븧:ja{dk-@ Z *I;j+959Aǽ!~; 9۝H'G5W;12+5?D4ѕCWjd &SxD#L?l-X߻:) k(kf 6+|AlR xz݃w/oRrd|9iFlq<| =Tiͮ!q aѴ"*% =US`#1-W,Z;+\Τ|jK;]B;JvLAoöGMu˝(Ԗ1Rzy,ˊ |ܒ=%:7A1,,27rnj`)hz ۄr @ +-Ҝ1ӡ 6l؇G]ϴlEƐ]9Il : MNsۑG`̪nvk5eܥ!q%cE3]  1/]7A-h,(Wߛl>nb 2($ !Z* g4 0ApgdFpf Lߐ46Yig^gd Y0`0a0ӭ M'}E50`gk 1.3nFSDF7S?ZϱN{mB$@ ( 3 WQI` I0us1 N  {0`}p@ւp ƃ '`gXf @V{P L۰! &@ I-DӝN)>+.^ :<4[zs@P\, |âMMMN8}#` 00Nã @ A` (&P ~ 6 ,P Pl@  nYpG 'P6 ,i (pl pj`` ` QݘN.'-Lޡ2=B?S>(vdZu 8{PxsJ!RW f0  k1`ր iy$I`sQp R`aB(xR,c0I!+: oVdkЪ+Bm\c-䩌Ƀ,}=g *caֶP`m+5*#\^% I@IXe͞EVZmъ iRE~xma䕱ZrIeObƋ=Ydʕ-_ƜYf%VhҥM~|Z겟Ytꨴ'rmdi&-D%pe8ᛀAM-[Rޱ`J5#'`ޤ8t7Vycՠ!GjAmIni|*^sD&x\ fcy%1'ŷ*}_at J+fa[.3co=@se>xM}_`qn͠al(頺ǚg0fx9aX$qb0CiLgDYUֆdIOFpTjmb?C H\7Pk|C X,@ 7EyGd, Rb`…2ш͚fD&6щm)$Bb@6\U߈V!NFF24%Y}0+^!2ڸR` Xd! H wB>R 7zɕ!U@>J#Z@A1Zic8!d%H7S, Z0*ჹ,zb(.SRvi0؅ŦR;2ћ MLrӜ9la: >T8ъi `)1u$!`08 *-|fp+;:qH4 a, ~䃞  DHBb1VyuN_Rf pn56Dti<7,Jqin{q#Fp$c>`F2pDePG81gCXEr㱏yX~E4`m$ê˪z2gBsuk]5#&eSC\k;ffFV W&%laC׺Vq uoi#Y\aJ~?$Vmkm2yCö?q,F'%̣ 2Z͕t4Oak*NۦK3 l/ wX֥"<~7zܩvK䇕:n`]59o=dW%Xx g;n{ٌ3Җ9̯ Jg76zη=]DB+XGܧnb06 c\y'gFi(B{@R~{׵ӿ?0xZDžkP;ËX!x0A;ӿų@s@1@X0?"! D@ &^,IP8ATx{A9 ^A ¡!Y>30=_#=K&AU8KH )B|IIhG8DTDmKAdxB1QL(D)+R0Rx]F1ɒ,I\PQ%R5SETUUeVu՞4m ZAUJ(FM"@aDc.$ OZWjklmnm^`FH[5N;^}-p"ciRp+Z؅`~؀؁%؂5؃ bK]d`ItD"،؍؎؏ِّHc$MA0pZg44JMO*(7@{z5ڢHڥ=ڦuڧڨکZګ=ڤmګZگ۰۱%۲5۳E۴U۵e۶u۷۸۹ۺۯ&xZ LÒUE- Q-1.H*Eܒ`\Ղ06}Y.51HF1))2)ҝ20h 0\׭%5EUeuݍ}]}]%5EUeu__ޗ}-HF =UxX[؅aP5@%5%24\cv7uS9V7r`x ~;,9Ca?8?@AEAᒰ:@ 8( 8"+BBA0*(#(A@0E0'1&5f6v789:;<=>?@A&B6CFD@pbBHFhCZRx :6a7T+"a$qet J( E( Bph'a4vhPfhAh DjN0jlfpaȨ|bBxFgNe]ubemh(Em}grdJ~ MCeq~drv膆h臞舦苶茮hr&(hJ&Bv> xifvi~ EJÞ Tp빦v `뮓JR⨀6 `R98lsҪ ( !ʮlC}ٓЮe0̎ lFڶ30ûmjcֶ֎^vna3_xncՒ(vb(U8fHoVTl po)z[ Ɇi( phު& !ii\` ghΆVU'W "nqq)lpde'"'|2m0ri2q '_,r0&)w+2~rrV3g6g ?74 /;,P&ԋ.$<f`. qǫq,ϻ8#P:餋):Ỳ@L?Z1̣< 6ی3NF٨3r6\!tcۜȼubN MFAdM<Ԝ88}6bioO}dc6AFݐ4M .49A`Hߊ:2CV;M`Tyn騧~+ {NNb~P龟 <qɉ w?%ghL8w&?32CG_=AwYtwC6|!4?3?1wJg!2v i7K4'!e@7# ].~#$MQc0 443anȡg$a8iPgU=nm]"Q-ZTwU-cmm+yQD8I3*JXM|\0@* 7S HTB*IZ%A-a,2M2TRSNtea U$`RTO/A !eÓ<@9̌a aAy'u0%/dM ' YB7g [k2O`Ñ!6!́P0sA;pKDZ26\ O^8u8̀HFF2@#il?N0 4' HRҵC|dHLnxx&H#Pa(KKHHrU` 䬙 ZEX4}B0N tL#OSZAiܲM U*8qB">-!ĩ@D!x#0lc\#M8n{Ypb˂^'36x4v>AM?M0 XF2]; s 7gz c^mcffDW47P~Ӭͱ"."C=y+2$lR1D>} S gr[qe$l- d\Rx8ه:*1p/#((6&}uG;9ԤNUv DFu]Ŀ ?s .=s]y P٨)?0G!32@ >l:(MJRe e Ӻ6֊)ٶE.Z`m"4>ȖQ GI߲A$vd\ 7ۆ$iw`'lA"|x9# vnK#'dmAs_1ϝ C :Bj6m09n¢+Qz>:#5ycoii 5#h>AIxAܺ3 H)n1eqmKлo%?]9q Sw WRhXڀ' eqmAҰ uw  TsA8*yqCMf![X&x(*,؂.0284X6x8:<؃>@B8 v0D NPR8TXVxXZ\؅^`b8dXfxhjl؆npX$@ q!  VwH!w~B0|aP)o( 5xQH 0ola7z؊8X:8x8 4çVA01ZPb53 ƌ  |8exZ@ 1 s0 4P< &pQ QXPgL S04!P9  H U W҇@1`J(i1 !$I !8^D)*P 8% fB ِ LD  ]Q 0`xANAZ'O @%ؐQ@ c7?z r-!> N23טA ၚI)9< lؚ !)A=YYqF1yy9ٜ9Qֹؙ鱝ܙiE??ry)Iy00Cp @!Ԁ sڠ:Zz&ў:$JP,ڢ.02:4&ᰢ97Z2&0Z2pt4'V A yGGУl81 pt΀ }m7`Ԑo20ak0 0 $壼iQpuym9@' ͠9 o: yQ }mlL`' KpI0 xV :t mB/`Tq`P  Hx51P &!0&09 0dxe kb`8#QJNey` @ ф f'8P iX1 **$#pG `O0p 70T(i V ЯwC (v "  `w T` faOvfPQղ4;6+8[9{:۳<;>+AFG+IkLNPQ۴SR{TV\^[`a\hnp۶qr[t{svxk\++۸{˸۹{˹tgHꐙ_ IIwX @!'[ູ!0[lH Ɓ{JLJr M 6 0'Ny['y*O7^;'GL0]I'Q@a K k:q :ѿBq ,n G`4Io2s ze O! @ÿ / ) P !\Ó2NIK`QdA2  $ v `\( M@ Pal@q,ǿqx?@CAaȆ#@~)i90 ȬAP0șl"sØO23 DpD` qDbʗ:^Sq ulz,Pɺ"ЄA 3:V4c5؉ܬ:W> ɠ?Cўql a  1<2͠eC=qG 0 F ~U0*1Ь|8F=.4Svj(qB YNC/1aѴȇQ&])y:p/1-X5ࢋ) >I%z] T3Em.\0K a Q}S]3U)B`.]E&q rM] 1Z&sOHM@1P Շ=R׼/-eɠ c@Fl} qlM3ڼ)zɶmSع}@уdp=c>}/d j2`{OJR@=l5-=wLǶl}-6AQ9_h' ˰l; ~ 7+9 $L@0wRQ ŐQ i 鵕eJ@ Qc:p 4#A$" eeafg-H ڶ4fN$Bz 9dlThj߰{Ӡ6噽{p@Fw^|>nz< )>\o j# V6~^-f@lmh׃\QN]Є~ bJ+@  U" y&hm@ U33^3Ӛ  5xla  $j @ P # 37c.7\EM?N_ K=0Јી+# o PpAs^ 1c ~=$[7YrC _ڃa @|5 װ£ ]To { wu8$7?Ti1D~^AY) p`AezZQD-^ĘQ(I!RH%MDRJ-˗L5m,Hb8}T/A 4i.`|`[l Ś5#?,tQV\T\IܵN\YIW^})_… FlS-{uJXs!9؂ (@Im%`mƍun- ,oo3-(4V*:e  a~ؙk-"CqVn6]|Tx_oZDy%R:K4&  $7ùtG$Ċl (y^yaqM܋2=L)ȏ@kVz"dҥ>BLI),ēPFJye,i @Τ2(ѺZzY(e hv)vb8 JPC,PPG-LHK8i1MH[7T˗fbnQRj&OopSd,\'8P҅bi`OբB(e6ToӥQjg%[ @\t߅Wb eb4l6^t"Zm &x3 F8%./|tV$/47c?&lM.ZhYAVGe9fgfF*U%ZhETc~WZ"xffi}EQ%FZtY6 Buk[Jc !m߆;R+lFe:Bw't;]hn㟇>zI4Es3Z{ￗ>O|? fG?~~k\=πDDE{K`%8A\yq5A;H:8B>RЅ/_>heo{1au("a)R-0 N]Mo I!\> ъWJ$IGS:)IG*WWn&i)AK^JD>-e)ʂp%4a)K21`oKnvS%l#y鈴(FA&gUV2Y1q#ϔfaOk,pF:eR4h3 OeZ#1MV4$l&!`Sg5q4*2LYr"rD`L*L2G3ղ{Q_XYԨGЈXjXcq/3YŪHG2s`X2FDAid"#JNAJZpC; @?K9 4cVc4Zl1O8G$344я} YF|!u#3G;+*C&cdw 2fWogЪ& J W*[pմK@IDo~5+[B|G㜏p|0:G?Ac<# N׸ZdOit^ItC&5eDM2GfblD1|nvF&ޒ?΢P208FV.Sj9%2A/bŔ@1! 4ߋ;mr#۹=r7; PP P%Fi A@ uOm{,t>wr;Z#y!Wyfoc !(xg V;VwFx{!: ^+L`}7]#h@Cg㸎Oq]#N-e(yFf2}c?<}#QF|ؽDe#f C ,;٫m< 7 }:ۆ˳DӈÇ/7#xs) gW20AٰdH/ /vw`B(x5"Ԉ]6&>b-4G[q0 Aꡉx,zۄۡm@l8rCyBx B(̾x{S0~pȶ̈śN\B~kXOx[^!(RIRŒ/l ̐N=u3|1}QмхynRB L} R#%:(жʈ/Qu()0@sB hPXkx==f`+ɉӊTS^ϊ(v3-p/7ۇy@4QkvS@7Hy8)sD0QP mо  Dհ.m+…HXUVPWcEw9 %X:wĕCU(T轃ĈwpRRTsVoZԋHR֑؆qș)n 2KQI@U[x׊G$)Kd` I؅@^2IB‡1Ψג(!TKSRWcKeO"d=B #^=VZ2ڭ}z e `ڲ>(0hYu[ (#P!oڷ۷D$)¥Z eìi}" \iQA]ԓX!}Jc֕օx1Eץ]%^h+-#}b^+ -IމN %_3ފhe_4^HRm6z_.!%6U _` bP  6^=`Vf%_ ]haV}a`fjlƅa_bM bkU=b`jx5q`'UHxڸhf)\b@3R0.2Xr~XS/4\&N , g* {ˌ]46apXń] H0* ()q^K~ ?+n1hx`3X@ґ@֠xً a'ᕂP^v#5_`.s~ooR0o[d(i*Z0p%J}b֘1CaBip'riJ *_ /yPLe TS{hihTqWrHU3Ђ7x<0@ ؈'K0bpp?^2W CU0CDe(7y?6 g @x_0$7COT@Ot38߇W~:7NQ9ȋ ?DRabGrY,KHRnzx }pߠ #^ i({.W28ַ׌vѹ{ BH4P/:Jrpܕŏ!`cI1ZQ)0|߫|+r؃\wVviRwWb'~aG~\8w~~!/RV|7A|?g_\ۈU_,h „^P!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*WlE?+eL̜:w'РB-j(ҁ A0&0WҨRRj*֬Zr #Z]ǒ-k,ڴjײiTcPҭk.޼z͘;.l0aK1Ȓ'Sl_s/s3Дa+V4ԪWnͮgӮm6n.޶%;7‡WWʗ3o^Epn: hF Ǔ/?}9TD~ M 8 '߁{$H|:BQ  "H !ƏɃM2>N:#< 3P P4H x#=Z Dइ8ԈbdP cA4j 6OP]zg#t5""&mD' +r@ d '& f-B$( ]2h"N :)޶B@%"%Jx`;z*iqKDz Ym’*jW;$X L,ͦ:MCP8#ڒ$T@:;.U*'Er@I{//03I:;%Mi ;0F '@#<O TbK O<C|2)78+ 1<35|3=>> =r}4Iѭ!,MH*\ȰÇ#JHŋ3j1!BuIɓ(S\ɲ˗0cʜI͛5A $4iPO8 JѣH*]ʴӚb JӫXjʵׯ`&4@IfŪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+1 dIJ:59oDoܫ+ed)[bo(.l%L‹ƒ {32iK"Z (T?H ̓ 5hJ!Qo}P 㘇6hM]b/ :_BT ,`3 H5yp RK~  "x rJ3Cc) VьP 0P!-T!b r*QG^ PTښ@H^UБ\!; j"5 VH \d ;;pX&5xbA`S<Jywqp.>OR܂1@$:k`s  Dҷ]4>*: 3!lX,#ч4:MG{^W0# w`P2 d4dt3XU@L׸4R*1. u8ԡsGLk< 4O^~ `gKa eHY~IC4HٽHq2ٕry5fk^E %5ʎN5$ Xl#gzIb$|Y&X񉞛Glw7bnz|/w,`PЇLu60j"9 c,eHZ7%jJzt~ ?h7|I$akOL| c bdK3Z'u k-Z_o}\ 85~>^3d{.n] ‡ʛ>=k5ysn6%@ @1vn N_20*,Fzdm@ld,Oz8R8ϟqMKٵuM&,5[Igo1\0OR2-pͥq2ф@|1QsgkM@ҙ%}s|Wήm@Z+kِ2-s2 1.{014;6{:<۳@B;QF{Ej0/[P;RT{0]W\۵^`b;d+' ؂ lk/Cg06@HqytR=?(*yȐ@pn<q.1wQ- [3 )ozUpih)tpqg'1hYiTpNa \0'i Qb P&  OuL   AN 'Y8 ̈́I a ajP P P' ;z ` i(bG@xP 0 v"y§9P Ya  º` "qE3l  88p ( v@ "9(W Fq,e\~ԄYFL~B ZK#`F0!F ijl #f@^yz|{~,Ȁ<Ȇ\ȈLȊ|Ȃ<|ǐȒǑLɓ|ǖɘɕɗɠɢɡLʣɦʨʥwVpPSpb0OZ \\|ČƜ̼ά,\a,O||7os{#6WJ\ ]У  ױsNL١ ! \1 {@M'NmPҢ@ k'N&N bg'=]|K3]'MR=T]V}XZ\^`b=d]f5'Y :Q-t]v}xz|~׀؂=؄]؆}؈G! 8'= 0(0BJ-5n(= Qx zGZ4os1J/~I1. -! AN;6Wn@p[bIޮ!4hE~x.J ރ@^ޭ] W7q0>3ރg|*.J.@ ~g C+'>H^?M0A Y{u pyCG> 1 } c1ܝI> |+~-ʾ oM^ ꀑ/J+bٞHaO+N># އ ؀ /_2ޮ?6o @ p n#\UTe,dR?P Nj#_R 0n!o"AԞInJM҅AƠ7 Q _Ib>Q aa@  #)! ~: 0;a} ; A -- `N\Pn?B_#` +@ DPB >QDB PꕱWdɺE%M8A"C$UY$db2vPEETRM>UT'5*ROlUKRaLB))Ğz@pU'FXqѮ}Xdʕ+O$RG,fY4Ĵy hNR V_ 4kin,@A&vAh͝e3+ b_Ǟ]Be,@jۛrz^=P\,tVdf*bXj)%̃0f!xEB 7䐪vje)+-"j( %Ák3Ϙj/\ȖYtQ-]<[\|j[䅘dYfyI)rO )ʾR̫ѹl2M5dM7MPqN\kq/n&r?ݶ:CG=l';[ugoi=wUC ɚs݇'T\->xo4z^**l꧟~&mzHC]Oj짢>ۤB1/87d  =eؠwP5Ȋ﹝B@<FA,YP Yq~c8qS> >N%#q:9!$XHUxF<@0|g <:iGkp`f&q{4*u`>`Q) 1},-c rX%[M[@ L>rϡ3F ;3mJ@&$H8Qld261 Q(.[1}CITq@|I2̒/@A|j%3Ǣ =&ς +Rq",HP 1@4o8΁cu1" Swa.PiUF Ot[)db-8Z|h0ς AQIg"PX#6JK#8 qԽGtЬr{׿ Kc1GYC=\:kH$H8 ԥ`6ƑV*xyc|5XX1UL`o2">;>8B8 $?Fn"J*$HS6d i@P˄#x2t/D3!BG6O|SăXF6`0;au 9r6ܵd iH' 93h`J).<(h €?h#IAUԒM<vc &D,& +DlNӅ Q yE;@9A oH1XK{2 4Bl`($a,`A',FC܏q̃obɷp^Ҡ6Բ SntSTNtUntlFu 2J|gdo 4| D*x!#tl=߆6zֳuz%36Da$0}>۵c ,;tkЈA X >uJ5xɴr# ӣg0"Yh&zx9 izz#f.h+yX]èx!C,".C>4?lyH&kXBLɭ ~?@.24+EkJ6x9dA;$E<}h.`brvcvY0l25t2:(пX>qZt%e4482xHBB,}ƪyzQԵxqwƒ($X C4,PDXB~'#S c 4Ej+/Β>q,~~xs0 8$>xZA}᭢ǎt4bw`r ?wӆKdH90=B0P)S{B/lEZ$Ybʛ| $5]Gբ[DAyH{Jd2HSK ƒp$d˽xˢ9J ҏeaFpw親˿T́"أS`4w6HDM</X`;LUAъtB]iO,@xxuȅW[1>`y+2Kw)@ hH CA8`1] P>ԇhKsI5ߤ6$HTp#(TLljOEUHMRBKlLZUO'uWQP[VO=H (=5I f-S1⚍^ukE)fC ! 8Jr5XUsef%8KvT5!+#4׀UO"8X"xAEV؈U˴cX 0Wظ!ف(0֏eYu Y8 XAٌ0Rmٜ5ә-ցp١Y Iƛ%ڦխ3MrvLVZ:ӈYگŝ %oW۴M%E[[ۨ5 ]%'r۽Y4E-[eܹ[M\Zƥ\1\ͳ5uJDEE܁h]5%5ϝxXץ]Q-ۂX}8];ڕ RPY-a]](^ d]-#؈R؅9c0|ީ^d1݈\,s>%1~Xe%=]E; _[pu@-FE -݅q]ԇgq p$,- ``aߟ݈g_#iylN$gh-9aH`෵` vmۘ߂x⁸@"V5UpMt18(ZH.f# %&]0 5o@*曁=612` SX0fHb%Ip'8!RLM?^] D`dehdb؂~8h>\VNFbO>]R~&4CoP= W.p"߂XQ6S⍘2͋&*g};r0p5rbm@NugN?^3e؆ t<u( d` a%m@y} [eAnDaPk9YΊ ֹFQ@eKYMH蜮x!노Ѳ$E3arv\yPlYj&>l!-vlQ !ǶxI]킈lTpCjQ0FXm柶s'M^_jj3`j#mMTlxlnة~0"yk!~V3釴Shd?+nJ@t ڪC ێ6wDGO Ό}K_ I tLH3O'u\rRW8qZUY<8Q4QuRuI!H^c/ #d[g.г*- l=uv&,Fxp:u'Oa6 ? ?@E9>qʡs'd16wo0twe DA<~'UiIDiD{S{ bD KP8Ю'y:}HXKfW ʇES삸x }w3zF'w hz-0pT XɖS{*zXdnlw(# p JůFpa~ Oئ|7(o|8ҧw5kx`C;P|g!ExSmP6 Jh mppwl(SHyj}i~mChʇ؄ n(k'9Q,h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*Wl%̘2g48nI\:q)8j>-j(ҤJL4p9UN <۲m 3q7qD`` A<8< =Ł36C@LXSљA DKԃ!,m^*:d4řUqBt OO:IREI0&;OsǤ0!AAVCkjLp+^(#V<PKJm-\Hy k^Ƿכզ[k+YP`,G6ՒKHd+z<^=w"cB  [vTH!FʹCa) RWB8m0a"oUdXtF2DjxJ݂\qӅ}Sx>?0Zbc>_c'wAsmT32t8v{@/h~vzz  2 B$  p' ă7ct/)XD-pC " $x &xC)K-$GXpLă#X'8+G(>XL9Q؃?(Dh.0^h8!8@x2/ P1  2x2>5>( bW12%DI3HwpxOr(>H7P1D # ((1x( 2 $0< >H& CSp'k+BDYyzqeP  ~qq/#{q@F._w*t1EW`=D7js[zfo{cvw˹legFb:ɀE֓HMm+4C5W`sꑮk'5+y51}ncKҫH=;:h;L dEq?: H[-@+/C0)a K@w %>X0k!>Y;7UHQ> 99b~{NS>"  J5 b!ٰI6</5*RP4v z1,4a/L!: @f(L AgW)A0b) _rV.̰'2"80D%9p <d 60;t1wr #4OHCl'Ґ9l/7F6&('80ɱ >@NK`=Oɻ,(k7[fe"O Z|"1?Gټ+I ͆D0LKǼ"p>GQLf2!rUr)Be1FA.lLʡ B@ULx%{ɠ',7Y!Ax '@!' %m&TSB5{!3~t!$A`P p pW+&K{ڊG~Ab).+"˿_'^2o5 QD-^ĘQF=~RH%MD>-NK5męSN=}T(FCGjOQM>UTU^*JtX~VXe͞NfhݾW\u6]}XZFXbƍ{IǕ-_ƜYfDiGhҥMF]S(dS[lӹ[n޽w=|Åȿ@D0nko8J/B /0C 7C?1DG$DOD1EWdE_1FgFo1GwG!H rH|D2I%2!2%J@(K/ItL3/L5dMq3JSN;3O=O?4PA%PCE4QEeQG4RI'RK/4SM7SO?5TQG%TSOE5UUWeUW_5o!! Nf *! aC)߈ R4 c Ё.D@(0S6(DxG+fԡ!x08hp,@aw h kHHA("ZӃ >! r  &2`<:BXxG`R&0/UtP,V!Dq1!9# isL,`ߠ l #@ @`JY4qtXN8V@` 1 }64aud>mlkh 6x`5$A:ZAypOL;awb,:C6X3 [ȇ+, X X?xXq@#&`||C{>8g3BP  M p:  6 *Djl5c$ Bbhp<`As+:|4#DX!p@%1pG6 Ȃ(ʾ (hLCv Pxkx b OH,fTb3`<)OKda BU}n1ġ TAF`9k|C@G%0lEFG:M|U0718wt`(b|Za:,PmXFa>F Rچ6'H]:"`̃0&``"I >a 1]1}.5m߁T@4,y$ X-$p@)w4 P@paX Q>w;45`A7@Sʈ& 3k,n>x5 ?`JYc+PH"ȃ*q aDdH\@-&X':`E `jv岥%Ǒxrm0`(A&GkpHF?\<C @CDY@4  ),UD# `@ a*0 Z! j}0,5yHzI_:!:Lc߰?~wJrB?}p hxB4 0gZ@WR 4Gow0m+A(d赒As~pxVyЗ&appH6X~yuH,})Iǩ%q`5܇هyЇ m@Up0 "D #!@yxXeYAA1p d&:PSB1A[r1DAq`. zi 3?-QΓBޑf l"i AyYÒi"MM@QΫÒq&3@tůiQD5 HI(DQi@1NPPDQ<<Tz!pW#!Edžx3FoDp$ wՃp6"Xd6NDÄMtωpyO0QCx_(*eЂaHJàMxXOW)pB#ȕ0 u &n:h3ih2QЂ@XaO9JpMm ih`_S ;0 eo!k(E \(]4 ]؅Z]ЅO/ _Z3uˡgxX2%CUT@Hd@g(ӡhԓHTG`aOZԳ8P=ISPT`VuE65Xի%[4\^_`^a]N@cEQPV$ bmVdT=gְOl(@lE .BO&0*fPWtjpw }P|A6-ЃVpUPQ`XuLW \PHXՓ9OPOXu҄XYx!Y Y}YvWX%$uWф-LP oʼnLڅ(YoJ١Uڔ}ڃجDfت K}M HH0[ޔˉ\McQ[[xۻLMM %c(]X$\H\,ܮ$mm\$-hW=[M(ǃƒY &N\ۙ X6%]%ەG][]dEə@:!^=ܮ[,\}QZpGT݄xHƙxTgxÞ8]"۽ ]5Y@IQ_h_k_1Me=ߜ4[%`#Y8ޓ*}AUNͮ,`=av ?!_`>aGpa5vNCYb46܁b*NTՊ&V.b `Z@`1.#%I!\`́҅)cȇlP?*c&b@^ၰ.с=dPdyi.`J,\[@^ZPy^8eBBKT%d>]'pۆ[V e.fadc΍,[[]XӃ\`cĀ$fƸfہE&>^W` @.QZς$΅2}gŨy5 |vZX{ pg W.ƅR:S֌)쑬P1ᚁ`Ŝ |J@bPex |(OXExdhhc3nxj.:iq] ? ]8Nvj3EFHj5K?k$ةW)|Hjj*I։xi),)ґA ecUJ%l@[hhPU;0WFQ8u&,©n1VOO*)hhS5A G(q8m6{ >;ZzB W l܅n=eoZehфnAS\]ꖍ.>%je\.'@(iضZXl&O_m^F0>z NK&O@ݬv恘mP K:6Vx[ϴp7 P}vVq: *wUԠzagTW?"-8r!}.V3u4#A IRtf9"E;x݌1iېUZP]S^II@[*fm9Ji(bY?*Nq:$6'5en(\A7ЉZY) e)Bx+jy ϣjeaeՠAꈃZK05)iryXn2PabHtU#(" De '@nZ+&\c[Pd۶:R˕B̛I(8&>%F16[% * )2*D@X"P0Iu6 SgboP @D+tK? !@ڜL8Վ=42[e5" d8PC@DmR)ԴO`a2(S dI]8Rӳ s{ƴ6q@?BĜ~K0l/18Cq˶e#ރa1ޒ6fr)dHN PiӠnQ5^e/᳠P88Pă.DJtI;P4aY l$yy2gOA U"4w#UR"B zc \/{I4ш{(UQqS1 3#4(/!/B%2< Mghn"(,,[&3X&/$OR1u/쐡1c#%:2$xH8?䑎XD'٘0bW! C24!mbVi rLLj/Z 4J̔a*DeH:N2s MgB%:̧a˂|N"!ECgq >w ySy1Z㘇OӠզF42 `H9sa+"ѣ%,ƨNj 5:qU"#\fN hȑ)C4h&)Vx+BHgjF<##=*f:_nÛh` Vv=miwg .!O]`Z+A ^\,1CtƔ! l 66T|]?ْ]dtAP!M:OAyT[@؇>.aWk5Gv, VCm[ _ܢ 8()o )e܁, iti],5Uv/l @Lku^' 9{+_n/e8N.J; 拫pc)`z%Hs2CbG84SK-$T~г (<=Lcx{gA|0kFlUsvg0e'ڲ)m r5b#CR<[HY!te$oqg1LА2:7s#U8lY#9Nc3hiHǤe'Ko,Lۣ HTsihyrS.s/kG2#ČΞ|pZD2Ӛ6=7%EcM;I>͔‡ ;-'[7x1C\> D<A P.OBcL5G;AA B^ J5K:^Na.BALTL^YMèT6X7y8>lbtCl"7!YԎ_ABQ.1-B&(Q{<@_lAd C?׫!aATL%D4C< KG5ݢ9BRB/b 6Ĭ1 ^F)fC4<>fnfiHi>e;J8|VNr&kbfa-B0tkn*tFGHc&qgcp@q>'t \a.gturA$m'zgd]Jܖv|'btN؈l}' Ԁ{l(N$fa, @]XXJeDd:"E3ƨNơ#v|ߌD@O (&tv FDaaE$Epєv^WP~)i`HXWPΦ))+&ک"QiI:.&)`FꢲiAJ*6馆jjAtF)B*v'4ljjqb*:)e)`zD Da. !5U+$JkFǴᘶީAX ~DͳՉ:!kE. !&RV+șD]8j D1"̈?c+AP)Y,|=H6 S5P "4+ǾINhF(6Hq1WJPx1D,`,B,.< 8@83D AЀ D\bHˊ@2!CT;,|A - mf":DRq%AI6D@* ") DV@!"r|侈ļ.AmL948U@l0n䲮<.b,Ƭ) B9!0BDC0AnH \/FH~; C1@@C+ dU @AdõLl58S@1nA Re :C@4G~|H~S ~'1W%GK1 `!Hd_̎5 [pE %hg)Ӏl1 FE1q 'e YP1"+$G#fN&SrZP1bY&2\2)'@D) 3+ϲVnOв.G. Da+1]~17sxy3Osuȫ1)5gu@h7Obe~39F2[4:*33p*CD2*'$:l*@!B7@+H@!C3)ĂT!X(C*9AX,+HB^.41D0$C* pqCl*D *<$,81C*s#B\X ,C4H7DC|DA;H`@{ l:0I+5D,$9@ ,D@<4$P9(*@,,(:<¿?!>ȁAЀ,|C4D-8@7H h]-{C\'xC$HpB$9˻#YG:8 e;XC@T,tB+H:7C48<$CC T@6L8-:8$&2d5}; 4C+@)n޻/5a؀+pKC<|,;,B::4TC3Ȃ,| 2@@'\ dP>L0dA@ Rg:GjXM־8bE1fԸcGA9dI'QTeK/aƔ9fM7q~]笭 .hl,m\:PK2Ҳe1;L&DIkLȒNʒA\fL)` *P!G,5›#BP6X2G||4l2F٬ˁcWL*ӟ_MUv|{幐43J6WzW2d c?TrcLJ(\V 9H3|9.'=ԫL1boݗf;A6>C}=P vB898Zfh9;Rt6l3pdZ+`q0 C8`#LЃ\r??>l o+M4çMMxXU|067rZ}ܽ6lp Opvo=W9h6 4aFrAaVrcW>RqYPߑYQӃ4%@ ӐYP0iP )(71 րXѐ?mAzV H4o52-318SwVV#᜝+w8שĝY!9Q뱟ZZq ѠZcG|Z wq?@@;PyRj$@ :+:SS3톣;`o?:DZFzHJLڤNrҡ PzXjZɥ`b:dZfzhjmd" ehU&*&wP&PaGT2k7m`͠9 : HqLkJI0 @iz/ TX n$(D4a `QpdJ&@ 1 r P p'QH J P xB  -@ {R Rъ ௮{򭺐zD '`{kao ۱!"[${#& {,/0;2[A7k1<>?@;B[=KGkA=\\Z TSkU{Z\^_۵`;ba \P˶knp;mKo[x{z+y˷{k~;}K[{+y ;i"EG ++k4q G&LjFK&Za_d" Q $kQsb R% '` 5( 8eA (w ,x! a@ +' 0 '0E! \'# 뾶|o` G %(9\bG0F! FDСHħAA??@TV*ŦAC@D^LVT,)PƥA᮹ ƙ T 1 ]Œlt JGKcQ *ȃJWlȉQY2qQ6`,0 /wqy]IpyY Ť< wJ4:#˴S˅ɐ6Dpſa,],\̩ W YXLlɕl q[-l4P P y{<Q< a 0 P.Aq2X'5ћD' @01-} 0Ck(mmvh 0`րo#L/cT)KՔj YF0΁q nM;dImVh60| F1_gȑh\,((M ,!Ç 1Ë ` PۣB0=JP a^aF* n!cҠر76 D pΜDg~FP tlm .U A u юޠes! A2 .G)Iߒ~EHe:> B aP\Mg^ 7&XVp pa A>@'Kt4GcsA*E†1UV29]ԇ5tNWjǟf(evo~zkzb7tL'|~炑I&Fk>cǝ@wZӃވp1;?A>ςSV.}Dk'DQ(/<m9k޻ c'qem8fHC°78$l!J(h(/I|X;![,4 +26! }F ((%>wc˜g Y4M~@z8ځZf (Ɋcm$ըUuT; q3O9=,82d$l^iP`B8ْVzy\uXBX{``eXŜsk8`pG;AMc} 3PXX m.d1v@'ks ;!{B( Rh[ CP }(930hhp}0'pxxXULۇ}@%$5 y/M22!л0cg󐎻EBJ <mhp5.Ip:D mXmP @i05`zP0OTPRE@EU<%fXL/Zf#T?^ iAFb9NF!pI^lKbLdE%Pve<|1 Pn4]YNX>P6HO\N#a60@0fkgV=f@T_ifMfF^>YБp$PpHg&PzB>cN^EH E2g~>RP@P WN'XvW>SFH -PvNS]?'jh]ڡg p0ogm:bA] d Ppqgx[$~0Qa>܀3#P]jO xAjPknn Pf1bHgkXl @ސY،&^6d֦V6֌N/Nj6(Ml> bnCx/&nbMFoo IPMޑ66wp p_ p'7j1WqY^apqqoqrx"O7$ S&7 $w$O(?q),-10.c]mHY/6#4[8@@@1[IeU9gHp>?W:Y.3Jm Bptvo\ŘCx"sS?VwWYZ[\]^d`a'b7cGvI96:wΒΠ]$jqOW+BOv;^jvOv0iZlg/~pmn'1!,MH*\ȰÇ#JHŋ3jȑᨎ CIɓ(S\ɲ˗0cʜIjɳϟ@ Jѣ4&5IFKQ@ԡI>ȌhC::ĥLơO& EiLr*jJ*dԔ-0ŎcQ[!Y$x)T D8k,"rU,3~]} ?u )Sq s܏9 ~^5O?1%i-aR l/%aRP?BS$!6:qU-PZ CW27&l㌬o%"ES®ic|@9Ȯr;`2B$AAx7't H`k<UI5r`#]qSD^,`}Sd3mI0HnUXL 8%@ is; ;dWv$* X{c39˚9 TjG*Tf(Ʉ N_X}}J@K CP_Tΰ@pcNznsZ'HX3Ĵ$b9t@ D!&1b 6ڴvhtZU_\NMcސLVcv8|vw 77nj}aYx7$xrX;'N[>k{ GN(OW/4{]ҙ32^|+JqD|(> /oJ%$8ջ4.yP:r*pCg`uXs;AIHýI(vd> >}wYN|H6WwɖORŝ{'GOқOWֻs#0~5Z7wb :?F'tq1bvhqs^AWQ}sXr1/~OOϿa1WV0 t(!Ҁ 0B'1-H؁ "8$X&x>EW9C>3=-/c?E;(*H.nģ 12h7NGs [XopTɰ T%k!^Ih76wlw_%4׆`4!}rr`t|)+FP8NFHp& z0@l{abP\0CHxa'h0Eւd1xHe8XxؘڸG2KwܨV o qhS!yXx؏9Yy ِ9Y/qTHl" ^(r& j mqq 5MfeJ /X&G erVB ' hB`rِC(o(&Y  `  gKpR cư  @AxI a n%GɗQw)' W&VXa0c &k (R Q)@q N p}B fP |&p? ?Ùxȝ9乁`  %՞)YqS)9LYI0*L` LP? Ji'Jq:Ltr P BwA \90dY >'&*p@'0 @ 9LڤAN5?RV*@W?@\ڥXbn&{LaCgtzJ%aUn: "13I}Z_څ|ѧ ZZqJZYrJ#0Nʥ[JY Fj\JZ  gؐ3&@੦-8 : l0Zk2a*d6dC712 ݢ5P{>0- 4ebLNP4ES 1Xqa޽Q# ( Nej>TeA!A<D0N~uQMQW0臞YK r~Q<$ $HE5.kꨮANEo䄰##ڠ>Ȟʮ_baCbҾ4E<:#l:ގ:!ńh$A  N 8 A4fYtKM tlGnAIo$H >zP?L]p^a 0Y ӎH%9׮ΉgN~<Aմ40 :  N ;>y<,IddI,NӲqChk_Ps~N4=tvNkItnAOċ!tPE .AdK4 fv;b;_e` 0?zV1^mz N`^0O]_ǏȮ1 3נ6ɀ 0&6 Lgb  ϐ ˵L`b<;t:!Nph&n2ml(n:Hy86` i.Z:dצ7olH&6|S^|zx 2 /  @ w 1w+0 DMlGCegd mI Ǡd'GxQuƴ F'oqnl ʦ|g}~gR$BsA-)4y&L3'g36[2n鸦ְ 7āk.ҩjx G ¡&k\ ?YgV[o51È8̠F0\ %Q2XQ JXpO @O1ZPBaVYdEy E~VPi5$Py%JFbfEߘ4ZB)XL $Ġa>$MnV$Pn %ZKdim{tymu52mIVV@&[$x0pzgZMPnQQ%mG jI;0Gyh E̛|Yf 9[."AkD%Q;m>)rm2egC/QPPF9%gPQݠQ@A%vmNER<RHT\yy^kq!A "QHqT)ׇtכ[Q)}`Awct?S.ץ"1яb S`@q : EJ6>ghC}G?n6g8+QB()T;P# IyKELR;Tg| F|D(7 b@TÈ*^q dBxE0z TUլߔbsLVG>0Ca`/B1fL I 5)( ­Q#%bF.cBeuΕʵQ"M gAX}ҸI-76 sFk%J H?PaX{w6>>m}X8>VQhzD!I$ !*(h[be3 0L[ߌp3myړ,4 R5Qc`hJ,K(Go;Ân@X8NHM2vlص,p_aXg9O  q#L~#$ 61l{Š0s~peAYOvh0@W d ch 21e E7Ud"D9(GV!lCFH3lN243 /rF$wsfIIuFFBԎvC(4Xh ЋN4҆a)ƚF6A `E<2*2MPÓT¶5O0Ii?5$OoRqDG:hOL5 xͫ$dTF!.yH\QMP ЬM {Q졌/ (EI7">Yasg`9àFo7Bq*2འ۞%b  6sHSo8)B߸<<// 248\^_`E3?@0PkX khƺғC+G*$G Ɉ0= ؼӼe?B ;?DE? G X !ًEӄ  4PȆHŋCOGċpTy ϶(U X^_] a`\ЅYY> fOЃoȂѺ)BcP$D3 QK!Ќ.q } S3 4mӀؠxa1 ;ey£X= E"T}x2`\>\m3ʹp[ܽ~P 1bZ_{R9ةݹ0w "ӆp H@l#xǏ[6[F E_EP\*?q ͻ xJ6 P=2 VH߉ 鴬yY ^,_Kxb_@ZP@p)q( 8ar{~<X5B]߬}_\kYF 0%b}xȇv4 ȹV44@ź L4l9٬ͦ}D@d๫H< MpÊM<8^@(Xhd e!Q&bf6jzk=Bx:Lxxhm0Z M3.~ XS?60DыAx^<) #]i hm5ȇx vl~lI>&{ⷈ'lh&ߦ<ٶu (m+C1v oR&a! ØƐG$20cpy xc~_0 (B4u3~f[$m TDhp`Z4#GrZ湈Z$O%Gs:(}V_\\$ yP5@vZBXh~R͆qؽ?Z exNbpt@ '&D_Z60oeEޓ=qC߇r*ah O]v`VwW 'ٞ )wP٨,rV/4Nv;/V5fF0ðж;XiHd0C7iHKgqx pІ|ɳv _mPoC UjK-1PtEt=;Uuj v%v ~JiL&e[h}yb] rSH5ם[ mOWj0^wo3(llbOhx{7f΢X y<Gongw`1Z[uj~||[soX_ F_qW\7Ηd`1jgvo2DpU¦sوPP>z߶(R&ބhW I;We Ƃ%mQ\Q!L,h „ 2l!Ĉ'Rh"ƌlB^4,Ir8PL跏%̘2g2LN'?>iD`Lqkipӧo޼pOu+Ѱbǒ-k,ڴjahk-܇(Cd2.޼)p2x ڐ,`L` D~7s3 {$,e,,yQ2D؉),ΫOײ-(Qm~v'4Q ]9C * 2LJIea-;5C3x")2 Fl/qڄf*? OnA[5T`<:*$MF.pjL49?=zcn[y,M%if! ¦AU[>CDT2tCV O8#52y!Ԟ|J:)hR)ZbP8h#8#*`&>$IM@9QSz+] GW٩PBE;c@$YMJ;-BhQ28YC[;.L{.6g;B5P\ 6NA>Z/ LmC P-sEzͷ3kE< 4EIGWqb(s2-?T.jz=/ɳA7HZdÑ9'++4QK=uLS !P) .xT}6i4@)S1IJ,E7zy7sC@nra⊛>9啿'D! 001[>:饛+K 8ÞzZ>Z@QC)V ; n Dy֢OO04rpc?;< g \ |RW] cLy C :F&Ԃ_$ 9+R3K9rk$ lɇ (K91L:" 'OzFl*'0 RLlLpBF?RyFD ҝjtdȢd;&bșƹPGO2EPK l\(MYQ~&[6Z DXJEb )PJ"PT dc~ԩR!#V^5HSf-@sՐQ<+\Ԭ(vu:񴓑dOXj}< AX㙵+d׽l,^er,V S<_T\JB]*_KGd4+a~c$ 8p3n6(g?TZѬ%+W_ fꨭnk\eOIGmae* \ @8䑯mCT9E.c4jl"}% >ѣt\3"MCw;٤nx:i~(ֳүe9:6҇jQsiu 8( )KPl}tE OiA|m\I MjzWUI.<||HF?KkPۈG<l%MG2>i /?@5~W HB|' NCF2k#5`kLShyfG?A1hB ^&P0(JA5aܽB+K@p("G<w" H7, (`@,˅U ]zkѠޡH,*AeU$:fCjkd D 0";N  G"Ppb 7 , oD*'6@A ?J'~0a9 -UطF}x?>F(: t<` &ðC)H&8A S\*؜s|0C(xp3`@)E2(C4<(C'@*Dx&"P?`}@;>*C8H@C<)C-̃>H:x/bC:Dh/1t@!|T(?,DpCT*P 0BBT@  D3HA0cl쬐ɣNu?:% +"8Tm P,,|@)XCS&<4 8TA |C3+(Aӕ7=!Mb (-0l-H,-+XB(e x%( (0 1<:%C7$C3DA* `?x+L,ܖL+$qF JMA2T5X7Ђ@D@y!APF40,DC,@WH 4lCX$AHBjRTv&7m=<0AtE6Y1dm VEmhnFPWCt@ o݆HAtBg68Ej@^mO` hғZjɰFtذ<@it88S@|˱ +ƫkI++櫾+X|Ɛd Y & ͍6, :bЃD^,fƂ~Ȏl (ɞ,ʮdU,H֬،,BwWah)e!ޔ͏,ԪD^%6-f+^("! BԖ-^"!DVmIWx-Q <ݮŅ`Д#4#ܭF$Yx+o@| P}jp-tgj67[a,w? 0 >O3N)?3tP`4c#ΏH>WGNl< .GNoX&$? ʰ*4z#,alя >*D405QC PMֈAơ%f0ul$(~DsJX &80RDpGLJ1";E1>30ys`Q-tEH¨TO U0X$7)1C!?-%eB!(b&7EK(rIrxaGAK5Pfx(xA %( ƅ$f1a*H2tLΔf42Mqs$&BLnn &(™M; y$Dg q۝߲PKk4B,E҈3\hǢz~5LW?~sF21==|n|Ka(9IV!eD'[k`-̮$#8g m Y>|%5A 0ynK6&zX` T!}_IZSl?:/y]aޡq:("F`L 4//)zy}x`_F z^EbJۓvLB`1+];߱#u}M'CC*2 |O&,ySG><QB I;܁hG]O{ثL+'7%/Z#D;gtHDυlX8Wqxa0_4s@^qkFA i"ޗQ>(rmRo[!e&sư QO X 0&T/(I~  6!s`}(ʐ!tFyw$AvC>FAp }yQrHl.Ӈ()U3Nj9HȘʸ،8Gb dc{]R8 1i1hy  $ÆX xnш P Ґ |} W & 02Ht 3&[24# T-Y`q".P4Y6y|jt h ]Ó>hcP0(F `/xP8b9dyhbjٖnpr9tI(lYxz|ٗ~9Π oPT"Ԡ 0Vx$q.^sǙA2) '4Z9uٚ9Yyٛ9YyjpX)" Xi" y"ҁ`f@`k3ߙ!&ٞ2oa1Gٟ:ZCpY8X;Y  kBƠAB: 5iu UE"Dų Pt3ᙹ2xgJVp?:Ej6kNs!5:-S=*o"J᠅\!1ik2G@аgp `4P б W&0 P '[ WőPjP  jR/0'HpQ0 '&CY0  pV aSi8`   Az yiX9hYy #"'  ` k Y'PS Z50 "ΐ? `с{2M!' (`' < ˽AfK۾ ;+[{KK|,|̛a Z"L`(\*|+,.-<0L2 a=,?><@LB\H|JLlMON{>A׾ 0n0ѐ=l"|K;i>@t] ˀ *[\0QnIm.0fp %e +Zc @ѵ7 j)TĠ+ b p [  AF 2s4@[b"KU[ ﰝapU@ K P @ >n 1G:`Q ="E sah 0Q!{JoM(Lӹ pJ }p1b{0@p4@z(žku>?NU㱁tzP f=Gs~! ف#N{P dg aH[ a1 +A P d= Gŀ|)1  `߱] |+q׿ >ֺ fp( ! 7pỺ ʿͼP PԅR=1bO"wqʯq} !y\ S+[=*] DPB >QāDa1JEQH%MDRJ-]S̘l޴ISN=}4 1HZ>UTU^IKVX~V,K"EtqXmݾWC8śW/E1bǽ Fxƍ+Y2H-UrfΝ=VX&hҥM7@ͧ][lڵOkLkٲ\pō E\tխ_/~!^x͇ŝ{ݿ_Cyt~,D0Ad;kfiB /0Ö,jMCG$ !#sD_1F4ke1Gwt͢<܍#@H#D2(d*olotl1ȀG.G>y4<~ EGv s:ӻy*z@Qb֤:*"_C Yc@@l$jj6t lT~ 4`qt8¡ g#8q c3!CmC6 ql8QmCa;pMtG!(Fһ@-"/0.ьb4cLj@aڟ.q8Ɓ5~$(2L@+) 2uUfPu#+4~.&>w8r#Z'OеXg]mR19~Zt?5B(Y^3Lq7g3VgBrưqSYf2]e2o4' T~b`?щZ6-qQP#Y@q@~p0ȇxXʱy9C l;ʃ`;db@AA`1ʡs;[;nq<9Q"t\{c@a,{99 s~p02h~Q~U8 AB+T!\1FPBaT kȃ&`Ƀ˓əBț?"ɝ<6d}ыR1daJD,aTjJE\CʥLbq+#01Q41(/2K".-0FD$ IKD i;!4a! C>{n>|ջ@~~Kiyb`t|#rAt7*͈2gqƬMMż>}TĬJ4̟~xp`!Ѥp$UixBr9C8 &`P81`R`dH<`@L!C]!O<H C%p ~3v)z -osк0J 17/K1*#3x k!eDyH:JrݟLӃ^C8ўʹd(#M>2!EӆmPxFMWSl8KӕYWG{TSǛ;bqM !BsqrHYK9D pp?HuD`:0 S0LT8TmkPQ~IH><ɤNOI: H~G0\Rx #*IK;8PWX P-F`H ,\aIU1dL\!J2,EzDŞok"5_K& u0K2"%}u">lMa?:?;_`0g4lp+5ƒB4,jjc' Hȅ0MGI[GY_Xpd5Suؼ}^^#|Yq YR2R-CIH*\]݁(+FR1I8q#F X3--07ȃO(^"LCePY[` ֓ _p0ˁhGK~fΓ&㕼㽚4e 5 qR>Ne dP!T W-y۩Z$TމԤ5"Jb EՔFn*΃(`zzH $;;TdkPh`U0X^_ 1zch裮>jzDncvˣ@dHp h0:-M0D*AxZ؅^ /y= HhsAi&pM'(@U ,7ڢCp;7ŋx0i8 $m?!R0 %R!~ 2GW KPʄ8@6iFn0Zb."7z_0H`5hIHxYlᆠV #؄,GIGxxQ,(XwpcX@Ђi ucdINfX4lSe A`0G/>Wq$ 0m8F:J#\JSbpXgH! _!'ppԞ qJe J?"-NJx% qH1~ܔSg6Zb.:~S3Gs0Z85@E9Ut8_Dg#;I01xD)=ӈrztG7FGuFWnJgV Pp]shU ֝&ԷGROSRtWGdVHcx_ЅZO 7>YxpnuGZ0܇܃́Ȇg0eI !/Cp+l^@bB7RM6xxx ExAx[jG`4ǁ #kv qyss0Iw#Gw w7wyH0+7b9giHz(USexG A;wЮVV$[FK0myPx2{`F =)٭ۡsmxX}4{aqxR4tt>q`DPdURICPlc1ɠDJ3 OׁgxvӞЇt"hh7{}.!|gx?|8y#ĝjYȏʏG%_+}C; !HSoJm „ .,!Ĉ'Rh"ƌ7rQbWb$ʔOe%:w^F6.6lҥo`*_?bǒ-k,ڴj(+@ɵr;"m:x΀X;cs.PSk&5S5=Kc`3s3KˤhǍ*0](P`>{Ŗۡs(Ρl%h\Q/mk҆4/o38PX`#Y8-I$iJ?CA-DACK-Lx#(]X'f?aMNg~NvHS>$8(zjE@9qEPÂզaAFD6iM>䓏uCM:u&P ?|mu qEScF+[O8Iڤ[9t(s)<Fs+(W޸q@\X!7Ï, FI.8D8! گ&CkĎ|$$Yk"- Ĺ <BɼOD?VAx&Kp5q7pRRD)[rDq+{jad+ AAQP!,˺]R !C$1"5ɛS't8Ҩln"H2QoP0{F0+M#(I|?Z[H-1x|iPt6l–1md#xLGះd3Xi5f C8㘅bk_F zH"F>[ iL}(GVf@lA+wq\?)V׿>Η<g8L•HF _Vlɖ(zSTXj`XZ z^? @tZ|́fFCB 8?C8< :$F:48H< 8y\i`ah CH!V8EX!BN6윩ayC .boK8?$a8 DCޡ? <%6FI`!-nGXɡd(Z2E<Π ĖCs|C#Ġ*]e<|5C@8>Cl0@,?;5Bݟ6r#ED2, l @ X;8AB@B>d0>2AA8~,$tRfC<5CD5̃2 6L'B> C+TBPV`g  XeE\xEC?56C+8@-HXCHQ\0lC3p7! B 8&<8HC #dA0-@@)C>:,&t,|:H$> <'A,2HAD@\4<pB D%Uۖb X )x@hC&c1< *,8x'4Gڰ7p'tf/Āep*$2"Ȃ, 2\jD8 2ȃx@txR!C3<D+8@x$@l;8B%KCmL4F8tZrr5@JkVOl<SN,D5|6A ݂bY# +؈::`5ڈ5Xæ0XiWf? ACL Ŧ? !kÒ56Ȃ>ăeT]R˱̞4jv% CIr tG:ƒY4W=Qoq MARQؔﶉ%}Ӑ2;*֭nĒ8Ή.`\?c%&8xM뭌ِ> 8&Jq`PxJ }*7RmyJB I1q|ZABڰ|Z)aQzgְYO(ʵ2B0Fճ'7& 9PRZ[QauJiV` b!9^^%2 y1of90#0AleEFKĵ+]fHUmJtk[!+G:g<.h%6G1"٧O=$P&MpnKkCwB:Qf-n0kS$}}z/T|5"6&qM~(84Gˎx$}wb0oH C xqKX&c"x( #km `8Oz Dsp]ԩnKZ?;?vG} lBnQ#ظ[; 8ɈڸsG\fS lC2:ekU5,S_lsew>A%c?KO{1 } B1 ec E_' i 8 X#+ y8c|RZ2D2!xς~ :BEEXDd0SDhb:b| x0TԆw6C!̣Ͳ #CX4!QT!&URtVH$Ea#w`5GXI 6(EzD>8P{La" B* ?c=x  -}* ~>$8 Pr,QhӔ4XBaRBBpFh-GE , !ƈ ʢm)Ax3;ш 4 RlE`X!L8fA5P e*HaQJ/[MY02703,maã~X|y~ 2(EKB=D]F}HJLNPR=T]V}XZ\]"P Aՙr Pf=)DEf 0 /iˠ~ z )7=}ا;+DN ٬r#ک2y{۲ړ\ۨB۸m*  ۻ} B?K~]ܣBd{;@Ih8yoCYX ֐ݵ٠( ?aQDm!8% dA!u  $A3:s=ZjA a v %m0F6.3 WOCI>)&>0IC P69n ! )PP;P$ 679VC>Aq0 W] א @ I@)k%T ;a9\`p cTp a qA_b Ë 0ݼs}BDV1% AGߑP 0}p&P ` ?=V2 )CI L s  p 1pU678 Ƞ 09P>T>v3Cų `%$)Z0 Ӏ b ;1 ֟^Q @خp$m' a  ,'Ă ,`(R&Ljb pp 6XI-]SL5męSN=}t ZiC% -ƁƆedBHPj4AEVZ5 okM*VUiCRw N pH-au[ PAYצQVhҥMFZuf LVpo=0)eO"3Ndrjl/_m '߬A_]v KUb=8`63譂lpE/ȸ*e.(:--z)(0C 7CeOXf*+DC :'b 8bd&O R FDR5gX FkHyL\nc"3.I  =a" ``eQp.&!@ dFUnOG=)igU"\j"bV*ݥe]xci&efbifZ8sշ m,}gЇ >X/Njm`fq'.%QA;Z .8 Ř6az4A 85 2x(! .pqX/ 0 [†pEv [ 9Eu^x+l vD^2 .ta\tЊj`&H8AHZA ]< XE4Q.x4:0H2xq XTx}"Ƃ‘+VҒ[l%*'gL2("l5ʳƓKx XRhe.u9җe0`0Lf6ә/QLf6MnvӛP0MrӜJ*ԹNuӝlY!Ug>O~Ğh@Z0P8@P6ԡ.VԢhF5QvԣiHE:R^*%EiJUo"xI/ RT,iNuӤa7-)bRըGE _AYFAϜ@5WjV 21(&bbdjZպ֤Bfh(*Aԉ&j P5l() XfGkAj+p5Hb!;BtMlf%$> RE$A HfZնU3C0 yI(t o(H^Q ȺVv TYk\檔 U(EPXd dL@ 8/ubX6W0ozYJC RCr*b DfwoEʆ"r#lkWh`p%DJL@ Wak8br29 lP$ QP\b}6v<CЇ"P &x6b8& Wr9kWz8_#H12mp VE-peW"3g>ku-1Q`B%™,QR)Ϗtg`OLҗtEPlǔ૦E=jR14)Aկ5OZXַp|梚vykaؙn+jq,~4 ;hW%Fյm=nrkv(.~rY6 Bw+BZptxKmcYGFot+0C" x5!w7>riA;J/w&peyq ټ@O#LGG:.'N';_Gt0p5!w='ϛo )׽vء -ҁ/c{cdzA]Ӊ(ԘG(9c%!`ۉ'ſZh pǛ6\g"8kX6.Jc])#KVC[dl }@<($~?~0wf&uJ x TL~e6'Xsܩ !1V"B>mh `Đ1@ K@n$({) k*<$ù*;dQTn ܳ+3'`Rk'L!8485RyȅZjRp!"3*"?4t7t \@8:l30;C ?‰98"`R6@TD 8+3,\J3)\:"X6K6P4@L4okStED!\8~J|[9<<4I,[`9LTC> Oe|Gd(EfF+Ɗ;Ƃ`jFÙ9;Zs|UCttG{|Dss{{ b@HV$7]\GNE`ȃ46Ath oSFHh}<9{$'ߋȌ즊ŅT@_FnJȒ&Yt*Ἀi%qPˆ؇k~`e݇E:LzDD/J϶KK4IX(( Mm\KIQpϭ{KҐQϗ#̭cdL 'P=  pPPP[HlH#UO-IQ t(qbg_ِNP5ݺBdEы0ӆ |ԛHE]JCE- 50TpUxF T@Üʫ, l lP ͆lZņ^^mhRwhv`vp#9)eqhRG JH L3ON=PuMdPWpLZT ȺWzBt PغPt u]pWM3ÿ́OdaG`-@K"; Wsؑ$WsXPN3Y+QP%<.ckpYMXTUW1XQhwyՄ٘YQPQ3K;K(Z.MtOڂکɩڮڂZMګɫumٸ};ZUZY[[IQX4Qu]E]W]T]Wp۷ۻLXZW̭[m\s\q+ ] ܼ}eYҍ\yOxŝ\ MP`P{eZޕ]3](ՕYx.`+J iPlPNC,WB-iR^Q@SWJSx_M@0/12/4@0q{u׀ YHL -׷+ ^QHk;;PW-|}MaXqX]WQ`aWDd؏AP( ޏ_ 6aWٕm.⛝^xY/`!n\jOغQXQW7r9L!5X*Ws*.WC~c=d0u{%;{L3]QgXUipN\PeZQXg3^O^_-]W[\\iݺ^lr%fņde[6Nm\M! \U^^]Um\=fj{-uXtkfy6[iHQKz|Pցhs`|NhhXhs0uhh{6肌6`2.6n6h1肑&N1+ETTgPP@3gTxhȠXSHa@W~53XLT v Dm7;k%F@`3aӒXUP͆0ERq0KO!Ԃ0OIk/jkK"Ie|k8Tm@lI ca>l$l&Ǟ Nk%kV%RS-ՙPUJn./X֞1i`~e5@de0vPndiI}臙15H}I|*׿]d=jȃ^oԀIoI`6qІ"PK=PPwp)eq 7Չ2̺UmUD[(%%'qd0p$UT.m@yq/!ndUV nfV#2&`f`0x1`)/)<}yy00ׇyHP/R//,_/ gy`IQr) m7 H$Ը|qnlńH #|K`@y7P<j0VtotJOuJIJ^XLVVϑ,,mHg"Ǟ QddWi'vhm0PewfdoEkDqlIwdvwvidĆsO 7u7Ug@#Oxi /r(.&y0 denFnwhPfyVe-n^wxxҢ7W_yL닷B_3͓8JN~Fx YH6e_ j8ȳ8%Ml-X3!v Ym#5Ə>9$DTEdt4_m֎RPBٔRNeL5le %6*Y62uLGYMJSAdI՝}'YWxєMfRʸTM4@?މ)z)JƔ2v&P䍳 6¨ML<8a|s8#J(+|b5QXo!JJzfV,.Q3)]{/vgר\oݙ@k~i=zE)M><I2(aV0tB0 6XtKB3ș&8ASo~S+!R ͐90G4p@F͙?$A q r&ؐMș_Aa#M +>)P957oL2*~1#T&uCF/LqF(G10Ab1p,PdvmK,8if?h#hB"4gئ]ZhbSXdpU3LO`tBG`^ub,C:OR\c*ar3d׳M+_4A<5n#b=L0byjTU'LSSNdғ5].6Ib&)Kgfƞֱ>c?Y"5a$]0NU-R 23+2$k",?0 0qu? ICY3m7Ό8+32Fu{jUX:ud. g:bY3%5Q9٩OTaʒ6wmٌ8Ǜ!-_,Iӯ)iN g@jm߬ߨV)"2R3\&1i;~8"(Yg` `ɜ ?F|(Ơ:rQ[t֦v щ ^*2Ңt؆ ?ϰL5l5XZC0S }6 #!R !`2!*-RASKJ(`y!"ޞ`F.4)V } XlHF<<)"L8+",΢,"-bʼna"6F4}dƈ_1>\a2d΁1N#5]ZhO!%zK3c'(C)L{+#xYgH#j_#f`ZTc/]2RJJ5G:Їd&8Kh;`4EҤP ȏ045xGA,h?Cq?@RȀB%?$$,FI%IPFJjJG&EΤH[桐I -dTe^&  iԔ`l:|Hq?h&,3<妤݇KƌRDAt֞H-iQxg vhX&ɣf]>XC<ۀBZC1xGqf,'V>W88:eVh&*0%IN)JďRCu(hLLRI`8H@C *Ɔ%c%\ Ѡn)# Rf@ &*y fm,([}r*j1/)@6iD.F. J2ʬ6 ᚆƺҘLJ.[ 2VA/όϯf֮..${H6j$?b /&olmh&}W6*h,@RLpv~$RЂ>4~б̭x(ǚLW2 $z/#zoBHEƐ/ fo[8/O0/m PQ:8,S;M n ./g,\X 89֩l1 0RJ-| b\z07qo14kRAe(0.LRXC$R"]l z(ױo~ 8¤ehp3Ev{o1$+,\ߢ1fG XcAi('{r$2+K$1nidҩ쥇Z+/S@YgVӝ//33-`is265_36g jR4f393$f$exW#3<3h3ּj胗M;˳?3f@0FNY&j?O#%`d?+ոmn,CWi~&#@*(EDgRPE+fQj@fԊH$0<BI f-0 k8in#fNWk LIĦFѾ-UVCOc3ClBS"g?5׽%}[,4" V+n1jX 6 LQOO_0$}r>*L''[ȃD5jK $uRh5kAR8Œ_76kvB(E6CPЁhs). f̀z%tn^Jr4(cfJб0`C:L^7ZY+E.VR B1BQ+Ç*UB>BA% {Wk&g8-k*r+A^=vx`n@pB8BOm8{JxRhH8]$@%(E1,⸒/9ږqi<><JSk39W"wƇ),C9-Y/X8 BX@9ysϷx`,냏yĄ/:,E7:&8OO~S:P̓j:OA?#ka_i @%8CfC#úFD/@h8z$e&?poyÈ;vEsA^gkJ3O~gbWSnoFow緀N#~>-%C~>bo3>ψM~M7DӻU9M0a)z鞾N>Ma{C j(~>fy[Ed>a|hMk@o_7Np!F8bE_AbGA9dI'=1Hd".](aƔ9fM7qԹgO?*1qK o0}ֶ,u ۿ 1W84`۶*k 6m-Ì;נZ'Wysݮڷ,8Y$3B Xa3x}:pY>'H8/ Ā-5$h`*q˷B: .P 9AIgǓ*"$yQ3oPYbkb X.H ^%&$YƔѧ0R b̉x2 8 Yj2TS9;%y%0n":$lLqńZ1Ly1OCiR.0V,(%#o<1~Y%mz1(PwpwV W<0kbmggt :̚5E'O"l%Vă_Q7y'[d Lf` xG>nHR dc=uh9+.0&ZQNYe$'tXZJhk1Y`dBVf^ CFOXXM@05 85 0` xWNAZerd\53m&CS&LG`QmĆi6{D 0jALؤ%R9PRR%Pbdy5v^q,s z`hLY}Cx':q80778! E), =|@8ࠀT@@#x# Vx=z aC'(yR@&zRz:R a,:(0V6W$LPP `@Ea '$Ge!H;hH$4!IC%DD)[? `D0p0:3 xD Ő"Z@,PU\# ( (k$8AVяp5@4~H"%5MDđE?` lHcD(Foģ!mqdR3Hq ?i!G8d}2(Q6T%}IQR91 58ʔ #D <͆fh$[k4<% !H?ԉxDrxR$ u(RT=02e5YWPkEa)7]a4_ɜaAĢĆ(g>عnu!c!Y慭Hkrm̮gk>{d[hVuwe;YMomq[JHz3n\^*mf$" A&#ӌ!-Buv*r"J*1 iR$q)++)e -#)t.r/d 2///!,S `QN\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0c(JHP ɳϟ@ JѣH*]1ΎJJիXjʵW<-I(@ԯhӪ]˶۷p^4HDr˷߿ KV_ ^̸ǐ#KJxRIE5M̹ϠCǵL28E^ͺװ=M۸s랈 Nȓ+_μdrNY[xËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0KN4o4s8[ts 0gj{LK3_ 9|npS2)>Loޙ$a}{A?n6dsy*`:SԇQ:)0[JXHE*"  <2b/GG8CoˀDlh} CQx: ߐ&>=ȋ[ma|蕑GK+GhcިLjcLL+|qGE:t$%BJrRPPsTP 0ģjaJt&%SAgtllc!6Qg"e:K+`  InՏ$_5IXT$r'gIZe֊ !Q6 wjFCΝIN,EKlH:khKQW5[.D#lh'3,8~(Fml1EgxJ[O(Є&fP|lrBw.sQ\DDݮA]4N @(+VTBҸO-n[^ﮗ m 0"'P8Bqf_^̠KX"Ȇ'A"J^b1q1\$ڭnw􍃐q{JFȍsF)z&OQԠ(5\(E`eRK.Ȕ\0cr'9cvsɘem.5ybF5l dEeyu8 Oz?y!y2&lԢܦkO?$ԣ4|ꂌ:4kRԩN5@G!uk-\;$8B7!N~Gd9d@h/qDX2CFx0 C"b^P(05XWr?`Zڠ0aPRW\=(B@$XxdžRх$cygR) u"u؆ Q q"bm,. G!Ep\$,BH 5}B!z#zb70F= BP ,˨8y t2 H`(=x!$ Ǎ &u!o(!4c Dr9yPAư| L' A`! ɐ2 S~0@ .g7kd>ZX p/w =6i*4'ި*-VK@Bt" AD0Plyx.} (F@Ldw G< i/M(,w.`dI}X,@`@I x-9!1҅ވ촗'aR)@:88™&5ZMq"I#Xӂ%a!?9-YP`Ex9"n M B`U + p!n*3󉿱83Ҝ?de 9"!!ؐi$ pJ8"pj,9 Ac ,(-p[9òJ!ې #,)@='N ۠:Ѐ+JJњ a}82`*/S:YQYHFj-bZ_-ejTɧL oⲧڇucw2Z0 j &E.hCiP7vBk<8#`9碨PwBrdmO rQeuc ?{sФʠfcx]8aKЦa _x. 5:Az. .#`9p4L/b}+, s يN0\S ] ].NW 9`#Aܷ@ N^ €^ I|s"R]@1f* =Y.l) 7 ~N 2S-1 P.Par a T|7 n5 P L"Ѓ Ȯa !q!Qo-P&0 ^ ޾ ڎ _5E r4P!, q 0j(~ Q 1P +@e+/_rxPYRv )ay6ⲁ:FDRJ-]SL5mXl|H m@ -U|l`-Y|T lR}<.h'l1N F404}X`… FXkRf /5j~k0h+6kv.[D;u.NO .i -С>Kw^nur͝(Jxreg[7%xͺs @KV_}pW/iݎ o x-^ 69 'B /0C 7(ho $9D1EWfb%|EFo1GwG2H!ƾN$2I%dI'2J)TX2K-(_y%0L3 SL5dM7߄3N9[oN;3O=OnkH3Ȍ7 =4CeTDuQH'}RI-4SJ/TSL5R?G%TSOݓ !P5VzVcuV[aUV\wյZy\%0BPeYg6ZiZk6[m[o7\q%\sE7]u5Md7^y祷^ S ]{_IUHqT8afQ""TVBa7cf+qh,VHA Q8T\fg>`O9g] ŕfB̞*PdTV^ygWeZB%#(:$$ɚfNmS6*0A@~ߥ:G|&*.{H`#M"=((TyLMޯ&tWw) ˞""WwIQ>;XpWC}xUD胉7*i<$Lq W܉o~ 5uAA}}WŒ0C@U U>V&(ꛟ>ɽ/l[< X l be+AЅҪECPa53Cܥ-n HpMGPI/ɄJf9O,D.vыݶgDcGpjc'JX%Mc.1#9HBJIDd"HF6ґd$%9IJVҒd&5INvғe(E9JRҔDe*UJVҕe,e9KZҖe.uK^җf09LbS< mә7џ)%yCx4^%x6y 8չ<Ri3MSs$[I:WD%@U70tD ]@"贞( (`%FQv "6`(idE{FMOWeRcT1(!p*[Zymse*̀FZ"2T2dAVSM vċtk ^ 1};\׽o|;_׾o~_׿p<`Fp`7X`+h`V ?4pY) , IG:DSXƒX|&ڻ^&k _A!|pd"8峿;^< PXB>yg1ϼ~"ӄs:9DÜ£=sy`ۇ~P@ӝl@<ջ=&?Q㿋=Qp A+AQ BB+B!\Aq)lAA8pD#IRPQ0y dyb<#D@CP7C{ÕYB!l#(<,=lۓͣA#6C8&CB|BB DCD|E&DC9$<:kj KEg  Q"#[R('RHPhaFXRLYl=\E^AQDFpE;tqFt>MOElR$Td W]G@ G!FY8z@qOXG\ rFj^|OtpGLAZeFm'@pL8P`A0((@s4)}O M7-Rs{ҌKA7=7'5T?R(6sKG6D[TtF}tUNFDcRx{́UP~KUE MܼRQMU3յK4¨SsW7MTk)T5؆q@|T[mh%3~~<kV~ }~ 3eUʈ }ei x A=UzjTFEG3Y54̓5$O5f _BXP9@q -m+uֈ8X$WVWUF=YuOr+՗`X ؕԖ 6? XٙHYsY55qІdmqP~k ZگVZM]Eم%xZPwhv[wv۸5imxg|Ժ%XƍVG6K؝-Ӳ^_(b@C\T5YǝfTܿIT٭R>]\YOA]]5]ӭ=]=]EU^\P}^W=E-^^YG_Qy q ۰__k_o5c;6mV=yk,//./6h0piPm@-uZ[m\GT]Vi^N (xZp @]٣}\Ǖ~]a_$N[}] 7&^'F j}-q0$naaS-^G[cd#7_:Z==fc> _!cyv `F GndFIDn1 1MOPeOe2Ȁ-}`} `Hxepap}'巳e(ԝP td(b׳-۾Y]mY(8%Tml_=ڶY@e`9>9 v&wVgP=Zm`f-O.6h.HdDP vF lyppe}mqqUY|_YӭnNj8IlY8``/fKE꣎.v r6ceņt#XV -''؆wXk5WPhu뺕뻶w01 v. &6v`O4k|xxls2ɾ˞,.ҭgM~F0g}%^bes(]Kفh&jp~0dxl"gHxdN-j׬hx4VIj @헰iijdH`lPlolP]݇#=S^mVm0 e0䉎۫WdgX䁀dDeЇ|`uwq4hN3_xxϦ>W^jv\njjm.\M m Np&[txpgixyV8s7/(6Hm@65i9sV@Almxw0(lqXlJPD^?g6Fd2hNvpgeh\O :I r:+k[e`HV0.'6qƘv.XZpPvAR~5gNč|?*?p-i6'm&M?sf&e6wҞAWgxA/qnP.k0`~t0'4/y4Xy_uȋQkcuЪk] yIvbP^'[Ø_?@e]4f.hb 'aa=~$߁6ٓnE{o{x}dGkd[ckF u[{U~`pÏ3/R:W^ֹjͿj:17~oxop<,}mqHzx]7ͭ /'pa@@nf%a[=Wtf{f6P g`06`M1hwNNlu{vXuv $(0„) B~Qh"ƌ7r<~ mܼK$?fҙœ:s8:n(ҤJ2EJq:N}jԝD-]:(,ڴjײm-ܸrҭk.޼b7_K_DNiPF31S`;Y2g[W[C vU`:;_ 0m۸k7ċ7.8gKOIqRШ6\,^5uacKIA Na?,gBڈN8)`I?T}QODO DFxQV8x#9#=ggTz?%dT6I؆Ic}u]]Yُw i8#L(FN&_t;;ڞgk)(BM3IDESiijCbN Piψ .6jZXSN:9dBc*hDT~HUa:"D""d .hP9BQɣ΄TxaV5"BXM8EZ8QPCs^?]9/{/*B8Q76dѶ<ũt< 3J9m#6~xlol0>5b3R6Ŝ-;Q81r)V[,U+愌4\ F5NQ3& j@y<=W;XS;S4,7}P49ոJTELmipDu?`=j~Zk{zeŞaiZ&4r9y:#gbrѺ|9Mv֖"Jus[%:k[PܧE[W6$B '\{>#ȇn`[xm-RP.!p'D8dhQ\n&x&<p ЂkP}X> 006D<x/)!(r!%-=̃riQGIb ˨5Q.%NF47oc^\J- }J!I% L%!B&QO4M:U)KRIYh4&za%2LzHEBFgL!1 qiL!*x\CzyI2U$g'#0+aIKh#*'@*о@x裡CH>ш@T9љYg;sziGIzΰcڀIsӝ/'^q9#xB/r%Ar*Tqa}N, K*.6"[SU,3 E 5~Q"Q*Q.uB&wqP#=T⯼ObY-=e̦a (h u`;s2%ŶN3oKXZg6FC>&쏔Ƿ.v,F1asЍz}K0~bt|[F".0!K^p(1~wCOg1$V>1/;@-P;sE:J_(0z_] LjƆuŒ-37!@5h+|q ]E!{Ѣ[GE(ʂKy^ZmJ\Im'丨fw !zt<)D1焺}CsbSmڌ JzA)QC4K^aUʚ{amZDu d pƑ~# x/=Ags.q&;n8UC%B4!i|LO`u.a1J3 "|Q5wP~ҘV, s.HH7ka h& )H!JjyuǕُ|yD,R*BP;Ǽ>_nbӂxN? Q -.O S YVN``T_! |nmG:1bn;O]REG[*d5;/xI AreΤuh/o듎kVanc;CM?Nj0lc8$ދ. @nW{F:^EY ( >`_o  Eghv:/H`lQ'\a}  +BM_ ` mmZ1 ! 2EH]6RD d6 }_X) bZ*X&.[ L[GlE:A)b*)n,΢whl(X)()E-"0*ͅX0TV `-ŧdN8\H3f6f! @t"l#:#րxc&!\:#>a0<60]>$B;j]^C6L Y^xI7ApdB`@Z1E$$/,@"fA MCFI\wY)@1X MqC70G_R[$[|C2$D2ٔ~xӡM))\52)E%Dj\t@-Lj\\͠B*š£EB4hF=M*K^p訮Zl*B$IL?IxFB å֪*Dd\(߰)J䥳4p3ll[fkZ@;.?t-Cj_B"ԅ+E1giEAP3`)lZ r֫?H?LC?88%(̧N—Y~@*,e),^L0(:@I?7*0GqR%,,oV%>R6;L2X5OB4/3a3Ʃ,rf`NTf> 0T?|C|0l2+3B؀̀6+@8XL4  YT0tB !DCF@%\@*nT< :lDA0C*C> L*7؀p5B AD4XHPC2DC'tBl0D70l40H @3 0A-5 A 0>L;0n]$$0<4LĀ,$7pb 3s)+nan3@ U$;00A,8 #?4,*tB*$4,$C8XC3HC!|H'|7*@L5<3$CboAӪ# )16w`hZ`B`u+!7I$}Sx@x vyTt8 h3:HBuA6p>07D?t.BBy*Z@D@)0T@@,$@Bz`6|6D ԁ6Gɏ$*:-&%1XC,PCbO,`?\cEzB@pC0(ͮB3B72C,89@"4h5pM+27X/(A ;$A69 @5l9BLC@)D+&\&X@-, $$_;B>t,@8Z3:8C<6w40 0!d/m>0u+@!E#@'C] X$TD,C6`C02}iB++BQD?L84`2T4&sl~CX8CBc8 57˃?LɃ5T sC1PǃI9)x/>z''#CbD^Wd0X!a!Yql*_B3GC PC8\ҭCGcC[ @7 6t/bEҥc(.‡i(pC`? qԹgO?:hQGhW+@.OF:jUWfպkW_R]@thI+zdbEO+R@xmpaÇ0VX.]!Gx񓷍'ON#cʡG>zuZ?U˧K}{}^~}׿ P ,LPl!P ) 1P 9A QI,QLQYlaQiqQy R!,#LR%l'r0bH!DR-p 4Jʹ,3s#fk*̮(lfq*J& aȠЇ!uԙ/4)R $J"fa~I&H|HB'mWO&pq *5~8&ѸtcM+abي OdaX@ )HhNDwMւPiQ:"ȆE]eh|r `^ahRv`>e*z'ޏAF3T"R[ש)""k4zI2HX't`ț$ Yꩉ @$9*R%Z,R!eI"b H@&Nzh| yF3$ahD C/!|z(4e藈bX`^i `oڇ͜HbܱȚ*@O**V%/IܢiZ7'pXc@'`I&#ga"HN-h1DQ*2ZE>5tn b-`SprXd^8)C" 1"RMDX 9W\.Cb1 3 q&c,9i` %_Đ. xf (+E7b]!Љ=|+[p7h8 ?J@rB"G IM*ȎE e0:Y_aCQ٠62l(j LR!^̸ǐ#Dk`P$k̹ϠCMӨ~ WKc˞Mm@ N\j_μ3)NسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$O(gtr,Sr0?r4+4s8ߌ3:w$0?p:#c""# uROrVu%õsc& A،cmvښC3L;PO?ClET8 M '2gix^ğhEM#$<[ςdKg H4'oGҳz !H5)JRҎZjS4i(%*lhD!VR$(@QgHD7E> ntsOdFWe=kFokVպկ6+o djSaѕ-=eEtV H*^px58֕.pK\BsgA׻ӕ-51\~7^y!"6j_fں*Wg :to:KS]s_FZbq{ qaoQőum+pqqz*ſun{*Ϫ,xvQQ +rS2 c8~Ț]/ewM@ABGODP`У~hv.e"Pt{a"n#Ŏ¡fFec9r?1 eϣ>R55Be)TPAD. ۫'W$Hбl.MltU;B& 6c;X(tܮk/hrǙ801mGWȼ>]CF*VSX[@eTj6?KhgJq G tp -̪Em?PZ;昛(`ϗ b;@@$ yo[ 'ҁdNTPU kF-|hODAߎ/(@J2#XG8`BA9҂$PR / BA5-+>D#L A}GA;VL:/ !H8bٛȂ ܎c[^;R i~#blqK#U]ܿD Ιt GʁUo$!@ ƴpb{2( '3g0,.4V 2~Ax wo? +,xz `-H1zGuUS?-RǦn|`z@5.kG98傁WnH.}hPgy.=Lq a8{r kI  QW-YF1uV6w,9x6X*Y({x.Y؊x(arh#aȋqoci,(k}h4o,XfPo$ ots"% X& H&,Ոd,8`mQ@#3zB!q Bp!h@=/oP>Y,=af#Y* f6H3+ Q ;I ,&Vk3 % 4o,skQPmf?:R$aT jYDsw,AhDnlو H{¢ kK&-u h e3؀+I;I- -e82YΒq+Y`=V-Y`(h>09,@)^D A7G- 5`@9 /i4y'f_d yS6_- 4cԜ1 ?Cel.i4$X4PktwwҡǢbi-*:6Z-2R<o$8j5MVFzG4 ";j57@VZXz'O!>5HZf 9R?ڦnpn{ 1(йAvt` QiE 6 XQ  sb:8)Zƚ&J:Zz蚮꺮ڮ:ZzFsR꯯r ~0  +G꙰;[{۱ $խ"%$I&{s@@unngQ4r @=r,#!@ qaz qLk!C#L Ps< X W"tDCGJ] ԣ c0DNS<9О 1Jf6 d?"9 Q, LT{  u 3` V4`s6BhK Q@+1 RA|aa P4HV4@ QR˽+G`@k[U p: 8gPY{" A{}tJ NA *P^P Vu" 8 [^ 0HhZ@?F< 4"0:SmbR`A8D=ٺ4X<#Ea:[vsqox(x-L"&ћBȉ<ɔ\ɖ|ɘɚɜɞɠʢ<ʤ\ʦ|ʨʪ$Ԁ @ rB˲ 'Qwp2L˾"p Y *fʼ<\|؜ڼ<\|!``aѻ@ $" P* @ '@R GͰ/J0 yT  ˠ1POQ &! `U+%5e $29Ӑm'a MDK o  O K ]@0?S *@~ Đa;-qnV@$A1)"  H@@WP] l0 Y Y q/ q } k  1 q (! Sa?P2yԇPп'  4` Ƞk qWKYIek;NwJ0` !i /q m@ 7 a-t"@ ""} 6`/0ҫ f`@Ёn@, aQP !'@MX]Sл PN `[dQձ8 ap?',!` I(Ak`  R!Pcp-;'P00a  d. W&NL1 ^W@ ð !kCF  nPݐHn|`Мk| K 1  °6m&ŀ"m?<}֌ 1 Ȱ *i N|@m@p!ؠslӠS !00 f  ~0! Vy H ,]`$-3 FeTc pڴ P q]P 0 > "@?liVMz } Z a į @ @ . o[ 1OPtu p @Aa Rr ,@ DXhE/UQF=~RH%MDRJ-]SL5męS'Igi2ÁETRM>UTU W]WVXe͞EVZ*W\uśWȮ@X`… ^ 3;nȓ-W Y3͗ 6ђK}Zuj֦[vղk~}[ԓp.7%@̗hytӭ;.={ˋ{^<7Ϸ^k_<"r0@$@D0AdA0B 'B /0C 7C?镎NDOD1 UIEE_1F$W*"RT!qF2H!eB U>eH%dI'"QF9QҠ[ @O$S,3M5rE,qV QB KQ,K%ȓ,Z֓3xĉew 1D"(6Cd̍}&Z]SjD` ;<$\vE +9Fh&k%Wjs(HX$"ȒzȐxDP:.ģ'|V;O(2HăQy xx״ge秧zdR\{JS'(Z4&T \h|kcJ&D_Y R [Ђ_hAk"TB~\`5"+.~5BX@PA ЅN X [@PP?D'"|a"Q85>(8ŗ̐%3I0@ pF8F2hA CPN \Žec92C 8@( (/"r =6ґg >*2A2 #E)E t @.X9%8q N <|+GK!?$Ӹ?JRCFACdđqa KnwAf(Y`P/@g:չtDLFA @$2a(` MӠEhBP6ԡhD#MjE338D:Rt 8R$AN':"(aP0EQ2T'L!.5 f͖5!Ң Uzַm;L-Su'嗥I,p5ٺAZpH).Slk@ 0x#2j RC)Au} hEЌ` RI {`7C8.lh{';ײ*$_0۽ `"pnpj|0*b w Vk>y nV:0VUx@8$:d$bg@ɯD#RA)h 뚿[pU@%_(y8(o v0a!4h0?7 UCX-bwl@d:D5?DtTG3%d<(d@z\DiDG<22 s@=Ȩ髒/7 +VC(Nt ? Ih&$Zp% x;@Ë$`:eN+oXN =[35ʨʩʪʫʬʭ9eTFeUMyc3-" R8dYM>[6J:N dL>i I2ehej5aeWeHcifh&ofg&)HQ>YZn{Hf2dDf {6.Z.f(hVfh hhbvhhh~ieq&3jK v藮znn&  v Qx&\R-ZMqjPMj 01鱡>seӂ  Qآ-Q)yn h땰罖 y뗐lɣ>ij=:&Ni^_NdAζiðpcQ~ftLرӖk.l.ggu.l&甎4녒n1j^6V 1k=~fn En֮z>NQo<~r^?lVfXf.fnUm}PHypZ@q~z҉iNv`~lymqy&q0qyq@r.qpP$G(r-q-[g&/!ﱐk~p7S~86 #gmb2an#hq!q8qr:gІmxh<tAr_{rH& xb Ȑp*1`t8tqx#T' 2ZssڮtS.N j^/:Od߇mh0vG IRFyz҆gfXj03gM>lT/x0iPnn?TwunJЇypk| G hi0w-s|/ f9䐇k0qaʨD 0 .y/. YҖwx4a6pd-5g #dl wm`&ٖr9/zПdGt w{א1'6HQL|g}78;جUmXzY~'|z/1 fyͷ`0P_OIdv'~ G 'ׇ2/G wpv7,weゐCGzp{O{ ,6Xeh „ )l!Ĉ'Rh"ƌ7rqܸ.Ip_gҬi&΋%e X΋X>x$m#)ԨRRjաZz!=('bǒ-k)HN#)@lI9DBN9bI=g93@ctt®~;nQ8+8 @ ^cKHh&qQ=!aPV_$J?p0D\`ʐk̡1y0ȼGf?(!@!3Ȋ. |`F &0,t r@j,&Z>!9'w|! ֏3H-1eK6k4ADrCa(l"q*Im  4޹VbD 3ASeD)F x3 +2Xi QZ?Bx@"o+baʌptR?ƈAHjbxZ\"|QTQ!dD##ƒ;`u+05팢tf!R A%bgf ^Pˎ@m<\V>DN FKf5U47IDi'n`I )d(7ЋJ˞ D(TU*䀋ࣩz>#&HUVFc)ZUqlR @A($7xT x `^k%< hs~$!99(/FJy60@\yy)pCl4#>ʊc}N.tt+}0&AU7DԶ4jVӺE_M#Y־~ISƦsKc3epR_O2\ MOE35.ژGX)L LZqv@D1Q<ԇKC"khN*X@tAb(@aERDuDĄ>_(d(hUQ> R J@!,Hpਂ*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲeGR$aI͛8sɳϟ@ :੏>L% ѧPJJիXjhGQ,(vٳhӪ]˶۷p5*Qx˷߿ LÈ+^$@s? ˘3kYAlԹӨS^Qd'u۸sQPJy N}5̄УKX[ سk&ËO^_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8|X:  M =:J3 rRMu@_}?XOZg:_{v5jsnO?ww\:wwO3[@7R^yh? 8_[J>NpO?xʼnc^噗J򹃪Ofs?@=;e}ߣk3N&hcG#d<ڰ攎e*ن7a G!C@w|FAơ@8 rvDA b8 :*Y;0tΟfȁ PXMT?$ئ@*sA dԞ1Dsy40WMAM,%S~/uAAC8=U  d Y+zZYDO<&)H h*h@̙l@!Bo]>Ț)7Dh-Uv3̝?d\C-8;ETKHJAPpu7I]2▔X"U<ԋ07&>ODphLc1A^\7ycy Bc<'Y>fr~( d0, r,x$V =kYxG#orPC4ahEH7' E*0CZ4=6Iu36WʓV#hY9̯F2g;eV WxHfilxΚ==xv6mk_[ ݶmg⎶'}m`P8n={7wmjn0.!d2q%IkY{`^y- 59n "sg\ ,w9O]ܓ6ГvC08Am{qV\t36%x3}'Kj8X+)Նw|߹ߥ >hM/XMHdGsd>@yu[HK~}7#gc>q|#"4Ktp/Ӳw )>'iP!ψؓŢd7GXXsZ ~O K rec#8U?v%a 36xyX7> ѧ44d9UZ!0``R(_``:Hi#PƓC%5E"M0 p# U? !'7x"0/P)J6uNcT"&t0b5Ax vh47WD|@T$=&0cz#=J#9dwr}U*RJ|rG2 HN@X҂ naMOU+t+7u<5!``n 4|P b\`r RJ†.qJ!ۀ ѳY2T#H{ pa09 p"x.p#`@hVȠ Ae, TV>4{} 9i%JdUeTa] V|0l , ڀ )i.F  ':3Y70ZGtS&9#Z3륔$Ra p(2BP a )TP)0A0@]J Dpݸ-- =5ec! DpJ.TJh5` 9s 3*)-КB|7HIgPnP e jj.٧H`Be)iCw٫a*(/9Q QRZ:5`Q쁭DZ-J !^pȮ0Շ`-6R⡫Ӡ몯 cӞwcDԌ1 vhD55 I/Y@1Ԥ ./pU+(@-(k7 / @ƨ{bã>9u.{81,&[. f@0Р8H >>фF^/9bpk*JRk/ |vJ4K-0=37ApHPJ7 ù_ /@Űя0i˻/`L +<#` KзsS5=s ZY;k.ُ9/45 9; i. WP/Qc vw'`7 $c0] KH®2 A?UJ8m`RG#sH<ñr AFBX5.\ÄaT|,ߔ>_n^c .lR# iNa~{ƻ Ѡ 8ȍ>gX}KD;a7K2ɝ"[1* : y='\yB ! V{Ϝ"p ]*A#{F`c*Vˈ`m`"@?`R>ԿA5!8%O *; ŀӞ4!8VAX)¦+<[x*\ KcLVi5(77BD<+ 7"(r\z|~׀؂=؄]؆}؈؊،؎ْؐ=ٔ Pr@IRE)  +8<Ӏ@]+ _e;Crۮr<7-+t#ܽ27:KܹrB^LݰbQݨB ޯ"޼J޳bުޡy# ߥ!m#mBMlԈt4O-[a}_BM0 C9v#,:ҀBY]$8N%Kp ! \aPePdF@z\cC(  Ta  (YNR&@ T֐IS4UL Zw{K0 @P!/q|N$0NTU ׇü{pp !x8[o^^("8ȗ$hU RP=0D UL0Q$`:U6N|@:`0:Etz>PBI8M]6Uom` =O {IB: @q=p J K'R P@PBR, >&/$$\Fv<+V%Q X!'"b3N?"kk.F$[OjC"aԌ!i_x|~?_?jpŔ?)Ӡ(`'ͣ|ը/(/(ߗY?_ȟʿ?a Ȁ )6P]3,=%B p Ű@#'a كzd P@`. <  4P@YWyQbVLH%MDRJ-]̶ Xp,xJ*:L#, ˡ,wjrpji$O1dEVZmݾWܷ\pxCX6ʃb { JLЌG fΝ=|*ChhaEC>xX 4(@J*ЁͲxmTlHl|M@kݽ^;@-ߨL/8Ek\L#F 8/bI@hXk#/C 7,x#M"`#(R)ዛUPiGhu;40Ah@ Ae PM3 ,IFq+юw6A lEC,E \ByyG,E/ G2$qA}rN$.PGVI8Fѐ+2c[6F# D $1WOP@v Z,`K(f @bقbd$)%/le<9OzJ$-4S h@ODKǑ0 bqQ,Mt iHE:R4MRԥAELeR"p5iNup*OMnmG @sթOjT*բHjxzԭ.SkXŊ(3xÓTYVխk}Z"W"h+\zWk`*XEla{X6[WusŬ{6Vvֳ)C 6EmiU{na`K6muKږmps EqKunt \b6<ֵn1A  g;^׼ Gz՛׽o|;_׾o~_׿p2TM?T7>(⼱i) awxl3 `$Nj*Ja"U$$Lbu: ?$D 0d&Kx8.Mr2H'@D QB* "799vsE M`I QD^Ė ?Ϯ-6gYŊ=a"5,'LĎ&(t,!r{ЊL' MΚַ(.]kP $Ӧ JJ hak\@@!@ָ>/j|mlw0=dF|7`1h@J9 GL)Z3xJPőH%F2QTUdE2^HHjYEF[őZ^A\E_aE`,EbDd@cEetgt=f?T Rd"qaCͥjUXלNCY`@sp@R  1M = 5MUi L1SKM5eSO98U(^_`a%b5b9m ,d@8=TDe2WP UR)HS2 -h؍mybp >*0Y~Ox~1<؍i@pPO@e(c؎؏ِ_i/n5f'Sl5+?7$< E`ό 2d覛@7P8W S>8nBI[+bMdS6$J'dDלW(J \Zw:E|xh3b:%4rivDeVЎ1gA*eiLk)-:#+S>[%ҡ Dbz贋O8S"#ٚ+;{@УjAѹ뮸˓3Hb`l3)@ZVdpB SozIU}\h4X!g-O^t< $n]!P,a%#"[5*>B _:2N'8Xk5[3aYC@ q?N+]T8%(}۰,a }B$E&++cSDgzkS;}Ͼ\}1p a@4̣:5տepP ꡅ~C5؅0O0 –>9a7Ir/qӲ5寀:a@@(/ d`}D2@c12 1U;Q4X#jAj(d>wi@LK`נ6iYSO!b}Px̣Ј@|vv vp15|$ @Mn*o¤N79'hUGʌCO5::YJMWy_B$^J!-rāÅI<ڷ {G7z*ixCJGBvRޜS'oI0suP$"d;d>-% :'>b s#L:ΌA I'B^0FdBAÎvd0ь*21xё" PIS J`pH*Xfk]#!VBq S9+5pA;2<2V1Se };6Yy|%3\xc  fd#௞h CS"f(CS4" ^FGb *Vjc-kU  ѳ>!_CXH.~ &#i c!C-l1mwF^ F[ PNjLF`0*NHTKUW=>f,YE~Ib7$l R:fip_L0|\Dџ`buDC `MD'X@< v  bD 0L!G Жj* w(&D1<@ ^р- FxYt !F<0Da5-WG>z`ęܡ1.aM8hݜu_GX!`?"Bj%ʄ6`ǃ^EXb'͕LbN*)"G@x@D Xy"0DZ*xIc"3f]E=5:$ A5X :7>D'Ix8:.$Dd# D;X C. >>ډY=[b@&6B.2L΃= 8CʗnD>6BA(G&օڱeр! @LXJ^J K DLΤOXMdO.%M NSNeSbMXTUv|9%VbXdRzY>0T#g%Q-(YΥbh%QB%]aHh@e,(_&N4 lbFO& XqdnMe>cBRbriD2T% \1؂f&z1^hC 19E$^cBlז[VTfp.EüM[!8al2'vbDoGGev5dAd?&[x6W5zgDPzx'i7>~'i B8ڧP @ra1Fn悊B'ZӀr~(gUVCkLn(hjBЖz¨SjX(:(P;)ZϏRJZ>(N)VdYn)-cЀ)))Ʃ)֩)b!N؇0I)ʇwjd>H/8/1` ܌|3h?:HÍ(K 11Q}45%^ZD6CP6jsB)ْC1Gыh q?8M`G, ?mg)@D+@w2^hDH90A0C@÷N ĭZ,7D(^B xBn úctT@+A 9+֜@p' @pCATAzو@gE` D6@b,>j!@B0>ĖCFEEvĺ@@@B`BgҩȢ,lD0P-C2Ch,A,>8BHBA$&1ZD|C>@Ω*b*lxB0L@\@7nB۵ nĂ+[.FlB%070Կ PG xB$D@&"A@@hBn,H@,n<@pH2!]ڀ* .SU@0B5&Vi8.D3@Ah4&)HIdC'Dt*A1S?G., q 0B-pQ2()X4Î D: hg ;p.* .C4Hﱰî&AXÑy 6D|jDD6ԉۑ DLD!J>)2ÑUdB0@8؉hG5CK(y`G|B"DL6&D[ C:3$Cx- 8EXG*D;y0"2L=z'EɃo<Th0IVyG'zD#m^>6є:' ;ZF~0tZ8̑ԥ8` IG,ciH?c8B*Fbc(m[:Aժ†1&5*~5$f}MT1j䁍ghdIFQfcӤ09jWiHi4%\I6bBLNTi^t@8Kƍ""T h%sSLBc]MڼFҤ1NĪQL5.2-IdFqcyfv .I+epc0]Z1;׎(7!8yh#V;| !;6^dL슒sB<3f-Vjci`F<eE^Y; 83 0œV Ì͐@ 5_ytrA~q $:yV.3ns*cݙ`QHfY *4d鮒76<F"{Ah Z!"^NFL2TC2~j5Ȧ#K(LuduakT[h]2嘳FJ:!PCMK ` wLh4 6M"CPF}r yP Ȇll?HtGU1ِK KRXTg!`YP%Y5md4。̑K<vfH|1f24X!tȖFa`y8(pƆ$Fdv!+WtK( @TH2G!F"pA` a$I$hQ]WI3HQQ"#C` D¨ 0S826}DX!V/]8M"$sYPYX2Å82[WYE0#DEh/{%B5CD_1@UoҲhHz#Y5:^FTrIϰ 2/H^4t3#  # `Xw'vqx@Dڠ\ /ii5!)P0F6}F,\^`)[4 vIdp>X 0C"c%}]9y]YPɍ]( ظMSs.FM56wx#Hp2p57tZ?hpڙ܉]T}i TT^/əG xCD@\H\^r[c@Zz *r:Upjb⠡+CJCnTEyCH @.PрQe8y:L5rXc〡 w B&Jh{#q0ɃYĤj EpETA_;u]_1K9G)%Z6?@5)0*4O%EnCL xƣGC* BK6 <B,0`HqS<buKԳCm9r)o{pOţLƀE_rd1.wēKhFV#) @XDN0 ɲT$K@mK~ɞ ʱ#MIuuJ?r&ɧL9EtLT NHD! ! M ˝s]GEDûȐ 6,˰#x7P4` ɱ\̓p%VjAϜI;Ѐ`еsCBZA@ e 6 fi<Ѵ{ϼlP @UЛĽI) FV2;rJ)C}AqZP~tK0Mn:kr32QLȨ,>1DS=dTdPJ^6\tq&"&QT3jS3= khr !փ$Hyۇ=QDcT` y6 opG5gN߂F3{uvSIPɰAQ y $%1N i6u7S@A~I n_1T#07<s*q~'aW_D >SMdq ӐH&TT@64j@_:>̮PFSSudb,fzxS&Hp,rn5!^J_5 peSDFUQm7pOYt%9E?1 N5?11D:|=?_.n4O9eFvGt9KkbHj_ubqz?;bX]V?ɯS Z !j;@7611%QŰ#HbPF\7!-@%C >QD-^ĘQF=~RH%MDRJ-]SL LqKCtp*l5ETRM>UTUZ6CDPC4,5MUe͞EVZmݾ={HOp*r8^}X`K bV ?Ydʕ-_>.]bZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_m~:a2uŋ'x/qKF~(p }'& 6L?Dzp>ODƿ,yhlr!yĆv'#9'g6h!L1K-/lhq,HB*F"S"B',!p/4PAL1V)ߡCw2pREx%z X o@)r5a@ 5;z81Xiy&A?0E8CUp ҐUT~EG:xS&(,1mёNglc)#EcqO}>q PG}U$GHҖ)>Mȟ8FRT! &n9MjK6z:Dͣ,3䇍,4(e59Ozӛg>O~ӟh@:PԠEhBP6ԡhD%:QVԢhF5QvԣiHE:RԤ'EiJURnI]Cx8FT吜/jPS1mMkzS6թMy)8ڐ# WjR^*1.l4 %I3gjZճ3V* &ֶk>ߊU2R͚_UUIHb i$V2XJ9e5YD!.lj5K؁6"݁jeKٗJLmnS eVTA2׸g.|[6ש o;ݫ Jҥnv۞v׻nx=]Why]4{ 2j|*ԸF~_׿p<`Fp o%tWDh[k#| bF%OF;WSܐ?9!ԣo{.wiYz'l82 OX&)Sd[jcDk$%'ר` mDt G}Uzַ}e?{:/%҈,%o{ZoJa@J@%$; Q FggE?~lFq$ 2U0k)R ̮[>龎pHh7T0*ؾ:025Vrz{f`{Q腥 3DTdtԿxl}È0yYxNHm`xi>=#[c ,/0\A@ki`ɇdx8 HBNZ8ۊ\ 3BػJKLMĽÍ{ a3dnq  pQT`x63(tn;;cDd]hb E"V75+<m\MmSQ0X0M30p'-@FD eԈF(U.5Wx`[DGЄOHOTOTVuOpF]GDX0''0D _OS;To _o}tUPj53XWG@`} pmv $8׎ ؿLXP1@B0(^O MTXDׅeX$R&xFI0`IPXLٙ՟ڠڡ%ڢ5ڣEڤړMLDUMЄGЂ?OYMȄIULx۰ ۮeZK]5۶ [[[[ "mE\X5ɭ\KgΝg\5UuՕ٥ڵ%5E^hSPp=紊8KDmi?^؇\cW|vh6  /u*-dҧ^V03z"04牉g IPyEzcʆ\.uQ%P`)QX6-` 6a ӝ.|(vb'l1d@_ݦʁ[\HIz"^^`fT{ux= *~7 bc[, GT q=u`I/3n&nc]J[ѓ^X䉠&!ShsHq!ىǜˌ04 SIH,(UPHYZxNJ`nXHɐyo:`sԈ,# .mtOCGj:pYHnwq[`쑐9sц憠n@d CJ1yUxGY2e%E`?kƁSBD c_P? [ЁURenn*͉i2m``0 聰p+YYbv A_P_oHX( P1u(;qÆќĈv̶6قUhV{d e6Hk Z@M8'nv@)V`7 0x`jdž(ƆP4a큨C)XX Pw(ƘFɇobHn0H(g1u/DɇX(Z,Lne=t `xS(iIS:h`vj~ƛYI݋(YHOF6@VZ1`qw{H&xU`Gv`Pi8quvwl^ÉgX@HS݉yH ga,'Vw:kZ i\VqS7y y=9I)9{&9饛2}u8-~;C;;kC ܯ( #> Oؿ3铬߿?{2< ʉ06C7-cZ6`Pc C(){`FWҰ6&8 7^7F<"Dp6 {zpV"47B`8-f<x? /.@#(9P0@:~#8o<$" 26?^i$&3F&uq&C)Q5t͟R9D|%,ayJ0n 5]e|sIG%2,)RH!J.ּ& ٔ 3&8ù@m2 ũuaQ<>@'>D|&F'~%c:a(2t[hhS ud␇vwYI|#?8,'xxLzPB|lj5U,t+<^txt\/ *~|<ݮ4B{3@*1 ~&ug} d3ưHr}]]rC(wԡzzo9}T) ii(HN2 ms0DǮy@-esxC^9Kƒ"hc]ذsx q̚UVl9~sI3}jh` 1_CFH@H0^\>Z0D>aE!< jv!j`q-ea 5Saɔn$I@ve[]?[m8[^ #8Xj%8 ]*%^&^5ڏ<4HnC8)4nn@AtHT@ Faw!e[>\%]]hXeO r Efnt`Aj[-&cQo@ԀHBΚCC:(up!VEtN'uVt2Zf,f8ZI@  zn@fosRB(.8$@Bq9bAu(J'vO%6pgn'k&Lyz#{ZPPEd C/.E8&lSa؍dx?jC?̮Pb>k#6.Z1E26=FBQԎDBxי6D&j>0n @tP"E D2$Kkh&}ED@6hFe8 ꉜf>li50kBT0Sx@B*54B(nB@9@6*)oQKtP-aE@ nÂQr0A.i,qAA {2[;APԱ`C<5qQ-o2Q,P2ʪނ5ےkN bgCVs2Q0kDK4(2*ciP#+$d?+Cg/ڦ-G3Q@.1c0,GV8ې4sR 97 5N.0";г=9, Ap*= RgTe@#H8hmD#.oAP 0hBCS* WM4JKG16D=CA(hJt 42HgXO?9@@Ui-lG A_BXk@L\&é5^3P`ʌg5@4H>aˁ ?۶A)0pN-OލSP exE^(6O-HiKahC0x06' > w 73dHB8PٵzqNp0M6$l"(YWH;ZN[a I>=4Ҥ!5A)@6WJyBÓL]Dq2;Ԃz2"\wҰ@ BЙM>tPhe/ľjK>@`błvd6DlCrH$!8wLR ?N``_9BlKȩ994 FEA3Ol`3D?CN/#VToC +XwrK-\X%P?CCXN }؋BP}J}ڏ{Nt+ٿf0TSeC?N}W7)m99=wNXC14чF=W@phG ]p"#s3>R,Q؟*~Qi. PZMxזl=T:Vj3>~ < ؾC-툵hf+Oq?QCl'5@@ 0`A&TaC!F8bE1fԨ߿4s6.JByQ`2!-g0q/hԹgO?:hQ? P+@OF:FgYb )j\U 0Ioƕ;n]64VXӻ5mLg 0w$ɡu a;=tiӧ/]HjׯaVC@86@'3-3XV:9HYa/$(`bg׾{.ѧX߷Dg &X㣈7FLPAKȈe )́N@!"p) @li!* aQ'j!hQǩ^"([zHƦGV1#!,('B'-v/ ZhZp 5ٴGq&9Y< )GiTHmIFGFXg~gilSQIKLX+RYmukg q櫹.dx[Oӎ[鎚 NۘO\&na Q>)<_o!.{E r\ͭd"AWf]G" d ă}[ZKy^.!(v)hݗ-h?ZN"XWju! !֪4cKi^@CC. $y<@'dO!k AlsQȆ 5 Qi| +X4d.H08 -A֐/MtPD"pB 8CN/D`И#EwD{iFСQ,JXn"ADhPp d!/D7#JURMBWcNQm( - C_Gh:|t3`& 90 }̃臁1$؆ 4,l -;?Yd0χ́?wBm# ki 9 =@AN}Ԋ9PBnAQcihG$@}g)Kaړ"^HGͷ҂43=)&7sP*aH:袂8~6uYCqQ 5@^$u gL`լC1bmXHS/E v `t.y@ :%Ag*G e,A d$)#P55|`lۊRC4PQ,$RnM \>\HF5|; C &0VdOb J!tR+ $&xs[@ B׍Oݙr,F`)hRohw@!A˥+i:C( lԒ(s@ q:$?l#=,NDpC4s=֬(~#u0o G> CcAuGlm,!B"!){ `બp "A: aAfb>]0p6RZ ,P(&(h-a^0 uA i a# g e: <0 +G!"Bc%p /B ;bհHAԡN ?& !,^H*\ȰÇ#JHŋ3jȱǏ CIɓ(S<˗0cʜ0QYZĉN@ Jѣ IE$RϟHJJu*"J '`ÊKlGQ IB`ؚK*Z$@QN Lar%'E˘3ʍuW0iqtӨS!NQk ۸QsH{ NQB]-hzn~A&سӫ_R_l8OTEYA B D CD(PbTX]B5 ]%]F' h52z _"n"6Cئ#Ђˋ842 }H8$h.j{4b FF?QF#ElH: P2w4GigH?80a R2Rk|ej6Ć"sK]F4!o`HQdؘNt)|C ,)jNf΋5A%z!H<1 df@a]Zqez)Ċ6zm~!@b,۰Ʃ%V"4l< ^PW@  jp)@P:;7Qp]J7D`A 7M 0G/=Ŀx{ Hr Q-;LA ; 6s)g'-TbOi{hyg FISGdaA H%q8q.Z9A &e褡a`<@e0@ 'Z0ؗJoQQT~ ӆ6':Ͷ.b>DCxQ<َqda^WQ{^l쉄0))3 b6!~/SW*"u+R a|tUV QF+8rj@Kď 8/9y 4~z]T~k.0MaA 00vBwOf .4ؐkR\7ŖaodUrFqF,'4kwG GPD(fb'rbptv"ʀDW{㢂>&VUo78zB\@-rvy_-PYTB 4+'q|!ad_XOa,7e\rhM#5q =X+wU ̲ ^.` eJ jC PDQEY[)F&ʐ4r|-w.&oEnV1zĐft&AفxFBpICP%Ae858P`HI `bB @ 8-KƐYCHq@P}L p }vt^`UhAAY(/ņ.E4||nq 8 9{R{+ˀT94J4z7^'0zrx`P+i q$ U2-Dd:^5|ד` +!vsPV yyЋӢ٤voB`WXKpX2ltt&1YPHi+=b6=Q|qu1]&-TQp*IC- ZvHi-hSPH. ffi6i87P079QdR99r#%VWQ ƞ~t ѓ.^5ga a S0ziX ˙gƠsp)oӉspvpn KJ@Cn=) +tH);q7E^1@``; w+$DKCzH);Iu Y`#WEt ѥ^z R?@@-! ভpz@Cs?yQc Apl Ħ 1RóHƨ TJ  8XpL T%AE k(@ZzEXÔG@!i 1;VAȀdW;pm.|, @jȐJ;:ħЧ(FB%k5J`ga^"6*%;d : ۱&azzS ;nñ%9C.9*Ӳ490{3:K96۳@K9<;F;~#@~SF8Hbô4ˤ.RkAn;XKõr3v T:ekG`^~؞ھ>nOZ;Ԑ)FQ9rѧf`ɰ2o=% 8 ?_2u $_&_q*sp 2?4_68:<>@3 -+/>?N?R 2XZ\^`b1?^<_fnpr?t_v8t~/}vpb4f>_2Tvlp25ɐ IC^~{?9(0M&_oPH-oXQ?/F/-C;?ye?M(\7JOp_NoN@ DXPB  @'D-^ĘQF=~RH%MDRJ-]S̓-SΜɒS7o^Nq& PiÐK ,S*QmkPV]~VX*ZmݾW\uft Ӧ6xޡ[6Rue EpJ]ZYbhҥMFZj=O[6ƼIftn޽}ɴ)5ל?w`Zm X6uHe{-m]F9q/<M;0@9:".c98MiHPA 7CgfhpAxI8b`f"xx tb9l2O%(hK/̩A1(yQ6}&8?N;3#j.Vjf"iB( R(LFBk1yPr1d-";q"G}҆ӒT"pxǚ/W]wW_6\Ȏ9*=3tCY6Zi+FPkf `K [,#o Й(&q&=m(gNЩԝ , 7UVh]H"8<b,yie_9f&@#Q=hxOxCf]j:kPں~)kg{t-|TU(R(*(Rݥi$P)f"zhʨȘΐ YtOGtd< 'BA65J!x `N@߭r䗏BƆi&&Rbhd'P`ފ.i&'D?&JA#+1FxU./Ŝ M30 U/K5V`9"V5AvaE81 "ME݇΁iHf`o7D kDDLn1f[Ƞ \!D0ną0N-H\!3|rmа+*aC4\/Ȑ<`8v8D4#t0H@sd()3ȉC!k/JpPcis]4c8 A0ȕvhD%:QVԢhF5Qv03 A}2Ι] 忊TBx]^@eJ^(E$`s!jPZLdHZhf4>h dDP( XC$AMLpD`oTo  3  U4Cq8GR3+D4!>YAz„b̃Zld%;YVֲlf5K 4|"pP<ΐ&՛H+w*RDSk[N',*1 61"Ks@*S0 XReots"{,,`2 }Rv&r2R cYU@ *1 |)`ph1L6u`S`7p%l"cqr"{;7muw_{>vgG;حNu)tE,w'I/t`"Nm!yx#w|%x?~<-c~憿?zҗG}Uzַ1y=Kl{\p(>E|7~w~?}3?~GO~+7|3bt @ @ $4DT|>?0{zDXЅS0QX& XxWX0#D$T%d&t'()*+,-!Wp43L"]BAE }CG6G;JKCDLNJK LM}AESTEOtV,O](8SȃITNP QЄFMQ1@?QQU]W=R;p'Dռ\ LP8Me]V PV%\LKЄlP)5q2Љ؄n2txOP?H-CHP jNGuPȄOqVPEXs8iPPV&(,N%(E͈ΎPLȂ$8RpXUٕJ֗YuSW͈8% &J* WW5ڣEOPZUڦٗŻyeWՈLCAҍJǮEڲ5[{մU۵SVqQaڍPTn8ۼ[S[`Y4ZؽELȄu\uSuAU\[͕eIK05-KPQe]ԅ*]U\8%5EUeu޳i%ߑP8=~y=}~Ї1L`۳__}.1f`18H(4 5cȴ nn(68 0(d@ajD gxb a?PuP ch}xx+K.+ "!0MvcPbP(a x( -6]Ć?_.Y؅] c5Ec ՉHy!uQqX@XhidH1^PPdbaUNEhcx yK |qOP_QS~ T. !ujb^PYȆe8it!EvX5ɋ`0qP,V ;CXۓUظ([VflxW0_@y_ƫW0%rlAI(5ġD.h:ɐgUVb8vc00`m(`?3fhe`8{FBRPR8"!" hZ0auP}>㉈y?FD40ʈgY[l@B* b2I*0Y,έbԂ-{ #Ckĝ,#ڋ[{,f+2lr-ў'U01 Xΐ?&B[h81+8;8uw[~9k@2Q9饛~: t0D>JԬ:;n#<8y?>瞟Dy;<'z{=O84< ?/?K??^cr?H@@'2<> 36dC(h#w .|! 9C $}S` shThF< C"(EbovB-r1uJlb'vf<#"xn|GCv[& ~Q&L4H p>ND(q%@F` 5%kl/ QJP3SԎJNЀ+s|$w)a ! G&AA|IiRˬ&1;M6)qz$ A'Frg\b8Aw39iцq3AaXzkfjX㣞%bZ]#:,1x!]mM>xC1\@%C06Ws>ryL7^7_+ېC!!:pbT! /O ^ J?ZYKNwԽn9n7m F/`-n0d_.)弄a:[2741dQ~t59rSa];ucЃˆH.5B )[Mr֪l q|hob %C`rLjQ H%P5 2X(qk뜷x$Hf>T'&HNU j*]jE BKVd<SحVRpFؙiVS=sN~c׎3gb 5[_=x:$X;DZiX6d 00}6e>H"֎j5񵷗baikfxۨlXcPNCj`0A6ݑ|!15.ysEg2!(i]2K<L>}8ew L9FlNjtP&@w $G`$=6][EwJ-d} C[ ZLL3/Z812}]̣N ?05@+$тQ,8YP?i`.MMSLLƱCj g D @A! -Kl MFo~5 @) aԶaAHR), QPD-D1(a @0 I |TB}Lb/W;%] P *ņOL5VKvKb.J\M&_b@)/Qʔc8xcRJYWeNQDJ4c#qIX@`ӝj(#J|@rH4 `|y'{ef?("d)z8@c(}!XKeh&Mt8l:ED2_~h=@Bk0F%x@AX%ĮA+(:AX$r \ RS9HēJۅ[a╖)=qQH !^ZCR #`"J' 4)( B "ڏ)< ;aN JlVB1 "C2t2%RmB%ΘUg(*(h#P*5SM0J6CT|"J !hx>BZ>`H#f5$v˱4l;RԔ Phd"< )¶8D2Ͱ(=5QaRt=6D *D$0k%+fPfMʲ%]u,=]S͈Cte6 l<&S*I @z| RUʈIFYjJWeYCFcI橂w1,ȜS2A.J2Mժm\m I ,?De]9  !. B0.6 o)jz +OSBM/@` $O2PvJQvҥ8@/Ȥ;Aѯ>X>o!S0(?Y>0%fopNl!iF L 0 בN فD]0+\#QHrІ, 718/) CqpK ݾ 1(@|0ҥgFeAnq@,<@L$UDi}4Eq@6>\@0gB+t7@HrTx,-$ 7 Ĺ Yp E)DME*E(#a+6'@-*I3AhK>9@U)tAtB0D#EVqH+N _7?|2wm>t&J>6p] 8mxp>MC"DA\oQ<ou4Î$ p#nGCvH@@$5hDggHv =li$kv v.9bY6pnqkp:^7t[ynSoOH-vtow-@4" ?7ww !]7yt v7}{r6xv}7zð8v07gV5@ u8 sWp, @H$7~@8wvL\>8֍WxLv.7/ajb̈he@aTB\?C$fIC3p;BJNEP א$9ʓs :#kErD^ a9,y1wPŃ+\DEt88F-'&7DDE8@)\S"}OH -IGv-s$HTTK|;<&7lywB'yD<ݫXJ[@'>cx,|ɻ^G\݉eA`9ȓуQ?`C3Ь޺_=_ U}٧|=ث=/՟ǽ ۇ==W}}, vJ!>M 5jJN>͉b_w݌4}\現 `w>> eu ά'@R1/,GJsar\o"Tmrv̩_%B% rW/u!?@` 0`l &T~$0@yQL(naGA\HdI'QTeK/aƔ9fM7qԹgO?QB5Ja0b Gp[2~j@ ѫGpUm[oƕ;n]w4T RRn)ZeCUԴ@B.y1gּsgϟA=$%CZc!eHEKa L4R$HC֬ oή4A0# ױg׾{w?zPQT .XKFvI +bi 8A'l!PB>d Pz%T) HD*Qu*L&NΙPiq\X\o!\f -j)&Hj ЯU&hʸmA!."IL,5l7Y%[|ɥ %0%+.(obǵ=9LYҝ hRbD! UQI-ԹP薁\fdJ )(@j=#C5y Wa<˅Jܣ1NViZ0Y0!L Ey Ce 6dY ]=J&%?$0#3Ɖ/B`DvHă< HCډ)RߖtSrG>$wV10zsK:Xygrҁܱ3}dVkU!HIZ'l`V(k"뚡nb4w%_.p( g~K#y8V)˥&Q| {C9tpϞh#7a]B`d&{E'mZO^y~w!,_H*\ȰÇ#JHŋ3j$`*N 02(J˗0cʜI͛8s<ϟ@ s䡍D]ʴӧPJJիX"(@(' )YӪ]˶۷pʝ۔VW*8葨t LD^̸1T;Le.k9g,FjD3 D۹װc˞hДCս2CQ+*μF^7P:24w#bNV- \4`Cէ̩TXi((BCA j!hᅳJ qe^CB\ARӈ0(#\x~B&6@)$l<ɈC&L6XNF)TViXf0`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.M:-ǽ8nziLt{88A #|ú@H>2#'Ï[@X+foLC0?篿v8?Pbm C00k? ZU2q G0M 2 ˃$L;w+|lpi= h:0l#^.u^$d!9@T[B 9_D'zp$UAIa*T}I6fX^RinjAՀ'?]mJ @ُˤ@R BEl Ǡ&ϥItg2]_8,óy5Xk@)l`Ż>$&EHXgë/ژ 2BNjMs)5!xBoJf+\\ h1$8 `YfçbX*A9 A ߘ hqCl؈r 4+ J@h5 h5|`w%R`rʊp7Q~a<6WXZ&~ Nb "jc>pS0B&O>.JsJǢ":><'/ǯo} M1 5DrwPE-yxC&R~XۊPu_E~} @y*Xa &ѳQ#=)FRF$!y o{iL c`9;zSG uMuo0}A raU'@PIi9Fa 6g545eI8t c3<9W5ӡSCB9`Kӹ q9Y`g0S o4Cw ׀ y8;E4G(?dH<n@pQpA[aOvx8߀SZ FP@Lm7O -! 0 o4ɠqbfYH 0q}px ZD@1} Ub` laD:w?+]ӳ eK2gʦ3ka>1X0r@R]!C зpbQ>OacYBs  ` @TmѤ (:OSI} 0ЫrB+){!If$ ;k!(j1L1 0 )TR? M<\| l2NA  0a,0\Y([b$l/`dP'S'// / 4\:CS@BD}&-e)NӐ0RRqQJD Ay4eL3񴥙]&S?Ά  ְ ;{:pdÔscٰ fhlPK7|bmƂ es&%H36\D<Ks ڌ&.;8=vCtC0!meB L~m.h j=ߔ&`N;B-F~֒JN-LP-R>RV,Xʲ\,^bN,d^rh,jn+p p7s z>Bj S 2 ڄ^&3nOt9S0YdDC;CGBaL_ N+>=b@.+Xt+믲*^~Ȟw.x.!N(@ AmBKߞ ۞1^~?^"mo:pPl[(_će?^Q>(_BA?e.D F CfS@dCc?}h%)Ԟ[pw.$װ`_'__YYjI@7.`+M4g濯}Mkb@߹ Z E:` Si<1p  @VDPB >QD-^h1=~RH%~&OLSL5+R 81&D9.h.Z~ LTVZQCUXe1YZm0JlFa !, Y"|2SC]aY$:;Yhp#f[w+:T)\9t,8%2YJ?n rfU$K`&\N!͞ИPIz# fMx(wPCD @(!&,s '-ebȄdA*CbBvl-G !Bo1ǞnYfjq0`>\!l'y'UFtʑC+E!d|*ajF[nAZjQȾbL"3O=3aY2b i,[!4RK'ta[l hAPiQsQf[f 2%[lӄ0]:Iwױ,&T:b. [*F`}WiM@̗X@ub[j%\z XA`5_z7_}_X Rb F.T^D8bb/f@T]p%1&dOF9ƙ'TхUf^y%sfDx fZ"x:iZ骧jk{6lfFab0-h;o . 0o:<7qWr<'ykw.>!%U^QE{1&ky %g}{}A't`Q. dX@006ЁYW p<"aE}x` a0 $,QІ)hxÈ"PpyD(D$Љ\#(S捆>t @0T ҳ>V2tLH((h!|51LhB M@%: JVuvPbc2 Kh e,1 aQOT/AJW^\f8-O󉡸? kN1?!xS7%k-<;2EhB nV iCPVԢhF5QvԣehHR2'EiJERRT/iL#CԦ2iNa*ԧ?N:{¨GEjRgFT6JQ:U3QjVZƏuի_V:Veլ]%kZպBuo+ڪԸծɛkRWկl`{V ְElbX6ֱld%;YVֲlf٧jilh9u$=#1@iU@ 1R-8 (Őb\>Q5K BqO`ۛC\h  RTaEdBZ{(aHp'"(6pQX rpC0dqBt'N@H$(pbJ$@%8!Q0!86I@"R$8`B|N0'jyiS{x"R&*yWР^LFgA}"IDPxdC!"r !#H!x5F-vcBһ6"<{(@Ap[X,>( h885Rp+X{ KSLa783lc7ueDae@H2ȲT>5H΢PeˏZHC2h`06Y߬ Po(: C,eәVkPZ+B[w$BQ3y $P!bUEFSla%VbEd%fRfuVNyiVc]mnZr ,H5v5,Ewy\`WzZWl~X"׀%؂5؃EE؅e؆u؇؈؋׌XO؏*aَWXQّ$*PpQّeYʆmxٜٝNٟը>0%ڢ5ڣ=@ڥEcڧJZ2zZ20ڰ"q-i4E[ҐkM֙M[tͨydmV[[Ԕ8nڋ4q8\ɠDžǥ202\̽͗†k]8ݕrbmkYKq8p pڎ皭ݕQI^pe݇^8mۿS~-}_S(_ue߈߾;x8֍ 1 ``-/\| !_JiPvpvp5w`(҅I൐/h.q^*ᦉ-u& yX.}X.vzEnym5f*,b}(bH 5YKq(m~. l`bb-b7yP(N4-~Kѐy6֭ s^wP06_ mh@RbiImMîxՆy, @!H؈Cތd$ن+ؚ֑} }M/υ)M@"л`_\pUM2a6iaHKOVYuH vP,[W_U؆< uR4]S@kPe`\zg}b"!hcmڝF08YJ4P"#/p Nh!!hflȆq`gP VٝH!j5 RZ0dxWᘆ,jX=j_b%j9jH!jGkZ~vbeiRH\ިJ`~8 i;xmȶ(~¶}y_w fMNHm0R0Ek(kޗp|l Rn_mcek y.,H6(.>MjMln~N`Xo0MP[Ulhb im.ޟ=Tb<N0b5^ exy W# pDz8771\0 pڄvpiHq*2>q'Jo n*Jw"vi+!V^?UCpe2!X$!A@> 0F/h̀{6.f9!{T؆g8=/hijNKeDOAyhF>[tBRSLj^` b'bGucft-bb 6,iW27qxUhl/pd0hˍwxpphHN .p"!֮cqpF!!'Xqc j~P;x _eg ض>n. 8 jdZ6V:2І@e| N ey8zyj愈$ NVG 'ZzK8W h>ROa`rK>2$" {k9dOGF%' {)F+`z|%猸RCV6o>^:G~؏ $0612`N  e; 0 ` {oƍߊ! ~'N}7?q~Yk6j,h „  &'Rh"ƌ+ LV,:"GGtl%L&Μ 'РBXZDM2R'61ϸTٴj P)ZQ U%OqN/S$ TJ I \, qb{Ygqu+`l2&`gӮio 8k}8JY7 /{N} 1{EWϠO%(eqsyn:TWtw MrUX :E@@5X!Y MC6 CW]H,Oa((^\h5ы=HP-cB(Ms  Yo$v@|_G%[iU"liQH)!T@F켯CsBr*z!P>ߤ 4EBN9ͫ wɆ@x@IAzA4B'Hѻ* >*A`%02]1&dNyG$"@,$JH\dD ]`8DC%pJ`.PBKch8OBq h2 d&+0ЍB mC6~6ѐ~cْDADQfP) 3nģ@KZ0P.{,jBJE/&d]7!R?\%3G%ȉ,)'(<2LPkZ2%sd+9f>Z[n~sLR8ӹ:l=Y$k,A_d*0h@Mю~>VMHSZ-HA+=_ћ4 9ԦsNj0۴Iicm^dyYֶnr;N`ܺ׾5-a1ʬp6\ƶ <=H(wW̽a}QE딝YiE   0L$8@Rt0Y9d CO ЂQ GA,pF +tda;vl0vVBVZ )W1(eHd'7*,R21@{Aޱ~_D.޴.xE )D B ;ver8ȵΏVl @ dXQ H,6WCV!H7.l <%_=jE70T"Ƀ Ђn- B1ă@*8AVD6 TEpAh@4#x*|x)@ Dٟ J5`adƎ@XC*"7d4TD%lͅ~ը"4ɡ@C XWTFASħpJ2<4>_4c,@,(U6C)7?BQ@3<d40A#=RKF`$BndFaDJd0Ph$F$G$h!,HH*\ȰÇ#JHŋ3jQ;Iɓ(S\ɲ˗0cʜI͛8sɳϟ@ Jњ E*iȅG%M%0CT Buׯ`ÊKٳ-2tTVr \x߿4ŵ̸ǐ#KVDQ(a qL齖N^z`:vHڭs=1+)2<<&B " X!x;3|۽RuNub,7z nf~ȸTP|g{7Hq\i"f!Qto $8} iy#)(y])=2 l&)d#inP*7'aԈ*TBTx\ɗ`嘦YR_!^`YFi>4"dixQ&Џ1Ŗ'tT&袌4(lg褔Vj饘f馜v駠*ꨤjꩨ>f꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wogw/o>c<>N?$?ÿ8 # >j.? txEJ`F} 6H?BQ#>ac` E@c{Fx!ipkE:aC1ÈUt6 1lsFP4Dd4!Ѧ (Ͷm{tQCF!٦1("wPQ(Z$5Iq4@1"rLZA1 Y,ey/JB,G1yLRbIlHS fmvӛ8kF 21m䲟+`?UxNC ;PL#`^eskdb%4AяG^Ђh!L mW@|gx6@fQ ʐF+ȏT O:'c)D(U!NP>y"&IFUJc8YT%0"G0#6] Fkk{qq%@nȏ溕]%KԹ(5jM>]Y8y- ̼4d0o~=\# uƋ^c&tB)%-wg oAyu-ПeHt63 H:2W%i\ސe …ƿo~]|uβg6v |M p<}`w/p <,~kІ8B~flBt.A+1V ,my0!!Uȏ_> $똹o\Vsi`A;G^u"k|ژ1 /*4XV}^}L晾nL@vgY"߷ x`f38gF@ү>7l^P҄bxaSҡQ33BA8M(&PR/Z8(Ah!1pEL xd/'ԖA"^BZe{ɗ1ق?}CKs"hRy$PIQE620Feam c< f~rZ~v<#'m|gT釒 r}f wЂ3p3FGp;plBt }BrF593bX)5 AAa` "Fe4 +v5)35020Yd8TF `7?Z wBqw1 m^`3T!КB39@H i*8?_ G3;p~pɩ? ɰ}d vbVE%os7RtH`iPU@tv $Bj&3F;xqT@aJ *3@ z9YpGJp QMdT!:**t>'j30B(A%˗DT oP 4b!(iXi[JLY)Z*E3GbȯXn c 1l۠ 4⪰SY \ᨥMj53)'ښ"TK` 9w5 ::  i)f\WeF9{6z3DpSyYaO,Fs*ؐ Q ذ@E,w0 @x7 VqwlRC7`e g^ 0DIXsjP4v;<0Czz`H%kSfE"G)@=1:1f$P!9$Eu@'[>k>{aaz`o0>,L|DdA>vhʼ aj՛tKU{>!\ۯ+| ]OpK`qzEuրyuԯʺtدؐY >f;|[CDA(º?{B|PQeoqGl5\kٯae0 `7rd ιCF]\+P`F}]d V_@K 3P&P_v?_쯂€x#SsY_Bj7դ rA<_8e[] @Y>q  PMP7SЌ))sSTs#5? DQ]; a`8ZUS,@`Y' IR)[<>֌p}rMU(YYy><  0 kUkD:f1װԔ7ZuTi! PHP7@OJ79Db=1A䪰H6# 0pCא\J2zcOj",5*Pb y8:-8E5Q=P F =! L7[8$a4< @kao7W5c]>1Ϻ\3&am})~9R4u^ ^qٚZٲB]=;cگY۰#ڳںc۳;=۱=;=Ais 81f}e%7]1HI[=6ϭ1 7-ws3ɔU$$ݗB`9t@;9 >r:>r:DaШSm6? Ǒ@Jj=-?H(,n3Rѽ(%n,'>bH3J}dsR_;3=?~AN7 Cu@a?)3JRr6?Eq@1=1wrBV>JAnKazgq{~n:6QF=$&F_ ,npr?t_vPBzD?]4x?6z?Y_t҃6t׋6:Vq G( oj Pw fGotiW6P``a5 6lsVjS)ЋOg?_Գv(>%vPE .@ DPB >QD-^ĘQF=~RH%MDap-o`.n}V \ăO_M1%ˁӜj`_Qe͞EVZmݾWܸ,%@ql,(nk`wb:5> ә ׂ?ihҥMFZj֭]+TV8Ѐ{ EY):݊խ_Ǟ]vݽ/ .`Jx*+r(9\'n/lyǠs ,&B /0C OۆRc Xk'xРUZiMrLJ^Yej)(ž dI'2J:)5^8 @p3dy=0ȁ !`*_Z`fSC"1*q NxJQG4RI'H "U& ҆1 f!(A4f\ ybiHy!8e R!XcE6YeY{oB%E`axHAa'6Q(|&]2 BӁ^)F@Fe8`&"yΐAxV hYȃiꑠ= OJ(ky$< ` - b0@ ~D+g: %lu8H  |AI @2; aF `E!Ϡh"!L n;ў9l0x+HUB r# #`ۡ`$02 5MQ%4O)H%ԸEnr\6׹υnt;]4 nvsȸv~ $ @D7Pԅo|;_ nj_. oވ Poi ,`Apjg45as/Jܭ% H_f AIF8A$4@zf{㴠x#YlLc2&5k!Sdmu1,Q|J9Gd({H+h.D@|:D ` <t%=iJWҗ`dӟu+ݐHKRDR_h N(<\H·1[^ҽ=Sh,g d~2 ,IS߾D=nrFwսnhҦ+ "3 Pb Tcfj]CJ/X @"M0 X1 "(ME#  Urv3`o.ZLic580 4.9J5+ 65ސ T*A}D 3բm`NSP a 1s!ԫA2EZF!$[D>B3apZ@ݚi() $k7~i66d06Ci®h1\] ^7{[x{+[E]< ]{ZC bZ$xP@6˼Kn ì^Xƨ…Vk5p&@_@w ˾r5%,҆FUԏيcvXh20eA sx{2 l􈘍R R$;Fȅ\Y0948Bw8Bl>ctУ%qű=HlІQ(^X8FA )3СgHjO{K}P@ORy(Q1hTu9S,u3CZ@&iE}b;l(45 j؆d0 [zX }ȿS%/15LWЄkuHF Mݐ:,ލpDdzZ[8Fc>ۓ+Fdhւva`k6v(6.0+yPyX}V׌c~^HZ 0dȔ݂CqiRP&C rs`6ZE0;`\݈RX|8(eh^)bFnapsO@`ȻڹM)yӅ;~=u 7I";S7&;eZlF4-hyKsO-D$uځ m@ѧf, مf(cT`pCrbp c08`+: A20?J 5gqPiNX$k<,)x)AxӑOgOM3A07eD L@@h8HB x:@Cq‚XRQ ՛f!xf96hx{ZpV?Zh[;?+V(HؚFZXQB ThY kXq&g8djTPAy`l((ghX8=X9 [N Y6`e@pDgH+XSiR9 :{jl]ꯆfW~-VX38_YXh#tpPNH-I@\bF&$eNۼP5H( <+@hY >~Y–HX 9f8 cn@V ͑兠VXM`Z~YÃ&/%R0R\o9_@@ȅ p[܇38% pnX) _fW<;@9I>8x5)t1M8;JG'7(6-4nz(v`spO@dk󁀁8j<@cyg̛քxnJOw ؂@$+0?W7lAYO)UkPdfm<&b m$oP{ d e{#8>pɇxb:.yi4ǁF:SeQRpM#uoflS =sxBC0P&JYk>S$ ?o2:0('ag腶np2_@ Xha+Y`zfE_`Nr:hjIP>(rH;6/2U,BhFʅ {rm;^E/N-hgQW(et!c<[H׭[0QF?Z0TlV[N 6`{d[ AB@o{4UITfފeO4B(2S2kX  ,ڴjײm-ܸrą-W+ vTv@ϟ T؋]j4(%_%%&t}0x@AP L SЉHM<&o8M4V 1n! ʗ3o9heڷswA{5] ͗dɪ%Pdj@b2$ |7P4buTK)ѬU3AםsUG-@@"9*C x[A` 5`Yfu7$E/@)Y;4s˔e,Z疏 xQG 1D8В]X-K6N-ev4FDc-Q7ˁ IX.$ (&dzGj)DIA)w:N˘ Ւ@FfUi/ -\J- u:AfĂ&dPT f0jAI{2K-z/M/.D(/esQ6˫b1w@*Q"ú`D칐‹RƚE/5!<JtAw ^?1 ˞5+P6&+tO`[2fsI,P;imjQؼXC5GIS KYWK6?s(C^ıѽ}jمabߙ~:l=魗ˎ"i2P*q=;g*AIyų5XSon<#K?={Zy 1P J[N2o$zs˟>/Ƒ@?>< ͰuTb2 ^ wPE4ήu$<#Hx^\>!1!Rbh.0 C RV"Dp1Csb|3<jn|#>"^\b Q# )A2rtxGQUD! ]$&3ɸQ* ˪&SU2uDb'בG6[]Veh IIJї<&2y@`2re)Hl<#@(Ph@VԩVj>i.+B}`#*p Fne:k#<޺NGJ{Qb^+Y 9Ѓ^x8R)H@pg0xa$/p3(n6À0F.@C+=`wG&#<. ?<  :-8Ó@鷒I<8Y OȊܑviZ1/>| i`K\qS1T쮜ǒBق_Gn٥ROZX ix>[H2, ^MD@| P{t > F]iYՕ]yPY8Y HZtZ 2(PC: ǥjV@><[r ZlZ U>h`9@8vʅԕa™0]N8o^ѹI\2h@t8½5CaC< 2|L᥍:Gwv!ͬAhL<6AY=.'`B 0!1Ń6A3{ C/z 5:9P DE&+c@l@ ](Y(atMuxiCéE]C?C?1 :?|x[m1mGy`]"Gr $LA YAZqE9ed=Z}ܢm]UV2\=ޤSN7D]5X?ed$5u`9M?xWwC"C]2eJ8H:2$Jތj<6^AX<ܣ]fcO栉V5?&yA{%:bCm= A@ۉ's$6∃S۫Ύ:OmO|*[W9x6&6뛽X' "6rW|8Cf(^F+IzH9E2"AtZWe؟" k[|qlivڬD9C<e%è6,qfl\-rh5ĕ4`6 &_Ak Z4fegF+]\zeeݡ"y6l'*6lඃvÄDH#!2GE; )b "5WG`o\AAQƍ[\+\|^=UDƞ՞Bv6kLv<A<7GL2 \eQ(Kt&/E\V^?Xp;D<_j$qzXCe}/ſt?(ÖQ <*u4ErqIQrm`l a *1^͐@DJD?hoG񦸜j±!ԏTܶw181V {o2(:ot]D.LjGgmmwpaLSD6$ "j(GY@s(D`C&_Ϭֹ$$2ב- S$Zқj-2[).܎6swB @#[|2E'Tr$;s\gSWZ8?8w`:4B#4E@_Q2t p:WtECU D)O \hr2ՆHS4?(ȶ݁2[GA>״Q# ^"ԬTD;tK yGg5@U\ti[*'3t V R?n}5X[:2dvkC3B2oc1ؓLb*s.W/(@ 4ݪߖQj$0P0LtA34vdv!_!@{@̀B2XBfD8dWx/\6AȄg 0 xW,@D$V> c*L Bl 0fA,(wE(7~D\Z"QhK1ԭ8_۠BIlp !48⠲*E* Fq_N"T5AC*僆HC8T+/ xB6%K"DZX @Hr|3rL[(*> 1!G@Vks|m̛>ql} 8[G>E1z)v~p1W(@TGJjG4S\8 ~Q3dZzk$C׸_}NCM6,@`AHxaC!F8bE1fԸcGA9dI `. kW~W0]':hQmKLZoɴq[jw V%'WgѦUm[!Sl #|x3ηZRGAzxed1gּsg Jj᪈SM:?ǖ=3[V!>DTAU~BQ༂N mױg.;ܗ]uȷW>@08-3*sp 4-rb$U+LF˅ EΫB10~ @i #( w j!H(~ 20]ZaH" |M'D ŃT V9.1' 蜂ޱU(S= "AKp&P=Ip*ƶDM@!(Nh'  :[#eIB/UX f*g8ぃ*-VUx(&J9,#^(,-sb0?e%]("qƋb1b!y\ #0䱴a`.%SZEs~0Z9Ȧvrl5XghPP55UZT2⸨Cx'>NST ]╱2%2 eXn%AAhaΎb3kZծVUY[ٲlqۙ o+!5q\.=/]VNՅtUWw[;z75/p^~u{/G}Ăߚ.| b_/ v!a O1aHLo# c Yk<O Dsý{!C}'ы<(#I0x~qa0A؟?½́W>e{F@ɒns%!p )@1G:#K^z!=Pt.gHaaˁ፽C.$H5%G̣tn L6PN OƑ~?87n9kD YI'Σ?GX%ټ\yG1R ^f~g;Mz_&Amnpg?aqTG$U@ JR@ԥڒ6\æe8Ah\K!戤̰.iP p@>5"C|^7bքH8njF:PUQ6F2@q6%2mS v 2pb.q&Q60!WTۤ ~L2(|8dö?RP<؆DWe.c|+uˀ1<+oV=֒E= \Ӊж ` r0 r¤S-O~<&H1<+ H#pGd qRH,}rjB]Rd}Dc) H L@03ӫuMhYKYWk`/-{'WS7\;IXГ"7nIfӿwbo4Dh?"n4q@ lAnکp,R%7N6Ny!d]^Y;0cLrjRKU1dL#}O'qF=CvBh5_A-3V^hmyr63p)+=@_9p5ApROI}:H"o#PB`KV\t%!}Є0VW5W'׆6!{QpXw(oTewG|4 yY4Ȱtԇ p:܃8| m'5XF,qvBC8GrTHQQ`8#2A58#֡$7~gkpR}CbAkP^ *lc 8  xue6]ft wQBzSS= Tk0zpNC;!4 !5P+, `?I VE7O҃@B8utiPb `ɲ#oC=! 'd~Vb "# -3Y#o3 wBϰq#t΂92 4 +,#vCqA#'UiFQCv3a1:2ׄ6IHG1wzjdb޹#yIO"Vn" 7_r|I!@R< yԠ; D)SU"YjzZ7!=@vM#Z #]*if~!` E8܃6b4WU!X)B!5 t8ʠX#uP!hHv<.P9Ͳw5P Uj٣Bl:/f?`"vJ/sZy-f:?`P00Ч`*uSɨB5sJbjڂ|2P@Dpj P 2@ h*Oaz-Fp5M3 P64FL_Щ`s_BG" ! i8|Y" %@XJ: % j%F409&1fwY% #z1C7y&Y yq EDpA(;$+ 8"9ְj4+$^k=#%XMRwABPy[mC +˲R(C!`.%dIK6.@V $I#N h # !y[.?dT bT-ۘiVXۺ;[{ۻ;[yba2򢗢'T [nB5)'pi@BOe2I_ϗ|4wKG \GHahӚm' uP a<Pu]](pҏpi ~zrgT@1:]'1 @'` U`{ʳRUE&pb&W Y%QP.][!ƣP hr4QE7L1!mPBuB_ ! ER{p#9hC=X]ڞ&Y,?W7.ډ]bJ%˰(FMo}۾=]1D^U[!h7.̤}TȿK[@ՍwP#YT#ox3ÞH8t`m?Rp@ m!Z >"#) g>`=fB@_j um3 ezfPa,ZA<"gfpN@O%q !`TU!V Pqf{r-MI `h -=]Ԑ¶==&mhb%mQ֘ h Qt`  &pvژ `?zL m *V u-nQא0 9On'{ / d 98pc.0(@ KP 9G p @!h>Q 0,ap..!6IdKnY gK2t.{7h_"DM~LG9TnCG`P-XR#ZzQD#7^Fb7rQM["TOryd'fvjO'lb/p?'o?6(v$uG{$}7MR5 J?$?dR/&o; ĚXiQZۥ _b Y&oPº_i%3.P/ǯ Zb?:n:Prq:=O=Rb ÿ@@ DPB >QDxF=~RH%MDRJ-]S̏hSN=}TPE=i'RM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}tFXbP1Xdʕ-_,#fΝ=72MƬjאZlTݔtn޽殺[ёGnV]6mk zr#硞]\iUg%Lci HKV^)v6i Gأlsɚ!( 0B(kD(HaN#(:QœAQ1Fy64̠x!OAJN'%`oHqƗ4}\rѠi%'k4Jؑb$bx|2E & ` on hw!Y 0gs%DbRi<1N xjȃPA#P£EHP_YÉ4^O%Jh! Q2a!`VU"z'HAc UJW<) FEVm)*F{ B'ޅFC*fڊ<@ȃ@nF6Hڋ$L膠5>0L}a2e RT apWBb %!hM @.~>(kxN5YftT) ( p;^;$' m&1J7<$W t -։~IG>A7偔i N$ ``hb~;Qj\!!82DkAh H:@f-(ܤ&fFu'JD Zj B IKPBV"iw]RY 0Hμ4@&A"B lF`m z@8VA\*ؒe $>@@P1,<@ z$!0 HPi/)9d^^U307Y  ≂hRC2I"kJ@A=\{ ЯbJq W#r@L 0A bAr&  LI L.^.TA!eJ#LgPXR8x b2̏C@G8 #@Q,dtǁӖQ$beIdۄs X<d01Y$2ިE s&4Ra-˥됁x !.i|9A&6nSo;p2Wg f"ÍhIihħ(E.j!Ѩ". ]--n Z`5-zUvX1x "ծoρPHD݈0Ai*xeRF0XB @1(;U%!M,<;ZzӴZfB὎b \D6_̬p{rĖ-ic]EC6\"&d.׭ er](?'@owջޟBn.r1$G#Wpg]6w|I" < AЦ K 5aoEb$fR X-ebǸ3qqX>d" *t@r](m G,. @(jG.hAO^e2c6sѼ3Ynfg:ss߬'qF WkiExA?( 8$-җƴONf E* Lԧ^I] 5e=kZ{DF1,@(@ ȃ*R1Z6*b! 3C  ?v VQ<"/MXB Ena Ļb@ 4=p - Q[ _xƭUsQ$3; K(X8#zdA(D BI-8 C BĀ.\u5L CB[<‰' J9;\C:t@B\ 1dE$# _9D(4JJO>DQN4*T a5<Ă W T[]^_`a$b4cDddftghi 須qk g82Yeq.mlFy!xG! y45l p"GzG@Ǹe~$H.xg+1L$Fd8'xǁǁ,Ȏ`[ mhh/4n Ȣ!wȁGIٰ:-;/0@x`e 0ȊXƚ\\ɭD;HP}8(ъșJ u$8ʐ4XHh|DuȄ Xl~* -Gl˷ @`¸KK,f=l/`x@͆]0!XK<#\ɹ MpmXd,4 qFLˍŃJ .M"IɁc(]P0x ^x͝ $g8Az =L87քOJ4dL , xK4z^ Cdjl_4t)^HϙHf/9RSq~0L0LƱɁ,a8p\9\6_E\RA^l{F9tTPf؅:ƘɃǁ`Zms)ڪ`bRJŷR_XZЪi%%F-tHuQZpU\8eZ ([rڭm)^by zHxcxdYiÖShڅ5p]`opUME [rbح*HO0UY_eشtMKU:!Tа؏`Cy"Zf8 W߂A VU3XWߛejta0I׊ª1i I}$ޠ>ܩ*>^)i':#C- bYDxR(]@ctᇨxұɅ6,x8m.f QbQ]$ /eXV"_@[' nfh;wUJH4_ 5ѬZc,Bv9|9>e󌈵ܠ@䬺*[^X+MVq![+Ū[.-Ha͉_q&r6sFtVufvvwxr~f< ]p*\f.[`f^e$cމbV+͍XelZم*XTo^0+6G6FV 2̭|ZϨJ:Ufv꧆ꨖꩦꪶj> 0գ [ i&6FVfv뷆븖>kջ&kHXkjȖɦʖ-^/vή5)fP艾 2FVfv׆ؖ٦Nm9SG"E#cpfn6nLL*r>A\R|&D&e&n;FUu#0ےF~2F`FopYmZ)gmm-Np o 6>p\4GqhoC(^MgG5}$VZ O. '1ҮqN H '_YlH 7P(rrq}=p_r,'s2)qsh-6gGg*$7g1o*Cr 5!:MtGsalsWWhVX q"Wx#dFn9Gl_2f YCm29WWX'uȁ]zM.`uN"ч؆dPb6CSx7w sK OsV ry}Ј8(qЌuw0}qPq(uzO?Ǩe 1eX^LSsr?PdF)g@ˇLedp XLvxkHSx  `(fxpyA rm`(mJՈqhvdPy /x=_%W`{OFqHȮ_WgJl|l$|ʜ qN(ʦ0WUQ_]Yhxz|hw(vDɦil@X|`L)]FqPGlPHgvTsOAakWaGJ~؇Հ'/500Sqp~W~Tt~~M/„ 2l!Ĉ'RT !87rc1i A*Wl%̗fT83WbŪe3&РB-jt责G% t^RB.\-G⿍G8ϐHy-ܸr%sKM2yZ 8aA])[uCN߇61-aTnТG[<4qih5Ͱ# n6CjԮ 0b@ a12:ŭP 6e;ƺ #3])o83䍘`(w74 VC6Z9 _zW}yZMM{E8"oQ]sW:ńWx 8\2%$JB s$I*Gh$%]L)eYjeP&T_Pbr)t&Љ62h'PQ^BLffDZR]t%RR9%BR`xa)EL&Ď;X;m:*| yPz[:J)HLd0y c̱"kcD;mHJ[- yuM-ႻQv(W.;]e-J/P. W:<_xP5\R;12d.qz"jLlaBzd-ʧ<0Jė$Qoی8YcORÁ22LQw q *5" `3(`KB+I(@WQ寅[ɍx qA+[j~U$"gc`KB V1K2*iN^bd"*T1CA "(GcBpcN{(ȕh#5jxNuX!juaIMB4<ʆ/Ph X?hH⡍WsD00\BJ$&TbR!f5KY$ y#GlSPl@Kd9_3Ƴ;'By:ZTρjGơ@2 ͖QHv95nTQ 'K#D$,ES* @bXf@ lS1 cr%BR4!He A!.adŪ[ǭPʚ:?:k5R 1-nꑉ,-2*BW܀-T?dc;;Z++!!,_wʇk "pm.Ds)wG?0w}9iKN%/l_G BBTm9\C<䇘 wS< 0C8[C T0TB}J y! aC4 QEB,@pD)mGW$͵=HCRXxxBN: !P ^=E B0R8ъ>\ŬX70Й(qDEB `ÁA@#a p?nIEd/j!#U]Bp$b1IHR$KIrAL$MΤM$NޤN$O$LcB@)YFvB "DCbbC6TMը$6E#VƛXCB!:56CSTv%AF:% 1CXW̟\_PRT2JONΜ`FdNJKI@ 0)e\Uhg%eI@jbfMj2DilViflN4-AݼE8e5 }B&tL $g%nF,0B8E%48B]'G?RA6ct'ۼ L+?$O=!5^5G<B¿$D?|.(T'%@$(|*I. qF("1g(B\=Y <CvL0Te!ި&FtBA2%5ŃK 0]?0^HXN ᔂL<wZsd(9ICLx-CLMB"5YPyRIYK)?~ר)U CѠLG? BL$B4)nɾܘO(ЗHEjQi\aʦmC8jb|jECDF`LƸ9Dʭ+.]@*-WB8F6 („-1_4?Yj4VCB]:M.r%1ddiu-0w&b EB(BhB8lQ%.-R'"ڬj/l[B:(D(+@,;AB<e-HCh\B@@)xCL6} o/-"V.*Y@0  0BDB8eBx[BTBh0Hp 2/H$(.ܪ;"Z,=-Ep+)SB< $,$ ' 3CB H@ kDt)D1P.sQƆ+D51C$!(Ez?D0AD@7$-BJ./+r_G'Br oCB%,#Ho@2bLeB@C*,[XOB BI2>pG20 98$D300BX@hd_6_/6X{kbgSi:`a:gWE(BHT_shB v6nECB$66nvSSvnwGXlG'mŚ6rO7QdazF"(& 7\w\+u7DY8> S<RS" AwSK^oxxv7x DD@4ܯ4I' D1F!D2x.@p<]玝Hs!0X1t B}BóoB4DNaBDy19CD%E<@T,b/xEGoB䢌t\Ⱦ"&cjJ;A)dC4A*Ş.s";&)D-_6$6D$&#px oC 6M7wr "94z C,yB|IGDz2互CHC28wD{"+?*J+@**DGӓ''?1O>Sig>Sddžw諤>ꧾ>뷾>㬔>%-Uc־c36.??'?/??GS[?ckK{?.p?ǿ?ۿ?@5`A &$PaB 0bE]ԸcGA9dI'QT%E9́1k漩+N<{TO3EhҦF:%*5(՞V}2 ֪\z ج@ ,۱fkbK۳Jڝ (_tFWP%{TqcǏ!Gbe˗1gּsgϟA=tiӧQVuk֓aǖ=vm'{ֽwo߿>xqǑ'WysϡG>zuױ[{wk>|yѧW}{?~}Y} P ,LPl!P ) .A QImQLq$D*$aQiqQy R!,#LR%l'kTQ)[$+Ydq / 1F&zF#_&f_;}Hq& Gxs 3Rh!Vc"DXTK1F C0!sL*dY$}fy&u~&3Tgx Q @XMltFdkVC4"o#摳%'H HF[ )vI0CNX#8M5/҂" l q?QcCB`o(X%|. qfZXJ449./ "PЂUhؤȚNHHL(lKa"' OftQ<P* j dU *GFot8N<Ɵm3"*DN%a\hn|f &dkq7)JLȝPkq{'!QO-fO_onj(ʝ"^v f80cm!FEUˢH$.Q$v=FBGnb%4 bZ^@M؆6yhBDW2HN`:%؋[qD8H AMXWLp;3g0EWH adACc vA2=,F[b'Š'Aʊ3E0&YmPe$ Ǭ<⯉԰GC$!¡A8%.A"lq" 1jq1324!6EM0)ʉԪ"GlDQϏ"EG#&2Vd4̉Lr"(Dv\$ơhނ&7"01i"⎜ 99:q6(J$N$8QCS.hŘFRSZH.X4 K@@N]ӚW^KFFd8i8u8 kCQDzO9i+QݫHEmekҌ ka%u`#?8ecd)؄J62Z[:Yb6 -x@v"? Ta'n#,Ep9Am#ꮥ{^ !,[H*\ȰÇ#JHŋ3jHjǏ CIɓ(S\Y˗0cʜI&AQlɳϟ@ @HУH*J+(DZJիXׯ]C):$)]˶۫ʝKwYOƭ˷߿  Ӣ+^̸ǐ#S+0q3k̹3ź ӨSl4PCj۸s(ږ?NCɣKNUM ݺËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(O@+'4l󲣀O7,O@-tBsH'l2S6?+ RK@QW/vƄ.?d;sщ !={28oH P"Bc>fU0uGA^EI@1p# [o4D8[q Cd8D{xR`-vC1+6HiOH2E6fƅlvH?QQ ϠDQ L" anV8я>)d&.w ~ݟ`'S;IFrH2{)~PRDymPQ 35eY|הK4/G8aT8啳<@Y dO?#/.G~1#͖iLcټ:PI\rGgΈ 7]@ %-c2, F]1:{PSUuA (K8l; =~£# E+~աuMII^EWLKH?CwP+#O!TLWT# 'y2ٌ.4bP0B'ήDˬFZ'&)(OTt6"650Q? P8UMLFg; y*c3M%9ʦ]?Qao2n"w(A#tdP/ryPӆ@3^5赙,lD-y뫙B&[~F(H58EQJeC¡>]x0*fC6e=i$چ6tl*_ji2} D@0}xXEYֲF47og>"PIN@9+bq,;CH1c^ЂtBh?O'-!1ZEh ԰@e\m|t6 U;}չrWt]iwָuka1!Ǧ6 kۆMa|?ڋZy=Ѱp3)u 2hJDn0;Sƒ%hF[ zp:$xL@ n^ImB 0JޑJCYiő@/G*ҕ30IvasJ﹫~ \ߊFו~:0=WB*"+$||FйΩCB@fMtp}UG@ZN.4M3 wMUITbI @h</%:e?|&]`GygpYE0c"ׂ cpty{[*tRnO鋏McoPvxM3}ퟪo(3CG{Ao@f8%!kאgr Qf7,r]*(W%ѷMj h*7&x(*,؂.0284X6x8:<؃bUE'@f0p>8& 6bI$MbNiPX}dcc8%cp)p_VQ$b 1pb Q za yz؇|~8XHTQX;t" $:jxHX&( 3\bf&AhȊ|"jx*Xq* 6Xqŀ+0iVñmd  1bA\%wj0Q nH ɐmh)Y8hGS%Ip  r(SxE8"op9u?q [W8Q##Y5a2Bt4h*ْ.0294YFpYkD hUB_飓 cX` F9' %ԔXbD; QoT$P) x @0= ?d py$V)  {#ts` oy:RG!N@$Ùgx0%(]?$ƶf њi$?dQa@כFQP%~I[SҜҙڹٝ’Y%( 9Ya96Yv6U8r#gQT}75'_`M!mP 65:NDGD=pz @PI PP1u ki  %z@Jь ^` g08 3 +JP !@\iR`KZ+ yL D9!@d:XkPpN[a Ga*[@9Ch qK8)}Jӗ:'G¨ [8Xu 3'* q`A d (䔡dt7(@ J9Ӱ(9pPmQW8J>@&a :a 6`:TDS ذa aE7>2ęd<R$^3 Ee$C(,+/K<۳+q dJB$D[KrH$JGҴN[$PC2T$Vu#\#^;b!d{7j[#l۶3p#7VL+eȠ 1 zQ&Y* Ё } L pJv9 1W TJQUpq ۚ}|( P9Pa,{Z,@{Є,鯲*v9p  pŐȐ*Y0  } '(0 ҁ- =$ Ą ͳqe= m;_隮J0`р 7 @  '`^~ #[՚LCc`hP! 0@S p@ 0 P `9mu  ,/JpZu;=T;=|Z } b| z1"  8T}M.X  3]/z,.3  aw*탢 >0n^&f5!>>0,.&vx0\daGҾ/Cߓ>_?'|Ŗ Ţ < @ wO w*L0 *O !R2\oPU QtN (O*h'i +Lph*:\TdA ._QJ*ZѩD 3LViѭS {Weo,V F=l8 0 fo?v:bV? !H5 g@8+U]"L_odѣ bV `  @ ?+/ 09px@`T8Vm*-^ĘQF=~RH%MDRJ-]SL5mNM2aӒ" bW&5bNU^ŚUV]~VؐO{ 1I҆D@%uśW^},,*GPu0bƍjYcʕ-_|磁Ц=YhҥM4tZj*=m[l`Ɲ[n޽}\pōG\r͝?gItխ_ Fٽ^|ˏG^zqޅZj_~mv'bf@D0AbaP0B '0LE ?1"y,꧟DjBh(ŘZfOD:MDQE^<ѥ^JFdI(Q+ 7+R0w9k\K¸"T戒JD$R/lhF0a@)nK8Yv ^Wj2:#MojiԈk96YA{=lbφf챼{̆v=mj3'hm(l9QB/S/ﮉ(TEPJE еb,Q"x3axXcd/R zIGI?~)l9~(R5x԰hX( 㛇ԇq>dIܲ H$PË;0@aB'ԇ/p;3K>CB`p#: v86B襗š$ m8{x v q8yx CT" 2]CAqADxA<3"`RY=^NDIadyؿPLSI1TC;;l Z04jl N>eRqǑkdl O$kklٺG̈~~qx\Dy8灇yH lPuuGC1^:Ld\ =t@xȇ;Hg 4-ɛp`48džhŁAl~:(@h$6{19Yqx}ؔ|tĈ_邬9AJw;$w0Lɪ@q̋xwJ0 1dd1V$^Q;OH^RH!'SЊl[GUt<.MeL~z ήv 'X2 4O,K6] ӒOsAOsx95ɺNM{)L/=СS@xB}K}X!; HJ Qd¨cɴjsu [ J}M !M 8:y"MѐL%K>oA:8>Q>WzplGSAqps3HόpmJ?t-;3Iف# ˟)l5]SkT ESlp"MB09$^2f2@#Jmݦ)3 o`Y8}xS|S<葖ލW?cOH6X ;`n,Kh Я0{;FAAhp K`n PJ֛٘8UTqӐe`oHfd$i0ʹ{Y^;t@X#8*yݍ./ '@/1'2Gs iH6%UZ;ʐ_79': q F!8RQ NimҰ/ ҅R3n1Ȓ' Mʚ7s3hφ?V m4ԪWjdֲgӮmv7p7`:qXҧS_9|dKW0M8/o>:?~A7Xz=SYx6W?Ls FT`NR{6!j0*$Q%X `! L"=5xcLp;}PT: E# F(Q*@4eÐ58bTF%aQ, юUE> &B!PЛ=s\Aִ0>9fI!(Q 3eG`F@*#rE Y`H*-*=8QyQ'GDJ/Tj7@P7htAdEjt:\ApRP a|@gFA|P.3Ir/ֆ-I )CUjL]0/kXFitB`Gd=K2$c4qA`ZPD\8ttNAPH+4r-[gF_b FȃuI@%4k0ə9/tJ4q˭U<9)Gjԏ4m#8α؈>^mOdƍs&C%CHf6s{9NYz48 84Ď#:nJ C\;;>髿>>???LY?'p, 2pl (Rp / rp ?(p&,! OF$('*m!sȭ_谇>|tQF<"%2N|"]#7̉0pa 袋^"(1f<#Ө5n|#(9ұv#=^" )ۄ! Z4E2* !GR2%3Mj'C Q<)SU|+c Yʲ-s]겗/{i5**YAGE4oi Qp0:䌰̣ɆLd$<'\DD%DAM( @6oIAv%m^"BA F< U':#ʕGPP$ X*^eʋ@"xjB7P>%`IPBxB tSiU`(4BYBXૂX WEOB)\"HHFe -%TAq8L)YXH]٧UBT=%ġC\fG$PlG-m9BͻnJ)G^ #fR"'dH ĶCK@ATn ނb-z W ZT5 _d *Q) €b-Fo })0 Y0FASfDMFq($ X"e X@5S#ܺF/^Q&Zb#(Cix }2fV@$ pA8юW~2HT @0pFz9N@F x- P@>bHv ;=JiL-RV ZXΞ>I` b sR1Q u-ɠ.C1cD7 Y2iElJm>‰B@?l"b0 |c /Q6AaьuBAXb-|C1 k^B8hk@*/ BAz{oa`#(?𫈼!@ D\N/.s,xBa6ac"!UJ#A~􅈃p3:I8GBA\:.'b=^;!,ZH*\ȰÇ#JHŋ3jxjǏ CIɓ(S\ )0cʜI̓j͟@ Jџ>:ʴӧMU R`PPjʵׯ`Ê;6';ɪ]˶ۭgʝKd,Q; X:0mݿ Lsǐ#KLyG3k̹5E5ZӨS(@Aƚ(ոsͻTФ0ȓ+_R 3N`5vËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(cW2Ģ4l3X:#W#@㌣:l(9MDE 4@J;=.B_'_[eFU<ͨ N"?l}1*E8)+{35 d&9!xaJw"؄ U]nۡJF}X$<>B#a]Emn("#t@GCb($El逢@*ĊEEOX:!EhE3ZѸeoDdhc%_5n"@4jk4*O*EU@\j>~KE 2 :∈VI)ȬYMZֶ :ކVǪ46R0_@qU `HdM>I6D:cBV>E 8g))hC0MHje~XP>=]Ñ+ (d"y, ajkUp%=J;&k騚rE2?$HBZfWëM$c?BvN/7ʒxOꫢU{+25ȿ TQ:/ W.aKD.jΪ$ e;^Fui`1o.<;t5kB>@,1_1Z##DF%)\4qL-k[<<%gʹ" k!vs ׮ݱheG;k41 zZ\F2!<괂^+r]VDN+ @:e5DS_{rp#@ҋw 16U! *cI7il҇CC4yk#nz<}p`\Px=lՁG>b(<~&{ߴɏ :>I%;$ omCV3:J_gf,d'PN%j'HdN6l~2 r ' Xr%pVcqazYU}zbG!X遼eB>*"8RF)BDŽM脣P*H8RV؃X=ȅ^(RGHfx(cA35eYr}<# ±(mk+mxG~, ib|@ PIq~7!%ra=2 ! Ab@X *ŠHf08${GoR5%Vg! dȆvC4qk#dČ2uz8oؘ(߸&Xr(긎|(1a? ȁ4^cqw9X΀O0X' hC!OzrL!Oˑ5*vȰ 98Y? ! x!7vX"pP ^u;  !,wPOW@]Nw%}ؒ\ٕ^`b9dYfyl1᠔h)$Nj n<N@x%P}BTAT )%)OOZQ4U߰SPQy%d`ԁY?YU:aS%EM2]b c"0P~HѰD2JĜa bRoC]$ViBD(h9&IYٟ: ,VY^r #p9Id^N3 !vRu3q ^9y%4uC* T4٢%pC 'x6%ֵ6 @H38>NzyE#QWz"VF Ol ٹ 1za) ұ FqRLQ aZ1 Q&E7h z8 !XՓ@ 80  8$aa>q !  C QAЁ  {E7c#c6"Y"݊:x;斳s:"*sTb%VүO%{; $ jذ&$z!["D2$+$&{@*#<{B p 6 j-$:{Pp; ԠP_)ΐ9 ZO!ay %4   !Q  ` a!F@T`! 1 R 9E)Q ` P21N! 21Jǹ09!O@10#:0 p AP g6"LO, PJIE <K !Q0΀U5:yԠ zCiC\#ؐ:eNj 4q:@O `Xu ,p&Q 3 }p  un+:$U˰uQ0WHĀpYo q \#B~ω6Qz;#` )K@ l @ fpQоl~ib  OLЩK  n\̙΀*bac@m3-(! qv ` 2`J A aC@P :p:( E  \ +`J"@=*¯@<z0  u5a xpq̀Ȭ @bHP?oY[ L`9ߐL8=DJ|}a!F"uyd QN1ۯ|%2'>)F8hN]@ ic7 hvZ Ҁ jHi P ͐T x#gHN9 2g 1 o\2nO m *wـ {<qRҰ K `H a N ŀO}d~#7J^ tnJ,u ~ >` J {L 纰,7% !tĀ:. V̧$gБ紐> A( Î?^Ǯ(ga2.g#}0@Y n1^ Pf.~%\,ap Pn??0203  @ 3 cV&/3 Q0Kaeǂ WI1OQ ,>*9J@6U@J ƽA = oI@ ! *Y 0\ ! ?a"m r NI +ߣ3)e@{QFߣA3 0OA +Α Cato!d`rq @@ DPB >QD-^ĘQcBK=nRH%MDRJ-KZ #5męSN=}TPE 0TRI`* ā@1CnRHB) y2z+He-qL&)AN]"A'FexG 5j A5kO#X2ae>sH.un (qIqP'.ʄ+BDzRˈ6夨('I @L . e dryD*b6OJ EռIEYgB%=i@P"LA6 Y Ѕ4W< o*b"əFuZ6=l,ԨR[v lp| @2HJ*KȶrZB)apwņ7'ȉsЙG8=^6RM\*:AQq;L YH#C'8N1 @NkL YÂ@9Y5l0HE<ùC;Dܬ= O [{?D!q| 3E!Qky,q@7.}~@y8d7.2tF `6 S/6&xoE CMi0xSFd\FaC྆6H$c"B?P<++2h4H8iv3^wP{!\ /.9!QȂ@},9벆8h3H*{ 0Iľ>840p rd/.yi 4J.úa,{̈d#1X4P 7ؔ\Kx~o0y<-L4<spl2L~i &l(8/JԂ}`6C I`e^^ǘ a@ e.UAZ] ax 9XM! #؄XՍ_"sbx-^İ^a( 0/Hh0ʉ-5v)!hv_[6 h>`=^ +8$@1n/hb*J3"8E*cC>OT%7vJ'PFe1dTe뢎3XFb9c[pL.]{]41 eX#Xb0WƘDi 8Íkx9#>X́{P8o8gr޽F 69xxz&<N"Xz +`]WxȃHNhgg EF YPh4!.hyJ.\yK9dЩ& Bx.0ҭ`i8ihv B[00jHi^ 拓Fh&!F!zf嶆k帖ak ykk뾮g Sl.nlS~Q ZX~0H:k ^IXVuЇ&` CnkDɬ@`ȃigX٦ 53f$ 0UHP GALVfkNH (3@3ѽ9(U`7{9iNnN9G )8*Ij^)m FkIF1 `]%fr( (>XJl_N3)b3 pmyNiJ3*l /kSx`(R`ؠ`@3xxpxqJ{Yk שr@nR/( PS0J4d@ɦjmؘqp5P*.-"gH~k8@lHy`E$TDyltP Q~#чy3F W8;egvfs v7sAv w{w}xqG yg g].qxcr'y]d|Gy3HpSẻHWpW_b}JU(kXI[mx Qx/0W?eȁ?.P(gky0qdz=x:ߵ7/YR 3a>xkzk/.t` c{"1)a/;0x0/׎!|Z70J|f "-+ g%` A+*||`V R,h?2l!Ĉ'Rh"Ɔ.+#Ȑ"G,i$ʔ*Wl%̘2gZ\HPVH^,`yK*-kŠUpBe0;_Ct&A~M,3W$-+.޼z/+TuUE. '֢V"(5.#ed!4#J5زgӮ<֮@(6ĊkK '27yɒm! 7~P4pU^PƎӯo>ݪjx#Exw<`e' ADIZY(\u!z!!? f^JQ:ά(⇫#5x#9#y#A 9$EyAn$M:$QJSZy%Yj>%a9&e¥]f&mfo9'uڙ# w'})k'z("k(J:鞝.j)r9:ꎏxZ AB*ijZK-z+ζ*Ji;Ѱѱ%в5г E{дU[еeV䭰ߊ.ĎknƞnȮnZl0 ꋯo̭™2# Wlg<GLq"w *Lr0lr4ό֌;'@-D+loA14QK] Yk4CУ\=6٤@-72"A=wu}C)@} 7 >8~8+8;8K>9[~9k9{9Y:饛^aǍ@K4$;~㾻?#3C?Scs4"&Sb R>OHdI4(_Oz/ ex`LQE:D?JAA~E dh Ȑģ HLvi'XAB!-XDDKu*E^P p<@ݻ$cAmD߿%aT_ ŨŇ#KL˘"" ̠CM闋n^,Ӱc˞Mvhͻl قhBM N-mf*ӷ`Ll1$K9 zP߀h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'm#@0 sC*s5Xw58 -Pvp-@ؼ2?q?8 $!;@?}:M8gIkOc3.PؔW~q عa1Mƴc0f6l#P2>>#.4 ͣDuٻ@$;32|›6S}aq} R0@82cß;`B؏pP @6bUV(XA=mcc@߶qpA@21O l/ ?RBw{6L =ĆK<8}cA: d dP7pMJ@pPÓơp0(zǃ<ČQc!FQԆ?>y!Eh6r)Õ><*_$ܜŪQ}) lCDt"8tR#* ũG 6y#väH8Vd&# h֑J`,teˁtÁk"p+="C=2Ĉ% X"8dI#!! 3r 㡳>a k@)+~nz6=86&R 7yE GmJ'$) p%&ajyS `yDJPE΢`00jRe8ZthHx|+bgxi͎IUbYeul*%+=qhl.bS8ژm9?:O˨o]qЏHaSE nLyq#?1Ppۓ#$^|!t0@|Al<ǪoOR ƁI2-Xd&J[B9"UJE& $}1 Ldc9,)˨8M\6dlX%}Bi`PB }xXcn4=>y&g5dc .@1;UY&{odӄ#3a@AV@M x}Jl$_Hd0;߾!xx>%WE?k}vՓ863'0BT4@wV7cM6/!(qCnrGZ8AK5Ϸ,~7# HLqU ;/Q r F@*i?~2S2@<˗+7G|7,$}PQRO+F@YM2Q ڕ]@ uLCh dzXn+|(~nf~7Pn%gm2 6xq)Rxx#u1Nʈ#A 8s@QTv $Da ]}o5q6DjI8m2BaxE$0A>_0i±7hj0X XT ç!>Y7& 2 ]`4KF*yz2ЀY థ2PcӦFHsz+:2?`2 *+ 2YjTG42 #=#sy0'#=Ӡ>l+*R6iЭV $cȮ)A )EB0 ֠I9 +:R垄Vr$DmcM +J]ٕW) C`gS*)+%'˗j*Ҳ6-8R[BH+-JrN-M2T,P{bZ,\۵ǒ`k-_t7٧dRqi*3(wJ$bd2`O+*u[K~[@$@\sz#w *kP2arbb`;[{+!\b;#{u 75|h0[K!#e5['{7 t 9NJ3)Z0 $;+TӸ,, 3Y!-z0jZҒG{ TpB`zχ VDreTl[3!V=Ȇ [ 9Tj=ֈBSg@f,נrOLpט4,؊،؎ْؐ=qȔ}ї=+ۢ斃#;{Q7Ɯ-~Q=&\  !|mj*-<۬}# 6Apq{ ;TU#Y `uu_8l֝Ԭ N P & p߽#+έfi'S]0e`n mG IW -"Z ,&g :#%MQ@ AiP  s\ l QP l q(VR.#̏1 Va7q ]V=U ;$M1.-} R;a 0 i  @I k Zi͠z a 33ga@hg 'Ydg aƾ#p\8 MnEN˛R7?)ȉ%U^~8Px1iY<_RDŽLQH٭ 󐏒$NPr̕,򐰙:%VoYE[$,?).2(4_r8(:>(@%%"a2H&JaP%RoG_]rZ'\y .pYE` "vo} P~|Od&c݋!7FЀɰ /?&o&:ҥ?;D=jR:=;`_@@O1JJeA/%ߟY&?Ͽ3_3O%n26ie|` 'l_.\ Dmd>QD-^ĘQF=~RHđDRJ-]SL5m7A :TPERM>Uԏ-G\t=VX2SVZmݾjEZz14g U̓68bƍ?v<ņ h֍l5ϜMFZ5ye[1e 0#ҫ}8mڶdm6p͝?WYX eW[0t*UP^z@4yKv{lk&(ZI qP l'rctn%9z{"N6 ` ě.xX2 3%g)=&9(!gAȂMB2 FNdyȁZH pbFF i B5'.7¥ H|yh"C"1 Y#HhFiEs% b Dƙ:g"(mN !#I9蕇Det@Y4N: ԉ blM{ Y] 9l39 RHD]Z or8Y͕ !hF34[ q{heb=N , 07={8doX 3Ecc^([" A "N `&+s;gs6j %! 8y!Cjb'@cωN֨ 1#_'Qbfށ>}M*z!(sh,d Qec7#GIZd!dg8#H4U`bR`b 94 7@,W$_ GJ"":$,Ayl ;D)C`E: t  eBA J W`B\R@GLDm6"bI&l4./a!@pR 5t/ y,C`}Y9*lh!z T +rI !p$HU %xǃTaưd`~3a#h;6x\mgV1Aj#A-CX2y}t@ҡ kH'~eQmXQ 8$ː:)" ʑQ%`C*3@5,aa}cXptJDžcE4|.ÖQJt,ahv$ H2 a8Zg kךgaG3ɞճVȰ:iDY' | A`[`1_qqÞ/lqY6/tJn%tlp'\$bٹvqӈp"W F-Wch(eΰ[,õi+Z,׹u bE`*݊`/~^bf w?݈o|۞:-t L ExWf"E0+g6xp%_M? ^-DztgAЇt hD/э4%Mқѥ@ b`p!a0FVկ&uXjqַ.5mk^׺vkavld/Fv…Tkj((%@F:=!Fw72vv=oz0p  PEHw>p/r"x%>qJȸ8ґ7;)>r#-^ 7AT Q!Z Cɭ4˳î AD! ˲D˹˯Sˇ6 ˿D:TɰDʥ dLGXIJH̾ t$8DXRCJ˝K$##"0dltC눈q``ظ $BGxIȂ8$6U 6bC]};](&?X] X P!&Pb,bBP y.݈ rdȃa@h|;JW0dbދh&h ]G%IMe(>K66 (h b h@6(}#Rha8dj `0sVbAѢeb98& #Y ;DJHIQfe-STVe8+w\0wCp[((s(!mq`vnJipfP~RoPbF.rph؜^Xf,['_ ӕv\7j12"ޤDTȅB,]pS0_+q-Z gM5^^T_ ?^]‚ȅYY]$()*+,-./s)oPۅ&nmYVr) L- ,4]a 'B7: ,jd*p@6s=ŋ^H׮77L+JǖcVwWXYZ[\uXtZ[jۄdO Ou&i67iEklmlWvz8 vQIH+&9;Pugvwwxyz{|vqwSNRvd"]CGt'5/iRJ,UڑH> !Cl}Cڀ3F+:ƴ,?6H?h  F| oP&90Fs`2s:]LKq50.5 3CO[L88g1kOe4v@CԂED:H<&8"pWF˙i'2y-qWgtP87I':UU4qU%Q8VD*t O AaMiv9` jJ3|5#8b~p@ 5'³,!H|FxN /O"Y^B8FMjᇻdd,+ 8uHd>yGcJxJVUZս$~H!&NS,la%B\cϸ&W0| B'b8Ҳ"w]"7@!d&ae,31ن8F~ >ǀ[5ATzDe/\ta>}.tEpԕF5=[ N`FQ3 PJ$}D5\%y\b4>2N'‚/X7>:Xwi!b:acCf1dV"H>!qf!kKQY)[F⑳%\Q$:́d9,jB<‘2ġb&ۅ*е:]&Cs t`?@.8ӑ&E iW)\n%XY2."=[W"HhA2O*+&igdlW6rz4e()urM0g&m4L01ΑOBÜ7L6na'I g7K~ONVs!U,5q9OgJ(Wjq\m*o0C~[؋"xw䅢z'$w-Ҍ)e LCIb$ 8̝$թ1y5&V3k^הT.Wmx=+4 QD{ A;Ac--2Ncq1"L6@x=qB"(6T!^ʒ t0D" )NAg<#1JMwM{ZȅwFyd ^CAۣ$FK~ˬP# u°qE4˝G8׾CljC |Q eC @^>EDм0W]d@HF8]V8Dqxi]E`FC CC8N`JHYC@`XjYH2lC p4LIMa^CGRĨ-t}T-D8OCMRFED X1ȂF2.D}œrItaE5ɀ8 SiD\-)CtX~Dx1 vbd(^JB.h`݄VGx f(Po)eKeDJ/FA9DALWC8DT+A]^DCqLB2 2T#pb̈́"AL<<QтT.d( QBvD ?8cE`pQ ^DeY CҘAAD5CLK$%zE`E4E)HB2ܖ|[C 6IR`W$BTJC LKԇྌ:(6d8ff]&%CH- C7R_6LM(F0 mUFDQl%DCKF!EeE4G4!~KZ)< >8O8t^.4D D$ebqIQ ym(C&(/=D@PhCSB| A < dtMsl1H)|C*x)C̉ͪ]$eE\^ KA60cef6R^uY<L215)UD{1D:zZS.+dk**W^C@SF-lDHCÔ$4lF˺v^MDڥtV DVdCb޷hm+TQF-WkEmCNCLl#4$]ݝ@AAԾL_+R)WIdKphPrܮX>t@jdȎvU@1xVjB._}PΈ)nF6_|lzR˸( 畄A/A(/:o>F/BUh/n,///b¦'CЯ/ޯ///. AW B MD`#0Kbg|ZHn KҾ.GDРDFBMmC|poQ / K6,B,pF_ֶ'mjgKl1BRzJl]{DHO`iV, qqo~qGp)?0 rc2܍Jt0!wEDA -$O1 %KM+s++&'{2.S@"7RSmݑ0@Dh0:Fl'8/l26TRDܱo<#0$X"F !8$&@2g3=D A7,p<7LW:J-+CKc=GJD86?n,ܤU:H#䊮8-D4WAmo.f ʯ芎Ր-CTK5Pqy>K0sCLS&ttFV=^:F3y8-\%o5\[E[St0k1fP0ALS⌤0 ,C&|6UǵcLO]et %L#4cCp !5F.5MJPhvC(G:lo1NuuELcГl8܂ 1CBk܎x-nP D<(Ch2{B赫#LyWeL 1DBN;dB`^!BxCBBu.&Лx(DB*;9CyWy-@:O$,D:IYE3D; k?Ĕx77zDnďWg8F|Bzus'0@CDA,ª/(AzgxлC LB *-7p<@Cz|\DR6D;*ՆX P<˻ϋ=Z(D9NED A|H4CBJCZt&5گ/'cA0C,A\Gh_BWDWUAC;M|y!?L@o?>p>=yQ(tCLλV+!?Yh~ #+>KQ4Kk≧z}QHmF\hzLD0R%<~ R },(9*h @\H-3/LSMP)ʊ4$ț!1(69|Vq̈́ˬ%C!T҈Aǃ'8')O'uh*BLVhcM[q5F fIU a[d^kP!BL /)1m[0LAq{*`~,`*l`_xCTUCwLG ? 5 ùG>xI  7%L'<\'kր?i,bqu#i #E_g!P6߀gy g$}|rY?9lZG{ H*!%-`"I,UO^6m64IoC@0E#TyLzSFSUYѾ}5&AIOڵ{ͬ֙ 0*)q0Vֲw~Φ4,$komҭ!Mzη~NSKsО"[ /z&:\*Z!.Tk kgkǽj ]c~xn RJtOl ّ[@sE1Njyh%) GCu#3t.EDc%XP83Q #B dJX5[H3#=s5ɘ3(2w{i@և329&R*.r=@POh+EH}\} ט3:,XՋ *t+FXrը "QWdG7Rӏ(*@g_-*Ibd6+8<ٓ#>B9DYF$xJ*ٔrQp@ I A@ iB  IǕR5V0b*[QUSt)(|ٗ~9Yy٘籖9 rdy'IdxIQ 9&;f ) `sUqcap! ! f%n Z c\uq H\q=ԐL`-j!,oY{|,\$2t\>rz\a~LJ'qeƂ!aq cFTu@"d,dGTsP\VdL u*A`1$qʢ\V˃ě,ʰ!Ĝ0 +ϵP@ Ap^I!04` P! 5@ Skl:YȀӠ[,";HNYK{oV$ ? , 2K "Ipq:`P̺ ֠S!2S *)jӛ&0AZљ+ 2Z70MNS*z<(< 0~`:P0r ,!`*P0 l{)&z $ W jQ 2ŀ P VH \Vz)u5C޳A ` P P&^⺠ %N*-lEa P㺀 >>{lo E @ 5߫ R>RnEP7 @䩡)TN<4( lf s^r~vxz|~>r舾>^阾~A>Qa@L\IZ@붾>ƞȾnna }y >vtE! ~  1" @>RAZ Nh71 װ5@ o36yf 7 `R0ff0 3@ @ `` 0GV fZQZyp h2 0  ` ` b%VP# @ _a"0 rp 1W'( 0 fQ0<"@ y` ` K=/2VP 3/)` " ` )by?ҟW!'b?ҁ%Wz?{ o `@ |4)B >tD)^#=~RH%MDRJ-]SL5męSN=}T(HEEPM>UTU^ŚUV,u}Ve͞EVZmݾX`śW^}\n FXbƍu y0َ:ƜYfΝ=YhҥAFZj֭ZZlڵm߶ 2n޽}|nG\r͝?Nry'ϣݽ wM8o޸p_|Sٕ~I@D9mdADxB /0CPC?1DCOD1EWdE_L~!Ql`1Gak1H!Dlh!I'OIqJ+W˥H$NY2L3-_R#Y<1!b]ڢ50e1dQ&$ds$Ib%RKk_VZ iJr%@͍MF;ZK=$>LţDN@eV_g%aIoP Zj%Tkבh͎&ZoA$Wf#:*$B>*U^} NJ1aNU6E[^>$V nJDeTܢa;zAK6ގBWV,:>*ŝhTbJ(W&N ŀekX|YY:3wQJَJ#*h].Ԙ$1Yde!b-%˖PGEKaP:px av8$e2;-~)QU,867ck<e^͵w6v=v^vYer=e$[:d^(%W [aq%=u^ѻؿ\&-k)g^ @`c*>}`MDZb~@Ow`[XπO?`E(Uď8`@6#a PB :CY?:P? h "![Aщ30Ռ'vы؂UֲU%ikV֠hG;5꥖ ՚'9G;9H*ٖllLf_%\ȏy>0:Gu,b.d Z>ä?輧iAl\##Y "`#_x17:;fBN6!>ĐQفAC'ZzZrF'95KdnI~wF0lSkBp*- /='$BGN{}>E}]?OƋ !$1k| $rnϭŬg1(="БIdI6I75qh G`v#ˮfS{78JpGu&2{Dw~w_D.wߋCa*8,y"O4>ӻӉi#=@?u? K(-A:ɿ 0k0q(qS~p)A6}0Bx'yh't(&2pA%sT{=hŽQkZZ>B3)~:C;$ qBϫH^ ě1 Ԙ>39mZ~LzDR2ny7*JĮ.4PL. !"[A852-E1Oб$LdDSE`FlT>}A.FX=gYp=@ITudz{,wP inK~8E,8y8h6 9x树jGwnjGHθG<1A6~GǜUs4l zsD DP .%@ܰӺIߣH5d*Pɬȟ . Dxt0~0K̊*@)gɌ Q@q@ .1P@ŋx˸2,z,KSKyKy826œYÊ1/DŤtm3zG}pD#+@/w HIHKMϢ$Nh:psε5׈A:,iwCʕ0,\ =$-iH4PZ>R th9 LɛC0Ql ЩRh@:TB 2A!= ܆"U }HQ,yD4Ҵ#`rrB #+0CxX)MVI^9J4= :8--TUS;M=U g@x0,F@DUM= aȯmp[~mGRNշ@@p؇@w8eUbX @<,lcy3cnJ@ﰨˮ/3$`=/k5(b(D oB}2.r DYqlK:US4,ot );Xi'P}W1؉+YMuؓER"mm xS*]`ٖ1ٞՑOۢ0tٯ٣MY%ٕu&1MИ}ڪERSw ϸQ2Z$180;5.( `Ъ+!7/lUTq -AM=4 U!ȦYPyP?5U =ԥu&E0]uߠ?@@y5IhVȝK.| C]`:xX4(I1; ]i^   a47 ZX.qȼ&Q4^>" Z Lpbx(dxbi >uZN@~q 2ݭn 6i=2,ZV9xC`wvonݩ`j5 p!q>C蜏0AgF `׊BT=xdr ΋'qӢkVEAi >:G^ q0E.[#W '*"YN./j+" (Mn5oph9GoZo Q&7^t/$yp߭aTn-D~Pd}p rI\tUxG~sA~~(~'G"0w!mA}olRp ` „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*Wl?3 # 'РB-j(ҤJ2UsfMMRj*֬ZrhbA̓- L׸rҭk.޼zW6:H´?0rm1Ȓ'S,Q `M(2ТG.mDK0_gӮm6DU+̈́e)8ʗ3/ #4a#, Hh;Ǔ`f7<ӯ_Fz{V} 8 F &E ? B#$Zx!Jr@)"q)Ř#ByA}СcA 9$=8I,$cB"Hy%Yj ) $%eys BȘh&q:]ty'yR@!,WtH*\ȰÇ#JHŋ3jܨC =L+H Ȳ˗0cʜI͛3{Y ϟ@ Ja+5dTPTCDjjjѫXjʵׯ`ÊKVbφ4CR Kݻx1)߿YG#b 0 (M0YXX˘3kFsϠCT)SLE^ͺװcK۸sͻŕ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0l<2G7No#<ai:83'6A[|?OAH/LWmXg\w`-dmhlp@c8xl'?|S@z74MAxǝ߄M2ww?6;"u^NDӁt&HO*ŭ TMЇ>Oge8@w4u[f҇EjΕNHb%R˭`|,LSء?R]!2>{A-V#PFڢ*GJ%n?xE¨4 H<\!Y ,5^ TIc69ni!hˢeFwPIг 3m~c ה`f+CW5mC2)`8T@<$X4a]Ta[Į 618)5fR:[@a]a7+Nf;ЎMj[ζn{U3oH+lnVO펷blvޭ{WcLV7YnOY#NI-_s֔Ə>ߏY;M~yȣɸ{40|q'@8^jĕ G uGEnuXf[6N˛<?ꔱc|i;+Yh|<žx乆2ܮd0rpvq)jaVc_7d  @ps;'.cE`1 y|`@78. W=wW/4u9i) CC;ې H\rJΐ9,z/;G`ICۀTbQ"230?w#Ð2rIbx;`t 0)v w0xX1w7j󇁘03_0#P} S78weƐy7 f0E7c6d`Q#S =bHӉys23H: րE|,8K;((_Xrظ؍8Xx蘎긎$Ȏ|⎻(Hrbpȏ'#b ӳ yXqe!4xc4:u 7)1 5;0S(Ij;.!4YcB<>;9mRhsҐLR9TYVyXZ\? 3xg] &TseDe%PjHX rY%@ yY$  [ 9I :sb`y%L $QГ#LW 9$T H@@# apЗڐ #0 [P=u>M( >F Ѡl6M qaPs]%]? 8J؎ْؐ=ٔ]ٖ}٘MO}PȀ/#@֠Ye `.* Y  p ] }`Y@ ?N J) *0P Q]}m oys i*@C!q5# Vde0 `٭SL%p} 4 @0{:ߍ: `j q!`  Z JL, A`~:P@zO HQq"fn!@-s6cn Xlb:s m >@0Y1 TP z}ꨞꪾ>^SsP}xQ  AD7# `7 j!iʨ>P ~0 .(t*PC-* }P 0:-_~~ Nm? p x %~1ܥV3B0 /ЮVon Pa`E.[:0@ '  W:p:pp$* K 0 5زыI txzmN 0 _ N務m~]NEJ)0 u  hp )Ppp N0b@ fȐ(  $T.|s0 m/ I  u?__}t_cp1 ,aDPB >QD-^ĘQF=~"nx+ء,pө Ě/QFH 7Wy;H V6~ 1k `IWv)Yb0A 0ak^|X`… FXbƍ?\`/d$3(RNln!1byEFZj֭]|Mlr ukd@[u[v7tf<2Sn}YsY`._Vܹ *cp:mpeY3Ia]A+B 'B /0C 7C1k/q-h9H#[:^1GwG7g$ҙzc%]h\ \v%]xiu]te[je/2_$^x%0%]pr-{f?EP]s1H'RK/4SM7SO?}pL+9%L\~$0X|T[o5W]wŨ2_ ZbXh(i(aEXasa^L5UiToalUŅ6(dZZ_[\M]ow_t8`&`F8a>lq W'b/8c3%WWB6dWe_9fgy[k9gwg]ָhF:iN6MydW:멳k;l&lF;mf[m߆;nVӔ^IPekO9k>{{zS>F?g}߇?~wg*7+^` 4 \ 0 1. j E 4!B8BЅ-aOBz! qx^0=D -*$E }(#.шJ C'&q@*p)!8F2Q4\ * GqQ- -h!hBy  a8!46#$# IDҒc'Ihd YN*ґZ@cBG4R!|+UJH!l-Z/uGa2%0wYYӘ|f/ 9]@4c6Mn.tlAo#b j\H':2~ӟf@:PmQEhB"10"Qha P Q!&;:RT\L1 d`'G-0AH"0 WRըGEjR_DTb0Gp4Qx%&Q"+X:VլgMjXQ" D1ıt(z l`5b<VbkU)A^1pAj a5YFa+@`|⣩Q5mnuیַE2Q0 ED\-շmtN׺A3hG0D!(yE^[׽@:B[}" R xD#5FpܿO ķ~[5.awыa E(@~/qWb8N0kxqظWrl lx#bP G$BDMpGxp7|iH$*WnCqoyE>r'GyUrXBяud/yC 6<MCqmlO:gWGyB~__7)u#վko`q{ޑz|PCvq~|qUSwI2 |G(1!4xŠ, |18Mb)lR!`}TRK*P 8{W?hFqRD YJ(|+ַ8  @,l}' hX*!β Nk7YYۿЈ=^Hy%mۄ H090PSP)tZ]`@4;|Ԏ8RԈR8YHQ YR wh$s]][ȅwkh Ã1D1/<A$B4CDDTEdFtG<IĻJD"D PwQ|D 8CRtE!H]WE3@EhR09ahstDžsF hwFU$Ga7p zȂkT<1ȅ<7g$l4cBjCR:Ȏd6S$g\v4e P$E pȴP ɆɆ#P(6Mp4`{k4Ʉp-hAʃh0hJJ\ԈJوIj 58kIʬKIylTVE}o0LX L̈hLpLƔĜ::δLL(M| ĆcI "Dd \޼MMMN8΄(FFelH nyש q8U?VhKMEdmr/҆m-O=кxc_Ply<4HYeZ*}SU~Jb0S`}d4e[]qU]8'\i^;Ulf3:ng28p6祉؂7msvg!wgygp{猹m贃`~&hY8.ΑZHU`hhWh_9sI0܋H(?̈ ffH ̋8ޖֈ}>lݛDPY]0~B =eƻ"UxTkdfIrN lKT@Jtꃘ`}gx9|uP>~ 5i>(Ցpd^Bl`ȣFf(@Y؆ޕDP^F`SG>lp[TxlPME``c:x#FmSGcȳIA:F`W_Q EqwfƜnG*  M!7rx#/+W&&Ŕ qF(n' (YHX8qpdhm,G-rh `hx8 (s3WeYF,WBOim\uHNWr<_QGu6?+QmPuHh3rS/s,^%t#u{ǐE'AtH rlLFZ|?6w7rX&x7@L/bGXZ0x'?x:lȆM߈XP::i'@qxw_ __0X zou/kY{Ⱥ Pˆ [W8Rͺ֯2}4E }v>P8{ۀc_y Yֆ)&1tӇ])le :|,hp ql!Ĉ'Rh"Ɔle#Ȑ"G,i$ʔ*Wl%̘)ќ'M:wDI'РB-j(ҤJ)ӨRRj*֬ZriװS7-k,ڴjײf۸0ʭk.޼zﾅ/.l8h~$1Ȓ'oML2̚7s3ТG.m4J4زgӮc_7ȫּ3o9t)+:ڷs\/o|v ZLUk.ӯǐAPqղ}x mwt J8aT=DhD)P!!?wgL-t"1Q@-̌=#$C$M:$wPIbL@Z yPXB%Wa@@#q1H"yy'i" BA|*(9P4:)~F Z):*R!,WtH*\ȰÇ#JHŋ3j8 !D C|QFn}"$Xs#sɳϟ@ J(_5]ʴӧP:cC-2P 28V!NhӪ]˶۷pʝKBMTh'~ڋP[)0჌JL -̹3Eܜ@E%:4A˞MmoͻwAgԷȓ+_μ9ΣKNνËG[|ӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7{Ԛ*0Uc^;Î*w-mC6z?zf߭|߀.n'7G.+*::ODSry6PB_@@>qO ?٤3i84A=ms A-i麗?@O7w\ϐn#;mǫ>hɘ< R? tlqby!@lH?#P"ϳ7cؠo2xCk6`)TnBaF AlGSreJyJDn."R~yZh0kv[$@Xm#A6q@!mQq[ я2d\FE$dȐm!1M*S9!A?0)84 PKS6ŭW] +Q@ @(U"# 2딻^of&建:p%lyղSl";qhUee7Y`"C%Hcml$00*ע5LE77Y#؃\4TU:1o de`cݿm[)h) 3V21b0*t^WEX1&X,2ƺ[yTzCb,Β uؖee\Vd*+ t #,`Os#ևSL"Uh5)]+@ާ<&;PL*[Xβ.{`L29|y6@3 , _ w3Y 5idp:]D ~KG:`GLo:B @J?fRj'U*ĮI4vt5[~j\tʹ6Lilہ?+j5,6D=*#q'i';`^{vAqA47;9]S0ˠFb6aWOi4ApN| 5FN6AOGɠCoai~hMh3vr \z J4;BBxT#uqI$#אQ ҠiNpIU$ dYȰ $dXin&#m1,Umh%$xȇ8Xx؈8Xgv1_H&  Q $0_0$IlfPtEp5 #O($ΧuXPr x%GϘ$x@Xڸ؍8IpEQC9&'JHQ۠rqwx1b!|  z~Pw? 4p(P,R  D T% ,VjCU2$  `EQP"is'a= RT  CS0LP vc[0l ;PYwF[ 4t5Ep5Q4od W0n![hQ:G\~ QhၤIA A&iHSc؈e&jjJp$r:FRvJ$xB| $~>#Z:r#6ҨJ#22 #z.tA<:W!ZupAL*ꪒک:#z1"ګl #6Z*qձj?!Z"ں#ҭ"Zz*u ڮBT(z;j!QH p$C `JjU L`Is j ӱaO p k  =% 2$k]H*:U#a B@]Fy2jw0J*u5 PD`z?a 0  &{r;ذkzE0o! L1\ n[ +;R! ͠V$P 1Dද h0U1b%Vv@  0 õ `*Kh`nQEwHA1t y `  rm +p 0 d :Fk1+ ` [ cA @+ ;,R ˿s[ ov  0 { ; $ 0¯? $mѽa k о@y`898f > ?ALC\EC\,aaR1  X \|`a\$ ZOec9+ p rܦ*DR 0 O>W>>'i  ?@ʱ@  ` @ʩʦ/So@Z  0,o0ʪNq L| 0 ` tQ`0QBͲ( yδ i, ^,Nj6 ~ibnNm?+(. u+krR΀0n׀O$ zV AFn[j0p0\Q"$T0UQ 3 ^XInvD$k$ O^O ;P qY P A ʰ0 $aFyKk1֫ n.f )] n; V;i~Ki ;V@KqK; .%>mF~P @QA nS;țSGĠY dpN+4D P  a .Nwk0$ O)൴1  _$. aʋ @ {N k q ɵ {%$ ;m>PR?T_H`i Mo1@D67XO.@h/`a pa/Z_.ACmA(ӡa_ ps?|w|OaAkOqY_dOA@ c~DFOqmo7o`?ү+yќ ۏ/ = &ܻ UӜB.0 P\M PB &Dp^$("C=RQTE QʑJBQc̕ AҴ)ΕbFPEETRMWI#^ŚUV]~5o?b3imVۚi2{4]e+.~˖ذqقK5-_Ɯ) kUZhҥI?.ꫬMkmM\o G\r͝?]t9pQ]vݽ^xIG^zݿz|ǟ_&ʼ@\h>'вq&! O 3KNmO?Wdy ' y&!jnlK,p84JlDIx |HB(<|4*>3̯awc5s%s:)3ϋЀ$# @̈́QEe ?j͇ԳRKRM'ygNx'"⇟}Nǟ~N `Mg;kpJ /4Ig^yQpgr)pǙ`upN-b~Tn'r!=%EFjHfZ -P}wl)Zߕg9,2"E)I&5CyQGɑ*8lHe&,Y¦+BuٽmO@ (P "֠F7 %k.+y|i~[2]b't0.nݓO{%Ciz,乲=RN\G.d hǼ444O` (D}'wbv T|y~l^[:$kz|-FB|鿿j xЧSdxIlɧs 2/葇#R=`LUH IUm y_5pt 8 Aoq YЅ/5+Uֆ)TGDbhi'wn$2J?̈Uc"b\>4DP8G:6E2S8xc(RFX!fDN!0#YQ6𘸴-&iJ&Sq"'G(CJ(Y4fYMchڀK]rP{e0'Ĥ fZՕb6DG9MdYnB2IG4|H9N%GhR0Dk:٢lCc 9OYOggA6*ԡiC@GhF3 >8csQҧh^oJR!dFԦ7}[I:X>gk5ǐ]U?X 9h co㘇VֳAF:$ :U=(VHk~ֵb4^!ֶmnuxDt\VP\6׹.h ]VwE~@hUQĺߵ66/F^=uo|4D#L|_|FKa<`GB`78+E/򌙶pQP chąa p,Ccn˩D[tBp8B(;m`6-c nDrФ!V8U:%wY؂B=$y8\Jr piWm[ 釙S0iY!ar͢~M:Ʒ &|/cRn`"X DBaEz8Ȇ|&q?x hDdxҐ~#jpfƨE--6X2x2dqצi}zsemР$7sǝ3fw/co nn}۹7F3(~F^T/z vb;_`%cJ! BRp;BmO _?ϔX <ﾠOPegE?}jJ+huKWI a->dw M?#0ҿD@Hi@ZaZTѐ8`y@K9@ @S Oh5Je~p:46#t Ht8Hj $;  [PaH% t,, Q8U !;-Tå^k@X þ5?8cC7̓Lc{ +!kCTUBGTl6KDaYH+F룄#PtJE"yVE0z!Q{`b]`Fa4F=#ٷ@:8B@`#QP;<.s[/3px>NmnO?`O8ׯ{+>spg@_ֿ/_]&l# R0e2إX+~PA19 ă6q@΄.A] !KdX\< 7dE/0 bV:#U0cĬ oЉ@ACNEo ]H𦨒*ޥ wcHFB<aIhH@"X(g.C/LGlh$YkP24)-NEGI,SŇt$K2r%- F^*xx)\ ym J2xLf&]0B"Zۚ@1cH×E?*+kcن88T ưgq A h& ⚥ĩO D!X*KՕp&_M&S:$(L veQ'UXX =ȕcoVU_ؔ (9nPլ*8xh]f;6 %eIj:B6"dD:Hg"NueUH><:j2nLkZfZ Rڕ|?E9Z&MgNoV6[6;// lƯZF> d]2wUZԒ6=lmӄucg,9,a^C[hb1\bkEJk)'ܤQJsi|%ŪiE}Rk"]>!IȲr}Sxs>8uqӢ#:$yƛ-pJgS(,ikM9i'uyi)uZJf\Y nUjĚYfar]MbNf;ЎMj[?9.zqq 03K*f@. &}2f:=08'472" ᰃ43@]`C_ci|qi0EW9Y;0tOt+vd*/$ֆo*~bes_/x"@zhzB5Uw36;}\0AcQ:۷<0Fw[PBba^%Lc?&_i8] d'f#;oA`CӓE)^p8wu7[A،B8x Yk٨bqj 4*x9H+Gx39Yy Y!& ! ! ي i ёI)y,y! d~60`wDJ(bI}J!68lhbSGwהQĕ CwMؕ 6o` tGw_f xP`@@G q Vz{))#y٘V57x(5yI:bf'g I'si x:P( dy&1n0y&WAQU&T}`f QPY' `p`TZ)%D(=aE@9n"nayJz& jF:&;#>8zТ 0*:<ڣ>@B xC697^U^2:ș Md5R 9wQjU ACׇw0K|g c? 4i p6 ~7ZM`j=BU*) J'GaHם!)y(a pa eJTJ ppx r9; O ~! @ bɐ*( GZ%65 d_q*0+Yz cNu 8Ĩm%F 3[Q; cy/1h% cj{J `F-; 㬲pEW(@07  Ъf  P W!b8 vai}<A` 179jo ~#!np jsZ; PE8G q`% +d"qgOG kA[hcz%!.L@=975`+[ᰰVXM+,MBi&;hRk&蛾d+&`%[\r%Xҿk%T2,%|P $(d N s: |aN@!&\%,S0%2 +"B="QٽZE]"` A Fm ЖKooQW X"-R^~ ?^҅M] ҰԌs^MKJ q(n -|$ b]1 [>?+HT ڐ7"auTbB~ gnsZʟW> Ѡ HMPؾ q[]pp}kz1Q O$k!Rݩ) .d!@ վ o`P 4q p D@# 1H2ep}C4D Oz 0 0 q{f Y @ !P o ,fO ip0 Ѡ PqەoqQ R F.T5 P 19@v / aQQ Y/SA 05 ǽ$ԱqZ" D Fgl _'op{ S5 nbP []!>A}NAP.X 0m a p) ]fnl -a-%p{A z.A j= 2  0 Ao p݉ԥ0@ UTUJ=@Q(XdwĕPcCDy5Y\śW/ނ6X`Tbga3d-_ƜYfΝ=֬bХ: 9[ʕM[lڵm m!UnōG\9X.ܛo)CǞ]vݽ/MyKG^z_8X⃷v_~Wi~A"0AdAa!paH7C?!"(OD1EWd1! Zl1GwHt+|$H#Dr3l2J)[vlıJ/3L# BJ @C1dM7|1H|N;G̳O?!vR3PEeQ4ZuRK/ŔAL?5TG o5UUWS4UYghZYL'^SJW)XWbK["d}z]WR)EWM>ܗ EoCGXPۉ4Yx_WwIOVߞ>A,rx v_]_)]%NP"%E'4(ݨ>ܮN%BeQf։c53EOf"pDWyF!VqKk`f$V YpƋ.K%w 20d^|C"S:h?_q';Ž;wٝDtLqQG%M=v N^?׽wǎw'xل7~x%Z^(;yB~L)%QWGl `3!:v SBO~cd&5INvVq c E ď-m*Gt #ӏ7 @ikNY޸yr\_BLfҲtlf4Y˼pk <:K!N)nh^ <fjӟ h?9Eٸ"v9ΉS8!O< &5Eg֯±}Ї@}r7N)yT #`J dqmK}R%s GQ)*Xg[bF a IoH7ؑhc;d5G2m# L?J }U'(zUdʠJ[[*sKb:Jdd$#.AGFO}Cr$?t2]_d`WeږPz%H>щu"\y7~XPсes hFEDqԠ&bN. qHj>f&.H2 ~S=S _\h>LGLadQ.l®X vPd=mjO%nZvv_2xHo-5ɺ%)>,]J q1۲A5mN!LA>vĭl]1q,Mv%mB!IR Gf.~ R/ $jћCݦU d.]=4u)[=@<"21۶^k(cN]7}G7 W7 y{('C STS{39 ʼnNr./4_v(Ɣ7PH cs᭗RgqWG'^;y9 B.Z!!Bހ`˱?S@rOyHDD {'o1?epH0mߡ?ɞ/Уx9;jeIt9ӿT h R2(?hA:p>P03"j1 kc L@@PaCAAyA>౔ 9$ %.pBkyp;xz@11BC??y"ϰ@45dC& ` Rzax+`-܏>\ M"P1%7 BH]4It(SN̴?ۛO|P&SL0c'X*kE:?a) ʼny됍[j c qFFhB FsLp&z~X7tu341|@.8ϐ@-ӽcmHl'd Ȗ\h#aC颈0dH;D H(Tp+bGZA8~#X\:bʚ7ƔZ(* JJԌ ǨDɜ4lа{u(x`Ӌ\D %j$LCdGJ*4c0/h&kKP0d{#DA4h*4tG H b CJ0c(lh|V G:vLCS"k5Dp.p0C)N͘HÆ ͈& $`"6c3 Oͣ0k:'ꌹd &  #؄{b/*6xm(²|)~MXt9d  o48. {  }x bc02"Չ]M <`F3+R8%PD'3EӫQRt| (U3M<ӦїAi 6A%T@R0#8"-I- 5Qt8h7 UT+U5L ݘ `x=KU]Չ\\]>"c9(XHiuZC mdTVU@TL݉?CQgxSW?-D7(F=Sar\hR@W,VLSBؐ sRXc(p)pK Q,X{!B\Yp}, 2)ITzM ~P:`F<oŋ#i}x`p)> P]M؄yxZ %[ ¹N@ *[`*{JjWk69-7pȇ> ʶb݋& YU5_ u%<[Ұx7@~ C!rSHQqEڕ)L+B -] t=YU ͉6iYߴ )u۠R/dPyTޖ͉8;x W P*͋')-P(^ma3`} D\]^XS69ݿr0ߗ .mH މąaCx^"O!fbu'I}Eb-F!8I. /;\ 6bc (2~ 4aM]"XN)l\8g.9Fdy<ErxTCFd[F"DTDlᅌ2@>Q>gx+JcZ#dH ZdP |~ec`6CZd!~d8ei!6fZyDgEf>b WsFgmm`U_axR=f惎g.(S1cW]ih yf8S?]Vjz&lv biN` 8 XXߞyRf Ufꠈ#0t؉jFQ^i`voNf(Fe&騆Hf nH'QYxh~j{f-yރUYD2Pl?qnh#x^kjn-1Ƙ钾7}x.ugXˬ0~~fn0V^1cFXBfɮcvﵚBNo&o o6pа? _ Ű! xaFXTllpgqn* qh<(bUy>#Y'hXx/&n0qR!wrWH7Ѝp&"WHޗ8ŀY`qpm)s'EQHWX7_ݔSbE+Crg{ƘL`.X聛o\ZXi @iB4 G{zfBėM--׌PKX| Э>@eїxC@B@8& A'~@ / M`yhGPјBg !,bwH*\ȰÇ#JHŋ3jȱǏ CIɓ(S$˗0cʜI͛8s3Q= JѣH*]4(MJJիXjikׯ`ÊKY%ppʝKݻx˷߿TcMPÈ+^n(P Ƙ3k̹MɞCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G, 3??ȓǭLP$j+0,̔AC36N?;-D'r<\(\G A&0 d3y,u:N[u@n@Xt6@Ȕ<<#<,:⨝]TX,7[J^rc9t@`>:t3P2 @3ty* 2l3:;ѿ<>Alp7PS3<@)͓S)<6!03N2p 1T|b H2Uȡ ;3l@1)Z t CtLm4T&GYD XQXԢBp/6*9acьBx)9n F@Cq!A Ѻ>ʎ~2MdÐB@ a 7 hU M#`ok0( AY OHp (": B"4` = Đ(f`  00`xF aL v(Zˀ#p1 @э4T[ɀ 0 ;(Ơ"a 7 ۰~ P Вh`m(p ( b% 3 m$;T d醀#0aZ 8n Z0Qn g nn _V 0 o=@ n;n*,.024?6_8:QD-^ĘQF Vl_p)\p?mKG5męSN=}TPEyn[Qi׮M PTU^L/TUevVZmyriM`ªbhJk\} }'/Wdi)_Ɯh/b)IjF})]Nx/fXcȰ}>F7  Ӡ]x=kB&S arКykDPAX8ž6LD `D0#N"|!oZ*K0ó<0DQh>4栔d-Zr ƕD$RC$ajaϔ@9 'h Qi *0Yfơ& GP , :8p@;N%&ͻ1sOK_R%YIKG `BڢҌ uB0TI@ s\Y(V򀍅!ظسU(TBc,RyXlġ)\HUbaTYJ.\{5# 80MP^עdbL 0G,@_-◡Q7s o%(YH8ks!D!϶ŗoZѓ!JewDPA!ˆn_Uweq2͊كdǃ9 \|Qe1fmqe2k1ˋwm9z QPy%NvepH]pE< ^@oԘK.WFyţ%=^x}t{^=/&u=]ܗH&QX4/!s]Erfr'|'$"g!}RF(Z~8@Ѐm @6ЁI%8A Vp`5A L#Bp@sDa UB @ B `)7au°a8D"!4AJ17Ob:a< Jы_#Eb Ѕ! 5ac帐Dp Q,яӒ&#ʰM,5HFzNphd&SFR!]d(E9Qp!)UJV![9KZ:-uK^JƓI, KbӘ@yeLf6'$JgVӚ\ c<.'f8He &hXƹNv>.1J>najg>9! uӠ a$7 )^&t"Ԣ`?Ga$8Ho0'EѨe$pe`JRSO,-V5kB85iO -H?2l0ժWOTC[K*V:V9Q\aqխoVJ͈#lK\>1LC!dEy״*e1VֲYi_ IrJYJmAdQLЏ>, "+t:җ+cLw4.liOzFf-]NJen)VV)k}k^4sq;vۉj&ՂlVv95%aLX!vccyFw-Q &گMwm9zw+Q=w#;Vfe?/=_7܄2p݄d5m;wfAW\^UG#l#_y̧bO7yus7> GNtg$mWPZQŤ3>+sgz˼ʏGz1`Z/rԙ!?h<rpb)vn̴Vpj 0|B6qʚ\bZCx9ϐh4g<ؿU;!dQΣ8Zfl!_}CYb8?n 8#MiBzdpD0iwcCs?7? k0[|Eh9)cYH> c jL#*7T6RkH,2%ˆx@1Mh<"I,A\ (<xAB$$CЬ>;xRj;0 2Q:(JMdK6VE2HXEl4W|߈EJZ$HEC{,äjL=s ;xb\X'b6- hGFÈK'#GldlFs z!#M)q1F.Hְ†PچS Ȼxl7pĊF,ȃ~zY[L6qujppmïq"TmІtx Ȇ6D{ɢ0H4*fkFi{q) 쬄BX " 4t؇gXk:˲@G:%cKDeclxkH9s'@ӽh(Ox(N(h8='~L Ʌx6 &T)2:hJt؆O:3X7Q=Q 'ȑ2耽L `XX2S~PzI# !dFq0I :-ˆAX)PPB\wzYA pNpNpJP Uh TdPqkʃw`pT8(1!AH|RHrу>CEPx! Ue1+wU,_U k~))i I~W@P *iym؇yd’¾"wՅ8He\̐+ 뺵[4A6ە!7%ܛ+cr;\-9_xY܆܊3P5cF1̥8:NJ@Va\uĉ&Q5]-QHa&ňV\Tȫ8nbPH5۔ QAy+5̐YX^.[ў Uil@_e'%Va)ЈqHٚp-lGx[=3!Fj؉Zj3~hтplEk< KT%P܌ 93Yd2 oI) vAmeU8x_pWh4rV@U8q ZY} /fw@_Y'߈Y:Qc Yb(WP a=$fPXɪѬXY@pՆ[ `2` .66NiІpፈy(ϒDžIU &hgZh&&VAgdh6qh%>p&iذ_&۾۱fJ:i"jjNƻbWynhchFkVk/!,OwH*\ȰÇ#JHŋ3jȱǏ CIɓ(StHQ+cʜI͛8sɳϟ@ JѣH*]ʴS.L҄իXjʵׯ;5KٳhӪ]&BQ5YbKݻxQQpLÈ+^̸ǐ#ɖ˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ?O?"J@%0,sr35Mܼ<MD' T@3l{(p@I/(?(#D<3ZZ2A锽8ψC2N8٠ n[:Ho2?'@rMcM4C; @;Nh8S C0SӇA|k.}JAdz4CtNP)0#QO<7&ӔL>1z8W}ǔ+y̒@ 1PDoL2dK{L䱲qc5ۇ!6m z jch0z3 E%D OBJ.H2:XÐ` ?XD@I l"JB)>zpB(HhEH b 0uQ6wƭ FӪFEu 1@QfyxD}QDRAFFrP3?']P(Gs$[*HiJ|qD ANd:ĂOeCl{0(2nv$BBsMm (BQ8ЮI':SP(Hιt#;@ <Ó̧>!3!3O68% % (3 &pn؆5JъZͨF7юz HGJҒ(MJ sÕfilWsFSb-ipz6V9)L.FMR3BϥFkS NID[SzrIU=aLjZdMZֶp\JUGv뎴9kBWi#HA%6L<ĔH, Y CB7vC êacvd:b%"d ;,n=T9a !?l9\ kn!^`tcJnWFxKMz|Kͯ~LNTpG ~ Դipzaeoҭްݻy7s#yųp}7-ǻ7~36~n".qPⶹ8i˦ C(OWNJ$gkH g-;*9ӗHOҗ=]#=&2!+F2&g0}xL}1. lL#9φ!w]4.ggw B(96`uLcjahX 5F w'PYƝQb6 W ^ĜQ12_hH1_$FPj@@X_ ݘ: /#6i,cwe|x}#` a  eYQ w\ .!1 {0CF@40{Y؇X GgG TP j`Px a:x[+ 0 P @, +YNQ26C&FC5@%sG2q C<.B:Y )&s :Xl2@! 8rz .G i@x,dLu`66c5R3, `\H F]U{<<-F p $? p! ãw DxL^u+Fu :`qeI1 P쵒"/uj`aI3@ A^x` G2 P 0eq 1 i9p0&:`49 )  @ tK/WQ ` Цp|~npq0}z  A("p)BA}pt!eV X- ,Ў|Mmuu}`!FPBi@ C -Ȋ²( ,e 4Q,А؜p=p?h MNa!! * 9 ZI EMu0YP 9 geУÓaLi;!khp6ջ  @ , q( Ѱ Ru `Jh  4kq nf?! }(p `1 3!3H I Z. fJڤ`)Wڥ`~:p y*! j d` tNY( c."#Z  }.""@ #T#^X1<^ꦮSC?@~C@M[N0O>.`󶦺` )л .M lR.mN*L.G-@%O!ΎVF!촉@Ք: *A>%H6&-`R3J1 ;oJC/=_KK?~_A)1 Z\O0!1hj'JKR?0Ĉ b}/04JO &a,> qa9AwGX #<"+{f?P˟O$q!֯'Qۿ؏B6TU?_@@ DPB >QD-^ĘQF=~RH%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][l'-@ڽ\ #f'q͝t-YfnJvǟQ"o(9!󜆝 j- S\ނHIz("@%nfy)t'^C$9PnŞ PbhB:Qb=eGQvt(hHEԤe@zRgb7)ZBY)N Sth yLI֌BDA0/AejVOĈ!#R:bqЊqխB*X MߺW,'ۓ00mkb/ Z"Fc:*ֲ',c1M U2 Y`Q;g01+HO/;[H!HEBA ƽY6".H30boS  `0!Xۂ'!ȁT^g/_4xP@8q}pSJ@`O?4Z#_N>`P#?d7DA @@c :4H-(qQQ(*Q~P}(H8( c#1xc!?"B#4LNz25 9%̤&7Nz (GIRL*WVڑ?1c ^e-+qb>L1] xb1tl^?M0#db5nz 8IrL:v*R Wq AJpeqTPS %rP694iI@)d!ʔG5"`<{M"@KŤzNTJժZXͪVծz` XJֲhMZֶp\J׺;Y]WA}u_X@Ma9dVH5S QiIƒ40*FD}bF2eD5rHJ%Cc%&qk P`u 7ARqwj"&c<<%b/W;0.:$ 줥@[$ w^ͯ~LN;'L [ΰ7{ GL(NW0gL8αw@L"HN&;PL*[Xβ.{`n8˿#VRdH7߆|Zs4aKQ^B">YcU>Wٌ`Güi$#cK4QIF6lhx4cߨI]dlyG"Wz ',`CtIqN$:ݸ ,0 +Q8uPsٔkS9@LX )B+K!IbI3FHw݂f (@SbU${ @LpN0CAb FQkn֠y0 p`LQ@ 8Agas@ʰlk`.Y]% )*!"Y,$82Pw,x1(C b?g&g|#ll-c )@|YFMA  6bP!X |o{X zB a1nM601 g 6"n 1Bq8 oD#5}f]DZ7'B! '@8apI2~_vfxch}X?P0' gz.  0 ;4U'qyP[4q3aq@4 gx@|',XOI xG rRP&7`p\Pgr??C G &Q a qƄ SslSpâ D `t>p 7) A'`A xog (t`{Px0 PnPrU W4(,ӰF!Xq/ A'Z ~6i#x4=% %޷xK< ͐ qK (X0 gQ~=WWrpKP f,p Ͷ z   uDz 2 hhm 1ِDe B` aAᓺ  ,} &% Bb9c$qŠ8cwnawY"y@`9m֘9Yy2 oCQDᙚy= 0 @ w ! Lpq"S TK%QI tDQs 4N I CypLg$T ZG)oџ n V!pqeESP q y}4`*?=Q}IH8C <0 ? &0As j  @ !tp -٣Eg *_ZT`oA _|A Vn`* ahs|ڧwQ@ڨ*UY1QZ"D]0i *3RêF5  i_cါ]7! rڪ@ Pk zJː 8g KMJ' qC ! PҫN (^ ŀ!}sS yy{+{Ю# @ F `x(L"Q z>fS_u BBF 3= / Cq,@I8l0A|aq"nh;q'H lP  p"i ` e|S pȳ0 t)~y"o)Ðvq R ` ., w n)^hހHP "Ns aٺ ؐ1Z- \+ Bȹ*B- `! wpX'nF{:~%gwA8x*2C9ځ©9ZhG ".ZP DllȽZp@w qN=vY"N{&6+sgPk P !Y:9J: рJIdz o ` K  X 8"DLSi4QP$ s#G')Ş#ʮʰˡBƲDD`I˿|@F ̥ NG@bA4E. oL.Pc.;ib \ll LAa<?a.`- ]@@ІP !L)  &/--0i[5 @1=@ aGѧ;5 AA7q_qHH6Q@\-a=ZZXl]nFAJ:A#2g4pI|-S+ <=Ռ~S {1aI7a $dL֞.7֥}0! ͣګ=1lA d= `\6Jm=p|2V&1]opFC]TݭoRm L=]}>^~pDr@9 {S ~Bb5}ܰɰע}; Hk f{3oM/$q-0 >.Ϥ1@Lu-M~.-nX,xԒ1"?0kF`AMH%)zh>+j>2VPrx箢}k.a   TbGN|$/lHl>%=إX {}p@`=^R :531ӵaH%Ǻ$Qc4C0C`0AUI At%6 G0 +36j@7T/ 'KQJ~sN4 &P[~P~v 1Bs] O/&oqS4[43PmIH'p'p_~^s' H73LQao Z:Gq"+'@L pysnh/f*q@ɼ\EXRke2#UH-]SL5męSN=}TP?~btR `)V.]D^ŚUV]_q 8d B ɬ"xb@E,0Wƍ?Yd@"EJb]=ZLygM߼y%3:|.bE~2 l<~mԧm6lQ +oߙJƞ]v+_^:fR;{G^nXtzo:mlﾁ7dA2'B B 7C3p!4DOD1EWdExȨgFoBXvɑ2{2H!$HT#dI'2J)J+2K-K/f0D3M5|Rd3N9礳I!a|飢4PA%*RR vAB4RI'ρr3`Be OOJG%TS{{?|'|G?}g}߇X@4~Oyp\8@aD`z@\$Ё{@VЂv /AI`E8BЄ'Da U(?Ѕ/TQ@!,LmH*\ȰÇ#JHŋ3jȱǏ CIɓ(SHj˗0cʜI͛8sɳOIѣH*]ʴӧ3G d`ԫXjʵׯ`oJ%h5ٳhӪ]˶[Aƭiۻx˷߉sjKÈ+>j ԤL#KLe"hϠCM:ft^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0?4@8+<;N:@KENL7}6ӺnLX#,P>Q?t>ጳ׭3œ8V8c7ɸ`BK:5^|┆3*=s5xP ܘk[#vv-P2*譻>E=貓@b{$|:9#:~@`J 2DO8ȍ*D{O<C3ﾇ7Iߏ>Pw#K  x4#K(1U} 0@b 'b h(6!R$  8o/!&S8`:J⇙ @V y pyHe2z]=%P آGr㣺 Kcbè@1Q[9 ")ʼnip P|$=$$d>wrPbr5rO "9 +d~ @JЂMBІ:D'JъZͨF7юz2A;@Jr #$^`J||LitJpMDHC";3wqCYA7y"D)`Щ*rqXM8nx!{pPj"j SBUzuʢ `e]Kר] 68b$Cy3:XAkdL-B$iC %GZ5\^ Flnw pKMr:ЍtKZͮvzΜW(5<{7:PQ^nCEo}Cb(G]s"YdØuKॐxk@ x$9@K,^ ~/d" 0M>Vd$F 팒 ?X*~c +%rc/Q 3N~\R'Y\` (Qk3噜@dY- v .6@ d@d@1$O1Y|YHe@ T!Gbh@s?HJ$ sXH8!Fb:?!'f odg hܲX$@ ȐzAa `@Rb A e aCzZsV.W%p'd`  W ~1 ӐN~P 1 q~G,Ƿ7'~  <#00 q c/5u\@1 9 P u=7  qp p~r 0&cwepRVe ч @Au|<0f>$@ ! TC p a7  | чL` \n@KFR(-8T2! ޠbф}?xn@a чs 'u tp8 ]Qy `[qX yh(IS`Ðz\0 ր= 'R;AM ! H)8uG{5 4 t N@\3(a  p ['0PHpVu /( 'XH Q (6 H, >f| 1 &We0z # Pq8p c1T pB}90ȇ?8}&@9@  lP |,[Xa H! 0`  I D 8 °p:wSMx uq ؓ@ i@ 谀pѠ $ ` g@pؓ 0{q4 1 Q 0 ! a p p93w7v ` ` Eih a:ǘ c g8 Y y ! k*N*DZj)d90j5j!|7G11 lt %QMR6t_A@ J!0: Țʊ1RjZzؚںڭ1JG @8A ML`A! : qHA1qVbǯJ:X9hG +@N v]PPopE ԰b p aP[ eY Ґ t &&7 ia%C[O  !4cgo  Ő@"^ OYV` S ` a \#`( 9 gH se.ͤq4 ٘ Vy#,)  D݀r!sz,Ee'88#8Ḃj0q0I< аQ DKp < ѓ<n 1r y1z8) r I 㧰3E ,[~i@I ر/ Ia|(Г 4LZyܙax1 @0˯e.BL <4dJ3 #Z  `,rYxh UXP Ў#s,r0t0z.Wz(`EL,#c 8 @[, ל{a T@Q=x }~"!I{}l :ћU0#j P ? mJ^] E# ?"e 鬣6i 0 Q4"8Elg0 MZ }R 1Oڍ lڤ @}"R*` >-xm 4 } NF)K:G #!,QOh1?!8K0J9.?FHC?  5;1?.|@TN?pYP %8O> 3n:?F @ ʨfD r-`` ݸ k!-P, Rxe Pc^Tkup^^觾\q.=j~rNHe0.žVvǎDFۘ6ZcM#` ` Ӟ5 P9 י]6FЏ1A8 $ `- A+d"$R%Tq~I0c,/.Oft5L57O63*  1CY$w Psr@Y/,1 ]`T7փ!uv7+68 JAo r| `H t'8i=[Y7?.?@3D 6}6x<o H 3v|H $TNf ATZcWN/6ߐT^6LTac QQd^a OQD-^ĘQF=~RH%MDdaTSL5męSN=}(+PEETRM>UTU^ŚUVzqVXe͞EqW]KW\uX`… uXbƍ?<0qdʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zRӵ_TiC~F(F#,t駴x#b$/L. SѶ'H*ƚ ODtd`pōdAlJE0؅Cg ka{$patD I GP!S4~t2i @ yRλIC!3S'OC' emO|LXSNGAQNjѠbV5V M 5W]C w6Xu ae7 ,R0lP,S($tDxۦUݝa!! \*YSG5 U?+8}G}p(x >0JV8b&^q2JxHM6^,h89'Oi؆GE>a&kB ZpW C0v 8SFhV~FH"~κ gJqnlwz]9퉶~NGlԇ@THC\_4xYԁD!%s#^|TNp u>!3VWq|]һQy7=ȃ|-/)@T<J/f/sfT*Dq Lmɰ&`^ ീ"ҏ0ARP7<#{A"( 8l%TNH%.p'Or?pG01)a$U0#hXpbI $"M۬ư 8;x@#! ˆOa lċ HZ Bַ♒(޵<  XN*IBR2pE b!@p/A @8W}E+;1a+eVQ$B A81Fg$GDqA @Ӈ @&l*iuDOҍP 4 @v(^` I\9B#b,!) H<qTWQ3ڝ>K݉׫qyAu@$FQj80:ψ̓ BXjQYP@ blj8ξD$⡏G$"~<;?>E 5*8,H?g,ـeFqV $iac1 ĢmNte>%oS q⩁0H {+dO3XN=ysrL$BAXW)njoDZb*KBw %pxz@:EI*AL+`` 'FqL*و3/I\c#glu㇈Ix j%͎qFͫJh ߁`Ad xF3 "I^Yg RdnpTu uPd 259S *'d P@á!й8)3D|Y?a Hs릪 ȫEN}xC`9[$Y@ 6|I]|k!q}S^spc=˦S ""kH6NmEvdţ5+ԑz>ph7!M6-7p|$'Cȋx'9w7T}JG}Ϳ~O>T \!,NH*\ȰÇ#JHŋ3jJGUp(Q$U I2(QH ͛8sɳϟ@ JѣH*$-Q\YSԚ$E\)0GKÊKٳhӪ]˶[0;ѢR 'DV LÈ+^#X H%Ø5w ӨS^ͺ룟Fw U0Ki |@@ʃyH`#\3УKND-*wC = Ј7xjwi˟Ozu<&'QiYSGn &o%߅fvH`&"X Ԓ*DaL-WQ<@ eQ#& A"br^PF)%FMi7.]#[#5*D"dihZOwŲWp)tΙIx|޷f*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmh06pw*NmdN83w܀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wogw/o觯/os W: 3`8:s :CH(@# 98x#6 t<^xncG v@B-涱BCG3('B1t05" c0πex?G6p, 9x̣> IBL"F:򑐌$'IJZ$ظ&6LlLB!Jp2"e)rJ2!\H+JҔ?P#L8K eA)LbR$af49hDפ&ŲAeěe7Lo9'DFr2,:N g>q&?N,'(;w;UcnMvan8MՅ 1Dnm mw]6R_μ2-):H]9Sj Q6qhblo*g߬u;}3~:įv4{gH*QsǬ)@n&wj~NO;˖{1{ kS&GSb1%Sϼan9r󁭃y@4aVln_T}|h(MdEH7k?9dz>1 ()uЊÐ1'Rp& f(J0s F 0bİ>^-0[0 = q (@X'(0epqAqPQ'AU ( U 9 ! 1& '{@!LFP ېD& #Y'` D iU_A5&p fs?y%8dGvNY ^'7Cl8i2Gg]Ib)fb'\ 1|zڕxk&ڰzA`'yY&[Yr٘9Yy)29Z ˀ ZEr)К95GBIٛ9YyșʹٜiWY@u0/13X /H; Q lhPycxU@3L@ ;ˀ oa ~&9(8PPn Ӆ`IX/p " Q1 IȚN  6Q@)) ÏV苳c  c Ѱ 1y 9t @ a hJ 0P  ` i Y8[J;p :xrB #5p'Q 0 Pzdⓐa#/F0Z:@ZJ :o``f`Aҭ0VSS 9b`:\a\ʯ(گaЯ0~ާ[ a[G]K۱ ' pP&#I W #AANP*[AAN$A"j;KYA Q%X1RkTP0@ LPU{A"J_2l)?[ x nP @y\k0ԡr@I00+@qI cRU`Iq" k@n QZ&7 4;6Q!A9@FAN` 1 5 IPR|D"< ^л5RJ6۩wBu*y@ %FPyV Pi AQQ 4P*{4;,2Ro"(+?3)\2< R%)“P U2 aj¢Ps'1Li `лTHۛ K<“ ~U|VXZ\^`M< SM-ӻ-1 *c `nM} 4P gcsL[}\D5s؆A3m[ kӹZsUJ=KmيQ ٝ͡kكذP} `SU|-= =A5[T ΍ ]͹`^s܋ 0= |л٨6M݂1 }=lе @ 8&hMsep70 ѧ-ӹPߺ Y4tx 10`$ѸA1- |Vpڲ@G33 !> p ( * Q ~ >8 ` j:^4Š=b! 6Qg`g0 p4~.%l0 @7MnA0x]~ѐ3^: !~`>:7  Kn i z|`n 8 e СN` P .3 ϸu ~p = |&JsUp P p Щӭ3 i u* N! P ` x&~n8- :L0 1 À : :0 ٨:N88<Ч8r#R?RV!X\=]^/5Nd_qDͨlnеsny?nq?Ou/?OMɃ/o/MOu_͐?|2?p-N"7TO"#,E.vqC2&p4(Fg#b" 5ьDOv8HBFp9MR#O0E%D% *-~Ha~ (,8't4cge.G B B"DK|B=It9M\p#R'$\2 e75镰җ)T9'cO,kgZÛ1G?NRd HrִV3DtCmleK,y IK!&EJAR\%quYA3 TH6a"|*"DkK!TP?8T- rvKHOtǛ8™\Dђq`7|/ 悀aB~_엃eKΡep) Ja8ľ8z.Npo/ bܖƅfs/ ؇.v.tec#sNmG%GY$9X7D$3rH\ @H -nk` !,VчPs_Z#. !( 0G8e2Y@[ 6U@._wG=I]knZ,A/u^Ė-O^!A=m(;!UBjw7Fsm{ܶwč+m7Mͫrޛtf{K:C٬Mˑ|/+|*B#rIB&w! CNYUXZ)()B2Ky0"arF*qArb;_qr%e6D?10X0NNXB}q7";E+zYi%RZ# 'ZKdPjHTl\*ЊE\ﺔ5blc=];"rɊr!pIQ<0؆()z l3#!×r <1zU}F7xLQ4|>."@R yP#Z 7vG!?BpW/>(5; O (iiHu %BDkVl؆pЩ 3 VH_H>phW@S8>08>h][kcu[,مts\;#`Sp@ \hCSbHԻ;"(B+BP- ;lR@0BT2<N@yx5pPqhR;yÕ?pXp؇Ly2aH#H2L6T;)DBEPj3Y+b<@h3_C4%H’@W@`C?,FP \%o-x\S10=(,&>H{< r$SLsyX~~빴ДpЇ]Hoi H1o`O{D($EZbTH9Ȋ u(2Ec* $9BWY8X/y 5 $W9JX˦\I8d8. ц g̃ ('m $ ` pqҀAx0?bx8̡w@ H"HL&:PH*ZXt6<.zCƟptčA@:'v,c.iꀠVBŐCA?.򑐌$'IJZ̤&7Nz (GIR򔨤?(12S@+_Iv!dfIKJ#Q>^:jmXT1]Zfaゎ\+oYBhJQ@5pNfiBRbg;3T0U~&< cO=̓qgh.rzhqρTRh X(0 '=)BaCR SMU2 (Ԟ2MIQcH>S8v5ulA 1(@Zrdw**0]UbxCpVcf< [0E[1V@&׉UP &aರ;lAbX?2B{T3K~V  1pL((jZ `S8R a=r:ЍtKZͮvzׅ.+Mzw_}/$+|ѷz+n}?a G+3$|>a y>d PDuc)Y~ZLfR D_6pL:9`}sgb}V].A ᪅mC4:1;Z=L 6!ZԦ(,9s OvEЌ@ @@{* (A XE " lf @ 0UMQH۬GTrZl`c H*PLNO;#Tuz@&$L%R%%uRlL )*fDoa 0?)(`@פ V :)$JT3@+A)Jamu)Vw,1wtCVxFy؍TP -w "ܷDvhc> b7P}`#Ϧ$"7Ȁ9_}DҪOXW}]RMuwOOGOC/ɭ{;D?/(`OϿ8Xx xCj7 Wyg< Y Q BGe XHs0 aw{ ?qPi|Lf ;&P:0?6hyyդ;jb`!p ; S}wa0tep;;[7U*vsa h!#~U8 0%@lWB O` `hŠ 68w@y&C;0 foЄ3  A0H;pp ̈ a P Ug  8H8@= U [SD>gf8=?x9P5pP ?"R"'/+0a yco0Wt#)a$y%*ْ)(, 3).i4y5:ٓ//a`1 DiSP=a\aДRIaNYZy[\^X9]I`ibYjyklVIJD @  yΣb Xyb9$(-LAB {!@! 0  )ݖ. pmQ r@ &N0n)"6T`t՚P IV@&e`IJQ'Z! $`& 0"_794`kQ L0waϩ "IY{'kp0app} A F5Q`A Z!04 p8:*wkF3 vw( @ 񸤘QPu$K $6Y:( !6c! ˡ !.*Q XXZ4:Ѧ!>l * 3h4{~'$ "dz5HjTڪ:ZzګZgꦆҥ!/ӧz} /6*btZ%: :Zz暮躮ڮ:꭬B@ *c3 i 6  |Ҏ]  {S J 0-J(- k|3%'W-` ȱG 'CPD4P P +~ю#` NjAkPNW=K[ 6G|C~k~T˴Xk `Dz @ @ˍtNPoy~HKT{G8~bKPs۸1CгRqю붒;K QSz PkC;WQ[ ԍ[Ѷ` A b8+;;{5y Q{;k01ߛ5+`C`[ P6vP;[eŋy۹?+1 ,!,[;h;Kێ[ ;;ێ_  ;5v@t֠aY0 ]H(84L58QM`w uAaA 1 )R[Qi,;#  ՄX +<}wOh 5<j 4^~5 G =KyVl VXa Vѽ!N07 \C% F}J3+KkTO@Ev)4?;4J ?NCp b.40 ԠBD8 DЀB#r Ё<ru5CФ p;ӎɸ AG'h80IC_0C Uz4d D50(+ 7tAw4 55ۀ sC3Ҏrn S$DEx4^@A :M܄5$N][7DqU#o0C } 8DGp ?i0i00mLPj7A@PXj{}6W[GE! ݮJ a r(?7z5ʴƴTdvᶉ5FгOz_{A'B|8N 1@<`\ 1\Y_ 0.QX/] DPJ>QD-^ĘQF=~RH%MDRJ-]G` 1."TPEETRM>"@~!bpHB38fUZmݾW\uK A!Y`۶94bƍ?Yd'LpYZy*-AB> Uh֭][a>ܽ}<ֽH pq;\tAxUj0e~dAh2"c'ked0DA&-ZE_ ;h:wp 3FFGD2ɸ$̊ 1Ѡft8QH%\-E* UrK3D3 3wd0}LR '! OA=ĐM&38 c|NBLOGSOc'p! SUWeU3% 8(EWa']V&1o 2%XeeY$4Bh(,02[o}  #,c\y祷ޔ\:-I{&`#7.>Ţ?Ġl8cMxaj!C"79(y6fe]J8@e&ȘBÒ1R@@h:kXF5R~R Zkf8^ZdYlnv Zt;pMoC~ig vdwr/o ss?(0"Z=uW/I(yYv)t辽wwRdxkOaI7}㟇^؝>{N>!#d 'Oޠ|/|O{?/_H]`ȑz>)%84S`5h ^;H( Є Җ Sі٪f5mч "'"|R#/H CÆ #Abp Bp%VEΦQ8KF8fэbEj#cLH r4dmHd{Չx"8.v8cp!'2mYUqL8rֈ?a 'N` ?Y`K@Hy`UDT;39?)&d< m A4±ď0L7u 0& 4PJF?GCfӠfcL@b qE.i8 `F@C?~`EܡD`b wPiFDR(BVaGp"$"`qW5gFTM+zVP Eq|+'U2_ÞX BV>bkdtagF%<o: %W#Bnc v $ x1.%dۖk#!VPH!̓5$AZUɸ ;RB;޷8W!TH7psur,W"hoѧB&nY Y)\ (EA"$̌\L " `$ pc[IYm`)yeV8ғЉ(6 PW\L?$ū ^<1mx Պ$f;bXRghZ/bqp<ِm歀;:^dVcfؼ.} ]΀cmz`hb! pÀN3$Z$V@qEx!Dyx aB6Jj\w*1+D ~]`ayM% X<6?{=0s@xJcR;a<p,W0gLvquOIړiqaIӁ$}[A)d.LdTl^p9 U. `$$7d#̄yM g(p2x J6!4w qہ@hx5yq$z@8QHW:.!H-Hj_h#FA Z.N :`@I b$Pxdye &h%c^cQ(1%A䡎31u!yt [ȁ -IHP.&<8jdyN[ϸ7{ GN E&'HcYp8?C0|HOҗ;PԧN[XϺַ{%)&[J1E-jc7H&0n@a$1jP 6[I$~臨W daЗ Rb )pj5,K !a8g+l oB|$J1RQ9,> L¤s  Je*2TF/@Id G%/nQ۪kCP,aB zs\! ` G }/1 w C v0 0p . .h 0P*?f 0` )/@ŀ Ex0`!z= \nDŽc!Px R3tKa]_d8fKeg(j؆likt8vuw,BK`8\a0a 8舔؈8艃(\ '"+2EXpx P Px1< 1 x- NN0Gx 1 } <L`1  ޘl LT_+A~(k1eU@gQ`ȏ&RwIA { YW!HRPАk U ,9$aZQ?PIz,H CIZw'r@@T- PZrIPrKz1P R ru*1I0`8kX*@>ǜAC@V*IrDǨa1ʧ~*J#q@CP`کqC(6*ZU*@LV:|z#` r9ZzU0M:JV ˺يZ@<-qڮqCDx6Z:J00 B Ф9SZJj+# <#jary<n:@Fp᫵ z~3/ۧj(;1Ҡ .~:ڱ@k S p ⧐ :kHG07iL肥l_`[*CJ8x A Đ5,G~Jmat%10{m1]) t+`B`Kb**gn^1]~ 1 K J%[A B9[* ytŐkGmh ]j :w0 g. +N{0jp x0 + pX rޫw Qr @1 v! VW|)\6 Wrz Q3 `Qr0\6Z0B&\ ƀP{ۀ6  @i@ .yU {Vd  \dK8WWr8 p O:0` .380 ((ɓӥz,*.eHaʮlb+E˶B˼<\|Ȝʼ<\|؜ڼ<%0l<)@9/( :^m! s dCm0 m=p oi0$.t$$]&}(*,.0.SpHmҌIZJz8B0@ 1=&ʹ Fp l3v'D0! X,kD8͟wQ}BQ @ X\Cp\,01 onj=5@@0@e 22wFCˀ10| qL?=#Ȍ-F@H0.0ǵ /t~<= FK*md0n|( 7$=< `^ v5%gKFAIA6{m$=Bx $ ۀt'kH `ذE5;I4o pçY* }NdV%` g]-:KL%OvP?r ]$!`"%?$nᇐ>Z"1236Pј6w!g& $Aq.J Ql=V ;z P NΌJ l!@=3lTjB~P,"nIF`,pLʩ~6;n^ pԊ4$ 0 ^ Tp]l ~K>ݴ鞤_4 Nݫr|dE4^Fn䜫*0ox+/{bZz !?r.*J$ xmH(qJ?x=qCx-Mmq!G%m W4OR<hqj_n4D AX`wo6opԮ=/ ocQ@&Q<=lmk6Ia~ȧQD-^ĘQF=~RH%MDRJ")1eb6 @(#6X00YwTC#6b ذV]~VXe͞E:gTz` M,7(t`KI2iRYdʕ-_ƜYf'!N,k7XӨN*t n޽}\"3h*=8lW&Dp*jzBoW-nzݿ_>1%i C! :'Jm> /0C 7PX2fbUTYf8AN7i9"<? -=:2H!$9"xZ0p" 2$Xi $L3D3M^0ê*}s?yOf*pRڦɃoNTOMI'RKC%Uj7hP;N;hG͂K_5VYgʟ~@?ѮKVi6Xa%z=v_eYgVY6[m"jH%\sϥj}]w߅7 /\ Ǖ7_}7zj~&`1C`8b'bmb7cl8dG&dOF9eWfe_9fgfo9gwgT&hF:ifi:j#j:kv;l&GF;VmK !,HH*\ȰÇ#JHŋ3jHpǏ CIɓ(S\ɲ˗0cʜI'jɳϟ@ JѣH " Ј@DJJիXjʵh(bյٳhӪ]˶ۅ %jۻx˷߳r2È+^xCMKL˘aFɓCMi<#<3BUN˞Ms۵)$HWNc#_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*%c뭸 믷*,;Ю6{_:+m}c-Nv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmuhduWC]?a;<6e3|8i}v @l6[> <C|8=Ï?#P?'6V?z[wlh>K:Zo 86<:583|Gt5UѝU))uhU3DVFom*]!c1xիp21HcUyî:n,ުuiGbQ @70-d# rO nuRYñ45&Zֶ[͢u]<{K}@s wr؃uao:Ʌ/;/dpw eȰ1 dHRCɇJpx$d 6DdŮt>I kD-M#~Pv TUlCA!D/wLD,0dC8NW|w# rA䆄W~ c 'co3%Nh@`=}Nw-0i H nk]84ۉʵ|X GN(OW0gN?8Ǹ͑u" U? o#^&v}ax{/pkgmk㋍l m{Y|MGyym^G'AS{7Gvz)u.{Y#X?)b@LmXc' H![L>āw7P`/$p@NJD3D NPc/> `21I`sG  X3FP~ G1&la3g1Q=U^"!_d [ePj/!G@B8DXFxHJ$7Lh"p䄢r:777.CaTBg`?:e("ö 1DM*q{0 !7aWX' (Ő~X 8Q@.?.2Hy #`K Ҁ  x ٰ~Xβ f--9Gylٖnpr9tYvyxz|ٗ~9Yy n &pNis7  0`, 5pf0 H1КH q{: c'RF ֳ/ 8a(f&PsQS y/x`X`0ARa 8/Y  $$00'`gE! Q a,<Ґ ` U %l@  )y0 ! h r i ^ u [= HZ@   W`  g Z-;pb΀ 0 8*qP34 @ݘ2W B 58Ӈڇ@Zb2?Їq|!o@*ʫګª:ƺʬڬЪd0@a*a *䚮檮躮ڮzʮJZ&U;D̃v `@ ᪧD DyQ a D"K%뱗a T )e 1*+_1! b|( @N_q9;J· Ҵ 0wBr`N J0\a  I` ;!sIR;z n Yy gAp![!eI`A~l 7!a_4!;yA l~U|xb L[8Kȴ)F[b۽/6'dIt  QG{qq~BL U#( `Dz`@k BZp & B` – (1 ۱<>@B QH(P` 1aLP!`G1LNũ¾' Av|xLu|}ǀǂ@ͥDC]D}H JFNPOT] qB=WZ-P Ӻ0 gaӽrnTC0 ?@?.\ymHD]?ؓ=κ  ct#I1ل مM-`0ؚ&=4僤  -۠MC).`پmXVWMؓД+0I mswC m=ٕE ޘa}ݽ-m1ض=M]״ pμbR)T}}[*, X1C-]r tE='i߯\ޓPvp3$Nm,b"WAj=TN˽ *PӀ2Smrc IQ 60JiѦ-P> P q=%! h5Yxn@@i9l 3]*(8^)@nNߜaA7}@ X# 1 bNm ɞ/Pqq͠l` n@ S 1a ` n-n]5 ^2ĐP .>AP G0  -- *?P)ҾF@!u:p Wah.w" w P.B?6?@W`p A_m. ZZ > .+¾.YC YY`_ pP 1Ppo_.w>XJ1R |nQ,1l혮 P 3u*@ AN|Ѡ J rQ  uz` o/ @ ] Y ם ?O+@ DPB >QD-^ĘQFk \t KȎ-]SL5mڜum `Wlժe$\=>UTU%N&G~jUXe͞EZ\?ۺ7\uȮ^X`…Eaƍ?|+B]Yf΍ZΥMF soeY[lm[n#2oōk\rs?) #Wvݧ޾]xPyݿ_>F?i7_~?F8D0Adt!j/0C 7\0CG$Di0# D_1FإwG|(E/ D2I%e#J+,I#òK/SW$0D3M5qHqM9礳Λ3O=䳢2f>%< ECe.PPG'RLK7 oSQG%u|+%RWeU`p5VYg Vi5W]!tW_6'{ XcXdeٍu6ZiUZjŶYk[_6\q[w\sݴ\tew~Ӵ]yTc>j^}U:G!`%إ !!N'h(I㉀A&p8"T()ddfdee|5fh`{2yFyV8e'kny竽x~'~(Ҁ`ȁ~v/ߋ&p7L T#E.PK1\!FA.*9dbb`HܹяAZx$Hn E A$#5-! #c̖N(~IG:;a I#*uIG."@̀3 pe25$L '9Mi= F2ȇ $*$FMrpD"MĔ;`7kl2~w4B>сaV"$![AfP% oU IECpV2Ѓk|$h*v uiVMz 4S)3:=!HRz m:w!{( AXִF BJ ,( *`y& lc8" qp vlܖ@&鍐޻ROWn, D@j\͋K8Wwʭ(T#4Qo{><,y9.ܛ w XH@8k4t(UGd? y#E@RnZq7cwct0yrL Kv p{Bix:e%<`syA/[J<.0?>pP`<'݋bR3ǸC{` Є&tk/,χ>m께B_0S >*~'s)Ͻ%Bvн %Py;R~P>x«8(@D@ 뽂~Az@@q3yAj-3Aۣmػ@Èm;2z'$q,ֹ("?9$t L(T -T.4ܿ!?1 q%q(y*JU3ĊJ:xHz& w''xw0CmAw 黄X0C  k g ĂwX28Z HTLEKNb'BUX(#o2JChq*3l< Wx%5p5ʈ)@Rq0[xu|uTlرVpF;~0EK䣃26Â0i,ŎƅH?KI߃I< s`0,ƂBC ' 1xʨ>$+0m{LFąE(%,JDz 0脁0(A6$y-!k$XJhKĄH7 lIX( VNSfAPx0´4M=xx{*(ЮPl |0GP48Jq3tȡyDyȁOId>lɇ ^l@4Op1zHƒ( *|gHBȆī-|C4t=qH~Ȝ e  = " "5$} $U&- &u( (K))*--.S0+ 2 24 85uӹ`7S9ӱ=>?@A%B5CEDUEeFuGHIJKLMNOPQ%R5SETUUeVuWXYZ[\]^_`a%b5cEdUeefughijklmnopq%r5sEtUuevuwxyz{|}~؀؁%؂5؃E؄U؅e؆u؇؈؉؋، _`HbP,--&X9B Y-0_( ZY_-# %: X_Ѕ Y1 ꅠ5ࠒYغ_# _?M[_Y< %Z] -X)[ \$.[-ⒶH %q-P 6[s<q; ح7k]3!* Ս %5^M 2 Ue^q !,NoH*\ȰÇ#JHŋ3jpOU&(S\ɲ˗0cʜ)QӤhɳϟ@ijBडU L0ҠPJJ՞@^ʵׯA6@[b˶۷pᚍKݻ-5r_'3e„Èiǐ#KLpOb̹s䛞CMӨc Nͺװc:t۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*|C#Ϊj5Z8_RDM*+k&.|"Զ7mؖHܪW*N K2ݖ]'a:P2ٰ+ouH3ً,l' 7G,Wlgw ,l2UrTK4L.6Rb@ ()2#-uF0Xct+-@) #-p-tmx|߀.n'c 9K6_Ois9yi裓闲aWxE@?3y:@s{x<<@V?i`?#OwN4#~[N6LB4~?# <]E?Oi/|h!@ӀGhC <Y+98(#,aOH]4̡w@Dx ĄDt(q# AB&L@Y`i` ~c4Տq0U$ȯ6qC 6$#(CL$1*򑐌$'IJZw1?)jϑ8A.\3'Ay"6DQVVI6H"BGpo#ɘ/eF,.ZLe̦6nz 8IrL:v㹩͓ &F|rjd?5eD?T=(6.O:dl4/#?XHEґ(%JGj&=VfFQxQ0 }n*ў _ h7b㸧у8.|+EMlp D ʙ0!a $~QFEh5aJ@WUuE?zzQnX[!ت^*_|сȃx1x0_ 1xVFvCH8"jo%Mr:ЍtKZͮvz xKMz|Kͯ~LN;'L [0oakGybXG%oخ8F-~1bH)1Y$]4mXCq21T'YEN~r,eGP2[mD]ܗIԍ9DeܙEfCmܛA#~NsPb;aS&L$XZ8j 16<ʷ;Y P :0QF.IB.AO /1TV|+Z\`b<QfLE_rK \zI9\} i;ἢLj\0ȓ\ , )AǞ;V#!Ȧ\ÚʬU [ ,x{˺, 4,%j ƭ: {,IJ0˭L.j4`˿mɮLr+ͼ6\ ʴI @ά\l΄* ϴ@l?<Ώlml̔lӜ3LD8%/?Ϗt0tMjj%C@&v#m8HnVH/#˹s`1lUT+`<=%Vk009"tcRalphnPY;h qylQ0M#Im7t6CPAqlS}PyŪn}VQX۷Ke\ {6EoPgR$6 rW=R DhRQ &C={+W-4btTy ـRQ P+c^aws ,"ܥ,HS=P% n FVZ#ؽ\d^5ު5SL.&5Bz++4M)cCZ ;^|5}z>E.IYư}0ENlI@ AW+l T>Loݙr.ѡ,\T>璌.ТȮL p^isFC|56aޥkiL |ˣ>kV#ܡ.`贼 ,5_)NB$y%W[Ϯ_%_%_%^_*^B & C.>_6%_͠x @Lɻл_ _k|.M_|ZXB=_DSTBO_>%"uO]%*_&?|Ý?o2oFoIKMϳ -άА^ MΥV ~+DKl˵pl Z\Oʶklо n1Dloʤ !,NoH*\ȰÇ#JHŋ3j܈Ǐ CIɓ(S\ɲ˗0cʜSգzAU4 Jѣ3i򈴩ӧPe!1ӄ[KٳhӪ]veXbݻx󪍫߿9fÈ+^̸ǐ#KLe0]̹ϠC;ӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘RNHt$jꩨꪬ꫰*- N!r /pL1kaz" L[ 2f #L|VL. Cl@+lk AfNKl' 7G,Wlgw ,[ (,{N` ,/<r0@U6}"P/B'M/_)tEKKU@S\w`-dmhlp-tmx|߀.n'7G.䔣mMOcP#z\ <ဓN:@8/[?:5|L\O6@hl0/P:|O5?P??niO@`c7z GH(L =..L c*j8̡w@ H"HL&:PH*ZX̢.z` H2hLcq~*P㘶Ao H带T:m Ce:AH2|SA|?Ё:(4hP1 z(D$щR肒QjA(F!Џ8(YR(.-PKcj0NwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'KZͬf7z hGKҚMjAF m8c,Zͭnw"oC Mr:ЍtKZͮvz xǫMz+ߙB#ota_#1jQ [HM~'`>J}7`+2C]+!!D@&83<g< PH_a$Әpr|dw&@|s]@b\6Cnvlc5۹"y`e>HsDgX \ ߁b~ ?8E7^'##M5p*`4.!Ur@ǎZ /n`O:$tP\ (򊂌b `E7bmCl] @g8+[@$h^;sDx ̀NְGD-8@3%p"9AAj'$A[L,B&cc Ub DC4]>8 OB XCdQLq> ]Q1# )`Y k @ފb! b4_}Z@N4 xB$'ixq<H3"asE_s]8@b#L@ƺLF˂+F b-x~Wؾj|~dG4\=tы`0*dc4 Ds yj€ 17wa1{W(k1'$Xy!b f&I&6-I{* 8b# P `:;F0b-`c c6 lHBHajZH<0_HEh*(dX-}lGvq fblgux/؃?xU RXAXVn,Q8؉8Xx؊8Xx؋8XxȘʸ،S`?u(Aֈe QQ#asH(rn4N >GʉADډ vxrFH ȤCJh_pHҹ9(3:giډlڟ[Jd8nډxzډfʧu٥ ?Nj>BVn+(f0 !ʆfׂc0`l@ ʆ4P ?xs!,NIH*\ȰÇ#JHŋ3jܘV(5ɓ(S\ɲ˗0~͛8sܩBBLD3+MZʧ@PxJJիXQʵׯ`A:Ņ-Rm54'Q?E Kݻx˷_fjaQQ5e¤ǐ#+˘3k̹ϠCF9xӨS^ͺJM۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨ&NZ(N:H֪끯+k&3*lzN5@,P-yJD۱䦻4eJ' 6[ݻ,l' 7G,Wlgw ,zlN,T '1,KU3-)@DLѨB1+#4D--TgP1Zw`-dmhlp-tmx|߀.n'7G.Wn:,?,Ϊz&n?Op{3<O|ߏC/=gw/o>zH>Qca 6zé6aaᯁz'H Z̠7z GH(L W0 gH8$sPa(" %>?ӆ pbuR*jOW}QO?q6񍏪;qụ> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0Ib2LdtfLiʹ)?m <N8CZlfu#0!3&@;ρn @І:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^VhA dV)- (` @eQ`K,f܁T f9J\ ‚-B h! \cBA"I:og f$unVD ,qb-DA ?0VKh D ؄5{e2ލ,V]DüAG-_@r^ M(ـY  (BlA O GL(NW0gL˱w@L"H61 :m}@day"(o,f!oxc\!._DCJyAbe' \ P Y6'q 4OF (Cee_ g1ϑ20 &'[lVvG'#xTvq,<@WiphHwmFX ׄA@eFg +H a@Pq^Vh_6 qV]aÖs2qXfv`g|vY{ȇ@6i!.pfL_8zчkVEh^ViYfpH-PeXk񆪘5jx؋8XxȘʸ،8Xxؘڸ؍8Xx蘎긎؎(I9Q?:&hc*&ve,av pG Ps?>   bb 4D^;7w eU`(UI Y1c58  yKaF'?1X 0 y)FY' 0pAE GYUC^SMіH9]^y︗||ȋ(FH`ny @XicvKS `Yvhiv ?`< ɰOk h Yohta8vɊZh h &)Tyh"TͩoPyTQ䜟9f&gT  iĩsHQigC@y@[D8B t懟AёfS } j<` :Xsj)!#jd!,HoH*\ȰÇ#JHŋ3jqI@!55P@H͛8sɳϟ 3JѣH*(2᠙hj,biׯ`Ê{%ٳhӪ] 6US\t%ŕVQ _:T%pPB Lz+^̸צA'%VhI``丳ϠCM鮗L>ͺװc˞Mb&εsͻ N{cУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼믵 5ƎZ !8F"dnlfvP|+FPߵ^Ț;.74H!5kn2[ ,ph!2#2'l;8qck(@;0#w L{2*(,01)\t=\a/HB/16125XWt\÷u`ud7vhwvlsvlRtϝxbp]yw߄vwq|t+8q;5>c.U9yݻ]鹤: .bܺ2;Í-%-kN{lobJ #,|S$@[=Y- - {ߗm2‰~`ݽ.oEpѻ{]s| N-l dCHŒ(\ SB0 cHä̰8$ sÞ찇@HD HD,PlH*ZX̢.z` cq!qlcd>яy#qxF4jp3CajAq$fX}A !m(rǹ@GV%CyD$7 7J>$4N80hcKaȥqˁh2Udc&#$0MUHlf39 3:p`:':zS^=E}ޓ[EW4(BЅ&T"D#ZņR4h3$ ˟(HCq&BHeTAXZȃ8ͩNwӞ@ PJԢ#6=R+h1R|(JTF$U-!VծzS%XJֲhMZֶp\J׺xͫ^׾ Q)X>;,bUV̤ɤcٚN 0q$,.=Khdߌ0bI2jk"jiҴ-fKvQI>0!?3Ztq JVs{A$?05aJv/J@ tzY0?Jvr*| q7ZoN;'L [ΰ7{ GL(NW0gL8αw@L"HN&;PL*[Xβ#8-g5`# tR0a0JPwq     ݠVw`zx 5{ $(u z0x )Eh{ָp ,y("Y 0r'uvѰQ.X˰CP #5U(? 3$' $ zP=49A@Ny?Ð ` (07 A?P @h5@wS`DD 4Q (Yi8 >` IDytMQ98rhC֩)8@T8 wg!.`ڇ%,XbA *iڡ_!F""Mx)TH/%:G:@LKhķcM%S\1 *.:d_%a|V aH&mAq|Kdk%yԋrKZ2c\ юd%&,WI6xnDL|PƞǗɦ\Lş,Ďd,Ɩ H˝,z<d]%HdRXʶ\M6% v\P<ؿJ6lPl~sz뜧),Qw!h  - =LX!  msmҥt:Pu8} =43Rgm&U_`?sa#?cP?-70M @wu0 |߈?(O?7G.Wngw946یy(w~:?.B3."3:Oꅆ,{h^ 4="Oܫ,◟(ɨ/o[mi2xi:cYX p8$Z2Al ď-`8 ;0]IX?LU_p갇@"*eFL"R&NOa=)Zq'T7ECaЃ002$4SElqp,Ii0xI>zd~ IBL"BE:DIER 0HMƎyJC:>J5 d+gI&eF 0IbL2f:Ќ4IjZ̦6n2J޼)BV%iGȬNf];;y̧>~ @_4~=;hɔip &}PG? PԢDĨHGJҒfRP`iKgzC8S:lͱ?x͠JRB]A5}%4Dqmխ3 bXU(eMYj1LK8JӼuWM?Ș*կ=_X aٙ-vc#9y,Se1{9ɒ> Z͢t^cliCt#a]- +Ҷ-n# pKMrxH G=\#tpRxuFFB}m?׉dc Df_}a@pLKX5D!0& D0Hv$a -"?0gL8αw@L"HN&;PL*[Xβ.{`L2hN6pL:xγ>πMBЈNF;ѐ'MJ[Ҙδ7N{ӠGMRԨNWVհgMZָεw^MbNf;ЎA%iG6o\0cB i@!`CB!0-f qYw- i]nrD o 47oO7ͽn".H-lB|A(w}[ 0H;.1H68nC{䃤&B;P='6FJNHjENvG7a@ԢBl1x?] wA p#Pc\b.BOO0\/.v1#ׂVdCs\W'Hy^p=Mq }݂ yGKk| $ w)vA\dP & |a7P U1@buCu@w"Wr ~ g-G0Ȁ fP 9>r@yWxlg >b 0`Q_r(_ Lhw ar08tuvDy!  ! yMxP d{At4pq QSp J0Q ^+@sW\1P A6 (A`BX (C1 uq ^X,tGwpNb1@ }181{! !! @a p $1! %G׃0'Apl ٖ%w 1t@ hQⅼmنW1 O~z&  ix+v ҁ5`u'!,P6K7 wvJy>铉 E?sÏ CY;DG rT”D)Q9jKٔ\68Yw`)[b)7e)VD@y1wk'u7xrY Po}opFo /Y@ Gy 7sK9x y9HIiqVo* puq.n|iǛ Fu qIA Gyo V& d wRAtј4<Ҁ @ C> ) (0 ـ<2! W3  i#P;1;K%03VS^r 7!1 |) ^^=#Ezc,ڣzm v*D0 Z$'Jv*?2upQf1XBj@,Jc0~@5s:`6CD! 0` 7 3c@@]٠ p73]@>ZW{ @3_1B`(sW! a{,!cNUzQBJϠ S0Ϡ -CE s3nC3Q`w *W␪ثzVyy`PZ\ʠq Z犮qXym׺>qpY:-tK|7bysF޶ 4zi"KyDgGtQ]V'  Z-'s@PBQ Bnj}W+SS3xAvx1ZkoWg{a4oq+nrj|a@ ,]XPPo C p_pKZn3H:{4 THfc r+yq6 HQڷ=7ՉyleS:+ tAa I;Ki{IRB  TO* "!%XuCx$nдqu3GÞr<:!J;7rZĽmG=+1m@ۀ< 4mkBW*J]k<̤L3a4O FxQ/\| 0_PU!Km R/`60 ā ɰ)a*v/F F2@!ĺl0=֐([[{ɼBH:k@5̲< P ؙ* _N=6hD@lc5 [vj? )]F@qQ;lsa"< m4 E=>ʿ~ U=hՂoys;d ֍Q+Qn- \rH PaaVr7Qmdn ,R3qКyHwݯ >{c0  &ތH,p;a|/{38pAƹ" ۀ30@D (ڳoG/o^+ ^m~Dٜ 0?:{ I۹. ֐x^ >zmF38QlDܼ;'|H-H IO܄TEH[׃(K+~Isw1N7Fy 6y>{7.DrN`Af{)ZTM>yK*]V.qs e_^>*mV.y7Fu~_.Ӝ}Nwru\d0g &&^ >Oaqyy[.ꣾV{)囎JQXpn畜G7A^p*^XqԟʮGMn^~YNc^`A[Xn4+}t;oOޏoPQ?  _LNqI$ #=U#Ea0g3}@9#{b<1t1=ODoJ OvðSo>.\ gy@ 8$1f?kr;r!,NH*\ȰÇ#JHŋ3jȱǏ Z3.ɓ(S\ɲ˗0cʜIMɳϟ@ JѣH*]ʴӧPJMnիXjʵkyKٳh2'0ڷpʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװYM۸sͻ߶C &ȓO<1x_>ks};yϫ_Ͼ˟_7ϟ(h& 6F(@L:πbMz؇&Z⋃Y 0hUݨM@)䐈:D&KPNTViXf\v`)dNh 7tios|矀*蠄j衈&袌6裐F*餔Vj饘f馜vJ84z**hjgluqꪛc[Y2L#뭓%L#c!*k&6F+Vkfv+NE`¹?koKޫ/pl0?-0Wlgw ,$l(,0,4l8nsn,mbPF'J74CG-TS-5UW}Y[u]/5aMm>,jKvn#OpC Xs0w-z76373v"θ?Wngw砇.M<s0jz~9,D!k)@{FZ,G,+@A$DR*/A+3j&+HL:'H Z̠7z GH(L W0 gH8̡w@ H"HL&:PH*ZX̢.z` H2hL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WɘW삕.`y,i!?~@ `0F-ja]0Č00 0Q ^♇I!r p3@a tg80h ĞH79ZS$0P@ Ơj&=]0Jc@)~(Egl03s5DEN: AK?jr pO_9\lviMcDߔ@Ի`UApT]W*LbVuPZ[2.rIa( J4Y‹Ըc[!TVE`Ef-jUe -;-1a)Za(h2ZvRnլ?iLdz  q`Yn'yK0 Y/{6+m `Ny@&9 m;[e ASR4,b!3LU,"ڱOX +# YmӺ ;,V }#f*381#g-raB7lKdvt DWlr`Š0:,x3f\C3,.d&̗490@\r^PfI5}-Mju͜ƋM. O-tMhBؕV&E(P1PZD(DAkQF2@ &hi` y1CvqL`l_X"؇r+a7mf'*_@S["]BT5S<@HIia iyl@~%tdm x&Ba6W[FyIҕΐ $G6;Crrzau'IQ3a w pSN&nGa.怇~44as%Q7[ ~L`sOnUG^ 4> $h$۠E"v< _ pOKQ m!'kd90Hk  ('cA.3J~~SR*PJ~'ptxAvF sJ H f=66M~yf,40hfj+x~5Ng!XؠOD@@PT)h{{r6JO$P0.`@y#AtMִV50Z5bD&MeK[j|m NJ|MH։:dϚjֺ=jѭjZ4A:纮1 .z+~᪯1r %9,i)1r:&Q˩ [[ k1űq ;&IQ,(kGa16`0 D]fa SL+ɬQۛ4]QEk7 K Qf>:opk\!,H1H*\ȰÇ#JHŋ3jȱǏ 8O[ȓ(S\ɲ˗0cʜI͛8~ɜ@ JѣH*]ʴӧPJJի{bʵׯ`ÊسhӪ]˶[fʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞Mvus޽Zn <ȓ/I74t@xԳk?)vے}OdӫG}}1˟Oh& 6F(Vh H`a`!Eh_!8y*24eLX#OiH&;J6$W^<)NaGXf\v`)dihlfy#P{oֹ:X|jO^[$nq袌6裐F*餔Vj饘f馜v駠*ꨤjꩨ ɍ!O۟k3;3L̲F4a#Y v+k覫+kF@L6K Ku GT6JlQ{owǂ$l(,0,8ӬB7,DmH'L7PG-TWmΏZ8\a-d;:h]6im6q=u'|yݱ IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0Ib2-9^􂙵qQ <0n`! R6Kv~s?:K3mjfhv$; Ox21gBnrS D\0Z"4 oT@ځЉ&g; qœ.2/mZ(H y)7 N€0,XbYes຾nTtA k/0pS!jtOz5^m'9OZ6L]{(\(b  I0M?jQrbhbyEӢ:ideJ"ݬA*_49rZd3( b!-|+ c8QVD(D \IA,L#@ UL \ ^egD F/@,DExW˶4f(yiWB m31Zy 8!w c0n @wpo^Fg?"Ё")CrR@E.^b}2Q/ 2Apf:fFg?eH\BxLBCz/{Sb`ŗ˦O҂i"ѡ˨=ݚ6 krXfFm "g)g^o@Gtٽޮ y]ڗ6yEc2@̹oOƝ3lg뎌]]x;Bōov;UwghyKfY)a4|g),q `b\1ȽK#1v#76؂cdk#F ғSL'o+iko&5 ex5j)ZZQ Ah Ѫ 8i/zv F>72Xf}}{!y|1 %6H0DNPVa-w"+`Xv#1M1bsB\s"1GӖ{Lr1dg gk3i/1` 0PvZQx#۰#0@dBme'ev0 '172P=)0`0^0tPy3=G/(uW/787߄`z9p8ė~| ư +w5 i8@@~D&u`uO 08U{n`F 2Å!i|q#(Dw"$|Q uz!A+X )gi0wÆnf1}Wfh5Xc`vr+@QEVUpH%;O`srq`*YCF`0+)?| bPz,*cэ UOP 0DPMi#{ygfu 7 N)/6+(P4Us5 Wxއ)t!wQY*7*S 4%.H)d-/ 7*y CtzՔT+71! Cl'T2cY0Fhp c}9/? n)*Iv@ T/mw2 ۰jd3r 9U0](QΩkqega"Yh0g5+PFVjQ6`FI)O8ngńa!ij J5|Ty ȟ VڇDwɡMdJ]Ct*&{1 &y[Ě<*X #Fa*0RN]ƠM:`qXZlrIcQM6 UqdfzLjlڦpr:tZvzxz|ڧ~:Zzh7_ƨj8a J2aʩz3 z !,NH*\ȰÇ#JHŋ3jȱǏ 8n(S\ɲ˗0cʜI͛8sYΟ@ JѣH*]Zt]ALJJիXjJџ@~rKٳhӪ]+TybʝKݻxg.W LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ N!שN]ˣKNIVuP~}\Apī_TC*m5?~q4_}e&LA΄ NxbD@TbO`}[}(F%b}@:"(;,h#PGv@-H&<PF)NLiXDc\veE|)dd dlylt(A dyu9W: 9X,(g6({ ̣j5iv ?jꪲ}Z*+Nܪ뮠}$F`5}Ϩ&{>#) :+yAKe,v-W~+TK;@$k1#0ԼlD.s +mG,Wlgw ,$l(,]0;i4F8zs9Lf?,kmL[tPG-e S X߈,Yw`-dmhlp-tmx|t~c| IBL"9gh@9;%+ 'P_*gL *{t rهY8$ wD0A] e b@C8gvݯ(gC錧~ @JЂMBІ:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'KZͬf7z hGKҚMF_ նp-``RC ~CAЂ-r[ 0|hG)x@xx`m.ߺ7C~@ %Bt+w nmA 7=@Z ci.t{;^V.%`[ߚؼmv\>ol\ @x ^w?uoKہԂ@!` _ -\`^(kfV ]pyE-ֶDΈ5g>mkN0p{ p-t %&tEH*נب<A DE,Ey>1gZ) #5Ȁ TNĸ0[BǥhFh _eCMIE/yh,7$[H4v01Emd_#4K^tH_"r$`6`f\HҎ8D$1A:]R//[D +^<8rX*sjOL@ؙ aHpvre>|J1n\kPnx5A*|.-s^βT Spc)hT;X v~0`uvt O7}@\YCe +b,oˍ?b __cC@Z0a * \h Ȁ1u  ӆoҀ (4 &~wÁh4J6w3dMƂQ/qaF335RD*28NEh@|?$Eh+Z[.W[^x$u^ W5^.in$g酁s#%Hz8td, mHr#}o[q8(g(\r(f^"؈j tU R腡`C6Baxe-@w+W$^h#|C0x"8RCֈ"˘؍0N(&Qf/#HUQ/222'u u`a+c`M1QgWQF#!1Nr[83O@1&P4'@!#D&)Y$MA7&*h7J\B ;I` =|$P >pC]a劎 0/ ɐ!B5'cR4=?IQ5m8RJ(щHI5`] `%@^uEr|# =$~ %P0IBYNQ27r|Pe !=Q0p,# G"a]?@ ji01`qIMHo֥ WYPCBIEh9lE љYR.D%?E^-trR G6)c"c({G97&"Fn`7Dn1/ $ E Z^&U4Z7J98FC5 L ?iC)cp3cL ٰ rUn4(qxJ/!aYC#DtA[epdO6֠/8ۙ!Щg^8jH=@HPh&g7}WP_J6n3dPE 7ppAi=/9Q%7pE id) 7p 5` 6Ne Т0:+:S02,=cG  ۩ki#3ot12BZ 2$ t&bo L֐ AI@RO*1q,5ԴS&b#OALOR0@i[ j `pxh;jfY*zv[=o ZŭHW0| [2Z 3/ e aԠ2qA";dkʅ ҕ:rj7![zek/UZ%R+0DaD&e4p0D*\ОH.S]+H$0אI!8P[Ņ\+1 7e` @$FD;51  @ ߠ y JԿ;v^ȕ#4k1tD\?P/78Q{pvGHD)00 ?ʑ'ARdý.W[^F6 [ż`6 ŸAh< \8[L64yP!5>H;0iL -Faዊ||~,n\;ȻQa8-ȿQh( ɽ!F`^kȬ8ŜwlɕeJիXju֯`ÊK,خfӪ]˶۷EKݻxT7W߿ <+^̸T`^;L%gm3O*ϠC ,Y:p=^ͺ^_˞M6ضs >7ȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+3l}raA0g "AHK:#Aj g"T A,or#80En `2P1kg DD3l"PynPK b,aܰ AK#-d0,4l8<@-DmH'L7PG]l(RWmXg\w`-dmh6в%] #3q!mD0? A0Q@~?@]K-/^}w}~xk>Cy@Tn7銛. N9.q鲃`9aKn;@莼 w7B,Sߡ_;A+> 4zoXߠK]Z`9~n 8`g,^& q @^7YtC'?P 8(zƋ0|OIg=!4{=E.* 1ދ/v&E*biyEvqy@ʨ3Z k -lJ\U8F^ gH"%' , HY(H= $:$#tI12w&JMz Y+e(Y6'i {䥇|=]PeߌR(c.hh1XZB8$ oZHb y!ڰdgsl'́x3 R @HR4<)Ct/T(8YM4cfh phGNJȑ|4"0LgJӚ8ͩNwӞ@eb"HMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'KB#,i ;bKIb5jYvӅm`\{Vm:S;[څofve.\;BT%iq]춅u{=nAz+W-{\W0ݼ/aB_n/"fJ@!,O [H*\ȰÇ#JH3bȱǏ CyPF(S\ɲ@]ʜI&MmɳC| J&ТH*ytӧP/JjTYʵhY[SYs]V$mĥ ڶ]tQ-߿K L8ˆ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(VhfvOS|@07r04SA@#B`207sB AL`MT,0@ @K@B-d~ihlp)tix|矀*蠄j衈^hH)2 .g`1؂f 4NXzөD @ff@VC #j@W @p0Ji ,A[Ҙk,~Cr K-71-J.1@4S@,Ђ1 t,⋗_ " @ifRf뮩 .({cnK2g[+2$'j8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|>߀.n'7G.Wngw砇.褗n騿J!,b 1H*\ȰÇ#JHḋ/VȱǏ C~̘Qɓ(SLIʗ0cʄR̛8s\XsΟ@)ѣDʴS>JUj݊O\ÊE9k6Ǫ];XtదeKBvE8w߼} ^xÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfva~a.(,0(4h8nJ<@)DiH&S)Ԣ˓dXLRYeM:@\Y@PrY2C@| 0@°)2!t1YS*!|K`DA2 C虳tDf d"?AРr&g`:@ܲ -Dh,|k.bZ4[ !`-. "!rTJ@nk,l' 7G,Wlgw ,$l(,0,4l8<@-D"}a@!,HH*\ȰÇ#JHŋ3jȱǏ Gq(S ɲ˗0cʜI͛8srI*UJѣH*]ʴӂ?KMիXjʵҨ@JٳhӪ]+IlʝKݻ;*v,޿ Lxm]Yǐ#K/]N̹τn{ӨSv*4հc˞M"s.]U_޶wȓ+ sУK5سkwl`kN u7s˟Oz.o(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlߺo\iO rȑL&h*/r.#O0GLb3 07,I:7Lq tЌtJ/NtTWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/WogN3 zyT^'AbMIQ#`L,18\C  6aP:(@&\?gDc4#@ఊu  "p@f$Dptn @1%@R P/&PF0~QeE!0*rF(&x^QQE1z1[`.D70",B C&5 8~ @%-`DI(4/tAT$P&,k^В f q`FSb-pa_ xCb\$P€߄A Gz68!_ 8L8!+R T@3, 5-T=*EP\@0*XSp)(@G,(0 M|0%jQObX ,mD*RRFMRj0(@ 05Jխk_Q;dB&B1<Q 5;O0!(@, (FY4r'B4 Q (F(D RBxnږ3 c5; ,)4{5rnoBA襮x?-|^и|[_|⿟ho+޷_sF'aFgn3Gb"g&0f"8wc@cHNqWȫ%=#=  `E(/Y?B(/c 9Śl@9q~@;=jf4^@8Z @ Zf=Yuq=f9|0-2ˬ~P{u]:-Oy0@kaυչ3AlJgӏZhi)k3/Kŭ*_f˺ iCc=\9(c!}nNZgY,<዆V(p#0ƕӌnbca8y;5H,j! /80 *q > Ē̏$CUiQY O$OSK//FY~9 E.^;_-fvPm EǓ>OZpBީ#,@B8DXFxHJL؄NPR8TXVxXZ\؅^`b8dXfxhjl؆npr8tXvxxz|؇~8Xxq؈W8Xx؉8Xx UYsp(n mhl@8n!,O+yH*\ȰÇ#Jq\~(jȱǏ CIɓ(S\ɲ˗0cQ͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKN:qسcνoڽ_|vӳ6][O~f,"h `ρ 60)56 ^v(0ɤzhY͇,ZUb0Ƹԋ2hcP4ި<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+kc,l'p8|#Wlgw ,73& %#IJROND3< Po0R$L@ -,TWmX;3:9`-L@5#r͓8 d2t-߀Tn'7G.Ot6\wA H.GOT Q$.9 @ Dn r8۬4O?P:Wo=(F {lI|#OA^zAK, 5aE,bbP sHi 9T2@ xg8 @ 0 NFh ;x@BR f2Z  @^ÉUW}A! js+1` ZߏE:sNTkĂA Ha MA.Ò N k@?í0}\=W;`a (Ѝl0uQ `H߷gX.(%ؘK:AuzrHB2b u]/% 0`P P'7 pnPg OMj=~@2X`/  %!v{ 6yP` p pyhdA h9^x sg]P @ ߠ 7 WL^sp?`  P PW p ̵\2y4Y6y8(%3A 97  yyCP 0 %-YB"Ŏ=3 ŀ I \Ő ' ) [ְ ) P  ~p pI]&` I V{x ` Y VAy ?C<ٙ9Yy陚ٙ_ ` f  0 i6 A%I`yyАא U ɝv 0 0) 9 ޹{` J PyϹ UɝP0 y70z ڠ:Z扗 -` Ƞ З ) ɝ94J`8 ,;Z>:0J )3ڣFJLڤNPR:Mʢ1* `  é 9H p9ʢ&:pjp:0 wv:lrʧ|88ڨ:Zʣ}B1Qlf6 x @ :jz:ZzȚJʬkʩ6` D @k 0 ׺@ ޺@: z芮ڮj4 zگ:  ]  A x9>oP>'7K{9"!+ӱ[(k.0 7#˱6k4(k:k<˱;['B>{C{E*˴8=MKS+OKWkQ7˵&kb0c; \iaabbo+tQ\aj[i\i;}}yK۷+۸x˶z+;˹{{˶K ˺;˻뻻kK;ȫ aԃm9b4 :ճ?B7ܳ"%gz&f; [뾉r { +BlB  @ (<|2 !B*$" 1V2@XR TRFV.%_MԔ@UPLm \NOrIQ cM8mv~h^u.IbS#n>ڋ~"> .n"` >? QQ#k[n'n>+鳞2~S=2G QŔ=@~ =ңN:Nn%~N~QFn42C?3!d/ABfN챎  1^0IAU U%pĠ 0Jl3g 0*p.?UL=U*_p6@/-O`)/NGN/P/=U.07 @<C @ m, %᠐4  rĢ/1??4=E*ĈSO=@':/N|\Nt?'e?d&6Z @4lGgO(z2FO(g ܟQO2DAsB7n4E?@3w2GcN@@ `.t"!6xct zE đ!]SL5męSN=}TP6aETR/W6%jS^ŚUV]jaL`e͞:C}R*ZuśWޣ)-I8ZD YdʕyY3B7Zh"禬nKZlڵ)[d\𜸉G\rcw]tխ߅~]vݽx͟O-e~ѿ_Cd~kapRR/$~GO~*0C 5#b \hZjZp` %uppC6Fbb/H~gqqndI'ZzPHxq&R0J1$̦|fILL9礳)M@dflPCΙ '} >ŘlQM7 £9$dSUWe=2%=[V[;(6tG %5Xa% }A, `6ZiGH~|ԉqZoơf!Kԡ0\w߅7gJQ Q*Em!4^}a8XYb aa X0'gv9d+XEf9 MvfHg ?UgnD7F:jTZE EY'AҤllk&_'ݦ>;n:=pQ߹| `?!z1pUqt"9crˑ#qt)|rG[3ȔIguۺ pbyuoJ|%hKx㓊XZt)xaB 8-:d xUEgm(SgA^_YpH 5kOD,"UD `D5 | PA/ I^)6q aEM40JA΀\XH p+ i@Q *(r XH8Љ{A&AD"{2Aj :!{b+W&p!a#c'o0aҨF0B !X#_L;dn8  #aɒH}/PD%8 |0ځHJ8T2plD , "bjѓ-xE gb0^}9Ͳ [x-f.IZ;jSj& h$M⡍W!xӠ9yUB@A`P6}6tjP~P@ )Pr :U[?ebY:QRpbXп젢"0!dHRl,r()X:yG!I})DRR`ONT $- B(xq O碐< #hAU\U>¤ZW?'Mh%G>6$^Y@ dD`rlBqXAT[ȇ: D^s6=Iv@ 2k~q{ nHWNBFϮ &vjL\`PZ]JuCT.{k  D&[u mHi~-Ey# ~31CzIyn:KT5y5q\Idi1~;Pao~_ ~<0`@^d&q-p"7L&]%W9`(vb+wi5v se211hl29`Kpf:̀5r)ra .SlIso( o<tE^E7_UؑLLt%stoÄ580iRi4KD]jV7 4tFjZӇ49uuXלzLrkb3uma/c Llj;ؒ.tiovLmr/IsՍs/7tDyo~'w>7Gxw ^&Y@pO' x5Μ`9r:<8U7|/ s5ǹq=2`]]G"Ù@ >BzsdR:Z t Y]>& {ϲu ;jV^vq{VN{/kru^({ xOg|c{ǼN/g9A!yd/}gtä=}g@@` =;{K/~W%IJH򥿐Br}0}GԾSod Z? !,Jh7H*\ȰÇ#JH!tҁPt +Iɓ(S\ɲ˗0cʜI͛8+ϟ@y QF)RӧPJJիXjx-qٳ5[ʝKݻx0ۂSg˞I8A ȷǐ#KLP`-9`bY^ͺװc6yV;o8Y`G#LĘ1^g+_μq^׫Wo1TzL\ӫ_Ͼ}_Eϙ`D *V^(΄L< ?S ~f#8oQv ! b(&2y 88㎐Й6hҙ  L61 o&?ȼB@1%di80*( -r|g̠b?I/ΈcߟF*餲cGse1ƨ*ꨤS:„Rd?꫰T: -H0Ԥ+@(0JF+t (0"j(;i[4GR 5a:S5ƫֿ`lsD\7ìqMldfwT($lK!Pq'r0CuX1Zq70A| TះS\ n@P?0*!a@1(0aX&TBAa#@H!1$,zb GxɗqwЏO[د07 ~_o;2ttx!+U@l" &@LP f|!qu !  |  ( 0  f @f` p{{n  PO o3 n )`  S P   'o ^ lx~nprl fum  }xq GwZRss( zG 4tEw(XF q0 &S0 P/m `cnp f P ` 7}>&@ J`   d wlp}P b o~ Rd ?bazq[ fp Yư ` ` 7 "9$Y&y&}9VP0~' 8g&0gcf `` @ 0 ` P ` Ǒ@ '6 X|l7o_ k PT Al( T0jN P 8xPݠ9 6 b44   HNЈy'_*E @ 1iq^ U_5 xyșʹٜ f`"5t0t٩EljL`` z #  xAUP  )BV W9vX! ` Pq p\7  IP lZ '8v`[`얏 |&V\@ @a` p3uGVzXZ\ڥ^^ }fp  z oyeЋ g?,o PF`   })YsufP 'bVPuh`'@# )ֶW `0 F/ N0 `ESa'` T I P87:)e +ɇ1qǛr5JƩ ;[{{ ۰`ws`+;4@ _a (Р4p ` {' fpxp  J r+ oபf xp   LU}`(&\'xapP{x o` To:X  zN ư : Wfd (sծ뮜;_ 7Wk_`H POwR o |1Дp   h 0 '0 qp PU[{P G 0 0eо&  [0 ` Ԫ`mf V @ JP @ w˻ "<$lyęsJ nqEs \5|68:<>@O~ %X@@ Pp z=z~VޯvA  !J~ꨞ  l꙾P` W~' pI t^s X ڪwo& ,&e^ P }`~Z~LN X^^̮ Z 2Ea?.* U ˰"_v.Qt.>5?Lu*U¤zEJիXi} WH]%u@rGZ;)(U^E\SN=}s*"64z ĠKqlhQFUhSljLJ *eT*SJXZuŋT}XhTه?~,P+C!_Ɗ7Y_YKZl)2%J[ItE͵mƍ!_sJ*f4j͍:]t芩O+|ݽ (fKX\3_սO'LŹsϣ€e6"Be5> F QB /2C?1DC|B]qeJ:\yeW31EwGЫS/F LN P Q0?8%LSP$_z"RF%-P.ZI7߄3N9tNФ9UAeJeٜUwRst6]_Pp]wVR`_pb ҩb 07fx.O3)CwUhc?Yc[1&ِ%YOQ*!*Q\1Ѷn?%8CQy’F:ifi:Y>Y3:k" e{"~cEႢ>I_Agk~-6䓙bjG7i|`D` y5_ykb1yuGX-; #hE^)d QKADE &N-7@ЀD` @-t4(C@3O %3 TP A$A p0%HQA1A ZA6TBIXD)6@Їȹ_LBqĮ h^0!BSs"{_䷚/&c*(2am !юwDZ5=14,h )l hLZ(j( ?'%X+|B%f=ҔDe*-ҕZF2 ]ӂ&&PL"/$b4" m50gGtJB{&XW`1Ug89NrӜDg:չNvӝLUOzig>ٳ) p6$tTp hWTcBPJBL >UA'=0 DRԥ/iLe:S4-nqa*-:-`A *dBRGLZDBe_|1nΘS13zeb$Qp¬<E,Yʬok\:Wծwk^Wկ}k;;XְE @GI4C%@guE Phzx\ A9! T$~S)vXֶmnu[%SgJ?JQ쩁x:Af&tC(|Q gϙgVFjs[ϠIֽo|OS-g)Q*@P4L$B3CaZWapiiO.B U *aJ#(^'FqMk^qm1N< (,!] #ܮ!=ٌh25\fppW?zЅ>tGGzҕt7OW:?KtvEmYMd}UkkL  8z>ww{p=6D&)pm54^45g >{E?zҗz< ?xOù~a( ާB4>}?|{Xq8(= 0:@YdJ<) vo&,o|w|}oSo> J˼T4t+| d $ @?# : l8<_{>.cdS {.M++9J ?J0?#7ÿcB&<'lB[I*<<*B°B*O;+7"B*D5d5L7L6C$:9C;CdC?C@CABBBCTCDLDEdF4G +ECI@C{PCMЂGAR<;6d[nΪF`BCH0H[BE>7Y2Gab$c4dDeTfdgthijF`lBkktlpFl|bs$*4s,ư2GjDwLİ„JtCm|}~Ȁȁ$Ȃ|*RI>*{F@AR#04IL ɘəɚɛɜɝɞɟʠʡ$ʢ4JTʥdʦtʧ\JLJJ0ItʬJʮTʯ˗ɱ ˲4KɴT˝dKKʣIK&hZ G~:Q9T`+FHA3" ˴L" p#(c_ 4DTdtׄؔ٤ڴMѼM̅\( ^, l]@$ބNM|NNNN\`3P1hd SļAD ȜLʤ!L HϬ t,M4QLQNNN NNNN%QQ %"L<La&pP]OP9SLcM 4U5e6u7mԠ:S8<=>S%6[7$}KOZ SL *] ,0PP̈́%M ]S;Q%R5SETUUUeWXUVuUU\UU\U^MU]UUa 9-V?]CM)c qHM I JE2.mPS Ll[EtY-UuuҔSd=wz{6EXQT/j2VP+ֵT L0L h2ZX|،؍-x]dّؐ%Y==T]ڔ$؂=Hج-ʜT mW8Ӓڡ% XdWR-ڥeڦ%ٔm֗mYY$pePP4uڳEۥ=LQM۷۸SF =:ٮ$ʄlhRDžȕɥʅS-*[[EEoTL ͌ [ФR˅ؕ٥u~}VP$ [a+zG@A.xPEe^hS^0X0G5kՅsEM^l9Hu}M_____ӽU HYCQpf.hC0`PY. ȅ[!5FVf^aN %_]_m#֌߽` ` b"-b$>]b_pv2ݵGdQ ^d2?%Pra߅a;<=cMdZa\ `DvGHIVFv2EҮY,b}E@ n`c4^2wV;ܪ@E D&>fC_@&b}?&`if_j6bhflVbmv^ 6ZNNTblR`2^!(4Ʉ(Z=GI < h<@f膞9h舖~h胖&6w撔gINK ;j6FVfvji:G"(6^H t^.^R@ еUf3L e3 ޗ〞j5,~ 8 x * C DQdFYQ# 2Ia'S.B/MN/2L0ԂTRb!3r!TRQ4L#5i3ϠeYhy, %]z%5X/xM6ly_0,iNc tTrI58C_Yh :(z(*(:hTR9},hJ n`08IS qDzuAΒ`'@}&$:L᠇h, LUu׉EV ax5g,<Sz-; >D]>!1b@4J'@K&UTP\PJ)HA'r-眀)Q1F*3`\r"FR 0@ $1 $4tye)L%Xe1לn9j`S 1 1O##˜h4ה%4ݙs)J))m6q=7u}7tw@kvM/L3LP)(s+lᩩ ;Zj>hse(0C)]OSui4LC :@P,( bwY42wIWmN%YJN)тN6/kt`@V]g{=ዏw枛Tۮr  to$SJ?CP)"qH$laD a )L.V.c8d 8xd=gliOLqmJҜ ( 8ai0yDi\-kS6M-,8AF-r^"(1d$$%gA~7"H40,JAŭŨJ BpWM,ְ` Lx [!5%YFӼluKҼT !@(4wf2b4>G [1|&4%E0oD߄>dhWp/{k#-xt2st"phĂ NHQ *HB" X\T( Í@-5C[9Nt؛)*6)A, xE1  8 P0d 88& C@%*a*0Q(C YH *fA P)7 8T':Bf+^׽7 CB6Ȃ[0:N4k@ O!e4(ELх N@ØFR Ox;`a1D@؄7T 7\p (T 1<8Q`7ʉؑ#P0A,`\HZة`q_=x2n ]_#, S\ uR57lbSE?<$?8IjJ':Uv}$ nT o0+JAft C! β,'%FfTp 5A^A zx{gD0`hE {x! '0AF@РP@ ?#(:YxPj!F4¾5b 38`/5h#eX뜄1|B\lܷP!L&֡ZJl 0AG,pŦg`WH @%aH,oWX  b'Ko"*`Y2AJa ^%}4@3Ёv"ְAPYxҵ!3|-laK<җ * W/%)щ61 xVd!A0$ 8 !3lPQ)lMJ1Ρl uPu hAXD`= \As< GLN9ND! ?y*&h4nn pE LH>(̘DI??ӯ?/M0v bYpKHQ\R-=C@$(@<$d dɂl؅7x$@,$471;UlٓqhU 7pBA35x/ lT, |(mBqBEY3pB DA1"t@+îq2XCL @Ͳ9֡nQ0 Y X]C`Cp"&<ĉu]GtI Jxȋ}DK0 /HetC |`),x LA,B! /|kD (A1C$ D@l^ԁ)Q$-2tR] G LN6Ltd Hy-̕TH5X (,<..$X $AA$B&P0P C24Ĝ,C$c+̔0BF9\X/pɁ;@֠ X4,@5 ZFB+Q/0_TA%!C3\a C 7pA@9hMHB5B c$Fŀ!x͉p LB&aa5@^P/d,]FF $<)"v ىCD"0/(YM$@ ´BA%@g:p,´)h-GldЖ9͝'L[TxC+;QH^F]37h#F%g)u2*U<Ae4;F/@\MH:ȑ$`2EFb ' Ҍ!&V^B6d04dC~/d0lhsv(QF xmBnTFB@!B($(LPBje)NBL-1Cq%TDA7F9 M1;rU // ( @!%$6zVhEx74/ A!ad4D2|C4@>*FN*V^*fn*v*†Z.2 eF hlFFG0p 1B+'T B2ԁIhgA!`,@Z TB1%R0E A1d=r^\(Ԃu]A4聚A1b47W3$O8AT+@P%1m%,CTI^ּ040Wnyʮ,˶˾l05̬C(DBِQj+B@7Q!<*A),EA3xTBq<H@!\! #tFTV/^S@.8C3<$vD)Z'BJJ'&^* /.閮fj0DlC6di/@Ct7*GDJdʢB0A-*C -j4o P0 C$D@xQ1`%^C/8)C",%PA\\@%C(JM7$,,-,A,4CXd^ B1B'TZBOZK¦QmX ( A3@ɂ9A֬,.7d ,11'/171B0[J0F8DOZ%h -*D%B/7@t@w0)VQ|NhmCҖm C#D"0A\xhjړ&A,@(:~-7<^ -0Wނp`^ D 0g,+0'<="AVZ)@21| $ ^.l73?34G4O3j0B_*E<%*jTG'*%2).Tbo1Ԃ2,(j43aJriz7 /C!}:*;* :'/X pȂ ,D9ؗ;4}C-CϳT0,CwDt!}m0q49E'JGiW-lWU_5VgVo5WwW5XXuX0(k;-\2qh=+/,;/hJ)5h)$M숍1b0uQ$M2(D/RF:̂QKe0J]3/4CB/2LO$< t<GFڗpv4@<[h7lVg4`LN5r/7s7s?7sl*E/5t28(+B9?׉D.qlN_.Pܷ.C'Da{ɬ}.,l9 5Xe"&ylD3Ł5S0 OP0'R%>HQyUW7w:::zU[5v+D|%jx3brApDbǸPxL~{goT(9nD?n(8cx~Bc:,h{[GÜ/h-{u;?aCPzSx}{B;;>'/>/=w;?|v:GË{y7~黈}˽ܓ{Gދ>׾}7L>_#go?w?S=飾??Wg[{>k??@8`A&TXPWC!F8bE1fԸcG q5+TeK/[6:?`2dD^?hQARTiΔ҅VUWfպkW_bk,jv-Hoƕ;n] Ve+^/=bd)ЗF6h .VFreqgּs^ H)_VQA6qX hhn^s4#F'/]ߕ>zuowlK+rң ^F^w2`r_BPmڲsȷx;*ɖ_!$ 1P 9A QD;@YlaQiqQGGpGtn %Z*%l'r)9R-/ S1,3<1 /!OebGf$ sܭ]|ЩbLE˥EI)K1TM9OA UJ;"h Ȗb1cOYi[ 7aUx%^tI&l@:чNZVmUiUq-s9ס%JV%_eZlK00u9r ݁%ʖv!X;c\ b1bޔ@kea]yᕣV"pSo[Vsf.`褜s%Sz7Zw鮳6Zla~^vmI&GV O|tV5~m 2HZ:ffUyNꦣof%f|nl'kޙ\vW*\I4I)Ɗj T~ _\ JwY~O X{ R /.?G_{^]j_Wt%0zNWbc':Oa!A N1A nAB%4 QB-t aC@Z`T)y#!E4D%.MtE)NUE-n]F1e4?s7u8G=}HATD/96dY;KM<!cd!AJQ4 qJUR6"Us@}%d&=KV/9T`y/³eq)jlLG:O7k^39yN06BɄV/=阇&NOr?$ h* ZĄ 8͈s]dܙF6N$^B"ByI~ -uK)"t5u!MNNT_hFcY:00!P ci"%"'p CP0Ҋt7W/t伢LJzCc)?yN03ڂМ:y5ɬ^cP<9Nz^M80 p`V,fYP*Ѭ,O{atb&eZ#"fj˪ufn$.ZSiGjh="n g8C!Dud5>#M/Zp`m0A0dX,X? +>q`$g (ՈcJY6ZjEk؂x$pk)<W8!bu}Kζ qWo\c!X 5A !͵w"_L+~׷QN1q|gخhP/,7[J6K }#eX b TD!P$EJ ~t@DCZ5%|t:*-ҌҡhMҦ^4CQ "ѷnhU†uj[ZҧntqhWCԮvbmtԗNuK=p) ÍmYbۢ趫AAnqZ.5fZڔvw Phҙ.6l[iǻv=pz_x;pS!9%pGz^yn'nM8ǙeҜ) Qbe:9-t`':wTPEAkHKE6lRHh6C_cPܩb)F q=H(N,qE!xq"њ(#/ll));౱)RXP9se˾Ԟ&L7@ 0Ju[ ? ~(`aP: }Dkݶjo٢ǪYa䚝9_ܢ: np/u&bmBA>!>A0%/Oӈl2H2Ԅ+*O14M5?]8m o=E`PEnJ2,Mv00dOv.0n.׸ON4A4Mm  PP0k ! )Pc0vF c0>AE3p4,A$Q%1R5TQ_qYՍ5DJ,< a>v 'qR"AASO3!1d: '!FJq窪$w1 A0x6o/ncZb^D{V\ bo5+Nr%L2%kT:KZ֒%h&g%QRNR@'kr(YR'Y)e۰%)[)g'Moی2 *a(ǩ'+%+r+;)&R+r,a&m-*y.-o&%u-{2&'-y' s+U0$3(U.YR(`/R13 2*E/]b-r2&k\34'k5(%[6wo!RB4o@ks.0!aA!Od6 N3=s=3A!aaA!K?աa!+. 2^TTC!a f !?@+Ų?no-US3ER-4*5ER%O-4GSEw0y4GA)W)s4*u62H]F@(ID4Js+O2kT7J4K&”z|3..%DKo3!`3sO%A%3t5a%5%/.) fHrdlIF5_K_2TH5*yUGLq3X54TFGWuK)ZLQK[F\)Tp(2]9!8-UP5879 BϪuR+TPO!R"R5KQ!u֋AT# HAC*Q.@AHTJr6W]6!XWwT+%eqe'fXHk-9kh6gYv+E3+hheg@!T5jv\늓^'V5%ڕul 6%^[u0kvnЮ9}RTj5a `b!!2'\BCA!67bVVfDi*V% kyLvJ{YVeT%je?UjR)z@|uW%JA*qzy%u_aAڡ؁—||ѷ|w}} ` ~ ~~ASpAW %ʓ Ap` Q%s;xK%΃ viwJLo7wWbx7nUYvvGoAaᇁ8x8I%VfeQڀ 88` W|ɗ||ݡa·aal XM5q[B"%TE53"@@JQaxsDQI6͌xYea_’su%YUPt$iuw %TY 4+!'5{nO]q`ok-udns\yv8ZsjSi3|}y9}y y 9y |@՗9Vu~y浊{n)#4]Aaw7Ǘ({|;ǻ@ɞ~~@9)o:ɶz?Ϛ6{iʅS?i[W#'>۳ kACgXƮ^{P{*o+4,X_x1L6K^̇W\iߤ[N{?gZ5kOc7u]>n,wp燚qNSO ? Yb@ 0… 9|a +`۶~JOHuk.L 80} d7`.ꗪ̛WsT<9ͫԠtM̵֮vm6ܥ}]6hЌ.ċ p߿ϳfӟX /\.@qi;emۻ?~^GwPM?c-OȈ1;#R#}K)՟gn(#0H?|e Q B\8  P[9^#) Rg Id\D 5B>X-YWHdmYAj u!B]N?Wf3qFvމi|1uFn:(VD)Xvmx艃y9^7EUK %w|}C\slwj9WLL-.~HmPotRkFڈ888$ ̆$jI<7eHF2<)@Z:dee+ B\!Ѓ6!YbɏXp"񙇙Dqva'3 BB9d+[Y:ug!1QDb/xdב4clo#~GqC\l$}:q \BVt#0I%P!G 9b qFNT!+_ zMعLBkKI5tB s$p5dqP͘PXG5Ǵ dp4^b)ۤ+2C ѳb*?QF @)kP:܉FHf SrlMREbL\0BqXe8jU C}8s:\!YΒI 3̸kW$<6iM1-T<6_[:;eiY\He0ϧ$jE)J1W" 8sΪ& hF3G$P|v U!d`zt6**T!6as\IwMoP #gh$%FQ@u#9I*浨.NJRZBՕQA[^ ߌ8g9rw#W6V@+ 34#sQHY`6(6⫐Кk]|C7ks<{ߘؠtNmCw݈C|[CmˇO3~ѐSۀ5kj\s~?8 Iԏ|W}\o,T5->onu]k'Uh]ahs du1%c!YRB  A kWPƐ jwTxb P <&V  Sa6hFe䂷cp+B(]R]ߵR߅>p 2r 3Q[ȅ]HJ2&@i?cgS.e`A''_\Gk0QE(f vAU 6nSb;;F&y84 Q?s`>ygJn((q 1Ƈ. 4`{Q}TrVj<j}JW'x&4hp"Enwx;Zw_C@BB*`"@ : P ]NVf!bh.j q hݐ!MYEn؀ D3EtJ J7 tf 7sU/%P U>(5;LѶWz%ʮEH B HpB`"B :@3 pr}l t$Eyahj۰\n~ M');_ qZQ dA5{خOx10bn0 5ܐkԄ9>44T|HÇs *_14#pk˫gp("BGa pXGt8(1i3 ^i;== | D.jc  6`&`٦m w0[FAM ' Lѱ74k  4*ɫ,K6a,- Am&*Z>*ѳmu»YqI]S taq tx|"p&;3 g(h{v2;;! ">0x*e_& ` A@PpeP!WK)sI8;`| ~gP B(LQYPJPCa&Uf+A!@tq kDn~& i0ulh&umw>5 p %0\@ 1P l1LPM+se5tBU%(q=/l"yFP 1!a?$sS v i`cM VTѠX S7;j H08ƀk P1l&& 5#Pկbpq5јѶ(^֔b:!gZ {a^jlSj96Y" %G'y 1dB͐}f,L|d ga <,KИorɈ%VU+I%4ǕjZ6(I`AGԠ໮dAAP?3|2` GHCŸ P(q5b (Q SP,DF0Ο 3f3):ե{7"v Ji`0z9~V-rЏ&B4`eFA`` os]Nʓ3\ 3.xܔX@DB)0?\JwCqbleSWu&(Z9q]32*GeIAQ/h䇫'ب.o «NupH@8`CĨZzP4P ۰OE&&d `z/!.}jx %ڮư e"۾C mRa4­}(M* ʷK^} !"}6xvt ms+i竎R.F\A˲Ҋ)ߖҠpn āy aQ躋n@.#]v#?,ApS @:s>ŨXd`@.92 t3/9u~fFVOqUZfZk {Ŧ=pPC2dH c1_fWIetזu~u)7vАo3y; WݿE̖o@/h#f$c082g &)Yp 0ю믧r0: 1*Pr(pthyƲ,uI4HrI%D#iasG''t!6ð$ 4Zs* -h9A'z!ȍ!% J)p$ H*u/'r҈U;6ܱO't= Ma&'iFG5?bIˆJ2Rb 2y&z)I&u푧̠ͬ1pz/cDDmb g*0&^iO2veW~ ꗲrJd\2GjߔPfM ErSt>J \24,N==y%"%ROEUK &uguFli|p2JGkJkϓ8lhVuƇtHĄ`!k3'gNo16]鋌8zj!(tGeXcCVV䗌G喳oy*sLw x Nլؔ66i#Z8JD2``1*6a$yY#mc`P++ L?+Hx"e$Wtt/0pONt) 28h!i Fd}󡧵xT\psuAM5qDGk Sѣ5y !X_Uf5{ "7i3Nҕq`Hv9&D~k5!X 4 5^&F RЂ<҆6Щ}Cq#&<'eETgH;u FJh.¡Px0v ^މa DP?51eỳ8,1$1kKA+&#OLEt_z#C}қ[6 YES8/d O>K(@$^T $hA@5!H(& T$F(/h]tF- ͈4cgԎs~D1J_" xVB0.eJɰjP!DӚ\19SRb`"Ic+qEӚU NcD{l{6yLÎBbJ"+K ͫqjF\9-HO!bא4qs"-H;hR$# ̀ PBxG.2\f>x.~]c_¡&@s][Ǽou1 4GJ!Ɩ%MEY1; ƽd6a˘672Erfj|x(i/ e(]CôX.$n,`(FQ2E+F= GDj7Zx')# 6T96P?+ , cXuayd,rh5/<($,<*/2FlqJ]z(4;vKWB ]ӝ|uqxGQLv=BC6܂,j8Do<9(E-vafYЃ`1m78 2@AA#C~{h_)ZG+<@BcHC8(ͼhzt")m`pVK]M# Qs)2l05ѷg#G{}7ܖ9ҫ}m8w  +Ԡ8@B]Xty `HX:!Lml=p\/zHc:xGGFLu%3AadQD5L_stjx8r&K; d8 ji &f(F@ d\DYTu0GWD-+G&xC%NAecֿІ&ͫ0q4!Y> 7#8+($:ȥdh8š PRSt CinI.HJډhi<m=x7`6p Toy 1cXjbjُ:1Z_V4ތ߂ko(7kk(h;1+Dh3 ;jgGB8p^o6EC)(>&v0M\`C .Fmo}= ud +qڢѡBZ p %WN}Xeٺ.ą8_њiʊi<3G2^_r&&CCn#pHss&x|,`8`p&olL Zu` ^x(q`p  _arJ4NU Q4tMD)%`*Z0Nh 0`xexMgR~h @>rYVJfofÌF lJ+: sIrs)LusCxQǚ xމX~Xw8=`X Ɇ/en?T#baZ pnpvo( 5) sz&E#syo.o(2+au(i;u= (zpp`[TOH 0L@'Ag@="fYN8GAG؆!iKyE1XؖҘLO'>HvLthZX!q}z71?za?hLFxԟ TMK{:skxd7RimXѼW#u/L?\[|Nݐo 8K؅ύC(33xSO\qTMާHz߉F?ֿ gN4'p (PaBŊ%b Nܣt :bq"^\raƈj)sD4o̩s'Ϟ> *t(ѢFy 0(?x8$FKM~^}K eg ^nߺ@.\Ĉ c&Ss,f6HQ 0l:$2dP$Kw!QbYxyTK@ey@N+ajU0@:n֚9{grGxAD.:;T0,L2)N *82Qj:Y9 &T чfQYbA⚫"SMACB8KN'yS$ޑ]YZ^ʓ:ZC*Gkȩ[OI7]uf7U )WO,+в<ۢH^}T}:EߒQ$tnbv'GddD+HCF̲(S? aC@LO6CJ pM|҇wq "("3:*bPeؠ%_c.x劈 YۈIXO6~DpX 4 bRr#! iq\lQvxG>$z:P#Ё pdQZHS'l(Sm0 g#;doD F^ic"@O2ĈP򖭊5<#Zo3ؒ#'r8@o",dÎ'?'y/t$cMA(0.7D @+jыbe-Bu,(*T0E3җ47|&DړCXE4XI)Qjԣ+5]P'R!Y6155"5Z*WSЦ'NeA,ַ5D٨3)X @u\ kú +OBĴdX65b6)P(+a77kӢ֕a#X5ħ-mkKȟEq|-o{2(okrFB7W]vb7(RP"j7O]7]O+Ѳ7oF^47]{]7F}#8hCXn#l t0(ĝ/G [r#NAcK(Xupc\F!UDi|NE8!pCJ )R7ȫ\dTqrC\mj^39n2D'WΉEg62 !,N)H*\ȰÇ#JHi$NܵkUIɓ(S\ɲ˗0cʜI͛8s*t@@ D8H*]ʴӧPJJhPl>QKgٳhӪ]˶۷#z&.#k %߿ Laf0@@ (X<z̹ϠC7o3&fP$j,Ѹsͻoي5 j5bE-Z]سkKV 2K uǨ]o_ϾIjhA"pQ o߀h= 2 5(@ uv X"1@ <d2v(4h#I Oy z7&L"X8 -@0(b -difoue0\) 肌3Ԅxms@ȴ)̛qѝ|&袌괡@ 襘fK jꩨCjjk8a1. AN2dBF"qIɆ$Ϡ ٺKrd&HDѓC@u;b*tRD5DZթ%0~AXp [ &cVo0p# *C(#. tC!f(^A(`1MyG)cdػL/ҁb0Ȝ#bo) <DQDD=iB2 VF b  ;y{Y8Ax} -RbC 0ƷByBsd@H~^b C)N>QԂpwv8D6Q2@% G(H7:ME-->BAr["D^@iCrT1C2h`E9^x_%y3*ҍW)i"| R#%x 8,c\[ ؃*Pq D S/"y4` h! 2%mt0Q! $&~0loY 6q X2e`S-8VUTZ6ZZ7Fz3(UpUP|G8=HU I=86=ZC(KZ@QM؅0kN68ka5oX2 ِI0.{  2T 5 ` Y1.0۰ ĉ 8 @[8G2! a)Y5QV!0 Ϡ​%Q 8K4s @  C X؎ w Ps 9qِ7X 0 }# @Hԏ3 ( QF!9 $h4" P   8Ab4>0!LU`qI)AB!`b9dYfqj:R1 \)/sY yx II'V9(nTw+8F'721GT L XIT)myWL )94B iA!PJ~x i񔫙v&`ge7#RP`te 9A vwfjJy)`#Nb@Qz@ 7L`knЁ}pcn0@JNӝN?L} pQ FaДp)5M yǑ *y `G %%=9 ݙ#J{f $  >S D I ZLڤN* Rʤ1SJ&> #ڝH/0dZfqjJk7A HU`a;&V:cbE ڨZ5?EDpOD tưx:/veWVtN5r@H4@@0vp*NګZk7ʩ*-5[xCƺ40` wJךONފ65U `@@?`ڧdnJ6#` 5Y7Z?@FP zN 5kZS1bzlz !@~:[Ա"v0 ;4{E[;KCЮ;E ;p@}9 q^ ו0 qXG٥ 3@ NG!ڤ] s+F3] 4m q3խ3N'͉$ <1`{#mjkM"q1# dy(XќPq HĽކA Ѭl  a3^#t+q'7 9n;5~=/ q(&ATiB/N.O>q>$@>%\]^S~aP._g2`em!&&dq{>} Q/n~牾aN鐎ݡ,!f OJl.>*fꗾjd~!}awn}.~w>NdKsQHen~^/c.v.`N3Q O!$QAI!>I)A  Rv _)  4)e' s 1?)!{&&64?83A6O!=HÙ>>0$o@M?][`O?!WDAR TO"?" R"_"-_,anJᓟ @ ٚv+ڣo/@r ObA O B PP٣pa_'MsTO_?Y_@ ,z,:ޯ a, ߝoϢЙ O4PAMK*%Mer ݵ4G!8Dt IQTI ZSB =s`Nf3L$F40iS~'Ť&0#D28fLQٚ (gFn&2i.LoU… FXbƍ?Y2ārfɃ c1- U:Ƭ9tvmû&IAᆅ/|*Yʑ/X6h9{:y9_ws7_[o_~`j%<dp h{(‡;:@D4DI$,i0FyCeAwGD3oA B5(L K/Kb##" ix3tS2\>*s=7:mJBE4Q¶'Q@;1 `cE7[SP~'T9QARIVgKg@3mI2LZ 5be3L4UU-@hVFm2"0re\dZ9QyT6fS5 `U~5<V7VFx2lU4`aFuG|Pc`HE)*c ]@@a7iNsv#CaxKːEUE cNAͨ.x@MbL U(T5M?.HR;%V8bʒ5emP3lb6!^PF 09MYF+bY04(Z;ZֶQd{Uֶ%!Q2L  Vmr;cB P~6 4aScv2L'bt?兯 u7nUjώf]LLeăn-8` W8lSV:1a ķƶ*Yw.472x:χVc37EFth2p4vHPҟ/7c97/Aj3ԩdVzl\Y@n%cK[1~7Z \Z =m 1ʎ0G ]X;Ƒ=x1؆0, "û͠3Ξ7xvg vA{ d':OpFclB톸lbSt@U9m\Gl7fnNaΘ?1iӆܴ6Ρ*Ġ 1&v_)]vGءs0=6<1=CUpM !ہT¦z"0.rqw78: +I |5_1[7?zқ't`cc,\e? Qӏ?}sRi?}j*5O1pa|w_|p2~4/FGw~1~׿t;[?VJ \:dgS?* $MRED:XHD6jDM$.>N R4SDETdEZVXY1R[lW]^\D]`#`b4cAbDe"edgFT+QtK(ķĹK˻ܨ˽K˿4LTL(tH|ƔnjTLŔ\̀!,FBH*\ȰÇ#JHbt3jȱǏ CIɓ(S\ɲ˗I͛8sɳϟ@)H-ѣ⒂[+PJJիXj脁` 0@@gO]˶۷pMA8dljN(js LÈCs"K^@"3k̹5 @iZ,&@@ BȒbM۸sЛ9o0 &b48KNu:5h 10W,Z8ξii p EO߀hl_"\5 Co2F"v!J!B 5hrJ*tWa1}(4hA(@1.4?CݨL6I.Q0rT~N)d 5X"K(- Rx'UΕY+"Q袌6RG2m2sc29駠 fצ30N꫰*5 9]꫘ +(L}f6!5Lx@ (f8lww-B{8<6CS39W~l`OAx(3#>;ߎ=?'f o;Bv 6sG 6!:JAF(L W0Y崱} F$Nkq6uYi(68R)!U0p \ !C3!=% x IP04Bx̣c4aG6+1},#Z?(0˂5퉥 RBJR:,MBXH&2l̆4 @A- "ߴi\B 1`wot t$̦6ͣc⡏xL81C_2!En[0oOQHIP} eP$}lAъZE jxxEB D/abꭘ(3!k4tؐ˲ iM! h#ҚMh7⵰lgK[A-2ae<.K CmA !41bRc0]O A覗f;Ўlޘ;u1mOʣm=-dҤNmk#%+^yכ7}zaAb,F6aRc 10 !s-1L GP->@ Sw:>:y`G;AbN:ԧ.OFn{`NypAAp0>5wxϻtӰ> aL}O.,܎e|ۃ<͙mzR]oS7|gO^.U|UaE.jq ^,01Ba[9 #/nbFrB/ / d]] ؀xN m Ġ o 0 *,؂.肶~0 voq/{*{@B8DXFx 'thov~/8TXVxXZg~ h'0Peh R "Qxp Vb,Axʱ|؇~o`!8(XXH؈v@Pp؉Z p p}ڧ}GFG@oE / ~` Z P{`{h %2 Qڸ E  b  h]x옎Ȏ>  Àv`>@ ~ Ǐ9Yʐ0p "9$Y 0 `~ 0{kX~s u&GVJ([\GHIya aQ RYLyJyTSٕUɕOb9dYfygeOYSVoiS@t9n ePO)~gɔ\P)aZ9X9YIQٔzp p 9除  kk99QɖaxQ@ٗiiyƙȹٜzyؙڹٝ)\虙b°u-BIvogZVԟpM44VTCS>S @]*3~%BMIL2ʡ$L.4:Bɰ t:9,ڢ./ZO0#sq&Tp9pT 6*+jf U=p24p9H:03`?aʥOJ;DOw_7:QD)oF f` oe%zj 9o ZF|ڨʨoک 0ڪf@ګwyezȚʺڬu %ںڭ{f|7ozķ 0ghs:n a{b";{K ۰x K Pppk{ )*+{%[yZ6[|`&K0@  $ Lˉ۳ +bP (=Z\۵^`b;dKel۶np?kFJˮ+Z apvw5uꍶp*gK Mb%"g{G g{"k{9+$k۳۹#  p9K 5 [{K GK Ii 뼨+P ˼j+۽J;[K K ꚾEzֳ  wwg@[ ={ a p `+۴;\|Xg  %$".,<\6|8lØ=\ AܳJk/ <0 | .kHĘ`bܰc|hjW˶닲W۫  v<h&Õvž^ Ȍkšȹ] œà!+>\ —ģ0ē9{;C|{^ˬ<̉|Ȝȕ8 æ9硿x|g" [; ׬,-<\|Ϡ @ @|l0 7| ]5=]}ţΡ,X \ M|q:\Ţ0 \7:lьͲb=  a0פ|}{؂=؄]؆}؈؊،؎أ=ٔ]ٖ}٘}íU0M̢ T O]F6̨ ̠`ו 4ט]۶}۸ۺۼ۶ Ԣ<L?N`ΖܴشH `yh6 د3kע \ׂ-ڂ]ؤ0Ӥ @ 0 ڧ 4Pߢڠ3"ѕ@  ѽءQ@-NϽ={6 Xڡ $>3PE-JL.NR>T^V~XZ\^] NI0 d"lfF QZ`QѓbQ@Q@u G`>^~]n{>S(~دQa0- \puݿ0wE . Q}ڟ .䠐 {NL`Q >TNg^ 4`l`b` x T0Hb@m xLT? N`oln܌  Q\< i"LʪPS"M02?4/ߑ S` lP @Q4VI4L~ o2 vJ ppU5?d_fTB%&nU&N"vp0 m-6"~> (ğg?_7 9PS pP ]  LƍԠ`4W \{ePw~_O x ο.%r TboRNp? 5F (oQ1-ޠ든n <TJ@ DPB >QD-B%R$e6ubRS%BFQ=!SU^ŚUV]~VXe͞E'PLV %5.A4}%SNpIJ'2tTWl V 3jҥ YfΚiъU*R~d%-F4gMwcƝ[n޽}\pōG\rܡ m $IaD`c 5j4D2I%dI'2J)J+2,Ɏ(E` 9Tye(` p7`&M'DW01# 66q!DH-eQG4RI']5%c϶І{P2 5h)R{Ed\,p `FD#42yG-l{DE6YeTYg6ZiZk6[m֧iEW*A%Wǥ$QTqK3Zl%ZJĥWB ɕffyE@أQ(6afa8?)EM2Q0!oBMASWa2ɜE[9U{Q5KObwg,MKFؒL~K~%'1aQQ&Z5p"P(AfmP>Vi&lrz5zek}Y3\ߕ-VdR/z駧/drdU4#p x#}300CbB.D1e_`8@ЀDv;)4@ FO4*vaE8BЄ'Da UBЅ/a e8C*`H id#EhA8aL@\0k C(/zaX) J@EPG#0fD՘F6эmG:юuG>я}HBRz#"wd Fj V3Ĥ!3IMvd(A9JQ'BҌI& FD"2#\(0~1#ѨȄ C@uCɇh!&a5vsf89NrӜ &!Fjyg>O~sh@jπ F1R1/Ȳ\꒗0WbvDJP ?F@pҕ1 d Ԧ7iNuSԧ?jP:TըGEjRTT;iT:UVժWjVUvի_kX:VլgEkZ 0;6 .=b_v_)>GhU8@@h,d##ȅ.4YvֳmhE;Z]2qEmjUZֵֶmle;[ֶmnu[ַm{30 15 R®kEP .k̖h)тb0aE/Z0HEpokڗ׾o~_׿pL7,ʶ474 . khN 0E*ibZC *^e .r8?1m/ޞQs_wmqV߻<3'Gzҕt7Yy_ sx@hӻz#αяtM7o{UtKD/Oˬ bHlfXb2{Ƨfz1yW|5ywm>.vhnwn0"Ff~W:zwQqxK>||7򨇾W?ǸY~wXǜ3| hg׭akk[_1[DTdLͲ $>r L` ,:{L*:&=[K/3;4Ms3#-ʌC$TB:+0[`3>B,ʳ,,d/01X,>KD Kc[;>T-[BȃB,D;@DTEdDD FHIJKLMNOAWDQUdVtWXC[EP]^_E:@: Fx kk#74ڋc`ѽ0؁\+;#-@4BIP qpwxy|{|G}G|Ȁȁ$Ȃ4ȃDȄTȅdȆtȇȁt3"g}ȍȎ>ǔudGTɕdɖtɗɘəɚɛItxW?TƺcFs::8AF08<K6,44#NӌԲAȯt~˱$˲4˳D˴T˵,@AA`"d˺˻|Lj˽˾˿d@"4d=d 8lýF`(1p;d?>17%a$$M <Qt͕ׄؔpˠK,KN@&s,5l$LJdCD@:˼r?ۅ\^^ٌ\͘ [Xȅ]8OfC7pȆl( gxπ pG LPp O"O^ T@*XN8H0֮`@IP^_(^%eRhiciin`60V0%^Wnip`hfVjYnլ[5o@E5ȁUp^0_U6/\i@'X.q8epCGDWEgFwGHItGd`t\hH@Bhd~sX_[Xmf(SeN^кm_[@6W%(^=ܙ[ַ\o`؄pbXde_;dXb HAw'g0 \x6obȇb(td0v`nWn-o0b.®WgwxWlVpV9>U pA C}aBO6e[h&p0*(W%p S(pNKL5 rf+2I@ `^np'J@:0s`-X3p畇ej@sPbOT 0((ǧel@,nx2(bȆoNPwkb(٧ڷ}D&@T̃TDthpfHm^n87B0^NpHHh``Xhkax@N0b tm T @炂n2QB(e*P2bAD(NЩupB1 $u  RvNN`ɲCJJRC˜s ֬Zr+ذbǒ-k,گyXWK.]zq葥OFzV`XK1ȑ{eVXN%JG! "?il.2f\n$ŒoruQQu(Fn!nf%w\t96휎+X"Uh0cS)֜xU+T"q$\"̠+!0x P9j(I #'K47@ x!!!$,zt+X!lbJ.XM"Hb2 cM1DUZy%Yb)3x vFXa^iK4XIp-xrB%4,!98PG̷ Ih,}81 ,(&"5 CL4aM+TL+ @ J76 +!2H343!|#L1}ؐH"7jpRJ4,( ,% &2 1#) *6DS ެ!A)XM%/`u1ء0[uW^{W`vXb5xYfyh 2kmղK-ز1$'/8~" :<4S!DF)D -15@(L1D35݄7RB,#Hd)xAjWN[p/~PAxCŴNL0~pM l7@ kĴ $7ӭu.R 0mq1ARodzmQ28jS cT}Є1GX`7Elo~hE0Rm1!lC̀xd[ Y"؆k c V4 -XApGƂa yU&0^% '0*,<[dJ2bxPB7BYCXF1Y "JN7sOܕ%yo&xs~cD@ )aA?Nx,EcEu5A0,Gt`3 XE$B _l/bk<Κ/QaCX)tqB4 &C؀A@8V&QFFD*4*B 8H  ` .RK[ѾM !Y "/(r)W4á&u.ܠ0\/D \F 8 0/ M%!D4X# A~ H4 0D 8dAX% LB7% D@\,Bx,!)B1KaB(,B D8At݂/±R,8p 0D5㡠0#11#2&2.#363>#4>#؂۽H%. )B0L) vTB `-P/PB. X8,#/O4lS,@X1.B P24C .@ R C-4',8@% B)8b@YH@!ZD@ h1BF&  ØE#UVU^%VfV`0֚0m` o}`\ ftF-e1B+\/F,5,C-C)\/݂̂-8S4C3 W0Ԁ)8-,C4)L)D7ԉ,,|QB4Vif)xC7Ba 1D5,Ђ1,ܰ0‹0 jz,;-̂,\!SC0L S./4U=y'zz'{'\WuB/ VB,8fH1̣;4CiVchB\+pV40 H- 1C-d1g,CrB-,22+xH2x+,0xB- .BW֚ICym1(f;C)\+,D7//fC3tf#/-,ݐ})))Ʃ)"IXĔnoceF\BWFwx-nP(,P/,>FC/B-x?/pc\W0UM,b\-'}'橾i % [ •\6\& !]z*d-d.ɤL.pdj-|j Cb*FbPj+8±ެ/̌Δ^aB*}9+FR붢"c´حނ.욫«5mlt#+r,,D1̌y//cBR-+K0Ԃuc3•b}R7z$x K))CmȺlFάe/5Lņf}R/00RZ-YVV 2m!&A\ކR2k/):BeBޢ>Fŭm7:*Vn*gFp-S/kL9Bj1'w'0L-0͠omv*"j ( \!.` 0! c<* '#Ӱ 2̭'16:2C+|~0b#PG1̜:3;;3<<3=׳=3>;3o0v!bo̞1jŁV&4u-(E#mu]TnjZrц+ko/X_~M4N{q- )2Z P-'֢lrB/Lp֔>lzVhqשׁtPHúl~JϪE4^5^ -XS55P3/\ !BÎntgHkm]+vH5g dtHKEEh׍]kvs BOO(+TY)Q#[sehSGƜm0U-L#-.-;l>ovo-*/q_f,vegC0-RzkRFT[007C-. $,v(v`^Xb녂#L-ЂB&%P+P}`Rmqrm s772L!䁘99ہ9׹9繞99##''y$ [GO:W_:gzˁp|:ww:{z:::Ǻ!4-gk(B*?pwQOy*q_SOזws¶S鳵_;go;smn+zyB0^t;۳166K;׻2^Ԛ5#( dFO%+>\ץ?<O.(_VM0C2[W|۫Lj9dw~>KLw7?N6OM0($d'n[REI>ʨ"w2h0Ͽ$)???@(8`A 2RaC"8bE1fԸcGA9dI'QTG).&e$jԩWp V 5p$UiR[bzE(Q2=jh .?;Ǐ!?\1dX-\I`$_]wջo_\7鿦'njx)cŏ8nre˗'Ƽ3dy;=ytiwK6)ȔYǖ=vmȏdI4I˖PFb~ujիY)BX@ʞmX)ehpyѧ[vƦUݾk??[~vS4_MLp5Kd꥗zɒz`)͖*Ҋ+N~XazԋQi$0>Z4KA 2$H!C#L|L(;1&Tai,L=3RQN}=Hh}\-0lSRG$E0M}ČFPi W\sCY9\JqES.bza%{Z%{ eV誅 TrC.cZdNyPT1_+^;tb3!iHڽuE^wLΎJ O,͞5I,ˮ.,{Nܛw>|ξWc_vcr-y$ADa Rf a^R]3 Obٮ/7%v瓍ݽNZI AOKà1|Oa2(406 V/>!-æP/e#.ʋ 6E)V2Q\J+;.>Ƌ+2CI" v' ʊSCсE˓r5DR2e'J#zS/iLgy3DH%P4?iJStHmFjSBU=IVj5fէWP ‘&!` U" 6ѹm$v: '(G:/b.bQX"-2XТ L00+@%-PIgcAXua-h_7[fIkbm:Fk\T¹%D} .b]‚Iwi aW}fe[^z_`Vo]x{^~ka)~0# `0Øo%.p|3s8-E X=p7`C1rexJ.2 `G^2k_7yrMl+='y ` 3[!4$UF5]vjcZ.5a&-_U_o_V`ѶMqaٶm`Ssa a2)H6Nde/Ce}`!J fkҎfSsYW* AfA.RPl &*7=jmvI=RK=*GGAWaVty۶yv@6czqSSlQNR_r3Atr21fv m r?ߔ!5i/Jca^A:(2Ap+BgA$3X6X2p41)Q>ٓѺVyo!Y!= @a1Tn%27ӭ)6@.ǡѲ!a OI0(9M'x5& Tբ!`.€A+b27!`wpM]4[ZN6:Z4:z7)ZZhoww Ơ'13I}RI!1QTd.0[1mBvVHH<;}}GUDAkwq @n!0h]kcRx,io]21)4^(O:Kŝϕ51P}9.]vT hT+Oa! 0^ş ~GOmCZ TڒѠ ?a5yAvEQ=4 {]H.~=5a޾W`'~!Y\gODV/Z`f &/,/!W.~;\;Fr$5:7)^-/!EA=}=1 s yT8xӷ…  /DyY&O6M2ȈٶKٳm,[M̙*S&q9F_~A}4ҥL:} 5ԩT:7npoZx7.]kuI&U,[!sF \:hŊ)Q>ezH@\~93C~0bX)ezȨXZ dN]p@w7>̍ԝ=<0>2ɀCfL|cy~]o <4PDlND<aNH!tKDS5=SNDE%wy*bIaU?a 68VY.VZm\uݕ^}XyTv+,c 2 e%uS .f\:7AL2HcC)l:sQy3\sEBg9I;. w>Rt` >F"5TM?8M2_=t 6ӎ; 뫲J݊{O?84N8Ն꤬wuBN=*jKh~H<#M;dP4ԸJTl\tم^|`ؓ9dY%f[hƀ)if\8l :z(QI2F6dOnyQ#()ܝ6Cl)5>oզHcYJ'P_M{VZ`<8էQ錕fＣ`{Jq{srO'.4Q8H#\&oG V"yp-DLqN>:P 0 '0N Nj|I͂=6/6Y<Balҷ46cN^}m^^mK2[2M p: *pq+`HۈMC#6rp ϙo7lgqmc+Ѣ|*?2knlR-d>8q' ʄ-3Mibx#zp@._Ǐ(&qg'Z5|4j];z(uLej1C;3gzEuo1yId<Þ'UϪ3u 0c0SB}".d\ vJFJa{s4TA1T`2 a؀Khӗ Ei֩hm:T, @k=hc@':튠pX#G6G Qdq\++Y8qbz KtitYEy[RjяyȮdLL"0!kpI}\ 1J9*3!ceiD 8Vw̞0cOVrj(Z<ت`p;^ZJU};UWG&Q x#zns$tQmh1nw[d$5d Hxd&OR#`|3Y_q/&_bJvJa` !2yCk(,9acG>0p nCMH T@\ E(2` ;!.Nqv*b?-=^u mp{c({n7)kXOݍ Q$) vud\,zb`x`OVb@'AJBz- `HaFJ XACN¡t ܃c (5 46Cꔱd%|` .(hk'ub;uۻqwi`g}?U{W ڇ.SZwmB+1= CSG2V( T 2ā)G`'r$vsy'`C%PJ o EQtncFhކۓw* c D ђqC7A'xсXO!;<) y 'g &@ k PH HQp-C8hdhsh@ 9qK` x P | E נbp03. R+5ClAqEIv PnR1 ~͖v'Il"enȒ-_l?p rtm ;BJ-B9rca 7AsxzX 6z1 H `0mڸr{ 4gsPh ='(E @o!w'9t dۃh95K@&) g*b :IT!IQ 9l!){ .(0(EIiim A!(FY)8 4 6V O% HT`~q @  PH$*B{T!`P ;$ Iop@ y0 ֧0Ø&%ԀX` mbmZ*>>3 EҚVрO1o rrafY$"D@&)9.`1[q;n5] hw`Vps'"E(v>E@4S @q Ip:Uv@{Iny{9` ltJ  :o0 E AA :,bh ɈY0  _p汣m꣞VkD#ϹI<äJa?[n5kPbc@wʯ m*7o oszbvnI12 OU  &  _N$rCyɩ5sЄF!( 6``@ 0\@ r _㪢':;r`A` %oqP#c[bDk%H dڶ4 ې ҰPn% !,VaJkm?pʊw:6d)}jZL7-&q]ۀ槪hbWU)b`  ݠ ` ںd`B1XE!(#e o0 p` P wRmҺ3]` k@q0OdK" LJ"w뀖밈v۶gu`~TM2 ! 67ij+ -] h x{&a{; :hRSy0 Ok } 8 лDp{CRqRU о `f @ Џ[;V '7!LH!ɒn7цP]@v dՃAlZPP [ &0` D'b* >lʱ,Πh;`p7 q]i#f`C0 "' HӋC5@nX&] P ` beAm' Dr܏r &ռ͒ガ`0  c@c Iڛܳܠ4OS-g=*ǹh_Zn"5ұ1 _ >h;1H`a@ 0 ` ː x5d|BHpBH.C3` }oꥰ SA0yP,c9n @^ ꀬ lxy p+ # ٤̣A_˼N>g1Zg1B331|Z#`pzH ٱʀ @DC~`%P &  {| I`&`V÷~27"@B X0rtqFT k.2i܎P" qRdo˼nMqR @UM ` `5n .M/` ꩞ sc o| ~g H0klsnYɐ QQ "ٸ\(hpgp r]'yU_YO[_x2 pu&x;q% oHy,T @:q͛ׯA9ԧv5C#6I'`PH9OAFt-e @G(} EԫXz Cv [t7E+VWH#F !b H0§]]ddc%/mKmt!'iԩM{v]4֒K,q`KlXMgPXɕ/g瞥o˗/82˰{;ŏZd(8.H2c*}c$(epik !!c 0d 02oBc!ɤbZz&3:Rj*QPI+櫰|ZAdA꺋Rca+Zp PΨwZ2dfx HSmM6G~'FdMIg7qLP3UtQFγBkH@0QgF;QǖsHJ|A#lQTy SZyV[K&` @e.za'1@c/:BV_" iNÕ,y1fDjUXlG2 %i g 49R-. vD0F0D*|)Mh(%Y٧DM6SVٱ7GǢ.|Pmq~S5 On]6zGI/ @.'BΎo֓DR v2:hgZDV]cUjyqY2b.a'5Rgj]\[u:JqFuG, EQTʖ{E4~}8!,؇!IZ],8C' d*D`P^ynyWh!Ԁ>8WVKfphgT$"/BڑQͰ }hGE1x qhsXAVY*Ӄl؇?!Bl}ؔ#&q+ ."C!@h(f%,5Ї,k3G!u&I^2d&9c nT/Y.Jn9)++m8! ɀQiH##5d0dN3Hoܗ (J5("jUݱ.x! _azx ~xf-]ZKJRC2NjN 5zC`d#7FLJdeNMQu"v5j@ÐьT(0ĝ AHB=6΄ FB9J>D iG֌c"E%]R~#@524OR";\ݗԂ,5M-S# YeoDe+81k `CVNrnM 4:~8U"Oo!9~m2q6biEv /҃ @QFV&kKĠZ$!FI@B}tR4q3A,/D$e9$@85 BЁ8!C(3QL߆ȉY5qQ NG7ajONr\pfv| ѝnZL~a_0uEM,,ϑX.ߺEZBAg4vր|K $fOÝ(#A[A1?Bч=;rd8َ"ǜ8d1!8~<"8H$4 }#4 }S%8j9qPoTS?AX.Y+1:$8+H4W0ӐoH\H&?~plH!PRqcdMBm JT=}al His>^nGyTK0cQd m)0,(_u -h [ ``[=E6%hM`! {RZ8]ڄ~U3(bYe]dG"Te ΰl32  _F~h9m`~.Wi9p}!yy]%qP ˆctǸa4NǸL[ ѡحH4U`PH1Qg+=IÈj{w[(gځ m*e0`+QZ27w vhy(_A89+O/8h˙fDsfG.lʣ8}sJSF@{J5\d :;c#1u> ~5d^ohW(R(SzKFNdyRE&(yuLoF^xal*AȇwmڤS2!Юx} S pfsJhJh<̄SHu>vц mxmXm6poЩ.0\ՓqpŪn" /0̲uUxv0UXxoG5F1x>ylvv݇X /U)Z:ʲMqT6ܺaȈ>ss0vtv4 , L`mD0έE#%sW_pB@?'Z A$Dc#O&Y/B!@/r1F  gZ00O?pvy@WLy`(".~|uk>x#t5tSD/cE 1k|4sXk(j2B=jNwxYTq[gtH^Q*k UqR5M(\aÆE0:*1cEBV-idqkcl (yxӐc<.E}mx%8{Puw?Xun(jK0p)0~is_| ug^㑵x䅁Mywpah2hk g^1hF[Íc49gXpȤLKv0(?駣:r۩1"+ТKC;TqL!* 0EuEJ 57\=aTn hp! LeCɒ&^yC /; bAoM1q$~ۄFCu @nE/z .%3,bwlpH3JB,ALCK"mE2 &Lk0-j:QsZ*ȹ+ _fh&mK wk#fN54:'Fs2F(qH&א/>O#kI *q{GW^QbvYܢ3B`d !23bУUӽM[X,`NXH|МI Z4dh&ao-,P?0ؐLVb[gsaц5Ů4]]\?͹,FM?,^f:06*҈G8f?9G2nӣ^*uu( \􆪽 tH`R\fވT\6YJja=W6P ATFT1 3ԾGk!ue#WՋx,&( OǾD qvۖU4PYC<5A0mfPI;L0T: Q.IEr8F ;4Rٽ ~]:ڈ(>WHr#J\ތ 2cHU/p}_r9BD(DT%be,"q -Ub% > .|3TbTYz+F1,3>Y{ |%UCZq]H$7ReUZUbeVN$:3S4V5b66r@aT]XՀI/fMc*B-.?D!\85X"HQ!نc$CdИgfU:]/mKÎUdC1ŲE@΄o  -Fyf2 L]t4D5p 3qsWrtRgԕ.TZ=&d5jYZ~c86!e\*Hc-8߬?C4ŬH+CTkfb8P>_4cd@dEęx&hhi΃?([dᴃ2C&>$I1p f?d;C'Ƀ2Ri5 LC 8'trNui.P]tvv}Yj6x%ɜ\ID-|F|C-!0 BfՀXqdZ,C(5 ۈMt]ILqĐ2h6 Mޔ%>>"M`EWJc 4(4YpB8ju*Օ-()q:i9@,z#[_}zBUe( Qa"br'Tqi=ȋrCd$ThfYO:@8P賌(gHF[13 `nꈬYCo8ba<404×jl)ΰ>Bx!Cx>xZb!I#=^*?| *@,02 $)'8C(drh&Q$Vý`ÁFFUHaٺ"Mb\'ٞ>'R>ݳ E6Y -pdnr.+Iʃ~tTLJڹp"pJV!͎BAa,L13$Q>k=%_@m/mUD?l*@&Ԃ~"%) ?0P.DM^Mbԙd$ 8r$pHp;`Af`C^ +>֊a.a*qk ¥nv`SayQGZݮ . :BHBTx,3hԁ/?٨ / P c)P>q*C1HV\~f$Nֈ͆o]/'Gsǵ1 WK!ĺ -|,Ղ,$38%WYr7CCIDj\Pd`MC䫟ZqLQqܫ61嫒iH++sC;4p1S%d)LpFqb 뾌M3:H 0<?x<6Ƀ,A-R93L8s-]"4ZF3 cx>_O2@ERҙc t,UCkV_E]DQ&Ď(`0Z3c.̴z5;_6WE1:88;$8a4t6OI^,qZOQXfn)2VvhfW:sf2$e0.ۆh+4WvuڦLZ͒]_@0Cp.|HS1 If.uf%+@$\ 0FC1(0v);G6-#e[N]n]LoOkwhvXrPv~Rl#3)mlcns B]G2_4FpZ{4k)Iߓs562#L(C@*xC|@%\(@p^C,A0CD7EVFAV6o%9z̤8-J FTlT7o3Dr-':~ i嚳yy;)y}yWˣa7]_yTOzWĒjB邜]_ wq3G4 2DtS?CH*(68.>(9SדوKo04l87y$SL%q3;꽝YKŀ" h}BE_s3k5rr_\8WnDC]4t,F{LC}T4| |{(|rC&ߵنKzEO[c_$e:d|ȋmțK$ [mS/8LT :!8#Xs;ʄ0tӂt{ţ`A B 72ykqA1 GZګڳ}ۇ?Zܳw[}L<oUw<Ã6}*`H[c~=4=6[>cƄ*>[>5<˾[<|LM#}%5@8wxOˮrO빣t!Dtd}1໾?B4c2fmQ(|?MBł?D: 4xaB5TbD)VxcDqfjqaH"7cJ+YtJ3\,)e#\x% B=IԨSTŊEVpIz-ZN_"%*I!ː?-@Z0d.[zd2:i%ۦO߸qesa)VU1_)j @@"TDQ=h([p^}yI&%xbxGٟɕ`t ygG1oDWI}#&Xi6^lV{Xx&ai5xg~~7`]V8aI:/x]g%Dd 2JE^r 54笭@s2 3DEhxyTfĺMGC-7xu@4Peh l1B쥄s;u#k< C)ziЂ8B4ɆiZdCzSD8$~ Bi"D/!ΊS3>QZ(F2rQCY.0~_2YIYɘ * .C4MM. `XF8h}ǥkk5<rCh%:9.0& f[r3C'VO'xD <\7d}X8C$C][aYG)~@kG+o@F A̐' x1\Vtʳ+ xXAбh<^3JUPFӓO"p+PI,b} @H# gbaJ|s(8^ +D}HpĈFНVl^b,FĎb0x|^P L*aƀHJ(@ >B)zA2'ED~XPQfaj\">/hl"c2Vd`-A !en6AAހIlLAbޠ`Aakeh.Pm'N^a`f0C00 1ELfP,[Xl2uG1PABa`|! `6Z Wl!pA³^<#H8lF!]A J*VF!H$ÁATVFt!3O 8"Hl33'8|h衈&R䷟TTYV@#,2HC i1Z!\ޥ説ꇆ%0)H /Aช8f0$Q 0N8?պW<3n7L(P,y01D#BytEBT"0`ܹ6l>a(IF,hVE VV5*Z^CbH,LH3L{O?l3>ps:Fs{8c?K;p-w^TSv0I[HV#5Ws74sWn|u 8$}SShJVYnU-KʗC@n{߮;`{y{V[O`L-@~.Wo{W߂2.Q }/o\uߡsE[J)>UL@o+_>& u.=6 )uЌh(!MLŸiM;Ld0h%4LXC1!Q*MBޓ`.S `WAƍX̢ɵP&< }4Ќ5!Lل8")C-AT,ڒ< 5}ۢ"Flȸ}Dm³C4,#OxVI7$$wȏ2,a:f)q8G4)X|$S`ZQK#Ijf%-6Lrs5<>P℔GO}&&q%,WI˙8鸉.-|,ĤT=QuZb4h͆:#'e ->dY#iMɳmP&B+a<۸3:Qg|ajiZS4gVl!-)E@ ԿnAjɊAPjѴ͢0L MQB j:~#D0i SҗЕ&'8\*p2F.\4ȃ&:Q0OQYLᧀ d'Kٖi`)fBxmq4 lIȐ J&oM?d3!ä4:!b,&(qLZ:Y8]arA AX!ʚɸlIS?3lcmYIcdq-rjlI2kqC&ג 6L(4Ą4sӧrs(P nby De<7+ }^y(ݬi`( oN:dD;Ve j+xcrȧ۳ NxGضaxă[Dd9ְ7硍5QD~*KQItV  J[?qO>IW# X@1 ]X<~|Ї+<h R :[yl %)T, x8 (Pl!ZXR0xܢ& (Q(F80(}D..a EgN r`pScL[D>} @ Si>8|.ʲ\|}6L-AȻ=]- SQ5E}_`Omܼ|ji1p-,r-41˽B|Zs-ͭԸ K] dŗNҠ\>F @ K]ڤ}ڦڨڪڬڮ۰=۲]۴}۶۸ۺۼ۾=]}ƝȽ=pGuH_< @L+ }=]}>^~ ު [1ݗr 2]dRe* ">$^&~(*,.02>4^6~8:<>@# N  .FᘲpN^!q!Z!XZ\^`b>d^fDz HEI)ޜzX{xz|~MB9Ne)<ٔ^~阞难>^~ꨞꪾ>^~~2`RX BB`>^k&6>^~؞ڞ:`ҿ L\ BPB<$MV~^~?_ ?_ ` ڭV@=#@ > 6 Np m @ 7=HJ?on P?KPBC_7S_W_b?uAfN@䈐KG`PPg{<0@m?__?_f cL  b08 P)C0@CLdxX 3o [3:N9T),Y]`4FNdNaC3O1)Ī{\Ie6a   cL^m QD-^XA-츂ɒ.AG~6 u`rvX5:?aR' 55 <" i|H 1D9&'1|Dd'2ي8H!L _t`0ҳ GKYwXg̘8%cgZ7ሑ5MnM! Y@&4Tw hދp4j6Ga)42 ԍ@ "&JYiA 3=ʿؙݔ\+Ŧ Snp!H `)hG?qNFFp8 g)_")WEbh=hqbT eڨf}Mp•?`+ȍ08p/_+"ҐEAk0T$ )>ϥ[_c{)j[34)(Zftp>W[1&q(YxEB>1*r0Y"m3 D5R}e%Q2&dġmc Ck?'?:}3~ t`;8hAEHA6dcM#@28ဈ_Æh890Q1eHM`bQH1m-v> ;bRrB-Sڊ.;]~@dȠ5 k"jo@Hʊ)B?D\wѣkrKs P- EQD{)({h_ܽa! JLq ^ڌ hYHPAx@O3703ȃk){ d M*B\1#xpX}Ld5A}H3zH?0 c9BTDFDK/CAlk( $p )5gdx#؆N |;#C"N|Wj(pR[` Z1=YȒI8dpj|W` _@@u\ͰEЌ 8 eh( MX),duQ(qLTd@3izzx`3#uMkψ!5l;yx83waw`qhưh1EBO4M5"\tOC HLhK fhXA *xQXbU JU)`< Iiǐ2 YOԮQq!~y=coox5 4BRB![M;"2۵0iȹh1 xQ ̉ؗ\qR'S@M? S;H ᱩ4%xC=b<0"%!Ư kg{Kx ARPW `bSjx+YJ;;ޫՑ՟plLX.R.VbLA5ɜeyhE=y|hk2u?͢,z1'DS(pZr׈S>C1sKEPX@5Xp ،܍ (#hZj tSV,-̵a2up2x `$X2`j%$b2✂)>9A_ J  y_C c>F[/82DL|ܫ ЅRB:e8]~І^A-H 3RZTư]yx=I\ #鵵r y`&ӊ0eg4ІN c= ߑ1$@!_}8Dhx/I?c@LDA=*wZsyE !fO"X2ZȪNoOA=`|Q~ wJ6i3bȇ|m@8$ .Di4 4kxapQpUgbq4?1`Ѵ= ;F 1^E~Q5τ!vc>F8A:3O[Oƅŏ8whZZxZ0`pĭ+!` J8Y gaq 8vfoh25p_Y uf_uУ Κ髃I&YݎEhksk7 <螖Mn!+(>C(fRx_ KXdxo&Yx(C^ F# ZY#v xb(vkʏ2#l\-@gNgjR!LIxk$j 2Ծl}C Yh|gdBh)[+i]-cO^hmx5X`X%jU@8*+e0O q'اH#fə)cH 㞇a2ˠS=Gk= 2NkwpVdD["`0R`XP 0T0߃aiilǣa(GmA8ib (rC jA iwP XWwXD[vXuh8>/7e 3N~_Z3(i^s$F6hҞdvD/IJHN&(0! sl_\x j(i@q^ZMRvL^s`t2( Dgv%Q \o-mЇ$C)F)|Hn( >9؞̳ߛXuJH,a7v=+fcwiHM(RHhZ$$k@C9"t@s8l(۝W,z(X4JP;5n(N SsjK.)PLB-cm4~8U~X~Zk*1筷ue fgo)(0(HPvKN0 3Ps"#uo= v@ШZ'~l gй^T9?CÆ8~SD.n0fn yҥoqἇ#Λ/ݿ C#Ȑ 5iG$QTr˒,[fi&Μ'7)2L?}̨#ФJ2m)ԨKe?j1H0RJ-\O=˧bpٔ7xdC˃OTdz'Β{ NEכ5\e aP@R2@FB TlYxQl! 0ۡ{!GQaXDLcioD#=6Eh򐱌wlFmDGmFͰÛ2W ;Xc40ws:dvڍ9O RGPNቒ}5}c_~6'*P# bZaE)|0@1ZN%37IЁ XPLΨwxgό?wy]`vi:0ʓX;`$S6lM6؄v43.1`.>Ln^313>HNbM iԩGby+W M;|(IGU?D n?1䢋c4Za6ḑl)ya(z93+0n:&5 E;X6(<̓-8Ҍ3#MdoF4CІd,c̴z gĕ+L#Ňb5OG?&PqVC#ʥ /NPC`8b,$=J:LF# z３ &ksuOO(cͰ߬eC 2p[;찳Nipʵmӈ{43uxXǕѮe8Cِ?b.H:~cV)8qV+NlqsN׸ln|6tI1PMӊnj! -`'/S ($.(@(0tDW64`a"wT!C(Kq CcxG< Іx1!plQͨqh eu1&|ILLISz.yR8n-(41G4b!~J~P +L Z&؅y0d$xS]#-B+(x`N B1k20+ZZe.4I}B‘4?srW Hw8-Jl#j)LH&.D<%w ÉF`l5, U02N}*Tky\N" @M]5FW™Д?pdf q p 8 p$eTi(Ph&akKh6е(!*8P,$ u(lh*ѴRԢ"|tg$]J׹xeۘi/)_C/:LFtDgX َxH*J:r׆ĥ.Ш`P",c p^k}!`-0 ِ7ND(b!ќ]%IA >c@ ǁ`C:+C8ۉMylC}h[:cL}}V00n1>}>F8%'# ( q`xPG ;ةunnwqJ=L$0Dbq14I`"wr F bfy`%t@Y5&fA,␐X*N],B8ۺԕc0<%8A:;whCK֕<-2cws[FN̆%LJff~fҼ%3ƠE.HFAp-D"pQFIXPt_`QY=%q: Ib̤c\˾:\9 8;#MiqE*Bt&8"|J6!@؜hzƤCҐu=ݩ$.DU ]Z{D6ePF:Bo 6RBf&q o<( O~yh5 0A剂eЈCHsp_?(= aetxK2ecC.ٲλ{v(oJ@͘v$|{S$~g1%[HYK2B$B2H0B1b]!(虄F!]TIm?2H5AC(`niE E-AX8 gZXoî}˖=?PSx6d88T  >U8,4,H<݋i?N?8F} }eLR !Ue[YB?L;t@,pÁm͝QP682KITD& . &DyHY욺O|IESAduUZ)_EUH2`^Q,F֑E>è<700VWRS%uVu* HV@zBh؊NCpCx֕D蹴AKxDj,D~hNl, -5ܑ:x 7Ibhd= b45DmE: ? %ÒH]Fg84g ~#Z?C>H2K,GFx5̆5$?uY?Q2(f'!:[ƥy*`h%- 0@1LXaֈ(kϺCJy(ILv=t =C=ԃ;NEeݛ~庂C5HF6$;?0 UM<KQ~@ =!¦ې8lgiPc7AB |B-I2 ߦŇpC E2Pe8 L*蘎u`#8LCȘ̃ᘖ.dnd>L!?o$YC!m1HU%Kbt}4Xƥ_.oT*þmFB@\:jR:@%A8D:!.䧧a?86[hA YGRZMhn١.p.Jn'f6[<Z4܆mKC"SD1 0 o!,UD[>ȧ8\%eC,ѾQ}LTSE F;aBjOȇB0Tl1΋1ؿStZ 1geF *Sj&d*n .It 崳"Nǐ24L#Ml4Pxu\u(4hDCgK3S,2t@%1t@)muPY/=CU6d}H3gZ}bc'285i5^QY,83v tB6 rgm$geO6q󈍵HĂp-+5gQS@0OWu_7v_io7w+]B`Cc ,D-k/E?0X0T|8(Xo+L@cMuuQ tLĂ8mp6T`$,,u7GgKD ,Dy-S4}%ƃo(guޅ8V׸8/98V5y'9/79/ޑĎCE8wy8ȎOJ84y7,TRLjNa(+EvgBx܎ARK$X5?:GOz_ASx0aPz+'GEݻh/>W//Ekv_7)s>g~R.3᫾΋ I>>~R>s퇼F~}??5+i_?#t`f5WA?чA՛????5???@8 *D &TaC!F8bE1fԸcGA9dI'QT2c ,aƔ9fM7qԹgO?:hQG&UiMF:jUWVukW_;lYgѦUmϧmƕ;n]ջo_&t AqquK l+_Yfl1#@w\oh&&1q/ 5@P`(Eui|`BG3X@3PjZ#=!AZa8%$ ?>_ @0`?ť]f-P7*+`8L>$ 6<cdw (B h'oM/ HD =aCHG;A2yC51iHF@毄(L W@0 gHư`BoH"HL߀INr"T*ZqXJ;"!C^T xЂ V<#q6n'Y<7^d bHQC #| XX"A M@ 1 ; (GIRL*WV򕰌,]^ch007%ҠFv]6PT6wtf4gҚf)IJnқ,N7NˠFd(x,tOaL F ŅƁ_KZָεw^Mb4QvC1`P&E/!Y^X/prNvMz.5!lQ!*ʢ帬;'N[\ȸ7{\fEjQ[X Z!xv9>UFU\=Evrh^8(4! PآcЩ-$M Y4c(/ܬA XF-J=_.BXhyzÅ.v\pNxϻޅBv=6+ڰ,`v؋Ω7{GOқOW C!a㿭k?ۑayS+H1hA a;O[{ L"? UX~ʯ|-DA \O_ϿW}Z|g7I w8Xx(׀'X&x(*,}U|a`ajtW&s2CNe P~6B8DXFxHJ6 +Dɳ ٰ TXVɰ `%Ad)7tC@R("/!4 _((!  p 8.<$`(D)Os؈K6'j{{Rc|Z  q wfxh[؊励5fWffeS @ I) |Ȋȸ،8Xظ؍8(Xx xfQze7p[ fЃ 烧Py ِ9 PW qG 胩('|$I.qp r`y/ٓ>@B9DYFyHJLٔNP97TY p!NⳉZZ `YEinǒep=؃' 'ٗzYO5]#ْo٘ VY9j)tF4H3es К29鐩@ )%y9|wY y+ٚ9|ٛI9Yyؙڹٝ99'm) ЙIk % Y:ZzH  щ ̙q YɜYŹqI$ZٟJ#jƉ1 ٟӉ:<ڣ>@B:DZFJ+Z'٣@Yj3Tp8PZ5Y ɟGZfz pZ0 qZvIKڠy隷YwZzʢP eYYW:A k P gڦtʪબ:꣞UP ٦@҉ : ꫵڬ :Ժ1 YX@(>G x @ 0ګr*zگJڪ; ۰ IP** : CU  @0  %( 02;:{<L:N +H pW& [ 60ktz6K @$el۶npr;t[ + @ @K0 uu  p5PY @ kk;)Qk}NE  o* Q `z@ ˼; Z0+I{؛ڻ۽;[{蛾껾 xP Lo 0Q  QZQ0G`P PP ˾ "̽+kZk NZ`-l\0YӴԻ '] p`#|XZ\{ѿSP L Jf @0 b@ `ˀx@nP }0|ŊȌȎş<;<{;N`<'u׋çSjjUT>YP @4` `6 ʣ\2©<\| }f@Ƹ l @o5*.%I~p]_ k0 @ ܵIP <\~ϫ[]Zv|0 ,<]uh apvx0 Eм!5 6',.5+ S 3J4 쿺* okB Q пe  @/`\< &grՄ)9~5lmPvN5 vөs H q @ k \50Evڢ=ڤ]ڦ}ڨڪڬڮڰ۲=۴]۵ՠRP@UIP 4PPvౕ f@lQ PQ0ˌ 0ޚm}] ,[M S \ N0~)Nuu7[Eؼ+ {l p ט @2>4^6~8:<>@B>D [Y e| f|ZLx\@npZ4k0IEr>t^v~x;^$oNo>  a NuZLéA' Q q Ѓ5`  t♀ < +ꯎ-뾮ߋ>^~Ȟʾ>߮ l ˉP<P Nk`,JSP QЦ[P ߼n2N?__D>/ߠ55>p & / \sZL VE /q PZɱn N뚀 ; >>D_FHJLNPR?Tף@ 0 pꡰL P @ p ౨ Kb^?_,>nB]` . a0 $~մTW?Z߲N봏?_On ᔠO ,^,N P` P ܠGŎL\DԈMK8uTТGĈECI(d+*Q:Ip.0C 7C?1DG$DOD1E2 ϒ=#)IDtRıG0%OTdI'2J)B+ĒۚDsJ%I@OH9Xj Fb&~S3 )RJd0pDJp\ԐD5q 't,/4SM7SO?5TQG%TS7=ITeuUW[UWeeBHEt|%A<5Xa%XcETie6Vgg, K ykUU -eR^y%\teNd<܏>_ST$CHQC_]eJF8afa8b'b/xd1IiRUdUK˸e_9fg愉Mu&XugT<I 5RR9J_qkĉYVev5M,kKt c( \7:0SH(9tSd; fF{yE%=Hzt5iN_9Λ߇Ѭ\Ŏx?uGb׭sH]y$^z lbFvlf7φv=m`b+4;w=nrtuսnjwl: t D#^1ez"f,8>v*xyZPIPCkHG,1r'GyUr</ye7yus?zЅ>tGGΝ*lWR$yͥ>uW!O56_{>vgG{վvF: Pv!.u^ o1ya<\3ꏇ|K>s\|5yw>@ <9v󧿼Q/}eO@; FRzwuF`05'_G\D_zE0BucwOy#aw?<ʏc="3'ػp>88 c @y9qPSl@l L9Æ $9:Ӌ  sA@x 4/= Z<:3H&R!kK<>3 dxklȆ£ӏB{{gH:- kx27899g;5]8IY3 :xH9.̆.D \5-lěS;@-|DٻR4SDTTUdVtWXYZDE@>QXA%{YW'H8,ax"_xF':Yp">ZF[)^jgHigR il s4GuyLR iG`呆il|idGl`PGgxL:ǃ,EzykhHidX̉RxRgSȗɘəɚɛɜɝɞlۅ]H']>'\x2h8_Z ][Fʃl(i9ujy4CpEĆL`Cl3+KtKě+KxqDH-pPLt=[̠ES3S`;aP9Bk3`2h` YMZ(a#_>'^Yx GrdH byI{Lq0vdX!幆$HDHDixryHsyuotpІaGduКJlC 8Y>8]ʬU8@]XYh$PSbxH5%@Ԃe[_RO>Qۻ;~h WXtOduZ\=t,Gi@hp50oDHv0s)XuLI_PslGbV8Hjz^u EUe_*%E;@4X[&`'f(][f@8p؇Duk Mh҈faxVxR(,E VuHH6X['M:9O[LJ1e~bD'XUPePedUH^vaЁabd+uwxyzgBv}~z}مfo@YCPZ05x8fGVnUh2Jl؇ .EbkP=HYiXYiiV@rbebXe.F`b (dmw:a`0P%hssW-ZL@A(Cx㺶.&uM߼2&[3A4sbr:+8Gښd ThPDpG0<8TK-d'(OuxRH%h JHX@DI5\jsЁP5NP( DM'M<=0f8-X3pnpHmbV0'HbMT 0e@ x`e ,o(5XWyO`, u'qwG:HYnrr T؃:fUR U_N?pJ5xN`MW@OpCm oH<L opR(b(xPsXs>g^GWga$;HTW@^PkX 0SJUU%V*RxI78mDb.V*WXepUpT2h=M ^O?;XpN?aza_yr>ބuVH؄V7X0Qs xn8㍁`Rwh5RdȊ ,h „ 2l!Ĉ'R|hgFv^p* F,}5JիXzxM\:w+.[bTEJT(P&=zh@bꏬ?xQذZrRKH pK.oRf}.8pc[B)%]3ZDu[1Ǹ s6 9$ȲԻft.ĖUd# 0i,BCַ[t ' 6(J0t8GE ''Id,йڷlQ ]$ l!FLoO%ˣxԀdm S X@*@ *B!8Ra: 2eFMd/ .0R-@I38a4 02 /q@ $P'D#2DPIvLC Jt@!k 0 F4sy2  d)N8qx*'Q)18A5X0g8'ʲ,i D, &d! ;,{,D0&ΐ0NH$J,L4لSOSPCQIS HDLUUVi #cXd‹Y,4cYE^J`& (D-1.!ed!Ͱ))D/B@LuXJxP}\ zI7:! 7tr482&tG/D:0hbA+81\7x0^l]d 00@ s.Q,D#05,+8S-A8SXK/Dr780pH,xX$aA.b%Yn)y[,I%PBL4LDVX$L$1,%b۱ 0Ѩ+}+o3nprppEZq k_ʰ2їi( C(B Dר<^4@d$&3 2nq\B! v=]^ZW2a*h]|`A =HbzX=bXD<6,xʊ4P s-JhXL1HBuXE7XpPT&PhNO68l-,X'3r6a=,C6Vqy]+E1(a jf ,iZ{&6hANQ'n*ʅ,0hqG͈* QЀ B#?2-RmH 0 <p]ظJ LpLOeap X1EEF,%g$֑U4&b_$fȢ(0C0dbӰ1\rf=+ZӪֵn}+\*׹ҕ/@AhӬ/Hdv :asKJi D%2A5YXE `1 *$P(.M`h.<< >E-'a&" 쁨<[NPZ$HT:j)ĨL _؀1 ^! ',;νŗfy !A /7SHF%B)"2,v^b%+MIbp=ZaVrG fK!S7D  Z@f fH<%PM㼡* <NFn  45-a[L_0%3ܖ Cp!'5+R!]]bpٮ|e,/XQ@$|UY"HLxq @k"Y .L\De !;*H'AY <0'0Dtp M܈ĂT"1pQH4*< A()ܱl@ FZD# J ^:.f?;Ӯ={ P1l @|x `3k`  11r@F`7B{(''MgG ,Y@) p !sEуg -\4F7R$Ӛ ," ,E-2C0 XT"&"."#6#>"$fI/L0pH/x]ܑ .Ă/lI؞}B/V2LË)5-,,BB/"MB42HX C,2B,Ȅ{T}L c.B2.}/6E4 Z,B1+/+2 Y)6.$DFDN$EVE^$FfMPC`` V*a (dB, VT=L.@F.Ε` /-.(,P/&dFdB%>$^f0X/)$L.XB˜E-$LAYّ0Ti1/(ǠE3B5Y3܂޵싋\.^f/K//Y$ c4"BR&;̥[P "Y0tƧ|'}֧}'~~'$ @ΧGHB[a`I$.0๐¶$# ! BLffKnf㿌X0JT#S .EȀ(,$!' /1Q-܂i$!]I8]拸Cri$2UcN&iceBgfΦdL5")z,WT!1NV.c^eY8i ȔQJX4'‚B.4Mfg- ؂8CXX"*檮*ꪀg VHFaQ[I. AJd#("LK[j"h*.$c銶Mg뚅LYX"' 鎺+j%b@)"[ ~.&Ž6"'*N,V/hdN")in -C,+*X+zjJqbc/E0j ,ꝿM$BLjEpjn,\BV^cLf˰&!`"+)c1+JVLVea`-옉c|d2"XKZ|,hdjIp- :-d),X2m`n,쨫N9> *.閮.ꦮ.붮.ƮOhvm.`B,.Mbn|z.rN߹H}~e~%B!DŽ ,"L_Vctt>oX &ֶY,~">h>B"ȋLRWX"mIЭ!L-*".BUN'.,\P.بK2&~.g/ -P..i:j )W"Ђ-ܕB,.4BL'*o0l`tNqqJoD^xE0 0qc/a/I.(.BJ-Je] G-0j`.gBr707z7n)r)]2,Dz,"LBVV#Lb&Qn% 33qfȱq^36g6o37w7388399W.7zzs7{7r3|{׷Nuk(`kKlsPw#r6MΝ}?8GK{O|g@[8O& 4%dBv vD]xO+_wev8xc˷xcD&|[Āw>s72o|N,_97&rg?~Bd‡7$[8yw~V6< <39+::'7?:O:W_:go:w::::?-(euuyvy. NBKbhnEow,28;'/;7?;GO;W_;go;w;;;;L+:ZwǶAhp-eB#?OO;Wg ?s}{}珽ُk9ۛNN((NQ넽ĆjV-O@#?ǿ?׿?|٣5@IԨb ,!F8bQ4ezP@@ G ˥+@Ŕ9fM7qԹgO?:hQG&UiSOF:jՙ~RK_(4 :"XR]4QA\~Q^%G{؋0MstCN<9c3-_Y3˞5-҉OUî_(ClqOt*n8 @G_?hq2ʖ/y6lU+c)E]佧Ol2{k.^ʶD-ùS Ҩ@! K I4PŨ<ɬØ: ꮡp%q4:SDe2 ^pnD%먜i.,$L'tQ”J,rI(ݔL:L&JC<7Ĭ&#MQ/LrH\>DIE'U32lUY!=5[<5TRq]o& b$k'…RyHK -2 %(< 'a,vGFbjAAFd_ d_BDN.A)R+'`B~A'DQg!M49_dWƋo>YaD %~$a 1gDv`1zᤗ&駑 lB>l9N츿&DiɎ켩ym\qg$tr.n_Nr1c.d3VvYc1iVqCHI? y@?l!#%/=`{ U] r!aš`<, ,`C Xc3խf6Nc hƂv1crD#Z42Т1r?1L_fO@9ʹV>a 6.\G B Lqf HD Tt@pQQg9oաmiOնw2i;8!iqc;vMy[M 5LI]j[HDzpy̱5Po2e;"PqLn7Qmgfg7Xbc_r%79P]stw sK&~RdQ7j@V-.|AlK #flc0>$#,nTY' (Bue7O3'6wm='Ie"Kom$cO!x#> `OaL |->~Ј{-^^sm|(C>摌C( 3>ql=m>{ǻ/nDg8u!9gۚ^A0b"A)ebΒR'(;TV'lv"--mo$.MTMgblrsNABs$}rB& P(@  4-Q-5[s*4RL.)) `AO)./"4_"@d"8R'-j^DA T=p! ,T;t[U4KtDttM5M۔(INN' P` ڀ @1 Pk3_ӡSʕ!&a]uT)39V%¾8NlGeO ~AL!!i&AnAj:c"[Rв[V4RUS ;p\)"Ma&vA `33 n,4p/Vf@d7R)PPr'Fp&"P'6&sq@/U!frVkf!b*$WWa! >ARDDE^ݴz3lnl٭ll#3 mۖ{ nqngPbխ0N0e_/(orQlrt;s3t)ObRȀ,uEuga"Ġ$QWgW l 4:J,N!B!Afb B!1/x4bb%t6BQQvۡ 03aa u |ax!rQvLN!&0$90w AOSn&֭HntMܔV{)])*\vWg 9!a<v0A , ~oÐoqSSTc!./s!3 ` ɀ&PXxa 8yf3$;Tqΐ'w =0iDS!jRQ3v@dϯZfA" EFKvOxǼ!`<-.Ph&jo;!>abzۭj4 8~qAAm` T$:5M)ה PaAep{z()96/(OlP[t7-@z"vMXsx!^L` lcBC J쀤]Aa V3 %@nA~v'qaUaYĘc,yҚU޵zQ\0ގ ULarV@`y @o%/c:&Aqe6_{lq}t)z'!Z)}CB!'!L+n h{!n @ Jadaz& DA^Y߀:4ĀEakáBBF\m"0R ɸ ء!q%ޞAaNA6~㵡&}>k)/lH6?*|}ɂ}؉=8Hz.] `f \SNDNd½] 97=a ߹컠a^2]!7'~~82S3~NAǴ*HM&N^b5G]3i-E i *abdYר*nH24ɀCfLNc f]Dmg 7u`UWשK*#%ZLM7٤_wT%5+egFofpnl~ jr5ưh?/'#bXdkE~Z.PiP&R>++[8N Lhfr|"*\Ņ8垫kn;O*TjZ6ȭN]x}=Sq4AHSU%<6M"Cr&s*lc. sT_Ɛ"͘Ռ؅IF^{䣇Lo$HmoѴl1Sh>ဪfY9_{O?㤍˳$oȻ(l@ l ȴl\ N}, *Rp7).hL7HY4,5y8A> JB@{k_Q|Ze γza_`:qilP1ʑ$!%]g<)b< IT IՑndXnR-n#ъMRc 6 nDaNn){jæ +B7|XTX-C0Cb*^4a-T?1 l@q1aD> O95 ڀh$?i|i=9>L{(&N3btV$'b#.V5!)c +qUF+2 GqT00`!f:Ω_-d_ Aq 3c4 J$^ǀ1@{!"Tน rP?׽ufHqa -$Q\,1ĐE-)nK . B~hhAp4%9[%6taF IxT  1 kLc#Cw(=qDN.e¾[id["#}"=3,)ԇl }H+/hQ70^s^MYkȮ1a#ռbt2?A~v4@ ɓD 3]0Ƞme  t p':   @ ߀@9p=@@ba)($LAOQh4"gB` o [ȅ0/DCq^qw{6[0 P5tH5U350 wH95U|>~xn"Da 0; O%>* S)+-`H(*a p0yr @@ ` f 2 pbpye >ui>E{Wp 0L-KBC00)i#6>阸G_ S})<3Lߠ RX`5aWH Uˠ vȚzJ |Q#M *A_b A1M SY*@ a0/გ ` 9$2ى#@ `p& L З P[ٕF< h$΃VIp !HWt3b/Vʅ"7נ d) AH2( é+Ҡ`yi *򃭧9tCJ@Irǡ): 2*< H vSJczѓvZi*YP1 @  i 0 ۠P FV / 8p UT1#2#WxiZ0/i ar[7 Е@1 %!<)T X Vɔ(ݚL`J5w z8O+ PA K`*bku'd h4 EIP @f`   fdg\)$3f=TP/1L! 7L5 @\% `^d``~_:@LaOu` Yh1f֚ʚy,ó/u I WHj{2:KiB zU &P ;Q~1ZA:%t5::Kd[ I6 m~,иA 3#)4Q7!C_1 lF ;̅ע »G*QL`up仚;Ջ"<] |P/z ;9ݸz_Cqh`q]^@S<_o@:<v;yP~Y)yCF2<lg!+ D }5CrGSC(5r>`N/o"7kd<<,<<~1ɠt )m "Fsͺ͹r͊|*<88p w#6 2Tz| uN-|mH `HP P5P 2'`&p[W5 mB_IXop1IgqènQwߠY{]U *"`7)ˋjbVb ,aD/Tr:@@ZRb.zlp3VL!;\ yR41M4~&K`P`PB` B`<]N |1t( QQ1z޾|R^-tU4q ~.aAU .\[NQ|>3^J9N2n꿎` 0R82G$NTļiVߜrB3pGژ@7@J 08h@.];u"뷞th"%p7Y^ 阝5B@O-)hL'dܿ,C/ `^!؜FOhs4NGmN1;1,vE_\?Oq a LMcnX`1+3v.#j{UAr[ lUW^6-oJ [L0Pɀǐ'd">1T6~_- {罼- QCRR%[زeQ-`PK<sʐP6!!"vj;O\xx"Ш%Ϫm3B ňs P߾ #jXbBPbDo/}(?xo^8d^Zy'{Q?xۀm m'a.~Z>C!q!GJJfpxR0c*Bc #e(y+?~*E,[ 4ji\hx418 A b!@F@l\ckm!<(/f32~ (wixIG$"+75sO>iqF:xg ?ۇ;ه'YtG⛏>[(?P?LF@00抂GxGx'BXpva?GBQEqf3>g3w,ouTh 2 bR&XM-|Pemw4eKԑ&􌑦3U];c҆ fx)y:|&w01?y .㴈FUyKzgi0|erIYȈɀxfkSl*Rʟr:"[dI#p 7sH=IyA 2^}Q{נX-Q܄_Pczxs}wyGj 6{YfZ& wtJ:uh?Ty:jkqLJ 9 Fwt&PHJFfmx͞mc@ d;Ne`gƩ !UA^r%5j)"[y#H3@2zD?\lT}s cQ0S6b}QGy|1CbZ⃌dLC;؇?$֎1lHяt!1R=iL6p@eȚ( dC6ifnSi(klѻ!TIf="d#09S xcˇ5܁,uk:4)N)AlH@eBxH#]f՗=Mb?a ( P1j1 ]0-#vi,#"(@C#t@T TQP^j\N""ތ(E{i$_賥*#y$X Pq&Ð ~C06 l*G?2&/(>Of ҸShEMbC.hh呡J↗֦h,x2gH2Q(KV 6Ys ($lݩ~;m , ~0k б1)xP~iQ&8Ck8ޓ@Hs7yxg8u*) > !$#C:<+ p2s'0qY0+)l?b{EO`70<77*<4e2 P@5,Œi؆gZ܇J,i/`wFaAG;)XIA`\/Aq@-eP"2 ivyk6o_(̏BBsyp7x@`19/%; 2$dC[ (0М_?wX6n`a6G@d2kPbo0 B)z+DF1p6S@82* l2 1Am3b%yh2v .`xn=yE psd9 qK989Y둖`C!+,B! x= jiA3DxMhӛj[ ғBuHp0|G`SLL Y ≇bІgPhpAbSMQԛ-,gcArcA  H˼4z9 =3,CŌ v)(H"0$Z&bȲ k86 /yRl̥#.+k|;r ;׃hYR)3#lؓT6{~( І+eѣiuRAH顉 DwyB/%=J9ΏP]G磊3TPdR# ?"8 oHZ UmHQ!Jx؈!G; ˣ~ЈiR" E0)%e~D(MI wІ3ҥP3fӄ%1hq%{0SeQ Vt194JiXaT}=B CS_JTC@PDRRؾf>^T|3(bYe@T}tpeU"!܉`)7LA45 pex|X m` (YIZYԠF/"]ٚ3.ӸY _$:z"Ȇ^\ WAPkHڍ0Az}eq 5μh93ѥn[["Z+(8Cc[ЋwM"M HntO VYE RۂY~@gڣ]EUBS ڨM}K`E/SƓ[۬X-U й߅@@Pw?0:!0 Lf XZ()45_]ѭqc|yJGWT_]v,tW GV+~ӱ 9w@vaN.4h8B^xl1 O{4Y (A)MlY(?p0H܆8Yl@@XT$U% !QM@l$r/`+"Ն_[`aqԹVβlJC1fa.e4sXiePb`e!r\eK;C&=`Vb&(P cc؅5@5X`&(8T._ Js Qdp$$)!`pVdH'iO8GE0whsh0H1h2c d nC5~*:\{v;ԘV,F-Pxgi"p4@x+[Tl6oHi#gMV9n$0H=pk0/k/fXe{B> CYK*䖕[ T zi(X>fwHpE+̑36(eS>-` }~ضow0Y}ޏ농 ;2pk𩚪,28f]du8'^VĩED?L/pX{Mm Vh\AX 0P7 y tPj `UY@pfjPUq+X 3lGEu`/ a ,2X位B-v<euȆ9Tx۰KsŖNXTswW&&ف`"ȃ+ƪ< 67xm4xm<2'0$uѥ{yMbH3 X uuq^O_vaG(xbYe2iN%5mj8u`s0]L,(فq zyWz/gıG=seB+H% p&h…^<1(307`9nyIkK:CL`SnPg^k+ks}@ Fa' VJmh u1//7k iCj@ӻǎql_{CH+C%@CX"p&5/ 0~8p(]8 m'=(!.o4l0kڴMnm-]t+wQrͫw/߾~1$Ao#NX"D 0TǏ!CH .ka,835s5EH 0ȃ<0y5\X'(^z)"" b@!eaD@)"i#N4Al?(c…̆M6$+v28L51<[bGrR u^2\OSީf^ A3BC2ܴ?LCEiԳ;bѣ<ģ֨? ZSj:x7Sv"䧯^$cĎB#D1Ђ ^7'!<\>H?R<2JA5~2fq:('æF]8$;S\Av;?F8hO>,rL_;+rSuhp%h< 5\|R̓6 ZMgZ\b'[h[mЋ12kf 1#-nz ` >H:#2=m3O,l,޾f~tҿ'J( O8FDBILZ1IsՆTӎ`DST| 9S?AGOxOL,90P#H]m`+$þ@QC#\-x47"x"đbC@Dq S_)`wQ"$8hJ~4$Wd!gȫ%X(I=:~/}eR T@ߵj QR-(H.`xph4$bLA*nȏMij 5x͙Lc(> 0@ﲐ8BiiUhžtO'5lǷ5\b);f)`؎XE|Lc-x,$ `! 8R + B1]QI-Gq ̂52#&cM22e`:SբXnNBIِ/1 b,@0>"0PgB@ bEj )o(jyw&pL"! *q cQ'W&nU|hCpM$l&3jmkuۀTjM Bhѓ[}LaRnaԟRj_Y3ȸKAڥ@) C-.YsC-4##@)X^I_Z]f_V` S(^#/"("՝CC1DL%v(;yϬEEN2|ZI3X<@@2288#8J_\NLcVіz9剄apW ;C> P$\Tr?b!sD:h' !u2Lv YAC80Ȃp1C> \U4(aA6`C6dԢ ŝ<Ѐ4hl1%B0d[PW> 5GI] n8ePAg`,B# 0@,aOdyT]r7v#abcq\F |5NQ9`EEhQu`@ &OPЄ QC(C~\éC8L(m2mqV!FcpeGq.Wq1B<]7'C 2@-(dc!y'`(q (BGmS<(wLlό9N;d@>1CT6`CEnfVCYȓ6,ӜEP(~ZSH!1f!vߑyhy(~^"*" qV[XAl.p.VD3B <1xvFerg.>hQ =,C;@T0$ߙZC6.n &ø>:<8*\ 25jJx%eXYBfd;tBT0x, 5 RV\ᐞb`'CdGJǴuSʬ,N,LӞBD{'*[QѕrhfeūuA{uc2!F-8eߊTtMقrD%;,\C^mi )W^%zZ;Q{bEhHV'kyVxl3ENl~4=cu?-/h@-4amcnۮ'ajGdB4JYe#rF@BBٚFde=P6d,gH>!f{[M=KnboNED䯰P-Jce~]됾.8Jn._n#$g!O./(ޘA<$8@-$AQgeD^zo0* Q]In^JVf⯢86zf>LFTK o؎$\ -D`: t 02`BF5A*h O1]pZ[L/BRooa " % w-L21G1NA%G:@C@%6hm""\-؁0tӯ?4;%-UPp#/S3b -A^L:1B1q`*D:Cl*D 0GApH>|BsS /b穰$ sA03h 6n^0"/ID$"k&5Gx$Yn 6bFss$eiL/,]qE::GC*LǏF4~3R2{j}f#G}"="cܫu 3n'6oc5? a:  $aD1x8TxdH#RD(*IAI2d[ KwA%e飔dQGi0dUJma_E=T I,\ȠŌXa7~98$qefky?FJyfӘ.h4q1Yi0Dqɧ? '@rl.'A䐅s^}E>#c_R/miey%ɛh%DvrrǓA䉇e  D"BBGdFjX'FO.n6YDd` @†_y×ię 0'pD)3b B\cx:5aɰZ<:a%U iVxzj!jZ7H8$ pE4@ CkX=ihOf? Rx_dBV 6BP:C>j!D"8"$}x6xl_3 9pD%ԑhA*jd* 'S(tP Fjdc]Xhr!b(Bxrd WhlC! 1b;W2aٰ"F\# Tr 0y$ "7:3f4D ̒e( Cה2QBH~#+Pl܎s,20(QX\ 1&C'O^(T{x̣L:TT/0yQ2C,f痔jdGtNA57QؐTST8,\U؆5PV`vG,p &}Zɇ3MFF,"t L^X3 ^"Q2=#t x\-xF>Zccr$4A e;V̖& D)@8\JOV9OlF#^}VuZCTU,DC,*`$(Dԕi--v LX.>˰Q FPЅ'݃e? e(,@+hA g~'ᐨ5m "P[@F/ A0ѽ D\:[F(HA*Fba"PBl!<t(BQ4K bKU[`Cc6>:Or6k,96DINO4!u%a4PPYrQAzTR)A/ B!H?5TF@T4-{U_qL(5`A:$c`o;ńX#a`V:J"pAb!`!L9"!,@pR =!Ab1=A!dA!Fl/`Ɓ4A TW5_leCL TWQ2;N#("ɳWrCA h L N N@ AR@ `A @` bLR$`Apt`*`J@hAcޡ,4A^׊8$ju-z V.7%Rt뤱%Vʷ||5x.c+7, p!Z8`L>! С \!`:!l  6Al$! Va< R`F `! X "l!.fX@8!dA]a ^l@ax!$U z3ekNs{Vi/E7s"6{E5Rě `  ` N$aT8:AĠ A Ё Xbbs`.|bAՠ~ A! leL@"Z!.@ ,ᓅBAmzܗAU*̀>pZyڧi ЁhXa;@""@TA:ڹ(7i޶ґlݘ{)#;隸6[ b!M)P h`#!g,>:8}פ9! vݠ`VAÁ `OeV{Ia[l4Zϣ'T]VЫa x卼Mi1aV4׼i/qrzýMW*`^.:"N9 !lY AkQ ` pxY eJv:X`V! LN ּǣx:ǡ4[l(əJ{ZMeOs}!@!!L*R "`@d `" l` d}فEZ '< ޡ,l f   L Lz8! X"Q!@ ]YuV@z|Ons#wUp܃`#ӃjajA{ m$&VR>a%j<<#a|aV!lSAv98=\ Z#C |։z XtA {>/rx<ٔed/yIi,M {4!f e Hk!E4[cTj0s$FP] fRSUy%_U(Ô(n>D9_[ay=#G?K/|t+4A3 ISl۬d򒍓 4kcm>k Hc`8Zl$#.e}P XmMo\kלKYLx[PVyᐹLipmZ~KٳhӪ]˶۷pʝKݻidDOa1\ǐ!OLY2xa&eϠC-i͛9@벡rL2qCG NxCK#k!Vl؝W'E&m<֯9Ξ˟O~;ċ6kwYiʼn7x}yVfVhfV`C)AtZe![>*&(p8\^N#3՗g?VJh(vRr)_ubc-Zy~ꠜ6{bI&ibVXX鄚M&ɉ` tz"ɧU6餓W >믾MZnSFZ3oj,?c96WB&K`[{D`)jzeq+(6軃[gg} lmmSc4*\v.gKjnJvRV8TL3/ߌ%7(pOv32na6R2ɤeYe^M c-CkД8mWCrj)羪6'*ά=e8{F(R x=uE &eLt?P6ڭߊzZeR)MyL-W3yx/VKFr%pPGg۝KDUz,s(0 gHǙD &|C'}Vw?c?8l|JG8YQb<%P63 4 &mx02R`8FBmII gF8쐈L")xT0+,@ :r)@xFJޡHH"3dxb@J K J:  xlZXR |b0Q 2ޑR` x+L0 ycK9q@nO}*#JЂ. LxPܰkA,piDG Wt:`80 7ޱ"&X2䐂xX? i4;@Sϥr.HqV, /8|}â eσ`҈ Xj8-:Xq`u;"1I1@G'>Y| x, I5bGr h8  @ql"K d{Fn֠VptF!X6mPk; D вl\B4ͫG!ve>kY+sJlb5GgJ)0B* pր߈? Q9.iQHI^ )Ta4C1 oxq2[X3a Y9@xG04̑Y>ZHu M4BVZA[h[јް2egӶC\/f(p)A7ku@QtDndkb`h3PmH;1`D e RwqQ>`)E b 6w>7#8(ɇ' i\# tNwxAh8 &N?@O0~Xf.cN|FOvbޛg{w:}=cV4nBItS@P>FD@@ 3F<f`6ư@%m|ژ/Pd N  I! w( {V3f pPygqyGhcQqzgzqv{{V -H{fW77x8F P S k߰ @Yl K7 z0 0Z  Y  0`f fm` }GK֕Kk`À y` `/ zp +`6 , kdyy"eh%(3'qsjMrBjrFc=;(i/%9(24P& aPQ R}R9a\Lր &  t p `~` a I``` }$ Pd 'P 80 XPz(h6:Ȋf׊{‹ؓcU` `STP3Cd?`SgeS96U4 f~PS>:T>UQ4b!0Kg4CQ# pO6LېN QZfo@'_1 g@ya6Bxj.z.(xsWy#,Bٚ$C+xڠ  W#q`jq N0 CEC:MB?09 (0 C 7y'EzY{#wh3Y'7 CI:rDy֠ )A nœ_!,o)d-U Ph1hsc/+-2rFYE٢i 'mZ-xi5493` 0IBgP R1*X<98;z8x{^JsICG=%p:tѤO S:qH bž Zz(d (:A٧֙ R6ٜlPRm Ƣ%O!8$ ~Sr62wW9jr5Ǣ](J3:j aa/@ѩi ,SW)T# "9<)X!_J-#X#a+J窛G6V"B"z:"X:b9ɺDeXHj 4Z9ꯛ!s=C2BzΚHيrrɣ+{#<㩸h&+! zrijg r W!ֱ# aY3,!- )A .1 .B!hOc| H  `yhjl۶nr;t[sxz|۷~;;6v[;mѸk;" )AOZ;{-0`  f+KkX[`;5y;+6/@p)i3tv*d ` {؛N{X듪> ;[6_ѻ)1)YDCPr . +P| << "$<&\(|*,.0l/\1|68:<> k웹)0{OἆHHZ\^`\ d f|hjgLnpr l\v|xz|~ǀȂ<Ȅs<DžȊȌȎȐu tuGIT۬} GBX,ƪʬʮʡ˲<˴\˳ʸ˺˼˾Ŷl|Ȝʼ̙0V+CR2$O.`S <ν\|ΡG ̴\ 0\ \ p$] JR.qɛ1_Q+B;.D#PG"] "<϶P#,.` PaИS0srDZ* B_lҸ P T]V}XZ\}ΰ 0 ` ]}h[zpϵ0 Ơ Q i}xm^l r=o-ϱ<_-< _ @yP=ϡԏ]Y ``5-:=5 <.  0 RJ}̚$ }r<ۼ^lŷ ۯH< p ð Rm` p Z̍ۺ` = zʠ 0=X\ԝ5!Ӹ L)Pp*D!}Sͯp źp _m >^~nsH` d$^&l< P ݰճp 4~ )- ;P 0nM!Đ 8N8ٯ  fPaU{>Pʋ*یBmb gʖ]v~x~ f؂v-y>} rՂ^L]P@ p؆O M Q}ې^ꦮ՘ ` db g $Bp'5 0@B5FpTn~nN~؞ھў@~NM.!P.４!K^^,N 0^>~NM~`"/ _/(nL `ӿ\P8?@PD M0 ` >P50 CѲdpZ@;.!*`O> Cjmk/0 @vxo#yn` d0Tg_p-_j?` >h p d ʀv` C^Ano??*AzS߹lAedy,6eSUi d] >p @H` ŀ @i Mq( ..jq B(B@0RVI<~(N8j,`BK\t#E 3]ęSN=Y3'6d݆~M7*PU^ŚUV]^`62ưƏ?uśW^}k0>Io[&HA%Vk}.Yl<{Vg:97imZ7= uꚺS˭/vGNFr2>I;شӦiV׮a7hl|۞^UFD/arN]3ODp@ (0pcyeZlFXl$j2a<^jQHtLl%J'3b1FeR/:2l'dh)F$?!$H#R-~1*%im믿K-0~ øfbxG*I"xRGLʻcmq|-O'}9挑Kۑi܌x#w6gf˒5V4/\hhĒIOVY?@ d!0pRjEpeX lȆ6g%aCحRUyT %X{F8aaRUMkggG˻v&rx//E Ey @ ktx™Mm5ٜJmϪwqT:I,kmNijw矇Ħarg}.|Dx)n9wǚOGZAxrZgmm<֏xcl+۝d , q#eLnGɆ5o\Ag((MgCMEeq!M`@ҝ*Ƕ@ِӒ)) ubpEʁ1&%iոFYC.]hF='49A=Ep`i,en/88~ Np҆6>9JRmʠG*AUc /I8k ix & F9I=2ӌ;f4D,Bt2вÞ+ihRkr*p"4~ch&&7xʃK &MT+nڡgqdP0ǂBs@>O'ǫXr7JFaiga %)u:R~(c-v8jq1g$CYK`l#/cĀV;xM!*!4hZR9p!s>$"#@Pp rRCQI:qDdrM?|bŮB-xۆ1rctH8>ִJ`qFU) #EeG25@ֺԤԦv(s7{ٳqIo}&n-A2=b B8c@"B$ָC0ƑF@D*F:G6{敬mg<g9^}و 'T1=^OCz*M+4UnNEO@[קč9>e+:q7Ժ^i0DlO|l~W%aHYN cKO삲 ;@ ia5᠃b oEpl*^z.0`o>M1AaWHS?l%5NLLLqA궳wIf&Ձn`0A%+Yyo& Ȯ*k)=|+ĀkX6@;yYyq`IlɗԊy5 tӸ$xpGz3:Ә*b*MtIɚt_;Z1肍r5S9 dEb Z̊\E<&d'~ʲJ 4$K,<ːF&?4%܄x @h] ,l`JWx@&A)7|X4 :=ȳȯ+eh'!+q {ۉa=Z%/öu!C < ft]89 xF"Ϯ"ұƎRS=l.04@Y{p3|{Pvhg0crRJ4I!R,I5-.yd55K4DJ¦=H!*Z 4`Xjq a>PdІDMM#3{Eic50 dԮxX؟CԐ 1+%(- (W8 ԇix*$Pш>mK2(0q=-KV$/YڌC*=bIB"9y+H9&$B>D1,ȹ+T~WE$xK hDXc]F,,܎%ΘIh X|N)QX,˨evQ79TkON9 .sU"NP|hV]Uga$C? C\~PTW~H!ENPR5$#u8:E6 Sሤx_p蓐U8 伆Px=P8u 4M߯ݍ3ڦ`G˜d(H>p0(;Žu =A`@CmPP^ʧ[=½Zr_(ߢLՇ'2:$ %@\ GTuSwQ+ Nb0`;(G` K@ Z5Gvx5(`$p(Dd"  *fJjeMjtt J-\hXӐ,4=KFX敮c`˱OqS!8"XgNXuUx;z׶:`{UmPW}~6h _: \7۪2*hj lz6%hihgh͛$鎬P%MC&lcMF!i%DRXM03=M t7XZFj#U7L?q@Txj҆τe6b &1Ʌˆ~PKXjXt7)Y}-<>l#c}TΉ izE` 3ȗa{Wa*T _Nxf2֝$*9j0 ɇxX5f7s`6n CrX< ީP:ِ#*Vq>O%!B9Jd`@ue-@>w懼 q ӶMh,pJ hTveE˂9Ds`a/*1?ָ]vTYi'pOH0U Z|X2X;>ߒT7xPp(ry(#m:in{@TUCyMԒz*rp ԯK. YJ]ók~k`8h~^*ȍLbZ7|QRj<' rB9"c1cZ,h RjUq.g~=R_) ʔ*WleQX9n۶q05yj%ҤJ2mR_}ʓ7N…+,#:V3Zi3<#N}LN|w5L WݷMUٸ~9#=xPjL6$ET?:"QJPXy2S|c -%Q4 N6'7Xc W-NU8TfT)J;mI*e$C:e-+= U@Arn)rnC@AԲT>HZQ0$[qR8hB wl#F*٭SRz(54>Uq d89=k>^s,2XC4c\?E3m(e^OcM[<_c<⤼ކH%VE;2a1AMdW8\{=M??Բp]K$J&C, QAp" !-@)e ԄlѐB`l)"j (}J01x AckÀGYBG@IiW&D#*Q-R5 # Iǒ Xz $`/qJP9wHH62 F 3A Z0#| ̉ a㞖)u,l${# RR݅]0,T+e b>FbW0U¡d<0bCL},d#})A$cƣi0? (/$[2PbÆf5āC"S?=.r' Q$aAG2c8*[ ?(u~ȕ;|0 hCĽ^DR?N&hUi,^[x j6Ӳm*T ʪ&ܽ03 s0C,XĖdf9Z}vdIS@8z ,ͨ !+6~L:TRPp30|K4cԤB(q,JƎ nШ@ c^+@ ~t챋q0Y8ưwBrӞ-tc@U.gb&%@` A^ GǺ`DKȒWĢ+|xX~`2O8EXO1[%)!2H nB;ŻLcb4Rgd8Q89.v khBQF֙˫&8}HQ*nMA+R%N)A^\B;fDqk|4RaK#H8A ԤHby~<} zNC9G8TӼ8D67 >7ι=2aA* qk \鐇Wg$RGd]YL$3<#/N&'5hOMI%gSx܇+{vvXFJ܂pV]І?Ԅe|z &. f]pfu PmtA|xIA 8|@)>XCL^5`B(_W 0@;X4]6^XdZ%u^E|[>|458T[E_r umURMl2?C}\Y!  "q= $M]g" h$jB)@)aA` r**A< r!rWi~`4H2c <]6F A{JcW;KXY4W=ɉa!0T?ԅ<6(\28Q3F*#::#F!Q #H K| <Ь&7*B *C0dp68Cf 4`:9t6dN3vQK$PP*;qpA<.G}JXɝ?nj|C*% $hh#uzJ߈@hbp$þ}C$%A<B2d_CbfϭeЭjXE "^ubOf`$Cȅ`MNUm&{{EyQuVDjXA@e&KpYXC4*4C$A)2pY^fD&g j$=53 qgu z$A>jیO(!. bG9i gkZU\&CXx84Cd*P~+й ?F?0Jb WpHh eRn3e.*R#gi=⪱%1PhX;ADA8,BDB)#y5i)ј<2<:lDnþqX"*?4n+XDg"%ȥA%}lAj dKX+pB' *}I8)5JAP"e:APKdǾ\5uKhAdde5ŜANDRMe&KDY,AIZX ú ^XnmWxlX!QH+%5!@bn'(Puj+K46x H'C+q(Y,"$0Bi !=Lۤ&K f,ѶbA٦lAlKADC9Y l l I=綮",-6Ͳb]Csq9ѪdghҏdmA1)>اK).@!5tCvCA)  I .nJo"̮M14\Ԭ!of% ,&~nkMJ0nBwŞM "/A,!g؂K KX;,B0\lEM1 q/A('ooҸS4mӏ~*1'p/l h-s^#|0"†Jjض&-6|CACиM>E$ \(閱))^lr!0'%(x_.ORKB))LGr N?\ e.AD4G4O35W5_D10w3-L3α+|O gRlDbT %Q84 ($@ *C4~SO3cDO44Eg.8(gFGJ@#ጜ+PC/O 5,{4Ek0r!*k?MwRC:3n%ܬ:d8mڴ3H;0! vj`>z*&JF=uN[C+D65Ё/C~4A('v`a6b'2`(6(Ac2e#a+v`Of[6gv|vgh#gri6jbkbk6lkiӶmbWh6ovaops6ppk6(j6tGwlGvnW(3woovSvw7w6nxx7yy7zz7{6|bPC|5zmu=%JZH]C6"+-G!D<fxCдEw]# þFz6Qkx:PD88DC>!HF'pJ`.7o3Oy8ox3$5][#-Sqi5dUEc6lG69ǹ9EAEI<:@%F5f+l< }wn-Ai#ʋp$ٝZb'Q)\0±.H;96{,N)Hz?C2.NNWn"nwRpr39:qwS r!DY\D7|Rhg=T*Q:{9;IEw|=99U<7?inE ~3jrTB%!q|aRKCM¿|RܛUؓO9ڻֻ:g>}t5xԽ.~CTlW⏝sGO>= +o`> gzKn :ƑN|WW@8`:@.?!F\8adS7N>}7dI'Q$H_K-KRJ7qԹ9!6hğ? @\ţ@FjTAP+hP 5N;~/ƒG-Y~9|:Q69Z ?xˈm:qz&;q>N/@ugl^ǛA*@*4 l`?`$# ϻ Ò}8th=sէ!g.Njӛeq6. \~ 28yJ4֔eIKAd0#X۬'qġF;hDI WN* DS3dn*+laZVG7x,̱1hI0ÌI9,d C00 ,ѻAF3 E '@xiIǙҦ^C@^LW\E3k#=4@mAaو Zl8OL)Sqx|a|:1d`"@DGATi2yC@yD\%D,)AG+$2E;蟦%Ou恇`hZw8&xaexOp Gx\cEQ^{Y`%mgG!֘!k%LYT$jb^č.AOKM QmچaHJ6޿PEEhW%f#}B!&cPWzLk0y.'MiV՝ hGi^s)]z P;x`@^)tGze #0 0$; S`N}|b`KU-FF19,u<'D)ʵ<Z8qíBi(AإZ >I4mE:>Qov@8M(F1 a~YJ/@ a B8sWQXҪ!3b!ZL*7v1@2xbh@)^/ $b+1ํW`F*X.lE1QfsmC^OdЄa Ds7%q:3D%&3 Xo!Y!%93qFv"'s-.a@MhIdhcxAH @qxA1R_A@A1!!D2W>!f`T!I nOaX·o'E|P8*B<ҁK &',˲%2fBbD*c!8Mz0#`~ O0F"9#cP6判 obe1jHB"2o N@c8.ETHD pt>ϜB.K:e(*1fr*-.WaL8OqK!"gfB *C/&ơ%DE ^X-s1|140(R@f|ƇA0c1BW&b D%|!,ٯI zJhH!v~ z~/_~B01:#U˝2(,"btAO0(3cnCr B'ywh2MR)>C(CDz!+a+rr2#Bo$rFb%2 -CȲ2k é ^R~2b\@h˶7&9 }F"R s38"82;s.^a ʘ1=N3?*q1Ss@ t'3 4A=(4>4A='t:BSG nCEtDIDCC0Q rCo3,+1CDso>42G}Gt@Ac P9(4FAe ѳ44GwJo2O2#^hl3l Tbvnl5Z.%>[I7pQ%uP@\V6F$f az.@ !g +G+ @ivKÉg&Pj`!! als2Ėl/"WՖ;D jnyc Z8,Q_Ը4R;t.TS{[Ekqs[ .[Q}"fPx=  .@V "Lb$2"$V! a$ A >L`B .* ប* a*x2F"V&kPH"tZoԨ0qC|}ʷq!3ŷಕ;a@!DA8 <! h@qZ!bA, !p`hR!P`R A" L VDx. g 6!l*!N@ LRb`f! !J؉8Y+c6(&e z:34T{ 1&R|qQz>TflVnvnjA @;@Bjg=@ !!@ X A -!!\"V! f`V8 H A"AZ A"& m!*ay:0Lv7x]Q}T蜔}1}Cv^ 'R%5Y*+rA 80Y $@M@ !!7aޡ@    \1#>\ ڡPfanZ ^` L +,`:#P5U6$EsFq1ќk*ٌә;Sٚ- hPt`A{ ;. :k*:91L4!"N ``Ё @`em !,` V!!6#A<`Ak7aaƟ!^,j70C"#A<y]=Ikwׅ3UvPG7z*v#_ei06#/U#bNV`vU.1RCl6W_oO+_nAE6\ɡK-Vš[]޼Wv@t\cxu;?#ᡀy7g5W[=iy36BwUqm" ,80… :|1ĉ+Z1ƍ;zXqPC8yR I Dh!T/]ټgyѦCsi4ҥFw"ez)T@;NT`MVC[t?4򤾏CbWZ t8A!KYAۙjqOpӞp9z޶4>?9N<~>(f<(Ï}Pfv!e.x4618E4qkYB.aТz(xCF>-t6Y 38Bz!@ r,!V.66m&b]t| 1]#L 82,0mAH@~D! %@00?& >h$T!x@)\с:؇*` ?*oʣ?*Ow4bV6ѩڴQ+ 4Sª/5?a?à"ʙ_ڨlYvX% X7:+w9Q<(t:52j*g6hAG«{** (yuo4:*-v'*w7[!oEwkBO2WX8nqpw-niWgw>;`Ȱk"BCrtկ#3{wvFw&#"ʳ2j{c"p|W~&C2Afw%!~˯,Ny 0)@  ` ɫZד_z=qKk [+X     +Kk˿ ,Ll  ,Ll;  sֽap +-/ 1,3L5l79;=? A,CLElGIKM+L P]°an _ a,cLelgikmo q,sLulwyb<}<{,ȃLȅlȇq rņP  lɗəɛɝl ,ʣL3ɧʩʈ @ 1R*a6 Aɫ˿ ,Llnj̙ʯ< %ɴ\׌ٜ́ ͦ @`<ƁLLƕL\>NUS5UbnR驮.Nn뷎빮^nn `1F`0 5׎ٮ.Nn56@ 4>`  pp a !P{0NLD א Qfpp  ؐ J@arI@N0 0 ``S@ ` 7!I M WP P W ךx#Ph2նpQy  ' %Ʉ} e  p0fL ^p ` kP 1P T=G7f $  pcP  4 !6iT. qU̞[gѯ8I  04@'  P6Q >Plz ,4-@ 4";5 0Ye`SB8Y'N5TR\suW̉^vXb5XdU6uYhvZjZlv[n[pw\r5\tUw]vuZFߕw^zޞxw_~_D!,P"H*\ȰÇ#JHa/VȱǏ CIɓ(S\ɲ˗0c 4 ةO;g @ FH*]ʴӧPJJ*"z,@ ZٳhӪ]˶۷ f p LÈw4W ع 0 Q1ŠCM{FhΟ7ik7&+ NxHj<஍C@([bmË$"(7O/Gܣo\" q w5Fc B5X(8@XIh(TrcNa/\vY+@I ya b ȳ#Bf\B8W1¤]* ) "Jrep)y∃3 8H硈&Zv^| g襘fJX{^̤TQ>NTvN hy媪jЕ+k$K55BVvzyk> ȓGM:[Tyz5: ois?%t@53Nl C+0J×^]f1wk,+I4KKtC3g3`\oƺ(H5y<2E+5]Ct4bq40Go"BWrξb,L/2 2@l/M4$O^H2n/[+Ff"S.S827CA4UJ/nYP/30}U`n0*/8u)Q;|6Mոwrvۧ@4ۖY`h/(= 0è.œ44  ` ߇<},@ز,2@+ Q- P E`p]4?tPBt@^塐 ZXfCpv4;Fb't)nc a^aÌhŋ\^ 3 F  6kX :nGJPu€&(޹S:5"4@ .u (2@PCOu)>d:65he54EU 8kZ%Ӂ,bݫ`C` .۪&2i!(a.h" i'd5BV%@*Jt6p%HVSE m-Z& D-dQX"uo r;:G&U[MXͮCLXu]Mł'+/ /|O^Ey ByD#db ~4qf pᩁd&& ' 1˕GdBЄdT!B 䣆X1+d %dقL0B(yKY}D+뻓%&I!1*B/nq@jA H@!=/ P!0:?R c8И4UP,:А..DR)?tA?G԰T w8vfu#@tl" rf[AF` \c^Ȥ v7mo>w׍~8[n.7XA/NR A6Fz+LqGc‚"OsFg^zo8,<@NzBruPGbsuGAz~2~cԺAub'~vO-/xIh )@vAA~Y.񐏼'O[ϼ7{GOқOWֻ Oc({Oq};ǵy7;* 5 $R|Wȷ~҂~oſ}_QEg] ?8L=#!H8(  (o{n7W/SaE$5 ||A/a.-,\*)!p|Ɇx (A A(/&AևFH}⇄<}'{ 7-%P"[hb(#bH[|dH]#$,$q^]jXsVxowkrzHu臁yXtXex؇(|(~vȅ|ch+fȊxHXx8xh؈Ȉrȉ(S 5ȌLxy! "Ԑ"|x,mxg,Ȏ؎8,(X8 yX ٌ iQ1 TyQ!bؑ y8i؆ $)"q8Y#0(' ɓB98ͨIi)9SySy=ȔD O);6]FٔC9f)RD4ɖZ^Xbȑw9|X*m@Xxh<ٔX ɑriy +i#iٚU9ș٘隽Y ɛH9 Ĺ) ,#~b0)膪؅i?(-螜1(3HB3+h'1韥Q71LA-*|z||~:~ڃ!2ݩFX~aT1  ZázÂ4hi3=j^(6< WY T! z*Eڣ2DYJIz,Ѥ a*W?*[*ٙIȞZZ*ZY , X}8z؞# j חz?0j_q,ʆ!ɟ9Xĺ}ƪ|ך*ҺWd麘Gx*窩z;,+ `0 +3 ˰ ` JYfO a}0[x  ;07  dd *:`VC(zڋ\YiPy`(  0Dr *Ϡ ` {i @ٚ~As_jv[K]{ihp 0OTڠ `@c@m|` ]`1FiWJBM `cڗ${7i(h;`<`0K>tX 0 Z^;+Kʻڼ{#ի כ P!;`` а Xw2˖b)A^ǼKq:;K PX!E+ N !L09&\~ y5LH68:|<KK`{۶᰺ 0>R\#  D/dZza3ܯ9y<  kO$>yA p { LS[sx" { >@ o_ƤAɣZ\4,"D[ʧ|Dh[ະ c k  jmXl: A` ͼ$x4ڬJY5˜J O4p ̷]m> P[+,` d mk1~ˉI"ԼT9}r9"yұ JNPrJ+ ۀEm8,I@QLѩR\*a ؜o‶`t]0_80`L~1{%[  g;ݜՆQU\ k̦nٵb˭\Dж0!``ڥk DM+ױx,k0`p3zYlQ+1ꓓ}-6Gȸ"L w=ɰ R׊]EP4 } ѓ-цܨy~2GƖ( m@_̷!K23K E D 'dm c[ɼ>˰r1߫]δ' ;10.ifK<Տф^ιƎB1nt*-ϐ m > Ī ʠ  =K-N;Y@aם_\:ݐ~(hm-zc=> 3) Uқn2LM^\3.!Ʈ ` ?mYd@ܱ " ِ t-YY_L=?^㻎4WD IJ/ ./hoE>`himD 0{5oPɬLM~>X$+(ίrji_?zl}/ oxu\}D5ǬMǬ @o߱`ɝRNn*!mo:Jj_ݼHci0/Ґ0ܩD,<DPB (D*o^e|H.E%MDdE-]V `Kl|SC3ʏ_PBU]՝Ʌƨ5^Y c['/ `^U| wQkcv;7 ++$y0t!͆ݒ 4uG8)z"P@GMimzm´XZ1jmI X0c1ǜ1@ |pG~6ǨtI4iɠMZ `0ڷjΜШ;GD#|GAxcNZ41[).{џ =PU~a['wWov7=40uq%8kFt/  _BfZ P4q:@Fx/$} hQ ]*x3T:g6ptm3|>+n>[BҪZ03 Ї?dt솰@9ɹP~I\᭢%1H OD5j xL}|OK9D8#2㠆 J65(Yk#>\5;4Ptr>Ɗ>>[x9&$oOh.{ћ;(va. l y{| >ɩ;0yyxukP摾>;1ɓ=bD=lA1jqFoXDFn 8o4!bӰN\{jxFgz1z,jǽGYGtȂ#vɓwR 9 ƃ0JR t8sҍ*KsFtTtΆˣD KKe:0kX̷&qL{Є:<\RAͦdyPC?ؤJ$Z'P#JdPPQ15i9@A<=F@Q_Ў2rGq,.+:] B)j'~p؆xD)$( QCdBP L-Zㅰ@ȫ8&a{ܜ ;B fB=>T&C~Xd(C"܀к}ڻs!~^HSQ[p&f~x;NjAP;&K]e a.Cr[rڋdKu$4jSXIkL7S3vp/` hcXi 6eAxp>ӊe Pu ,^opBӈc. KVP7*1.gP*@y^h6 $Z4tuvN"DƢ{>sP,␢ ɈRs [2!gʘ_PmpfF"5M-CƲsQcvPVF^<=/Mgtk \,Ljp0L‚.,Pi({lGɦ-xl&H' 7+:@pb널<cF%͜EM5n ڲxhBc0pgxD`1 1YՋR1FY6ZVd]h\ q ~h_ *2` >sI<#աA TL Fdg el6C}Yn0_ܘG&!(bh_A*%$% ҇ Ԃq?E!^ (ϲ$]WvJ Ca{^Z Ȥ=3 -0NF7(x|jr80{*,tJi G| Egtst+\Wc<--KUxs= XHofCgْ=Gdkh()t! ▄mB(SJe_f5iW-ծ^HnoFϽ2xD#cL8Y7`C a%vc@) Se9WaxaZvZj(#Nd6m䦛PpC8 %1>1td2ēO>hh32DS^D7j8h#%rRfUy~4+ښ{,£ϲ,2j&b?ЩCD ugĖ4hI-3(V-89ď]&?K02X6UMqte#V%WTbF/!<2o-4>H_%f-ضDd|֤ff5 hd!eQEuF耠lOWDZZ 0L36ģMm265S&XmQU,.݇;<]ε#VFOʼX5tg#$DqP'O;`|ju(^ݲuc J%0.؆4`!:dp >(e) ŝOʛo{6!Ӓ5mhC=?N$q[DhBzp$!YHDD@ " AbL% xSL60.cZ!FX%Mcot! %29pUyVtOM1+2!r!k-ȌHyE)mtbH,-D.%. eu$PFLJ<4\llkWWaG,aGSԥ;(ZPudG0tE,MW*%@ɬ /ǒ #p"T:yK"$IK`K1fYqP)T3ӕ`C`5QM# SFN @rHvVexf7 +>mL^2~tI+BNT&APH#uLI.aI>:mXc .юhO_G(Wt݇B }\#5v *Dxj),&0BƖX$09`XY "1kuh;QH>-Hd4WkHqXWץRC8KN P@c')k~;$cl>5ANT"|qL8ɴp;qujě嬢)M(J#I))X"0.;Y'B!:xo;JfA|t!mHni2rXWryYrmI+)O]0,es$.X ♅!Ml.EȺfAX"@6Zj EyCB:ii#Y<14dC8Tjl|5YRVKc,aduV~uHBh D hxZ= !)11~t@\1 `,Tˍ'PzI/\.q1PiȃQ228 υZ}.v0 M;v!|~{ZH2\@H8H` u /j\2Bon`p!3%-dJ=0ѽ}qX>B<<nRܧCOtG]egzQjLsA2FS~-!P7D9ƇL["[ѝ_j4C@-H@4#(B&?B?8 H@,>6 DZC1%dM?J?ȅq6@$5L՗?xD(»,++*D%* <%>2䳘GÒ`Gd޼b8ɑLFT<+Z6j("6]h.37B*)B) Ce5DS-8 (FL_:6tNJɃPiSN"HI>|PB$@D E 6Et& O {e>^DC8icj ÇILZTx5D`\X@l1?C\SP)ԏ6C o QDQxB0,T1C8l#4Ba5% .)D%X'< ᾗ<Ď2`A)DA/;taXM3Ī]HD:,bU.S;Θ&_:iE <MDJCt 2ΓA= -کMa3d]VkC +L!;8B0,褈p<4%xZ<|Cjd#fꨅbdM6,pPnEh( mTp% {pyE6q>HQ0]6 om"AX>zJg5/Q3hNƐd>IQȅP[8:#Zo:!̂2,̈A, BZB#ԬՕKL;`C֨Ohq:%aND |h(2.ߖsCCJx<\%OQ|CμH1 QhCmƛ+dD/?2)}<RPj;,܂5(3zb# 0 B:L+$ 263 7'Ò$I<C6C7vFMC;[4}D1L;؀BN Rf: !X8<A>ZKTD^TWuՎ5&̐4}ZP D]ɰpm5E|; ja 0$6,6xC?\44G;`\MhteNfĂB".&;tDYSCME|ȃᏑ\(~MO{I4`;Ty P~f#rCj ?h)1L5<*:֒uzA|'/dͨ*R-9DDC0 $BqoHd:|\F&l uwz:SV@Z&1 |gECVĆ[) ~wUUd VXYn|>ی9¡ĒIPzucgF݃[y{)6-Plmz>q4`rB=Sj4E@${`[ &TaC E(aE*BcBFJą iUqlpZňdȴw_Q~`)τtj4aӉWF4j׊\'2]:W jM[v'Tkȸl_`2ջYb틱qV*39r}Qݶ~k̝;sh!C1YuԩMl߼t3F&۳7Hv b1ln;qaè} |~:l3wwPvġ׮V(1.Ti.B;KD++ tcC=DUE~d/]kF 0Txj.N^谞Sb^0x OZSt9*H @yurdg8dz͚n89v;߿0}nzFy恧}W02(Ut@u@/F2lpyڵ@bmuI3N JHF6g6:j¡m/7s_D!$.;Ơ qXL$G8ҴhІ.[SHd#l'Y, 2#2˛P:EđD08PIAe\UFI A2`$_hJNj"TJ> cx0vB2eاU>ȓemxI m#I #}#Ñ,镹?*I'IiL<|L mLd"5AC56KJrp dcXG43`KܺIQ1Op7]F:QxJ? ԇ]Ya(e-1 !BsW>($23G02~hX$1;`mkB#vR+)^ȘbiI2L*{HG41@BT|9U-JyY5V#&2FF h y ^BlڪacsuFj ΂$!a`^ b_O8V5ﴚ~NzM!wofdnq|y4Jx6"q`GH4QcMfKиrWڈ!"$hs*I@0pf*)N);J0HyA7adG8~1vxA'P~|_-ʅ"Z!wr<~rUJ1K1.YxNcݑ nˆB jb(@KфYȂfqZ%B)zZgIc23qh$wMDeUS111Crq(jeHf69!$c^ڌW"E,܃kڨ*rѽJŸ2ڛ-Լ&TƣN=M?fjbCeo<NLQ 6f1X:SpB*Ril`6wBMeԷ7J||G~31J]M\!iDSJoluzb<"Ol \ Pns < x!W~nCaw7x" #<d|o 6aK6FOEbn!bVv V㵲N7`,1 (2!J!9#~@6.F")jm! ddcNzT8,>.m!. Dvq/O0z"2aA",.2/^M䡬a$Aȏ L`~ @] &J!B*d!E .Qz%6"`>( ΀aAQ"C.""C]6!X(r MlzJ! $2 .7`" P< jaP>!M!K+ o aQE աϱ~nG>1!A`R1 Sz0$qL^)NUA$. G!0=$~  z~0!K!S&D!B!^a!'qj0R"=v&ԥlR$Ҽ~Yb26"2+|%2np dh:lMG#b+ R"`J / mo'Lf  `" b!&(Y*ll,P)C)ҲrY# R^SԸ$0>bF2䡛chT H) I\ r!n @d $[ ^HqLTT6*Gb/WqbdBXY&E  U"2  `  [ra'! , `!PxqUbbA0"Ih_ S@h" nA|`'aN~>6j5l@) 2+ek ؠ@[j"" Dr/wE𦦽ꡠ*.wjvڠfY2tcmlNsm6Z8F2k5bW$vȭp+Bcj@[ @:#{HsF^s/pt-KiXS^:2Cv`7!܃k6m` ETx(a8 oM62v ('!8U0`@rw&AllKi&(ƔhB.7iݷ[9uu~b3F:fR2$n.xlˁ9i@uƂ/BW4j|WbR+B4k8X$ aRҁRaAA= #)!Gng֌2:#hb8L V`TVe`Kj$R:FXΘ`Wb XVfF~N]WcOI x/1*f$`3uD^C8. A`p9uAڦ(Fҁ}yj7!FBALƆ9mpH3tQa ysL7B}DKXa^AiUb`qqb”S ܠV$AvSatn ub? *" :38k̢/vX: /VfNxPT:S7XrMKqGZBAYbx f J^O `h+!~guNKY喈܂)2 2'6(eJȦ34<ڼ,vk"9"A )2*"VL4J$)~DTkG,;bXZ/]@h,W@|Zgġ2ɶU >t[ťG'NiY n!H3t662[9"B!V2+3삾Աg`ߛTO9EaɑC*@FAG99oBΊ%%pGhÑ9l'^,2VCRIO~R`il?%_; `h6ԇ~;j!yBL B\e,!vA}Fj > f 5L6B{Od+ Ec֡ {H!HBP+ "C?2߼3p٢ Y4!b&h!l^a8Ua4*B_wMP?,ab0yƍ .a :|1ĉ+\/cɒ9w +X1̙ټ3翚:mtG?~:Z8=l 5ԩQiZu#5@*$D`,4UM)UdKwqy oqdMGTyɔ+[12۶51ٶÛf>0d*3vA㶡MѠJ X,d'OƍG*?uИ Ukw55@e!D)eV@@Ig^UA!&5T?3R3`^Xf}m_1h6Og!ަn6A֏?#Oqd l/]OOlLRNIeO1HPGD # GK-ȔRBK,nJ63בWAL8ᘤ&82Jvh Oc,C4s*Jш m>4)Aug2Yq$^sIəzZیc2>\>U԰:u!P%|Y{񩅦0 L\e:y.L29d8h&`(ދY;dx3i;j u4hjA:N]815&wU9<2#ϱ.l@  1D'--"SG }F8ACQe,4?n4~^N+r^KB)?؄uj&M32R/C DC:* N]w6QMB&uVq#) )pԴ,1QZk')KZ"])80F4|cEel^Ԙ0jljx/lHP(D)d >qg < oP2z !+AbY1 7C d*!ãAl:kNBS H!ԲuG8b &b$#uFpG;5LmX^*IE6H?W `jlD)J9&:6y_&iR9-B*aXH0!ɠQB F"G> $H4a2 q}!0`q h ĊMFP P'eP `A/D͈m(%Ӥ1$$Бy '2 >0` .iI%a PI#-3Ȉw36Z}S*"Cb> JHٛ [IZ  I`  0 P€T ܙ f 7 Ӣ0ʣIJ=$XF#i{:F{cua+B[j U ꧜Ȝ= =9/ &15 ǥBj:17-JnxJ9D6!?Á`28 D!ȠbEƔE@rيN` HJM-P&?֦ P Ò<p x;ꆆ:}<9= π >2VPL>. ?Z%ʄL\Yajng P} 9* )xB*) !˲$szJţ_*9K!%d0d -KK%K dUiY@|`  WJ@ @ p! " {K1d3 xCj,:{<ڰ 'za|N˄P+A eY[G[J7`@Y:ЯS[:h Pk6HV Z&qI) "7Lquh az狾๺:h;\_k εc>`]tRһ 3c1=-[ȫ @{_ 17/۾SI K8#c8m ) PA@ -3y K )a0 ,J:%џm0m2;$ou1S,-۠;Pې!x䤖@F൭kz|M)' `~11bPNFR"0 _ 0 U 0`uQ9܁ Ez PSM; P RJQc,c|,lp/(lMkVv̾Q 5|WU3iᡇ )@ Z)Pˆ1_F|iQ͹W+V>v (㨐!AA״!JҰI7A?~{Rl[|ɘFoB%Τfu c)X{Ijl&|?ܸ ˀ e D\,VuӠ/0IU|N>h͋ɇB)"ѳ}!!qpaS`һ#2%,ͯ\%T|x!Sa; 1 q@N!KK 7o ;T|!/•7@ Q5z" 2u1d-20G^Dʘx=6/^t)S4Sg C!ُM(yLY ڤU0x@o p0?Sb ۺF' #2s<(F˶\0 +.RYYÂIL; Q 0*,0m?| ͌*- r7U;x3 !&M, !04t)Vrpev8&E Q&o!^C /el;x5 pa]aQ-s6&$W5RPȳM6 'P p!%QbNͮF Ґ'p2,_J>9`aN[>` @iH{.2Ie~<3)~>P  ,冀]-&'?nې #.Lcq9ʳ=sw>~ $76 ԡ9ڛ~M\7me);f\N`  ! `bźM<*s"HdpeÓ@O.: =;A`3⠂&?(MRm 0 àUF4$VX6֕@= Pv_@ fo0]ɴH3o- ÁP+%5GF}Ԩ:) %OCy6A[0s 0''ͤ\~9/}HQDA/\IKXbM;fs!.O}h;2ۖlђ Oe#&TlP]lj9,$TI :iB q2pCπRvr*"p6j(CsP=Qwn9RHÝA82h*/#ELru0$TBor;W؏,3Έ^nm/2m9DbĆy9*Sу6{R&,*.F֙x=(:JךZ--9vs\Cw0w3eDƼ}}$($y<+0 bR$"xGXx՟LdJhF*lJg1SQ>i,&ҫlydqfZ;1\~0A˟1]u e+FEJZ e!Wk(!o_)n8/ H>fq,*uZ@0 [<|'=%!ȡ 6QQdH>L_#e/8e7&wM$+>VĎu@qXF|\&cZW1ȴjjY=ZԉAK^F^%Ō2&#K]*"Cn3W Bqβ5<7f֊ gDYȢ`GG]%̍eF`r95 Nӟ~gn<70g=Rt{4`#eI#WcHd7@)@m a028e#p1ю/xa>0kH2em~s\2?F7 uщ52pvӊ<^\%g<28 qrZUH?av` G ~gy3Iu>{#rEh]룃M:  ^3>}@6kÒֈgx<>A2^K)OSe1B-3Xz'+CuybCk>X{;֑xr4^5yg?NM矉-`pmխ3$be=v[ &C%xamA KyI :KAL\|j hw{Y@yh@7}(~ zm+t)A.B2ػ0]+%1%PHg~@&3樜QH@!_;j+02QgxpekBODW{ZBC;6;Є4VgkH>D 0mHDc;:پ6#x*gxh l EmC;Y13? 10E8:eq `@G>Ba( `Bp*#r5u@c,Rd0i+F\U. \{wZGqYÌ#/`g& >5 H3 bky2۬lȆ'w g؞k!c:_G-Vѝ}4'sNHOŹTIKLۤ iPPx>gЇ pIGc>P Շy Rk llx!ViT/41UmSQ{˿M/ ױA7AQKd 49%`4<>%Ef vH|(=˼il2 [‹z*qS[5ԽZOшX='륆@E<|x e=riRDR9TTKUDUW[*SpS~SÈHjȆXx%Vduň8 x4X7;+cl-SyE 8ǀcF5hq5'6ݾP%֒0D[PMΐT qPk`s1@љ jadžl?2h.::5ΎF8Ac]A:˞pFmqGjmLدy߆^ O 7IpPhx@7l/pwȈX iQ؋21`ciȦ (y9⚤l  m0CEQ@FyppD?mtbyغHVKN@d990P*!bQwxȤ0*R8 /REGlqtOo#SҦvP THPMb~D͎0} bw`iXo_X `[fgDZ:]vv~i2 rS1=A9^j&y_̇ pHLiryH0h}H'DF(;hpGd`eyrZu00YɋovL&(ޥ{{{{ -:/QNH)ȆOxɑEK_iև`yCb;_ӛh'J? |0o{l]Dk'uW<|o. Fowˡ6~n//MhMEd=cmQjXh\Bګpǻ` ߙN'V-˛vqH&ovmH_† '1"dI!ǎ? )r&CGr%˖)UȀ1W=|xqCnK&.6.Q"?_9-)8A>o.g9};XBeHԏQa ]7~,β+8Z!u$N[3G6a4 &Hyט[H:$QĤ(EӔWb%K,BSNA%-^2q7!vn][yẹ F8?\VMQha?C^44tb۸\L+&#eN$? 3E :i9Ԓ5J  ^g'a"]RG^S%tUVZ_Hmz$(iMcL`C*~Vҁ 4ӌ1C$ &[#nH* 2\398>Jd&Jg۪ ْӄ+{:I WpvȂSIh qЅ'Nz:O<3PoRFX!3=иS0ڎ%mP#<6{m̑ C>:8&D·&3;|X'59y9,4[G獩{7t[oqНU00X?Mx(훇t``hc6S̋>ΛCan~;5`a8~GEÍl:yX4[./O p+v%g!Vu'7͎Bc(@ N+rJLi 0^°f̓wPH<=!ju^&4cؐ`! d}Ϋ `~" pBO&'/⍁ީRk7:9Z`'7IhI8qJ1WK"yiađk( ڐ~jG8gd )!yQVDֱZm1-"2GQNTa@="t$zĞ: G">MϡA`-#!$d|5A,G>q CR Ub,`W Dd9ZncAj .@3fI.摘,,eő(M%Ł˝4 a9 eCGZL_ qCX^nST$fDB!Yccs6%ه1T >ȰTh*דzX.}K ;DF[666 G:bjֈǭo$.*( ?|*R6m"6;6-7"N6@kJyn-błmqTn'$9Hv s*WDO !m Ҷ-?Bƪi_k#/0L"Ѱq܋!9/J[p 7ˍh~ezuS"A;=)5Ꝡe1/:$A΀C_KߴgyoL5!PWDs }p5+8U]W0K;?1anG8V:xsgNl_qxZna.sa>Z1 W^$'Jr& m )])u@;āX[D$ϙ_V]sY`Ҙ=͑TEuJv08Pյ=__8BS;`46M2 JRDRaSX!Єǟ@\tQAQ a ѵ3hDHPB0LAFӡx<<f!Gg91d#Bb$J$*^yz[*YL"9w>2A{Ia=ԃ2`fQy3$*HoHY#vb11"GܟA% )L"LmZ1 Ca I$eH4`;-DH A#A`ɃaT.&c9_?d@fz_i"a'vth㨔c`Lc2g2CJMCAÇ@a;@HBJn >a@MZ!Adш_/TRa\lb c,аKjXh AD̂C8L) AAZL1W\%|AbbB-B %QN!Km`6?l)$a F1iV&#WYp4u LE-_M~$G=T[eelfԠ,&%CXqW\4H åTA`,oDh֥>TjEXDjh`,4tHaCPniZk&PX|CjI*z`.Qo VcyXx–Qkk]'`3Vtk|#oڅL'&oͫʹ~k&>iN_e| Cšg"2<gJlXl֥Q{ɿLBo&(̮LLfHxm]Թ+k/h+Bm'V]h"eֵBKF(FcAhƋ&׺1*m,VF"\(؊mqLk*.$f++-V ^I.nƕZ>b,ܬՂ6DDqnM پfV $.µ$~vn$%B0EKX.@ڭ6oz1>/H n'Jo?eޝvEBK-bojwb&n^fc.KQ)ljNn!։' 3pvp p Gp pB p0 p58YK>- /woD\avggvȶCp0q0qq;Yd)Yڱ*qu0.woToH Zkplq(25XB~Z crvM5 C&g2'q !$ (qJDI[  U/l!'I+43HХ3H\a 0Wa](Ma&PC,T5XSKH:Ăon>h2 D,`0̈́L gs(qCP(2KG i>BpH|BZ+)D2$\Inu?3҂ܳ%"q-DEDOU_NtOOuP uPuPt4S'+\|-h|n5&A-vDJT//d:6&0{'2Bͷ2A)X"P@>#X] L/*[:)֏m@|C,=(A1<, &B*A0(CTBAe #$1Ȃp +ֻIzBB1(H/<\4X2AƯa* 5+Ń' )K)\&, J yi"75p( Я_ 6tbąH O)`J"KI4P:6ӡd  ~3@>kpjy$ BB)LhTQYdɃZd9 J ??^&xx'Sh\m4I(9jq0 ӧmn#x^نJ8&g7?)؈jB+KF8dbxlI$`QYr0lJ݇Y>4Ggh^Rhɨd((GgƏQ'wDF7lL5m3DI' f e^M _ #Rl%ߠ%^`bgZ!U#A)I&o~:m͒Q4]R z%Uyŏ izQ.AfWA&F2m`tlʶxJ:`G ҇7jf|dqZ/j|YOfkh\k}}&uΔ~1Kx!7cXnW|c^ߡY.~!Nzf[D䑒Yekj`+ *G<^ZdOO)䁈L#MC iXчe#" :!3$臍u,_QbL(g)_8f`{6i#cp6@(X<8?֋>oG>~d\TiNcV#Pζy 7 s^L&u)[_(A9 C}*cY^?WFe"7"B4 Q$?XE"> ܎+Qi"&FZ8%V7|1G,ː!0-+=HFҩ K`ا &LibD1-$IbD1q." Mx.<|~0A`#B@K' )rDvRټ(FBҐF3@ `)R{S^U##@ u,XH(dUw +%4lu]U' v-B# mF5'k)U|N7*cv{]qQݷ!'HLn5g]kW\fw ?Swϻf3',!'i LQcs<k=$y=Þyl<9VEt&Om.C tQ3"WWڝޕY+ІcJJ&X9zՒu?Ac. Q#4 (g$W>ƨ,*o i_{y{Ѹz>q={g[w-0a< !1w_~|l%YWE/`Ϟ~P0l+Aa1fs,0 C!  p@ApPl@ 6P(L 0,`+b QC-*K4u(Q  +O*O7sR! @+% &|! ,`<)" P`f `,!,Х !!  f3LB@HAN `$ "`RhP.ZHS7CTDX3~x@b6pDkF0%"8q!\`Jb ! X@R A At V!v P`+b@ A F`,`! N$V! Lv̡ ` a~QCr%^FGTEDn5!EKP!Eb6nTsUW/G!A ` ea <"8:@LX a BA @ rM.b`b@A`8 @( Vaf@ `$@L@"a20"hqWCTO8$Eqb @F͎FEfkL ٕa>L@Z9AVa!5F@f'4IVRuU1~VQV'q!Xn(u)AgdlSnl V 5i "X@ *a(Z t+8`V ahnanR r x`a$m!"8pʾa"Ox6,(@UB^"^6fM'L9F! ,X!@,0GL Q`"!hctl7l8B dNQ3, Ґ =! > |cYR%hx&s6peYv"tQf0Y}23+Wa+, f " T\: ԗl "Ё |@U 70.S`I-@`y d$6a* ! "Y!!-a7@ j1!FC4iE_͚R!`VY5dTRlfV$7Thoz:ኴhaE!{AoP dSbgA!V6x a+rc!)hAFa$Rק""  ~8+V1HOBMQJẄ́w=RZ20:FAf⦑Adiup ~Z31RBK`$NZ"`jڴO$G{*0:4D}LF0fH"-LD)XP['X|#-o"RLb{|r;"Ҏ%"ol;ۻ:VIۼқ۽[盾۾[ۿ<[ $!,@~DH_xeÇ#JHl3R@u #(߼t 'Pł(_ʜI͛8sɳϟ@ JQpAŴӣPof8#lT'~d%͘QӪ]˶۷pʝK"P F)8po8f*K˘3k9t %N㙂G05۸sͻ6E%m:ퟱL>УKt^cT`ɗN>hvK6J6lϿ{=ŗA4A F(%@XGZ@]m;5l,ebmH:@z%<$ @)HQ2ND"cM>~xXf6mC%)DC.H#8YĆ矀fdu͡.QeChM8 i%HII'MPGdꪬL׈#|yg뭸뮼+k&6l` -hMTNJ(D5 Q&NZiڡ@)MO(%b(Ȥl' 7ye[tTlw qa~ӟ3YA؊@Ax2%eԬF^Cf5 a 0GB&E!)Z3XLӦ5NsSp|tQ\ː`3!80٣j˪"b6sa/7 zՔLIY* YcbE1zAa, dCxͫ^׾ `KMb:V@4zbl19f%PI8AIT`F[3nԮU(JmUERj A pKf.t\E-J 1"<#R8R ߖd9P7)Ȳ.wYH)Ta++j &Fg8`5*h1`mSzBЈ.zdQ _ |f zS( GMRԨNWVհgMZָεw^ԃMb+s5d1Y$cØ2!ed1DR˺֡P`0>vnt-pN!70)@ħ q( ~7~>s< @m P@{8Ϲw@ЇNHOҗ;}6-_LȨ2Ȃb;%mUR®d2y`Q!~ȃ>8wJvˈ:P$$<d0]hbxCLߩGOқ[<@C! 'ːR B* 7>i{38EO[A=\)Obͩ$>F` 쐲ILB>8(X x ؀ (8XHSC U P @ p cKb{QH34DR.E ae`6M`&fBWFxHJhZ^eKxOReE =Ǖ XƅS؃Xf`| P m0 0 ̘PivI$鑊i<@N銴O9YyșʹٜЩ9[I Dَc` D ZyvQV 19ٝљ9ɟX8   Z i6('(ɒɛc&z(*,yْYZ) DTpycgwd@I-': PRLvX r(y,)W:, NPii g+*)JtZvzxjȉةI 2=:?QcCQ1e6%iZI:Zyzʪ:it y ut(8:Jj IPg9U ; ` J p:٫z蚮I٪9 J LzLJtyDuWYW `8 Jt yJ+۱"+ ` #,۲Ě@ Sk yi L'J ڮ'.R;T[V{X˪Q**\ Nnzt+NudI6ʮ]10 Z][{۸z|;; }0x zxҪ  Oi?YP ʻۼ빗kʸ [ \Na$ׁAU$Iɰt80 b@* DD +<\|>b4[ 6I Lf @LpP 'o?ITP |8:<LЮ{ںjÆ߫} :ྒuN`SQ;=jn̼e \lP fy@e >oIpI@ ?ˆ N'oɜɞ@B=D]F}HJL=l@ pw,R~0l0 vJ `4>k4`ϟpz|~׀؂1ݵ3=yѢ _ pׅؒ}No`oNؒ=ΤP*{\;jť YADRg&y}ٓ}ן -љ J۾=]}ȝʽ}3 TleP Zna`U apya@n`ZN@\4I֏ m>^~=θ2ۚߙ a0ے]+ `x8zũMTX֫ۏZ ] > B>D^F~HJLNPR>T^V.,i[ \ \xmL\aZ xl8߅ W>^~8 Mm班 E^i۠Bߏˣ-/Sk w㶝㏍ @^<:麾>^~Ȯ AϮ0 5 XP  P g . } pۼ>?_>D٩5w= a@٧pSc46ɍ ` 3<;n4_68:ogKidM BO > i@) = `QM;^`4>}~=i- 595Ait5)=^0 -O_ߟfKM֏?M ok  [G`똟 /}) 7e LqA4'`5Dk dz?_ǏI% Ԕ`&2ijIk i&Q^Q dGAePJ-]SL5męSN=}diIPE@M6$'&&HU14E*իX~L8qܾ-.\hŊJQ@ J E@?Ydʕ-_ƜYfΝ5S hңMFmڰ%L [ Sa'YuRʛ}\p+O<o 82_p+H|H5 8V%w&vqDf2Lfm0*KxL"UPapL!f-+nTހЂ̘H+Yz1y‹g>O~ӟh@L|E(z'R*ne @#0aC̩-@1r̢]:SԦ7gBuZt?5B Dnx)G W,K^P U@#9mm vNto1'NպVC/*h8[e]k^Wկze-;XhBm_X6ֱld%`"jf`]|iA[1ڷcdEbQ %!A: !Rv:Reڮ׸E['5!Blt#.zºŮusj4v׻oxKEUW:"pFDTӊ U^ $H-xDocu'vvF-&'AeK=hBЇFthFt%=iJWҗt5iNwӟ516ytUjV3zse=kZֲ~uuk^׿v=lb?%MBj@"O-nDXs7וZ̮:-Vo:!p4o8%>qWxA n?hc? g\%_C=s79 ƭ+Ӯ ~KghV3HZ[ԑouaz<ھsz #\R:zvdm'v>׽;w|@ ]rų:g ]<9|5@ò-:E]eȠOSVfoTDE齮Y7]^x5l`#mGs_ƣ_?? g#?~?ԏ5opL#נgHHx4dt@sqzA^8v\X_{{9Xh8Kkll>H ᢗ^jÆkcBiJDjiPMQ)P dLK4@O E),E)kiElipi_PLFLdXShijklmnȃR@v@@t<)ԆpAq@'\&Ap04C3@B!,B4L@[i<(dȌȍȌ Gjr I%g/U= $@>|8DYxY *bPYbJ@JZP[h>HIDgxklpib\DXEQ FxPd) b,ibtE F^L`HAk_DfbBOo@`LexO `~?YHUDp1kPZ_dQM_YH^xMY@Ժ:xNiȆilU$%5F;r y ]HXI1Mx@ #s%p/"bbR0a\^P[@,J_0GZĮgh kDXN]-O+kt=dL`>LFx3kp>;3atFxY[eb~8 `(UkPdHe`d(Y0`TXiLfpitP%0a3E.Zbs)XiPOiFXY?LYq(lx̵MԶu۷۸۹ۺۻۼۺU UE;`f&פMsh(ڌfRfp7`XePŅPe;p>K1؄K^ee`axVx[ELd]ڭHH6j((odeS),i1bg=eXE]Ђ0 YĽEUeu_ueserW7?|@)#0~]0e@YXZN([MGSePuXl\"aXWf+VPXSCd4V4=O0ixLL^صui RXYU5ce*txe>VuaE xS(5789:;<=c:Ldx;\ff0ؔfXHmwYM-Rp]x ]vFb `kP:-F"^L>-Ft1El^hh bP ׃H` 0d (p|}Xl]ka m0e@Ԭ@fY^ZL?`da8Dwxygy[_04t Pa8ɸLhB0#"C} ~u0epDO6pB'`0Z&@ZH%h TX@NK\U`<S5S` XZ0ep'W?=s8*XȂ2pd8GHUoP0'H`(OW 0(00hb4~0,k(fx2؄bkN5aaz&6F7.a: {XA&_hS؅\7n82HnY  HHh``[KOxkp)HhHXfX0*(wh&X 0Dr5 ݊ަQewHHBv82xXp`ɮ8_xR8_ Z()\h݂̑UauNP>f] jM(C @$8sDXCfF,Hc ݤYxO@X0}y n02X6(ZHYJed (s_cww;[qU}v&'Q(Ȅ :yu v"0Q_ >H)I"C0h p70nBP0ch>BkiDkdi hn+Xf\]whi~7n`+uahIv\kop?@X8|R9D*o lW0%$KbġS1 $ʔŐ!Sre˗)YʜfH8sĩsϗ=}3dvfĘ&XOvlj5@/^Z=9,^5c 5sbs !鐇جeƆٺk˹ƒ-$XbY4iz#TJ4bLt 2H ! b`90d8A&leѲ95 Lyc`uVucqT-lDQFQULN)Y~f΄ndd>ӯo>'Si.UK\(2$ 6! &/R<CU@?X #TEK-䒋2( R /Ҍ @۽vlM{ /b .UViaU4'" 6D$\3Tf2L#5(I7:!:q‹382A)X/DI%rAAP BgSX$-C7k5YI ;,{+9L1o̐/)E`C 7`X6 (@Ҍ' (Q\ŢR0bK/ayUa,}ؠ'R CJPdq Iɣ<@kM,)1ͧlDDpcr/ĠA+' P@ `iX 0u,]{5~,pod N/=x` #h"uM!&8"$ @/K(iJ{PҊ a:b 8,TYiey$^7'H'e, @gxiZd)^:1ǂ4%'y nr +Rr-"Gs lPD0:А,S,xE(s7THz۵H 61`|X(' eL%L{!O# B!aآ8L"BdBL`B,||LZ3pJ cV-!@,aGbYbU1&f0 N~ pChaĉǦ AS 0 k<"Jfb(00~!@d\a)KMr$(C)Q<%*GY 16YEo$ *DԷ]+J '#Ltx,8 bpM* ep FQ 3u>Ë0a Eչ= 8,Z$! <8kZ7ȉIƢ T`Wf0+@uQd4ݐЁPHh#ӈ0+ۨ|(Jt'ĮGjRj@gdM' R)ƠEb(* x+n Nx, ^Q$3A02G03K3n$MfчbpG4Dv-$Qmh4l&xrġB8QqV L  W07aY @F FBp@mTr.xv&, DK0,M{7Vx!RB -b 0<> w. Jx N`9A= <;N(`@&hq3NRP !9"_±J07b8!xh-bq@NQPia2fCl?3Y#Fp*3=~3-AЀn ,쟰Zn&j cb+hq- r2 " `@P(Ġ1U791x`G0!^N3k1:`©pZ4#9@ 0ehy ^ע`0G+ f"0PvtV2 @%(D =p F !b(0" ex8#.S82|;2}{[FӾ1'ċahx)Z7d1Z隍1scmӐ:,ZDPFg e(;a XDCܹŔ[̺)ÍeL~M)L[%Eva _XVv 21!cj:'LQu0H; `^B9bNaԢͦx2ҎUXiWưFDð:U$]-C[-y^0\V^ fn v~ "Cd`Ǒ{eȄhU0퍈W AU`FhEUŋTZD_-_PB A10hE.Ԃ/D2\ H.ha.Am_ы-̂%/1]La$`l^hE-bH Κ/B@/B)B-!$N"%Vb%^D"&V.ޤb)Áa0biU0ϋ0O”^@ )B ދ͵B/V^.'jЭ*Ƃ2j-/`1̡2,\j"<ƣ<#==#>>#??:ZU)FN)V^)fn)NhBN1pH΂>%T&z:gsz^ [V'bgvgtgPUjEba)*g9dQN".lK'bvbeKR L~****. D *F( :"iEV8t(.|h"j6c&`=}:a\NIޏ^ߒiC6*+Vɂ-&V"$|^iJ$*#h>!ȫ'{LhM-H(q֨Φl:HKv*z&"˾,Ƭ!ͬڪqZp*ab "*M6_ģ$Vkh=d_V4ވ2c\d%z̖ٞ-R +ܫ`9d޾Vi F$<J~VLL,ž0ܙ]\ZjD\ՋzϭhPZl.>"L/ZilV|M-Ђ~ꢛݞ^*.fdj"c"t^z-}///Ư/.\|Z- BUhq/=庂*pK>34G4O35k/Ok/U̒(,38+739&RE3??`d5?73BmA/4C1$Xܸ;S;݂,4;sC4HH/36ìorttB4#4L74JoB<E[E Fn4ML5Qu4SHn''ۍQC)KtB?5ULt&N 2˦c*uqnUZkIwSuTKu85]mHAHVtWOOgg/0#0aa+b/6c7c?6dGdO6e+6b_6fgfofWg6hh6ii6jvj#jkOf+!6m3k6nnn?-ė߮LB_#?4s?7tGtO7uWu_7vgvo7www7xx7yy7zz7{{7|Ƿs߰.Bp7;qcI`&.4|88'/87??<NUw~~#>4C888w7#LzYx.w F<|&.0B縎88yz8~8uXaL⸐GO9W_9k7SxU@y99yo9Yr{99zyx9ӹ&97?:G zz":H:x3:t{::C8w:WKU(z33::׺ߺz:'yz8PCs:/;7W:+7w:9󸞋(<;z˹9(?׻{;;zU㠦;C|C;7?MUL4Wz Bѩ{|'C<ɗɟn@@ V{8ґs= |{7s>~'o~/w8>O}s>˃<O?>W?p_?AU8$)nf?go?w 0Ⱦ<:(U?6WrS/+|UXc?@8`A&T`P !F8bE1fԸcGA9dɊR^P%AjLW.]&ҊP ͈KtQF:jUWfպu8_Qn'm~5[v?q9ϬHUdRMfpaÇ'VXWԍ k-o'o<$^E!ahbj`֯aǖ=v큎ͪe2``Ń/k%7F8pɵf{wv۪ݼ,4|0\%cˤ -510,tj}'QNv clPiYƇoJJퟁhEaQ܇ǚ + Bi Q:ht*P@y+R˅|s,( Y9y( GyIP;T)Tt>mvr%߼zɫ7]C^0҈CY\p4YItPlqfj?o3g[X9& \ >o٦s8wp 0yXgO5 (y0f} `pG2x!J ZꭹڥCBkYEYrgx ,pęIƊLQɫZ}IY Wɏn騽;КZ-9Fi)ƙAX8@NBiLZUfX`Q!iGqv ;w(+.Q(N^srVxy09x׾BA7Um}6a%Kq3kqkၤq3G5Yn1/(0F= N0֛]wU ^1 u R2qCBK "? l2CgjHHࡍxpX,㤧a*g&RUWPEq%v_*TI! dDxӂ𸏊Pv8 -C³<!ۥ tڹ!@FG9E}ܓR^][A\߁mAcMC)X*܏&iGѷù:L:ȡN{zAݳ^wc8eG;ΏUuY{pDdލ]ƀ/ /zc2a3"J/a 9x CA8~F<°;rq Pp lP^ ~DAb*Ms *qʴr. nd@ 2>DLDK|WRq+'c1N%XIp 2  2+y0kk TBlg܂茒Wʼ$LܳCPl,vbtJ. "d"^`*/ā EsD#SclzK0hPYX=NiU6C-:4{ ? us7' 9H` &t[4%f3{oRFAGaA/B2^"N e1o@#jppGmT#zY8:COI2 %mR쪮*MO!2ۤg?m CAjZF1UU%V?EVA"D%AdINuCATNYXabrlՖu'bNu|tUMH+Ͳ[?MQUеm>=c-Y&0HUi20M_pE}`*r.a6<-t)b7 pxC?:A &D'{^4T q_i_]M,ofc ` $7uDzr"Nʶj xfpVDEm6 j=cwACd7A%xRKZF]6C !nK@ vm?"nFVEko'uo;HI&pYbp } A%@cJF,XbslLsm1T/Eefчdem[VYԹfEv;DA$tH%3h E%>p(j,jXu@8AEV+Z6t#N=7=utgO=+"fa3w5fzWuv&"{womIw%NE i^ L=@.`BC"8!|sTMcVQsk^7X؍FyRW@6oW.-x u÷dԕ 979#G)E 92MЂ1‘A^e-HB`8󬓍󓹦jl?÷ ŕbB\q2T,$ NC. 2J BY"FZՒFXY=XQ7f[F]vByT9.BAmCb-3 b7N8~ֈP9Ph!JzTzIկU3Xsrl)hϕf/[xejjM@L9`20L0+7A X䗹q5Nd\b)p杶t+ᖪDqW n0+:n"DX(|Nia!i8p"~NF"@F<<ԍw$!mfmk*nM]vL"ء4BlۈCLg&Y^ޤ],G;õ}_A85$~x j.ެJ+u80Lfy\zhr=j>N@>azgnzϮYa.U޹s۳p [& ,)"WC]ѧDMk~.UAbf )'w-(3x黥%%HTBgV-rKQ|B%:$|=A7l &f%f} .y߄YS_ BY ?!~_+`a8AKT.G@0yK&ָM}B?gCACX8L'I(w>ACdc)#Ϛ6`1=9t= 1w ;v׮Y۾;I۶g)}SԍˎE%d]+ۈ&n /s(+1>,î81vjt0JMuHo3O V; 4cd$4`#4u2#fo8ZϨ'N?f]̂[cٹNS/xEӏhQIzs!\dA 2S REp^m]c<d+>PlQMs?| / <%ΜN}WaA'O]vDj&S?Pqea?L j`ȐEA?/((5e|)%yk?tO,RGp;' *BVֈG;cPGhd$c-X+ɒ~3$ S 4EJKuۘ(ilvQPm2 N#̼ jD EK!ǫ|*VF$%JiO21FM|1`R  C!eF4*iP?.'\Vļ䥉uBMqÏmQ7o:a"|0 NB1Z(3PB B 6 EeiKkB*x$t*QDAU~NDQ\$ؼP>Y0:&%a !L8)IƁkи*ƕ4`VU$gSm>2p8`0iZ*ѻ$e"\$+Jwj3 &NBMZEPhv)3IgQ4|#(4PUհ) ZEF="|Aj%]q狤B7=faa0 D*75H"=Qhq m0yF8-VXc[bkph7dZ0$ cjΚI2w=kӇsjʆw'Y;u<9-LǔQhpxeMG@>#8"e<2<x<.JxSf W̬&8Q,ĭHe/+ޤ$7ӸThPa%џxPD;x{.Jd$yfeG2m FKx kAiW;f4q vM)g{kFݵ&aT@I,Tl(ÞEt ~m5{#CL\lc*}X"8RXmgΖLyI%tBao?[f=vɄ8 a@.gD>m;0x|{>1M~qc]ExLcʀǶ5f6Y 6ڠh$%C!_պ%6U5g=e>R"GOF2)܎R( ATPE~iY2n6Dj2tpo;G!m^G2m /?m%ʳTnw8n,Y@1' P Hb PQ1$w `_"7s4j^3Q?5d+BdARCqd2G8&t2S%I"&% Ep pG!o7guv# A` _Rأw`pd;>`UC?0D@0G .`57{ ؃ |-#dt진x"Lh ($@6u&b }0fpV Y77V3X0 x r7G!5` \%6 !4Kh:<E$r=12 X &0!p4|zS 6 yPrS~3C>lh !tA v>\9.Mw Wv%aԨjwD؍(i#KqCt戎vk@  _hȏR;> ƐYgs=A#xKx ?9u|CD 8JɔSQyK|%R}M.OqPcq[m'o~TnKy&qfF1ְe$P WQ sW27&V(CE? n2**Ǎy."3-%SEgUw] %ЧB~a7xi@#%a WQH;Y  7f$&`x` zd4~Þyp Ѳ*5 6|%Dx"0 eӱFhGJCG.(Ӡ IJϠ 01p1'ؠ `|&!Kyw Л)0ߊ5n@]y0 yp8ݚb* GA1`Y k#&QR  8ƤV(a ЙyJc,:`Re;cNQ7 + Ց&y%}w qǛ>uL ` ꠜ\ {a P s CqT@$! O3.$j p=|łR&~%r-˟Y̸۔wCqcj(&c x0zLC0(dmL1c2BG-,x6"<ٰ @P%( Ii NXEC1ďl [ j58̌$a` g@9JQ+?[)4 Ȓm׍ې 0INT4  ` !Ɂ ` ɡ\"8a.{SP9l(q$sBgAnRi#`ihYb*KnD^^ oPSUڰwQZM,`+W6@^RB`.e&Ku/ggi{g @ A!s?c ,2>Nӊ5~>(A] X-\W& Q ,t8jě0jKUBq(き`o\=(7 a q  0 20 k1 &1ttP;6^oq/ZUL(e-ў26  {;΋r!@VooS> ? "4ذaB NX1@?(:tml4}_o*O52+;top7 &mQ+!:̵ŞPe|)dyF>P[,q9,MB qF +ipG{qcj!\GjNl)q;lxbnqB詡 'Ƈe8: I:qM*yR^) +$25,DT.4Н7qm!q3#-Q2EuT"xhgHuխ40Oc|*GI~t&K-ҠydLLS5wkSYf~^[p oAj2] (5J5̏k ~& Nk-lO58\@\ 9*=vn= jh)ek;f܂ dyܛhq4n|",~uc @d ,VC-捳2bq^KMj7`)6Qhdq 7c"݁1zc:2Gg,ؚAdfr~ɍBZneN0JDI}d"̛>ʹclly aw`*^PCW^@2&wiy:1rk]L]2mQFkfWfbjRmTy)pA)̍Pځ[ޣ^~#A84bhyk*tLq${B:"}-ln&-"5QbU7UL`Y5÷O|}#_s+Y@ <c~1KaixH~ 2He`k,!5 l`$GX't+zQ=Fmx&{#ikޡfjF{s48H%À81 lg;qL`[k@&cpNGJ)eCK[&WF( K)IJ-DyO ɓ@;%y22frQl=5ˢ(e+P,iȰ bcGoNb*l^5zGp'(C%HqSR4HGa `M”/fL.`aL HuR:'0L jL<GWyVC({[L4H`V3ܾ^Sݎ΂!W_ \=fV^u+ c d(VIhI"ɇ0Ybݶ'u0MdqǶ-u84T.}h`L~+[K}R`"Nb"l&4Zt4e^e+%(;r?2 ?k,3"`dS&_;m< ͲE!ic-rf#m&¬i\c;6q2cy*Hy[rDT,^X$%13lFb"w{D?d@Ml,BQnhfd&qF1ކ mFC$֎fTnBGT8!K]2AP3ר0H,]kq`m< \;-eԊ#ܒ4&ids7! VU81~ o@/aC 1C @Q Ť&+8 hԲ\p4U7o~@"N ,p ,&0,GDWw$0rt-!GruC^P>w`aGR{KoMzkD-9kg;Ť0 0fa8eJ d55aЋf:^s\xxLF'q-8Tni*(:}C^zV1\f?ۡv=I;9d\1d0yBX5AHk^5 FD{#Zr4 \oB ypqƢneaxrH!HJ! Jt\<ȗy77>68-/.W?+~@A4.I!dž$J"'#oHxP27 K$)*Dd8 Ԣ xdi؇xY쉓0Ģx J0 Fk-j"Ll!@"pĨdMp`M) /r Ԥ! kȇ3O*z $\8[. wSث IL lЪӼXH0>@RXY$؅\xg[pf+1 5aRc V2yP;vh-8OOymX&8@P"DuˤHfTFa2:PR(MsQ€:>7+$00 m"@Yܓ̘CS )G1QxQyQe+-9*;OR*=:/ARyPꚇp- j>c O\Y,-e,J($"0(!0$ ^̴ ZHxgЕ1*a u p^#X@D-|E/kq Ћ#xĘO- 6W8lઞPR~h-Y2gy8Ujlol Q_0𐚐BtZR2U e4vHݦCAc$@#5*pJbdn7DUa؞\:i h!8=y؉RLx0N-lӆjQ5b,e2ȆS QB!]'YBN oD(M[R((b[B7 \0Ή P ( TL~P.9M: lbHgxrQr* X0/ot5DJr$|3mxE ?R0[Pq腄޵B-y0֒ DH sKO~P,*U2dx_ #)GO-i;4 -#T>Lj8m0%JiF8A8g`(pbvj7d3l1azAܒlvV4Zb7.ݳf<ĥc7>71ecH$R ۬i7%1B/-=-!QL nw' 0uΖ;\ ƆLxR+pmZ wpsyhs'߻ jO$Xs'vc8_tط{"(yZVxa07?ӡ]ʶ F_'ER^.ek;|/kF DeP([g{'_"S8brR$2n'=4 F>3>z87;PoV]6;X W ^J,B a@"n 0$uAƼ-Lv>k0L,E0^ܜ}EHsw:y'?Kz8@_jc$6`9ns ܩ>7j8eӆ>Z:ɎvzS7P+xĐ:ȵ!;D B)@t hA ^Q]v :`FT♧,!ʾ!ifD10\z 1)!Ƒ /FKڒmP$ r<(cQ |F1Jdp`hC<9iˋhR7 (CԂPDR1Ұ)a_he Gq 6HGXs9Wc2ax#ͦяQęTyGʶZbHS !#XBw-#ªDZ.459  CWj~*XMH1 g@167n\Gv`xV]9Ir`!t)0F-b k#ðP g u9"<,3>xiDRU8%ifa KC&4oQl(tg]`<2xG*J~K@ H$+dVԲ eBBB BK x0`< @o]P %BM (!OA4 l\Ukt;~|̡s9NyOfe#?u2d8XJA'enYlr ;g}=mk^7K$,xO;`h6\ًY׌3L|0]SZBl(/l```6x2$C\>Y?mXJaIrLM~E]A&H}tKL//D6C))H8PC2()@6($, 8L*<(A>3'h pdH^PWo0$[@dDX gVZ2s>H\hmV'GvI^hy4,C>P5NDE{?0bYgL͂ BEP j\luCfDdFPRƹltllMžgDCt-,L zCK8RW&$RӦeW".r ͅ;"լx+΂ƥ`Cq-*bm)Y""+jHkkN-wB-g|C+/8l6x_C+PltBppmFDNS\yz !54Z QOc]4wP}QXŒ;|$!*$aɃaM\}OCl4fGنavo/_u D)B?Q@ 1ٚ*_IB+jҠ̕tA;1x?@ w8 odjR~/du8y_8\"@8\ 毀xSuH#8D1lVoLwlxEhr[ fa6X娥e6$2`$-qOA=8/x^E휪 ^VwlRtjS($X*4Ì/o`$%Rp;z`Y;x'z( <5Ζ cW2̟͢OS.7fCoVZUhj븙C0s]}'wx2{MEI̎;,2tP6N-BA@ &%_ƕ|; NƒXb -<)̕H!\yɞ3o߾p4t`\q %VcƇ 3v1I4yeJ+YtfL3iִYѡA#O"?| ijr9NfN`s(#ǐ`NJy~'J:q،8{7.3eۄw͇5wUϲg[~)#sXjx36Yň 7~},bݻyJDp`FE H)p-Z"`@@Z\&iI3_&RJFFovϼGgc|pؒIֺ(Fx42ц+MB1E\|eEᩨ! J( `Rv gC p̘ gL>)LdkG?yL w|kǟiLJk )gq0Jfx 15c ggVLEʼL5Iz\.9@ ۥ[t.>2H<)̘uI='Q khc'r=Fi!0qx,FȰ!l5V6lWkNCF2uar"jې|H!ntlUg[U_]әXap~ vȈGyݖYش&x G[nsB~qiN","x#EzQ 餕FB<(J*5jɥ%G EQk'1#?uZ'b <3CK賍Fq4& kqҕˈhj#t5ڶ5ߜv8kȕ&.bQkāk,1w Uܿqr'2k^^]SYƘe!6lEbm"W&ֿ"J}?}|{3i)g98ӯDbr'˚1#h: *gŸ[d!,OƐFClx039rBfiUJN6È8@! dj-X!&mј g,dr}tBM#Lk1@iTc{<EGqHr:pb)'B(@U 1 -̄& E@wkNb5"2^Vե >X61ˆCncK2Rj$,ZQ"iYK tPvI0.c-wkT,6PG]Ą',UƖZ$Dd8U HDvD^F'}mBSCWRJ<ٗ:~wg=k:zY2qp4BF` #ˆZ-yҘ6A,wkpFA9xd^Ya,0'\sPJPϦidO:?l(l2VF9Fُ}00 GwxCdX<`sZMaҘ”h)ԈWd}ƁO}=)@Wg#&M ӄ(%jƝ7۔GDexQH8E{6X|aSܦHWs,3 i%)K|UVc:}AiG S&E0ق>db2Ȑ Mh#"ռC"mY6ؖU WOl5ڀLHuRR[Pg99iJ.V::6adx_G=j$Z9.e٨VƤ"KJexcDE=cژ3JJZ\e\>=,P?ŪNv8?q6)W7FՒIy :.4x҇&_1,r\ʽ`S  /=fu.u2h VƮU)of* m%S<4ОܠlyCPm/1'k]zԹY&ʨt8k|C^(Tk~~5E28CvzWpOPȵd"UFN!X 8lc6k ap ktZtARj,^58#{ ~ă{5Ϫ0$I2#6l2`cؤԽXORŵLu'X~H<ͼ&6,Խ)}&Sg<'Q!%*3Y q$A^lӆ \:i9 ¼F\K_d L/oLLfS382lxkaL*l&.eZ^*NPli ވ92lf%cgѮA`P%0Llc [j 'D>* W1 ϲ˸ΰiPG1blz!|%,b=AI]HQmNh#"$ ,NAL ,]ՏPH%(c9b26%TmB+CA"nQAc\JaFb*xAy J5aB6D AAqZ/7‘$jb2E /_4!a! 6D13CX.Gpz\+a-CLk+!6O$2SԊE /d*FպRr1( Ԯ<4J!DgΪ2 jaC+)ndO,&Œ3S@1%-9׆!ư#K`# -pr/ BB/VCy `꣰])A*O?L)s@r:;_ so9t%{L47>byҐ63pXOZ7IE"P 9ʼnH>JA2S̬B#QSE-뭇lh<]gXbA!#O4hRab!"+jʫF{#t3ϢH#IB4cJB2t`C]O/JT`fRTEANAab-dFQ Gx.$hP',JS$4BbC7r1I!AƨOr2he+t |oqQ+"h42444f+t"WƹΒt#a/r#Rfq$^2!@A4U2!>VCu06JN5h@5\EV+d!"AFkWy~_A;W4q7! F>P FJKa!|*ڀ &!t,"bC 'C15Ƞ Di] m&J6k*OKQ:P_6dPZr7ҡAhA!!`3 ̂wF&5!a51 v ACMdS d`B!4œ6rǰJf-#6dcG/2aangOAhW_D="jA/!onSjLiq`ALس!W+ &wh&b- b䣸Nnm16@MAv4F,]j33wt6V#1+@az1!B/أmq*ovu%%[ oP\!B{V[f;gJ+Az!.B/&V_byP  ]{Gu+"BznKJ !PVIz1(W6w*0`BaaB/BdB!0|Kd lB7aG-XV06k5Ҳt)b-K2D_'&AAH"4A#L5a r AwgsWA밐DYU >;5")3X6DUq X$A3T 3yo_SCB5`/ƀP)4Qb (MDcQ6 M!sOcS> 'dĪU4cھ:A䁼Ӥ{5G;dQY|[Y|}v:$࢕Y Iʹunr[#JJ(D' ]HI{AaT $@ڮϊ3Q! :I[AwguvlA&家7b+Cwx=}۫;{gAp%Vod][2j𬁁:sy 0 Ȟ:, F˽psCg,CAmpAqR>wQMf4:G2"!DK+0ß]o]zeRPo$#1Cb-0XӁ!:ڜ{H""+D/x8heʰ2qݣLzdRllBeꕪƁ{,CFTuMZ!~L r+cģ$޹}3Pڠ0b%!T,ո{H]#L޿&EQ$ߕ钝_V-6R+r_G|%&fG9"@E/ϿuA9^$j!!-hG^cu%J"~S3bCkQPA&^!jP9lDQb&ab3$ _CÓD O !{?ie9G|^~E¡.a2BfGDff]z%"lɛ2"?s ?EiL_2w]}O @!=#8f`aLF !4!<8zN"v - 7O1 @Cy"JHQ"Ë3jȱǏ CIɓ(S\ɲ˗0caC\db_O}1bB %YhgY' 1j&q%Eڴf-;d [lQ?@~j_*SA!&J k M4vy3O?lƖ%8'JF#04W6 bq\9nD궻~6j7PzM9$`; ki? qd:]C w|#5H4؈y0$.Lɳ?m.C@ ,38H+Qg朓6+kY}yM9)l^~^OzNVm9{$5(cyLcm#RIl%|DlCf3AC%m)``9;vmH#INejJ׺ڵW{%rp\h $q\{H>*F8J(6Uk5*˴:B GF/;(H+>ՏNftw\rLgPXAʈ 2ef±x\ >B;jb/I؈EUJ2 q{b(#*xM[iih:FO?AƤ97nVڏiӴ5E^DR^zZC8%3η0˯gLcv҄(c6ItL2G^2]nQ=@'ђƂ}{XlQgSfl5ї[ɐc[Oth"\ X.c-IBtfY<2`vKB}b]`9F8~Kc|P(%ݴ/tFc Cƛ4h#p^+g)?Հ=|AGgu[ax{+ 꽸eX48̒lӘjq>d6yżo6uU~S9/w6| #:53>Sby~;2Isj#/?4^ZtDE]~rqԔ6~(y*?5~|&[4e'~&w؂.7YSSòcp|,x{{eh.*R;L؄BbglXy}"4huV1IY 5WN(00 !v@(y&~'~`b EZh~1؆3Gczd!CN/$09Keba\.c8hnhk6T5[uȉmՇy$ቌWW(|lhY?6tC:Ib_6?7&ʳFΈy{5@nHh,+~CNP͘^Hl8 ׋O4[hBS^"xo/pȎ HD&ّ㘏5hVNJhO &'1D{p00 Fc""oB t*06?׎$"yƀIbT)?YXZ\ٕXDy9ɔ'tSPKcE0 P :q OK:I&Wye@ ^)!!ZX0 b镐\`a1ّ.kt Kh%*CA 2 H&Кrr **mē>IK_ 𙲹 99PڹV }V)) M!9& `bVKh9!a \ ٟ:aza`\ b:ڡ " Z#*Ja:4Zi* j<ڣ>?B \`CzALJʢPRڢP*yyA&c _W7dZfzhijڦngj10Yj I!ƥaQ+[ak5ĉ6c}eI!a 䧭Ҩ0Wm:K)!!ک%| G:az &v@Ö.@xK҈_:r3qج CV'0ᮯSSȈK ӊ/} 4 pP X !p '|rL-} 3~ !"pPr1#R` \Ѱ 2@ {Y O ˑ pm` \ԯ n 0 fl0 `o~sba }h$pP 9\ 0OՔ ϠAF .hR ~`*P$"[K ! {2C{pE2EȌ @ P* 5 "; "f@Z| lo ЛI&L Rfތ |2B   Đs °Xԓv Ǫ-# Px b?mP~` 0 oP Fٜz_1ʀ,#Hņ \Ad pҫTC6n06<A ɀ `ۍ6  ې k4pMM p@ ΰy= 3 x E+>yxP ɠ 2@Ń őDA s- ) / Ot=K!y1 }Nj PCJ ۇԇ   {)@p")1H}@\ D pokP`0 zM"ˁo@ ] p W[ 4+>p { MPrx\<, ]QJs|,Ðۼ қ  l Վ B*a8P0 p٠ 0 U / @ ) @ L  vP °# u5 c  8ψ0 0P -C!T] + Pƣ#y 6 SOe @ +!sLK. &K|;,*"ӈ׳<#Q(5'`>0S(# X*>x&>RB0 1x7@n N` `(0.@b#eh h,|`N L`8 x/NTH7`( <`x`CTc#YGЋ\oe'_O ~K =P}YK6+:UHF RH D* Hd,1:MeOL 4" )2 &H:p_xF \H3EL`thDVd)xH9$`FJ R,C@7N*o\T94nX7NXL`8m^֬8$"C001'!mv&ֈ\י硅Kd]%BS=yuF$3(D)-H e||[ qDÉA,X0]H(Ә ,rװ~#"A>P'QT4'QpG&7Z8:c bԙnѾbpI oI*z}E$ G6XlK8]k3c 񩽋p,"*Q5bM:(seC8wH5m0'&? =HSf~HS7a^ˏ׶+%6a]SHL!a@H>@|hs25px Wx)Z*sNz*)iEp҃t$)Yp&x6pP{pX`,ӊXxH03/i>#+T%;l;×9?½Bt ;#[ 6UoȇW|qІ`z`kw6p 6",s%t@.6eXSZS&͉bY@~gН߹?Cq%Rz<IjkQ"T?7s0 ,!QCjAa"RwʼnXZk1xنpinߑFC ]zqd b ymg䁇J[j@yleLH 63<$YƑ/qC]ЙjblKoM<Ā.~)UbxxS"`NFmXX yP0}p(YWnLSurl-; ~ЇiRS_}%[׍Ң '-W0T% W~ wH >|Ȃp{V5& "CWWp*0x PWxp mH~qJ@X%4`Z%=G Qյգ?L }WkH*cwi y@=fЁ:S66I6DPA`0$Ho!b*yk5Y}f&aR)VXr`(i0h[(Y1oox+blij vgi tP0ogCUІhtHaN[k0idP?PwfS p%&l؆h8%TAT}V'6B6H8Thehxhp0@awjQ._?3ˮmmAU %9sO 0ؼR,穭@mPhVX}hۊG.j"Ao`(K5Z_ȇe%Bk9d!* Nt.7OD0 yHH޽)S'PˇW(su8XXxnV_MH(XUXbx, i@sRzd_`Cw[`H+60]y` Oli0YX&v{QwxBI켊9{yۈw>A XWMC-0 /~7Nc M$gU?Z,GTi:g{;H{AAP76l A \p`‚"Ɖ.ȱǐ"G,i$ʔ#{l%̘2gҬi&Μ:w'РB|hQcFI'B(ҌN-:mJUFZU+د[ǒ-k,ڴjײmd҃ Ve.ÊQŻ۠]C 0Ċ3nqM5To̚fGZ*PԪWn5Ͳm;*l=*`RG#ʓ3_9ңSn:qg;Ǔ/o<׳o=ӯo>ov̽5JIH\!5;KiBK.j/z!!8"%x")"-"18#5x#9#=#:ҋ.ZA !5`01R.`XK.`9$ey&i&m&q9'uy'y'}' :(*hF"HE "`D)0X/cK- 桥z***:+f5dNB9&KɂK:,J;-Z{-j-z-;.{.骻.nKY>jC1!,D@Y2(+f.:0K<1[|1vڥ*bL2C a԰Cce&cf3=3A =/Lh% u2pѯFBl.9L4e}6i6nz- 4o$urTqFX0.Dsi733ۉ+8;FbFNE#M]D$g@[@:.@~;;; ?<<+<;%2(YRJ=$85#s$e)e2|f+_IBjtJ`A %0` hDh|'1_a \ةw*~r,0P ==  :lb @"N~2[$e){I DHToJDrOI,gH "< RJʻ_l呜sܤ2sH,Q33C(Z%}E-xA[9vS;}:`X6Hr 2Gִ̺sSM#$ #@ +A~6}juX5W}lh!D-n0%`j6g ~7KR <1ƻ~r `?r@%kQ~8Ļ\dFQL"8-eX0BEL^񐳼}upEN~ $5 -b`Z".9okr0.h N >VO+O^_^'KR|fvÃ`B4.KAáHKh;{ !,@~DH`veÇ#JHŋM?kȏƇ'[y˗0cʜI͛8sɳϟ@q1JIKPߴt$MdQKXjʵׯ`ÊIK୲'{]˶۷p*`yh+?xKɓ7no7d~3c6@&MZfC&ʫcc˞M۸s[Sfݻ1?` \8/n87ɔ-Ӭsbw.%@.ׯͿ( @ ܂ Z5eNrB\ =p51D`.hcb8(G-:`'<ӏeef^gT 5RH1PF)TViXf\v`)di]UANP˜ g/!矀gC&3\5` QD0ĥ̉8)A]84xY4R=C h@0`y0M)k&6[lm˛!Hf--z+kB-t)HMr!NJĽD@DN7 3c065G q*TY,S.N,@H?,oa Nk l8<@-DmH'L7?[,TWm_NpBdmhl=0 ,2,cD~ D Ba nt{n7-zƷ}[w-puNM8YCq0X xkR" \VUS&oW򕣼ejY R<&G*NS'9K_1j8Gt@L/D!;Xb3Okҷ{`NhOpz U;c@Fa`9&&rB _EzU;|N|z*tfnЇnyw9ZOA cU(TVЗϽqr|:t3Yi_z;ЏO[Ͼ}/bГ^y/(1isN@t*/tA 3bB|(G hswX}]k׀\E G7]Vsx|y+gs'z@uVg ,؂Чsg|۷z8:<؃>xsWye q{g 0*5pg0]c'.auW^*`8|5g;G :׆:煨HtX 8g @o pEdhxehrshes=˷s┇)§rX7}8Xx؊X{0 :tLR#w0O{ಅX`88n 0 B(@rݘ긎_X X{(XhxȎ9YX/X  es S$9ƸU]d'.cc8 p,ڸ/ 1-9+ u@ y,P@U X7 @M uPAYVyX՘6g H 莟0{Pgd\ qƐJRT԰Lk"(Y Z* Yyy^٘ 89) 0 YyYUP  2ə) U 8y I 0 IZٜΩ*9ȕu L`N iPeY7b԰HFa?ٙ)ٟ)z  `0  9 @ @P @ 02:4Z6*QJQI_N)\PW Z >` >Ma@ Gs bSMI`0c/ hjlڦnpr:tZvz|ڧi؉TP QNzx 2N^Lp:I ꧨڪ JkJnZ yiVba ZP  .kduQVt'kj؉f@ pZz蚮꺮h T@fI04 YrJ &K@LpP LPa*nP } ɮ۱`b٦`6i  ^D @w)UJ&'6E%Z۴N{xRۧeP Jl34P I0IP  `b0cIy9~ڣ K٦`i  @ìѳ*!xYեS9 fjh  p;۫{I RеSP [  T  &LP .j Q IpNP 껾۱ Wxi*6@06䪟˩\aN0 J Qf Z7uwiP Ep 0P &|&*,.02<4\6|8:< eP Y [ L@ @ f@p  4` ?lnpr@B=D+*&fQ \x@ILSP KKi Lx[P /Mʱ\npr=t]vm ,Y(Lʮ<6<ӯp {\+)Nckb0XE &}(+ ,Ψڪڬڮڰ۲=۴]۶Mpۺۼ۾ژ  @\D Y@  P * S< bP !1-ۨ/2ڊzl = Z + ;@wi,JPN웚-]- ">$^&~ⲝ `  l -Q,"ң Q`ƞPグ ΩR>T^V.ž=аb@Ζ0 \.>)pFҹUkWJץ ڭ~~`؂>~~W.{Ϭm *=>k,QxU A<⊾ꮾު΄>냞ڵ\-]m fܛ.> xQٖ= \ [ҢpN>^~ ^G>*^^> ҔP $Mژ P G.<\ب ?_= ^.0 PݛE0-s J QY !-if "Z/9NPR?T_VXZ\Zbd?f_hDaxz|~Ug?i_b>,ao. a` 65cŨs^x$ /`p@D?o?_ȟʿM a0? D?_{?b D: 0eh%QNE W/aΜ]@ĉ,^KTF IӤGM:Te!D 5@N=}TPEETRM>U:UV]~VXe͞EVZmݾWnW HHA2H!$H#D7 &,dM6@L%?$G`o!#$"RQ$礳N;3O=TNXrQ8+?(-$W(PHzF$S zhs?8mɅOUWeUW_5Vz-yC%+ E&=eK{E3?&Q݄S!Y[o7\iW]‚%/PABM })_kkT7`&`\ (QuipEDD_4=Sx3]F9eWf5OF9^Ab8< EyMZ~!:j\? npb=Fsch] :[>Z 瓽n;ooxO|y?R 5gx_8@f/zy(eR&,A c7 2/?τ'DaB& M#%І7auN?bMC1GDbD&6щOa0g@ǕjabьI1DQ/mp (B\vjHюw] H@QDDd"G ґd$%y0yQ ѥs7yus?zu<V0vi_;?B}Zb~~-<7l0l4g˸~ KAkY8;qJ{`?Q(YrӰ>s; ]bf`xd8Ca,hLSFL<#\vK83i@hp5Lx7G{Ss)Xwk9j(ɒTx38x k`p8dtϜyϜOd?:h*h`&6RlLp2@[f@8($2(b0؄*T7DF7axVxR(~HtHH6Xd'tFdLR1eq-X10I43E4U5e,-DPh(Ԉ(Z(LbpYX؄Z[bSlAY(SwR8ŪPQGIMxn`-0VЁO7$4oPu\8j@B%=B`oBdG( 0Y85XN_b]RWtx%X]]]EYXaHЁ#a~؀؁%؂5؃E؄U؁HdW ؅foIChZ05xfOfhThЮȺnvPQ#o9P%pWf]YIV@{b0ebXe-O|`0b (d!]VvwMDYdYeH@gHa|MȒ,ZL@A(C@]υ%5E=\ϲ8 D S1d4J _eHxL:<@͵=BT )^]Poh 03RW6` x=R8f Z]h-:i8X]WxcSpN>Inq6b  R @LfЃshN`I`U hM:pJ5xM`MW@OpCH^ oH<L opR(b(xPsX|WdabVfk;N^3UE?C0:eT&ShNXOPhH@M)I7p-~YbCb1V*WXepUpT2i DI JcQn[@C>@Nқs0MהM ؃Uk8=W6(ZZ`p:^ (Ip]g^z>]-h @Kñ杙ÀfK\CePրV]Rf jS H?xP&H^GvH,XSxfs8-Xw[(EUJ~[I+s'8*PN_YO^tpL6N%Xt=5D%s|LR\peWEJtLkLNOMPRWT'uUQouPt7S>6_p&Tr:*pe@M0Y'0FHXY~0H'f5:b%`)@GBX@Bw@1s80veZ莆,HukN(ژ:0Xu12)kx `(,pY6HpYUgwyOjxkZ@I{S:0@ "d(M20?H ckk 6 S؄h=>0Zq;$lX5X@@fpi(R\fH0XxNxx֜qFhGM>0a`nW ]F?U>l-g'y`H&^ja@6y%|GWgysbxȃ_hu!;H8>a@(oh08XX`8Y0aЅ[Нo<1b hP\S% Ecś+uB IY=!w. +a„"+ p(9s< Q9n85qeU .Ā0_ӈSfM nbrҭk.޼z/͌7nBFN^&OeP(sv&.@:8.MZiF.mTZrWh(eLd+u #aS4=,l1-!S|-rh'VVn:pd!(Н;Pэ?9"k٢|Λl4 JӋCz2a\+N  SXC'$00 `C)}ׄ"C< 8 (+TU @P 9/.@ wd("` э8Ix$с:$)պ$l(*D ua`l!r,hC+50hi )`cM&G?Ҷ4C4.xA ^.jQ ZF-Q _B!]Y07YFI2 L/6B/!].QY" /a Y|/ wBKX1, n4|A>c -d_ܢ2A`Sos>1,!F>{d+(02P.2v11w"lE1<eLx)|a_bE,(ՋXF-ePX1`"ΥH4ncJ :Q1aXN.mic\ӍE1 Q530̥,l ×^WQ aHcO-a>6e3~vb@#`O~4n 4Fj& V"C,L ȼA/B؉}:faZWeBm"=5ba` ֡,$7vG~\"!b)LPo4Ҿau(z(_ה*$ؽB 1ڣ]pe*CQZ]Yc.- v`GO.z-[%\ƥ\%]֥]%^^%_%~ re*.#DV Vb/Lx<)>)W&}冡es)IL}푦PAe&H^/|fn&t l~%HnYadI*uJB vK[ Fۭݤ r$b$ !fWQb"ۛr5WTXbVe,lT&dlYQY%a&0vc_+uReۛ`!-/Pf-Pe>^&gڜXmiN^0LlӼf}z&x*`mRftÍ:(2H^ ][mqRk˘tf㐊$<]n̸b[I [/h( bZAVbZ)jiA"橞)"L7n]6^=$[[~]̗ 夞% #x~rmΟ*y***ƪ*~.,lJ,V\blZ,Nv,ګȎ,ɖɞ,!4-xpL&v("v$M`GQd^-&.-6--lTklojILӺIf\"%~-ި-ٖٞ&aiMk`F͖Ύ4'l+%-.nv*6N-Fm2׆-m^."\v"LdNƊ欔jGRw"`f.HRFEn Џ/Mnl|-6oIN$(-vkl|e<㊗n=noBƯίcn//֦/+aJ&/.l:/) FBQ&n[l!xoklۑoŮ! o#0o ?ư 0m0.RX뺯'dl,0G3.PHphNޚ 'ni׬1 iq.pv/!+v2"ǯrl dALkq"L>3??3@7.4V\2U.4@GDO4EWE_4FgFo4GwG?4}F%PBFa(C4LǴL4M״M4NNjL/\[B4J/#R/5S7S?5TGTsO)P-e,QRO5XX5YY:3Yu4VsVdDLR5E^5__TOOY4BnuaK5`^?dO6eWe`ua_V5exI.FGvTi_8ek6l?vft[#ugRUh@ls:6j?\o7r'r+l*egudPhHgD77j8h7xx7yywi47zO_hkѰ805L}7j&2788w%W" dvd7yKxhwo8w8#b!50vAF88@ 0Jq:pw8ԣ rc?9GOB1u#Ò~b9ymupk9sy|(h9׹@{9eHxƚ7bw㹢/:3zyx3nƜ:g$ 7v:77:GvFw5o:uz:z:zyMzV:gϺ'/;?wqC>:ðGszw{yC??8d\<ú_dd>yGnvC/ {0+Ʊ/<+{;ǻڻyW.W;"B)dă>#H*^gz<0;c|HÛ/6@>D֛=r?A7{}ዽ/z;><ГFϻ<<3<ýK:G,8%06dC(`C,F)d#>;ċS˽,Cl^C88BA#%'?7>g>X;C;;tAC݋@ 0`A/>8ò4_ P.cB'QTeK/aƔ9fM7qԹgO?7}  2c!1cu/_P_)`.!{fVMW j"?T o_C<_?f'0Wx4*& Iҿ>xq.dj 1iаΝ4iٶl| -9L3#&-hk0x۫ ,Lp'y;AdJ} *jC2O1uPqa' dFA%[JeB3l p#LR%8>$,T 0@ 2*ӘFKqAMuIu܏^p!cZa cj1& -C]r8RsH'd*S0҈#(!g4Mg v1U-wj$\xӠG2 G< @-nDmgkdKmiT.ou.bp!Po?V'UuSuu^VXH&3CNXa@gpFvcȾ `p0E'4MYT3MtK xZNf!{{ },!.裑1[Hy8t$'||Ë.:dwMmT^myefy.Y']s7؞34-\pUxYzAc:1v'6#mD4q lZLng_BBΐ ⡄gTӰS6pL$<4AN# j_<d JWѯ]јF5)@Q2LN7lֶy֨SlTFSʚh *reX?>1av*R;oi<AJQ[bJ8 cvPG!U&Fd.5i,n,Nt3AY6jQ^;ڐmj3XF2!S; 8.gl4dyAd!x?2cfB}4 lMSѻG= Gbkxv1g)A;7%G=}3_YƁN(w ³ә64' Dj'QEV:I`f)O3h>:jCP$Ҡ@ DD9ӛMv mj 9 PF%D}gHi\Pqᑇ1G$XAaı* +k0 UNtpG|Ird,6pAthְcO@66C|y0Zqx3D~gz0W Mk]&95/t [0mC"@8򹙃1c S pFX>ǚ >:2]QO5w}hQP S_FT ֑$6 k3/c?2I"WҳM}s `AgAMu5xD)6yڮ18QmÆ7"`,)n\PJ.(pzAQ 2s<'8O9}QІ?Noyl4^u> q;exٖ3Ms<|G]K=CB5-`:Р|49 0v#hRvzBwcTY'wOAp11"t"}EY1mN3:Ox|nMb̀p -@e?Z?0 NDAmNX"k{m618e h,D$,, ;!D"o,(!8.ʸ(ʏ Ώf¡Abah&bAjn= DbPb# 0jp%Cb +9<́:,A9$fptNj {1eLA4`dDah^afJ !Zg I =Ѫqta36厜K,[d<ǯ2]Vͬ fQ!Ǥ@i:9I>AqPGjX+,1ګr`zbcdёBDMt)*l)U,Z<`A.  AHd7  ԯ`2AT߾ Ҹ"iTDˆbB&dRtt~т|Rk¸4a 1ID8"Aԁ@$@&XNA@!&$2 B *bkafm!C!dIlJtH{aErIƨ+{D!h!Dӡ\a&IXd@"aҙ$8l\p0!1C|TP0$sL)Bgr^ t>AH>4-< -D @dP35Ei5M5#a! Ƞ *2@p8˪PsS$B:gD6.2!^ ~<)h[0Q/H=>A2"2b/ ߀ @.S:F$ā 33A$L/Q8LDsQN=Y4\4`䨤TB % @D솠m'FAD o9DE,ԙ("4ҡ1fG-p N%>tK8>ĸLtw UaHRGI,QlTu CVSȂѳp(%+vA@DLoiF<$NE6 Ub{X{ cY.X0gR3Rfl$Nm*긒k}IŽU E:NVQb$ƴ'B_Eas8nHIa8n䡊:RO'R=COyKSg V{0}BEiš AJXu#v)⸔Ok6M9Anx!ΐ.!.H<?'DK6FӁLD&s({6Ԅ5Ld2ˈ@,f3&YĬ.(n՚#$튇(9uyD|IZS3.ht2G-J;!FAFơ.[EcѴuu@}"Ab6ʸPg` jBoڙ>_Z*z)*`zaaQOwB-d !zк0 :/qhB5[KHDb^gLH; ÏM~KA&D.SLNAL#@HB{дKD> j4 t!Ѷ'ٹmB'o,'? d1ՌMvBe>k|T2.w*@lnKfwo~KN䳆\sbH:6gdD'‡ B̨sMw"9-49'¸U OS7l:ŏI/5)rA,BbizPS&@#+^R{kS`C{b+N)*7D+Cߺ *yqM:*E*~afD$h`G cA!=r'γ$2=Ib/5 Lq"4d[ˈ 7b 1#N M$J0,V0Ǭ!SڒrmOT_PI5Q>AQ\4@E'b@:xz#_G r?)  f].2eAlMV[Ic?Ad0z?~C*0… f8q08D ௡ȑ$K<ʕ,[|߸p='_m9NP/m|ƒlZSɌՆm+Wb˚=˵hY`ٷb7޽| Ϣ Ó&2۞8@*[.# <aĉ뗱W[3xjٴkI&N=n :Tyԉ-Zi>`Uvˤ]ǭwu-o;<kؽ~/ȼ@K`X#2PHaE3O#ZAS~a}U2\V2O*ԏ6Î9S}V>(?pX>$"wBjaFd XP?#N;d$Y)eBUfdL-v`  <<8\!YIg` 2+#X|V͸5[V8dmIi^ڐNγ 1U5ּm;`Ud(Op:Ή=8<ڈé8$Óf!Dq og̷vh*hP. fk>L4}BGbs+YX9 bܴcÎ23S$.ۘwq>|R2Xsͽ?=f+j?㐻E` M|W[dA>bQI>CU֒A7?sYN2y8^"a+x> SX;^u-S<+c e(Fc[vg=O?+v[K\C:__H>}`{)`)J<+P?PTpBOG8puMݨg8I5a9t#ÈcX)LYǀK'lZkq<:Â!LǃEUK-~sady䏇$ 8m@M2p/wؑ.l#$+4+0*!z'&I6EhلH.m(~RRzv9`A4H7Wl +鼹qT(i8QO >ɕ`4Wԏ| v=L%LG q&d 7c<2`o8GbYBJ"]5IqFVk2c.|C4F-C5m IdSJ|dx y2x"ե]E/tLD125m &Y3u`ȇ?̅<hg<1.]: w>؁M:qD#=T_k0HbI;hy~qDڄ |*+C  wW]<7QQH MW?:M!!,K>iX"FI1Fqo0T$ GHq['S)1^|b F ` mQ[ id-Il+I+۲pdHpYnv*_zKq{y P2Z8a }\"˰4VԆ+ :1ʞ*mP3\MH;5+%Ӷiy>Hfqx^ч6.юYv^ 0h։rPs(Wֻeldqdq[2P 3$G< ctXQ1br`Hsp| 26]T8у>\#㽧|mc:k'%!Qe2(ٺu`]h:|pvJ[sku];Gb6$cBS do;#?ޖ쎵Y~|bXt!$Ҭ<-XKx1̔;߷ASq<#1z%d8>j"vI`B$[ځGWd}zmp P$da&*j2 f IT{gz$0 f٠ x%:D PVαdcHq!X6SsRV`4{$'y1 ?-[t’B z0a`IpL #{0A1.!:QBBz*4gP@"w`qP5 Ic? @iHA)U.![uXMIS}Xkݒ "%nC"Cj p~ P1 aWx~.9`;09-@ -s Xk@_g! ~&YEQ{098Dz0  BAgl8*B3UMe4Y#a@ >?ƌ9#6&F A` ^J!3T>pFAۢ&e g md]w6[al;RM_l\9^ we7P5?Bwi%߷.t`ېFQ;k&2 >0 ʰ ` [x&$:{9;Ѐ4-lm¡65,t<ǓKX(!QRAy ň[h} q>'aYX % y96\Q>0 :Uӄه\q ذ a`Nzp%b1;|S8޹5>ɲ5!iI,Jy[P{Cu%h :D p4Vb| y`v a070a3`fTw@ͱ &" `5i4Zi1)١W'Ђ JtPڰ2eY 1t-pfKpE@ p Ӡ t ѥ/7$t %eќ$GP ₩Ue$Pyq`GְpZE =֠ t% ʋ$a  2WO! ʀHhs e@p DEǣ>ZF. qS 񠅂q Tc"'B; 1'`C[_tj #_W#\q y0 y? Q,yw Dc2^Wr Ȑ]76$p2 \b2YwJ`opLI9->C-#?@Z*v] ti}mSQP 1  lap e y1 a 0 )Rb XYqC]p<µ#+W:RBg# dBcTg=Lp"p dJ&S1 ,_ g,lG vUE4t,3 @A p `p~ !{X+eR@Kg Y8`yF/hgFX'QHlM᲋1'P;Gd ᐅnۥ'"-9j}:p @ P  ?] oSXr '\0\lmNnk@ QOAX ْvxEf!pBN$`_C#1:D0_&k-`J?2h\]ЊYUԇy<IS%L?E༒$}46(0 p v5ˋhYh@ І7PDSǫ}xp)n|"appU'ˊ)ĸѧ`{neр(tӣX<,B\4I|?NL` m\ @ f6}qG'cP4<KWA$l5|I}":`{J3T i@DG#/k塜MG}s<('p,  `Qp5%ڰG,Oc|QmSCBCT MN:[ 1Bv>h0 !:CMY)8x-u۱2֠o"%iXW2}!T: -q   <Yځ  uZ4DMzܗ XPl[U"P %n*k(QvO d1z 028D>Io߂V ' 0 (Ѝ*`AФ!J>L~N:/ ] KTuvdk1t(j )^zOq :40IFaGh8^ O~E 6`& O !͚`qPp"I^.Ne ,>`z`6VpBhB.>hL Tg+?F÷;'[=Ws=g]](# ] ` &k9yL3R#_?0`! ;.⫷2L:ƾ.쮃"ClhhKV ,b.@T~"A ox _N['ҡCZE %ak.? .mܔ-R7 "Y ގIdfAX ϑn Yf%7g!%0 z'im"L`IP\N'`aak, @Cq`59|#u4'gIahq $]xFMlenfa ;}K ߐ @N00 ^'-ؐMk)xq߀BLwQ|941ꭐhQOe2|>T&H dÇ %NXAɶYП?+$YI)UdْbtĨdƕ +}. ENC42 7‰NZU(c.,_vZlJ'1yƉSz%ĨRmb:%KnAclC:' `9%Hpyb@ @ GmxѾ\lnDet iƶkM|X` 4LFӳpΫBms IIc3ҫHtl3(DI(zQ_Ǵ)e#jSГ#lIG$:"y`06mxlhv L65mxwI&lv  P2 2cu"شֿUp_3k"R%)hGb0֐AL7 C 8(!rt m#`?RF8QO20d" iǘD9zMo!)1”qЇN& `;aE/?[b-q v9˖ڄwC%ce m J^XYHmȤG:*@yBULct3A<fӫ!zbc+yYۓPI` ? 6Af!o4 LVgpPp;\>+^ wμ<оdL#(]x bqtBF`bN/e5>p̩%yȦ12Ƒs,  @-l`e]pF`VdVxH rrpT53uL@6r;CPyxT엁e. z1>(e0gT%?s cl{KpJҏ|C5#I%o@ fpF7;["XKt 6<}8et}CDPY16ߒe7r`,~B;}8snG)vܓ,4p4F`tuG<q} `#&QV!N?˭ ɥRu$&L0 W/pG*l߆?Ăº 2ǴCf1U!$e绘=7u?!.5PBp3M,z cZ2 D١1ӌ;ca/C4CC}0o1 n$3͓q`]e{Ŵ=J@o]`Chg?U1bH>Qecx587PX1pp4a3 c5H8E>)}0ZI4X 8BwHx#[ gqgJ0!} ` OS}A0i,X3@-? x0؅;C LPQP(8P}D g@pP3S >x y؇*91!\ \ph8BuhJ" zpp4SepgA^Kq Ñ$(8ފ2Z+ژ@x>x:<`?; xZp`F@xxL/k~yp"Dz цVzgps;y?Ė9AݙH&rb BzEx48؀ ;j$ ((&AM ( jC `Hp1ÀaX&@ZZ@e4a1xyqp0x%A8r,h>u0DG#R[’|v J3c`@|=j8㑇>4?>(?3; U!gpq'((b IFW`YV`@kTxZ::0`4(uxƴp@5 =5]̩`BKy6ckxp28ː d^ lR@c\H~aJ ڇ*B07dpE8UX<; yA38M:L9tMs:C s$ (Rg&䄈匍gpkH3m*d(NH@&i˓.$p7"d1gax L qp(39pP QVqd8#WÈl|r"/:h/=8Q  7p!HBc\hE=g0 H^x. }3Ny`֤M2>|h2'KLT/ Txh!(xJ (8# (jk˜3QWQ\UT}LPqI\) eU=-$ w^[ydeavh6T  HՊ茣p uq0@gw-"X\0O5`0`Z8Xb7̞؈xpňx(M5$#4Z= Y`ۓ=ai2rOn 5Z!/hy0V 3CT{6 Zڒ!M 8} =[XԽb]*k*d A840imAuJ/59K! op*j\xE ` ] S #(_\0]Yji&ʋ7܆Ej -S-0ޟLqX/a1 ȸ.ӽvX jŵ`RkP75 ]W̔ HאPvx i1[" 2[՜a2XS2|8 M އΐ۩CJ% 8k_N#WeQM ֔#P$Vـ`p2ib=VWuMQC((h׻4[]h @PIʠ]+j1Vyަ֌7ȭA]zH۵- lY5#X%zXf@~M(7+更R/ Ao1a(d`.)=G3%|8a1F~87 p&^/oy-][G{:@zu0`.^8r~ p "L8_mڑY~*̨q#ǎ? IPA~ r"P^BCjec:w@0iB(r)ӁIF2y%ZPSӮ^ +VQ2 'oqh#v,]IfMj-2i>ju.]]ysc>ۖvmqb裏_H#?Ԁ7Xy4 x cdC1fph&O6ۘÚkLlW;b#2H($!R6R.V 1,l#^bQR(.2<m2aw[R\?iQhZZ2>WxمQR#V"[je?h?e1Q֏:5i}.<|zJB$@@$B01Ce1F30Q㝝M() )2Ng8 #/@̟Ȗ?~V >n1Y–y] 8mȡ1UɣDm+kn Yd,M@ a B MSr?D! &% \O8064 |,`U93+5631jbv/*V&LZ6ΪaҸZϜe59&0䲏@CBqLՒKG,@t 0` 07뙧T:3֌$041(~jV8kȵэZ"o Ӡb->GA@,$Y! Z _?a}cvJ VR0.G8!?$lbȁc0ZΗdU2H oxP2 #C!<#⸘3>!-Y&C' )8ؕ5 L"FoҩNy:sCF<)5LMJ?Q lCiyCPU Oq6nġ\;ū# AćP i Y좰"?|at@ )%P1Qw] Qi<G( Wߝg`,Zn kh97\fm0yo<4S ղڤ\@pG;@0ø4B[+xfg]@F?MEAc)BQ/O]Mͥh0h'h, k<gd&$OT6_ݼ6ÌlgĈ YGmS "%Y>Xc"0KD;B cGm@H \x@1e D|<4L5\jXD&#p>W?(pC9F ·AjŰ]DLTO6s F&glFtdm Hfd<|4ue$=0#0 0KtpDCl%2%Wf$<5[V6`cNZ+/u϶d?C\>4[8a4x\a08@<\?$dC9Ηlb9]]їqpxe@GHHC~E6jMM]>H7TBfvN m%ni$2`A2Cp"A=1ۚy"8C2Xye|Hִ'熖\)BkM Ŏ?;4QRԔ65 dgPgC:`Uҥ@5CHivp,PpABx|F4⩟C͎B5|M0\< бF?榓͚TMŎfEJw(ՅC1C*j|[pWS?|C3+d/\2$̬=6h6*H e4aoElR5h(ρݡ<@dZCqS7A)DB0$h'ѪB>t O]g0zC;@V{Rlw{2@۾8|C>%zĸO[R~7 }7;?,^h8w5wa 4i>y0YƇvydfǠM"FTmT tGy)qy[]|C)"7.(#\pQ.;r2'}<k+0&1&hfL(?L`1i \p(gdFiG?~P!0S,Q~L5ݔMydN(kᨤJ}cpiap#F"(XuUYE0x`^8I2QD92p#*gU&jۅ+ۻqQNiMyfz%jB|7#ȰSC jG yUGJy^pI,WtǝK%n3 u=,6q@y?00"2&sUÚvydКiiW}(?aa~#T 0xABX󃒑slB lg@5ӕAݽmY5q4^û!zjZ&Xp5}шGWBP& ;W3ːkHPZƅC2@ * ҒfECQn$MGm{I^Bi oE1 ] PI<H6Ա6cQb+,ncsCFgb o|. dc(c,CY)U%87Z~ق# F ^ .;8)#GL,KFNx< NM!RH}xH /?lX3 mh42ʃ:)EšW#SHI50MGp$8F= J)JPZ P(0P*%j.ux sxG%ФGXi6HD:{T~DI)ÖLh]2qCGڢ 2p2Pu죠-} ?jI]ƷžcP6İzr \aBWh g#69+#dt@xDQ(0`?q2x³ 85ޯ*PpvA hx#/mDRJ!Oxv\"FQmZI_Ed-p0£D-I{ I[<_ <m2ܿPNظ% C!p<U JYkyV08;3VKN'?w! q2G$mSlgĬqIVɞc6e:QqzLLp#" s3MxRz["` 0HCI5]pdAyXJȌ흎!% +a KRC [NA$] C%"!܂YhAAl(Hb!#@:dK6jrPeO!Ď l$e@=*P.P=耒AȠ aAVb?1Z^P\LxpŎSr*#VaDs,M,E #"tVΡ6f^"ߺިk$L C1Fl%PdoeD.)Z~L dajp IDZYOh  $ P iX( (‹@Qq>go& |$AN~H.kl9E N! 6M.VN,D഑"+O 0e@$ !42b+m  @a`X` !bJ+Y!`@a"nB+6RU&fx>As C [!"".Ì썀 uD%-A*&b˹R0̲sܤs*#1#bVbv l KjrȠbpYJ?$27bʎN®0mn0o"(3o61@!]"!nΤ0=H xf”ޞZ`ю"K$2(A""073Lq[1,ّF`bYD.sS: ! aO@c+k_!$k"=dDA=>}>Sy !@s,RTКjPa` CcQ\2e%NJq7g*?jEg S&LFBLHG >x!2lޅePp^q&5lO,h6PO=U?#FABP FSlB!2[. 2/o.A65ck `^Nה0>u2%L2Y+EW :b!Pȧ@02aSYS5 ~3lsU%((0a@vY @ OaBt$ao.)ja} !j!-[kcofSu% vrG]'GdT.C^RѠ)ҏP28XCX .UiS*QZ5촡3@[>%DUecr\e$f/b܁ J;!S#gKgEX/D 20i sUUj-.|D`6f;t mU`p43ٖ4c!y?Ni@Zu9LbTٝkۖ!PoZy+ADh*j&t7%H!aWe(=._湀ځq!Lan@$Zڥr`+t"} Ɔ.tښg}D7#z9Aa|XZb`CH/\FW0 ,@G­aֆhR]DgKH `\c@efEZuٍơvx$n AȲhELbwo)N#ܶDc[F#x@AI`G9۰]oE$=McD$;Rưכ *b:;_ z7Svu3mIA[.aD$UgsSAhL)2 Z0JRF×SfE>(*Ybf2sEӧXrւv)4ֈCp9Lt"" #ŇuvX%͔LڛEܠx2o?(_/h )@$L(Υ;%Tq2RœZ\[[&a\d I?-02]7f[JN`iկS,*|q;>C%/*)b\[ .4\͂M!BGN@[E \ǁZj ^>}E`s1|%=xu=؝;0 @-LhSA£vaAY[0!^OW:S1*4>i5^+ !$&rdƦI]81w@kr"D$,"AS!cR 'WɅKL>Z%ACp)ͬZ7E{w"Ҭ?n"&Alio;$Lk[obC 3ARmZ*"L/ߍ1b?@M ^7.$,bh8K=&q %:l["!" XȰ"JHq"Ċ%^ ng O2mܵNy-9SÛ8FLl۸p7-\y(/@L~38~Xmʵ`ÊKٳhӪ]˶۷p0Rj!.\qcb޿]i֟?GP6! 00lŅ#^|"0`MgXu^|O}Ń0È>ybg5~!*āw#]XٶУKNp[0p-X\ފ}9a9O {G wѸlTs RiO:C8i5EBu ($^ dJю<{^7UN8#=6h?3>q3O.?Z1\Bk!P!<>m3c %tixy\upW+'״CVH\9^> iD.dh36L6UU.YbQ;c`UjÐ,C2 ̠kީwx(_bt 5Ө ͇e֏>M2Y K ɀ<O78H0?Jn8jN?JܮacLF43<<F;<<)L\wi^q\1#%?OSc{-ǭ8s8S<.T;emM8Yx;kD2f(氻.ͬ 6 8ld]5AiU#!C;ġ"30x+h;s45HdzbU`ml@f⤆K>ne 1%c\x)0k82.>!8vLj:Tڅ )7{>_TiOA8n"@7"aUTZǑvh8 wHe+;x҈|&# Xx l1PoTR5d3v$~Nc8pg1 }p!~ьz)2y#4GO/FRjذ/[Cl*zWp9~Vq!OP@JWGvw1!#2eQ=o0(y7u|zu'\fO"]5("‚1TG74ءxϡv=GU"'qO143߂tMx\@s [X'Hv''-"^(;TXXsi,3C5 Gw!0 †+ㄈ{NCjeX2ă{4tMSHZh;X݄m膐"Ȋn&rȅ !sdM #d8XxȘʸ̨y҇"hq8сd،qhXh-r^48HehL؏I\8ɨ @\ΥOTx ("HMc HlAH,Ӓhq),'"!9#)`0Y(-BB L9iѓaB43yY)HI+]Y;iHъpsL9NyDHAȕ("nمmh}iַ;'2MY 2SA,-9C7!KYD:[tD b)A?QXu9qБ)t2vyʉsDHțgA}IkYtci9 0SMe×t(2i@ya:9TMe[ 4s~  PT`_ 9 ʙ9GאGA jI)*DF:zGJzם˹=8z) 'ڔ @ #:4 )Jh H)Y!]ԀIWʗpX3 M+8YKʙfУDP"a \ zڪaP:a`\PJbګJZzȚʺ̪::ZꫩJaڭ * z芭麮쪪\`*jz*05b$!c_!2bI H4[{{ "[ɗ (Ɵjh r;=Jh?;*۳>@{i\tA {I)?c+CzZxQ?86ۋʖh9*޹d@L7GB&z۳s*[i1Zl[*귎۳K K{35|B 0X!eVr#?ٲUdy5ٙ1:Ѻ9ZRΔy5y H5!ٛ-$x:+kGTɊ! US?[zTx>I4#ĺ0UV$ ŀs7|#X"J! h ?ġG4\{qC~ױ5_@$Ha~{J1@17FR"Jyt0:0fO{G%]x0˰~mf`P Lo` @ @ E oPyP ȳ/!c ^ajm F8e pĄH [Lf *l,l @ŏIHְ[jzf  0 ,`i ? opxT ?  } } BX` ` 0! y p_| x L  @<y@ؑ y 0, q Š  o Za_P "IPF ƐÂ>@ }P  V< Moa ˠY~ ׀ yu"r l pv;p }P P ? NlF.P ~ ,kMMp?!0 ap ЬBĀ  W  63Q v 2Q3~" 0 @7``x@ A 'p0  ^+> l00ipKѠA fP r@ yP pѧM7#ԉn" Px  xA ُ ^ D 1¸75?$0PڻA㪐 Ȱ O  "K= O}N S[#Q#D rPDb]G}b0ux-?s `odԁPgА#1huҀ ] @nFn@V0 yОBh#iSuA@@ D`:qOdQ'Q6u~RQJӞdذ}*@bďVY&JhPby^Y~U7y) Q}=ʩnr$`飒eDAeABON34;HC/2#qTBC )i#g1FĹGa(aR!x|C?)FIFD <ŭkЋqZ0ZkAғ`UD8¶ۄ`(k]%7qQܐv:tU]xkt:E%(}y#yGEӡF.#KXN$v ]@Ωd_~Z҂yEbk9W禣Xрyag9G2ƚ>ֹk\&l:mZ׆;29ӭoywy^Wz쵗~}`U,(Ձ.] JDZtaohsX=M_DN$y~;A!/a 7@- @GG0~D'óADt<x#s~ vc)l [(1ьg]o|#xdb o7ψn$yıd[Ȏe+D 6HEa[cQm0MEd4Xa9e(Eٺ6tmL0z3 d#6dÐW"MM*f10k#(6 yXmj{_:bx e:չNvMF> XdiK %8Io ܔNi $ lHXH4؆;L`&@L$IpB ! leiNuSQ:`l j?J#:L8CpuґL@ L#f&!ւH4 }éإ:}p#ِGKV=WM~O:Bjy` #0 (@Go`*!*@B4i*/lA>PYu5a &84ȗw80hQ8Ld bh['BlgC ܯґ^nqzޛ>Td0RЇoxiHW*؄f'`k!O*1b5xSPb&_Xmmb,hAQxSH*HJpw@b ^d.m}: q*xVB+C6ȑH8Ua\jVq.0M5؂dxN0fx |gنk8_m]E |X08+&gP& rhX淘yЇVYkGjtd0V@RЦ$X hm).D`+e#ݕh#JͦȇeTئ29[~9$ϸز@#Z%A6@вGڥF9~;hBW'F)g | [=k={=?>>髿>>???@!h .G" D1DxJ`ebWR~2XAݱ3i C(&Y>99ZĂ9Uy(PdĠL >?:ғt]Coy `.[8sK:ֳLZ><#?#Hw@!,?mE&H$ŰÇ#JH@] 3jȱǏ CIɓ(S\ɲ˗0cʜI͛ua ϟ@ JhJpF*]ʴiGPJJի{:ʵׯ`zD*ٳh_R .۷p]Iv.ݺv-޿Ż` ^/ǐ#KL_̹ϠC iӨ52Dװc۫ۜuꌫ[N4o+_μУKת?~{gcw@ųgӫ_^vm˟O7װ&n!CtvF(Vhfv ($h(,⇴Ǔ@Tߍ8FgcOD͂eBA` = 51y.h#e8T 8\v`)dif&.ll^y8a HQD0Ġ̔8(#G'餔fpfڦ-v駠*ꨤjlB-tvR# 65'E`Q 2P86F+Nlbfv+k覫+kM)-KK, l' 0!4dx=QY-@qŸ8m0,352<@-DmH'L7PG-TӼdu>"dmhh)O,2A5{=rw"  '7x8r1r3-S砇.褗n騧ꬷ.n{뚻rj-/'hJ,C󯼡/dOtk, ! qC٧/O~ǯ8 `?/ HL:'H Z̠7hAba\;V0 gHf.tQ\E-з"}[ V@\8N W`C.rִ,l `@6pH:x̣> IH:b4 q1& 7⒘̤&1Nz (GIR򔩸d*N 3-^Qe`o{kA`a%{j=1}E/~A Ꙟb(2nz 8IrL:vSbx/n1g,4ƱsX@q,"CNI :9ZX/fA %!Jhqb`e*SgFJ4rp$C RfF*NSx2xE*MhŪqN1I=Q    @L@4`QS OJbI LS [N@ \U0 gHILNP~\g]F =ʻN[H Y.ęКQnpJ^KNHۍ%'^- ^~ꨞꪾ>M %m <ݍ> p͔P 1K͘ P N :-~؞ھޞ>^~!֓"&(܀@ߖPh ToĢ,7>B8LafP ?_ O0 %&(_*~(^N"@B?D_F$JL6_ڬ=u &_:^ Ѷ (6,3 &/`p~Xu/q{5~?_LXN_? PV }(?_/BOv ^娊9nyDdjCa M b n(O(?P$40?_?_pߟ?!@@ DPB >QD-^ĘQF<"JB"-[pvM\5m޼)5g~땪Q@5zt (DDZd-\~VXe͞EVZmݾW\uśW^}Xp^02ˣI@T+^`ęf::+Т4=dfj֭bZ]Ɲ[n޽}\pB+K0F|3SM7SO? ,93Xl O@HGżWNM=$  J-TeeYgESN:+5SSN0|XyZj%Q^ÐI%>(jL^{7_G OF% QmdƳUTh2-)-ҭo# w^}?9dGTZρSEB ӉUg)o4@$D ՈhIfi@$_ U\F&:N .ЂY څ6iF8N ;3o: i[[H0E6ɋ\Ԣ߬E8(?N@?`F3vӝg<9OÞg>Aϙßh@:PԠEhBP6ԡ3IPN'?5QvfHgHE:RԤ"hJURԥ/iLe:SԦ7M?;‡I2HF4b2]4W<^s'8ŹArWjViOS_kX:V@3AYAfk\Nծwk^@jn1Qv-%]PfdCDl(aA[PGKAS̶֥ ҂mlՒֶmnu[V']f0l${ R{CTG61͝gu߉] ӝwCfkzջ^?Ѭ0,'Ӵ ܌bQ)G_6u2p pd#u^#\P{πp\ÞnoE9st8`p$ٟ4ġucC'Pf?z}n]P`DMDA8Ͱo-䅋X .f1 B<-YZ"[ f#DhP2b)<]jj05ad p/ i?Ѳl:ˣ&1j|g|mhFg81U}e?{ڏl1[b,o[[k!؈u6n ;|؟ Ȼ[[hWq|kʟkXYN9ZY(WG0_/;&x;jpt?aY;xY,&r;])f`xW',F̶d+,e4Z6l8gdH7oX%> ̓P;s)XM6jxW4N5x k`XɳD˴T˵d˶t˷˸˹˹llY;h"PXh&]HZV82Ȧ[Of@8(c>ıbb0؄4B#U˶axVxR(WS52T`U(pmFTBiiPy`PQhQdG( 0Y85XN_Hb4c<&n'XU`e`RdUhix6YoЁ0[4U5e6u789:;uFDS9KhApHOpCZ05RspuvPe ͦ[0B2bkP#&ibY@FV@Nh(g[]e\b^ (d,wpI\D^UdA`0Pi@^o ;ZO0awxyWym4U+_.PK@a(Ж# ڰImD(T['(tPfBx`T _ yX;hX O0`*e(`I`P*Pp (>=`Ђ (%Ѓ X&`Cd8GHS]!%Q'H HX*3e@ x`e ,X 30dV5xN0Ӻ;z\6@x<XX>ʼn^hfH*p$Kn82xJu*h>X]t``[(ȭ#ESbVd DHk (kL*H< 8Y۹ۻp %;f͂m\A .$X$_]u[(XQغYe@f8:p%6vXɃyXἴ](~׀]+ %^3aP_Noh 03RW2`uxH#NT=scVHf:0oU@[Y(OW9@B5>$YX- @7xk!}Ih3uNFdVfz;gN^\4]UE?C`H x&XS?FPhHc'Zx'@^N9 xkh_pEX@pWP_@ (f DI J@_Q(N8eX8afDpMMsMeh=X0Q$s@d<>`Mg?w5R(ej>xaaPS*::D#a ļ Iu(RY0l-Qpn>pS H?pfG3Fc5КH,XSxfs8HP)XI(@T_;[=N0 ؂UaRP8*NdYЄPv[?@W8@`TU@H(_XT%^ byd 0jVj.vvoFooDg73_p&('?Mo`s58aE~nH}AV5^i PnJYn(563i?o8X7hȺ@,Rp'RY:lȪeE$E_[f(Խ 0M@X3 3~l4fPSH(_(BPsN@*\(/֍\tmhsNఝM>2u` hWpGW) (YEH0"]50sk IWM7a&oh0dhGW0=aWqd[<0(hXL b&oЁ>Nh&HCih A[H9`;@;P(fN^H6mw_hW8HhOe$@uk5%gw}Io]'9k#uR_]PfxP_0mChބC QnnEpF`4х<`bX-ALt(hdn\NX]/]PYNl 6BYՍItl9G6}s‰NQ(+W(݊fO[)؜ӱN6гLX)Sނ,Y%l`ΩyIX1aH1mҧRFզX&z+TZR%ەRJ)ШK `]a: -^EPI(Lh6E#KRvݺ%l/GA-_&XP pdJÈ1qҍs%eqˠ3rbPQ+,hXMNHX 7i#/b: 2ԻhJW|X35ʤ0gQe : J8!Zx!NX \`\ja ..v!2$"18#v`]@.2ItB'ִ# Ҍ+С!

H-Scr1eNj%Ҳ'3)#/H) +xEub (/p]d2J! /! % X7TYP2n1o(CML.QYHg'1fb1jhB ,f["]؅KgB-y5 1 u"d&Rԥ2N}*T*թRVj/* ` cXJ 5Qј,J1 cE: Y,h'ed32R#X/b [L;/Av01zX"W{X`#P,ƀ,| X@}Y/I'+ҡ\Rֽ.vr.x+"C ]1+_e(h@Ëi"u @R$cԢEjnXjP^(IOVxo߬f:ዊui-O%=mgz1  /zYBbh`fa)ۙRV2erYr0 t".z wȹi Zc0lq bW0RF.PYIn,,~a_U 8E-Ai~.Z_h46(aaUf(1 YbSpGv&u0a>6e3~6mw赋z I`|8W̤4)_a߇8Ew\71|tX1eU%u@m!dv+Gۯ#bXGp  >ڡ˗}Pa"r ȅ-Ӽ69ΛZp/;caHika s漰E/ݐao.~n_Ӱ/y#=95ˋnRhR%]ⴿnL9PTґy ઴3<}/vQ]̝tV:.#y3SLafw`($s`ҍ!M!GewloC2ߢ3ws-8JS/ʿ󋂞vRN=E-#k]\߅حB]Y9]^SY\\"ް ߈W-$p^8x=N䌓=Ձm 59!Ճ-a0hReV!- RE;BO9-Y!T-!!!  "!bf]RaU !tx~R(Fh"#E$ BЁ~(z(臎(ܨh(A())&B#B1BWes!p%P5?v [Έ%e.S>])Ʃ)Zh0i}-.T1i#m*2)&.jiChE*(L5|_Κ*^䘚j*N^*j*:*]׊h*ƈcLxj++50=$JZ٫ƪ"f+$X&%+S>UJƫ1g&UN^CکNVU^+.Šj+B$, tkZ½RYd1ݛU)ꫳV^xb,Ŗɚƾkz"\$찶T,&l00i5QUf,p^,d9+1jά~-R,-fR#x^b쵆ޭB0\Zl.FN.V^n.n.vz.憮.閮.ꦮ.붮.Ʈ.֮j- q"LB&Ü#C./6>/FN/V^/fn/v~////2#/\no/T5/00'/07?285\*2+g20 2@{hq e2+0310,^Բ-'ryɚA\2Y884g6o37w738+8d*z8)83=׳=3>+93ֱ҂C e:vrs([ҫ8A68 <4D4HH4I!@.צd@k3ZxtI״M4NB4-KKw3ۅ8Q5R'RIoO87uL/U_5VgV׈A;84A@&$V5[[7f 7\]4FOu6{8(HZa6bO28q*5_Ӵ_d?(^vb6hvI/7Xkd tJ tvEar[&h6nBv7ch<]Xkku.ksr)ASktO7uw3os lgE?Y:5+ ]}/>T<:`C;,;D>l3/CW;t2ȃ4:wi>l6g飾귾C%9?9`A4<;/lC&;0$:@_&TaC!F8bD1 `:y8d 4eK/aƔ9fM7qIɒ*o[ԩt۶iE 0IO(6y^7CI7]1qBk6 N9Srԛ7UթQpaÇ'Vq=:(ҥƩ 6dN_<` &6Ǭ{LMt*|)@(ǿP+j*rϡG>zuƔ>Nt{6N1iڴl5BksE?X~Ȉ''pӍ7߬l 3ȌкA QĶǠqlgy 0 vfJj,YO m~f ڭkh#+-Lh0,3l,$*XF4wi'= cp'? $ђчz (o7Ñ%qܪ\0͖R% TGsWaUYZs!7b.x mPj GDQG tmvFSN=ŭP$.3B KV͍Wyu8qɪD 4t'x )ׄgуleEB ~0mƿUz! ^Yna^y,1MxgHG?bs'ݽJi g&mw)AEJWavԕeN[m(N{7o vapÇi Z)BJ“]@cI}^8&ZԵAOI/~ ~G7G(d)4@ 4Nʉn!MxGm86 i|&pTxO;?_FhP{I#_ue1A\U6~ P֪5>$!AӕYJH 2WiXѻ5eSwq#^8 ȆV% 5C!:eG q!D<yc ?ằđ&Ѕ. ҋ.TKxΓ-%xɣ8+6ec döi(ܜ&rjZ䡨mQ#j*aˆ_œ :;eb)MR (<[0c"A,~Cg 0`a JX&Ĵxh($ф3)41xbKRV #gJ&yބqjZmQ>:]\є4P1̈trhm<`h]ĭ^uxbWZkLu[~uv$kE[֗޵CXmrSUءBW.rc ;~N: <#Oxm8!8<lz ;j5k!孇ݾdmt p>RK}`xġ )89;f#yY[+o- +d5PyIa6;(d,dU?0EAtFţp#pGNȚ!@]tgGNqdT~m%*N{Htc)<:Fvw-92<>\ d ÈpD)@ !)\ Gō yTz Ly$432J3,zj:aeYǰ _|#!X؁$ 9"gOCdWI` hugزi,+>iS-5, 潋Ձg`dD!J^A@l6`,D V/K,ox+jcz:'4J*f c&: YNdnn&QΚm yP MHD!A\M 0Op:,`0DaiB<"I!oa| j[FOaϘ/DtpxDi* fh dp,¼,a ]-2C4@喾P(/!ҡ@AgB !X:!f+jJb, YbJ(am&!AA$: Dq&$ Bvjz%*tFNx o z1n2+qsD^!h(!,^j+@!ё@"!sJM*K 6,#AHNh"ʢ^e`gFX&α% \e^ t` 2$ABl,CRF$KVGI@ @ a& !,?vz'P'l(āj@j'sFFm D  ʂ]C@r-w -0,6cv4n_0&j?:eIF,.3vS\hlVȏ3GmhLa>,] a3dӹjPØ%QA `kL95e9!9?2Rs8*S; CghB@B-#I=@EUKd !! Ex=- ,P|.B>U5VGP4V?0/Aa/ 4DOMc e++$edQn>eap#mB܁ *t u4BVUiBjL>cP"kvT&$-p%<| Ҡ+ôy|f(Kq?VokcWuvqÄ#B>dgvD> ">0AA(No (QBYjT~d w"3&fLNaz{k7f-VV>ϩA Z{ta5a`O(| XDlGTh-B"]? p ȊXk,2VEo>i%"7%m]xj,AN7GG_CNm`7%ZB|E ,V5.E`gV]ƎEa2;nvGO.pWB`vp0f!ZX@m}X!t2"l S&fAG2'b^B&f6y&ظ)~*[ȴ!i sa! 9AQ^1p_*f:UD3Oi%6z Z&McΎ< ODa(˰Vh QECIY4yx$FA-(U)Y(Dy0Gxey$K>!< F :yue0:Oe5O:ZKX Ƞ⁄pXrHfc߹#qo~Ȩ#.@A"!(+ f J L&yָVYwQj!!c05Xkׅ=,vW<Oa\+F(6Ea[hėej< Nb)phzDeɠN!*ҕ|=D$Y;H1ZIJ[j6Py%=#D# #!-\qZuJՌȦ(_d}* t& \Ɋ26mez ;rĠMkߦk캁 3p&M!J*2q:k{-¹ #a[,wJET@dND$D4\ٜKt\K2X1*3!iae)\cz!v`KS=L.♭EWMp*plRiZȏi:zIDEBE)"۶8ePJxyOO: Es9(ٛ0裆-$=BfR$:.BYZ Ŵˢ m< }8 4k&:ޛhb7m ;l z!l!^A~1u(JhNEdCqlUwd 1bS_ Ӂ*ϤsG3#KDb& d$]T@q  6L1ĉ+Z1ƍ;z2ȑ$Kj7_y/]:y.43Ν< MN1pQo[~ĺ.Q`(Q b 6gMx/!M}ڹs̘.cI+o۳y(mۆ2yPa`6:~8ɔ+[pa1&_VČ:=BtY0/!yV_:MLJ ʋ.cܱS.` X0ᾌ+82ۻ?q !v?KH\: b$ $CLD)M48U"nR[o5  QQ-?JAThUef!S\.Ybd1\8'3裏J=(AvC{~ j=@sXn"bLc!Hi(:W#NMV&Z5jE<ӎt/LMhL2Ar DzKo!$0VEp *+Vuv,Mr0k>*K&+DNӐhε.z q}莣n&/IF,q>׋?ɌF;YPJ HB0CJne"o?3Z&F8⊃t6f<ͫ.zq"tS32>()ƹ0p@M!yuז#J(+MZښ]bdV%7nUaxiO>  o\` ĸ1kV sh!ob2ЄbL[Ng5$36l/G88zW&jIlkA!/?qV=2#0F-vYUH YGkS6Bw"lT1Z Nldoc<ʈF ib". n$j#;4EyHcI`|Vcɑ[2t Z2Ɍky1`b`KC5fptq͕| v!UD4B;N؊\wB:ʀ_6!T7ifWa6c¶2GxpD(N տ(gal<2C+ov=J x^}ՅQ<Z1Q 3ۨ.l˫dc4accGv(>#e<3~7y>etGʓ9UP P e>'G`"e P 0 WQ r,dPi\H]w\)D|8"9>gg0 f`WI-Cu`]@^h2$95SbF@[ K p b oP  SѼ Sh ɐg"` 5 0 C6u@;z]65cX( "mh0qUgj&98RV2z|ohpHh\;4e&`4  + XN ;Q\!8Ab1ؐTwQTiasOKXc0AzaVvϠ^`{5{43B"]*3;d *G'e!ум"x8W"D{C,EHAJ5Q#1hWC0 p !`pr%/ulI1{|m1L55ȒRȚƀ4K ES,l ` b&&Y1ʥ̣|ha [L< 0HA}uɈL ` 1+Q!Ȁ o  `o 5Q5bTRn,Y> dK 4"74ah`4CrD7Q$.eݫI?u2ɻu)))x8O_LY[Dl] Yx6$Mcڰz o/: IWt| :q UN]+h 6\tV`ϐsd7܌dXS#q=̩vm8x16cfk=fdˉū A@p &0 y3cdt!|0 m9otU3`!@U* Tv#7IP|f!45 M !j&#qmY 4Wp*d& AjxL R' 0 (ߡeJR Z+S~/ʠΫX Z 3p|;r `7]ِ2i0h#Zg2]-&94;ぶQGfp @ `IRbp=m œH9%IF% p@S.;A6ERa$ȒB6=4? ȡvS4R0pf˰ 2L^m0Hn1]AʒTfU};W Q#`ؚ o0PU~y >ej״_`WТa-ES*}QW^n)C3m2i<b%D @o .nt<@ކr KQ۠ AXhQI_ c Q_zM=bB iKZ/IwGaMZ92M!120hQ`2rGcקf@>\AIIPw+FE3IMg> N^_Y: f6ZJЪp߉YeV)x{/-G洓2d@]&$`AtnmU $zT43`3 `J𘁪 O޿۶`%N85nG!E$YI⌑L~PΤYs&?"laㄎ5'~4SQe o_}¶2x:;-\v!')4]:{rN C!Z "xq'Mdib0e82@'2f aQSCc1}Y~` gѣdVm9HӮɉ2hd 'w|/`2Fj,Jeg(85R@>pvPbbb C SI=!* | Q%둩O-wzRTSƕf1'TUg r! Q~!"z2(4ʅ 𾱦w$K2|4dKtMi3~㨅jEkQ&@A,yۅ}1[¡gXxS`#/nv 5HQtR"ŠH4fD%DQ Rm$DDt ]NCp9`p?a0H(QPdH>0Ɓ g2 iP;|6 ,bF2rqp&w1} 7i8#1llcG~#AHQ"qEb~$R?Ze' Q&Beq/#Q "pǤUqruJDB<6T0 `;a$kZPZB@WG#5pB;4Tm^@F21vƥnȶ,&݉AhfV)0TwLBWJ4a1dʴxKQ~ e/Ic3r :!gx:f @jmj`~=y6яvxt";הnx͔e?N>,C,Q?fa \lŀLo,CxE)bXK&?#Ɇ\3a:_9b2vA~`{y8HA Udd:݉.*G˛1i$G`DKV$F$ě!}TO<0DQP(~b(e}xG7Paq]ۿ߳Ļ4"O4܆~Y-jPo8?{ K {gKvXeh~$ ָp }ІD!"" (y77>6苢$9XiM@lP~j@pP3 S 㩩mN!0Mj.9ꔾ Ur81y(Y)) h8x0_14 ΍i*O0%5 0P̢9F`ĠLoh4pſڡP)|*"]-7jRlTM(4xЇ` ~dac΃2ѡ`әHC@RXY$HǨp[pP2 $9ePp@PĒljHJįT[.1pJ'$VpZ"sQP%6pl8xmW9lmE,LT}8i`gHly [Qj X†\)0M!0["hX g0 H^q1έUa\ I7@^aeֈ(ӕ'8x8e @,: [cphmx6|$yk`ޜQ':8(^ȪB3Q51`nPFz 0L'ز˕_UyMhdK @|!2!ύbِ=y艱*`[ RRxa0F PdIVӓДv@dbD|>cPy&0V'"e p8: ,)*@95EeN" NAN3Hxeiډ䢟9mHtJ-єJe3ڜ-É+b5+c2 r)d())zv@ hy~Nd[!0chYFqrGx"u&b'wN9ߍzQOb:#~F*H βNy8Yhލ i!NBi"@#k=A-c5B7%kf{aV0KgX'ժfm|"Yias  N$idD(Dc.N}Ȼjq0l_p1>rtinG‹/ٳo&5jNӮ Yof :$@:Pl}XakF#_ Œ8ovw yWC6(Zn5k.h | PЖ/=;d!RH@fDF/d`?"s9O,y(e/2Ԋъ3pxgneQ~l,$h1 j ct%יgFA.2h(0 %ն& : 1 0i9f5x-GuXчixXF (*_&Chi2X"1sA>0K"^F@BW!p " Xk(> 7,'a09QyO';aO*u`[UOe+RB~dfF]~P"HB!r&r23es (t.`@[Ά0 E +дأpO%ъ-u8Je=KRp@eupۙ؈a~^@@6Fm7}vhOD/`-gmgN (Hk4Hp ZŒXv3Ws$zm3NQszbUzJwhp`R1a ~;, *:.kwʻ琼_vR|.P dM@^o{ׂL?7Oxqؒ`.5QJS&}4h;ا.@yHp!ÆB(1;L?L)uv34QjZW) YV@P  5KJON #T?|8_>& 3d `8s>Oj7d%A3f6\3~ʲSI834ڈ<7q0 qUT[T2v@/O;q`6OYPBC 3B؆TÈc<0\pA"$1)(b%5elɈ8 #vgjT 0,!#Ź}lm<##Ё!VW@/"V R! Q\v\gSڱ]J4KB(2!8.J$ (+'<I`hc#ԡFC"$ChQG g"~(;Km1]  ɋ @r̓@*B)V1`HqJ]:,&ABu%,I"!} e V˅xQS Ԫ376`Ѩ:n#ZeTKvNl'clPb ]~xa '8f+#AШ2v`0І8"|ja{[9qR(V6!îf60!TB{Jұ̡1*Z*UǮͫ^5G^Է%:lCةB0$(S!E.4'5XL!Pa ]eh-S(X>Cp 760A 0eBQ? :pC~H80 6* ~BoU# "GьwXcvÎ!lw >RxG;DfE<1`S.b’c ;rnFBNǾ R!Hpw>"sG ~LE2#xE9#?jG oNQP2%!xxu b7?ݧ8ä>PU!C8X隕Y5JC{Dߤ˹}4V 1 O;Ђ.K?pN2,@RC>2HC: (\8h 1'^z}Pȃ5DIk` UqA[z}Ԇ>ă1F`CHt^]V?$OEHC6$v%5(SFh^( [?:?5[&=ᚰ!G)D[cͅ1RP7!XX`CiC] ( DϨ?H:d!l!$5ܒ BMȉTCF$1y\?t4Hc%U.^f$ZچM!Y0NOn2 5P"z!%R6%Ń;X<l5tWBpD 2$CM¸Bazjqd^NeF8(8PF%3P'EKI\DN| ]m88-3p]mGu$ɴoCUƒ9Aa#IAZfKXFE-"&K!}.œ'p? PB͍GdF@%TRx{\ }G^E-` ?8$3D:DI8"H($?4)b%T4H]E(B鬢LK6+E")#} +MH7H P> WWZ:,ާ̃8QA:Y4\C;5HCHlȄ8EϼV4 !0䫂l-b,@BAX)IuCH T8,+QhX\ɮalL4Ԇ=^G2͏˦DFhA%B0/6 RQ f|@cK^;*Z .?XrnhNqjY+RE"7Xõ-*_mtbG&y.1oZ3'B8Y/qiq O#:DT T׊S ?e^#I- p!brXj&vj1 7|C-P"L"\@1X{BB6+p(P/J;|{ڤxpފV.ElCO!|Ds?\Bj[( EB$J@ ̀a68`OB(`C3;A?jhXR }< 38Hv1H.tO* wo. B`4B ЂzjSdEGt `4$etA?lDX cwXRPf OSW`o41 ]8.̂Mi1HC QU5Ch7<0u^Chf?nMvHCn2<ю.kvmG g zQb@((C69i[Pv=4ȴm]_40D8(64Mp=ժɃW|;h?xqCw|K306ALC$8)TX 46UrB*pDau2 Ix{vc#2`&Y;x>S7xE0&Q/DB,DTx%C+ pv,e;t*ăIlICh1ǴsFJTmRDB%DqNM(ØxtJ,c^$DEBAE'%2Ay 92*s\]8Lȃ. ꕯD;%fpt]lyz83OP^xGD($XܖE4\\ױzgd4t-F|< `:>/\lED~y;CtAzDQN;{SBsx[A2tBQȉ(mK{~cSǸ8i$.̄64t{Xu/nsz`aO?( T'4C@%LQ=ʉ2C(ʇ4ҹo T0IjRXySH$m;.3`z1af#}/}g A'&,u T*,O=Л&@XӨ}ShS ˜ՇHIt5y\0.ޮᓾDn3_GD p*C, wd6PR3RXc~%OT%YDP?\RE{n = 83ľATmyN&~Ŀ~ځO޿ 6tbDȓmq,`L"Í ӥ_p C1x/?C5J4eRK6ujTSVzjCp+q-]ImցPVɌXUQmiqbŋ ǯ]ƋgbHcdy@~4:qBxk%heKQ\:F͛rpÉ7~)€;v!ӮMmܷ|18yrM+ 0edw~P~ڡ9y>C˘$xJ/Ԯ&whs&kFvEG!~ b:nv|ExeA6Y4{FxAp&9Y2d`w dU]'Kh[g l\1aC3Aġ<C" 81$'4d/Dm#}Ўј&5&d-r(˚DžB3yCqTXGijel0!!+T#!XA 'h1X!/ GW-S\uD$]LF40mSڱWmB5D(jd#89T摮 Ap`\~G8PphHn0 8jd%9q$J۷̩=f*F*(4T yLi#64k ^ 4zD2JF6L4+4sHI-e- fV/4 qʤ2Oa dӢuIqR( >Kʧ'KÕ"n GSZWΙ҄fQFA }\̃cZrU%_m#Uuj#Zw*kζ!֜bA 9x#VBQ!=HmBL䱙} qt' 1D]* ;u(F1XC), :sp-rFR/ivQAb!H@@ (R DPD!, 3B-Xa`"YB2pvmMe aJ$ӽZֶ`.8>Cyx\aGF2!W) q8yE:! (Єy71ƭ"HѼ c}[ȑw\nbF9WrUׅ9Ud_̟r]ymf%,z#CME(0 bX E1(DA'!4|*۽JBq55Ȇ:Jy8#҆6!`WkߖZs@"En$=r_-6u!$|)g]ȳu.tdГ0ӵv(6G E$z82< } |]B6E[M!jڬrvkYA 8};DN|I8VB` bYʘ9y3em.t5Vb-G]Oq|g)#v_~E$6# ܁?b2zdMQӧXF:BBFĐdm(abM"1Kq)эFc*)Va~ 5$0c!ZQ7oJKF!4A(<8R% 4R%%.6Fc \2kGx4R&x eC۩7(вVn#aI&wcC "'ۍRAdnѠ rKb5L+<2-0/*7*7^?Ba;R< RdZbD WOkΕX55G-,deF13AkL)E&3E0inߔfb.c^;(P[ON]jA'J _S"_,n#A,naBg43; iʱp*Ir,ܮUHW=N3fJ(!4H fV'V F#:XƯ$d G"c($3$*BC}0t>Ȭn!KmaCLÌȀxDL!CFtZ[`fAkiTZr mMC8BI{0!i.`+feMP 0E(B3 NcMNGoiNcGa(I@.dx Dtp.t+S??-w!xINJVN6#!mTU™06M;A; AV/&lup4\Yx$J!f &HQ'aEʳf?Z}7UaROuO2$$7a,BHhܘeJfSx>@a%bi JHYTq5oa](!6IuZBmT% kްcc!dc2$&PRb^p)'fa~֣e!&#,h%Voy v[K2_E4B4P'&Bp4Dj!rgeobAz4xEncK&&`ƯgrS uoW]jzPh&s :)ޖq!,n!AYaNs<t_3z7kTuwZG&oɼ(q7vjVs55 }7jN Al&Dw1cBg:ڋkʃӸeA G7N8!6_*i P`!7} ~&V\%ܺ0HL gq>4a4J?+bLJuZ)ÏCK7o(|fJ9(ĵz;܁l{Q+ < Jơd^vF;Ⱥ4'c`ʺGl"|DHZƻI>/%bjH"l-6W(j-4R%rSQcp0!gBN6cԁR<*ˑg 66!!{Oxƒ{)I I.ƟDNǍ-nc&ycPtl qɏQqs%A.w³Ӊز)A^Hr M!@A4r!r/Y#aa]L+X6v ,Gkڳ7PިYT{=-<ӿ}8.(A(tas{ġh)b}2h1tjN\ml:#6w41<&٣m<@$3~r} q ͭ5S5I7{yy `G"drd )F$DV5cӏ +N[O'DB1k.T\6`{!РXe| vܒ32"&Aܒ ?1=/d JSZBr\]]|5WjGg3A ۍZUРx3^FB[V!up;V?<x g>An$I&| XUPs:`*6U5R-J%Unoպc.BA_"ꃣi?4+ H AuLi JHŋ3>xBƮ];2(K2ۿƽ93@My8mǏ_61ӥq8qҤ0M8_HիXjʵ`ÊK,UFJ ąlFnZn&MOfE۶dD+U^/@:8ne8øsͻ .ͅ\6pu?O4(e'n<ҁiPg ngGzmdyz~(V01b V$^tեVs4ͭ`X5>Dlsx17͔S@ӏ{M??IsH&LZ"ʄ}rL3C` C}SK/ KPN4Jv ZmEW-ǁM=bTd4 Ov:N.<ī5l1!C8Ӻ6 L~om 7Q84&3*y!l܊jE?}WR332ʘ< Z\U2H26p=ucOcD騧) .XFyM8zc.}#ãLmӎ5M[%zL;vQl~Y Su8}$KdL;xC>GHK2rP<8Wy㴽[%VhhTƒ^53pfPU[&WQHقY|*QknVvAG24Acpc >GJzt%GHHbL~v)P)M:nC:XDU'Μ*V\f7|[c= `gU.I(p1HSl"FmEhOFRݥd4ϸ`*j.c J:} '|Ow۸P4d1* a<5&>_ZHp .ꑩUYB<΅ a<ڰru#n\j w}[Gne5kt׉}-D2@r83X לV}'x2 ԏ2(5(4 Nɩ:Q3q;N'Ʃ CA2JTxso[ %<~QzHű$x,9:3 x$*NfICcgԙ04DЀ ' egհTGa t8Jqb00t s}3D ͞CUtP! :xE)P X8X Jh$s7mt<M/ǹ vV⁓[c`G D3#(bw7)B箑Y4 яp<`G6>L pvZ:|ԥ} 8615{ 0`7e;Ҡ˧{sIY]!D^q HUdILޥ-$d5y ;>#kgJc>Dǽgă ;#AyщE/0 J1 GFK ҐWĀcR`W+$d01;==~~&rvKP x $aKBX8=:!pS3q&3$g;.G0cpˠkG%wb8Ys o΢eYc7W=X3ɠ(%a 6=1#DU(rPuS3Zd~b0f "Yqhc6h `"l5Nt J'AM 54,WPpXWlj`)!.݅6$҃\a\H3H Qz44(lZ1rn}0FgX>PS8Y>u+ !eD6Pv9)%> 1ff( dXIhpqSB y!"1 7.эpM0 tg)ٔUPUB1Pu(Adp c|i#@pÐFr9@f!B%HNc`c_ؒtq Z tPC>a aC1S04zPf BPY+Q #8E:7b?6)Y( ɐa # ؔ:fiIh05C"#E-c)rCDJvNUfv1`ٟ4` X/b)'wGۆ:J FM!y҃T>5 *B !Z&zX>XQ (2* 1\3z8 #\F>¡ YV HN JPZ;XzsQzXB\ڥ^`V!Bdr'jJ-Vf!J3#QG⦀7" b7XA0*[:- Jp ]QY N / ": ?& iش2@ KV Īas**xz:/ Y:a`p*O1 HbKvZIb$fPs*UbbP{ ˰fk+۱a0$[&{(**+.˲2;4 ;a<۳+D[F{HfN\ O;F5{X#2xs  :d;z.eKnK 꺮2t+n{UzK3t[mkx[O(ts /[{5'۹J김+E1i b[g9^cda!p+[)rkzbѺb tJ;ؤc6-a+(90ػ%+;--,һ!+D.&::˷Z5d1kZ ޻7 aB{n7b2iA ʼ9c9A ,_,"9)=ļm }#dz' NI kcb19!aeU"iRnBL){,G; Z4O3$#uĽS,`F^:OB 0i#ZLsel;=L?ƕdľvB Q, S^',Xl9A,c<ɪqȪC60 0`. }pS' e 1 flq0`B { r`yP *o`jSk   f : Hش.`M :ό t@f p(Og ih} PmI>i6@  =: } "E0 @  ʪL y ٔp y0   Ő `Ҩ@(!{05P 6   лMP ` #a٧ƀ l  00 F}DS pـ א06aP s ~ IGMX% C0 f -@ "w,=]H x 3߁> ۠pX p կArP -M/ O 7pap M'`軱}PF8 o Phk6ʀ~'}  . и;ҫp y:rđ }P 23N ~ fṕ 򀪫z' ,]r veQPm ĐPo G !:ѐ 0 u@oQHث: {Pep! @ n eb #/! Ox@ +@ A;`ʩ:p0n 0ֻ۠ƌ 5E PSP  y M Ϡ o`X` GNϘ5 ]B'P pe A}lsl3x/ 5;e1* Rݾ? o@ ,$p/ydA} ɀ x !x^FzA o'pt? tQPÀJ!VԔ㻱(Lf$R.pP 5x m?";`k `]4}- {% -:с"0 oP- o  %r/ǜ2s?j<;tWgu_=v9RtF=www_V[Qx,+&ߧJo'^4kz{g_qۇ?~h~*E^~`>~U.r>o`%8A+<0|Ny.#S <e#XKoV@dd!<H|RDֈg bLِ#N8PkX3^@ 0A% 'D(DJ<@&5C4ktu炊BZCb0_`Zd#)xG$PhtF V$@ @Ax sa GNqCD!Π7XE: b6HA(Ix F;.R2xaJ?Fϰ1C ` 0 ﺃ&eI`DL!f X$!Et T*A8X<HZX  #3%P `@ 9pz AFlLG\ӞEraO3AG)`|#E2V KzCXE3C,H7`QZć)p>X@)(9Phd LG2\'X8JW

z¨jLK|xL|~Xp(NW' &-BwH )pxȂxhHg} H3nX*'@@z P( *W@A0H@0SOHGX5` PQ@`F X Qwo W`:XU0ȫ`` Ͱ;$KEgX:o015`'PS`qhxHxxp|pj(ă0xP7n1i,pqJ H|fpR2p589 zH`)"!p`ӁWVЁ5< y"JItXRYvC@8]kBwX˳kH6Hkh0IkQje9't,KuwՊES XymOty҇5`LX| &_xhGw &``0=A0xqe=0 $x ؃|pVk_x=x'P4sRפѠ@={ßw32o@vm3Ho#)&y0i58գ[Շ-lRo0lh@ix0\R$xg'S5]P0~ U~$X xXM&M*v%Zvhl:Lj>G}Aypp'$^J0š7i3`pkwqD!Zj[ÆFMCix(`̇겴|R-}PqC1>p<\qTrkhiEyB& AqM!3tix`銐JU0幬l$rd&бtX uyh&|iQEҡqc ϔX9'$@'A^\`Fgt]HIJKLMNOPQ'R7SGTWUgVwWXY^[u\t^g^oac7NC[[hAj߷`lv _ߚ~{\lWqψtWwKv~ Ј]vr's_}wwwvA.IP?!pxx灌0luox_vw ypyyy^?O_oyzz IWtZՂFr3xx~Zhg{i {mwrXbx1oID1((xe@@ȧ|ȷ̿xΟ{'7GWgwׇؗ٧ڷ}Z[b 7`&0|la7R(x8'7GWgwG L R 2l!ą pC"\$Ȑ,i$ʔ*Wl%̘2gҬi&Μ:w'РB-jG$|@UĨR2(! $ᐯF+ڴj-ܸM+ۺu/.l0Ċ3n1Ȓ'Slr`]l W6FxXPxI |Qci!z!!8"%x")"-"18#5x#9BFkG]x$I&M:$QJ9%UZy%YR#`1on f/k#q9'uy'T-@+gRŦ[*(:(+c[F!)ٲ- 0,,,3LRKB .9c-j ;,{,*baB АztmZ-z- BѴ n.;o\VECZ0 <|p!,pr24D[!;z1!\r"Dy$-pG.|3s;/%B0C@'<2?3B Ax铞2'( /*K%: CؐP,x 1BBZO"-c(P|hd`)T'HFP⟯>nCCDBF _P(.@  Anv ~gRx D"`0 F y"DA~+{2 @" ;wB!:Q@n5It *oJXd`iG ¢:BJEJE#$VsՍԅ[ kщyļT0p-PG~5xKpɘV$uPļ6. Az"vo(R -yʮE ZR_O @ښ MP(ըhghbaU23  W̪S;Jd0Y:+U@Z%3{Jlvx'mM^lMwmڷ/nbwߔ:[LS S;Y~?4! v`}[#LC=ck Rq`-&SNSQw/2UcGF0d( $OYu<@j1W X6NT3\LVPd>wÎ&eC3ILhh ?яN# 7Q{B_0lӟH @/xCtR|^l]6?l`?ilЇ6=өѺ5u bmC[typzwяy͔Ie;Tg[۾n,}?dc0̖A\"ƀG2lm du ~;F>hch8r,C7q{6zZ6C'?:=Cz2`81 lk}=E?ztg&ܜ04!h̦~ 24"hrxGmoF[B9[dȏ*R:i6i}@o 㵛Xoȯ >8C؜5|0̝ F'/ ²z#^ڐh6Աvud?:Q:p@tp-@xKk}~G~~ UGw`  A;mr _rtfAG'v ʐwQ7: p @x# DH~t'p'ւ -F Q d][w 0Ƞ!# WyK\2 >Ё-23{TE9!| uRc`Gz\m} ɠy7 vzx؇p sG]y~ qA"H}Aoȉ RX9#v,Ȃ-&azg dhpF 'AxΑbz&rPr0]#H(;7v(kȄ/z7wuЖiG!vq.nX73r/Ƃc8) Yt/{(iDyum8 0wvIww 3x tf0 YӒOpi4 kGw~~⧎cwA 8ˀ` B`0/3-pd@hyvfI<vW] 膹gyLi'lR 0~ 'ǑyI IxАti`vm7̗Gad` qiU'Q a9)m&ll< ]d>p 6! 7Ki fld3&qi+d\/p""A癞P9MH6Aw /~ziZڞ%'o%ÊJfv'i“ MѠ QXuіy@6 8y11+"Hc gCx~m$j `1v" ^bz/Afzt#iא9Ϡ wHa i)t{٧7P 68Wc I:t|ES l8`` 1&M{pCӠ"2n2s#Jyڠ 절G ⠌#xة ] 3v1 l,ɣ DJ:_H^sp&& TIqitڥ *y]* 1 0 `h~-l qX Fty' 8yP '*00AI,$ڬUjAf*`mЩLW`nF>9)܁(ycs= v@ dQ,c jgiHKژIwdh:tmpae7tN7mqfq o0 &_ѷDag٘T:m >( Ұ~ߖi: /N´ 0|>( s2 ;4"iQ}.VMBgӠ7:8w4ΚJvйe^-~/g}Zl(   O/MmdYw>%˯GCG0~*vJѓ/ Τ4+t>x4Pqp0 +w{:˂Ŏϰn8t Jx&.m|K2t`pkX^kN&Fɍ;'\ UkHٽi>H^`u 9i0N**hj/$_~'m ͹:, /Ft:w8/ א Qr>gA' p>zHv}9 ᧉ m2C@ᨈ<E]6vk &7|Ydְ 4?)ۢ}&ⴸ< 0m9ߞdC6G󾐑e ;룇mDxi#t;` # W {zlB6i.:uC(/q"LߴiCMv3fy+9Oi54@L5męSN=}TP>OoK27_QURV] 8}EVZmtO6N[j1 xهF š/* ~N*I)M$0F5Cy.&Ng)6!IqBE2J2tԣRGi|`1!ӝG5yCBl`LqEq:Ϝji dJ:OΈTTȱ>DjR>khmd'ihm''TGE,0¼ NGEtitIG,%XMxiiX Hi PDkSQ7M~@͔SSUEmѦpె92h#0q\;Wp&x&dO e|XFgG]jqE7͠TgP4" ٱ ǚնkkcJq+cfCjy(jMZ30'fq@9TMKNfR{0I:jT\fr:n>{9yOVlA )3v2˃Yca^ᚹNrUDp.'ȓT<ߌt^3HP pI2wuk7%j N5*Fk"O>vTigJ*)O.5mN39cL%c覮*mc OgӬu-1 tJAN ȄfCdnQ o*Ӆ`YTU:)hjɀ6dDɉ6f-.*67{IqdSF #o ij6QX. %q.@?lTЊ@ǁҬ6_= HD$ae`4gxmVl!Nԣ` N8 D!xy8L]E?8GWh^pE[5)0Ʊ$/)=%Mq)ŴGhD(uKKxmJ&>!{vv ԎK2J4ט/ :\ͦ2c6 @Ƹ4dF&u`W 6,`?kt"j^ b W 4 _e֩(ls>L'-sxXCˠ#!$@j]KpGӐJkO.p#02IҧFQ=pЫSig+ЋpT?X\×kTmH+#e#S{jCS2TX6Ax3pt5rc2{*`_r50A `#E67?0L0Fh<ފ8*E%xªEH,@ } FHrVAQM:HyRQ r3ptIE񈙋{X!0%jKN bD -ϙH"d>= EͨD#^˷I(DEvA'wYt62=6O) 5_eSȔx%yjnw+@F3xDu%%o6}ev_-@20LI٘n|%yK@Վ.ni>!sB6b+?3:#p+gg%88 ep#`0jn04r2X@?9*t1pi1wxi0t)܌H*)#cx>>P!4ܦY/0ԲixdH*C̊q.`n݈kÇz::*  2A-kyAN f*V?wcWDt r F PIAl1 " d_ram XvFqc(kְDJ +9= +3I65xq`a3(ljljx.HGƈKk`  H!)9 G,&Q"(1鈏` ܆8lȎT*|}OXJʡwPy' z$.r!xP?s4#9a^ʺ8ShP $$hʼnD1B0*A q#d- ˞BM qx0 HkvvЋAXk(dPPZ-sW蜙< |MdoЇ|JۯݙXE{uy(Z٬"[}D|=}x ًG[M.%QXX8`B+;08~5̇Sr]]W 72Xފך ,ٱ?`Q3dzex݉g b@dr1%dй 0|(:%ނM]-i PM5"! Z0P$ah_M!50t mHyP ֆ b{Z2Ɛ 0 `9 .AQas}bx@$e`w Q) 9 q<^C` gr&M h9ɇnQcKlpB.9Tj5bDa`hXkkЃ` `\3 <b xPR\Ae q$PyQyTlefڈ1YR&AUBD4i9*WlPp` `xX> Kpe~`r) mi 0hv6 vWidPS=o:ICJ|dmh 2aVq؄XaXh+ɤhxkhJQ0 *ђ_xXl/wpL>9^ig՘+>z&jƝTܔ*liꭵ=(U>x Uʢn5u(xWB :aяc8( Q\ N1 ~P~^~!bAhK˥y~Z Ԇ>CZH8 k(@`-ލ d1xQU) F3;>0( _]fc!i@pֽՒrfmQvkn꾓-oԘIb&uWRU3bHV7*< WxmP@8D(W5}9*3?ʠ}e xPd@Zdq lXmm-A,p%ko2P`muk`FX]XmpoZԟ+=^p%LӨC'xۇ<Q8DOl?@`8sqؽڕ-ex^\i>KL-F&4p`XцH"h?g7gxZQ@'>  xBW x8]ZJȃ7yt 1 x%й4p ڽXQ4de`ဇb؆`LgPES֓1QX68a\lpªv/xOrptAgq4{\j? $mvpw= xP'vrupkh/ʇh賛yE k78yX훰G7vZ[04hrZ1; 6wx" ޳ ǠPv'%i>U?DiuX45 e0~h4.>)˾ N>Y{[) `U'ZHxf8Rh\ʨݰ_9XZFxg(aP],h &gӤ#c6lC֯_Ay &gc r$̘2gҬi&Μ:w7Lv۶(Ҥ52mt`dإ m: 7n}L mɖe .ѣF~N>Q quN`^ Slp0XZjnMJÊIÆMx&'VD^W=zT03LVl-mkgz;ikKnͅd}$r?x-o=h7h`-~T*|GTV[uUaEZhm3<S;qs^EN7"B!6` A"I 1—fpg0Mg70$ P4p4O,o's )Ne|#4 t8 y@S:yʸ'};c8DyN(6|d <\vd4A6f`2`d\g2`ϫ I{舆yu?֜t:N4bg0QJ-;ңxC*R OA bc ȓ #o 8?cG>s3@h A;0Ŏ _ +Z rkn/Apz45(cD`ksG]}YMSCծHh7O<8,"V $r{VնMq;w>>`7܄</c'.nX5eH8k`:d@Cư3cu`9/F?GE] <%+*^qLn p_'~ ƶݭ0.JذtX O!*2[Aq,Cdp5#yt!I_QM1 ! l;kIEiWŃnDq{r,F &a*  ;⅖Մc )>2ڰnb Hq2˸xŒmv@v~KCx4d!r%H_'s" #NWDL ^A) WΉ(󘇊mQ0(TuRS؆,a4!ܨ2܁ -%|2DNa3`]4``¥-e_ `Z؆VDCJQj;Q)2t*\sR]hGE}$mYPb-dB֌CҀ.22*)JP/E-XTx(ªG*N0` ذ+QEk3Q`(2⤁Kn1'^q]Wԡ ?Ƥ>p|v-Ȇ4.a yd;xRf5,yҨܑ5j92J3I6 _A x2Z-$*3R$D( Ğ J]A]_q61Sy q `\s n ]@}C/`cx!lӸ= ~,fi 7 F2ڝeIWY"ӱFh9hrˬP"&;zEd1ƻ2-XVtp *%woJPTWE+ ~U77HC않*I PMA 9(&/htV w\ mϋNy[Hds´@igB#?SC&㡪ac9MQ{L|Ti+HE1z{}I\zLn5<,ze\c'r{:E<w|RD;M#UC+C6hyg8('>\l] OtH3`t>Wὠa c@΄@lEV%-œ 1RHQdYh0K$T: üɴC$Ɨ=21X3(\l%)+,[Pq ?@DKs2|b<6C%E!)%A^AQig]J\XtZC> ^IQ݄؍.*eDC,C?b: Z9 +|ՙ̑QMHF@@DHxA.p5WUD|3ŁZOW,*C2)PΤbXF~TA-Ȃ0 2{zV`XR$Z9lO &h+ԋC7v086 a5|Yf^YSǘ")8h/V28C)1H^r,AKe;T ɐ̂,P%*,+YD 愨*-G`C8P팄dZyEAK¬o`aZԢ,J 6EL5tQva4DrĐr#B4f. 1d5xN"t; `=4!9(p< Ɖ& ^}x&ldG8! v 4, -2DPeEuR2FyY˞>YlCPe@" 6G%#7Ckq H_}L H.gFՒ51dS1M#8>U0gHUl֨,[ݧ"HR@=T*5AI&ornjׯGP ѥ*؇20@AU*2fO*xGɩhc`u7` &bTt鉰Ba 7^@z33ByXC  e7Y1}KC2L~h 02`vK.\)% +|*,N "-982fG,-?xblh͙&/ܐHidyZIZа!@;LJDbB/C;ړ>2+:Ϋ|(# @p^ԡalӞk'tG20ev_hKKpfe1ycCnm4pN#D^-ޖo#R0N 3%ELp \A'h&rOt>rsvm$g%qR_Ux8Q1rp8盦v? 2MW#"s D)H ECo 5!@|`ekBU='jQz0ڹdT.ޛ<6%puU:V߼ +8Svx'K2^i0W@ݐ0 V8c5!JZ h-}j&b eDzl JlV.8#'hE0L}Nw,K0COv&Mִ pK r*R H#&±pϱ*r&a)4 'JA:"aAPo&A lDGҨK..6̢ƀas!a6PdB2sd:U<*@Z 1nb."5(/c J63' 4.6Z(#h*! 2?6(ؠ8. #:2U>A@ qA#N/;<aU,a(JMcԓ%#=">.v8K?F\D@r3D̄FBPc 5D|!tf!"`ؠ_rnPޣ8K6MP}&Tid(BrTJ1 $/L6A8i<e+L(ZDƌ[Ki%ٌ9QɢQfLu3` ($!@ J>d(733"wVQOÁU( *$jXD(C(&.DI88G|h>J"4EICh(IJvput*!?lDI&V]"#y^qXB P3)Q'ft2$&HFe%M2UPbu#"5zJcRHRY7Ta F@$B FQak/+4K'fãtFAo4!hf{a>PYUT~.':V8neу4<&l%12?fVZRf"kaW!I E7yt ϗ(ZU!`!JP N6[DŽ+Aʳ|xL ƠRchI5x%Rmu&Q>tnga,FVaA'Rq&ns`y6R F9N! .$V&a&+ `|pjEf2fekټHyLRP+JBk &ChvUf8*󐋤i8Y kBSXcU45b&|yJL`8b!K*"f@.,^c`na\&H.S5&IYǹKJ#0ciB֣Ah4fKnK9>}z!LJa0|R  ̠aNXAP!\ ٧&4fAи#a8oEؐ.%ui¶cBIͣi|0-y.!0g996oل/I I7 S^Z>!bb& ̻ !.#A01/! *0;` DD [>z,1x8xS),cob*l;p;< {UkamLNo-O fxE7&m"2Cr,,`)r7FE̻è DE4F.ActLAH!"Ư#qjB0q\O笀"oքu`a4vK% Tm-.vhU6 BdɗN!ҧf<|ZI[>Z^ikCM>'=hdD˜VҠXBvF|2y鞺tӍGE,J!!U- `a+p'jo, ]A;)7ܕmf,%Pŏj3d4kMNB.Ƞ lwsݥAE DBw%BA.NFc\XqF" <0…`pΞ=#cL?uz(H!Ǚ'2Hq^.][_q@ 4СD=4RDF]>l#,K˚E,Y?~-#॥I҉۶޽|i&L0up#jt`s$IYyi2ٲv!L`0;ݼ*u$V#KzV;k>ƶ]gLJ7q0#i(bw}@mPlL=d`aM#l-`6@SQ@r? I4NlކLl6\C4P8b>"4I`!4s54CMcLUAie6A7^T2#2Hldn A?HHpƔ.tP4'L aFbJ6̓FX3 89wA \s"94?M1Ƭ5]2Xnʥg%h4>5Uki.WpEX!B|ZEC)L 5,Q [ 5π#eᾫח9@SM8rP Fc,GsZdN (ȠTsD}9N;hÏyP{R٘Wɓe o#403MCSmD vR5rga͂BS<8J XsDL&]>t1kyuC tmf2LeT&XRh?,ccLc8Gڗ|[ 7˓Ơ6gJ4s ^<^h9FF?&9?,i#,Cq] ~DgWlm#e lƐI?wks3HB2.ɴ'Ȅ,&l, 2c[ #Y &~Ǐi8#6m!A3pP#/a ;w& fIP*Yv?e*2,`7c@ +B ͠(c pa$kTQVd !*9fydy }Tk-Vģ'?Y $d v]cd6{{,Y>X8!@FNzD O)z%_Q XC&GN36 PBo ?rh _GZk`25.ш4Ң.̄S;ymsf.j(@!;k4f49Һq8^w%ņհ X8*Z:P o`^Md{Ꮢ1(pc(@m`Dl]܈](7Po#k!q@L`bo;PM\Nڽ'9÷wQ5 2cÏa-:atxc2Hq0yroLātcx80XԭH+fv]B!st #"@tA&jhiF\YwO:7 _!p{qﵩ{J m 5i5X^0"IϬ'N\_'9=$26% Rf5tgJH/ `o > b Bd7d}$q*Kln(@*qc"xh97A,%m F`q_ t #@  rP 1a.DRC 0,fv,cTd `na6hoPȂ+Wj@>OP$0V'>d-F!Jhg7Oh .0 p 1PC@ʰj fF(g6%B*&&`bqP Vy!DDR#g٨tՇ<|Cr q. yP:D, +6:7tfHd"t SCHhvc >0 U u6ir12h }%{Ўa`PWx 1p80a>DH%dR?X;90#1 0 %Eni"? `h#5Y%PIp/営) I\`i) vDx#m84-> ɠZLcj1+ pBg}|Ӏ:@2@3u /jnU*  e:Z`]@$˰ $:JE41ꦒ~p y ` @ y0 v.s.d"6!8GHF$ ö E6@&"wEon{Q-0o`0 pf0fc+2g+$М1vـ:3js -Q uM+#IiѪJ+QzZ u:Z,V3NUFD@ P/DyJb"PHfR jq ]aYFX1 @7g# xʘ^ưI9 ? {, 8.h Ӡ0 0@"&\Ar k{q1A" `\/=a3Ҁ X0 Q[^֦?k_WsQ d≮+V6qbW17%ɖ~#_,0i1<^F )֬zˬi ac =hg1L'],w #+|ڀ"dR P-kl$x;g7;Pۆ PqW{l>B8O7*@nUVʛ~l !@!kKiXiVuqp 5%cQX{᡿ ~?J0wĘ :y{K7OpI7Cmtm:0/d=)7k+3U6\5b: q88u#1Hujf7>Bb r@7g>/a ]'2;vLʽږ=) @CJ sPzh11fd4ܩkj 뀞2 " E'\,xs&.j{ (Rvd@v֚EVcZ_@/ Ll{!KtӾ1|+Ÿ6ByZ*Q< ֠ILfadIȔc!\$TgCE@Π)@0gdP }*d E%-Gq  p\wP kj.r8f+Qe{ 0Szxy܄rxYÐ6ŋ70q6qVlr q)JY$6#}e) v 00rc=؊ ^mD|"M"Ŕ;"+-kͺ㬍!ɹ d asq66x>5&/s@&[$ 1}DЎRXjö&A&#!c3`ѝ` `7 h C _XH-wamʯC6c1@0lef̞dM*xr$2I6n/TH+8o01Ta<4U26 곶HNᔽUD/H*f@شqM1b-1]&@m旞hp7$m)Љ?q6 yNk5IAsXq6)v+;f dÂwWT lȦ2>- 9s* *Dg-<o%٘ Zn,Ʃ/!VylP'mUܐ ;[ӰT9 BR㊲ 0>/[}hQ ?Q-@ q$MN>3$ L( +='?E(%%1?_ݨmq /# RQ YDK`&N,op8'Y4_/+z 3/۩ZWy}ŢAr >` 0T< i` p"T4/ / QÃfl^9}?i3W}Ë?$ /K>8OJ6d6 c0_h50`֗JK#Z .W0ÁAXE5nP\@]t##/۶mWsI9u4O%3]߶8޼}*ʏ(Ay\8i>L۳t yΥ[]y_8Q5w P3Q8qe 9'|(SofؚUښ`]'4lagkwctoW]iy,7jٵow[`B$bR{ *8! S8nH.GԒP;Z;i ~<-7wȘepyJgDj&xyȐeyFsqG{#Jy\ң.YZ XDyѸhw";WKf2(Qx]&4uLM*J3n21P pͩA_ʞXˉM! %M }M76PY6u֢l,A) d 8?@+y Iۋq` ~ 5?jvxx}ЇikhӼdЇgR[x@*Ž=8ُ;Š;Oܻ ygЇ?i,@.` mpB9( ajR.cB+DJr"/씴9ʋI#B5\ä+>Qۆ?Rvj+i9 +aC[-XK)y RDe\F#0M[ ҼT4]T-U}؞eE`(C^<$p#Fkq8f B`82Fc b 9nXl\vPwhƺid Z\8X|𻊏pID[cqRAO?- Cљuk#ux $ lQQG= TK ɬ}aTD|KԴhC15 }Ї@ |2: 2yHmeA"$yC!T6( }!=yK5EB115)`lT%J4L ,X6850Xwp{FE̎;v b<g+LMd2dMsF t9Mʝ001L1C2eT#2&xІl)(a6jJ<>ԙP -<;HtGMؤO$ 01h }ġbFERAs@<8by P%I+¬M8 ͹+4kd@|C0$ "&xk1ܑF!oG8I kx'%-T O' $6O Fx`eH,(5AZJBeUJh6e0TUw&ՋtD0:(qB@Ge4$Bg]iM<۸IO ׉x4 w-YBԻxdd;x<FHHw!*ƾ\ܠܘ x>6hq-_C"W~pgX/ZSiHÆZxB0+Y͋g` CS-,s= ׿Dr**JZe׻Px 6xpO&g*JKT$kpԿ}Z, p4 Z| ɣ3MEBYh`eM`༇Э.xS Ї}ԇpЖ׭Ip@Cl؇i1s Ԝ] jrS^}aqxChmkM˽+ImЧJ(A(q' 2X2z ,RE-`>ʵ ݇*@ޢT. 0t$,J9 :liA_wae $/ra^ .E`i8tRPxFyXD1 p܆lX vX0 b-Rهa 㨉cUF4d "9HiGdЄFX&V̚q8 MGI)8 XN v`gTFU桡^ <{F4'b=6:2 txL 14}tHw Gğ}AH9PĠRmN7CNUFP'_u%4Dqbm.XpH$/3ߏu *8 G2DQ9!l}ޓOV]LR~oHNM㛌[?&љgO(y Gk.#+ffr&!b:[mmj`881 v`Oc,~(i? Rjι+ PW+?# n;%$rHꪩAG@BndkP.{ dA⎃yݖ2o1C_\$?)}W=mL.p? I 2 @8Rr8 @(y(VX!"jDc) %gX8ٛ`E bz50oȈ#%! yr@3WH+%57Ex$YÊ&o|aD.rԦԠ" a6?DPp^QP$˚&G1+KZ0f̈Pj6[ b\D_>YLc }-Ա 0Ht~SIU@:^dlR4r+!md#Fˀ h>Kex>aP}&0InMdp0Do E1G2q#(R'}X#H/)HAT"=-a).hd1! B`b(OWPE& ZlC[KFS$ ($Z,<1bfg8lX/1~|%ŅƸ)!ÃeOlYI-24an5CVvv B,< D:ԉ!h1NLKKAS ׏c>㥠W+?d@Z%(c7H:(~6J$z B`#DP njKĨCh *} cp ŸKP%&dZnfo&+bffniv& '8h^ Hg@δf3&ĄlnmXjFnoxgy^̶C<(a2? DC8K13胥z뷂ke\:H ȂB*5hµY>(h>Z :4G ;tYDMC24d6X;D@ž+<䃂ƒ>X ZFCl*4C6L ]8ح x D2H@%ȃ2\k'ĘX;<>hlrnz?'<;< נ Dm@-dC ;DA4tl7TB'$ Dy@ +@:HB7:^"D C2k3@d}C|*8A1m,XC TA4H7<C.@3WQ×~nV<D,C<8$Cx:D;4Bt)NA%,%"t:Pp *kBA1PB-\B A3}-0A0̀>' 4pCpC$&!F*mk"p_ʶ:%,颫Z*H* 8p00:@V!,]#D@7P 0?PLX@*@CC4[50C20X BHB(D(+t) C6`<58FOq3;3χn B>| j2؀$8\/:pr$00polP BxC ΰ%k7\!P $A({ l0|)s$8 C2@D ;9`CFKC4t0'@54}1p234tJtR>6`C><RJU!y C/:*DBTAFDC$KY3+DX7A72 S+GG,B>)1B)̃/X!J#vb'vKk6|ùBCH)ЁX Bu9{2T+@D@ ;PAv0VD2<l:$=;4[oCDH@@!$5dA07D1I1bwy1<{&?m6iMD4sC`CX<\,\365<,H<60|sr ijC8X6L™NኻH 5`l>9OJ4*}Ct8l<A3&h&6`AgBVVWXCZdwšSa4eA8C8C^!8KxyҢBB`%y%DybSd ь7fcLa<9[OH&B9C4zKIܣ;ߊcל`'HdE"zz^Z:^ntį:EFសz:yF4zc{oz}z ;_{+_zTeCRBY.{[Nk;_{Jv;gz{]KJh%{{ۻ;r{?;{ K Ɋ?qiAY>t;D06O ?\E *B5$C< 3hk=N>$,xM|C6T07,@6 ~T'Xx@(dź ( 8x v=,>Z U}C(e 10eu[4JL ߠ=$īxQRsuղ .7ߺysmZmYK2eDУI6}ujիYv:!9(%̪wkFڷ/ޫH 1z lRfU3ұfªؠ5 R$&/tFeakdfc 0uv&ka#kZ&xi7&gmqR>EM<KDHfUZxt3e'}`8 `_Gz *a x`L)%ALFɦ8эVwN xC=diƗx %>-Yy"\ MJ LUܔN=PE)yAGdA9GqĄh\AwAK8ƌ$I)Jx1Fo8q' XhNbVBayYɧx1floyɂUu_xhbH'҂4-5TtxttCw\\%}نVS&@qSBĄWIuHlp .N{=YS~ȇ ?Id$0ZH!hVDk¸uBt:Ua+8q,%MSD__{S8zGmqO0$XJ  @!Pا|ymqZV:e YEy0-R, \'^q'X Lq(4Gqb?tIExWlAȂ~&S#7uh İXz@)x X" Q*A P?3 /`oC`B  )(!(Ђ h8X x<^`XF)dAXV!.b;F7q @"` (Ƭ#xclY#q9a]jId0h0JE2QVD?^8c `hqIhF?X $BH)kC J[aX]8əY4B?qNyhNT #yqpBȉ5/*q?ā il 3dp\Hٶ1qcĶ}$K%ő p# ef Ul,OFn:dEFk Eg UjYZ׾li[[,խHґAcKe5DVƽVoBUq#衡ayc_Izp4,[Mקٔh 7Ԅ=m_ \ 1.c _$=n^ 2ckz)!psUx@68ڛAC9ycA\d#6U[&w!JېWOe/aL%̌(7 "mv5@\g;yg?Y`sAق!WhG?ґ)]iZf-MF"a BD跐`u~uQp)Wpgh6+>G a!0F-haY%gҙt?.9Kh5s^x)^dx#Fq^wyw _xWx?ߎߗ+;DHQ5![1kQB-h_{y{_|W|?ї_}_1wͅGH2aDpa磯AAmC EC"/o$P P=b@PRkbKv"mo"<7KGSPW[_cPgkosPw{_10-DT: "lP"T I0  P ǐ  ӰIh&a@ R/׸mDH 5 Qk^p!@ ^!%z`BQ!""-e Sp!`pcQgG F+ DAR F$"JxbcG?0!`qb!!@M##hۊMב1z h!/.m w!rc @($Ā"\ !#;#92>R$G$K$O%?!@#%0$I2!^R!k&oRT !#8!B (R@ @ (  㪒*À R++*,+,2,*˒+ 2@ -ˠ 2! R.2 " B,R000 1S1112S2#2'2+3/S33373;4?S4C4GS33N,@)2 H!bAFB P& ! ! A999S:::;9`/1b`< " =ϳ<B< !>;S>?S????@? T@ @TAAAAB'TB+4B/B1B3C7C5D;4D?TDKDOtD;3ArCP!^A1$2(A!p=ʼnx= b6"pRIIQf5 ,a!A8"TKKKLTLÔLL˔Lo!F tMITNtDR!^SH=G"Z QQU" (&!Z<5@-V`URGTK"D-PQ < !(aMWsUWq(4G1MScVwYUYUXbP޴nYZUG( !hZU\uR!A ]I\U^6 U`[a^_q`@p`VaaG `Bc3VcW b db-v!6VeWeGBU=Vdc6dCHQ[gsVg1"RjughvQijvjVjk6!,Hm8H*\0!)\#BEŋ3jȱǏ CIɓ(S\ɲ˗0d8sɳϟ@[ѣH*]ʴӧPt&իX1WCKفΪ]6^6 ۶ݻxIWlUHܸBwǐ#K|4˘3k̹ #*.8Dxװc˞۸s5[Ӫ[Hƒȏ0V\iνڭKӫ_Ͼ˟OϿ(҇L!8ofYe7 NpÆD0AD=#(0*U4h8<@)DiH&L6$1D &DXf L\v]j)dQ3\odC=-C@nG?Xݡ‧ݡ裐F*餔Vj饘f馜v駠*ꨤʝKRJIfi˫*무j뭸j+DbKa8#y`#5GIJ!r 55C+"juPz+k,?'0I M"+-WLK,gw ,k1!L1ֶ4Q8wC22ŰobL7PG-TWmXg\w`-dmMW'@ tZG--vl|߀.A',F! = 'Kb #T褗nւ.n/o'yނnAoTKzng+½s0/S.8#Ayje9sHL:'H Z̠/Ⱥ7\#*F(L W0*^a^B/l!BY@r '`ȅ_"qH*n.q.z` H2hL6pc3mhγv<b&*IBH"F:򑐌$'A0CpA[0F̌@J,bJ,g9KqKnWʒIbL2f:Ќ4IjZ҂"K,X2An%jDX @ -! aB>~ (@*ЂMh>І:t ͧ 1 V4:ftS.JϊMJWҖ4f:T Jz{ғ?iP*ԢFM*RԦ2N*T*ժRV*Vծr^ +X*ֲf*DS},vBeʼ yB fG:FMbXVjP6 i\֑fl`lqEm? : 5"bVaInw pKMr&,<Ћie910|P)DR 1Lz^ߋo_Wb 0Stg ,;'L [ΰ77{E1g6mEvNff/ -yƔ1#=q%I ϐ(!_1d&3Ǖl$c@ 8t&L2hN ^CC.{π 1"sq 5b/oU!WbHEyk {Ӡ3-RzPUgH2Y}j!["Ђ@@j "IǸDֵNIQVdImH"՘rQmIzէMrNvFw"I5[?2)@ ,%^43 xf(^\Ƥ8)M;#gǰv5GqX_(,aLL%-@Kh"Nw'x?^IX(WxOi?EgzϧN[Xz=f0zE ^ϨPFz]]2F^{\7&O!'Y >Q!N+pOxw ҲF0@ K?p~ۏQ L@~7X~ wqxqx` gz'G~6&؁ "8Gw{lgz }% q1d}wi7 9(qAB{ 8 GHJq>聢@jR_e0CB NPu 0v'{% qH`8tXvxgE{' wg~|v' 8 0 ȃ=88Xxxs؊芶epe e1%XxȘ8(UP }dpi }U ׃&` ^@gzR芳}<@kL{N@ +׏>( 0o}8臠] x ~ؑ] "}%9k*Y6yxi7 I0 q0 h( @ =09 0I8\ٕ^`6s9Q~}eIZN\dhc}gcI pw10阘9Yyٙə 0 ٚ}I  QNvxLL NPOǙYP 8wiٝ9Y Iiy$)POQZXdp>' 0 = Q i p  fPBijq Hb3`QrJ:%Џ@LpP ljLIp!PR:Tj N0ZʃI ZpH=JT >p< a 6qWrY)=IpU: j Qe 7* Q4Pʠ QI`I@ N0 T0sISj᫺* wI   bX 0pޓ Y0 z o_b 0qJ} pP b8Ш @JLLL ~ a J l4pL`@ Y*C) @ Iq1kﴰ > N >+ j 11 @ pSp(yH >Z;?[f{hjl۶nprcWrs wszs۷~ JcZ+s~0l0 tP f@l+s PL`ipۺ;[}GW˺( 3'c PLZ 釤 P ] 嚵  [{ۿys0 `0)@YLP ;bX  b b4Y@Z JP y ,@B||Ȝʼ̙ˑYc»piN\͆* evjŠ =7 +<]} =,0p }ɞ P 0 ᅴo=`( `i@ ҶP @ҳ  kLpLL LNPR=Tx=Ԅ<7êkH՟9 6\`s 0 / Ϡ  ! '` τ=U،؎0 ؎}٘Ж0 My6G @  M  67ڔ0P$ kp p [ؙ=]]̧-أ mhۡ}s0! `r\yϢ{=Nޢk=ڢr ڢ9֢iǑ۰Lw  9 ۯ Ǚ0 ^mނ &؅ M.Wr0ޔm} 2(Z0IvvI 6wLNPR>T^V~喍Z\\6bɬ=ar ٣ͽ=]֖z|~r^~NMͭL3I<  rj>` 7 v KؚfДry چ^~븞뺾r^~ٔ>@i ݔ٩*֕^>^~.>~%.ޜ ٔr= Z0 IF1M0'-` o0O "?$_&(*,.02?4_6oN^,'܋0 @.D? GPR?T_VXO]`4 \sH? @pd MW}{G ٔP`HpJB@JOD 4?_?So?_`L \>}a }@1w.@&?_K@ DPB >QD-^Ęa/Efh !JF"H-]E++U"Ciz"@~B C~iØZ4>UTU^ŚUV]~+.)ZJOC4zY\~ UQ4itHѓj5Ydʕ-_ƜYfΝ%%KK$a(=6Yb7@(KDe%mEe^9fgf_fw~#>f&hF:ie=!̏ޖ~3B$E \%MPj\OFimn\Ӧn[h|AŠDڅ\GeI [&!$%r/ygt:F^vJ OՆ6 d`#A=j t@:\cHFkД _%;0pj58"l QU1~1א6oPH:ic#]x)8ՙzqaC >pQĆkְElbX6ֱld%;YV- f^qٞHrN]S'=iI, -C ~J195Ql\84[RqkX׸5lr+ gɐow[]naa kHؘ41 i-lY1 >o~_׿p<`XC2 TuE$/OfNm TlTFXa%1`zVjC!f[ W54k\Gby~%hVK4A [d0ag[BK6e"F'E4xLn)  ăl/6 Y` `*@.G_x v:|O0!7^GMn-SVD#&P#;Z~Ɔj]Y &K%3f0la;S0>xY[x e3[ 0~8 `(Uk`ڴzFRHkkP#4Vs@H75tX%0;4ýs)Xih8i` , AekhY4T5d6t789:;C9Ddp=Cdi] XRhf`fh(RfZPIT7({I;bMh4edXWw`"4WԴ:g`3,(05W\š75A1P6Y#/ZeCbl,-) )Mq`XYN(Z0=YDX([P .f+V0%b@lld@ZP0 e` kXFkA`pbhH(;oPC=mtBJi@'BIVdMIk;d?4˳D˴T˵d˶t˷˸˹|4$˷ DЅsf0nXrh(YDwR0 }t +,b `kP^kYFiCY{ADl^m@b@kH` 0d (p|,MWAbІlJeFmDQF`(ZL?La54DTO?E!p ؘM*hkN_=6RP^h_p'H2Y`PWB@$pT _ti8S5S` XY؄U&`pՐ8=s8*XȂ2pSl@npePX'H pX*3e@|0MhȂ'D|2xeHkVP?tI\GHIEb@Ƀډ˸0f6^( SЂY pAxHX&3^"k[7wPD0X0(X0*x(wP*HtJ5ٓEٔ]XyX(Yt?`a.KOOhh $;kW0C(Xp(6JhH7W(=pORX D:-X\SpNP>f[000QUsHWP%To:sP1a(SWHUU8t tHŃW2p7eDTUU(;M^@+UE>J([xSN`]1uHE1WZ'YVs 98.@V)XC?T]@ (fЃ @N J XhN =`hb@0,xSW\d\OH(O@X0Ts WPU`|YI\ e/0fK荁荁|OϜϙ e 8 c_aI:>PC0w ]N  Z?@j:0,;|n8HS)XIeu,YxoSvNNX XQjtlu*a1 O3?@U8ȇhH6B%oX^%BYWdx@5Ipu|.~{g|g~.hg>h~h~hVh x`Hh:^h'8%A|J@MfK5DtȂ'.`00ptT?舶ξla=G@Ix< Y^Fo 90PN PL T%(D+PN(r&H_ݎpJiXfa@Kk6%\E=Uց]6U.cnp1m0_JYpkA]Lc{6TWUgu ]1Ncp ެ͊`mpm;&@l䅩Jh=Er u=0_`EpE҂n80APtpn:D eX3uQSxfk^v0- Xx38*,`_~9[A,GN8qփZXlXU(a o 6Cxe6qh'q?hhҶ^``aa` [V(ecJQH&0$0^hf e؅smN9~ ;M 9P[V8vph@vN_j3? [<@U_f8]ShGWR20aHzͤL8||N7GWgw_bp_,M3c(=e0@A=Ag=OQ08bЕ'0YbW &"P@np @%'-TJV"nqP]:pY`'blTxWœ0h.Co&)<BITU &9XL޼z7o߿~  a%0q`"3 yqet Ct"(.[:IQbjWE\Y%O'`)+h9A;~e;epx( G,fklꖤVbE1 ^S4687zH`G#CY/IЌ+@2Ĩˆ* Md9#=#A2Z ^)$ET4yiK.Nl2(-DC18-4J 8@ <2.]iBb lC D8#``J3I0@&R00ʘi3'QVlR/D)I8 x+X0 /p-jcCPI)h4&P/0dAB .;/{//%0=K/܄KKq0eb]xP  4F-Q 1 /X ^-@#LX`鵰81: 7L(@ТbM,L,+ ,S9D3 L9DZ 2Zݮʝ?@8@ 7I˖ /N3 /B-|#1΋B2,(SK- .|*\K4(-R;j3G- ,K)o>74)d&rK8Qi"0/`X-|fDC1!Ja [F3 Sbb(Ұ6!s> &_`WCX42v\zȅqXFJ1 _ː.bcBcxN 70 x1`1^4xaiMԣ2qbx2PG"E4&ȑǟU)SCɅ0va_"w0A .UԀӒ, X/xB ĸjXQᢄPJ >)P*ԡuD `(y+:wA0р۫Pyj k Z,A ¸<Qh<G^Ţ,kPՂ`C\g@}"%ca;-B{#1Rv@eT^@XDQ*ђ=-jSղ}-l]Y #Id:fr 3',vJs梦gdN]1tP@{A**@ C:y*c+ES=J )MXkmnu!}L/byZ3~ T2!o 4Z-:%^9/l 1ķHZ+aƪ /J>,21*.[ +7Ԟ2tadЭEhc+1f>3E;[bӼhVW"E,1pōޑљ:xXD.PӸgv\TSQSSe\R9Ԝzl9kX$BOc<$/4M-?׾5DhReISГef#ZBƖ:Ը YCeo/j %qPN[ZyC-KE^/53vH b("|s`!X HFm..(qw0h@sjZtZ5G5 MQ6yvgAR}CqC5񍵑<os^:.f?;c/P=D/~i/RҺCIE>a\9{!KPm0zJ\.&[7}pV*2O-􆳾飋i+t, "$Fbl"L @ `&.`ѐr<$-pɮ1 mfeBHejb*j.jb}^ U""j[1..#363>#4F4N#5V5^#6fj# .B<}\UPraN. $B=#>>#?c؁?@$>$B&B.$C6C>$DFDN$EVE^$F&$"<  Hz/L"JdJʁ$KƤL¤L֤M$MK$OKO%PPdF%R&R.%S6B#N@c왰c#Hd7Fi $ZZ)m;=}d8% .__%``n-Gʥ'Z!]aB0~]q\`2a_^!^㒴Z&ihij%jkhT!V179of)ę6=`f]-sEq6]߽u>G9wF!tZ1 $rs'xfpl9X|6|2X}6.jT|B1y%pɱ^r*2A؂:X(߄2XХ%~h1(:dZFZB&EQzxF` uJg^ߏ]玞yz]"i) s8_׵q5Othfmiui楻M $XۚhcR#b uzNjL٩)Ʃ]JcZ)j6jcN4jrF:g.禖0@hh()q]'j0hZ5*j*f'jzj"jB Z(B&i>.EY+ƪfkk^Fk3Ć D/@"˾,ɦ,͚,~Ζ&Qp"'h.08>-FN-V^-fn-v~-؆؎-ٖٞ-ڦڮ۾-ƭέ۲->E@&-+4&..6>.FNnҭ^Rnn>±ņim)6Ir.붮.Ʈb.έ.Jm#B.nh^V/&./6/t.N/N#nn V~//6Io?2f:O/֯/Fon>G:Я@Npj+Z/p<c]psiTp'00A o[0 0k0qp +pp p70Ӱn 1t pү80 3I0\8 p[1K1_1[q1 c1T1qq0'2 1#<G Or! q888D3)G8rr\"@2zp-K2.Jp{/sP@3 ,2,/s'-%r,73/۲@Hs1/o5062"q7/724g8q99?@D:S33288729W=s<>3?;s8k%q;;sDs>C5K40s2.30{p _pK(4AI#*O4.0Ocr4MMSt 5S˴(+IR35TK3KWP7uHtVoT[uW;QV1UWc5tDV\5XuZ5WWu[sZ^uX&{5[ ]Ru`S'6aRSHtҦ|$&$P5v&r&658&&g|jk36k[*[f(g&mh&gYj6&h#'%wptOv6vw6qolǶk6kwm_5&686ntvuw:whvk x˶}[{n67p|qvx6yvS7wqw~7zwhO|㷂gyz{pSx}7cxlw8sKxxkkw8s8Ǹ~;xCǷ}oG8|8'7;x~/83kxmim+8^e/o:)9(( ))ģ(*'9o((@;:(8zccwz:8$(WzO[:8:Ǻ ;(G1'7;?GS{OkWzC;K'{g+;{#c;;{{{:{|W;{3:GO~ B*'~p=>臾菾vV˯擾>~p{/1}ٻ>Q_}%XW}NO?Wכ(7ү3/?Ҏ<<$C2<} Nl@K &TaC!2(*]cGA9dI'QTeK/al98y7%KFSgy2taT]/Y Я}EUg0hU 7fԸjW_;lYgeT3ϝО]1^-%%k<d/ 3vb)x5J!GxqǑ|m%{|% \f NZ M^[r]HVd|9oŁ5R׿k~Gt⧟i(.6'F&}|A/yD!3">kaQFzFg'xGc1x8KxCu$!p8e,[TR5lMpƅx 0A7\\(~GG&^FQH3INt(NBI-Sê&9`UČzF|qvY 0%c`gOT]H4'Z:dugu:uTM\T-sER3ZMUXu\*tJFo /e"4 w#׈2j$i^ai>%=idjJG MqTtI.dRobH݃&\fcl6ș yq&lqǝ gPIm!!^h@̐c$P0bvCH3NNZ'!ϙb]O2@]i6Fk|vAiN.bqg1c12{A=,"t~GlY"uvhmIcgEU'G t>Sѱ^LgyOg0k g25羍jt'`IÜgr#"fMAARP#5MG!lhE 8bH~wta̧q#{ dqc:yt5cJ.gf~-g]@H$IRٸ?*EC<)A'nDG86.cQ>?"攧=L|1 i\Q_h@a kcܻ2@9)Iw&n6puiCv2YתP0EHcCO *`<|쪑UH-Ρ6$Dw9r墷VUg{*dW,E"$<yLg uihمn c@E/c"hDqpUi^M]Z 691&ްx>XF22 аUU i#@x^%٩Yw6U{X<c`A_;Xw^d`ҘG:pE>|Z6#/M#NH{< }Mi.,g 3lظF 0kr%`rI.;FNF"e<4AW!9fG='}5]!8| EiS9qh'zQ< B~O9 A<{F'I-k?;YdGMRUF"f{z:r."U)nIhPzEUDH8jfĐ|/- f)sBu(KqtBGqP&hP'ARlGኾ+ܡF +FAD&D SzbȐ<0Dbk&ab;AsP$DaN(a!TBAOWց aAePqFX$ d 5 vc!J$=A(^A10[#1C 4Ɛ$mheV69lş0`pWz XAGy  HpdMJr{0"HD!a)C822bܲ".EkwtplA g@ !Aa$; +4!-!2*A.B=1k ,Ar8j$5kès5()jD% iء(?Ҍ- .&&.C.B%A" 24kd$9Fس"?!gŨjGI?5$9 F tC cACA2ar 3,@J5G!Aءp DASoZ'?К@,BKZO+ˆƀt *;" 52@"St&!@_j/mq!2 $QNdՈTG1Gڠm5# I!^ bJ8>R(3MLlg%*c)pD˖a[xCysVuZ:$'|ħDQ#?#@aZZKZ![j[5:4.PР∮ Pfh 5ժTmfU'pARHr8pDf%:NOdAdi)H!v %g^J0T+624K >iv2fw?"a S?Ncv#bTvOliv6&n0fGx.O64vf/mmClht\##BID@oaApR6G(g!J)R't mbWfzDAB6u2ƆE bvi8['agvd xn@ji; y97zkz6BN:2:2@1|dT 7oZ EW^ڈpb ؍8!!6ni1',Z{C[yvL.'JŐx70R& M)c؀uT x KXRNxŢ0TE'v!Ȓ^Ag&m@p􁰢Fhyxb/RR.хx B=~N=N*XSODH'wKª`dkhE!p`\0891 "#"A@L_HҁJ2iesn!!poHf[)6e 0hc E_pbchvU'GqQ˘ؙ #"@ 3ed抜I_BXAxƌ''>9 ^ގH:dԙh3Z,t6*g KTb3Z+%īf?zz úuƙ o@fEA_&ȣ *+M'Ǥiw <Ms\6Dت[k 0Jh܁'m'F* 'ZrJJ}Fqo INL.rͧըB$T%pօУm[4AF V As1># f`pvKHϼi0 ᨙBAnH0WT6+/oex@z0f0OH;G)~M9#(H_IaD(X ', ŜA #"I"U(܍\(1<÷c8\'(hWWY)S,Mz{ƳZ6An0 -Ǒ v;X3HDhչ)NN&i3zBǢUa.`x[ BD@!fvƮ_?qs28w 0N\{>:#.eW{x&n(5ӹ|G蠹Mgԑ$ޯ߳gSbm@)i qH,`,K1܋MWSU` .M#5>\i2!j&2و#58Xr`4]QV^b]'Pvu7w7:l38`6d򸶌dx-1-ɦ"i҄d4Hff ?00.UgYTZ|2#K8+xf:hWABHgaVL%$LxMG_xl6׵\iފaJͳ1dS?AkYJs@"(gf(+SQ%w@۸ĩC_|х94;֫%o\͓V:o8QLBI{$a?'ҷO8 r+rb &O(Ȕ"t*Z^![847O8hÎNc?Ct36A'CS;Cn4ܖ_L VCu嘟: b$ ")i-'-0F'#6cM||>H>IZhσ9WO}fd=ϖ3?B߭\t4J3Q1F4:CЇ>3=$0yc#yL$H&.iK; VV#P,nutByh2VyL2$6 J6\u.IRڠ $*..IZ0e[bbD,n僪(@^ۇ YH ?1tH 44b<*3Y'& mV,!%y@ggd`8*\싢@1M3s'|0.F2! X„SOHrbrG m*QbQˣ/NTOj /kG4}pjxD@sD/Cm 5pp&YMWJt&N2J?טG^H紑q|`\B}Ǹ &CQg=ORTE`G Mn >Rt c/juᤙEPLC` #ԏEna{ vyT s:qHJ/] 2G`;ƇPW#>ŸrM@,wqXY<rcam2xw44׎zf$CcVBd({7HtM]hGܑghtfʸ#,w|;FZ|>vO2;Y!Ժl[kʸYi% &3Pc*C`"Ip)ʗ, `GhX0* 3h ;Q_q@ys؃#e>XDEi04P)Ð)Ѡcx7&.+'M4`"Q΀ gp\&<%d` ְ%X)-@BCCE(3F~j[>p5et6'  0 5c%h<g ii!3p` u y AheC}e2y^-HCذ|቉=A!0\YTˠlu  'P   ktaA*1$ݩiS5ARא}*~aaS)P_IH`MVٗq |EYyARfNA0 } LC* o0  y`v aL!0` p7,Y͵pPv #Z4wDAʉ m2ut VJtLt5m DW 0fQ}0e P1qP V I0`p F`Gjtذ 8-I+567ewc)1Y)Ua` рuڄywyF\ xOi0g$VvҠ  pV,yP 01S>X!_)Ve~dh@@>q fc/•7!U/tc~ 7ې `2|X> K pjg{bo*@zP-AҀ5zy-Tp@ y`LQNlhpwrg@w9X6 KD `3R/xxY$%r?Y)1.2K?$Y.4 T2 k惍p7$Ba Ƣ 1;"XSѐ' p op y@ a 0 UZtҀ `o[ih+\-pw(B}+aSl(<К1C-='T-p VMf>a >ư `3˷v) )>A~SDEP rSN e0 ,)8)Š A Pԧ cyALyh㭥\T BP0VF2R݇׉y!s" P>^a}DQ`@/8gՃillˑE[B>+y$eh -1´C0h K0e& q}C-s; hg&]<#d ^s}L ` J,b/"LZɫʰYB.AT=x2d#/P1"ICuR5C`|P*d?xek-%&i9>pl.ym]f|f5*OW{x6.~Tg`HT7;R=E^X ~4N 㐏y݂5,F^>!/gqQ_h7-@'\SQڰ~. A@p &0 ӮIA]]DnPNVps*g-۰p(Pea* SᛸQiЎɓ 03#/)6pp00 (0ԱdNCwurU0ԽK. X*Q>_ԲĞk>cNX Y=jQU-2=5gA`&P BQ*@E/n0jao_] IcH> 1|A8Y%Uc._vG`}8)F 8#,R∡ oe"l?77nsm Qa]3o7%,hTؽ4{PP.[ݔJ0"' Qdngc ߠ ox0-B$XA _ɣ(?LS C# RF)UdK1c3F72gˋwvh%Mq4Z# 2c+M^:m@T)IƒM[8xґ1h^ĉ/N,[wB "l1>k &;QY{tGcTqtXƎlDU#V!ч)PSB+# 5\ݑv"g<7>晈[Ki1 *<װNTjmEuu1/vY>aȱq"u"u0Ϯہc1%*I0i72coaFIQ@\ezÆǙgv]fg V^'q\F u.8yBHV9qm1UV6 X4NYul!9]}BYeo? :3o  6yKw yr#P,Wsu(r }zG}G^gBh>j@"ÙﳞTw$b/S V믐e\fJ^d0~dZ]@](D!qm cy cV{}l?$Tσɞvs06jF6q0GcKEvcLo+ G?|0^`.b2g`stT(:xF](4ц!H?xRHPeF9eiNcqec݄cI<8EX6@"?ч ]13+zkғG 960C˄fi;P`$㢌#!ɏcJfBE^6VC!8TĤQ4vt"k汓f (*A4SEeX$r( (?F ,HgkҚB RG`&E=@v!ĈXDɄ4 8)V14jD6CD @d1mC@TFIIK@ raIhfqk`0iuVmQ "z > Ŏu|i^QzŝHf=4}|ǜp# Q1T$a(ޖC؊X):-S|4{'@qaEKmfځbe'Y/&0ZDp+Z8uЇ5o\ޱL;~F Gri)~e ?Ie\}+!R% E db; iqqr0$" Ew,6<]p c(͕\hFRQ9k._Ex rGB\qP#wΡp #]3Ce^GOiO!s2BiOiY4hjRW`NJ:RCj1 Y0U "X~sI(:Ƃ^ZHfj N ejҼW_d,?z9VD؇<,kc'=y7FmcQ4* Ѕ 0%achKt2i|mm?@o_̬tmR> EִXO txcr(E,^X(F1Y ŁrKN",)G2<|;lTm|WLx"%+wSpL1*tH7Cj84֮"XuԣRREvJ_.q+¬EG";)-r;O{q ,p,@&ج:.#R Pv|E^^{LOx ?Ql9m``x_l{?0 naqv8 Ϋ>ZY h8?"?ȇ( x&HҨ.a@3Wذ31ȃ! 3u)@b3x氻)e|P@7)7iFرAȄ˿̋+Bip %NixH % ${ρl0!#}xb9lh0( ;!((Z"(e(0x \ pSpX8 Q#I0M3sm3Qu(%}!*"&+ѸKR }~q -.R4 9ɭR;t:>(770y5gpq'((X@Ҩ.`FW`O`@I7:QyH l <وh `1H#*jB'1 rqҘQlD X Xv٬dXtR@5("0$ yLI@:"d 3QȆkXCE1RT Q|ƒMX:qؗ C#۬Z+e[AIkp2lekVMY7lXXwu[?MP!YCЕHBZHx*!-IK+PNx`\۾$<̵X6`k9#"))xe 5ƴI.j~t`\:$ynGBtVc0ZFF %W ZVsmOjl[RN| c g#y0-mGmS4 )U2x fĆ'ϣA(Bͦ4DeR Ao+]x@ј`9ܤ~gi"0}6Z-\: Q G-\f(pDZh V/uΰNMlv鞸0&o(1ǩ[Z m}6aPvc CQvhs~D*Ed>" k(eWe F&6).+tŽȩ͸0xy(h {&m^hk9Dо^><@3("@:YAhXW䇱X "oLMKp؅IpgO-{2k]6H/1#]!:mHm7(R9uf]_Il{g8(dFpp k_HhHpxd|k1Vios툐 "C O׮" $(M'm"^k| Pu`$藜p <hi4pv@g~ x9Ɏt wk8&.>iHȆ[qeidSrIn!,}@_N_"N~rP PzuwZב[Q`wh|1xIm00\RT& 9EzrErxHwu'@vwIo$K'd\ؼSkxYHA# tX`x0}8.U.pkqHZ jGA!xNJeY qsbY 8֣yHw !(h߉50Sp3rvBw_;wҤGqyЛxxȺI{ɱP0Ï +῭vHdbhsxJ ٸ"Lp!ÆBpܸ~kN[mnAOLr%˖._¤xgQ8wi *TaAplXk0Hq(U9-8NWy<7Ϛ5vc`&MZ"3Y2]ΜUwPdɛ'\#>5*@O<:(@D )E9@ iAT;X's<ěJPz%Yo.5xcf;5Pq#O|yĩ8sm2G ˤʯ~6)];w9%nºu#>` 6X cA&YB@C!n VpQ+`KDU4R6~1xWy%4O;`ShxGcG"yd?p%h3/S8LS dMA|Um~rDLO84ҴdsW_7/-#6xahg'JJP C|Bb"D9]@>L+"48pS`sAٲ]EMF68,vPX0-{{7+5D;c?$śam٣ĕ35<3܋1!CDaE)|`H)n|CԲDK&N40 Ȓ6WP:x3{9\1g9Ӷڕ$/YNj|-Kԏ}HHIR$;"QjSB##u ذ>%Vc B*!!= &(@aT-a3pB`HC*9 ڞkE$BT-Q"9Wяcvz5dLcxShA'u"6l4#1AA WBQF,zFcC\`b/ܑ,LO;g3$!iPPyD@*+ d6ZԳfؒ6֖'JB򷡵?j&pP"B0Mex/by">XL!C^rX6܁(e?,5Q*6ƖPKTZPb<i(eG׭($)6t4ţS*Y4qQGLC*t F0BY)cE5!vA x02'$5p1\ טXcbMی@! d<ˈYK!+zD0:nL;_GO9RֺF|f#TB(XYق*E`7 x(Cbn~'`gdTtKNr ͫ2L0x:N~wv 3桍6]M*_y ԦzvP @xX H-hG)ԇ`$YC2&-V"QWQLk&A5!uzSq= 2g6S呔JqN+?L%ً`Pp)ATEUZ|DLŠĒ7!,\@Bp"Lt< (@B[A4?0D:A PMDA4E<`CXc 6_X: ?RPۍ=_ PH)]FBB/(d{!T&>)UH&.h$D~$a{d8$@G:X]̃8dQ0H(n@10M* 2yUuP3o"ęjJiVC<|,R;X 2G)&I6WJV&h RtqBD>TB-,A! I %C\SAXÉ&$-IR;LS mӐ ~6D}AWR%kC#)=TY>T "D $,D4ȬB)څ?14ImlL(JnkI5llg- S1)BCt;"ŻY<+&DWZ(D-t,0*DDC3B,+-`>VNē(B<`LB]Cx||R -n>0qSC`Ɇ >n"!\nBA6D:;(C\ g ? S-(/1WUjfĒD*-fIJs LY_ <{}>r2CdR&Yr@,+^pI:1` ];00WD]tKs:GtQq F:' HsE&4l8̈:Št qLADE6V9:l]c2lC`D8|B4KxBW)vAdb$<&DXs]@L;6 tJF@CcE_<ѵC-VFiGERp"]5rՐDR5D /,nr6D58 7$6X#dl`7jC1&*t[6Dl˵PK)*( \iy5|A}0@;($K,IӄE1SRGa|0~ឱY&I}EC*ñұB5=>:@$T1)OXkRnC?0Dc43D}EF8PCC|āF^h4db p!SxW$ݗ Q҄RI<;= 3xV5(C[? }rC n߰7ƫӴsh}'&Hx+÷A FЎmx#Ԩ12ms*/~u!ڿG幼;~{v횹Ew/[0pfxgڑo48Z-~K چh"qVp,tD E\ lXf>k^k}aH&jǚ1feAyĈȈ殽:Fڱ.C&3lGX~)ŗ6"0<~\s,]p'w !W) q8yEx2%ݼu G6Μ51d ]^bDqM"F-C- ;y,A̟eMo1,("_`68 وb$,ˀQa Q*%6X<ڽG\1VAUc~(,2y3H]pJ\c>2x3iXY͉i0# fQje55 2H͊M.*x.u<'"~$r[ay :Qo i Æ/(pؽ 5ĽYɊKР8]e,lsIjHmi{ѝP;ľł(wQIq< o&ʰiTjSpN\}H 7áv!)u'1 zGmӗc w|$sʑpm}CIP0.!:=~cQr&m`X'F5IW<Jg",kbp1Sx ្ǘ~LV;_;*1aȽЮ@I8V".`1\Ibw C^|Wmh r)TMu(&X3 EQT.{QU).}{뭔8BqJn%D:3ĸgdJH{ F$-$3!+'DM ءS L1\ ?L`eᤂ- ;Jl˰Eʎ/g$dAnI+ab$g2u(L$1$ 1QH'F& 2!*uNaj1z1B~bb~ia$ K2.KlQ!eaz Eı+J$`#X,$גE"GϿ@,(Dd&#V#9A$O$(V"e!#ڌDYȠ7RK$oE|gn$BOBibJ0^ARKę1(RHFQNl HhLzNj9vT\1nʹ\Ւ+@Zi֘,zc}|`aa-hEf.OSQ ~PXhH:@Dԁ!ġWB4`E ine5!dӎBaHa1PS; !"ʔRleZ1u/#ԡ>&l.06q(|!&lc΢`HB(n0A(R)I.36DbjLLƤA*ҿtA{;;nD0TV413'2 4jJM% ,@6G&lc2 7ba|uG?TwR1tBL|f& DMC#D7Tԇ f?zLblcLhatMҔM35F(Oh~JVOʜja 2S )| !7$.d5<5!cO5UY5c((IZPRV'a>TΩ!?UCZta0 ]vU^6A$FJheYu;/K<)AEbRi~9`nQš#U>.‰NL8=6#sa~nUg:eMvDPN`U"CC& a#l-`*"3mn_LKqfSc!>zvHAVJ^fgT؇S!džH_I[Xa#6|!IV&}SwCޜBAYGآ7Š12)GԴl%:0Ba@#XLxJ料dٜ}+0b$C#8P̔M2<fah UǺ^4n$=bvY}"^z}z"jBaa~+Š"K#D:&CA^gJ*>Hlc$ntz"5OQ3XmK&وF nY,uZ^4y,{ikJoQ6%K>9vj#[Ī'h .7`3VBlOYOm-z}k5L@t,D)&{*aұO"r\ s$'f$dR |IԚq#2['A@@r4H*]6Сs +ih=R_W#:k KZ]{P"w .f>-܆oN"l qu,> IuBR{Z6"XsoN77\!), 1t,mn%Pgq1?b4<9\[cĆ2黎.X迨!Ϯg@fPA` ̍hf-6lCI">'$P{;cC-V.h&|@hF!>W RD(Cc$)?d4ϫz/)b%L,ˀb7`RccDؑuI$bi nG4$dVu xvԯ!FQʰKܾALƅe2\á%bݽ&_a<#)C vtU}yaܔK9\xOG ׌/}ZOXm<%'}""@8 {rbrVR^Gޜaa"y% ˜(~c+Rr  -.,'09F7ulm~>1_"2ʝI\'Kۀ~A5Ct E\O^S Ǿrգ R]: %Pl}.PL2bb!@\cp?XU)Ҏ B:daR "2!,kiC ƍG0@(Ç#Jȏ #5>t)=v$M IYɳUhc4? rY"ЕgETC|V&(TSx.UE^&(:EŁ5P̤<xY}LhjRg:ZQk8T< [kU 5$Lr#pZT?&bC1lV8{$l2eЛ''(l9cG_e`CFp 8\ 2T=3NE[j5#q`X^kBG_6gclemJ%NC#V:"?Ζm1p32~Muw$Qr[֢54+uMT?/%J=W  5NCX9Aw6h\8GgWo3Ivgi˪a6co[ _8lyiS#Ua5ҽBPHǓ >j3`J2bǼxXC>Pa*49H_:L?b lW %Ȯk2* _BA F2ѱc1a мvlLЇv.-e <]PѸ 5Cȷ/UQp!0oYo1=GBR]c!҄:@Vk;dVW>&rBĆcad ] ,nəm)t>)* D0T?4o=HGz"c5sG!ic ^@ UKzJҢu)`Q j1P%x0]CazpU` Ii##@Črc r/m%"' ٻa5=FxQZOڤMZڲ$;ڳ&sۺ`۽ }2\0RSyܸ]@-Խ*W?tK7]%CF S "@P QP ;]}&ZFд1- .DQ+D+1p[Q0T>A-pൠ p$, 4q4P ưu.~1݄a >)06D^F~"}wLy`}R>I0`Q`&[0ily]vw!,Im7H*\!X F|EVË3jȱǏ CIɓ(S\ɲ˗0c|+̛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ L8.^+^̸1Î#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkν}O>{ӫ_Ͼ˟OϿ(h`|s ~EJ2M VhW@xb!AN$x$.4b:&(NԢ@\3<*DT#A$}P~dITVy#Vf\v`)dihlp)tix|矀*蠄j衈&ʓE6hXP nBL ASqȌZRkuL@1 #R@@ c@xSz'I*BE%@ܘ FA$.=1'AI@QH52t)l@ DnP2Č ,! 1468, E3T*R0@;09,U- V R I-eA B@X)8"ҭ Jp GvÑ R0+ B(P)1pQɴM-Ir111Z&dՐX,i¾&1Z0nJT9SLK9< TJFŐ0#FO'LdUYv5fYb'liGղ$jc! dEֱ!-BBkԶVpq2ש}Jk[Rͽniw+^Εgf,|\趷IovXwkwë o^b$6aƑjU\`]X(N1R{bx,~ϸ6~1s$-q,bAQ|&9LnrR,'7U2UiA0`1)9Ӭ1a~3,9wns՜FMB7B#s3JE3'y4KJ[Ҙδ7N{ӠGMRԨNWVհgMZָεw^MbNf;ЎMj[ζn{;4q{ >vMzηфm8;L-[ϸ7{ GN<>9SrW0gN8Ϲw>zȀ#8wsF"khC ӅNp$G8`6䟲sn.-#3=@{ߘ 9?Q+^9|E#K87+D ɼЗ~OWֻgOϽw/lȆ<~'u z8qj7?进ȇSұm{{ڶOyOŝ_L8((W\ ؀mrH% X ~ X!؁K"H$r%#'P,$/(#.8ER68$17(c7ѐiϰё"9$Y&y(*,oYd`@- v3I1蓜wBYFyHy;豔LP9{(TzqZ\)(ѕf8ɖpy quw{1PW~V9}!8)0bxc| zPY @@h PGÀpL!S_1Y]p)М9YyؙڹiƹOҝ)yٞ9~YEqٟZzj(  @ *@9(s(}":$Z&z(*,ڢ.02:4Z6z8:<ڣ>@B:DZFz7HLڤNPR:TZVzXZ\ڥ^`L: y :br:tZvzxz|ڧ~:ZzFڨ$j7j\JvX9ً*Aթ5ʩ\:p\ 0e @y 00T p !,Kl7H*\ 6Hŋ3jȱǏ CIɓ(S\ɲKbʔ͛8sɳϟ@ JH*ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ5L˘YN̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËO_>zz˟OϿ(h& 6`\<(h@פ#NBPU/ DM&T ,ؔ.#3 8D A1@c9)J"~28L A\LTV(-L9P:V)fF5 y9ce©MroB(B~x螈 壔閕f馜vpBL@ꬴj뭸:?&&lІlԌf_6ߊ(㭷%EƞMH9y,I"#'I A !2Z\16THE .ES5` 3J7ʙ@8k*Y@\d9`P4˽<2"pq d@1 G"+8L2D 0Ґ,11B@4;Q3%NPJ1x"xu24c@ g~n^P1+ +B9A3dSA/rFM;B~lR1B_sƻ6O B'NTmyR4In"4 Jl DP4y,x88N ]@ I$_:@ b#iJqm `p"!1d$R Dn 9pZ㙤;&B ?ChP:,|C$Q.@f?D(`0 ``:lO!wLH?gG A$w5@!2$8!K7"!$0Z2HN$d&v7PfXF-H7 xc1$p!FBX;.BP E~rD` ݨEb`n?7dfw,ܧ$4 ~\:(w3&g'؅$ jf"hɁA$YC \͈/1|/a%NVp8AxW'8  LX7w(d@ -*= 3Q">DCKBH-l+BA bn#CAh x0@J9 QG ULM1Y0/~3EzA6J2!,R!-AZ{E1"/kt"Qx>íd bh#\Be$1].dX|OE4.LBR- %¢Ir@Dg @8!E0~\$dLH{Zj3 x N a/r)\2F2R 8RzAoĹ ,/f_؜T}y6418Z<גX0lװ[:dbpY!_/" ;)?3mA[ `u )B~\Y[:3Z(۝,v!=r;Y9{ޢ@F?Z])!rRGjȢ^XU4.&u%酑K^c ‹&,Olf/1)#QT  DʞȋDf`{!7P8S9aF$S."87OO)RA򑧢W09cNϼ8Ws\hRH?W<NNi3uf `+"}^?N=)>QtQ<]6I~g}z;/x;wE7Y~%H}g{>~'7j ?Q?+2_xgxWgC x8ǀ~xc Qȁ" X,() 'H"H-h @B%1FExFJ(L؄HHPR8Q8Vx"?x`aȅDXYSPxql؆npr8tXvxxz|؇~8Xx؈8Xx>a\በ8Xx؊/8Xx؋H!GHȘ8ǘИh6Wxؘڸ؍8X8DБ"߲aI%`o&Ha ؏lX)(ю ؐ9YyɊ ّb K&*,ْ.(/)1IXx3>@B9DYFyHhKJ!9% ۀ.|H X L9Uֱ00F`Qm`-teՁjɖ6d0& m)"  o)g" i9 +pƐ>9 q*a:ٙ Bqq)*a M)Dyi 7Ii։ƉiYI቞)pɝ)fI aEyS99}(p #7 ڠxF08XI4 V t  j$:YQqq4084. G @ʆ+DE:తY13' ]Ș}Y)`Ⱒѡu) "7n:Y8z*۰ Ц츥8ڨ:M ozp0TZ |:sQqʪAb$JJV J꫸ҞJ-yb,ͪ,ʒJ,z򬠪$aA޺*$ڠ@dAeI"eb,*?<`:.,eS "ʯa:K( +۰2P 'K-0{"˰ k&벜*Jb;:)<۲?[)6;%CK)A{'M³8۴N$7R;BR?Z'+KCa`1?P)g'-zs)#k wK( }k%{{;(y+K(0Pt׸Q `᪒;9{K k$'Z';U"DŽ tѻ0 {k 7@ ڭk [+ٽv{[ŋ) fZ м K L{ y<$pzb2 ABu" $\Dz0_SBP" & P` a&2B@?J $QS\ ?ixwl)0ja ڡX}|JL~m+Zk|L:\ǫ~V> ?ZC09 ;C@ fAQk q\Sq͟1 A"(|!WD  D`HF<|!*-`,fzo =ɼ_ίB]a]LC ,@pҟ ` 9T1ѵ'-+/ 0 /MU1dҰҵ28tw` 3MQqM|ҥp_ XT-+ ,M,*])-\&&, *sum%m zaSm-'ѣQ=،>;y5ӑ1aP16̗ -N*֞ i):|եb p)]| , 亅A_r=1m,,"=MMa,`򰚍 a цM)qօM mٍ֡u M *l۶1MLڦ{ooMA]ʨ>'-S->m;%7d,ˁٙ2N~cIAH>2N>)>!0i 6@b]GA[NҤ({ r F.A&nPM}WG:n3^.ps0^^o0I鐱P@0NjUX_C i,_:H.km R~_]/ -&nُ_;Ϗ{A_NLo1@` H)p!QD-^ĘQF=~RH%MDRJ-]SHD"HAb1lDTRM>UTU|t(0?rB4XȞEVZmݾm}paÇp̶HXbƍ_+» %cΝ. hҥMh!tZ씢iƝ[FI b^ 8ܝ%V]tk ;lСEV^xѪ&rOMBw_|{v|[￘yD0A]xj//̼[B4B 7"' pDOD1ESo=ˈ븾TFoTb 5G!$Hk.dI'>F㐃2K-䲩' K3D3M>ŃSS~N;bcO;˛OAeIGzL~܌C4RBԳ=4SM7]P6J8%TS2'3FO5VY;cаޜ5W]wu,OnU>XcлqQ2_E6ZiU G<==~OoE7݈R (e4Hu7Zc5zWZ_ ag`9UV/{V^ =8b].l8cwYKؘue&3LjSgs[3l6c|:j߆[7v+Q;|Zom!jp+U%q'kl'./*r7)Uy0Ey+~h>}Rl[{> ǛYا_{,?|cH @/R1Ђ*_FwAn1j!``L‚9"9NY8Cue0#a`abb@NJblE*&Ub!1_3ݘg Ѹ\p>`cٲE9Tbc%F=qPnc DGA2Nx 0C6RE|H9"0H.)HQCHp<NC4e*oIUREteD1X.D,q Tr P/JaŜ,}yLd f3KiV6"FD; Ox"xE@|ւ@0/!Jzk? &IAD"qW+ DIqT e<2`_4T28t5™ UC+(U a:X"{!B@r@,yг#<QT h "H !ꈈԣFUjVխeQwoPEb!/D!' *@PZ'C0Ӧꔫ@ mX؞*-|d.<Uv4@#UhC ـU%iX$ !,Ll1H*\РDŋ3jȱǏ CIɓ(S\ɲ˗0c~E&X%ϟ@ JѣH*]V/]JJիXjʵg`{ٳhӪ]˶۬}Kݻx˷߿ LÈ+^̸ǐ#KLk3k̹ϠCMӨS^ͺװc˞Mks/eĻ Nȓ+_μУKNسkͽËOӗČ˟OϿ(h& F(VhfvSEeӈ$h(,0(4h8GQ|YX,al ?'6J ,-ZeІ:4B(w>%OYXX04 HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHMjwܣԦ:USji-x 5U7T 2v28Af8 P g*@PAU<ˠ2QPT:hAH\cq@خ'(0Xb L\76b5ŀd+"@l$XEO9"-`=7bT p b-$(jgbXUQ̼|FK_kEH [FFXԺH R)ŵD]h0Ar#,,hX! 2B-0bԫ!/&I^ 5q/b5,x IQ́|c@&`E$!F J 5E8H7N 2Z21P"x`u!Cb) G=Be@1"*[  -B^卾W؋{b0ſp`G h-&/ -@J\ t"XG\kqA|BoA  C "#-Q B?9! ?r0g  ðBr ={1{ ̴ e ' +4 y ` ` - ` C @>` `'qU|qrGvRQ KeP8wm# r( :IÐ g zta U 7@ p- `5` v} m8}PUw$t# 'pvH U~Á * (9Ax苸 v8HR gP02 @D!xX: :x a`~" Q wH ƐJp ȋᇳч؎G55/s ҈h0_ P4ؐ@:18kQ (g =~{=@@m ia CxЃxؕ;9vg،i)bᇼ@8I rqhɇX  J( .{"qzs@ |ڧ~ڧa>Pz)| :+i z:򈓌oZ ᨟zH|Hڪ zRU0@ n1*ъ%-*آ--Êz-j5ګ'9I9 $Jt4jKO܊yݺ LIjz_1䪭"Īʯ" +JʇJjZ*ʊ+B0J/ k#[ qk/P*,"$)"3 5FK)>+F,yF{` 17N `H vA)(Q"DKGk!_!FKaEjkXj\t("Mvx˫ ~ |K~{0Ҹ&󸊺P:[ !d=Kz(e;ۺyx[w{N˧+ѻ īK{ [;k ˼gZʁk;pK kk\L  ; ̿I/Y&B5 Ezdװ@ 01՚ T2cUÒ +_DF԰9f}S ,7-J8kSWgj}x@ puMsmH]/MHmsךTP2{ `1[ِ3M> ԄmCG ڇ}أ yڧ ԋmԎډ;=ٰ]ڗ=ۗ]۞H-ע qփ]حϝ܀yܙ աڭt <6L600cOD# \7-'80}=̠ߠ0lߢDM>Lj"^;.Ar)> m,N+1\W-mn7sDFNHBn ~P>S .[9i~k~6fhn[7Z^- Q9D6\'l$M*#AwP^);^nA<;%ҿLꨞꪾ>^~븞뺾U~Ȟ.#q>q@ 2f^ !/j^5Ǟ a[(.a/B i-ɠ1 `"/N~W8o -#0#Fo0=/0򦞡Go_S7ג4dppĒ5)Oehd5/ovd 01xtq 4? %F @ϐ6X `EUAW#E5Ӏ$DD-^ĘQF5Q!~ՉDRJ-]SL-%ęSN 9 QOEETRM>, W2V]~VX-[<)8ʾW\uƭ5X`… FXbsDZ9]q@5ƬR"yf8U`^@Fc&WZ6:<[Yݽ}N)gE \!v]:pG~yz۽?;6?dy«wRej1hc2߄S!5ӼI7N?$HMLC{\]v!Q.u1RK5j:/-L"C3\8%*ҴIQU_5cM0 eW_iBcXcwryf}45&lsTQ6[RuV>6?X-qlm\w\2ߍm'z-ywa&xE -M5at8F6Z0S3(EQ;&d9X]F>e_>h)fo69kqgcgF:l]IgcR늚O&쇮^(dl߆ Cmƻln8?Z{AGu$,!vN"`h 8L3A 083T?4?![c#|h=I, #qKAǀ`C*Z釾&I&5 m(KDyV!3oBlB'lf7.$ /PD2 *fnTbIgaQȂa{z1Y_@QqwWu͊B ِ R 㢇2Hs.F]AKɡt2T#pA9`^z W4UNBqHO qL̸RDJFrg@eB%5uL] L@8Bis,8@T*VP `0!va!JbP4Y@ B^!y,a1Wʵjjld#^uW2YO+,gY 5CÜƪ mt^jJ! JT"MIp5Y 68.J)ӹo*6:PWW@BU&"8|EI-BA n/E%S9QG~CJ»I w^F,WB0X-/Tư;Fe\MfÒTd p|c<@ 4 e9Uvg2q rpg|^x!8, DW:mTVt~hs,̌ #2Fr6C H` U9G1s%쮗r;L`2S5Ca\+gq+L5D08!E kA& xr1ugdXxB Q쇨Z7ץiC0P`~;iT#=lvȔD@xR6fsE(\!bZ;bfȽ)&$X o1ݲwo04 "57n\Zsz h@*:S=+OExWi.0J| Ih9N~C /Ι.F GQ].lM#PY @;7L69 @AThOd gt=.+2ä/ {A-/x PE$y;d|FZ=q D-܂jՖE&|jL"^G8Ͼ)d:R΂$?,6S,8+nx s!>& 'Qccti?c躟 7R7lY?ɿX eɓ{zd% v9Z+) Yx*, %{G9%1:AtCh9$ *䠆cm'!ӈ" PaÌIpP.9K[D! $?90-dRpZ:!i`:Y0 ?5tœ ŀQd  Ix烋 VQx@y)۸kAթ[ƂPpj$(EH`F~$$ BG 4ƒ~Ӑ<ƺ葃pI?" 4]<P(; 5Ayt<)K 3D u?i8sR0묛Hdž`tQvt0¹pHd+P"䘹$$*K7|K h$ YJ&6pJ@G0( 8E LH9p#yp̷d"Dц҆ ̛K|; 0BPjC }@0iuxq,*pxb*{ɖ|,$ A ̞p jxOe60l *O 3D~deSȷpM͞P+ Rt]&MD q 992 $Q/p\>8}#'`rc?HV%T e(8˥_5 CY€C2:6^T 3ͶCy09;bcLh#UU ^cS=KvO!|ڣHfچ~]SNeX JcT&knLh'ނ_%s^024 y38([$I.ƚ։vuFD/Rh  F#Fዾf0qԟj.~YՐ^b&Ie\T,!aa!֨^j(jͺI&Q%HOii" jfq֦Q[예lB]h*XkZQD`Qcư.ԛHL{߀LvNXhfW-IWIUhm!.ȣՎ}qDފ<ՁH>.A 3 @!(~.eR=n @n@@Vlъhg dj~WH] Xi~`@Cf qpȆ빖R<ŒW@oY`iR !@'׋;C $ufb? 'Wh k=(XAX,\pّl4~IslVsqm|_8>-w>YžMH.Ht#K7ALjQxV= W 8P`uʁX<]H |CD'[ 'UM1`Gʈ4Z `\XHS񷸂.݈(x_/mnH(k C_Jxvknbo~=!r%Ɇy 3Zkx+UxCuВGUהG 튯7:юVRxv`xdߐt1*kGm{Oy.q/Q *rx05{ ~kpP4h\{g٪-ZyZ>/׈tߒU smЎ.(C#`g)Al@,3v ^{#Wksi?ZE# czlHT ڤc4uk9Ab{:zjXO/JҢ苳EU)$L0楐_Q$ND>s燾f<2Wݣ$KdGe?DA-)6^U|KXCB|JV?4׼pv6] s 6U)6c8xx6ވ25ȨgЋ1R |48p1'jӫtA5?Tg8BZ&3|@6!WHP7BmGc[v4n7(7A[D!<]s>`4=>Ki>[?y <Q&O$;W6Ǥa-\-V24 F) X3ph;! 2/rCj@Hk.!X){A }8Z'5JaheCw(Ɖ"uc$Ȓ ivI)hn<\ώ&!1]Omq䱏#ݱɣDҕDtـaCj%d}+s$(ikyV,$'ruďj`QeD eDHIK..>G•!r$H͆ "aRm^=0D!G,F+Fr&KήsL\?7DM ,*BFB.2T6;4#LW.Z691&u-MAԚ@y9g̫a=TLO@d,S A6d4l{_~Jݶe >,aJ}uݵjG63PY^ːTAiL6I*dԲgkTS M@{P`GZi,ƴ 8Ԫ:~M- #M QL^et8? ؤ:9ғ>݌Cui2;LL :C5NPKQ;\>PCnX o6M-(B_+Iq``~jxB%f ߔftAϓ2}bZ~8ٕǾϜo{=#2{Q(pj%/pnT~yP68|Qi5/m/~ަK?u6ӿK-ra(YG-h,6 ,N %`R f $vVOD`|] `l ب`)(  fY !!Ĉ. v B!`1Ey M_z5x!~ &2 $̅Z4ΏKkDlJ!QbMNNP4NAp9A4̷D0eS:DDE㺕u"qWv%AbǧY&D DW#  95B,4\K$^BLg0@BQeD(Cx@DCHBG34D ]0B0e@n @HB?5^:0ƧA@A߈>B(Bv.D[pBAЀ5$ApA|* C<@p54 jB݌rHf D@ARD;HACLCL pڀAjCB@0<_Ğö4`[4IЪKOv`.̀|s$*'A BC-–ec ѧ:0fzGO"nJ@nyY4tBBo.BB4a\ZHUv2άdnA+_뢯YF6(N60l<5HD.$ % D+ȡbjAA1tw<@؀,B$Bj) @ qL/)4|LL^LX8HC -B,Hvo 2CWHclp Y@VJ,1t+[Dk[6$~ D) # tQ㝭82prdr)(/*I" )n /-.H,[[-+'3'm00Ep3]4H Oz+n-0%5wTtnK;,.39 _/ݦ T q%Y0LA;@JB-_D/, 8sF7M2rH.Bǀ64.x84&,tߒ/CJG4߂ t Q\@u6IThApATuSch5U V/n Rx"Z A Z-"u]ȉ4B#N^/"k!,Lp/H*\ȰaA\#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJ5Xj5+`ÊKٳhӪ]˶۷pʝKݻx˗oտ LÈ'LǸǐ#;VL˘3kNص͠CM4Kp ߚ^ͺץɞM6۸s= ȓ+7)LXУKNسk.P߽O|ӫ_Zj#cɥKH& 6FVHfv"H"?, 0"A3h8j4Jc/"Di$AB䒻YQ*"@0*X ) (d)&Vi&l"@9DKU4J* )R*|(̠+i(z&fUD˛2q.J)y(D%`*jkg!e+ ILBʝ E̚8ӦD_!q禵0 )ΚJ*"%.% 2,h"3′ mJoG(^# 80&'I-FfShJj|Q_&Pb DAMr@QT%!,Mjf#%5,"1vTLTA 9,"Y0qhS3^PP2P&M(L; ? €*AAG%}$q"'sB;nQ-MĖ9E_N".P? aX#v @oD@g 2P;zuQ0ъ@bK+Bq:pc'yzeD 7ީ ꝶЎI!0 qc)\[2u89(i!W )@0F9\UPaLL*=PڤNRVMJS3$@`bWASJP;jd3M>H h xzО !ӧЧyTy=(F p !꨹k9!z" 㑫&K @볊jN;=KZ9*?*Y [_a>k$jK$G p۶(pr;N ekC{q K{{ ۵ۧ娸Iu[$w[Cr_k<p{ a;뺰[;[ȫ;λt Ի[`V{ջ˽[D{蛾Bc߫KZX[Z Kѿ !\\||, ̿ < L|"l"^l=P*`,=:|HL\N|9;\#@|-TV|X,AkjLn|% uziLbl=9 /0P,7\-b/ .,ύ*-0>2F&.+.f])=S-1Y^[]^_n.DXNetR>y^~3^NT^G'=Ov4n㒮%^UNJ.֔@.j>~nAH.-B쿋l)̻!1L<~5a!N~Aw^%HU8UK.;~Fv$| t5?_C /y҃ _?!@(o#"O%.0i/P0181@BLoĠ }0cMqKX^b_Afjlnpr?t_v|z|f0q ʉ:o_7c`,[y]_2AS `&_ǥJO AOV _/@-@)o?g3_率_p# o/? 1OX DPB >QD-^ĘQF=7H%MDRJkA-męSN=TPEETRMG 7o޶g:ΪS]~VXeBJ*VZ噅WO]sśW^}X`… FXb1YdʕYsʺ=l5%2ljE[â%DmZ߼K6q‹gXav_Ź'; <͟G2\zllď1ߒ!f 7*BAƃßskAzk*D9)b>FMM˘ ,ZB"daAx8#=Lg  ml.D;xocI]? 3ip r'JȺYtA5١t# u%_%" mjkV5.5|DAɒ`v)Mnu{I-j Ń%$k `bDLxJK+ġbYcW0aq D(u ![HC"B~y 'd7c0Xvs2v W"EP(C9g.@Mҫ# yFU"!Iƿ';KduaJ=8/1\7_G QhwGfQF-[vm4fnxJoȸ<AB n."Ѭ!h Ƒzd=܈ <ֿ!5@)R !z{cR6mCz )2Ё$"H7cNuنqSHR{!2H&Rs+ c@`a܆h8ch*(0dd e c x q~‹ƪJ[3Hqq`Ah! #]載}&?mjcÓ A($9ؼWXvi( dCk1c`d=C ˌmx'; D1kWdPS'cvtǿ,<~Ǣ蓃$ax~ћa}ʨ\(,02KXN#34kx!J8 P8Ll><;ozlHغ(Lh ̲ILK&Mڰx`ǐDv O $˄@ ;|Mi\ +PNk#%GʏQ8kÛÈxX_ 1"TxPFu*@ M,,D  JM U+A{!He6|phy3PHp I`ЂXt4? u  xx f QK~-bC9$PPf#+тЅpԌ[!{у$X҄؅Q$NR\M{Ji.1]MH)+©M ,FS:չY@S CcPB :e2p99Ҧ4Ju&Uh< UтyHIILՂ[%OB@ ~\5e=l$$@6]@ UՂ0\`3pʯB EVm J kԇ< lZmd1]Uu1pMNm~X_T?%у0)ElK `UqSA؉@e1;[PՄL9VEem/s㇂Ea;20Vq@ƒeRMT"S@(ҟu}=]1Th+oŗ$ @e!b΃X[X9^ؕi |!e0Nzx(d;͏5JϹ!̬ ܍H]ւZteňw<-O15KeF3]Q4\w\H]` ͝ν]@臑=")S ]qvBň/ެ }WmphQwފ@TQEY᥈`K~1ޑV$f}xHZ~8_H"iIL_Zm6-}p7Y必K``ޒURp_钘x=`LR1Rq!zLu8 =i%&XtuX;0x yN[0L6@2؛Xpb9\4vaN$ ~HlqhcUmP%-3VtӉY$exרXS69hΙԛ8e-oMeC~͢~yɒ(=dtmzF^vs†QO;7JmrOwtDEl/ i#sW߈Ofd0ۅ@iU_E^dVW~Hgg]ͩhvyh>n' M]UfYEHwh0WwPL.1z}y p|߈C1 6s5Vx^ݔx@~_BĒW SpRy wE phoxURQwP2g8tak=Ũ'i/O6OzĹ8,x[~U7Gegwx ~ SiKpKa[gІz~F@ٔ_^G<^)_su xp㝟_wzyPE|^z{XĚ^3t/ S-{2pS7at,aXv뗈Qp-bPK2_wc2{΅m0)x,hl!Ĉ'Rh"ƌ7r#Ȑ"GtHd!%Wl%̘2WGp̜:w'РO2@FJ ąK(ԨRR*֬ZrQZ06p-jY!Êҭk.ޟ* /̹ kF0ĊKүR2߿ŵ3ТG܋t@f%]vh\G6ܺ:;4lxe]=8ҹEM0rӧ/$jV0\׳$;uٳi{>5D\?C7 >RuaVp_6-(` fL\N!ҁŗidux(Ad>4wb A$4#m~X#A)F38#$Q`~IYA@<69@]9&ueTJ"TvPf Ԗ^6AҔy' |yƄ3c<:T*f=aqNz^H%B]I\꒕ګ!J8(+QlNv6%*X$˲"u-B Jjb-[iJ :.+,;/m/m!n&|gDa;0;0YW&1KpMq%Cb5l2-ܑ(8޾|39󆚶38WRllI+{Ms/=5Uku@0(5e<.&6ܵ u-q}C|}Pd7w0j"u+ޡ =KK>97Z-P95R~w>:YnÂx魻naۮ^V;^7VnL-"m? %= !A@,cR3¿K2p 9{0 `FYW\ !t}Oh6чH@ xb/$H+N,0 eDp qFc[RqF 8+FPj\D&Hh21"]Rӱ##?Js%3=Jjä'Cy %*IG[ S+20[ѯ~Ǔj MEry^×1Ehi0Y $ܦg N\Nd'~$S1YΌ0Lʩ' 3Hti 8N|E ? 9U@h& \(x= ҟD XHGGcqKat4 =ACܰRD6MAQ !Yt WMG@S1h7BP Z;bڕ{%;R N0EPQ&=A xIJiȈ` "aH<F% 6Fc q L04 j)] 5 4}ACT 5=bTD` `AQBu %^ ځTb %¤0` ]V9&iiC!!ϭl1˒T@+މ@v( `4 Rp2ҁؖ (HF"VB/OW9H ) f0?Ȣ\(n@d 5H ]@} ,8F7ӭu~IWc:B!~3f-;Pxo}{7=&U1nUP6<ڨ"S~l2?6{<oV9;LjY@滐xX#6ʙ'#BxAEޕA0pADk*!eH;:A/)j^"  ܻ TtD fY@)4x^#Ӆ?D0wſX#6(3l;B3WTa! Dna4 DPB, D.|aHDXBAtD38C8ʂ,C$6LA'T@ (A C@At)$~A)?ȃ6C"ޭD@,C$BBU@)-̂b'a>ZC͗2U\HYG.:8<6t6`F6C8C}Fsp8$@-'uuT2:, I%݋ө(WADrVDB A hzh@ %6Ċ5 E! hA A)%&).6)>Fs%)Y)NDvm!,Np1H*\Ȱ@]#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJEqXjʵׯ`ÊKٳhӪ]˶۷pʝKn]pV˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺ5K]c˞M۸sͻ Nȓ+_μ98sKدk}࿋O~ϫO~ˏOS,aP 6(Vh0aTBʇ 4J((20H(\@12ra**9)c\LrJJ~8J )唂 /T▤" (L Yi&U 4 g( *z A/` ".5ȼ@Z3!Ba1A8l!@'~EU 4g'"833#u\`9 q D_P'ސ6W8`ĩYDX1BhB!ܟbAbC0 &04&Z!U)Zh|oA;J)(&la e! -#RBa- L(:D& ;Dc0(ZQ}W)ƽE#7Bjy`D Z0 !4# Q%@IrTH-ALTD<`'l#   M)@2!c&̂ qE]n%ƹGU*B @Ai܂b@YI=9pnchGj b D@ @"4#Bs @G jP| iERDJRn-BHO)`0t70A ᠆JU SU. dfh8UATP:pliąC W\ս55-l5z=bˠGd'KZͬf7z hGKҚMjWֺlgK1Ḇ@脃 p2 jH#ӘFA VÍnlQ mk@WEw " d] /P Lc%7k # +గsH$y@LD#! H6Štq`@|Ykix!PH`6ɓ櫳R")$i:((k[2ށ#ߠXC64` *A"4 6u \ %A@^q E""U$ZgH5 &@J`Z#r70Ҍ |#FHHX 2"tMT'18XK5y0Nb X8`ӈt. SH " xru-S2$)l LB? ?ȝ3$<HlCB@`A$ .lnH)@" !E9'i !]a *"#F2D<Hy, /al f9Ut /6\1Y캰h@?P!?}T"LE#DvBG7t`$o$2\6Uxq 5$ C-4V%.Ž5xAa`Æ%(jA6 @ @E-,A ,&0 dFFF#m;&bwH0@ba"C]O1DNLPGdpyBBLM e>H.'d 'YT0 t1|_6Ʉ w? D& a5 A xj Veqb.H°i!LS 0 `;g`I .'4axHwP "0 7RQYq w>W Ɛi A30W 4`x1 !u%@cg0 39|F35uHMP Ѓ]t Ds|  `P4` v  Cjk{ f6R GYamv T' b DnP P| 6T W#C3x%` Y 2 D=RfGlX g V uh pU43 D ׎nY)Pdnk Au  Q4` 4(  ▒я%T6X ,%quT7 D9P €B5yX.2~dn=@@V(a ir%n\ MY+X|ImW yYtfmZU;6< )YG, Z U@Y5a{U2[a y)ɛYx5hIΩyYYy٩9T؉9)Fr ɹҹ,HD Czi陠 ڠ qEڛ Y>ANa $Z&z[u,Z)+ڢ, QP$g8:<:X) aУDZ>J!F:JHzJʤi"( nTZUz1? _s `V8RʤjQF 1tJvZm{\:Z*qڨᨒzu꩟:ک<ϹB:{QYeW!f= ƪRjyOiiI*؊ Х[*TيZۚ P1#2Q; + {k [w:̣ X 9JKt *:"?? 4.1˯ X? ˮ> /.BDM -Q+!QW+R;+kA _++2=%Ŷ$!<+9 q+cS3m[+_2q|oK{8t;+K(ӮՂq깢5*a)ۺ;[{ۻ;[Ƌyk:;[; p`];1 WHX!`0 kk+ۿ lΦs <~YD<"!<&|(*\m.02<4ܿ\8:2@LA\1qhkNйTq LY7\Ųc\ H f [|fl]Q t̾[uIVx,Z-pxǁZz\({(K bQ@əLf tȮ<+@ ,lY]A9l ngH׬pM:.#ܘٞ٠ڢ=ڤ]ڦ}ڨڪڬڮڰ۲=۴O']ӏ,bL`ķ"pp 3;E n ѭ;foRлj 9m[쭼ӛMߪ0 Z;. N|&h@H-ќ!10BMᶋ |8N:.| }s]l001 B⟱ MN a~8S1 1q - Iʮ -# 'I(l;1 Rfy1 1qP+[/X^DPA閎'B 婁 H0`` q 0 )N-\!π,S.+Y^^5 SUA R \?q:#~VGoIQ{YmYpUMH1ed`~21tb]Nb !Y 421غ &o(MP$ vK2LuC/0(>G0ݺi{u.QAHZJb_Q0"_1 2kv@jݬXW56R7ZɻAk`e@US' i@c FNZg1`na\Xdkf5h O-`Wp@ Ia4⭛>eQCXs @R ` T_ QqKXQ|'-g$ A% B >QD-^ĘQF=~8 H%MDRJ-]R|RPzW/⢝,C9ETRE>UTU% s!WHAe_~VZJ7\uNwd" rnBЩ^ƍ3cʕ-_f .#Y1Fhԩ[슖@-aTZgWōUNm]rmZm z^v ^-<|H_l7&*j@S2@d#k0B !ZlB  rTp+RqcH@LBϲycE12 D.x)H 2I.# J?մ12̒ ɓX#B1#>0 l<5f ;I@qFSMAٓ4F4+}ʌ >4"1%5%lk#HKe%ci  b%dWDU}%֣D"P7ꄍb(l#d1%%4"mq&V/Jƹ4]4ۑ-^sBd2smLy؝ U 3a a[~0m7}4 c0eccNz7Ȉ-H5+"@.hǠ~ Be!uF^0*}vΩ&v[SǖnEy療V_xP6HhaX(&]ypٻgI?5'}# BBVȵH;tI~Y15Em'^"Y ZuJ1ʈđ"ڋG wp>| t>1Ϛxb*|_J.21g}1dG"`H]ʼnxzIz% %cT&@!@ 3:Z\D5Q9|8SAs$ (HҦŚE}0tCy N\/":06| lftcLHG'l>WB0v4H A Q$xDG(8b䑎ɐ!oG 95 !d AzcŇ$@Oj^8ɗ0R"h#sFVBK_+`iD<`42YDbI1^?% ¸MqcA1\˙&1Cѿ>%L:$, )3"3Phkgϐ>GRD6.BFWB CINv-b5+c#ँFy$tiLR (8ЍEy 7^G*S13y)O6 ͨWj]ziᅞ#ˬլS)CYZdG8VyVvד,!z5lb7r:T4;;YʂdI!y쯲-D,IV0^h#A-$tM X+ֶimAp[PK`GnyK .5 `zlh%AZ;p"~F:rgf3vs hwAptmH8 L =zGQx[$jPI]wྤhwϔ2B1hjq dG TU<эSE.!~ ԦchЫ; %d M_5 )|jtt cFQ^xӥ{*}n閠#n.ia m]I2t=(Hܙm,[ DVBhߜ!E|ı o?( UOjduLִFQ>na,MǢM#b,[n''ӒǢHe#/g_VV{P c)>BtgK GGGucG`7gߑI;м#FJ>GK+7aZHW:@rp_+ >\p0h?{:5A\4g;@ \)c4ײ8! | LA, x2*D & ly¢%ٌKtCr365 %4wTk"lç z#Į@|x*$6DĪ3iʮD<߱L#99@Q EU,z:x.z@GBZtŵD3; *2C1^EʱҦ`_ 0;+TCjl[VF迱pLqvرAs h*FLĔy| Sx 371lV+evP*GS[N NYQHΣ0x;8 χ[ӯ54I4KO1 KyAxO,K(E y< .XG E0\ʜdx ețKdЖмȬa2D=,ѨlQ/,bKbm m.H_҇?PLҖ|R қ*̌xQ@GRx4! t t,2(i؎C\٨8ܜN Ԇ0C] HRIX4y)tYFL C6M{ 4̧pѲ}á[րwS6,l-s۶(9 TV Zaڥ]y-xªQ}eڼ[z܌ȕSa5…bwi#b$aݽXqPA/HbܳYI5ㅐiH5>0h-cГm]=6~0bc$RmBd8բX=Um9~83Z6Zd,&Λ ~ )``6 [N1`+X]dfgaaeL>ETEmancq&紀`dK^uv0&yq뿞 ixfk.L.I^hŶ dga7w`j͆?vF#EFmp$7fʸfmmI&AxB I@BfN `%V* ˝NfksAJ:(F] Ao g￮[~w MoGke pkl lnppDE?Mi _oxdex@q]q7qgo"]Vlo"r=+oթ..s8)*ɇX4yցsg^:i9s/g٦|=e=oZs@;pC3WuFt-?o/Iw>g*Ms2'YO_N@`3٦y6G&ip:lŦ3uaCtRYRW Z(i'1e8IFX6f,O&šONcG d[musol7vd@KXQDECwRlvxRFG5?bywxnaW_x5ef4-؛7O N^gҐR_|7'yD ~iyTQۨ yP?HF$Yi8atVZv5@ $]xpX;f:@iHXU`? h5XT d@$phJ_/`,Jk&x/5@v6o+pkp0'؄wO6@r晆Q_s0xesܬ ` ,w D )B"( ۵tG,i$ʔ*Wl%̘2gҬi&N?'РB-J[k5"@qjXI5JrAI'iPD#tPZ!Hg.޼z{w.ll W p&84Ex-63`#Q0D.X6ܺw7+^`do:4Ir3 xHFXH!b o8; ^ߤ?hV\2R}SK~8˿?oPҷ<`glC #+ $ F^.ط> LC`/hgR ~@Р!aj(!J#YHы S%RW<Ŋ^ 2n`<#.׻4ұ 3Z}(Af|HB2{bA Ꮢ$&mEc&C)J (SU|%,uR8y-cb@D2Qsܟen%IiRs֬&6lrs&8)A&Iiu.1 !,Lo1H*\ȰaA\#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ,Ƹǐ#KL˘3k̹ϠCMӨSKNaDM۸sͻ Nȓ+_μУlح: ,5O[4A^'"nP5 D&niEBĨ<pEIA^b*KwB_=F}|#8_Vy@`.1OH&) !F&xs/j hD_G?<(@ \5R`8 B Z"rEdvڃBX"٩-18e0Q# #&1PE1!k\Co` ߲PV %g LXф%9m |F BBů)H@EiЅ3a0`(Q У-A LOm} %`)w2IFty!Lf2ou\uAW*kBA&OJ1fa2ׁUąA([(x*l^:.X<1 PZ%^NDy/\|6;um(fA E!_Wے'/kޖ]a[wQgz xKMz|Kͯ~3 L#ʇ[R $AF l344#ZRB^AA8Y@R < NP GDZhK$,)QA q Z Hl$y"pbdϐ B nH#HAjL@!# dS?]:qGHDZ"`ʦ &( A ьPG ~,2Aѷf @u#X@F8!E0dk&p6mFpZ"1`!E/xqr V(aC1A\|!WcBH*FXPy1HnϤ6.sJ'GdO0/W-ĸr c׈-ADCyKAaDTP@>H `1 {N` pPgA.'H (A'8wLAt;C4zI}`퉄"~C}Q% zNv le{  ݰgEAJ jpRPEf&7 ap!:bNvDxCy k7W,8Ah'pƦ| &1o Ya r8tv Qx("yXa ʰ ' u 5-mڇEFR= ts}@l(u} P 1 a #ed PuC V \8(xexX:a #'V X eAG Y8쇆u(/ /3gk1 h^x4;0yGRX\!$E 9w@wm%Bw s }d } WYhcp ` a hAkySd7r N7 m$5 2 ] (as ? BYf7Б sLIO9p'E9 ٕH;鐑a`!(9 d $# N{Z9 q ؕ7oG]@0q1avYw Yd)?ɒcv QuyO.9y\Q qMIP!1+yʟ 2 {Atq c nstU^ )O"9$s8Y (-jɒjV"?Eq;XDZ!QE*HJ R7)/ !7W]<?av7VȖt vp t@ls:cpʧ~ڧq_O uA @p s \ډNI :'/*\J^:*>q(ጲ**1ifl@'a [7jqʤmj ;Aa@G1358d5$!;`s(9 DcL2$;!|56 \*,,|'L",/\0)+% f+ 3 ]V;`V f@@kY}:\7 ,ě [0-}&q }4b!]A&A*.qZ$ӎ'56=t:-`c0`D:bD]֐`i0`Rm4;,$mh= i@lFRw z 0 (c@_=;< {g` <``eT-! s-acq֠]@ۺ !}`؅̹K0=ݍMFRmQ M-ʽW Ks{QBꍺc- t1>w >^n,}%ŔˀVq ^M֥d`.~q 6nK}L

89NX.WoY.]j& ]Đd%@+EPFq~s_:9m)=B! l*sN@ 3wonz>-|1KT~>a>E>ٯ~#2&p pᒾ6J4QX>޾~~Š NӞ51 Ξڮ^@GU  qqmL٩`@@޵mga@ ._L .^N+0L%@۬q5 -^n?Oc!!$6m>PVG^o4 ac?^@mm dڕ mEA R>SW>֠Yn kqqٹ jm@/? Grt V㔻_jo0 F /o㧭9 -?Y~Z! ^.>YޑSn_42~K4 ?2]?_k .@d DPB >QD-^ĘQF=~!6%MDRJ-]SL5m޼N=}t%IEET鸁L>UTU^ŚUV]vdZ_͞EqNվ7k,pō,r͝??tխ;س4m tٯG]dW6_@0ḏc~U/? @Hu2Z`c0'~jчBIgpBh,xC_ ˆ80p*I?HG9LF'^CRE!/',XP(tNg'!$.11bxH 'yl3P 84/'¢1hsρVg? 4QOw#t wQ84S%J'Ny3bԹn j6=4dzPMuU E⫵Mb^ߓUJpRLHf hhmh#EҖ[oOt ,3gZaSH PAjG9g/íеd @K-zUW=|u :F~͘gGMO񧍁g"+4NkgqcxP藒셰hA"nZvy<FpVͮU^uH:Y]jl EX{:J1!|FjSL<b&Cq.,SpG)Q%d-p4a,@ñm NvM,r7lrPTY4B7l &ȹMjiS5F Y)3Uҭ1#F0" wH-Lƈ~ (׳Ƴ!)tUӞJ12$=-8G.e9Jb` fy(JgQDb@pucKozD2":F 4d/וB$_df};>c"0 0aj{U\C޼c Gm"}!|)ӷ]QꒄMJY$4EfpbCe;BZ""KB~h?CLk?Ki 45sgCli<-6z;El x>B:#!g[>PJ9:<U7(i7y`p؆ C @7%l݊)IcPEC2t sm4Tÿ8t Hp@Xy!b) 5ARRH E <Ĉ7O [Pd83Tq 1;V HGT$H?amjBƢH!Yq lXl ;S -Fs/qi I ܣGH@(蹋8+tIxSq~NIphhH<`4FC`0(B"x`L 㺘˜HcsI lWw{wyG(炒 S uɳ<T a lD[z-Ր\ PJHJ` ~b|.@CFI{g@uC0(L~@p5vبjèF/L zCӇP#(@ MxƈDX4cC~[py #,:^MҘE< @xM̋e@k"4X@w4Ϙ!X"̋mٻ]k谒ՆPuڔň"[H@B09DWݓ&m'i(uX%fKeخ-t˶e>[s=/Tv0 c[p A `8& PV:Z@]@ Sh ݄(U08:Ԇxq\|7qLeNi}_X KT` h~+i8\\h؇ֽO-kݘ.hZyРWxX)E -1ՊIW`XANK t&F mx-)r ̥ʭT s_ױ*>hk~ iZ-! hb8RXmqB d} Cf"0iL> 0edJ EeX^rXe? 9EZAdHQ_yipY΋ 5IfA9gfAfoƊS D֍ Jg>!y]x~O~F lIi~+3hXSɁ L=L2Ijk`>pb3F h QPH Tg课^>V0``8+dPWYCgvgzfj{ k0bJ|Vy@F5bV쮸M>Ah , ;h6#p0bg8v dfPd a(Gl9& > 9#ܮWgXKۺdKQ`z)f>gfKۦGmЏ_ c(oFdc&Xk+Pv[_@ňV il=.ޱ8y1̊`upp'˜,Ka|UGHF﮴,Q{d8c}C᳠>_ 7(l]}-Xq!qnjrݟrγ%nVre6d 4兀YQ m6mpl:W1^ >?ef>{r9 a K_&pim6򔨛F>FA5tOxȄطx(akvkN,o88ɳYp0>\//mnP;euJOf? yVcTfŪAyPwmn78f HrrQ0vwwpkgETVZ+Gpjv]Dt '̑txv&Gmd Bw)akY~7],m = o!HAx!xX_Jzp(#,0'! Tzz`XQRղ|h{wW|{m e gPvw/PZ: vx/{^!Ӗv+w?| /xxdlwsp@,m@7 zQ~}Óir#6u# ]tnW2rP=,+`c# l qDPt_qh+ax8e3P%/q6!2Q9-u3Sd(N#=ANHTĚ(0 >Ûx;L79fLtQ%~(~Th #Eɜ`|%Rθ<𣖶-HdJsC\m%2!Y.,f.G\0]23~pQ1ywMA@~#% CykI=ϩϔ萙7Fl(eđ쳡+90o8 >r nr(HEB@2qยv, mdTwGC*S7 Ǘ.8k$Kg*TMJ|nC}G:FAEϒ:6nP&cZ՝f+!1Fh~$kʨֹQ+P"ҵb2#y˯>؇m"%s4]XQ0'㮏,#m$[iZ6.qq ós-p+7(*\smR÷-]ha,dSӏyhNG=Hֳ)H@ڤ(l@WD5QF "wZ0Bc0JAc^?|07\Ű@=gX?3>/Sֿ>h' D>f}Z#vzC:o%cO$I9 ~샛ńGIDd藷60P zאbENl W0l:Uf ģxH7JFL^Q n\ MF0482PG@a-!Ւ:5|3G<䃰mD?Xa6hb۔uh *! * '`m!D @|]\A(F, PbH x0!:\w|a A;h4hExA#ȈF*#A«2.Lb?C+\.E6A @4@AAT&h FBFpB?1@9l2̀ #4BfcONmAv 8XLn;p@eZ8Mv$'D9F@@dAA@-# %F\\IA%F0FH$ѝ"ffGX4$=J?8ЍbBlH24I($C45Wb33mK8.'IlH-U,?Ɇ`K,$^%^L8@-a8$7ęJ@B҂.*X?4?t3ATAPD@E`!+ҕ A]W$C6FC . K\j dvj>ՠ8bĭ## 9rB<B)V+Xݤ$(3bAX] B@Ceʳi !L+*> x ;nrpoDB9BB )+*eU*‰dz I3pH'0 8D=v:ZFIY :-`@\o;"/ X<?0P4ƨQb9"htDB /HAta #XoxK 뷐[ I>7@ $` ّMW4CL,]D,P=޶uAB!;/k <ϊ!::NlЋYpp(AT?i<"_7p,#eP o!nߒeМ7C3D`C y@]oT"㽸"k1 '-hht 1 rxA vx3{pWXz {x}vtGtQ Sor3 p& p{~q `@V (x } &0\Vb' nF(Ѡ ` pvv ` o6~A ,(x@(P NnwQ@ qi JEhQ l"iu , 7 搄0; 0xр7XOyՅi#tbm H gW wA|х v% 'B jx@;Յ6 k1d@ZV x`H gWEgpD1 +UpKj*QZ8Yʰ g KHa KÐ P P g u Ÿ 9ZB 1 ]ȉPiІ˥@AldJGfW ` Hi: /G4aY_+bEbg ` - yBAk|8 xA vX  f(`>\@h9Ryv0 q8)vLW'^K Xh f8ЕQZk)yxGQi^E^0 \bpa inᗪ% OYyٚ՛Yyɹŕѩ @ rؙٝ\I֩ )aI@:#19LJ*qLٟD6sOyɁ)PC A9Ud ʡ'ڡ":$j"ʢ}# *Z4 !/ĩ0#WdRuHH 7 :VP UWR[J]XSF*jlڦn:@t{s2Wz|ڧ~:ZYiѢ87| 5!4A$/seVfp&a:V1$ % a8sJ*P }ױ]*^0:Њf*ʨ**j:jՊ:Jߪ Z S0Yʮ̊  1Ě [YKk{!;#[%˰"隲JQtBOˮ$[09˳- (+kBDO9OjJqsSP R=C_˵a[ceA J+mKokU]ǚEz۷u~ŷ[_uYk+U54X%l   u Da+kCCj{;E3 [S$ k5gQe[Rt\A|ې[0f_9`}T۽a0  {~++»VKzo!뿡 Ok \F] ` ;!ELa$l-"\(K^q)a. 6 5|>)=B,\4H;FIP*T\T)L,ŦkV^l\La_<ƪd|ƲlkLU7 TETW%zLKC2iǶuO?E9A}_ +Ry>=+ɺɚU|>W|@@_e caʨ,  GS ƩS `A̸P`,-Y&κh3ܧLjd `Zx@ < e0 0 L-Fcp mV3l ]lі 4I100d%EkFҰz -`@Pv ,_-ϰ p?BMU. ;|PPE`,[〻'ƤvZV b=-@vl Pk=UL]Jֹd`y~O{]،؎ؐىp]';lٜ]٠ڢ=q=ڦ}ڨڪڬڮڰ۲=۴] 0P5ї ŕu ]NJzܜΝץ]ݧ 8T ]ڝٛxݒ_-ܭߌ1dž<k+ m<Q߱[y86^P Lj]ؼg ە|hA<W,L:] O}IE8_ HI~PTӋ1`b[egNikpr>\zn51~>Pvl݅{OKZ̛`ƚ.꣎ݢ*!O0*W MG}!ཎ.^*l BBA@4 Qe YR1d0Fa~!qʙ>b=}nn@> <!0']0 Cvv Oʎ]o ` IM_]M^TM! `=sM^1)~_AH=;dd0 `qL'Ng>R]1[)mƀ:l Z\Pq``Ұ8a|_*~I]I?Qe 0v, RmC!0/ZnZ TѰ0 /`ֆ;^M7{Ƃ+&$4` FDxb kk1b$0BvLq 6H$AGWmk=?Ŷ]jQMHte-Q褫$e8 坉2,vC*`ԲUI'*XC282e>(m62?dˉ$+bpD& @>d"etu2/<l"L91w6z5'>kAHˑY?A zMaj0ᢵrlb5;O5^HhbҜx\4ʰ,Ă;LIc5 Ya%%ȶZ@12A&xdFYc␥K"cׄ@ԏGvԨyH#w=2B؈k :BdDymdCBɏ~q<5qgwz@!D]G yl;(xOӷ}2D҆@A+|xz@BE!6~!} 40>8e +* >MfG ?}AB[ ^"᤯c 8X7GcٸȞB&I%@C<@"T;a1fBCe 7Z@3s C8@5"gt +u#a#/ `$  L-؋#(;#hj5!\~( )4P MӶyB~ # zBPBS ZBYX2Py;mȺ9)Bq :-6lCHM@LYIlڋD#Pčyx0J  !-Z `Cuy6@ Riſs38~e3uiو }FxWWr A $ <(є҇uDqzGH4 t0`Ǿp8T .kMmvGz7y0 8&o ɪ?=XMxp0kTq 2 n+1 v07mJ)&T;C6Pe38نQ*0պ5l [BJJJ;q~8MŠ拥ME۟풆A<6ʼnO=F}!]IP5X=Bt|mL ‘2\Dqk BTiE$gh(- Vn !Qt 2`ЬjUx z׃vsbO׀t!Lcص,m:M$ )^5s=BY k9$U釻T|mz ؕ HTɐ  XHǢ cXNUՉTK ~ dPaU v;1E5ZQm ~" ESQ=97jDbbXc jI [UK;$9d0\x8,mЎ5 5US}'k1|٩C]]>\n[# 0v@%a]pl ̵wEW,P } -ا cѳތU"U[Fː| y*l a=ߣHu w4FSۯ@ߖR_ F I6kN_߃C2ȇĆ! niළm\X"%peQ'v$ Yjb+~_/)G 3 c(6.!52"9v0f)*ҟT?(6d[9 \daʘ^ˍ1#  pH%t=j 0V;%jN>eFV4Alp9ෑCYib8 %[jG$4U_4H fSMK M6I2r&t J.@ AƋ4s& bv6J%6<9V I]8hgm.e(\mů_~މN 7[Ɇb9C70 Fjp9Pc Ѷq^-Ol^[#eݺ\6f~kmkNjiX?y8#VjR2@k 2 ePUSiylg:Q#,NY[Y)P yklJeeJLe v~҆hZkf~Y ^`c^Tu/pT<'xMw.n _@n(Kqk<a"aݘӞh |B10 \n[>po{;4^prN"RFٮp4"a" gQk'P)pe qunIU;fq⇴P$./i8hDRʍ+Qg 0(U ~؃U~- 7>f֎#0!~h x(/jhGDPmRyl7 d6 :uhd%vSߘv0lDA@n]H(nn%/ClpJMX%HuXu:omKAt̔+uq7quсfCGeVqh93d%V$NH:mІB5wIntdV o i xRwb^[?eJ872Q.>~x3gxp^xrv& (?tiҥtG pUmky 5ۋ)wa ɟ.آ?o3͖ibxUo}x1 z&7i e 0q Ba ڸǓ y_tȆ# 콿4j2Yr~~jt /_|^[~ w}Eُ^Lַ}ZNaݟ}Mqxw,~vw~g~\1懈}{[b>6Wg}~yqo,h „ 2l!Ĉ'Rh"ƌ7r숱cgh$ʔ*Wl%̘2gҬi&N0 WΠB-j(ҤJ2m)ԨRRj*֬A @R+ذbǒ-k,چ;{-ܸrҭk.޼C='Я:$Ċ!/\'StO7.mh 0o\pL7pزgӮR8=K5eEϟʗ;41sƺ 76]ѷs%,<^#eXxo=pz_Ic6ag< j[8@KB GL#@hiCap!-v#yT/@?"y9 9$RAv Bis)ܓUZIyDX'*F\)`,myk]F8Pft'}Zd$J-MsІ~N:P("J2 !\D)[ OӪŤ:_/0#ϨJ'JH:,V~.F:2@ DjҳR]slӎi-V,Ju<;{6[ԻNxP;g0oO[rqSw < 2&2QH,<-W<3M3ϜyLqA =tF+}4Bpj$CRꌰ:r!^kXVҵQQ\".ut h_*؃u c^Vum<6$@ͦu? YΒ6YbP/L%i,K+[R2!dPDآhpζ"CV{$!1aA8a@5>顤@1du@i& 8Ax#+4`S~k+h2j>0H3Rr ' mdAyC<q`+%dQw  Va V8ȠhpbF>ah8@">lȄ }@Qo n8KL/ 6^ō_*#͕@"`&@l$ N$ T @sٽ#~7ӭu~7-yӻ7o<Axy-py!y[ <-Džy)xB#Qo?炇D?X@k(yYTr<0XT^p8Ud:ҥs  'E«9ճ7Z:Rf' 3C(=;"s`nE-8dqzl/%~[](%D@\Ӿ#C @FPݛ+*xg>Cp#}~ 1;-O/ٿ~؃>H Bp@>L>1`>E A B `A` fv ~ `RT!,Lx0H*\ȰÇ"Ad3jȱǏ CIɓ(S\ɲ˗0c2,]^ZY& l6(O Mд2,#4<(&☉&HFX%5kJfIS 8\#3f,E#Nn,Ab -rDT+` k°X)ZKkdL*B 2( 1IRP2I,+Q(&j1P Iɜ[?mF+㹹B%f#NDs<C#u+PgIA~5a-t7fM? S Ho_8Ar@RH;x8^\dSV$" `ADa }|G%`\F&>"F)nPza{ kk Q ~hPPEY\tgF h Q̃ؼ}t@=! A R>ÌqXA( 8FPa D{ `R# Zf`! Ph4b~"$H0DP Y>@" +p %~Ga8BZ1, 9S"IHϘ1B$+ Gq D#V( -v>Bf'sh$D DGj,M 3z2EsYC0ɿ$_I nR KXD# 0w@5I`'-IjeȾ"HvӚ 'fD{4(E^)v;TΘ?"r_ '~3=7hM(rȊ DRCXҞ3ωzUKVd>AҖ:*Y@?r <( kpħ. jryE"\QTPjZ,*/ #AZQvJUXcGU t^mkPÊ#xAkZ!irU J@ xj[0сZ$hZ1 V D|D0 F (RVh p [h ꗅTȄ$ :!#jDLڤNgB TZVwZ[`:dzhj[Yl`p:gtNzڧ~:ZzNԨ:Wa bFfh〩z&۰ :az0 Z L) #9ʬJ:ګJr:cʭx9dT2wd`0mpBc~AGt穭Cd  ې 0,ڝ^*#z "ʖ:躭zF  >Vfڪz:0 F @ @[F{Hj ) +]OQVzQ ` ! *<[h+ ,pҀ6qM5m* LL#`,!R-2-2DگaqGnb4Z Q j}vE;,һ\bpGL2fTqv*+= Z}225ft=F|Ґ ؐ!+R(fecs& Ɩ&&QQ !L`S*a\-p-I T`u ؀FbA4 \-W\0SP M0/qM3)=@(Z!l_bz( ^!ݧ] 2U)P`6č 1H #a2Mb ]o] G۵Aa ia #( Xɐ ]d^M^`qW2$R65 ِS'7y,~QV`dj-2)  xol ~ W9ts<; *릑3arՉt~=` ^ځ2N0@ϠI xͮq3 s`a+ Q[qUK1B,UWhԎŠ%7 i(" ԭ z:H_ `NR?]lTa aa>^ZN ~E*`_,- ?1{o|"< JMrtP; %z-U(LdOҡ'=aIgЯ?q[|zA !/ ]- g jMz!!Tc60^ q]c_Sa ,:_Wq !Q,(%d !@@ DPB >QD-^(F1ʓ/BwMD\Tc'SN=}TЁEڑˤ P 4 V]~v!vƴEuiڄm N\ll1>iW^b xZō7ZsYd&LX4' D~2`-O !(׵y /mLzX䠱Zt5 v Ԙrކ<J!Q ЮR rR e"͟1 0C 7|i ZjB& 6Ã⁇o$/372fZfc Ζ\(b#P\ .kq 9KJ+A"դ D|ZH`0.[FzN;SobM&TΡ6VP!PxӬ M OQK:RM7K0FU{l4UUWPVj>ve*JWwW_#epWeez(!2"]Xd[oHLh(ۍy\w! wS?]H^F+(BAmG .΄BbYVLY0TQ2q!ҍS ෆt%{f}4%T2pHZ+du"W 9 0lygjGgB#[cԵ4O4zՑ( [6c Y u[ra3UEyNik[lF,6w?m_6v)U4"7fkFGx7&^.!]C#}cGIxo">j y)Vq,܁U_mw,Si߮لCNH-v"O3`⡍,1&%!R h0$z r9Dy01!HN ׈X2w™ .!qԂW5:BteL,Q,BC)6D#L1JN1q H3^C1hqEhB1>ll y^%ƐEf < #GFjriF"!8Nv~N/BCHbQ Zq_QT'܃H;DşU-eQF³ <+& n/"2,l'IM2D1SXX3U;z}\;33tO|?q:y]ߪw*!£ݭCmKL'wIT8q캯}J:QT{Ṃ279OpG; $ŘGw $>?)USC8@Dk?<]L/w)܊i nwI%l0s?K6 "@v3[?@;v12p ;х" kA(c##4؛P6Z(29m/yPyȾt>!ԋ@‰ ‚ u؆d "계yAB 6|.Lwl#ih16 BB9F;w89B4i76TD!AD@hv`.0q TܱDM:XN)0iv(r>WE3x`p!XpxbDq6xQjFE?fsDt a _p EuTpc&2zܵ7 ĮGqǵFNHP'{| upP(/:t4X 1h;bGPDUHȺtɗ00HIq*ƚl?ɠ!J?A &dʨJDʩeqʫʭJ̫ʮMʰ$˲4KʳT+˵t˷KKȸKi˺˼KJ˽) Klmл YCDLKDyL L/ns0KqqH iӊW$M L51?|i ~mEȔͲԭλA( LM9ʪ𘇈pyNЭYbICZœ8F,pH"(ݠ iM|괈h}PP tڹlm #n)O1tpZQ)AГ '䰙L Ћ(!5}%ؚumPQ(%Rc@M!`-G}3uS7NqRKYHEr|!>:}4A@2uT)2 C";UH*U1HG @LMm/O} LQ%RE O5TQUVuWXƩ֑[%)^$_UYTa}J]9VXUd}Ub Vh7e`VI^Vb5VpPWr 6rlo5aXxk{wpVųjWMդ؀TZ5V5AahL 37q )5?@:m};U$dC0>00 8״3 ,ک <ehӮhSȃܱ-Y๴8 Y!B $ YZNyή@@bhTXPȇ$WY5 ( edWXP\HAN Q;tbEDNG\Æ5CjȂ@xHF Up`ؓGO> cAh0U00e/ƈ[hY+x\Y٧ͱ_.>x݁p` (#p3wftC@ߎQЁ U@t>_ep Pf0Pd`x%H db4@N rBdd!ex$p`F@v>0I }>܀ZE_N &:> x L2Ix6f!K%+Hx샚J1 /Hx8БߎHgC=kᣓǦnՀ!,Ox-H*\ȰÇ#3jȱǏ CIɓ(S\ɲ˗0W֨PX1sɳϟ@ JѝB*]ʴӧPJJhWʵׯ`ÊK*b |U۷pʝKW(X PJ LaÆ-4iL˘3k̹ϠCM:WJװcWVJmU9ͻoR"{.\Ō@YУ%tͿk.x_20c(Q NϾ=LR MFϿ?Q'h"@( $(6(b Vh<€cE($+cL|)z]"tֹQ(x|gg ً3΀&Q|ʙv@V(馜n)(*.]#N:h)Pp#P)ꭔ}k믝 5#?o,&h _a J-|Ȑ-v~.Ȥ(GlLFRqDqAo @V0 0KsꥱF0Lx1z@$jZ(I*U5INd%BxJ d*3̧>CKE@dςCAJ:Ua7 3l\׹@$`*LG?:+<@T 4F4Ya  - <2kL##IGPR/Z&` d "H2@DN [ 8S|0-!`:t +DZR5H+`D$A (!:80H1bȐb AAI"EBzE o0R\^ Y!xFd{&Q\A˒e)FTD IAOK Xچc 2JbdBwۅl( HrR dl+= )+B!`ux kW|6 @@I[d=H"!'PD @ $v 0 KJA (Ao +d?=ȚJŰq_IA~; d T8Hэ:]D, -Ad|D 1p]%(-|Xb H[ "jNEbsP2" 4lHH\Qؒl/J\)5,!J_W FF 2 5dkܢ݄9b(++Ȍ@Y 7AL#iw&y-$-i[h{ ]i'8% PAZ: '1w <0)*l p2@Ax @+_ x`~ H)t*Q1DX9'D΍w@qerU,9)8 e>#2ݒ8~6مe޷twljRy[%1ZTe|M˸(Ms /ZDXZ$ E b("v%QYlx`HTo U2rioSPwX[E PƀH` NB?" ` ` tbʰ#[1~a ) #3U{ H~0TzA\!ho ` ۦ}@}$UFP% H@ &0 NG`/ N' ƀ  G8&!xՁf qpT]qNa hPNӤ e 3ih?XV@lx(N;!} A N0@URpA!P QxD Q1 @Q#sHƘHŀWLQ w' Ԙ؍XxHJ!E88NbhSO`C`8YBs iMJ ِ9YyYБ  W$KA:91 ᒋ.!-A,a8)<ٓ$;U:Q;Gi䤔91?i@I!RY (]ɕ&A%aׄX)gɖ"!a aX^Ŕz)AIWI~*Y{)ɘ|i)Yi m"8iњ II!̤  9yR՜Й9ԉ4#=Qy0ӹ-9Yy虞깞ٞ9d 0T@&9%T!(I2 0r ڐ#0y9T*, dТ0Zؠ 1@)@BZPCz_HڤNA&V8z\*d@]:dadz^n*! oZJ_ƐvO! GŧmZzO Dڨ*1 C樔 k&1"cRaѩJ?8T`ʪa  zź !opQ t*C pG Q㚮ܪؚ"㶥ZM#z!^mj:rYBP$tT (Z*0`0 ڟ0A+>{ "˯ZBapڲ貶a`2ъ<+>B;D[C1ѲFL۴NPR;T[V{XZ\۵^2`0Ha)c[/`ai .96ORCHMzx|۷~b% z* r+Q,)}c0z9ۀ1E#TȺٹA޹ mJJۥ kE*qUĻ )8|ɥAr+7櫒~j,: ,*J-  ̠\yL 9$̞&|£ i@*,,.L857,9;;+`B:T{` $.JCiU# ds!M. 疲O1yep 츢P*p;9=Nf ۀU A_m6`@_"GAsKvӐ] ߢ"DF@ ro0? Qt/EѿTP㰁Wq1?aA$ eő-j  #ON-PxҤA{iiu ^oCuɴR"0(k 5A1.Tg_j1?B}%ѯ߿DPB >QD-^ĘQFRH%MD2X"7NL{ 1XDҒO]MEE%AM>UT8D2hU]~-.?e͞5 ZWE\uRl^}hP?vdʕ-"dUkٺZh`HF5CJ Ml3%Ɲ[7W9,AcRn͝?]55lݝ/^h>8.3tgS}avJ>4+rфjQ) TO\&}dMTn3Ƙkg}<T*4NWWvIY3,g}l e+\uCQGeKJl@+ɖ \!QE]ueȥ7qyx>6l^ 1gՖj%XBEibJ+/`ǡ‡?vU/Q%WB ۗ6Q6bE;QdS#YVyfVJp:PJovRv4׆;:y%5;q#lc]*s7CGkӡL{ yO ݘeyTdN `Qy^&. `ʭwuh~|jџb*o8zWO}QA~dpJ?-Kp]ؔpc @Ƙ½~efRZG۠N "! 9[Hq>B zO^#% kQGN8! zHI cgMӤJHZ$e,I/ʲ(ۀ\>/251 ?ylҖ/:4I<`GW~3}ZcZ4C =-H+$Iy+^Wܜxƣbp}4^?+%i#G9)q C)QΎ \%'8qg ]+lVu "!a@1tHjSdtKauw]Ogǫ;Z{ڽTꕫt`w{Cr{w]t{?lQx7†w|xW_,1P} yї5:K2Y"iӇ]c8\I S.z4$+km!W~SS&:/P hm0_8%Dg᳕mv˿pC=0-mH3˘@pX摉[@б ѽב:Pakex9dkJB1HapM@XbRmhj {؋:y#.#*L+B&.$PA 20TCI’2|:4C@4vCC:AjK )DFz 9QypDDSZkQGt6c WbEġ%RYŧ8]tW9_Z9yXR$fq1tiƚ0kmƽnGp$r4sDGx hIv wGx{L)[D|zWGpYH|R SpHGXG%#d BT1| (bFdIwDIȗlGIt 2țLǷG4G  E$2`0ʩ8x<@!Ŀh#~XG$,Q J dx`XIh" k4rN=hM7 Uİ- ~P9 Hx0<~| kW?XĈÌ$cXJJDqX: $A >9D@< ӊRHP'c¶r<>?P@%FA1n(;|؆SSXްGI ԇDͻ=#UƛT=PU:ָb@:IBFhrmBdeG!,Iv7H*\ȰÇ!0-Yċ3jȱǏ CIɓ(S\ɲ˗0 "͛8sɳO ѣH_:KʴӧPM쟳i&ׯ9y ٳhkԐEݻ [߿0as+^Fa8fL/U XWbcMӨS% &h…Kͻ0iRBqIk -{(QlE8֫O)kIyIU*T%( G(C?4B@݀ aEaJ)J}@*(h,xb((@/Ȥ! h+@2.W(L8A )$T #^K0Z|RA _c$AߕxJ*A0etr#^@a !)jq!|u6#Jh] - ?f0`F( 7r` (ҢK;(&6F+ ,Bf'!Daªܶm]B'jY[V& vh2&6Gܢ(Wlq`HX3NXЈHl]Y.a0Pah)(s*_l$#3&Pֳ`&LH(=jdmvYVjKoID#Ӊsـ~(n_}#h%p1wιKUx(J@;*2.ܸ玻ow(|]67N 2<] }hbI=LIn*>b -|I&#D@{\CAF@Կdk H VP)@:pG!{H1K$4 W$:L\0 ^gHbPHH$&6XNbPhp zXDeI`iH&2R ecIEhPD߉ ?221x @g25b ? ~H%@ 9~&I!@`NBJ d(ɒgB&12E*N@tˍc@dV MΤЌB ax$)nzSg <kċ(4yɁgB?SBg-bˁa2 @K(0  Zds@'JQc]XH"gs-HAʊ "걡3i 8ͩpT(xGx -hӦF6PTiTxQ ˂H`MT հ$7i4\{UZxvڒ( τ)&iD(b؛V$0(g~6Ԗk Z]걠m2ڦ5m$G[N l]2FUZ scG]œ-ml0׹m2T`%&L1A0 iAjhs+R( vZF `@˵dW.7@p|kpp%!Cqp;NN(jh19 @ȝSfV4}"b_:PZ4g#ȵ@9C$׉A`Z E-d 3`C p$"@;QdLv\F] l]M-pS9Ϟ Dw_ !#Naf!q,M9WȥZĀ^:"=<D|-L`<hF,~;~$VQI-'@RJ A:&dc0W7؃) gCn a`+@B"7ED ߸2 5:A'^G$aӸXFq*Mk l f:W Ps/ 8 t5Jsވcq Ԩ *zp(5 ` T%*)WF P %HHىXEѤLQ0Zt|1`:Q@ E  Zz e!:q S@ ;jJ!&e @H꺯UUZC@Sq7 [ + ZXڰ.2 ى1;a˱* p` f6{"=4PQJ?BE GIKSMOQSUWYk[aA= OC_#qo*DDz+r8a?㔑e{@ȴ=Q{۹;b61˺/.!2鐻Zk  Aa aż;Ы ӛ+'q {RbԞeAG!Ln>8cn(5KeNQϐ +.A~ RҴ= ƾ=1- /(`ݜ.2~/?1N8g9`ap A]Paƒ >QD-^ĘQF=~RHqWRJ-]S̑'!GpB=}TP}Ø.,UTU/>xtdxUؖƑE ҬYum=7OR)śW^Nf v۷"Ydʕ> ^Û*fl6?+zyݿo~ɳ".ݶ"0@wo@ `J49 xB /D@ 7rp9*R7D1EapEtp'}F+x4/pHh 4K|BpP :K;ܡvhFF'.gd#s >7'6YEbLJzAqEe?5c9HR=exYE<4_!9Єl(XT` 7 `O'XlCacR [4DA| :$ ,3%S"(v;*'YZdl`j :CFٙYA v clY뷾-F.Hzkʞֵk $I s[qlc[!z݃$ 9\ዃ"󩢕*iwA=|3X9A\T"S*Ѻ"݄jm#W ``f0 0k^ >uE&9 .VռG)~dTfmH&B ׿#^&Z@XW-AL` (K@ee#'fTeC5N԰A"Q!rM4SRIENMC(ِXM[9~ %RAiJ1j^kH>)l>2i|&Kwd&J F`R삾Dta{.S&m:emvc9 )Q/ !Hu۽vN O6|X*mLζ7w9IuDJX&8۰톈8DRB!Ȼ]% E3LjqR|缦xCo|\Gtꜩz 4q 5"%эuo}-zQog#|\| s*&H.wg-d=CmPcazћq=`B"B{ᜬʴ@tHEBE+r忚o~ʬu9ʕP!@1 ~0zbeOW4 ia$ a +U:myc ġR3 !p!pX[h~8$, y$wp8p (J6S  ;jp i  R–U) ı ÂA , ɪ L7xHhËc24 BA@9 # ;اc9?TA Rdyx;DTD 27p'O, $6Z[ :LP ~xBqūX31HɿY7š5(CưgCiƨKk8 mEdٕ(|Gi⹎0y (1 WvȆR@H> ȁ "p0PԼdHiǨЇcH2hH IXmErnRy14̋mI8vP x!ͱʙʢ I?xj|$Lhb2<ҘJȆd؆>zxA)#6|Dʫp !8 T48 ěIz4'ɼ0 |E xkܣg8@Lӝ 7pa$Fj"6p1 +MԨ`ԵvYȉ UlbΩ(Gx(h8F´dhSb%l/qI e$IVdHҔ4VŸ,m`1ؖqJ1.jƚAgs` /1ڙj:ÈmP,ypa):kghfckhV Ñ6Hx .ȶ6}種Qmag%uNHޣ6AMMbh׾v&a؆gti.uf_24iYDTIcpnۆ.;yoPo1eyoZp3h, F1g2ѣ\f HH}l b𕀊d. p 'q٠6.}l[qXjq܉p ߑȉ, !q:^򬑇v}2x7L#uy'=Ias›n/'v/w & iN9PxQ E `dHpAl)ԨRRE*֬ZrYÃضǏ@$S-ܸrҭk.޼s r46DhqĊ3n1ȌxM<qf;>~IO2ԪWnx0^;4a/nx~-CL:;CU;tT}ijމ >_+PSLÐ+l0~ <J8a]`.?DӀKQ8bj1Ɛ"-0lLCF'.<˵B>y$cMˆ$\CYc-4ЁS#?e9&FCL<و!4"]c]Ms2L] JMliHkXM K(wCT1h(< W$3*bCfaʅYTS?3Y ;]:(벱lF `8*0t[G.ynua:t@h yX:T$pXinRe0AՊHR 3c-dғm nc0yc-5],׾N׮ _UiWMcZv NƯP;8ȵi2.IdhdնK#nlTv-oX76`$-~j6HfH.qq8W}% E|&*eG$ HPul>H9'e<,ĽnRU%I9C!"O`H0!8:Z<34Ń0:#br F *R=DC$,"ގ4"`:bX5yt!QawC,#Cmt|%x,$=P@ݝÀTDA$]*XVE`EAGD @1D1DPD LLl,1XO\iDA,AA'`֝8pa\Bă4$Ax1A5 ?0,2DN$S6`C}<b8X> ]S0Hm<`2E!P [1Cׁ[ȃ84"%&FZ%n"'v'~"(("))"**"++",Ƣ,"-֢-".."//"00#11#2&2.#363>#4F4N#5V5^2@D.B8 6"H-#:#)A9 2Ђ.Z3X`*)*ꨫbꩨ:haAZha 뮼"ʯ(I BQ<(V)f-0(:O<" )b+ն  bbj*غ+D'|1a QhA[g Lr(`#, (0,s̖;'fE @2*}H)@'L Em5Q8qA2JWDc4A?LP@(m7WYwONpwX=.}F[M5"~wbt 圿@42w"b騛v:o`2۟hI(@.|mȇJ+!P(ԞFTO=e~&\EhBPTo}[oAx_}Lc  y3 !RC@fF`A Ѕ08!(Ȑ]1@? HD( C BÁ ED`CHa.H2.E QD"aąHǞ(B nb "ācIȘ \أ-$m,$7I ? (>L*5 1l)WIM EBE7AtCYbnr4@F'1җx@hjFr4.tU rIA.q0zn~3$t"8rS gIdE.I( "JzSh !~RWL.x!Q;Q: # WьӑFr1АFG\AN-4T-,Pӫf\!iO3ɍJ W.-*xC41C2弪5F6؈ y$fBZɊ0xqع$W*V֔\ʟUfdAZ@M h-Ua`U,FeֽDȀG'wkՑZI!!YvB$Mpz r@.c$nEe0z rAEJA 80E8 HY@xY⫁SA ,Xa,.i@ 6'!_r ˉ+LQW d0"2`>+@V!\xKz wB2^#"di^+$!S +J@6 ʅ-b4#W/AL`B)Rс>!D-ElYf16GD,{fn 72B Q-"a98@0\&GÏ0WDEPG `{ol @0,@fkJ @819:"#{Cc@BP!Pa.@IV acaH!x-H`Z lEDȱ| &@D rAB[ӺEҵ Tt@ / q5@8VIT uT(YB @!X@ H/X j01_M 6rMnQGMup]MH^Jk[3H½.-Pܑh&Bw`X@Jd0@ ox " ad6YwD O Du+6Xx -.0c>0Ö a4 &HO0 'P`B fg$a{`~!;@ q ʰ VcTW_E] uUy`Sq'[Xm6 (,Ye 5mXQ TD\c`lȐR6h\{hSʼnc t W^vxR8 m+S 0 H Vzʼn16! : 0*Rih#QmX=%,hE J'XN^xWuM[`%PrHSfh8,%U Q>McrԌyI7{ 1pwFc9(tr`nx٘3V # ~9SI 5_IL876%yW Ě,+*%y[ Ib֙c p<7N)扝Q Fs&)yi 1 7Dq ʞq&iA*1 h ʡ":$Z&z(*,ڢ.02:4Z6j'7'AqQ! >:>z29915!4AN*P VOڤ\^]JGģfJ-@ ϓgIa%U3:QUSzZ9X97u !JJa8Z: *aڨ%qVEJZq#*B*!Zzګ:az瑥J0 @!ƺfڬԚ!:alʭ9gxEj]0GԮB^ʣY06!\Jd7y ;twκ;x${l1`(۲.02;4[6{8:<۳Q?>U%F;@ʪGZLPR;T[V{XZ\۵^`b;d[f{h%n+c Sx{,~;[{۸[虜gJ`VM%3ee V  ڹ[5 "㰶ʺZ@7 -֬[t5zl{K$;sC;8+$@c1{-{۽#;[k蛾AR쫱&{ۿ<\| du;|VZ{JưxК \_'o;4`[46ý ĵ 1L4ʭ:}fwĴ TV|Z,]Lz;fwf|)5pL-s,*yᠺ)}<'b\!zą%:$ܣl`L7{Ǯ%k_;š` acP@J,@:Í'm0{<``$AQa= _9Zw ʿ$=8!"v L0 ABAxLČ %ܮ9|n6{& DE@P^6CT0iΓ( DTфG7Q~UXX@1'%)M^x0e<`ZclMV KATC1fqN\R,Ik]@pсգ\}-{Ӵm}p::^T=!UW_A4LD }1$gm@/X]ۇq=ݲB}`F.oUz?Aɐ u! ގ̥-4-򠿽ߧD1] ְa V+{. Cڋή0`Hk'.hu m0Mdm\EnFրK]<mm".GS0TR;++m[L<~o~ ᰲtm<8 ڀ5!:}~NU @~aLzzį<|+_(Knȵ~ql M WKn h`j.>qy 3^}nqqMv1 > {$#|^Kmpq 0q %}A&z +'ڽSLwvv00h j=0`ЯS^=wQ?k4a.Y"-uu[]m1 l!H9LLgs "ZQC v\Fo{\ԮQm%bט'/ukjE+׀NoP߄_]6leu_֎~`V}<0 }r{ܚq3!.g D 8 >QD-^ĘQF=~|(O6j%J-9h,\ęSN-F (OE/~2RM>1%vQ^-?]^H)_~ԔZmjpByon0Ax|' bƍ␝WJ!<է#KHPІoX/K$#sEH EϞA1Vֲ!O;דBqmh˓ֵxUY-RÆP]z~ǧR}[*mfb-ň[[6׹EB{A""AdyoxoUvp.6|0x;_׾vmzJa@FoL8k BVȁٌk 2Ywnpu4Y"A]zŠ)iDq6%{/2xW2#00 7ٹ2-BgZR#M->elgފ!e0 嬮9M)E=0lOr3 Xϡcab&$dYcҕ|iC]͜AFWԧ$H}Ҩ_&zLVMښG˘F}ɺvOJi|i-gg,ͺ&ζn񏐆JQ{ls+vt`ۢVIs-%*l6YS?*DPVa*釈kBI@7ӻIB8.&+BXI>l !\C5= ?IA +CC` C@]5WC`CJ5,=BW +dFhH Bd HDCA76IQCb%@@Pb3Dɔ 1td|tVIhh.,~4s HyDjT^KwS R y >IiEIo4+3oyˏ2KbF{c!q0ȼL6@+9qE \;Ik өVŃȚ w v@njLTi eI8Jc٤͛G dQty"I@I@ eSDKNX82p[ I@i0t  N){cᇹ(MV$g؆p0Q̌hu|㳠ᔔ mANLDP<3ɺ7KkΏP C>7I chD M `hDC(+H;}M8)P c[s;TRܼjt} 2aNyPT"cnُ9Lӕ[SPa8 ɘ$ 2ȸSAC]S ^,ȃקUl [PYv#v-aW)fa@PW i]6& 6X5n`u01~tJRbJ*VAo\; 歸HQgĈ4'7GWgw7 T7FHp _ú8UZk w1X+A*c*ذb7Fv60# lT nxft[YP `2X%H0p*8&w.u <`T8|T:"+XX>/:sʠ+қxXعx@x ?-3w@yF1g >h04m诠bPXp?hAʆl0Zm0!1=u)Wq^?v:q)uq#Үl),x_ |}~'7GWfxHǰ18775 axyC϶hG^ yydb-HYy[k;WQ!,Jn.H*\ȰÇ#JHŋ3jȱǏ CI(K\ɲ˗0cʜI͛8sdzΟ@ JѣH*&.8qKjʵׯ`ÊE5p]K طpʝKݣepjkw Lc{Rň#KL^WLb ӨS^(׌!0Ժ Gxz  ^RNo5_h/ӫ_^IA^Ȝ˾H3:-80E,<Vhᅫa1 50+8!,s#c0 <\:yG,DiP$K1x/  -\v\h!ҋ0 3bz)t։TR#3J~X @#v&F")h5ZXE\*j(I Q`(j뭸 ʮ:(h:O& [7Ϛ;Woal !ep#0FjE&z~_҂B_L)pi k.Nrc=&j1Q,7?oX E&dQHqE n?@XF BtʃVH\90yJ\K~I. ( P/BTbה-><@"[, ]ra#ͯ] cP9,:*7XK+p"TpB3rЄTYE01TH h}Ey* DGHg Ȋ ҍ" A}/er:P.h[ bF-V= H!¬`"^'¼;[\^/ tz!y8/YCX Cz@EX%qKv+0vb  S j/cfS0Erh0 2awzq(EDīh0ou^(F"Z2$ /6] 6H-> e$յmSڰȽYZ9HxyB*!ٞ PFCScA ϻ>X>J bGȟR`9D|`Bw{| 'vAMg}3j N?ʀƐ}6N7}'$\T%1mO %8?(h)C-gTK& $!\Mg@/8J `H8YAL؄N(R\5B Z(] 68v;:@Q9DFzJLڤNPR:TZVzXZ\ڥ^`b:dZX9iHѹ   ShYz::P1Z( p*@z 4 CX˰ zTzSQN+Ơj'XaڄQjtڬRh1)y ~i0jf @Tɬ0wPͰi1 ֠^Jc@V/1 ;i*: XѱؗԐڗ/W`@qn /+:n۳)~p 0>Jp *Nѝ_^@W'ů9ciInű`pљ*@Vல4F)e 7e_H;d 1b+= +13!|Z>Kؠ#$ vîJ+k=SwE1gE<[X % k=ki P{aq\BuED¿p`r/2g0 A H"lV+XH$ f a)L',Rڹ)6>@5%vZ <W!tJ K`Z ;uq[K<뾓j @PtqPZWL |b{-0KY"Dv}\!P`0f@,Ɍ\## ,Cnct\![D  ɲ:hǩ+<߱ŗɓ!ELT14; A_]+La-kE6Dր` :k C$kye-3ХD3g;03C> B$m #pK7- $5 |QZ H3.%16ͤO}sB#BA-] Za_a0a,jk[֤PA@) pͬu\=.ړY$P~ `0t5 h1FP ͫ @˷t;[ Lj EK;RR}@ ?B@D)` m 9zҖ ܁myCA=@B@>F03ZdbҗA=gLD}k4` mPw@- *dFrd ӁaDDԸ1ڀB%0 ~<PM!f 0 -1`!"ğI54`=K^!ٮ\ +7ؠH=TeՠsB6ZPH>AGB3Hrg> qP`W0yA"ʝ?9 ^a` fMhA~,AhN:馎5G 2p f1 !#  70~CE.?H? p1y}1@f@ n֚. =  v!9~A U^ _D˗A֞oa@J@`@ _ &4?Ad55(/]E?c:EYq@V%[4tQLA8wF` Z[ϞEdg ko#>D@J8?COGA^cEQ;4a^᝝D.ِ Xb"nw ۰,.>A-` .?>L]PxAz')?yT3JoiOAdȏ@H)p!QD-^ĘQF=~RH%MDRJ-]SL$=}TPEETҠ?y0@βTV]6We͞E'<*daZu o,^}%tuFXbƍ?>KDpZ fΝS@?q"Z\†Yƭ:\8\8GnG8 ]|҉v㗒7"еmMǟ ĉ?>nZqq&"cgߵG?'v;D Hǿ%ɸ6nx4 T$BwI@j0ЂY`[b (L1Bb/WuЄAUTRV0p@4Dp#G\C5<?aC]@D"D\$ .4"!c%5 2K$" 'NJ;1\(pTY?1cG\K]FY#|cG/'"/~(\#wx %$cj6hqJA8/҅Ә+= ჰIm$m X4; <ŪihI3_Hf m aH#56؈f1Hd4SKk^Mܙ Q4$0.rAc:d%fgJ *&(+&C%%mg:ԁ(uiZ- E;M_K<<$II` 0[Y䁍t[09B0Av ְQv?S2hL~jcajUӷ6XJ|'i…ӏt2cзzeIV;ȐN241#bQş\dV1"D7" M]/bCG! v͸tS`]'DX [ޢG03 0ָrQLk1xiSjKjD[*ޭV.Ҧ1fpvcnUv<#M/^V왲 e!Bҟu+B`M3DgQ#:Oe\f-"^Wd,R  _%m8D$t=CgMwzЅސ,xfOz)M7N;ի@=!QַuUZ׿ά=lbHa/φvەliWͶvmnKvh4]BFw}oݬ#=oz]i-xxOo]6xp!>qW<xƭ]h}E>r%GJa pe>s.nZ~s#1yssG]wt7MKΟ>uWב(Вg,&znbEmz(y3B >)ف#OWB-C)ВBwLpC,&e>1. 8._ #(a .ɐ{ +Q*_f, Yre,$C-l򇈨HhAԒC<"l?ox(?f#%Ip,'oD`G]MF Cџ~Pґ?Bi`eLBXmF( ;g<a@I軲XEjp+yw 7x X)@5R#6;*#?+ D%, %d'()*+,-./01$243D4T5d6t789:;<=>?@A$B4CDDFDt>cD($qG9J:uHrEDiHDCYN r*ŗcSE[?I@)@_~:`[5-"܈Zp Q0X @dpV p-ƐHkʱAXHXi@-8G~@w4p<@Va8>@uС  HCh~ȇ7XOTHb KXƈkXmxhDjDo*NX3pH#}G~80/(h՛?J`S@0 'QDqBtbK $Iʧ"(D*0&"J*+j,¤Da#r)k%;착 À|vK߲>bBϠ$xž*8$I*kWFo2%Ih('5)B&Xj,U ,}LʫαR)83V4A!%C7V~~ Xg,Qp-W{T %Ll;v-7OUJh2t{~&xF)7n0,`2P%Psk$zw标~,%["yP%._AbH!I!NZAB@ⶰC >#/"9/@%rk5 S+G8E4Z8kl1 QRį @A ĹF7$(Fwyb)A"pC[(H0 ]k@NZ G q@h,:B B3ȡ%` cH4MUL.”=\jJ(P EOscHAo X;'Hľ@ \-Rqd YRpG\&( y3Dr02"5yӭ*'#8Xhh?B |3%(訍xAa;q XKȍ#QHI^a:9Yyّ "9$HLȲMFqK:9!8A7a654$#"!!A 㒛;:987!6A5a4$#";!6qc A8765!4A$a#"!k~;:3j9a=)J٘[+fQر탙O)5ə9Yyٚ9YY 0)"Gٚ9Qw6̙`GO9ہYY׹U#ɝ9 T9О)I0ٟ:Zz ڠ:Zzڡ ":$Z&z(*,ڢ.02:6z<ڣ>:cIHJLڤNPR:TZ.VX)۔{3 HD(ri! jJh)ejpJ(]jwJiʧy`c )ZJz~٨y*≨jI䙩:Z2yڪ:Zzګz9P )  ې:@*^Jy* zZ꺮j;ڮ bA *HZe!Zưk,[l bP $ʰ1Q1 @J@X,[ 3.UFjkKȔ h0y`gvf yfh_ɳU(p)  $ʞ:Y+ٞɐ AKa@q f1X0! (I (@ 9&6ж  gٸR}Tk.(7;*^mL[֫`G%])ܺy;] gYpMi K{:ջk۪{ 2R&T"[%替S2UBJZX 1Xƀ2<n&KP;1G KƱb hI|m0Ӏ 1qTȄǁ`%0+ `1!@Aʗ! !p,,Aȗ´#AׄhmŌl=JTj lLщqjl=*7+ְ[SAO+5P 5IΞ1 ߙ¬6t? 5]lJP\,7|PA Hн`;rBSadͪ|-DG QHZZS*_<L=4@TC8CҭCp?` N ##0A%MLƽ0`pQ0bx*5(-"ޣd >3AȰaH]EPp"D9 0S>]GD .09 7qޖ<j` FHi救 ?=ݛCldl>OUWM ǯLTU鎞DB U1NH_ |q%}2u1Q^.{ B o1Hr ;2گ `eNb0"QN"^&?i* d9T ɨ ? ރc!OD?54D84` + Zv7OqT Pu K `?qt`d1?S/(p5ZO(SA1 6n:COr@j}3$7ny_ UOE@qaԐ8o=~ߠ[ଛ?;3?lm^sUB3w _Cn B! Evrs>=mtQ`6r/7Eo>5TpZl 8c?v> M5$BE RqPBʓ7D-^ĘQF=~RH%MDRJ-]S̄C~  qBqU4EETҒcUTU#͝zh1˜Y@FpUZmݞtV\uԪS'N0 qA FXbƍ?V3!=TN-]=Zhҥ7aرʚ[6~^[n81K߂F\9pJ[]t_'ۜL] l]x9/.\ kfɿ/{u߿ !^5.0$@7(O=0B 'L첄( ,ڣC?1D\?$#0WdE; ${FѧΦ*Az=2IIH蔄Ao82FGK1߳.+D3}z2M7L242Jߔ ;< ;i E; @eCtQGGpEE\hmŨz&!G SU?tN 3JKrNMWOg1ؑGQڬWcJ!CYRgWxU*c+1MTX}H*k'[ݻro/bR Jmv} 0hf%*i[+T&v}Y`ۛstݓem gq٧oN*ٝu?M3bQJ܄ !紙fڥ:e7jI0L^[&{&6Iz:!c3kצҪnSQp;B\TmEblt0rZS]ȩ+GylGoHg͎¤mƽxvwOC±G—^WDPi{jƿR{Ϸ[q}רOt?|g wc~k H?rj; '6Ђv "C70qY %Dq h2t*GGH~&C0EZe'UUtmؑm;cS2,[\¦+u´V4gKn P׺LVU {q Awipm_A،# 4:v?1=h Nl⬞w0ՆsIfH7jR ` _X)0bBfլX13m(9}x'b$6V:V`!޽\<6FU̬αa]AbִrQ6*u8PrX?}y*\>4L6G!5͛DO~5o&jRԧR%iT3P]=kZzȪuSk]׿6dplbCFv 6ֱ=mjW d/EJv=_g玒nvv6-"u7ao~x}p7K-rp#E5b qh1u8,&~rCFoyq\1?9msG<[pqkѕnb%_zԗbJ4_~u$];M KQQ @d[D"vC%[FaU#5R^ad.PϐpzZ/ Ehy҇wHK@vfS"P]Cb #gф<WbGU i&2;%CtBp4*,}F-Knb21Ff%X1):lU```5p?x1 a>Z~;Ӈ0)"jj2i kTPRLHEha Cgxfhɛ@p:[P$@ &/d6zu Ԛ 7è8:;Ԉ# Dp@4D@CTEdFtGHIJKLMNOPQ$R4!STUdVtWXYZ[Jō]8q^ņFb,~ۆB6LFf[IPƅ)XX[ 00ԣFr;而fu2 qh醄F#G;È:… pkÆs'HBG oH-~d,\U9-aBu`ɇ%!k ”  }$GOlGDAKlC(0&}Ѓ0`4 ₿mx/Ra…H4{47K1u4D̀3$4DTdtׄl"ڴGg.$)_8<3`\6 CZT05D̈!,Hp1H*\ȰÇ#JHŋ3jȱǏ CI (S,ɲ˗0cʜI͛8s \>y JѣH*]ʴiG):JիXj"Е]ÊKٳh[˖m>9c \˷߿2LpOGKL˘̹] XS^ͺkmc(N~Q xq]bŖ\qKNuβū3[ҁĜVjȮ_Ͼ{˟O?j=b (c&h2ňN# A/Vhˆ"@/  .0(cV\h8rF" 23hb̨L6?PF)K1Έ@: |di&G@l (L1ל$?f,(g矀ʠ@蠤HJ,c y)ivꩅ*J,8@~j뭸wJꫯ0J# (p%sXb(lF+jmBDa# ARk춻n& Bf(sΆ"@ oh2 Q2#`ꆉG aiA Z=,@ zD# @?J2\ ;x0-@tXBHLXV8ÁtJQś`B \ HÁ\hLG ;  -xt<4B) DQ.%!n'HD!Nn$HF'EE/\DnXŪ i" Rs!O)\\cfZt6`/huqR\gTw@`NZU Ɛ.,x!X4HY3G1+LbY):uYa,`M6J ňIq#6Z $;*-n^⺪vNlpMb΋hԜA!pb FOm LS$ W(@8p#y@ NaFly"4`z!2tC=ɺke08$.j / ?<+A`A^BU1pCs \. @ "k!ZPZ 1fҠ/Ӈxl  *#@ 6PBPz !@%"_?R Dd'`CF0`A2d1b\hIL r :)( #εT/H(&$(1T W\fsD s0RZ4NG1@!D=m ;`3Cl _$b 0Mډ,T`DaB%L0`wW !V@$aS;}"ॅosq:ūh; oA>n< B{@2Q `Bm<<73Yx>Z4( n/>V|@DG ؗ;6M+t 1GB*"lDҽB SPeG>0W`Nlv7y#{ ){' &x(-!cDe(|E' wF pQe :W\'7hGB:@K! u8{'q&L^àhUS0H:0`s mQ Qb 9KzPqpO:6rY P BhRp7W wWjP Q\w4S!P ^s#sPN)!w 0uA7V (8! 'V6OS pFnZ e`&pv(LaLg|ᖉf#H0bU6U M>S W >U 5-HXAMMs 9 fm$W)8H!rP\PP]P  q0 EWZXĐW1pziJz@   a s ` "Im pJhh@ @ ] ]vd VEZAw [U`capria#h xWXJ] Ya%^)9 >U]UP icjyspIS 2gВ<^d7LDk:xZYҗEH2 re + (V9'jxTt!]E v$'4 D%RQ ൙1 G j JeQ _ >,QSwYY_` )P QIs٠p s9 1 p*B9^5A"APc9M`S^@ /#: Q"z8::$* b8tY>*=MO, B:-_iUFg?`Zb:Q"A"Vz3ty24A3aJx5!T㦳12V01*@0"Wx Ui.ک?IqUS!9u|JoJ&tb95%1!\s:7ĹZӡJ I?ךDѭb L꭭!S&&1.4&J::*&kҮ=[N SDZ۱ ";$[Mb"') +-/13[5K7;9%HF@CEGIK{MOk1W;^\;ac Uk`Ja f%;qC`r aF}+ 9 J[뷌;[+@d 𮟀?6 P> ;Ṡ+ P:;{=k;+ kK; K‹̛{ ++; # '3C= C+"9;K!aA%{  , $T\ $:3ù% PB5A7,9\;$˥AC= feیlkr}q]Lx}ѽ|̟ ؃]؆=w·M؊̜؂ؒ]ٖ}ٜ٘ٚٞ٠ڢ͵ O eԪ=w TE PwR]|:\ܣm>p!m=Э=9mLw b]ިM9b<ܶ}I=9P!^u%@ܵ` J N`ӷ$ FE #,>-wHH$-rtuc$-xI)$쳒_@aưr@>#LҍGM~!S UF`M>K` T pm\.qOGg{.QNfnsO0@̗'дt h峎^N`TKÑ+ lP!S n^O:]}#L.C^0gTpR^!c^:>,c@ אPL1q X BߡSNQ|G|7߾ fpp0 dN~?P%FM 5! '?n1uSw ;./1d|\αUTtBϴ6 e5&:VOQ`!gHi?`gߞxSO]0u TJwoRyή0 }D`IekF;pj`~\)VMI>f,J_tpu^tXxOXaDmݾW܋[q[2Txf%'vGgGBCRI%+I%ȊLx፥ACdQUUW[J)Տ"J121Ȑsət Keٍ.gWgEԒ4ͫLi N0g<iZ\uVu;΂B<]7,x7`NMq Ȍ_Q" 91s 9d32i4ys&W'xdo&wQH Yv6$ӥ-(6K4ja3҇/ƚav"^)k<)HP 9?pχxD,<hwߺJK#7ｿ~d>HEpA ^Jٿ7(OfU=C@/ 03 =ol0@M+ܣÈP$ӫ\( Y@A{AU@ WQ B⨕&|*< 3Hd »8 C?{3',N,6$8‚HB9y9@>,칠S9 DbpJD5|DXJđ;<<@+ E32BCRtE¢{,:1#3=Ø[̋E[FA˃.ClbTTfd;ADhTZ kd3ӣOfq 8⃺"T-\Eۡ#o$qDQeX1NH٤ ;Li2ѐ̺,oå"iTN.L$qPI)x nxl ( O`*ļNabȤhc8%~QO D̫4Pi~ts $ dDH㈖`ά;Cúh }c?3-9Rv /؛Mw)n)1S$U C̷DpA#ҕhH#25LD5@:BKPH ʰ!>tRбxH%ӨdyITv;UGT. pU #D̑'8JK[%T%&e=^]Q5"j՚L$d͎A}Nl/v0TQDنg3V%-O=Eu)0\ dV-D- uMWB&}X{jJ͒1Չ To4SuSX JgT[ІgОFHI.EUDSSĿ|( 5Y %[]C}Uh?êuK] l<lH!%۷(#SxEa 4۹v]Us\ָSKHE&mGf㪔;4}Qӈ Co]٬PiltPQ.q߈0e%%PVt0\ %JXuPD[Qqm`|/ޓHkPPd^鑆u&/a;.,CE { .Y8ۚ51zV`p$8&f!O1b@ @iI@y1Ѹ0/=}_ 8J}$XxYې۽b Iyx 6pm^^yߡ!qjnfx8!^M!Vfxpgtm6p(0S 97i> %yf'la͂X+c;@vqX#5'r>Tr.ځSx$%''S)Wr*<r.&,/ )1D]x4w7/qe*8w5os:@m>tBGD_eBWt>FH]F~Jm-t轢=Ow &Qu&SZsU_#׃ufZ/kYOu\hVwu^hYu`['v;vLVeGg隅WwovL4PV𤠄Tա B@@y;>=FNޑ;3 gv:PN }gs@2k<W`pwAH茥m_fq :ZiNy2H` Ƞ0h~RP -pZi|h`R؛CȆqo xY@P `xGPypа 98X8g;Y0OQ q؟<xXt)OHˊ7>h „ 2l(pе "ƌ7rذ. 0#ʔ*Wl%̘ǝR}6wi0]l5}UHhG~-*M:RRj*֬Zribkвm-ܸX kcAqw/.l0Ċ3n1Ȓ0hk2̚7sϢG.mtis]F5ltO-qbs;hA×3od~:ڷs+Ǔ/o<F=X\`2oz>@2' * a4318!ZxV'>\!!2qI-"3]M9긣~ ANx$Ib7 SI>O<pH}Jj%>k d@ey&f$#dN춏5?y'y 068Y*$r:(J:)Zz)j)z):* Z*y*nPz&W+Z^? =ͯ; {,BuZ$w-݊€ EVz{.$(D&{oGiS2&$&B@AT`P+01/ kTg`<0 dPf8<2 r l ۱I* d|:LaPŔ<4*ћ Au6"D{E*raxPH+q 7 R(&X5 5ȈsɲP%ڜ AdDAhTE{^|Q69B4ʣ3xEem6O:=8ëF83cJF^BzzPm3:4@#ӤF߸)j?ueA1#JN>?y??(< 2| #( R 3 r`c$v* $PFP 8(BK/JSLaLfP?(Cbp!,f4<,L2JM8cC ?0G1`h ˎPVi%d'8Ȥ !ʅВD7PpBJ*s&* e&eˡ ^ss()":蟔.@-ċ-AxgxJʭJ(K13 RY- -n:kh@"*j'BR(@9JVi/ K/)`Gݒ0ɞ" haAZ! S(,P1 B'G .'/a40A޾r ,( ĂL|Xbə)+©HbT5JJT2(X8QpH4KO>j-Wb@\м1ċf@ -ņBnzqnyTq>% k(&3&09+ %UJBgI!RU(7<„0D&t+Eܝ8B$i.:C~ 9=@|&bA MxZ yZ&B RBqv '&ѿ*ݎJ!LG6ъD`-Dኽy0  q  MY5aP*AР  J&TQ\ָƂqEDcXC ]."4"Y!TPH RO$G͒dJ@!Nf(0$G9L Bz 0$j8CN$H.y@ ΀,9Mc8 SPE Ž)8&Kb%'?n8ː4 4śĴ@Ld((1FJXB &H.pE> {3ܓN.Kd %e>]Oz 'b3 DtXhFQ0JwBѕ4",`G?'Z"q$T:b7Lԑ8P}hRGLªXVU kH$sh @Zg'ֶ"F3=UօѵxՉu _Mb:d'KZͬf7z hGKҚMjWֺlgKͭnw pKMr:ЍtKZͮvz0/v# 2&>,LIvf+0/n!5Mx f'5}*;Lጬz*)` -4Qۘ!(qe!ƊA\9!:ֱWB"ch|:$1 EE^HsL1f61Ӝb*k;Ue^8Y9p.> 8%5ivsi]Pwr'z!4ͼ1+z(4sheWVOM$I"kYӺ֮4i<'~6bbS([aA%6-|X#ErrA;H{%VIS2mږeY{1m7ےH,).AxKѶ{ -ܑ\xut\%o.Z9,KyAbr\+HO{"gp^6ovHYAG<nѳRoUuŽ[OI֩A}?eQ@Mݾ*;^w?OO;񐏼'O[ϼ7y )^ W\YC+$Ij/OOЗΕ rM4>oU*j )o 7ÅLO}?d_-`<}y@dմW7LʰAy  =0"𐂢؁y0%8pG(7#BQ.DaQ-ȁLy68U|,[Hy'68(G8Ia`^ @]cXRHm]0 +1a`؇%xGX{1/8x(ЉqXHB=0]dҀ0wq|ȋUM1P,Q=U0@0uU%3(phs>qXWڸхDQ0\WB`ъ+я?H@~iXdGq#'!5A!Xbx8)@>H$9U!,mP%573B[Љ?@HՉ8DQ)':qXٕBj^_)*4d9>!^ IuxГAqpɋ0iyP8Y@ه:x9} #l(k bhqШZIaQP)~M9=rɜ|}~98ig8`GYy؝ {ݙIЊ |*q :Xy찞ѓ*P鹡Gph ?# Qpg Hdhh0YXGBZFzHJZD @+¤Qg!VzX*~Zѷ^*~a|dP_6he|= X؎m?*vzSQ5uzǧ#qqb|qqJ5@&H68'$~9riaUZ: I?c  4P y𠪀3#mi,$kրZ  #7 (b'+0wtjh 0:Љ9:X)򪮮); 6xAzqApz0٣W>5BNe E^aL d pN]S`'W^\] Tn|b\B8L= !g]i>L} 8oe#k750h # ْqBhފ\nTY^˔~iz܇*PX4 E`A1$5k ݬPO^] qԄΥ~:ađ,]5[ՃG5ү` 'Nԫ!S¥ w&x1-g>'ԬjˇFYT6 t ^e`@!*O#gR9PG14P\GҟQD-^ĘQF=~RH%MDRD 5męSN=}TP HZ0VpU^ŚUV]~ժ吂I 0R .\`ݾW\uk,wX`…xC1>`aʕ-_ƜY3`.Y|6ڶMFZjٔikڵmƝ{ң17,nōG|k/@V`iխ_Ǟroek^xY*en0ݿ_yEKg;_~?$@tɱ֛ Q 'B OHSĹ0DG$1!zI( KdE#kJ8IwGb< U gD2dC,lcpQJ+Dm1zƔj ,$̿ 1kȒ1XL;ē+l <4PR3NGAeQ<[ M!GsRK/3^KSO?AKpA/CE5UU9[5VYg>Zo5W Cu6JCU(6Ye}3c6;AMLZm '[qѹ;rYgqhrTy-t}GyMMg'x WIad}X I߈)X*MdCpT9 T4ujyU`r悄U?/hUzߚ&iUmV:kh"VۯOj+ll }n5ouo:귖$~,kp.pyr<my\44?gs?ڛ"GÃ^!p9woS:2?Bڧ]kM i44ŏyF̂am\! gw ݴZu#} F73 *EJy FG#*APr*Dŭ^[<!“fꌂ5d/ᶱ މg rV$^at ; DDH"0EO%!2eQV2!P"3^ąmD;(daCF 2gp,Xx3:"ґJy9=ҒZ .ɂ/4B!'E ѰD%HFTRYMJZ:-~b-uRd9K`R$)Fϴ2"AӚv*% kxMnbiOSŸc@Iz,32*1; ҏu+ovMTvM 0 p!gP`ch6 F;/UgRmoc](@x8c$J̒13PiIQSyD L;ӟTh=-"֪^HgQJ;Ȝ e@uBM%.Hy ɀ8U!>plkWA}뻟`9rE#kWя-##eoʗ*X9Ճ!mhRЉn1$ sXT/0 \ ̩xdZ Y#-uY&3X.Zt$xҏm̕e7M2ivtaM߻C-)X2J+<`%\!mŢǺ%{<հ9b3 O3ʋtf2z7Gҕyj ]\ӭAE-6lԧLT3CPBJaJoBfqk^1ula+k];;6H-v L.pE ap6Q}SbJ?m@2%wu-7,;Ή=4!{v7o~fݵه2  Y(坚`1"Q;׿i3?x7# 얈#Mɣ+qx6BF 0v!ր}}Ocx,8H/CHѐ mt0k>x>؂|XQm2,XK cߚ6?8op[fZ@?NPX@&Bpp,(܄l"x>кXSR2PA70.+'` np‡-HB鿇@H3$8dHE %p/$=2C0x:>%(Ã&ÃX<즐[q(D>%k" @;?HB Ây"3e,$`H8m)5|fyHyȆZbɇla~0xpqGXܥ߁qx<00:2y,lx@EyDȄTȅdȆtȇȈȉȊ}HHa#/HgӺ~ IWMLɇiЇod[VIHz%~x2w)E5fHW8C5 9!ʮd&i0-5lb#"車!,Ct/H*\ȰÇ#JHŋ3jȱǏ CIR,ɲ˗09I͛8sɳCF@JC)4@dFJJի%i݊ׯx2سhӪ]˖ʕ)ʝq ˷߿$ L ^̸"K˘3kޜXCLj5(ͺɞ=FhX Vq]z)_@y\h/ij? SˆN\ˆG!MD9O8l򰁃'MZx`#P6h?2?,A^%- XpGoh( J[I(3"e0t(>DJ *+EX*PFTV(3pɀ e(*> -Dɐb$19gr\Nr)B)(B}jhDjBGZpy<3hhf "* Z*?@ )L$穪I)z J6j2$f0<N4H&Hgi"bjоj*NVmA* ςPa9ʟGn/@w/)D8 s hʺbÆu qKB8,,J*|)(=-&O2V$ٍb8| y(%B [ (f Lwu3D (3ܴp9<(aZDa8 @QH{e_-QrD= C8P%1܏b'>$ >b9cPLHAPEQ@0@.Ꮷ]1oGlN=ى c6тyo!':T %V^JDpQ2 Z'뀍 G(„L&`I0O ~qG0H pY4aHL"Ґ$P@N7 B6a8$C1GRO\d:~3Pแ%u 23 $.EVH` VXMxғnd&A1p @6VfD,e2,m2dDdqk*a{ńa0 Kr%H(XFwc2 K:ILm gA[R\gc)~Ğ KG\?yUNsu\TP,'FoILB(@ Q(MiIWD\ʐҔ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:a. [πi0zqd0v  hW> h "Yڶ/ -za _f!c 8m"/\HЕ.&k_6Mt] #"΁<>fi0jYWx| C\Bͯ:?^_A-/90s\` >r 1aQ&Ia2 [E1A⏴X ,.F^&1Hl7%=ZdXǴE a*Y +- 'hCEG,K&HL2hN6pL:xγ>πL\rkXu)KEю`ݖ m4tL4 tҠGMRO+NucҡV#扮_&̆BuW]޵a/)mĶUKP ?N7O*r;A0!>Moxa q1z$32XC NyDC fYR[<$p7qcP8GN\$o6; 1 !y6 ҏ\]hC٭oN{Dx@j~sUociYBhb:y~cGwt q  Xo Z7ۦ| qoXn.ׁ|3(*,؂.0FA2jh@7XkҠv &BxfVtzLjNX& pTgv[`b(7  ϠcfXK"ۀohg6xpQkm`\Pq|}}H}A1uJG8Pq (j~~:HcP q:Bdzr򐋨Wn6gXxHgy8G(f5 Xff8tfHfpd68.ffqhV%.(׎sC8197Y+ 7>֠ )](pp-熛s'1-}'`ېt~܇tؒ雷~69`ɠ vW דńA^灆 I1sN>Ȕ4KsUiuh ;5u _Wn` 2yh c, ⰋYqti@4p!C }y t}JR97I阝i@8h5si[` ¥ 5&6,"c {Xv eog6 XHU`emÙcTVgfKFVIfJi%™oealQs{E1T`@DEtqeIŠkYa 0g":$Z& 1 zop }['Y6"hj+U>igU8X;Ja]^RIEuW q |p i[:0< $Hc VjKrY񦧪pj'syn,UЊӠ joU7c@ǩvkXnY{!!qIVsXYyf)e^Zjbv〇'ѪZV5}1NJ)q*VZJڭ*Zx꺮ڮy7jW1|KjxVYگt cP[+Wd [W'! VHiœ{vIhhU0tpi5 ቲ.0P5<]SpFu8Ui,i ?["`D LI*ma Qrqګx#@ xtLg٦`@F`< `E}La {˵X%wyf]Ea _Sm! 0 V qU@U?51 :\08ygtᨚ"P%1r7X%=$ lz]Hź-1)F;H~+\5q|@P" p9y5[e1 r` p ƂinX[g_%ᐯ/]C@d@0{ԗP l”{[/Dxګa_ U< y_^ATDxJxìg?H,IMrq\?DX [zƜ$wåP rJx[ LUK!pĆTwb,dDL<=LŘT; ,,2ӵ"mg $$^!` c@]Kl,= /7=uഅ!Fj8SNWY>1T2_^-(=e~5 浲 MlME=o烒=.,х|><,W(Mו1\m]љ)<N+&-.-2~ެnPBݍ%"{"罽~"7fJ^lhӾnTǬqA' ")Tt~yTt^L`~qp ў欽m T.pD;8 B.[ߵ cjNFr1a ԋÀ8F$r;mpPu8*KΘpo QkfC{^q vPq[Eo^rU^ȸ 39J{i'~)ˆNO>qO4hsk g{?~A80ē, #x b\0ڞ̹d /ȧ},!qjfa빬nϢ^8JʠmS<? 1oҿv촎կQ/O[?sN`oC` aA]>QD-^ĘQF=~RH%MDRJ-]S 2SN=}TPEEZ0FpVU^ŚUV]~jM. ZmݾW\5ڥW^}V  FXbƋXdʕ-_Ɯq0D ieZhҥZ][lC6?$D3}4IapؤSFΐ-9SOA3&pgP ,'"~4DQK73/`z$~湴".TS+s.UǟS'bx U[JC!~n=R6YJUzۇfV/a6Acն[oo[qDž[rE# St߅!⥷^ YQ- yWX:ax9+g͌G&qC.9?[m" B'l,t_Quy.FafdR"ITZUQeE zA?y(l 8e'RAسG^ (wR&P *Y*F 8p2u&6 `b*PxâgL(F3?H iB#x>h@<'Ȭ,?H,!ç eBH9"V(?a-!]/"רHra{ @H#q A8AXKA"/ ;H&ћu1N ##I4D‰ ߐHh%a+}A)fl3N,Xnq`͇CH?䱍MWz[5! %i d̋D!>rXj(A!ҒF*yINvғe(E9JRҔDe*UJVҕe,e9KɌ`e.gKyRt/9L Ǵڶ1xD9͒5x7渦D!9f8% ӜϹj cg<9OzӞg>c$ % !,@t2H*\ȰÇ#"ŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳ'CyIѣH*]ʴS< իXjʵח@j׳hӪ]˶[BjKݻx˷߿CÈ+^̸ǐLrʓ/S̹ϠrMӡS@6yT˞M{?r0nL܊U;+⯊+_УK$ljPURɹ ?U_Ͼ=)U3@"WWZ#L@|oAh C .K*0'r_)\xB$a'"xX(PR\ ("x#($"& $aIK'dPF)[TiVrRaJMNihzFl^ #i)gsX蠄:&88($4~KiS4ޝ*'I(Έ! DIHANXtHLc䪫z8NnI(U6KAY(q1A8خ/5 J޶+ QK0(#Z a5  1ɪF@  A-+q`*%ЂK1?f,`F&#Y|R'FIŞTA(جPG u- l( fd?m 4@]Ipmƥ\v^M߀#'b#Nhy-`DBdGA@೦D v}M8)D-0"LI:Tˈв qJW9~@~l"J(ϖ&B/? `A8a B|X@M3)Zp=4o{'1f1<"KR N@%"ZZ(IDH\nBW $Z$ H JXƒ>Ih!Nȃ(GqrȄ~ @JЂMBІ:D'JъZ/0Zd #`G'#Mi]a X 4Қ:60 ,ĘM-! a_-r\!nZbp=w]GSӉnG+^L{Nj^w#oxݹ0%*E R`XH ΰ7{ GL(NW0gjָ%7fIg@L"HN;",D鑿'C4!@ `:yE P h $!*p#Hxs;҆!ȳ?24Z 2b} BJC8HQ)K{!):1~|6Pjհ<X y HCOă7{  H=cuȣ-yu6Hl&&ƪiy#G<^mX{܎.}v!Y7͛t*ZPMm:\iJBitǮ rm "TNC#.qtҘJ+6yG?n~<%$I.V\0H푧D @u0Fq/kI4s.hG@=S"u6z#/ȨBm:&e?򃃯]6F; ~w?wQw bÓo3Os^ΞG=?=zջ90@G2s48ZH#Gio $'ӣexSX6?.Hᱳs|wlo"cq f~Wx'q a 9Wk րs1{ g|G,؂$l.aW)4%W g&^@AilNvE)iņkww|"Kp-6 Vtt rfu" 1Lbhnunp)@qXvhLB`wHbcGH~O` 6 pb`'H؈&lXa逈cU5!*i?x8{H" 7' nH" h)qRRp0}yB{ʸZPpox>4'wa= x11A@(Xall0o=Hh+0 ~яA |Ng}PGpv-n')]jԠ|a8I6ma-ГCiD؍D7K76NrX*ZyJiAywq(Vx["C'fj)Y0 Qn- lّTtbiX@x{`YbWEiLj)6 䎪5mL8Ncic9 H `XS)Pi8YSIŜqX5x8)YѩR^Yys6蹞YyMؤPwYhMw{&yLXl9Pic` L iPfzu`DUOm ڞa4, rɞ%zPUP1p gg1i0&zH90LO/QUlN*VPXE\`)bZfzhjl}٦p !vzxzҰ4:[Z4`o6$B訐N9Y hΨSp*M N0PL〫Z؄ʫ7/)ا*p`fVw{&iU ɤv*ӄr?o 1C)@$_UzM#` L5@g*3FR:0` v%CkSS!*ᷠX-Cа,nˠ|)KWAm"eF {ϖX+&qa  *zf*†kUq-` P$Ai@ ! EjQI#}9Xd: `9WVfY4Ԥ * ,@+sK6s1 <#ӮKje;K? [K{ĺλL+; ҋԵL뒥qLۺƛ4;۾K+Ky K[|sTg t8kgJkp 0Bx o''‰%0\K6lF2< k8*@<ĖD\?B|JgFNoR7P\X eV`ldTsd|@6h.fncjƷ%1r<9pǪ- 4ǟA,!':H,|,0,,ȗ2 ؝,Űɑ$ = >܌ڪlʋɲ&\˸ \Rr˼ˆ#<{ykd ֐ዱ~DW6).9` vɐh HraǠX/ՇE0^V~XZKl[~Q~&PԹ_jNl.oqv{WMmxnzK>p Az .iSxඣx& 9׎| p6 Q ِf` s}(`㬾P  )]w QZp Q fnC 1>= |I 1 J> RW`L0 9 1q ,`6, ɀۨP!T`o9(4n Q: a 4[ntL 6Ow`jj⠃il z/OJuw0AJw!ok"Aj}7كJ|Ұ(#L?!1OҾSVL@Kq^O?KКR !,?r:H*\ȰÇ#*!ŋ3jȱǏ CIɓ(S\ɲe.cʜI͛8sɳO<(JѣH*]ʴiM@8JիXj݊B=JٳhӪ]Rj@z!& x˷_BʕVPd+^̸@KLJD& ϠCMӥS^ͺװc˞M+SL Nˤ-rq͋KN}$pݪXbqO|\L=@RݛתTPxu?@(`g A+`N\DТ y+)W)"*,H`"ހ3b+7 9RcC')!x{_"0(FRY Ld~ )\dZL*x/VI%Xbfq1"F34gB(Y rថ&bI9ʜuJI稤Z&0%$(}JzJզ2 ) )ߦhkq)gD),#JZYP-yJ@%< xޫѫ & A'/LT%QJn {+%2om ȈcNX"JĎx\70"HziAP(҈@Z`7,6D]2CL:hB@:AW$4GN"PM[ե R84@Ԏ@T-Z AI@ Aص&;eo 1 .O:0~d}0AR'ȕ|8Aͺd -"/ 8?VQЀ+dW@xd{A;5á=c/;J/׈v0$(T@D0-M6&';M7!;XT ]PCtLg aIqYJB3B` Y@W D(4 °/HE'6Dv .!H>H>=)E}d ^H /6SB Ub fH(1ʡq/LL"ć42E( .X`Z yNbɄ@ 9O b #gIʇOb! 8xD+cILPȄ& ̆x ݦOl-Z:$X ,yD:3Nl%2FvS f&DY XŠyv& ؟0ORͨI&!̎r@@ɐO<›Պ:WҖ3/%B, h 0$!) I^ ә2 $'T(UB;05kX1" X"ZVuxͫJXB".,~5Ыb[+\CH{pAll<ʲ hњMjWֺlgKͭnwpY=.p:ЍtKZͮvz xKMz|K&Equr?wI1R Npb ƾM:F8 Ha&ŐE4 b a'>1Wa0񇑲|x99@F\6c510d xH0l  B@$CNP;e(&r%hNUV  CD#80tP@@ bІ 5;G1@Â1- b;-:CQf4-VDc`F[̢:E;\&-|kIJǍƵ!f;.Q`qX:K#م1b}pV͔"RvX\yY-}~5jv&wQTK7b}p/$  CWci̢.fDžrg7y=>t.M\i3" қ7=mWBtzR^b$vӴNr_-4UQrʦxD;~'HEbqv{^^gIp+ǗFD/z>}3[Ɵ#?/{"GeDtٓ]m׾ yvz+}+ ZxЃ(wkR~k7QR~k՟>hA3BWDj/$%8w׀8Xx؁ "8$X&x0[*(-/284X6x8: ;@8 VD  2e GeӄPh_ A"FbW~!`aX VAxcdf4?@Bx+~H8ZaJxXaL5 h]01 hP00x-!00;@iQX' 8]0h((:1 0ʸɐ0@h(x0h 0X؋x0 p"qH؎​ـ2 ۀ(  PX`瘐ixYp9 ёА͑ j$9f2aS0 &13R:I[mZ'5bPCy[0 J4)P=k4Q2%0m yf% x*1t[@`0d^ jY+阴uSZ8(l- 2Ib(g$9#i"B()؛Yiyʹٜ;iڹ?ɝiipX}¸ 8 (HYXWɟj j`p@8 တh y qآ. 11 Iў15x踊D cj   !0ʋ`Lz J՜dH*H!H iaj"i GJmY:*vI*5` ARszp ڪDh`(;a$H8 a0MAZ^ SJ0 ):ں% ZFIzbWڦrƀuڮ+#d#f% j5N鐭& _4hA ؆ !- jrda$PięjI b3[5K7QvTE&>ا1KzʰFQ˧YѐU+VP?:Ѝ 0a+T )0  ymP1JJAD>8Z*_1 I QceYЋ+Х Z1;{xyK;{c ZwӰ i +[n8xu)J˽c'Q` k܎@ɺ놠Aǁe XHśn #;CАH@%]pbm8 ,#\˵]CZ[[_3¿ hA<[ P2<X;HN,A1 ;ΰu]52Y 9;U[!+"vxM⣪~ջۍ8n^&qY݀J QӖpɛԑ#A.(H`I`~f]N<$1O iCޏ!: iѰ%჎58ɮ.~*i*^ (]˜ё A{5"Dށ>.v áp>z黠*g!/v+@:ގ.0ܕ$Aan7.Y,&/.A9\hX~W}cw=؜ m ގSzE  u۰#opm 'n>//_R_7dc=_Fz E_x.EXd[<EZLO9΋ v h ]x@⪜"^4 y~ D]9)>Օ OuC0 CP﨟]q /qҷeuPFPOu1/ׯyP iU>J7_Iw r =96j`1P`!1v@@ UHqR^_L]~6"yϚt4`Xu}rmwꔷ`… 1D Z 1@`m_Ɯa^ō,\ͥ lj֭9qq¥3!K ZGq]0}a̯xo^pͯ4\)k_~(~2y$pTn!J>  B /0NQ&/A *%\r0EWdEe"ÛB @6`hŖ2H!0Ty%R,AjRjD"2K-^I͠ZD3M5dsAjIkM;3PYo5W]>"5Xa%֣AiXeevz]Yiv26[m3?Z7\q?j7]upPTLv祷^O6[_/S&1f᜘D'b4Y7Uh=&dqdWfc!BgrEKޚwyY|gV&]R((&=Oi-pDG3*˪:mK ]^;nF"fn6G eGrͥ:*~& 'k[&Yr?a˜&qP=uUaW=v̖t]vo' XwwXxx㏧ Eyi8ҟzBOUޢcߕ{GG|}7}ң1?}&cJ~\ፓWhXc)uU.)@ـ[29PV7™4}1T?% 4VXecpa41,ؠCHckxh*Um14qTx1qB4l$P Mb0 '2rXFEl FQhtl32+xdCB@% ?B&jIlftQL8F$&;&1)7K*GIh3 @D_T 5(Yml((${>Er-9F0!MZ mKtR[,Uqd 6Qş6J7JWT_IG.U 1H,`'WŪ"N4aCǺV XWI+[务tw wVu.$ _:ؘ$El 66Q0c%Jl0Y-2-LZiEmjUZֵֶmle;[JG(Km"JmL$B vjFv[LÅG@:׹4@ԱQ 12T2h]rwRhHG^ Po;:gHF2xޛH ;0j1&݆\ 5P0 d\Ԛ +6bv 2miGA"H Lm1やW%mY1a ·)/`5) Oy/H^Ȁr3|pF6̟8ic<9xv nC-4 &z P088?8451ot+jRCEF5N n5e=kZuuk^׿v=lbFvlf7φv=mjWזv 5l7U^C=nq[ Mqefw=oz׻+ƱwUBǜ}D(G!Dv}m 1g}3 -:[Ԡ 9qzb7t(3:}X3qpw:!N骪{񈠗i+ZdZ sa;"(rskx xS`;"˰Cb=v75>Nw|?xG|Ѵv' -Hg'}ˑWީ 0C8C8H@?1SdU>"~)@{H֐ zOPU^lGl5Aǀ< y$"`npk6oEgOCQ{_GC;?+BȈB@@x@@2RP)S)0*U0XfB38%%%0A2oA`,N"ƒӁPpT gXP8X 11&p8+w@?8"8'P `#c‚(AHS@ 18bPI4 $&KDه|p%ʆ.3mp+x >2mi@0qEnq8l@ d`ST02`&݂l"@F 1โBtuTB?G~Ȁȁ$Ȃ4ȃ,!ЀCȪRHkȪ#ȭS-dł @m.MD 1I/dXɱǚɜ#$_ɦmyZaʣDL1!,]mYH*\ȰÇ#JHŋ3jȱǏ CICUZ2+0cʜI͛8sɳϟ@#j)PBˠPJJիXjzshFSz*%Rr]˶۷pʝK&)RFO=j| TÈ+^̸  pn( fdjaȠCM ZM2*fGy5۸s޽uGN y0y3eKNuŞ  5p8$*jӫ_uS(Qˏ[^`5 @N#N|hI}$F%=um LhL0E` $&Y"W10C1 @/cc h@FD+p@P""LT(K,C 565)=HYB BpL"@,Psh2C©t1!*h'2j)F"grʩ+#hl楬Q0(Pl" %|}J&lb (|-Ȁc( o*U5-}%Jm&>"JL8ZDˑkCХ*PlTjB&HRNȎ{P&lJJ)P&b\&$, P1.֮<&_WHDJ8CDxl,`'T6?A}dYL2hN6p˙t󝥛=g~.]Az>tt2}4+IҖ-3MshC-RԨrSm\=հ5J63r-Z. $5&_@ >G@ qbMcrV{EK%Cݗ@ ~,6727?pqߒ,#.q@M⏵1؃c>ry %,S.Y`b].i\Ն@ю.|1p4gn#vF[XϺַ{`NhOpNxϻOO;񐏼'O[ϼ7{󠇝r'623b/@_hTSi`E:#ϐ7d+\2F-G<0) cAu6~\ Ձc4ae`_>43f3V8pxsaq(" s6pG1 +G?&(7gd#Ȃ#Q| Fq@s\(zCHQ|W?(3tPXdsS|(uLY}[t^Yig@׆dN8!CW upzh/>8^`?҄ф+xC\ק~XA`0c81:^؇ŧxs^^Aǁ08@8cq1: ^(ϐxmqqs4Whqڈq qyaXz36 T1XW` `סZ7xذr@Xg{ Y4a(H} {Xdu}8P|.Ydmrʐ3R1'$P}s@7᠑;9w}FFp 8c ~.NJqzr\&[ ʠZ91_&r {J)m pY sɐuo! jcZ ~tA"U}otr׀\ۀ[9? wED [3G~l1nЛi?‰cĹws9X~l)?XJw7 uqۉ?sY|XfiݘZّ𞀇pA@gIX+ԓp^pz.x1֜kd:yCɏ@ QI؀Sq1iyڠtF<yq kыXv_/Әk.N*VJLI/Gv=VaZf^Iv0:0e(L+gG!xv =\`[G8]cEJT\ sذaeJ(*s%u8cgG3%3_i@i'4 >06ve֖ ` %  Xjc ` @1 ޗ Qa b7'aYjC ɟ1>q٫ As[yAZ [w @k@ydmy_:Azڀ&?ײz y԰y';dPA dxALZHAҠt m@IwBuv0r?(ڀ[x{ ;-);Q*ʰW۸Ppk鰴mѐXҀ@:7{G3Fۺ=q?0^D[d˻ tzY>ptf A3= ^8 m˸یޣy ᰠu{=Ј0~sZS+ =_ھ_K k>˰ bְr0|`"@z#?щW',F3Χ_62: r9>%Q`PGAl>b$Ag0pf9jH K FH^S| c`Ĭ<&>VylArV;*u=밀 ޼5( ^݅^煹KͤH`= JTsnc@ \6 \N}P͗PNŽېZ[qΗ ) еʙ_ᭆ0k >$ԋ[tnk*1N(жO~ [I0A\MacN@Vo`l(FrHZh@+O.7c~68==x0C6bڨОˠJ'pTr: ~(\9لqKEokq/t/avy_kA?` w.\!h1ˑ칱 g^񵱡0^ p @]Z͎KM`K8a$af#? طaŎ>(@o/X?_@@ DPB >QD-^ĘQF=~RH%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]v_^|͟GozyzM6d?MyRA,B #SB 7$,0D"fGD1E_Ѧǁ)l'wqP@G#D@!'J 2JJ+2K-K/3L1$L3$jI4ds!zM97t9@= JGM>R eTJHh$hAwt|g"W:%54% YƠXT[GR f<$X AXVe'TgF.&T"ՂRe5/Q 2`@RS' ~>zh0c'?3" #0f-]u~=[]_%ӂ0H[`%ZPt ևA>  A&C%a eأ@ amC?a8D!6aD&6щOb8E*VъWbE.vы_c8F2ьgDcոF6эoc8G:юwcG>яd 9HBҐDd"HF6ґd$%9IJVҒd&5INvғe(E9JRҔDe*UJVҕe,e9KZҖe.uK^җf09LbӘDf2Lf6әτf49MjVӚהf6Mnvӛg8ŹX 8iw\ Pgl#؝7"!Xsu/Y@(-O JQY/-,P;Lb ܧ ]SL'eohLG'`B)C!,\nYH*\ȰÇ#JHŋ3jȱǏ CIdXRx*@*0cʜI͛8sɳϟ@?J2UQ,*]ʴӧPJJjTRJԫTN kٳhӪ]˶ۜXOҨ˷߿ Hj3 @*o#KLG`DaӨS^͚QŀI#QGͻ#Jkjf=%@  ]#Ne2})Eصt1i&(`D8Q|&(U 3PN€(j+0@u--Ă 8N h1 (*#oDID1PyM|b3\Xɉ<.嗔MG'$ I&K1s3o,&%C'A()8%QZ (L"Qp  Qfڔ/J+!b9 |e8ZDDQh#f*4$p!P,{lA<^dgE {+nL;(Xr#)MAR <)5"Lڂ+Y*Fp`"ILEe#aӗif3?Lf:3&4;Rfє&5b"L:v~ @JЂMBІ:D'JъZͨF7юz HGJҒ(MJWR0Liz Nwʖ~@ PJԢHMRԦ:PTJժZXͪV'l*XǺ1+Zn}X*ׯҵZ+^׽Z~*`+=bD䕌,!ADj.;Urvg>MjWֺlgKͭ\۔'-pK*Ꮄ )r2}F+݌R.v+Nލ(xMz7|? z}1<@/"#.#bA Nt~b$\;hh ` Mm.IQ#-ے!#q +dEEN&;PL*[Xβ.{`L2hN6pL:xγ>πMBЈNF;ѐ'MJ[Ҙδ7N{ӠGMRԨNM ի^g0Ězxi'[W?,+؃Gtlz 4jlYٻM=y0ԞGPg2,{et21wnnT} 23/@;l&/~\~.SlAMk LjQlӍxʇǎ#-N::>t{֥ƈ! "X9az?"M;Hn F!xH?!7÷WC?J+l}#bϻF"\; tG|>G"~My;牿<vs}}uoX;hH;䷀ 8 8e?8_2 Plpsgco]ChK 1 sZcod?1$frTQ& c xUh@ yfrװmX<؃&X0 t( 'C (uJ$ fx7xk!G!Q @Ia8g#x8yi1pY3؃1&6  `xAVtA%&8@0FP P dCm8[؅ bZ 3),@``u`+Y!/@H7*ŋH(2 ^%!}080 ~7X ( 6S؋g"6(4|C58-Ay@  (QƂ1q|pۘHX 1Pn% `Ő   =lxpu8p<QHWX'#<ɐ 6b[ɕ$YKcɕM(4sXx@CƐwx(Q58a^`œo 7ty)B8VHؘPb6 Ƀ^l8%JI")z/u(FwBQd0ӠՕ=b /}ɨyusNg נkj\g ⬈SŋQ[/9[;uI, 8p@f {[*,{&Aj.& 6 ՜h"ma  qgJ.ȳ6,B;ʮY` 2bhT*٠ld!o %q 0kկM  R5AmF4b:7e)ĢmH{@$b@腆Y()lП>"Vsm0 J_:oSȭeRXx;wU{K `=b juPmu^0 &`0}԰E$s ^#JoGg]JApsfV .ᐾdV뾰R JauA޻ઽ{ uhK+dPp:Ո(0ȍfüA>eʰi 8!v"E'|5ƶ!P5VvKϦqUmq.7G g^}6^l`Կ!Ki&k5FYWpPϧae]Uټx#٦'_3T 6FX1ק הY6{-98cRg=AvW4l 9{иYe-AX]}jdXݕfA}^ޜ*9` 3  ~i#[ n77;Q ~QCP ">$^&~(*,.02>4^6~8:ҽ \bB ~pG>(32n~`R~p ZN*傒bcjJZa;t t^v~xzg>b~s"m[q9=& M迱Rq0KTt^0# Y((~& % 1A")0 R,PlPV Ana PlO`N `!qȾ"e  .. .=y (`a^aoduhy@4 U^e -,h,2?4_6ߵH8ÄA>_c |8F=@Q/i X ](Iaogckpr?t_vxz|~?_?_?_?_?_ȟT Y1@I@ º @~a /X /༠`A YDPB >QD-^ĘQF=~RH%MDRJ-*3Was"V[nղԧ[.ETRM>UTU֚->k"HTUe͞EVZmݾ,_&!,\tYH*\ȰÇ#JHŋ3jȱǏ CIdEUU Ҥ˗0cʜI͛8sɳO(STѣH*]ʴӧP LE*Wjʵׯ`ÊkT*Ҫ=e-ٷpʝKݻ S];pQHÈ+^8!HIPI&නϠCMZɨ'ͥc˞MmG",\țBꔼyͻEI;]X5ixֹC %Lҫg$@6i Z$9ϿE~QDE']%Z!"J$dK`,B{&$ pb'Ј%)db8*"(C6Sh򉂡bep8σ'dAH)elz'bo~$R?CL`2#@;1E%"'k2)EYgJ 5\ I&@6D覴JR3-m!Bɬv*vN-?cf<f)YT %ik.Ai<"@, L:P# haQl篹, #ҋ0X@LgL@hG%jm&$l'iB&fcN B8k[q-П0(D+,!0?Ws{ն]Џ=(L&Ⱦ>s ۛ @wۭ7+}mcK,xв831J*j0@/.A> ӄ((-9E0rE{@. .7oUj/gK0{7:oG߯ >L#H Z̠7z GH(L W0 gH8̡w@ "!D SR/H%:/ FH*ZXt .z`01e<6pH:x(3n=05iے AF2{$$'INp#$#)%Io&9LT9$̙PBAeGn9J]r$,aYX _Tf[6H4sGMlZ٦@ij3C]3ise Š@b C +OyĞg?΋TEhA-Ps#!Z`F`Q(⣊F;:$#ݨ@L*RrLgJӚ8ͩNwӞ@ PJԢHMRԦ:PTJժZXͪVծz` XJֲhMZֶp\J׺;^?16JMb:d'KZͬf7zmҖBKڐMjWֺlgKͭnw pK\L#bCzsI[-aeC` .x=ۏ~VMz|Kͯ~LN;'L [0i{80X$n^.WL '>cB@kQπMBЈNF;ѐ'MJ[Ҙδ7N{ӠGMRԨNWVհgMZָεwkĆUȕ{-@N!?QaM6,jBSmP5H17Gjo 061|`A(u BL0P*G# _Sm+|&8Ixڍ?aB.6; A=y9Pm2Xn?$k#F]ya].#=!r?!چ8q~d7rD;Q峣 Eo`_pپ<as\i[riC4 47 =(QCy9ɛ c[cI&ә10=aSpy5h^"$ykqGn1 < Cpqu(b5cXi`3)f1eVg&(8v| ]m pZ *2qƀc J&8cǢ8q$@c6&?&$.G/Fz9cqP ڤ1dp pi0i+u^:Z+Y!Nq.7pZ^E41mp.7t:A*, ? v¢#]7i_. a_Տϰp` 摘{> b`cx=ZOJ^e}Ic٨ul),;PqZ'`@ڧc؂Ʀnę=zOcК,Y!28v|Z] 2 Gj dPŊLcM). pQR$! D6)r[qaZ֠ †!/+Shw}6h+CZ"RVc5g8ʯ22ZY(iR3؀ujak3F k`Z2t 0cٖWgtХRADGuFymTwxg7GHc-7`vGƸcqc UT+gw? kKd`/<ֶ2-@_a/|zyii)2ݺo[zaci+261b)20h{C֫׽10lH`t+i۠08O}i3,ǼRq\3p{i,2`z1R3``QeGj \5O+kOfVnsO}TǙcnIpw-gL7hLgUA)LQTs 1'jA4!۞$*d+f*@Gr 664a#xT`p NeC?`[Ѱx9n ^0r骷dv̆3s,d>`ʋ|xy*# {@{TGzfLCQ;sqt:< g>+/ rh5 OoW o|njι3ǟӗR=ΐl8AƟjļ]9ӣ#q8=A#;)XUƿz8;̣uv0JH6\sDMG`=g^ֻp;cIs3jmw]5MX {m8 OM:'xP Tt:I ב=0@ذؗ3.pٝM7ף:?0ٕ}ڇS8٬m8 ڢUڵm?3ۥ@ٖ.Є\p*boc5 ܶ׋Mؽeݍ3]}0 -Cm+ȝm{/)`[(Z0RjeB>R&#NE#.$*z',.0*.㱱5nQPq>&wq0Bg[9 PpmYwe 1c' W^) $qo@@pR!ru.dX ]ɰ 0F1 PY`8p `wS a ~/v(%0l qP & ?M첑 ^~؞ھpn >8X ^[=?<`41t01>^N-18 c -8.taߥ Q.qcQ!*~ ny0yqo8?@?B_DFHJL=O@0UOVXWZ\bdf?W?ZdRRu]n5=,z~?_?_?_?_?_ȟʿP ~PM`$pO ߲e9FP /-?OX@ؾO1+@DPB >QD-^ĘQF=~RH%MDRJ-[JRҲEN=}TPEETi[ `.\^ŚUV]~Vl[ԅ a[zz˖ԱuśW^}z% d@!,\nWH*\ȰÇ#JHŋ3jȱǏ CIɂN\ɲ˗0cʜI͛8sꌘjϟ@ JѣH<Ŵi=RJիXjʵJR` L5*T*Q^Ӫ]˶۷p. KjT*RFEJ߿ L0QD)0j KLr$*-cCtYQ,(Qc˞5zJҊQ0!@(@^μ9N*UvN}2P3f@ 4UO|G.4̫XT /']ϿY'Z(8& 5<h߀VH[GxZ!Qh`(Z"@/QD6B~(^ &}#<@!~RP 2O D1I&8=ViP#ul?^)G &!)@0#?yQ9|eAN} ҚjRd,P?|b gd%vJP zQkJ/ŀ$}jȓf*P&Pjꮼ6ĩ@P"]F+jjK1X`ZWe2$+ r An& -8Q|;@@6ܰ" N #w7b ̧(p ! @@8A@<{K-.\sKPG-C 4*@L D?Omhf5A8)&LbCe| )+o0$J .qB+-gjl/9-sn#xꬷP.Ôw/0^`2t}0* õv+3 sYC,bX=1WbC-m76α8{u>ƪ50l9|1#_UN^OF8Fza $\Ǖ+Q#oVGyl̽89f6ైC#y@XTG},+c4?KocQǟ%=KgzAQzuzY?HF2ly#wkA (6Sg<0@} lu@fH>|#  ǥh+>[Wt M WksԂUyGht 0pnh HhWp[nIT.0^&}#rF@~R8 ,!,iw~9D00`8csT A6;js=jxDm8 j%'5&iuPT7U(M8; iIr0 Xu `e]h0(x;`"l  j(usi(7~ra|揟~ot`1jӠ irp;iu(` 5`y~"IFo; 7q 򠎮d:BGшD:jU Gt7O:?sH(H1t0Wӈȸh۰_0lٴQ}_>td'1hZ:i_| $DEY ;.IVK?־z(Ѕ5%o>?    4q3 1ez>` KYɺ^Ėl\c :9y+?8`)kT?xgЦ.|54|l`:.háF>) q_uj`Jl̻ރ %!Ź[iȗm 3 [v 6jcg 0{ky<[Vr m!*πjybg)>i.9|nw_f {ޣUO*U@hUPAm*fd0ӛ R 9S { W ڬ)5H*`v as\QϚ3:!мJA;XyѳѲ"+|ңB8,^\2d,<   Ԗэ60Z|F}%@P<t| .ӈbVb}>*թ +}7!֧ Hl 917 z:ɠ L0PY]6 F:gzIҒ-mYòVnY,*^)PPڢҨM:aIc |S8a՜}wm?;ͽ>syM͹&!}֐l;1l' ɷiб1 l` f !lp ;]LuJ Slo4!zFQn0'J;ae8 v\Q|8h&q[3^hlY>9<=v! )l>yM~gwqa=Ҡ")_(fk)U(LbZ7hsxlQdM~!A1莮?=W9ʜiIr`` `nuhp{^^0P 4,sһ>䖩ApX l.]n>ص_ }7I.>FǦij1 @.n`|YYW;ٕa A?c\qqo ?^٥6'M|,:3Ȧ W:0%=?OtEpa`NS_ (UQo!d?YiE^[Jl<qtoo_VaprNk֠ A  iǶڪ8&fڔ\HYX+ d^N&/`\/WXHm@jmnz{odд` l |ӯd5jλo/٥/^v DPB >|nA}&Qx=7?!7DRJ-]SL5męSN=}TωM mhFB,9RU^ŚUV]~+~]Ȏx‘4X Ư*.8ɒX`… FfdF\86k7^zXhҥMFpř!]fȯv.; BXuS)Wr͝?]zׯ#i`y#xFx7]zݿ:lz 8A07L3D0AdL9v;e,2J1DG$DmƁGڡhǼt'L2H!$55FwȠGlj'Ņ2,K/3L\Ik o3IJ<. 9!3O=䓺jrڪ't!e ZfiRK/9gGFqMQա<qЃKJ"c @Lo5W]5QѲ~t|w~d{wgǧ~;AZxM@ЀGzFv@6Ё`%8A VЂ`5AvaE8BЄ'Da UBЅ/a e8CІ7auCЇ?b8D"шGDbD&6щOb8E*VъWbE.vы_c8F2ьgDcոF6эoc8G:юwcG>яd 9HBҐ~ЛH&Rjd$%9IJV2ód&狃O5P@Ҕ;; uJVOje,;=Y2ue.K]җ $VE5`SAE_Uq ʘόa 4mӛg89NrӜDg:չNvSHⰏ;ɧD.ħsZĐz*tɀ:s7yus?zЅ>tGGzҕt7Ozԥf<*̨X o1:-PYje") .c f0hI(i*Բ%H #B (f#FNDEvOt}&Jъ$D1ьr8tM)9<Ө2.Y(wPI:eS uLP@Hu>}ԗ4%OITz\ ~:pu^jWIbէfuT h+hLBt @09̵k^f" ,^FX}dm%[״hf2iv2lgc"ڏ`jWֺlgKͭnw pK@$ urZW'HvMt$uKMz|k}+L.<ʸF #"L [ΰ7{ GL(NW0gL8αw@L"HN&;PL*[Xβ.{`L2hN6p\Kv33+AІn/< fьV(TQGGzp4] }i䡄0Z+Fa,uqsޝӽ>/ՂMbNf#?Amg% `k{V6Ǐj-яW+w520[NO;'N[ϸ},}o ׉C~aLC$&AQ @xC6h^s9 pB]p̣磃C2(UФT @91!eLz,Hm/\hu?H` P8ѠR;CJb G#0F)ւ 2v/F. O|;>zMPnX6D^ q ɼ@侐*TW=С$D{IcAh%>??WTB]''a"Y0׳;)(*pD#iA_=G|n4AQz~)D\G8\!qtV& 5~DtM@\"HeL Rw m SRW a0e V ` ׀| q omO l `u R.y?wOf0 |Pz-X᠂;&'a?e(gi8.@_}(xOv``T6Hrc }6]@e3iyQR6[gFCZYf=PXNJEy@B;D[F{HJL۴NPR;T[V{XZ\۵^`b;d[f{hjl۶npr;t[v{xz|۷~;[{۸;[{۹;[{ۺ;[{ZEA  +kBP Kȫ˼ !ɻa ikxzدy_L_ٰp Pwɵ 0iyɯzm,wjYƯ,n8| [ +Y!,H*\ȰÇ#JHŋ3jȱǏ CIAURPҤ˗0cʜI͛8ssdS)JѣH*]ʴ)N- 괪իXjʵkORz)hӪ]˶۷1I%7Sw%: ߿ +(fπMBЈNhb'i'Mi}ʕ^3iZp(@}3*$ɬ&;Xle#y)m.kexƯrjC?L#ɭp*1f3S#luUVQ; c+^9+lO)p߂55Q-] -%QaS."'!l!ˮ8z>W@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy٘9Yyٙ9Yyٚ9Yywuق1/K0Wpzϩ9Yyؙڹٝ9Yy虞깞ٞ9Yyٟ:Zz ڠ:Zzڡ ":$Z&z(*,ڢ.02:4Z6z8:<ڣ>@B:DZFzHJLڤNPRPU*VzS\ڥ^`b:%}) ۰Yd1p!,kH*\ȰÇ#JHŋ3jȱǏ CIW(STi˗0cʜI͛8sɓ*UJѣH*]ʴQBJJիXjTTR}M%حhӪ]˶۷7IxJܳsI˷߿ f*ԩS̸ǐ#Gx(6HQ0JlbɠCMMʉE!F>M۸GMjzPbLBc-p+_μy8Æ(0jĊM{N#@ )bZd;h놥ϿǼK,0,"80(G߅fU&6J( cLLG dΆ0(0h!(<"@1)ZaFtQ73Pd(TV)'bKh2 ?0#8,:cxI#Y&( 2 f24l#>8*RK#@~Jc \EzUք6ɧ \tSȥ1sm|˳,j i vҌ>79@0P9D\ۧB'LmۓKB$еP Фy5]s }gEG*eJlGC*R!|dF]TVAySj iL}*&DDm JZtRHpDrULuY*BԲhMZֶp\J׺xͫ^׾ `K¾OT4ALk:d'KZͬf7z hGK Mj$պ)@k_Kͭnw pKMr:ЍtKZͮvz xKMz|Kͯ~LN;'L [ΰ7{ëuGLhA(Nqt0gH8αw@6fdHN-E gc Fe3Qe\Y~@00tYؐ6pL:xγ>πAwN=i"A4PEGV̌imq3pX,E~[q EI/)I:G> ""ߺ|pkZ ?ڀ4炍y 3 @ixAH6zDLR )( ZN('7-#O"AZ0o@ )\сM8eטrg='/W3q7^M^'/So\-D"@ pɣv'V-e$ /;xļ$@xh : 7I\0oC_.N b?kW۲GOϿ8XxApm x: *EᦁGw 8$HW(g D@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yyj])_Yb59Yyٙ9Yyٚ9Yyٛ9Yyșʹٜ9Yyؙڹٝ9Yy虞깞ٞ9Yyٟ:Zz ڠ:Zza䰡ڡWI`I"(*,ڢq]I W8L8ϐP nAA1ʄ_|;././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_save.png0000644000175100017510000027245315203313266023576 0ustar00runnerrunnerPNG  IHDR5hsBITO IDATxw\e! nEG[{QmZjZ:q/Ժk{"3DDD?/\&.9"4&C߲kA|(NKOLIW&K&RńFJMuI/Uqa<m--+" sVNVܻ[,$&T%E3"ruuˆH&QRRRbb"9::";S#bxNol/a NfjcD$36U%gHʛc9C+'GkJKHS#FDb}S8}PHJ)4hpSSS*T֬X>###ݞV P.4ӳtt0*8Dӄq@}D=]2D2c25UXGlleg#U"RfƽzȤ$83QR $&">%:)1]-QcIiJĺr3Ci|P";::j&;::㻇GxxxFFFCCCw3=@232xXRFrB*13ʘ&-dyVfWᓣ,S%Hezbc3TX"=k*V: 1 72d(Ml c2(=!95.*]HԌ3e2qZbrr\\¿93NUĥ\շ1t@e*Ǘ&vxBsɩ-(P(>  ]|||+( Db]*-6"4&gfki$yd&1}fOOM'"N_R§3#QZlRD8'KM,l dbu*11&S-2'k^N7=J8"EbhR_&xIDYTqfӰt7Toj2RyN\&JKNHU<2,Dܹn~T7|hhR$"Pdbbbgg)j5L@8WxDF2JOLVI&I iE^GtZ9iұnuƪ*5.MIRU32di*^J-0b#H,"""]!#%E)qR]1FH,lB*J#x^#}@2݊ʚ%噎8M4)` Κ M{͂tkgw'"R9uU__? tjbb>cL4@e!JEH|briL$Sfd&1TJ5#D"[Ӛ >->.%COKJU1D§D:5!>%Sbbbk%Gj12""#MW ';S)3y]^PyF"DnqG[8J4DR=B TEl!6665L\\\.WkdBe+f*3{;IuRž%L9 '*32T%&'GR*&R!HL]{"ǀCuYFlXx$3%'Lf(R0t %ѱ. TKLb| q4] }GGǨ("rss 655•g Fbdf8DH&11YHSSRSNclihg2 )JFħFL7$%ubDħ'(҉8cT**]ۛJy^rB\t*%5.,Lg$35K^1{Y345TC-tRRyIt-$;\NNN DFFjn:::DW^"P X_`d'8&j2=]`'547ו9UʴJn.E'fuKM8Zd)HY:Zp J*@G T of+[$DF2g'k3]ur[V27 vĆ֎fL@G$yN4@FmħD:6_+ԧr1K1]t[#7m-iR}KoD lADDn-oȖj;GDD YhY#ywt&ؽVj5%wȥMK׀W<9^}Ԣ:kKi;(%3>#L>jZ;g"R;Z??בVkU3 O&''+.De2kiPa}(̭5=X"ffpHff+'K=wGMOWronm+E>&8&*=J$1+=5f$R GDI$bI1Iw|V}5GDgp \=nXp`νf,C oO>D[.B˵kׂJ郧rL!6:V*"">UTDD"Qvh9GDJˋ-߁C}g7]eU"}9+w?csqYA dz&#~>a'>4܄HNNٝ|||N>RoFFFFFF]!z5 پjjem)l^\+X vNbnDD{Rqޟ $3z$$\;p:'q"jb 9p蚊Xf=:̘h T1t֗Dx'Դ\wk꛻t2<8Npm"Dϟ?/B k0N{~UPaѣ(^wnٲ%VD۷o|bڼy3pǎ\ʍ?u33cFv"<0ĺopl!mVa:@قP؇)OOpJRT@Ұ7J Ĉ幥-] DogԻo,H?MB*wI\}ڿiJeZ̽ս7]ewh׸LŦ&ׄgdff&fy$g?Gl='˦Wgm}S>8x:L9P lt>~:HDz{vM$Xܥ僛ȍeU{^%ޤj ْ%D"⸬I(ͪU67weǛ>ob%ݑW{EGzxĤZi>IH$b˼Ca;#"lR6sDNh_GF枈X?ƴ^v^sHy|b/w\ԧm'@ X7GCV]ug {t{*VnSuODIk};4hZzg W׌PWպ/:YZ|߷}j4%Z͹.{H\T`= 48Z#۽:ܮcvçj"շpq+m}#5F[*2^=`C=|)Xn?[s 8J"b)v?rl1%=zC{Ӿ!;hj1%_^)bQ Ys#cu.ZK9&Vimo#~k?355n 92M5m3٧"3 f]\wW=7D=qAsG|>RjdYLeP+)Imڌ[SW33/733޻'/q&'57p5[7nN׹U 5kauHdְ}#0Gq)cج +Uw"E&xw(i,ĎאH\DDz#Ib^Ed#]FQmI۱?9"{i̐ZD.Nyg"Z!T 79AeΨmPop_d|덉dOV I|Lc]wFDb{gǷ?d`fniA"kZ$b b1y&[f}z!XLGwP(--ѵ%ƫ VF&[Eo@%^dD ʄ6g|FI|z)t_uVSߴkې |J؃g cęY[;eICc=㲓KbEUjxXƳ=WTY5_f2UUnq_8)-YMw}S*Jjffh,L=~Ν;wܹᖁ6HνgT 3Љ:7#:2\"3Ʀi !%9l\cws/Ŵ[snb"msvpTo)qV~<(i~K{qٱdiӓ9ި(M}~Ct.Y}Ƣ*CںָwW, ƫ5x^`~sK,pSeg6P*o;^5kڵ]Ɵ=K)c )JLM/?Πw?L Jmҭc축•'\]VydFc[Ua @$mydeo,[L~u."5S>n3Fv+i&EO/~}7㈈ "7X.3B]|9}IqgӺ2IlU/ED.<Λyv#>XeTAAAݺu+*޽{[jڸP5'vh_nG6$oݺSRu@yN!·ݸb2^p8v=|  o%).Lv="U ^>Ai;@I+ҵY*ڗvZ#;v뙱]o}E$rA|y^;@xWե]@PD'++K.vJPPPi%/{@|}}K*000*~G @"Bi;@Q){zЗ { A'(3EE-k|yZbP}gKkwC\ī'C4ӫ;h66 ge4Jܰ]$Rݺ`c;KZHV|,}YW;-weՈ65\\3uMl=<8FDoǵ_\Ô]O3nmk\ZЮnݖ.HgQߪnn՚[|61g;}5{1G2ԏ6o\٫uw3(>}k 2hN )cRէ3HZ^nn^ :;Է18PYiC7}}'=7q̆ /{sѹ}ooc V]znM68h;[c'FNܼyfVSq/Z|Kx7X=N>OOl^]W>N2:z &"O=r%go|̫.B߮?}ڞ}ks"3FM9q| qaI:Xpܨw _3|6'u;$""U!\8ј<|E u2?{ vFzR,n/L1_y DD͇ HϥWdK^dsf۾j#nfPRM,9Viik%Եĩb:Er+N gb&||Lz، 3V3v)cֺB5ފŢ8Twgli)M, @b˖.l,3 r;0mwB7:<'c1eDF&#YpD""YX(XHB""eL]GDY\df!7j?og "(+N~*ONuٍ_2rȬN9|ug־C=d-8 II.OD;w+5k6vXwwVxufF@Dĉut6ʪ/>^l׳Oo?iiLDG7wKŕo}P8S30[cpɪ%'Okkyڣ[%eǥ[7a)%uiz?xj$y,XDy DݿQK-7SAb˃szr׭9p "((VQ>ܸq5 IDATZ|ZƾؿzWpy@)qh~g5\zD9V^.^Dsq7KHRC͛|=\gѲ.oQcW{^=\;j!)}5^k_nBoę6y.ڴwzRO|NZ\IP_ܫGF_0T{xgE=@nP%6y{{wĉg.zk\@@@?}2XwZIPPP׮]Y`ܸ[oM3xfVE J޽{O>믿L``ݼys& QF+b#%իWElFHx\im\B;@Pn ;@Pn>i_ӧ B>>66 (rz]v`ʬv֭[kR$O>]UTRS-Z(BJ߿_.fnoXզo+s-ߛW߸ _U{cΏ tuuڏ[+ȇ"d`jTR^P]^ŏԥ][ӝ 2Ly=ecۀg?F'Q^Fx{G3q'Y I>fpHxL| kt bv4exOj{}77Q(ŵw6;kw[dŽzɤ/j >9vמ%s/?};?v_&y{Սt+s}eN]twzV&>gI;ߎ [̽|a(6Vȍ1(Mѧgw"RJǬt aLn"‹]GyYv8YOW3.ѹ9w1>D)]oȤFFxCS\{iu^n˹=u Rj/?VioAus֋62ȵD[Y eӉX⩉5>ψ ]Z@ypߪ0ms.KeR鯪ޥ(ҡ*AiTҺnaOCT0Um7c?U22:?Ǵhm;b cOhakPoHQV{quz̺[IھNϥg/ղgǣGc]/'?+e1͸T?\ܢʂ5NkzYWgɅ81ȓzۻ1t{i{wMija?`t ڲwj})66v^4WW{^<%yE}~nߑe o;Lj2nmks@{՛v)Uu>nIbϔmmp:o.ur?..-D wWtU{̾$&$bHwڟN;beQssZZuMUlt[x!APϸ/NU%.Mp-c0m5[:~I8V.Ƴ"|[vw(SWYZj=g`ϧf-nτvCvԜ?Il9ҧG}Nl=BDm~3lbi#PMӞ8,*yĦfuOH 9ijKmЗqvƯDD,~7^}uK!⟮͖ j""CfGGe?jnt#,d s7=u!S.OmJ7n?93S y*mFJH_=HiNg= hΤ~n5 (͉۲4ζwcaS{2M}knGi~}hFDz_ ]`T©YӮu^>U}{Q,TDŽyhbT;4g_VxUOw76yW1T? R,dʖϏ|7}¨֛_3hA }^Kn[xeصEB\9CiibCbɚtm|읷[OVl춣8vs492{L# Tqyvp݁; 2slđ5맼өqrwZݭLMmj}6x88FmZȢEIQv{90ά/_B?61)G}j1Ok3vdc`K1&2k5i?麴m*WG ZR{^8WYrɚPDSQ]uN8lEр.1J&532Е=IP2w3,&L{pTei#u̵Kg^(KbԦí{_ DD }{L>tF37ˋܪĜܴjة#S%g=<^OqbOdPc@/KΧ2'fz{gcC=)cZt3{+_W<˱e5c &s'2>lҧ{vViv[JĶ}︐]|4΅V]Q%SxZ!NUqy0\I~W.7Ca'ekc[}GaDDyѽ7܇gnόHGQ~'}܇=jE썅M܄cʐ?}ѩuZusV1Hdn%4JX,I6YaE"b3jYZf0H$0մ HMd&q;b fA-h&1NDoӯ׃j 8̳YX񪘈5puqqqqt$1F*.?C/g{<f ~Yv[/Qs۲'\_;o\ aÑ_dt \>nGX=|Dm%<YcLHNk׸$1;85 7|ӯ]-[}鹚 [\mY{?^R)3tXlt}  "!-03TAxzzc,Ȗ١?%yǶ*8]VvG١W_$$q7UJ&~7bɢ~88o޳cڟ 2c~k|"̳> W f:>LӬԻGW[1ro}ΝkO.cԽ !)I7O1oUкC3 in_,h֬.۟~iܶOnjNeIe_;Uk7k{sRF.)VG /$|cs;o z}7vA-[wMc"+y_[QWhK1Ǩ?68?קI'm w k Zf5!Vncײ>>ӮNkݸCW|Zk˟?}fk}[{9~6xidnPu:w/>y][O?Y:PK{?m` 3Z[9}_l,s"{?1y*kω/g5t6lGI6fVwj;q˽ODֺ-Ns?<طyv#]>kOm1rm`O/󮪲ۿ{׬Xԑd5 QQX5zJˮ]{+AAA]vgqnx"ںU*];vIWrA$=z4C= Y*T])000@yf|d+ʲ `J_PfPvPcK /i( .ɮ]jJ˵kd2YiWQy"أ+g\]]O>P(X@377d]H%%A8A%A]`Jv"}wssVPiTZC <0{4Tf%;U(e5kּ{͛7J!ry͚5K- \ ΈP*Fj Jۿ @|(7 wrW.2jذa1Pv ŋbթ;ON혳Wwwٱ=Ӊ2\߿CvfN:|U w>}ك==b- a$Dr1?ǁq3%gӴo|f*SRTCϚYX$nOy*QΎn[Ӷ̤ԮEsϸhAգ=R2.;!ܽG\GZנz2آ_=NYJ8~V/x|E u2?{3o9 @ G Q ss]!6*&^_ LYFKwO>OǪD$r۳[2w)KdfՏ.JMd&'A AqafӪ?1u.rJ=SHE s>˯*ɥ6zꭞf^""6Ǻ0}"3 Q W7v7Pheq!÷Mقw?|1*">%7B"Gikfs{7m.Yuox}Ւ2Ȼ^f;ʗwgak:sR-="{sIpttko?o{Ze˶a<ԯwG]:Wt}5^k_nBĒ{C_^K0xF\g}Rӷvswȭ'zgz)SľL=7̾'|ΐ_}ִk&E֞VkCwP֔kV]i: ~J}BXVؽ֠|7i(88rO)u>}P(X@377d]@95sx>?}T$թSGϟv!SȎ(_ ߓ[nRJ\.?}tiWP! w /iC׶w( P J@|2QC,_zն617D֝  L] C{74?f|ϼЕ:|gn)(y=tXrMO>AMk]}1I/{d>'67ql𥟳HǦY6a+]7¡W3Uuܣ3[6['F+KD*wwճ'/]:k3j5IYPv-p[N;2ojpKSO&h((,ɮʹ{'۴7 |cSӘodz~i/ftxzuX;@\9osT :%Sʒqg28+\㸜 ͵X@K23d"ϛy(QGإԏy\ *|z V;o IDATy7W$2ڵk>>>Z\vM&vP >sNа䶕ZBB_5\=9';59+rKV㻫kppӧ  (y2յ OR/Tx(LLJhCII%!B_5Ww[ss9DrHc,P~/d"m̬6_BBw;sfΉeq*Tjyf\9 JJ% 6ys m?ώkWFtMQ>=ܵqF"?~|P٭X sxwWTƦMvJD/_,*7xƍ' *}99odDt#ʎ.]lڴiРAD9~77נ )qYs;riڲ !Wj!g'\88*`~\]ss֭:uB|(k:ue˖kz> ^xw ߑgώ Aaxtvj>nWȞ;sCs6{*0sksJ9B|Y:ݳ:+_ٺ.:y N] qLZZ@99t#rCTP{S\ &UjwjҾnrز{v;<Z#H4Տ[tXYYQDs^zi&4s>ؔ@I=%sﹱ%8lԈ }]IYkiZЬak7Wan6WfF={Z?jo߾kg}V b:za oT0q̙OӘw>eD<{Өdֻ}:Hϔv+oأG̹G :FNvc.Ξ?N&iS#ϓ5[uwpXۖq|ةun}[*Tt=zؽ{]{葚٩]wv7| 1xӑǡjyu,&Mף5{J3idÿ~'vtƚec޲O ۷PRǨmt8Nst(~xӮQm۫B36&\j:; k֬'.8nw(jb?" 1̌OhիW9̘1ۂ}ժUBJJJvѣGJJW5Wd ^LKy\ l>ʧi-)πEn< KsV^T]7h|kD|n'{#Hpoʳgw~|sDD,'=xvoG=F_n'''`SM-ygҳHW I1hwqMK&,Y8PPuuϪ]V;uZVk]ֶݺ7` !{~D""J !|/_\.w$'O{.†{|ԏcfsTߣ$ҳm׮-9Wt.U[kh&Ldmmmmm=vجM:-FeܤaF<+M|s2vCGvK/ݸrs:aNd#ěx4TI[3Qs"v1vؐ:MkoXe^M'iLnh2\!ۻ>c>>^}||{"4@3xT͜ԭe6ONЈ?cc$DǓȥGVgDҀ{YYtj,Y䪎J G4 "nۚg%DGxF>:}x%Nm_KRnּߓn7|w}j6nRߚj9φIȮľs_NՔDdDA"Yu=L~~B>|֭[-,,ƎhꀕqJ*,9^\"K EER$NJ$?HKDT"p1Q$;;*+"CgXsG!XWȈK yK+ڴn/996kR.hۜ/+.=N̬MbŊWk;dII;]vcǎxKνZ)WۛM|]OYsfQ iRw}ɲqyē*Pݓ&qruҵsgHb*NN\Rwp)&"8:+uKd'Jk "ήk{~_|+=ucDDZk/dgn}]DDbZ1P$Xvش\5ٵ2A~̫A*^Ztuuul֬D"5``rX*WŅ"1Fʊ'jbQ^$6vJK\J2HYd?[ h.:ϜJJVދ,/7W+X "I-)T1au!;dddq YYY5\ }v=z4O2;αiWF R!K_bE|W/X;FM&KqtBO.#"& KofbZuyW_Su%V##x#)<ֽȾ[6^LMȭr:tHƈĬ6%^* V޼ |1);H`xmڴ:<3zh] }WWm} {x3c2G^z1O~UI[9N圻E<&ou[HD}w&OM )RS;^L.є.oY{Pm~0a. Dܫs8t箯 g/g՗DTWs`VJ&8DlnS~+֫m}ew7orfhRȾU^e^۝-wگ[YsW 탣&T Q;*KΞxMpAifzڕ&ٓK.ݿd{Aq\*R8;D6/MM-3i$^^l͓2~{z,uP >$=䣄S–jCGzb̙3tmРy ֕MϛsY{#9I+';wW4A3V|^9=J)$[߮]ZmI$0\y#ζى-kj,\C𬯓A[^σh}ġEqa--mۺBQ1ƤA dok)pV]R6{)R |ٰ]B ҚSw dak%%$ <#wqrd%}{MЋYX%8/D`BZKm<Ē26^zzݱj?Q\ܒ%K&Ol2ݻw1\헦5É'vZVV)mo@ui-.|:AeOD W3 wjZVСC={4ȪHI֕߄b]IIwS3;ʲ2 jwWSvݻKRTBEDW ;zhddd7d2ƍ{[WZd(ɼٴ2<){O_u?=ZD6-,Tu +s:+TjU!zQ,s>^p 6`D'eY~F6k0=vag*Src?eDmC-1\޳⻅GD HdbjF]z^4eȐJ *yt`7gV]SF jpK7vDD9 Kbf{پq~Q6E瓨Yo1J&xC#&fU:]%+ULH`vXuGV 'G|""|=j;VYdlW4dNK|@ψXYYW@;E;p2pjc9Cp,r_-҄'>˜BFF5\bfDR"YSsSQƼܙstAaа@5lmܫLnb Hm+Y -GU_HItVKӺ=Ν9DPmwd;E/ϧ,"g`mzXz:jHe k׎ђ%O>,:y{@`;X963/{ɓLӧg6 %wW`F@{GvVVX?Tb9'hͫ@ 2{O #"M:bֶ*nCf>|+/M?S|םR* "00؅Wٹ~#t5(Т,Ӻʞ/` ܟxv_/{x+|x| X $%%%$$49j<}{w1m!+;;)c8ЪD~v-%!>c*ebfL?s S3Wr#/$Nϼ[xA?^Yvί_zO 5{yߧO`D{1vF%HC[9=ϼogh,+1 NBm1'n7BM>Y_hﾋMDD j& Dq<19p ;ص@Vi KD!P92"NETT(8xixnO+ 3p*@7N2Yx緹uH$vx g-?f.(۽Ņq.17cKY4/ڙ"XYj"*䧨~_e;@!8\YVAӳ\ ɗ>`O}c% g\BD{<'qs:YP0[+|V?{),mWʞAS|hLƎwM)xeD$f]ۋ>~Mj˗^}uyDžRKnӾX`;{s}w]pÈit%~45<(΅8ŲCW"C~ٕY;ۚ2یt4!\ٸRsC Fr3=y۴W_x{_O3a幺 ڒQr47H`@?,Q}޺gzڔ_y|G~uA QN?ٗWq#yg[~%'>ye}{BVzAoS4FSz}dwhxQc9ۇY;y`+{Cw4ĸS[[Ɛ+:2D.,OyG3;*7tۏkZji h̏il8"*9`ި7z7YŮ͜eRvh´'LYψgκ=Y]gsW\?XZ^nu5JM}PQ0%il5rRgGU{:=}2u6wN"dnrDD?osUWPuzgs\)5DmyO_n1E}?E9C%J5M\pSRbߏ;_ QٶV,h9yʱ~"RQ_hu;qnOI|wt*M)?kyh& 7N~yٶx:XPN=HÕ=oŝW&2" }aQOl4֭xST*{Xb*^3192gmZN7E>ԼՕ 6tJoE#pU+_O4h__D/CåZUY=D|DKs䖤2\OS7qk~&γL5yj+;{{3)O3_3Ezl穔\5#Vwꘖav><ٳgFo~9w/~'acɹeL,JGFuD|_bV&i@gg)'ZAcNbSRO]vz qkf po啋=[5%/svsqs֎nN6f tSx=ϟF @=},ߑRĔ,|@S|FQunӏ?Iƹ:H5GdwzwRi:δ6ib|Uұm&׮ˏoUhڷgl*rbT& e­Umz]P>}:""€˩S @rޟE_Du꬜CSBD]/KܳF=d݅ЊW81 &˗/ _ AjZח}D$''QbbT*JzfBfLKbS% Wͫm_?X|I?L-Q5n{SrTNb;ji{FU `nl6w&9XqHUͭ"wo=:i\vHx 6ZMd`$|HyWBZGvoP%_SJ}Jٱw:w8Z`+-*ͩ}zN[_˯Hso+5ԁ0k]1&՘',]pòt#!bU>GBgQQ|{}5TW >c 3lHh9kV~R">xo|6 ^w$DD{fw{u0xё_:e/{,-FPoܕ䄋v蜆Ȭ: ق'|蚖_A]To>³;.jCDDStzEW[<s:W׫_<4`:`n"oUyٸqBöo )~]!$=MWt->Ǘ]eJ hέD-_myc 8A= ч ?]|^/T ?\ڨȾՀ^ʍ_7|ˆīl5{oǻCΩktهSu#r}zk7)7OMá7Z=\Df\?|D٫^jҾʉ:ob??_m#?'5' ZҦl~sxg_mUa\.SEMaĒɽx:1Vϴ)_uگ1J~1*+$N\0_wШ?˗ٲiZxyYt{tuktm嗬Z}19Nx;tʴ?:`YN_o>#9"c >}憿wNMrzkpðp`l;1te".jtf<|kN_*\rx.Q#:<::pߺEDx{~#sO9O}\%>?i W]rڵU=ːy~}6盏~s_ⵋNϞ X揾ռoB]x~:y>yO_.]s/Nzqe`G}me%]FnmeDVrki:eDDLSv#g^HHn+g{to_qYKDW/q[~1DD,wW}#o|4|ڱ~+Ϥ-壕W*=][^/>3zʁ׭|ݽE$BLvzqMږOD$`]^[(}1#[ِ)`oM;5oK~܋/I=J@_OxSwMӶ_'*L޵C q]i{d\FD:zuL|f qImr! G)_/J9K%جA2nv.b1N1Xi٫g,{uʼ!^ZE3XYđ/M " }j`k#F<6I=hZjkСCՊjyX{6^W9Wڈէn92HjsLu[t`YFld{O<w3+3ޡJ$}V*?.(7{SaJ31γSvr8j3]. /9㔝wNK;.v|GV1ƴ [7lGGar~FHҶMEVqD~ 'FLxgrG8޹`/=()5cD zMWC06 *N1Y=ۍ1)YWMfxQ|3{]d7kv}S`@`9;Z-qQOx}LqĊ1􌂋i _dx/?o^7k޳WgV&iX4l!+C"Mx8ff 18:rR Za?8]!reᜇmnS!u)9vS}Z=&uO<}fӏUϮ\lWƹ>3 瑓=1R/xfXTz 𠆉"cwmq$yQηp-T$!ƄL|KaVV)c$%R^oy&V|IYƺ9TW_>(wIt=1/[ɼYz~~~~^-)׽|$dyːp`xS'KiVL;s΄j*ߝF^*pg^=tСCGܺ7E"SW/X;ַ˻IeOY/d1~gNɶ;_ wbDĕR ҇|;NЅUe1Uy#vӤ,3Z]:gΜru, zwn>|}E "mF[D6\=.p1ƸS~Owg=ܿ߻w]d+nqcҾ8#HS11-nNv.P˪.~~mo.(nWqp+Z‰Ĭ,]fg;:.սU\O~EzL&dISYAY\jio޷4ᮼw_Z1;66~xP3zĭې"WYS_~Gޜw&¹%"I[h5Zk.vu)ccrDb̪?.ؔX$Sg^>\XSWhiEb{StQ)zr]cڏa?3Vx%۔> \-qLkZ{6a_wNrv~ݔqcS  p5&m{6kv}.QI|B[8Nټt _8}B]tJoHD|~'Ri;9M5 {6ˌ>%UV_̵ѫW%?l,&w;S7 w_/%o^~:~a3`8G]w 4ҦbG O`ODNQ-zwMpu_IQzh϶ט>7OY\?꿦 i?E˨O|x u~S%u>-Yµ5/>kgO^v^#д#Z>6~ϱe#B<<9vޫߴ~CzX1,z<;cNi#^_ǚq}LIo/UiQm&5F 3<|Piݾ=ok-Z0dl,_}~A!fBGsоW ߫<6cׄ'.zkG=3jć݇wzu7Ƙ$o6O@'y1$AW,xxzfu%PU1Ƹf쟛:z_Ft;utWs.m̓v ﹠ߍbĥa w6CnIܾST-u1Sܒ%K&Ol2ݻw1KR1{n&M4R?zki'Nڵ×[˖-1cQV]Ƙ(( jAh4ZV.h4F/Fj:+,D}}6dռ +%Kd2L&JuuxJ|9D+4DѣG###I&i45q޶V/J׼K 0hjE64E{BBBAAAvvvTc,NNN sfddX---]\\]2m^RqiRƽe^ϔ!4McnW>=!!㸞={6L5FP<ǵjժ2Wfdd0UMw}G8ڬ_@| Bv'>̙3zKxPJRP646lX8XoyCxY cP'؆jy)7R> L"^`XQҡmX=eZR 6\zWNxݥN$D{f|.΍uhCwVv|>9C,Tw S@*qϟ ctpjolƣ&v_fo=?yq숼-l86`|gYddxY:P+`EnBm!pcG iEѾ_ ꇗz:Z[)|:=O}4 甆1Ƙg=B,c%m|cpO.{*OdŬ|>*ӧeWשe:!?3G"Se 8*I}WJDdMO ; g{{綑2quKrsT"1)/9uTC[gqN..-aD}WwMNV}V>""1Z\VUƈi5+j4"o#!TʕDfPV&Hm* Jz>Wf.;_)~j՜~1{=,3dHTZoHD|аQ-=! Md|9#<κO/"/䐬ˇM>qnmRs0b,G8z]>d!ҭ[p'"jGDnN>w%r qX b@H⻞cy2a'64@SxQCw"yo/04chU0m}7ah})]Tq( SQH$QJeͳ4g؅@eUF1{4֙;OK:MHS[;7"̾1h-Nmm_{s#섵wl%43111VZ(Wkoz ^,L:XE# :+LV6QIB6/K}`k L^F# U6@ܸ)ݙD+fMpD+Ϡ[<|@cǴ-/oH^ĹH 37ouS=9]0I'Wهn'rOQ҉a$%U0C,_vMRJDN8#:K&X5gmUq?_GGSVN=vI}S'Q{i4Z k6Q!B骰H&(NSJ9ռ7N$$&]\jԨ%W~WJ9ˀO/T K]P@;ClHls\a[h7nLUҿۥV s;÷}I^[y,9"QSDĊ 9kkŪ#VQM`H>*:DUo}>)eomYb3d\` 7tx;YuK4w|Fg1 Gb1ے=}zzHqɞAFh}T p-[$"Qk)`0r9CVnth8'_3pWED= !yլ- W^u 已CΘuV!4~v)fS}iVKENco"j׿'xBEyܚ')q+hw^ܦ\ ^v ԉP麪+Mt_tcK|F&fLǥ;\~m|% N,ƬUs-hWUi#9jIeg~_S8vY4w]7 ^?^/llM˺oh]WF8C؉>nޮ.FR)WWsZ7_Ec<<${{ϯeӻNv}p8ߩBvSjfLԦsOwZjS![ײG[lME1$$1K\7(BD/_֯+880n3kKObbtuS._Om#66VCCC9) =6)uB6)P{!zWmMonU(11N8Qiӧ1ŰSN/]Ja%ZB|0ONZ U* {Ak_?v̙3|0o6888}O-[Ry]DS;Q1/Te2UPU:ʄ-'0^CWFwR[{Su"7O(J1G ;Vm?JZCAh`Pjs<{ӡT!_zDv#k445yǭr *6eI|zSoMxT Bґ7:D:UR3ꅘO:6@?AMo?GL[ڀfu*m%HS^mGvh`pj|~=]LۼB1C\;>ߢ/ǖ97O ʈCkh=z%jےAj˺ ZVvo=Wf>h(%1ҞHLOq)2{^g|5cO_E7W9JH R*-|Տ|ׯB9??.A>K*<qߍFV… RT*< Ht%wӟ EFFӢ *uFht5͹s]ué#b{p_'H{1uKݞ: :.iD,ED[P~vw=ԧnnQ@[QNݝ H*>Y8?t؝sgXfΞ9s9d^=p>ztN|mdn}횤=l3MɄ=I|q![}:W˶R؂z8j+8jVVV\.r8ѿl6喌EA|q(_?X<BD^򕒱{/?b;Y\:دZSl~gHQ-lpG/[w9Ӻܽ?|aQş?ypWeiKG2RUAa!P);26]wvzsv畈IVbbK6Rt>e?ԩ=gf@Xʭt>ݒVM4UDv<}^')anܑ+{*g SW%&Bu!ʦQ+,#OoNK8jؐRTWWloȝ)%"_w߼8}ӧ$:,hRFu-Q.|sDza= Z a,22(7;B*={fcc`BD?r3\ #"""""۲5}`5iԷk(U ݍTT|@9v۬{yJU72ڲCӣvo'GlB5>` B7+Klͽ>˝wVkjjK Ѡ\^2C ˝giCIIJfܞxޓyE6r? "nw^4]PUb_lxV TESN F0|GvS};Yҽ@Պ?ϛ̔J8$5o">)F喝(]};Bٳg?:u㍌~5 ]uӌ̪\8{nR:zpH}۸˓t_Rlll~?v m8SS;6UE$&m8ܶqBRn$?Oc;SrXB$߿= w?~˾(cOTw-LX|g;)P^D`BBص+D ]>{Aʍ ǜ)iA8!P١Dieb8̾7r>ӂGD%`E($~~U>2==N"~5\pMϗTOsR>,0/R>~PmP'n]mժĉ~5 ]uHo]*"[Wwiݥ=q#?URB5qZNܺŋ/_oڴiȐ! TgH H<;N̾Ȕ"9c`%/$vxjԪU+//[n-^[Zo<ر聿m5>#鎕S2h+:p ďS1@?hݺիN` B)5?/kQT*Pa@VaƻjZSa@O>}Ϳ!T#(9u#cCp;P}lgBה1v2q/BbBQ#Qi#P͠?W|suνlIw !P݂;B[rf_ɼ3|tDs7tZ*(%xFjoߓ*& =<<$PUaB5EdxF%Q vk*U= .`N!k*]wh7ϳ(([DՙC7NnaմFjFrx!jɸ6}EL̍5ٱWn4-|aSBU/o~#TGlb8M*B_yfBBj,R5ռւ CԽg=xjesrG݋T4ʽ@~%jlO=ʴ-&ԃȔR} m<->W^]C Vc86< N#j+"rP BW{UZm~e9SASjVd/Ǣ@JTxؤ O_^m- !{7$ݏ %ZfWQ^N/3?3Q2.QQᆦ#+ әI ~3Қl*B^Տ5;!T3a:i(Q9SѼB)ίl@K6t<أ짻*1!`!T'm|iX/"|~`[ {U{w{5IeXzp8\PX-9rB[YF ly&wC2[[jnr5v)\i~k~wly),|1YQ+fuaUfOyI_} ϕ_l^#<Z4BOK2;+#GԁLJr 4ͮޮ"P&v *c1~ԕM$^?EűД{Ӳq} ؞.T9rfnvJm9?A͗=[`vC?:cBtu}&,ms~hpX2>*x4G XZJUؽM?L T)3} IDAThf}R._?RʱGy$Ԧ㯧&#t;oa ݁1ZͲ2v&UezD p4 ;S S}mm3'+-3@KaB?loyVa[2o !Ɣ6|Msoעe:ОN;MT!$k#.~%}w9eܷؽd]fOk׵7ރ_S-\`!@\h2ĺX^0ȵarJNJe}p;nʍ7KRv^aֿ$_:&\Q8?{?<ݔ-f:Ȋ.{&;K_یn_oz).6? @/9x6]ukofxm{鈃M#fsչS=F,1ҁ$ڹp^.:R g -! Ztܣwr8f;B29 Ւ}'Ucwv9UsKERskFsmbK&ZfF,UαYpwnVg ˫>=QƧX.7ԔrsN/FTRQC%fY: FYjj, NILSgih礦B,j((6EHjaT#sw%!+BQ? @G}V/l|z7%+H¥\?}"x`,9q!/tx9k|?Be4>ׯ0_NsU3w߽g;n!RRUMJa!0Y BiҾ&&|MVPW*}SɮW!溿ޘ'/[qU>|33Iw^4_͜9;!1qӖbk_6Cn=t玽8B_ĢD2L̑2oݾ}Cg}? _enH^CS>ͭpKqt+vdYY g?pr|oLE;p5郭;g2uLv>mbte;5ȽWwBYXXHpx*Bٕ =9ʄ l1Fwϩz,:ϮsQ,[u@W$~ę)VRd? X^8 7k7Y,6` };)"﹊)BJgޠ]zϭ7(p3}=7^,[}?kor !,q{6Mfc_޼ -uxHNU&=<8(ZXEJáB)W0]ԭ8Pxj}o[4'gsw!(;w_ R 9-̯+u~?զu{k= a<˶ݒ?z0OHҝhHp*a\"ĺew:b!-<LqP3IZĆųfL>ACӦ]kb5;WG74YO_sQ.\txد.b޲;г 9X6i7p n/154myͣZOY۵[\?mj^ ñZZXwqc>noiبEa۞e~OPWv؁e콿m^h@2n,qC}`bv ܼg7+EL~ Zo7i, INj*(j$56Kn'7 i# =i %m>(#ZSUNz_Ґx\uSc Neqb$ \% JgR6zmOm-U]Zcy_ť?nFܭâ;qgἐ> gϽl^Dߛѩ oί*:Og(bo+yaҖk^{ϰkS\ @Ll:;-]- YZꬄv'0 177; YX< uQf  RZ߿ T^REJ<iKEհJkrCF^biimG1W4|f.`$ҿ~i]vP(*HNKg{0oZQ_EF$?#$IzTc{%y}MoZZ0|/uB)!J$r/pRP`LyŢ#&3MTQR0pZX Q1) '9>³Y՗EQ͚5{˗/ĽSP(SR4! iVVVݵ׶m["|(ˏyє>/P3}iꄦeO$پ )`b? z-QicƱK{Zi2x2KTCҽ@3"$$fs8plhUy<k֬VQ6|~n+Fe޸/\fY#TG;:̽<\,ui{N+~ϥ~=0;wl&T<ӌe̽^^ryOM{,O`z,BߙZp̻1 v.r@oofPϝOKìM9ivt}_gd'm0( cwJkB*$$rNw^m\ۊlv`|˵th{ϲ_DABqAmmHIt?j0|G888H VЭ?_'^nc%G'R6V`!PUKj4JXu4PywT1:]XuleޒqDBN;BզK KF))x P( OIMS !5r8 3C͈,sؑ51;;;1;Bզv^IO%|{BR͛7/3phBGq jkU!_BK5h#TmBBB$ Bg#TmL!B↵UAJDDJ#!f6X<~vxLS9Z)H,RR@UUҝ@;BgЏ.ⶦ<1Xz8;Bw Ϡc[Є-~ ˰xj3G u>-@wO{XXjjԭIϿ]Y3wTg՛ԔHkHw/K ?I|Ѫ!KG\JKtϧ9>+^$2lӛ䔏g=\{,`?r-no|nĜ˙WGYY W*·ښM]]!Dko+)((*hv~$4ƻqlH&Sӫ-#<%ms{PU kֵWUVu0h^ $ݭZGO'.&?IՇFMt xv7kE)67=W¼M] X^?qٸYNlp/Wb]B59BjVfKg w_7FtqӞZoWSj"ifVWcw33333oWr겠s7Zrî/U8qmAI TUA]AO6<}tnbRxڅFckif'Y69p%g3?!YYWviS*[p&%)]CW]n:;5M#z&9>):z"r2,Gn?Bs=Eiq A¥#v3x2g,2k2{*ZiiBd>#dunifcqp>!?[ywOKwmDO[Ϫk4!LAV6iced?b㇛m6(!:~&6}WOfu࿝/7Yr6}9O,Ip娧 mѶUAo !DBNvolܵ|"Y`c D@!DcY|B =<٥rh7z,?GK#-C~#¤=X[]Ӡ-[Kϯ )"&-cLQݺTRR&~.' =RR ! 27Vڷk\|E<~EKC[-5.0M'&*ji) MZ=cVO=i0Sim1Fߐ ?^s4OvR c`!i&(tx.7nIF[%g?e3@ B_~ hū퀾gCȷ7񼼚sxNv 醥7bܯ^GwwW.8j$tB<8}UmФn:lFO_2]=^]/Q/Ftr x6ø1ŧK훡;̀Mw!4Mt8P0бiV||.M3X0Weιaiwp4O4NCw5wY+̈́|aMV;y4(V[V~u\zy[~-O,39IEst0ei!4rbAIN?ݸ'Bwc&02:}9oie*ǒR5jģ*^v?ETYDJvœZ։ɴJ. g[N9p+ Ԝ+]3Ww;U3{ƴs3flKڦ}[oXCRupj*HUIEa?0U6Qz7Ysb~k.P:C|wD]ìω&=U)` {;o]%EUԶB䀬lu! <;yYII]i)lޞNHߗ ~[O`ʃ1DL[W*JPYmIؐpc!ed(S\kV{%b > dT)B6GJIII6ЄNNHſDtFu؍ Xսʤ9ڎ\_ɿ~S 4tD}4X&)%хkBĘ냬N*!T5 7b34MTMx .n#TGk:d IDATQ7~O]\~\n3ѤT _>-6r[vmYy>-q!^)=l3nq{۪Am.c=E?Np{n,BW=C))u8)|ٳ7^v$,Uu5mT!豘3_ouV;UEQ#a/]ֳ{(Ry,U B)y+x3Ԓk7堅O{3T8I (wXގdeăע'K𤂍x*$ pY&&Aqy<@[޲dyBUKZ'ϧ{uݷbx6M|c(x:?b,!,37[=I"}"]aP6_ 24WfKW _w(#35Sθ< ?{#]o[s;.:7ۘ|B@EU!]7aH3jzoRמ~L`شtE6OG!!,m!1B贇'Є±tO=6CH?=T*y:Ex92s>Ff+\v`}R;fߪG?عe˖-[6/5j6nZGjOB!~۔r#1~]iE+vl~G;iBaY߽6xiy;ISVuvr,}/S9E8jvǎ.]U*|DSP2@lk}) rO'2o=J7+Llt:wfz }Wmtiojf3𬦓5!5!GN!D͟һ8Awӥw#)ju-tܗ?Jc*[ j z֊NF$|y^-B!T2dHeo?yή&;$&,+,,\L]N}k 9۷ovI^Ut8vSe3;88T} &z ! È.y'P(iZ >###@ ?>eѮ./44{kBCq(_0NK{*E(&D˗'N~a۶m\.r8ѿ 6pEX,[V%XpJZYYUo֭YeY,V|V+ \@;/\йs=rHo]0*jB %-xv6F{8]1Aa~0B5nt^{M- yRsZ.ǞA!+0ް~ ^zcP6C;RJzMڻ:Y0BbZu9@?čf -B?eff&*)_>e\yE!d2I=z$. 7 |>Xbp:'q?%&&J _1tV4U)KJ瀼N.=ےIw.DW#:^=CԾ}ě7%MO6l`չq+o߾5j7nH 愇Fv!?9BUG݋T4ʽ@~ea2ȱ BS傝{d$pf_ܬH*u(5C-L'F)Yz˱(гR>'06ᖜx𣒵!^NCNag~(p8\G@Zk7Oέ3K3%yQu 73[; SY!԰@p;Q0|GQpm٬;ftVQ,>tNE3   %t胢R6Z__@UAD;vs2U*!=(rh60FuJV(fp%z@ hxI{;F;B!$xXfo׉Sm):΁ .|Yncrc>$ 4US*숌H+*$#<46=+O'hó&f?BOނ)>k#+4gܵc̹?_~3$7!Ct&!|{va{/ai5wУ^> Qmcm%#G9»!0`PǤ7j& F7^e

9G BunE3JaޕnP #ffff%]]؆2݈!<:¦c~6@Wq^fQa_JIZІAm^x-N—rer#SUϜ{gHguPS1r}ϨU2In9j zj*VS /ryAF}D t@}c;h-;8H>wq+vz.ᗳ]-tu;/YbP];B@JBT ţ}zRQ p[?rTs8jk}{s^r*Cﻇ_>`qiIw3|gzΊ=3e\A:*~oSUw'@G<;~tjB<C̖wZthVk!>F~:3Q1KG\JKtϧ9>+^/$vߜlď77V#$#T`BaQkq͹|g!S?; Dwuaɨ[yK>wTރ3Gq3̩_􋪤dg)J}5b)gg0\کAt~wI%oP 9Rl>n{ڙӢ?ɝ&-2:Xn<4AhܜWGwP݃# Z,|iVԈ´/iܨU4An-oJꭼƶ*@ BR؛;oE׈duTҒRPUoiBN\dxͤ#[?zO̗}}m\'ٲds qwiNx)Px@^ 5m VŻc`/o_*xqnIN,MTVSe2T/)h„dvӱ򣬰x{78y!^q!TS0|Gt ן]$'*Ĩ8%˖r,rLx\~(iA߅omy>hyly{b]>I8O՗ N e^,JR2+2}ɣ6?d>?i>iU(Aȡm$ӡ g.=[qRd+(v@_k~!ۛ]x^^+lĿy ,eSksUZP]]bO0|G@+XCY9K3%yQQFE)RmR3᝗_B>ӲRKỵRn g߽:w/|QGXwz>OjTӞMY2.饯m(Dk5YiZ=o%D)tVj|xYgyJq^͟J/\P $N77:0/#_QCDDV&^pD%%=3]0^1e_G^)T?hB\0|knŽ;vT""}f2+?JrM6ޠ͕t O{L~7!wwPrUNs8\8I h{Τv7 +eW^v,;J ;BUwP1aҳsG= h>ih7IS[dU9"WU,IvLT^KUGeӰQju/n^M[ZǎD!Te#D;ܢIvY,-ÜWzT«4ݖ\gA1m+)aQyzP%@|݁+'rP'2{? T! B |{Kά=d{ (+VX;wRAolv}ٌ,g%Asbb9?̡|fcg'=۞=Bv;BDݐ}kyJg:. dkhFv=ىbeff&J#~޽5 b2_-I?~SE!jP0إ}yYhBL];hQ'n6kxwU3!j3 B" K*lܶs ͊ƝA!`*"Hx~oc2Rtio B6wkSw_4[X{.&^IBJt*BH<07 E}@Kl+B`!kmpFj5ތOjTӞM˟d\&;K_nQp~[7D|wMkIcgo2lF вj)Cw{N{{NKm^@[h -вG!vB"'mINc;!ǎwqeYzeWy2ޟ\^Cn:z5k>2?f =Շ,'is9oMdܳu%+%ߨ '(sO9~1L? KB;Px슶i*bgnf$xucM fg0~ع9Q9 iS7 -#Z4s/s53PplƌLW|nŷn4  IDt3u5S:v  ^G*DuUAn5(޺p=:p@T;!箽lh/\^(w{JC%՗U5:?`wHWN6i}s8p⁆siKuRqsYօg#C|$^sg*wQxD "rrij'-wzpү/|v4#@T\-pw_uD1[Y#8󤤟x < T[S"ʬ:}kɊߟm j ~7cՑ4e8^a ^*˽ᖶ|ˆ˥V/7g6;XUwJMHdOp.TTjio~m=ʽm<:¹83C/b/ںD3xmWZ+TMeIj,j:'N.sܶF6gg dʺ3粟KRZ`̠?EUO]"k&"E;zzzMW)[QunC1|$ t`xX[tȢ[qUnW]ek& o޽{ŋyE("JKKy^<JDYYYZ֖!.7qߡ|%5~PW1O%$]-W1.B + IDATfRͦ=ƀ%f DפgQNu[yGTe>*W$ZSp;cz6Ou>Ǘ]&J Ʒ+~so$xh/_H$I$^zQZZHw.x"q,2 ӧOsM mMO]h4F X:l3 ?`BX[6r.#Nnan3ߎES[} WHYV]ۨC8yr ?XmL˔@$/Zܚ ;&$Q)_7pdޅ(Wh~O cr pbW^jPĦ+妋D$mz]=) x?.}Nב44⯡mX' ڒKě~iv8a ޖ_+jL~S-7r8$xhG˘ s3=1rΩWrKtŏna7::yAxyzLjj*EDDh4FS^^~Se|aN{]Yc=6fi/Zf{t dOVDrjHmN][T~||oę*]޹_}>ÓSU٣숉=h;xܰ4keB_foӻHrA5DzqX(^YEI> zk ZD$js=} _:nK/nu~5LҒ~sBm&߷]WQQVB.pr6$xe^z$xpT*H҆dϞ=uxkh]m`UM1^ GπWf6AUU.*==fÎPQ\X>OPzo6f|lefA][)Dߙ ;gYZI&>9BdyOu;JFvZڐWs.RtK?TDʒµ=\8P愒lX_ HC;@jky ϸRyE-ZUb^VF{HB|z̵Su" +!C- ;rHwѾzeC-x8@4;@+S+V<*[ٵuB Z'Wcj5I9F+m×\f;L" ]Q 꽿Dy̢%DDqt!cnG-S*u)k\F!RON]lheN]TՊˬ]gd"9%)D$\,UwDҥ"x+ReC#:u)I&jfVxxCQ"^:9T 5~9}͘*>EE_QVN;#H$R^,1JB}3|GOf6Clj7 ӆэmՐ).rGb”ީ)˷*]DieuӽcU+EQ|.gs]OLy ^+NS,a(O$"MZY5\ saHmMe˥˃8}-n!6j>Ғ&x*wU u0Xg/iJUDD>'H<#Ga2X ^*n BV<112ǔlkݷ$W:+{GF;+F7Zjt={O#FdˌӃh(**M3P9ЩúTloaMX5[yՍ`m^'ub%RYl,A$\-V)>ޣ|˗S{;=?Hڙ)[0̧Xo.89jGڱk }Pݗ^k8,!V* ""m~씈GL>J$eʲ-r !jaA J%"ыUQAbeCuSrjUk_1~4U*>fBVE1&&f]ח&nuNZ - %!Iz屉0*΃i_D]{Ӄ&~"]T?ԆeaBj)J]Ĵ%]͹džpmʺK KrGOWQŬ\ÞkPTv%=eDTZ-]Z)-Iyƒ݇&n3|ȋ7?8(Й~rV١RFFƶmnG`Xnq/zvjF~EX:ӦMNK~;@H]4Wrrsed|_NmqwMZmyLÙQvAmTS1%Wx"Z`A]j?W2_pDYsY0^JVHB|xՕaUj""owdyfw"bXiۗLٴ{ǢdF ^v7l1YYUu^nęOUߩ#EPB`!Xxca{3Q_.H<[AL><۠;ɜZ]nCJr 7j 3gn:: CVK} F illp736 X^ZZzȑ{ ]e8)#ui>g%#;@GW蓗ʃœ|mڊf{6֬- fTbӥg{]4%OsQŒ*.ɨwf]ۡBDT^Nſ˰? È4Aix˛5gneeŬY|EƱ21 IN[NMneSH7`]zr pg5Z}6Ok3Ur6;{ՙe(86ccF&,I*Fs -VKP(H$Gv7Řw^zUMz"]hqkG_~ߏ\^]$. sP⻕.`Ah;@G΅gTh^2hc'Ԗ>)۾ᯓ%NCfw)*0[)M)\L9rcȌ{-LɨgreTouh`yyQuz@jf|B-٣j{c>c￿Ha B9c8ݴ~(~C/uiv: wu;Uqru9 YsK';e᪱;O5exT4G]1VяdAI9F+^9w*p[nNteffQDDewt; O;{c zfw{ u޽111SLd /s…c!9w2Q^-A|X̵ubMA5Ԝ\Ƕ>ح+u!YӾJxQ]"[^K%sXuEݝZ4(A DQ8tװ1J[L&?1lذ`WWW"{$'':T*JR}.o.>nޙ б+.񃜒kXA>Qʝ-I\ /L;2+bw7HUQvrӗ+2Rr˫~LDīU|~S h%Њ(#POFק:݄~a]$,d㜜t{jbb#<2`WWWDbߍU6 ֫#бV_P)<~TyMqǒH?(2ɟ#"!F7{`(͍M) r]<VwƄ;0BӘ.AfH [ "٢;5I$Lٺ9#G4h0...һiv3FsLV< wN[\M*=zesxyܤ]#|e̔<~c !?.rFTꪂ#ېg02 - !cC|谄RiM)RYgH{Fӧ;zslq ;Q7lmO3)So]l(4#X6ߔΓ ^ #A|""r\l=m|j t.R4S{5X[g'hg'\JRD"}$skg;ٺ]FXlU7(C;C|f[L&z-'U7UnWkt/Vp40-xp_.{oAMFӆN 0'%%%99֭0G-aEօ33PR }aYA˳D՚[7,wŽȪ6nr^5w "".$L~h-I«y7;C/}كm}Mw(9_I.FpmS IrUK@acQ#t-Ŧ`@ Z\*z7+ohJ0> &k 5FΛEV}d A"0| .`"<vy:;@=_}Y-c8s|AEk;28_+3*c=fg{1@Z3%؂S=@oMxzאe DR{s$UU>P(.|}]#&qgn C~8yƋ^Jiן~A}|^5EH$wjfNs/ 6M/33333b{a9y:2}px|vf~ܴq CZϋ%?2هH$RV_8KB}3|GOfaAxP}^+Jec+_=Rv'b\URUjwϦ]ؿ|a]vaV7L=['kgSʂ‚DܤDzjDQyICZF w6}u+:zHj&". v|l#]E{75¿ "Q]UGϜraO麅Y^gB|ә.q|Yk9{Sɋaܣ-&"P\5:QQ>w4l |ddF14AwT[ #@G׭Y5a[A|y PJJJrr[a'Ouv ;@n̴uom!wVSk `wz>}:eܒV^z+p.Q\.( 'ZJM]n\T7jm8aH< ٥"##5:$<Ao 4aV3@$Tgw4XŹw0vl]_pzϮ$vSzXmBM9u/r=8lWwDRJvR(aB0aӖ̮3` k3w}+a '.|Ҳ#=DUceDiĄ%cC E 65񈝳xXk<Z!'AcFXMMԣOfaqcFFHYG2ۗ\>uIrז}teykl*V?kt&?qé|:.7G҂RXa E^%i^w#Y"bj IDAT{wIIazQ*ҳcfÝ/NϣiݦvvNIR2=Bo_<kE}wqb8װ/8N}\#9,~TLW7):;T)se9wCsP.Ze/><0ٚ]UWpqXeYV~&i%scvu2D0ngY 'JY^sd^~V[%\bzyKYg!}YV,P}hGj*{_PQ wĸuF|6 ާY|my<+3v9Z6IDԗ]Y g@56+_+t׬29dL|u_.EVـ>1v Ѧ2*-AX:FP_VY+%Xf;hZk8׳R)hE"+hmEt,p'm+W3nqzY+_rȕ3%kV$C/(w:hRX)+*?yP!?qۮCiSzY#ic*./ k MDzI{HN=oIzRst:'8:y yF"\]hxTg`Q}hYЉV Dvpc.l=QdnJ|#9A#۠j9)8"V{@SRt5 SJS@tgqAzR'z JɃ8'~džY _R:"ܪ1q9rd.Es 3aTW<µcw֒=)qh͛7sq˲1  HWt=m8+jWw[ta]uuZ-gZnBh4SN٤Ƹ 2F["n[a :Gx0ښl 6[6hG;9EYc#bĬ6p;`#fDZ٠zΜ9RT*J$_qkoߺN(@g`7;@|y:}w丁AƣU8~J?4lFSr`њ> gǸɀ4йhJ0mQyB %V'9'uHG#\>3Z?qe8a@̲hyYWﱓb:)Me_ؾZ psDUerOOieEh/<C8$EpTU~ؒSj5>sRNъ-=CC|NM"j[H%v wWUUjw7wp$r[_nembu?&Q#We-Sc(S ٔ )i.Ax^WdbyFM ϯ ?=/'luu1D IYGADѡ*|`8nϓ1/nkje%^>޺_xL ɤT].,2*(Y/_/R "EPeYw@|p0b8>q`O/HбBH}!̺8_R^)2_p 1Uj"I|%iwrc\ir凨*+DBER)kyb8* Ϝ"oWDB١o7]=sw 8Ii5COضoXDhȗ.?[Dyzq]]uטY#s_cw}a&''3*y>; @'&Vjnϗ0{nӼ 1/xYb5ꮆ{|Ǜn6h l{n  w`7;@|vn  w`7;@ ]@1a^1>/b. 7X\'hHrz̽7y5ڪ[NҢ V?WSVe|z+G sP^HܟSY]Z]>}lCezfjS>ϟ/.,'"/5ͺßZX>+/ZwW >9HJQiν2vB_)_RT?gtw~2AF-)u} x'QK$\WM uaX%"6h-%{QW +U]sd G#+G%mrDGsꗬJBIQ_PL"H$2DG^Xİ=N*%J}p,CDbey_rb.+<]mMo}?cH'"{‡ W3Brs!M]fF~X :9;j&]n. =0oBx6/bffW\]u0-3ì=._$">.^)̴PS֊ BwQ8딵fi}8fY",==3$ԗe8H,];էçF tě'222J S~T$YG[ztˉ!w.Qw9+ v$=C^Twdm"*kjX7P5$cVbUI6󫕵u% aԗyny{nn&wqϾ%"r8ԩV'Vܭ-m`Xel*Wv̩IﳟSzrGvf3gΜ9s^>H|*nŞT󃵹n(pZH[~n׻#$)*1#3g~ˮN^3ndۋN|=x=bs*AT}] vͫֈWgl!=Ʌ}h#׉y|ioLC]}=_7랭E4)r~`p׸{C4aM.םZd>fo!^j\o&n'VˌLE^+|%ݤ 5 ֌V4(4wr"~}u5sc[ɪwuu;ZCmo=\>Y%X]!~~WpQEDb7Mڥ$d9=ߋfa `ҪnM>(?0'ݺ^EN>x1?2,*z=C+\-+䧞\_ RC';_Vq^ 婧^z/v;O(//H$ DZ T7-_v\x/I̟3/늖j~qx)S֋$}䣷rnX~9[)l] ?la374 bmMUһ4j3׈Dum@ ùXt"~R],_U^t K7Iɵ/ź3D\1#$GNZcA|eM#t|׏ugN9oQU˅p۳\\=!,,j-o=Đ;6xXyէw#1""IDϐ2V;)#tpkUʰa+VVHf rKs.~7FQ&?UČV;wu߰ ?>oG3tEQ5] wwA[AP4tŪ7>xj)#"&C2w#.nS *ywnjӳ\V2NgB|e͛+#tpB_ӅzFOs"B-Otz[[`T ,xk?MWu G_cUuweAhy=ThSS[vJ$V7M% q!9?o,8FdEQ>ؽ&Fx9j;8-aYM6pukb=Ln wp È6(?b&xeNmgn KL 6fK8a9遞5@D111gϞu3ӧO0 ؝> 1=ewODCrM Mdgg>#Ml1<#ew [푑ѣGJ:wwiU֭ٽou{ ܺ dțfZrcnq%K|=Ŷn1LF3 Sc^Ewx1*In!wԞr˗:3ĉRi{nI\\ѣ;vٝ:3'hΜ?٦L;\\o;bZ+3Ntv|7ZQR7 \Z IDAT78lڳfW9 a(7{0 y>ͷ|Wpo: dt;eչ#!w3Zynh!EkpR+cmh-w`7~w[7;Uۺ `M;VrILvdm03VV0`w`7;@|vn  w`7;@|vnHl.## iG>>>7\φ!<pk w"##a1cغ!ԩS-,g p8ֵ:t u+aUUU-/g p8ֵEii(nQ<F NǺVB|@x6 Gc]k t,pbK0gu7voP EXU T UMҳє:ᥡ^?i:~12mYѧ zDXhK*-o7:[y:߯ʼnn!&?5۶6 yp{<(p~6g}$b[)ZQz.s"XִmS'֞v{6s럙>x xFn? t*<.o}Q]]‡,xiSz~nYBw&KE?fLS秝*f*H[=4ܰd[?5V}nH*u7jbi< ${AD,` *rw޻TWE!|?B A9cfv7ݥj7"G '2gQ{M쨏]mV `A Y5U8B~˜f:!mg0/j5McbbWFk!nY9‚zh5]7xˑSS2'0og9YkXZVOW\=Wmt?ywvƊRt ~,Ɋ]`ѩϼBH]HSYI|7$:|tZ]ʷGk(t7|&.}5lF\}KimHH)tOs ݊O,r4VSb;,J4紇 _hJP Ey KHc gMg@܈ {>,)٥{&}̿P[ q]ʋ'? su*OBmİ&/|ͮUq׌-|~&zQd`*ӒELJ_vxdC1$t~aBgoĝGֵ@هmdyG&DwKq;0J`tR% ?ec1D* hvsN4ϵùY P]L߀.gB7O'}=ol(C:tS|s6!w6A;?.bL[3gx}vn+OTe'Y%u;Y2d2=mBކq=yN:_gIDIЛF{JSv( py;)iMD4-4֪`0jYuv qtc)ɘϜj/a'.*$M&6|KZM2],ӓX<׷EAdg11AB;^a Qz{L@(թ بe$93L %!F+kI *vI:@ұ5jب,#L9 7'J8Ǽ__fuz#g V ،)QB#]wmM'˽r8CA8 $2Ӳʊ"qe°Lvo#oTǟZF+z(aU|{(+YQIXAj!"uy>B"'3Q 1y$ 8(,GP,I2ͱM .*Am~ei29էi*HOIkI5#IЋ[v] Ld㔒xVrZZb.s1Em_t; C@w i4Y fC K-?((gr GTS($I øw"0ia18>`gV$S# B . /J5J9#`;\*r;ӋWP*S,rݣϱFwk'4LXixb4-7.Ë'/B)m9j8q>X5,ywAJaȟN5aCQ/j1 ]zڼ8yj}'hIp?(_+@L~}Y>猥a3tD4wa8nvӟl0i\)Z.P*+/rjr< I9%OWoӌ]/Gػa- $6|᧵8krreo ѪO9y7LGK?!,vbG H8+,{Xla KsK:uVܴޯs|p]:U 7τtqcb;#p lhw}eu˩7i/vB(?>׳- Ytq$F!:ɸ_O ݮr|mwIu:ca.7JѴ\U~55>`b!4cÌՔU ^ZuxxYv[ izBѐ7{ U5M ɯB(תuR9XP!f?w)6yO{D+]]־H4n<  ?7&t^UMAuSH^(J;w4Z[ӵ:*\kX:thҤIuu H{gmmk 0`I/8ѣ~f ~(t3qTLu/_F#i/¯ۈQc1 Az0͢zCAJj, H[i=JAA!Doz֕h#A35C_ EA",t:IW(8N$Nb(P4X@(}GaA"""0 k뺴 $#""h4C HGƺB; ==?u]ZNhzzz_ E "Dۺ BE UAAi7P   JAA@;  (}GAAvyAE```[WAAVbmmݸAc[WаkjCj8Cjv'O4(}G!!l* g{#F bp(V bp-V(}G!q@j)F bp(V bp*V(}G!qv QáX5UáX5\  hAH{ĭ ?WeV))osY9<(֭@j"bU9Fi4hccլc~kmlP↬9s"^v uK HGpR_MGFW56W6lj nkY J3`S7/Ǫm6SԲpY|[Q[WIxFǵCVo=|<;^8P} [z (k9GGdhjf\! 7vpٔ1\!ƨPJKKӔt,:>3_MN\A&8HJk.)Ł:~+5=-AxK=&%E7Z{ׯ_9LqWf>OɁk! )N?Dm]#DD(w)|y8Jcձ57qT jqXUc '&j/7 .h,;A,cm1Fae}}_֑׿+l5ȌO9"HL^~~~=7E7 c}r 2 ߜ?^aX3թ̻jlSB;oluhSRR}PS{w=:CCt[vCԕ]bCK4^J&{ȅBH#,tTXfCl,T\S]7p c c -rdSmյ6Ӕ5`tzͼBɌ'G2QeXB@Hf^u]tXJZνu`REBH>:RGMMۨm3Z!@BF!;O!3/^u2]Kʢt1RV0qs !dΛ=c-4UO}x9d,q^`māsw@3m5U5ms ϛ6*cE$) UegL|>8nGK !jIKn>b\S}"9:ͬ߮0 m UU zNmÍm"T[5U]Qx?IpS6UUQ3M !d[uLY}^,& v$>={̜ - 4O9V _m7T3# ⋫(AFqƑ*Je1}XP0Q⧶^O" {+iiL=OV, ɒ%BK/16_1?{ 4^j0H7!*#, Kݤ)R qfvކ*Jj ׻TqVɻ}ob׼xyKBs7I{|ʩh?{]|Pɪpdߪ%W<v%W!:\plbٞ?*Y Y'^Fǽ]%w}/!$n-[u2IӽGg~;D򵅳} y-"԰{nǛ[P!dܥ 7>8_ MHUgҚ0貧 _g\~ܭvXk_<7ZTX\BgL*`gs՚_υ;t}y3cXzτhE6]Kj,Py12Ϣ"_YWokn5}2gRL <<3H_g]Lb̫I'!blɨB\k±mCW? ub8uw?E'F\ua<^N-4Ww.njX%BNȅ[Hy@3߹Mb%b4I%2ȍ<:ώb;:sRk|HEBX##-5T]2W(}r;֔ #7DzP_ct o8a17$Diw}H_է?+"h(}G!BA"BI8;FOCCCC2$l)fLq1VfT0zۛ䧤AB8+:zL| zOf&  'GԘX6r<==kׯ_\$I!ymi\[Qы9+SHNF{ HH1s 4=$c8AZ= eqgNJABjQHC@շ$FJQLOfs3n4u^9e,ǹ2`ځZm~vSm쁬!'MTA`I14Ec%}n))x1up g5Ɋ zrƥh~=8w?,2T'j˷$TdIn#b%ai XtC q↽m$)mS53)ScPU"))vy8C߀Ei-k~5^(zqʤNTЬͱu?n=+Y4Mɍ !6LC49ӺHV[V<S:Nt3{+1HJ[H'er o$HuTCٹ0rc܇+(Kc䗲zݎ=Tb / VƷtwy>A';d Vkt =^]d0͗Ovl u1kDiZNc) I1$ؑ81wLܷ'KATRD^75.@ 4^Rr='nݔl=L 4L^TB*Fz֯(d琍 NԠ/I߿Yzyʌ Ϟnq,WVZ%eY"噊c~mOTlǭ6_Xw=x6LRJiO)t IDAT=eŐ: eK22Ϡ/'A]C\ER+LB.dK "Dgz[)rNQFjNY RpX#{g%AvkID|1PsxvWT!a1dRxKyYyڝ4,~w}rV!#:+ B8KxBͫ:zڈr\gpG%`I̽7 w(w' y篾iUi\L@ C~[a 륫%}"SJEI|41br4_%$9Yt}1H{?] jb>frxdatR*uRrͥ Q2xP xy pi~td>=p>a4G<ܬ7φeԾ]:$a];{eȒE#*=y{[FNǷ$6$Ih 0ÂAnar)3-X1 p=a LgC-Huߌ<*ЎCh ^c@*z+  n=#fu0p\,{a @C\ZD"5ŗbvYveMP Bb/ǵ۞VJ v#:몀U;tL~v}ܒkn@{?uIttmĻ6Y9Wc"=7[l(3-uMxQ@H2uy?D?'&_N#!T<ũc;=Q`z'X6rBtu%!tܭ} v.QLR4.Lut :9l/q.|k,5+#$XꫪYhŝ)Pe1mNߺa L’;i\X3BAF˼4FCGݧLqӹā&z?<:U kqj:lL}j0y!c'6w۱oV'/|By]-yufh!}󱫋xN#GUW !hrθ0ZE^^no,,! eaR 1B@smCy۹׬~ƫB8VSۼF >b>@\o& 5Nº%?K(L4ջ>ZB@Op jPj6L;+K'/}4d?7\3ƪ_,>z$J_Ai17LfC=Ӵ>i8oO3fta~~~PA@̾:!aաA ֕nhG@ՓGEEafoo:*>}խzlj O]qZyyy.F,--[>HIAVTO^PPq,,,^xQ Be@c( Hk'}ȣC:TLPxiB4Maaat:#D||uҎgUߐX;.xh xď}N#~/䐣hv:ny_~?ɜw! O#w/!Cĸq㌍ں.nHkc#7@f}8p4]DhQ-@H?@S~:PZT}+tNTIbX~ $!:_κ[B2zX+zC|UM-gXR1j.5&UTG%_N&'-cҶ0y6Sf8,ǭ&')6 )I9s.Wd#s*HIȪZN<(u^ 2aR]*3Iݥo8.{PU?u6PLPx3 7oFDDL8QLLR pkg͘K_sʕ֧M_6ݳ·\WdEzHWH (8;nzQ^t8gRCywHւ'/{qo9vD Gksy\eG@b=M2Gq[j}_yq!}u$vco~)R*_#"M엔0=k}_=mvDtN=7dY^$v, ^.<Б3Я`ח bǦo Ȝ4{본ov)u^^Vhp8뻴7Aƍ%$$/_޶U{/U؁AzZw3Ϻڷmew/ely\|p.b1Bb8_89c"/ [|*ce>S'fu5}pn4fw ;zjz^h,ϔW6tX4Hۍ.&* 9eBF !E^Sе[B]'!Ij;I q"w)\p!Dn?%cqZ { ᬡ-%lG:~%$ %&S^˞`! y Wk(TFQ ~sdgkHb@gĂo_aXVy(VTةb43e=FqZpm°d͇B]k2fVybR|\ca=異GsM]ͺzJ'EO˚F^m*--m{=Mϝ;WIIm+&8d F85\"Ͳ/~ǧt3\~hR)[8u_y8eN)Sλ.#ҳ/ wC^xĺW i\y2|Ų /Rn%kEƢq#cccc^=ePuYNLra0|_r2Dk|Bƕ!V9&M$$!$r94Uc>ō#p! 1.RIIآjDZ̙?F\<6aTffm{u^Λ}~gFVZ)]d1BfÛԷK)=ďS8yLO\#~pʦweydOQ_Nw ֦?7 =@iLDVDNzI_I}#_~ lc2\3Kb-+Gge~}Q)lj+>0cP\gKӪ,z$vL4Oǝ;XU Sd0T;Xz=mON;bCL2)2'_L/{96Bn[Ay͒74&d8Ϻ\.֚-nYڟAH$?25#4Ci޹PyBXuv?0 ܴiSFFPO &b5aNQp]hČ>TL|Rj| oFIaL31`@?뚝)7ן=ݴPF.pf/W[ ^%>R⺃sڲἡcVǸYjVy+mW][5O ~+/%s}ld9,mWmrISCr$'Ȳ8P8qQo͚W-X b4^Ψ>J"@Dunٱ%Uo*nre4M&gƜnWADݽa| Y":DB^qIf6勮Fe,~hoUwj*(JQ.=hgf O|wMUłzh5]7xc}-ԕTt\W/cw_ι[w^Mf?K_UYEȍ~I)Snͣ-uTUm{EWu԰s,y~. {ɾSdCȎr~Oy$o+qgVM,ԺM>!Ie~DgݚQTTFz.pWVR3~*^cEf;Ol7ᇇyxC2azjjZfVs fMul}/Ͷ浪duh@nDh&Dq D-iX,N_GANVLf(5eIIUHQ^i^qYʧA~ ȄKsf=2bթdH.*·}ruj7S'>Tǚ߾[<:sgNj_\%~t2\~:6!x="F'G ۰'Q2}Jy;7!Nx, 59>hpt |Un%W=q+$z_{kRɛ|bHBܫŢ7]l{aqO/z'[ٚ2ڂپF?4?| boa/ J ?eߤ>ߒسNe}FO"0񽷝GQMXxuTWI; 2S{Bq|>1eSg PggN䓰 !`wX3ܻ7jLhSDZ'8XY>C N*1C.?"< yDZ17'ҙǘ_t3ćbCc(Oy[!S]MSf H&ʗDGv{1?`RդM0mgLS@ENp؂ ctDAǯ$d\qʻ^9̷"Xyq]A.=&ÇPo[F9YF\~C1/0ґJ¢2='>SR1 6NK5EQQSNKd{2`I:u7!gxhhhh'%暓Ͽ2]#*\6$kD?PsyW_t㢄m/qtc)ɘϜj/ٟ=>o0{OF1 2)BnУ[⸙wZԋITVߥ3tn<ɫ 8O\9\1};c FQrTq$U)먩]e1aKJ"Y_Ly3e(똡ŷn|2_y0 7n yFzTI .BP7{ 1K4U]i;:'- F(XK85Y#o4h2Ab Y gM`[oy ܯbZB DS||lrkԹQy3PO~{022wE?VuVԘp5!dPtCuŕ/%;܂Lx}ʌLDe[eޤ^KGKKKK̹D(?dlpꀃ?^ە%#)0y^b=|V;!Z]NTʎMF+2#q! z/9vO/Ri2sofdYءǾhj7_| =&CQxgGz(++o4dc@ ( N6?B2h?ͱݞpk>M@5%âϭ\D"]=QQw]pSBƕi{`a7yY/+x%vLy%Uw2l%jVe;|^!)wK\_ːU,ŝ("2応dD) %^q^O^w[ָkglU}&ILY!QV:rKI|Bp:^^-QYLyD$I@B`tNp{]FU"*j| ѣGۺ :8X >21j[g Vͻ[(/^Lwx"P++Uy<nN*>d@۞V~ؚjzp$mիSZxaZ͍JU0)m᝖f-5C1])+UO~zUb#h;bA @De˦jwr;v{s?f:﨤̹i+}Yk[rBZ~Vk3YE?x,[0z$ɿ.׽M1hq)N^^1b4Lvj&51`^nHJ"VPKMJBi $%%ѓIa(2ߧPHN t dB@Ԫ* `tyC! bYp*k`ft{ܵqĄW &K-J/"GTm"VUQ)&SjsUUT^qO1)+3`2r iGxfFVy1-.ssЏ#TxAr['':ɓ, iI՚~2+1[r[Ύ5* Acp菘`Ɲ8Lo'/(ۅϊ!@K»'tڇ޲UvK&"LP0~j .>9p.H2|K&ǐN(Bfp C"Z27>{Ba3iϞG’;YWƔIM%zpfWt `Y6K9%m-6x7o;J S'4_=F }Gˑhp %B{B벰pl is:Sh(wo6Eÿ]AA7!F߾a gcnO,:;H_C&vBba<1x3ndoA`e97ӵ0)=xjHzoHsfpycਃc<oޝenAfKpC{VVִn~'  H]Zͯ?4n JiBa֮  u}A'A@v,@J@Z V@D;  "м͞pNo54yKGFW F4 :v9=џRu/JA]hZ8}"YBEAf)D=cK=T)a.=,'`U+o_@'  H{ ;7ZꟅMRW!t륯mF$Gk(t7Bn*غ_kTsZ*ZfOꦭc1r B~k];*}jپv<B~Ym_¢o9jt3rD1n4d)iX;_6Pb*;+M \4Gѳ\ZW!)AӰv;ptj>9$뀣2d<^)cdhp !'xŚ`B]vK_pUZ?\\\x;|&  HGjOO>+itr|/溟E4z#1hkOsLtC a׆T+,|IH 3\#S-k/(.A0Yu|LH|es^9 WهmdyG&DwKq;e}=:mƛl&<#SBlqբٶō .h+Sy>RAo¸u|<:sgNj_\%~tJ&iڻ^ kCy]{ҳf/NY<@Ut=?zG@Hյu$GT{;T{=i~?%*U>RR`T o4h2}JkܾT(6hp]JUŪWB;^a Qz{L@0 2蠖ąů+Ow U-OMۻ8%D]<]4`iT)i5N` K%{4ecZCN9 HKB]3ǹs~s{{;^nW{]6nj_Bjq;~kvZ0$LWRa8򍖝|ƮIGoNvn< ޑt+SNG/6,6Te v?1DbمzC`->@<<1|̧b_Q'-|"Zdac<~^Ԉ!@,"risFDRIQٯ'GlU0ƘTUp"zGDZvhiykKJ[uB=yle~pm Da@bkكe1~N5Oӑ#ɱ.w\.$IRSytWz]l'1oQQv?= RRaNb)"K*D"c왦uԔ׶.8#*=KnJ"5^F*l 0&ql\K$ts6\lT3&8|#[*) XvFuuMPDUIJǢd "q5fqFD&09;f۹c Mw[fGKq5LsSy&jk9c o)-\W)kj~YЇ^)VsjY]j=~[fyaJj^tU9+F.5{ut7}]^\3癛ӟGc֣Vݤ+я!|ˑS |nuޟ10%O Cċgu>04Ⱥ_0vpW縙2\]FvСC}Knb|DNm*;4yS663aOXTb2L ~1O=wh_6*5>!1äwϚ;<1)ͯTB>uY=KYfc6Wp71L>6/:8n]TMD$FLyڌq-$"8o] M7ͧ4e>,L_>\ ma_K۵k͟,_6/3i+[͌&^|,K}?7Y1Ԛ*6j{d&i}L; Wcov;66VN꼼Dw{Ic;.z.}f;*6c| [v,W7;@f<ݽ1xu;̏S<ޝvO$nV7>9;cv8BWq_D}ptW@v\VW=Fg]}vpQk4ι 7ݫ@EιFz!?']RY,1[,Ju*C~N ?h,((ϷlFRƫW!sn2dĮ ;@1Px ;@1PxWsIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_side_after.png0000644000175100017510000017301015203313266024732 0ustar00runnerrunnerPNG  IHDR9JsBIT|d IDATxwxݥ'WB "]zQ"g/X16Pz "Ҥ^B]I @Bgݙ}wfgM **(}r5t{N_#G\eKgDEEz*B0cƌS r={nDDDDDDD͜9QFN 7 ݖ/""""""r3EEE=z(r4{ԛ/""""""rmP/""""""r Q/""rKĴ/r [.' ED:f'yZZ1Id.xQqG l͜Of˯jA 0RX7,{8oNyɝ=M|YbWS7-_[T#zR2959d6e ""rq| #Gi}7oooRRR:u*w_R/"")ms`7i2WKXr18>Z(9-aNxxSiϚcPU:=;tk^69ۛ¨ݠeL%~8}%4S/ """ OLԩSׯߩ_<Ϛ5M6aÆt֭*AVC9Cҵ+vadH033ٷB\Ym&F|霴.?iqslVtՉf~ĬOkRi=M8bVn;FBJ[ ;бqn嫥ؚt$L>SyA~>}8yd*R?x`&Lcx?22PEDDJ# N8WmEۊ.d&qzNdg sx#{k[v6G4rǪsqͲw$M'v4=WBY69:V7;8GhԕkWu*ES0sdXkԥfg'Kÿr]jT1i~V}jl NFgT>qɒYAuqڱ|'Qo\> >|N7G>馥ӧiiiEJHje|ddd@~/R"""ɑA&|q׏bG]sm3??絑͖0ѴE&#&mj{Lۇ@m(Kf+1ٻپ, ws205瀛(׭"ҺSٚJ .)9ۛѫ_2wgX{ '\k N4f:4%/-{a,Zi+?H R{ J7{w?&& *p!*T@LL EJH~JJ >>>ٓ9sJ~Z_DD..`vuiHuەS~s>p9 _+>ڕyYOr"#곕u6,Ӭ̔ OKJ ݊0abI?ed`ϔEZdW2ޔqdf݄A}2Oe겼MgNU\x tz_9]H38tW_~8E/))`6mJٲe1$%%"""J{ױ) u,pݸCL[ݲ01mNMhdذ9,Hq'w<\L|6.1j p ɔ""rU-t ^#}8i]Ҭqqqԯ_," ^}7v)ټv;$2ą8n·yC",vO@La=hS=cL\8́lY]Xu,qO6|3MVQsP \v Ly|+`?fgN`ۮ:p_O|r/[Svu[XJ0|u"kJ9GkO苈[.PTgz{KlȕBp.5wqhg 6eB"[# 2 37tjlX<Ҫ;WƒǁKp<C&؆=߬`dEmMnTʝjqh_p%ggj88+ֳxmuiBC+شq& )$?sH9潰TE=;GVN:pL[z ޡh3=gYf@۱gt'&&ҧO,KF vB\̸xNfLJvF*'C-zyS' V3HIfp #y%9+_4lr'(KlLb10ωt;Nz`?@| /_o<\,ٜL#9,w}pN&D:!~ROÆ xr3e|O+.ftRRȴf3Lx 3LRs+~=""";YiId]5̔d̤t5FI1(p2򭰦,) ɼW'I<]# Ndsd8}٤&$弟#$I f\苈\ _-ȵKȵέ݆5&0׬D苈\苈\i """rP/""""""r q(rrJLDDDDDDD EDDDDDD! EDDDDDD! EDDDDDD!-T|[ 3֧<߬Y@``ai^#G 98b+c҉@L?k~G`K-.-8[Zbt|cV(RTY ^>~75JŊ5h?|#2*CjYDN螽d5~ʁ׺t̪:ӠA[^^i=ACco\ZׯND*4'L㇇P51/s҄ZU*QvgkctAȦ?sHWK{%H^CQJ7K`3음Y/5^Gvml<~{ꗣQ]hP2#kѢ'lȺ?\ }4 ;߻ٿ+o|w;~_f3r\ģ.2ե`* {lo<:Jϟ_N` n?Uozncιܕ o|4wXmΊrן<9f.veX{lsqw_l֟o%><#߮%p-&ﱃS,ڶ ߵcO*UglZ36:Ɖ91v{}_A5uDDDDDDDr~TS$B9W77wC8i[ڑ٫nh݃hz+<-<ٶMVmΔ8zڐr7 oJiKf. Ֆ`'Di8NyWDtm(CL_so&ҧX~[Πg<vLh:Wʉm*?oǨ?9)){!55.+ *W\E>77ɂoK`[I.vu|7۬=rg=0e3埣d-d=^&|*V// ٙ ٛ]y ggoܼsw69d`8H%.e Lz3E#ߩ3x}g_DmUq+G%={0ʹo߾r[n{%22"""""r])<{&Ls {151@؞Db4Nw~VV1O3{*XJkFYS7Oǩ|KQgƙGwc˷M4e3y +#6+gDH7nY!~oeDx%IMMU_H7fٲe>|tJHRH^^^xyy^EKPL[7"-g3z`)WkY "Aܩ,K13W#[fQ򳓔_:#i~ˑzdsyjVBgez0nM/Yt|V"=:Tr; OB0fYP7̝*u@di~$$$KDD& SNp)Ea`Gȑ#+W$""""ET@Gy=ΐopER1yѦ'_ˠVBZd܋6ӝi`j㖺swtitVu׸ռ߱03йgy=^wp3ukGz[["D%s>!{OE./D>g/7/oTv *yEod7<ߒ߿97i<7Kq wRR2J3rdУ'fp_EK`2 t) L _D@/O>]i۶lfӦM4n_Tiĉȥpn""""W/"""""""א>)ASH1Q(k6CBűb0k6CB:aS/""""rR/RDy+ܒͲQqvr"6(J:g/``I ً|t\u2ԍw0.tKHPkߤgg_k;-d`eN'%+&MqG"+u._hR;;'44VmJϭ>wC/Wcvۉu߹!Oa|}J/w9:m&rw k[@?&+w*nA|Bj'j$3ANNNM&Lf NNN8Y̤ˀkR!$-6ewk4?:7=7cgdXL #G,r@n[^q@_DDDD()^-ojVlB ^wc|; V0@>7d2wzF`9R;]~D:.Mw2vegu}5f3MQԘ7G~r7Yr.P899a1em潛qhGw5鐽oFѥQ hF~#:ℑwaZkՏW pǘd DR)g-bT#g}aD}077N՚*M~nMkRZcz84ƧGTV.lmǽONxC3~qoQhЎcu?3իSY/w{u """r]P/R̾zWf}y|P58$N؉K^ 2ws{܊` R.J׏tpr=/_'Ը c'KHK !;ew ')D[ I{V%'""""WѥEwƷ~;i)9~]{+zu.l:nG Ǘ ~%{o\'a|r 2{5Eټy37ofۮL0].5Kzb*HK,ѱgǏ=N_0N>d~j^GZ*iWEDDD()qvOWw|+o<~/2gR=צkOM Aw&LCg0ܕ&mý؉W8cb@DDDD2/Ri;v?Yc/{|d Ԇg~\3g^]=Η'009.6yjD톜tGpK;"ݏ+{k|z}8kITg:c_/ [0_qx$؜ ՗Wzxg|\oFrgI{>/f#wVez~a4Nx}=]0,Q&/Kv)R\QmY΁)q IDATͬz3 Vp;hY#Ț-r H`ּ4WRϴs7CJ~}|%ϱ`OC=c}F6>0_ C ~=h67^neϏ1bau]ݫ>0%g!& a//af!N_^71^o)-y拑nb)S/?3wH'{v٭lc׺_xg@]ʘUiFF2_GDDDDDD!'\%e4&]ߔÚ't7NJG!rt~ύ71wn& ͆sO,3hC,'5A fߦ E0Z gL6hOrMo$^WBǚk!3nDtD9b7Q?0s},6ԊÄ=:@_DDDDDD.rdbƓDX{!!$qvxǚC 6%ɻ$a&8؍dc gVx=\Lr{-T(:=G{36g`N= /zq/L -p,NXX|`?|[;27EDDDDD.Ko"51v(g?Ns )b !'∷H"x>|/2!'<>˨|[375r8R{{ɬtq&{/_X͐yV>g0Q 67;}He+Iq fώHIvqDD2viS_z̶_mBmDq(v[9Kk+s$ kUՅpKo3}<{6770=dvN)[έ.mׯ Gn'00mMY{,9 88G 3!5 X^IRndo'uۏY0 /tl[4;Êppd+|wNs$͞q'"rJIxqgGNmBmDq(@߈+T|>tz}<ҭvUd](>'3fn/o= Q=w{;պ:e c>➈3n> v|ðQ?qLhVmēKmb\#ѥ&U/20Qv7vs'YװsteE;7]X/AŸүQe"֠#H8;8cV#UUJ""rX@m@mDq0EEE *ċh.{.lիPێK#rqិn+Ƒ̧?m̘1N:]t'^{EDjbڀ:<9g2c[z3ȼ L88~qn $"r(6½\{д+YXzjY苈HLZ_^8nz*.f_ '$>=TDDJEfz`[}W>G*m~ܥH_$+>wn:kVv)DD_l+G '^?+!\o`( :HMgͬ6 `Ct玧ʶrUDM8>*8Uξ{5+{\ms8et"*G@ ]>[zr""reڛN{pГ[snFl0CGUkfРeGl" .ܔ̄`pd HMe&p~QDD.j#ADh䋜'""$ 3n`G}S"IGmcvQm+Kx55|7Oz(LR<)>0Yڽ5F"gS/""cqNI0y9j%%=)I6<9d%)^O:/vҳ._ED]6L+"oLD|"P/""Yˏ4v30R,wVωd,;vg|M&/v0w*GfʶF'Ec) PY9lD Wѩ2pda n%L.Z06SXaիmP/"rmvcӿ݌Wgh2>)PX|z38mJvۦ,w>F'HKg,8d6xJx:l9ԟ|yv`9}t""rIJxҾ/&F|j{ێCt<3/ODDDDDDDE%ɬ6:>pۣZxc7ep+/ȵ}+hʷEs9٣:w?z+~a"}KrQ47a߷o!*֨K;UkR6v鱲"""""""'3H?;y&O'9Uzboӝ :t2,x^DDDDDDDf;Qfv!o~X*NW*Y)f»FEQ|$F.&|+t}KR>#[ܵeBS|LcKP"""""""WwnGzә*?g/[1DDDDDDDe$/"l֭$&&_ER?j*\_:WsE^ʨ ElݺF6mJ(rX~=۶mȩK~K:W$\QJޗ="rJLLaÆ] B4jԈ'Nv1JwKsE^{ɯ}gr"n]y1 !Wa꽜zB犜z8WTlY5aݺu4nܸ8ܺu)bHԘH^ptH^W\{l23iNCʕK(rjd2v.+{_ +߹z/P'㋌,$EDDDDDD4ȵ,}tgG$od"[zkz]$/`+K{F[AdEv:WJ6*XT3"h؎DtSxf[Von"[y24x_ 67澷KXɜg~98>-gHmzGmj94؋3s3glŚR/ЛHs_KQ|ӽ<q:HeU_dȗWK Z{.y>TXrα6zS/\]]qs¿\]*@ 3_z<2-VּЈ6vOƞhJ֜(z_TVsJ=+\QqՓkާ{ h^ _?jwYK&"ڃp_ۼ0=H[&/må&38:5;)z'µ /3|wkRn8.a>Gr6HksSxQr k|>ei9{3fA=z9lɋI-D&:tR2%p{\}sIOgd R?zL@Io;O~Ƭ|gPހa*0^ޟX6Q=l%j#t\)<%Vm{e*?GXf% RMHire^eqz>xv }fmߓg8 ?sZ,}65\@81W$ߎ5kgjx!CeA'Ue0eTAWG,sǛ+IT7)dH +Gz0zsZA&-x55XA~}MkT$,{$֍ďX( ע{H_ ܡiPǚ b[xjn2 2E5CBqflx,̚5KޣkcQ31?A*K!3l͒}?BwɟS"7 ּ2& z#F:uSj2m`; wIBעlDtGQG-{yqK$Šv,Jh6<㞜 TsZ.z8k'$$Cg{fnqT{PV's3t_аj?o7ȗjaקY0 '8]_D#vz=v۫be틍hSҦ,Ͼ1#no\!h=Ve?Β78"ʍ2ypSF:U&0|(s2<Ϛ +Q5F\ѹR8j#TKޛ#1,WaĝSm#.BH)h>w;ΨCΛλ `im䥤|htX-O&zhLxG9 b>,C̑ L7])[7{1_6흏R#flaϸ+Eh=ĖYL:ӊ x3+#aYq&;},M9H&.aV=Q̙E3V]otLv;I`hYo?bw^ەc-OٳYLa >dYԄgF6,Ҷq M}^ϔ99n y2j_y1I,}y4n-?V#q&߭qlw,L7'm˄83nYȎضc-tGw2gX&z?r{YL՟[kFo֓wf†\(._c.{7ȶG0H9-EY+"C^mޕ@î-;Odϭa),HiMyu_G{VkR!}svfJJx=]XW/Yyn w>ҕpg}'b៹|tTO7g ÓY nUhײqb̫yd7;U^%_ojF ' 0Ԑqe޽;ݻw{kQ<`zD*gz |nN^t؉Ho &q-<;.ć/ވ)Y%eqle*R?&T߿܅"+؍X-?__B>?]e1ftl f۴NJ41y=2NU@7ʹsKK[h2tM}M^B0l3e0Fc,~^*=%euUX(]AypH*1:V(pm8{w%w~qj.t!op{igpHapYX4u9{VfL>͸g_Ka€HxytzYe}]cm+6B}f>yb af~ L}W.ȼUպ'Y6EQg|na8RbM{]ADDFjp2,(o9#i=H6iۮO؏p2Kb`A&3@R\|E3r3;aY (TCvI)^ގ[r#FU^W0闽y%eCCc̴y= 4}n׬i}/2 UF̌): ]k7ϧ0e9*GG8FʉpƷ'1n{R_jp>?LK3 /.޽{ٻw/bݡMnY`ގƸl">PKncyfyM#Ɩb2~9ꀋ|Q_Ky Ր]jcf _ςLRLfQ7sڜn<Ώ?`1OIm߾ f~2x#wa`*1ٞ` 8MQi,})Kg?K |:o1d;ؓ9Td&B9q8Yyَs4 A.Sn8|? 6bbw>da?=i=|=9EƟf!_/A^tS=p->ϒ}]{mĩM:WzP/zo=ȴ,5~z-~Eu@_9Nُb 7'zoe2[mQ\R ´'I<|ag??~O9zh#ji%j`1E^C@o;ý5}o>7odIYā$%W.HZˬdpٷEܰ\g0v. 5ߏ[o]pWjJ/s'-ր+W+qː< Vy̆^D}9QC񿧧s zZCU[6CX%1vA7>£Ƹmd \Z|Ys D5X8';02y8,DvC2n}229X~Jm R brse!bY֯ p$yxfU 1dL} :mOaLAzf*cR\mΕйrg㣨?! $ -ҫDQΎzϳ*6 !" e~@ nDžٙ|pޟyܡ&S;?+TUVY J8&T;Q6ڟ .esuG ֦?wp|T[&ON9vshSeCw--mqRvs.m}\{uSFcƤQ\|g]e֢!O_E ըf* u[L]9ICϬ{_~n IDATO@oCbumV.ݭ(A>Xx]^FO]tNKl sZ/ܯ:tu5Z+]:'b[)7fЩ69*>,=𷩍.2q Hw_WO!݃tN.z?f%O|YwFSRtxo/O7C:6?48ڂqrSk%j5bݯ"szȳGP#~:L/vCTUσl+ȎkFι_6ڏ>M}M#[q/rɜ髴+ZjV5,84e+pޜzzP=Y%$VkOW>]ֽx.|=?Y5˕zZʏVaVUբԽj~' ]8MƺdT^M3NGd2b14ErO=qT<}4`};j_n0?$ٵiIIjuZ{KgJ'y.]qz޽P+/=5̲XZ2L,*,Sŷz}K2i%t/h€oY&]6A_Ԓ\ӗJKY$&}QFGc{N.<&}4B}_UӘۮ>UWq{_3ȐK;gܡfw3кWY7E:~QMij ͣռ2[%v5SMa2+L_:R3Wkْ4`D߭kPGjKataytan/U>z]4A"2kF ъ4U&uf.9 ~\G[dR_]zn.\gհ{a[OS[{T<8>~+O=yf־hŎI;ko~otQ3c^=L$w:ř3?R?<_vM'^E2G*&N%S >.**JWVJJL:\.V^7q?VP͟~+,*ݱJy\^n<Ř,;ezե+ee]?=pMGΉDzFy4}q4yY>8/k|˒%K<O۷oޯrĉPֿO8I rxC}|>>BBܹ'N7rH䨸Xs᧢DO^~NNfwmذAJJJt(乵/..ְaܹK@QQQ?1tGCa}'Ҿ̏ry:@Cȭ]Sֺ|ҤI |Ivv PZZC'#qQp.n#uSZ*YMgGfߢORhHs% Q.oMVvv<WiBg=v+ wvmG/׭1ckrEk|G;V}z7ߪA/MW;ՍM3:_MWV3kSj[vD*uD=Z:w'w*=WfE_uX3;;ck.c9|Ϟ=2 !9xз_ *B:*%~9ֶclҎeTpʵtDy\^7OV%_(.!@]Qe,gy}a-4pot`W/2+$LLϗO*t{;Ko~1Rw=EF6X꧶Gh,gy]:Ir\i1&\VEFY-ۿcSnG7[.Tkcy&оs >_@۸F헭Ӛm9rԺݳuyΙzm\$Y7&2w~gV~2c"f/icu#FU╗Cʹ:#,_Ғ?V\9MmʒW7%b:wWB3*팩@jzooM ks?K?_QIfɱc6?խ0wι 1cZ*>a&vKRh5}G-n9*x} |P?>Rp2x9@5|}h(Mԟ[ hw8s ƭ~DD-[]Zl"""<xNƗ\͟?_s᧢DO^'%%{?Ŭd|&77W#EG-;;[a(--ӡxhPC(!4Y̺PC(MVvv<WxeQ 2힎1l==8VU|:o4*u4 cu#Ե]+>oNOq}S ] 0T*ܸP/pnwumarמa>|4׌_/P;c֯ܤ8A#x?fo PDP]::Q[s7!iT]sz&wPQKRŷZm:gGoaUǓPׄJyvWuAQ=ϸUDF$薠vI}uٔEʜvFHRtkqDFm/U(5*D͢a9ekgtWrR'8}GyՆvmƤwRRǮz81ySu g4}J7_nWd[?VSWQy`m`Y>Bo.^ +^ש=g+T螕 Z/Nkz;ּfiK~rt?jQ>Xw_^Y3ӎ'_F_r[0IsD|Sߡ 捀L=}S7]][pJu{Vj؛˴n;5RULA:uiu_{4m|;jRz߭WY9FUɢ(xvW7b[4&P2Gәkr`nz_=I}"2'F+,INKmv.)HܦC' Xuބ!vHJ#/;GmM J!yc-JyO-wz Jv%Y 2*K/w~ifj4{֖:ґ7Wk;I!ҕ?_dW!ba$|:[k %[IT{5bp$WB*Lգ-116UJri|E--עTUA0G)&zVl ړ*Ր8‡޸itMc՟ڵe.QU{*\ J+rj=*|ǁ}*UqJ;ܧᚐ [q/huǍߪ>e]gTtE)s~ IQ\"#HY1-vܭ)6&О̼w`1YwȕkD 8ItaߞSkc;%e>?T52vi1Z2ovJq6h#o-Ԇ 9H*! 9^їBܪ[VEq mեcsYTMҲg{IS]d~][mw?'3Pg|m\KGjp\F,Eʼnu5h¹)\ h8JKKt!G/hB_6KU'Eu1j3Pg'e9:NG;քpWӕ1tkkp蟈(SijV=.){jIlז%Y:OϦkض\) (ۢe;+h]ڴ-\)(lVp|FlQζ#UҪed UTCv;qLSL1 Oxsj̘1uZfn?~%KΌU=>aڙ%ɥ WFhC#] |/JIk]ITZL:U&MjΖaP߾}Nmdsı̜9S#GB7Vlj;e 3W~ft>WFro?+9FUڇp^>ahrLa)RAi8rV*yaqFm*WHYeVHЦM퉔G@sK%/՚߶RߔZ mʵu|D W3NmQ&CQ[U(y(@a}#'u;6;LԇoÕ,ɨTέڦn2;a{`zܐLAV>=J۪Į1ʿ>uM5]a&I΍r>:EEE1b;w (**Jh5oGq`uR 2,/4y%<}r}G<ѸЧ> Vg>~^iWᦣ7iseb<>- KlӋ3QuO\=7h@#tcôdMv⎜Nk]GBxRtJצб:| ^Ţk^-д%%ДX:Gi4]?}>6O}ۘ^hL,PuF<9j+l2)=j͟WA ((bR}hN,7w1=@km}ƶԵV\ړWn-B˧(ȐT_>+$Ex3vZ\GwwB&k] 0dzٺ=_ {t,OU7 4֫E|~Ćhum{m:}&.[tQ'cx9-7ttRۖ-%7I;6G樫Ļ'~BJ&E{BT SG) FB?22ҝܪ}Rs~X-DmV>7r5явeܹK@tMQonQ7K--1AQ:_)8.>~ϭt^5Tdd"""Pb}2K]~c]~ Ty `|0>py h0ES;ۨm0<xU N9LtNZ@eJ^9/=ߠ̵,Ox rcIL]3NTf|DX `IFvn6ufjtG͚*,kZƓCGx#[];z~'CCk, E%0NμD\n WtE+uJ ~U7PzɀVVV 9-7 WnSfx/~BF|,YZj0IO{7rgO?osߩ t^98[{7 '3V>衸7c}$#13̊]Uz:@BB îs`ӑnì#Pި3]fd:2({u5LL_{b۷)ъPbbb۽{***TTT@pEҳVAסLfŶU|8r:9992L2dHCs/_\%%%iݻwd2)--#-ׯݻPk|qG&IVHxzijÌ_*u.􋋋)OB^?yruڵ#MZjhx}nq&V*7gjQzw'$3!Ĭ@=#U\۷Oq;8 u(..{>IŞ9 БKGo`O(rJS6g]6}n%eަזM3|Gvv `8pRUKe2Nj;9ٛ9v.Дt޸΢'&@"Gzq):%$o~=x9M$<="ע)ɛ>ozzxC4NjbaU&j`r +8(HAկhFԦq#իE_rh:>mZW u?zp`xuלuNw*.FG!sIz"u=X OngMPJ6Y"Ɋt#O67\&s2)*|ۯa,-QAaVTj`0 o[6iͯ0,:T0JrY ]>a.nncOjsoS 4l4OEt'G}IRs}q Oun=O(vC{f]­?~G{qzr8=yr!/P-;w;޾%Im%AZ*aA1`VLŴ?,b2Ej+IJH2]!-coLVc+r7κKQugה]87=Ji0Yt4:j{M7 uçJ |z˿d ڣ&+."tM55g! rv׺]A*kOɺOH T/WZ -`l"Gߣ)Pynej,Y5_ 0sK#Gclۣ4jPQo֚?J5D*|9>lrZs~JmW.Kx )Q3u8wt}6ۦ"MahjOozx97uodWUs)%)FA5o QKG*_7|@vv PZZC9=S߮9_徢Q< I!Gߣ>L>N-<!Gߣ;^{e*TIIɡWi9{7FoQJi\aaa^1ROGjj*"Gc>Gt{ 5iM9>:ec̺ r; }kڿsl.Tː$ٛ/+iLx9>Z1v *؜*W yy&\IRRRg`2>ٗ)w$np(odit&2rS2,2ڢm<$9>]uCu*݆J$Yb󂉺t_e{:Fg#qi[ˏ~uͧ;eR=K{wةY4y:N@#Gcy9KgXտ՚=7Uy{ms@`}*srwâd=\N>ɺYx:B#U(ð)kP`h=d >(;;[aЪ 9p]!ƹC+|`$2m+oIR=Ԋ'!GDxBտ&\XK7OӸ r }7 O4TOxr c!l[Rh 6GPZlJ]N~ a!Da}(S?ƈ?:^ E_4B 5dv8N#[hEŊm=JI< |9|7]ܥM•ҽBfPjl)\PjYLVOPXg4Z=B]}LSNդI hGS}w9|c9sFyON>Kp=A:#z7zh#Gף4Y09gb&+;;[YYYPC(!f4Y̺PC(M>>BBa}@ŬG>>Bd1>@Qp\z: @D}nM9-ZM- }@ŬGPCud1>@Ѣ4Y̺P }|>>Bd*--aM:!(o<^mՒy T SAÕ&Qr4Y8Jmy6F k%# mt\MKffChtyMi}ZƉ#?xǍB@휻i[RQ٬JآmvOGv\O%q{rD,q_((/T+\CMUKԼM2<д1F@٭#aY;dH2ղ7LL.]]c q:ߏ?qiP;U6Cv!Z/&MX<M]\"Vw,WAa›zh(RK淭*sT7eVBk#x9;:wKBH %Хw*EA!EY bJQ@ҥTitҷGBOB1!s;;sg>s܈k/"YpTVTXӾKY8*[SA"YDD#DD5%"B%sgu=DD$Qɷ4u_DDDDDDąhD_D;ѻWtblէU*Y^9y3X)ޒ5pl=lX'Y}(U)-P`g&eݒ8^%Ѭ5Jes6> E`P @ک,k3.VƭQh&čNm_ÚmDo˲{l$st_yAUeBؘ-:v׵)#QPPp(F(fòuITսٵxKѭl V)};h;dC^4.qqs Jm!KnYʆҬdA iDYJOKzwtb-s&gl{'W/s]8%1C<qbbb+(h1ncp0ejR ՗*5CI>p.8q5 .dR*qp)lg!zSU l/bg|qCǼRf3CjS2zSo8q\ZaXLQgq( ضBu(U `2335W<`*L`70[)^.qbbDA=sňQ("A|YoH>~xG3سmכXR=1 ,8zxF\+U{iؐRn;;H"]9ΩB>ض)4m.k#(?=A VáXN+(hC]@7YR(#)FD_Dnfb\Cob1yYdnb\ovsbaϲƉ 9R> hkcZ/yfnμAΕ.ڀ3Y8lvX.:o+VenFR" Lj hLҳy Z=v b$˷r6 f"7bD# *ň FmaD$YqݎdZPnu^ՎqpXݰf: Fօ,;Fۦw%7.iF.V*Be(]8YV._鄀*W WNFkD,gVG~=c%{I,؃tk#Q)FdP(0 >~ޜI4&g\ gSPE(~>싳AP! >6w_=C{ Tě"I$d;p8̘ drc'#U;!M/d䃜tT$L bĥ##bDAVb"*S#+Xl;lY\eqTDS΄B ̤ptRHI?Y(ۆhaٰ9 {Lzd[]r%~`woN߷zW^tmPBefYF۷s̯,e%kqTv'ᜇ7wO]!!V4y}pϴ;}/T+#rnK#Q7srKQ/""yb.sv0"=&o *\8BJJ ))^*eϻ[)饥8A?dؗ{p'2qnӃ^ؔn伄<%0nw3eh[n -G }Kq4[?+>^>iEꡔ -MHtg ;|pO<ĪךQ{|~} L9`Dþ4T+Pf pGKPيQlK+%"TƒJo.R&>߈ eR6U?oSğze?ߛmnj*t8 mnRTِ!;i;V+sXki,T:O~˽E07|_VNwЬVy*|%Y 0p&d6̶BH5TŤ7~½ P&(r-33\_@:}^hI: ED_DDr^Ό>J-d'כ[ݻ/j.ࡁ9B}9~4f3)@DvOmGA35FLF^ B6g󱃡w^6|ZCNLV+%,KYmx|UN|9 u }ݘy ~s1)jžf:?װeFoN3" gwqn[Ïpc|zn>y` +~}{ػ{ĎW"nVkß uOa>a>+6xVdj?"xiǸF,yf.?39cgr Pb&9J?O""; J}|h8W`QlЖJ`·{ዻ1E봦1nbf~·Q 0۸?Kq 5ֳ Wjh 'O""S___==)'*bmő#ZЪe:LR.z5WF89f)t^ЭB"l}͉Z4vdX.43$*P]6,9c]Ehܽu@V@ 椬Yq"7~DD$9JfS}܋6+}2zw~B$ODDG[џ3~DǥwLxь N|UX(Bvw;n89CwBQ*#+H=7^e[ލq>y6yzr5cƉtϹv쇿_?1DO`1Fwbq;Z,V< _o3}[mi﷢S/K\ϓ|l'AAEϿWBq"7}};늷SwŽ?CO|b B A VΥY6k'85>W4H&٧| ߆thѥ)G߼J}&pg;姑ƶLiT=&}! w""yvwG~sҙCjQV=NDmZRi0F.)S.զgSwX*ĄhCԮX:SUsL>z '3n2`.Oۚz-;ezuqQxmˋ7ndk8ax`J.m\_zt_Ӹq~u=D ŋӵkk ͖6֭q9Q5WAnYG5j=Ȭ3ٟȵ; bAl&u#aTĻp^=vYjRٵ;wP|| 55gk=L Ԁѹz0>Tewk)~fPmn [و4wT)N?%kuͥcFrs>|ᓙƈǚε(oV|¹dvM ZP/""r3$-Wޔ4;9Ó Њ8+x}JS Ld|f;9>m$2A7.b>ތUuJӘ{?o+kH[!Jw32i~XVV+V+8L # r0TYw&r}|pƿՕ*>lJb؟KIcP mue 9jQ|]zY;b_ :Sb(jtه4;`#Hֱc&ETLs'zʴ?&)<y0LxOOd7q2O=gY|}72YUʇV!㹉iAJEDDr]2\#d< _Y<=qOJ$~EP—͔j^tߌˆq_~qo+z[W~$…)|%Sa<=2f\\RhTt1Gcpvf%491}s*V )1!0yzQؑHbGqtF^\ۙv^}d{.s>3]SFGس? DD{`Udfmuā>[ׂA gq,rˎtطr4A๹gq8ʑUC_lL:aU UObŽD g<',c˵Ljlh?Ixΰ^ƜѥMH;㱬Yģncy LybV PP/""یDx<*BR򅎎#)4"x]xnQ4(|.o."?ȿZ^[{YW3ԑ|xo5vLxxybNN&nIJe[C^),Q|M|aQc_]8}'}փ{SʜO¤$%`$%l«8ez=̀ھMEhZ 3Sx=W"rz ""Wgp6 EoT:yB͝V}5Q=s_ƎBJ2VǺU;j>s*exVʭ6,䛷Cѣ*嫶chV&ųz:bD6o_h0m7`QÌh7qNf w;No: AVLaH{֬dO%"""䉧Ą,Ubwٌ=XgxO.)^8!f\N>Y9ăU4QS~O s!Ȣ,rqf⧩W8ŋߴ,y:X@VcP&b78y/R9 Oڽ:GM$I 9!bF&^UeDӟx8W3߲>ÉSZ4ݱ%$͌2Hm݇8{XgiH2Y#|6jdX_f? Ày1R0Z[0BwFPm,Vf#KP'DvҰL, Zpb}\I "Hi{O36}9uҎG?FҾK}܍(08h-[زe fVv2*OYyߖPrIB|/ˮ}FppWlYǸ΁4yu)+Ǵ'IlZ7:[:٧,r7w0Cz xwLTcwӈ'Us+f8ůΠ#hpd&T\8ow&b$ϤpNf5Sk_j/y-;v}3i}w1g7ܲ}?{"BX>wD$?3S",t8837gnp |Qބ3ٓ a4hٶ25{w:m"֑¡fi.N_QA4pr Fdţl97#iAŽXp0ʡ(S${ao2@ fe[ʄe#|;ѫ~${F>OJiAe(F(unjш8Y !=c#}tG$Nx\(O;vf߈z)E!l; {YDa*^<f y#ȧկҬ}о[8~7-3xAH>ĺEr8ׂt IDATn ևF0k|O$=Tf@|4S:hps>u`.0|ӖmC{i_>Di3`1o܏o0^\l{*1-]h؂"&l=8KYj/%OY˗ypmm:O|ER>l5I5xj6a>ŨQzN.&pۮ% (FŻ'T 9#%ƻ-R*zͣGXލCtB0ڛ~x:bc` 6 §l7~)3 #g}3!""7Bz~ "")Fȍ}i꾈%rKSEDDDDDr--4--7y\ٷ 7nnݺW!""YňD_ni9uiӦ%J0h BCCF1BDt-1"'hD_ni~~ׯCeȉ֭KYfM8[ϵƈJn֪| |M9,""4u_DDD$^.""r苈&MEDDn 0r"""7JH. ~o0}zܨp6mʐ!CPBGH.,^|?f"""""m޼ҰaCƎK~r8JErɺuy]G '44޽{ZDrN[C:uxw:th_MְaC~\ٷ}dɒ?~jE5u;"oqu!:::/WFE$ߊ0H4tjEUe;D_D5uDD\zD_D=uE՘LB^D\I^zF_DDDDDDąhD_D4 >  ȓQWh7EC~gD2KUO==6"~Oe/C9DmdЈH6 ΌH~{ M>zEruy䭧h_"oso6(BB(\R5hl=k\*+PRfŷHM]p6ֿT^'yt_/ǖLEŕSiڌ;+gY0"5]Mr&;N璗p}#Qoү0m=pxM3޶y R SX靀˘QV+F7A<2'H-{jox9;r*Y8k?Oy=RQ%/)) b,>V=GLg쥲voC2eeHǒը2h>1<̄a`9)qF^e<ٮ??W|ä<{4{,FD8NL'oGŨ=nu;XWYڔ.|$ZSiM܀%Å8|mTc˟2cohM9{o~w$}59s·/`wƳ ]cyc0g` {2F֌L78ƿq.<?l>¡q?Ȥir |~S]m$rE*ءx[ye 891IΫGqx'Tm /̋ϸ̇|c950]U_Q.~?3 K ܲoʯnґ61uG8Oǡ_`֩X6^}ꏟgy:qc;6ԘQ䦏dWnt ˣg=Dn0%"][oE',nVM:&|TǤgg&v{;r e=H2a?0~(P-"&_}?2YMwGL/k?%1;fz NɱVcwQ׈=9q l+瑎 ξ99z* Bl~^_KEoA1 ٖ&%ӾݔvBЪ)gr.tر;=WL¹s鳖_86XaY0u`Wܗ.`Kj /#CioӐ]X6o2}^eX,5\VW[tԉN:]*TI=>&Qt+YcߓgӫEh}o[vOьܲpvӃM)r͔ +Ù?`Ɔ؋zL)}&֞\H3>j/;?ixa U?Ur3js}Wqٰlx&erdj(NO0<&~&Ca" zV#a'k>zg]!5Ͽ{**7ܔv>x4J_cZ$ OQ5.iԍmbyOZ4Sgqc2;94i4S3fqƵ.M3n^^W0|3aPx _ y|B gy?,gw0q#E(7~I?p8sD@?{NjX'9v(ݹP^\ifSxݻ5/CQQM&N{Ƴ#6E#@ul'#qSDyk¤{^+m2.ѿ[WөS'*UDJrg (|2Vs +a7= 0F{i7C_8?#{|:??{/O0(ߡQ/{j J[(1~>Ni-f9EKyl* ޼`KqzOtrxKJ(U*TvO'#9&A}cWYif;ǒpb%RMBl `ql&A.l:2櫝&Dc.CJXH9l!h*F6UH`Ƅ?8֩a}WpḆLK 3{:FuFۿZJ-əM9j1BXv6 kz_"U;j= ;,>8I:ۏй:*Uw77y)UKP:ٟf <+q곿rɉ8kUa#prx <:OraիR[=rwҿ8 nx i;)GGʧ/c ;EsS8ޏc?:@~6nw.gS9ժ -Zueft \:|ɾL>eLyW a I_ZJ?@>+#te:~ư^g%g:M%=fc#Wy6 Nj<3NuҶCL/y/zlk xbMO!6. oߢ$F%PVxE0;̋3Sl"%$VvF\I7 ۻTR!JBI@A*" `]{ose]*" *PЄ H!}A H ~k+̜L8>>S"s(!ɨܭy 䃣$%%)99exbSQ\QjקZJ2T3Wy(#EK'd PT~:oZ}5Vc7*ixV)"š̔afEx>^5KJJ:F8-ETFF }AIږ:U~:M?VJ*צo_7ݬ_JOh2_ޏSPw+mh;yooU`O _cO--?n=w-"]2}u\[:h`J}yX ƕ]t~`I&50DIr$F <[&!&in^\Cwszx엟R͙7>@!ƒ%c5v>[-̆ fޥn?P7A( {G+Q͡2UA%zlCٷ'<ࣂZ1_q=RZBx]jk_ei}tRVV->૪^kn 9ZBB<]܌* u]}4٣VAU T Qȡ[X}Y__^笖j_w)@A( E|)HyP{4vW[7~uKr<]">˩F%мm[b,Sct TSP{ro4{uAI25E?s'+Q}^"ʹKLvܯX-a=X IDAT.ϔ!ʚ?~N.\sګ$p֢>,mt?/+ڨyfҶOIЎ usKP{2at͟LwW* ODy85D|}V͞9?mElU"tԹ7̔aJNNt)k_eꇻ/РGVK')ʒ w> _e_g˩3ts̑k~ޯ4)ZR5T{>5ˆ>L! kf> BcռYM B|!)n٩O>E+^k5?V())q#yɡEk 7e -%7|+N:JX;Jhu_cKhk[X)$k :A|`YϹNm0x*.PNX_]=$F5s25jYصB?,)RWh@ Y Cp >s٢"K8wiK^ U$tVRmʳ+.Vm muSTL"uɳϪOoQ֍֔?Ө(R+T;(<ܦ:j+_wAi>+^:|WcDUUK4ṵ7z+9B~Շ!9|Cvf!*UIytTEK呣կ폯+)==ݻw{|Aa6CuÈjo9'Z9rTiwd=zZaȰDCj`\5G\-;p<]`>^ޤUY:f)Va顉*,RhxA?D!~*+?2tl9+ NAY&Y5d2'Y/sŷ,պչ*wT}25S\3 \JRfz 7jfYl8'%33S.+0uUUK%e=v)XQ'[/bSQ\QjקZJ2T3Wy(C ,"uYP}D0:@F3>Lf !]զ&?Z]/xP% +m %S8M̞|nCdr TQQqViיp r^~m|V``[hM9}%%%)99ex^YE/M|p"UMi0RT zM233e*:M{Hw-ZMo%AU~_Qw/y7\uP]Ƭ*eWZZZ#0*\?G6:ZS<]`DUtMY&질sO#oT#VՓ#LfD5WL />@!Ƶ]iߞk$IHw>POZ(¢}U*uiMhn1AdjSt>HZTZC+GGc+=W.0k-unCL%MrC!}ԜzKܩ~kQޯu_ G>cclV?PhptOUGD*?D3L5e&ݫwWUCZ҉E}C},j޸D?P͛4[:jEK;Qv ŸyMc"zM7umڿT~!pҢIUQfWQSewr̲Tk?|D?>CW׌9a9Gt=}eZM#/Ԓr״T<92PQ%tC-zu=!s~6W@M㚪VV$)!!;Ap ff*$p8H=B˦kzɹMe*Y7o7M0}Fc?QVe̾PKAn>pAqt=ttuO"d +o3)mSTFF }ZWQPdW+ôZ]wphz8`hn}.m(6<]/>PL ((ͤ}+g)o(aVPYUޢ^+4(P 8t )n-@-aDk0{>^(IÇUK4ṵ7z+9B~C:u6(GG8,m=޽S !neRx ێ78@lwڠ&r; ]jAp'KBGhnY7itWtE&-p`>P/1up'Uva(?D ̒njDL׵Ǯ7+5@DY;r~~YP*IYύPrrWȗ$Y65vHWa>5;Z2e^X.Y4\٭\*o멛L?Y;wVj+yLg|]jApmj&!f9*5LU.d^~m}uc BZ\?x@PTڶkfً2k:4=4`nUvkIj1*T Ux `E\^a=z(.GXPKܩ "X%vvjm{\_[=E\3T4HЕ';;8[G@,6 3TDBR4e{gw[O(:.XMCLP 8\n~]ؘ$%DjO2tä9t*á%;NY(^%k(eX K<xáã3Mj|Jp~6W?2Q= P&~'f`,Y*,5"$BEU mrh~LkRs&vԐ*C@#n*RR,TNtW빶i闋^}o Wϝͱ`T_ŝ anZ:W=cdڹZS3 LնGK5QӶ DAp[f,ڡ-C%vo&(앍熨wМ2Crir4KT\M廲qW]8IЗM)zBMD(_%U*ޙ[OxYK{mJB)'ڤX.wdS۾պS5ڲB`S|QWX=ڼ1ONC2"e/V?~9C_eWw]BP>t=||=]]iYojPOuUp5j&.>@m"ʖ\[9OwȭBrg?>*гwvMr9V_z@5}W+k鏏y}g*Yq/ӶuGp> \u[T2$I]+uO58c}g9w, *؜Pcuuy>LdOPьU`n]N}}nv)١:oyK||kM=4HYMf]9JsvO&T\bMEFCEZ L)陲噝^5vЭOo53tťӫحӝZãP{27˖2U fi#/WkPL|RrSԇOU3IDkӲ O_ OqiGWۀ7Ѹtԝ2T/iLvL@M_]SjZy_-kÈU5zV{P5}8sIRc܍θKc<]!?M~6DO3>@a>^}9w9hXj$KSuYM=Iff PrrKϱ)W>~^v0LfA(B| @xu5xFG}È>^Leddx @"4P3JX;Jhu_cȡͫ|zTTq!\eA@ T)'ur!12X U_m3L;wռH l⧲p R _>A5gιK[BծSftVR6mʳ)Tm{^A ih~03f WX&WJ ڴ`KΏUk| A37Q|R[rKW+s_35IPJ.ajntѠbdsepьGKJJRrr LP6ŦS 5ԮOdTxgQ-Zn \?󍇞kVsԕq}5Vc7*ixVH]yk7'33Sa0P P"}k#x>2332A/B"tx]j#x>P{x>^>P{pVRVV-FU<]< 33Sa(99ӥ{Ex>^5>@aD/Bx\ff222<]W Ex>^>@aD/Bx]jA/B"}%%%)99eoNPs62vJػz*k1U)'urzo> 2mt]8ۜnt7Tc1S7 ;]ڒvbd6+0¶iSӕ YYY.g9 Nc1R?HŮPp heb>pnu,r2$ugѢEfŊnNc1X9rTiwd=nȿU൘Θf)Va顉*,Rhxq>?(e֭U˥<]൘O,J R>:uދnGţu>xFxC-ւlpnO8(ߩ4KhE~nگelC*,jѥWnI_ګQWK8@#΢lX ;nTLj;cj~[Xn+]H /hg_f̟߫fkYI29)>2 ~OiejsZfh(Ag~tǃ` tԐjњ93Ӛf{#ftb-oc/S}}R|ܪvGpHV-a5jp̆ >t^F']~m:ZXWf-\ _NLAJmUisavRyf~6~ͺw8dT|p6Uڞ[QQ, ԩM7:}(Ze>tCюWH%D R` Hk9N7-~jm.NjX/Bt}2T\_! a ZO$6TJjU ;M Uea*yUn~.lɡ*8cĮ] Eӿg'iꏿ+%N1ir'9ڼzV&[b|U`[32;dZib8pz.xFMC9J/hs9pXe6l8r;V զwiLJ1bJ;w:~(sh89,N4jح֊ ps@ _2jY}!*k}\ZtC4Zz(>*!ȧq.&QWyڞ\VR9cĐaΊ4KP%o.Ǯ*a^;cġ?Բʮ9v][fioLG@gdRXP[$LrhHC14xڵRQ+0!jVMEv)_bA6g2nt}J\rTڥi( LHp=FLA vUI $.\f `tWn5)~`+%йb4qu:+)8q.A&Wߴ.9 ~fY[TCN>dǃ˵`e*$)~jjnnASl|d]\%9ZB[EɬjLj\3^cFҨQ4ʁjH/B4y*X\\5mFz';F*rRKdҠTy9{U%I2%4^t\Q$Og|f~]sGxpb_rwʈ_V(Ȯo>֊CO$袛.R>Z@g}MjvNon:Fbx;] ?|i#q4hOԨu?v'}x&NȠބ!Ex>)B?kIDAT^!Ex>^!EGkU2[pfuk]y-εU_aȨ>j/*^}yzk@\V{rh4^ V:fYpO_Q UTk낧bjxiiw6ZN%ױ9V#IyhDUP*~H6YJIUzԺEKU7[D/F*lz5dJo!.Q!IeZxukszh}_)ڕJHh: J+4$UimW® qZ2Y]1X;ūu5 c4Q [%R=:F=4oWmyKW1=کET.OnTN:Q=s'WؠGdxZ7Eҷ~7UG8T6_zwSZ;V=iݸE[u?Bj#u/}O_^/>{ %SkT}zVYyp>s^V-~ٴ^ ՘'\&٬&U}A =~{U/=_`8e^&GO?4Y;O mj|V[VSt3T,V>wB}:[7sf[?VKcLmfxFZ)]Aj'aNeOHР 5Ogw%"u;_I1׷o٪bCI ըd6Y]ڞťs$"^ Ojƚd]scw$k>;w~wH2ո$MbsCM%Nm,߹Sk NmynVPdkc"u2379}=:7$qjd3d2dn4PWֱqn>̢(&>B]؃M?zW?m."ur$ó)(H2%RqA ;4bn*أ}Pd#c.~ )p \zYŪ60NMakNu&+O{ߦ EE~ְKTܧ={5NjءW̯qu4RCNP'8H̊=dx!Mk7ܮEI/j^ |&ߑt#%fHE*:4׮!7iڷG #k1hzLL-L\'0T^ZVo0*TPx * P73s P;ˡ2upxf9߼On\[`UL 3KU[gݩd/-U)qHJ/%o/WHrh5}ˁFufiXLMh*6ӏ+zX-MM5W”Gƃ,M,j6m%$c<}9dNƮe_LJI u4{v~ZlG3@&G<6'/ӖuRN)z]ui3tdis&<o.W64nng]ONS]{WA*12}&?S~-ӫ΃d׸ow./ LSN.]'vUR|7={j sfFuSBzbιƧOo^@g&L`7u¼y4|;Wx?Ir۴4ٳP-[ncdOOr'27!Ex>^!Ex>^!Ex>^!EQ.m}$"[h_áVjFT1~QAa rOL2U醙QWǨ[LB#[}St޷CgMYU'PWt9M Bд-CRݠp5o?}S:$ɾ.5V{6 e]ơ ^C^y.ɕ.t/,CO*[ܨ+Z.mnݓOg)'ֵzz[W+Pxdڪ}T9#Um{[o?tRV*P{yV=l՟xMQ2IJx`v*sű}5\?~GоMS4lCor$"x x4[c,'ޮ2UM=\7ˋV;m.ɹvn~rSyqӺ 9`{2M {Uu?~~ԝ͒\*%~n(2NO]JOӺa}kj5*X f;Uku̠,a:Vد`&)(:D̐={g$l ]>|MMfYVYVYҺӆkx]3*jC(kxW1*V,j;e]i:fgjj?*N0u^9Y3w:mLW7'Vw|5Uk%}PsLY48 vSxt uqza L l5D)Sn~Sq0c-Ico?-W>Yc64VĐӢv *ZN{5n꧱c՜;տ{wܧ=[:[%*-Lk5撚.С/Ћ~yNW|?CWUPDEQ^(y5:/$$^]JTlenPjٮ>dKlV9`$CEУՄtdPqQxQCFYS+TV~$:T@'~4zj\mڬ kuCJӯxtdk6XPiKjʘEG>zWjŚ%ɤ&iKx%^p~nGbc$KOIA2]F* ج@Ua`Z#;Awemj( OnNR4!nSQY?o80!@!._نb RPK%%hS ms5#o>IA&yPB3f3ZkǮC- UUVWMQ漇ԽYS5mR&;]uh 7Qh1$H-u{N6nўs{)Δ_b;YÍ7j]^+MWb8m]pmMke;vVs}ռiS5m>TomXzI`p/0PG]0԰%}TV-Zu"Q2c} 'D)g}.xeozg N~G]~ש:+Re$_NI}?뛟 ߶,~hzOԩu4C}h_믿_4H]-yu.}T5fu IP—tsu=)XxNށ뮛_SZdMˬ_?_U_|C?V Bs&R)K>bq֯9^?ui̚_! gWkIזJ2Tm"SS:hZ%'dS ӞE %I&E^޼`&QGsQMKjAƞ}^}x6]cb>#6*R&?bԬk2;QO T`&jڴ[5 4?[uG~M׍#ըQKj~o'ɩuS}Trǎ_4wRnH.GWOE4װi ׻),n;7פ! iGo=_7䯰jI6D6Q@WL-հAC%HNEdi4 !BAjvϻx_{Y$97.Ҫ[Si„ Ƹq<]P/̛7OÇ?msuSPP I4)MKKSϞ=k/xX|T=XJ뱑:g*?v|[^y`-[ncdʼn7}t 8M8}z ~ҡzƾFi[a=Km_?it!b|c<]G-?tF}FOq"}A/B"}A/B"}-[%@=E!Ex>nrJu֭N^eggO>utHhMvO,t=(55N^}{g+W/Tttn6jժNÈ>PG $XQl, uM}Qjjj|դ#iĈf5~I0u/B"}A/B"}=]A8))).NPO'}Z.???35EE={)ԢZbD/B"}A/B"}A/b'zP ԶxMٛIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_side_drag.png0000644000175100017510000020733315203313266024554 0ustar00runnerrunnerPNG  IHDR94SsBIT|d IDATxgxU{w -ދt HW ` (aE"Qiґ!ٝCH ` yf7gΙ7{]DDDDDDDȑ#MINc]DDDDDDDndM>7z鈠DDDDDDDnh; +Iѣcό9tvatG3wq-X brM) JEDDw)ۘ2V}xDDD䒔uFa#I3\(H&Zm ?wpKLSux<)Y785SG%Ԓ|6$ڗ:Utʛ{1F ZMxy8c="""c]q]_~%} DfϞ >Xດu qBf-G4!Uf%t$ <] Τd,ntŜ0r'<ܬ+Mc$Thݛu|qH ŚL&iX&RJpNN&$b٧u (((lٲ̞=}}za(T>|mۖ{5[nnXDDXea$i5d(Uvfb3L,3 #k8Tr+N Yo{ gy^vl;@f Lc8Zd`s_" H{kw$&1-&Ԥ,n)_lډ8Fun]?cH[oiYWHΏ$AG$mCI8ץme>azj Q)P 5[u]-?E޻woΝKٲeώ${̙3P˴i8yd߿?111nXDD8#psִBzRH'ӞdE[++xS{_[\==;U'#({:ri̕װsJ 8w5Q!/9_zԬjbC z;1[@ݺ ;ֽ-,\y_VPZV=X|1AH'\Ç_q9#כ'Yѻwo UWuʀoHMMߟ}]EDD=-tLƟ>`L,:`zx\8~>Q Gݳi)!4ki:웿sie#T;z1ÛR+ؽ*Twܳ06ǀ[(q>$̺CٙD .Y˛ӳoG3x({ Wz4Lփ$9{JF,`lUسNR?۸ qybm'nRugMBmydS\&Mh^BZb"֌$15͊0abΪi$d`הNrvdCi/JSIJnHN%p)3)رsznj] t]I*S{/~TTe;tг ^ܙ⩩yI8z(ׯo߾+\||;b{nN*:"""WUz3d(Feq1 0tS7gÎC;K@nO.UEqxJô Ė`b׆}S tUr Օ]k̊5X)Ma֟{ojB6fWyވy! .R6X ZpGg$rƞw}í m_*R.xMO7Ik\7o}~lyݻ7Pp}WHdƥTiJ{ddرeZHM"5{JWO/Jd1JFj2id&\>q;)$fM.xaլF|DW&MTʟ/lgbN6ㅇ=3V\JaO . o\2Mnr'$ Jq#1UrX W<\ح)$'fyLx.fجi$'d-/"""o]ȵFzr<闺+IZb,iIZiN^r,F:'wRsaMTXc왜gg9~F*qR9w>$`dzn3"""ru(QsN""".%""":tքǑD]DD䚦D]DDz`K&ȵBH 8DDDDDDDnxk׮ߋբD]DDDDDDQ.""""""R(Q)AIQZU &M trmN~?B؋1gy,щȵ!DL~C5 >>R7ʎ":K7'2V~x K-g?~%""""""r 6=})<FըT&`o:`0}@3FObpZTTǟYwʑԼ#ش#wgpx֣<4e;wavz@p@ ǘBo4Ah4%}JIm҄1뭤l6vTӅ'Ěk|8R1we㷏ѥa*գ+>`$lӡS*54X=LXO6~Y|esl2yBDfȮ4^*aiC_ޗ*""""""׮n/`N|>m[__di;ʏSxl'\b_9s-T!Oѿ?jk,k'=|67qS~Tq.bpʇÉi6v}:k}ڽbg6 زޫ͚W?όmKXw0kAvp'#;[9o3s DVWe}l=yNs1r ̶ ^"˞ʊЈ]ěS y{sD^=ԃ2;RoGDDDDDDFSpmέ-yh4v<g~ >{lvy=fw7/ ڵ^*v-Cu* ;ek7!AEB)$a`vIKd:Xrv9~gZTp5AhGU ITXܥܽVB\LPg kLu) /l7OKl<|-%ٽa|~qt(%?TRѡ\s 7aq`s泛9;ABdϩ؄wJ$X9dd&8dT{f?|sp 7MN89v0#Jn$m[=/8?'¹ߩsTy{-^L1sW5 QU~f3:tpt(%ަM8paaaEDDDDRę0.hT "N减0%xe \Brge?,@eL6ֆy=8='YJfaS_,I?pwyyۖknʋ~d/iӉC8>[?ŗ1"Tw+IP&MXjǎ#%%dG$鉧'!!!EDDDTDt/Yw >>b208a'8~8˗wtH""""7|u;f?#_̧ZLm_O{c1+mcʘxT]ZQ zGWtὣhUs۩ WPsݣi +yK[>&{.@;o5^MXo|=X7؊j߾Ŗj%03v&q-UCfHUKcbg !$$Ʉݮ[^+f3!!!:tѡܐLƠA.#=|s{E&RX޽{;:kܹsi׮klf۶m4ir˜>}zo&"r94ڤMDDDq W~19?f &ϋH6\0$+, ۥ/`HpG>Aր{g2cqr Ʉl 'ps-*_fܪ6NAp2O8~xV=..Wmr3V{@_$""""rCR.zlB^8s(:[[`KrzlMlC7S#̹`kWt$?o'&gں'ӿDn AfZ JQviOsG:Tހc_d|Ss| )oql؞{'ʩ;iRuX6i`^DDD䚠D]>{t'}xjPu̧kgq=sS[q ,0ߖz[ewiF}{;vN/nkͧwcD6WbJE!3ӱDXBEtF0!e,aWSrdwKkhE/{Fօ0S`?2bc9sԍh< }rnF1=z/kO7T:jܞ2\#T_7y?+MxGjr}Jz&/n?:U[>U~wLہe86ʻpܞU"9~Վ =06kswN/Y' -ݏv X|Ц옷V/J!sGU 􀈈ΕG]D XԚ8a/mj$x~ex)6:/YȜ5xLO14YM?/˖~Xgгs cC%3`#t .~Z);O=h||6g&вtx;x$ڈJŲ ,{q[Fw&gM巄PB>A닿oNN89{Ӯ FRԥ1w`b_YH!&#sM\f<1y,/?nODDDD.ܢ NFaMw= |uD""""""re6QbB:<*H-]qM JGl3osE~7`#Vr$Sn (:q2MfTaNCZGdcx)D݈_㗜KM4-]!\D݈C;R7,*Z1ʹ-_ߺֵVWlVzm%~/FU+Q-<5g?lYД߅ ]f IDATZ+#mݴFX |g5`0}@^uEHpetoQ+SjG/?am[e׼9B+RIo=<2=nFXj47VhdY/"""""r:3:ľp(O=;g<ƣTgšڳg 6u(<`D*_y?<Ɉe5xg^{j FĬUG}u%nDg7 u 9]$zOA~|q?Kn+@&[疰^~ỷo^6+?~?e#oGiߪiݸbvDDDDDD:zZ~^YA#o!,~1\1[ @G* u.e[+7ùNVS)F,+AF߂٧gd6*3&vYyw&/kBר5{]6Cx7fڙpfLhy~ϛ#@0_L >{JEDDDDD{NW#)@Yξw\DǺINj+C)w!AAn$%`' d!":/qea=mbhs٣sʛL(sQb}GKn<1Q:ͱ8a۱c!i|=>c """"""7 pD Jg%iOׂ'?Rt"{)"|(m:wsޞM;yuFtE5ΥK^|8]X9sLI% i絓ٗ]6k_Uef,Xp'1Zu=Kq&""""ric~CE^g1tҲy,/KNwʦlQ ӹͼY8tCV}0]v>m,ei58??0p4-I6R:ՌOdet*B]̬F !-. tHV-XKQ#f/_v&V3hv"vCZT"^>v+Vxkw;>? _3,8ŊQWTZ_DDDDFռ}nDm|ܵ'S|͝OҭH-A4'b{N? kp4Օ^ 8վ؝Ĺբ?4xzy9yԙa#+14wAjw3%9^Zmxkƒ瓨7ǫ<A,'drgY0rU|mM(  MسU+d(QwC̙pgyn/MƠA`%Z=W^X={h#^v;9SgluHrFԯFj*>h_ϛ7Ν;rӧOzQ^ԭ[V.""""""RHVwLu6qt"""""""WFEDDDDDDJ%"""""""%uDH D]DDDDDDQ.""""""RibŊNDDDDDDSQܹ3'))ZnPx{{SJG""""""rUi~f3 4(jw!8@XXCعs'qqqDGG;: Ϗڵk;:C}\MV}}}r`a&IIItС(ɵiΝdffҶm[G""R(7of׮]JQ_."WSر׵gh1t*ӮND"R@)K^;SҼa%d5m^g񱨨RX׏ͯ%1;;nCWأ@p񱨨R}#n$a]tz !.,o2l7?)@k^@y;L|kQ~G|71.*DOx]dt^usM[smQLmg)؉\wrX5ME-G Cdnu7-LL=JU&jQ.Z?*kz;_ˊͼJ:=[8fLx d31uTj>8ej0:kB/י!u'SjC`TAIlJUOS̉)-N k4§|س5D{|8%U˗rh@"}Kҽf A=yf5+Q6< zx;֭w^ k涉HYekSyS-ʗ)K}=w5bGܲ:!e)tLEEp%::_z,Rn-ٺa$I"SͶ~HY,n+m ZT#fhug{M^ek&d֢B`TMWV`dVvBqtӕ8ځo#X Ծ>aPj[nAӴE 9wNo؝]o^فje)_3O-Ҁ>VaBPpu{~5v~Q;Ѐ=me4(uwh[)Vg\FۘI>T\pEX{{Ӭ|MBCҘo"nd19<վ !CYw;\Jb،x& VFK~}N\\EK\\%r^L L*n5yv3鎋JZb4t]C7yW Ό%ݜ `It\,V'pjhތyF9K3`o ً.T.m4U1R&#`֏3壇hV8ʎ8ӈϸ΀{ٛrv=ζz= ̈7vG9kZmy%6OcΓ1v,cOy^'s3;8u'Nai;e~Ϟ`gyzqr\Յi[qdLǴM4Ȱ2Izf(Bmǚt_/'s_˿r;fdؒLp>xaIb|iܸͦ7n#0uSz)=@ի/(/i(NZJHI!RRb+r2yӲg;2V^GV/3YU?wԽ?Vbi\ֿ@OMlɒw1CR12ՂK:4SSſ21\SWây6B=ed_xMg_kҔrs0JQ};J*['d$yyg{1j`Uq8wVhr0:a8-=rpYEEp{t?_;k>$dBөa. hہ5wJQۂ[ypp6{-Aӡ#hc xvL9QnPnTIxuYZcH;-P~gZ-C{ vCofm8Wczܶ?B N4}-.9'.Oz ghgݜ{zےv*x[r^**PXӦMڴi]>Gp}ԝV+AnunTIU]p2v<ޙǽ_Ef#3qE+ `#-Nڂ(z ]L!\x̩9oM0pdEŽ8OY#LU0Ǧ-MweMoR  [;X =rHh^3e?ͨ ?L똝`u@D%9I… $EH'1~V;i)k6$xH'L=z',@)=|!yt+|@33x47Œktj~8JaC3&@ ~{ty p\h>>眿)ٯ{u䥱i?z::}d2aϴcm/Tv#bIQ0O~r5).wަM*UDŊKta|:3o+O|,_?$9"rix}x>['8<:;GɎvpW/UD=s؎tz#G>O&uaS[bzt+[N`lj\J s4F gCvL`Xms1|gNԞmNί3oz=~#=rn~ ;|F:3b$%ygGbVzu5nIJd*jH 9}yen҃fjғO>!|Q^\NڱI60{SAU|lV2 ;G7VR O7?Ɣ]'gH>XHl*DMT_Mas#0?N]LBXބS6'`'?Mn<+\.w֜Y([Q7p<DZe/X G<2:tK 4goD`'vvşDrXC(Cxt 5wgLՁHɉ绑4)}D$^DZo`ZcL^vSߎ'VYXN>#kP&^㯭s۱ن\>sfzi׈RQQ:Xˆ}Ҵ9e/=MzV\$yEtLP d$-' >W3๻I yьКvz26 ,yGyԕS՗pw5Ɔ5msa|1) jp<>5z_/=jn*G7J|t "xC&7]ZYmz6㭤&B~g=N0s5ʖ)O/\FC~_**@ÍAIe+VO>ERHns̡sΎ+Vгg-;bn'..3_v׃yq뭷býDDlfҥg\ԗҡ O2Lt?T:͛Wf隡)"%xTDR_."WSQ7&UWeJEDӏ;K}\ME8*s:%"""""7"QfӦM4iҤ(ܦMvt kԗt=i^J8U)ʪ7UTqt(~~~"D"r0vJ\D59# RDnP~~~޽5k:""eٽ{lEZca1br"Rbխ[;v?pDD ???֭PJ"rW7^^^TZ"*<%"R釮ȵO}\ >UEDDDDDD(Q)A JEDDDDDDJ%"""""""%.rO\OvQdu9JEZrt""""" Mm[I=M}.{72<٬_g+"""""""hu.& / +>ՆfZ<{~)ӇiI (:)A(DDDDDDD}j dDGGrtό˧{1n"ob<|ˉ(3tz_":ٻ(ʵْl:%$ޕQD ؎Z9vXPbo *P@#( ! $޳:h s]s>3̽dw}0$2}Rǻ`جl;={O5kq`ggж>1Y>morkZ5vtK?;dUV-؆xe{]a?al`X0LX,,fFow-s;It`7ҩ!k5ˈ/Y=vmJݚui{[,?+Fdž14[__a7g76p J {T[E#_GOV}< [-=IX8)Ӎ-n۬Yd?3۷׷nZ!9 IDATUh_ 6oڴCqqpCՀ7}4#:m:!6< KP䕦0rȱ;I9.2E &K7EԦhk z5"j`ޕ.8` \~ 4[i}ZL;ӻB F@Szw$eo2NwsFwcSp{n6EWQdyJEDDDDD)dz'FɇȘ1 :Bm>ۧ+hG.A6;]Lua!]yn}!a'Z-V+A 3. \$.g;#ۺ)ӉDDDDDDb+D=U?Fjia5Fo?;'dnvOLL*6`Zh4f/aaEh\FCrL<_'""""""r6SILNOa 7@Ԝ[~;Ú-)'J2In:e:696¯vk _#7gՄ1o"6-wq?Mߧu)f3j uwާ/Z4o.A .Re)EDDDDJHɷōՙ 4|O`n0Ϳ[r 6 Namuech#-2c`zԁݵG*q&n+qWm$T&iF6Jԥ|œ/`!Lx#N`~aX%zȸ8ڵkwu۶mK~dusc(s#+5<>O9?aM/o7E9y;@J4iy_ۯ:"b\V <8CsD"R~;lOmxJEDDDD.LL&W+0axjx3ǻ(!%"""""rK,͵3l ۼ\Dp"r LfDDDDD<kQH)X."%ƝG+1v7`X"""""%]DJL|s =D]ƨ4n*+w&+'cKnNO'""""RI)Q WҶn@-]4F]뫒xb>}wÇ`?O%"""""JE*+ÏEDDDDʛ>wܒNDJSx13C8\["O%""""Ryhz޽IHH ;;ԒZ*0l6ўr@=D>[qѭ~{EDDDD*M0LhѢ$Jnǎ$&&P**>z7G\Zv2\˴[ /O)""""RhM=JJBCCY`èx$-kR+,"JtKiѵU ,h+BfW#[=H%YE*+s}Fp}nO*aOp`wÿMSTZ!=^m2ـzyxu~Uf0{d8 M:Tt."w7*D׫Ky/3IU\DKR u7qc*ar}s^uC n|aVX}0W^~qq{tX0?Jp111zĞ(Dp)/ }'\}ΞSJ]{[{gV#[D51`ՠf@ %""""Rɕz0Yy覺lOWkz/u1yU^Tݓ>)oFXx {~"Ӊh{|)ܝAܔ~ct/5GtQ{-ǎWQIlg{P+W|8O0yc~SzՊZt>7^ߜzMCJ-z ɻlK ݾDuRN |0x+#,` _yM営1kiD48oir Gxڄ{: 9RU!vn!Dٲ b̧mJ#$i|0o`ZѼ7w+D.^['slA~sl )ODDDDr*1&r3opʦeao5_0v\w ~ ί*Pd],c^zs}ZFޠufRd/>TE0t|'&4 ūx'S Q.""""cmſ>}{u$rX.n/Fc3;n.j"o.F6?pt_SM';wCwg] (:~ ."f CH# -G2i}z]G_MY~O|d.gHI|8yjIUR #"""""@w"SG0N,FcEDDDDr ;(((8CEDDDDcX (.954뻈HS.R8u[;%Q7 L+EY :{&DLHecsܩ[yx}-nz!zz"8$uǚ^ooZ=Sރ\Bzٷqٷ=,WمuD!~}xM䃕om$'"""")%;7ZގaV6BN]ǟ9 Vx7%Fvo0}x=Z咒ƙuG+Dqpq2y`.?U [ԍq5ov̝y޻ז6R3f9%)SLYs܇IZ j%{rő}%҈ F==_a޺!4)J9ݹo4{wve;֡N+}vb8o }Zգv UiĶK.㧧}ԭG>}QjVZ1mO+ZPv3=?S'vo.zqahޣ 2 6>-|oή0m}b5*}N{EHŕa/-ҶMkyzy/WOߡDN,I9ۤ"""""RJ/QEL6a|fz{"+5fﱤ|,Ύqy}N.$1< %r:#HVh;sl׫8?^ȿz_ l7/39yrFݮiqhx^ C~`CzN?`?`Joc>0=>Q4ؑFUԭbso&(£9sc-WоMڶm{1f{2Hʫu!&\UPc<۫cLQ2oLDn4>HʱFdK }55ځ.eøܩ,6CG.ĄMw%$1{Za2|3Anˎ`nDZ jU}[?jzIdv?%QLݡ_0:,~-ū9Û7BĹ,*mM~8S؟@dKy _jzGM%zEQo/?tl #淉םnNfY߃T63}7|x:)pJǨ_ /}42M5iT/3> s,#Vepd0},ՙ(`O] hw%?{o/"}t,*AkƤd:{I붓6oQs&n!3gk:{W჏6ߏY. IT'k\"""""R1j<~+97͇yb /5Lr3Fg1E4 :G|z41ڲdTb6^yAIynڄZj8nWb/&硴A]烕d`-J5iw+-<< cq%#QF(7Hi?k5񿈈Hg?=x`O!rI;w. mG^{5&jtˈf\>0de󞞞{˗ӱc S5j M8N-εkҴisn3hЇ=Tߴiݻy4iR)`kbbO˜aD>G96 ?_|}|9”2 FDDDDDDJi}unM >y,^_LW~bBPOh $Jg%"͑cW8skz}GAS~bb"1110K)~[O)!l .gHm|8y]Q.""""r%Fprk JlR7bꈶT3cƉw hGHY2,ٛ>؝c';PVO+r]*~#N/p߀T-60]cEDDDDP.R 3TG@μBv'QTց捧☘;e |}n/DDDDD۷EzzzIW-PHH6XOR"i0A&LE}]Kwoƭ+&u.""""%o߾LVJZvABBBIփ[H^ ׍B)dEQ&뾄Vseg|K< uCzUU|,)D,zUUʼy<F0j_o]'\IU{I* XjzKߎԋ(u _ݙ쇚`=%"""""RJ4QWww)-2Y +`gcO(ex6{< ťQĴqs57L]DDDDiRg,`!ڷ.Zm"mRWgsfiLӪ' W )eYERdz]SL^>DԸC$,Z曅)t"#RwrhWa>DDDDDDDDDD7"""""eZ ogmO3fڊAW7`_nfۭ~oi޽O_ye|z^~X7iO%X}?Cvҷa2`>sG_\rZ9(H{ӌSͣJ{< cXHӛC(]jILCjzaO͖m,uqUr\*WU^1~xKs2hР ]pe{V>O:v&kًO|c[FNE롿hc#=I@.FZz@\;0$gHNlsBK780;#i?Ђ۝I?=&Z#GDDDDDʜn sݞ˜nxXύ|_r[WOH4oIcaBxqe&J6OZk|5])|Wk@Øp|xuέJEDDDDPluR@nG+J|*K}Oyy[|߸eT"""""[quCF\0ar9pBi?v,DZEDDDD*'%"6u}]Cuob^'{اH{:D*+KS}3}`Һ\uU.];?Qx ѬKO8,"""""r1Ԣ.Riz5;Xi {?cc5k"v.]N[gn6[svUR{:)tmȹs!:%"R!{~'MbΎ" NFpmI9K α3]hآ~&Q-ilC> lA)]r.>\t}ȹ(Qt\tmz0ǃ)bqk\"5 2rl#dg. """"RqiHen)_i3ókhMf}:->@V37p?..d߇T(+VtRNڐs!&;%"s'pMP tõ?tt| ٷt:s)p+W>.]Ov/KB?%H)pg78Ԋa a:' }")b"69.-[ّ̄7e1XCbQHvCqKp&k_ [d7%m{Hg?殌,DJ*W.bi"Y3J`W):n[S#Њ3\8È3Kxx8v15BǺAD|)("7Y؎Șl!e:RѸr!v (8Œ ε0)AD"sd "XRCpoݙls+a-ve$'(c_$YgEJO _~$&};e;sMEvhf_%[ٕuZs+#UI/8Eaw`OzY,NO%eρab>ѺeZ1;8Κkq ~ {i*4r8<Ռ~jkM%=jOT@Nbׇف6\r֑nl;]*ϰSYU-gd7n~Ow@"R ,V NͶÁӰ`pJƂi/L$-+30"t0~iȮGQBnnZQ""""""³- x]\G<3P?_l:p+wm'ִ~&[^kYT.bǴ'Y-j;'}n=R#fr[NaM5C{/Ai;6*~+Vm pVw{cX-)tq]ƽ$'#$ydYϪUؕRyxӑ9-?+\(< Igƌ;S88T8Mxha>dΤveC6mhYF$ NM[Mg%xd%&iަ9ujP;B@jՌZA."""""r>mQweFuAdg)'Y0ܧ${:ţ/צ3wHv5uUvyeݞ,QSUTq+HwVRiuv哚V@PH @B IKvc-gVbmB&5k6T#*lYvX:^G[' `u(YEDDʍi-c'~ͩS;zM7l+(ⷻnkj[cP=3uU&Quqd;xszߒ;'']H}:>эFѱ4qrc >|f d+TD\si=M~&Sܻ> 'Aߚѓ0nÑ.<}:5>yy@^>yGJ-Uzɧ7U4;~ j7#4 PZ'uɗ }Rĸ]!͊o FaŪ);%""Rnnaf\L .f?&p#o5'b}ZFH\7dMᓉp%; 'wt_;}?~^MduE,-@C\־|=˟łc _^a_̏#f04BOe)o<SB<Kxe\,O{."""koL[لac{i|0|l6Da2t[ctl_Oܵᘀ=]яޱӝwfwJ^M0Mu'GE^ {\?I|HyJ;DjJ^͛XBp`` 9qSLp/d3sKx"SH!d~$7=v| .EDʥJEDDD«ӑfsoSY`(Ϟ` 0hFxh>)^]iI#0,#""|u}t"""R^&3F^&YE`ևmلedW:oqڞn ȷEӠ72Xg,.'7 09dd Ҙ~j_ 5Of]kSSS‹\j.E=$$u.& EHH|gO"""5\y oppHZrj0LhS ¯GuZt~?cﻁ?NNF^SuO۪Syd߿jժ<_ Ł="""B}eH^_Kӯ3}N!xnv얍ߓid~"!:ߒ9x d 7'""eXoիIOO/͘*l6O*U8x w&778J*EDDDDDիWZqH1UV=F""""""R!ivrDH9D]DDDDDDQ.""""""R(Q)G#JEDDDDDD%"""""""urDH9D]DDDDDDQ.""""""R(Qʫ /Wae>?J䲻?gs*9vn2~4Z/U2r-w=D@Bj_֒sƍ_0k UBC՞! }aF)qt1S}\yrd.ǍͫJtqS0-Ci Nlߴ *4~<*yQaVUn}zt/ݸ3Ԏ%4"<ӫKgȘw$SyX~I,H%bOEGxiksϳ sEq&[X|:Ѐ{3m؞d:Qx{U抧ہh:91MhV p6̖qZ1E1fcTjԂj` Of:gLDy8{vgt*uHѥ]./Q;zZzjקƮDKA(_ɲʑ8Qs}nzｙ{de3鉾sv>^?6U'Ԡ<~*?Wxcd/T na|^c)u޿6w&Zb@ }@{Ao_OL*Dk+Gr zkf #O^Kq;k1e#&[1v:{;/lgT;I\IۚPLz Xֳfc"܏uH[I\Z{ ';_?N&鼽 sڽ}M`KVLj.mPwY@ł31ż@[:m㳑|QczrF"m＋zeNg*kx6v'mZ>뱃g<M?rs085)䇿=$e;W竄l G&zI3Єoo{aW #douN\Oݗ 6/iUdHQ=خ#>C[ԉC$9 Q.""""""' &G]}/Zݜ?SFN|tegZ*ܰirTВHyϭA>?9?]x$~9Yd9{cFZmC޲c7\Xa<?fOвHｩrgi-;0 bEXaFjW5y̘MM?rkH"""7r'BlX`KgdP55 ;~?]j6t2ԍ9McY9W` -mhWΪie$X0U7ܩ,=5 >"{}"u%,+Cuo{ӝ4m5Y ގݣټvU\rLz]BD]DDDDD!Pf[f`[.@;dCպĝ̣eWxo"6f/g?~}̛ZOo߱ b;mP{ {+S5kݻ%"""""LqEj,)qsp>~*!JGx?ƗO 0g62 W1/浣FS:p4T ߤK t-o|~-jIb+ñTJDDDTrfPYQWMO^ӌaKǯ~D0Amxd|4B%<{DW3a7R9*LOFg#7s׾X͑}Xڽ&mD&Ì>*ѻv41q\Y~ͭR'fZ;֪HbmG7 :x|;۩]F\ۙ:rX̀cZ6%p ѣC:2aܹ<L]r%m۶\v}؃NKGܢ83;7\kWgNe:I'2nq]E%f]DDDDDD)Vbp!|>ΫTQ.""""""F%"""""""nDQ.""""""F%"""""""nDQ.""""""FnٲeADDDD-_!gJEʸ֭[:7p-s `;uRb(._c„H٥""""`ٲeL(Qڵ+EDDGCEDDD.a%򳈈(Q)%6X(6<== :a0dݻMHM-hEDDDDDGCLA;(LJEJ;:a@N-|FWKMTymB{$뚣.RJV<1ttwlnʱK^DDDDDDJEi5]čٛgnhDDDDDNuUǕ[SNDS]."riSOD܎r)K\]kQ\X,n=31^is[!~6^N?}3O|Y.Q)+DZqb/ףݫ(( F aGkS7׺>>>U ,=njsOT%|%!ThKl/dճlen{[EU{RʥwUށԖc>6_Fn1;R>К;Ge7O-%UbyTa|YM*j\+)Q)x;γ?.fuxMb3*pJ2w '+ ߦO2|ƒm J :Gg}~gҹT{ ^ƐU QWQ)R yFyYw$}ś؃wvMuÙ?a..\ݣ>.rYߞr^V,=FwWkOKG**,D]i ᅗ{p->9o=AbGb/.Gd’=1Fh@H7nGw6Q?ۢ&]]*5h=CނGu3|vnyc^vƞq~ Ԙ"juS`y3M3n:WJX5N7o+ߙڑU3c>u|~~MYwLE;i_'*M"r8Wԏr:xf6}Ox3l)ƉޒBV?לϭ>իafQ87frּ5Rf0~@hk6 800i|կ5OMÝj}'3r|hQ b'4MvrcŕK{ك9=B.wˍmcj>\].TQYxIS.R_ouYoaRWySP;w2 ˜ 01^Yҗ35џY;p e?zuѐR]5ʹj//%;)l%'F|v7{gy,O摿^6slmnWHMŒy3y8eĭ)!Sc+}sEwY+|^LXu}:s,Y[HM'?瓍}goxoU2|@_o'dyG^YĎ-[4A-p]G"KŊ>}9)O%m{,+ޜ݊'kV(dϠv=a-g<یGG%z(_|5g.(B$Z}ͦ}HMojBLhtlK.w}]~&լiLh͕)ANKu}`a]ݖ42L`AA\irA4[4Ydz+SHw^yr~7Xw՚bUQ)'w].Oy _>9w>uH]kЍr"7k\'ExT8fqh7z?4 3/ bwZ9TTCqJ=^t{62NҸG1 jǣ‚1d?k2vt=3azLJaĘ$ a7r;5?pfJd]< n8OZwφa`jp}{ϛݲc])|:˱Toʉc8Pl$SA9:823pab0lOa`'` ½9ډwYRNl³/7SѨש& C~"=4tniӰ #B x/ _P&R>8/)Q)y}b`ਇQ%G`xՉ!&x3`(7Od.=yxQF|8ug/0 pz֥Jx(>U2#yLF}H~Ո|`܃T]6Á qLJ|6y?~E6L_OEQZHg_/dcX~T :ww% h1o075po6/&R~ԩSu'7w |k>4u}'eرe7/<Ϩ۸]`fZ )04wG) T_R ^w<ė/u$07r JaeAsi=~ q3=75/b7n;›OLz6$~~]2{2O\ĄG^fms7v3nc3G:Q%"ꗽLְ7۾;w%ɹӺ;g('zbbčd}<4^܎+:g9c{>4~=n~',2?Fѻ^*GUDzy98y˶ssާ[ܥum76~#DDDM׷t/u-f=z1tPW!R&̝;}^Ծ޻_'==v‹R(?NUW]á+"Rff͚ur).T{y9WbSN[n5G]Dܛ\Τ\DWYJEĭq'"e3.u樋[S/EΤ\DWYJEmp8VHa6q8:\DwǕ cӦMԫWOqM6)Q?Au5P+QհaC6n_ő#G\E #,, :\DwǕ[SCWDS]."ri껈Q.""""""F%"""""""nDѪ"eʕ+]HԺukWH9жm[W """"R,[ew7D]DDDDDDč(Qq#JEDDDDDD܈u7D]DDDDDDč(Qq#JEDDDDDD܈uOSG5=[϶QP+ 9ë'Ê8J1dObuu"däէ_C?]Ss ;KcǎUV~oٲeɟILL0 4hPDDDD(Q4:G/e¤\uS,> >v;=wR`i\ }4:J׈>?ɜBe|o6<0饐EQ1-Vl]pLE}`~|]S.⡼+գN1MAuҷ4ADDDDܔuTl9ACDDDDuOepx\JLL$!!aR. H@DDDDD(%" /Naͮ42:Y:>D]SǯWel% #K2sHTF9?\""""".D]SpԔսPޙd:\S.⩬_Jᩍ/ls?ACDDDDܐV}T: >\ٯUD,淎cP~6 -PDDDD3)QX&B;ҭ702Ƿr].֙ƕ]\aUs(QdY f/Ȟ6vN[Qk$J"""""樋x*(ߎOOg 5kRْgs=39b┤\x{]Y>O_3OfeXRЋk}\R.LW$kLA1T $䢸Jna7184p8KG]Oehx&f5^/Ɍ5(Md+ Z]DDDDGvD]^:CDDDDD9"-}J2IٮODDDD3G]S,ah/| RUEDDD|x0K^v][[\"rnjO'exD\!%"˄S$߂d:]樋x|66?稛9""""".D]Sxչ!W7樋 }T^m}|2v琗wY+>> : qCJEfu߶TuS.l[Dݞ;^JEDDDD\AkYNiES=]RRqqq%{`rFɉHfLmYZPGS^V}Q."2ElDDDDDc)QTS1Ќd:]ބ5~ӱ˙IHHpu""""4G]Syw5xqz19ً DDDDD<uw`Yʱydsi-e^NV}q:%V^M۶m)((ӊau"h\DƮtfr iqz"U};}>srJM&V/ vf|J99uhm۶uΉL޴R))|0z?\s8Ϋ#/^ goWΎ1pCtsfP'>>!R.=XGؚ$enm(Cm~I|9a/GbH>Y8WWJr"""""Uţ^oo',民m%4&[Z:ߎN%K-noWGqEwc ZXDח/)Iw.""""D]<ӆ;rXDۮMG3~L}goqagø`~ yfzhJix4 }`$qZqƱL~VvbOB+ŝMo/" $*T09!9uh\{!GÚť8%S2>֝>-D]<ӆތKIgpZ]DDDDGx4 }8ZLNۘGv%~um_]t!;s %|$J"""""uhNn;;ÿfӋۮkK}'t+A?Sbb"aW]DDDDΡќ;&B :kk/5}97ʧֲ?3(QU-tVϺaW A-NR7a=Ĕa-`2N|9"""""."dPHJ+YdR ؝KR>WssMT.9"""""rq8=i}/q/LVaJet:W2qrUEDDDDD]ę|L:@{F<;ˬϙSŽrSeӷ)~Ef˜,x8yμJE.A>|.X{GG8Ux y癱|{޺|11'89&UEDDD|֫@D +cOaSKO7ݐfӹ| uP.d!-j X6B`ZN ic/$^6}n㶫"uZ"""""Rug2өGoҧDȝ]-(W7;nKZ>wg#P """""R”8ً<{qsF3oVoe zz8G8NJޣ2RUEDDD|3}(-}Vܲ"۳9pOÈ3sDsx3cSԣ.LEo+C|DS3ofI-g~At[9;fq PP껈"NVrO'26@ص3,:}@Mb -6a6MT;"`{z?t{z ɶCצM4DDDDD<u' Nk*Ӽ/&lNgkwέ{X"v=[aa6ΙFs v"V5ө.$^5x0i2 v*$w1' }2982ع~'Ć{{`R݌D4iw95EdEplw`;ϾؙS{tK;W/e;*絡O)!"""""DO\G0o wyk6M^%{\\\PDDDDR. h}]3s83&/ꏘ櫖3oa ~tADDDDEq[&G%0q0Rɴ{h02رgv,AQS5DѪ""""r>jx* omέs+P/.ߢ㽯 JEDDDD\ApOUY0%CWpu0'110hРC7UE<)#@DDDDD(%"ʫ5w9'eˁ N."""""ΠD]SƨG>ㇺS/"%|?f:@Ϥ9"ʧnHus17o7>^EDDD\`رi6d a0ʦcf|v-Oq?QMa$ˆHuB˘VKue&1K-Uh 捹eOSrkvg3c(.cgb/IHHpunaծAܔ>r!|ȅ!euOY Ӭ0%eyxɩAkٌ_tS=U/FRRC7φ\>r!|ȅQ(Q8v~1]1/3M ny?Z4亱 #/LG!'w%$ċcNy """""樋xF@Iw(GfIlf!]{sc(ZϨ@,^l6 ,, -runaժUAܔ>r!|ȅ!euOcEҾ  M?{ 8O$ͯL TDDDD#)Q4>8W!"""""R."Ƒ͋Yrބŵszw8[cX6e[g ZNtj\.,8+b۾ 4j-ьr.7/"iԡ -c.HgY]+vzݙ*գmˈ ,f%#|.xueH|k0rIYe3WwjM Z#&q,j5qu4D]DJ7 WP4 f,X_뚇iexbu1KEqk /ɢX]i m#d;NW]]KfXvU ܉AWGcڷ Q=sg*NgϚ1m|97f-Bp 3oO Jtkʹmg8faRJ5|ROgΟU5-YY;Y U T$" kn5&> 5zkc'??[ʓ:H再cR!&uع3ް=l+49isQ$QI f3~MbwwM` Ƈ( #1עI\75"vsіʆ M;5'& `2R]|;Ñ-"`#<<l694_۵}i?h(Ci3o#[si19)&C8v8LJ929J zs l(>ALC=gg;G2gGe:lF%ux{&-I6h8Q@PT`DDR398qMW_׊v(!K'̀-YADEbDr N|ر͘uavP~& Z5fw;oM2!qcjR`"ZMBͦBeˆXW'T&f$i s [Z2fHY;0pyo mf ),,Юr\ճټ>\I<EllN7iԛ f 8#ގ9&5LIlq Q@ƍV G/A+Q;"߰s,y[#G9vvA,XB&8; ]rz7H"R*LAtls3eE-ܬz ߸vtH>'@T.tF.SH#Wh>\st^Ӑ(iݙZ /pU^.q0e> WdۂꃟNMc|W8.Ҁ sHٓK *VI.wr1UQNşog8;Jʾ@ Bueb~` F͎qcѣGCuu"eܹs۷E{yngl/<{`ʕm_KDDDDDεl2Zn}v(^Sҭ[o-""""""N%"""""""nDQ.""""""F%"""""""nDQ.""""""F%"""""""nDL__şF|x"sKt|pE|Q‡>ɶ{d} 2;3fODrǬ;f{fU9HD]DDD q-X^yyye{ T}\ (r~7:ppsd6oC2jUNx_v?]'quˉYG-!aç7ѢZ 'H_4GlH\\]j׬7fQ(`Έ4]tW4fw%ԤVg~yS5D(=?6]kE3| YX]=q5pCzTN2{Cf&<Ѝ5b]6My_Si܀6/+" m5g6o\SK/PJEDD#O;D-ΦyruLۖLrr o.yjŶ|;zʯσkf?Hϟmrv7?}3<%m`-lw A.&&6MxSn~_b_3w4oOM+~gﾣ>ϔTRI !ФwP@PP_ ޻{G/RH*H{BS$L2Z{̙3<3ٳ{Cppqf:8yhzvYssq|j+7/cL4Kv! 0ҟylv,}6STmN8{}""~L.H"##  Jwq|sg]X5>tҀ;viXkf@@F17sYYW7,DwubF\wsk 6ġY bXW7in$O9cqa|/(bʅC"{ \ۉ Xɓsmw&#vÆROJ51,J=ty#""ETDDD +ɺ.Ž=_]Er=I80yrXq܀y|4 !8zb&3-3"dž8,x;-Ttb#b%BSIsCıjVA'߶`>%]PygH;?0^_U)bcÎgXЬ 2]eͨıZPQ( 5"""RYztb 5%ɷr<29 DoDo摖~tãU"6&>eG&ƃ D]DDD'[nu5ps(Fu@i|d' kۑFۦ1aEdϟ2iǑK:}&\@\>4)FDw^x yV&>0[6 )0oDZ9pcʄvL\qe5}1koƳpvDD%"""Rn\(/ëVK[n{Jv<֌zэyI:o{M,'^Zo$侵^Cg5皎\./>?oymt%VwϴxǠ/Ev }r$wѺo)z5*neV<գ% k≃ Q;1q-k&4ۓtR!(3ލە勈1zhsСގCL={6+Ҿwܱ'-- z8*K,}X"""""rEѶm3N*^I&ѣG7vX%""""""">DQ.""""""C%""""""">DQ.""""""C%""""""">DQ.""""""C%""""""">DH197ǥ-ocF xOgjU@x\3LǙYhp];V\6O|[U#"$Jz8Go70z˘A'm?r6z&5M+^!]gg!=Fpo\ٸ2i)u} `9)`.çI،6g,ݡmETL"F~sa IDATӧ1),D]DDDDD8T&=i{YWo ϧ <{s]Չ<%s^/K8ŠWk1m#LL7}uy%o5i[.cwp0 wvߝ< xfnc%+/>mshoNW|oƴ[>eܩIr;{Y|?0H.XF5)"[+C[&pyx-5o^+x%5%""""""`&O˹MzM5,d2wڟUX_ʤqA\4~qS9GDnx-#L^Wnjf;R>!V)L!>.VXӹgfqZY"hu\;~ڨ9bY8pxt~ .Y wq$-:Leo1㫁T?p&iiҊA`D\@Afc5Ё}% @D]DDDDDcyt2c_7#9dlY#+CH$(FMK+9-a&{9a2x8*UB.xӏ|N]xCҠVm.l{1 pp<L=l$mMŘ\4uZ^Co㴘\xDy#7o晍ĐX8k Xuw~[w}u"sVz[3 BOV[CB&YqQ]|M5*\%# +AW$mOʾ||V ~-4 `Br9;-ht,_tgdbË,ݲ=)X7c]?&S^۞YB&lԯI[ JEDDDDD$pa~!瑓{"tPRТ4/J[|b TD.|̡kFһFW&FP<x+3oG A0,Tv"Fh\f.9y!T8+$Fk4!=͸zUX *Gh@@L+n}ZekN.GY%mkFSkU\5zs= @X3kAHh09YG&Wj 1MM+wuV֥(?D”WSz͔I}%n~Ag;ۅ|ʨniauP}ٰ&g>1qca6,VXѡr !s-UwFAP^͒t)\ҷ 9Qn~ays^&q%ϻaK] "++܂cY-_omnH;3yf1vK0f?z׶yNyJq;LV\qYawz''Fp3O ;oӘ9.p$ŸO̙u֩K[gWnm%""""""JPδ0i&`}͛aC#QQ=+nˬ7G׆xլzDFXX$uvrT>i$t`×qA|49WTނ?ĆU㊉m$ZYk1ix+P pUsFV MLO|^Hbsûj4@՚x6f܏\{A{4gO3Fm:q gϦ_~E;V㤥0aBS;g6K,}X""""RLf nͧ]enӴ'GsR'pCVKNh"ڶm{v>za&MD=λرc{JDDDDDĻh<|ҋs3_`/* JsIk,/LkΨϱ߇ѿFDDDDDd̕ގ0e YU7{;"ӈQ.""""""C%""""""">DQ.""""""C%""""""">DQ.""""""CoѢEADDDDDJu2m۶ADDDDDJ%""""""">DQ.êV=_#+""""-J8:KH0ٳ8~{0 Æ)YURz"$"""""լD]Li6_1v핬L]*ukH)8.M'#0 7СVvݻ v.(EDDDD,OQڅa1uRbOÀoqPT"""""4]DDD-Zqt-""r6JEDDDC%򷈈h껈H1Y"uRtL%K,0gi&"""""@-ر#~;u)(Q)%ScU/"""""%oʕl۶v;0tR9uRdICԢE ZhA͚54hP%:H))tw)Zlɫw]*+Q)v1yR[H1dzwR[Q.""""""C%""""""">DQ.""""""C%""""""">Dy;sYv-iiix;"&** z;\D_hǕZv-NN:y;bYb֭Sr)ݎk껈4Zh0DDe˖z; \D"oQiCD4#ԖHYv\4uDD>""ţD]D|:x"R|r)Kݎkш[/lͧMaDMgWFa+M%=~gE߆rv&ш9|'iޟ\ohD]Nwj&܀/2u͟ gQ܊[^zK\/οO \&\r:l*(zOY)uvKlI6,C'whSO.QJY*ijt-q[]co73n6Pј/0/-,Q[OWm0rq7e/+o{nTTYIHY،߼<+x_#+tF\>Lors՟H_H3NH7ȟM=.7aSje*WIo<>@:7áol4}LND\+][v0Mfh$&TJN L3gnmp=o|2 Qr-%֛oJݸ$4c9~|~z>jP% UO1ұ^6#|AUb+'fr]C>7b-q쩖|jQj~cc!g lUi9u~O= sQWӪVUnɀ61)|qU[wMt[{L!!VQpIIIaʔ)g-.=VX) կ07>Bj |}&}_y6 3=V…f܀yh*ocq,~eK.ZT֐%tK3JЙrjmu;$1 i# ?**x/iJEʁ n|E^9Z Ўgָ9dt}-gocxh8u'/%:_bJc.9Ղ==T&k6bZs3Ys7meљfd>_v _u~哼2# pÑ>o1/xufE31Az1v/ʎgҁt<˯|'. =(|}سn:o_ߌpBzԦ<>ꮶmIg巄JZ v)Q).יMhqy{*1ks 8+}bx~I;]=y~U\6n}/MN!TOi|6oQ:jR7e)M _^UTirn0M<,DwJ}86bÀI01*^H!ޞ˝̼khs4 oEabNL®n3YAԼ>LG֥BXt%CZN:عYsˉ=rM/>3GxץLV̀я3+3'̧-w!ʂю!}+1o2ML7?=lZsZ**Ӈ>}w饸[#ͧ1c kID H}[]ۃ &hn޽f {Sp-'V'ׯi~a5h\'  5Η^Bt)$ꅾ>jO` ϴ#:W~HC?**%Q<Վ$%"AF?^ᏜB1o~f׬hWw2}t|`Pm\c,be[ٙm_ 4mx~ГBN#ǡrQT",`//3슮\ܩ ].{X*e,V+nӕơPT8ޑTLEʁT*b?v|K q1Y7cZÉ?6ӊjv<824CǓiXNt莼 'v4BJǞct,QHs$/9vZԪU^o%7'U_ŪRʱPΝiC{ђ;G4,<9 $О*Uu7\8 ń^wOϺԹ{&O7AdEFO)5R[[m5,C9 ܛ,gOEG˳y.>y/=o:3g{|gskrʔIs/Θwάd$ N͎3.:6f`tHNو83ԢWn>l3{ko~g4G6MӨ e2w -&Lm+b=-L=W%&}`vlj8ͳL]-dB)T-j5}*2)@?0n<\ }o1p<:I\m}T&6Mo[G7BuuR~td둿Ֆ{-\C뚕\ GJgv^,xx1zhsСގCL={6+Ҿwܱ'-- q:ʃI&qevµDDJb_~)wFy\DʢvQ:'MD=λرcF]D|)"RjN\DoYJEħs'"eڭS-m֨O(EjN\DoYJEgEEEv\V'!2bvv(>Am5Ў+QiРa"">v~z%G-q%"7n̚5k믿HMMv8""EETT7v(>Am5Ў+QH٧\DxtwD]DDDDDDć(Q!JEDDDDDD|uqK,v"""""R۶mr\%"@Hh"[SEDDDDDD|uD]DDDDDDć(Q!JEDDDDDD|uD]DDDDDDć(Q!JEMTnqSkcm3Vc0?27w]:ъզn%LL1Xq1$;g<lƌC6mnݺuU.""""R(Q7ֆ { ]mĐ70nPU ||GҪ[%"""""ED]TpW݋'&=Ȁ.58x"~*z[Z~A/^pDDDDD(LNDDDDDDćhD]_9ڗGh|A Z_͠ KDDDDiD]_၎1+(QWyoNd2:Vpy;>?D]_/O u";V0!'QWxmV^YODQF!JDDDDD+#e"""""FSE˿'b͞]DDDDDubghfҟd+_%%ቈ)%"ʹW'!g}bxu:9mkOZjdS.lu4ǹ g?cEDDDD"Z˥WգZxؕŜY[IcOJEAŮ/k3k a0 IDAT[ {til[JEc?+fLc5Jw42 jDDDDDBkE:VvZZw=I5KpIII$%%l"""""D~Q7OcXٙ~`ȅ߳7WK2rL#"#"&J6Fx5S.wL.N% ss߳|g:g;9w?ul|Ili}ON#pzFxe8_DDDDDND]\9΀,uo:r%:ج|<so]z9nkΝ'sc(,IlI>iKԪB"""""D]#$WL7'Ng\vy\rvvc.F"ޓ ' >5B<B9)>tP }dwxp"""""R<:Q.aY}AV&\DDDDi껈'"w}K%;Fz]0e窠Zn6lx6mvmvmvmvmvOl?/S.Il6Wa=`/shٷ&ﶳ&iikkkkkcСCH0{lW}cYйûYIuQA2O4iiiYd ۷/RL2fF0DDDDDlѢEmvG4i=z8~cǎugl%$X1H]`aΔv;-[z46~=ub &8(c%r0g{49JSEJ-/զM`wz)|VϭQ/XQ'FU]C]DDDD+6g:ݻϼG!zsS\$K`"""""exAd|ӶQ;dE\q[\w.11QIH(Q$k݇W.n۫Pǣ lALޚ+a(VkEDDDDBSE<ɰ`wک0dQ<K|<&qkԍPbF]DDDD+x+Ch{Q+Q6QIO%{KryKyt"""""rJEi%a% kEDDDDP.qSi rWN>;^@fc:]^b|ʏ pL"""""D]BbCߠU-82lXj-9=xs^gg5"""""^D]"[kC8*N#{oeZOx0Y&*ɆiO`t.B)Q$K]zl&8 }JBKK񞋋/oO:v~e})aJE3DC$sgզIwv=c9r)u 3:x"V;>F\P8}[YNbatյIڐ RX'ͤZPW\No`Gv:bɦulN'0.zvyo&""""הxPhh\K˺ADrٽ!_g^g.qBf$a`j8uE<^3"k>,{Du[WfDY{<2c;mጯKh;@;dUJEDDDDApO0lMwfމ+gl˩]#Yq٥;|k}= }>;'Lj_,Bl"` !Z˖rt7Oe0[=S|/zҥ{}EDDDDDS.df~yD.bçZ3?Rm%{$JRrHSE<ŰW'zg5 s_mF>Ml@i;ٰ)f>{bbbV(""""RN)Q7촽:m϶KZ&ynOdۦ:5;a өA/Q_\0j-?x;9Rضy.;a6L3 btBx"<ג]>>35U."""" ꆋ+2~ЗIӳctweDRFL־l' DvDaBOZ.{l)F!IDDDDD` ٞî 8b#uS.Lrod &˹a rx"""""~Hr~tR ߉"Z\&-ގODDDD?dr"ʱOF_6{;X<7v"""""^rl ,n'.Km1,ux;@D]_YkP+h?AY(swb]H]DDDDʡ1cx;uek̈g:rz]M-6 Q͒9 X/Bhrq7Z'vy)- Ux;&rce;Ưл0ǻc=c ؾx.#:2ܩ"-b[bdٲeA|r.zȹ!euV@Xiqp5Eyx;ӠY! U0b[ha{Q$%%y;Qzoȹ!eufgWӪ m׊ڏI{εZ `e'2NADFH; """"R~iq|ڧ"ngǪ{x:8lS݊ I;{.]G!R)Q7$kEQ@Wnh$?n ftKNݨ˨kJEx{?Otn!&0 e*""""◔>|;OJ'0wVD% xRnumJ&N]4O]Xph#2p"Hhґέ\nY}G:uwIJ 5QRXżV3MpLwZab,^Cy& RCr 3cѺd9-6.mYAKC7EY3oGsNJETi3oI@lϞUo3M XϥC$ڱSeY@ǝܛr/K ֌ ̝6eqrqWe{D]^cg WqS RWNuN"qzJӕCfwM9W~{2%zp>{Oe֟ҽ:qgm^2@$)&Yv]) H4Im'~Mh`Pflr)Ynܑ Fd1WLfL>3^[D6\N׉ζӉ˰a++?cJ a9qN]n͎ЙRVdށDztɕw6v.Ån;ej+ж]u.I'N gXrRZԉĎA`ԍLf˯3UAt4CXs69t29)9|(7G38V-/0*F%Ifz&Ե5.Zr$šDzI0#=u-؝ێlr&\޿ v(,N# 1AzV8UN"1*S!?\1.\. 0\]ֿI mw%Q0}H)0^]>t6ކF *3$Ԏ#e7qgmg<ՌBe,LdlhߣK#b嚥2kdanrnb]j<<!$I2}GW],2HB!2 2E,((D@+(*ZG*R"Z['R)V.HŁ`Y"*0dq P8\8瞓~s_{ӻwozfRYxuı+raAfBŬKVԥN|`b>`kJ!J: cak*csRǰ}O6wEHLJ`6<+t)LyIH:v6WtkIu3xZ5bϢzuJ':ՎP!y?b5' l6n /v>7"-}D;1Qќّ>d[UiN46fJ*4 4%]vXDD@\l)Dzx*N{]%֝uZYHR[S;):@4Na_cž?g)ڰU'R:;pzǼ=v.@TR29m. )FӧѮCEʢgϞ??yrss;C}g͚E6my.I$I{1cMI޿Vtw'Ns3f'%I$I 'uI$IˆA]$I0bP$I$)%I$I #uI$IˆA]$I0bP$I$)%I$I #uI$IˆA]$I0bP$IǀB8"*Or6|]x It)az㔘 4 6l}yre0N6rŇo]|ϫMlrdcA]$#"I6QTTDQQ+G)tADJ- ^ĈEG 郲®ײ5)IķKIt"Ʌ\5e m߮ܝHA#ro+%0ah,aM=0C;\֪)uW~P5cuY4j؈U@ޘ${\ڜV3w3"m6u wKJqʠ.IQlZ8g\KF b)cѨܹo.!'g&w&((9 Ff2K~pX"7 ]H7tL^鱂)sKMS5OVٲ,8! +;|8? ͕pы񼷹pL\-ePH3,^AK}"VL%% =/ҥsxK BLJgŊ˳șgDL>>I:%I1Q]V*U")>>AU5"H ‰4:vh䅀D?g&b4aG[di|V.nDPC_z5 z*4kN')4+ڱ~|Y "Bڦ %S4Id2SLs?яr;3㴤Dחh|U&-A@27!D "@D\5rʑ$O%I1"7Ma_ZM/_DӸs9a''}DDRkJvf l%"Ar7B%*l% Tj?bRqAbc1lddqA([f eo[q܁xWOB–Mm`Bn=zw_~8PI:l|K$IǠ.3ː?Ϣl!#G' kl pZDrٴcA;nQ]jwuT=5y IYt@ O9?Da~݉>TDƟn_q#IU੯X|j֬ۚF(Ct%Iұ))7GS73nd}niM+&('dy6Ϳy[RLvxD.toes(Z+/}LpaܻH>;az#kPf- Zl߯f6[ys$ݞ'ҽGm>_o{8'IA]$[^1dGd2=4>5s\>L[&x h Pq}7gPVV݋WӢQ5kiw_nzyT>7/Vh@{R6wʅ̦yDc2IDAT(;]FY&n-9Awg&Ɠ}R}s9N.d_}v/BVV={<7!ϓ ر;k,ڴissI$Iӌ3ohJJJh'ҹsr3uI$I‰A]$I0bP$I$)%I$I #uI$IˆA]$I0bP$I$)%I$I #uI$IˆA]$I0bP$I$)%I$I #uI$IˆA]$I0bP$It*م{i,&JTT3{EE{d_Ȟ}JZRE7]o:5U# ?{Ĵ~ee,p/g&9>*I9Z1Ee~O}ӝcw/Z(R{]׾[LBlQ~sJ *VA!L)SJhd*]&[wk z^<5M%Ŝ.o`]9!Ble/xHJ\lٵ- }i#~?^ĵ $ISAVx7/ջ!Zh#Wﲸf\Wp ?B?M#gfzq;ӕXLIIf>܄:P9} ]F-7>! Ě@ FVȟ5O󋶏Yʧ! ُ]9weS--u&]1w~ʚoenx}=qjǡ^?$z%G,J̤eyl^&yb-\ċWtDjG:P1]Cb\VMH×rG*X1:]ԡ.i7ޕmu'‘A]$IƽN}ϧr` +Ū<&\usֽ_<CuוN)`ժ̈́ITTQQQD3oԢu-L_6FQEk%؊͹q[*aױfC5jl7Ȉ/,Pz{K=^^~E]-Lv8aҥK榗ӹƻ ߍ_"18sI{/ir$QOnMXb81{7uvto[L[(ᡁUx}'l"ci}dݿn' bh٧7^b/ %I$B?tjRnӆVFͨ|!KJ_0)g<*f3. -hyB$ ).>"잗˝]TIIgwy9r.^ʪh#7iZ6 e{2F~zN?_r0F}?ŽN;;N?hztsv%[azj561mt*qp q{Ί}? %I$ʾ]BN4 Ձz0ymiM[ :gFE{Pe<>j3{ Q_@(.∏-$`\Fsy0uIIЏ)1.K`ϳ A~|/Մě/fC)7ON82r7GӤJs ]uI$IǥP 9݄-%}$>!2TP@ad v%PN>MpR_N'r{ܷdlU?;/+/eiO HZh֢ݭѽ#>Xr(+b(,dgRPOńM(y6P 1Rg|S Q@R^]w-%&kQ6M T[Sɵ\S_,׺ yk)p?{Bѧøyo5ٳTU-hߒrgKA <\Q$It\ې?.aYZ#H;"M?*\ˏO 4 b\`CO!gVB(\>ϼfcx<|&-e1<Hblɧx[ >Z UgLד)$U?e]Q{#j<{9[y|ԓ|д;F@lFh<]g|@;ROC_[ηooŨU9iLցS8KeqW=v/e9|n垎(h.I$Ia)P,ڧâG3k3 $hǓ1DdWӘRB*`9'2 Ij}+_{177v=uhz .[˾~^XWiDILD_M& j&ڊ[qCh^>ѶnGz k}B:?;0kT_FdBjԬI͚5YՓ+BI$mm)qTHFd2>~SDeB9we/x('UB Οo2eK?6t(QB}9uHYYYxP̜Ϡ֧Hb3f 33s})))o&NHΝ7fW%I$"wpf?csǀ"㢾cxpr m}@!h 5I$I:RO?=UE\l.JDDDDDDDڏ?Ș1ccSMS勈\XwޮCDDDDDDDYf.Ƨ|}}K]F}8UbԀFx:O苈%A5z+3= jhűȎtc[ `ݷ8W/1}SNl o]w'WF[K4qLϬ}[-z݇pY^ݛwl@DD߽=?g0p@`ԩvm]}Ddl͔ve'f#"lMIvNQhKV,J zL#P}5ƻ [q3^iд:`H`_ܳ(8KSi&X"SNe~.~&mQ?sL6nX{͚5k9EDD\ʾUwe#Y͆4Y1s38{4Mm&Uz',DխI3l[A۫zPn `aLYJX! iLvuW aPK?[Ft.tmQM|b-0bhө! s_ 6ߪ'-+zB&dM s=!zvVx&Inz~Y]9[ѱ^n"߿?ӧObŊF}uQM71qD9r Drri7,""J΄6q՞vg:?31l^:tt֭[ŮXg2 ۵A$:Tj<9f9[/"ƍVn#U˟xBj4nM=4_wL$ (f/vϿV51E8,F4{6%,[0hFEDQFzG\oVV ~uFuQoW ""Rr[rݏjժ8pUsF~FFӇٳgl_DD.,x`D@F4Kg=dIA `p,/,N7'n-/~agĽ=VN-<ԧV֦ڱVnAV22$o2r86L VKaPB#+BOVNӰb)?g.YV ̬\LNw'GsKMMSxV1ϟ~߶L8pVbx{sqx14"""hժ*UbvወRHOײ1 5_AcY7>^δA,H"1͉ჯ{=%+.>c/9&ga+fUlI_r-uiu)·5 Rc4Xrx Î ӎybǖ HO#ˑAFܼ0xx{cBD!\Я/7#GED䂐P.6,fLp=7xiuV'&&ҤIIMM=ϊܫѴq{Wf=8gqmbԪƦ5ۘy16͈:HOǾ|L]4 ŭ}rb^60k@DO_ZMgゕ/nax,q ̿ųIDdfK&x7C[Y &xTCvlXZ,62 l`}"5vL/y~_R\\FDDa%e/cd VÄ\Bep*VomX}éپȾ5XJw!ŽĪ&`DZuuQVs`o$Owꆺ"ױpM4lIٸGBZPe隢*O?qJ,~aZyX{0jm}MC 2vyӫrTOg?/5 EDD.U[f_8a0=55cZhրkv?%""ra돿n Ӊn 7l[єx+~{{f5a 7<즁g`!>E7$'%ٰA`x(>͚yŧccDJ7P22s w}pÂ-EDD伴tҳ88J#TO1eQȩ1I?Bœ[ [Vq%bHf_eWyf.q'=pL0 LN+^ f苈\J_=KΫ.׌lAX` gt""""""ri(%ѷPwD]?lX4y|>Gۗ3!{~A6)e[@gyxJEDDDDDąNo~OjroqW6Ejugs>eVyz_x?$?m/~<qY,!Ժ&=pcλi[ÊD w*qsXs7߬g㷂cK7;0e|w-q/U]|.v.W/3y >5}b֝|o7V#cFh᥏lq+M>|i{ƤgzSt;"""""""NV[ F\MeO5WI8i1VZXh#֕1(1ܽÉnu-O|m|ױC^1tlŔDTLloaՊQ?wH$&ؑ7wmi8]X#GPe c蜫0yW0Ibk#x y{DubL ߜ]vIrrC9oH5\%}K( nVLg|| AǦX" BztC~)<ھY#|3O&S8LJ}WlXI>66/}0`%U%pw+Ænn&̌363|P#Ϡy߬1Z+]t:6VgSxZxW%]X,tա֮]ݻqu("""""3Xg0='I I8p!1 iOif8 )DžU3.afLu/;랽O)wO4f* ƚC8JJKX#wDt~/6݈l;g#bMc'JOS-Xd $'',W$???\2ZPo>ch緟oGhըo 뒜DG83%&c|Aڲ,"P k5$ ikd?ȿ)[PVV?kkmLr_όIח%FdG5w ߖa8Ʃ-e)ۡMl֤QEoBk6l3"KLrr2AAADGGc2M49|0rʮIDDDDP)S϶s~?7|[Ï|O#yh>z>oGp6W)4~7jyUtV]ݘ[b~ vM|rJ3-;^P 1pM̲h ʗ x,I6\ϋ_HuOֳye }^<1[2,xVWcrgɽ'BTTatѓ BTT{uu(""""rXsذag_̤:ﲋL_brrOg] Nb|(B\苔;+rMTwLA9?d:'3z|t|30O8<n#;$24Jsw;/ojKt?uN%+5YD[a憛Xqssj!g U#C ֎SvqvLDq˙ư{9tPa6=Uۡ4r>苈%".Z:b&.!ϓz\&%>|x(̏c4pt,^XM0F,ɗn!Ԓo/aߐQs*HKݹ#D|Zx Ղׯlq83u>s`c[`gcѼ.f?WtqL_'Ӭ~}s?.L 0}L]4A-cy0u|~Y~ˑ~>ZԡVJNkZգf{~1ir$M|ޭPvz`΁qeNʹ5|4J׫Cݦib?lˏ^K:uhк/Oz:=ZM $(qK9df,sai.gJ`^eAW׾}g|vhQOJDn48Ѽ7upT ]=,esWw˙g#Fr=_{,y6\̚}/.}f/}gΆ-q?(S 7S13wL[φv] f\Wbč̘?ѯ[2.<&7oe|| z筅ٸ5n_u*npzB1;>foΖ%xjN0Ollχy4X5""""rJE\є`C,8H Daz+Qa&$L$ ֿa[#FA~gOy/r˕iݦ+!}$t>*&fcyڿx~-<#/<XjNTp ]9*/^C~Jf,eШTr7=jU93jtW)!,55 vMH IeP#CqNv53*<܊9|0^/7f/лS-sDK6X!G2owpYç&z%.\zADDDDέ<dw,rk ܰDp؉?HHp~%r$'%h^]O׷tɜyd"ne?ᳶ!X3owp&jAdPDDDDΎ}r`m&z{n<·.ي'}N3diFߙč/1*jxvY }y,=ֺLJ%|iד%tO#Ö734Չ$l޺>>ttر $u <'/:/:̫&p{;Bn-jO9vY@Ҏ/?/8yN϶*)p8gnTrEz93M(8O  +w:Ow!_4gwo [ثޟ?ǐ )~ikZ]^|޻G:rc&1ih4^ ͣz>Fvv/K>dƷyP ? Gy!OݝxgzFYyp8~M_2'a6|C-&@o> <)|M#eC$X[c8ksumu;DDDDbƚÆ su" ү_?Wqԩw>[ #<4I4q_> NjeÆ hѢ|25i$Mn@/qp=+wa3Ǭ smܜh$OD"c&$ᬋix&~3>LDDDD %"gWƣ[z:[ӻ]CDDDD\DryԞ;DDDD.\JE\9]ODDDDDND_Dʕn: K}3`Ag"""+W: .\DDDDHnNk?%"RnڵkDDDDD. 3f8}5<)rNC9%%"""""""%e!w!5+""""""Uc+:6%eZoU'<&Np]uӠtX'y5gҥk]4[;*ջOL5͓_rHʹ㉾FY s蛩yDDS^;Gk;Y W蘆t-S sOҺ |`OլFWr]䟲5mbiڴ#TC IDATϬ3Үn 12e$̤WxG=bF1/IwӫMCjWNoy/z|59w'rv+^tUjK$a3yeԉAL~qotѝ""""""oMo1[ e4]>QɡGsϵ|{Zȓa2$ ~Zʝ{Xlxd,vA+Շ Ci/ v#)X4&RSNj` yo=/fȷh4?'%)kvɬYqG6W#"".NVA]7fs2qV/>HJJ#W K*tS}~}9L7q+,6pu"ߙǡ|pWҰotp9[>D;YvwGǢ|L "t{|g_/#Aڲ,$n׵bH$f*mY?r#  ,&0sێ4OLOuo],XnCӆtrh~m))e@)Ofűpa|KXF 5+ض2mN%""5 *^?=]3^ɻտ]hsk۷~_1r̷w4_}7j5vQCأU*WO1g0^z}A˻н׃m֛Ed-aK޷oXOI1y kե=hZ;Ik9KV!S?\'V>',^|Ѕ#666lXT^lpT4UՑ `8}B ݺ@EdDJD_DDJgOw'ԗ=p^Lxu?ʯYׇ|[um w eۉ59 X%춃Gh ]{pokA9 r:}V/z&9IY,!ssqZܩMU\Gĭ |7%]ͣrm(5 r$I-Q%,džN~8Əd׺LқzlT9d_r5\VӀ͡M=@am- ~ KgAɼ]{B2#왰t.usv">Y k苯{j0O_Î7 ňi*ٕ"1ėMo僽NB@`QUoff}NfHKXCIk澈ɄuU@h@6Х=C >ǃ?* ZwXR DDbm/+qxvfఱDP I0![` AjByEټimUc/_.8KPuxNٚ/"rÀ5 i >њC 2Dy@`5;ᄬt((4~vsʋ"rjJEDaf1s^b} 󷒕jĕl9R/f bȨHrχu'"r>3oO=9E۽!?j@p'GJEDXhܛC۳uȲh(zw'а Y|ݱRC4>Ua + wSYF4rۆW‘Oғa.x_U"'%""rj ><+=[>igDu@mNoL'a$]a1 |+xPdZp*t5]UXmX=-xzZpS%"r~1;w&f{t!>T,P vr+CÈD+|:r!'m HEΚҹ1||s&iy3w&'h:fڪ|ThLI_ |69L8xOEqm :B>wcy?n9?4~V xsp6)5_DVl-y+ f읰^n/r`pyh Ǣ$oMUCcgEԌXsذaeR… ֭[%r>Zp!}=}{C9G#""k@Ϟ?89̛1ciۓ&M*nݺk.233INN.˪J`` 5jpu(""""""2MwڅbI&eY\ݻqu(g$55!yH2M333ܹsYV)BHHK,qu""""""2M5]_˅ԩݱlCDD3>!y(~A(((DΑqyD$TPb{.[>V Bؖwn"o£'OsdYg-8=(S''>7fxs8noŧ{-IӾg2}r{ѠPڄfv8@5(^me=.""""""rV\INv.^>>x;w]T"""""""2&>RJE\lٲN\9n:nݪd"rru_{E╚Jf\9׼ysRRR\yA}\\~hhhYV'rߺ$%%aq MS/@D.e 4 dڵhѢ,Kڵk turtr'"" DDν2MkԨݻYd eY\BCC FEΒNDRcC8/K2_/&&ӤUE.f9?1ջ4=ڛidǾiZj5/7_$&O7㛁>FD.0UOq|IO}AQ_ "g@ЎS96I8._HAipli̟O'wNJ}//o?B*7_! =^򾿁 <"vlN׶c'wTnYOVߙʥTg5vc[2g-=<1WEwnui=߾s3 nS`*6ɣ3?PQ)JJE\or[+<9=ZOoϛ6ƣm'30ե^ 8e;YƁEptrصuZnzd(?ހW@2φgSۀi}qY.±e]ʥ[ O %7YUڹ{~jCo{;7[넱xB2O~#!={E/8ʼ/t}W'bKՙ;q~Luߑʅ^\I+y67ϱ0ao>ί=BRg MGaE#9f:6?jLC7a˟ͭA'naWP+* i-Cޒ_&%+<1Mw;3*9#aSjvovQ`ysQFtW!22v#d[^Qy;fLgjUrn?(cGդ*V~Q|!gz_`׮HdTU_c(""k;K c'<'E-6<՜O96*b5:Կeg6r֎5Y^gEJI(^@(j4KKHt$&\׊~j5ٹ'o=F~\Y'**XIJJb̙XWZ9^m塆s>dwI W*4|AWSRVzoSYV9ƶ!x v{ԣJH*TO-!ݴ툾3߿U_`f+:OË*= .7r>s5%".1^범1o滆/twE3k\'/& soeC<,R3%oIeӟh=_GpА+hJs=$kb&3jܳ`;#>qӋIܔ1WVwHQ5gS2lW .@EO"RRhh(f[)fTLJK6M`܂<2Y30ϠW3uLP׫c3#>m񏲬ly 2s>꯾}ְ1M\tyeLۑ4َ8Jy2K ڊV"z ٲ)ZAysCM3D1T3gm"`j6nn/YMW6. *47}'7V0Mtm:taF#5n55T01pu;KLdʹq7 ۮ&01M;f`?^T>仕Zk掄[q7W@zS<ҹf<K9p:5W!Ys⽔'/g6bpZ[1=wd_ĂؚtML'U{WbI`&zW^r<ᑦo<9#_xiA>AS͏.C8T[z|wnwY7zrNJ1UI\4_5C0P|L!/Q_plP**K9W}AYR/j}v9WӍ5Ͽ9c&39>U@wh_J,:a0~'X_6nkZ<ܯI׿^"Oe?zF7O#9i=!P01 :Xf3qMWJDQTXVN'# _*V;v"e ' )>o bxIIyET\7ZZMR¹C_O Lr[8t3l AAHz2DԈ&:&Wܜ E]˿vb'ŪrubggqrgJoK,Rr~7oG 5~̴#;Vwt89kRq/oAwrSw w3d<z rN2뉸ݟ>Ȅ*OˋY=}Kkt”ML_k{c ''=䐡ϋ =Oܨx(bSGQ[\Ϧibչ>|p8xn_ssi6o5% &/ϴ;LDع ʊFE\yx {^@׿x>>ȧK]ʕ Ks<8_L>4?>X8'nnLu_6_;2ե$(g>ýG[J!RY{:4е.>uN}|?a.N+1{|.'ymͺZv2,UW="JjH\CvorOYld#nZWYx8pDXڵ]׸¼PW) s}n m&s}bo>'qװ/@j4IF"a]LC_cxy_<ls-(E.. y;9;_ZJBk5돗ޜp[o1){d2qf7{: '\ʠf2&?qgL};<Ÿ '~z|#zhzaQ:}FP\z{^8[YJzS \Shgba>_f4iq5xh=;d*}׍>{ǜ䮂[^:OlyD_|Jëzt=azydu^VCI={ƌsJ:9>};xZ}|/hvm둡*}r]M;7K]-**˨g$5;p&wp|GfkVƴ~ʝ IDATSof~Irj?jLf7K+1N3O\9D=Ғ6.zt hڵ$]5LݪڹFsyR7Jw}zb-6EK_OsY+mshWOBN,޵343ǭ6W[b彟׋J }_K_G{os2@ջrj*}£a=va"I;w֚5k?pVtt:wlv(Qc.~o.k)*02_gL%$I*͕RWNDC7@ Pt+4Xoߢ/jskp]geҤI5\cvP'7wjδ@f3d3f)mp8t:O!t:95|n7uT|6*W\xN-YJrW=1: 'ǡ^?}iYt!h }1$gvlŦ4!$4!$4!^MgϞb|ÇWnn***TTTCO(""Bf>~nnVumܸQyyyJII1;hWTThȐ!<$h͛70'xu>Pxo>(#}PCpR^M<&L8Ñɑa0;Hx I=Ozz!?}3*[.B͢:z3V}ߨ_RBC"4vrrrmvO5|_r+ xh 7sW[[)Z󶪢t>g&QkDߵKʹ׽')^wޭ?ЗXt 5 ^ S|mwq5z~JnV97h[҅J=pJKWq<ڹ|JޤGD'`ޥ~DJa]  Agj`h+$ZU{yZwq- hz*RwNR3˱y0M'Z]MFքY豳su{]4KUXw;tl\O h6)@ Z:؎S8S]JƵ[H] +wj=hrU<ѷgEǛT)Wo.\k;oyYKJFwz⻕{2*+UYWGsnQ+Gvv즤fN9? E=oM~ k ?M__])Vɵs6W{Tѓzq^ SXX;hV1-*nnxMWݗkۏjo˭TsɏQ}w8#>$==#5999>oviviv_o$0.y6io999֌xhvivˤIk+[r c͛7O=z0; ͞=[cƌ9mN YtL7ydM00F@av($/V>}Nͩ L>]Ç?vSNn-_ܛ|rEDDONNV^^͛"o~*&&FJNN6; ^CS|Xhz:tS^^a~=>fG&D&D&9xU !rrrmvOЄd:cr/x7wفqRtL;EhMWrFE7S6jAGݭf y꾥d^,mZnYwM;sXuثُߨ7G4Kأ՛+80 Un%@Iudm"Yu㹽N2F螏唤گ5Mzidj6MC&W??Vm>8R*zz7 ?>.z[RF 뒤6)}tդEʚrFtOQ]49*4ݨU4|ңC,!VW{WԔ~z;:y5&RwI(LuCkрs=~C"^/rCu6Jg ڸuq=M$޸KVlԆWo~(z׺WtC2Oo7I O0ʾ.{+="|jna!Wܥ)O#[b4L|^MUofQѵkMOB[roxM?ZC\ k聠tsT{k%k~‹#>0}co-Ԧvͻ|uKY%YhX8Zlj>p2*v@'=Eco>_%kt_wVo#Qs e%8U_?J1VIr+/u[ ;]>^-U];Hqvº ~h((i%hˎ#۔t4vZ0ux&Hr8]3.Sd TeWol}˩/+m[:᪛;['I!u?_dԋ뵋G*"INme=5y֗I6(F-(`knHR(!>LfbccQQa8p~[s%4O Xuv9 $]v!sSKӻO[澬W齻TunzQ֞*.uxcxTq*'ẐI.ҿz^ƽ{ӽ􎒭b<cקF(*ZY{P,rAmrwv6S\l#w`6Q~W.ΓgXs5o?AzثōYY/ V`UFToҹ J MPC*\h~6pDM9N& 4})䜻uWkU[Q2kkuj)jyƗZ~*ϐĪZZQQI z?(;Zw[^[Rd8Ao-SK'T֭J=.yNr FV-~ud y{ҺRժJتGySm]Q#dStKN'>ИY&Md\s5fٳgk̘1ya+K.U~)3苏v۵C*IXҸ^:4Pe}PZ زBn:wPc:ɓ5a„3v@c#0-^X}9630}t >M:h\.9>6M.KT/ѷ(UϙՋw&(5/>ov9\.կveS/U۱J~)׈wi7$v>F[J̵QiY#Kʭ\.iQ˪;ť͛Ku'RhHcmUZj=XJjTmJ)(\ܻyg IFm6nUxd(8>0CP>C:;}VıWꐯ-0;>9 GCήH{j:)s$"4I=?^-arxG1>;(=qޝQl)uz[UG5}:?ӆ;h{>:Z+!׫hHE{NKro&Oj(߃r͛GA&T$ hhw1x<Ҏ\ uVzO?N4]4N>{S-ߴG啕:!B^^99Ј+##02qvwa4국*S%?_oPcjjzi'XGX›+N葮f/`[6Y\g RdAI)))A&%ʗ0)~tofitsGŮZ6@ }Mdj?Q1-\{6N֘k oи\DC{mS?8GwL&GROO(xf5iL:ƽ3QcaPo^oi^ KVHhZ} |MS$#L-oi~b|~1w ,ua[T񕡭:\"}Uv۫cWzqiY%&ˀlu<ڶR~XmRX.,`,h>%Dm*WNM5~T,;ys0%QUL_-,SK4,>D6ÐQ_IuZ?VOm`)yU`Ww6oWZV Z][yĆ5c" R$by>pr0; |QBMzj=^͈V@7jT WAt(B%Qf-jƴ-*u*.l 앨 `}G:\S'iri9lr9]2C~]*wkOew7@!5p\-BC:y謬?gfff`@ӑ#0`>ֵֿ]]՞n咫^a?|XaȰ%s6jf))P;Kt3fff\DIكv[3bb9'o T\U*רNa'a C=nBLb>ɕ,9Pŝ`-ܶJWmS~Z!FۖQuVr'iJQUzrh$wFDEFQ=;jgR}ު'8Ni*5XQ]۴]]dZ9W=~Sv=w=ɤc$/rMwc+>^Ŧ@lj{+vK/VSG҇\! @Cb.jgG&QRt-Wh hx9996; |QpzZ^g RhH_)QeR}S~DEuٿ諽}]ڸP HnX IDATEzzJ=}XG?{>&@U(4VElH̎YHpt,2;QuDE0,ˡj۸5:9PQQQCӤ(""Bɧ_aajkkU^^@5- R -_G=Y5k`SNssseX4hРYb򔒒rJb(###kZUXX8CiXZq'IZ)uEgUtʉ~EEI/гgO}w}MM:w܀5MZfa4}DxTVNc=8#WV֞.&Tr}w~oD`Ԕf<+[ZzzX]7h\ș8L&'Ne39Zc(۞՚]lLf~XؙHڣYwU,]￿,*ܢ]4EM 7 hVu R5Oy.|u=4U!hW׽zUQ"T{ܿks>Q F6NHwiuu*#yGw IS64M] ŭŲ7o.s['YTk"kX=X,׎ |2-[J붔c0<ڻ} w~X-a^UlI+V2O^49996; Lfu~?4bp-Z-IU|* {'mɟ^ړvI]~P0Yܿ|\{JL1A*Sm-UuuKGh|HKś6J{fW$+oJIڪduUZm]ZuV]&IL"LUtU:{L5}W(!#cRGC=rDyL,d m*p,@"TUTÐ S![-k#̝|; EVIQ£"d1H%ϾppnΘSm5 :~܅;kW}֓2Ds{6qudwjJzfI =G5 7u 7gNOyE.qEm(\J$bԾ`ŶMSl"aH-ԥzi!850:ygjEk}!_SNت.~%l]gU1;H#?B@Gݶ$8uzYdڭOoK9ڃ.{{>D\=G@#PHO5f7Gѷ*9zz {,V9:գzssʉ~TT<Ͼg{|*V<NyP^tu ~itbvLw+a) a3F}`SN#""vZߣ~!ǣk*"" ֎;|<vܩ`C9sjgG&kJ܍G;9۴te﬒BePe:)Ѫ(0]?D4^触jÆ ZrJJJ2&#**JJMM=}Zh]vi˖-j蚎PEfr 71nYy9u0>JuA[#Wwkk#Em T-OUڄY$ըN-/Ѷrq_N5]ZEVFDEN!qiZ%+%6@u{=N7;KNɶPr*-^M%ʲkr[[Km[FV.um9tG|"|E{QKNsf k^}G S'סV}(uwJy6pR%u*ߵMEJUp,@9 4b$/lբk~PEdžJ*Қoiι|NLPP#-JZk~OAwfkH2m\QPuA6 tI}M#p_'~%KӃtyڵ'e-[-Jnf eggS$/[i SuzO T ViZTgblLE"K?[r<-)+r=4q|l~OF h7S6:@Β-Zsi>&DIus;{͙Zjd OTsi`Z4ldTfb>૜{qv k@L ?ѿߞ|0 /2 =ufJKUP[vJ &''Ga(##P"|3K_X潢@c}Y"6A-@cC"G|q^{eRU#0 C_TR)X-ѾW[3.RLC}`&}gڻkm)Sǐ$y*ow.oVOј@` }'c4U$պdsUq 0'ƤBf.U=' tְʤOvJJ I>`2}yhF+*%5Z}Z7&k|`}*)h>YUF ,[mvB"{gXͿVM-jΫ{^߱}ͤ9Qvva?E1>'Y?r^9-\]T0 =ϩն?ԛO7`dUKn՝epʿD)m|Rvo/.ӕ:klY̎Yl]0m/nVGЃ_:5wjJ 4;Pc$/qoR^`H,b_ܨwjh#`2}2 8ɵ(0bcҋ49992 CfshB|{VZI^SwIū{_"|C!?^kA)bBxLGzc[0;'D}`&ЄУmZ:wwVI 2`2[KeWhVR#Kh:=X}¸CUHSMӦ?*QKŊl?ث];jMwKrRxh1w6oWZV Z][yvpuwCd6I U ~ƨ)S'\-AtB'J=؃hKNa!iHWh xYYYR>0>ov9\.5nCN=eZ?贰co=`>~[J ԯQiY#{*;k:KJAg8VW(;;0"ViݪmxTcr[*CR-+eUڸ+e=4D9\N9N<3~ǡV}(uwJy6pR%u*ߵMEZH%9zoÁ}}.͌.!H(0A=ϻB=l+kX. CQuѷ4!$xUHhBHhBHhBQu}}L$4!$4!$4!T˨D>M>^F}`&}^<sxMJJ!~}z23ѣ@BQuD&D&D&xU !˨D@B@B@B+##0@ӦiSDF]10J]fDž ++U_}gp:x)"plmnb*8#*w|J^^!~=o#pLFM= o RdCe%2L 0G\r9lr9]2$Y/&Al2Chp7;&/.38_Ԑ86]KzMn[1 &C%8RrV_Ҳ:G3886k %ҺUTf*TRKّ88Zy郷* SJ 6;.'B+82ЄУWpx[gSzkȀ4E̎ A]*}Jm)(y =KIaG_Tj۪4{ 7OUAՑ7T(\-yjljcwSqwp`'<.3,%2V:gFvd9$IZ4?Kke8"Ԧ |E+"|;S+3tnfGsB$~1'}t::Wi/4oU2skdͼD7xWzz5?{s52V}.Pv.J3SöCSgZF^}b5e5\}UB:RRNY:v 0wT4Y$RѺzL,n5V="c<h7S 2TutUzC{ҺSuF()ެTuK ](aw6=|;KH VaY!ONTHex:T]""[$uykV?{EqْBB !$z H*HQQ_E,Ŋ"OD"*H/J!B e?=D ~?s̝!3;wWRWn߮ߦ)jӴ8W{MeURd S]6%HfJ7ꪛJ]P2tZ%5$ L>IIJ , OVBRnNPfR Y)J<࠳_iR`p2qشB˷TPs]PjQكMڷ'Mkd*ݡsKv&ENUr8t.*+$3#uY:~I.M*.|rlrXdqRWƪl #{8 C#+*G&y 5]gU_i"vTNqiqz0PppL *'ԙaLΤ( >x`NPS*edORbJJaԪ*~uZ=9@%2;&H2, ^m?vJY'+F 2 2t:4>j?&(ir(wCYU(W{M2R*6,!$kzjSKc8$=(R}pLXUdO-dTI%hY<9*hrYߺUKTRE?d?,׎yD_ԪJ19l6lv9VaUjo[2 9Sk?P9LfeZ7Ehn[{V.Z(W{M2beH22kLPf(nzJ~?3 Hbi.}-$On(-nK؏zE{M}k?*o'hV)䯲u۫}/HWC::2o1s1l^2+/rGǩSu(.@YFyܠmSt4}uکb5պ]M\5I%*v'l叚aH&_h|u@ac?~ѯ_?W(.\=z\պ^^^rp͚5j޼y~T @!j*EGGdf͚;z'O wBp#}A7Bp#}A7Bp#}CiG[F IDATb2[}]T ;k[Iϛ>'k-gUvAsZZ˾N/*f6/m0Z^0En̢Kt:#CHցů*RZaG>ГuN.Ո=5)3VXT2ڽe2%7ZJTjv~F?8S褐/7*jM2r IJӖUUnS2G=?꩛j+"W5,-XA @/YmFj'izԪ^UUk¸s9CJx{&^%J VN퉷i35TaBe]þS׏]MkbXF;4epGPW_9ɓ{(Ӌzo-k.7'Kmn!_+)f>}BZ5>~}fUlj=PVjoiFō{ƨˌڵe~_=ޱCM;k|O^Yte5iǢj|-]{ܢ;&~Cެ0޽_==Mq9d+㾍D-Xd3 z==\%˦om4i^ڵN|CN[t];BMTRE F +pcY@??4NA=^]YtóKu𷡊d-vmkt%LJWn$$T8#':z6V;K2+}ڙi~Mｭurjd2TjU$*zʶ&&RE5",:q4!W>ԭ_i5$JyWke^mj`5 2I 5}j &KvT[Ҍ(xYTS'ݡouR컠3ƫiɾtY-!{u\x6cfrp:$#vK(ę8uJ! -yOŻDI'RS竳X-v2)x?~oU䧰sy(!$%;N)d>UOݪMit2ޙ}:J*.%p _!*wz&|FiYh-\VJ%vwб!7JN<'u*^%B1TQpXtr ]7JH<D(ZRamڿv9'隖AxkM=:a9>[m3Q'*WRցlnRS/8 j훫R$7{f:sκ~|^ I7Uk7E}+{;Kʆ]d/=V}?E2%94{rlZQ Zښzf^}CF~X}h |6žPOKj>t4$Y"i{UUl~ WKo9'~V=kz}js+ޯ1/Vd~/ cl{5n{]Z]jkwaVVIzcCEUmgoܬRȹ]"*G;UpwC+ߠrjF7/._`tp9~@pBfu5k֨yQ5ȪU:WΚ5k:vM<} A7Bp#}A7Bp#}A7Bp#}A7B#p~K4$~dU)Q\eصJ6.}͓4km (:FERPA=#c -5R5?ҵk˺Qdd'=s$~MWP`G~sL2]X%\PҟWpQv43֞Y{Ұ z뽕vP ޹Oͫ/XUZ Ԥ)8ELߧRd>P#fJk˘%Oiz껣2׬Tb>A? qDW5: hif!#;=|pN[,#XYV(f-dT7oM|̙?uW~-&MzW+;ո{([:Io5[Ӿъ" P2.vjbk)ըpYEԌP: ZI^j6pB_'/yW"}<}?ҡ*75{_u,W1.%G>T:[c\R_֯WbƊ:uhJ0k]MUJe1Mޞ!)׮|:?T*JU+G}k]36ja]19?~P@9ut^*kd)5W~[䝖+}#IG<-^$g=dWCG=QIIFZ|t~&UzJ.|}*ҳjWLoBQk'kTdm1d(5>^sЃu2Ci2Ss(&?t]|,`_c2-g7IC>H/߮Cqв*97m߻UnݥgNGn]qL$j4=1_2F7GZX#TAܓq}(PRN?|e(-|u)˯s cz롿zqIҵ⅛tZ{m*_~i:yCi+sڭoi &*,R }veQzjUʖ pc'~P5M'szU#]i~*~Az5Ke|'EVj}uýdGXi}-mi%뫔z`]3T;H]qjDX.YӤ&?w)voV|LE@$9n{AOg=˟9YTry%=vnr<Ö,-f\5QN?tnӖ%%HUJI~~>rGeVr٥8$㝭ZP֡9m:wo"o9u`z:idit痕wϪWRRRaa.*hg?)jLwv1 unWֺMqqD??vF8QTgP0$ɩ=ß)> ~hJXf][=K;ֺ]Yß+ә%5oMeRZ1}̧'4EƩ}v>=\Y))JIMSì =QEo%eӲ1_hctgks9o tM̔=q>UFe̒{s9UJ۴X $B{}[,=A*YykT\S'-ւ>zuvl[+* @ 7VܫZʫ\z-A};_Q|`LP}LrJ#ޢUmQ[ewzUhR=#>^}W]VVm__>@~5L;PAΌ; TY2cfmsHrh6 -Z}PM8RcG7RhFjز,+=/-VT+fTX} zY*ݮ+ġeصL+m&(LǏ7zE… գGZK6-u֬Y͛GPַv~Tэz\:Q'}~\]uÛ ^s^;VZ\׹p֬YԱc]on)T=G<%}>J s&C%ںqȗ'덹5*ZsnZ յo~>q\AAWWѣ!F>nn:y{{oh|=weee чGc>wCЇGc>w}x4p7ã1tG0 _j\=t?::ڥ~}V@~b><@~G 7h@7n,m(֯_Fȶ h9te˖ڷo_m@ѵw^nݺ@}x裏iӦ\6lX`P 9s9R P4_^ӧOW2e4p@U\@C>@>jѢE b>@>2 #_~Zb3'Nk$*9ٖ&$$HOTU 4P˖-裏Zj>P@̉…'6l}@ڸqۧMjرׯ_쇠5k]]H ԠAU\Y})d|@p}aÆ=z\ 'p5mT?sluVlY9r@Mp#}A7Bp#}A7BX]]Ͷm۔xWWEhhBBBIah m۶nu֮ 6(&&/zn}KU?R5l0 7ɺQjuwxM_ݯ{6 _/S>tKjC|B[ =@Kwf/05- m8@_$X#:qMsq\7GŊ+|u~km>m\**=_2fܣuʔ ۴jNًǚVݗVBqVAܒm`uyvsXys\#W/gGS,yVђtS *RRejvԓv)Q(A("~'K?!)e[zeKO}0sX߶q~R-y͜9~p S)5sůR΍fMRZJv/yOM~^oߛ%$@oIM~Cmμڷ$Ô9ů?RBR} }K^3n-N9o瞉k]=3]Sc5BhB훂j7(E|~hu;OXz- o? 7!cNQ(A(|iwj۫#}jsj㈽L9g,7OSVdIZ4jU $Mvo-s(QtJ4V^.\+^1Z)e,~JQӏ'ALիe*( }9Y 2ӝc鯯 1gNɧP B~ֽͫP _^wܾ]eYװoCnTUe+aTMyU)rUipkzaֶB= L=OFA0S(kW,g:.͆ڿhiGJVαC<&+j}elͪrJ2NQ TV?Fi]aoP*]!J_]$îMJΏ GB[gS šߤ&q:p Rzf/KDCJWL[WQMuGZ0eR$v#ƨgƲ$MAo|D㞸A>(~{LmOoݮޒtmjU_] Rbi#jҲ$+X8-ji"{䂑^Yl8#1_Ɨo) =&m;k?QiG c[~>Ssd~hivϚ8[S食?nב7?;iƃ]>DФ9P_?xQS9O6ҵby}.s~SW)UNM}BԘ:~"'gXMz}ʾL{wWg k`R`;u{-),YR4gΜʅg2b?ŏOߛ8r˾y~2T]ԧM{̟o==b_Q%jk/hmc5F mӪײ&h{1ﭧ@Y%"u**~{i]_P̣Z8--DY:n|>#{Q?'*qSVVƢn}`Tp&;n']}㇨%w#Tz\}5oT UUYMî0Q㸾#\%UP}qoY CrMա~eVhvcg{r*mT4ӡ'pВ߶C):$(d0=wT I|PVgٮF,R@ݎjQ:s*xK>U:]c:pĞñHN]ֺO^{֫tyfcZ^z^oɪF}Tޕc@y/M2OZe j{ԒiTžeUG+}KJxH֭u.-y =WzAʩ_RPުa-wuԎ)3u(;[kڪԐe5*~*QQ'PI$*|O߼YsLOKr{93{d)yM)P%ӴxLIJrHI%CtjQe,d?T*[竖 +ߺPK# cT׹&IN{༠(Ov*x̒Ǐd`-*R\o;.8sg. qqU[nTdddYJR  Ϲ[=)=rV|K%Md׺7:k;4xx-Y3c%Wſz]?9sf{A?Hwo|K 𮑶 +sq=%P9OJOy-{P}ssN1E[ܣ;"˫|3%~jc~d OЄ1lثZ|qf;Y)B#몲MY6C4xxi$AkDbrJ 把 E=W;MԺCMgڐ䔑_3&cNI([OE,XmHS?stMsz:Zzz4вL:a%9_t'²k_jIy@vTϻ:T>zG gHr*-om=OxH8-VT߻Tٶ]6C'yQm&h?EMSq[iidRz)p?T+ybW'ӝtb헚&\&q\@77t޷տ q,NisStnM~:j>>be=𡞈V@5z}-=.B˩RJydI Qlz]6잞Jtf3}5] iC#RŽmv̪G9_wת=jsf&Z1*W.zI_UNqH%MegPUM?3˳!QF-ձ^&5\\uK*VmO>&c}Ft2˫Nᚳv0DC(P <6GSV5Pnn[?jʂyz?u˘jCǨz~ F8urHuTw`|0Tͼ:Dڭ/;Og޵m}Af/5j6U}m^h% W3?ׯ .T=j|IHH$Mf͚oYNg|l֯zwF[]m;%vUۜ5k:vMn}<hWi}VHHNf&nl6t*$$U)hZ!!!ھ}j֬)o"tjlMah ڵkk֭ڴiN:@ QHHj׮ Mah 5n@b}A7Bp#}Eܚ5k\]9v~ h޼Vrپ!F>n!F>n:p5r*pք r\>hР\"(T@#0TV-WW䀡>n}ׁY%ߩ>|*\У!<Ѷm\] p}A7B0>fpG7By¬n}A7B0>fpG7By¬n}A7BPٳG{qu5"Y*nF Ou!Ffy¬nF Ou!Ffy¬nF Ou!FI?5k[\_FuZW.[~jV.[}2exbVjU;L.2 A^Amr2yWdsjFvKv==BdJܦWh[ ouqLU^y*Vja%+f)3˪%l6<A@IJv*lpZExS ըЦ}YB+*(ʘunjxYdeH:?($uT=7mY,{v.#\F[ύ7n Vy_asgEyJ/҉ e٬ŋvEYr4o? LłdIVbفJLR`pEAH9rS2˯l=5+66QNWT}ygWJڱҝNe٬SeU ZXH*8ظtw8S4>@Zj x|t;U[TӾJXjnj$YJ>zHUGFʺ -[&eWa5کu5_WO5^lW-sA>gp#}A73 O}%2F Obbbm6WW\A7BμqWRfp#_nw=N0STl(ajtӗ }A5"E1)O~iūvYOg4@Ž<*F%˼n~7: A P>ੌ4};MSRP@Ζ{4=p-Tzj+|J2)Cf?h'ckݩPZޯzQ78Ҵ틻JquZ̺@F<}(UOܠy_>&T\GRӴ^}H"qLL]T;YNT C,zHU/+LѢ(T+&&ggpY±d2)&&ԇ,g9Y뵼(| AX&hVs-X3VC:S0o0Zr,g9Yr免iF~\]HXpzqU>kOBB$iʔ5kԼykۑ~XU:mM悏'LA]ȓZj*ZVRtttxyyfYfRǎuɓ'>ౌD:8G,Z,4ox'<*VCOeS?VCﯞ˝8iVdum>.kB>L *UFeK^ ˫B\T/ A8즆C^A$*ݖ/ut|| (c>i2g_hOMM97 ^7e LUN\~Hk-׶Tɿj尢S6j_u(1S w6S83x4n>l{QLrdiV}n)'SܟxJ*" *vlVE ".C:cOz_FVY?C]%˷+iݺu~nܸDv7 Z g/**U`>੼oԽ-S6h3Oo5 V%Ygg(1)K}x+-~!%,Z}cd=4V?L&R}URvl>tSG6+TYU)%)C/)2̥UjbT͐-qʖm۶W}SeRo:w3&T>-^i_Y,L5[Wb,%=ê#CU6X9߮P%HvP2x*Y^7[*ZrO5^@EuW*vw(-YSy5W[Uڟ%Ӧ= *w?|BUBUX%~}-**Jjru50tT>Xm6]W>"ʙkVݸ5SYEh̙ 1112 ^} )>;4sv>;Ҏj_J}("ʻFڨQ-tQ2^&pBާ]?jeZУ<æĝk.. (WW}SefL쭐P՚@D>੼;d|&UP`oV @aǬn}8h+|$id)fݨ̺9} (TRiݚɇZvI7d{UqJ*!zj"(Xeueu]*Vʢ H74&Hh۴!% L2~+gΙayʱɾ=U+w} iC<hiOj>]`{ۨgYb}r{~zz%ӷZk̳jP`#`W[zw!1ZCtBQJ^jD}ж^]wΪ5 +P> jR?k͟O6.^Y.֮4H-<<'޹{^*I=n]/կa*潛, `=<A$kF]D-Ia鶇[ ?o՗4o@L{٩.@}} ج;@ѦB$@t`62YJ5}vhţuٵӛէ]*0 @~4Gm0{.N=pc]4FzLzj}&sz?L_!j:;@Fj3_ܳZxtFVg%PxI̓n;fkp<I2' c}6>I Ή2nkvY77PLE&O9@}LV;w FC!jdP-zb 7+9@DIF|Gn )׮Aة(\dzyϏ}UHOOaJLLv)8'WiBmwi_l+ qjìW!vuuf 8eJXiJwz zwk6kx9H.T fۑ ߶7F+vu2= ]k5LC^wj_}?{e;Y(+lB]+݂ej|`o_-A27@}6םG] =ՑeioUIߵGrBiTKMRnJB[rA4-n -SK$6Qrm VrJfEhK5Ag4;2`n]]j j1 TUx  S/ݨ^UԒPѣxR덨DŚVxz8=U̻m]N9֣. EN YPamIVƓz=zk@<͞7`5 1QT*vzKg@ ,N-[$(>O}JωuST]VٜNU.pdU5ZGjE>Vn#tjHvR6]͹j^C[S0KK 1I*W~]CߒBl\vvkJ><v}F‘>@a~&*!O?oVtyzZ:}:*-XQ_wsK;fbB*MV-dڽVksreZ= 5g;;q "xmsuWߖho![XhKW˛57Qߕ9ＮK ]kټbl*ۓ{ԱDMA_6Lv ~ִF4 IDATV~.PaWlL).JYd+0J@-!`*(9goқ? ,sDzjr="-xp<P3-?RW<?Vݏn UˆJ8!/еOkU  :O)URWV v QkkKḭn#V/Z6}# sEvY&X늎ZZq*?SGhӕ2@xɪv!.}FfL ׶st=ڷޏ6~rm׆M%s Gߦ+[+] UdM6u[m8~ZNB~"8Opg8cnQ˦ @KV4~Bうث/k5R(T^^Ip|@xrj5# mb.4Tp5n.@}êm}%Ƌ7i))n# UzCթYBBBD]%.`>PyϏu} Tdl/Վ rDU@ftFm^ ې$V;ViºO51>`9Qxl *\*Wu:U2 C. cޛW~ڭyD}`?;Bg>[-:偆ʽO^vv&n\H%~･oTFm*1"ik]K2,2١wPFFwN D fMY7K_~}{1a991jc}6>`lZT:|8  e/ߝ[3IDKnO?ҲroJOOWZZU  [[?LIп_Jz%wː]9_ԕIgh[i]'SA4b֯ݨ Вg߯3F/ةZ% vNsƕ]I10R&ITqkNc* j }qiw_Oa{iUGh\ IrRNyK fbq0 %&&zp})W6~^3?եA^(_B ^vvjs!a}6z!}P#JKKv }|Ab|NMYR/Vڮ)8Fg-ɩbFeL^!|>S`W +i }`_>Xv3J{C\!MTT~^C_XuN55ڣm9Եf覄ڒ8z?S:>W ͂d1Y&V1"ީhj(/P;T[nSA^NgRG@}5tau,r:2$7;kݒ N'򤦦s=NS@APsVlN6.Ym?W[N! =0t@f)T~ɡ/+48!]- fk]ٺ p@CCPs榊kS kUv|Zh6I^@3e%ںgi-ds:p8tP%$$(11e*0t)e@[}P,w`:v wg+GgM6W'}бf5y.јoZ@pjc~vSFwَe$y4+==]aЫ@E>!Cj$!!%GB54o@!}|a}6z!}P#@F!}|a}6z)v@E>:%>>%8tDo}|AB0GPѣ!IOOWZZU C>>U@>u=>Vn#C>>j$!!A.x뭷]Iq{=,[)+mW3Rޮ YEve-_>5_. oׅ*55%@u{}N6m U-d6+E7%Ж+222]8N6dh#A@1 TUxTW$ë9j)zԅbpʐd:!aqxʕ+]ZhK8.N6#=VlN6.Y 'NTeb>Zc WP%+}A@17U\mX2[;*@s6y2g1t@-e@[}P,w`:vޮ ]}?Fޮh G9u`b-HTO=5o'EX]z(ۭGE.E=K&~ީ.RZ)WP>kt։~jJs g)PW6*eڴHSzH]i#mľW-Z_w!EPs;!sW9ZVGwv5'DUFoZRN%Z?oU=8v)љ~Hp]s]֣1Ƨ*ٴXKrk)ʱURQ*>yWl/){e #OP6R]K~X% !+HP6?kUOPWV}mjV=]UKP~h#׃KCxUҺ"m2YթK[enUqkI 3*),;cڙWgtQS,bյM[w_))*hZsmP5\$ B#v6n$5 t( fI#t~BDF>PaAB"_a -<|[t"EFG򟚯s+(@aRIᡪWqvg*j Fڳ3_~Z4swT}ʵ{dxXۈY*`|khe~{% *ڷ U}g"^dpbOjpf]Siʲ+5zv×sj96l8rf if1JU\jNu6FW_y]k4oUUC;1ŪKCYjʽ iN.8ELڬrUteZ_.iTP3E?,/יC{) UVSNבOnC.M֣qhg WgCaS.h,j߹{vq>mĩ]|euWk}if} LL UP(wAB"FlT`߳Jާv Saa0("B[ R$C Qll߯d$pH3h1+FLA v%J [n^0_W6& iBSfp9u2^dRp8M3_mMEpujN o]U.ɱoC-TPCC $>?Ѿߴ8K6UhUXZUu13f\6DC/QXBofZulu)*v]V p>Dm\٫hyf SB('k.UNYBŊ=~hO¬6IxVlnnQٍ_ReV:n8OLiUf V.4M:Th`{be5$>j>R:Ը]/ ­]*ۈQљ2ԱO-I~0Y}[P/&Md7u¼y4jԨj{kO0]rP7p( }D/MT^OO(]B}5W TAtm&)@.t2Znަmۖ5y*dZ\>KN?-ׯ__]/<rg;L_ouE㪃]ڄ[Ze6oA7?+dj҆5sOo{.h^7Mҋ3 ᒭz,=iu_N=0wE}B9W5Lmޜu|l'yڶ)S%VjU8E\?@R$<\ RueEY;ܫI8mW!$YbGha2I똨vuhi}.,ɬ4.QW]C&I~q;ϝߝLf5pF$ssuhGgIĪcEyatcȵoB*5:EgIg$[]ze?/_4}Mzz$Sz4N| &ctlu\[@fQܝ?*&r>Dݟnkn?%nxG gs9ó)(H2-Va^V1G(2⏿"H_DcP[COkXXfƉ)l~qz~j2ӽ6)::cu@i]CP_;>v4V$]NP+HjqzT|$ɕWE /h^JbݖPBB<vwjOD_SIDi &5}j,M&CG'0TVRzjw0ʕ|F*XMBti:?o,>!N텛zCrkU-:SYow"GIJNC(q,M_],ɩ]߽X<얮R!|>xbF\3OxKS3)G+Yytl#$c"}YM{O1F>!C>>!C>>!CͯkX[5'ߐYhИՕ*4=\Ѹs$B;k#+}~Zpߧcr>[UHʴy,‚ոP=69TsV覺a62^-I?ƺbC+^]*QާۜUTguEr[5 Wk1ŝFGi:VECf:m4t7l-^c+ʬ~n>Wm#BZKrg ^%I}m|%7=v~rJ2 ?=#m+(ޔMz*KcR+˱'ujhZAsYmr%:oRb5릿kF!Z%Hdf߷D*-hHO_sr=s{hnV>Ҏ?}Q!..{gr ͳeV^UftLЧ^ K79$#oG3u+Z+DlWʳWjx uzfnI2+UvNO6ߥ|\^ʞύR0$JأʸvK@y|/@$ɹ^϶kԽ;3)KU!?u7F>֒z P*V.Ԫ/$9ksVulr٢N*ظA.Ѷ7ј+תꡳ|k& 9NAM+7uoiWHP/7>24 >nʎvtP{uj w)m"1 6qI:4J=]{/QS{/UYG:ƶU灷kC" \lI#eG_ǾH?R&*ڶMd_Z}Unޜ)#%*) PP`^ Oۮni0ōV?cqk^Խs?TQ.e{>h=/BUT{PZ >IߢϴpR:Ԧ@YE9ٗ;.Ї+h˒ wEG__r],.QUj]Fnփ7LFd.mиnSGk5[;ܞy;n"IxulC3'{&#@2T\TFnSUZv$JKej?r? g J˴Hzm\k=߫++~0ET[5c5um _5hjyƒL Le߆2ѱ/˯n{dZdk>L7P9A=Wq^şjt 7-\fS#uZD+ɇv$ɦ +w=1k5C11 1I25RH[ǮP+_fRPpJJ菶Q<}ot% IDATHFrLr)scBߪȪɦh8h~{‹$JEi8vߪgJ|XMw雥ڦi7֫Qw/ V㪧I7AXM^HwR pJIVIe!j)ڄjad^a-D&_GI* sU6 uX~hRBMns}RP"jݫWEVY)zj$k+wIQRy =P̊o+WfrKR\Wߞ|+y>!]{nBJU\\2{3׿VnRrSvn3Bޚ8ZY?_e]5oFjXY*]I7ݮ;%sueħXRzuCϲu_K&]sX%Tܨm½r:h+jMy:'|y6;x\ꧺ&Bo>TI2|cU[PsY?qfhcV A}e+iwZw46)ƚkuu|Z꣡$9?m.mBw+mv]F9fDĩh=eIQMC?8D~"E6mPzCa2FiTi)1^{h>JOt9a@tmPo,?GwNn}eOxW{+9FVś%lRU.s=VtЅOѓ}h4_4?e ^ｷ]7v"9}zl*p T'X]v)X}{Lͮ͋[$m4i1n8o ӨQ=INp}SRRԻwS><اic{4{bkZ֎ׇߺ6y]N+ўPV[IJe˔|}l6 9d̙2dI2e/LQin~5Wʵ:PL!_rguӳSmuk;oWqVboQ̭7kvF>>!C>>!C>>!C._l2o \rrKP0tB!}>!C>>f̙.Dj 99%  v pB8RSS "F{>-T1t4*z!}|AB!}|AB!VI2e'I#IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_tab_drag.png0000644000175100017510000020257115203313266024375 0ustar00runnerrunnerPNG  IHDR9JsBIT|d IDATxwx !;HW:XMA,\) +("DA@&]z/iٝG0a){;3缳gsfƠǏ7 z_DDDDDDDC5}%Ȑ!W*&|&cfΝf:wɹQe={6C5NO7M]/""""""r3Əovq4gΜi4_DDDDDDD_DDDDDD:D_DDF?^ȡ21{ <'JEDf'i:V΁D2L7S^kbf˿)kLlvKAm"3&ZzH:'o7SiV{cInI ^>kЎ'nڍ6J"͖LGjX(_ TKSE  ' `ƌy_JOl޼euԡ}ݰSed͊=ZBisna7 ,.Vdy4MLp+GPw^9 _Gló]BJVTKSp NۛSr&FLLL$F~u={bӠX *7iC* """*D[n̜9ӣyI~n8uEuI=ԩS9vYGFFҫW//agr) Mi^֍̔DN6s$<:;+lG:r?}=>ԯ[ZP{L6lXÞ2%W<-ܺ~Y :2- 9nV,!|?#k~VU=;Y>נrY>ju &7boԈϦ])>2wy<%?.#e,_3!w05ᣏ>AzF'LMMM=+ӭ[7RSS/KJm6{fʔ)H=EDDɑN&~g;k<Х^o9ymfgӠqNfV|l{ ;4$$;nЅ^ڈ͎e${Ӏ_NodcGM:Lm g-9,O7ܒsַ4sVg _ANWDJC;w mG4[ÙFFv|"""E*/ ?/hʔ)áC(S xyy]R='''KN;w.ͦED&)[IߴWo}: NsGE׳H^MͻO'ӳp/] XT=-+W_cHNna7-`ZZr@`5L LRSX\tK^ }(H'%ՊNYc2NexuYiynS/""W|ccc/>{;===k:Ě5kѣ\K_bb"!!!4hЀ%KbXHLLEDD(AٜTUoH]/G 3ibfpk5+.:/i$ħb˷0e%W1/ҏ*2$e,xbsW(Ųg*X0dA&qvoHb{2ɩpg !MpguO `\4kBLLL[l˜?֭Y뺬RV-233IHHmEDD e]3kӈ(GvyiiSR[3 u#5CN4 :0O>V-ӆD&Ŋ]EqL6/ZMq11pp#66m~|'νzެGܟ!-%WR8"""7 3{gϞ֭Vf Ǐ7[h6Yp+V^X0LlY)$NCqOw\mdAiBW8H;CRflp78/kf 0}2Ldba?O\^nV GRmÑMB'!e%s2 _?)ƥ>!`e-ߕT/7 [ɉd>ŋv[ɉI9니U_}냝D2/3d$jLQ*Ѥ[`KxX38SyN1YHgAk/""rR/""rL =3$%"""5%"""7{*G.t}\/苈\G\"""G+W韛ȵBuDuDuDIT(n[.1kCJ~ &$<;(x.+f2NDDDDDDn $J|OWc9/6N)I_1طzO).(yJEDDDDDĉ.n~zq_<­u*PleZ]ϴ :=5Bhx:g-J?@^k[[1fG~M7Rvs^^i;%_o7\7nUQ4.$co{ͨ^klէjT9UkˣÖo~:5"(ـƯdݗCh[;ek%䞉0TRμX?{7VouY榞gݼ6 _ޠkR9LڎS>*{}REDDDDDu蛉s5hˌTB!~)!so"u.kR1᯿~妮YAf~~d*+op+Xp#L};vΣ_ivOx gy+a{<6wYoIsfww޸m7К|f 7f2G bOhn6~т O>7'w[gl`qt(vuDhm {^߉cUL{#.q]"2J 'oÁ7J^Q? D}PgͶf~Aq &t4_Vѷ9g^`O ml>TyB/-ڡU''EeϞ=PZR|yg"""""rùDHH`ӑ7߂֠PRT&./[X;g Ι{`&Ŵ?e~ٽ*6-[$-dgXI`oVE:n ?\]}ptClV淯Gu;|.u&34z=FbD x\G%W={X,l١\֯_޽{tv("""""7KϞao8أ4$D F|gcͨ4sG6^gG{o<|3cM:{λo)H@ Gz,;<#$ITLΙztnQ?;k«Sh68z0ƅ-V#[nF'Q)[lK?"EK/M||<~~~DDD`.Nd&irQ9BR\}g m܋x^zRKD0 =zZaXgEDDDD.1~xo߾_ϴuLYx\/^Lnݜ5c̙4o\I5byfT+iڴix=ˡ&}o"""".%"""""""ב~3>#3&H!шȵ(sCB1`ú^DDDDZD_=~JˆWWWܼhЅDR9 X'xY,X-Y뽔rI_S7C:!"""".%"EJEZ6~|6Fحda$93xCG$3e\FkN })M%NCYTT~{ô,qƬy'-ux7ەGDDDDyJE W juzoQo1/)S``(B(Y-m̓wOc"ZƞR37r͟..`1 \֌U(H`& zg6k4! >7cg5XČ Nϑ#GrʎquRmR֛){W}kΓ苈\%"NNZa>#IgŲN~.h3ُ#c9)2 Xq;S&KŵY>[1P_NJQsŏ;c?Y^ ?m*QJSOXҾA*֣ȥĚN|8 :6FŊh7vgA։L-75.:71qЭԭRʵ[pϨضIJְ3M-^e&8ŏ@4RN;aPƃ<$3Dv _XMeW<+ Kxz׭!.Q(f F<ȗcl[6+`ؗpдy~sS>^PׯX~.S/ ٱ8OpG| % ==Lo%$,g%84'9u8u:'su3r<9=ѐbyX*Щ_ JkV ]?#3s5kP;JxUI dMZv {e}(QtK`[ҨD(zN)7r-hV>#oXw5x.$w=ܖn`Cu"Yp?M~ (zw+N\Y5x$"/߱ĥ)TsJ@QN!MXJc>K,ǢsNo￣ʘ<>~̙Ǧ2\n=I&Er3ά'&e-RJ%FM{OoJ|*Oq|Y|=sr"($۪DN%ۉMε$wu{A;Ss.ESt'QNO^.׮3%X8s2joDh݃CM#!;D/BCOVLe'""""\yĜ 4]#Ktsw y';ן.]clJb,9fǾD ?eij q/1M{r 2T`Xk;_dbğ9ib; ;zf< |Nj.O弓؉>?Ŋ]gmb˖-lٲ櫾%r`_N`rr۹'F b8s.1'H!tNWB5CMݣ)e;wfqrЎ+ggSl88p!Gڝm(i UX?s6u_-O k)WO Ycalˌf<:9&pUpIxڽ33>y/-t?:ƜzpEƌc]L}i`.,~iGϧ zNMpVroؗG~wg m_/MJP+=q~OݵStݳ;f3wW` :Oig~a8k?F5zD/ƽ?_ۺ6P1~xo߾ΎC䚰xbt0?#-Znʗ+kCL/3&)ĶZo,xޣ,}nV)ODduZ>0?N?_aטԉ*K{ȼ`kv|N IDAT0ov漼~uM*GY1}F/'xgU!ߚixs,-&OHБO:e_{7z7JDabxYJrl6ӆj?GWȿ2c,ܾ+R{0MޏGÿTdԊ]{1/}ˀf;oV՟lzf/Рr}>ൎ4 /7rWbw0g0/.Lq^s{X;/~ofZ=6gC֓Omf{(Sd|f>!.Lye 6Lxu?fÞ}ZoAqÂTC-Q$ߎ\GLKJw譄56b 8lgOkPk Z>zKgknn ]"04}uKodߩr`Z5O@/@itڤ$^bT% Jyb1|ռbNomou|AD6T:q#v %"JCwiFc`t*r%1S &,z=P|b9}zZJb>杒0| 9! !XHx2XbS*Wv#VD>S#U`ܬMڭXRqؿ\:xÁ+NxyzUA\+>p4s'H hDKq" h3 Dd,qhDHǷ߿LGIO'i7tS?{U3>w3)uo7d-F1kjs9şZ}^^O5=j|W[–m2gq3d%mm"4q:up7UdA ib$##waͽ)xߟOK[˄OVS닄[ifd<-~,{2{[>N|܌_oФ_>䋿jgL࿌tȶa'6]0f4Nnξ T >d$$=>Ղ]!;esVhVʩߔE8fyY 7^"L-zQ#? ܑ9>ق _39űNkƍ߿ 2n8[$5f_,CXXXN) s|id} a}|t_,'wԒW{.&.Uo_CiR!ިqv?'~ߓ8[:\}0L uyri6}3^oWҥQ;]Na_V$tkt/|ܶ2UOdo 8}4='Be>vo`ٚ}sHgCH:uڵ+ Jc?, 4y‹ϗ=G Ma'[x1;wutMݟ>e!"""""We˖_f͢M6޴iӮ]EDDDDDD䴆 2{"[VdI;V$u_]ΎBDDDDDDڠ}}}}}}H&/.DDDDDDDfemڴaϞ=_U *00___ʗ/PDDDDDD ٳBZ Z߿{P mFBBqqqEDP@ժUUC}\O~PZlYUe˜8mΦYfEDPmذ۷+G}\5/EEnL ԩSaurIgqUP_/"#g:/"R0Ma MSϡ^DWUM""?""K\t("0UG}\O5"""""""\W( ζA)?Jhdvd\D"-`PLA0L:ôsp-Yb2~6α_gy;-̜ [kkB"-PQQ˥ԡ4)>TO"G>6 ^Rr܋_F- |Zo&T M)=Ⱦϻ&OL/ԥd_Cg뗠 kO68Sx ߡ]P^4#?U{`2}Vwy -^ .7wGkVәI5\榎-p//AŠ*! ~oï ??#^n;YyO5nmSoárKqw,Ky;Q jԣ|-ѕX:}1)Q[U.)- ၹIƱ1,o-O<|X6e?LgI8Y wvXͫkƝZ yP]4 08{_ٷe+GNF\+T܁}T" ZՑZZ]feۦ5,xڕrͤ~ ^eS-yuJl;xjn2Lu{k\Tl8e;GEEpK\\?yKޣ *£ѣh iҳ^yJn1ot-Ԧ 2i/_ ̢k8b봖Q:sdj 6l ՚ݿ{1#Xja nO81%+yߛ$cGUzgJ.m3WdȢ=xMr ǿyoA܏ S_Aɑٷs<k{ %#d*?;AvT Bncr; /1c5??Jx|ǧJb&FxCZ AZR=8y.Qt{=L Fċ#b;buVL?<&͞?q=g5g%RDLG՚#dYOv)&wCBP]-a!8,q2X bGv"r=;؛;wY=y ZA\ a/kSPM$T ?hང #>ϹY1m^/wo@]_r }ib![mYH >C wUcu,X8L{+S?` &Вiډ>Xy%T6e@_nW<}mNJj-ox}y3]yk8_Z&[,c397 &6Y(Q ~-rc"|!rbJm!}W*Ϥ7pQ;~}K`ggO2 zshʓfgM4O[1= zG>H)^ez]t<>wc|[s\y殞X)/A&saIM]Ps0;@߼wQ3/5aPnof7McmRƉqak:9QT8UX"+V,?k`0+8N^2E_zhdnd;o=_ ˜W?$ko?}EsP瞷w8>@oS{Tg%7qϳQ,>mN}#:3~dB)ЫgNОϛgf4Ɯab$`pr 2M+@ '8ȍ3֛]}ߧ/ZߣF+#q7žxGKjA\Lv MO~V?i7/u/~OvͳG/\~Ǐ7[(-^ݻq L-/a6%uLt(\ܸ{ڴi0Xx1;wut$$$0}z]qtZNՂy *oaO/]o+ `;b]]f͚uQ9ѴiӮ%=MW|>]0D7^~@y'=XDDDD:P$yk\I;X-[&M\SDD.aZ-[:;S_/"W}j?>M\Q6g\׋)BǓ6kgS_/"W)/[efu"ߖ)}___֯_Oz Z____g!NQ_;z\O#/_{l2 jAK8/0Y0p8:K}\- X,8 QGFFv"raDDD8;Bc&١\׋բnp8رc苈(Ν;IJJrv8""UA}\-,YR(@ ˡD_Dj:gtaB뾈8}}}}/r? |֭W8k zCuI&^mVZ FDDDD䚳cBqժBR\ESۖJVQ6t󃎢lEDDDDDD) 7ѷogT "LUn$Jթ3?ݙR~ UH!)lcphl^mu{uaSxw`i=v'1~!ԽܯX8"""""""WLk[p@?5猠MP>aC͸eէ%u*l"66Ҙ:O #oŌmZFҴu] \K6㖊'9Z ;R㲟Jkt3mzQc?nvN&!ndߩr`Z5O@/@Hg?.苈S]9⢉ $A\t,sRc Tۗ/crԩ4o?Kaĸ:9|}KsC]ɍ~eNX7r6ks̾[JlPWe wڇ!3Gy77! v;C.{+ߚCzG̽zn:M$"UApK;+7򮔣*R˙0a):>g IDAT9{0>ɗue]0ߖHT} tID_: *[!=9 &f˒vu""""rj$#RDDDDDDf%x_L@ZHmb|""""UfVu:)OJEj+̟_c, (8*,DDDDD_}ڪd9S?f0eWDDDDDS/R[udӹj9&w<]T7/"""R(L)iu9ssw"Rdl_ٗgI 쳹:..RRRHNNvu""""RJۗ$rssIOO/]K-B@@W'~|I%KWq`T2׬vu"""""r5OJJl6ӦMܭr[n%99Y.o|?5+yio`w,:A*D?77޽{.Ef޼yqdajB+.N[>y)*\kT `m@CEL_ȇNWb4TN)hbt)/R[p]=K0+`p`_@LʢD_2n>?KY  iթq/eaBft6˓؛9r~ -NDDDDD \z&3GlIcŅs1TRSSw"""""rJH a{?lm'_q;|cQŇ'R[2F#^~l#F``Z-J[.**ݩy?|{ Sv:]͙?S̼fmsW0ONXODʉߠP8:x\T+/"""RTxo_33Wqߕ4p=t_>;.~ ύ|0>La[BHh-β> t05Kl6ͥn0c+FVDDDDD /gKI$>wM#Sؐhz$Yַ ~}QZ2IܔE{EH Sc?9O#tu"""""R!*|{\SlDBlՈLFu4޻7w?3YYi,tyc'zϡm͑5'w}7cMOH O/"gn؝A絡q?hSDDDDD*I'O;>e/""""RmkMrr2#==|$g'6M\'zbƿ@Zj[955ݩT= ;fN먨rޣ}ڪdy -g汴|)UzVn9;n3&&0iHuD_qgSMj:&zq^XL^icWb!9 9%)sn*񉈈TW;6J^ֆWH#gO3yz;iк?:4,^%vd=vUjH_c_U  iFP}{Mu -;ney"4K*Oyf>2U8@ʚxDc_ U=}Rٔx9lm^ FU *ɝƽhRw` M :<Zȩ)cX[x{. {l)>$G m7WA [|:Өqgk0JѧUctqlݜ6 [1I;Ǯ4;4u{\\K׆ؘ&>RthCgap&ĵ׭"89?rG<2֥7:4wǥ)c _uw~9ɫ♙Ν;vSp"""""RUó?&V \ϬLLf,xjWӣ'-r#p1\z<?Njwix1nL 3&b y)q[@rCnXbt]OZMк/]"f =L?ս3yѠ(%/J٧uo^G|sd$cM<inT#/"""RT}>F l87ls}b3~f ;1ҭwNmLW9,D_t)1'lǷ6;;l|LVB|3lw);v,R$aX8o1q~l#o'6<9+xb,Ճ5798E5-z*4_d^>}οw2=BxLkM|׻Xv8YnX43[0=wF|=|CF!?>5=Z >mH5`LDNQԏm-' a|ZA\tW؋ `d?Xqs)+aFn҄Go`ߏYx"""""ƍg :qT saeZwէXb&gcn?Bӓ4&}-9Ggff嗽x%Kеk#&ge:u*C quR4t_DDDjK/{h":utuܰ2MF߾}ϸɓ+pbˌTy7?̝~To/B'7_瑸{x9߫҂jJUEDDD%"qōo͕,>z0e5|߶?Jc[颕&oVHD_ٳx >vu'an؝A絡qV 55?T z*^D2Xϛ@>$[tkEmH/vy(**JIH%P/R,]BM~Ǡ‰-˃(ʍ {&];pAfVf,"""""R^4t_2H4ȳᇯ*m?L-`+(9^kHD_29رכN]BjDs^~='&0#N,iùճ~_~_~ad /"ų[/@DDDDDM,}:Ec rgc4X*޸Bn'K%staiw 6Ɯ/9%/pL}o Lf,z,U[zsO0y| <06ٻ*ߙʢ聆#[vcS@+ؑNWy DߐT=كWwfzwz~ߎ!ym&I8хk}bsdzp/KGbh ͪR$ &*:b䲵 #. dWtoM`{25?nu2(aiHTC=iq5l8]bd|vZvh1y3^`n\y~CÚXHfyGڹ8_#|~#DϨ)[(39kobli$'e *ݶ٫s~mѫgVHBrrR*x8<*`J}t W4>xk77o>Ma4%-I;⯻5/U/w;9y'_j䖐nŧ2EܰfJߋ+H^ n\4 55ݩ 2swsw.|o'2oEssg!o̡'ZPx>xufdGxk6a|5C[3-nsmG!MOrU;rQoy.}WNO\FP]+MYK%|( 3xꏟ[j̳0QyENIVn@SC OHVyﺮaɊDf`K㶝h\ːgo5I^^xyg}DtjE@wvݯ7lp:_Ēc?4عu"ǘ?缺I>F'y{Ź D_{S_TWq<{w'i k\vEUu_HUEDDD$zI$3gO M)#zJv ۵1yd3,nvd|?/rJFsx(*wD_DDDD:D]svK)h!7|tZb`2⇕o.']TW)))ALLCC-R[| %ՁHyR/R[Y[2W&}3(((8*,RHqDĥJ⣱S%k}eWDDDDD?P/R[w)?s$Ϧ0Y!I""""UO&AAA;#Զ*uN6A}2^1U~@@˗/'!!ҜPhZeĉ4 Wpms2-v-֛ff@o3v(+I>PĶHUʤD_2asYD>=>6vYn\еkYl5};JJyW߰a͛7/}Iͦ"e"e"5J%[3i??lXM9.㪁yKN3=i>4jROD#u&UjjCjBmEJmEJmEJmR/R8C e>p-OMFI<: Rv8|?OӡO󳒛SQ """"""#x9 o[a׿Cu!;vK,V30dSyHrr׆ m_RHYHYnա^Y)mI=Ќn1{;^*:y+VGڝX<'M RN/Ȱa\F}Zljðv;䆻oW3lI>`לGn%>i/"""""G=sElےFI-dס^ q5]FlZ+HZɁ,!w'䔷@e˙5GwG/"""""D_ֱ龅njR+޽Ox>ٍ{(Mi*""' IDAT"""}ƽ;c~1CDDDDD*} rdTrnoAvWeY5KX= $s|H8uHܕA $%l"&(c[9AڹZڜf8gVyXzc7ҼwOlQֶb iJ6Î;Qi߶allc&Zpm\i) a$l] { $Ƨ,`ٖ`z7WeZˠpJVf֡= f%l6^=s˹"qB'֡OZm0G&V/5Z,J^Vv. FEVdoY5!>L65tssm寙ţ})PGŏFq(NEq步w1q0{ףIC+w-"({[qfmf޺m\m.<EHOwи\ؿ;1M1D*o=" voZ ԯO{%+) aZp0YJ`:p2v+Sd%ךbb;$TUej2g6[VNۦwK-U+a%<.P3}8G 5 (k[qp`BVۚ pA;|v,bQRF ID_D* _sQtR㇯K2{k#7~<|9YG-c#gQKgV)c[qflckFŒ3iF2SXtI^+o/(.*5V0Y4R(k[qwȸ`ENHV9$rssIOOxj>(..&''"YN:E0$S]X"|6s#,2Id7#о% ƌAulȩKfa}M8>v0cuQ^+ķE8]|,f=[QWkӵm\>洊&a֯cwX;­$%+,^Oj5Vy]Ȏps;O}V)sdgϞOb )iiiL&ZhQ,)))Qn]W"|Ӿe6KZftUJG]RGMԉH0+$'}uڼ<;iĆ8g9D ej+M8z)cحMV<<ݱꂼ8e[1OG޸Gs VΝ?v7귢cZҨm[rW,aV  ^u.Lu@Z)s$_h߾=g/**e˖Qͺu\ÌonՁHUb"U"ZL`>\tO \ɱIRƶr&_ Irb!EWNH9 )k[OiSI`εʜ觧coT\}RnnCqr{V$Ln旾ogF%DDDDDDDjd mNrjz'rfߦ>kA;a~GU)q9ٹoVny2;0*=D.ѷ+<1ߙäs"XôFplfM[r<\5QxcOn7~R.xv׭)>%""""""R\ۣ?o~=E@n̟k32q6iO1˰ξUz4(aGЪre;1θA޻)Q hk87Tv?kqdv`Xl)KW#@^[װ|R._ͦ; IuOd_$) wZVXlzEDDDDD*KYI+v;vGҿ`?>[&pZvgn}t%x0-; i<=l"ᄪ g< %$ԓٔ>m B$$6.m)+-4s-w uc|rRH>0(ػhZ'QT F]V4פ}gV&!Z_f"0؟lz)Ha'3ÑCF;u"p3`%<܏L  0Ҡ7V }\;G? 2l18L?(q\Npw?Y3Ѣ񈃛:K(J8wǯ\k,Y쌡y#ҵ=ܟIqv&ko pfvZX8vv6nVga۰9 ,ýԶsEDDDDDD*K}KL':x| 5}уQ)>Dv|P"UWDp| >3 Sb#2&IѰW,%83Y/tX2"gcy;Xqnn/cc NZGe:ddPJ;_eq-E8G~ w!Av͢ÞǾ}x~Y DDDʹ!?γy )h*+2^xyR7DD;}(n+ÿdož]c^鋈T7.‹`{Skn| SUwu%""R9/b.#f#fۼt0MX\@&ih@̀wӎϞ wpam.H#/b/OοgL`|1nbod?S_ED*Уx>;ꞿD_NߗTWFv&%A|qQůYNY`wtfpJ>s\p?F6Y-]l\s=I70a""Yc !н W~6C&og9@Z4dF})C_XeNظq#M6գtqFʼw&""Bs9NكC9 -F|ςo7=}vf>1'pjtY: ./1Oe=9bʜƒʕ+̬Șj -6aaaݻ;v_>>>xyyPDDDDDD\UTRJxxCjJWDDDDDDDj%"""""""5}DH D_DDDDDDQ/""""""R(A苈 JEDDDDDDj%"""""""5}DH D_DDDDDĥ(W?+c7zF #_'8FA"ߏL'y3S _)fǼywzuN n {;a,-f%,YrjABYU9}Μsz,xmPAnKxY8:Äepf˝_}hÝpYx39g?]ㄈK1X.&--YÇO}O} ^W_>'PcnބY̹k{7$="i 3MԷ|ontOXחP|"Lƍ38D9s0x2;|}L]d ]v=>!a>Hm|?.>9Oc9 㜁yixy-SN] T5m4{&OkHrT6?ؚ'5Ü?F}|/>1' 鶯{sU*|>:{¯G8 xunmѐdok|ri]NpA'?+t1)ӯ#g: MJS2|9y f=[]_q龷"2}bV?H}Kk?7Ӯj/"""""2$'q|^XBOoo O9Ot[>eyu5y$=%78/ߺ]x*m0/?AHr^Y }.V+CF^^a۳}xz{탗#3/^͛vp'OFQ(q#<3>~RY7>^EMdxs֙sM+qQq$ cJ|rS#%>ȧ07W$qo{`'4 ?70y֣pq|bL\7Bvadɋ u&<}1Rx#"o|Oe񢨠!Z|9ݐռ>z1N^'YnI^^ѿ9JD_DDDDDULx{;;Z4&-T)S#,}4&ogLR }!$5{G]IWp:p8y&6`&PȦ]f++qcsmIް)qo[)w/&<<.ϰ4=5ϸ$2&0AŔ苈71uٶ9?}tgŻX$uoL:tHowr'A_*)vx0_<),qظ`dͤmjO+q~"ENT~ef5ENb\l8r4Ls+8rv+*8%ϸXR2-o~bg+ǿM/_RY3]Fܬq|!p ^4[gX=uVj*VL6 _psc ؓټ-h%""""""rJny'+2\@HG{'</9$5y9/Z̻`а +1| _\G@? ˋ(޿׮jG7\#yoLJ,<ܿ'ME Ak}|| jܗ2@/;u'YYv<(Rׯ>I2Ys;x|ya~a=xA>y8mGhX8_aupx+ZTB|뉜x=f2Ä7cZU$rrEs ^w׆Cq>W*acx"+^zTSpԣ/"""""J>x>3g_}ְdG_'?{Eq7N*!$E  DE,bQ&(BP ]C AZ 2&s=ܝyv3̎IzbF ߹J=͛n@%dQkuҋuteR:}:OQjEH"$x}>^D/B!EH"$x%''{:>Pɵk!@!EHp+Vuo}l˖-ҥKUr槃@4zh-Y\M>PNڵt*+VhԩM7ݤuqI-TV֙eH@2ML "ʉavi~^FF$in2MiPRS ڹ<P㥚5Mթcj$k>PNnaRnV%'3_vv4o:~Y.>srtiǰa$7JN6tUr7>PNNw~Io/@THu}KK;7w]Z_Lh 7o?zУT`'.GT^'^ϧqH"$x}>^D/B!EH"6On:edd(==ӡ@VTT7nP* zޤ"$*upK.ʕ+~z}NnP˖-=VZB<ӣJOOi<ΓиG[eD@ ocCphxOУ(R IDATfiTbƷYMH/cj?ܮ7?~n?|35_cͺj><`=Nw譟TK\֗zѣTr_ipokOQQIopӸ6jrA5;u^g#G=ٮTEQ5y|r42RPETi-)Voײ[D'm=Lr(o*sdkM t_wtAd=cIh}x[O+2sC[_>OSO""Bv{ _'\M/ig{dJY^3P/i&/D~_Oֲ6wWB@^J%711#Ky9{5rڲX2$H ۯIwՅ>YNǖd%g^\ڻ1]2ueԨ&YP\}9~vLs1(褭]6 i)7›R֟ʼw_gK==MKGݯo2\=P*r$} h/]u&㋯+4F r΍|A{.]~8pX9trI2 [%/[[?ɱ+=,ՊZ2JdeB]s}uu^?C9=;HwqW;_H/|}zO5)=- ~֧?$htHC͝<_9d/»,z^,7iݷefm٣=iS_6U-T+]A.l[m;569Z55‡^Ӣ#̌oTCuX#ɩ;摒eoxxncë~ZF;wnҌzqpϚ>,!~SE|~__<:E9sϺ'}xxrҮneە5%}3Rp׼]?6U5X- ks4 9;UJJ3#N/kܜ֖%rL_5Ey>Яg`K5~?vGӊK^{]ɯܫm?҆]{sz 3,L.mTokV4Sxm|#swUjyaEEXZd.*`\feΌzsmꊇct We>W7*d;kp?"oJ;jGVWdDbϾC;w!4eķW1E]]s'V_o죚stQ`m'k~VmE" )Hц)tjGucP TKАo5eIZ5]U*6륎q:oŪ/$T{"ٚݮg/OS~סc]ϵ<{9cK6rGZeQ`~/ܯ9Se^CUO?,WiJK<;P鮷NBҷo__N,+m OO+| 5UQ+zi䯕v8 j{^|2PcuRoQjn9Bi(ѣ)c?W>~gu v,ޠh?:K˟xV数_:S;ޡbV>n CU{ߤˍd?B#<)!}@|w5@w}ER kܥyRUɔiigtչK7uq-r(KUD#YV\. ?*G/,UE2MPd\RMqr^pxQ8_l~a ;2*ՔYСsz-<(Ӱ;-{Uli[EVq3F(*k2k_VP_Ey< 5e?'JP9r'TyF53HYt%?:)}U=A5bcpJ]4YӶiQU% &u ;1k-S4}u]k5r[UvJh+^[_I7\i_[j= -|z@T{wib󸮚zuwqC:=5a y=oXtvjZ\>qMRzE :ЦN4~ z(Y]9hn;_c=Ó6MSQWWOn~N.{Mr?7|S֛"e\}}xdȅ&?te)2,Oeɐ:,WdZ=J6Vi*Iڹ7Tբu,->uG9\C>J{Yg;Zo\s+%93(U贎Rt9`Y$9(EX#T-&]z~N}Icϔ}53~UqujheJsHreϿ׎3^ˡ%Ra}wVsjuY{|YY ɥ]h2lHJJj< 5u)i=k Mߗ}\SҮ˵-)YUy}E8*2]J~aE[:ʡw̱}X*77OE2#Py? $@%7'g4ޡq7=utg~E=/g 5ǵk+B<:rc;ӝU=6^uy\97>듬r]-;i(ԡ==55+8M\wI;kz|ogM|ܾǢ7qI?&~umi0RVFQZ u[~%K~BQCݡzVy6Էu'h8_O.J{lٺax^jg;wWi(7NzW}w4ahm C<=B \=irrK]޷qs&ϝU:/ktFḴqۨbjR뢗9~.X~LK==ozMIk*>VW}RB9x1~xsذa͛j[nY}Ȑ$Mz4]c rcX,͚5Sm=otvPƟ>}zM49*rWhxOi$*4.x#ڵ6nӘG@F/oDv +**J.Y X,r\t(m=oSy}VTT6lؠF0T.K6l ?<> iӦZv~w8p@RTT6mP*zަ"$*4.@b}>^D/B!>P-]!(Av^D/B!EH"$x}>k 5u7Ǫ;F4vE뺚̥˧_U^8-$%qbMUGr}kzZ~}?e{ &hG ct̚^E)9 IUޯo&4t횝G}mڴ)=( >s E|^5B\2GvG3ׂ1}GWkꍰѿP6GUf*PH((}L0, =*;;ݡ)ʃDU]5Vykؖ999Rr t|> [| Tj  U=TSs= 3}W+)#3쉠W$2]l6 |C{WLܦnyG;\ڹjҊ<3E,|0P/zBvj3O޽Bݽ@9!|c}=Ww.^ݮadTyO?szJDU=cP:~ׇR-:LX}Wati4,%*,V|5I7>O_ZkH;r4]vFjs }goB&kB49YpH_f߭ghOk#!Te(J**3S?QN A14|νye{N>;W՗%3tC{~iz-*Kpe3}W UoU#T!>ǔh78cS"5S"ݠ9}FC_S8]â곜#?ҔgnXd E?eAںzϫf1&eD9]Gў@`>ೊթ~5)(0PGJMt|=*ZOmPgћM_|}K♟TJ$&tӑ(+ |f3yv< 2B,C}6 0c%h>g>P)1tUE \W8GQ sJDUE~Ik腭}k0tU~4]dmSAARhʉDUs∎J QPPб1DSTJ |U@/f'f*9@D*WZD׌j׿j3wtH_ب{R?Kyu:o}HʈDU=t*=}\K<1_U?a1>XjsSRRR;pzcڕiPB:11$k]jaNJ_QQԅ@D>{b|OUbj)>߃/HbS\](ݕ)Z?w=qQ[ݡA @Y!чOС{d Rݸ\͟p@ $Ԫ: ds=Uo|^?]XʊD>{p9t0צ0IdKoB2HؽPެiK5y`ChwƍOzꩧzꩧR_ёçm+O.5tcPYLwef.z۲\Q瀖F=8CяkRp\i'/WRSO=SO=W?~9l0Oxȕ6џ7o_moV?E;}rcaUk?X.)##C4uj㶳'wҥ7Z/B>i%ˉ bbUr &hԨQe3HNNVvN;kL>]z&MD>|ۆKӮ_2wűC6I7%mx)&eD>mC+z/-Cy:Or۪&$iEEEn7a޻hU`ç-_|na Wkq70V7W[M D\m̌ҨuV!eIpo.]|35A7@\wGVgtXчOs}CAV),ۮ˗5OMWâ թ~5)(0PGJMuk0=ino װm@/'RN5蠳0pç}}jCU{!U6+;#(G$in_u7ֹ~Xw$}C}6 0c%h>g>P)1t>6ؕq f]BU"X 96u>q2=Hwr(uwڝU t6EF~Ff+ɗ$"5VJrr>NfM٣F7g{hWK@k[{˝S:hąɺ cX5 } weFBZ+T1!jبb,gd.ֲK/ٮg,ɯ`>P)nѺ"X{VTjC~7L٬1RTCg|_BDW~5X-eDp'K]7&[3Nw^iu:_A hF}t}'MG͹ 2COWݳ߁Qp;Xز{ԯ{֗ՙLtXTp'gR]bŴӝs[c5=ĶRsXzw*x>ڝD)G_Oا=|=ګcd$9O5Le@ĥ$O3{6feJ\ٿ[W5pHЦY:(:ds@ʗ8,*27~qr2iLQ-G dwn-!ި[iLTr?,AW"B5SVFLw1G9.m2sRE6GQ{kk~f:.mUC$TEKP1,[!\Aiq8W-H_X__>S6:0zn3mޝiW'k>J 8>l69rrڝJLG:]eqnSʮ:{ b2Su}|]A Tf*RXDh>!|SOGX~}oz/.,UN6NS˥WkJqʥC?l]/>ȑ+(FP ODE]Z5g$9VhgA%=Z(T S Pz$Spz!zXoXoDe>D5}^Z+9t`/Zt2Jl)T\ڒ<_ɛ-[:[.[(-յ٪Ve$JyО_ҷ)5u*D4g-K^ͻe7f%j2>J^#Kv(*vl5 $~is=)(fii^a0oрVQLnEC/Q}~Wq_=3v)ٺp 3ӵfL.kS'\9±wwHU8A|i+Z zh 2iQ|HiYwuœJ\K}b/slٿ*3*AnTΎTnQ~2ljԬlU**i3U0dI~NҿFKunChի܃9'moUsEاUߪ+RiS7ҮZ))ZI2H}Jە"UP$HUpKf+u]8R$ѕ!FY ?X#v2|+Gف?꣡0ffo,Ҿ}ي⏖8sũ}/Ҏ2 _SsŮ=g*N\N~\}ERsŢ&i~^M[W/вj C.(^ ꆩ @90;dYQd5r8=^D/B!EH"$x}5 Yl <\^l]43m/ùRZ0]Q2ՏorP8M»2)1K_K7jN| >V% TPPJ]jϹAC[-;h[QPJ҉T VU+S(4Gް0N٠BIfJy9_T7NIR!s`]\5H[,S杫ԺvM5h^mLӝ7UbbC5P^=^K3MIE{S-%=4umzoӴE_KWTۃqFzH;U-'ܾXck#/ڵ5jع+^vLׇoѽtV5@-.~PߧN!MQ8ᎊQ͝g/#/D(O[Sέ(6{oܮۗސ4y*dX2C[\߿]=M^}IYO.I՜CqnkWԢh_4"sxgːy}.8K^ KFnO9OL͝s7(u ==E7?8Ce׊kxrMh6[G~4/DzJr/{\mmGaoVq~G$G8ey+kr^;E@VYu~֎wq$[wk:hJ2$kB :'\$MTܣdVZH(P*Ir휫k(̐_OCsgiCaQn9Ґ,5 \5Q0C&aUv4(&}4ֱ:g jfH~u4.*X7lSFm!j05\0eX Y dpe6G?W~riǗުy(oz⑷|Yr(Gho ,rtt0#KfDtX"yWF(JUGVUHe$I:[զ?[d^/rgVJ}l#X11G_THN:(}\u8WkQUQt/dQ5ʗ$z:|6~N/o&닛WĢP)+CYG:]g$7j?^t ]eワ5oz4hCa}Syg$@OTnX"lUS-T}Xm۶.;wϺH7"H7?woѫk+S3loX_(u/ss/qhNjȗЮkC3-5-k+mJ*S|e8'^EeGVWl$4u)]ɟO֟_ҩ6ŗOＫ5Q]=fR #>+{zn{biDkMY ca{I5i?^OI5ln ]_NS&։ooբAC5hr>/do Ui=}nӰGjvݱLM.j*t3pf.ꜥzRz+B jĺ&5j땦S^D/B!EH"$x}>zs^׺]Us %ۙ9kΐ Jz~j]r,G FbS~]ι4]]U Piݥ;(8}>PgV(G(MS__ͪ+Ju;JΩ?o!b;a}y|UEFUW ѷoPfh?M*v?U72TuՈwW+Gu7C羠)ok5}/b 3RQ;5MI:7 UwtG5urv麭`MSmEC)9P-롟må`lWGz6%%ڙƩEc)~}5W[i-ܨ;jG7+\'!{ރ[5}Tlu{sGv}FL׳+(cZMh8SAꦑKCU˯tܕz=0WP):ٳ ըG7%$^G.Z^\S|䊂D΄3E_|A=(]1g.]74 %sҧ} og ׹З#ϒ1=Ydd*w4pF")j;C%b9YmG'mm3Jc YbwWYci`Oآ'޵(ƱvfA y^q)Fj>ʫ\-$kZJ'$)悗5A]p ~Vq4LOiP,VzU p}+_ RiQ%I qnp :es4/5~ Rm^팘zqTҐxn|UM}Uj'ɾR?/ջYk9DSWM!'ԥ]+V(Y%x?p&o?Oof++;W3FWLT^_lV#u[ |G9 ]JK.S5l:ᛳ#wf,ەy܆.m -p{(m&uUGb >UJzT^nt$4CUnlwU/mt҈1n7vMWԖES;ӗeE+ӫub5uf4>9wlXc^m (a$ñ} I Fw])۵7}=w|_c?>B:h'֛_Զկɷ%ckmy퐊__"U.[KG]G>-Q ЦS 3`(/$TU Izg[ɵ. /h|kB(v'(\|./;:gwC !4j @tP ~-{wT,tAJA]~sawgg]fo3݇1>uy?\ݦmscB(H]^7{NxUhXet2,C1~}2 t(+b>\S@smH22 CF PW5jWU-:kݲ^;+:5 ]Ud]:R#W_H\nR7T^ö8oOҧ{щtZYӴ/D6l @>y۬sNO7O껧[e 7q.;H"yT($K*SERb}Un[Vl/)6D>Qzu٢k4Je>\I?HAA RPp_ kjUsuzd\A}b^ř%#w̜U쒑?Q ofouGEaQC_ խFbctzᇧH$SSbi8;jtִa?JSЙo6" f 8q¬YԳg"m{/8;z K,Q/X\.W+Ft̡]vT5OiWש-{n5ߠ$5m罽ϼPPX0&MR.ݨQcV;mӇr/[ӊeGtmm8ɗF5kڕ?TMمcRpu%\NM^}(2zp#$}>nD7B!FHp#$}܈%%%:W}kڴCpa>nD7B!`11g>9,PZݞ-p5gA4d IDATp11F엌(!y+UB*M}P$iЏ?:Jd JHQKaedͳk@RRݻMڽ8,ǦV,]&s9HeR^+?dFSTCQRRLǻh˿\$ŨEo.Cao.>PBl6COKґ#_ff$i%hРZlOիW/%i֬VpYro߮f͚?K8$@ Y䐫CpiР4h*U_~%PB.u>аaC;z衇Jd$8Yf4y7>N{ȾIp#$}>nD7B!FHp#^.dݺuTzzCb0%$$:+u=wr%$X֭fS֭] +V(99d_ܓybeffA]Æ uAWqE\]ӣ.0\C]]'pE>+ @d2:+u=wz9z\Xt iOUm0 VfwX7/~FFH[w觛\ +q_}15pA됺P8}mv8?ak5*( u8H_Y%[QHw:E8;Yl(,*u;>j*'(*y(L]=0ZBC~wlnD Ke-Bqr)VQ&g{k誧[_t^=W~zުn9uy{5*VNQ:7+ Q(Wrq%}ݕ^5Uo5#uS֕c=qz%,jܽsETxVNV{OM}F-ƒIJ$ z#?%tlIC澪z}Ž }˥-J:رuޙ^WO>rڡԚ3fa:ܩ\4rWuRsȯjo^=~JuwD\ŕHηֽfXv>f1~3wYp89%ֽӕiHrhd8{SuGt}!AT#*DVQjy7q%TMdvnymd y+j;%N0dHEVo~ڢÐu1D*Bj~Zw|yӃT#b:豩e>y|mիȨJh7D߮>"i}wj 1jS;FJu@ ZO}TUP _\vܶ]NxL .2+gGۨ+TR~i4~G(ZC~c GFTNE55X[GOӍdtBJzzLrrqKw#zzrfGҔoO㎨OɂvVQ{ddj6Գe]6ɶcT[#+(b:N7HtqV=_H7pz<=v^j\9i׻n_S3Q$B~z}aȸGCwޙDO?РБ[c~Vh~~ İszHs^yVoX_xڻJoK՞iz 6U6Z72Nw}]Z,OWl/us\V3}BtM6*ؔyag~!ʢn`XM2+u;9O'zr=]cTjui;dwiޟk4$WW(d0l2uvO I~r0EۯzF-RPjN[ZB>Ua}Vp{gיs-^.ؒSZdTV=3OЌpCjf)(yӖ)0$áJ_-U&W^ꭳbP[7yZܴVGwЇ/T3oVt\%A-TIfUK /?J fQ /_]7|_] ޮQ((Ϊ> jث8m 1wTT{FvAaR&SVVKw;wRWǏuުpyc@B+NSnu2WkrtX,CQҠԪu[5ͷr(s9EG2[,r8282'ZrU,]U6*B'o.YJO;0دE^ >1"Ő^бzS.~ACa2jN8m%[f-*Ӊʴi_ZGB;Xg 5Tg?UO>o2[)~2]ұJ?. $ہTe)aeU' .8G֭_b :59(걽Ҡ;iUFoz bnL_أ:PTd~a=q Qs: 4+SӘ[3Fc4^/3wbuy5UG?T INP_CխVEDWT{GuCiv-DسM]ں>fMj\"*TCf+?f>.-Q(Wjq5ӰaÌ:T5kzYme'33S4fLއ;4iz9%p/'p!٬ӧo;Z{{{ji&MR.ݨQv\Dv&zu>+?zL܍4FpE;^;u=w:D+,,LY 0r8 su(WzJI\´~zժUK&oRph$Qp7WB=OUN]VV]0N:@]\ <>+ apPXu7B!FHp#rK,qu ѴiSDp͛7wuNc3t7B!FHp#$}>nD4z*'[TBS=(_9LѬ̡e(ɘd4fQrvV$XCŘ>\M49qŷsg 8u\[ ,x*zw6e9{ǙW$2( @!J5Wg>XQ}5aoHOUC5?zI2 ڊ{\XuTx=tݍX!Zڕ9M/iX\ < }cTZf͙QSWwh>e"R,TFUEXv;~AxuVmݺxw ʺXYS/A1h㴠n-=2)|˝Y cU1:H&?!@! h<1L>oR RD`Wsն:xW6x*ktkMj u:ńDX&yi=`d:U{'Én:Wxzx_Ξo TsRDT&Ӏ }m0tTuW}$Q^^ީo҉DT3]-T5,PJhc>(!!A-0tTzl:5BJ$rdj˒EJfVӞUpdA>@1 ŏDpZU}=PQ lУ ުePFԗ|zc%'Pѣ8aWNE~ $#Ǫùvan2xg4䅩fUuCup\P|Hghſ_ a?(~es"awB,ze{}=0lno&sVmI;msEVTr!¡o>rHБS YyJ]NXO]Z1W$}vOG}V6~Ͷ; (V$9ڗSkֽ^'M#vgjH.ǪŇU'3g޻"?Hg QWw3)f{*0n:WHggká0 y8FMsw(u^wuJ;dش~f oSU<^C~*wMG WG У8|- 8QL:t-W>͙6Ͳ85m^^߉_㲝 bB>PҼB4jj[U_d=oܦe_@XoMa9}!@sb V(N$@IҷзWsvP[JJ`c>T&F(gT-۹?HktkMj uHq^P|Hg{*pә{"UݩMK{+*"tOJ%dRpU3\aȲoʘ%ٝKB}=LFKUjyڗW"r5WSOn:Ow?$龞LE>N^3U>d3]5@̲+e[8;z'zγ^QcU@'?#\ "P5kQdY^2-=6k[fӹ}8Qrr PbbC(H' mTENY IDATGr&!H5I,-pbﯰ(6LN?L[^]zܡ;PHg2m-Aw?%6J+vk+귯SOjչjTUA}wKlx4Q @!Ѐ<{{9Pg^ϺL?TVC{*Zvϱ{zt|Vd@âڀ3}O-7+q9g^qPT'jP|3cKHH`~>@1Gpo5_;iJu i5!$ɮGk>@DSpiLEU TdI֣yڱ=OY6'bA/S>poU1fQ;XuД\f-ϩ;IPK6ݮٳ|Pת~W? (JuP~ 1ɞ25Z[9vin=h 3i9V-UUjԡ8wh=PSu ːwj4ޏ)͚ }S1$am_]mڜ꧚h؍$@iD3pu m&}>#2oQmω׃]CuK:n,k:Oݦ/һb _)TϷNyZ$$v/6*Uhx)ЙH|&i暣g vɉ%''kݺu-0tp).}2fLLѽcX}WK|dLцM٪jU oݺUW;p}):᭦7WRmyDygNцi5ڙ'KpjVk{@8> #e:8fM{t /am[0AUQ[;5PЌ4Oe]zhԱP\XuTP ~`}Dx*了},mL=S%;ODT4/ţU+2TAAAJvu.sOA٩̦s_3)4!H寰hBѮ iFpV(>$G36VÐ$9.{,mk~TO_˦_T렏oۮPoWO,0PJ=੼h-5{4*>[lݤT9pRaXXfEvT+w[~ON Z^^zPuEޞ[Ku(]ժv>D>{x}(^ $Kx8RIyzv,!-;տuY혗N n'99Y֭Ӳe\ J  sD8m]5 lHwN/C3=ܨz _vaO=U/Vfc+!daںuC@)\AQq8WJ/}OשZz6mFh0#X')4[3pʇp><}kdTCw5xL|A{@c}.MV/3*E6MEKpeXtC@)\AQq].-~|C:z%oMj+$Ȑ!-dE}>1P?O(84DУx">1]ޒl˵'ǒdTy[+Zl%ޭcdڿZU/n}%Ħ%۔iQX\kUKe7qTے(iS,Ԡ֍7u4rkݒ%w[}VڴJpG"+ؔxlU+ q 6-MZMj W^7^(z+jaY嫰jӢ&mH %SIYW=WGsA$J-Q|T'8[gM0=MkAZp­5ZVGzfSfy@wZ3w[>qx+'P. 's%?E -Ѱ^.?!Ń\q(c_ZmSlO?~WҦZ8k់u(|KAn%P֮eW0oBUnnۮL*Q*d)SU⽵}Kgm@UUIfpU#YlwUsEdKӰJA ũ犡#Wj_j.?$H=J+ $*jfMf(QW]PT$ѥ!F#*lJRVGrdQ? I?tHy|cҎ*,"?ZV-Юؖjnb)bUC II?i10{ 2\YqZCWC5ԨF<jT ViA @ 0dd%aʸZ6l^j*eYe;o7,Ԥ9~WiaJZ6`>G*b(+@Tps7%Wj*zb XPPPsrD%l6M^*-AQe~EZey2K4mQLQޅowTsŞ w*ECE{+ [WYF튲W=DQد7M1t >`RH`=tdOpU]!:tz CGOh ()H]zJϕG)8ASjݴQ9rL4=BQSܜSc Cư(TJIVQYURF1ܱ[9T+(E+US>*i\YeuNff$i̘vɒ%j޼e @KJJRӦM/V9aҤIСE5jk}>nD7B!FHp#$}>nDx\_f/_/ J] |8G>ig(]`[*>_7>(ƃ-sQkzA4*/(CG!¢Gh^wD)s_Vղ:`.;\J8:}miLh@:K!5{ezK2_*rLjuzRS쒤z+3kP:]Æ$hWQXըLE;NrP=~]Tj5umô!@3ﭨ~]6 TكezԪ^5Uo,|\)^~~c-'ܺPU'^jѓ5Uq,\ƱRpUm&nAcUFpdTOt|NOTLW+*25t ݽ|.P(}l:<^_LISV'gҔ;s"=,ImTmH&ӾwԄtCm_eFm^H?ސ˭cߠOn;-y4uhn~/$o/6IQ/eW5qtݝ;LMJ/| ]:c=e6i^){q:"OlVo4c||}d[RnK_S30W(K>vmICCEvDj"j?v|%yŨ]Z:3EG I&R^"$njoCGJԧ~$ަ^-$Ǟ&QX&I>ʘ9]kmLfoCʚ$sk(]W5 6IgQs䓨?Co=v^K:EW&ɻzZyֺuV]~o6(""ke*0밎*=#W*ϟثU9>Օ8uSK4Ts[z=J=Y1DѬeK$|_BzE guGRӎ'aUNJ8^p0]eË1 T> kӓr2hL&Cι;ynD7B!FHp#$}p)|4Z{l;wQ?Sf@0 (+M"UVU(?/*R4"1졭 J $R BQ:!D ;auΜ3>{}ʌzuFTW>1 :XVK[~P)mK.7WPzj8r%NnիPVF$T?Rc&s0am*>GS``56Ar+D=AHYuѶЛtǸPs_hѣUϦzoGE?oOn-}TH6ÕrJI%sYj`t[c];C5mKO.Kј;]ݨ&;g JV1=TKժSnɕEc(:|6PKcL\2H[M(_~ŝ24!q]Tjߘg=[mցȱzPV֣r.ι)٪itmzW;iN~wg(%wII7 mԈS}rJ*\iՔOG4 UʡÕwFG6Q%3hݶ4/ΠFK3F fh4ZTR! jeTRw(񱺵I~7ք!V,ߡ 3mSS2hnJ{B|zz%-tЪbT Y*T%n{Ťe7\S:T槉oN:/h4J2퓴`j/5k9LGT05@ݡK6ܻF5_u;:Q]җkN_#ȖV-4|\O}{:thW5z7 9F0PEўZzV6M?-]zy܇6¿K̾j7/էA'T苏^BW56JSVN}5*donWA:uqCn.?]pPO~|{LNS A[Ӈӣ܇\:۫YܿIUS1Q^="a}V;sժse1 efWdgHt T]%F#?LԸM='r`Tᨔ_!D(hrT߯Q "\nκ%L鯌ӆ;kR[_9PiWu2oѦ}Q+cJuqE7WʻKT\/K&E%*ƆѶQKW\:}>%$ɨwO4o(=UuQɰ4nNL`<~D>ց[hJ>~l(I}F״ak lUZ\"w@d/UqK%ť| *.QNtp"qIzo";2S^Q_WJc҂0dT,_MtP v5k×O UTdv>,,)RGKp1[&ʔt6i^1>H dܫY+ceJߡѴGw[}f+ɛϏ;2g5`RpH lOT/(pI}g~O#oXZCRYTj3KJTjgP$%MmNcjpMTOQݮSX!cfNV\ʩ#եPS Y,.jn?YX3+ 2(h=KŽ*jNʝAGῑzoRdR:M9Yg'zQ"O׉9*|+InnP4E1ucΗ:FYh"ZyT=^qr7on^ޜeejB\}ۡZ<<2Cٹ3Mb;a ޫyt~C=CΪ2%Y,~5| A<Ƣ&>=PvQIJ;WO?3F^ݮgczŘd ҍ[I9%NQf7xz함C֫}(*RQqʝu ZI:,SyzHGşQߡmb=bwHEerJrSтowK5z|H}ӼBVU^]o#̊Y/ޚJާUk :YIDATxU?NKIZ8Jv^Jݻ{ne6hhDI<̜H4!.GmvԷ7)%I>8GvDur$}=hfUGrЖ h߷?JW(-* )foF հE/D'ޝjMbBm6l6jfdY1[-R^O:V ֿ6f}i]#d UN}=7nE* w(-Ӌ&=3^ lc]3%Q2F?_je4-,A |gb6,IшF i{eaiPjU?Dzl]/I)4,\U6,  $96k#^pǐ*,tjDm۶͈>pyHzzVX5JQQQ>H;ϪF}||j$m۶횅|\3fA}ܠ>}n>-c?_x>^!Ex>^!E̞.ޤx$> y,> z,Ԡ]vWjjP||||j1u9bD/B"}A/B"}A/bdOjw2+ޗIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/managed_dock_window_top.png0000644000175100017510000021003715203313266023430 0ustar00runnerrunnerPNG  IHDR94SsBIT|d IDATxw|Eݥ ZH#+HG@QAذ OEEPA齥.w1_]2wYY 3z^DDDDDDDrM>p}ذaM"""""""w3/ft9?%""""""rW3gΥ`AzNU"""""""ws2|pӥEDDDDDD),,رc~CDDDDDD74.""""""R0(P)@w2(َ!ݪR.""w01G6~^&p?%C[Ҧ/fA|>ލ߯~&eIvt +1&W>m-WTqg=Rrtxo#&GW<&O~6lM5i$w̚5 {,e)P;A Jsxdgq3dl;AmMgDkj j\RFi KQJy1>Ԃ9o\zh(P܉- Y޽3I9 ͛Ν;VfMlW,""Ҏq!́4|x K;cZ&X3 p*M@g65T,DW ڵh;@Z"N凍kԛ9v:37ظ7=s{$ ?C[2(.eoiIЅ>BfUXcQX N) eJ⪷rV:c`oJ96```Ig- OBEаM+'7]?ShKAz׮]IHHvY9 ԩS9sUχгgO"##]H^_8ΉrhZʉhEW,zFn\ݸ8-54edt Kb*f83[nPblH3:,WE)Uq]gm^˞+/ӏN``߱VJG~o~}2UP}Gwv"p*T 9ʎYG JLVsLUqؿ5|h_~ 2Q?~MUk׮稬V^z1e{DDDbdON"^8ű`R-yKUܮR3QGgYAmN%fA&#$;u͓B+Soy.&^ɻzXF?[ajtۙ.bOlN8Ŧ7ԣs'|8Q)w@ʉ9`"y;Z"<)4w"9-WD: UW>w3ϟdɒ8q%KryrTNX<==ԩ ,ٙݻcZu,N8aGr#9Lj`R/R۸.p|`nS*s9kQI8D9=lx(JZHŚbҰ٬ 3f,"޾L|2XL&OM)1;a70L̙m(Aa{q\\MI$N8\5Fn'9!;vέ۫27ᙘ+IVE"" t܁^o:S<))kN8ƍ޽;ٿJ& uRX1f39hH3![S2St؝Gc {9'C H <ڎɍBt_Ypױ_zhKbd<+6Ȟhp+Fҙ?Y fS|?}ZŴ{6߮:wP-K ܙ1iٯncNb%69{m\]1c&Qo)Q'ED@pBlܘ!~e޵kWYׯ_OSzuRRRxb%KQZG7fѷ.KZgaa\y?vmǼɄ:xMxկIFL1O0LQ5}qbD#[Sُ +r^>ʲm\}da`ʼns{رĖOK 24y neU$ٝ(R.8ǵkܩի}=lW f_x]bXr4jo 35kvӍ)8*La7̘ ;4+Iq$X3[pv3ج&La3 DZu+YYH&| n&Rb"JP?'l DěpɂɞJB'Bcs1ORcW7iqGē"U. /3nNfDbcIfLnx.fجFǤ|z>.""r{MʍbErlI>Ǚ-b} Yf>O-\UmB"^qU#g|>g1H%.2:+ٮ)0R=]EDDP.""rv}ܾ\*pPzr"""5"""w[Eۚ(U͇L@ `D2W]_Ê)Uz};up*cu#iR9P ﷦F u-B~h`= 6d+]i\8U)R>a0ZDtxk%2$1j`3*-K:yc)Ҍpc6V)C:C3s{k#/_i6ںc݁?x5<4f!fӧXO8x?l;ž{]ybcK&o正eiou;""""""rv ΀s=wq 9:> nC:촶$&%?u)6BAp6;Ekp LY2(G&M3R'R5%ZѠl}:P-hZ&glPb?/v9ro xMSn~}ϽLxZ2]1CeB*z+'yСCM)|}}L2Nu/&, {|v3^-~!&˵  = N >`f߈δ>ᇿNjti=3 6YޙA:VN.{_.pé!3? pt#cg f2c-D]cy- .qw"|}ؗJ1`9\R-p!f3͛7x[lÄwSDDDDDn+9X'΄OD\NÌ=|21@X;>e?q̣K[G5ɫ[{g<j8xc>U\}txlW)O:j.9sv*yS2ZxU6sōcy&\ȓ^A =BCCYj'O$11nd;wSDDDDJm?NbCi~ 9x);v.ŪX16^ޅ9gFQ dlDG] A.`UDZCd"\弰 b9=L{u3=@HBiWO=γm_*n7KvRE]-[RaM) [3xyyd”?pGa`OԩS/^<$"""r"Psr<1oΤ=!ȿbrIB|թ*}OZ l< 7 o0/܌ёGP'YΕ6I쬠Bӡ/4^G@=Ĭs[Bz\ϕٺ _xyҡF=mLj#:_Ny!tv? ^mHQM`7tm;W|͞X3΅`<\֒6J3rrdn׭ of =M+Œ}HkLZb]vf6~g6m 6d6ٹs'7$ĴiӲ{6BoOzDDDDu3wqnb򼈈dЈ(e>3]|l'uMH~Q.C^JeR8:8舓u0sRε Aq31_\y.7'鶓#w'tBDDDDuEnaט&-m}|Һ&#޺HS.r Y܊P'|˜v~e X)^A&o3#hZr l4׭H{Bo٨`U{fďLx9e]nvnDofԪX 5oz/=@hTיW}CfEDDDn E _D [~eэgރD᪃xC?AZZf/-c# ȸY .|^_ᣙQp/ѐ6Ep6Yhފg8Rn8iɰYǜ2h4cX;hq_;1u~Mҧyp #F=gYc~݄m/ĬנQ3ʠ1~7b1P߸3:rvL/Ղ e8YĴmjoO0vEU po>law+#%Bϰ`Y=LjaΉi/F|qW}LYs.@]$?s.3 \/Far A~\-.@X/úqo /)[9]iۈzҰfo|2˳CjT jH݈S/;`? |W74es(5#8i^%ͤl`2_ziC1GnzХ_ܘɃv#^e) d1\}`p/H^)d¹t3vz,eh;]6\9}2d]zV>C[S ,uxb`vY)[$kÃeVKH}E$ JF|]sj >Nsf4Ο ǧ?9s`?nWǸxe#3Le =w!`Nҳ.gGr!̀ "qЭ L~56pvV^mCW4쉗 ~~XGk#4.Ce`vRa = LGN쮯t7]Tڈ-9Ic?ɾ# LۧSk^Zڑp EsI*l$s9l^>.0k"NXiGiҾ}{6#O&Cga+̓ 8<*샏{(/.]صk{gz"A ӿ&Z;a*쇟^_sxg-ODDDn@]$~} 9UOߙXHpuym;B62Ś` /=yYD])3m#YјC7wRa{޼ДNe/̚K>̰*R>OpKofHKKO6+FǼ4 k;)9ke|K#:>͔Or$F*vs<֛ c{9?ܰ%R؝Х]?|ө`̄IQVҸeEL8ROtN"""" M}S4wq7Z7gYl377UwāT;wCs>ZI2Ɍ:0y[zOq>Lxhw뺰ʹh1uݜ`h:uۋpM x3fq{ Z=soN_n8*wof8(ONC5S),|1DN2k%i@#ցS P7W/&?joBi\HDDDDDD:,P7.nbT Lņ~og3ol;o0V)F+~E0Eٚ<<` ؋1 B6#9̺7QatFҒP2ᬟ fw(zrjwL%p,XvX4={y>F~6@񹈈&/p S?}\,~{Y~x<أ‰eֈ$ ?Z=X?fdNҹ9ղtH HeGHΈMx`+{r<feb5Z0a&*3'""""""M|ߣ$g>vwǿq_y8 =>s#yYyN$9S` &Rep.:f<zN~ G/Ŵ{Rj=$5˹yF>ƄyMEV,Nrеa1:;/4ݑZ3g#3yuUiՓVx7ZN 7\pNGG;e[b;wV̩ EDDDD>>Z*!l6j֬Mɑs/S~zK^)..w3DDrB w3 "r;~\H)"r;SNܮթ""0n$""9@]D <}ۍd&8Ev (POҗ7 ǖ^|{&nq/ܽJPwK5-lJ^{ݟ3|0ǾaZEIIূ$mx? mS~iO0vY!W"nK˓-JJwAOy1l -_9M}aCDnKxOʥ8ڈf0 ֬vfR{=9W~˟ 8Wwv.y6Q<7i-+e:+W!-㱥T+؜PRR*)'<՞'~+׳nA-)Os){}lԯ_ y<<$py>MɸWiǖǓrrkC{/})))?}wmrƭt/] mo䲅jW.٭<<a"ul+Y:|@|u%)c^JBpX=YF0ySImrtu'iHۗy{0m_۷߳%";䭳!4[$"w~kX{.ΜS󙲾Tvά\Fd)/6-HB67Q` %׽ys~Jxù:`c 8a^u>\5`?֫5#NPBY2;Hck8`*,9Cg[2l ΰ$d9]KV5͒OP3lh=w/7818<3< {e86Oyh:V-/x(֌}I;a; ԤibaG3syݓ0q,N5~Ɵdw駘5?o| xT9;>X٘%A]x#WqY |}2a-OF2U h0u;hJl;z)Q&r;fΝZjxyy]|N!rڇe0ea?jwg}g1b;Ʋ 4џӣ>1=MFr$>/Sy+GMb+ML7 !^59@ց uX \՗3p=6-gI3ʐg&'Hr.Eo|8;ϕr$B&yvROwr=Ң] xfY9K>z{xnLGб\!Lp"ɇ_Ō1" z5u/004~ٟѼ!cp,593f_~ކo^r_{ɦ>dܯ;0R3:6^D3aRuxk4v8utoJ>7SK'DnwmAbB.nd&BH,.RQ1C`yȓ<Z([Y.6-Тm)\&wjy:[?㛭Dcr̃+y%tK>KfѰr߲ԬyEoqft *MOgˏ/-?WLYOX>ԈY7?s^;-jN˒,9\OX /WBL|[_.aƜ ?v xY,Y<EŏHܤ/ok֬.]h}DϜCgeY>˙QKXI hDY6*=r@ן:2Mt$Usb4vckQlKf(d2Q5+v˿I<SF9gJtx f-Z̑el6bW3oo}FM_oQ|!q@(oZʢ_ QcS筙,Y+uM׾bK,#whG0O|wvY8a bt}3 >g酜钣do_Yp"6cxw]i~!9,zCaޯ/઩& UjEW ,un\INL$Y Q9^"r#&w5x UdM!mhgq*l[@Sz }<_PoE{z-s"Jx0sntPc2R,Ëz7"\ʴUl؞~ &w?aJq738 Z/b4peݗ[Z9ەp+ӉލbmA *JMo ŏ s<)z+%%ƍӸq}ڔSNz=ky$w@ :Tv-Z{֔Q]=-Yй#0a/x\c¿x.F`+T%<1ahgx{p} P#ϷYӦ ;|kc2 LU[GxժM"S3^WK Z>ؘ@GGU3/y!*wA&p.ANe2qrӝqÄZ@Y]$gm]=cWT6h6bcz IM"-;`„gn|?xtK {&OI/h;y) OHNiK1QEB"M-3fᤩ,}Bʅ3f.LGeAFأ󪀗9#f<;( v[ByzH2vګ*7NҳkP&yWbON +eYy T~#?/Q-OQ}фGA @u}ɇddpf%4僸G&zםNvr-R^e1vRRR~uSEn8'wzr2~'3gڵn ""l6dɒ߉ԗ(#V5[e6SEDMA9)"귮\Dn7g)PM_Dv~jEv}V^뛛ʼn\-[ꈺ'[l!4447ܖ-[:w+ˆHԗ&\ ˔)ÇYjYܥ|}}L2>>>vL&!ۆlnM)ԗ ~zHHHn)"w)G 0r""yno>ԗ ZLND *U{noNTTT~7GD$[|||J*ݔA}n B?@]D 4}/ə\]]DDDDDDDnuDH@]DDDDDDQ.""""""Rhw_M#խ[7_U.rhذa~7ADDDD䎲~|M}qT}v5yYM ۍyYm/c營%+qo發)[z"x_tcj\uA"H܏VM<< 8m.o⫞]xgcBWOܻ}pÏ1´o.~'S}J;߲戈d[+q-G_1yoӹ=B_5θno#bnN e(Uv+[G5ȵ$gfL^uyc&30L`6Ō)e Ov0"֫OKF(U<Me/Ф %3laB*6Gk0q^$-^P ܂NTh׊׳-l'ċ;i>i dh)e,ImaywUTkǿsJz@ wE:((*PEQDZ{^`o 6P4!^H9e?hMrB5KgϞ'9]&xdAo x,?R`Om-<.V?o"ix:~]IxM3&nN}%ؾl, YY`Pet HEDDDDD"T.y%$r.fN#} oh\mMktk46ȍ1s\?~C7/_oMChlх>mhxD0ӧs){qin1MIp+zM8f5R.gsN&/po71c=rtgcoc_E;r1NR9` 77w OsùnJB, a``YqN%pK/k: p_S 剈HVz>cheNԠۃss?K IDATOQ̝J6`zi4f/eauLi`[%d %",+F |"""""""gS#]XdPF=q-Vr疔{ݙfQi] 2Y\wWrs?Tp^^2F}ncM l[f Oߧuf3Z u;O>o4K72ey}RR=!>Zf]cF#<>oʁ:t~x<_4?ц CN`ZB+I8͝xO9?؛f+o~DᏙF#J􆧘_P.gUr.""""R2岘\i3W1~J.{uZYjrӛϼϫvy9DDDDDDS.RUywgăV~v&+'c[n.O'""""RE)Q W䳧Ҿ^$"n\O(""""R5iHUՋNe B<(Q ?"j*hJuܹsK9)sNRVM卧Gqfߚxy:.T{CBB٤fREL=J%"铁t*}oQFʇ2+ICJ5QOHHbЪUlV;vHllC\\]ѵgd`p+),+^RDDDD)D=;;={f"`OQI6ZsM;kQ+,"JuKYѵUl h B7bW=HUE*kCx}ohH'c9;a_ϦTMJE,О/dۭ̟)D5>=i"""""D]*sd^=NvNn@:xDQ/.Ng5 ȩ/ff Hbbb6*""""R Cn|,7&( =.{t_ ><ʱf5eʫ5DSY\T#DDDDDJe8]\NJb5={Ny;u5mÿ!;c ^1}zZ=)%F թ~#&jox(.*u熙̲ ⑛c ݃ufSzՎzt>]ߒC,zJɻ/oo/g-"""""eu?,f>y~ekOY_K4F9HIQCDDDDDΨ{5hL[H<{vKXiu)xڧxt5lT:wneX3^&$j9 W։I/>>Bnaj|\kěG7wX:]݂so=LxH+>> v?eڐ1~D4jE9J"UAbƽίfaxb $FEDDDD<umx1wwg%ͼZN{߽˷Q=sx!?ȝXi' .#fx3ȹY^;DB"""""F'}z]G>o˧s\(Ry]ʐ.`j5||&E,!~ޞ~V 8kQrQ h Na7quß(Q%"Uaް/kKCQ0Ju{xxxi6'r2`̰~LϣV@=RMԃYjUi6)ªUtOl^zzau)ա'11 ZMKNpp0t(wƮū}!."""">G=66N'a2v;5835w]DDDDi19ʹ"H]yٱˤNyj%"""""D]+KInҖ:CqTq\,uۿeIQ鶜Hbbb6*""""R G]DN0dl͢NrZBDDDDdԣ.RUm 8Yk{M7 }TU^Uy}b19b' 1!^ LDDDDjS.Rո⧳< 5`k/V})wJEW9y$ꆁfhw<+_Ητ(""""R)Qjx~<jyVHƬ/=B/_O'"""""et[vOGT Q/Vum']~aQȮ_CŦWG+ɉxJ&Mg^Y KxCh~ 5S1g`FJ} nդ] ր6yq|ݙq5Qw\ĸ1 qT:ߣnDrkxd7ﻇQ3&Z{,41|@m0Iv]2 R8ia_flp<4?~{Ы[7&EDDDD*{Epگ>{w'phW.gI8 eDamӀ:usėl+cU_Gʩ_9۟K>iG@xmZJ##L摾mH+mGtk hߐq6̴e{\TT^9 ;zєع7.oNWrŸ;HBB‰- 9g[^DDDDDT%ݽI3?3Y=c ﲴHm3c:_˷c͇\;'p(XוOV`ҷiq[]GsnyOnLJ+IJZ=f ~#_Ibk9@7y \'n!xR~!߱!a=? Ng \'Ul<]Iy^CΝia}v0ié]{ظ5#m)Ѿ}`V'J?Q71qPmEGS?;x2ntw( +ݺ, ):m\UKX'ė}6SY4w톎C7GE/3~mo-? 5kt'fزVFS^/OfSu9ӞOuxם?1ZFM)q. :H91U [4Wڇs8k3򽷹E\lt222ξ@?O*""""R5!SF}]?y'bk&XI'!u-Z‰:XmVLgQZֈ"MjJ:բ8p5ꑹO; %cڰۃ :ڒaf31ϴxHg=-F@żw=7G(tףYɇȘ1֍9҆q5Pv]z yZ>: Ax_i7!kTnk>ƙWOd7W_O &7mɽzdg/bÞTEoE4jZ 6s^L ivL+q3-&8p-)|c|c-wERor Uでjo\"""""R9i&u=JwY iUF v46c۳tD'5 t;6In֌k  S_0de󞞞={+Vйs)&L`ĈCDDDDĖ.]JǎYnpd8L6>}ޤIʸG]D/_+~~6xoz>^ϼ3-H"-f˛ꏌoWE-l"""""D]93dj>tg`mx5CLrOLL 66O&""""rwreRÏ)>ԯa/_HKeL^|MJEDDDDJ@Hy{xm.0N.rՈ+I6C0=qbך."""".R A'9 %|8!sǩs 4G]DDDD#'WR,( ˆKJ }_[r"""""rJEʓY4~ )@[|To~o0/r3/"""""urW'wMF=?- ٝGFQy2ןĴݧ󹁯-~}vHOO/ %888ORi8jA6,E<ǻcUq>ÇQRMԷoߎjM6٬Tq;v !!$!~$bw{h0׍m|u_ª;2S9ÅxG麡 >WzVV{.&E c޼ytXq/YG$ۂrE}/}qѵ_gyS·c#Ͱ)ekJsmYWscO!x6G<e^IJqq7L]DDDDiQg*`!:.[m!}8 RWgsfkJj'TkK+R39NgnB|$&"<fO^Bˣ8(u~_Xn_ЭH9+{ϥS? Q@6{rӔ/'i_C'Ϧ:xnE<`B&yl2 Vlys`B#޴d`"""""UZQwStfدEK݇hoP oG| 4E_KdPQMϟwpGz2t}yt;F^q/^O?BytAͺ8M{yo5 0,XVukCa,:?咒cbAh>KW]$fLpgc5P/N~rۓ}hmnA=)weףnxW>:WD+4$<{pUؗ'~ ua[}[wo6ӗx^=ObN#Fv ͆ժ1l* ʦ]N-@R&& _ytۻX|h̭%rpzWfd@Ɲh]i0qIyNB3U+wѼ} Nzd;]_u] XOu]3\fGTX1ͯd̔m+`V?bk IwwIRg1+i $ ] |'yeLY'R2q4X r[Q_økM>mL0/ٲ-V7{DDf!6Yۨ\*WUr\Y^ƍ3\*͝;oB>_ёU+d-kZ€)1YZt\}>"+ȷ <3\Dw充3Wl̰gQ~iKoӧ`ܹ 0DuG\{[7>QWLYb;w.QL3ٹyֱ+kP M.Ma-ބ 1bD)(""""R.]JǎYnp8J޴iJL43=krTu _CL-E& hE`Y Gq!<%zE%0tzN՗1rBtY|Ftrf}d0LOҲ҇9"""""RG] E±ƥpǼxI\9~3w|QjjIЭHU>!}/fX,aty;&EDDDD&%"U|~Y5C 37n L+FA""""R M0!&RUٚs]{p&WҭKKakS<;uZtEgZE^DDDDD.zE, ծy5~h;1y<&QYul;-`gp7y6 IDAT}7t e¥(,إ2tRAڐs!C.vJEB.?ĜEx567 ;ۓ23pW2ѸUM,|cZ4x 4$=TP6\t}ȹsqQ.Rɍ }_ Ԏ?I[5 )2ނYI;c| Y.ADDDDuƹ/S7qPfC߮Ùzc2k\MpNb[q:ra+Wz:tmȹs!3%"Uk'qu0 5t|7=wWMaaw:qog;c>bĈR ^DDDDw*DžӴuk:x1%K7`kYDPHu)9%"r,ԯ˖{w)ؿMi5W|twu58Wj՚jg}D{7|7zǨmJE;~[xX&2xW핷жT5ho:y:9#%"RFm+Hwxہ]zRiIZ:Q` vhũKn%~l?L].ͨbl< iѵk;ӿ'>7wTnEkYvglL^P/ K,$oXƲu;I-0ut}Tj%0ٻ7nOӂoTc.ёZJri,4[y:sR."eL_y4̓rHܤż=5v`b`JzDx} ٷl:sU;gKf-'#(J2`g7[4̎a q˺' ]A>{h,u# rz(n)dv qY,ƴi9Xݝ߷Ѻi*=8Za5lтؕwJE>mҺG[j1R>]X?H? DDӉnGՋjʦE|1("lCFJe!#ۇcA!AfdPp㜇II"2BYI;cI!!v2ӳO63ٴd+:QӮ[INP(A>Hldy;}?86·'1iLA7Y3lZ±K+1뜴jSWRРnE3%FÉf=ea58]Kʟӆzwbcu:p5*@RT@}LUjN'yxV.MؑN8&^*! VkÆq@3/}wnnw.g#hТVdG4^Ow@"R lv.ͶӉ˰aXƔRbfstH.G:8v6 cӥl6N'.Ån;ihśة6Jӫ.WÉe~ Kn77M\v 5A!VzUև.3x@k9;#2`Dvj&n 1rgJ V-@B It@7`WH0>Uvq.sqU"Q![5hddT#XnY|HA&eRCd !0;,7DZg&9AT;"0|1.\. }1\>M=7_!lr] U&$] dggZVT*S~ :.%%B(%(("##=g_>!gsz5ulu$T7U5Wg$nGc'PK ػj{B;pI}?c@:mCŁXحh*-K4t^t8Mi5hU/ފe4jџ!{Ί ^?]%>u٬KjJXo7l`_h]:ӷdm!$*<8_߀[QkrQSg*sgi5] AdEff\dEj@ȉD*' A2Jg$&&[)))Af8%))<e5[4ϘB AuѳMTA>|~1?5ZW-;d>Z`X2'?~%+iFbTRvjvI܂ߘIn(wE/PM=x70ioV/+_TfZlo N\ګAwO>5N>_8/WcТWnҥtuv;Ǚ+ziӦѧO֛4iR{SSS1MW\TlQvvC.hYDDDDDD^k+>_>T4ZFADDDDDD-{|IҨUm,"""""ԣ~,,͝ƊV  F3K|.TeϟX+IJ<4g;+,"""""RyGob0\&^:<d2}S,9a0]ӏ@عoܔ7&_,DDDDDDJ³= x]\<+0?_kwηsWx7= ٶ}6[KcXTdbE$WML\zx3ݘ=$w٘1ic$6U޲}vu( [d",>z H۱+YzIO;ؿ}Vd媵lٝN4ƽ$'#5$ydYؕVyxә%ޭ?+y6\sϣkzv'-)+xeKlcƝ)߈ lqtpgq8Û#|՘/.wi?eQʑϽ/e,I~$.۝b0a.gҘ0WVש+qXip yw8pfd<moZ;q.AU|(-B}:EXFڱ \)#8@C>A 3lB:l6+yT"""ǸWf~\ɸ03~:zHrKFvT(3I\t8՛\w1:K5i 窡|S/ai4O^/^i;WuLssp'mjWz tW-^gw>ib)^n $,<ܦ54lX ֪CiZKy-f֥͆ns5L֭YΌ[]DD=aѮI:mq=oI:q4kFf[@SÈ5i8jE3)j^ukSOk 7\׶dwq׾w>gNq4ibc_$| d#TDBsBh; ~{*[oIKY1pdHOUߧO <ǁO@^6WN>|*ӛF-:-&MD^ cQ1uNƴ(^;zMË5S6wJED>şoݒ[bf)Q{Mox%Kkk"!6Vr?I>Ug/|](O{n"""{L[ՌG"6cݗe ]yy9 :>޾ D`S>v;8zFfƾVln0Zjn$jԌ834]D"=j}o#gbϿN.%KDD**w!R WRqڙ-a'n\,yi^Oㅝ,vt:wD/JGqcXT."R!]P.""""MOgF.}Of`!q<{?m'c_P3C,Dp>]՝v4ˆ {=""R*J](O{n"""abeU}n-_N Y0hӎ4)HK#?>{;U V#Sۚҿ-9[ rɬk~ }kiIxM{CCCqGM8X,nBCCK| t}t("""Z^uQ0A>#mlLIP:6N7 z551M {Z~?kqq X T;vk<Ȁf0 7^qxohXƍ3|ފ Ѹqc Cil޼oooJtLrr2Nի}.!49p62=ܹs0`@/'==ɓ{+ܹ_>nҥtuv;DM6>}ޤIJޣYf$B-44'ZFFcaoeToFVr_EgedzZńM+N /->O713Wԉ #,2n#8~4E_KdPQMϟ.:MHfgOyGdGܝC؈ {<޷Ob}Z>o@+^btAk\p擇΁?9w(o-~f'[ǏfJf lGǨx%t|3dz|6U:aR2Zp8p8no.šrRvy>I-csKCf>Ç}.7-æڪdm`B_Lr aȴqSt vx }7>ƣ_Mz2t}y2IYo{/<j}}/5*6%"""""R52q30ԝn̞~so3,~k{6JZχ+&n%M\6;s1"y'z&0XqOI]AF,mbvQK I^l6l6+Vi/$ 3e#7L)wJ?#x{ۈ17mA3I<~d}^;]u8:+S 3nh)A{ECҢYj%(A3D";&9q=}sߟsrrs_N{|Q7pv֣.ZԍFҖ3n5~ q8}92}*ʎ]΃Y0o1Un}?G3X]}E`eC![:zS޽7ȳ:IkGn1Wֺߓ=|S(QؾYG rs Di ߑMv`+3< :mԯ{X,X0nXi=f>ΗG00N7]wS7SAĝWwlB}]Wn~{qS󏿮 NN 0wz? lіc:1Ùf| 6pxx2mw6ǯS_WP<9$CBS}n=ZSm?3(QddgD9L.-iwO^NNb#'\K EbY^/}xLAtn mh1g*oAXTA6VÖl3nV%T^3F;w~Š>hFocέ;ypfgJW>ƵyX\&0r27r \e cި}ߕRӾj4#zȿm&}gºrUrV2j?6 'Y3xO z`(l̦֨Yْ Ƕ3XWqO<:Q_rӽW|Rؘ=̟ 2or|k"],@ʑ| rwת1~d6툦V %""""""T-W%`YNcUwM A:0qz96J\%[4γ_rF3WDxOРBy£3dVoL{A@uul}UcizG` ,OH"##D_aT"s|5%:&zgRRÌaOaWS/2< >[p鋴29u֔'|6T µC3Š9sk7;3/zW&|jx?43}΋ghb`IYNjwqO"73W?›Ctt#M?>Dp|)cplYĒ6to=G4rHcC0w\z}A}tƍX6msx/';>K~ܢ85=AgWQeC ϶Ѭ~ͱtRZju}l6L-(ɓڵ?7vX2S׹e;p˸ߒW/wwn@Wa2s;wqԣ.""""""Ax%"""""""DQ.""""""Ax%"""""""DQ.""""""Ax%"""""""D[tCD]תU+w """""%HCEDDDDDD<uD]DDDDDDă(QHVyrl%"""""""i۶mtСTUEJIpBw!"""""`ذa,[TuRҪUCj*&NHTTCzrk`#dduV!мys:teJ-I%"j5qi輈wtRL&ȹ(Qm۶-\0J"""D]ӦeŊ#}tƍaAfv4{҈VDDDDDIt4Tf0vҚͤD]LscthaRgqTHM5:.tJ9"dŊ#+IDKfK[H)II)@DDDDDTV{]CE<ݧns)fTuvqJEDDDDݥs%"""""""DQ.""""""Ax%"""""""DQ.""""""Ax%"""""""DD'11t <GS7T"^C="t!v8o0ҘrG]ھHdD  9s|QrOuqqwZ?r4bQ}S9@ TyĒ" Y\3: %zrN4zn%\Jb|ѳ ]FnyrQ~ZO,%??Gf;^KMEUbzT{axY *U\;)Q.wz~ڏd-z݇Sk2fg0Uŵ-/PfEANV[C˿b%2|"(s'u׏"r,FI_E-cг7qpԻ,:3kޚՈ vcҏqs9z74+)ſ?J.atyRvz3LIwHEŝŝ\|ȻH|XͻOͣOҺq,7[xOa;t׽ O]xrԊD4!o׼IJB;<1 !{b$;6".&ȚF {3s/PR,m yǏDJw0<>??IՈB|{rm&"}{]E{o~5+ESRm|v6}oׇ9O|TxoI! 7 '{5ߦC#,*LΪ߼+UـwXrx#̱y#<6: g_iӿL⑎5鹧z lQ b4NzrcŕwCkQtJ_άyz[_fmko߄*q2oeFlwf݇Yq|䀑>;ٓm<Ǜe~z/u&aʏi76`?_#5uӇ//ToOl|={^]˻],~_͎b7(p2;93OE Ԕy2 |a>8;A̬{+SعCjO333)|D*mFr_L-˗`ڴigg(?3ykvK|i#k/vg@Ռ~؟_S9a#iV]^Xم,}) {4onLLX6thK9.w]~:6IJ %LHY` WPMiC9YsƱP.Ϭcٕ)s93Í/l疑O8"Mis0j֯N9XΧ_=r^ثSP">̮[&͕1tiRDtD̽?bI{zc` mؽ AwOPd݉0ӧ}8~T02aYZj+`F]iɕvSc/浀ah8oސk/S"\ĹJw:̂SCz7?쉋sm͘BZ3WyL 0pRu o[rXu՚3bUQ)#gϞY.oyt\>9w=ɄOk9:ؕ~aп|xzؗuQ盩W}؃Ѡf8&T߼t%.?'93D=0RUxIR.Rgˋi?+ b135aFE3wi7L6LKYSNl|tkd~ޗFW؏]$[q*rO{97/!c`zDx+,*4p.<MǏfӉHPf QN6+P ma¢*b;q~s*dwD8-C:-X,NG1cc? #˞x.˟cĢL Tػp9Ngyn̄t5FT$<{0?iIXbckmd81XUTP9Ѡ.qgg@ьk|s2+_mCHboc=6W.#t>3P L/hNC:.#edPNoYjw/#痾MiI5Ѣ[/ܾ_eҫWFDW%E="8gxz_?*Y"?a>y1E98_1>c9VjL㙴ÉsXqf{Xȋ,<+ܹ598Q )(4oaCFRn8՞O:L*CO鬺{Й*СK]SVg81rw׿ `!g_~OWg$|Y=Ӻ٣k_ychU2Wdp_z1,;dL|2ا]f787wk);j׮H*'tG'gM_59z4#oɋOľӪr'{'!h\PG!(uAQ uc/3·fCnA),(fn/uK܌^eopgc X֓8#?l 9{PtK+}!v6_^|mh8*EFSWȺ-m/]AJntl>yY`r <>0;Ny@{zYN=X'c=Q{&7կJ\!l;+|\kckCZPJbc/!R ?c2FS#Y+W$0ٜNZȼ[9ZJYӱܭu}ӷ>v=fёDFFMwu/u-f9r1x`w!rI;w.{}>Ozz:'v=m{at)'Oꫯ}ff͚uerN+tmɓ'ӵkoر."Sj\ [S]."wYJEģq'""[S]."wY.""""""Aԣ."M0"r)Ru:"rqwD]DB!@ӏ/`N%Lpb"""""DŜH˫Gت^sڕ)GM˖-OܢE?ɿaԯ_ݡJE6K7a;W/`2OJx%ZOJEDDDD2u Q:&»w6O2c}oOCbJEO.f){qy<DDDDDND]D3[c)C4G][9s,w'""""⥔x+j>ͣKV3cpT+_&s~dx%"ʱ&f;}{`dtOX"""""N֢L5“Z4>m;sːxׯ0DDDDDNҪ"R{WMJaW[űwgw0w(""""❔x-a^c?g)WuD>e0 C""""1x}m:g;>;I'-XµCrr2qqq%{`2FsEq3iDZTfƳݸ6JtqqqJEDDDD.zEUr~[6O]3Mbe1>/D][E1Pr&7bADDDD4.u vS3/O`#}`?Ch=ɉxx пaE7g pGUEDDD(Q6Wav^s{8𧂿 cx"V#aH4G]k{hWwdBNQV0 yc ǧ* `~:hwy}^?m^_ZķdO @\\\XDDDDbr"Rַj$<2Iת""""i)F!G6f#ZJEU/dd2*f=wС{$I.|Ϊ srHM&V;XߧREDDDDD΢D]Z6m\s"U|pz>Rk8ցg/3gobҫUϦ IDAT?a:2(ww"""""Q.^=Xчٜ$gfu|5a/o1l$UOpM5/YINDDDDiwj `4l+a6nd*9krG?lYMi1tX_S$]Q.^eCߝ9,_aM #0rZU+Ƿ8=\x ?E;pąS2=;w_Ƨ@Z]DDDD<u7H 6Sa|v~jʻRxl:1.""""JE\,yu1k3yĎ-,^Uń|ɺ?Qv6NoM 9-߈u;_9I))&Oѻ*z7\\k߼ jRph#ՎIcADDDDD)Qq%Ѐ8XDDDDD$R۳g_P?*/ߕg֠9~Xx*rV.YFvЪ""""i).9 v҉ $2Dhݭ M*30D]ąGڊ4G Gn>73o>Vql],EHxD ps&CU !""""rjze 'k^́,[ZTq9.HQ1۱WElزߏ:edHԵ껈x/hx#dzN݁P>{e{Nm.\v_+e0兹3*0C浦o)!"""""D\@\<Vst'f_ Z\Sr&QWEU/U{ ,)pa,nDbb9IKU2|/YwYSɞ.99=H"bU3gwŏrfNv9C [Kp wqs6_%{\\\PDDDDR.Nƪ:.9]zCe[CyX׶ ꆫrqE\ɤLrwg*LcT26Fm˪Bf8ۚqrԍx+~w$"""""FpoU%#sw0aԯ_ݡZ]{B)_-J~DDDDDDR.l>h.gudwwq%"*&#OFPNALvw"""""IsEoW]bnn#4!V}OD]k^ٿ9xŠh)Qj96qgN*nY} hw4JEMӰY|;<*wijsw|"""""Iɉx•y[#+}.u_gو\2bT;"ʙASk,ɌiaBw(""""❔x+K5bo)daIÂi.RF."""EF樋x+k؎sthה)i9깻Y11{!0;"UEDDDDbG]kvkR~J6<>y`,AjZv,[v vc¥lwU%'))Dwx(}6|C.uJER>M2g{>&A>-8,;II nf~!x(}6|CGKudh [7玟aP@wyHG02txb'?BCmdpk)4G]DzL=8<.Z8ONZ3 8>҃8NzZbY1r|O_cѢE\!gCG9}>RD]8v9=:cwփStcXvE[`-6I{K(xOCEae:!ҘG.,ILX29}b{G2  *6Q D]D.5eqnrN%peb+=DDDDDh軈7reY*R `I&Dm6bZu,ۡ35uuLױ<l~ŶpF4+@EDDDDuoۓ18DDDDDXJE9q1 Vl#Їtj_s2ymKtA,Tmڑ*r҅6/͠BLv\<ͨ(rwbbfC` wEy~tNr]KuTmײ5t_.m:_FlP1K,y_evp(ׅAQ]`;eY,uc+R]^I ciV}9/%"R*Y"=oAp6Ngڊ\,\+{͋`etY4m &hkAރkwa5dld$DHjj]X!pM4˙`)oBoq;9~ [0sur}s>^ӏkf2k&*tGӾHybp`l`).ܓ@:.Ɯ?+1K,Z׻8 .%PAR];ɮڈp&k(uU'wvҍ~%q Qׄ\,kؾu?ѠՊlG ʹ)nq ~RR8&ćbkja;$xs0MCyvk8.ɇ up+)9ghOe]&dLmpc,O35GCd\vI$B"r18JPXJFpa8D)kY9Ghȉ~ 9BgO@z0"Qyd: X-v hcdu8mu nA|fϻ!ΰEPa$WxZF%6\$"fawjl8LVeL)!VV;vǩYXjZBf8:NѼQj6ѪuU{ GχÊN(_5Ca72Zٗ>y;1c f43a-dk`x8-&'"DHX0Ge#gF:GѴAb",$P0Hh:6gGQE2| Yj7y 22wp\詵D<#H0ӡaOf5S :>m>s\S usdM* 1rG ~皣3j$Fe#U'j._:S;ʁݻeP7"#,,>LV_lS2sM:5?;q\޹>&p䤱{W.PѯOzz:'v=m{++VM6\"""""rKҪUX,6zq&OL׮]qcB'Q.""""""Ax%"""""""DQ.""""""Ax%"""""""DQ.""""""Ax%"""R2V_B*7#٘[§s+t> /ǗO,!҉Q%xŝ JEKWU/f)DD%"""RFX{x!G#// ^Z_0U&a*ݡ\3/86}Lk$Yk*)"rAT]He%N/n&6GWQj5EPǙ@} <=5k\N|\32 }v3ͫPQkyh;dɓxաV:\~HV1 BWsE8j~Ic}}/o  a%v;i.)+_(Mhe_S."""em#Bh(CMjaB'~go XԱ.GSvi&e!:igA'G-`M՞kx ״Lu b0бL`LZ!Tԃ&R'}ig ?ɧ>?#o8(e HQ*""" nzMbKK㭁CXPf/[_0ja!84H?68H$5<)d(5VOɵ??b=aMrNf.iOlo;|p¼Lqkپ}{aÁPM0DD)QKWM~eq֚pPjT#;g-deu6ykl}?}GW[_5 11|tNbhv:Xz,^k9Gad2ɳ1 Hz>MWk>dMny`2;q""rud\{aji]O_ˎР9]HWݶ β:ք!}*?^WJ M[Cnhnk|>mH5^Z0oF&AkF3#l;vcuKU<9[ij{p)ub ڎ݌ktܘU0UMǿⵄG|xZ?;R=I;М ??;E_HGnW/"r6رc:Ra^;t}4&O|3dZl%"""""gJLLyg>uTQ}L:Ν;u'NԈ;Q.""""""F%"""""""nDQ.""""""F%"""""""nDQ.""""""F%"""""""nDQ.""""""F]3_ƓKs~e}nQo2I_7/GHP8U; O|G az}]Kx{@s*GO!`=T2NϷrvy!>Ɖ=ͪәɳyDY9 `e|gR~l/s̶ycShB)ߞ{|\C,{mEZA?wkur ?"ο9/mo2ǯm@lx(ax}h?gXT.=^A?{1yQWUr|Ve8Úc_?AO's{;=1kE0p>-@6&_]p 5ndPPP@AA& l=f0c1W*Lʵ1@#˞ЊNJڿrW=CC/tfetà V m,÷DId6=K[uOnNx&{|t#pkO~ P=p-)MaimO՗g =f7đrx兗`vzMFh-#'+ IDATiR ׫}V ѳr0x>gqy1}nnօho/"; ΄Y|37)H|8G`Npuxݦ+-;9syk/'T,CJҏd1cp5éP*}\xj/Lj$yN#d-&1-Mw#\s}γ^Ӽ}̭؛խ2d&իW+Nۉ qL>oaxNLk8!mjSJ-oDz">Y I ЎV^.GoĎdgϱ[# {YdecO_Y&ޭ^d-$I!ydn{>~!|n&F]#P~4 7+E$v mGNfߵy3I[o^'{ :g( ˕p۩}ٵv>MI,߈as_+3c>#閭I'{aM҆ }_SO1㹇ճӠxjTƤ[ JEDDDD#YdstVA@?9Glr.,99ys 4?˅kOdxF籺 _C鏱dK֌%n\?vb0c}16-!DhK q]I[H@n69X\10(G7~i;!]MgMΟ7XaXs~x`Ԫ4s1gF.xO𖃸1a9 WZa3X>Dv~`80+\褵YӇ;o_Ko^tYnEx$# LL/׊c-w+/زk]ȧzM*m@ұ7g3TFsv;?k/:*UsOt`?}s6Ll6;>Qif7Y>Il[XyMPF3cwu>Ʊnb2Y0lE1*VB>n_OVs,y=؍w7-6qb؟~ GA>6% #7Mi΄)4dm{ƹݍuHը-Y*tѺ,̜M|wN-/{Œlӓk&sdr;̯y Wk&m1noyb2wj2L`s/ƷZu-e+Lp-odl?"Ǒw$l,xִvA8v,9͜/3JUL?@R'm8`vRr@>E4kR}6Ʈ=?pEc_y^ŪUX nZ{X̸+Y7f$wa;wߙCN툱[= ~$+v4%q{WU."""""▌hy޻7FWdձk;>ɣMlV۬ؑcw#x- 5?worC i7èd}坍T\3gK~U쐿O_C@",3|ÿ|Z3Ivsçs]qk/Q刎>ZʅMpD9[(-_#/"rO4O`1†cJ:y淤}sn7`;0`)fϞM=.CIKK`Χ/(81]d -[\Ŋ/{~qw/+l٭v&,EYI>F4㖼x%~D7o~qoS/ZQ}L:Ν;u'NԈx* Un-[_c̲ 3I]~h1I:8vM ׈ƿ-^( i0R6~\}ø`Qq#JEDDDDDD܈u7D]DDDDDDč(Qq#JEDDDDDD܈u7D]DDDDDDč(Qq#JEDDDDDD܈u7DKLLtu"""""RLr͛7wu"""""R4]DDDDDDč(Qq#JEDDDDDD܈u7V©?T"""""rz<6dΣDXlɞ=ǃY4Hɺ;P,z)!!!ʕK_DDDDD*U*͛:&NtвuwӪ_8JnM})!\ҥIO/Wu̟og+;wwg"""""rbc.O\Ža=ueгgyz,1 K{1E%"""""NSEDDD.Bbb"F(QZ*\4"""gD]l&ӧcɒdd\friiiLܥ$BQFnݚﾛjժy1{TGA-^DDDDDʕ+ٶm-Z୷b%r%"%dɒîADDDDDQFhԨUTo߾%k39rEDDDDthܸ1 w_ԯD]DDDDDD"hтDV.""""""rʗ/޽{Kn%"""""""nDQ.""""""F%"""""""nDQ.""""""F%"""""""nڵkIKK#%%ա\é]CqjE4qv\kbh۶C(+V`ݺuJQ[."qM}FF\Ekܸ1--FEm`W4("RZW."nM;OmQ."nO<)m punGm&nǵF]DDDDDDčhD]D-4313M%0Ob`.M o)|z]m~y;_hD z}yo4rAOmy1Q[.14.Rmzq'QxLjſ/ jLgVa7ù"5űb닟b'>bTP(STGj-w!9|{Sb\#=_';\{JJEJ; {7kG>+x9txQZ9#.œ~$7OLZX8c3:ԼLO{``μ9ktPW(G*4n wpjWvfyc&&ބuমڲ$sXO|l4r[7Mܟͼ>ajW\8Zs vzL9bkwf،X?)ҽAec*R>^z_b(W,OӮV%pňY$;侀y':%,{1Zv|ڶUƂqn,d/>MR\%}?S ;a՛&qP1^AH1}U"*S?O`-6 ,KJJ ӦM;k9v뱢3|G;:~7\C4[3S ϕ/ CӹFc_EV} îErDWMH7mݒnUμ>jݪ-FrE|0ӋW,pS.TQYxqS.r q^8{ʷu_!E0wG^-_ ~4L#ύょy~A:&?΋{kq_F^5+Ş躴iӐqc.OKcrXs7]O™fڏ| >[>'yLΖ0|U;>_Kߥњ_P6->͞=18<#_i|/߯æ=uܱ Ŏ?|Mq ~v_Eay?k#{vΣqse̚Y&<132g'Sl8+N ioz ,=-[ӧQN~?3bRƎa?ʬf(C:U2@dYF"4(Ftu˷|xsy ĨЂN BDGj>&F2bwdkhvP_~w%01MLcWǻA0~TALEyGV[iiuCdvYaU~^!G!'>;E<\Ĺ&nE+Oez ϼ_YwYPhnmA22LLV lZsZ**H޽;ݻw?m|/6o},1/ڧ5xcg6L݅Gy5<֯,̘Zt-93e~l[- {g\AD $E^'C[-bƵp볷R**QՎ'%"5}ߙeϿ"^c/boR/&0sL~`P]`$E^M/za/׾X&GũȆӈq(e%/_M:e 4K mڶUϱQ8]KYzbp80i$&:xGR60M;)ɩ-Df[Xo8aBhȱ)VVѹe' Ӱ 'p4"ύ2e0}ƈ(Vp}sYD3W㶒}bi\BXΝiIޘ{.<$>ߒ%;NmFzi~t7Eېӳn+Ն~Իr[j +K|BLHm{^Mh寱n,{**UҎ#ݞMԳ4!>$jx{)S&jy'/}N#ٿ ㊯gZo}o2jv/v .10A<27@ՒߦibU+6A?hۼ #_ӷu(qt5NBlazct`-N&V~&2‡{ˢsG)<ґ'kLPa=SIs4BsQvr HPH8a0"ÃUL|!_s2OQ[Ҧ{$$$Pb8kH$,a90n`cW0 7V ӟGYKn<}%F;֗iE`PmyiiK I_7=d8/.){7zSMQCLH:yS&]O%6hI=&2la7c`Hgڀ\=8"">U /0meiQ#%,<_G^f*iJNJ;`܃ΈmHw`lgʧ?߽8eoMf7oQ gy<^.MVb*4gv덞lz o'>J~.4sxefd5鳉\:\wr3_Σv_X[^^Ǒobeɡѕ=;~y:8+f"]E<5;_+Ob+ٷ =VW(""""♔x,2^M72D6/u@(W'""""ⱔxuaa>;I#>͈R """"Z.̼]Nk9V#ʺFt",%%%T\4f& 5x} U8y;_- qo.>>*iD]SFP̀K.KDDDD)Q8&јoY09dXϬ&p`Zk?9wO7*"7,xduWpE"""""M񽒷nEw3M"D]Q2CDDDDD5"+_Ij߱֏o\g҈_yN8>'n ֧ufM-euu$"""""rx*˹&>9WG#"""""x,/pgSbqkQq M}TLL^-Q7uP. W$hwOݒۯ''=-%Zq %"*o뷷".<EQqM}Tyd1|#LkEDDDD\Bre"v33ӼGK*i)QT >۳mI6w1uWP.|:2:q%O9 uh }]fr"r -n3xkNJJ"))x+iD]DN0 8q 6ۈ+㋹FKFEY6'Ӿo٧%ꆁ˛X _|O@'$""""")Qqpz^$/,\`e`d2m~pB m9F~Օݻ+i껈3v`fc';yݰuG*>z!OKfꇺd8_DDDDDND]٬Ǜ^Y83?MӖ28dwB,Ռj֐{ȭM±Lb^c ":. """""ND])$>8LOlg8%]NK.nLdܝ]Wkᣭ_+ 񈈈)8Ǿ좟+{?:)L؝'NDDDDD.6q#JE8˺oϊքx>ŁLP?7-G񄾱8!UoaV tކ|u"Id?j땨"`xѤk_6w`;ǾGؖH0սE<=r ?>=WW(܅>Sd4-8DDDDDH=3X˲E&?S_%JV'ƔoVϕNU/NXDDDDD8%"NaFFfϚGI"Й/>SgT/|=]RRIII[%HSE"Z0 gՏ Q9y_]ӥM,פri;ٰ)Jb=>>x+D)Qq yJ4?K2u83&oj5 W-b΂q(kHjDۚjDDDDD\D}qgeݨ|8NW¶{Ȱ{iu.BǛ;SU-ө.|ov5#;y}O;ܨD]DDDD Teu4.AFDDDDDѮ"l:9uOݜ;;f19%3(QTy35={ 5>Q"39x&QTyd)aIDDDDDx0q<]R8uf#v0pYk,疿@JE<}y6vrMo񉈈x&m&' 2an̴?^Ƴx&%"Z8?2{L+F.F""""r ?~C8/QT^u<5Wv'UWeѶu#?ƈz59Y2˂Hآvue!wXn-M݇g0{px/լzo>c{hkvږaD9+v,[!φ~>\!uEÉ-F;֦Ssv{2;PA, R;t[haHJJru!碟9|ȹQ.ql7M:ë<ǀMm~L35nlRגo37 Ga^GX7iG0DDDDD.]Z.ilktv=u/C;hObn^^4 Vo+&PT_6YtC7 9|ȹCJ3%"ƾ}M!(Z _eA_*I'f+ٙ?&-;^F\p[,$YĢs(;W%fN⺽d,GͩLgK@Z︔d8B 6^[oolg͵ٷ,]}GWUmޖJ%( Z((X"VdDEGAtT3(Q"  @zB$0r g'Y9kmJs8[\gYpKvdo_h+&^ K+V{B#?ɨC{Ύ59|%JKr DCDVLNf4t$"W ͊<{p4YYNcbjup].ՆT;HڇFrUՊdrڝXmsJۍ$V%U#M}ӯN+wXrF3nj u#2ӵ^uU80u 7{~pqq7L sfr"r'x.N2 "@ ^[~;Avf6xɉm ,I &M҂Gg$<~&̬bCJu9/Baffǀ[ֲCd/'l2,2sST͟jEzqt1pV GSt a& Ʒ@{9$BIHܘD*0[')LvnًAsnҷΑ"Wn*[vR/<3ذ5)3v5vv;vVĪ4sm5c\4 (/[Ɏ ޻4h t ^Uz#M{ؒ(&}V5 WNV.QkDc?F$'m B*b{ײt 1K4NS8^-Dܔ#Ua򿎎mN˂Y[dƿAo vtH/CɗХ  -1\.\f~_UbTQ6Fw̞;f(xF4 »DÂꉷM)U&:1c[vi _@jpc -uѲK>O g(pzL&ujSDBr)"""UxG$Q9Ҹ~եY @W%=;]r]f, -#~]"ohC1ߐZ"'oD6jJ!$f@1Kףo1a_:FmUyjtcˉM}x >5eDel0-9ΚRoDŗ1vކwM3פa1=o(QhސƑ33psyW ڼĆRgDLbd14R""(udmÇ#C^8IƳ}riikxSF@!`ZqY@Ji6}7?LtW<>n;=I5|w7OCt~۽?pD~a9YMe?3c?r <<=p[Ⱦ{H[2Xϝ9Cl)H$%; LJ:oX|r/z<kcl0a/ hڂsf)|35c0%,҂{ш%?ԊG Ci@h^oKCFX8v83O.K­qCYɶm̟J᣸% Xrd6aэ=B3HaF[l8@Z#o#syŏX8"3&M~01p "9A'pesԬqv#'pn-+^%6c%W8ۆy^^&lᛛE HxFŸ?ݫ|Ow5+F/"""R u='RG)$_׮fcU`Œ_deuzAu#N굨q?]|"W0n;?̤MLgsAA^݉($#W'ZZ~~rrjf9= EDDj6)Cq?[x 0C|vIDATnyy䕓lbl?K;yŸ9;}Zmg @a2^iykM]y.zM֝69N> 0p2Y$?~J|wu[e>fkv,z!c ~B."""UOg4 Ss4_KoɍNz1N{'3\X F׈M[Ҋ;{t:҄}VMlї&2.H<&jĤ9=FčsjnA'Ѣ8:ńnQ^ հ/y]ߐO wt^GN~5j^^uʞSED.oU 7{ՙpߢdJ/pV#ᵥep4Bʄ>Rn?òMi%bͪ\'r$7S`34@S rD9ْl*RL^Z0rBo[j=QSZO=1'>wɢҽyOL Yde oa6 *ӏ4)4]=7̣}$gyoB?XV;z6`ʾm}6%s$O$WGRXh;ak^d5SV \_Y3.m} e>4k|rEE6'M>x;+v84= |;aE|8GF-3sBǏˇI9L{ xe]~_.| oo kǫ!Iǣ>݃= aۧ&xm3sG^Nx7oO @x3[6~60yɧSe.gل|B{6w:]W_sS:GcRX޺;78b>&yO爉fBB+T ?_eЭwȵw~.y` 㱟xV7dߖ`ߝDZfgKYv&AM{2bP#>XMp{ K. ;Ҙ֜)]_iy0xD6~8 $`8#JNɮº0 39^ٞC(soG72h mq$` nyDujM67Y^Ju&Y4ޑ]+k^\awݳ7ͭ.}^Iqv]" ‡_my^;/ň;CΖ;1d_^v=×:㗟Knn:_BF~4ըp{R[*b}sxT\{,kևC̐#$ɠɨHݳM6i&Vܑ^v *INmK$oMڽUcw YLiH\r ϻy c6gb)tc;SÈl."""""L5)b=K䗹pNǬuݑ` objects greatly simplify the workflow, which leads to making the measurement with a graphical interface. Using scripts ============= Scripts are a quick way to get up and running with a measurement in PyMeasure. For our IV characteristic measurement, we perform the following steps: 1) Import the necessary packages 2) Set the input parameters to define the measurement 3) Set source_current and measure_voltage parameters 4) Connect to the Keithley 2400 5) Set up the instrument for the IV characteristic 6) Allocate arrays to store the resulting measurements 7) Loop through the current points, measure the voltage, and record 8) Save the final data to a CSV file 9) Shutdown the instrument These steps are expressed in code as follows. :: # Import necessary packages from pymeasure.instruments.keithley import Keithley2400 import numpy as np import pandas as pd from time import sleep # Set the input parameters data_points = 50 averages = 10 max_current = 0.001 min_current = -max_current # Set source_current and measure_voltage parameters current_range = 10e-3 # in Amps compliance_voltage = 10 # in Volts measure_nplc = 0.1 # Number of power line cycles voltage_range = 1 # in VOlts # Connect and configure the instrument sourcemeter = Keithley2400("GPIB::24") sourcemeter.reset() sourcemeter.use_front_terminals() sourcemeter.apply_current(current_range, compliance_voltage) sourcemeter.measure_voltage(measure_nplc, voltage_range) sleep(0.1) # wait here to give the instrument time to react sourcemeter.stop_buffer() sourcemeter.disable_buffer() # Allocate arrays to store the measurement results currents = np.linspace(min_current, max_current, num=data_points) voltages = np.zeros_like(currents) voltage_stds = np.zeros_like(currents) sourcemeter.enable_source() # Loop through each current point, measure and record the voltage for i in range(data_points): sourcemeter.config_buffer(averages) sourcemeter.source_current = currents[i] sourcemeter.start_buffer() sourcemeter.wait_for_buffer() # Record the average and standard deviation voltages[i] = sourcemeter.means[0] sleep(1.0) voltage_stds[i] = sourcemeter.standard_devs[0] # Save the data columns in a CSV file data = pd.DataFrame({ 'Current (A)': currents, 'Voltage (V)': voltages, 'Voltage Std (V)': voltage_stds, }) data.to_csv('example.csv') sourcemeter.shutdown() Running this example script will execute the measurement and save the data to a CSV file. While this may be sufficient for very basic measurements, this example illustrates a number of issues that PyMeasure solves. The issues with the script example include: * The progress of the measurement is not transparent * Input parameters are not associated with the data that is saved * Data is not plotted during the execution (nor at all in this case) * Data is only saved upon successful completion, which is otherwise lost * Canceling a running measurement causes the system to end in a undetermined state * Exceptions also end the system in an undetermined state The :class:`Procedure ` class allows us to solve all of these issues. The next section introduces the :class:`Procedure ` class and shows how to modify our script example to take advantage of these features. Using Procedures ================ The Procedure object bundles the sequence of steps in an experiment with the parameters required for its successful execution. This simple structure comes with huge benefits, since a number of convenient tools for making the measurement use this common interface. Let's start with a simple example of a procedure which loops over a certain number of iterations. We make the SimpleProcedure object as a sub-class of Procedure, since SimpleProcedure *is a* Procedure. :: from time import sleep from pymeasure.experiment import Procedure from pymeasure.experiment import IntegerParameter class SimpleProcedure(Procedure): # a Parameter that defines the number of loop iterations iterations = IntegerParameter('Loop Iterations') # a list defining the order and appearance of columns in our data file DATA_COLUMNS = ['Iteration'] def execute(self): """Execute the procedure. Loops over each iteration and emits the current iteration, before waiting for 0.01 sec, and then checking if the procedure should stop. """ for i in range(self.iterations): self.emit('results', {'Iteration': i}) sleep(0.01) if self.should_stop(): break At the top of the SimpleProcedure class we define the required Parameters. In this case, :python:`iterations` is a IntegerParameter that defines the number of loops to perform. Inside our Procedure class we reference the value in the iterations Parameter by the class variable where the Parameter is stored (:python:`self.iterations`). PyMeasure swaps out the Parameters with their values behind the scene, which makes accessing the values of parameters very convenient. We define the data columns that will be recorded in a list stored in :python:`DATA_COLUMNS`. This sets the order by which columns are stored in the file. In this example, we will store the Iteration number for each loop iteration. The :python:`execute` methods defines the main body of the procedure. Our example method consists of a loop over the number of iterations, in which we emit the data to be recorded (the Iteration number). The data is broadcast to any number of listeners by using the :code:`emit` method, which takes a topic as the first argument. Data with the :python:`'results'` topic and the proper data columns will be recorded to a file. The sleep function in our example provides two very useful features. The first is to delay the execution of the next lines of code by the time argument in units of seconds. The seconds is that during this delay time, the CPU is free to perform other code. Successful measurements often require the intelligent use of sleep to deal with instrument delays and ensure that the CPU is not hogged by a single script. After our delay, we check to see if the Procedure should stop by calling :python:`self.should_stop()`. By checking this flag, the Procedure will react to a user canceling the procedure execution. If your :python:`startup` method is very time-consuming, it is also recommended to query :python:`should_stop()` within it to allow for early cancellation. .. note:: Instead of emitting results one by one, it is also possible to emit results in batch. As an example consider a device that returns multiple points for each measurement (such as an oscilloscope or a CCD): :: intensities = self.ccd.capture() # Assume this function returns a list of intensities for each pixel pixels = np.arange(len(intensities)) for pixel, intensity in zip(pixels, intensities): self.emit('results', {'Pixel': pixel, 'Intensity': intensity}) The downside to this method is that it is cumbersome to write and can be slow when the array of data is large. Instead it is possible to emit the data as as a whole: :: intensities = self.ccd.capture() # Assume this function returns a list of intensities for each pixel pixels = np.arange(len(intensities)) self.emit('batch results', {'Pixel': pixels, 'Intensity': intensities}) Please note that you have to use :python:`'batch results'` as the topic when emitting results this way. This covers the basic requirements of a Procedure object. Now let's construct our SimpleProcedure object with 100 iterations. :: procedure = SimpleProcedure() procedure.iterations = 100 Next we will show how to run the procedure. Running Procedures ~~~~~~~~~~~~~~~~~~ A Procedure is run by a Worker object. The Worker executes the Procedure in a separate Python thread, which allows other code to execute in parallel to the procedure (e.g. a graphical user interface). In addition to performing the measurement, the Worker spawns a Recorder object, which listens for the :python:`'results'` topic in data emitted by the Procedure, and writes those lines to a data file. The Results object provides a convenient abstraction to keep track of where the data should be stored, the data in an accessible form, and the Procedure that pertains to those results. We first construct a Results object for our Procedure. :: from pymeasure.experiment import Results data_filename = 'example.csv' results = Results(procedure, data_filename) Constructing the Results object for our Procedure creates the file using the :python:`data_filename`, and stores the Parameters for the Procedure. This allows the Procedure and Results objects to be reconstructed later simply by loading the file using :python:`Results.load(data_filename)`. The Parameters in the file are easily readable. We now construct a Worker with the Results object, since it contains our Procedure. :: from pymeasure.experiment import Worker worker = Worker(results) The Worker publishes data and other run-time information through specific queues, but can also publish this information over the local network on a specific TCP port (using the optional :python:`port` argument. Using TCP communication allows great flexibility for sharing information with Listener objects. Queues are used as the standard communication method because they preserve the data order, which is of critical importance to storing data accurately and reacting to the measurement status in order. Now we are ready to start the worker. :: worker.start() This method starts the worker in a separate Python thread, which allows us to perform other tasks while it is running. When writing a script that should block (wait for the Worker to finish), we need to join the Worker back into the main thread. :: worker.join(timeout=3600) # wait at most 1 hr (3600 sec) Let's put all the pieces together. Our SimpleProcedure can be run in a script by the following. :: from time import sleep from pymeasure.experiment import Procedure, Results, Worker from pymeasure.experiment import IntegerParameter class SimpleProcedure(Procedure): # a Parameter that defines the number of loop iterations iterations = IntegerParameter('Loop Iterations') # a list defining the order and appearance of columns in our data file DATA_COLUMNS = ['Iteration'] def execute(self): """Execute the procedure. Loops over each iteration and emits the current iteration, before waiting for 0.01 sec, and then checking if the procedure should stop. """ for i in range(self.iterations): self.emit('results', {'Iteration': i}) sleep(0.01) if self.should_stop(): break if __name__ == "__main__": procedure = SimpleProcedure() procedure.iterations = 100 data_filename = 'example.csv' results = Results(procedure, data_filename) worker = Worker(results) worker.start() worker.join(timeout=3600) # wait at most 1 hr (3600 sec) Here we have included an if statement to only run the script if the __name__ is __main__. This precaution allows us to import the SimpleProcedure object without running the execution. Using Logs ~~~~~~~~~~ Logs keep track of important details in the execution of a procedure. We describe the use of the Python logging module with PyMeasure, which makes it easy to document the execution of a procedure and provides useful insight when diagnosing issues or bugs. Let's extend our SimpleProcedure with logging. :: import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) from time import sleep from pymeasure.log import console_log from pymeasure.experiment import Procedure, Results, Worker from pymeasure.experiment import IntegerParameter class SimpleProcedure(Procedure): iterations = IntegerParameter('Loop Iterations') DATA_COLUMNS = ['Iteration'] def execute(self): log.info("Starting the loop of %d iterations" % self.iterations) for i in range(self.iterations): data = {'Iteration': i} self.emit('results', data) log.debug("Emitting results: %s" % data) sleep(0.01) if self.should_stop(): log.warning("Caught the stop flag in the procedure") break if __name__ == "__main__": console_log(log) log.info("Constructing a SimpleProcedure") procedure = SimpleProcedure() procedure.iterations = 100 data_filename = 'example.csv' log.info("Constructing the Results with a data file: %s" % data_filename) results = Results(procedure, data_filename) log.info("Constructing the Worker") worker = Worker(results) worker.start() log.info("Started the Worker") log.info("Joining with the worker in at most 1 hr") worker.join(timeout=3600) # wait at most 1 hr (3600 sec) log.info("Finished the measurement") First, we have imported the Python logging module and grabbed the logger using the :python:`__name__` argument. This gives us logging information specific to the current file. Conversely, we could use the :python:`''` argument to get all logs, including those of pymeasure. We use the :python:`console_log` function to conveniently output the log to the console. Further details on how to use the logger are addressed in the Python logging documentation. Storing metadata ~~~~~~~~~~~~~~~~ Metadata (:class:`pymeasure.experiment.parameters.Metadata`) allows storing information (e.g. the actual starting time, instrument parameters) about the measurement in the header of the datafile. These Metadata objects are evaluated and stored in the datafile only after the :python:`startup` method has run; this way it is possible to e.g. retrieve settings from an instrument and store them in the file. Using a Metadata is nearly as straightforward as using a Parameter; extending the example of above to include metadata, looks as follows: :: from time import sleep, time from pymeasure.experiment import Procedure from pymeasure.experiment import IntegerParameter, Metadata class SimpleProcedure(Procedure): # a Parameter that defines the number of loop iterations iterations = IntegerParameter('Loop Iterations') # the Metadata objects store information after the startup has ran starttime = Metadata('Start time', fget=time) custom_metadata = Metadata('Custom', default=1) # a list defining the order and appearance of columns in our data file DATA_COLUMNS = ['Iteration'] def startup(self): self.custom_metadata = 20 def execute(self): """ Loops over each iteration and emits the current iteration, before waiting for 0.01 sec, and then checking if the procedure should stop """ for i in range(self.iterations): self.emit('results', {'Iteration': i}) sleep(0.01) if self.should_stop(): break As with a Parameter, PyMeasure swaps out the Metadata with their values behind the scene, which makes accessing the values of Metadata very convenient. The value of a Metadata can be set either using an :python:`fget` method or manually in the startup method. The :python:`fget` method, if provided, is run after startup method. It can also be provided as a string; in that case it is assumed that the string contains the name of an attribute (either a callable or not) of the Procedure class which returns the value that is to be stored. This also allows to retrieve nested attributes (e.g. in order to store a property or method of an instrument) by separating the attributes with a period: e.g. `instrument_name.attribute_name` (or even `instrument_name.subclass_name.attribute_name`); note that here only the final element (i.e. `attribute_name` in the example) is allowed to refer to a callable. If neither an :python:`fget` method is provided or a value manually set, the Metadata will return to its default value, if set. The formatting of the value of the Metadata-object can be controlled using the `fmt` argument. Modifying our script ~~~~~~~~~~~~~~~~~~~~ Now that you have a background on how to use the different features of the Procedure class, and how they are run, we will revisit our IV characteristic measurement using Procedures. Below we present the modified version of our example script, now as a IVProcedure class. :: # Import necessary packages from pymeasure.instruments.keithley import Keithley2400 from pymeasure.experiment import Procedure, Results, Worker from pymeasure.experiment import IntegerParameter, FloatParameter from time import sleep import numpy as np from pymeasure.log import log, console_log class IVProcedure(Procedure): data_points = IntegerParameter('Data points', default=20) averages = IntegerParameter('Averages', default=8) max_current = FloatParameter('Maximum Current', units='A', default=0.001) min_current = FloatParameter('Minimum Current', units='A', default=-0.001) DATA_COLUMNS = ['Current (A)', 'Voltage (V)', 'Voltage Std (V)'] def startup(self): log.info("Connecting and configuring the instrument") self.sourcemeter = Keithley2400("GPIB::24") self.sourcemeter.reset() self.sourcemeter.use_front_terminals() self.sourcemeter.apply_current(100e-3, 10.0) # current_range = 100e-3, compliance_voltage = 10.0 self.sourcemeter.measure_voltage(0.01, 1.0) # nplc = 0.01, voltage_range = 1.0 sleep(0.1) # wait here to give the instrument time to react self.sourcemeter.stop_buffer() self.sourcemeter.disable_buffer() def execute(self): currents = np.linspace( self.min_current, self.max_current, num=self.data_points ) self.sourcemeter.enable_source() # Loop through each current point, measure and record the voltage for current in currents: self.sourcemeter.config_buffer(IVProcedure.averages.value) log.info("Setting the current to %g A" % current) self.sourcemeter.source_current = current self.sourcemeter.start_buffer() log.info("Waiting for the buffer to fill with measurements") self.sourcemeter.wait_for_buffer() data = { 'Current (A)': current, 'Voltage (V)': self.sourcemeter.means[0], 'Voltage Std (V)': self.sourcemeter.standard_devs[0] } self.emit('results', data) sleep(0.01) if self.should_stop(): log.info("User aborted the procedure") break def shutdown(self): self.sourcemeter.shutdown() log.info("Finished measuring") if __name__ == "__main__": console_log(log) log.info("Constructing an IVProcedure") procedure = IVProcedure() procedure.data_points = 20 procedure.averages = 8 procedure.max_current = -0.001 procedure.min_current = 0.001 data_filename = 'example.csv' log.info("Constructing the Results with a data file: %s" % data_filename) results = Results(procedure, data_filename) log.info("Constructing the Worker") worker = Worker(results) worker.start() log.info("Started the Worker") log.info("Joining with the worker in at most 1 hr") worker.join(timeout=3600) # wait at most 1 hr (3600 sec) log.info("Finished the measurement") The parentheses in the :code:`COLUMN` entries indicate the physical unit of the data in the corresponding column, e.g. :code:`'Voltage Std (V)'` indicates Volts. If you want to indicate a dimensionless value, e.g. Mach number, you can use `(1)` instead. Combined units like `(m/s)` or the long form `(meter/second)` are also possible. The class :class:`Results` ensures, that the data is stored in the correct unit, here Volts. For example a :python:`pint.Quantity` of 500 mV will be stored as 0.5 V. A string will be converted first to a `Quantity` and a mere number (e.g. float, int, ...) is assumed to be already in the right unit (e.g 5 will be stored as 5 V). If the data entry is not compatible, either because it has the wrong unit, e.g. meters which is not a unit of voltage, or because it is no number at all, a warning is logged and `'nan'` will be stored in the file. If you do not specify a unit (i.e. no parentheses), no unit check is performed for this column, unless the data entry is a `Quantity` for that column. In this case, this column's unit is set to the base unit (e.g. meter if unit of the data entry is kilometers) of the data entry. From this point on, unit checks are enabled for this column. Also use columns without unit checks (i.e. without parentheses) for strings or booleans. At this point, you are familiar with how to construct a Procedure sub-class. The next section shows how to put these procedures to work in a graphical environment, where will have live-plotting of the data and the ability to easily queue up a number of experiments in sequence. All of these features come from using the Procedure object. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-estimator.png0000644000175100017510000001236115203313266022602 0ustar00runnerrunnerPNG  IHDR;nsRGBgAMA a pHYsodIDATx^kGƟ72I/ٲwƚwέD2`,'- XFyc0k$wckR(]UuuOMF1S|3noo@!)/! Ņb=|i!a}رczBի0-"XBŅb ! Ⲃ+ 2reE896!PR%ry_J(j.  W za|BL!VH(.[᜙*ɨbzEʝHCT^mpk\)]n߾@^9ߕ++b_TݡUu寸5R\-✛BNo1po4/ӆ~~\u-6}/*}! אu _4jMQ:!ۿLbc.=wVD|{jc%Q%v[LF+lGǮr_=kmO7Ej$/ӑ(0Ĭ/儐I] z 9R{GoUiȈ?]a=#!41\d{-?=X%o+b/r߃jŹLWi6hBHWф7ŅbDGILtbE+P\!VB@q!XBŅb ! B(.+P\!VI FÉ'Z|(.$SN-ryŅ+..!wynq ! B(.+P\!V%.}G zGlB_-l !}ׯ^n?;JXʗ֛%^==em ƥcCoBb˸|Y.Ch[/@қi)07D4mV^F:yHڼgD?}*56O'%2;m;:# @Fmo /9-Nmi\v"뷟7B}c.'{_f(B0e3^1ȉ|2M BoQBHIkyTîxvF0'EC] t"v%֠tjnf-(>`o@W%*.f$2<7EasE[vYtUBH KBZ>=-HA z<&30/JEu,͚HaZ8DZEQ $Mc^0ev[Ot2PQI0[eBE<qVS,vMBeNU_Wi_X28+VAq-'KRdFqm;)EE:7ȴ39#Qo"Wn72Y/S)Yk2yuBB%yy[):HŋOã:IpB"ENER\?BH1B(.+P\!VB@q!XOH>&~(DGL%:"q !MŅb ! #."_ 7y~B)E 9Y@~)=1x`L y+)aƒ(y1<E.#-i#t)@',H2/hۑ1fZť nytdu]븩y*3ucǸp&>T\ocbA2mBqy "y1#c#s<ۧ>-";]wuHt+GE`rLKAXDŽ6RFXT~c(wFAusܫ:9F\1Hs5' iœ%Q h@Uq}+v #(T# 4;8TsgLBcH_%UDI~#$S4 H[^z?j4#΋H&. ȱ M\*x>Xtg5LuAҔD9/pdl:q1 i]ƮAĕNj9XZyL#D] 3#'E^k:26Hą?\$4B,p(BB@q!XBŅb ! |ZDQ4G$%:b/ё Hi:(.+P\!V8<ڈԱ>!xRs_:/> B'(bAEuN$>>E3IX;;L,E&W?A\w. C,X ?';}'/%B}zf I }z__wD œ/9k 9j:޻8b,TKaQM8m_3-ʢXSnN"7( \'; vyK"'ļcgv.U/|S/H4w]sSTU☤=u+zj˝[vrsp׽= xDv%,pRd;ѶtCh9}ѱ.Q~jkiuCQPbg|ȜDνw^n̨ɺc@n& }8Kg ; C?6ü.հq1B`nX=$.>7q3p}{sQzL:t$uzO@'NY"i}kH?`gV&>#%aŽocǻY):v-0ocսvT "nc*F_ؔAN0@s18ӡ.U=.EjmEw1Q+QzWQRN?rZ63sOZ4.{``/`(Hz2SV|:XV@;q ;UzK]F͈,u4#`UXBEx >Pybl?HGIxrJD*!-Yt&|jH\M^Ѝ âxU/;_i8zu$uKt8&È^U^v|^w4Ը_(28+;,.I T /XI?fz&r`yU'Wkحd1A a6r #^^qLQxδ^>+3,`EDRӶo%..ܮrްQ֮b^GuQO*ژP;۝e'c.kϼ!n{P5|.<=|H{#FUp)+UٱmGYm!;0C,ӽ]v%n/RӶaZ?* CL qe}|as#h&URﶰ%;2ĿI!(9]E~Y|RDS_aE/|J [>oqq1 ۏRvfgwqvsNa^O$7 inf"_G}|ay#Kr8 ^籎W B(C]nbF$#wWAx-]dһ7;"%ըkj֮/r\v#>Yq#rD@G1^50bi!*QOHh(;S8HmQJbqjy e*}(N]}d9z gw#xx=&?=]s1ZTKDk %.rC[ʥkqk-/:kzD-Fǰ_uK:B jp3 wkpᶳ獪Ugw7s_Zɇc=:EKσO2=9gBt1rMBGnd-22N B$1j wbD\0"roȅtP\!V`ZD5u MRoZDq!Xi! B(.+P\!VB@q!XB19x IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-fileinput.png0000644000175100017510000000616315203313266022575 0ustar00runnerrunnerPNG  IHDR*RsRGBgAMA a pHYsod IDATx^{LTLEtv=ڔ %並㫂՞@:RZL;3C5mt7Kfw [DFHL}=G]vd}ΕJi ؁ƮjU5+QKi-}$rZU m:;Ǝmuu5Ul?tؚy:E]a%-ygSGWl*Jyݡrfgr_~]ELb ߼QFw!r9,qy Y?R UakZƩbю<fk0H҃%{jԳ:-YCWKvfʟ>(6%El8V"E+-nDK{5LG5rB5T\.-fja6kD# 5 ںxFtt-qa݈W{T=w*]ȉm !X #"FR +!t-v!C.с D[}W>WYVƙvE}_ikJq勑+wGDBG_vMh-l8"{kB>e!H@ !!222Eߟue56olJ/Ɓ|nnnx<1L" 㙚 !2C $ @B $ @B $ @B $ >mڻwH088iӦtv}i`N:xDZFSv>@B $ @B $4QA$׶ #Dh]>R&s3$h2rjӀzbJI5U NN }6Cm"# l l刁C/kҪfQ%4M,?|(>o;ho=X!Shl ppǢŏ=J5 &o}Bk1@5>l$z`F GgE,ll„h#jKjzF[KWmNC(Qڒ4`#H/采ۍ# ګ_kzB $ @B) ~$0ib2b2o]X#9&?Iɳ?j5YRHl5YRn׋4edx/.! ?P`NXR,H C1:;;)wknOL`DV5\h=,R_ P19?5*")yr3y{Usld]X>/}CMy;Yyb¢bN~W㝌,Zp]O^]WAa@($ zgrmۚ)7+=wKJѾ4ϳELVjP>ɉ̧F7R7]!wq{=foL4> DR ^{vͺ3)QhG")qN Z, 8ScϜS3Nm}!j/f9#3s3Sn5|z d֒uA7")ӰԀl)A7"X\\ޣϔU2b,]j>caaŋ."W.j+H k|uύ ?t*H@ !H@ !H@ !H@ !H@ !H@ !H~rrc̜s>:S Lu=C,!\ѱDnBN;ݾsN=N^J` n;555Fub]f:}۷o/((0 Ղ&(扬1ƨ)T 2Chĺ.+;;[$ A7HĄ" L"aȉ bkFj?dɊ52B[^#3֭"pQQ|V9q}!.^\oСx A6ZkT>/kNL>Q˕' "w5([Jk{?i"$<#ݩ$u?To~[ã)%҈B(%eɉ£GJ9eFs0j!DbFI^v5"WFO|Pŋv+FqוplPvw)w{#ivgS&9`>~D;BHZ|WQ|!565[N*l'j-; "˨ LX{Vcx̸xI$(%ﱾϡˑ?n:944TNKj'{Ϟ="5ޟrii3ſSY|BYKL]8X'`BD 52L^L$+(::DĘ;d $"a|>_?xB. JdvIfbZ6=cF҅7onذ!;;" gΜlF҅}\.nh Y`  "@P @A (D@S/lSB(O#B" ]L !a&:n(:[OV07j`"eRuC۸+{@`CO,}x=C6.% JDpmNGiЮYfow OG1!Tz~Oإ(O.5AR{+9ÃD t?.C zZusZzxf }i*BC2B[f_}v{olؗ}iܫ-˶W.n_9y}4\qDe"d0M ӥ%EE%J K6fTUdn=ש,^Gq1}_?MtLEв J9QYQ`=.ǝz\<^Ezk\--j ||#'^jmPZzZjL^b:M $Ò{r].I -tky*ʟ f׋\" gvzɨmSmQ!x?70?t,l1d ~%حY`INCXPK֞{5APkN."r,̳\ٻv=@ZKVCnVuO.~i@ $@w {qbno~Hÿvk|:ZG&91ci[yݹsp2'xVTYa$NBґW)XЪ:17 6- ΏJg:,{ѷxoFpZv˲A&F2{ qt/ ~|csgϗXϗZϗCO8WC˵qWde'IA2fG)k[QKRyG ^MEx0a"kԔjMM,bD򶽓6>_([O:dZɒxmķF!Ąnz y!o{'gx4-,$7ARjd\ZZ ̨HBnk{H5St,, )XO }O?y7Pn,$co`:"`fPL.vfg(C;gxn]]xDad-+V<!` ,(hM:O>K^ yGJ.C&( T*lRjUFղo_h HaBPad+I!/D-LE,s 0?+ֆ_1Rᥢ@dadryq$%"d$I% CSr m4m,/w+dCye6m2Ͱ5V|۹-1>@A (DЭG *y IG-FGG-2o@RJp\Vubbn[9*dgg{(**Z @v܃Hb21lܸi)`>`!  t lA("_#)^A |0 8]Dwx<j?DKPS P% \LNNSSдjX,=Mfс'1%Á tfff8X < Qy<+&p==:j(@p8rFv8H@pp#&QbFŹ<8"PzpQ: Xsf.Jvڵk>(7q*Ҝmʚ5b"!a0 }tJ K?")'{Ds@ 1;;ˍ Fxb%e, Jf(, If1L  =Ԉ?rlljI(厩Lc5 D`2 "@P @A a?#)ڧIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-fileinput_complete_filename.png0000644000175100017510000001024015203313266026314 0ustar00runnerrunnerPNG  IHDR*RsRGBgAMA a pHYsod5IDATx^klg'Ə@{b>!".T1J!2E *D$"dFPCIj@Q]#kϬgmi{ٙ{ٹ׻! Ad/PP @A (D aB>oz/˶Ew@AC?8{t8|o_$CF^; s.Rw=+i7Ot;Nu&J:c+yuНI\yH1o`oM@C'#Sl_/!2evGK{겴^ t=H;4x~W~|K!ch`P+} p|hīQu8lCko{\:eQ\l}[Zc{nMج~qת}AZF~p2qg}Zo{e2X?;hqUIl[P^!] S(ߺA ׯ6ѭ\2*g]'6j&7I\U?'ͨx2돿*WZnYVP6H5e$q ȃ:]{\Lēi׷`ø!c 5Usm>iD0<:!` S8qMoaG H&Ń@"m|u1 I#Np1 ٥NFN<&ٸy\s$7e:xݑCD !B O 4+I9O|km[!45Si6>MyAKn%/ L_o.pȩ}@A S"@P @A (D@>DvvH4e,XQkf4"͵ل D" nȈbS:~!"@ ԫ`o/O׫:yav÷N DTGuK˅I vwcׅUci _rup30&{|K}5YM?ng>jJꚩAՌV!M u)9ϝs.#EykDCzf*4lpoٰq[wask4~]WuZ:7qKG}6ͭɶ m;׸L`'#tcfo42]&D^ 6Ulst|[ˇ25HHn?Zr>X*} WH'oصM z9گ;YE%ovuhZƽ5䂀>8/JCPk,%$4$4*ۉ0BF|+@&mSd4 .0H8/\ޟ!^CD@y.ɸwR턣mXR הop#7H#]U:y ZI$ Lր<N$ԲkDH$RXX $P HjWX?*yy^",#Ġ@LE+4-ČI$6Hs'D^^/#f&Y($!z{3Ysb `K"&y"0 ~ŏG9r V33`ptt4b+L*d(Sπn~j:QO@"S|E^'s r҅ZImeo;FDeqәɂ>8k=M# 8Ձ H! 1paA8u8)W@szaZm+/MQ"jH K/,Tتb[BQ-`Iw\b.) !;"Z#Y$11&a,A&^ 2l1+***9'''-qm&OY.a!@PZ$H*qM%iAcxxv~Tg%%%奥 'F =OOO`Àe]Ac: -ɍE$kzVK%_I "%yi>KZ:HA,i5"ϖ켒VoP&c HKO*Y8$ >I|g s$v&VՖeFbQ)"9XFV^0!RGci~Oؘ;n6#~oFaBRaa_BHaM XŠ챟ּgaB%>l ,+-_TU$ܞ| ?E1 "5#YACp8<,yc Ru44 B# w,VoDFñH( {>షSR+( n {xy C1 "%xsw {=C ? GcsfѻIHIޞ'@z弁aP)ɳ$ ~%%H=(daKNHNH[Vj0x2{)gq6 z&)޺w^~e^F-Z}SWР2bjjjO𲈮 & @A (D "@P @A (D "@P @A (D "@P @A og$ጜK͇X,W>Z$ Z@D[v6o݂DGv^tm?)] 2Qtl= -R=Tm^SV)& <\jcӷn]b[o7>1^+e9쫫k5M*g~6RgBPYTfm\wH7.B']F[ѷ oVJElyTD sTtŁ4EcμAԊ(I**q l\)[(B23# BJo~夜jg*bμѣݕQc2CǓҁo}R΁IHԀa-TQB_^SYTTq n #[3L {mϧ!}Aǵd+s{ڪ^!IMFc*@1H3~Z.$ R$w%Ehӯޅg!L4qi=Rmsݕ+W>P|S9xf/|Ri}uqHVR8^γ,^Y,sQ3%DFF)D/p8x3 ZY)dFF~.2RӹIT>|@dk*ͱ9PCb? $@A (D "@P I?``GNIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-fileinput_disabled.png0000644000175100017510000000403715203313266024422 0ustar00runnerrunnerPNG  IHDRs7sRGBgAMA aPLTE𩩩kkkbbbᘘ·66``6`··66```6·66666`6`66``6`·6`6```6`.L/66`·``6`6`6`·`Ϋ6``jjj`66㽽˴°仏َ99仏xx9ee9َ99َ99仏ХxxxxxxxxxxxxeeَХxХxxxeХxxe9e9eeӻeͺM< pHYsodIDATx^횋_E8=8PK⑨*8uB ǩEvefӡ9ﻳ3w7AD*s0"7QsyYKK9ٳ77WXBM6oT9afc{Xq-b[\e`, f2G4!m+1 a~BmvDKcǟv#_ ;'w*\*{4- ^P$UpۊbOl5To&[ա*y׆mm_K/ 9 cYcPY;Β]ڄ / 0Cl{ąia;ˊ{+/qT±9V1x7`uh<&lVv>Dqv|~o .NC /_KlyIfČ0-ߝe~{F%س8p9)fCBqݟm 7/܇Pl9)&'ߚ,.]#1+@ vn&G0! w71X^8)VjtU ѿR m fڰSZ#ЈqF05|ɾ6qp1&G{ %}A"/9wgBIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-managedwindow-queued.png0000644000175100017510000025401015203313266024704 0ustar00runnerrunnerPNG  IHDR\ pHYs  tIME"5l IDATxu\TYiD;;֮unX{-|\[QQ@:{?fHU]{ܹsyyι\)3b@1 f 3 f 3b@1 f@_@3YFԶbN0 HC5ǽ1UC[O?7 Wizkoy 61ԫYcA*Kvww*T*0B1BѠ\=M,%dwAq*S c o@UTJү7 7.xr3'(f r9+r`$ yX 8E/_zYʥ'Éw4ヵM-Ʋ!SGgxzh"_##"xbLo޼8|snA04}k:͝Dj ncx""$mˤʖH(C?[Q׮]tǰ@CcҥKϟ?yÆ mllr{<~$?x/L7ҫHHf` i1fHVx)hݔω\B},wh>nh5KC4>I$l;}q+7]%qf}-9|'$*Qˈ[,QQrrÅUO Ջ%޹2Vx}:8~I$*ȯe޸HOսۯ9µ|}k8 N_{'{yu["c .)TгgϞmVu m`Oo,X~1& )!N76)m[G x رcGڥmfsΟ_ZX7oʪB j[LKdVu ;juk하goyv8|GtVў_D/tGR~[[^ $*Z׷u)!<&B-=~ਈ0"UR !7 $èElllmmT*y*ZjZV}cM DԮ][T:Z,ˤ#"b^jj`L.JDN7&d4;Tq1)ERK}Fu\:M\@HdN$ԉjRgy,#R,} #>_^*1,3w '1@"## a Y )bt0SBnbLax ,po~mX̹aͻzOs'?W#nAoOdrrqY՝^4͏PCJCXaxʕ\$x?V@tf/p2*eZMS!f N,7UJy(8Z-wXW:_^nyP@P`A7* zswի:JTwgu8buth}D}֭nXyy 5_}bO]tIXd6٫5DyŤ߆AQ Րҳ^Q;IbǶ_k۳A܁7Kv0ګ-7{l8x6bbgV-raNT-$?[׉"b ]Asf)n8![m:(Z/T Jqf3g2xt򱪢u҈3Si܉V J(p6} 3g_ƶiC'_[8pΟo2M+;ȪvX>E6vSfjKƯ .3pMGW9{uO*L]sÜn?:"O.?7LS$)\3D3gXjhS3 t;oD% #ҿ?y}AWWߵ?)o b>^U [V՜MDm>8%GQ oyL`zxYBG!E+Qr<ĸ07wʽFn#;nO+Sa}Fn dwo5j/%ʔ.canSr"%'j&$%$tfYo{}% - 59/u+aurv>QB;D];w!OgVINyʲgoz*o wI^=Y"mn3mՐ"ikܦÀ~ =͒^>}yCLҔxk.Wt3}+\XvIRI/^QLEWZ~V "όo mSTpe/kM 83ȭݘvOl;IZmʯwɊtS޲CU۬}~{湿*ެUB.d܄9dL:lV^[V;U١&MѪ-YKdkN=+s: .لLʁ8!'e8saġ1F)CCZv8k9doV{w]owt@ԿnU"N~2~iZ\~;JTaODG |8_k6ho}dڍuHM[zïzU >=sD4/.nۍpEQ.ˏ :{&&$KوKvZwءqA,xn53q+>2:ƿ01&d82%d<}WU1l /dtzS' (2k\;[&V7ξPh_^ xd3Q|֍EӶO(ʸ; 3G_P)M .60DB~r1S??pE""]ȁ=O yo֗=ПtVnvo%/5iV1c4{NdRس< sԘ zۈ GT-ꭚ3d6eޝ:s/nԠ ;ׯ[(_:=uax\_OUYZs+SڛYЃ|%[Ѳ*mʷݧř{2c?ѣ\,^NR"&YM1Gٻz&ImrC7n!q(,%"N,qDDJTڬ[c\ ~.˳\NԽک5]|z79?mG>UmyHq"rn Rwxx㼋(lj6>2ZDR班di_`D11&3n@ NrFrS;wtePVԑc. Ӯ1oGv$NVnش~eL4My VQu{ˍ?2TGX,% N\Όui3Zo bLM-v,*AWEL(82N$W]cD/cDRxN`/S^YTyӕwd/vd N2I L`)Mr7sްI|{^ń݊[&2%OO Wɡ$g2pv),s,nx.Hm^$Θ,+Ro@&{m o4OLgl6r< :-pvW״R7vؼs݉^[8IL%-]ך^Qɉ8*\t^^/ o,, qb3iH""xV/8A` pD3IDNY55e\ N,7=1F7L#/ƒg+  @8"A\Hn?IK X~Pp0|BJ v[þ^'p<1Ã`lRG'2Wrc@]7ɀ7/7hȧ~ G-yRK7zrxۊֺw:ŃE mY,Psc{r-T?:n ]tJY%8r涅 EnJ w䰹]FܾŇݻ@bWAXkIJWZW6Ez٢UA{M E <$=߿.PѰ]{6aqr?&m>'gy̳dZBLj7,d 'd`ɛ<9g [&OQ`Ǒקg0ZZ&}+f'"bbN62SՋ7b|j. fDN$qm3}n&LغKLXK&Newhbb, IDATqjߕ $.bN͘6c]Ŷ]:\r)C-G4qƀrߒnwQŢW1zh䶮zjOZ9i&|~~:1}}ÈM/Rߚ~i dzo2&0tѯQ+"l8.ԙԪ˃7Tߘgujuo=*էBٸK7o-7Ӥw/.;6 a0@2Wz2/B4"˷Ni2p#A>-^R}UwGP-`vnæ :ss3@Iu6\nY~)qn]to Ǥ/@Z̝gq(YyXj#6ue1:ޢT LS2o; ""}[Hiݑx_?3DM 3Rq3^ÚɈԡ_nP;#b-Mږk=_% ^ ƈܷt@&|d,خ7&#1J^04DNJ~ߑZZ2a@aFr!qmپJ֕4)kh["ήw62?Nܰc?5"K:}ƷvD9lδPZ%-^E?)bqŦdgIE"6lgNt퐇_?#vĮ?v.V}Nb~Ը .לk[,?}*x Ϫ~q2]E}=鏏1vu߻AbG3@nӹI?:!șS-dq)sfgs&7CcO-pݗ3}|?/FϚ'=2(l'Oz}eU0g xj1 f\*GD t{c6 I^ND;:Li#ee$YLf>cRC`|Fz퇻ӑȬ`e=v$.1 fȅa̺I`\I4oV3Vx'G,Vz /k<+<1@.ᅜŘt.s\Qr#&t#60+.ǹsp b\6rr k}aYds,͸t?k#e b40+c_J2NN<,X tGU4ò8dSc3@nܤl:qN|=3@ I9}8 ?vb3@nE xȅ YIg1@a!7 1@0SBnbLax1QܥMθW?\ۧOS.k4ǫ6}!6{r&ޚټ[*""Rݝնiurr3|{2A6N(Kʏ߹{a7x s#V:6a!7 etӼ;i隣µr- `%"<`­G f5:[T#*=pPQ-(LisDaI4u>?Yd:SF-xU{g~E-7$VCbKz}G:J"6M,/Zv^M7.Y$uiczVn6Yթ}֣A;سE{K9LO/+ű7\yH I/|Sj!_fUu#k'e|o;\jR7t@D =v*dS5a,K̫0sȦmVRscueܼi;gv3ͮ\v}-5=mѲ 6.\et rE۵krĥ{w}Z㖮\k3ٹc=Q hulO]v?$\5ggTV5e=q|y`Qlag%9"""Ip1~6r3ydUĐ`$pSD<~&9) IJ9r'µ剈xc.I(g[мVb}6[ 4t@DTnG}=Wߪ92I'* d1Z4RQp29SWO+qXb(NȧIeZWnyee֩WY2r30&$K>$.1lr&)I̔q!it'YTD}cZ_t@=b'.ݸyz]ǻ\U 1CnRʿ8!\C/(XPe z*`[ā:[fa~};Xp(nAI DD[O[(U KqC [V՜MDDLHcIӗ,+_qaUqٔ|3wM81mߗ~cylU>Iwa쮙^&BsѺ '<0ȵaDnҍ-7sx@҇\{|-lUbanM_Ɨ& Ӱ!boLoz֍DBMR30q'> GSZE&',֬f5ۮɽc&W>uvepmSZa6K&oռ0}vrrG (}j¬mv 1vP]E7T? e_FMۍ5(Rՙiy/݄eDe/w "0rPL?[ot}Witi%G[sʇF齋>vi4wƂa9$o{j˙|lD$0\eR U>gk|h&0\[|q |-J "Ճ%jMHzO_ΆmֆIDB:5*Uw3Ւʦ^պ_>iH$3QHx)C'^IL8MSoiǯ#Zѥg6ңapwȞ-7iڤWµꠕ}7O_ XkcLrv8M}|NZ1!:ptN ׻MSf' JmX}оGy`݆_gRȚ{%c3g.KzqxN&5{Uެۘ]5cc8Ga2U\~Ș>’;6iݦwP }|خ |6<0Lcڰ'5kݤӰ wb{}68|.ۧu_]7K&z/|<( h9hAtǶlAM Gni-68nݰ'jwмsc%"]voӺAc쟫|\ V>g.lY7IdhD?yNIpll+[ߒ ;|#ab'<>h;F9]6kZV;<^=~ê(, <.ZO6}e Α^Oo0v1kpnzFGG[ԭv=;5뷷W9~[9r|xW-nǻ*VqV>=ۺ3Ȳ Ƹ|۴'1 W,g/2F"a'ֳHx`8ف!WgyHm;HzϒH\ w}22ex]KN3*UJEMl%ΤdvözZK+cD$l4eBb2J^@5xrjfux1bHmEDï?uE-gTXrubз!oEg!o u!Uϛe(Ϟo\QTڠ~Gcbg5X.AKE;pھ$/|nkX١c@ͪ^^u+e-|#AK@""[(d $a{7ao\'o !!!m NOIdl.N^vnͤ۬1?eR Y~ :SzS'/3}ɑ>yVŜoo}ڡ{CCi}"8",~[&կĉcq&&5.~A>S8[-%ꔝj;y6Oݽ}kZe"]#?m7<<}o+N=flmiŅ>23&%<8"V #cQjOCnҴv{O̔%}[;Vr]v. K_ G\:X^O,wP䩘!IdgzR>+;{9 >0wcdC:zyZn^BvNv_>a :|#yϿޣxך+H%jF]>ؾKoFˑ I91F[^hLKR'm<#Ҽ jQFFX ϑ'1EUj"\aD iă\.>).A#0!)>>Qk&(`:y&vȺe=ԽS HHdf#syi {Y&tRF8˧33vܛձi~v7 q$ޤY1͈wȓ>^jS&իSju}UpmWߖU=n\ hl/|(k)ug.0M| Mxrf׎33$< P& /+a^}m؇ӗκrv]}`}C+'_„`d)њf܀#mZ:ܙ b]{Nzx|}h0P<ʈ.鋮l8PfPe{g?Uy U#GSIg{6< GfkZ#j^=αI5oYYqCS~M{WZOp⥁_i6L3?dc?lYs"\swغY^޽\rrpٓ[߼It+^I-s.M?\}Ɍ?,6jS0 1Ƥn]?\xQӲ2 8Bj󜱛R|& qLzѻIȡKqZU $.bfN"PT>۝< 3dXWKw-۔mTghɴ\}}5]u~ :,cUW0X"gV/}~2!mڡԧz!̓"}1{`ɮC-jS )?[gWK*;Z>P|ߕWVŦdgIE"6lu^zūW Q*7¼ IDATKgNo>gO/Z\]~B T*}A:G*v7 LG3pDip|w!oZܯ&~ǥ?}z}^!G' R,8rf|\7;n||@44ot>WfBy,uk^ QIK[ʂ'b_0ܱBA}}pD;m=(J0-X 8b귁W |e@*6s-1*&3^y R(..v||r|.y8"}̫ILx#9xڲ[Am*9#N_sYt8(l=G$6/X$DyܹP>1Im:C#>_MyѩS\<\A' IPŨHj"5AyU:UtIM9LT*uBFhL KdRgYrL{aFwTQ?`nRl*ܤ@18#EbaΰsDXO>]\;^&hR\u3䑦Z:?urr Reۏ>}_4>>^Tf+++|83wxwmS!+ @n_&oB$%%3r^f@Mc^?~{{{LKcZVe3DHeq yM=xȵa!7 1@09UV$a{I _ & f簁 S^@)MG۶mq1W $ 8n f1}{w4ƣ0s*ZAk?2.Jug|U3[{oj"Jo*ł7[[{ł``@@HPӷ;On{uԠ}p2ko>-Ƿ?MٯA ' Ba8iŘ!7k݋=qϴEy=>u~v\VDޡO+]CzwyY!i4BíuIdkE go7m|&!9ipb]zk8k RX/l]{  !Mr7& [n)@vkOݭCO4fY<GuzCk(³?]pkWynOdJ?wG.e`2v9ŅF˜is{άq5dEupKןv˱wwvdIB!yh4:M%l6S,+7:hCn쳯\npvkWpW*~S SM/S.h"jd ʙ#ٝى?20%n_~sѦGק/L.ZH,D>b٦wo[99MfY{uLhSCwܘ{&s3g|/O- wǬTj$}d{Lދi+pN@vۄ }h#xoM. 5>gQhD:`Hl]|݂Yy|89B?p, YfK X7 @V/h~~(ʕ/=<ƝsUMZ~͘c*ŋ7N؜u(~9sL2ղe˘j@5ƼR.Yd@ի_9hŋ -۵M uƆR"IJAV'ΓLit1ntAm >=p.>H٫ӡ PVj9պIB6 fE) @$M}hؘ̠:t4Ts&S.Xy$[|ſ;+s>X)I=1?K?$q4 3^9Um>jЃܭNu~&A6 P9 3ec`$;:!d(gqL/ n6u ,g XHN7ߙFpO-+q3 IHOIM㢲(0RRS5yja_ "555?0(Xd42u5 L/' &P|C~hXYeY'TH,(Ia)gk&IG =d2G=77:nyPt V/% Ԛ*5L/ZMy;NU}Ƕ$Z -=Xw-GH\Ϋ_t3n޳/Opo&_@F׼Cj <B$C?5لNZh-<3_};D{7f7t}qAx#ѵ|e9_;=_{g7j^t&Ճ`%3TyK ӎ_tkO'IB |8(EM"=5$kxe c@WVr~=M̕%-[xunuQ!>;`#u#d2˹Kעb%7o,"a%: .M]$a<{8C:0ԥ*p kw|=m.i,_ Q+k]l&0pPjUVިw__=q+3pL}dE_ׯ-7z:YЭsQ-`?rpP~dsS.iْo>3"E# E,4֫y3Su\< !xEӯPغ맋^_~$<}6u1jpMNdO?ktizW-F=Ѩk_Wi}ڎ~IXͩ6Mj`??zWtbJRk3(a쩲D2[%~9]Υ6 `UJElr/Opp液 7Z:V^P=lިGvvTcα%'3X,ၽ|V) j5'O~[O0gN2̟O{3d.WHː?^dƯـ ><'O;f~;njY=å{:}1N|#B!LG/KkwϋM1>ߛ# '⪂yWХ2ֽ6S&}0磷we)Ba:~S_OOӆYS=zpϙKgw7/Ig>;On{ul/%ܼQ3Ɨih!.\>pōр3\pPj2g޺`/Brx!˙;l:r*Gi"е||$ajed*&o֟”y.[f߻ '?;MVD?OV;l~|s[CݯJԭS;/snJf;"d}]~}m}rJfy>Q?p#۹ !GdXD!K :M ] @fB!m|fF! yr%!k>{o. &m-ә:˻պK|Cc9[^;Wb:w$C&p-u")DkBh-zhvT' ޶c߻Vo|G ,G, VDjIZ {wf\:M}}b/_p]' !.{ VM\,},+maG*4Oh;^}F,tLgOer1jL/` a$wxoPύo!Or@IYڀ+ջ2쎶+=f .\7igݤAmVt*e!g$?27ScOkӤη&$}sƽ9˷:6 ЏBW.;{#?H>M?:yKdw}/\y(GdӟM#?,Ԣܲm\c>5l#_i Z"sjIjOç⳶zquM~FdDņ놇5׌9Xxq)̙3eʔ;:< :8V_:K[e|?_J٧⛱TLS+mJɟKdE[EEJ%[ERQoVq모*hjz;NWdr۳ܝΊuۭJ*;QEZuǎݧ*z5 *:B^wʡghǼ.\I;Wݶ++߄*jA,_2πwկ E @)&Ԃm P#n}L dʰn&Y>"y\?6j8Mt42P. @eMr(\h66M2]ugKavoS*'oغԴs0T} z 5ujQ;F3`Lu #F h9n;߿G~7搳ْfd (* ajL tS{<|`p&uPOWFmȓR*b$Y3SSS ޚxl IDATpsq hjH6x\?]#Z0_iOes) 9]D{ejATIP*pHzFzJjw:!%5En8*1רh]uGWI煉qDŽ>~@W[!]͈ ~#8jfHMM  0L]jjjM26OZh^2gu9x_n蚲?i-$(g&%%slfd'3CͲ,˔obݘIBS26I Tؐuuӕ/~\zlL&gd+ՠhkb! 43H[a^GduְS6IB= g2Fӯ(-}Ju1Ϩ7S2̌\z@Z 09̺I}ܲ6 hopovqWr/OJJ7l¡ 4<N*j*6\N7mPܠ9붭Z^ O#Y(BF4fSʅҢM<3Ǖ9*Wv$!> >&nwMVFbQe~;5\GZ7 UQ2kF[;h"8Cf(oį]Kx\^!_Ͽް/9=uGzk.tf(Qt{|I̢}_bRsWSʒ&k 9&T&jE`* tE"DxpKZ${qPܖꄒܴ~a~7So>r}1νNl&A3G>bguɎVlΉ3>03h] |!zSoӓok&._=_O7sf^v5,. L.)3Xݥ߅,b5|3u6۽}{L\Ǯ(ܞ6ۗolc~r˶5z\QdA` TydZTS@88mf(pY$J/,wnv-~Tr nдm0OlYߝ4]tޡ^R~VGm@` oP%>zvz>9Wxi4n {Ekd,4 /t< @W [|)DvnE^q Roِ[ +1/'7C`3Nx !#./~mI^1K~w $[%ge:0_S{`'E5k`jPnu[)3g23g Bq~Pd.ܺՃZlοU3୑%ItZ{,X5w7§͓_;P!Sy(6j83C.'~zb|O9?{:QTΏ}-K]~R*# OP;;Vd7mUMB\7gn43{ <|IZF/I@=a"[2CuF38l.b$ 38^X.;O6 p 3ᑝE78X.yl&tT@c KKOΦIvvvZzZXHXM$ |뮥2Yg Ϥϧ'[xhx@@lIMCz*a 3Tl 6hG(h4L5|j Ba2j>az^IFaL}3T% nlr2!6jpkcqNf18ιl 3$pVp 3׏ $-tq{c d8*FE[AT$pp UMAmRd_bbbh cd@%NR MQ5Qgnz`!36 $8(@\ S 1|@fFm~l&> 36V $✊4-dAP@2P.F pDWo 0MPml&qڣ헢8&dgwb8n<ԈA> ԣEIHO; *UaGq*bM*9r)Q mas[eηk.0 B85ij0`=(:sYgiڴMII9~x~W):)RE\Җ$v#ƍlrU7`pǷk yݚ۷o bQq8&r$A6.n-N9DDM\85Q8NUqMpPr$ F#gR>oU~f Ɠ?}1t]X֥aq6hufIHE5-QQIHj Ui&‡C5Ct.6D1j$CuA,#i$A&}]/N衎&RumG ?<~jߖ!wqqsL8 2Cݲ\MA)s׏^Ѿ﹥νfيXISw s?BkOUrw:uK<^-iڤܽVzaLwK>kť rH\Zq  3TQXoxZ!|1qW} Ar_fMAQ!Uqj/2mِzzCbQ tĪ~F c$?~R?Ho64U?hFϽȞ[gfNkgM?OEQ%w뷏(r?q!FNz~+RC52W|iעW5_muJU~Zd?)l4O}^t,+z7lQ_\>O{w^wZfsg4N-1mېѫGmg "~kGO{]3?ؐi㣧>u+~CmN1&Yәş!:8fOwrs2.ZyUl?oOMz6u8O=.2(ZN2SEp`}]BcEWИ3-3c5qOg΍'E(Wq*,0E;n8^JnӹmS{v qY>и˓}Ĕ7H{?󇭦S l(E{s3Lбo|ۇvk練4.>>ޞZ{UiKU Cdw/]҅ϯbw o$-%YeăPFQ8{`yT(rAԼ4˰l0mLpQL,+BQr [BjmWIX's65dQ/V/_$(R`^L&Ɋ(3(B(BQdkЇOv(^]T{f.QaQȲ٬hxyT}яj=Vj/3pܔr?S ފP _GXnӖ4:IKT RaUkCU~f&7RB=ཝCslʎ. V] L[GU{>r0Oigg|`N3+Nhh{_tY4SdŬsՉ+fEb6!+*TO[tfR|;P;X: !!yknؙ9guλ5jYs0%oP$DAT|CN-jEIR,KAffJl$}?~xqw;{skѱH@$3ƣoOgV_C[[ Ѱ߭vq%[r.&z=I;K~6q]5ݼRXt-ט=[;5Kٿiݿd6#YnRmD]kO8c٘潺1|c_v~6ys-t'5@(1(B7o]TF^8{$!v{%߯}:%}ѷu w3.m3%}7)ێƋǒw:}!_n3bM: nPU BŗҭK~S{6ūyBH(GxɬW]{B( 2y?@5Ouwʀ7cO|J(oW$UJfmDv] =kb{fIB!!Fmݺ5>#^~/S.7.:vA~6EW*3aYNTX{?BM@aO&/OUxg۱3[C!dYq9 {g[#-Im?YKlf+}k߹{/B_Pv.\NW;YBn`-%'nk 'ԸQU1& !g7yewwvoxhV`[EhDPL6ίLLjy˘a@ I3C@tkFKVCBk5>TEiuMR<ٽ!w?sM );xw?xuwA/kB+Il~Wo7;tp_:_kءg7Imq5g!& =er_j<.]BtiMKUl ō$86MIxnxe [&Ok"1רh]uXһ+&Eqh"v0ޘ: v{0 ``?YΦ8CWe "6M݉rk4a`͛ٹe0m:j9#3aX -Vl_ucCmsޱ=BYA 8Uf0AaS:/˲d24N k4a!0d,\t\a]iYm=4v~!BQ<>ަu)yk|G_63!FcN)M/$DŽV8|t>V>> >&nwMV-{jٛnR|,Rd 9}"dցd4˴>08MQq*0M UThB 3Iج6ɳˣ_ϴy1C[xxE7bN dD3d@;͟NiG{6_GT8+0AmRo8=[ՉIˎ'<Pz Q}|uq ԿK-'r,@fjM<.}"yf81J. 6)ko8*͒: \)h4uAf B6[7ɫ]ɳkxy'b G9-dM2n~ɱktm:f꘦ty:\Jc$Sε'XFḷ;čaL2&NggN|9|o˜dp6){DMlݤ\ ǂ uY8^F¶ 6IȆ|Cq!b/\tµCRXu6ϥefIW†}Y'5ٺI=z8hAҸGxj> 3b$gd4>jgڤ^w0rX75pkҸW#6P &9)ǎɽ1}k[=|#&a/; db$./}k75aoږ-=Їa8(8@1~ P#-COjqK꾶hMCM=ݔfC??FǸsd@AIsl;Fm>Az:\KFJ99g`$Ñ9cz="ݳ?{8mKic% =j'@f}Iy_&8[}~:n/ph\CD}&]gbccnv8(gx$\(2M@i&AAI*lKLL}c˗f 36X7Ij?*;f, 6X7*C摿2EuAztb_q$"pNe/qF 3ab$G~|LhuzMgOC áGfI9}"dց=zp`$MҸEb k<<:L7#dIPol_'jw!8]OAF'MbNsfjd$ӥ3܋pkإ.' IDATE} Ym[M;?Xt)w&uo@NV&j 6ɥY2rNϮ=sݾqVOnWPw"L2`N 4}ߕ|ے%kv1}>M<8q"~6@fRTgѸϽC/0L8h2'6M*8dck1S4uO"հ)csB;o]pf#4!mk֨8-w`lPy_ l"ew$8{ $Ti@}aU76|۾{kâ0ɡsTld;\Zic,xohnf&I6a:$MrkߙjFQn9|$&3"V)`M:^ p 6Ih#F?t~X'%ߣ3o5ҍ pf&AlV$wjۆG/t3/?OT,F6MϭÈ=4s=\dNlS1@"3%cڤ/km t?m;/yv۽OO-$oXW [xpD,"&AlV$DF~aLu #F h9n;Y(gtL2P%$N|p%+HcyG;.:4qm2&_)[{a>1P. Pl_t>M }}$l/kB+e]6]#K_!>cA*{"5[y|OrnGuO'sֵnjI煉R_vhCcʦէ>U=% hղٺI oV:gV +ftzBRWܳ)Wrl\4ocC,0jڒ?TΝ;;ݨrc$;:rj7DdsÔy.VF^ Al*0k]tW/i}:YIB Жz" ; P#wɶoطZ}]'}9l [|zPO~b}Y-c|5œ9?dN-݂<6Mr;cyۢqۦss/Y=ڠA=f\j):s}~Mrm5ٸNCnnzN>s9U[ORgtlkDpt+74a :d8<$t \vYlY-oX>@M@fjBհBDgZ/{ ݭM>:cz:3@ln=rw?>{cQ!nom k MR.?/?xw4؆ǞEnG]TW>QQI.wQB@G}ɿw~v߬m_L3cjd$ӥFIBx:{WY @@lnQ,@rng;0?2\76۬$BG>`j}dD@lnsW~'f_|^B{#VdtӺI'L3;7A+S~K2 6woٔN (3@lnl=ЕlN@fóźIA!3bIIaQ%g* ;L/!9X-[2Pm&9ݹOI`@{ @^|ϸB3j@G@f $"d^8z]7 3aPT'@]Pml&V`PENy PT018`wM 0"qށYM2P M} 3uj u@fAmd626 nIE-5KdJ"*)U]:Ub`_MQ{;n^7 3U $V&NM@f`z-8MIdAPniPsLDz:0aFmbLNTu@f $P#.j#uL/IynԏYjt N,%O-5yܓg3S芟3-Z}ꟌGW^sUtnaA>jRSITAUyʲKGנ+yqͳWS{wF}*⽠*U/}kP*SѦܝbt*nr !-i_VW۵Sj15 sMUr)KJ5<ҥ}UZ&?2ƅYf1ŋǍgןqΜ9SL]OʊK^¬*J#],ߊZ+}_)垏+joNyAʶ|E\6`=[QW&|æj%XV^+ٴVm'҆}r?EE[T%;r@{PE]\gg[lY(J[B%[]ջcNygǷrܨ#TrLW1>XQ庭T7J_k% W^ʑ@+^$I# jĺI`D({&X&1f/h@ 3bz5rb87MI)Ǝ$ Pol&p"bz'M vUTI*]7!> M0bPA_ "2` j8= c6 P*:@f Af*CmDË1M*]7 MX`) @^0 ΃u@fAm"1juFG@A8Dm?v8#_޷{SkwfɼR 7xsn$=@Eg9)3׍';&15.n isࡷivfo.` 3ajL tS{<|Р tKMFGFҽ!=%2`}l_dt.GBwvTO˦|pp4 kAMhm8.2`+R$sUW$N.7VrN}Ҳ!Sb$@C,Ig4R,W82_:n㙀Z޹sgFǨM=d(XMfL표qebNk{"rB}%`î7?IP#Y7Ii8' !9;S*9iCFúE*ja|ػ 38̺I}ܲ6 hop" Xs¯sٙ糌N9/ΤMr ih66N7mPܠ9붭Z^ O#Y(B1eef+ىN> ?Sٰ_8K_s0!> >&nwMf{SZ! y!8e˖ P9jFSvʍ1ddὑZ jʩdNDf*Cm#jw${!n$Zܿ~Wh76jN``1UXU<Ԉ0:mݤkj9w: 9-[N2Pm& ١ZN6 $q@g1 @MPpWM 2P*6j @^ɥzY 2` jvs9dKAmP,k L/w\`SU S&zqu$T76j*$I 1`߸XA&T@']T[[& j0t2p M 2P.P'9}![@r6 y΃u@f $S6c2P.]'CfQd @vIN@f PkJyVY}Q[o Rd>Qp`ujt4TIE-\b uy aaC=ڜ-(u@fAmM6 $POؤ`j Pdn7]ɺIU&AAPv8xg1z8=c$kPA?qzۯBp6 $8 o15bzuurej%n3lcY626& pun@fAm1B˞k~5MIc>l0yՃu MB]| ޭSmt`-FL/$"@12Iλx>Ʀa$IPol&o!.cajP ,`{2` j vB=Mzc6 xq3`e*<Ԉ  P9j8AyYu8IPol&PFL/gͺI 3֠6 \dMzc6 &d@<ԉ _T$+^ȑznԏ$76MR nܐtAվg` P#g^0lm빠ֻq߫ T6d|IK:\/n 56pqCdQ!{4ӞjOS ]$@̱A8Amy" !'[|6LsJ9Omb5*:I&`IF qq4RTZI*\hΜ92e 8M>6'M\7A!,'[&Nu@fD&CZ7q9-񟔌m>jhgjBmS|KD7n\FWd}ya:P+jFNTpz2`}lNQ@f`$kP@fId\L/Pp2`}l&Ձ9sPRRR@u 5Miz t5\AP@fzh6Ovo\6h{c^wGfvLBfIj=pBmԈ$2PMPj MEJޙ69}ŤkܩO=~9/}/?9&>@kd{7nH:~Ѡj߳_|w>ܞ?<}RYն{Fhl޼dԤC;DIB.m3%}7ߗoJ 垄hp4_} |}b\Hˑ]w{slϫfƋǒw:}!_n3bM ?J^(eh [GBKٵϿO\4n.9đh{U״iS+ //*?|"MlJ~`m۶%1&qKvL7 ;%Rx>vNɕ]#ڴt!!ץuػc-ŷe@]]}^9䞣tj?;wm<pv?9ڷ?{wEbnE@JP ;[8Nn]" ˲1cQQWE]~wg>w̾}pQ6rhj ;n^Vt6P^z_N+N^u9D^Ȍ\׼Q.....B:{ݴH\5UNc2w%ǭ&LUU|:898;eHVr*Mcs8p]ִMfy/^why䱣O?/UEm#&+{vdab`%{(1^2_.iR _ W+kVy+fJY{im&-yWrRǐI͐i7lYƹO-cO }jyؘW鮕,B zDn)][Z ؔ26#g^Mh2-[-{B0,[>x橠Jo#QkoG6i 0H Β~ѱ {k7,M#ZZBLL HO6xK䔮[7{=:6L̯UwR 45\qԯա~r_oʇSF~ ?6&Y5_'rV/"]6Z#|_)e%o9hհmuS~j6464΍q'2ͧGR9D._hګ-U0U Kt[]=GmRߴOD".)ZB./g޷LNE|>WE{z)8,O\g% Ow'P^^)dVhKy/]McrEH8p,lnjK23<&%#\8ڦt,e4#)oYȀ'NNBgͦtL$ύ궩Ej,O4ExzԔ<B9Y_e{9{*6yZ:,4yyMLu\Ba0Ԕ| #_U{b$eb͉Ke!feJ:BU)yΐ4*>FR4P%r9wsJaYْy~FtBrWcvB/3,J IekW%'D_ܢ.eU:|ף$599999%3- MpGc߼xx̽, \''ۗ&%lgG]Ze{KۣD$/y웗OHuu7͊_JmY+[/_ݻx5IӔ;j1מG?=ȑt5ֱ?|UF^^f1 SgkMAYK>)3|W ߘ4{n{jUD IDAT'֨n%=ny;N݋{wۺj-yɏ_2~C>U+O-*-;ٓwRݝK}(Jiģ<7pk% -2|zGEuWԠ GUWzvUQS6JG>y("M{VBPck}Wo>JpR{GF;>Kkg-UTW^:cњ׮ܸԧQCc)#~r#5)500'PSN*v FHl`s=l_X3 'CA 6 @} gM@%L/ g( j3|=m M@3I6& gP $ _Oj3 EAm~8iLVn@PՊ*<Bdϖ_Jt7r. !5d``lJ5&/%5)=Fo^s@dw<#&@q,KM{ !1F7tФ(JúΰB 5+)4<'ͺk-EQ\c^#>^IО"}u`l`-]_KgakH[Bt gr6&@)|癉vFߜqpٔҜ'+Nd-1!#R:0BmGm:Udޞ6l̹Vn!Ɲ !$?G'9:bjѸ 3@(;wlz]}uyΩv뚻bBעӠMm B= Sd&e,STV6=ڼ܅<-lta!gyPPͪ$?I"2&@!My"ӂCQEQmNdL'p,Rsw8:u_T.˪.-dj9jy&Tt9!iQ.haY3@Oj ӷ6ny$URdz5I#vmeXsجz4!lᕼ5y: x&L/@xB"52MJ`S&Vo-kuwy鹬HOS.V&B+L{u2z Y~a+sp@j4R-nQNoldgPgȾ=43 bZm/[lpU^ᕈ߽g5lZM  Q.SRG]N;>ڵ+88-n}a7߆ψ2<#L/ Pis3 EAmr ITr6 9$ *az9@QPiAmr0P0)gF7nl; 9@16 d ^h6Ma^Y2[~>Br π3Y 7/+9=7]} !ˆh[; ۯQk/% !L}D[C n멟f;ѶV@w@.SGقQ9w~~%2E 6 h?bdK::XxL^i cYkZ>xBM;6m MP{켶-Bd{Y+ig"gC*_`Sy &$BkkBIu r){'N4E=ɓá˦OvQ?sa@)43l~ #ZW~Z4Ud]_wNh%&:1j4a$K߱5W|{ZABqn`I%?, 3h݆&U!g&Jg:u$$6 - wפ>9st*|>ߥ>S9x{Ƙtا`ie'G]R=B%0qrr|}.V7]5؍~r멍aQ˼)e\5wq՞N:}vs`am}: 09r;uL9{-$riP;>ҫGd"i^~+'C]76 jJ+WLйnIRnR;qћngy aܦ[ !Du[v)QCXyvaڶla,-9Z('3aynsZXdNVӢjф"0gbK?z EQ?(7[ѲNм>c__f&7=*Oy&nIJ۳ieug3 Ij3ze,!ś.4^ajwY9#& 4+CSpJeA=׳Riˁӏ>nħ !WGnrV̔F5{7tj;A''u||jv7gV9y~ "wņo\<vaPϊBe=W~y7*K ?Y?ak;lFnBܫYuMBE}l~c75~BvWh__ѵУ)9 bv9j@6 y_C 8U, E&&Lv 9ah$dsD%`%CK*7MYEӳujڊLg Vcl]ènI'> I3=:?3I&d+_H)MCI_f}_ZF7۸~ByQ!w[V&Ϗ.ߛ:=&W:_ZХC]W`zr)OMķ4tgM7k⢞Bhu`yC=tK:wJCs+y}V@$}yi0iЮ|BQHrĹ9 V!ih9yb)9P1w5+k5} ImokImۚs!"AXw=e~ڪ~.B*!sǺ r|gu zʜhj}r--C)a2,!&ȐҺ [Șfiow= %d˹&QMbI*&G,5|B'.!Dp83af.t#;63:­Ϧ9_>m@J6s," 0(M@ITr6 9$ *az9@QPiAm@:200l!l_"em#\?j@}mI%X%X%X%X%+N X%X%X%X%v@L OvJ 9.[jT KKKK3 @%L/ g( j3|=m M@3I6& gP $ _Oj3 EAmr ITr6 @}pP۴pm˲ɉ oy4PdnfnjlJQ \300(;SR=< CRR#" !f&f>0\#grMY߽ n:R0\#grj~,˖}c#|_pmpʩMR#j()VcVk PõIXe\ %@}`e Jg(bJg(Nwޛ^JkW?\кE #^٭E%8nqü#$(}9/<&($RY<67ĺ;GOͯeޭYLgKx9Bo k-itE ŸؒɯOa/Zr"4qְc^?'^^Jpc1nykۤsV\RAj6M"TqBG.e?>&Tڋם:+^XR]|Wws*SQ͏prB~~zpd]ĺe!NzhEng^SDW!6$u=i0٥]&jsk JI*P}y.u)B8l K4ں91:ބ^$mʗ'_޼xšɌc%Ac|C~K|&Z U(k߲+"Eocܵ>Hæ]Y~E{;iPNXR<?0`)vﺪoKhcw/¦90>KJN ݷ%@Rr&念[m B+W(;r㺻5&z$s̽z]>a[oMɼlbs`}+55Ku ;nI>PV%(X&I!/X4˰ȣ6sw_~Y'(2n.U~Rj6y #y}N-2"֢ ^y_~ݚQ);g-F|jXd>1ozW8,a_ESN[:?l ȻW|݀eX]+#>s,dqn{J4]\B@r8>V8jh}? [>B̰(b]W1q\: y-7ua)jï 2yw6 4밅aQw טgMȏ&J_ӟ - >U=kTw6S,Ns&6Ч:|kLXY^wM2I [~M^=Lvqէ?av]+VJW5;4_y]pQ{j~Vp>>7^j\V=;p<ҟl`LRwsT(R] Zٹ9v{!&MaiDRŨ9'ڤyd˨nKǴz9?vuքR>6a&J JggƦ(<,DGD9?'>Qذ:d躺!>z/N8#)H\D5SYJêj"Տ82,EEC[⌜Q [oFr{7oݻ L;؃e R PtE+Oi$rRb38 hSxtdYB(VyV2n{ljBXTf#d)Zy@ )YTQRσs>(&}PqiӠSSS-vìJ+>(nLa G9T0Yz)v<Q=J 3_kGH<t +;x2/i(^s0P gHР (2)XdaXFr].%z?4 mվ+Z1sKJT|؈WB`ߟ3PZ^Kb{ NO-r7l֕v?~\?KQ9=?YXr<PX@iYp2^(* 2M{c )t&@8|JrZMn%6'%$F9.5q?o@~7(a14,4<_?@9ftbD\$㉱!OdcvxG 3o+}8ԪB@nƱCOBKksӣLᷰLt^?BN彉HҬҮa%}.aYUsQ(#(&8D\Dž`tV+rr۬v/4TJfפfقyfS>~X0^ 'ȩOqtXWMGg0ilc&Ã{B= IDATh{^v1uRݐ宮 'WRAm@9Hf܏kh„?'ͥۢ^o6Mb?~nRph͛~^i/d+!o⠟{댃"rbM{u=9nSr[8qҢ?ra\Weꣲz ȗѳ7:u蜹^}[H:짷Mr3s(^]N2iVvV6Wvo;կ&Q,_9wUE'Wx5&zV0ob6büդkÊZyq.}YuD_MIÏgFj(e7Kiݪ>mP6A(^8O3ύvL͊|M[׀bY=dzMm²СZ^'B5+bE3;7mUU70 ?AP|4^}i->#:,ZuMif=,Rgߴ~ߒ{ ȩz`Nٵ❡h*M76 {Q(ȏ?=8<붓ںwS,VĒ(Ɩ_ Tep-:Z:GɪuJXzo[n{PVU/gBBi7ؖ$3&;Lݰiܓ ѲRI-]525G?)500{,nId>#/I(zæJ^6\#guTRI EzB}QˆO`w @}RVeAq' 8~pͳlcAP.k J6I(Q% ByP3@VRIqqzz7I$#3Ap~^pk jIx_&  \+$BaldlnfN'2 Ap~^pk Po"p& 8Gm@JI 9)< g(*m M@DH@djOX( {BBCm&:Bmw/+ + <7;, + + W@ܤ`A@!V Vz9^>B+@+r(7P=# + + [@PT,SbXbXw3@QZovtu:lLf*d} 5# A@-VA5wV/a˓j )3:*tSo۲G.E$IOΣn^j999Gj֤^:dxKm} e'c'#k#tq)GU~wEDe0DɻAࡁ]ݻkcGf7BL,8<ck֎XͳZNgܻ0ȚqowҰvu1&vl/;I=OrYBCnw!]A"Ζzk;]Q3l{vvvoQuGCG#Ŷ O?:ZU ynznV& jzxNCH~dh]ޣ_vSLt`˪~u 0%&ƆqxjW8iݱUW/~;I-yrꎺd>1k_@զ}~.V51A~uvl[ۧסDF|=Q.߰F$"DA۞I%1GhV/FcvtDZb|=![ow/߆.=7zJ%1gK:V w6)jj7=|^9׿~_OlTwee1"~OߠM/eDVϯĝZ8ioG{5EA!l^ݛ uևٌfCW؝\ѤZ".EDZúIݟ\?ޤ/ )ˎmTϷا_멈 fB)VT/Vۿ\sXXؼ?x7fC~sN5k6i=h)̷]]=w9ˎAWFrl,4F[W ^_\r}P" %mtִ̎turסn^^7G{%Wkȶ ;b>dwrŲ +f)_?^T֠礡 En>x`~zsZy̔%_:io潗,سTrrpy/?&R] C[y{iwƵ*Љ*29{B6 iײGOxnrv/s+q!w{ +UI7o{^!ɻnqsI{vx2C!כ<9uAHsϧX, ۞j``ػן&&&;öU^XFj*ɸ6k𒘪c<{z !ndm9|. '/۾eaNYB(l|F]{,4jusN$(,fQD]>oBv_(.M(EQ-YrCအ3NL:{[V1wY"ȤQk|.[aNoL/lԒ|=e ! )swX[mLcE 7cޟ)|mj!pZws jr[ ]ng矞1tYš?{r \?I,WJyV 9%<Ӟ>f+y~n]}XˇM=z:e=J 88~/ )6{^j1 gnܾc~Q<B#rU~i롓6֛yǮ!+%(+Jb~D'H46*CxU;M\~9uUevO>'ӧS:2+T #?àY;{ Boſpɕt0]GZځoدXF <-/3 tΈ:g,C6/aµKǴqBF\ ˵LIG﯈q|ZNraӆ-g3ty}| 8e[_P6M&G'fpGMiQGBⴷ^uEs'H !fݙ+V$¿}yY \1O;a=%GͿܛoUKKs.;vmOII>pp_=qՁl|oO_ze!Ĭ!'"k3p'чFHja*BnܐW|sYOѝSoc/kIU~;ïە/^bi/\rxPvqC{3v̓+ q5Vo5}[GqRIіW Ny3v.O"y4'XD}}+Q5D֬s t{fj+G4nիר[W%\fae9)I<7>z+oQAOs8zz"BT ĤWCc5笟MH=x:Wſz%;MbU;c% ƫkfn*FĩQj')Ŀ^ Ua_ pubNKsIqRZ3"wwk4㑺'II,XOe~-w<(y=]WV0l]k57C;VgD SkN$"O8(7+Qv쨙͛n ٰ:=MRV'uX%mلy P*ϟ%E5^~xwl}D-ᦣednˣ!T|O 9Sy=0۳'N_q~a9mצzOwڦa/?:7l]=[-ɵ1SmVŤ*g*2 y)S_jPzo:bJ X45FjHe n~W }N 7|Ґ&s} VVr* \.<-}׎Wl"WY8`~PE,#gY%NVup G޿n2.tjoUE/,PP.S@}RIo%B ],5?(Ҟ>2kڵK<u'IdV9w]u1DFFhqUWwz4S0oh]{GGsTScX\WYՌys7VHy1wr,+ƼdyaFMl>6IW/RN M[yb0VLי—T 4MBW\VC+xB-e_Kg1s)=Qɓ#XXq^)'۱ bVE>l7 )ShXF=NQQNհֲYvhsដ˾+i̡%ZYiWĭkW? Mȇ'sjvN?b*msF.Vo@[@Rv3>egBѶ2D~wO= Tr:Ӟ%dZA$TE' -T-4r0T=_p禠~Fmע{7.ƜWbɠk zwK{LW+F:v"LƅwLl,$)}QgͤiM%?t"UEF':+^浬ҷ|е[{.%[_>~$֌i rc8;7mˤ:mqúWۢ${߮q2o|=д ʃT [yv9tlPQ;DuS3Jpxl+NAUgn-BW\H?Ҍk>~2gǬ$oӲyT3B@|ع6,ۑ>yAn&ԸI%#N߯dns-X2o_5uO,bPcnञs]nj#%Dxy3Ys#&?7G,gY8'W*)Q=i 1jEހWJi=g׎W%/5~o?4\-inqЦc_tblnT5]-4rnkqj38گ8m>ܘ}*3QƎ&)F +YjCzS B/1 ԰۹s݈5'47ѯn֒\4 ak&, 8z Te吠R齢' Gwl߈oA?-/Xv vsQs>48mPz-.CSC L2]m & Ӎn W2#'7L2p[OʒY5%i%沄gxၦZwި4 Y:u>Jzt|F!<6;]8sqa!Vv;e36ֱ{ŗ ]с1_g`di6Z>ylE{. ,:/َG1G/fH V˾㛙Bqkȍ:LmqYtشsm{;WxH\ێ7ʐB67j=fĻ`^ؔ5vB"Vu:c)v̖Ѵo?Bh-K}o'56rN~o6yvUoRk9Jg9sV-=p *l׊;+]<9lĊ}롁ҭ1ff3VNk89Эߠzm'MJ_+ i>_(9vwus(Ό3N!Vد~͎c-wnaE8?,O"B']T eo<ܤ2<>˥# IDATDrKF37TNB X1)ԨYXA ~JmRY[f*7+aŦ ; E!Vد7Jw&Ne"~A&m %ܤ$s ,wK^#7XANJkeϥ.:x` fY b &>B+@+r(?UIHB+ ;MM&=xTVڋ>BB+@WI` g2M2,W"]~HE`j[T5PT%\.O!m j$.R*G".͗V5@d!MBOD@}# eرHEu'M *Iӻ() TP3:*IT1w (RŴ(6]_-CӸ~g 0 g?{wws E")"EELJS *w޻#XE,R(`0r;f2Pn⛁ $kd4 PP$reVI*>fV];\vٛmjWҾ@1@ ̀@67)]X`WXPsϵ90ͩ"~mvٞiIzwN?Ŋ?gIoͣ8Ç8@((f(_nR^agdhP6ؖA$8Agb_gMD9&/3o@ 0:hzҪ6 .+eVnw1ey7Em>p%T#zw#'8 zD/ Ted2eOt{-}wI۵p _wꖤw]>w??++n^n~+Q831x܀n| dBPMVq)ʽuogXS"+ r m/)@ 3 M"a0Z8B=/9WT*ꞿxտ'zӜ~f(:j͉Y'q{~v⮣Mh(w$͙)ozN[,!Sq κ}SdQ"rşLb>N]c җV+WWNz͇8vܙx;ND6! 2x_*HуwϏX1kea˹<'r.edE^3&4KWo(Z @L]iQsV,9# = k&GUkcԠ `Ehi<:&̲ )2PgM 4' 0pe]!uhAokR\t_AȺMG#Wtxsη9nݿ>i;.x+kîM]Uyja۷mX4؂ -߼x%Ҳ5UƝ ' Fzͤ$3Lx ZE뚚gls+-nɄ(x)aSj\nM&E-Qw‘ZE+?yW1f%{qqZ!yt Y6tǑEfH')ags$hqeJ& Y+a Lowi9l||@O3QNidVu/rIA5I;_`<>u2Tn1jlocV kj{?{vUvWV@39ԉȔ|W|ש*~8-u7BElu6˅2aYTa֟%8l %5b r@p4X ,a~p Ly^x$4Q֤vw6゙Ugo`&KoTk3ێL;7|S,{׼e!X:>m9ӛV/2;= iAf@ ]7Nc0L*rKunmȥI;fhVÂwS+Kւs4\$0A0:]!S}U]WRZAT)I5oϒ g1hBA?ZH9:MWqǬ**煋k=L9;C}lIv*&nz|qV&IG&ukN7Oʻky[2lo |I :Nhn>A$ 7X:\nke"ގIU4<}WТCeM4 DQ$4Hˆzk9GSr/ÿPZ mϲ2bQ[=vϽc_=˾VWFfZx7=]5U6܋/)/)3 &MG5=uz{Bk-qbIj 5й:ȩB\-ƸSV+zLWHWKEɻBT#i0["sTrkڂSW&[t){Oh3{%WVN)jH>55^pA{IUX4h/ΪZjJDBY$lS`2YE%O_]c>]Sd*IPǀH)XYim玟nxZ9rPNJ&Y uY)i'Hs/__u~8߭fceվe /?TL䀿GGr Rŧ  h4( o9Ѝ&Ԍ,\=|Ь=/)nC_4ʹi[Vl! M-Č:vm|qYi^kɐ{R|Qnmj^W(540nSj\nMIb9zO}_f浇U^ WضNJ!Ipojּ0ctu#SNb7T]փJZ7Iy{$I:%<}chepbw^y17P%:J1̸wyZ2)̸p6Ö]zk}`·\ྶ0]?ǚ֩w)<8yw9-֘,0se_>yYȋ:ZŕeC;/Zփ p.*p k#v G m87IDv-oV7+ ^K̲c$@Ҁ\Xud牴l XͿ3jff*K< X\'Zm3n94uZgQr:ᮔm u"EJ55BU.7wJLqE^w]CpM~s9tlvYIu~Ӗ=wȒ$ضOv;Ncu;fF+%M5zΊSi5&7Պj%!*l&+޵pKEa^}PݪmknsFN\rX͒n«>?^b#ϻ#fٍS"~{g=q I~ho}%m6&).-|*>0̑#|R iit,۟g{ZK;DId'D|C7Lep,U.]=B oG? eB Q369foFd"._x81;̶a~i&lݢomX/'xĻ"~Ǿ=~t:}aG5盺5v]Lc͟WO [mwf^2/QqѦor3ⰈG^#z[~ko!y=j2ɞGl?LS: p!3 3P$ĿUu}e?9ʹ=z/s[x]K8Wmaokk{!@|Q sk3(][PuHi9/BQ-"Ӱmа@ ̀@( (мp/l9e/r[ ":0hXPB XRǀf4x͑ kPF곒@]E 1)/$ AɥoAbi0 (B@q r=-)xqQAT3%U& A#x<3S3$ @6(7 ъ0>I@ -PFPn@  5&!Z#/Uz9GP3hhxB d3  MBb6`jIi;RO^ȇW]tE@ &!hżUD+NI T*-(,@@ k6@M:7wkj1q8r| EQ!1 @IoD7F[5 !@ ̀@4E}nR`B^ʭY$O8NXYu#rgoBul2OMul0@r? E~Y1\;k3 Ӝ{D| PQ"d/FC!( @|(lc3Аɡm-Yͽ&I0qd_T兟\|֤K{\|tؙhȚvsl]9o.&z)os I6bRI \ws_ThXPɷ?cG4F|5?Oh +8Á/pp}(PW%|Oko4m.|C/ߩ[w]>w??++n^n~+Q831x܀n| dBPMVq)ʽuo]Iy9g'<"@^x9z^wN͒W \ ˎ0s)g@(#JD46`0>-P>saNg/^l_4?!^&}wqx*?YzqtAQ oŅ, do:iͤw,NXo̖Qzj-ŽY ?zoȹ~ޛm{T!9mچO98M_Gu o[AզlK7ݮS%3J݄­w]Xtֵ-~Ϫ >C@Qp觡ь.+b àzh}?[D)ϭ]%kZBF%f5iżVLYVDլvRfځ{Fo8W5_|p0tn>GDՙ Fӯ_qqɍg:a@ |wxs[BIG0"*p^)1ewMUQyp|NexTmeowD46f/K+ńuQo 4_^brU9A٩nV+@ E3&z? gm ML&udrx^qcz[P%UFOkӼcϝA9`A5l=8xW3Xvpl8w.u2^-=;qW8Z"jWUlr-\Q|r]Emϯw=%|=yY|PpouNͺq1MZ>\M =+^ [C#hr@UNl/ IDATh2i4PJecF`8NȲߐ:Ӡ7S?>NMRܻ[5Fɽt#3)2uOL]d6y7~GYGMZ]ةO7L,/8pv\^Fک ͋W"-[Siɐ}\ ,~0hĪL:I2ʄ ѐ@[XUyV6"LGy-ryԫUlI gϣUTfaN[ 4{K ҬIʤᨓ ukQc{]ax>w30ՇENݠ&9gc`?kO=Oe9gv}h_ 1J&r **9VY;R j8Kߞ%b8)* t_:}b}^:;ÔӺ:ǖo]C(ݤR_:n}d?|h۞wפNt fգWZyw|-oZ{Kҁ̀@|!JN4{Oб~u<7׾ZهH51 bW8/ga`٫,_$.U@iS?nM67Sw&τʂ9BVU-0&|S׺5 ,UUN4("5LeI++g#3-Ԟ.Čr[唗AsmB E%B@̐O0EXoܡ OP}BEe$$F=jqA\#yXZqM9trj$$W16Պ~k Ij2 ywPjt5 fjR˭i næ6O]tnѝ'>ɢ앗\Y9=t#KFBziӗ#$U}cNӠ8~dk*t fJH}V(&EQ$ؙ_2e/.N>ӵ>ELUq H?zɪ @lֻ>g1L<rle-1`^8"`Y/O/gh 3_W}\2En?뇥/0]KQ/9ZeY@YvITLx*?EgOG5FAh8Pk~T t=-Evh$+S/Y9lHz>nFӱ5& RZ::*蔸J\R.#)`ս̐k!|BZwPʂS-$QW߮ Q/OKuF 'Yʗ5juׯo++J# x-r@W@)Cι;O@K}f\8}a.cml KFtZ0CSno-im +nB;#҈.hreޚcW1J}2SLi;;pղhSz /-h¨VDu ެDs!U^*MZ|Ŀr=fO`9L./e;ƈIu*iOg81dʼDmg*|5Y X\'Zm3*+gNJzX^9slHv:姶2Mq 8QGʉKܵƆ 2ӨHPXW+RPTXS#Trlzsμ\qׅ:4 a73@'{l5Th\!7mLكxz^,YL@ށmd'>F-]cmRQ8yVcr(y]NJQښ¦o] Teow խڶ%ܮ袇\m_$#*Ϗn~gj{vYOzxERd3 MImK JO s+3Taj<]#((F,;}R/Q$ىef mY z'on,Hm\Ao ;2\5p8:սorU%K͟)So?Ч puEBm:1tXS|)$zkiB 7fS &nr;1ԒӰ*UuŽj4@7uk께9փ ~DL댸xD6eլ*1o!mv3ùMS uOI qϗt&rߏ=vЌG*֭OX4y F]ڴ廃VJ $6 k\nTՕGЧ]h m{{fdd5uh{F\gEdUQL@ l-vM)Ӵ,uhڝ:sb9E VsbA/ f|~Uy~ϟ5jrT7OFD]!s \#~(<:wOOn ͑<܁-m ],+}k5g>6g Wfh Q_rFudyg=7 Ʉ+|qfEZ+7*E9K｠ۃ]Ò@ 9hB(#J25O(}}pvmQ=vg M~DqhessV{ M]X1$@6[Ditkp/_33>y֎+iqqX(JlFE\:|$)@6rV"wᡄF r$ @6(hfK5Jb^*_L͐( D$D+wT{$@ Pdf$@ % / Z1/Uz9GP3hhxB d3  MBb6`jIi;RO^ȇW]tE@ &!lhUD+NI T*-(,@@ Hk /pPchj1q8r| EQviC d3 Mr߈ntk CF@ 2/7I(K2+$ K3{D_.MmQ .@0@ ̀@#6X,v=P( XEŜH^%t.*3joՋ>ln90 >/%B2n;?$nRķ H}VRT+660 yjے;h'LLIU^gM_ͯN8?]6/7R}nRs5F,[TJ9n |~9ޝ&ˆ dCy8C\jCkZ'?Ľ6ȯ&m.|C/ߩ[?an\w5geW֍ˁoW" g&Ѝ/p89RUJ5.7 E{μY +")~0/Gc섇U$ /GK p{ΉYҔ0=asud#Gϥ VVPf(_nA,B=/9WT*ꞿxտgk|-?v/ЬqE={ e\?rb6= *SYrmCvTAuޯ:@䊏jS6N_X'#,5M~ߜ0Y Onj;0sץ9/^jYq!b iV\{&oݜC!Y_?6oi"1v^' qs"l,iIcڴpBT6VygIwەqwsXy^Ցifܪݑs,Ϭu9'_ѝqA! gBGz[2lt:"ʓEQiw_ i4zI" &T^u^rخN_o L_36dϏn|n5+<nAg lwegj-Pг_,ۋ/p7aյb,+~Dޅ*/6 u}(7䚕Oyp WqނQ2euP!p>p|LrT)W_v=R/(^8xMG% 8*?^gLoy3@NM\*%dEv%R1hgLTST\|a"3sG/v\%jbYyYRQb락C~#vf@Vx-v_vUL,3Țg~t.p{ >QGYmq!WJZ{ iocW5_|m;4/ry彣i}fչCWӻ]=V^x#;w8܉bg -&٣C~3^i񡆦+ըH47_s+ƃc{=l"+ńuQGyM9ܠ65PsGLǩ sAjiWOPpgmߩSN:whcF (mn`2K%' ƻ.f&/ K2*ܽ0zr/nf_v'E|L y·[?rE@;WLP‡1SV^QySd!eKK#hr@UNh2i4PJecF`8NȲߐ:Ӡ7S?>6%.doP4p Q}ur/ZdԕIf7<wđ%+Ζ~FoSZ]ةO7L,/8pv\^Fکl5F+ 4dH>.?Ut4bm&$ieDžh -*^<+e[itN&DЁq{ҷ=ИݙWͽ#_P<3<~@@zpUU% ઁXɏor$BbGg2ZâAf5iX"YIQ'SK6f5qAV >zC"YnPpJ15hdti짲3;S>4xLp4q^]&NٮwZpwJ ) ,ʄeuSYਲ਼AX&Ti*` `3yTZ㑬{D[&;Gbڌ fV],R^ {qj#ops-#L]lc*>]GhӪNoZ|&t,!Rv$:d2֪\L.׹ٶyX JD&W^\9A4Te ;FIz0z/MG=\^%Xn\/Ĺv:8p͎N)jFr1jj;4N`^hᵌa4\$*-̖he3y$FQa]_0++a3vg_? iሗm'-z7*=uyӔT$o4x +y$8EJ2rQLI\aR>1J&r **9VY;R j8Kߞ%b8* t_:}b}^:;ÔӺ:ǖo;nRy/jiߟT|4mϻkR'^qѫD{k?]7%Af@ ӍAt='Xނ:W~KۛkM~C$ךYȈјtwb>3ƥjΚ84Fى<}$~ݦO'sw='kb_RQ<~UI l2`l3TU:NhPd2i*}'[/ⳑ jOb}MU9-rˠG tZpyҢPuR!~fȧm",FxoUԄ'O>JU"vβkpnL#Zs ],I\-:W95PWT`jEo Ij2 ywPjt5 fjR˭i næ6O]tnѝ'>ɢ앗\Y9=t#KFBziӗ#$U}cNӠ8~dk*ZOy$Қ |IL&H3ݿd+r_\|,اk;}"L% U)%++-=T\rPG CO5醂䃧P56d=UΨ`M>SZ`o9L= (ˮ < O(upFt   ÛABRo׊Bʔ}KiVΦ,: 5R^Ltl"N$,:%߅H zu/3$j~  IDATi_P4ԶeB̨o׆(LP%L\NTޓ}Eˌuks5UW׷摆vĝ~} ryaIR ,=3nsw%)̸p6Ö]zk} F'_K7*hA,vhwƌ;ȁFO<]%W$4W^wԛ+7siv _=<΄kYVcYP 밎<7d$C+lL>J{Rg_%q%l?uٶ=Sn ;rvhŝ3ʆigS~j.۔wIp`n+9uH1]hlɞ]ܑP n1 u"EJ55BU.7wJLqE^w]CpM~s9tlvYIu~Ӗ=wȒ$ضOv;Ncu;fF+%M5zΊSi5&7Պj%!*l&+޵pKEa^}PݪmkX.z9qնa5K2K0 rx!<֎}fSה;SoHC?Xli67ؠMqiWi4aaeJ0LCMke<È~պ/\j%J$;1< am}v2͆u14={M ijz4FsC/^i QOnZ\-951ɖԛM' zOXy_\)c4nPKRՏN^/F#4|SƮɸc=xL3>y"uF\alq%n)fuU0yo/8|h/ ߼nZ {zO2f0u{ץ3Y~왵f4<2Vn}¢d59r&jڪqAz] ٙRڔY&{*]g68*4Kv_rEʩ{el)8cF>s]4.T jR6Xz~IոfߠѦ-hRR ɷ9lXrx?>.R\?FKh3#V&ۄ@{NiWs UE1 +ݷ$:16ZsFNӶhkgvΜCkm眘tP_jUޯ_?$GrQF)US7SM]!s \#PWX 5 ],+}M{fck#!oT= p!3 M nc E9K｠ۃ]Ò@ 9hB(鬜I'[T]ygY!h${ M]X}c ol[7qxͨ/Cb(A$r1AeDKK ZK+j%.<7b0 Q R e&!c/(zݫLG4g335C@ d3 _d6MBFpwMGr@ D EMB PP$D+Ep١tXݶJ#G x<{;{ Ol @IlU-)Mq'_+B kH<$2r4bei i|BJHT8BiIͧb8A# EqS(@!/4&!ZntkܺƐр@ f@ Bi B^ʭY$O8NXYu#rgoBul2OMulIb[ "ǘ{5XT̙iN5?cZ_r0 >/%B2n;?$nRķ k6&fxFO5mmj4It&&*/&]\״dOt{-m_Mڮ]^S$?NV܍ v8ʺz9{8w\rao *P b!ZZ n{J]XhUܻj8p"C@GW4ʫzdݓ}; @Ks2f㫡 "P %?>'w̹p*.L!v >&f+GG& |+Jԁ>A J@򝷛ͣuk*g@HckHlX1f>WT*kuKϚnC&ޅ5RfHT ~Y O+E,Yoszy)5~x񝘅7#gT]ߺ(e|CK uyĤxgv7%\+nĚ H@.f8l.I(L{驘d)uʩ Wpt4ً̾%/-gv~C 7Cϊ. B2rsV P{yJPNEhE0_7_iٵ4ȲX&1Bm>]+o]+J!oڒ,ϫI~yPgK.Ij<"_B ikwٵ5 {H|V'>-/jWYgrN&ZqL HoR%קu}I Y?tva- T$v {{fkv{+竽cp݆Lƾrʞ̮cFth:fܮQ͸o>g?ߍXtdcEvCbun/rl='TC+6nzkN_<*P𑼚sݸo; ݾ :z2յ+ݠ"݅=kVuH<Q4`DOSEQ~@Yzj̡ y;pťKmxxih^mpOKec|,'jQt~%tIҕ+v Q'% {ȡ0#(7zLN$ό$-z7.RP]>)ahҝ3gR^6nӶ_0*rb%7XvHl tV2 NsЉ}S;rU]be)҈%ZZ!榤8ʲi鹟p(w.t4w>@ E$򀪼 010$cnɫ-($I2$I`ggy|j/nʠ,r1W8ϴsf4;kϻl3ti+!wO{#6勃3nO{05qK{$tj~ZMxZtiA.4koU۬ڛr.-Nݧ"QR 2s" oȚA7RpLcS^RT\:H)÷(Zᱭ'j3gUuuEEKzZ;I)ky2,pi Mbl6F*! 9NV rBYS+;~V$y|jq@V l?u̯ ֹ%a {6we}ؤ#څiot)yYOvWn3o'=WOhgVcfa0X}==]"c:]A`/ڗ~[Eu`@ێH=%o)07hI2Ti9ۮFN5բQ>eS_tyۻd*u#Yr^{t7ܽ_m^% -1p#ܩ||kׯwtC.m .ttla΀_J@j,b2ɭ1aygd՚ G]9kO5I|g:2L?\A8iu蟷ee!P3 +ozMݾ*"ka߳0MQ@rH⯮EDݟR*$ JD<=emȼnËrB^DXvm!f}xwe?(͛>|]qv h{j:36LQVxt48Zdh'l\?Ir&Sly "٫%Ie!O$HZJ m=Fj0])-mdQKGӴ4RpͲa6tȲ=۶q]=WQrrިUlgOpm:՝:gQsfm&V>;3ju#ɵtZh3$U n34z)p5Npm0֦4Mq82 R]/Uz ԢUp#_UKKrn6ʢ$(śI{{Q [^Z8sg\jcEWGZv@Ң%5<cbgeI$Q[\ Ѳ2byC} a2 X,$I&4hsߝT =%zE}*,e:xYsY<T+UidIf TmhiT.BN1okRL3 |c=Gߪi:i6UDX3:$Khqu[cK j_YHVGۺmYT g&QVJ}(k:tbI9o7~q_?SOMS$Z۶U=Lx AxٍBڴ^7Is$46ȬԒdz8{ǑA]mt EQIF &6G.9s;/x7-nV-izo[N1x9Y%ol5ȍylXFʌ#GYgЦ/iÜ#NMu[܊_[Z} X}a%]1尼(ڽ:O8v6W>:&43Y,zc&&n_۟v[g֓ÿy pEg-8$؛'jA3nx&&}18vĒ~^d魌I*  27;ԍC7(]=$Iq]؉ 弄?zmzN\1QÅ&OZ1w]p?[7$ Q3$i7y̲l"98!ui}f/X2֯_?{l{͙V>"{έzGERE!1321t͎؃s/ց3̀)u$Gdxֺ h@{a4ZSZ$LK6a ƹkVĘ WN0;{eT//_t  bG`Ɔc="&EEIʥR]*EǠ~_F,.$fzDņ0 -z<7vrϰt 9ӖLBiu8Y8d蟫gojW(U >ntٷ`JX08:lPhICWW΢ A`?hXW~WiWL SUū X1͙:}"ic꺱:ه0 ]:Y+]&a"fgp(8_/ _|8|=ɟ$r;z= ]f"%jd-mm0!9B $Ԍ6lq@!Ԅ8DXB!9pinXG,U _y -]]L< }%4n1 I2`҆͞B3 MB1M}vM`ҀB3 UmR5狉%+?~ m;t^yq}[y3/IDAT.ĝ0B!ih^mҵRaRUW|[qUl?`{D;R#-?gGQ,#~bV[7FĝKCyF'6R2&S r-l-Z0chN@;}0HߓnBo7?qǚNʏaO'e>Bo.^.W<6M5|"Ryɥ?&9w @Ks2f㫡 "P %?>'w̹p*.L!v >&f+GG& |+Jԁ>A J@򝷛ͣuk* DHckHl_XqO+*=Z'+zp62Ogjye;o0rbٽ*;+r4/)iمso D|tCiAeelX=kRy`~j@4^]6a]+gWM7uo++Nl. :8/=vإfx8#0wsq7:mvGNYG/O z閎?4DYC+>nDɨ闥 tRΒf0RLw߉Yx ;rAR&̷?$PJLڋwޙa{VlwS5bFpo47mͫMbX6$Y&޽TdJD:[TU+{:{fߒlM햳 C|!mnd?|֡gEWD~! 9<% k "v ]6e_s @mR{ ?w*4xoʸ o7dφoPr}Z_ՠ0=@Unܷn_|lP[M9-nm1Bm>]+o]+J!oڒ,ϫI~yPgK.Ij<"_B ikwٵ5 {H|Vv /:4N;Z7u/M au}<y wZ\N?6u{ڪ)%E5U,<=}ҏ勃3nO{05qK{$tj~ZMxZtiA.4koU۬ڛr.-Nݧ"QR 2s" oȚGZ)qktZs{#JJ JhˇǶqϜTե/iL2'лSah@{ I,H%Rz!GݼAN^(kje^b$Ob\m=}=Ȋ.!C:C{$,d1NC4S@wd_0mnmVQIٰvܿs?:}`}љG.f,m]=}-PVQ}(7OF6|AYɭٻrw ڴٌ*V$\.Ky,6ΩZJnTS-jS&=E7?;+@VR10b%;3˟SK;fNX DR*V vdX[;*;9uLzЀ8tО52e·v,g[~؄%~)9گ~HOr\\VKs8$_2LT)ej^uH"7QT(jTVJ}[kێ״ub/͊ %6<~wly3xǮo#*Jh7eV}9cǵb/sZWb9Q[@HZ7 u2I˛b)D4s4& `p9$d:Fj:%zտM#6f[G(h`xd9q{ռPmȫCbRT#_/=:[CVsP UG4 AL|]qv h{jjIu+{IwXZ:>Zdh'l\?Ir&Sly "٫%Ie!O$HZJ m=Fj0])-mdQKGӴ4RpnflU7jUiپ\c6ƶvuguwԜY۷UΌl=kHw.AfH$ Mf0H@Nlp4Mq^Pąk{g6iѐIUozKOO0\>cT`HJ,TWEs-n >ܭ7~q_?SOMS$Z۶U=Lx Awtik#nI0Hcм$c#BsSK&`NGu5U(E%Ffq0/x PGv╞ߴiv<(ؓ'~?eA_tse^16wcMݸO>~c@eڊ.}B\ =U嶉Yf+g%nxrfQz5{5Vmi;iGuf=9{@+ޛWx߂C}h-/16޻n*lwcM,eIXt lP+SӮ]=$Iq]x|x$ ~0pb̅+c'fz +gQ_ 4lGw[,]{h5F뎓f~#ّ{[z۞OշaLi$="ó%-DA9d㗆I+&ښa ƹkvxACieK68r36õ60-.JR.]:uR9,:J0bAtY&d9) j]j^8:.vI!1#".6Ą`0m㹱o|-KX%ɟdJۮ!x`I%WG\o>+{?VRu@Qf3 qNF̾S‚y`Fn͕UjTU+fusfN_H`:nG!LCGJA!h FXٙ3ʃ16!333""B7HKϧo|S{>pd'~3ި)Azx'tyvG{Ҳp<@y`@IO "fxq eff{h7^ H͜m@%ls`h>cšqgދ< B i"Mk5:0&=9~̧=7!0g@M{Ofg>f3PHJؘ3!JwFI)œ!MBU#FQELhjr333 Ba΀Ppz5c?[X>d-mm0!9B $Ԍ6lq@!Ԅ8ܴ6 !Bs200 Ba΀G0y@!œO I!B3 N/ Ba΀Ч`mB! 56&!Ba΀Z8B!9BI!B3 pXB!9BjB!`bR&Ipp0NS Bs8π47mMB!œ!6 !Bs>B!9B I!B3 N/ Ba΀Ч`mB! 56&!Ba΀Z8B!9BI!B3 pXB!9BjB! } &!Ba΀Pi`mB!  !B3 )XB!9B I!B3 B!4Eff&!B!ԛB!P3I!B!B!B3 B!0g@!Ba΀B!œ!B!9B!BsB! !B!B!BsB! !B!B!B mIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-managedwindow-resume.png0000644000175100017510000023155015203313266024720 0ustar00runnerrunnerPNG  IHDR]DO pHYs  tIME%"W IDATxu\R% b؁݊gyvgw}gas֝cٚ.( !~ޯ{y<;;;gS x@~@~@~@~@~@~@~@~@~~}zD8C㛥}@djdODtp=>ReK$7>d!?e֭DԵk/]1,,,000ۛ1vgϞ={AS~y@ODŚvj]B$$r#04]SߘҶ^C =\7e3":Wkt6ZP}3kQɼi_LMWcI\@_+{J2VWmX\x~ɤXoY[;/=dV,o+S쥺{U^V_#Fщ>[9 ?9yV|~ttX"GsW:R]np ] /\HHt}"(ޱEt-0.$c}mP4zzdݎg"w=gd@ڸ. Zj)w>zHɒ%+VhzQڸQDDSQ[^v~ÚSoDD$um2[*tgzE-> mDDB-Zd"~[ub+7_O|"FJL+s\K e{DB>MV @o,X~!&)q'Du}2m"{Nx5;3vؑvڡm۶~ܹs Q*Txutt4YYY/_^VW[r'Fm&Zm_4!m H!.+[KLE,tC!=* ۋ]}z1cdzT)&jd6D $5$֦D1ץTUTbS7[B H[BO]r*e3U*|@.}>ީS/3Ҿ@DgΜR7 ;fDq= I*^{;f&1^5Z=cHЪuDDgŇ})T_8LM>5OMP r>]YYŻעgr6 #JB;ÅLkDD|RӎM6R<] wZO>֮]KD}5V˗_|IDEAAA/_8r&B4?(=ʻ +ǩSD&vV ӲWWN$;GGвSm"8ƭ| _ٗh!٭7 X~YӃwSZL$$u+Vj+ǡAJ[?7?\5xyzzVT8^`OOi%\[xjD&^ jWZ=ijV+^Hx玓OѻmUmSJҙG?޿jđcO4DVXs} 9ӓht߆Mݳ4U?}t_ ,"U)6*A )w;y΢T2msVMdDΪfr/+>>>/^Rᚇ5jD"777;;;^_y)83> zmK2%x|E7+TV:Ez^.*X*:,JUjUVsEdI#jժT*q(|5-eRX1Ai5jN0Q&K%"#"&4$Fψx"0&AzV+3@b$^s4 q*&RH(r1OLQr)o(ƟL.JŰLD^ٸT8Y6#AJTvu"^,˥WiTj@N:z 씐3ӨtԪxG(hc>18&|iVҩbRV'ĥN u族m#NjҬN$ԉj[]] |G~Y>W׸@~@~7+++,4D ,E Sv@~*_@~AYvEӸ῟cK9snXh>oۯ}}̓%\HsEqVufͿ}|a_eO0ehy+BP/]YWܕIiTt6.îܖMR&& 1i֡K]/46NS}רu:y:#/Pg {n"՝Yݦ&b=z[u[9\^eF^E,o?ϻƱ.:8,NG2ےUنBкoloàesjHlU~%1cۯY?%LYϽ 4k$CZ5o;u஼½ii㧴qkC7/];L/RK:qRSQ7~_fϕ7jNnL҉!^"戈xWy""Nn*7{bCi%EPDL ôj8TjVoʗVFQ+1Le}D]$."?⸏]O͘qb}̈́/,ӽ-vRHYGx)ڗG}siLZ?ƟŇ_$/3bȦմ~)ps"Aڂ+^.߸ki\|3_JKZJ1g`w>%"rno+,)NeHLo H3YW8ps3K]k*sr "&d?׸iUDdX&K)ncI mߺأCYzmeձ]kޘjҢDfn:Μ-^vñ"u*[ bǂQIdUᘱD83K9*h4kxytv\),bR dui㕽F޺9FCq,ppVbฟ۱g |zhC_Dbǁ5+L J_ߖׯS7LN r_3k?hZr{U˱c>D gTTfeq!uI6*nֹsˊbD8}9Eʁ'e.0pr_^ZiҡE!Ww-^;|偵\%Y۳: =GgYagOo x1͈#[аuj|䌽40tMnE>ihYgq2Nq7.pi;!¸~; \|kڧ[dռC?:1lؿc𥤞~,F>q[.ZTAEsn \,H{{u'y}iUX~~d䕇F BU:M2zjSjJۣuvp7l݇&SȮӦL_V3b"R?UlЦ2~;Ϛs_˕ |.VK2F:aO*9?wrbb"bw Zzp_珨g'Z$F$0$%䑼 Rҵtǥ.(vlwPl~ }آxqB/L`D L0!0ƥ c>+~o([k :=I)EDÓowkk-fXWdWcg/8red.<~(r]>zi'Uчze\R&їO'.J&"ݥKM -!,nb\ώ."!Q+U~z>YM鷧܍˷5#!F%WvA]o/4Wa&l{m}q{uܯ;R\fgV;t?>_VcF,Jlwiq^ ~up|7".6BĄ4343F{WoI>wd/!}N-qzm}͌:|#Ɛ ˙KFVmopqIҾ8Ƚ~x"~:rX(sPT!{PލT7>U$/55"Y|JJ|$ihs͝icXy&Z=yK$,ULT5B'G$.˚Myҹ>pnRD){F:0Nj h8z+k]NsjROFn9M-[g?;e̢r17,]ȶ 1M׬۾O=1Fιu=Zr{գnڕj7CXW ,?S1K.m;OhkTw:轸ߤF;ͯWr,1"F%' "҅Y/k6lfe[V,*ŅeswGU;3&$J &"esxbpDDmlZޜ7^%\ԲT}ϵj@f YwfuK~TrV؎OnƟ3wtr5BNxύwz,AO(KHHGhKER:6Vn?YBҥY}.,g{7kߏyUxHq"o Rwxx| +lk6:2ҭNDҒ班hi_^gD11&3n@u NrrFrS;wtePfԑc) ݮ1nEr"NVvش~M4My,eb*MLMD,(&A "?h_9nA ""o{fu"&rS`!0NlX<1IDD'1AzF"H "&LMEI \r c,JgAc'AH`G$KMk DK^K '/nDR Pe z  1ZdZ=BPv_2Z:‘s nTy璻捞޶3n jqѩm[V4~%Tĩ`ƃ&\W ]RkwGܲpeӭvNQiZ6ˈWW$Eu4({~]M%_-RA?Oڎ_ 2IIqg*ti#Ugv5\|~^r`.<;2-f!Jy&Nml&\2F 2S3Di%/i`Ǒק0 MIR7ˤ;OuEED,>iVfz:V_ԆO-X$nm{m؄[tBxɖ kĹLM\M=7N2D6%[LY" F IDAT3fжKK.f(v'pTQ|V[ҭ.J`,*ܾcڽ'm GLn&i?.&I+' d_BN4m)8QfS/GƘ.{1p>ȆBI[qS@xF(e{֓}Y)Mܾtt7Mz_etS-.PH`L04 v5k71C1NI9*bwc2)\R:tc$=|0W8VrrC~ln/E ʛ۽i7P ˁK7\ oY~)q.]do Ƥ/@Z̝gq(^yXutc>5E~k=!EF ,e.)w@DD&t͟+K"oh?>"NM3Rq3Úˈء_n:_;#b-Mڕm=_E ^ ƈܷt@&;Xod)y:$ a8oq$qm>z5/c4bYDֲ}堭+=iRהv2>E]1l+eޯ~ajD^o& \shBi5KXs7H}S8"oƢSYĤ 4ʉ3':v/Pzߑf;/]bYȟz6.}XIjLq]}_/[K~8cwܩ_>>n dTN_ )weh >E J,UЂq:".eq.u݌ȍ34'>r猿qG˥c= ˓^]y+=E2#}}B(>ѦN>L[죥vX2Mj? 5'_^}Gt$2+PwpGO9~KX0i6"-Lc /kn?.|8 ?@.nŘ9r>!˹r;_#0+.ǹܳp ?w!r s&}0'\\V,Ÿt?kUe t;WسXK=l1IcVglX&}pb r;_YO?NȦgN`'w_gAڷiؽoZ>R_p/o.0r$7>!> YK_!> ]޴[IV4nӸOAͣ]>>olvMj۴W:J9 -נ '%\ӽ_x K#VPw"a@ny{n5GkZWJD,Y[O?ܪw2ȷ>dGs,{αrIZVriӑLisDaI4u6ޟYd:sF-x}ge~E-'$VCbK}G:r"6Ml,/ZVL׷.Y$Mƽ QݘmS/Gb-u3g W6Il\n1=Tƶ`!e8,qm[~yVץ뗎xu,ѿrǾj7.iJkˣ^ص״D_<=3ĉMLe<'VZXXsBx ~k;VvٵY3ϓ::.XPKw7bpIv~WD"S &PCw]ۡeD߫?H+M\<)Di$x+SEI.%HRu)D%c^'YUt31 B[z+"  U%ArDDqYǛ(QsмF|}6[ 4T@DTnG}=Wި92I'/dr:Iarn^V b8"& kZi\g˕Rn%#/b@"$-q'qakƗ5IyHb ID̥~3i͢.& ΐ#ĮszxGwrq7 R r׀{E/ mo]dSUaGŽUG!0;O-n[c1Ov>p{~Xo5t+^{džl,|'XqlxG~3*" .鋞OV'Y>D:1AcV+ŖVBӷrdݶ9X i[ɉxϩ˒vY[b(wI*^-KDR'/7w-ou.>5cnZwϺ" Kֽch例ro=N(`S~,8/nʈߔ5g>cnCꤎZNEQ^uBXfZ>6>XvJXѵҝW?Zk"ׯ }=|n֪/֮5o5ImTi&]gUc3/tجP=:DD$vi4Yǜ{7yGK’ճRK65[a9>EŊKWn'RGU;WBAC/ : 8r-SSn]2i*T>_+:% EL*ѠAo麐zY;'1ى3'ڷi^ȋoBxyzY[Ymȵ""#=~7^*hyC._zEb%,-4 \y'?@y8~)>!JV._ŅAKC}PQةz8vi%㈈1c}GE?`ȥ~Ap=@)*T>/qW8=X*;?vLou!9pPdwrst}nrM\5ޖa;GZѰO|U7'֫z mnjLJnߐs1ק7i=z"!&]Vcşը_Ts 9YhroXɕO톾]~|9\=E,yFvݠQw hjp>;H9!mC.e95aֶV;xɅK^Ϯ \2=8|%aSLҵ@qF9j}|a0"Ʋ7 "0rPT8 7K߭8#͓ -VyHsqC#NZvޅE n\m4 ;m{PŰ%o{j˙ۊH`,^1 ߂?4Q`]Zf/=;FlټOM_}9\Z9x=}C[4n{zcCήעOc߮cLݰƒ{nԧY {S?uV!>CXaW4)cdĽ ВGٳ ʇ%=?xy`1ƴaOkԧIank!i:4nZǟ' o?pp;ƭ{?ʺ]7na®‡Vm]J{al6KT?ԩȀH}t膝2ٯiS6 {|x~6M}|;gV"҅_}l>[w~0(Q`}Mro#K"#e"mWv*$ćgc VlQ [+ko|a`ﱳjZE2hL2r7h=#^rxҎ }nZ^>B$Guwʉ{/uǺu\-= \D|f͂kJmm{wzNYЭT< bĘ $KtZ=Id$:Vs"G!?;ui_-Z_a&O=h5xŅW>!&ڰ3'mxzHdI~mxs%:imR{o_vƲi1"}NՎzƌ[+0fH0S_.*pwPj^!Gڳ]QF$vˈN"rNWyMeYLx !4rz-F1FoM떴PU> C ȽzP2A^ڸSbHbb%]5:q"1'G$3Wp:UR˧ 1T<Р0ޡԩ4\cˈE Hy'&q2D_u!g_/4ru3<̈ROq (^JY# 9{|5 +BBBl,,ml N\Ȯټ]|ܚI[wYcx9ʘR+t;_);7:vy6?$i _w.ṂYm17kW,,p7:"u)􄠮<;e2Y()|۲YSgʢ'|Yc[0__wٵ#DΌ5a(d땑ذz}SK gSO;.17aa%Gmނ}MӟI6-o}ILCqG{i %=8hP 4v^^(KeH~g6N(=s,w^|ZUS -995~o-OD]w}ޚVK5ΞxԤC灷,۬n!^)kDB't8u]ѴPۃ[&D2 ~׶W9"\sgغY>XrrPٓ[߼It/VIMs.i;|wtXiشqv`GM ʸoݪsnKj+CS|]#_#|~HdSŔ͜E|(xF$vcg,\\`ΐa_.ݵpo[azv{R^Le{dKJ4Sa㭪b톱93ڽ iv9>ui9XeKD1Kv6˷hQ7H=sZb_aUq5L5 }W>m"&hР׭{eFTܯ.!'Μhߦ}sXTe IDATiϞ.VF]v|Y_^*xnyc}ש_Ygg(͹ꄄI]N4Ûr|܏㸴oY}GO神sT>|aW 9Fd|^NοHB߶!|G|rSɷcاf+=uo~5,uk^ QIlJ59ԷO$޿z͑;aS6.l¯\(@N{/3"C^?NC RJIeʖ-qD2N**?p9yC`w~_Iɾ^\j EZvޡ:&ղ|{|͆-_RzfsCf?>bƒ<}<..4O\]\_0Rr$uRLlL|Ǭ|[?UiѾaǏ$r&<͠Aot\|$ #;O{) 4}ZEr߾_󼳓s~8xr<6*)?dQDjh23SEt$H Lr3SE Rn{/73UJO9Rq犏*'%\1~막8#Eba0sDX\%k[ӿEM=?~ࡗo-{}҈C{JB8G_qc5k-.5vWWg1vK*ݳc@-]*D+5taLM?!iDyQOعwa{_KwĸeEx%:ɛv,|WvwӨ\W%8JKHžWf!98<KBAf/}S'Z]שAH" !d 0,%i?ewRGʱ"EqDmp/U@~8CɁEb8s;T5,!΃^x;S޿cһL!q]_j%-"=)%I!S17~bۢ$KH}K!q{_CV1ZIJŭndm9ԯ^P)"~{hqϨN AB(]a#K~ۇ{4K2/ؒ4BxSzPK>f{"5Tggm[]jќ&wW,! :3{M 2~ް~ӧR~C9SL!M6n,07Ia,[=ߵKL{|"! V><5o0wj%k~Ov g`J7(B[v'FuNBDxŻߙ斈/k-s{n/RV&}VP!QNO0 TP/ QZRbw*Jlީϼ;!쪭vY7@ ~_g-]!X9ÕQݮNp)RWG9N|1n ٫3T[]Bܰ҅ȐX 坐.|y(pw% *e%5!dH|ΐ!gkY,8pJx*2BMK =ij|,9YYYťŬ ݰؒL&*SׁĀ\e@eTg%wddf(/HJHu_}Rv_7uDO'[/5gZY--YYYPH>G/9?'$&9eYe@R>HRBb/N1Xk5}Wl{T0Z~$TXXP r{zR_G%HiT̾2Cχ2@~p՚5#Z< ;PEAE UϢ([%G=\+8/Ȕ0x9©jFt_!@-!*.((`KRBCCO[FA UA 큍܃WN?_ri ꌺ֘n7*WV/Dܞ.өTElAH/yjʊ$RLyeΎ6>:~fFW)ԝ37aj#<) Oy/0fLrSIJPGwJ03ox?.DHMWLYDKûM[?|~wƬ^]lMjqw-3B/#Lk{Th8?~(>^H$ "l\q{j{#: 1IIr=c]/XVQn;~p,E|rk%%;0PI ^lh_ DP/8W`3D@HϦ@xy^,* Ni׶Q Qa.p*_%Ǘ8sllʜ0ur&$Id1M.(#$!LfK3$׬D^S_Fy˞˳-^{V}0*K /F{hB2VKd J JcriA%4f:!X#²gȥ"NY$!IIBSO;MW.[~/-Wn`[PK<KyпTYff뇔-ϏF 6 }bHhujy_־bVnlhɶArLKAw\g Ttz}^ WWDFF NgLLLbb"P뉢(vpx"?_`HpxXhB_`: O6#H1N\6 M~v5HUpf F;V&0R-rW@of4Ny]嬑:[Yq/0u)@5q8Cz~ve4ޅ=CS<zKWόQW<@}L>]W\n;_FA@jW:rUo*+Bv21ƪeHD)Y.@0%ͣ:Frň0Z_˪bQ[AN3"9+gO9rdJ\Ռޝol:`ݷhdMox}Us _4}fƼ'?zUːJ_=?~oP"h٦{+B(%{͚яu~ ~`۷3f|9D!( w|yϜD?o/5J57@ 0u8Na 2 !cܛO񖖻>yq!m3~ʣ^+m,Mһ|TgWgu|l?ߝSi;Heߍ9$>DlzQ-4@Rrx='9~g^[/WU/=uӦBHQ]!8Ӵk蟷)P !,-&M{$ -9y Zq&!#B8W,X:䵛z7mo ^K˻_h /zk|zCN.&\׌c;vGdrx+"~gL$7veW/VY/6iT ! !h<DZKz8Ri+N/;?ErBXR7vaJѢ kHQ!c-7l ťywDuhq0жSeGB,&[Hdv Byꈯ)o~:`?nXwуޝyѮn (--DQjx!KΧT\U+Ow[੷曃,_WWԻeڼ!-cL?x3UNY1dNlS8_vq?,$7b<^޿XPt*4rܒ]zssu. . *A k{3ɯ5x&28.3g~/zs_≿$As#:yM3V/y]td}G Yb`JvL}jj&KGd5U/"'}4?/?BժJ<ܩ ^v[%zC|<Ǟ녏_JעbR|0ߵw_Mx~CٻeY(2; 5(h|,ݚB ݠ!=NmҜ%B\ו?~(!?^Pc!n:?Z tM7??/_!}j'PnK&!K8D9eMkXF5i2$Ý'hPӘ#CF_O N IDATF .A SFAQ 00A@~пrA0o!D#hF_!tѿ8KWo)[ۣIi]O/!btuq+q1 %>r?@38廂: 9r@k֥7OM7|_KtKn;[z5i(\l  &/9mݞ钶uM͙ѽGM%F6ixɡ"MvB'Ĵ5U/m} I?9-=,XZCS[FH K5I=\z GqsM6) Q/ywk\9'^ө,Σ+_c&}\Hp<~eZ><![{o?i9;J:Hmz'ߚ>Vtҿ%ǁzvi9b^IfWgeR+--n~tlsBSh`؊Gn_f/?c?ڔ!P23eYYhk c~ah]M_!ZO.5p☋[7i;G'd.\.Pv|;=xWoޠyV-ZjѢUak[oq4m;o~h鷙%Ba׹!8̿'N0MYb7rT/~eʒ:w<1M)oX)17aꗛre!*6WB05hYsw<⍧<3kf/uUXY&[5ZU>m&ndݷxgQέJ%EG׾<ɷ^uA@<2>!}_HQ͛u݅\rt¼-s~eONdG-ޑaR E)J/bh_$qE6˦NvBMMiP9qz;)m{ !hڴg[z]4nR3U!S"Dd='2?O_`N}wR[@\1/*9鬞# _Y̿Bė_wPUw4Kj4d;ʙ}yψgXZ|z{=zY!秬2-lvB_3pBy*؞ݒ­8b&'FC6[\WΣ[w4I*g98:1X8/X-Ӹ!A!e/4Gс盟Qn:ὕ[ ;9yN[&, +}IeVJߘT/fkFt/~E}wlphs&y$9oX݇v Oy<[/xM tSBXJ]C"MU d׾~ނ_aCmbpX?|y\xtfI+Ԟ=# p3nlǀ3JՠvgRAWxJE ;рtr%9 we/Ah%@a%7kLJy5'=<~/~NAąjah*?m[i"#p<''p -m>qR5NKa~8#8?燆&t󃃃=%+@ie~_JO<} ??5'$'z"/R!w=5ʚ^_ Y)9Fܗ6-)!)::t"/ go WN3&&&11)\DQp8<|^HBðh.3~Z.dddhqĚ::BkX%>@8tRs D~΋%it%T!KpcB^`,p€[}Fewڛ{ "#\ff뇔 ?@i4=\4*46-_Jѿ@ZK# zUH0E/iГjA*,*@MxOCBпFq:( P)@uѿ@οDT!K8t!X ަۦ (R ; ̿xK~*j])HIG\ ?EAVM /^$vc6^maENI V iEQs(Sݒ$Uxl<_WFZ4k)d0NxBDǴlræ ]8 ;Ќ4N$qb;g!_¢蒒̮]{;cbb٬UXX-˲q*Qi֢ɧuo{}qHpEFRN 3VsB2d.槦 jV$>CZ1@s#&)F ~v ccfMJUN+" IQ3*" P oKE=yva#wz<w\4yαIt$?Ȳ\%C]`2Tݿn♯}ξ-C,e` n)Ej9K!}=v}׿ݖ楣_0۵Uq.WuiToO*dFFO۵u9ت=KX*V^ݜ银>&6U-PgTEH]8DEQL>3{5wײ722-nOwX3FDWRoL!uqd};ZnWճ]z}x沃oxJEQϥ]ؚE,qu7jJI aW+R_R(Op~/OߛKJ<5#MvإޘCY`C(ׯNfKzʊ\G.bbu=%Fk`7$w/MM͖pѤowmwgD-Uڬͅ(J"fE4Y\8_2iX4rЕ/u!t/84!Rq|$uRoozoVq}.])Q)!Yv_3v{ދkkrWrˮʥ}9eʒƯzoN>CBT|!ÃM\瓱^Mn敯\恴T"+rreP_6;{gv=5wԌ?sW?>%͞X Ǜ߻xY8~_%_cүaufeΥgꛏ=ʧy |JSsL5V~0 qّSE~ ~ 6muk*V|j[+շ.-c使=pWkqbW<&᪉]DO^^vwiVAG|蛯ٸOkEZt;汷<{':d΂ob-J47zl{6mkJo={Uu?ڈ?>D-}TWDl5 ,If|lPÛbl~IeY"{!+Bw=*$ksVcWHp6yW(EV(ێ2nu-w8!Ǻm8_w"gBk[_\fܙ--'>JiQqXibCy ROS5I("fIQE 29Jl>>u1jQqi<e"RKJ wktxHf/1 \ŝȺQ"s[NIw!16IVPAB";Kˉ3k\YCs?U*Yv:sǟ^ǒ985ͅ;Őea&}ߺfEep¯i]*>98:6??,]oLn#ʋ"U!+RyԒ˖VS9&<0HR }55퓸f?{Ot}>zemA+*>u>[ nެFI5 !edhqw5Xvj;zmQH ,8ȩ(!d]bk'X`:e"+NKE;EԩHuۚ%DŊN|0 $KTVmztzCnsA{Z6蘔ECزCj;|b'g}ԯl)1?VTLB;\]]'%^-o7eoK~7nwbcOo_ݬ?MʫsS D@+o_|Hsmߖ1 ?~_uFkaA?[jPⱵ[Y(wQL1ݮpD9I:XG<4iJ[rI𖸦_ТΓ.j:gKy6]վFO:g >^qkK54畩1olڴM^{{uNdd렣MϾITi_RDW/[Ԯݒ=yEDZ]zkNتGMϼ~lǚUk=Z,]0r% vOɥ $Q>1pb)W _zcםҢȨVE F5b׌yӟ sNB".f嫏gf]_mÄϿ3B(ѕO|0?"NK.osV?Tn?(׌ ?ksu>q+z0&)%e _69OX/ַ_y>zט9uzz͞XT&\?T}(JB"翟vS +,m.PwW%!N#'vr^] ܻzq#E IK %bՔt"ԕp*ܽA!)B(=uͼ}hY}Hя?Ç !dY =o=LQ]o?_6v#&MqS~[X851컜a'ߥ3G_s][[߬vuÀkڷxzSBde/jmڃ!jG^S҇NdIUsIa?_XϞcupwۺ=/ӰM"6[36gYwZbU=iR4!}{N7U;_Q(So\][ݺ&-?h_RVףaΟܻ_~y{WPۏ*F!uCD Ж}N[_}H%A;&(:=?tzֿT)2g3R܀]īSNg?mm`'~ \Su=_NsKVE-v("|9NN:۳/_1 5_:g Uqx n{m'Q5f1Cu%iMlpisT!zrtrEO!E\F&!zvѲ-%MNyښ5k*~ܹ3\@uƩ@!((00 ^zׯiYQnV9Qo|fELEό$I>YsO; ! lmK΢"j|.Lv=kV(u(aiY*mP&sY]ϐ,!b"N!3pS*s g폌2-.)>~x:yrRbR䐐#lpYL?/X88exѼruKFȄ}dI8sᕿxh˟q&( N77ϢN@!*2Ja&%&EEFUg!ٷ_qI-ЖX,Ow,Y֮)ѱ{N)&YBypR ~_&欵8j5]0#'\SeH";Mt%%&L^eaY8._/6BQzxۆJ%6nb{q`ς~Y"%;mIP[ XjRpu'>!nfh@,*m%ز}c0[&A_zP/in'USSE\W<#E+[f*tdA0~@U &ͿT ݭnK'17`舉E5GǙZu U5W'q1ToK!]N}y즋eShfC]' A~I)=q8k[U^ ty KP#}R3Zio^%  F#΍QsSe ԿKK%f*2|222׸:$B:g\ȉrENV P8ZPu_[ߗʏr*0I ?B{.s|ꃦ0։7p{3U%L\7to/ٳ~bގS lr՝W5 d$sV`\ &4:KK~\U Bq޾vkI1ʬԲ4!(>L#6zG~JqMJ.A?4Ld<W=Փ!_Jm4:&N /6k @x4:B/ YI)='l4໢Q94N|{YOy(w:& 3*6d IDAT}}kAd Hb/)n1!|߿d Ӥ -CRwuʭlc81F_"?@п$߱m[)9oZj ?Pw_ W#]Ÿw_,B,"hܻSxTϷ}(탽y[}xc0nlBצߵUit%T!_s׿}mVciKXj .9w"S\Kf]k׽Ė++ժK(3+ &?̿To!̹sȜS#KGZ-jp !|ۿ1| pT/A ͿTŋMS4<%:BϿbRRRX4 1lNl-NTaӤcQ*j*6'f*N*=m}yrԖ KewuaXM}ჾp։IqD0@_JO@vK+&<`pkb*%SPtRU5ENllE5QCvɚ>Dl>wʎ b# ^xu+U \0}!|߿uӂvpbD$i8;zFToKĺ!}1yn۴vuZ71 U2K1)̿xDцÄ?i6hsY%F Gt=/ABp9[3탄Ba{{0P)/9+mеaP];˒T//R.[ܭ K[?&Gc71!|߿coQgVnB }1w,y+yF~Ps?@ֿ$L}g\5ݚ6hu Kv? SJ*\ n熇`h!B_/ڼ%UU`I 4:/ð#gWͫ>оOFa%-so'Nd@UWZQ: MP)?̿rѴԉ{/fE/}t`q\.NcCیo {4:Ɣ5( :4BVp"@~mĖAg^mXѩ.~2\2L>ojK.cLúm{|%O{i p4T!9y-;o?_0-nulƽ̊[Auv4'=}Q%Tצ<l\5RR~|hG.KK0K{ř+?O!Uj_@M}̿x=B/ɇs?uw܌#`p:B(qm'ymnZvyȚw[Fin6`(BZܰN~`Ս^sӊol澯N׳F&9\$ !3?;W K Ͷ 6D|P# @IFu1M~I))0m` 1zϯ GMHu7_ݬY+7=k݊My-R"L™YZȥ="}R`ZuDD4oa_RgCǎ}islǁ=]E86TSt$&@R~)G:vzi 0%@ۄV}R[95Uu;_Kƍg[\Q?@ֿ$,عcM)=^Z;n<WrAV0U- ꬡ /ޏKBa m訦zha@s8slǁ= ^eЪ&!BQP#pRj_ 7,я@4:BݪOj>c'tw|nإ٫ j5(\R{Ks8jVoֿmTx`%BпD9Ӯi}P]/;jށ1b0_^Ŵh)dx;K &tZT!- %-1HKh R ;,Y>E*  F_"?@BпT3dں,[ ?@v>~~@W/D`P+_# 8GPq-K?ڋXt ::VSIxKP)~gʭV4:Pu/2$ut%rh7R ;z o΂o Fxwi1I!_.43@5jjy \5_'ZKpBuB:*ktMKP)4oӺhf|K:BZDs`|6`B^垇+zX(@ ]̿xK:r(UӤ vk'6 %.iOesigyg8٧a[g6I8L{1+TտT_H;$)njdE*2&6_"?@BпT.33CJJ K2ɰ|6eςk"el~| *EiRiD3j2BtצW_|S=X*njk/ /ABпBM΂@UۆR @* yS: .s-}wuήJ\Cݏ9t00R/Au3ΦwT`aڈ%JVt7lEA-fgP):vtde /D*޹G,Gt%:BPe$m%m\[Y`oJR ;&IGIпD xm'de%BпۻfU 2ʏ>n6Tabzه0M/AljZVMo+o `_# Mځr0TaBױxX@p nѿ v1T-K:B@p b F*0:tQk4:OC\KeSiðo6B gLGAc J:GM_Jѿ=,!֣lo`*EUH'J,,gh0GAtp4WĿe((%ajx̲1M/i)W_XUGAbePSqSWo+@~Nc%${i׋m9S#k-7οD~J:$GAqBXÔlYF|@9#0@RZhW,V5*J Je-Ԧ>1 TX/IRP"W}85kiL0RHQ _QtGC 87/^KhkaαR!܃yRxB@h%k|Vw΁Hn]/?w̿xq_" W~łe;mmJ|Pu_vu{V9P=R_ ?2R0"_!wqQlmltHJvb"kwu`__ T,kDE%uٙ=3ϜgfG%҄%EK!??φ/~ APT6mڄ (v?DDK KPׯ_#<"<" N!?!_-YWw#x6 @qR%D\A)/ (,< @ ~ : _*EKמ|HWpumܚ4v1SJi?~3C|DѶ^IkFoRdl- թ(edz?:~ B Z֝ob3l=;hRDz ٔĩnӺv @14k_%f3mj^m4Y/Ӟɗ]|s# /bhGN:5iR?ڈ__>0Ӳa.$9w#JE#֩ݾ] WGA"BdQ7݌7hץcc˯ ,Rw\CY;Lj^y[6S()ٺsUY//?KPLh֨ǀ}U_H2Lu`ˮcwBWN{|1vh޹KZZﯝ#J0#R=w{ 掞^7pT㩖Sv]X[TỲN 72sNL+שW1({jHPtrlOzʳҪѻyE3.!n-mj֫:.9p[gDJ+;Yy"GgcD ȳ!;m.Cg MVfk\b2Ò~u APTz4FX[U5)4SVB GUJq58D&ѸP61OCҴ볙d𸹁p,KDs"y3mͦS Lp6 IDATuyD)2CԈ[W/u*3ӳ҂[qiX7jzoJ˦* DT =ȥ9+z!)|\(3Z14uY^]_!(U; (ø4c$ms=;mK!"_]]&95\Tb0͑ׯS "_ps@' "3!7Y#O?vɷh)AR sg$PCԝS_6ؤ*,>W"#H͠xh</hW5_߸zuU>RIO~qW]7;)!!!!!1Mp+T}}+4*!&"fU+ Yhȗ)} 3E/>Gu-LQNooƳq,Cߡs<)޼*I,Ɉyq74S/ÔM&4(e2Liai8_ad\g7%*;@lF}J;;;-(u$w|]ͩw^իիhDx|(Y捪rp )M'Ó3b^J4`gfMx~ÐY54seuώ}"ѠZ53 ȗ72&/{QfZǻ>b Ei/zuСa,R`s Ž T;NשָEm3 DF?&ذǏ^JYa(QE== gxy׵,9/*T% KJ쓼ѹt>]|󂀀___%߽ ;h`&-AAA%yw/BBjB< a@a~ @R%?i%EK!???- _@Cv@PX_#2^+@# _ߋ݆\iO ZӨƐ2J|+ɸUY2Rԓ>2ђ$ ]z+8Oܽ렁/PS_[f d_\{l"<:( &QGTuhBJƌY7YQMQȭ0+Iyߛ² ;>N(kշShB踽N#wp63ҵk3z2fPR%M9xqF8g 4s7U_-gB85Il v!;Mx"Q=) 3rg+ɝx<9`0fTPZAA!YR:L[#p r?ڲ}Tl-jw#1!c}DƖզ]~4SW.4Ӓ&$X$y{;+;4OY?s1JBעo tj'C_?,uF?36EQEw<6^JnEqvjw4fc`oS6\Cxz֎< ;[Nrpl`:zxg3Fm26z1IDRtӰ9atdgJYI%*}|x4Eנ p;@Ma@ !5%EK!0Ph)A´BK~ KB/ !L;%:VgD#FPC#(&/#I'y}Lk`"F|{&e/NY˵Aa$фEcvպ߱01wscǔ<<\Nc[3Wk9C2-w'&h8vw7Ɏ<ׯu-m,͓teŹ]=J !LSK{B褳}=\?i6 ?wX ]=:]!}J/WAdWǂyu߭_|6Z]Os APF f7_A@!}zbwyU/ܧeCk8uzE_YtXm;2> z5rc=;aqӱ[OugݘVW:9UD!ˋGl`FlՈ5]7Μ3Ӣ: G KFcp!x>2|aqbmm)6adaFrjV):gIw;r'yֹRrx<ыD?kך^=݂b$7#5Ff("}Z{eUġm,۲~%͹s1QלMrO?Kn1=߯hoKBQ&?}ձI%] ۲ך߉;Bů`_)_#jr]_]͓.tv뽴Ay X][(,0l6ncǣ])_5%uC>ޠi㊼%V,B[8FE3 [KO"ٯh1&֨uN`ieύ89Ci9c7&m x g/v5)BQ&hѠYaOl"2oC棝"wQB(ҏVnP~ @mBcy1%|5ٞkPt򻗉 SgA/SE؉KM0<7_iצ/pN+Sp₦M; JdS8jd&"P߫@M~ @(5M?zf^bg4_q{L=؀Elaͪ qswW4˻vL~Kߡ>Zw||u8=x6ɼ9^3EV|I(=J?wќ6>ovtͮԎkZɮnfEy4,[Bqt2ϸeWٞ5U_Z:v}|J;GTI}+9:f,qb!("URO@=0% :;]JzcunKS!3q |sm*,YL""znJ->]l}~t U ydJ-sUFꋈ4wR!j?s,9\Za޸iQήkm"Ҧm5DT4g}H0fhZ8lFmxi7rMsd;vkk^SAȡLMclunP7\cc>eeddJ -Ȓф6[ă[guv7$ɗָuQaa RFJ]wqȝ+SG% [s$oӤ]ݏJMz}m'5ٯNo߰z7am[1{÷B^\ݽ`m\] ^оƵ'BRsavNt;W9ԥ WjG5|J{c&M8i6c=tP%YDv6j}PS_P7,]禖G~\Yuw4toÉvH}>;Lqtt̂+G]0e]4:6xܕU+pm zTUݔSܵ)"#4M!Ҫ=eTΒm#ϸ| |>>i{P|ϳtJYzU;YӊK7{e+i>5aކᵴUjV8u|Yкӻ[rHVb;DsJ^&޶myʌoO瞱j̵Pn@9p쓼_%rO (1:Ȏ+=0Ph)A´BK~ KB/ !L; (,/!BBҨ_ѣ0'@a??- x´BK~ KB/|4)}}gG1P~~~-@~/ZpK_#%X%X%X%X%)뛭KKKK2E9p쓼q eB~,,,,)K%((?g*^X%X%X%X%y N> !) !L; (,/ (Z AP0Ph)A´BK~ KB/ !L; (,/!BB/1 #CЄ1EQSFP?/;⒒9%%'BL* 8N@}`FCU뉉q欣#Ctu>ZaApg))qX"ӗJ$h4MrAp@Ҫ_RU2 SWȚH)^pmpTcJVS@N AJ\DaհB Ap.8χ5UZ_@Q]*_m;J.sZV%:"~Ci72J:;bcC%!~Ipجg2p[P_eK(%Rԙ>&+ܶ$ W׺G~:0 ə" H*7-eilB!أ#v[oϑ=]rߌ)b #}oRDPvn}}K^^Jqcđ8xLc޲`ߺ|\^AI AJ\DE-.j1K*Po^8{QRwRVЉ`Ѫ ;IfT[~˯x=&LELBEeyIkC+8m29]{U5R%5E Jux=0m̎jk%xu=`!#TmΚpT=PEV$FOP"8xz%D2oo$ ۖfi`!L+^zJkZ5jDˈZE_,kǁW5ӧ/ 5tǒzڟ>g TQvC0NIq3$S!yx1Opc >Mu*Uf_~y͞ ]27bܻS]S(HI2|s˖z=V-`AB*jp~W/)Æ{nu(hȞ-r No,:,:]F8zMMܜW^SS@^@'uO{X!ġjwn{Twș'=n4 çli#tڣu f;x8~s.<]g.:u(rF"S"CyY44X u(zy_IL~'7_2ڇ3_̴mI}-7+"*iE꫰,6&ߛ)is1so\pg[+iZum"P*//bp>aB!ifC_̙{:9 ki#04LjwCo߶eg ϴv׬XF=Iޭ>.nk|[qnvy-≕rԞ{!_G cB>aWW/MaEיz.vڄiBr/gGDKWLNWP&k]|F"-*Ki)S(?aT;IŸRQA IDAT$)hF5kݗ\BD|mP<>aRJC[`+TVLC MY@}XV0NܣMёa=Q3bL&")_lBLn0g(꤁PrLYZϘ V_*ΰֶukjִ{`k]ﺠJ^UEr&E;a&04ZyiēTEάe7#K5qlSqV,=6}cW ;E/E68ÔINA: !V*4aQ$g&fhqv0ojjn5O*Ttฉ7|`T08>;tŗטhU(x >Q&%cL]\(}c]^gabywTjiN} 71rC; RASld؆gZPF{9VM 5N!Hɿ?hf Ύ,_(O7M֫dŠ !;Y41dZUH}btEJ;g/~Ԭ^Yٛb_D\aJՅY|)^bg0_nYަBqR"t_aF蘗)|]=ݜ?:vI>ċjvnVECFu5|b:ÏȷʬLe677vTNnݲ09=_= L>Jt,jБv*}މ-:ARϒٙ-~,m`ie)HyMsGu=mM+C e”?=Ivg:4rcF\s)RZXٟh^u˅ᝫp"ͪ6pr8(;a(+in:L8o ǠR:Ա j>^?/\{ٌ>KFö+#t# Ǯf(e+teJ%GܻzijB^ֵжʈK_D]Dyu~s|{#n=vb'UTWP7 z+[ƄoM=t0j|y C%('Ci>ܔ=3din|}оt!ka"[zY'֝QδɸK6^*kJ_ָ"ICI\j8\#5UjKbПXN]"O^ڷd&M(-KOۚo}?3k8-{Hb |J=G-0=% a4?dUGZmcVA64]8(Zp>>ߴOq]Wmܻ׸f&5O1 P:c~tͬR3Wo#֝t~,-[PenN=rtmpCNu4g }#Ju=||A ;s8)2%ɰuJ {,+x<{=G,>!fXZ5ǮQ0 BQ&/^.?o@ulΚٱ44YI)/5TU̲OFjd2Ye<Qp^f9l\k/p 7(`/|< )P?oy>H@MVE(RYlT* _ 8?my~p: qY;(#JPg \vd{FjX"D(D,>0\#QZKffQQ:|livjZ9]pkKzz4MH4>ojbT*>0\#QZKJĔ*߶NӴBSvP?(#D.Ap0\C`!))/# EUD@aS%?i5/*/!GFe AJ\[~"0 EQ9h#  *jQj KŀoF!V VZSxR10 + + o AiA@!V VZGv(h`G!V VZK_*hkEh#  B B/CVmX!VX!VhP..B6HWiI6b V+e!z>[#UI,h`L5cFO7@MK?oSC WڹQ]Z יۺe"_H2ŌG FίN+|xN}'qbEG1<&]L|Ϳu<˺;tSjhŵe~wr,BQ}G1 N ZJpF!=`iAeuv=g/cVÂ2Zny1Ӥ31d&ie+˙$eO>vEg6GvgO=rM^k^w`>#Wu5:&Y%$˷_z4[k̲9{Yqkѿ~ڈ>qhVڇ׬:]t|m{S6BeQGǍڐp5 qϮ8z.HѯʔFIG՚ՏF|&߂gmڜ4kC r 7<׍7TG 7I"~x6士jBiY|3R~9Vm7U\ɼrČ ǯlbKȅ+Q5/ j,ꗔg?enݪըݨI0Խl֠3ng,i۶yF^/[Lyg\F;t6+++ `rJ2EQigdd|W _ꏳ!fhWmޞ]0}/=yFzcvdy}0SFgiOLU'_UAM{}kN:5po-3yOڬn;E Y[NeG^ܷu=WmN:.SNJNyx)iVwqogC#_)[/!w գAO*>?ZVM\=:x|gFF#n &чz+*&?_}}$*xV\=vϭD%!0iUëQY{eЪz]\>}W& J'/r(+q/s8QdVcO/35;gOc'?QKD_]`[H6!Dx{u=\wrzc˵尵RiB{[wZekK trѤe{lィ+unT˳U+om*, Xөaygy,Sugggj6,^j..L9O|Pר};fjheڡHՊ1W7 ˣ7?rZik0Wòwhkyx)vd^mӳ  sp# dv.]dUxhҙ!jU#§7e%:+ֵeB䉧Jq1ˀirwY !<:t[ՔƸ%^@B-Oֆsy+I%LII]Bԃ3W(Z02]t'z{5&?qмF ;-Bm{n~iT;`ֺ{vlS=9BTO(v[O]>(6Eb ٯE5xZlɶ-+ptjw]_p!ɤAe^:w]A0/c1ӂ=:swVI[K,o5xm-]߮w^5)N]n/P:llvzK'H5۹"w\og/gw{O/n6˺ fM!ƣ&SQͮy¤wܙxd*+Jr!ͅaǯȾ56CƵX[y+ۼY[+_K !D…$M8BgQG=S\s3!盇߱ԿkΜw.J !tӞ(akvL"{{ģfVn];-0+h%\X=zwu- <) \1[[~?S_PjBҬ_%D3&q[͆]kkR@BX FՅHBXF7L#"{pcƿO[8±a\>ﲇQҖ%,:>~HbRO/MM{؟p>j-0Ņ5_ɗHo7gbgױi"$X~9{HGyDfҕ !jncRT~wm#Av6K ! k].ktyň%q-:M !,I;wt1aǃhu=һ*Jfu;vNرJMʤ;,ZYDβ*B/b{o"%ums 9Đ:6olsƷp΄< !iՊܽ -RX|-!-(d:]aiV5ߍL- rUX m~#7tݰUVBVϺ1y WzdtYJ]9M8 ;ms>rT%K)Շx~hF^&R&)edD_K5 ɫ$IOǾѵ)B~xh ,HބeW<*r \>2,=϶{wN. X]3 hԨ>"V+ O=(K(toV`u.p3wv~`܀]^]~/>@YR@(qFݫ7>h̛uݺfIrՅӷ}l8p[c+ۓ bqbRSHfikahpBCJa[[{n+צ.rv;tEUvbʘ^ЎdWe@'gO?J Xq_3;PV>ڌw1w}򍧹c+dv÷kmw˰Vr f}~\ֶlc٦ӺMtz#/r +>e?Z4X[&%0ho.CL~"ݤUotZxZź3u2?0&>f~{?RiQmyA.ĐRʥah"Q"tIB낟qLӌyvC&/qpCgȫ GEBsFYԣwZ^fB!6!%xs5;.g1s -byy[gJK*I l- S^bUP(gT"U$Y" []"&4ʨ2u89/#~Dz*%YMme䙆S֫H%~5 3=rqP8e{y¼w&/&;T}pTD}MurرFl&=ܷ,qf';} pedgHĆ%{t} 8%*T ^­k:O4>,`ۭWew[0Vܴ޼ pMVY L/_!gW`?~L۵jMꋏDǒZVb߽ㄨ'?;"VN yT1dJ[Jg`5K }nՎw,5݄3a39sÏ/>6 [F<ƙ+^&eziJ4+S`83K&q l 'ϟ`UŘ6ѐ1Ö2y&϶OC[4Ʀ5OSM@~4Ҳ yw3$KVpKBVFB䣋v^q)SظWƎ?{/m\n:s5FU5K}t?adXJi7'vX4Ms+5^f IDATenfvx6zh%+E#'zU;/X3Q(~фe5w=5>Ը"~~G2me٭S'B *[[zģ4Ѷ]IHώ]6bWhpugRm'͢^2<~?Sut4x"vFS Oyli6?;ޘE؆;7gam8f,p u13|X kGnl)ZM[7N}{xH!\ߘ1YAQ;6n2Hѯ:L!Hi>.\WфX#~e+(Xq,z*^*X:x~+)}}}ȣ + + 'U" X6B!VbXo:_N!H뗞~eDf7xNaG;Bפܫ& zzߍzSGOR,4سkrڊ %{~-Іe,^^` ;[7;Ng5ZC8tͱwj;[69R_+yt/ ݌X*0[i-,T|^dkn`$9[wG܍Yc@1/IR$wՎr o}|NI~XY߆޳4{zE6t•Ulܨ=QZ SXAE-Eqy/ޛ;h pϝXm-KJ.N|et\32#fn6nG -cC"&>]2i\>&\g%n,~`T%P8񥔰RAIkٔZwE5p>;@N֯Ƿ=OX5 fF e㺲% JaH/h.YZ- 3icغfO؞X#x*ʞSErX=7/p Pv'\گ#{|.Gh~EK_yEIt_SrbP/Z2 җj^QN][,#:t^.\yGb?ߕj~>"V}lڦxX')Ȧdf:SA "Nw;zYoX1)B`Qdө8h &r~/e1^="a+%Jw_ p>5-rEOeyv9I#>*aQwuL҄i30@k*3ةqiY6>Ϝ.Skr/vysb-Ȭt)i:/r,ç_lqYk0Em:Y>ҝgw=mAZ-;6-Nin{*/~737~+/\u8Z9q9N)OK]8(s9 ݹ+1- =wѹtZM-2q)?FԠr٢}ozBeKU8Vi" 'M̩)[kY'sJ8:л7*(ҔLY%rs?3:֖~y`m3NDHU~EkLbٴ{]v2EBw?Pab`;zύ<Ǽ16)Dgк& ,!H/ Fliv9=aބm< 2Ol&f-im:?X<[ʰsF;f=">D.Zc[}t06gU>3Iܠ}P 40+HUffާ=H0_#:Ť/{k=|CrxEJ/^sWG 4Jo=Kމ,GiI%Gzl{pV$dz[*-J+LJoP{tW\R|gz/"?UͫvC{?ulҐ7. ݗM=e/Y ?N+ \ܙO)VVھ(iK |WGLFia=ۘTB)XUaXNa@@JxL]@ p ^F[FaM@`b)ь8%,x ^MTmj)pܲy: R2K6&m+TrR:cWGNMRҾqo,y)5@<Skb7 ~@ /6AYI+ NOri^qN2DQ#*)`A#b{er]l9t8PْsZcN`>,ivϸ}\(o")y"-\#Xƿ좕jU=}=%O DTY78} ˈXS'KG8f`8f9(#h3Q gmzӃbQ7?#qu [hs6 Kyƫgu1yVvoX]cJ(p}#D_P9nIJ%T74j%p&\\+aɦ:r,VU|Wvq þ|1]}=L`PXUG}٣h&:bSz;Uy;Zq1_&_$jW[_Pݿ_=ue#f/ƱE˴JRKS !r[cF%_$Im&(փR1ѱqiWB^rM3䠦\O]S< "44sNB`prB*,)+%XI)5G;hT <\YOV[Qo,X|^e#6yuqim:N늩uS>ERbfjBEYE#phLG-#qwY;U#Lqq~VsV'6|ZeZ^- ?Οǝ3zyOpyPA}: C*Rk=,q&)3B%.1%Zi;LiښkaY^E̾G،dq[pL'NOա òuTUٍL$Ma"!!XI*B8Eb,'3)5Bѯ(tZ- ?lVЙ%v;yaa64.'= I[ ]KD& =~@ Q Ɨ K5ʕ1QZl'N8cr*6)kݿœ ȿ81&[8U,e'W,I>,ŕZ*ƗcXt;;".ÙMtђ &r*Zq(z:A<{16ӦfTrbW1S}Fgzrw.u ^Q'vƬa_Ju0o1cxt/mIPe̵vKJ̙uJ , S=_Si͞#>ju#E̿nbt7_X͘vқRLU62(U0EΝ;#S"Yi-ɞlDfu%?,*.!WTV}3Mrg7w9+;҇7趄U.W,R q_ݷVb5?)qI+)/EC@ )EDD,MF#hʴO7xŕ>.77VBáM1qnK*>k`r*<0^~@_|%"Nj(+Cͦ vKo]N?`dfD[CÅ$cd@q5cO:2W?hVG]R 5LZA L ʂF hO I%fRYպEiH]ax Z@ H? QB@_B @(1Tb\A]d"#JL~@ M; j0QŽXmfn!A𻔨雉 )/O/E.h@T#\E:#2@ @e ( QQ [FK`ѐL̶W5Q[%q`ogz(@hPld^\\MB^6*ȠnbUϖLDvn64n&A/!j0o{HUBW/Az9YOTa@ @e 5/_Qhp[saf5fA>8 _M; j6QtA|S0 @+mZ~v$ey W oZ[|~DT4[ #P?@ H? F#!򗢞t~ށve&(oĖ9 -~W7[~<sk,"w[nĢ:k7Ύqf|\q7}|ϧ>6@ ƉqV,;/TfSi,! RQb=K_ ^pW6NҮy_`Ȫhn^|\0vؓȟS_n_ٿuިqG1[+Ǯ8qixjez3МSRU~D~`U-wB}Kw`/5ӿ84fvaiXeكZ 㾢b-6g !?SVܥ٣_`ÖLeX.=|nMYu%vvVueqSn[m[pm {SH`{ IDAT_`kοe>- Zt2AýϯXU܁tm'[ra}uI ? _"H(VXMO97>>$&'8":>0]Qבaz# @&NQ_?|%sUe/?b)=9l.6lH6os/^uq1M]/_Dۛ&/P`6< ojB+f/xs-q:~?۬|3<^d:|;uِgR+!…Z7 h@ԁF3vʼw4tZ^el?-]˝l-ԩA߶WCy3NX^MկoFt(t_e ѥ1cO*n굕auIj1F_SYE.GQL(02 H1% BQ#[ڇ]N7!,jpLcZuioRP{>SW/,ǁN}ݚeKz@g?GujƅG(V!!#o>ˮ}Z=N3 # gRVtOl ϝٖK]}mHx4qd]rjK7Egʔ%gn?AXBȹ}Dׅ=UӅW1ٌ)-kBeY=9/M\-1J\"(VOy.NP{8 8@(:L)bG>UE*.wآG]Ãs/F(EXA_6=aտ8*cߴ4>pp~;kv7vM o~tx;-:fۯgo81oɅBF}[S.R@Xߎz~s`bz"uγUSoޏw@g8B)=8yO]fvc5c؃f*|@<"V#Յ413ΈD"nw(˾BC8}~c~v69~=ioPǟ5^#w[kHy5+\RY1GGu̟rǺ1_M'6377޳t𦩝<:lt\՜DXaU\d&BM4@*KD.R땥:TTbs!j5nđռi Df:TςS}P 0ʌLԻY\=RKcꪼmz8L]CYۘʤPĚM5?w :'bCقFf~b ώ,LnMGc o3 H? +!H_ zH0i$6D+ҜO` L+K)ɾJy9YsK&o)n\=<&fvV[ŝ֙5gRd%g)۸ 2hJ\}Y%ŖbKӒ 0rFst1}~JtkJ$C} DzAEhgc%9Ӗzn~AXH2$أ[MBIϢI{hn})K֮;o[qZM5) E>7u+NӸ_c>8"E{u R:r%]I\ J= @0r&&Jdg:Lb)RVF4Cv-H!Թ|7sf]kUpYǕ*䜙5F 4e 2d?Wa"L|̒.<~-.tҖ^V>G  %0Xu:<׹kEYW#N- n\ۆXHV?lYң%BL7cl9i.(xb2;[-qr2yaY!/&Gqn*.z[̼VepȱM\q&lY~\u* UŇR">PBi`8Sgdc uͭzPXpb8Gp m>ʇwwrd/GrpWʻgo.WZ:[:x[b*|-OQ\wE+,ގDnt>R&W\&ǻn5,y+b3>+:sk/u"st:#@c%qoeTd3)IJ3/7.`+ujbECGgv,rBcf.uhkE'j0sqwsswsswsu p\A"%yz e_l_?aدhu  o<Պ&Xd1K0%+m^A#=ϙ;):w5i: JnkUsN XR?`IEEw{dׅqqṳ@`X;Њ|xiby ,{jV~}ms@z_>zۼpĮtonڍio%D7m_rSD'GyAWQʌWOZGwbPRu(Z'т^ ;eh IE4-OWզ?m;{T :8)0ŏkpe]qs +ܤv=>|v7>S=<{+2s%2]8PH &4tv\Z²;/^>]` jFe8֠V*& _E-[O[|ᦸr& ۛO&8遨Ruom;V\l ]x͗@޵6sWg|o;`H2p{XVe75*Rc8ZR* T{Tƾ;JZ2ĩu}DmVnX6f<ڌW$ !sao͖[0YRc{뵒Num^'y,žS,a'jٶwv060}_`4ߤ&uq|H:{[5럝gۢ˺S龅GTߐ t&\^l휯yV,6G7i:~\MFwXwbٔ+%+s@W6?u }C<q|'0yuΫI˗udNYl鸃ȹӛag]7gN֤V֌[S{|ìE&,-,\9ȅ0rUm7ڄ.JX{  fRDĥSkhi͆Xq"zo)ele/|=GBѯp[#VhA|9"7>-2ΫΡݎsj#Y|OEΝ)HB!1p@VbdMh=V\\/A;o-|}VR^>th @ _4I#2=ȟ 㜅@ &>.W<,SQa 0R6ҏC?.<\HV,,ç_B _hϏ| s!VgV>3 RSN+ _5~$'bJͥ"A5 j]aqP~=VU(O/5;zp|qA>"CXL{;{WW'@KX@N3@ (QK@K@ @)hQIW/8{YidξoPѠ%D f$1tGy sqa%QK@KHZ9^&rt9;0 c0rr)8A#N;vn?@H'xHG8q/8\%@ @u Ɨ֪<dgʊT޵#{ lvؒښ ӥ/ޭI`1ծnj,z-ĩŃ]7 ;uKd[;O3W W {3^_㮔Ëlت˘ujٲkBo5? ZB/O$wkH`SRhߢt]dXG! ?ϻi|&L4gwl>s </hIe[ Ԩa@`΢Oӿlצϗ!8^\mA~zr-WzylK[e }&Ws1kVN!ȯIc^Pak9#jڈTL.LxCԫk`÷ ǹ&!깹x޾iT!˖dJ۱̈́ȊA`&ذCTލBOY{lX;S+8vl?Xe#5 2`$ liTwZA9_#QǧzCiNP;1߻a3:K|k?ebu2g*:fx<仑m:+]hi.:yݺmMhtSUڍ̼wno yfK~qڗZt=a"ʾ|:Nwt7}‘ 4̜߰~7f)wګOVO?{8A `<9oi9lN/$_ >rzü aQx$pe{lӪK!d}7z`9tlHE,>zϬUK&7.<`ED!KĄ0KˠmBl`N Y8{sخd >/t){/kx4;n]qjs! YB/$tZEC9GfQiWnޟEޮ]MBd"&qBhbna.}>ޜ pv'[~pТ|}?s\f֙?*re"|pzC~jz'6NJxI?t,wʺqq +[>[664\?6An;:G:Wn3ݺEMja~9{oXrc\_=s?[^MB!YyȄϥ(~2rNZPߓu5F2f^m("l: | U{4ߘGǟQ6rd5ڡZƌ:FJ֣ kj9IDV)uHw EjTǓVy@ͅV׸GVU R= ROA-(32Rf^plغۊth?vj߭6؂Ę|=Ccf[9/xc}5d"C_քM\`{fC+ߺE_ˍWbg; ٶ#dob/<@ 2`:+ v%AI.mk#ډV&E1WR50o0S=kbv- PO]ԍ gGK4!:00$+bKQs WwugiUu(` 0müX2Y)]~:u 2UϥX&hp{7-> zqi58% [S;X}_ Zʁq &M{kt8 uYc7HlKK^ɚӪbҪrʻ쫻NzɧXb+KϟjyNkNnٺݚ-ZXg֢_%EG9E9Khvdǻ1.m]<"gk@fʦ\M+I6xE"!@u8>I$C/<չMPx^B_^ dҌLb C8fG../;{IǶUՁ߷_lQ_ =xɉn^h2kWwb FK\"I=:^ک"P|qauzlU0N.&brb;H%\HӃxސP&R*V?1^KRj{7]g B?ň3K,%S+7]ҕ1ŐԳDE~ &&Jdg:Lb)%RVF4Cv-H!Թ|7sf]kUs-ʳ8kO帥Lste='/6X9kH=nAڐm+M1L.ⲔLqbԆw{Lf77+*䜙5F 5A&@_y],JujQp6 B#y1`+g-KzT Y{[jbf8݋R:%֙=($i>vĒӗaUlf]}a{7;nonhoA=;z̫kj]9O kɡ(%4Z 6o2) #I ?%*aC{/^eE<IB ŢގDnt>R&W\&LWQ KS,{kMJ;ers\\WOYKPs<̡׉ȋpꌸġSϔ$)ͼLjbI\|ԩ >h7Q:3sC[C,osǗdsM;^8w#g`< VOZֱ~Ct?ecgԑ(|-zZNKx ڕN`fMwNXU;C-aYz^\qÍ9)n fZz =ÌtγkgΘߥɭ|Y{o.Um5XZTH$|m$cl=mKƳy}Ћ6lo><ȦkKyֽ}XwJs=?'Xw!kw#?m8Cߴw e%gn8GkTZqFT"A*c%vi` wfaNya@lx~k#kzo̞tڱ{@wAލaNP/~9oޝlFb @mڹتKڎkE]0VEՐ  .tRnA\tJfYxqјg6t8X &Yҝ/ =yƃ+0 CrN=ѐJ߻[QZhĤ_xcp~v3]Kytmsڸa!r?=c7Ry=ǐ '{nmmشvCfo;Oݦ,znKN%^BYEVoP͟dt7o-q_wlǖ;kk)pK=vȽqhee=R꿨*?DG***%iiĉivd/&YM|fa Cr=e/{%{ơOϡ~ߠϿ~𑷶V7ї,;}7fW֦/^u@J\NǏݚ?6.V-m-7st>vߟvd>7,d~Ժ)r*Q9~+y`vɴ]M{v.}mڟ쌳ZΝ?>~S͝euUmT ؎ ת[n8ӧN?KÑ#Gz(ғԵ_W(^{K|@y̬޽z-($N`ĵ覞ߟYh\ua$$M` kq/H~ @?@$_,!~He YB%\;~ @?@K"v~d Dr .%"/@?@\K%D_ɵ~$K` kq/H~ @?@$_,!~He YB%\;~ @?@K"v~d Dr .%"/@?@\K%D_ɵ~$K` kq/H~ @?@$_,!~He YB%\;,G@z_} #uB%$K` kq/H~ @?@$_,!~He YB%\;~ @?@Khޗ(@?D[rs%@?~@?@?Ee)jIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-managedwindow-running.png0000644000175100017510000023314215203313266025077 0ustar00runnerrunnerPNG  IHDR`i pHYs  tIME$S IDATxu\R%!(b!6vw]ݞݝgq6gݙ?[QQ@^Kw^,3>|y`' 2w N$"RX:8ZH2a%_>d!<eӦMDԩS]1222$$0RJ?yɓ'׷n8rp;hD"2o߬R ѵL|cxVx ,xMOjPBѽ>wl2zPKC4olyGI\qK eɭ܊ViP\x{voħjמŋ}w cUJŔ*znxYP)KDž=rÈ$=ɬ<`&þ༉m?~Cu:ݓ'O[AxȽ)<IEx{Uk4'Wkj;DШ5:ч{4sLG27i O$lPR",YwW_yvM.#+  wK$9rpNŒCJ6ѩ'W̰LJVoYy*,}s Jk!2YB} /^|[?uN^gMxw*b˫#Ϯ]yⵖv.^!~:[8(ܤY;%]߱H\iLA_$pLYksN{ztن+ϟii[}+I,uDsGªVAաK%޻Q2->y-ȾN@\M7oo܊jyƶm23yf:t~!j\r/_%"++e˪a1U+@ň36uAMF#dLၲdLe0lRzHfﺯ1Dŕz~}~"ӟU/0fr*%dƔ(&2]rڔ(ʴ*Jln˝cIz˴-QĉU Om*Vo%n۷o5GϪA8{!9QLL̩S*W/Bxȵx3Kbo5lV}mSWPG/扈1F$h:""^̳i_tDIoMѦ''X!֨\ɠ+ cK`] &5z"">6EQǦJ˺i3>qb {.}V-ճgOV"^z~MLL~ŋϟ?'"EϟsWbope=DaO}u _Q";+ EjًK"hw+\yܭCBfY vdYq~} ^8ol=CYY [ӽ7]ZL$$q#^j+ǡAZC?_5~yyyUP8^㰰0//f%\E7|dÓ[$^ jWZڧGW:īf)+^HzǶћkT hYJi?ҧJ#4DVz[ym^ :ӣXx͓ U?}L_ ,"7)]@$S>f*Ezt=Qg$U%=L18 9^}}}={VreuիWDvvvzSn.~"S +mJuz2>v5obWTMEz^]UldT.LCѳ[>oQўZTbܫSA׽;m7+jO[/,'~ $*\;Eq!*"Mv;zݰwёDr+ aI~]Q9;;TIT*U*UZN֛/]fMR kjT.J" zNQu2\*1AQ5zFKMF/ ĄQ\$J#IJPH05D$DybzZ/KyCLff&7efrQ/ `&Һ'Ȫ! UZb\.NRrÇZٺ90FMNJT&1}3mR\܇a%*!.huRB,ϨNSg(~) q⌑&DN[[5؛/ |_ < <Gv]?feebbb )Cڿap@x [@x@ipEoo;3I4IucVj8׭W̓aK8GKj؝Οӌ_njAw^;qhٲy+?P-]}Yg¥g)iYwdZC]*<'*2vx'GG sBxȘo"ua%-۰~͈ۧvۮKͳ ;iqeI9x#"!uX o׬X0KEedeҜѮVf $0SH 8Y->kk8cZrLJږE:V> Nq-($/33 zK|y'<ڗw0w ML͗xχ1b"Cy qNL%)[mZDbˆSwQ;W5#ӣ$^,W("kխi¨WS_s iED;6JZ9Gsf|mywWups~ [.NH$7x=/xcܱw/:/ܙƟL}EٰheHHi.M[FDIMgԿe]^92E'oXx#"e&2^-扈8k7w_rBF#Hgܖgq:7<ӪvoWD S GD$wQb҂^}NW*WlzՋXq~T-I]EC:Ԍ'L2=zZBaiog!oΚ~Mi{yA]|qMwU\LW'-5$.:x&i3D6' Lf)%2l^nĊEUNys+p~aRڿXR v|_X"62\RTt="#k 7wwߵo?,c bޟ,VSGU\LDe;o;w _ԋN(1}x3EI+Qj0b\{VkYya^SW'q@d)AƒL{ FdRY%--+!G.%1Y#0!%)I3玟*jtgϒSJRVo_ӻK{7,T$d.&.|˧3(izee)ً[Yɚ,=E{;\kٹ@dWUM3'ϴت%mq\Z;]17Z,ōǞT5$C)N8ڸa9ףDNupeؒ EOU&aϦV>yiml7!DzC̩1m>$Cu^\7ZSҌ#h=[giն‹DDB{ֺxfe6ƒϽ0V>7-lE8]ffi@^oYeԜ=r+7l#fڼvfW4`@f.ek+ HJEo;|C249GaRNO9F`_} Owϳ֪^ ~d\__BҚ˺iA sHȀ?wo }wЁu™5Q?j2e&o-g/W>n jebȽ?lFX3{q׍MFS-^.Kc Z^ŅGWzGZ,_qc,%j&qmlbV?)M಻#g: WO/TD~yǂUCF[[?8YҭUzoz[}C i^߻xhٖws#"2quLzJaF;ϤG/n,8Y9 2.sw6ğ{[i SoFx7-:2smf}%Eo~zf~$k"ETħ3OjbAB½sg> 55ydB C ',;x;FP~f xpiS"}sKuDԧve"7x,ڧ[n +3MDD%~*_eGe"oS1wKc'qMd[u`u;z-ޟW t%sgք>b"b7_jP_ k H`Iu3u{y'ƥ-ejDsO/;K_PذW<4{9$_ l`\C`n6WE=4pPPIO)"G?d\Snn?u;_5laK~-%w>;'ۋ"ǀ%ӯ"uliH{{)-rhBJXi3U.<8ܻ!n侎DqF"\a2fH{s /"Eb]ԷÀv%OoŪ=Wߨ6.^uY951rfؒ>ٙkZ7XP܄o5lw`E+ȷwA<V)QО/XH%?"յOKMMHd/<ʺzڨ\2ǦI XqMEIĽU*I$.ULT5\ǟvK$.Yyy|vCzF:0Njm2bK}cm3R0NkѬ_C].̙}Ʃe,ZdmcwQM͟lE ybOqoc榵+_+0pxWV*3[>8gN#ΗZ_ )7޺pȓ-_iA 9jrWr,61"F"҅͜$k6E8ul'8""^iu*Ǜc\Q\f )gUh5[U)uxHnĀf"o LwhT>} )lk4<4ND*oi_eD11&9o5 N~26wS;sxYhƻCG[HAdWu#/xWӉ8Y{4!X<82.9^415 H}~Hcًzus X4ޱ]0wX rK+Z2$^ϛ֚ahVE2|vlua΍ggk3|ʓ>OO[W&6 Ri].'uۼ;w;ܥٺ _J:-d,,-U'.iD5ތQa1q$z"uCb2֣X]{K {'wr p}|orz%{)tp3W:{Z{T5y=+׻֭8!H}%ֺn:*޳BٰݸS@ ӔVog!%eC = p w_.҇qVHQ 7N֕#A&\ѵj]{p`pc|~)\@W΍M_^?sA.@x\.-Z{Ve_bX kMȸtᑿ[iۛL36 ""쒱TjC94u ~#?5Eck16ㅇ ,qiKDDF6vʟ3+˸"op ?"N ގS9É7Wm^LF"+bp@MmݾgDLKTsc8N8QGp8Hd(іm5/cц(bADެMM~=nRv2>E^:t+q vےIhD޵zi. mYy`~öoXoY׍Y=+ ID:3e[@*ImzU!ռh{H>:ڷ9#[q%.6 <@93'"@#c6ScFd }p#g1[gO,k ^ [!g1&| 9r>!˹r5 [#0+#sg@xܞÖr 3$7'U\\v#q~b9dg2 !g}6g}As=e6;->R>5#}pYb r5 [Y>NJNN77@ڴlعg7*rp`7c@edHÖ> قaKÖ> $jꍔoU@_?_?ߎB5+:5q6fL>IUDD5/t8r- ܫ?>|o>|˾:|-X )H4Q9^0QJBF!բ,RTeSn{9VqPW_4齶3nkHl]޵]L&ҟȦ15n_WDsu{Nؔ1[UڴT;l:ovn,([,uu٧N*Y΍j31 pd}M[˅=)62,V3y/^X%#~aڪs'""]đ18ŵ>RdμʘY߶u4WYV߲ ׌}o^X•m'LlQA7_2oa;{c'ۺgǒLr{T5F/ZӳFn~&"TTna;|I|wU,^rfR"D< %-*A`ϱ}*cɑg!:xyU=uU+nJ}ËU صQmDGa>2<xN0焨,W("kխi'9;.tI1QUܶ[D"S &POwZնehWG+[0)a&h^%x)UEI.*ʌ8$aK{bU0Hl塈~:Rx-8TqV:w⎅FiaJ;og鈲umWkh(@%"⤦rcݵ-VJ͕):Q~#[#( x[v)gm_XL/))9m`YFeGw~RRRkթp0Ö&$K gzrLi$fʄ K]X4}k+Wq1Q_fgm{p!v +N:he :Kp8fa/v+׍Yc>K44u1UV 9onTUxl37/n >vx@D$^Jci"=o>x4j^DDĄ^>s2B֪'leO(\\L9ש+f{~;Ga@ z6훼ʥE=AP^TvXULs $ ZURF[Z Nt.‘}V7͜pd^^zt83}!MsԜ=r+7l7>թk?hVN>]kzy'=Jݗ&p;b~gu.$'^ҧtIbt_ݘDILH@Dpؒ a/Þ= 251uwsw)P&/e|[ ۧωz+vx;uM6y< {*5V\+:&Nyc=;ծO ;ܐ{Ö=V̧FkY[x{y߾{;T>|{[JLJRxe/^TR6*/AbkZ~ٖ8#"zcs?z,**<@cζ$rG/}NQAx8l8}c属oW^vQ;U2ɍ]g V/iWO6x ʉaKWg5-?ރ<2o??%7^*zYu}\*-=7qHx{tp <xuJӯ&!ĞШP5cijt pkW1LLj}Oo\՚G[0vPjSA@_6\~՞":4CWuUaE h6wo`k6rnrG dCz =1vz˅ K~Z {gj-wRLk[ѿٿ3jMu}iin1"ƾnXJ/Evh2ýp/g;pD=}]~D %GG;目ʇFt)= ؿj6q&a93*J#4SmيH`,^cyAVVVe!Dl{6gi&yo9&?^w. RclH@DzU?tTߦB$$9}2meڑWZ<\_Jo[(?LeJ8bߠq΍heCwΠ}{98Y`Х {j/]7[ˇukϿQ1+.Fiա̽{gP _?{_<^ cL~z~&lcL Ѡgh۸ݡI裀+ؓHrr?^ N:z{iIȜ-1u+i}mR٩Q2Tmy'ʱʇ1Fëwɪt/J/M%ٺހ־~-9Q5k;vDnWV.Ue7H<7Y˅w odXp>6dDsvmn[73m%"]-4kid1l>.{+<(gf[94gx$n}A)} ;?_x@ 6e^}WH͎_f 4jz ^oy'[y0s@O1o8m KWdn^6Y}wלſn\݉#_۩[QW8D8hN;weu#:Owvs;ǡO?}܂g,?YrvS3tNuX{_GE8,!OJ;logq~ JZrwvl}}V5,b -.[*WW>{FL`CG{VgMgYPͺWAM u4 xBDD^}.үo.mc$JE&f ҽ8GMK㈪v"C%F5m!WW>y6 S[u1^( P #Xd,Nf!gqγA?'Jm|p\\133ueǿ ٞD^6$:qٕܣn5ڶ ^RZuH(*HP6H]) )N[ă8qIzWN/0FH Nqeɂdk :"4wq0:Gilqc)A N]k.vks~]ҮVpb0\)"Nbk@irDuA񞗑/\'p Kk(i 7<:}ί_ӫfRaly='h§7/7:-9"T&"JNLPg>$k<{#/^>r-lRJiD!@)+[&/3>ɑ>GVcŝ{wjg~^}C-D鹄2EaH L# y_-mpؑxӺu, ?)<;k9os{Ts*A`TI]oa"/ 0=S^t:uSo+.|qPjÈ#bLk92(4d8?^B&@2.oG3e6=ZWeXeF-I- @,uEzDRNj;|fxHѤ;81A.>,㫨7_9:lIoֺZs-~љa6<"NpdR-4'W]~j\-_9ٵxAZp LԠO :zM_ ,1#A҇-e83I~=ׅfNkyy7Ҥ@_oK11g4}tPƚW:؊=|,sƊ{IŝH(C MXv7*mWޡn {f["1Ɖe&Q7lNg飙RKLSG#҄y)7vvzO,^|8Bޠ/~[MaK+9r>_ fn$=\8֬AB.O`3Wt7un+ϴ[>XžN]:4h[aኀN[_uS4Rfb'/5qdbǚMDֵa KݛsWZ?G"+[a{KH_ݽ%TgY{+Y>̳q-ˑW5k],2dp"e3􁠢<:e2YZu#sͱ_T$]>"=Ye/#D:H)*J?YϔEڍuWӶ@?K!<e>~{6 v_BJw2FӂlosN NS˒׿b_H75 mc"5WeBd;ΘbxM_#OF5̹ 'wޢ nY[EbI=:UjæMnn\A8nn6?,b8m4$rh“/|{F{yl784#e8ψN~ty fԭk1eZUdZ mYxYb_aB oUmظإ֎:̙yKϟLH!?ACv̸@|tposȱlӦ5^n{XF%Z\%Qf˛E&}) Eׯ_ֽxb򕾾rRixsw8;udT IDATM6y`<}ҧF/rJٲeT*{nZuG*{v֫]c je z8 gp}w!8#SS,oٖr?2J>zz>/@݄,öxw8<+`Nȑ7lK߉V=rxOntZ3bL8h3%' o%?>zK*M n[DBͽ+V;mֿ_!HuiM'L*׵N~Y9rmq:(dUL*W8tqJV*=Q~~x>6zoC)7 |kM5勖["U;+⾤OqyĩKΈ ^FpU{ ~<bgruq}B.>ȵR)qqnn|G|rT*l?Oȃc6DD)O]Rѡ~q <7ح?9yG\qdjETؾåOv.x̓|ug(!!.!zѲ`Aw}|㲾~aK/_DDFȵ **\|%q>2&<Шt֜"$;/{) ?z"/9o[y9s~<\ރwIPũHj"54FybU:Ul IM$xbTxH)7"˙JO9jq*'%2l k8#Eba0sDX`|JYWFt8 <#i^zUj0fI@G|e:L!K:VｰzV^CMÖv؁O;m۶AÃaX.,;;Eٖq@_ͭ[yyrŰ%\%<@^ Hm !qՄK!̶{ӗ*DJJה`ee(C:;f%#^;9|M!KH?l.|2%%G!zW°%^ommkƘVt_,2t_ʄ< -*#?- <|:ÖVZa' <|~ [@x4t8Um ߠԫIaÖr 燴q˸-f΅kPQSn u:-1~]}8.?- <q(%D=|/w?+]#l7{^C-#RY<~焞2"Njb>lP!Bl=r%Nd߳O}&,YuDLa뮻 ,ZɷּcVV{wՆ4OVwm7(B  Կb~ssNyVM]G_|־_<ڒҌ/\D|?i=TkZEIg}fSKNq C_}rs˚_'Kb %C"!ywl_ɂ n瘴Ԗ}r/:eD?wnܪwv+M"[/>w=~'<<$Kƅ:ԾG޲6g|m3RvyճViftqQĄ`VesXS+FY*/W;U IŎW+vQqaxjha`_Kz48;Xmf,U_+ wEMvמ;Z)$i[/@x8XٶwHTzwww+{ltw""Ó}c`uO;K?xzק[wMM(J?֬-/}AUP-:v% %wі_g|m1Q@x8cifeeDjYwE/+U:K Y|+w%:ޗ#?-r:u ?HտmiY>?'\p_~º$¡ur#jH<ë.'!5ۑ[Z^0t]$[`YV74+Ro#oGNnNBtlZ3GYEyNndgzs;-p*?wQDDj1n_/;=jŁrssSSRmv;4\|[nn7  @5Rw:R#n!}CiyizF[UUU!qOEI?M|ΧqLU`LjPGs!E,..vt}X?(-cHJ-^4k59ѡA=VXELez=>dՐݖ W9ZRB^j80#<(OEEE=hCLLLe~ږ૒C,>OnybjYz:Xpp^YGZgNɁr恶%|n"ޘGmi:E^fPX,"ZYΏo: , m_turRkLfS.aL$ #eyypHYW.L(.|0jxAJmѬUMQDR;dZZBɪ{ߦ-=D[E$<}|m^Ep V+}n}ܿ3XU; EےދL6N6Qr2T"a! Ԓ}ZX>0rM?Q"aa?[cõ%G>(78uέDJzi*mK;>`lc (G8B*pZfz-X4UEQ,K3Q("'DU,EDc̓%Izҩ){6s`! U7|WPFA(7^@jUbJTʋ5r[L\@jJTʊ+B-/*&QVEQDQOưԱ`:9vE˗ެ\緰s*0DMIÓK4 Y`j6djHT٦ Q[ػ.DZ)R}M%Z8T|ژΧ)q/^６zrq m E}Wnտ?П;LpbHB+,7@x8jY Z-Oʹ)?4wXy/8)+ܪ 7HGOKh?Ĩ{>hNⰦ{|NuO[-̭i[dTpŖϟp g?6UY$q6+< pV&P2Q6xkyc;nsw{n<"MMbz=W^bKrwjo}?JDDp'OO_Ò;.}%QMUG[ǟa˨CRH7# Kݳճ+Gt'39C'xD!=?䶃򷾿'۟{\* 97q+4s:Ai[ jXq8T~p5ͦ!$$@8U BWAiT4wM~AkxnfmGOܩp ^<7?͂i/.mK]F~ NG4)RCS z_VAض(-!C4G35lΡQָF xlp+55QQQ>3H0**ʛ[4, xDP` !Z`:~X^Cm;r0̤pێmi^mK5bRV0 "}(mKn---xFDDDfzfRR 6Ժuko$Ӎv3Qv;(=7&B;?<䌌 Li.˛a%f DryYe¬h[.#l cgZV67.\!nN:oZ啞C̿0cKroW0gRu2 <nK~iohRou+fmSFf:!Z -#}n͖*ʹ @X'@=M@taELev]Ц3Oe'3oж7n63ſ%;8@x0P!TW|Cflm|2z$UCOB HX"qCD4]=g7?!<[\{sٗ|Ah[ {ަd'`y(Xxy>1'e>D+:ows[Xc:|񕣻' L8!9+" b5L1Wx%lg-7>H”gF6C|Њx~<Ojsfp 7AےiuVY\~pmmO< G9 k\FHǸ/l{`C~*Y'{uw{:s\e}bw1g5Sm[8e_SZwۯ6x?n*$2놴XziESjvu]ä(Hzwlt[yivWijc;tn;LD+2w}nWdtcR7~("C=.%"Rˮ,_Ah[ IJh_mfK|p|ǑGz\9v=**"JxV1{՗'=}ձ?|z2q҉^}bwϽH7N{`̲Sn|GƟ"<:͝yaO_t^\VA7Lkޤq7evN^]XӢ%o]DĄ)_[#/-+TE_M'>}cj;Y,Xx<v[cQ qу#4(UGmdZ##`g%w_hm%$#kۻgҏk7iLj-O?8IWm~u^A3s;\5S-"~`.׎3 Sۇ?/&b;GnZmrpa0)gY~fz䁱iz渳81uս{ާ/dAoiIs\Gɯ;?]d?[FwQgL&""anj۱|GE$E5A-EDlG6.Vq֛Ͻ?{k)r5wOlalLT*J 6[ح}s(k,YgUCD4=.M~+MDv%":bz&v}pWѐ_Dz^['MrJ6u<rmu~s6i6U$WAh[B0١5eQ˚N qcW7^[Sh)"R4iÏM|4Wݪfq8fPi5y{}ŏ\Ȕq7~w۷^77ʧLƄ|S鬜s:k P)_=J"@6t2yP-[w~}#?glkGtU=YeLYSUEMDĞ.U][fvZ3InPVroGi?DgRImT-1:2oF$Hto_GiX?Ka@g'Fg̓Gxk2$u\q96vz''ꠌ}}?m~W7kItgiw-+֓lo=*[us.#hÂ妟y{i?I78NRvu"{u|3d\ɶiьuVp{/fm ACx+$5ۻ0r>A!Fy'*R {* .ߴo>}"QMz3α#,Χozc'O1LR;=klJxbCFs IDATn/O*g4ٲUU4Wm h@5S%NQA."H^?H\"{(~f;GKB[ޟ}\'T}""2*q3nW<UqتTq良> k{,)_1UfM<ï>4l9'twf5?]Xc.x1?*v[? @=pN(P>~:`a --IX}>t*!Q \ @C3*) K𐛛j9᪨rss z@ˁVzȺ9hâגW-Yٰ.IK,gϞ, ټPhB3J1ꩴ4=#ӭJi BQ32s{mbU9m (V{u[''X7i3~=vhn(aw# %"2ۡja򠘥mI [K,E܅;kj> z ъp E4qb%B#Aiv[%kk•[vظlʂ-[_)lmGYpE,foq\z/P(H~V5/ XxpMr8kJ,Y񴡝,"nѴ'oq-Rȴ'wL ` ,f R͜ë6Mےؓ:ttxpH{U?q8gBKO#_<Κ=R/v[Bh@r_)C&"u $d5i#tWS_i5+_أƆ _oy_Ҋ7s?/h7o>udh V}σ3&nj;-8ҴJwmKm= ˈ]`O>ggZ=<X:lpKL(mς{oGk﹮yɒ/?HD/j&"w>"DrẄ́C8YtEz~\̛SCE1vmyֺġǜt\c_tgϩzE;oT^ZбC:tl4ֲw7-rPzwåwz}HE>6 d=f%ƒ˃>TKHxl~ْ۷[\*rf=7qv)vߘGg+/c"<ۢ}BцM{Wj5,Fm |_{{V' ʘ1m9g`p0{q[g}R]arwYo7rWxМAXw3񙧟xzs?R۷Ul9S~u20Ӯ?^y !jU5xM0ka´oQ\sOLzE$E[jmY{8~ˮ /EDDڶm!_5%N{cn%mepU70˷<-#8~pݖY+Nx]eNlKv,TKg廉vO|rO-S{|Σw mnQ*IIjnqX]I~S5p˝TqoŽoT./w-`]aS jWl1)Y1RrRɊ78%"%+#!L.jt^wX&֨(q̘6ؖQёQѕ7&Y YYI^\\wpLlI4+vGo)_W 0UX]9 ۹胩[F>RQ\,bֶͻӶ~Hލ0mKw3bJp)wӏQĶ8rH6KD f|WEngEm"^xp^Deu;gK)ֳ A*?mKԛ v8߇/ZX>@A5Qx&B'hѶ݆˜RaaaTTAh[Ym=#\}2,Aivl+,,`Iaa22$F>8u5bCD `TNQhkP.%Ģ?)n---xFDDDfzfRRnжw T n;999##5fiZEEvh[xJq\W0&pX̜y9B!ny@+|y\l%,-P'Ea&ƒZىmKAx%dX(` BZM@Ѷ`3 6:BR{hݺ5s8E @pZ h9QͩmK/ږ <:B9&@Ѷ}B, q|ph & -!ҩ3+Fp;:E#Att ]LږLJ bByж#cswNYzm<@pt%G <жd"}wX:󻨯!O 60&B > ':?: ЂiMvض}[qIq( kTdTfFfzjR9ORy՟P)a֧!n%%.ay;vIɡ0vZvde08 mKBf Dmq0quX׊ՃaÆCZG_yfE x:VZspp`|nFGF8)1,DUUդĤz!U{m_98-5|4l_O#%YњedZ VYU?zmKа LྚPР[=80D?6P槏O txPD4MUՐ ( s1spֶT8bE}y06ҀtpU]ƒ.%*ZUrۖ}iҢmƅQt͘US@x=9e_ *Ȭ.wťF3ࣶ%O콭ǾMm""56ejm/{Ǭ~pwH3]SXz=[fwVMjᡞS^uӵ&,Mbyլ.LY N_qʽ:c6⻟KGrmꆡW~\4M+^XiZy^2t؈AUl|O [γ/.4ͽwԇ/;wĠage9e*/WKϙ]ŵ7~Ȋi d8ٱȁ(F+ݺSGv^Z$xV5sqjUOU돦K&֦׾[zbǏd[49:YZg'Ύ<>z㱋=W˽\.*-5'KWZ_8: +/‡_{oy{3\j8#"}o?.iayc=')))HϋUOwϱ'[J79{yO_(yBPƒԸA#?M߽yKfX1)o^&ԾT;_[=Ҟ7jh~;Oaf$g|YY[~Z}nx\;+-i>8y]3Fe.WqN?e/?>[D?ԽWd21ڮX¢cb->ϰx">?s=!mb<Eb( R寪*5VQ\R5wESrW5}j'eTUD4׾ı kVWŋ;ݖ|{ojQmNͼ;([lWd{iK?.CfYU%,:\90Fc iݖ\{5Z{1i2D2! ք~m^٩a,ٱ!_#UUADTf;vuޜTDŽ筩Qhvk֔=tn3{ՏZbޥu gPٿ Vgٲb)R eH6Yχc;3Wc8˾{ע/D>>5nJ JܚfQ+*T4kjT5{44UsmRԭihr&)1MGY+q*/)iB y4MQo4r}sF]D|G_4H-iѲuӶYrJF+"e+s%dMD4QͳGoC}'h-\u;deO_]3ιW󊡃Oqs8}RBxP7+NR\tڱ??˛:CH{<{~=maK$9x.szf*>79wl:|7g5x梅>kh-<\8mLI_?-7kKF#v[>h_-Ea];-kJN&qEKWo]?mBA))}"0GxE{s4yA$-&-ιOHxSM?懯g/,v]dl~ٸ!1qs~fiV)?}*1M|VjjP=8^^ cyc_^};O{.E7hqm^G0.W%5(ܖ+ɷ7&8lT{9sfťP|P\mz2<5Rܶ8tShoQxFmX}kE+k_śT.t}o_#GjaM_@$eOϧTJ|sntNߛۈrO{wLHDw>?4HxA>3oj 5n%G?AzNږDb~ιÛvvՄ tol=ڳf]Ar3;7HI8Wߩ{B+ݴhIAˠ7*9`vnK ?w˲i3^/iѧw*F!ҩꇩݖ;Kncbs~r~΍[2]wg=1%""b͈Wܶ% \bnUfKhѵݳ"  NtDqݚf,vo?H:^tvzp4Oy98Ak[*Z3gֱW^/,퓣*+4k+ԥIXEy{+[ާ]>7s k} -Y={4p: (o<Ժ}|JRlCjmĥ匛98k[RvVH[;tڛ<(S-p\.%nǷJ齹w=&3t`8\iN:Q +ӼCdddqIqxXPE).)l4kl -īι[Ozvy;_uؑ5o\D?8o[r׌wk-']vBfZq3wrэM=.rV[1XíZEI'[tLԥ@7_6+< [nxIOa--+ݻoo& Zږp??qe_U{Bzt5nwZl=KLZmEjjEyŤ2 $CbB۶o+++ a LLH϶B m)vٞdʈm,]?.\#õiʂ-[D{v.bf:wỈ-KxR:.@x6:s*?Axpݩ)KH^媨`p@-Y2Z#""kX\z5͈j!tڿh♟)O9"Mܾ=ψS]sR%*gN#; "RQQQz118u nKꞹ7>j[zr×g5&I::<8Rx\HpN5Aq'JqtW~y<)"po/Hw(䀣WSdNPoՋ H%2)cQ]+30)Ӫ4_xVH&}a@ֶ&cƄ+N̊VXbkC2;1%.h.x!{a@$mK8>aޖfDjP<]K82` ub%<^Mcl5Xy>5zN ,OEx)h-Efl] 9$ԣ= |R§:sHI2l>maqpRg6@ nK1__~Z+hGerL*&,2ٜU ,Fݖ*rtڿe3y7&b6)==eW % o[r-"%떮)>*,([0}  Ex/x;sw-3vԳtLЯT[XcRzoy!$9(}|XS@x@ |ےwVڲ♨H@x)h>=&'޺1nB`BR׭)ZX3E[9"kt IDATfH6-?Hۖ,Mڴc<;@x#-zcJWOc~D qL> <G%(ߵk{YJęC!<Pw~@-Ezokٵcޓca_:=rX!@4n.qC+ȗw(|4k{yX^b`3Bw8xz-z:@xx%u/qW-]nC9 @@xV2qht(tFk_Am|%/ye7Yxa_Y;С Tӯoe9#9,*96EMc0~@-ŏ%X Qݖ@xQo%ԁ%=?Hw[ұ{hݺ5g4b_8ͦAmI KljPt@y?Vm-(WOR5g <%u{ʿb-U{ŝ/ψ㘄6EQOa-IyS(<nKЯdLؽ9C |Rt[[UUVo.TM2NMވ8az~3 ޡm %|_~׮ZwY2l6 +hmK8>aޖf NqPK6C3{~-){5 pwL{jy~z¡Ztkϖo޵JC_c@x|#hmK '"%!.ʰ8& )Ý[fh[m)O%*#  1 Zے%*i>p>];us%|9iFOzh@@mIJxaOm6w>|kl~!( mK{~-/{=mk8mn{o.f_Ak[rZޢwoDբ|P ] ZRDS0uMUR随_\ LkTXoW-AA߶Icܡ}ZE\30 ` III ,I=lYӦ3$Ϩ _0(.(>?OR+Q^v@ȶ4߲*y7&cM[@x@( „+o{EN:wز%kCsLC=M~`%Wv[>yԫ$|~KSX0}vAEĶAf  AHOWUadȘcV."qaF.햊?YXLk^&+xNmL˦vڏr7GxӠ hLCA߶$֬SVoS5$"+)c%dy[vK8eu)Q_> uɥ<@v8u猋yR7s+U2:;_Z~g {N{.i 3U80q~--`iV}3&GSs%ߘpQ-̙:K!7n]<-n;'ږ_Ak[R㒚4ٳõgͺ'wnުIbW4FEfom1h`{^ǓY+"PAm)5W=nݽJIg*,'DZDDJ}~ĽwլoI?w ` *8\~-rtfqU׸S++4kx aSJ]:N?SZE/$0+<@NZoV_%*#7X|H*;x{1[sߛOL%KTݳgO@x*m%KTz뻩3m/qk" r7Z/}bss(ʫTWa;0j|m+\]zl D 2?Hۖԝ]cV;!+?wuFfX#oϞ]5DͲ[]c!sQ"bG'EZ94P4XCRъi[=\ޡm_,;Cܮ&)fvv-]r-XYԡuEy><5 30oਂےVVdm1ެ{7[)ˋ{֔C(\:,«!àm zV}hГwx-cܳċ+Lۓ:ttxpH{񸾇<'N{ GFy~m)kSegGv.[r6ž +h-E '+HO|f/n f@'ߟe٬R. Ͻ20?HۖDD,1-Lj4pD+ǧ9&+q+uQ C+(mKZ?wEٗm"" uiq1!Nk6k` nKڞ>[OwǢ~vD>7k}}b8& Ѷ dR_SY1uXR/7uym,}sݠI߾D<h0kŘ+mK9e-uIPDbz\w ni76@x%S+T׼rɉ8b[vQ pϜ+l""̓VWo <Y#>or՟e4WCnD|BA}$ ` l[]a5Pr5p {n`!DȊBD0v[`jcD>A! h[q%F3E1M  P/-0MM0&I@x@m—0pdL8e@x%Ѐ -8wJ`/د!Q@ Am zBR{hݺ5MPq@xɰN2.ږ_-B =B /2?mKh tp;v'<AĄ(PCxꅶ% BܴɄݖ((IUfI4h/f_-H!:M~ږV2*lg&o dжm5Ԓ2s:޹,&%Hf -r @ibnCe1_mJ0pZ@ж@x x=n:}dlӑ)fcH-DžhP~ږPHΫ_L85^s$ %ޭR$y7K @x%ԬɁf̎ 2@xꅶ%9E*?mK ` MjcѶdd ف:?9E}C!Axiжm8@x0ljb!nyږks+U2:;_VuϿٚL Klݲ"y.HOG"Nś|DDQ czb%Woo6lԨ!Y̙rz;vҎ?匑~R8a5f_&p{֬+HqfqI9;uO8ݭ=:#rO[9 (E*y#402nK{wS"-""،x`>~Zu$,*w!E*(?ۖԊ nL=¦~Ҋ6WGvXdI={ ٍLGx|,-YQvqWM525,@"qvv-]r-XYԡuEy><5Ś.|ƄG*0DU@s8kJ,Y񴡝,"n4MD4WA~VZh_>s쐦v !'u8Hq}=_5=fC1lfO߈%['+mfm 64k_HjW1ǩeM h[˨?4Ԉ>*y7;M'WfvxLHU3͙oKv w`V-͙$` -hh©-zSTT <֜>6f0VjusE5?([-M <@Ah[2MT#[d:Pװq({<@p#"Љ7 ,E#: <AB jcfv Ąpс@>yh[ qjqݖ -v/""4*Moف48']RRHDw(8c_ <Gi[/jZ e*=?mK0S$ 5i}Tfi뤃P:9i#C)D^"n L Yжm(xۃB-=DQ3!.VSi:~~jvb4(/{<|iڽA@_h[~ѶdȟbcWXI?vhC??mKzS1\mQ3ȼg:_yX6mK/ږ̯ NqI)y~ѶA (?\|352yжdن`låقVL4vϺ6YvK.)pbp@`жÖ4K;+36E$yږˀ_E֭Vp]ح荱VLKSLٹ8b~ږ13qpӡ][!W9ht8~6Dc)LCX'bf{@Mid's|)c%@??.F#.p$Gl03~/:|!E) <mIUD=wm:yTϣbuf.]AGN}JK{ry~ѶB*2V@hczBRE-TQS=MA^A-163/&x)ѫp9Ds:{<Wcy^|93/.Ѷ?[̥Lw&ےn!9hLCAh[ :ȆFa%-CI\w[H@PѶm >yn;7ye%+ -N:@ sGh[~Ѷd—Wj{3A%3/ږM)=7nK:λg:fq&BLP;@0P)жmIa!}LF3 mf_-)T wq 'h=!h1[~a{x$ږ f|#R^Tr)LWq+$V<1jBk%En"ԺK'O\;ƍ<[]~_il96PߨI%< NےeW󒧹\JXB!+ 0OynK`L,@ے%*%^\DD\(qV? <B-ӎ;&lEm[ۂuEq-1ORhgcWΘ!ːƐްz%<tcBmKԶv[wqQdwAJAP[<Ϯ쳰Ǝ[,{s"?P_v) f!?gQ2i)"O qΫ$1%4^c]zڃbiۨ: z'<>}e@/]v~#ܺtE\wnҠ.30PCMe[8ٛ1D|Ir\Vuvm{$?"uVw= :AsTY^I 6Dg~:whײ "DhAV:5wfty$pԭdӆ֙~q>E&WE}w$/20tFcNx$yeP]([*1^#ˮ^]SC3'_sYThNʷKըѢm#VfvyID%5anhRͫ^54gµhmOz_khejbfa%D*2KϳMzao2bxfV|͈e* 61dPO?"gea謷IBF.~u "^Tz@PT~cMBnVj䩉4SQɚ\"'(/ohAs.It;ߕ֦C]*9&-'G~&Q@>E07|WƜpNͳ#v뾵Q=A=L<eK|&S˥Q:j|I;$FL/<~%rqKP| ܨ?Hd٪Wϋv6vY!?RpdA*}/X  BHRR]G7n̍E.-$Ӗ< HJeKHʐ?- y(&< ʖ<! ([@P2L8 y(- y(C@Pdp@P*([ʏ*Q @U  ([En}-bBdW7tt=뇶Wd#Y EGFnvm:!.-@~:(juf?IqMmEEY ~#&%r]HO}h>l8}|#iϖK1!w&ثS1NMzcڻYkh۷w#F3JATRڭ_jVn̓gKfyBHnqjccfty{ x8M)R%yvx?y? !$'hg"b>n6kH*Hj:rokߜ"v6{\BǴ۰6Ռ,mu]&_~2G[)4Ր$%[k;E+M\7\꺳q B׼s[L O"-C&YzwS6EQEv86QBhi+@ tvPj9HD_u$OPĹFT49!-\C3 bH eKPQXj=()Eh\G4lEg\6D?:=F pt4gxFRA$Pa*})/#>sk =?vꡈ,<ήn=*KaZk:<5BT߻u*T98A%B'\XDlY/G!'vFVÐ>qɒ.t)3{Fͽ+#T/\7vgb?4oǧ{iP_1nl6Qc亚!f,"#⺍Y6E@!a#^K"[tjm5ew6L9ͼ^E΄eO-?l휩/0W&L?m]Oo][ NoM]S=8w7A=ή',t8ЇbYzݵ_/3h9kGCH/dke%O8 !kfɎ}QRGڶU+~kҘgqńG!l-i/$ছ]e* 1%:.5SCx.'d)B4[:ODUz@P2d \;OtjPDk>Z$C7Mhϖ$siPK@rsp SMuڰ9Wf&lNYvhzZm/X]OW {ٖ?gah%4Q|}Yf!V uAi4[FrRrD_1:>SV,{1qH#6_96ZeZN*sȦQl@#yՅ%U#Ip.coEưw-z(&9fnkly,!*BA3oɊrCP tjvYu\+԰3$~rwKCƆʅNvYgB[4S,v$-ό;OZ`  $7鼧^sc<6t[3!'WL@K[CV1)BZڬl1@Pʲ¿e1>[ìYZؾ#$jCfDڰm6!y% ag)9K5E?G]jo/6Rgg)R?jzCFM>K+",I~i"/K.նrжr{pnȡiZ=6_oB)DNpZI<-݆G{ffY뱬gxuawƓH@%9w&d DWGlv2I6%04ZO?w1&]X"ߪĪi9[XX諱heF&sLmu9Bưʓ^Df;uY0y*Ui&i6Y@>7$͡sPm4UlpZ?v@3.\cS[,-͔xв;:,Bynv^VaYYlc߾ƆMKw?۹a)j:#^ nfr,0-u#^&Bq,Z{nXsjhc{xZoD?Nۨcm> y*JYTw k6oh([UHʖ/KKKKK<@UQ뻫KKKK B9 LwH .TDPb KKKK*/zy_-),,,,K0Uqq(Gy_$@ yU$@0TP Aa@l @%$%ÄRA2eKHJ $%$eʖ< HJeK*˖IHJ˭ A &&FFE!8N@uF@!rCBRBJj^U[JjˈcCc࠭]&:Pː<RPTwo'.>MKSK*Viij9:8> }V>)98U's hkiؾ@ 2$eKy:i]RN"8%dC_ 2$_ْ"a*RA"8?Z u\ː<@UW^eKJ)ez};2$SDaTB T]|P;.e? TWy}EQtZft]deB+s%m&ј : -n:,UQ—BT'eeK_*Dz%R >&'5WŻ}0 ɟ WHתK#uM؄BG8jw{͔:UU ^)r"'."L C8# vH\6}/>yMsl>0Ϝk+H2˖URH:1k_:ӐJw)y|sPLDU䷙}$IyOXY(P=蜷w?KӰQUDE5,U/w΅>Db>۶.%yԘ 4ceHdb \["g{2yͧB1dq>FK];wQɹ4<||PB*F"YZ}o'!hkXV֧Y_<}>ULsDk/<~' [gZX伹v僱yvdd׹I=KA)2"=Nɑ҄XԨl.!T܁*Newe 3[!ѹV51;>'z8<;q>"Cͪ)[8xڣw?uDhAYy=]}6"SF)}kj ʂ%7?PP<Hܓ KM !c\1yw[fъ&{jsu|6ml:ۧy4-~Q uyEvbtjxo_ӚIl^9]q=P˾$2_\zplԌS8$mZ<K3(!=u@NJ5뢠M{,'Ki<-:m|+#vCDzrPxR~x7}|o=ky{y9(aSPDawZ$ۣ~S8bgxIG2̸&Caǻ>5b'h8a}3jzV#4+%U#S(ovR%/\|A" *Ga)+>aoM͑g]>RQA32΍ "*%8< )fa$IOB_'((#)F0e_w FCR0QrU7L|=le. f R4BZJ'Ud%bӖOakz6lҭOYe~ºt. M ju ! 5V{e}[ kHwu-"%gY]lRӐquܠCǟlCGٿ2Rӷ7OԨD! &,o_YD -g8NC׌),jEvBEu]*6x[LP04wߗ}z{յgup̚a<:N9'Mu׳7ia l@C9ˇw^ZjfŖc|S7/y2M*Ae;kiB}^t_EN)G$eeeihT/n E|rX+[251VU%t3S3cllK *?deeT.ː<|-h4'HB|B@p~<8Qoߊ555c#R@u`,C@H-) }cJ|:Mr\&!8N@uF@H9~I!2 D~ !Hy^߳vabնvk:O?K>:;;Zh]W5[_`8 %OFqckjNq"tWN5C&Gt}̾5ܛb {y^ªt\oڂ y=yM'bm!̺}#FDZ*Զz;ך>MKW߶=gƯ1!CBZi葓%SomϪ$ny~ Ud?qc[ͷ겪ʧ%iԁ=Wr:[gnmzٕ_ !O*l!ևhW Wʉ{-'BN'+M`kּ̊g_ӭ> @uUDْ"ulo2k#O: @ Nu,8~p~ :m>6k&޾- aɽ;ߐ# JGGwnݨJgosrr؛JQTffYYY%JqOqu\k)SQ{f8+z3h}[G}_t}[48pG4!6<uymܭ5Co !iOû~H]\q,jz3<:(1lY[ϭձNñ7rg& ݲorAxm|Ǯx'ν;Y1ǎԯg"OgoI矉O-ݪ_L籢{i0er&56mš F:ZzuW/o_A#vûAN?3ZN}=;,rwjn*$z VULdqœ+ݤn'+!ɋgo-yx69Y^y; lۿa9_\dEBEq"n慑J=ףѴ{R֞=>Q~'>-{uabB"Ά}=wr(;z#obȚ4!tcyzk~ؚt?5j{72f}o䣼ؾHdN zxtz\v[_˕/i=Df5\jtdqt\jtsu4|<|n;}g޾ ܒ }};O>ܰ,!yxzwfWNu>m;~eNICC]'V mW۷~%c,ʚ-|=|Z]0#*+RHr#źϔmkzxǖayhba&lm_S x|3NvE/mلY ۷xGEsFz&XDBϬ|rk :77@ޔ]]}ޛSRqh_ЊBtqtWGs&m^C߳5fwڽo̍a{&/w[MZ6,d^+=-dl³q ";via0ʪ]PE(6EQBWtȈN6g1fݛZ[4bLFpr1nپy:ֲMQV jiF|Mֆٽ9xw'.aۖ m ObX|=SOCu-?wZmv#Vnݵﯹyοbeңg.{}q%0/c+Ѝ#'v_Ў9F?NFg^2hknvYݚ<ة>3Msg}Uj8C;]vIGϞt|JMɷw;]|z[yٻnjߛtގv9\L!t G'.39j眝/%wMۑhޮ}Mn(s(j5wl"}k̸#WlY3-0H(Kѱ\H$<M*4hXpb]=rߗ[_]]/([UHy-I"߸z)u)BG?Bj5 >CBXO=9 X]50S,}#iǎNNI 쩮޽[}&'';~䷞:{aD 'jp/Hv؄6䳑yXrݏZ@ΦB8.SVhǒW{w,rjxI}X]DyAAB&YWҜo^+onX}xLԤq흍Dq߻w pb7vڃN>anC?KHuoݿE8tב3HԭlMغG~nF,{'V*+M [4u_9Bujikks!FilcGh:fkhk +oH"&qċ='hkkQt‰ot)l~_4i=ĮĖ7ΛȜCQڬ8oDbxߕg}l¢R;EF4.R⸗ɢj5g,,M[g{%X\rYBKG4wX~hulg%d})<[oDI{aÂ+"-~B[FEi>w)uwo(e,eJY B{caD*ǐ<|8gmQ[" %yzuu>J\ܤCSw3mݸyKY?gTb1=؅cU/;GUNEO>q/D>ό88|U`8V/xꙇ~_7YpzƐnmz_jcQE@eϬ`FA+7aSpAܪy`F,u]4M!)F! oX. t{W6My۾1ltwv ucѹ T %Ċ6ڰۀQe˭WL୍w*݆FI-!UbWnipKߥn~kk?N]sܪ;w@;nc%yGL[q"{#ǔOSP}T-Lەǒ{U΅7]tYW>IEӂQ0l׶2(Uaj W?,ho"3 @IF.np [ƧO^#oL:q39y+^ȍ^,/T= Yү(1!,}uG'3WE-{6w|+3"% tU*<T~]uNsq;(BhE:.(%S}}]MAU}P7 jU4*gRØ2`dzͪZjDGee<9-~7{,o( j)NFKT0VtLxT , B'<{-JMSxU!WsdIY>&Q͉8&I:qޕlyCکeD:s>©Ÿ_4=:h6;'~h:u\h,?;OgȽiReW񋥽Q:֫ayi]g[ӈ;pA;f5ɉvW2C_l4A 8Jo~|4UFغv^QOnYMsyNͦa 6>;pآdZǹԈw%,Fs7OYlĄomQEE9}AO׎M ++_|ՖqGiiNHU;ڈmbԹ9Mi;f&rxh&ihGU"STK?k%b7cfÏo=pCa뻶5[c5o=G'maWϥ-,CƮw~'o9yͬQGE0!p;vs!gns؛Λp¨NzXI( :NJƤN灖=\=v@ z|qͼ\ݚ"7[1{uVMjeȢ?Bx7|VK/vV~IԖݻ9<ʱ! ˱mרӥN&r{@KΫ=mM9JsԶWڛMغh/+uK^>rj;gvh;u9f>mcI˒<\ kȞR,,`bWB'jCέ;u|{Mt[]PA!!!AAA崱ܻۏ# -#R6uxTGϕ=@BA !R\KVܥŝ[;dcW?<Jf;ssϝ9332O0Z|~ ?8ط· r$^K?; QO] Y/~< Zmɨ6GH{xc:EʄkbMx_!m[1[l.DBAaTHڒo b"gjܼHEq1d+WVT#/L[N6 - =$O?\m"lJXT|u͞]7&#[!H~CwV}:hVbiiU %B ll KHE|`aj3BBBBBTڧҖ-EFG__􌐭VVV$oZdL@ FF<$w@-! n&"LG?D"`R-@ C`@-! 7u$Q*DB|7B@ @|ha$q^z!]x2@ @|)ƚ贯W"g0>dj֜'0djܜ,@ H< _-!=) 'C# `R*Ձgjq<z壣Y-6`qА @ @|&υokِ >i6/ԒN5eI6wdxOnBY0~cJm>Odc6gslY-yO8a\W^g3[75wIJ4$0*fv+p~GW٣L,_on1 -Nr!G93{,Bnl{6ul}JcWwQ/I8ӏv#n>k=*T<0JE7w_}Ȯl"*|{hSϚ?-wwt֡;Y}k9@k^,{WB`р"ŧۅ.l3)`e[~L^'[리J|PqMO5F߫?9BQbR>:ԋ/t.YR`_3v$lN0[oAVLٶigsc}!V)ّBq:(R]u%NW #8miAZbvآ Wѩ/f avb{]PjQ5FHDWU:!@|-p|!P({dCRrq>ߧ{碌qke\W{8F:Yᙻz O`' &s6z8`<DO1&0y4%*<ɦy 2fӴLO;uw'ϣ[6aK.+rLEGJ:yC,mv].t idQ3rVq]-NDh;z=7@ZQx{jk$ o5R/1tXUyZqkr{[ p>5rc-EM>:m'WDO,&{ksE:(Cfڶq@sr/&y3W; i]sx<&19GI*.^ZӂUlOLf r/v_z/3AڍaX&yJ%iƵ_rY:N[IEZ1| uNފ7JX̶ïmq}Ŕ= Km9mB67S#!Н=ߜ㉺V'\8g@:?Stt %(6]hժ&_)T SGALHVxN6YqFų5WܟcuxN}'x-nQ|U73m.} &p23TQ;E+J`bٍeP5Z8}CYb/^gC! ůIz|c@UHנNCD" \?-q8\=5}Քo^56->xIlboRIeGt\|G [褔_W<7D:_W$lI܊ B*vQV_%I`YFgtq; *^%vm[L{Fcc<;ǚ9ð>]]W.&1 pVQQL:q9edZFd8|LbM|$&?OJ!wlkdd)㮖߯r4 (ސAOaXZ .eq:<˅ CO-V 2$,`aS&1G_5K 7[(3$tt#n M*'i kDIUвROxUWFkW:ab?G'VDeu4Ǫ4<)mQ)J(괙DsmHZ2βp`+7aXփ%cS]:#We\)[G^eOYd%-*98qBeVUERZ̲, <8WɔMic9 c"[v՘8=a:y?e2P^v.J: :,c2X&YQ{^l9úe\)$-I{U+$_5P̷?FɨRzU\<~][sWR^kMjŧnbݲK{&uE,;Qo ٪^+zƙgTzk:_OwizojRͩD Υ r/7L1myQj@PIʞgJAgٙwT\?;?`ޅKpI„O(N<ìoI*L?=W"cOݝ~O QhcKаV+6'05{|eI7ڼB!mS*U0Sl]cgnɚK&&\ 0R".ZyDP_+8J܌/VB+Bv¤{zl`aQtf'xq>-5;ĊWFv /ma:OӔ#K{H~BeQJd0,R"^ A<^lu'?/Ӿ@nc+[x +N_~jJK;گa1/]., WV՞f}jҚÇ] 1S&Pj>Jrb5ʐt6 Sp?a^aY+'.Wԅ둚sy\mlwxI,fNQ fݷXZs-:W*ه1],:Ӝuf&T\oze]AI̡"`eNg3$(^f9Li鴡!>!^MOYd>-ȽV}#,/^jٺv\Ď5+[:%uO$/1֮ӻzH0q3.@a޼܃b܂Շ3c+R>*'Q*ϞJ:` -Nu@FJo.PU1jn)rj]1 T{NX,Ϲ9A2BOOz /=Ks8`kF?kA?\YPP&MBBB6%x|ۂ FfEG)R?9贯I?.&z,nJXnvtKr(pMOfs/[f+V"PF֘iX*v9Zykǐ)SΫEJ!!!%ߏbiKjs2>VOjuW"rsiҔ◔QvC񸸐K )MC C0IWaqdTHqG>.4ߥs5.9q60gj#9(Dqe0Mѱgm5% W>)$Ģ#5DjFʃKb:N"e>#biK?c B3ss%JMG H4'@ x@ F?ѥ-!Vr9:7Q!tE&H< ėF.2zC )KViK!c"W)uOhL@ H< _-!F|ąXZ ILc{E}_{;>I5Re%|ĥ2Q*]Oi3[}+aC@2jK#B,e/ J{O'˰874Mt,$_1 uoT_: IDAT9?+3@CϼbY0&ŠqX=Uf *d; C@ x@ M[RM|08Qգ^FS9zrѬb*-P$@0 F Õ!6hg7]QxTa4j1h$Nb5)g P? Яײ>˷0k [7xGߪǫ{R;=ɤ& $07C'cUQDX8{~^x2N0a;f/ зu){30p1ش% |!JjĞ1E*.!1Ap ?k9DI:۠>Ozh5"5霻ng3k_]Y赸qiu46@D)KS*lIC1O4t1+(6s^Yx|, /;-Ҏ-}Zs=K \0rςwz3FSi2v:[̟<|Ic eVk y0סkg60p|KX+7WM4~f7Q_U+VRLʕ>۲q?L!.xg=N,oh&B!@|^?-q9O-bu̮z$wK4,\Ef\%B&f,knܙi͑>"thX>p%xϾg+6,"ljxju`0}ynVNncCwgT<ԣ`ɸSO/mfSGGn^iVGW|.K~Ӕr>smI1uu;R0<ҀsAfsuRauBʼn?S',_}>JѰAY??k[/VCt?9p?Cͱc܂_Z:pTa3NՎDWmUh_P{mMU/p<,K˵oڼyy\5p9>:އߜSE1%.>&kcժqꈠ!N|laͫsƤ{:W jKЧ^rFVΜ[V-޺zeK )|JB3(Zy BBhLIzջVB`ƣ2 g-OMS{գNʯԑ&e]'GNa1==j㯓v h8_1yG-I'54{ј)nj0%x&"Lc%®ŪZx9=ˢtZuͰ]SR84'Fr p Hs73z0SMkrFU#E[F SnzQqރzp&utɔ9"w:;ExלQ{﫸YjĜ|Q5oIiא3΀BǮύLg82Z3/Ӯ[9⵩Xaߜ%̛N h5*1UK7m=Vm-I~wh"ҋ?J.ҷŖק{tz~5i#¸Cq#XU̎Y~=BC lKVR#'{6{>t,{\m̎PȊ9 v8.pH?EPً+wۥAx߄hoHqLoe0:XLU: E" V< Űc)Sٷ܍ P)J(4维狻 Ɓ%֪Z=@j14L{7V:[4qyy E=--Cȃ*b|zϼWeIn9QgY?6vz8=?ﺕ\d)\[ĒD\Tir-@К &y&2fuxN 7BZЭ^5ex<Vc0Or;Q>6 ԭ`J;9JgM32"''w] ّ/pWa`)~UDz3Ʋfrw($V?xsyWrh25(KnozO =Ӭ%X`)y7#!=m{{dރ뇺S% *Fnle/$1R&ts5?T80 @JD*-=,MD/wJY("E*YmzD6P^dDdGdjXejt.JPˎ͈,짋fn&1`"o+eR\iω`|y#Ya~GN_)*YyNNR>μaJ#I{wK@vzu?l];e~ޯ(e n-4?'pՠ*d0%+mvn#I~gv?s/qPVnfEefYIm U[d.ߋK=Ke \/A]kt_Cۋ(}bQg#M ڃ:Y۶dئg7w#̷¯joU,tDOAݯ7kL%u]opLp!M6t4%) +܇C ՗28oř Sc})[|67|M'4RȑEPZSlyP^׶Vղ{W~7;/čjts!und?6Ml׹wKw:OhcWusNb!3g["ⱋlVn]_pKNT)4rD$ ~h.iidW^ԛ@JO-X# %&EͺzoٶrFZUZ{G\wmC9?r.vS~odYpR)re)B.'befn+lڳ]m[H4p75Xl]{<[cȍ8fnvB"x@ M[ruzŲl[O,J, M- |&=[1{Qӆ3~IM=||ƢF;qᐔ5սc.^?sLR­#>KMyKf/[;ȭMc} 7-[fUOpoWz{j5\Ҳ/cwɈQkU8հyl mҳ3dN1Fv|TF`fNb + y~(I B2xv?W9N6rYsrR]P>7HۂS,Y=kn-iU-z& ƌn4ea;לX2qrkGPaٸGM/w]Bc/G/ oq OXd؋J_ߥKYW&.ZxAɨSaV,LfIQXV V[1y?X|7ƶ[fv ׂ.&@Hj 7_"×M-4@ߋ >D:w?JMI,fr,s>2~k]Oٺ`L "F#ϙʲbrMciZnHX!k"*H?ҷo_úc_/>]²D*TV껰9rlݲ5r)$$dq% s𸸐[ӯ܊0d@al?.x$T+K[B ėc)˯Af^HyKb:ZLTxPk| @ @|~0Fz,437 xJ⁾~ZdOKA#6UYH847Q]iPUWL+@RPˆ8;y,@ laP@ aF p@1Jn LU8!^QFYvbξOmD@ @|(m al:q) wV쎩م|6UQe1AYPn=*PK{ BdD⁦iN@ @|):p n^63Bd*֜VL+8^&, hi@rP¸SPOP 0+^ڒR|nx?lj4x=sDf=~ T#bh4_ria|v=G(=jȃ@#}KiR0ed:ں;pJl 7mYÂ!x8alѕM3;t!}[zO- <1{Pz\bʘ Gwo7 0 wJ' nЧy`oS=+f*iVGU? 5q}y -\Lx.A%W|Ѳyy^#ic[/Zpۙz q~PI%7 -=>;jƈ@acAY}Q!-'޼v}35 mc0Y2'unЪnj/g77QAN&wI9`p~Gq]Q_[غ;HLҿc6yv io^؀@߀Jy: hnKLս}{~!FҖ\.*{dѪ?46"K_ eRI.HZzD%m)~hDgϟ0qN{eǖ-z{-~\[ܖ;6{Vgl#) +ۣCo+}G(#msL]?ދTd=:6xүt{%b7 ?p |$+6s^Yx|, /;-Ҏ-}Zs=K \0rςwz#DApi*A$9rz}9콇Z<7 }ܴË hcŗ6\?Yq#,*lfFo=i@on@gl^48(nV-Eѓ?0 зy{47+@_7 h۵&(آt\td[6>n_y\|rց[5 *P2v]l5CTOjΜt9}`LXMpJsY]EFIj6ݸ} WL&IxM|\<tIآ^ȓR YS_y*h]DiUï9k1b'4ZKgԠzU6'9FoxTP{5 =>K-PiV/>JAM Y9]#߀-{oasa;/GCOWEe\?:mGLk}xk70[oݻL?&( зqc7ܮ[%=gh]׫vsVwǍk^ i^ŧVZԪU&wzʤ.k6>wOñj]9NN[ˉ-q8\=5}Քo^56->xlȦUe7!wt@:tu6%IrA_ۗ_ʦӣXhB#1 MK5 ׼ȍw^QtYSvs@IimO7e){cNt.omso[?޼xe>r2ǥs'w'D"UJo&(u #2K[<\G1Zw:ח$޿cV׫5pH$ m 2YI`$ABoj@# ;T+P4p¿ 4Uؖ3V.[#ye|#/X=#ycͲ2s:z >v~V*ʹz2Ur{eEت9d-9xx>U ۊQ[rkVDdjAzzγ׎g^TɪomÌݏ`ԅJg*(Mִ'0te[7"P@iKC`xiK)4jքh{4tJ+PiNڲ]LB`"œ:JpZы'mxU.9^El]nx3ϋq{i;*gNlŕ)}&бtkFmWVXvߴaJm@Cci;@w?_u9Gy T啡Ck0?=r&áCw.?~lC\R+uJQ4NKԋSnۘn&$kagoM *dd)J<۪̥\ ?)YeYZ}Isێ=҉\ߡt;aT孭;%>! /17@+8H1[Vw[[s'vJdY49(Y ԪLJRW<1,!42_iHqYМJ82wGeik Z{5tGfVci> ewcMo!%_YR˺wUyg5aenIQ Z,~mъ[urЩ(A'jK2Km7ɃdCo+ ʚH"*T+$XlzYb.Os]<]&7 m}uFKeywwK6]cpm)LmȻ#mtss Z~WSj^:̌[3(gkL0pY7s\p=4Ԃnٰ, ǀa =<$^:V*ur5W&o"7 LQ/_'F_jKJ@Xe$)~m􌛞oeML9[_Vپ~J>u4fitJK$ڜyyҹAuKλӕWd]\ApL./k4uY̟| QG@0J)|4p@vtve/LJ<eQJ@9԰8Vs9Բc3"K3x1F JTVs"2;{g|%ʰ|#/yhs[dF1i89XOٴi(2wssswsswsss0kgK.o{Fձ,IlWF;Tع]YyNNR>O 2A&@,d%Ͳq$Ig%j֌,+A|kW{`48?6 g#` hFREmR J[+j "JQ ," :UNJcDIp I_:#./Iy܁_g'3;zҹ/ˮ\tNמSkcnݱ͙9mQ'n|{by%gYKvV-{O0}ks^^vFy& =E>57=f (ܴ2)hש]ן}2/g5KXtĒs4OFku[$X?~N7mʵ5{ȎFYyoNV[Ϭ~FgNjO?n׋bPyI^4Q.w*{~Fgn?ismWoy7ugWzFV.[P~ /R[|x_GVϞskoŇ=﮺xUUޚu={g:~fwصf\ާEf^CO2~|o.v- 28 g/6_ܵ倉sñ(s_}2wkm]5s쬝uͺ~%sC%L)m[nЧqFF+nb_L@˞C hyז2vœngOf7jpW=Fu>?iHg"3_C [kkK'^1 Ϩ|a6ev⫆wk`HFFoaVbX5;}c{Er@ϻk}f 8㧠mXSҾ-!t9//ZtM^pii,z]C޼q:;\~Ua*0_6]Ut#94}.Bo^z/ /y`BiRrƈ[f,rϮT{ Ma3rnSZ;{.ӕS*w|®2W4TQQ1rȴzICjÎs!-?0c^}MF} V-9է"Y7a khxN|[iێe+.j`=Y_ywV~7KGՊ%8,r#yG4 !dF~Ǘ]ڣcˌO߷}rO:s BɌfPNV$=Tvm քk{>_x쇐~O[:FY,vjǤr^CS 5G!;3#,6xW.O- mݲb?#ilcذWAM bGy滫G=kٵkW֭O$X-A;ևM5G8c紏wݹyK8hQOlcQ^N֕\9Е!/7o"|Tx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Hx!-H́x-Hx8Ll7)++sppX8y !-Hl @<@Rۜ'!gC !`e.~sJT]v+~ܥ5k.ץDŽnB&꺕bv6ճ})ƨ-+[}ikEP4AB(Jqㆭ ,˪!PaxIZ#G ڥ(u;h?32NOYX{uH>U6G⎟'#CPɲsNٳ \~۷o߾m֬ 4M㻎BEM}|Ivk`a3^ {ժׄ ڍm߈2/6QឆBukܲF(e&\:xjݶ;)uh5GQJPjW޳yjB65@V5)c&~^^=sUoݔh6"{ceX_=/IzW Nս}aZB^SSS7o޼ziJ[ptt411.* N|Z]jYs2%9{0 B͝\h1X\պm+=>U\ϊ"f3__~Xm9i4J\ˣon2 0 Pn 6DOYYZ0C 旅jCJVVjB5hdS trɚkiEeG6IO.O0oײf1KDZu,0V@{^ h׮]w^Bry5"##@*_pT(M3ZŲeʬ(v?+T<H5i% Ufaۖ{sB((fXcyV%D3 @:%UF&X L&ٛRגIZ|:c%>qÔ%!#ٓݺu*:e^ !!ŋu59>* .-R|yYkf7{l|( K0 %C`rͥI_T4w Qf*:t9+2 }oP wr${Z5,Ȟ8gRa@('1${&khN BH}W-5`7nMKK+|͛>|WWWa?|@QTڵAU@!NL5n߼C)JđIy$o?nC+?)pM+:N^ri]wZAߗz?Isp8HV6d`3">LQښ R@f}owGpvvUEQ üy&""YGW@¹ !T۵y ٫ {^]CLv˳mPx3ڇܰf_{k~ܥϧV=٠z'OVH 9x9.bne, uysx6KmVK ?$\ݹ$\KQv +5ze_6 *iAUp)n.HMM-2lnn:u'ԯ_ۛ1 & !P#D\{/|&:aii!yA B|>A@KTmŲ&3KbYRLl*gjAi 8%~,͡ǃ7?] ~ңK^$|Qשܶ2$J$ļ;v{j쥥 ND;ijpXYwhiQpC(i^j:GoFTA(NZj҉+bY^ʩq=^8<༨Cz&roE*Cm߶y|}sV?1L̜~Na}[2gUfY}i^=RW2>o3z$r+X0Nȇ`%]u#BpR-\^.~bON-ל ^(FooLt+g>{svUZCk';via`"5>Y2ʫƝ dY_Gu!6큨byvQz=2?5>(^rmA 7vm0طƩ#`_l>S{\bf=r^|3[&ήkHђXִm 7{Sٽ1^l-@77 w"$ BHBxQ Zd$ ZZP#{}:/蹵 ۾20Q 3CK(PL+$Lzy\ HKPB=(gd6C=CPcIy>u\i(}چ3|ɣ{ݦ]\ T$}O׿"."BZLC(._ݔ&w8pј"#s3C>| Y8$?cKj¤ #{oe6YH5?GTd/ak̰vgϬ8"s j߰•-9&.E%?uR҈P ^;w]Z05Wy fW3奉v*]W2FxT)ı]\3g3va⪂l{V7r>}u7ͤ 3ccVc f-XˊyM^iϦ VCf.^8R2~ɶUzirD܂>Ɉ;E<թ'઩M.zJRHMl P#W==gFq77R5t*c ^/سpq.>6ɪ#뻏^=B+>]}nڵqp5&l^25DL^/k<'.q}Т {7-WM/@/u;aΙ!),۸{ًXBV.=8R&6V L@*PVCP(x~W{@!TQ3Bke5kVحaûeOriBM&UcK=y|KvѶ jZEO?)rզ !П.44tv P$F}Shzv; WϬȮ'sϩ).ls69yu&ejz޽mM_fē"l9 c:߷.ܧۗzneKίX>{U ՋOi)m*ĸ }6IW['__`r|>ImiܰN" ؔG6o:qSWa=3[c~mϹJw[GO }'uֿ~gi*0mY1T_wϿI5pi7bt7׼P^=/mi!9a aC&G7l?Lqyû2膍}Ml #{idLz) CBC;&II}yg͗W폝-?1Ģg2tWoI4_2޾λehRJrmI><g҇.8̫SSnbja)A۽Nr3︺d&ӥ̳RMx&NMD :u4U쩩- 60w^5zsKArLczϞ[AC],~qSK! !@S4ќ{"*11MbEns4BiZ#s5!͡!|1h%-qY%J&1JKgEs(Re*YBg̖=2. J[߄İlcDh;e;LU4Fm-R4*Fft'JZ(T2ik24+e-HM!m9֢īMtvvsݴsJf79 E^QkxƖkfPp\s.;$_T٠D.uÆ7P!R-o֬8x_bU{Oڗ;TA*V"IϹ'I 2FZqUP?}?4d[V-"}|7m?n!tÍxwU@:J:66ֳe߳L{aU ړY͂@TTξy﬜ϽQs s伿Q_uiݎYe̅oMUe#y(# ! H-dvB|*j䫽|b6ɷa/1WK䛯SQ=9|2U}Z~û: A{$*1"B*)@-@Ѭ4K- u{Zﬢ}_렂tmP(\)`U\My!PL(Z?93꤈++ !B*  HE*BK8;/!BC[`RazբRr^ : 'lFYhP?TE,! aRQ+&b@AyHA7 pԷ^ 'B0X@!0T@:w$I@!Gҡh0(tOB!TB?+Ck0]B!{4 ԩGB! B!0T@H& BaP>0 !BC B!0T@H& BP!hߎsfW˟/1\xgWS~n]͌s[w\@:QNQ$B*.öl\Uػ ?x Mc֑ro$B!o|ySObBmGwrd \$V߾^\#twt:aeYqmˊ)G Iļ԰ÂoDuwqg'Du:MgklA[%Z8*E\# BFN0/I+va'a\ϙ'kݟk[?S ݺLҷ!$o|[5pȶ P4 4NɁ H!B淎*^>PiȒՍ(p1!g>u:|]UwpzF9ЍzfMb]:րsW"z9;hDq%z (664蚡Ʈ-9f85nKuTb*=!ioU 9z"Ep3ߕK]+.͘w @ kMY>\篓R%իSy>WW`B! $ȔִFΎcϬH߲u6% 5'A'ٻ:PR(J,P|=wI{e۟@f -~ rp1R=JE*_Dk 婋J)e&kޠ̺mzQjƵlD^w_$B! aYyntGTd?Fim|cݟ.G(u[9{/l<t׺=yxN@OB!o;9vv„glUBYYK˓HQyO4wZakf!eXEHHh(㞽S8li#6{DV.Y`^XezTeF?E=0ߧԇOY B!tƯU ʄOBo}u7ͤ_jg$;u3kk9r}6;WYo|gۦM_*]I^nԧ2 iH?=ʭp$5L@!*ᡂѦc~7ɪ3GnT-ƆKAmXs"3{ DIi>uzP_rm` t׿yFsK^zţ6Z4aek1ޜKiܹ\Cܙ|KN[i0oTk\g^e %sy AҞ]UGr$e#"#xB:KOgogo[ږ..aV>Go֬ٯ?PUԑ7ݰų;t./}OQ\]"_zimemok_<^V>gM5-诡ÎnJ`+U040T(x ]]<{R|B|Cg) HiiR#\.w_͛ܘeY8`V>0TZ/-@IZ( [/FޏBU>8tB\eYg#9!|0T@DQ!G)f ]dyAs=$UQ 8|ӚθD ʧph|ېD P H~Ĝ{ȉ/L>_iKzxt*[ك)Ma^/̗Jb /9FXrҿ<lKmy =?[5{zx =$"M}t䔛wM ?xd>|ym>M'}۶m+`X<|%OUqG ˏTBQ6Los;*Bؤͻ-=vpQޭzO>شeñӲ8~-~cORyŻ"~!BlYgV&U@U>8֎e\8_yxuu!Lukay?8gSׄ( !DsmdV-(ES{)OǷiKμ`5% slN>,>=29YϹ]G]eҮMla37ۺ$om}}N8U~|->VP=w[o=g ` !^ͦn僣 D P4+ q,t&s;VD .^{͚\On{fY_[1c҄^nXsʰQO.Nbh )`&wAGXڼIǯQQBMnفūrԓPؼjݳoy[7RQ]%KV:׼Os# '@f<>ue~S4yYEmYP%^zӧɒ7GVn[y,Qݩlnf} bX.,$*%<},K5է0eko8^8dޭ4+6-\1Ag a"m@XVsa #W=?x߫׍@T96MV cQuM"ٳBUZKǼi~VR,!e hF4/B?cI C4s&6[IKTQ'?%luN-1U DOײ8yUa R@o`$ȹtfDCב]=T9 })J7*F^MN IJN:zQaW/%%%6^а{\k߉~%*EhbѹN%'sv"|rUiٹ/ܨr"BR;t`qejT3 Hc ˨SQ|>"6UpTK μ;.PE_ ~糢w|y@73r#fndD1O\<]kR@{>ǖ4}(IF:~O-WBk|n_;L6|`O}PZ9rd+{LG+@uۃ_y@\jWE:]P!:6SԧR}RRV R)X[p!EQ2 }1SݘʭE Mhs:99 {6صU zƤNkUyˆ.?GQvVM QLJZ iQSF_ݵv' G` *%ڝ1 ef]A-gY.GSPH*CCžc7m"cG!͚ ?˲^DX_͎):6g8~nxxx6hƒ"|Vw0c &,f?u/'ѧ[a åX"J%L&ͨJ5GC[Yh:VlX)P,R' eYbPC@4u!eޤǁ{Ξ :/ЙeY <bJM)ڸpdL߫Yt)BTT)˥P)8nTTτ P`S3gh{ޭ5AÅ_Q՘y q## p2R{8f^8}ˁSwyS7Td'XJ1qq_a֞z$LN'b&H^A?k_u38?{]Z[,פrvkQ'^ XI@5NQa!xfNƲ[I=O_~T1! C4*&k|6RY{# @̨ |*Ok ~(Pq/o@ĻW,Kmܥl.C {'/AT>83i+-N,FRuJ=ꙓ]Sb SnO8IS6i3>>qJ^Tl7*{UڢIZP\H1CQ)Ubv DIr~ @45oemo,Bz E E/[oO)ED|_c¼:8t!cj\p֞NPkQXv._rMM٫-uVyg}\NOM[~̍GBr&ū ~=wKZz#Lfj%lfZZRkXPvgKµlk}ZT2R}y;gAP:N*tp2a ZtJbl82-~'wYsH 7ZGke ^M{YU>wk[Y?ޝhN|(r:صԾ:oCLJ_9zƑ}u1hoʑhju'aMlpih˩L%LjwʝNCت_#䔠I$c_-5J@BVw~'²,ע<ˊ28ϔ}! %Ybo_f_͜pqKHza,lV"W>JnVjH.-_?AMi͚?p~Hv~ji}FZ^ᄠs`g{Orazj^^vL85gxL5 Kw80MًgBŬxFM khhp>_;@h@E?IY IDATW@}EiW!++1 SñA+ [/9stE"'!k+!T"+pe*M\WZ=d ٴ(ϤOߑ~ i6ё '(Vm )+)1C :elb8C! _ZjQ! A+] C۽&B,Ҵ:z w/)ClSo^rͲɞ)l\t<ѐ > ܲpe@#:BL@N6"> B=Yd;[;|B%Ջ~+ߩ۲]bBƞRoޖU߽YEC =6:^xʭ=[=W13~*UËO̰c.i HcBDHgD"[[ s |B%э TpEQL򇏙խ%4E,]ȃ،B[;+Ibqb҉PJ`MV֥KŃ+f:X ʒeMOZ/ $J | _= ,AwUQ%0X6ABX ߐմffES4Qo@i rhB6B!0TȿMQ ( U+@d-才DTTP @ K%<  [ L@B!PAe PfZ3N*J| _^%,9^([qȢ^qYRPɹC߫& !BaiNj9 Y\V%̔"1_C6]WV̈́oTEEf=562tbCAͿpbXo NpT$B*7WAzȑ! 5j$phY*'[z2I6&xri0;+WM9Z>cpuC3rݭB!0T(JUT/ϣtg7(~.Q .aRPP~B!TltҥD t|5<']\?wB!k~*NB!ŸݢSE~#\ !BHⴴ4꧕7ziiibgJJiD!*iiixދџ-,~u !B& [Qx Phin)Jh0 !Bd XT*U*O$ BPT*O)Q+ !BOҝhJP{cWgiyB(. p0A~pȐ!xfB;v! m0 BL@B:-B!BJXB.W2dB!0T@(%lʨ;8$_߿mG,^!]*pҡhJFt8!B:GN(Y H!8x 0T9̗%* !B Ra} w0ϗpx('`B! B w`SUs3$;Qf*KS6*7q=(*( 0eꢴ3͸Gh *4Zn4='M'{7DҳExXWñeKU0q:5  i3z)ghSW aM_ՈB"{>ʴ_~5k׽\3#@dw+#c@+sXL17 ٿ|"|7ObO*sf։;VܩHr}wthM^e"zh>Unm]tuRIB!|4cas+9%WXqc,@/Q"aM~XOէ~>KB8N,{_4lRBp=7}+ڰ^ÚW/n{K!C6i+C*$OG5- TÍ}?wTdp9s1Jݖ'C0[QB3 kuz͜yK:_BZGjszU=@_/BgGQv ue_vOta^}mWY',_Uv҇ S%ݱ=egg&&Ǖw*:CWI~ ̜UۺO\ |t@_t@uIn]=={"#;{S!;5TkQ#Ǐm~l]eVJB:dTŸLOޝC K60.q荑z!*YSbAjH]Æ ScW?wOy#3yW-4q`'OGc֬YӧOY@ XX|Ϋ(  8.[!֗p|ꏅ;oINh(@PK7*سi# bI $]y: ˨J *4ܜ̬@@Bn<*l̬L!DdDd]$ύ YYYA!a:o46.OUbSRR Q!XsCeYfUHQ|$E#3sO[SQA$XVVV"MPBFi']if $=N'K:Qd 9u PZ/&7uL $ό \٫P?i^&  : *4KF#R[{Xj ӧ ;1Ev#'K791{TPmʢgG/Qztᛟm m;{ύ6k~![7]tzOwiaAQKb9z ..?*w+I5s'\nZlꕿ?M#E}X^W?Йkp<{]}].ᦔm?lH/z^uWD.Y+YL8 xXT8d.04i$!Fj~NͱIQjOA[Id 2i]OK:k<yŲdRGD &ޕI?/b"L՜vʧ\brPa[B]tέb&m.ک0WnL(@P%F$i'EVęO~b;G7eBsq.jlr NIII I@d-*cԪ7h?t'W=%ф y۷7rZ W xtT^)Up#ErGVRfs@6}C=xާP5[ONLbժD}\$ύ 5KjfF`ثض~87vr(o|h, ~`K}bo|h`pB_tlxղS;%;oBCL/>H_8TRYLPWOF# -<1[_׷W+ݐ=&!ЛHp U𴨠k ZiضDZ?W& ceWОӻl] -F<̴~a:a0w?ʕz3?wkh[ z mfևv U7Kۛ o_6vw'&>0՛ \mCctBv{%Rj~wn=އ?Xz`oh!m!ß}`?AjpɨBHQS|vGz} !s;w*^֧JȂg]Rq=Ͻ]#zܕ/=Nޙlw+Ba?4ໟO?xǛyp|ޯ]uh>>"wwjKR'ǻ?}w/D`aOsͳ%FHR?a73ڸQq<$)Br[%v^{xBk{K45-6$L_ž~6+߻u@/!y[aם…еI?\'k%JƾƳ3zuμn„ WeP<{JHWחVeUwa3(B!ZLש<HNlT E._UkB7uP,Gּe OSjˊy9hlkCA]b?y W!!}(-.B1xk4ZZ^9sDpۇ_ݞym>\駽y^#:qsUnʝ=?[43NiAPQAvwDG%ZNB؎&=&XpeMwݽ_<ɗJ/.$z _l!݇Ltʋ8wɄ:?Su#>jH-uF֭֘LI͵H&s|A}ZW'ٴz㞌"dmٽ¼xP): a*HZfq|1>k^f !3fx|$,+J72B_p L B[Y΃{Nj-BUͱT}c'iYDXp9s1J1As5fs 6{ޖ_1v9aԕw ;~]Oy̍r'!Kp ~n~v?? [$o߾~/~i댭GvokSV3( !}'Ɯ5{ݹtOޥM{x֢s/ +b1}mWY',_ ^,zco7g?8t槰wwB҂ C])6"y׾}lOi[Gxy6ʿdnqE MF=T=Ojw|#}CRD#G'}DPݳ<:ذa .RZ̰|I' ϟ?yd7rnp:!-k?q|2\<>eGINgw]1Pl6jAk VYQ .$]p[7N?sdm4‘լY?)ve:eKi/Ć!4KiC+]dad4SFP3|L?-N%cxc0q6@TUd}p z0w BOϬpfQ(: zX: @cC$Yh4^Ysrs,V Ch QQQaM'Hrrs22}yY32 P YYYA!a:o46.OUИ: @cB$@,VK9!˲,3*(h$E#3sOS* Y$(IRs˳vU}Z D$5%x|iq(rU>-H$AHhKF$ 4gYLP_ 6@OZɥ ԉHQa)9UEʄW>Bȧw|w8L1=qx?Ư?Zϣy1[]z^lZko{23cM-mu Hy߻(["[~gpۯoS}_:Ŭt' 8sm ;t3hh[K"P'>+w5FK$P6 {] zQQR!UFB^ㆲCzFRfC^ّcOɲ*LJ&҂ @5|jˢq' Bɰ_g[;=fqio~!O[|`Ww;0.&<:*8϶?>f\8cdqS^x}@v9o޿ɾ@}O_kR&բeNlpCʉ&(@ub@Tp9eUp={;57zW -CcS&we!J7.n t~E sSm IDAT=- rLj4&N4z?stQ#eIB)ؓ#†9\ɭ Nt@ ;疭eee"K}&Ϗt#BEOiAyqA=6F{ΜJf% >IJ9GzXTqnLGGU݋O !DNUr>V>~~{yKfzĮ j7wH ۵7[/++|!ZcFeZ xfT w||gjn{ݣݯT Ə]SZK l0#vU*PFp9$i)Ώ$Uq՚K'<28uo#PRRx,ݥ=okQQd22,LAj4h9ܜ]RR¸7&%%%9ps]$iU`FVba p8j}' : *4b6ژ(bv{$ύ B^sJ4>,&:%%%x, C5p 6-TJPw1POZ Uc{U`1T$P'6*D@iAP@T\ꔔ D(@ *5AQpbQHNt@ *҂ b1ԉHQp3 @iAP@T\@TA (@ *XLu@T܌$PcZ W,&QQܜee0&)!ISq ULP : D*SN!!0/0/dps۶n Sx0  yT>ݩCÇU׏W$IUdW5}5o<""m붻캐ٞq[?pP$B)+/  HKKKLLl÷iӦ ,(*+/P.dp(@hQRq_x ^ј\OM\HU'Jc'έBOKw0 BREԸ3*" dSϏywԘ{j`@TBIr@; ,ɞyf}hP:FIHS[}oa݃چ5B:tMWQ{GrW+m׿+:s,"%!mv}lSzzcx}: D%)߯i\<~pCSCm|13gҠ¨(ʅ{֑˲3JuFmIFNY: mHW|)V4>~8OWν ub9ͬ5+x끉:kߵ xs:a}}Ī(zR(qQ'N{?d"kld#~EQGo^QG̪fwUr2JZuhf*8Q짏m_%?~ "c;_?/Yf[ZMB.M[d;CW-]v'썿.:)q!7sO'ٲiΓNqh3GP~ $ɹKn˵bذ1/h~U^cy^ 'E[f>Nw٧?+ۗRE`-;o*[.||oO~埏[kHM{R訰HCIzNY=7.SbBP;3-5g]ymzЧcH!ܕ%lߺeõޯmxu@{_u~z賲ʴ&^YHS+.JMZU:^ Z]+E(IT( y) 6OHan5G,陇f9ⓗv&!C?k揉'uvDzOLQg>S޼F!"^1L'oSel%Gf!z!;ؐ].djշOž$I{VTY%]fG.r?϶[˻[2%5"}iDn+8%ySٯÄk/b@بSU$gZ |,Tb+eE3kΣB+f3mҗx&w,;3řEQ짏/: ZI!WbCk~[VKNz)l_HFy әoU9>Y\RX"}̷'GdZp!$Vۨ0"zd{`-Zmu͑^#'D:SV\6s9#,[0pvDe Qrm`LH;[1 `y<bdEQ!(]ѵNO޹7Λ EE:j䧭u_W]>B)(KVPzNy^՜k~=u@2hRB)s[[#ƴ26),6SF혚7cBKKRI}z^B}r*("IR*st,u=䟶$vyKqCQtB6,E*LޙZ? O['*,E:!7&X%;)9RT8F*(9NjMh܂+Nݴ#dysne+ʷ}&Q_"<I\j Voy7@b!RAٞ.G3?궸ڞ OB!٧"lܟ04+tMex1*; :*W_Trv!}Nkm B4mT%#[/P&P4!=]W 6{t5?:U_[73e7B;|> n[gʣ￷m՜?[: )bg"Y؞h!3Ohub2ZFJv>ڥe讣ftrm?uJ+4A^R}=%.f)@R@-~RC3һ&lֻRnޠ,vET\[hshtщúlY$H]4.©\wo=%oԪUbI/҇w;[ݜSF!ݱ*&lDx؟*~m{u1JJQi9vlw}E V$Bm]&o2,ĒСk!>6oV-νdȖ-[>޽;/UQD!REm*8Z;{8l||.|:^gVp( WL;w9'e"(7W{Dc:snZGl'#BfT7ͺ\Ѭ97`T˿#:\>n+@BN[I<^0'k@-wk&[Je.ph :zk[y I%Xyx@%بR=nجb_7yM{&Fh/hՏ*\TI)`A_xOfn3NجfQzp)~m]4͙٥rF(֢Voʏ'D!9 ҄ ~g۟E L*@ܨp8uK#* { J|dxz;8 vc!l}jܺέvu3ۏ.o3p6m}mZŷWSm~}#@sB]LWy\U#XG d:>fmP۶>k]mh~+S,w g9j}eJ&s!I #h,+/nҤiwUv]yIHq]jobcceeF|<V\\cQ^RPMț~Gf|YA.9GWv~1߯>8~ ao޻Am\v?âBTdTfVf`@`hhhhhhAKtatTl6OOmCBqqttC%#ǭ9z-L7 UP`,'+**wӚ^u=^m|}-m|AǜndZCn9I-@TԑD s-T!(;5"a3d&p%zm˿G%BUp[y55%yKXU҂h$![-֪j#zjWsvZ mH Cq| u^ȹz#p#i#"q#kv.W_TaÆqj13,_|IsO}:O Po>`Ⴁe˖p ߚU{ 4>-[3D ,{g?;{Oxxt@ lri9(ܽ<9CF j҂h$SկMTvτOu nBŏo5ߥn~S }`SRj'{L~8#1b@TTDw@|})?7{i/ 3 ثUpC$Yߵ(}r[W?eCէA=⃴L  *H_-W~q_9&iD@iA4dRva { n} ' *J ; XZZ󃸸8F PW^III XU*Yּ;f[]κ.} J҂h$`=>8$::#~:wsbB?_>ϝƛ${ n뀤1G'Ēzt@< PQZ _ޫ_CWI{&0h|c[Qp; )yY?6#ףHJJbaXq Up[Rw?:brx*@EiA4|6G3pV nOiw=OT*w0%@ VTּzUB@J#fN@: $(-/@񶴙y dcBcU$sgnڳK.=1f "))A ;Ix~ǻN}W͘C_eaJǣ *J ʶ}0^bBqCyۃ{XU*^amXuдGSkF9D@Vd^͘t`Zޥ6)˲%NdfC}sk{i]oe˖w3iA4|wlBmtkkyfޤvk2lph F_nf{%;yvx nn F]t7.[Og'|ѧfQzp)~m]ʹ Ù6F 7jy P ]_~8"8 }t񷌋.uk[7fK]-.@#~gq\BHQPEZ _$ߦm|"MJ?s "jY0_ʔ% +$cD5B80;n)@R,G}W)a#B8 6ǤOs|e֬xusDX˯_S1T-))cѮ,= 5U)Xqg~H;}y87Gy˜OǪTDC 7q/\ގcpOݗU.f/̬h6s$oK|^|@TzI6Ys3G/7F"-t@B !lo eђS vBʾzws%شȬ;&ͪ,p~3|qQL *H ! F--h5bT @TQ *H @T ꔔ D(@ *5AQpbQHNt@ *҂ b1ԉHQp3 @iAP@T\@TA (@ *XLu@T܌$PcZ W,&jPD$"- +@7+ IDAT ԘHcWiii @Tr U!!P : $(- +v3: *nF$PcZ W,&jPD$"- +@7 ԘHD D : *H $P': D(@ *5AQpbQHNt@ *҂ b1ԉHQp3 @iAP@T\@TA (@ *XLu@T܌$PcZ W,&jPD$"- +@x2C5p UY֭LI͵H&s|A}Zȕ6fU^Aͻ^ѿkA)TU(-FPd#Ʈ#'L^r97rr1ʁ K` Uh gBAn;kDhߎI{ӊ:& ڐnWA%$mv#Ft b *ĥIc+QS[KfM* *\Mܺ Oٶ~wqp۸p&5k֏efa}Krssssm Ojx. Mޯteʒ1"~N!BQP8D$/9^%SyP#6*D@iA4K xusDXv~f6L7P? $ *h.@T?-FQ@T D : *H $P': D(@ *5AQpbQHNt@ *҂ b1ԉHQp3 @iAP@T\@TA (@ *XLu@T܌$PcZ W,&jPD$"- +@7 ԘHD D : *H $P': D(@PCAR4qqq *s\QU ԉHQPEZ W,&: *nFQ1- + @5(@u@TTHD Nt@ Q@TjL $P @UAQpbf ӂ b1T$P': D@iAP@T\D$HDƴ (@ *XL *ՠ ԉHQPEZ W,&: *nFQ1- + @5(@u@TTg )9;l֬YZ)\6f)'P}Tn<sqXP3ey4ļFU$ɽ=DŽGJJ'qg4  QSZP$睲$!'? *$ZfSt^zI!7ꅵ*c6V2"+5Y6o 0//G / * I^&W8AW%@sOHP)@ҘBeV!Œ *H-2RefcA{T&&P <l^QGZjϩ6ot硃ZV%{u+SRs-gPTZz/sMd9$meX!UWt3ln*½-\yM#c75̋R2O[EH⤉݂XI uMNsi9[QDTj+I]MRK{ޖ_ 5rB#=ea:y1W\~pݪel(t+H[uzO΋Ҵ5KR򹬡ŖE{&^.~Pǿ&%EjxsSze!d E~vIYj#P*@ԃ!.Ѽkߎy{ӊhg>x<}c"&i|>-Jrʘ'ϋBd,YWaDh=U}*JWn<:2*&:ěq_,'۾EQo mٱwIvkpNMehlj PQZQT#[R}PQ#Z?sT}3ak ۨTbݾtEFC =C3({^+oeQoQS$; -z_UzluK4Sx3xk5w^>S oyKLHUrWgE Fܺ<0-hayqgfY~/s3eB'zEUإJu-&Vk"߰<~mGvnr0%`6~5HI/VWt^zt6 FB8 nc㪎yч]6.gζe[N;a@/ISle6Y5Bh FZnmw5GAA&)hpHowy!xn:>rY窽ge_/y}[l8ʄpUɼLAU4o7=/Z?st E!SO}vD۔uOA8" P+: !t[oݰ;dΑmwUjysf}[U(W67WϦܼR}^yLMe[xΉkw%}h݉NXJslqԢm|4i⤿'O̐Ae  8.[!D{HjCT҂$p @5(@ *5AQpbQHDƴ (@ *XL *ՠ ԘHD D )e'mj *ѥAK]iv^\sWoP pC5&$yr݉Ӄ>շ50܇UH.mLa˺ɭz<"*,|pp I Mݻ "5'ѧ7v6IOl+-ͽz8~f[Mo)@(B fATJ"M@AzPtD 4!@@Bҷ̼$ BKelv=;gf˺%I46'I;:7?p*H1{o,E*oy1"$գB~!AǔGu]α3|L N-c!D-Ҙ?}^{3s1ە~ǓܚN=4UޣϽ񥄱tI!O}뗿KpDL&xr^"ޤiTu:0fWX|8G <~A\u,fdsFҕ@)Vۗr\u=#!0HxyrWDL&x샂IgNէ׎Fo4P=D͹iيN2t痌Swo;wMI?j&ёQOk‡o\QZFFEG>Y~/g~=ݗjըxЕ:ÆOٖhB H %c5W"ͭtc_pE' _v@]?k7gBr,Պ?_+7eVw)˥Z0.N;BWm:z!Prb}Z:QԼvL8j\ƹUBakʀg!úY2tO,iܻp̸1e*-yRFwB/2;|)qo8gZ=ml%n{Оa2NFۭ/>7vZy7G#Pyw]ϗ}zL-=Q;^^^|c=f7S !LIn=~ufu7koWu`[XFDd@i8vu?mZfwB 2lZ "柳x}]/o{/>JciW;Mrd~H*{n׆"lp{~+kAڻkP/Q{څYw/t,\.md_L~_}oeN~}ŬW ~-zF-Ȼ5$;1h@] b딮s NoMtBv/_-{ ֋nB?$٢$`};V,-hv;'Z>M7Μ vQ !CDŠMJ^SםBüBR'y9ǙMxAtdNl|㍸̪b@1םM[~d^|^bggxNT/p:TkgG~:g; h@R\2Z8m`LӸ8&";5,|:LW{7~wJ~2ac!UnO;mXdz޷~${{ϽۨڂOr/<%ϗњ/7Wǂs*'w'y5fo_v-WU?cB`/ ^s#f5svo>V !Mjg Uhu ։+ǒdC@/~Gs1f ]B>o~_|vcFCi瓦it$Z/,'*.Ѐ@1g:ZT1j*M J%{_oWP0 2oSZa]TkزU0s@_eg8[-$Z*WYGk珧܌\UŎ=7򔄨]w潨H'!=CeD wY!W]Zd /qS4x>%'=[VkTLwg5\?"V(u/>%FY)aϩS^S|| /0߼}\vg0dx@Sf z; !4M_pѴ5t8RGUpĵwnժW/7ZT5KrN9jR\xG/ݾ!ga\W-܎V_)r_Sxf}/14uyGyf;wkb:tkoqHP6>){Z;[5>~#/׶xYۍk>9znmwéÖfG=Ӹ-wڳe*NZVj/qC}?ck^qOka:U#ylW *(񇓝+{ H#}έ]I)Ҕ FRٵ3O]If!dY񎨩_iEy=Q !k?*XUWn%]˒tdT*6^R{''}4sl_n>j]vR8ӥ1ufvב6~^7UUۏ{VeȊB_/\^ftڧڋcWUKEV-4csRI]Quh;eFʄsn7?gdk[xF.8u^1!/JjL(h;>>~`lXjVxGصK.w֍BFw?|˴ޏIŠ.ݶD/0Xrխ~Vn5a{Y 7<[7&&fb~\)P$>?oLxrڱWCuX!`QlzUsIT]+(^^q2r·frrw i_x]PU(6{j]LZj]h</Y& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@7JI (v( U]`2XAQw@ *L *VЀ@TlAQdQ$`3-oY[ IDAT u!a T ?ϴxr<4 ҂{g` KX%,a QO%,a KX.yx1cR[jš-FZ$?%,a KXR31ΛY<]RY%,a KJfO)P"Ĭ|!*҂+ %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAPOZIQIWrrsJBN?_?I(yHpMT@IU$W)$_ONI^9,ݣ$-=#\y!)CqRq~$_ONQ-˻$oظb  H'jR9Bx{-w?#š88`?&ETpws7 %a}+U>z(Q"h@)9G{sPW99^^%d}eY*ᚨPT H%>ךP1p)pMT@ RT Hɦ(J ŻDQZI%5š85'`REq{`lΜq|Ƕ(.RrәxHk(/7ݾd3NׄWMZIO9iENJzAGh J3ޕ֭oP Mqլyޙ~?|L6 !g^nӯP 7ӌz?zU>55m]#ucT+X{yf Tr+}(r3,a qyEvlZ=j\w+T$Z u⚝pbZv\PzV*5ү>wT!9àKӍ^Y):/ 4+{E6J~<@J]ߝ\T/YU[T rT''wU]XJzI ~^i*#9&b6 RW3Pِ+;l6WW%بa;5)/WzLZ\֕!@IUd K)f@j]VbrMw& m. Q~%ҷpOxqۿL}?m`! '~MsEoUQo1VP_r »ܵׯ9{1~!$ Nd,g+·Y\N78yjΧd}M>!G%fnd*w95W4:I*CF.>JޕC,2Cf ٦'wmBͲcsM7/36!-_:ɨE9&l@R4V>WqGM6K$K.ʣ-؏w@*AZrɲ!KH,˒:J~ҁ+Ϥ<;qh0dJ+J I2EuCWWª&uTbF^VSծ~nJljFʍ|n_PROF>7p`T~ z{Fg4]'=bm(WD:nBRi-3ɥj3^"+_t.NR~FQTK6?Y}1 #n8EcǎC J" K:,s:G7'C}YQ $l6ɒZ' c?XGֻcR(8ߥ?W4[up W=p6ft..ZV9;K9٦NN*S^RBBkFeNȜ%ʗ/HB|=|uvRgnSdk 8hvLY9R僽U((,J;{.dqdoɾ=mbu 7er./1S0 4\íErΙ/9lT0ǒԁN' 7ς?n.:R*,/SRTUH_;/(.L0UVV=vfo G/}j;I*Gs">;S+葿|WW;ygh|YWNL}dܴ/$ֺ;zF)7HdP|+=k8 S]{eںdZ^6uTE+B )nE[)s;{$B5 = +<{AտR.*9uGW?~$ BPAD'IK)u|^`}ke諅W3 7/8+ 'GyNw=\L ʬB1 `*P'8`WW]dY*Xɵ @5 kV<fߠ!f3*lqR* mHy Bqo1vBQ5 9333]]KWfff:)yx䔓s($I99NNN^؅֣_?ҥ̒sp钿?š88`?!/?/-=-0 ά(-܀) JB==p7}rIh%/ygTg'+t>Uw:KMwNX:keX*,em^߿vmҶ>l=J=cG%ij=wS8=ߗw죗|.·/);cQK0ޱrnk7 >-ztoܨCL9<~1,n?ghw|GWKpT!#h\^N[\v+ݦ/Rw=Q%3-"n@2_?ǜaN%_E:;cNZ~kׯe77Y.*mJcW񰶍ty*usԔZl΂mL>˖?|i2r:lWuv0I }SE+t!FQ?;ͫgl۸hXo/]r"Tp {!rL~w: !9_\UeUxJc%zIpd9`/"D`ۗ;ҹ#",؅рdm}/֩yj56u_RVo'o8SM~&ѝkY;*:2uNe+Bt~/JVoN9Vב9ЪEF5o7 Ejׯ_s#$I7of۰&33ENZkFD#_=~Dӝb.l #w ̯>h^rIZl٢ee!cmtdT]H3:QM[X"re#ڷj[b(;mq R=UGCvrzۦ۾`P-[8vDVQu}cs9E8tXȦ:kR7rξO7}jv(2*[g/swJN;ɨ/^S go<;S>?^[ѿsQQёQM5廄|=%;kWёQ/8o.x0'nz~W*cgGGF|qgB=Wmݬ/e}:~|zDF5m;|_]I]7w|eSϱDG6?֐mui^NӖ:IBS.ܹaTtdvou( F7lf. !xHQёZ8`)Tբi(l͗MVF1Ȍ7kॷgzdKgg~i״t*UGԌY-M,_fDD͈41qESzzQQMz%1a'EEGw1I?/׾ydTtKݝb~Uxպ-_n ϱc_Ov|f #5`Femc~K 9ݶQ5G6}KT؈VY'7LdTtcL0> z`Hrojn_#ZaLnƴ.ފָThå+WZGohB9ƽώ7|09,Ƅ6~6]3'߾9997Iݫ盥JJOO_aMV5uZBE6&[Nz{N|ak|fח?SBV~ܝXa֬Zh`3dϽ?}Ƙz:3>r~Ifa_{{0rc ݱKs$IZ$!Twۇ0j!׬Z;hw컩+[^QM{/:ܮ_gK +:y"ZzهI)oo߸nMV*Oos>@P\ꎜ;H;o5ƣ |&v8ig895նѿfkf~?8r*{a/?3@p,ya 5Sߥ9n{ s {I _RWyeT|[C'5xuntOoŐakrh:c>TB9n61UϯpEl~־c6hGve~ZIyZOI[cc_Σg-]rM3֍{^駞sBasgjX81"W.&Sꗃ_4)￠m=i9}!}~՛|u8+E6EGéOW]oǃfl8`0]9dF\2wK"dk?X~ǯ>vrթ~.LuYG_>7{wB(-l@2\?sMobG+FuoaιqձfL2RB}`x=g!ZGg* `ڛ!Zi _o2%5ӫ[...];w_~MJl~kpA3;o_]G o6._L[Bh/k"_}C9/Zh{,BSmԜxL/nU)S߬u_o{cƫM>סe^m]})BJd@ƹ]D&Ö/zsVU(ޘ9ŕ^bKBTr9j#n) w|ҽO KՆ֯_5C -PwmQOU!4svZ+z7061D׫װYaZѻ{xxh./+'cV5m/?~|Jv kulH&O~^{WU"7~7[TZ"]^srBhCߙ5gF&A廝*W8ֺ:TZgOwINjcHQ!2$ns[7 W2!̍&c]>񭣧2]ԫ,Bj6r (~hulskܧ ) S)Aa~U¥nިԃ'E^ўsuP_m5ck+34wpJ:!Jwvcgi.=ʜyOn=͏V S[b9KUmJ݋.)i׆{G!5åS_i;>joTeӗY[xu/B.smê*`ϊj{bego}_Y[06|xRyZ,B1Yfamܳӭӄ]4ͅϬSKBZҨ OheٜqSRKFkYD8;B5ws~8!Ԏn*!0&*Sl\SpMy]ܕu=G.iJ[b#TIDATuU%Iѭ4 +Lcu4:A-hVӾjz_-YO?ͩ>x֪KS9;Uu>TvS=]Gvs}+lTsN9y%INK7*]=?U)K`U98U2̆kg&ֻ闪3c\EZIqW="b6ɷ>6m2O;Ӣ1+7tXvȄ+o뾽+oX۔&6XWY:5;.Y0]9ɣ>fʆϛj={jRK/==VEeqw=yH-ekm]Uo*j7},]^ʻr4I>막"Y_ĭ,kӶ|iY Wn?7k I魱U1+ {юWby"p0GC&Rd~PJ}CڠMh6/Lmd~+{.~ֽ 3̒Zz *҂($OV{|}.O_JJ;߳˛o>qT rFܡk0/.| O/a8$W_᫓7LC;$yz~/7z ._|PՃ1]@KAɍ?|U]b@ W^%_:aeo]}eֲۀ Wn|;y9!lt`*Mf!0%=_c.j!ۗH!uRٙਫĤrOMC(r)e4 eYq,]mᓖ[3#VZY3/S2nE W_z ԫjF/VN۱`Y-k|˨]y~U^G<^U~'c Ys6OhP ХLuR rjq6)oV9)!yFt ЧDC?O" 9B=x HFڢ>2WrDY5_Ymd27ْf[̎n][>K:}Px1xQY߶{ck 뎁}2_[/N0VTe>E[΅۾=x№R ܱ|ZtxcU0Y='S3VneU]Œ~]1*pPNl =GS/M\+fܟ.keJ:Ϟ.\;aUݱu|rԖez/j/BiJ[MolEh=3xɠV~j{~ ߛn>O\7bس#ٽsvqbBhC^ymsβ=y W+݃gk>_[֤l<8罷n1cL6}4kkMΚ5DQ 9a;ff\)|YX:dyBC}gΖ:|gv^-}+f{i;-]9S#[j[[>S>1Z/WIX;~QaڒaR9_ >Cr)]a^nBب)nԠ#cܧFn]*k]A9ɥ;>kګRc҆t]qńh )ݠK*6G9ÃDj}4_yM7 B8Eu2oU'+ݻPuȋ#fOɣj/]}^>>~`lXjV8֭[=Yξ/\^BʱF&vj݄H=bLv}u+_-VLIiXIlSKOο;31_jf`h5x(/v5#lSj23̉Z_k%^c O!*.<']1NGo#%/e VڳrwtV+pԭŐ'"_u H;CaXȶS!w V(Zit[wjW۪?Q+<[.xyyQ886V ԊZu xcp#hۈZQ+jE8o`GiA'eQ+P+jE@T@STW3WRb `h@ *6ӂ; ;dQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL&+h@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- %& 4 iAЀ@T,1@T L $`` HDfZ4 KL& %=(h@$ZbR0;J $`$`w@ *6ӂ Xb2XAQ HD D  ʹ h@ *L *VЀ@TlAQdQ$`3- _LLL  wM' H @T@T@T?}]{IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-plotter.png0000644000175100017510000006655515203313266022302 0ustar00runnerrunnerPNG  IHDRAtM pHYs  tIME)[| IDATxg|E٫ɥ"UAvEQA,(6, "`A1 E@4N%!kϋB'W~/岷7;];+"  2d8p B4(aZOr(\\v)GUo]{|gTP6@-#3ܨ&6u:p3BCCcak&:&t:]5jOWnP՗!T f@fj4mU a*囥"(dcCFr%fw" *OPxDA-U'"GQlPKUT=} 畞^V-I;v߿2>JMI*JBȦsX9xs=iVnl޼yÇ'%%;v('%%>|8;;2V~8^NN&N,ּ\⭑MYr ,P#| 2sMV!T:OP*GR-~TN9x"yVoPBRpE!g߻G}HݨP^i`-^T֔q*LUN˵z.zl8|z*$w@hD%O qupWJX.J%5)[ԍ I/ HIIIJJRT%%%EUH?SY.j&BŒs.dRv]1夜>( !ԩC?Q̡35|JWJ(Bb(/ZsVӚx>%+dr3s z"7@^aiuW;%I  uN_yM=+ |EOQG !BCCeYNNN.QG`cZU2ɑ O{Ev0!O/ X33ͲєF XM6 cITBa)4Bg5[$!q[1+ KRs ulԋBQgQ[rsBIoJ| ]*<u{5kPooo2'V:t:[6JK9a9{h_^F+<{YA2囄*OwNѫQfߟ-)V媟F%t4o--_It2˚u!b2+BB4ORuqoZ׍prKKK]vQ[Q[@@@e8TⴾUx 9Vwa~J6 fS rW[ ssLBPvFR{FT)fLx]-AU=uPLF*::l2wHZa>uߔ h׮];JTNJBrM4aО={`xpd8@  2d8p  @d8p Z4$rRJRBBBCBT*[ns |=}) \l:pNFsT >~AXfM&!! M!aVYeEQ\KRHhع]*oD=??v)QgqP;_ w6$gqp C 9d'e3 dțykip n::o{Yÿ|>2IC ͺh?:xsr6ۥ[W?`u/،%_=֥t1]b;uӘ./NwAv U=gӫs,ݼX$}s^_YJY7C?Y|(FU 2꡾~yX9ygǣ~wG'dTB?k>jK9)Ƿ^{mOVj!o|w賴>>&pەR-{d![LXGS L̸lJƖvy ˦|n#mYSŸ"~kڦ/O;ӬTH7c4b)N]VT]7Q7E~~mKN{h[Oα}PdYOo_HOMtzMSe~G>粎B{XTttW,ot$g^E;tS¬WȓHOtW|*ߥk&P$2tf}yAmB]SdC^y*xfWLG}$F>:8d"57\y6'WV_w|ZQ Q=y譏{? Z=^S/V3#cZ=oOy9|Sm57LmfdZ|Wٿq^[%9a>\-NaMXwL|@uⵧ~3quJ7XXnyF:mPMqPO! ~coMZzkږƩ蚷ohWZy_(z?oašg>O.8]y/k7'6#˩6׉3wjxzöLyZ pR"R,&})'-MպM w{y(lJMӺ#zK|jc)__RO4eIr60v~ngڽBr^n)W͑^V֖!4Uo#U5JeKfELcwQgmB{מ(l(4v_gBᮑTzOooB[S=)po[y*^ƊM4BfC 41i܎Eŗ&Px,J'\˸kk~v0|dkI0utf:t䘱JHprz/PB/ u*7oR{i1 vx,+zl/'|7uR7*n 9i)__Um[},t)'VtʃBʳDZdc)q:'/ y'e,<9RH*5A2JBIᦖjI!Tz>b2ɍnTUp|V$Tz$$$jISRiԒ$I*7O$[dQfU uusdt˔xj5 O&':݈ߕg8ZG,[Nuϛev ؛ТʣU[K:Ǖyg!%EV]GO|~W&0J~j_W'DT]ozȢN{*ZΘ?Iv XɇTޙp5/<ådܸ)>=a}T>b-Vݺek*|%#o[{e9뭕(NAŊcUh=JV4|P׬g}I%I$$I%&1J2J#,KVLYTMUaKlGlm5 ^wH6EF~cj$o6,k/_`w\Y$)(|jA{mSOoQU/S:UHJib臫߭/~oܳ>-B܅PdAZ*g%yz{tNK;MU!PԿ8)"^o0qߕzR7Xu(ýKՒ{)r#9ұpӹ6/IPrE{|o{-SX3oQ5 $BWW%ִfkZV4YګVqժz5ϛb܅.>M_vggɗ:zFDdm߂MkjbL9j9?פ$,sT`?\ip=b>{숛*/ >ѳ ѧ [LBTؾnAɷ@U?oC-rmU|sRb+76l>[׫̞51fĕɴWZQD;¥Vo>K_~ c3=zy[Ēc{~ݧkwVر~abHeD%Q<**Io\S_[OvZz˔$k5XH6~Z^MzQGz*S4ӑkz$I\WXʷiO|zh'WeORA IZ1=~C;^vGJ+-\L}t킅-~8f'!3i1ÅGhփ}O1#ɼO^5NmB}#Ow7KZpt3?Z i3&&#\]?̜ͻKeUeǾݥ++ڍ?NxuQ5$P+e!dzoNlMݽ5f%/E |&ݳOz[ua:jڛe=Ƽ;0MNe !$0IKN$yi.m[M/IBڲU9 is^iƞlʔ"M-ʺjjg_}]{^*I㿞2Ϡ&}?3JYY?~I&lM[Xc^:Whk ^oriZ7L%k٬t4TB3ߵGjuQ{/t".)9ם WU"P\92d:M8Ӷ n]x_ 8 p^X6 -X+al( R2ҵ{b822 7<i 5 ]bBCsss) \'%&%vRB g ) \[XHpj2Pl6[,. wY,oEj 2pd8@  2d8p h(K(x>1 "IpJJIJKOkܰq8CG !BCHEDT xL&Jp>>?pTD F#EF[l;oͲ,;Ӱ#@ED+alEQ( 6R\ GEP*HeY)C;f*"2\Pu[PQ'뇫pg_O;=[=gO{83nϴ]|w^q5uk}^lC3:ju5ʭ`bUbr;ۣ߈uY;߿;!g}1*(GªTYp$qa={}9dlD;yP'?iߊHQ7PRuwy[R7URB)#y#wG){^0Yl[A*"k谻׏ccJKh:׶Lu2:w JYzᕬHۿro"~.N_C٫(77Ȳm&7(u/5o|_EKtb˥HȊt͇T:ų}=yh]T(eE*>aLZȊRR) %É+"뇓|[}I鿝3_0eb\^Nْ䉧q_'CBDl[2!ܒQ1)=mWS?lB;avk-t|#1ϭJ@.*jV%&ܒit.1͈7ʹG~Bb xfcb<2}뱏อ{gvo3Gx~~Kzw}3Vl(Ƅf6Wl}=͢(r O7c3{K喾_gϙY毡wŲ3aMZ;42H7[)~Lf(BR{GԬSn^zhX6Nٿ]bbyeZZh_-&秭O6+7}ƀ]{9e$r_ֿKLl/MZq"_.^~|=fP\N3mU=G .E4>h<6_Yn\?#?n@llۛt}b}nºuBXR7#(ׯr8\ 4tM*c]&urj?yG󀽺7WGFXo7mg[xOƁs[5;)*J%$UŊQV4w7XYck{=mD#w-sooF4q֚=Xr=]? R9ݸ狏֏0^I_6zCw& SkQryo}.7?k흼z da-1DZ_̝P6+ IJNZ1c XľczC5G>;mcsZJ7]Y?u[G5ԧLUE$+e*^z!˲ kBr}:}⼦_as#ߎ0{_i6A] 4G"5ߚFWuc|1"|C?䭮g}?uScCAH?>f]ʊRw KG==IKڈeueW_kъX~[8`XO3z识:Un5 =wp3ڪFW7qBtuYW.tOԱK97Մu៾[4xZ *"sډ9VՃT#lӊBϖ%o~8a\=wE|[yX٘ZUsGNEћ$abC)9_Ḩ:_i$mmg:D鄈|=ϼ˞g7❗:Ig~_^_]'rՋ?=l/ҭ$y4P.9z`wxm!RSE׋|ݦϏKÎq,K}EMƾ/\-Dp\n0Bl"<.8צZIB۹euW[?9ӟIl8rV S!ܣ5UM[iݼU.mk{$Ie(v\! '7?-zd2ZE植Njپ˷z-VY)ۤ.3g~пlղenwHQ\~lBcY Ozwg g4YIdY{K¬SrNQ%dL: -҅;b RRK,KCTBeYHzV6Y.NM)7Ƚ%(K3\iu$^+ "K;L|[_%u$IorU74XnԳq% e6Ei+SBBB-z}׮WZٵnnn,xWr:䫽_T"[9ݚ [vqҒ}MUDHfC}<ط͉UT,+Sޟ%^_JXҨ̒ZH"[ͲPIxE\XEM K(d!+R|аoWDz܄jMVD,]eY(%( !VYux*pȱ2~S?|qL(0ٰ1j_mB(y=w՞vw{z?eݟĆ-`NtO _OⓍjjoeXEX(B\+` GP51!(B?'4H/jUl /!qT\O’uV9Wfye.渂+Tewu7[.7; ,ۨXE$k`s>ml&lS)BHϐ5kZoO_V3=lD~X . Y5T MF|T\(B۟`l]G'Rpf:n;Bcфie"EUkѪXLVkKW_\AQ0%?+ϸ^ 8SEdgΚoN7}VjUdžxvPҸe>aCjMkOW|cΙb_v3ഇJn7u]wW_L>$s*2ܪט}_?TBWdE.7{i|a&^uh,o]?IB_3H_65֝EV~̝vR|-!MR}^/^J^?/.zNjl[丂ӻzsǮ*wBYBQٳG{v;k*"qJ1'G~*?T7oïl֔ RS)+.5Y_k3sfY >u9Ʋ,q_|SkxH%ӷ||a W(fݓL$<y oNZ,˚a~Zg]xpOYk_ŝxE_T)P",)Ty9K>wGhU\*"{pj_sP !T>LäK %tiRNonuSV*}ITj}#\ܗ4W/iFiJ "_ݘ'fB{_]/ƭѸޯeͯ{kEDT*T]>vp?ٯ^ؘjEQt5npgl6@Wg/[fx<.I/Dl~8t DMXE o^-mQڿ~Wt U IE$tK)Bh»|ĘYGԔ*Y]:&.A³#N۵!ztlrd,E+ofN5g|ɫfǧ>Cv틸Z?\ա]B( 2tȁ?~>QիWB(Y%Ũ iИJq*pF,L[ۤI'Z]/d2ю;Zlyth޴9󍿟]j%ܮoCdK"pva:=AE*"2ܥ :='p5oƏAI ݩNEDTxXs>nz7Jp̬̈*"S.'rDHiAׇ9͈*@ED+7R( !ȲlXf|#*" WfٙN8Zxd8@ vuRW\Iqw:UB 0 [zz-R 2pd8@  pf̘A!pqqq@d82׏Bp *R2p ΀yιX* 9f}tO옗 ᜇ6cÞēBd8\"(3f\ʰa(yε=`,\R2-&lU(`Kz',By~m<̗ IBЮ.ivn&qT ܒ - T )@mp@r9p@eհ@d8]0/  a^*@d886~9Sd8pMKpn"8qӘ @p#pQp@9NpΤ R2ۄJprǼT +p8d8.0)\ڧ9J\ ]q(?d8C+ (PNKphptE  Ro> 10pØ 3"኎(`JqM6/"(ZjQpWt.8pÁ*Ic\9(Rv 1RHr2@+Nrœ|^*6v7KK'b[Z\,ɕLi^wϰ'Õpsge K! 1PwNp`19[OF.p gUd82@ @f8j2yt݁ 2P Mm7yS29pg]fvod8xpmN8/ pp;@"8TF8@'[8X@Ff48}2Ntpd8pR$zK1\Lp%@t8m74pΈLƒѸWdܸfBݮsޗX9Ķw6"ny tC>/UQ_\Βu'ܛݭU{\']#CBj4k3B9L*ATN[aocrJ.W5d8`LB#$fYʾCWz]sB)H9_Y5傀b@cꦹp9߬*ZҺiB".\k)%noMnb[]^:;v(e˖@Kla'v#\5 !Pew|?)]j?o;6",`Jk RdѪֻi44hY+ q^[O=sy42i}C6\`VJ;d27\Ke8Tw{$'صioZ>*aM݌W4~#2vo/! ?j Bt!R6EՁͻw[u"ݹ{c_V(B(BrTwYrv5 t.˨wK1 2Gwdvа%ow=q4@Q"@\íT$rh(r){pQ +6y_I^ƶC'[\JX~W9ƯgNWʖ X9J\yr.~6\ër}/7[HYY?~I&+W0܌3 F=Jvo״Rv]ɲ,(*WP Kةn*\ Tl]w ՞={`3 GneUFzt-d8 p;n;&R 89:BR˕3\J'*mRi $xК" pL5-p 7 qvK%d8y\pyd8lyNef%2v4/J 9I 0-T (_lV&5$.t`TRvS  Ed8n帉 \jKr((8j$u (UvyPУA@ d8T"Nh$,p fmn!akmRR+p\S X~\;VCZ( p*RhFJZ,\pSE1/ @lv pXpyNԑwoUqTsp5Kp4UKQ=2Cs€\d8R׹H@l`[a^*;@4]3R zmC?*4żT be* 6cDC Á"d8 ytɃ] ˈ50&zg侼v͜q4a='6>tyl2@=EWP2GA {p̳ƈfUJ_ LL@J.$ApW^S莏glϒ!PtgH:l2 p::/U[ر)#_ӰgkYT-- 6"R2\e}ھr<]Xz ӳ{p 'mY2n\pJdn׹]mGwlyLzհwB4"@EO}]MjWѠ]vḡK?֝poӻwkVlqr?~YQ܌*W:frNޱ~&%gv <7kze\.6lxqf5X28[%7:wXvebZ-;rpP.k1=ݰ"CܺW);Fιˣ"3g&iUB $fYCgnv:tQ[i؏6"$IHheÅUraگ^=܊N6^S$F6Z?r^JjD=Z%l<*(N*..B|pւ\%ީFܚXa=4yM ò| [ -OT5ƒC56zP҅(񪉢35]/As31`#74u~~en=֧"QUk MjV֫sS'gZ!.:%lF+'0Ϋ'_qTeR!rV%IيW=_^~.1OV ŔexS܎IЄe8!zM!#8cKcMwPC5QQ{vn"rj|Tš凟4䁺&<o[jꄝ[ۇhTa(nsoP҃ukp t8p+"g}uGZU=_ûB T6!o֥{Ht}UBXQT%ivٲ򗝒!aמɈ֏Y*E?ϋ[GѝEw84m;u[#{lw=YRv^%h7p\&y7/~ w<bcN|`C]ζ*kqokQz;0hݹl25ؼAbK3W6JNSޫ=~b^v$U\>B=M#P5 wU^]?W'>aU=l0nt *Ql6Nr y zgց+-wvci[-Y]c8vx8[=r$׬{Wm9+zv 6GW@)Cw-I}2zCfl2ё̶ O>:ƧO4b$kFp;AmS0ugk_\eJZ703GDM6UᨩdÙxዓ |SġKnM@  2ݭQOBf}\+u%ikaQ-+gě ՝R,d3gSplݸ"p[kp`l א`w% Q2c ixLG=p6$koab^*@rZw~T5ZUI/w%Ǘ gϴb,ņ8ӝ&N<ܱcNJ~U{#@#R ]̣Ջ>|~K'SH IDATOnP'9gdTmAt8w:Rp壘R6|̲޳8^N[Y3R NPcpuƒk ErO]י<,l"..BI*}pxF4V}e~8[,}:-+'D-`p9'۶.o˾\uŖ,yvrױ_TB\o1 pW`/;PQ:2V8A4mԴͽ-:Y%]Qn%Ւ.S{c&n6l͙lztBRGgcϷZ⃦B!iFjk`25@ez;fp̳jVU5 /\Ұ'6n 9e?Lخ;&aoc k?mݾW-y3Щ`yׁ%*ʿ]z-\jϹ}cT@%a W9RI5F_F8w. j02\2]£+J_Ӻ󝫳 gIٹzŖ7+V]\祂 W9tw㌹GN"RώY&jj[pp6έg`*;t<:md2:Mn-3'~e͞sOx6n.rʼ'*]3ֿŧ[4z1%;prnp.NN^hkڷ)}1fc qHd8[6X60LF;sj-ǼTkBU pW™B칡*sJhleVXy*bASeb^*󷓝ocܲ.OOʾz̿zjt56(L3Wǯ˿dE@yp;*2-2Z/X|UB(VcN c'dp3āJMxpE=ҲwgF}OZat^6TAuNC ֘}ohԯNe UCOoG\?֝3w5kVynsYS n] sZlk>e8hsB&m^Y|*F9-z6V8ݨ!Μ{պt2<*@YBT%$!`LB#I̲2\VqзÃs7g/^ǼTO_x/}.\2MyAWl9߬ PҺidcE)7.ۮj{w i^ݲ-3@fNX=u6jnyfvQ+No&n+.l=Yfϟ^`ֺ_޷A ر-[r\%B'rgGW/[B_߂_lt9;g[猸ïéJ:dѪֻi.Zj=)`I۱&mp+/LGe@p+X2?W³aS漵a;w7t6@ת57)[]˫ݼJVRi=|T'cTy-i E0[ͲJS$ʳ_'GEyܼLr҉]׫֔-͘|7UZv]EMJd_A_[:yyk.]dC;wo*EJԾLp.\ GdJ`I_Iw27]|Q!І}XE/.am/+ໆ<˾l*p)׫nM:1㙇gKsc}jqT΅y|br <&pcA_p' npp64n$H1ޒb8 ?'ᖝ2W;B\\Byd8&Vv <d8@gkٴyp  PKpgT 2na7RJQ5`_geo(>>57RIB E"r"ٻyviw*@@z DBK${{G A y6?y;3;ٝMT %fهL}}.c |  >md8p@7ߙhvu.08c"\9֥d8}I hQ 3EY0*3w@u8p) !Rd88ϵc]*d8!c?3=@\K:MidS H[;FK%c]!md84@ZH=p.2p&Z1{^@憽8W[MArcJ$g@kĺT4ϐice1ơy w6x 4'uhqWKD:2`Bn&a|3K~d8VL관f/g]*@t02q&a7X @࠘]2Gł1p8:u*S ]+v9źT >m9 NDk7p7 2c; pk=5Zd8\"հ0\ Lc;gp  zk֒J.Adر7-$#{ #؉Q.KfZS=O2:Vi27yyր.j}{M_ssoҳ+lF-m'i& vYJ~!кyJʬzl Kq%<2ݓ-EkeI'joJՙ怘H7V|Ԋ4H%YVzt,~z\$߿n I4.Ew aMlZ7re:w‘]Vz@WsQa,ʼr=WVc& uԧ4˝<>2tQt`SI;WD{j WU+œ nѹ {gi-;9vHզ=k5I΁G&EEX+ +5g>xP=OS;0u?wpGa* H ǝdϊ+( F.{0*d81  [ NJ)d8H0R2<^61  d8a]*@p LgpźT 2~h^\tqIK(pd8`]*@\?\epG..  p 4=|[K[E.Ae#2RU;!Pezf[=S# dRUupԐ-8?!CWOq?z堣4!I`:JFKe`2. .ߨhrt  @Mutptwe~n-=Eݳ2M -V ]8hV s?AµT!&;ϲHL>U_ !y1*ư.ptwc4'8=_=4J@ǡ#ɵ0.1Ku>~TeO8?m ́y8!> ђx@I3+  5M]9 A0R9A.X4 g?X К4tW"p8 Z χ՞!Խwd8 zY 8:ud8p5`]*@p. wc. R2pkud8p5`]*xy)-3JZи!#9K G52g^;߯[' 9d5VKpp2!v hӾύYG2 q gbABGR[a`=~zڢ ;$^߶p_Sz wHR㴤"+ڌm…? RGǵԆfp V*\ )*T(P2\,Z[!yk)fN!P7RPR> 6ʐ'1%܉wdž|8`!x[7ZfѸčލiv}``}\\Ux..JW%_w&''ng* p?R[RoӶr+aZ;XҷR3މݛv=W%:1+iY&cN +Vs3yU/݃$!%);6I+\:1Zcݖf6]~.=[mwטmݲ?Ĭu2O %&pCm;oqt岃+%^xU{'wtU݉FNڶ0xGv4g$U6]2ݶ*;k-jTզ,Rh^ȆR%m~iyyր.{j2v]QU4ܵ]3wY;R[Oy?-sϦM5'vlNsl%Ŕug}z멳)nFIښƭ)A&]OEJeƵI/֭]l5+jmG47ҩPKƑkӲ% .wێلPemd9pзW65EZP?m}+a6+õ>͊ΨN:a6˪6SEch8/jza(Bb[:s0;Mrg~6M7wE۰B;Z" [rMkSLl,nsc.NS~ڞ+U[]ÎJuiv3q '%11S66Ȩ=-&lS~Bh#;Wݙt*/?}c|4n)vt,,(((((U%kgder}t:<:w*i hO5v%*l}Vnڟz:+[ҕH7> 6ʐ'1%܉wdž94₭Ƿ8-ֽAMW.=礈K#"ң:eWҙҚ̃?Ƅtp=W ڠM]v%̃{~>m =jhG/Z\K}TV*2KwNwuƁ}k#%ŔTYYcWtk맲ʕ$kcGN9c2tLPgиKQkwN:Ih݃ ݓttO6(rw0%ܦϘ}t)sdžCRDq 6g&s3F毗\ŧ֞ER W ]Ŗ%$$ U+..O%''nhKA82d8p  @d82p`̴|=| 2gG>\+CfnCK*~;]U2rMaQ|_qd8?Ə|-vG|s өo*ISؐG !|5?ŹHNq/&U'-V$韤\%%޺BϬ|fL;7It=zoO,y~nmܽMxuGL5 O/F9 ľW6:~y+?+SwxؗW !DUKɹW>&?gMK}zs_0W4{̴e/.6՜zٗGyU!R+o񜂬o96'Z/}vk'Syׇ~/B]nj͇e+;]n*(ؚ#ϙo3)dسu޺s6!>YcB Bۣ %LhU2w%&!+īky|_&9v(/ZNEE׏1gKBe^ȊBhhU|'PԱU9^u{;SZeAjumѩ_Bi%aʌ Ϝ{,W f ͒[QR}>|q dvv9oՔT)>~ZwgZ,Vɗ'՜N;,>?Rj1֣ <8@;{X IDATf`wgw{dMyN3|/߮x 3'<^<}˫8SKkeSmp*tv73"pMf'\]oJHH_ŧgm82d8p  @d82pړ9^$SƜg.;cmQ-Gͱů6ܳ4rwﾘV/9[sѪ}g]"wu픎 /r0O!v}ޒR̮~cB9iϾO(ݾds]u٦yU+f{frtVjOEkJ%߮>ʓ#M5kYm/H윕=x/͝𖚦NY#ʷ?fOʙ/vŒUhQX/;^{WX;t-Z2hNr֎z|T 7!}iUsXO]o?{HE sytΣ:iBK7?nd20$=m 9[c1?x6X["fIw˞/Rhw(ڀ1XҥJߡEO.1:GG#M;xa5yK-Zϭ3wQ9X=tOmX/tY7^;чFÅ 5g~0e>KOj~:!=쨙34X+<:;uwGAMB77=?n j2Tstox˹7zROsnzgc]]O9xÞRݿ;;%mB[KL_2֭;w ъ89 o 6;>ݾή^]4lrڢWOO{S\XUq[q'u iڻ9ᇹŖZŋR >߂km@%Cf`?[}p3򓭺Jqt N=BD֑Sӯlxu w4 Q]YAz 2yV!}UŌz=BIj8¬uvdPΦ8Gv !>[6'9t7WfL$2 h?t[{1O>?ceI'FREqɍdEuP K^J>WA!#ܔ?wn}Z}4fj Yǜ}l6L|O4ºz Sk+ϤZJi}d_{~+2k TN=zcgoNJY?4YLaNX_rKN\Uݩ ZgOt 6O nz!t|޷>2ȷIQ*~YŹ\#no>S?7/FJ?UiE JXjx3}% -ht}Гzl>1ksӀX*mqk[fltzw?ŏbssZ7[Y&lڟn 5fCFxJB:ܲa44/*+R3ݭ$\W{MofAyI UDNޘve TVڄ#& D;ٲ7=]&vy_sw,M#]\r"$+K*Յ(oZ\w3*Ej\\ӥw/?}msqq7[MYemFfA!M6xMbp~r2zƫ=ܛ={HǮ!;z_?9SGD](~_O\K@%tNyֆ&"*22*22*mQc s!&4r:Uи6r4SpPoɧhbY!ڼSQ lB!WdeUk쪗y춅)KӊmBa=%EJO?M~_ϦL.%}gNx$\Qze*5ZM\(.2..<* 4%&X_]r\i?]O' Q}qvzw?ھl5蕋|q+^<>?0cѫf x~J':o~yi}_@}!h:˄ j@Q&/_ފv*7!zaN~s,W#,+o#ߞv$ܱeЦ)T)ғ_ٰzT.ڎ#©+:=>$HwѢ7ϹKB(U~smfS`d8TBmDx[3let+ݿSeo3<>[TfBm3 ֛\">c5BDkesߝзVپq}79 gvr9uL#~i]-m$޽27͟`֌rwW^3B/YȲPS}4=L!M~W;:956K?j4}ڮ\pҢ1pzT\|cB8&nN]Tiv}``}\\Ux09o'- `s]%{8Ϧů._{f]K8˿*?99y+[^jhGͺ͸_mKm;\cl/M{@=;=„Ϟ~}{m1ƆXͧVⶰYύkm~8Du sT fg5McpN@ 2pd8@h%Z漏3㘇  2d8p  @d82p  tWd 2ܬJ Z*d8p  @d82p 8 Q? IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-sequencer.png0000644000175100017510000005351015203313266022566 0ustar00runnerrunnerPNG  IHDR_/iCCPICC profile(}=H@_S"U;8dNԊ8J`Zu0 4$).kŪ "%/)=BTkP5Hcb6*"~ŤL=^s|׻>S&|" xxf9XIRω #e8xfȤCbf%C%&+FBegRc{J4GHBʨBV)ڏy\2`X@*$5 )7)_lcu> f?I0 \\5ytɐOS(30x qd+Rǻ{rk&bKGD pHYsttfxtIME 5;4ϲ'tEXtCommentCreated with GIMPW IDATxOhY/iȝz)??rńyFBKt"ICFZ`dƾ$ &kF$`^izCnhG#w7hf*թ-? *U_)2Ο?#ADDu/""b "" ""b ",S=O`G|D-j`A/f,`3c1X4\:^",h[tCSHXGDS==x9@OO,BJ\Rδ GB,G/fR9RpiR.hz75M]]N^c&S6Rswjn-&/|3̀B o~xnk`w c%ױ7Em9y@%{ȅK/_Pgߥ?ޯ;o=&-&/588{]4[hch/+ kIMDvfܵvQ9Lp x}|]bFS=7鸄ITuP 8`/уR^%f]=/,k n<ƥɔJ""z$N*=JS(3djKF%p4]dj `w7.‹4z6;⧡ xR7|oU57;]v;뉗+YyBkte{RNzx9q;=uUM.V:i׹2^NOw{Ǖ΄"b:jo'/UuBыuj]<K 8oL"鰽'=5$O=t-4>@W %,<մws< J!Ur_H%5ǵ.ŲwaZ/nx~T R R Y2RM,Undi'51įϔi1[)dg.LR)Ϻ,4-K|3xu>@^xTBVwupjOqܽ`LV^&u <l=^y$*׻LL,1eUmOPYT?Jntuu:wZ|y润 WO;w|aVm'yTU0"":Siz_*--=Yy'aJm ݰ\Z@޻qgpmj)5Ir-@jNki\|>Ϲ! hWVߴCl%> ":C9&j',f^]g]v#+fo$JD{!}ךV/>|*D3xuM`j[_{WBϼBT LJyXvtRT>%KgR3uR˂,L:i(""b˂,,,֊޽ˣIDtB}'#XG~"DD'i(""b "" ""b "" ""b '`0`0 "g`.DDD,~ ߂2ʉoD|. Q.\!Q gr9]KceއYi,a5W83S>̯0Zut)M[?,7`+25ZaA DD`ADD g@f ylo,6lI203"":k- 'F|VMC6Q xI9Dq"":>8 :c ,0D9 < b0l6+FppZr(4&"" ""b "cp}1tߕB %n,[!"0V.ZЍ}qk&+.g=wX1\{p׾M!p`ˀ; brʅ˸\~ς,9&j5NCT*0Q#LC1X1X1X}GW uE}`B{p7"b˘ɖP*PյR@wHe/ɝ`!˯;%ӯwC-[p ":`W,ÍO?5)JJFN-!OsyT@H U,My UY6"r|EZ4f[bkIz3WE߻# 1i+I?KBRGKϓK br sRewkԴg|.Tei'ڷI餙Wb%JY@ܶ-(eX}8rJ%)9P(U -w߁kflwyBxeu8𪒟T]`&[hs33re^ Ҳ =s!8v]CR٥ .W6BJ-8YNC9}r-}8Z<^7oW.J(UZL^</p{DD(X-Wפ<]<܃ R_'e?u))Hͩi =_H;07 ?{*틨Tzp9~F_\nՄnHEWזSP " ]yk/H9ncJ*Ǐ݋[Xb3pMI|ۣo!&')$݃Nl+YDtwV .NZ:o0Zo{4iaU},,,,,TVt]M"믿>?!":a?xLC1X1X`?)`_~$u*44X_o7h*ѩ R%t#W.\.\Q sl@"G1};6D`ጕQ.0?@>æS`ƨm;ym(">ADt:EKr[ ϯb 6-0@v%""`ߵȸSApCh$p!*'0 ",~ +1RtVG:RT ;l]}I? +#(TFpc5ޭ 2b ،l"NlY5Z dj {A`t,w%5 `a ,\@`Q PXj;Bꐎ՚Cko}6~DDղ "" ""b "P,c>"":y R@DD0 EDD DD`ADD DD`ADD DD`ADD DDD DD`ADD DD`ADD DD`ADD DD`ADD`ADD DD`ADD DD`ADD DD`ADD DDD DD`ADD DD`ADD DD`ADD DD`ADD`ADD DD`ADD DD`ADD DD`ADD DDD DD`ADD DD`ADD DD`ADD DDD DD`ADD DDt<>hugϞh5qʕ/&_4 /#VNj/ܿ˿`,,,Y0hT_?C5<]ߵbkm [!S,'n.Q,Q,1jg8P~y51  _>>/g,y&WZ E`{p˜XxHTpg/wOlG|ir!:>x5u!; 1]*jk\u\xEX#c[[<}{WU=! & !?ki,-TS7x&O(<[E2*o? %$l+B_ī㏀ ?Ѥ*ӈ-жrF{䶆i =FxRxƯto'ȼ_<}*]rƯ^S)Y1?=B-m~/X*Kl ױ7E3dJzRc\0 u_]v-Q> ]w=x|v(^>gF%~ ƃ/7{# 3c?z*E_oTv+?>`6 QǟC]wj[2MttŻ.Q1?`z)x/_PgVӅKxXv^`GުovĕRj .Ji>LD`QcT76p SiF||/E;O1aaf\.">oFx3Bux4B񃈨u[oB]I;]z=<0ZTK)`уʴ&ܛL\DuاSuhF?؅սOcz=FJZ>(4\]/O ""=w}W>,Ҙ.e1ѩ$"" "":8w}Wa "T*1XQCLC1X1X1X1XZٳgI@^;.^lWg[LpZjP9 RDFaH m qy2L~7//:*Z`]{R\#UU"&a)dX]la^OtQLpL tU Cr]vUy/ j`Ɲ޶Jװ>;!ඣRg[(`o@(2?fXpXVofa7fB?dE.aX4Wo` ET WX+a!DY,vhV&-1&O囘:a 1׶x1ѭl(m.F:=qT.En{Xk%Vz:^+b Yâ6&}],./`f Ypۑ]DQh('Ukcrj' OYQCoQ!ǪB jkW/lVF:f9-Pm#bO:v(gԎ׊PzWXCVKەZSg {۰.$a]VwߢlRS Y+ʩ& MuPb܃ŵu1Wݼ5]p%M$5c<XUgXLF_V\zB]SLV,> z|߷Xl}ι" IDAT!`YAjmTAsR. ⟇ٺu!iϵ.2]tc̻2X5j;fm{+W@@.Z~"e̡4Y!﫬WH3a,¶Wy 携!0Ҵ`}V1-.JǴ~4x_t:~mR=އ>\jK)֡YCUס 0Rg=XTx{I_ P RʌϞ=3DvzEKYx !Ùi?ٲ ",)> uʘƖ@gl@eADDвhubNkΪ""i(""b "" ""b "" ""b ",""p=X=d /x sxᓆ0 EDDM1X1X1X1XEsI19 tA:m@C',[$r,rlNYHa"ϏyD p!~"# j9WxٙbK"NCG G,5H w\U>:klڔ4~MBs|~(͑|tnZK9IaiROzo,vkaѥS-~IDkosoz1 r[cWj?+$1_3Z%%-GUk7`Teb_Bl"p Fã6dV:ե |S]We;Kn+ J$7t<\+#S:f[)$|wj&i:˒-:1iE1gebL(783NGlw#:hҨL aԶI .l ˑ:, )#iϣ| B*_.y:C7gMT*7{gZ>m\\l]V7[(/Q>~֎UWx  pZǨ\Ele"n2hvЬ2qR?#c2lձ~՟_+n-^KkX׸hV'Љ?óцq-32K JMd]*N@-gnF'w6Ք&vV]u ez+Ι2IXkȜ §6OSQ[955lqK4T9&',$rؚ`"L\qh;2g3r.QRzzq8Aג KT|/T:`aMC{5< U,!C#-,iU 62[$wxCX,3b \KH߯ hmu6/d5huEM)])G/m`7KneَCJb>zFqe;dI\Z\,G1{4(ƼmfqDlpiI/m-Ľp ")GqC!RRrux2y}AF{29lel`e^l}^O^ `;9P0 BH$psϛߨ}i% G_^R-C ,-PV  5ۤyzdw4E*P._;k`ޥ}5dSqe%DYӇQP"bރ1 An5g 0*P2v;XaO3& ]MJ0E|ʻ(+ðfW!re}{ #ݍzk|Xj.BmUЀ~\PSBf=( ,0+>q>d8uBt5~Gcw(]Uԡ=:Յ;wEQ+_RFlX<[j>/ܰ랚*Q\UK^+=fn{ȿPxլWLSV }J (X'o~u _ͽ@U#KyEuò4\ˏ6{HAI:cu)_߲\+OhUtp8'F|o_"XC81ڸ^_â5tvk(<[EsZ>UIΝk/PTȅGFiƕ}>z: GA~GYNqگOӒhv]Ji3ks`NY81-rzOz(&mts]Q;/ս.[a׽ٴatD'be>Լrn}grch8e\gE Rl?1oo9Q#O1gNcY}lы/N䰪IAGK |tz7{} ;hYБD x(:;M׈/Fx}y6_8I s)`ѩ pŠPzlTt:} Zar'v{-ŋ<DĖeAt%"ز "" ""b "" ""b "" ??a]c(ZwcW'Om Fl 颲7>U^ca}xSc˘(N K@nl$Ƶ>{Btm"QfpZ,NZ~;)Kpe|Då6zqt+K- ~6}>sJK#i9":5⧟~—_~O?_~fZTO?ByCzbųUd!Lc=%?}?kZcOWhǤ梳,>CD"L& JJ0LD";XZ8ܕy&^ !S'Oif+,mtca]؎k"2IqԥegiUqدwѣGX[[GݻwHDaSOW)NUJ( #:*U !{} ix"A R,XL#d]Wd'nVquM7&w n#kC^}B9e;qxa؍h{bxXF_*]guLhTij@(,m_pZq}B\~kUϹspR)MX[[C*;wpܹ~6#(-O`!B7( 0L(az7"EDC [fE -bm'u0(N04Gcg=iCku#` !vȏPU4m -a{aa8bH]}&`ba T,-ª> ;P䣃p!V>: aY.1T`q Յev,///KGJw:k6XUD~zM${䑭5]\6`5|t놩5-X,"YWHwgE0/m{8+ Yt0g<4R}AAK+決oJhIxM;:Յ;wtQ7a9;E5!Pe8=_#FPCEnGQ[8BܓruV}1\j>AFs-rʀ3[gןgzu*7Ú]ųֵ ת: {GDL}BQ Z2&Hr\afQi(`GGa7GM+91槅/棸7nb8 )O/w+BF>۪Z,fh?‚[a.3 _ i6<0bwaC^:'M2lE6S^aɓog&[ጕ"e+ g`#ۺ#\Y=FxS=P!4 cimyi=v5"vF+bk|64tnư2񢜢uXCH/+vuG{`;%3cgӆ;lbA7;EX+>Q=V75ڌ Wj1˝1^E>zH Y-\:.kc u%8EJp06c:gh0^)2K11'Ʈf(*CRke^;vޤ.qݵA嶰f9汢FL邃s\@,:?ijJBMi#ADRjCY^-IbeއV!lϟS#/˪49[}5ͯb "9I 6:Gt7aڄ`qv0{h'ma XyJYIvhza߅Hr,B,a4;E-2x;/+cӘMiÖBN@;y*kއ!%'#],X,X/l*7)=E\^D1¶W2Z7Dy}[ 1,YObQj}im4͆1Ţ*\'#6~{\򚙤P! , u;̽&j!c8- %T0hE("VC{]}&U|1g4{$dX{3GȚ¾ 0FUf! e5]5Ǜ71cZ tJWf7=!u_ }da&dgۭQ6M Fb0Plc ,v#F[BWS3KCg50>mgQ ,Xͩw6}27h䪎'!ȣ!ۀy|A*[nӾ[Ci5j8QL]CC_ 4B>6Fہ.Q+ڌ 6Vtwr*陆u`n $.$޽giR4G`716V}n ިW>ͰfWQ)zGV">`q;&2o+L7m,S,*v@2*wטyxvb>_gAdNPSBmjjkԲbHp%kmM,c»m}ȏu^ָ`o&h),F6du[Ut)} ,ktQ&A(f-`B|jkoXgL@5#:|XʝCx !2Pum"SNLKpn }60[>ڸ)m4r͸s i~T_0FFBUeg T~>,KmhJ6: Wi)ZS(lcXAzy CE'IDAT ="]ƖӀ0Biݻk0ű6MAk1 <^#5nc¸(3՛0v#1n 'x_*όFV/0Ys\Q;0ש;_2UL}@Rg_uń7֯g ec5< X%J:+;uYMF>%VUNmVYd֕G;$VP*fsS{}7?R^ oA/^??`ڙC8 :(݁oW*E*'?jA7?nu^lOR.r}jLlYuZ-l7lh+fs}˺5k> D'n;IEBV,َ.5R!?BUeӴ-0\D:w9,z1o{]}&`ba T,-ª>  5ۤ{;Pkݵiʵ*Y{N.MĴ!9;Ǯ'y,Bw:k6XUD~zM${䑭5]\6`5|t놩5-X,"YWHwgE0/m{8+ Yt0R jJV6ND1hƻ}0VO-Z4ށg7Ki ZE`+q6ڱ:VS3vQu 8JfHXmKmYi_Jk /0mQHrȯ.!Km^ +8䰕VMS&mT,J%2ookx4ZڷZ t5ןgzXCͰfWmmZkU#">-z90[XG0 R [f d7}?91-'.U!+;GkI"ia=yߔ_s/:GtM^j_O(%JZ5/ ;\YEc׸(aYmL[Nn;F51`PZ~EIPZh5 a6n1\K!^tyuXCH/+vuG{`;IbNYM8c(kŋ21@jD\FL.]em`C"ͼ(Ɲ]juTlrQR:c(; qZلmtm\3uUw߄Fl JRӚtqLh7|Ñΐ/^??qJ U?qXwsx/x06߃,, w_z2-a=3qtPu,:Bt ,:"/^A " $>CDtLC1X1X1X1X1X1X1X1X1X1X1Xou0 ?#}a'pG[W\`whKaɕ[*$dG)PbAۅa83ܗ4҄Za ,@X@X a ,@X a ,@X a ,@X a , ,@X aa ,?]_Է S(C a ,|g^[p8Bc?2@XK41 MsO8,;Bwq!':7Mwc0M Gg!a^{j{N]󱓓/qfYkizS)NC(=Hv994]1V^iJH1Y%xhr\6oڊCy}_e;?zܾr~Iz{:S#ڊ5蒆ńEk;ʔdiQo@S+*siu synZb-5W/䛉&'Ey=/|r<}b/mf`5j]3cl+Ɲ4s@-%O y}`ƫf?% r\̵Tܥhw{Ҩ||3)9{i+#YӁըx^*4yNʆ NW<ʶMgNsyJ>_92m{vXCqZAj+r%7ʕ/|Y(:uW +,Mͺ"7](^HX\=V)*UTeʿu%wR0U]w7G**fOںQ]^7^%~=>m˫ Ða 4MS힫Mgڒ=ײ8w)[rGU'{i+7joUSmݻI[TiS՝`^ܔkP6 3m gyݧ浬ֱn^[Go4[/e2]< a2X>!o窧~?P3T.ks[LSCYggR  6M ?S86ffdh,Z'zTسH+A_}.=뭔̤(?sܾ5|#"fz)՟~Ublc)fQ8UjeOYm?Եm+~iZ؍LɍVWrOסr{w^J;{\&ewW=i*])yд,7UZMV7۫. ,o`)E=+U s L^)ުtۚjzoRЩʑ?57fo[/-AU*LL4nJMNvgLjk~ӿ{$M'E9koG?s#mZ#o///vyzR` |}",oE׿Ӌωci(E @X a ,|^[Io7>.̧  ,A2a?'T^ `/(M+uhnzo{~ޥF%@6 e(!ni:/$C6Ѝ-IWc:Eg&}D}׵j.e^ \[oAg yCS2eK5Td)m/e\?}tM>_ Z߳bɽ˲)U+m"44: .Rxn'~V=4Oi m-obya mw;)3mu1}*)ɪ/U.O\r&HU7?׀}l\3vp(CbfSbn3 4wZOOC.P@X aEVIIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/docs/tutorial/pymeasure-tablewidget.png0000644000175100017510000025640215203313266023074 0ustar00runnerrunnerPNG  IHDR8:iCCPICC profile(}=H@_?*;8dND8jP! :\MGbYWWAquqRtZxp܏wwT38e ![Bb=!.1S<=||,s>%o2'2ݰ77->q$xܠ ?r]vsa?ό*ucE^xwwgoiM^r"IbKGD pHYs.#.#x?vtIME 4tEXtCommentCreated with GIMPW IDATxexW{V!KA(xZh-P@qkq/P-ny?$@5Y9svwv9g('LO{;B!BWEo5{;e3 @P.B!Bm5UUܫo ?zHj_!B!Nbb".n6l8JmYM,m2eoݺup!B!uVVVTPa#GQ<" IK/ .\M\\ B!B:EQ|nxz(Ӥ+VX%!!AjZ!B!% FLhi4Z-zN'xrkٲe߿2Ó댧dj5uN<.)L6|B!͗HLL qqqO]* $&&>Rh4i?nI4ӶJ*-c!B!xĐ^Fh̰r@9J. 7xzJOu=OoJ QB!B7[TT/rqBBQQQR(5O20g<i_U!B!9"&&¯7 H9Y]҉d9!9#t_G [?!{R1>[})-He&"k F1g41Qyڔ^e¸B&6]BKz㠏Ns U,\_ 鴖|.Ƿ#<z3s,y`lko|7[GS< ڶ",fen}H'T]9Iظv I^y{Tۂf>XeG`ѕakڭ귡U'!TN< Hi_p!:qO /XLOy.^ Bu^6XPe/ڇ9%㚿,Htۙgu]Q}еYA,0ytDs,K2%SZoũ}G9 zk;l4Q:OJK݋~2:Y(obũ8 fֹ?"~V8cV׋;rbpFA G3\=Gl Br΄BB:o)G ަMg@94A[BBΎ\3CPa'?zj Ϟԩ\} 3rv4iԈFѨQS>^|#΋:`i/4oiܥ ~s͟ɄQ?-E,x$"SWqy>TʭG_W3XEL2yn菞N._ɑ dDng+ti5isfcG%7ᮌ&Y~nK8…Bg*fDYVM5ZW{#Eqq --M܏ѓEW%1nз3R6gHU@㈿?1yPFWx4Qٵ0\<ÅUݛ8c;7mG|ԄUh49<;zs_~s% !xw\\UcwiL<2>y1D%=gwGAo鏠FqmTΜ!荛XG.HkP"dTAN.u:.:=I/3a2e,Ք4=(8uVjF"3'2떓HS,#KZAN5\!x+)q), %WR6M뉷偁GPSmpWQxdsʽ 6Rs7|6au bTӤfF;/N/͈o9(xhAѢj4w"cQAK^vNTսR -8ȞBRz>S6B󘙙h9r@Ud2gOo>mB9kqs^ ?B! )s/y_&dj8RA8Nm_Tiq؀pw dg|JS),z=_ƃzz\YJ+8-9~~kyl!&u sNLwX7}}7נ`r]r&=3zL: a:&vz~q.4qDǘ6hJEׄUth j_:r.FgϞJ*Qbtf92:; $t$ !кWτtSn0ׂaiN(y̶dGFjExar[-QյbLѣGOMX.YȮ*+QA , 4PS,]蠖y2t=>8qل_ռrdvnwFeƖop"[zIj*q9B!r~\7j& hjBoCB˝dff#pvv SM[[!B!e t:K_)GZdB!B!`/4R)΀}|B!!11֦jDK9^]H;znFRB!B^^h4hdJFAbffBK9^I-)B!Ҳ+Tdq!B!"g·^B!B!+$!\!B!xBtIB!B!Oy.B!B.B!B!DeuYѣG*B!B^dI-!B!%9B!B!p!B!BBB!B!!<+7뱻鿸B!B!!<~jk/bz%N8׽{7IJ)5eꚡZ^n8zQsI_ɇ+^Po$A!B!^k W9g'tg΄l8H&tmk_a;㿢[Y0q ˚R" ~>t(KoY|)DиftcrSo,y7plzN8uajX|hk Ƹ8[qa8c*k 8ZNnbSF7O`+ !n.[.ݏ߆xs)gT#WFl<ςvv&C&/@Ȼm(M}[S(go Ҙh'?j7u(B!}R-f@q/ڛo%{4N\po VjBX9\߉ ̳3G_ v RՓiOLtØ۫/ޖVүUyNkMmiT >Xh4DDDHel9x ϟ_*C!BB^)1 ZVCb'gg05ŁWK̭qCn$d|N|c!cfOkKzr^f3TcwvcYM&L^efnF#ƔT PQM ̷[pqVdVOӕd2K,?m%b2;Af1|VO\9EEEI/TRlٲ˗/#RlllC*C!  E3\_^aDsp/Fbf{8B>hfpzN7pc%.o)䅍zCGna,䎴/EQ0LRA.^(!BHki,7 ځcfYOY83~i}\8{#WrȶϦ` ,P샙ԯuva̧p|sXvƷx3쒭)|ySL}:P,r@/a5y2ggeHGa K2(s(-QrJW-Ҫa3( ̙ wFϹ#tiBS$L&4 BzsrO=SM:Ľ{f~Vo cvڼy37/&<<(j9rJB!%j2$ !B!p!m٨\̨'z#` B!oz72s7IWt!5Tn-};bGVzWwKf1߉(rhR6yzO!B!\LtMP&#aѠI3}>akdMBc?XxvnH4f𜸟hfl>S3{Nm;sgUWJa N,Wo!BtRB!z͟ܥ?-UɆACW:X?ӌa|mrh\(?81,kHuϼwV sژk{/j^1$ k pt,kOL #B*HKo̷сB y2U,G.E%rM-62%O6>`~Abܒ\yxlIݯ:yH!rYW֓wp;)q3ue8ccaKazn%aÇZ1 0q.T-U,@^w;K-.ӌ1$u-nm`@\m,u+L8z}] :0/˓ǾgB,eͼB!.ěDh0`x<1IAƱx>oۏ{c;~),tw6M |^j^T=qI~[j6i#_w`tZRw3e6 ,b&"meba-6,aX,ك%5`Ds\2emُ?lXcjb\ٛ'*u,ݟ ȑ#>!m\P¶uಗaw!.}b* wROPϞ[7%2= 80*vx-D{ZɗwPɯ\?R~xyzW>^D.oD:(Mҵ2{㏰K#"J o#KIq^֏&UQ$7^y)܈3Ƅ+oAdŅ'6fϜOhXQj{&zxI叠L|Ļ`Y~CRiFZ O77ܼ9<ٿgХv z%t+WS$pdQU ˋ(W@.BB9V9=Âzn-(T;[ӵW}JXF4ApqNJxU;agNQ\X%: Ś{`^CװG! ߿VjVv".@L᫁Pm"5PԊ EjPa;Ҋ?eszzu;);O`,؈i36a00$=EVA2'іF!kׄ,4br)x%Ru\鈾ّXٛ*w Ňk4#<;!i k&,@TYLցfp2;}A r*Er⻑  sZO㎱pz+@%$ptZkZ|#ޱ_z%θ4}~3F;T&Ƿ??Z,]ݶ}cxoPcО_qhzg!F`$rzNBCW k|ZMsB!.pƜهpl+`\)[8!BH W43zB 'Mnέf)U&)h5J*oX٧S_|ߗ fh| 貾0,^#hncd¤*(Jzex="]Sc.?abuԝ֋S&YLEy<Q;n!L$۹fcء MGndT 6m⌮( kd”u{mIJC`bxdU?o컊e.knm]YEj()dÑ3hSVuXa=K⒱~Z7v&f:vg~NVșB!$ &KɨUTu <ܗ/4fѠA\0zh%z~Xq@|7ys(WƆ4j}jCBU>Uˉe+Ȍ695l)ME 1G}ãUmq-P?{X$Nв)IA+ݻjyиxV|4ߡzM#"ߩCƁe y3Qϑ m`F)ɍY6mx&WsTGѨ4Ԍ9mgAg-eͳpъPWx*/DϻE/چ+1ضzr~/]^LhhJ$<~|ەT?{ ~ݩtcAߦh”{qn5M4(Juoɻs:@+gg^]!oti&}Iwl.!o4l  o\yl儇c4fuD˺g2ά#cR ŭY=C)'lŧ;!3/|Rc")?5T+\ 9)?ѶHo)'q~Ivs9ctfՖ;_%G>nh)H[7;o4mȥ,+>~L)}eh?H_3fZ@+0^]LjOÁ+ZST~B! GRtԣY}G+'~ɰ ߲-TBОN7-0ݶ|Y>=]rJ*%_ !_޾ p0t\dH=IBBWl9&j5F,n!% !ooB!D0r~B&KzJ GkB!9BߙfBq\?yKNrC͝-Q!]z!BBBܫ!‰,[(+*]ʖ龩]!BBBh4s…B!p!Op !B!!\<)^ {쑊@BϫZp!xUPA*A! bŊ4 L&TB!BBB!B!! d'26 {X 1OmWn=B!B Op%Wޠ^?FRε =$*Q9JxKO`V{OՉ;C.|XB!Nf{Sl&5!B!o7;z5z/@/7JR쾕SP>nn-RoVkܛ决KEi[{{{;> Kpçh5:ÝfnT w P<]qvKvLvk?Et1C<)V-폻Be貳ĦDM\&<.8zRBs1늋E>aur!B!DN{Z;U=]x۱i6 I PbV0iTk_'U!b"bܩL߂זi|8vJ ccf 67f*}F㶫:"zlnMw],j&,[WCzzafKxqvp-2PCMۤKYMqS@c T89%"TK-,hF잝ӝ9B5##[x6B$8&rl4>NIcT5UB!Bp#Oi\ T=n>@q+IRh4B!BoXwx>FjTt3Oqh"ޕB>Y Ja0Љ 7VL>1|!OsDVw& 777!kd9kFRy66gÅCyŒ8@HXQ4sARw[GjuCiƧ}|B!5xfK JdZ2ɴFFQ\gJɰlţ|R3w;̣w)^cSSs, PU'o^&PpƃMY^?/[ F!B!+􆵄T<Nngם'q30'x~t{N~܀kU So2=,<eLiWceT_Bsi SG\{?؃YbbF/Ļ7=A=v{-C^e3Wq݆p P\4c]&,V72"|ڭ\D4*|lqbԜЉNviWƆkf0l3ߧg"KC);ytq7QLYaUl_Gj-_!B!x+Bxth4?uR%o>.VeIn:7ӗ%#?er Ʋos3x >jr ա~>pHXsw OG>k2eC⒅cm8= %*5|JTNJn =Nj[zG[Fs ?5`l=.J[\fn׎F 6xWAe ,=i>6;4>kꑵn gC#f?ϻㆌ.B!8'ԓ>դJܻwog ^ZknאхxM6oL "B!x XU>y]$]*1dH=iJB!BCڈ̉'wwܑB+999@``Tlۅ]jCC&?f0 B:t'OJmB9B !^{QD !Ŀ^ɒ%{Tlۅ]]JܹsUqo6Mȶ]!u B7 !lۅBHBΚBd(R mBv=9BL71}\5Ie!sQy-7o҅΅Yg8ұeoj{9RU9%|`JS#d l?D|ur xa. FBʃ a7'_3+vIE BjZ*Ν#**HyKstt??a;˩gwԢ'Ʈx1]S7JDQWA2^nQdYʸ=yйX",o=]c`N&{v˦>!t\|[Qu:zPT5ZȇѾP9M=S&c\?B}g~nŪO*|2~94 Ŋ9ŋ?7:DԔ_C}\4R\1uS'['ضp6DsQ1^uWzd7KMYJxX{$J#w!5GEE!5/r[ly lnvP;F86?æ1/f;gSXjxS(֎cv NEe<{ଉaǬKi㥁PgZgբhƀ/H/ηC0휏Ƨ|czEv([f,#ͭXJ,";%艿yO_zۮd2DP#΃Q|bwv)qN:pa|c+aO-B'0OyMR̷)9ワ73^)u39%X~j:;>V;D,p/^ saww;8S^?fNր5Wc01_LfH=ߧKn.]Ѕ|2۳̮mfp3m[\lg-K i_teԷۿ!\o}b=dovN&tr>P/龡*z~KĒ\օyedv$7Z?:BZ9涪[u>},ϳtx_:k17q~RAgP@/Sz[̐~g))8#>_`=(f8!;zg jQ#hPLiK0]?į=}-|uD[Ώóc+_I!8);bVz決u뾾5ŖzZW8.A>q,q 5׭7? o'G4ehULMwr=@׻=kɣkV -ReqC@[M4^UEt{s CJ &}hT<=3wpΫ/_&? gfLr~ CO0;KyGoM& c{ h'۾]C}Sj8f@xxnн'd>q"͝Blƽ;Y:"kef8(@BS93 Dn #~ o% VQr# v3v8zAE)}&C] `Y? ?JTF}p59I%#\O80&?Y0tvq C'3׸O. gRy;\jc9 C q~r-\}0B'){x^Zw;B;lWN:Gt]1-|D+[&bQ5>k€~+p=Z۟fǮ;ZⲶ4UB\Q¦).celi)TS&{S;*J~K&3htJl󘡪4;MIͦ}4ôx?dg\''P"TQR,|*)U:I;2o[(PkQSm'8AQS?v2y/!OT1KVߤEدl:IIUAՠHƧyܶ>mbJBD.HoqK 4YLi+QlzUpWn3}t#g fkm5hIHL{9iT3QL&)I[jid4Gv=w*g.ãw7,%ExqBqwwR$hࡸ;!"!-}u͗ݙ3{ΙsI r׀g^^gN935dikN=6|cjOѧq_=[ /ftWS\\+9q068>Ή ucjNjDa;QEn*[3 B xt˓ɔۜ S4ǺZ= ONe,هl=a(%\I[ozw!ė_uI%ɯVs6Z!g7OMzxYo+e֊Ƈ'<|)Já6v/;~yR5mTXU̎YeRz5I,[%wXwhi$S,l儡\5CcTrX0(GWÚa(l]o.ʐ$\[cYPeVW4輋zWmB@KT&:%0;Z߶t-7r3IF VlGK˸gd/R M+3vt='Ky?T1Wbt?NuPJDMrCҐ\mV}.gfnmkDp!z]v)xEf1f~S^SpͭI٦PXyOlmF?X)˪2:K߼kُ#88ڵk#((J*%8_4Z͎;>qѾq+'6G0u{#sa%C !2~AyU4D$Ki W&nQJ eNȡ#X@WsE$%ӎJR%|!M!2FB/.D{3܌3 &d*]vS ]yr3w3v\:AeK?B8J:u='4#iwCyF4 !⋗H茆TqR0{|ّ |:b=)|A.߮/KYv.]ؿ[i B|u٧aHx:3WťBo^p=N#,<Ȟ:=@eL&Dcmm^GRsB/ZFcmm-!uBo( 7C +& 5O`6%%Ȑj/^$W\}!\xQpۅRcI8Щ#׌Ml1:хȀ9wDFFJ!ؤooo) ۅRKI85 w0 ?̫=NDbM!B!2rnгq MPWΦj !B!"ɐfB!B!$B!B!$B!BH)XXXpI)yQ7 J }(k^4hXkăĤĤB!I?Ŀ{RBX`M7:RxJqcۉc/!&BL-E DH`2 %[dl'+4EKKCۉ&i@IڥQP3Iqܔn9@σ-)G6ʏ %QeH 4ӣSvmn䏍[^ў /N!$&Xs\zͲQ^pz$6W #]՛6ez?'2@4Ia_֭+c%}&[w+w+А^^yѢ#|.ĥ)?l/=UW浥{$)W_73cK\ MI,ne_ atIT:KWhcͫ\v1!6mqRf`Se;w2L&?6EK\~wWQCKLJLfXB!$%;# 9fï,ugG)]>=ccUC)qrs=F2E.q-bѓ^9(裏19g#O> |7I\&w5@p"t\?{ h}SEQahEzD;A~$& 3Orfһ2򢐏jD?EQ,*G=!Jk s4 +aʊwJ~M54 ?,Qxs!ZC7j繞'CON䵱ƛ{(:ܼCR:ǂCէ KbRbSǤBQ}zbG՚EckcwqpRzW]^XϘjgɦ+@1&5ŝS ;j@m鎍֑sTbH|34do㽞һ|cz}G鏭&S:0h545K ra|\z02LNfW>FnMTbQP} 3[ޜ}z|EI\o|#SSZ$wW~㄄UQCK>>"hQ)͝U5慲~HLJL !__2w`Q F.}A]:-C>{+بYpr+@K+VyooM{Ju'깚K/P~;/_^84=Tn.Q%KRx4j2(HɯvP+,.I +P4+v;{QXO>89USB辮Ĝfq(,7W{LB9i/-=QQ.)TV:{5 Ϗ$) ܺ~jЩwԭYgMjBfT`R35$^COХNQP `kY^S+7W(STLJ6SjdZ{:)휰׀x'Kywbw1wEaS$<ZG٣Ac=yv Г6MӲbv;:&+DHLJL~ʘp!XVNn}c} + Їo٪ŰX7>{x@0Oul}c26e jUW~sA9NjHLȱ]?dVmɍ88ߙoxFJN]gax̑~g<]Ifc8BGT 3nEe`?ZVb90~[7*w5t:k5Ӊi#xAB': Q+/yQiiӔINt-f T-'&^eN.)eM9 xL#nGSJTc*:s+ozLxw=o=6I㨚?yj0l||t)^'e^>)]8g@lh, RiuʕѠ>Դ ȡ耄cz$ gOu"*ݐcZF$2d‰5vܹP5GkK^CG0CEs>I2Eq55O5Ԧy yN 8{&t.T֋v+62uyU<֫<'odE;[~L{1{g޸ogN ѥj>yMR,x(KUaUsl1<7r"_L]иbٶtUVjGF`~0~HLJLJL ! #6bEEE8|ڦntmɚJ@ gQ`p;εr-: iV'.Ʉ ,,cK%{S2qGI*0ֶ>0aW?8k^nhI ZD=v͹y?zx^o1?Vp~JOس3iXQ?3֌Opc٥T00TEV<[}CP \IL0,i, v](\rs_˗/!!2\l !sQ>hݠ q=++i HL$]2/B9q1L<ȢQ8aݵ9$ΤEb0 F_7'6nt>د243.yp[ZZJ/#o$[yo,2B!+qp%ư!ҙMʑcr=gٍth@^$] .?z6' 箓@Of̞Ɋ?*`Yzϛ{}е5$./=~\!B/ WbsAn^y<6,aX|{.ײմUgpNڣj3[.߈̙ؑ%Zķ(&;tⅇK! CB!>00t@WW0BBBB!;v쐁LL\|~,B!ߎo& ׇz؛`w,_,2{$\!B!IǧvnΚ !B!|B!BiHyIwt!B!.B!B|".g&-B!B|;%\!B!Z`)u!P_-B!B/'ȵk׈ɓ'rfccp&Cmf>1&g6}܍iC"rqj{*a@(<Ii%tX4B̅ fM]H\Ē;i_2p1{`uel"X ~X_˷+mi> *}=~-Gn=$k!jt.%UI=1i 9nu$o 4jJʢƁٜq%~K6WJ*z$Urу'z nFk*}3qnL n9)s~ggyMSLpބ41HSPλB!2^~5j5>>>R⣹y&ׯ_UҶn+O82'}fl|1ً7fqdZ͹M1*e/`w4YMp8>R޿p9MT$OcіɾU0@gJ#KZP)xf͉6%9Пj cu&6t!fx:uƧ*;8x_95kH WD0v9<}jY64"dX2&_0,)=1aKHδ'Zu76=Ö jYstFW~ӓAy *7-0{>)ˆN5i͒mZ2cnrdվXbb5赕ySbPM+]!3 \rR⣲fϞ=_|rka+ N'mS}?0K3{ngqɤ~lbCzJ&:75|8,\\mxsN+Ҽ/,])P0cqN?Ȧqm^F?CR,HcocҴ4cN^PzE ԃNHNԸkB:_ʙht}aێ0ZmWM_ zye[{F/ 91fJ&e禞>|,5ъ~z4裈RŻ8|-\ !_ I]Hl z;øXtC@[ <w÷W(ykwyI$S j*+wŸQ<5Ϲ wDe,.j jբk'gDD?+^2gA34S1 9s]rÄv#&p?AAN4dC(eVj-}~#\ÿ@w}?fu%2K~1't.耕3ޕ:X^ Y IDAT .{qt !"'B$.rGK%1{WL89~2 Wpr0N˶^ETXxJRܜߑ1wdykCDl([~;掾'_= xbqC)kٵw#c3QURtA4G2ۼPcpsxuoŞL!BH.ėxgZ2x| {Uaqi>RrtD%j26=šclwxQ LқByi 1T+DŤv8YEtV{#O9ƃ'q&#]iI•[X=R#҆#<Le r^ݗpWgX.&Sk~|6yݎx+"Poe2 3޹i%<-鶑}AСtrWZ]Sl:NYpVM;zC%R; &ou=7ܥgL_wUB!$ "#&.ةy(MVc=Vt d(#MyMwc7oP/ovUaQg6g.PBCC =XՙIz*@2i|p1"^kcd'OVg_4X 4]ʁT`]I7= O=)QȞ7ɰ,*&<1z?$,mf׎s?{&9fCC91N~JSܽAbsQ}Ii D|6xı7^'IqYg}J?̘'Bq6_)+Du[Tْ}abHf@wsoS7h ӮkwB܉ يmQﳢ??Ϻ)oOC&lxb$_Οs wdxB#jKv`Zqʖ\ӓQe$+!ra Ȩ4;O$Q^lD,o8ڼwdN3O`{8կqۘ߆LB, y,sz{W/F#+*]=q6SQY{ dڠ.0nC18.m3t/!zlȂ9(ibvdvAN5ԣ}4Жi>{OGkf:.ɦ|Xyz} G(܃BBR!_P?SV/&qe,З=i'm's6{SU6 nVYgOnF'F(ՂKGQ&3'Ki]Y&ZoGQOΰyRZո^=~M:OnFՊjڔY{O|KVe4+fDrr8iF~ŌJд7c{UgjD<9v#Dc\*2pz0.BR6bEEE; ^zox>ޥXVb=&)4#q^pusfN$NGy:4²^tGn>:':/eGrYv-8]k.-1a\4"[7:nF3 _ BHL !bرZ7(( ++i HL$]2DK9e=@uNiM0,(_"% XrB!B|b_SMBSUaioJ4ws/B![L?o3E繴}(e^>~m7Pμ!B!$ oM*9˴bړ[[K. B!BO'cLQ}ނ3>90?ةL1QINZB!$)~'j/fdqԱNBB!BOLmGޫ8;i.M_:fG{RRRB! !>ÇmBBBD"1)B!I_ڵk*-&BISH 4d`6!B!|2 N<)%/>'Obaa&2OB!߆OٳgO<3 3,,,puuB!BH6777)y!B! !>-b.B!ķC-E B!B|.g&-B!B|;%\!B!D%\LZ…B!vHK_E&CP$9&]'kŧP^w$ F4+Kn+/_Sϣh^+#2"BĦtH! #,чW|]3z85Nݙ +4sa +lJo,Q)&ԧnu-KjeyV¦Aq n9.ߕ"55/1q lL1d{q!BH.(;Kt(`O~!$޻ܜ۔BaA jjwV}9~r#+bkI h/oF͡flĘ3IOݵ|_cgdvTON0f=? dc6'hZk0!&%X zmӜ>}ӧXL+LI1EQ:N\)g];X,lZ^r}AB# b ЋU9]6t(A6+ؒ˶kRM,UC{E)zY(luңE!F R+l7r>F!G(8'Ƹz9qߑL G&6UY.&@v?S݌,o PlĘ)~Ÿzrs}Zd6$UdaXJJo太?.[QP/i{`0==jG"wq ZJ|)mLqdžѰC~y޾q5 /ggjp:sw먹l&?W o5vœ ?5:.OkFhJ[u*.p*]ݰO<Ɩ?$"xEo!;ʳlE)%j?&0EI/1De,.j jբkFWxoM&0pJY F 6Q,OXu+9!?ɇ! :`ewN,+6?urLyaGx!BHn6quJUolc ._ѹZFjn&хX`qW=Vyɒ} ,ڿē>O:OYˮ𘹍wJ_} j בshngIEq\NE&%. Iuҥ= 3'W^fjmt (IVi\;eNyK!6 Ɏjo5θ/EzWX:e1'yנ͌cJ~,N::>WѿNlWSgߠA!ٽiҤ ?In^Ŀ :Q{fKv" @yIkDږE"XTheŊ4yl-Du}cJgVj;BkH9+4A@||Kh$ڸbC$ =Xn߇ͲǕV ~3Fk~ew ;Gm&a S(ո _3zPqw>}//Y@G.bӰd(B}AWkm˘ڷgѼr :-j]3rd6ȇ%* @l(]*𴣊G𑂕FovL4Mz%?E֡u gդ߸}6 B2k:wȜ?O 'Gb}:1|ANAvv[.h=c"?d^|N:& 1T+DŤ>rq&$&b势:ԛ|166Ƭ wnk} -ӟWUy͹15pXQ4vk 1TbNR; &ѯ-l̹K5et!Bd$<܅E SDy5e}(eA7si\4wxl:;J+#vd.G x&?:ԶCܔn:o5$feȓ'T0i>$B~ZYqɽ( ,dѰTȃ,Nϰ0mqAn{ ZթD`4:M=_<*1Y;Jz)'E `}it84=Ջ"c6rnʨIW!&tjɁ,w8]Ku?(#}_fM}CE`iCT/?bQ@IL$s$d#=J`7#=w <^ֿqy-Jr%4M>O~kCv3ʉq2WJ]eUV`ė@+?k|6xı7^IqYgkrkLϺ=Pa ۧYB!Ŀa߫-P){hÀUqBnj=&cݽ2ݜCXU%5a2z%⸶{kdCs~;qgX1jǰyG iHe4tQqt6Fos/ޏ~!~c4]5n~I*u,l,l#0h`~thfH}R( ~MbKK1߳VҮ^oNyaŠpC&rTI3|ЫVU 'iҜ+Λ0a~.ʝH|Ql<МQ>+;:)f_?)}>~;`DA!/L#c&÷Pl| r?ar*]G1'F1{&^zu|N,:N[ٔ8}ZƔ@F).~.Vh^gQ, q3yi֮L1Zْsz40,]OGVhU&ػzlb;\>3bҐE VgGi8-G0}V0t\72 gCHI6f&7Bp}3>iO.:UL>(+*|Vֱ8 GWU(Pҝ3v^46d!N[dbMtq=rmDŔgα4qPe)򳘶L!w2ϡNؼҼVybgPe %QT@EўΣ*㻸5yrLnK86G1x "®*AO<;1"gdӬB tg6lA\^9jZ:)݊ee)DEi n%ufT}bDR-Xte2ns /sv'W7s <ʌ,U'*gKLMmOš$eʂw6~ G'Voi4+ۛX[_7xӇg %R. JSqBR"gG"j{G&2&Sm.wVHc:|)3Z"Y&\bb`V&ޚ 1:x (DI.QÃpdҹ1 曥tU{4]so%Iy  s ?@eEsa{5}X^{7h8MN7j[Jv[lNxy{[_T|:#؏hXƏܹQ_3<9r9Z}ڃήX)<8D(e۴ݕIbߧHRSmQ,y12wpuWወgC8y_(o sfo D#n} ߜ[J✕=I^g~Ep/@ъҨd٘Z11l:|.39@'Լ#}abF.8Lt)W+ٟ6M@i^aØ6_ťSύSۊ7PcRyeW6%/%kv&L\5C?aVN|d%iFuu<+"""""@2a~q[jS]"n:BCCsYf߰a:tPGKNHH:BT""rXv-5Ѻaaa4ny{{v@ݒn8E-w(cVU """"."wCzz:ADDDDD!\DMd IDAT6zpu)IpBN/vEXX.8$y.&%դBdKfQp㞌*pb$z4B1*CݎCx:oi58"=gx8gҹ`6&z$yDiwy'7Z}0e˾O|ճ=mǘ| ^F4:O3Vq\O3}a|)/udXemޙ.c䧰9k ̶m۲- V|<1 +mM&xa禭gۦoRy?ͤ֬FII8>>w`ǎz0gʦmv#K0M\.-1|˟6DZ&g )y㹬\I/`˨t~[c^ lym#z;yyit\HDDDr(@y P^7IJd#;#0m2RnO>QG>[A#1my:! N.Fb5v0f#dѭPn-͐Ȓ%K;UOKKѲf#999c9]x &0B|,GƞnxB/}o$\󽣌ZΞFyq&e^nt-]h7{Y5FJ֝F#kQ㿌t0uO/=ԨTBxh58{-gGe>FqzFs#K}cB5N_3<bIU%7odF@g;hb{ʷs~@UWl~0p5* l$a] NU>4v^݉S͑lI0>d|}^6:yΏ}jRC'u]Wq=IY&4gey|fۅ{>dK_N瘳uCgY3?.֧ߴ|;k.`P,ɜw έIv{#u۟Ӌ>AnӵDDGm'7#!M36KPC^"eSk$3`Kx$79hw[\4VwJ ϓ+>ֱܲ?L$uuͥ?SIϗ17vUh7xc*۶KcȪ2'U7yz<5i)JPȟV;9cT"a7J")xX9v:[NNew:C&JH8 J`ػ==(#5˦"AFY(TcjVEfzaJx+5TEVDDD$G 6N/Gnt6vf5AfM+G?(^ִNTW'~ruE\Qw#8eHt}յ1ǴX_G'tyؘDŃ(n6֘(b o*\G!?Q1Aы!';7 6A]䞣W=8,_]WJ4>6iPW:4b%oW,~["iE1VBI Vc8 _Mf}/S}Z\9FGcGG\|=|p[ Gek?3-8NTЅf%ƁճY^FB8`2ӿӏΧ)g/lTWW?*w_ڍ\@αthߌ<쪿%e,iZՏ6/E~lB≊;vX ;fE1f⼾>٭>%3eS>>߅cik&-l.#A9NG|+S뱶QcX8a1m| a{[l4glk# p;廬&yXZμw_oغsjD פn8ѧ M د`d͸5{wӴ>M#D̸zvP\JS51O%ޭY,z;KKo;~o_G2!<.CFx6+>5bɌI6KΉzӪ:ʎ^ά.epݛHOc˺$e l8JzUi^ms_슈 ""w)/IYvow`tRF79xerƻH Ŝ`ćߒR'],fiijգ2Lu_ֳTfG)D j-||&zzϸTHȵC: 48ykk Lȵ^N4h8nvÏ⁾.ws6d_&L&3XHI K0ukv,SV"""r{ud.=g ׬ 9?ů4UJS5qPqdV׀c1o9^4l".cy)3{xNm~ر&=loе\Ug(ѕ1N1c˶W@ &,X' mDLO}b''2#?e A҉y[W19>Y=8j<3OFΰgq'(aKnϿ"+|O-IL8:P('r[a!|uN[>);hԷN@궙 D4βwY1<`~gCjfSpK1(|2ֵ_̨.PZ) :_&*;ƏFsh 4n9x0:UI =Մ`<!8~r~kG.,_fV\z(O{eފ4 g=oGOa_RwμÌWrYZ(c/4?L];w$ <[9 d[9z]k3 6A 4 oJ*ԢQELъ2 $=Lb܁hMx#'>1ii+ۇQdQY9-3ՏВ$\֤SM_ ~CC].:]&m&~g1ax;q_ڴ{;}R7_lы^ Z9cCGF//l!\v§XEw;f.}>Ynӿ%Ϥ[d&YbpG?Npݺut;#xZ ̞u2(r`l}aa>o:edʞᵨ>I6A cҥ4n?uuׯ_Oڵ3 }+gv':|!?q=NHH:BT""rXv-5Ѻaaa9=@:f/y<^f{x).ѷ*_>qۑ -k:ccV U2Cѝg][mW7 흋Y(?O. ֋/""""""wƊEDDDDDD-riFEDDDDDD>^Ֆwp///OQ^^^cZZDDDDDuGƒ8tׯ'>>^y{{EPP}"(A\D2lڴ)ۄ$OQM."Wj0BBBqjRZM(Hta6pQ;L."""""".""""""`tt{LEDDDD;4.""""""rh$\HFEDDDDDDc H}\'jݏrMPJN6/_fݞNp40e-TZH9nQfҲnMpfŵ [;.+u7C9ݸɄsD?(5iJcljHA۲j},xM 8k b:,Jmh'F/OYѱ2C4.rʕp[g`U/T"T}e>Շ:^fi5 }8+й5o72>;hW <)1 Gpk@pև-qcA~Tￒ-/]eWD3j{dtzfs9MX63/^M?K=F!BrW<DޣГ4mR _Etgx;[矬x8fHJ$ r)lzzvQXiBȃDE^Ϋe|&~>ϥeWYHpy[ l'8۪`B u*@v1+4|G}3 u!*\nūPjU Yb7LO;'Cb^?m{ONi `{0\[F/mʌۇ+WP.O1oU㪊ɻr[?{6S)F4̏ ey?W-2eyjtv8`;xiRU7X}Vڙ[`ɎQ<-"""wƒD102w=ѣ⥏y?v$2Z8|r:Q<3o5a%a7E܎5]{lfPMÒ̱ 7~t鶂Aҙ#x1Kxo}k81Wسr *{(i0+#zRQu̒ ujY[im+)Ѩd7^<ڤÛ1n;C5g})l&HHx⓽+ Fp:_"YHpfŜkL17]~3ÍgZ92CNvfd;gK$͵(WXπ<񏜲?!d&gb4߻<LJUfɔÑFQ9fWWcy]kҮc=Z]a$!4b8f<1~))xOf_ 9h#}/ʓOʨkeۚɺ~gCj!H.Û3K|o0`;q_X`_g.g hϰG]rԆnώ{Ax) 1E """ "(e!,8c=ͨڷR=BNL߅sGa+<$?cW6-ǭ^xvAb4O?V?BKC/IMZ9\T81|r^7t +jr&w 6ۻ&@%cY4| ݮ /bꀾو =ލ_ 2!&73/vP->>~JN|RJ8L&*T˅HbccS+kW=G޾:"""""r_יIJJZj\zs5}vdɒ\|Y!""""" ?{F}SIII())I """""FM[z-EDDDDD!\0L<""""""wY] 9gB1^D1 #Wܿ w/]$Ĝ"ՓbwGs$$hjEDDDDq8|uS2yZcJUoӽлen RO?Lʕ(f 2v;QF gLOO'B= v0 ^øwK~8[gr|?ç[!ܸͩsdI&t<؅̝;æMrMxx>$OQMܷ!<퟼ۊOdVOwGh1#3+iTcFNZu)h掴`p Q1\(L9DL;ek)<#o.""""" ,|JQw`.&Ϧ3`2a&4}ca3,8%oV \ R|gڸۡNp[b,qmŶg>so_y1uAvϰ[9ЉM;l+"""""oqCǧ;cmo "SƱ|a{>>\Ё؞(qIeRށyA`{h㾖N™x= SX~mI8p"s ݶi$&$?nf09fBE /Y $%&/IfNx(PL3nݘ={>8nu4,9D k~A/%p' qc;=hq'ǑhxP6͞x{9r. 39 3n,I@~m]2T1aqDi dͅ2hdGYpp!/̦;VyFEDDDDmȳCP3f{/,uWM7֧_{ӀH&dMНh~ KSP|fVڕ>C> Yp-NM1{Sw6݌o e}+""""" 9P otɷR#{NƋpCFEDDDD^?.eyf *A/$:Q'~kڏRnYʑt7mln-sU)Q(\ʶdkŕIvO/_Q_ܜ])P>]&N[uj>ǜY#Ma3glor>rVMwԑ;ofD2^ lym#z;yy]d_dNֿ}MI$yyر#c28]ɍVfٲ/S$_lϻ?_aMzΚdkHMRsYz)^(Q:jVDDD;<͆dfӟ9: b6c6M ϼ\.mSoo3%@sl: aשE؍.,1]ZK!4ݮ stU<ˏ+cw2T 񣋼6m _)Oe˪I^OR TMN_|'vޔۚI?K<4YAקg3Ż#|yS$ֆ2V5)=9]_bui)1-TW'~r G:%T"""rgG½ػwoV@rfgrϮ>}Z~>}4yMx(-f%̤йl$vr:Q<3o5a%ۑ4s3E r7|Ц4n=(GqJ%ۏ۶aY) $c75oVv`A%0vfUdFn%<ҕu*3RdֿmML qքI޸jEkuTP/[$@ ;vfPLwLjI-E8v/wGڦ* qAvA||z7"(((INNV'总;j=œ`3@]Mb1b(g">*qdvc4\zU0Ҽt*ZX{ ~o8-œzS3o֮u1~"-r[9]v5i\6p1K1(ՍgȤtZ=G{LoqmkRvD 6 aW{}$lTcbxP_ZĤ.]Zzb2bg̛S|،3lXV㓳p;̶o'0SY63+ԟ ?uт7I';aPC*?cQxr*f `LL>o>?Ûࡒ՜˚9*$n೉c9{ EXo L+`#zV@̳",7ͻFP|#__وCO3wfn|3øh8㧨DnoݺuhSv후Xt"{Rn::t蠎<#<<u&ED侱vZ5juhܸm ҁ4%~H=f7ťQ]&lj(mF5xzfy1X)i]<=*t@m<7g~49~\›U4'o'5!>;hWGs4~M{?sƖ{))$s //;vd,[5mǭ;Ylc>Y-?/y͇p| zoٲ|ջ9KzEDD$gH^ H2_ӣ%F]oQ6߀s2g`K|*/y,ie7eЦ-U 0q~-:NMl{N*?I#f}oxfAC>hc$dE5zc?xiRU9|6kqeԵ7dg%u\[DDDnO1m7n=\2*UX*tpMl:HHG̼Ԑm7L6γru?_K=C5g7p6(x#_V.)s~év[ש(%.#քe".1Qw{gQD|T 7'6&_-}&-e/(3׋`$!>!4b8s^17^ٛE3{Jg~_^3e=@Ԅ ؐg̦ [H-ZLc,~{Fv.\$VŐ>!ަ5Mܯqٌg!/7%]Iל}6L>8iIG;FS S1&43 ywwcNE+p$XYKE~LxB7jWv]9%ӍjQj=:@,{ƅ n7sr4yneϧ-}3ױu2[ҒzWF7'H0'9qkFn g~,p:*y]jTyLb3ع` FR~tбyx'9{!67I^6͸DC+ؐ.km2aa՚ɛeŗ'H^HQ/ttm:&2;hחgm7n/)ˊk88d6HO +WX SgH3sq)&9+4켆ֱ{9\#\8OBhQs8ەŏo?A| ^=jy}'OmEXT;yUj ~׬>Ƭ~Zק7>Շ3\ّџN3+Xr6Ks]?EKڳ7þZ37{Qb m2#|3ƏLS3DDDD!\}gQ|Iwʜ]7i's:)ƖuIʼ G\U*o\JpxV\) GW Cp^"oZظ0:ǯa++=e;_y6bc ZtLs_ye}'G vofۅ+y-AYK,\դ Sٹ/vEDAĎ q»—k)$F eK;gm[0.eDMgL&&TlbDz1Ly2&=loе\Ug(ѕ1N1c˶G:xH|4?{cn|M>xk]7gd]oa 'wafGSMFTȞ+%*R"Ϧ=x! &U&u|Z>;~~K&Q~ſ"q  u_NYУB0m{+h:#֤W ?wE ,NbWD י'Y8v{3Qu8&V#iz^HcOM*< YYP~ UDDDE+SBW#NSךqņJX };3:S~IFHnYq/&wio>ȍ|r^7t +jr&w ̘>^bPxxcqͼX:j>No~;g\:~ɪ1-6A-lKeϧ]NhƱ@[f#hW'S@5ڎ]ɄhOۚGۻ&@%cY4|0|r6n)ݛES?S:?6$<)ZI>X ,`K$9{N$`stX}j9e1a~q[jS]"n:BCCs]vFpe,^P=G kС:ZpBBBڵkiԨQ qƷ]ۻ'HtE#"X4ss0>]N[#"""""5Qyh:=""""" K4.ri$\DDDDD!\DժNQ!==] """"w|MM" BD#"vlQ[nRՖhkժQV5hbj֌Zk4F"#AyxwS9[ ¼aHpZik0V}~qhǜMAcq~<88 #OPضu㦌=]DDDRD$cTX9}6\'K ԤR {,p惓cz\rLpt?G ƫ 攴apj$qff{t+Y8H^Y]v(NM;t5DDDDEwz:0ofp.K'gn WlCxܧ-a3\pwsH?wW’©o[˃׸Ihh$&%:B8|ؽ٧ǣ|ȬH߮N2ODvnmǸ2-uTz=yMq'J~2n9p\D٪1͸_p0)iÆ+?n=Sm!4+\$ֈvv%ı߲kX8n;H#61 """.{wGX,=l~7QsYzC]fvq *JpUM;!T%"8q2 vlXƤNl]NaܗUpO[ ]R& e_s,!~#vLtۍp0S,fe~/2ᐽ$m%jǭ`R u|ve>qu֏msI8kd' h5y.<~Q\.wa,:BMG}&(/MNgYxяnvs^"K7=#V3n䊃yp}44$K/oI[g$&*,H+M)Ru bd[nN<lp*W{kMXEpHvrm2Rs N_61g/OE f| a8~_>ष^DDDEm:=&kWq7sn"r8G*e-\Ox )WE49ā` ޷A5%(lkGHwrNyƖbW i &b}/hFl}˵[o/ˉjqsWze'|L<5a_ӬZ^s~d\9I sNly˚#٘[y*""")_] nyZXk7fq4r5ɋaGNҥW5fEbZ,!# lҗҝw/ &̙s {io Ljv8 ؉R@| slٝ5SXr~8f2pđ5S7[*iݴK֝Dy|NEƓ֤?,#= bє&e\ġ %ә%2FP ϑ^G̞&6"N=Ξ3eZnטk);[ zsd(X̅i޾ S?I n|V# bՒ|qfwO-ӑJ;A  xTOJ^?lh8,G8w` stD,Y(YS 73+Ïǔ =MSFrHk W8~, g;XKROVu.oGsbsSz@,Uq'm+"A{np—.e@/:cmŔUNh=}6/yg|BȜjdAo Ȟ/v[dDDuH֭[]~=˗5ibo%sZtzWs;uݺu4kL-iFPPQM c͚5ԨQ#EPfdsqqDK\E#"쾛PTt}h%G"""""/>}SDDDDDDD!\DDDDDD",FEDDDDDD2(sbX """"" "<ũDDDDDEyؾ}o4E5)""".BUI IIk5)""."IҍDDDDDED!\DDDDD2}OBEER:4.""""""h$\$i$\DDDDաpD#"L#"""""I2ƶ\gӻRN_NvSKT4#?AlFsTmܜÕ bgX:5C:]R:h+7JpqLGz>{f5C.CLH1'~ƒ|st.k;NoUl[ Ӄcc~LYMFж)#U>}%*IoN88ۚ.`;.""" "/HV1 z~\przpqĠ&0+oCAxtEaԈEFr3}ZŊQRl+~8TS7rӷ{*gua_7N9d7X}맷ļ z5|ը/d̪?ٹz 5gЦb+~g~餃 iפ-?Y]ug3 ;z]gHYMڙoq+K]dutzxgJڟԓ8nj;-e@C|ݸ)cʐl|^ Ci?k cw1mZ-~ pj.OY1=/KEN>!m |A|ecyߨTTQ{bkovm /; 7fG\m~Ӟ7%_㫠T ̱z{-sU_Ҽ=P"[[| q;.:gu+/PyO&MdSyDZʛLZۙ$xdԄ{V=ߗeP"j2~,me|j8%'ML*aw_DDDA%Tvg$ܰJ%)Y2~ } :#F­ngi;|kU91s?ں/i6xtZN n\^CUgw=ow7DWA<9_~\cd SucOYUl/eX#C;=@6%]ܔWV*7 7" ҄36ѸCJiBCYɝQ_R9W?ߚSJ98x!01\=#i9Z_v?ne†M°X^[phte298C>6JYj3_'z5yk|~ +FŒ\MaG┫',ed0_Yk5 `h7v'%pSLEDDDE"i©ΒV Tu[~ l8H>FQQYǵ67@X!b< Q0}C&gJU.ӍӜCp;[[6Mގ,,Wͤ> vO,Ϭ&cZ;[56&0bcH&DNly˚#٘[y*""")τG~;*}PAz+K^՘#:k$سkac^K_><6Kw/xѡ,:#{1- '=_3=kIiCU#2""""""" """""""/MGIe朋24.""""""h$\$i$\DDDDD!\DŢNQ!..N """"."۟x u)Ip:NTWMJZIpIn&""""." """""{EDDDDDDEDDDDDD^..4]DDDDաpD#"L#"""""<' Ie yuh$\H658ޕ"ud~9V~ɓͅJr[hhd86eMX6ȃmӘ#!zislxޜ$HJBqJHUh6.'nq\z,D6'2(J^?sJⅫѧЩhF ~4,N'yWӔ?0d)h^ewlM\͎ϻhפBHZ*qoy{2^myS߷ <"`0jD̢mlI2l}(;.P \Ǭbk\۷/~9:d%;wbםet.@u)k`kwmb;{IAsn][?kDǹFx /혳)uZ`,@P&z/Vz e[ñ=ko1=~>xwY)gm ǾoADZ,|M$GEҌlO_0`*Ůi8mIoi6j?k3Pv g|@*ΊI׷gmY==7=][ʖħLdSyDZʛLZۙf s>Jww?q-mL U;Q$ (/){ϝ+gRFO6@qfnِn&UjxҚ}ȉv7-=$p}m *@i9^? [g0-h9F˯#Qk2'zEDD$ IewGcۺP +CUi7#[ٺ#G­ngi;|kU91s?ں))[rx&cVWTȂKBT0¸lcK7-){<8Xfg8[}dIhf< xb\ͪ֋H ŰH.dlsV$q9p,NŕJ&N ٻ p'MpɊqDio8#)gmj=]L ?ѫ Ip99ׄ4D梔I,a3\pwsH?wWˆ~\ؼqsVmd]q)tœ[ 9NMer!ݘs:_&cQphŐE *6c܎t6~t[ɈrU4>Bjq\frVDLh0brX#њZ&0y NZٌ ȳ(S+S3Y>m*tKtȳAf̱_=G'ە![?r1'z,㬑:<6mmċvv8d/I9GfɁi/l]9Vl"\M(qnf7[7Hz[7f7w\M\Kt3+%B/p#ܸJ&2Mf¹xO٤'WٖC^%[֭%-Z$=]׸yESUS$>"YQgΊiػ/r'}~+`H 8ι'8}Kdǜ<598"d?9JȉS^D68] 6!25ghVwëFbRR"""" "/[4l8wQ5nQ ycٹn wH )W'^b>z/;ޙ8l%Q<)_VNw=>r6bKlYvq!AVooyJe\=¹b猻'B&3`yv*T;QJ^rѶ{clIaO;9r˟hO[X;si]"#WcOv-^"N=Ξ3eZnטt56c.q ΄gL[vCQ#c62{}FƄ7ܜԤB 2U )=e1 fwO-ӑJ;A% IDAT  Hɮ:VþP>7tyb ^ Lv4/Fa97ū`4̒h<;G<ͼ4pX&x>4P7Ǯbӧ|I&^&]BTj3j /40w F;yIhOjWd \]\ћzҶbDu|]'FrRP""""0x.b I޺uOѺׯ|w>+c}Â?e&g)}0!ć߄5k4#((___u&ED䅱fjԨuYf빸tq@l%.pTfkyu0["""""/IdS!KoD<)^x96c^yIk;SМDJȸ-0d;^Ubx5y$p}m *@i9^? j&l9=[M'4Ї+c[̟r{2Co;`$:udi+U(9i"fW ;""" MGIea`Sqz_7|(VmН!?1kÍ=v֪sc~yEu'[VQ)BYS1_/F|3#16Mhas7_ hpl(c1|+ rZũn^D^ .Yq{rDio8#w0Cv֝wa(?z#J&S@wSdO*xk$Ws,`;&:Ln """ "/PpI$dx1sCgSK vDąCq6l[9a 72eoY~oy1:X>v9o6cQphŐEM1iMOxpN2g 츛dn}Nbrͧ ܰEiӯI'V-ylz[AlYNM©o[KR̯]ot:Lbڸ/6ILh] :ql,#Np6*p4X,, |)2+bh,7Dߎ".a b³{S%|*rx:{fm72/8ɍKGYϛao7oJڸ#jgŻ}wjeJ-el?v-} :㲾/^l_kD&(S~O`D(<'3bF[[7"KfYrj%zgc7c~v1m$yK>[W/'[R!Fs属`@u+{dUDDDEҾ; '?CϕrzqDVl1掫) a=hDEn{p[{m "#"{Ohs.2q処 e)D3Ȗ˖sdm8_ŠѢEGބJynnXšK`=X##{<[U;i3t޴'C 9qK]r3XC0+88\Ӑ,d^;@ĶO)2HZ. mdjѬlWf| a8~_>ष^DDDE^$&V{C9C80&N^+67p狔,!pʑr}QT"wɥ;>/s3`lۈ!hDxףnAs .H6-vݸu>4b֤9+y>s&Ej2i?ro=|qyk AKQر9fVۗ ƼL;9rGG{ځ+W,kdcFto.ݶ'{2oˉI`W.1Gt(KbIggd=Ǽ|xm_~8Nr0NfN܈ n_; f,bOyp69f _X(3o3@m'lDR }}1ԙޒ i3Ib.q ΄gL[vCQ#c|8w;a7aΜol h؋.ؙqM6 }gpFӜ>1=OIﻈ(`qrܳ3ˡ)MnON3'FO|ۖz[s玠Z0l mWy,ՇO'XV~LO[ؿgPDt[O!F_pdG2e‰@Z]^] $8Ԥ~?'*! 6yw޽X%Ix}_sګxV.vvRvd.GB0M(j7u[DD͓\WX߯.-&lRir͋6`) IeKl5NMR[7z6w1VB99~Oo$j's뿡]pɌwe|gG7~T"-&aRfl5 |&OzhD)[,Q̑Baz7xiҏ>-aסs){>ʿ3q1 n]L)3+YrvGZ_)4+[8gy`?[/.:f34׀;|cx')ɺ^ì )[Ѝ,YPXTz#[W2n.8gKỉ_;z@#""Bm%r M9Mɯ~g㏃v7jM1l^DGϥ3Y5|9#Sɧ|}?|z_6R|LL,C"\(Xgpˣ3V ~\Ʋ9py[dWL7Q*؝Yʌ Ԝ㪑2~I~'A- >v4=9cWvC%9<4 Y7 ̕y=`_X^辷}۷/1Xw;ʷ-2t , `8:VMKڠ +b_ _{v߹TW߳dzV14 /\W qp;ӥ8Ɍ N d85D2r֚KVzw lTK"""ka rr`l>j&Gp{- Y]oʇϧ뛭q’sq۷p2W{_'%_LБ-/Mj:H*yo Fk?̪L=ʹ'#>{UoN˯-װ/(AH~MNA3Wbߔ8}ޠKT_mU;6']fofȟ&7Tk*exxڭC4)C׹v1]r(SNo},>i{\xFzUD$l88۰lTw(7Qj26ҕuϬ`ň ľG$F93qqb+S#3-=l9ښXw e|W&B7*aoG0?X"""Ooǰ؉(l_/MtIS2l7 J'L]jVT'˶bm; ϫW{j,n Â9_Qdp@iN9(~YĂ>θa>i`= ۴C6Us5ju-s0Ar0xV[p~u6|iSgަT?8~1K:~8>.-n[ 2&U8#Lj ߘg-:E8% UGq(/b{Z㈱\﬌:'r߄019>~N'~+&ßO"w~.et5W&j+6ƎC0 'GǶa`N<nXo$^Jo{LUy=圥"vɞ˓8W;'+lx%xE^٥0: VYm7YnebƊ%0X}WyGEqu7bA"^آ{%^cآKbk41*"|PAD,w;]vgg}{}b <8OGṃÎeSߍs]F3%JI{#Z)!ό/OW+j y(p@>!Ew`S+䎡򣩯1£f=J ֜ fx %r(=~a(a;Q;ǛWqQ_!R) oWc)?'˯oןW΢©`A\ ص/Ƶij=co_TD\mY%j)㓓Gٗ%6jQ(?oT8,o=zյ{CʣȊ[oݏ]@ VTjQ_W3aa{J|y“=_PS UF8e}qSPeB_I@dnRʾ mypu6i_2>Fɪo*Ù=2xZu0?NMV8(Hn5h8ޓĦ2ʚYP=*Z0ej!YS!'/'_8r=\z&;T@3:`x|d#[.Quf$?soo#USQLwwݩkOOrOKEAQTkѝ ;1I^h@a#^޻BD4-a!xDZƥymD˄ߗkQ]d3l-?WjLG,_WsOp؟vClM@)3{5Aօ>Hq98CYUg1}rߋy2H+ gf3*uEp7y΍Ch7/GK~ISKF0[B>ZSE|yZ:3=*_,vGp\3֢ݚSN X\혽qu*y‘E;/OC|5niB%IKkݲ V;\QP̂a"-%,EOTޝ39Ӵr9+eeb((}WC[$2݇r7;=r⿓s92UZs IDAT/څF5kӸ"Q2&a#[smF:2fLEQPKDZTW6ӧaWU )>l gK|D*B%؞ Ѷ4ގE{ߨb SshrgծCo|/*j㍾[ [#[ ] uo=I^L߫u[ 4|ߵ%I~WV$3t|uZq2 p$"'kF@ለ٢k vJ*)g 21kRoQbE!g!/N@ |Ծj4+Y~Xvz@7] "D%d&,%Y 'ܮHIEw@  *A!*'3!g!/Y@ |*B?)U)p jȲ$I>LReV+,EY ?_,p ʕ+˗O<(Ȳ̕+Wrr",ş/ Yy9B@bccCJ,)pKB Bɟ@ЇЇ@C)_<( @i>|H,"$I)O@ЇЇ@CVQ$)KM$H?AU EC !!|j$\ Ip_BBЇ!vGnoe)z8ǘپ9@d}L[:=^H Ԯi fs{1d"17o̖-[>p G4s33\g@TW}˴\>s82ڨ?}6kP1~)&*>rb}RƦǧ<OH|WyCw)W>Ibo4]5Gax-YQ>l"I>EVO3t$ݍ-LqY6o͛Yf͏:gx`Ojѷ9+J+;WU_Kdjsn'^33To^yn1 B~*^K^-077ũ~k/G}& +I[q.I΋3vae;}'ZxjSiw y ']wj&'c>rd|(i qσwwUf:ͧ5g鱇-ͦٻk`S֡؁u3gPƔ=ֱI8n1+-X;46Y#cLj:; g1ITJ녃k ? >æYSiroA ưyaǸbc'nڴM6-[> Y|&e?;kFs2;ԠVhk:OBq)7Bܸ`ISglD~l7JJQljIbK׎!{^dg? =%ܰ>[A\![]aWלؖdunJL2 Q"G1Ŀqj?u )厣569 h>Es((?n8,I)y"gWxT-2A|nWgZ8k+Vo0oe>P aU0]uM@9\NG|sRgᴯ_JUѺxƵFYdEٙ|S{[rCGIKiǘ7`|j}ŽRXCsV{u&@3U%=pk֬a͚5IF;@t%j 49aɂ^n-֍G&&d?=M <~ q̢wF7)~n悔)9c%r?:#{qp[ _PN?zZ :b,a34]91 „y+e!e`B 1ٚ6T9XNy5$j&:{T qcگ9[ @#ǟDU:z;pN=U%L7G:x,skxmqL؝L=^#'7ֆ[r݊cN% uokj俗ӾN/NKZ6cgH,`0菮g  ,##H$muɞiĉwωAV@_ ͡`B|\YL5Z'|ƕ:ɡh휌HYVk׮eڵozjdY&444=J`H;ܟv_YS TPc#n|g:ʮ*Xz EJJ2Hy(RFX:70~a^4с=Cŝi?FZ%γjvWNak@!q`|E  KβuFѬ*Cx{|,vhRTFʔt"<Sg2l"K3vty\לQUCAGp 'z-̘s"O1*ތuөr-L4?=z#5e)Q ?-ǢL{{3iզ9 c 2 FdˋI {JߋY~}^\+-Gb~Zer|Mt"kU` p3KDZvnǡK OAXٳ cA@ T̸ID; 5 ZGU$KzmX2e9Obנh%t"co7jAFAGj/eV'ר(-/F^jxHfGğV~gӸvƂ%tu㯊GũX. `z}}ȼ>L P$_n\U|!>N􅀉Wyx%Q~\Mc4`J8-31*n(oYRzhT-UI~ k?lHЃ0A@QLO"m^F@1kr5JbWpžsl1}{gX<(@ϾGy0⸑-6}# ->ftE|RYKZCq 'ok=squlv5| 'JZaٮ>'"  +2Rʙc f7޿[:3cq+p^:3K蘤% ӶI)X ?s ]i|FM9P= `5lؐ f()Mqn,Zĉ\-i-?'ٵxt29č#tqF>ԣ(Fʝh$::nHgCwOlp |Q?2!oNTf*ɪLYJt77OI#Ip (8|ϞuphiWAWGJ|"cJ^"w,sJ#6߂_Oڤڼik fGZ*!>1h 2wG8#R\Iiǩ*[ꜾX<bu|ηe1gI:N3nΐҍh>.Gc뀪u>r}1-sr7HelshHZ'U/q =QA)aTyÑT:E{Pci&s(MEGW Q|Xy ȭ %_7BIXd;Mɛyox;|=fh4E(f }\jV\Y/t|Ar``[3- `0Ʌ;Oh4(#ܥTpg9 R'&S8_kx>HO/Oi, H`riM* 0܌oނsfⷒD8"o?]~8RU;EEɴ`o__߉6 6 w!::#G7[$!$:Ԓ+sC("IJITxdf~XX ˾_eVEwq%{3WվAQ%G<,N$viuPd{fh؅uRmC=? f&uJ()Ʃn Uuaxn^BFw\iR QK}&it,~߶uXW9EpdEgA*j l=^io@OOm[.?f~M M_ ΅ 7oU5rc8v17`L#x)Eƒ/cΜC6GkG/>snej.VLaVrbl?0pFTi| ռQނ{2kw/blYx b\}(78 oޓz3`#?5NLn @:=LՍ_8(Nm{ۘ9%'fCug+FĪ|gHI6>*xZF9{ZڄͧҪLfCصhI9ˢݨDόfT2sF-G{_YRxJ[7] R}tBb9﷨2-J[]RmHꉺɉC%GenXC/({9CY(d3$&K<>䕶j `ˍpw@وvҫ4Y>c%7F̑J.\6f/!cX̪M>W;% IDATU'ֹ.ymUD˷TZOXZvHdd{$׬ݟ3RvacL3lH*om:Яjы1q /"F6fj*U*" D$nASYxJd5%'_*\Lf_;c4ع䧼DM2Gu :X8?嬾@auP .OY‹N7b>zveX9(lmn&uBY3{=aQ*l}5E5C!9RWo~13B:kfM{)#hStjsl\횴%#4aB<;Yy__9aȆr:p4͡<1u$g3 ԞZ#1+F=eSmC`cj| غT[~ߗN2kjk2u2BAu#Wjx Jc2ZcB2'kF@ለ"?N?o_˛:s>y٩T*ODG|I,Ї/]zΎ ƶl;8BQۇh%C.|\r%E%_>T =|l!~sjwMhJW !qqqLm='Kj5:O ˻-ie.+W#]|ؘe'{CEIW !YDXX@ЇЇ@CHiذ@0s#?#S!,lvR[C :RK$@ _\OzxI3'@ XD.Ϟ# qo_V[,K6 A@$@ |΄=~J^YAE<+QdE   3cPd!ց@ " N"22cccCbńq($cЁ@ " P:uJN)|fCaMV&W((:̪ yRm ]K{5\1 `AA2TB牍[۝;we9MwOlgǹ'|i)&c3 9 kgUT^WE˚>?l'+v̇o_dS*;7 'p,+&f j͑/`,j淠_Hglُ$Xx1~;!0W^Lng14iŝ]>'їUQ 3o0 WY;f8~e$$S9hR fU@I da F}RQE1$$ɄĠu@U{57Ěmp2_W+D6 ǹW ≯:a1 Ų /nLƕN;_?sZw7y4 ;dnLyp1XMbޝps׿l^j-ưbt%"WOfi8noNyq4C@I Ow4G%IHuaxAZlURj4]XfWx0fYQ\|]45ޫ<< dLa1ҕ5S3,Z "vGpA__y_E23{Cᬏ2 EFeeNsOc'1+xSX沦 <6N܎vߍ- hdƕX,_~.Yx`AA-l[L 71V)|cij#ҫ|hF*x;bnb7!c'\qxڛH}L! gbRԚajNz39eC1ԙS/'x?pΣ uNn1sQN2w4ͦd@(Ujv`Zԍi܂e^4Y]21q6!;#}H27sh܋/' &t6MR gbbWmVbK:xJ^<@o" QP|〘I@ b¨W'ONz/ ޥK?U]ŋg]N áݽg!Y{Kwd )!qE.^<͌:EPޝWs!!:/9uRB`#gX]z1_Y>:Nq);[ G.f˾C^ie?eoY[}whcv<1.%#T<U}{hNr(JSely|0ĪwԺw# T';t6d8ʨhF酧}CNdaD+ǛRUsq<~A:Œ}/[20#+ExbC^YO] ٳ֭[cggVXS}SϒT._R,v/Epʭ yc[BPQ&U+XR)10~A )\ 3 Lj_U}?CgU9 "lCjOZ~cu[ygtJ屝7 'sv[+<_ʧs%~CpXMxx떰T7WdbWZ _'ǝlqv|"]DQ9J?R3xGNv~Q$;E!LZ$CHؙPɱ=!S ➿`ﱔ-L{meJ=Krt=Y鲦ܦ߾~CS7*I7թb9ǎ~e% U?E0%S+WԯliO8 \~8iW0b2{g"NUb#pvuJVQa~C-ΚdyNˆL2}֘jU7 2;G9+6d/m{O WU,)g#j:$7D:NSgO?IWy%[d M"ȍ}:;it@ l`̘1<aÆ}Uc '81R" %mKioN<t,iUz5?8s1gLFAcWFpﭻAKp{_P_70]yռPpK4(Elj(;,hb>j_#ʲ(inVg'|/E= T^~ kpڎbYrES ݧeeU2x=EINLhP*s&GO4 b_]aY=?[ eyۦ馹=XڡË SLI/fMsR|d蹷*5J)[Y1M }2O̟KhY++.f@RmDo7qﬞeAmso4b;LozS,F?#}r!wDHAӪU+)œ9shڴY!31z8#[:JB*$Tѡ{eFF`0 !^!1.PP5Z-ԹsKh._V!.o;ytk'-E$[wq}v{֠Q|,))*o;z-YVKsv-h8'<;sdӚQu wڔDVcel񣏒U{}xN:ãaL#9$"Wή8I<K<|uq4Κ܁]M>C\WΥؽ!p'/ TQǟsg9n秃O41ƂD*3'U5@8_;*ë=-\ I@ r#W6mZϳ nG`/!I*09ڱ\:8w $W8.t]\P*D |)SΝ;w^p('E Z3zX˔xu-+u_0Jjs|>gPjuyU݄ nbW+z՟JA^Ӈ U*ZTNޭTg * j[4=s`%?ę coPUJ+ұ&=<92~.XP[WLci;2^av I{*c\{ca|_Gl>s_[]$V4 K?>~*dL(8w.3c釧߳A`(3櫜_aF3hE4Ǔ\ pMS蟸Jyk׭sz4`R {wrVK΄^ש&pxY:SB[u~qcȥ Eb[J nGE o]B4q43v_Լuvmwgy8 zZ&RU R"JRThB3ҫ"B μ )D}]law93 nޕiѱaY-yĎ_n7IF]VSKĚNC.Ӓ`x'HK`]uVg]Wpnvxb$=x : _w!vLTu TG(-A 3BI:gvdҺt \ ܸ'3gP>~ũwkUbYNfTF3%\3[;m*}EPX-H[Tl=k?SF- pУ $ޘN&cGHl!@2BIIb\&(슖X:"Q6xTK5|6cg|,wmZX'^s.TF7-& h.!0v}cLj-yyͣGU"ԭ-~QVݿ"*٨$T=qi8B!7oq"֌~s+χЬù.Hw 04"-BCyi!d#ZB! ::={כw{0IBȎxR#a!'''*UyCF#r BaQJ 8?kr -!I'!\!D~i/UB%)!…B^y:EZefX,'iZ !…BlŘ^.{Gfx;Ӵ|I)3C!M$'ɠQ2,6>Ёȑ#2̕œVf?M]a}r>|T9󟦡IKŗc%f33!ϳe*n31m]Qd !0!(ruuͷ\zUU.NoHvS/bV=5_Ͳ=W1*[.0bIDAT2AдchZJCrˬe5)Qg"$Ҥ캜p뙋lvB!$ !h4 /PvmRRR2g逞LT§F-z;~5J/xeemqIQCLʦ~8%GїbX9g O֡&NػWqWZoiŋGW>_i=Wۅ9=7{`Xyhɦ9Pv7_fC'ؙ|O ?_vK૞?U0f?řkP[p+_*%WR.G`gM C \ sdDxr? M+`I'Ŕ'.GⅭL%UJ8`X-0H2k? ֿݗUK`k{&~g'챮=#󕐐K/f .ds%._liފB<[Μ9㱵b7gL[Ǩb 揧z9jXglt/._q6| ҜZ 3<<{'x#-Q'ea4U{o&/ ĮQø:;=1-:9Í]{(SŝK&kc5@O;?O&zoǎM=X32@"5ܨ|3mŔzI-=|z?, `u^`]++CdsF'd2neLq>rļY3>~ny}g~Zf]\tݧ\ݴϘQ7fu#Z;z-OdCbo&BY9I} T8~%[yj\ۿɳ3IvBa I}AhѢEgs+χhytXj7O{d(JݒWf|竷saFzvRID܌GW>E`oU1[.+VqF"g2KKMWO[+*쨦p5}'rA~IЌ\KSkzZsN*w[[!8,3iCWt5哖v|^!tQz}¦?)4\M`2xc^y+z~̏Z?Fޤ(jSi4kߕu7{vft9B'뮧S|˟;Eعy k[Xd\yl#Sp3GfvkDnDy.pkkk:ځ={a0v(Dm*SsUKĦlR/?dRpZOiIlŎtGsrr",,{/QL[Ӄm*ԩ[^Ŗoӌ.`Cc i7` ݫcC7!Dj)/ԟ;:ڹ2Of [ҎNafrۉlf$u̜TQWÞ}ijHտ)Y7ٰn p{'KV^0|a]]X[|e<2&s×3jBū[:WHM-<`І14([MuwMj2}F;=FFTjR·q4P!fBf^T'6De}G#2-]_ޤ7AMѵ3ЁVv3Ь~}H+u i*w|^]4>^U/o|Ag6 дV``n ,=)op6*>>HlNuyH*iҒdzt)DU*c "4wyl`tTA `ρQ#1+>* fHiMG9gIќh4a+Kf}nsPτokpZ溄p!D̙32dSNM6YcW+l˖ǓDDPE8-bU2Bx{᫣GJzdIخ峓s)EoOOycEt@: c[+֬avؤvnbŝ?6f`ZP .DZC#0[|kOtn#O^@СHf!ٛlY)kAcvj%%һY6!hhja"ӔbqPIKoA{κE8($8/zVRx# ܘƓ"fSeA^}'yy?JgupykW]DRϺq owĘu9{(_ 똙mTP~J,iH".j/ .i5n*I'Nu3'M_9kżz(Ħjt{?:}O3Z#3Ѐsɪq I fLS> h?> D17h |}}Yl/J!vllHQqFQ|:ʦ{f4Q2bgRVס`WS 6:{ߩ/K qQPl8oc;]V;?~deL* gҢ>8/io8YќIwrNlW7B^ kݝ2]9o5$pС3y-@w7 Uݽuv:DXo#wSP j촵vm33ư+&X粖99 VܽkkP1涯jSͧ80"2v=p5^:6n4mÐt E}:E\]-Zrc2#q.1-MK뉏LQnD"i=Jܽ%GI_}“0(bTAXpX@#>m2Ә+k5ŒiEúV\?UjRRç6jؐ0Dpڴs/{=c1DԐ>w^9+};<4m מPtojv3Nw^C8^AQt`4`0j+cÉӜ#Q6M]E n=zУG.tGкukF}Xp]w2J[HA?@wYLۄ}.ocv9Zt6?2- cXP^s{}1oPqROjp*Ƥջ_k]Oqf6aXQ|7>”ձiߓTu:&oL/T<]״? P3o ?FOygp+[Ț3ʻ/\JF`&߼`fDNgn7MT wGWMt'=Å%*(SËގ|qITMyM঎ܽ7;ⲟLΘ6)*ͻ\l3c؈+]~hvٗMaXz_"F.|Ϣ1sh%NKTvygs0kKVm27·0øu[Mg7tT3Ւ(6%^7Iol$ Os>e̵ ,4hg󀟧ਞg9U ۾'(b>Ji mZq|&[m2АT \xk@ZO5Qٲqҫ/b[LZ<.cHsn|ѻ4;S]]<FlBi&tiZޙmΟ@zqmZ 1oݓw)5$h7wX֗KĚNC.Ӓ`x'HK`]uVg]Wpnvxb$=x : _w!vLTu TG(-A 3BI:gvdҺt ܟ^-Lq}? ^s»Vg&F'o@_q~2s wQJQ~GV/5d6oLe;x~]5:3SF6*}EPX-H[Tl=k?#[uKvx '%&qgW(슖X:"Q6xTK5|6?e? KOߺ@0nZM066YB<aaat?cǎ[򺻻#}PuDYUCSulT Yʞ۸r !՞={h߾}7-Bf#߁4`RL Q xiZ'h!OBxPORb%>@!x26xڃp!x (i̇5̸2B!K*bq 7.c…xd&!BƄwL}!c !B![fl]>/2q!B!Bu%tlB!B!Dax~x!B!B<@i B!B!Z~A\K$ !B!:ߗuy$t-[!B!B (B!B!;uu B!B!DCx& !B! ~_.A\!B!x<59[s{QB!B[%\ !B!N:1j"B!BЅ.B!B-g6 Yɯ;z .B!B[QT[!B!B*Y!o .B!B<8>6\MnMK\^י֜Z% !B!D-<wnٺ[%yc J nnt!B!Rܜ 3͸psN̖Cƃ !B!(Z!n F<1U/R͜º{u=<-\!B!ģ yUnn;:fwaƁKB!B8𼲯9tE+jN[;M!B!szM>!< ^c܂KWb~ o!B!S /lG3crb܎ߚmĕ|·R-\!B!%wAaܜi:K#2IENDB`././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275456.996892 pymeasure-0.16.0/examples/0000755000175100017510000000000015203313301015063 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/.gitignore0000644000175100017510000000021515203313266017063 0ustar00runnerrunner# Ignore generated files /Notebook Experiments/procedures.py /Notebook Experiments/analysis.py /Notebook Experiments/my_config.ini /**/*.csv ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9985108 pymeasure-0.16.0/examples/Basic/0000755000175100017510000000000015203313301016104 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/console.py0000644000175100017510000000766015203313266020143 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to run an experiment both with graphical interface or with a console mode. If the script run without any parameter, the GUI version is displayed, otherwise the console mode is run. It uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python console.py #GUI version python console.py --seed 12345 #Console version """ import sys import random import tempfile from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.experiment import Results from pymeasure.display.console import ManagedConsole from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * (i + 1) / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super(MainWindow, self).__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number' ) self.setWindowTitle('GUI Example') def queue(self): filename = tempfile.mktemp() procedure = self.make_procedure() results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) if __name__ == "__main__": if len(sys.argv) > 1: # If any parameter is passed, the console mode is run # This criteria can be changed at user discretion app = ManagedConsole(procedure_class=TestProcedure) else: app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui.py0000644000175100017510000000620215203313266017254 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface, and uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python gui.py """ import sys import random from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number' ) self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_custom_inputs.py0000644000175100017510000000755315203313266022262 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface with custom inputs, and uses a random number generator to simulate data so that it does not require an instrument to use. The gui_custom_inputs.ui file is loaded, which allows for the custom inputs interface. Run the program by changing to the directory containing this file and calling: python gui_custom_inputs.py """ import sys import random from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.display.Qt import QtWidgets, fromUi from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', sequencer=True, ) self.setWindowTitle('GUI Example') def _setup_ui(self): # After the default setup_ui method, replace the inputs widget with # the custom widget super()._setup_ui() self.inputs.hide() self.inputs = fromUi('gui_custom_inputs.ui') def make_procedure(self): # Overwrite the make_procedure method that creates the procedure and # sets the parameters based on the custom input-widget procedure = TestProcedure() procedure.seed = str(self.inputs.seed.text()) procedure.iterations = self.inputs.iterations.value() procedure.delay = self.inputs.delay.value() return procedure if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_custom_inputs.ui0000644000175100017510000000310715203313266022236 0ustar00runnerrunner Form 0 0 450 177 Form Seed: 12345 Iterations: 100000 200 Delay: sec 3 0.100000000000000 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_estimator.py0000644000175100017510000001201315203313266021340 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface, and uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python gui.py """ import sys import random from time import sleep from datetime import datetime, timedelta from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def get_estimates(self, sequence_length=None, sequence=None): """ Function that returns estimates for the EstimatorWidget. If this function is implemented (and does not return a NotImplementedError) the widget is automatically activated. The function is expected to return an int or float, or a list of tuples. If an int or float is returned, it should represent the duration in seconds.If a list of tuples is returned, each tuple containing two strings, a label and the estimate itself: estimates = [ ("label 1", "estimate 1"), ("label 2", "estimate 2"), ] The length of the number of estimates is not limited but has to remain unchanged after initialisation. Note that also the label can be altered after initialisation. The keyword arguments `sequence_length` and `sequence` are optional and return (if asked for) the length of the current sequence (of the `SequencerWidget`) or the full sequence. """ duration = self.iterations * self.delay """ A simple implementation of the get_estimates function immediately returns the duration in seconds. """ # return duration estimates = list() estimates.append(("Duration", "%d s" % int(duration))) estimates.append(("Number of lines", "%d" % int(self.iterations))) estimates.append(("Sequence length", str(sequence_length))) estimates.append(('Measurement finished at', str(datetime.now() + timedelta( seconds=duration))[:-7])) estimates.append(('Sequence finished at', str(datetime.now() + timedelta( seconds=duration * sequence_length))[:-7])) return estimates def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', sequencer=True, sequence_file="gui_sequencer_example_sequence.txt" ) self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_foreign_instrument.py0000644000175100017510000000771315203313266023265 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to use an instrument from another library, here InstrumentKit, in the pymeasure graphical interface. It is a modification of the `gui.py` example: The `MainWindow` is the same, the `TestProcedure` was adjusted to use an instrumentKit instrument instead of a random number generator. Run the program by changing to the directory containing this file and calling: python gui_foreign_instrument.py """ import sys import random from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, FloatParameter from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow # Import the InstrumentKit package from instruments.thorlabs.pm100usb import PM100USB import instruments.units as u # For simulating communication from io import BytesIO import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=10, maximum=100) delay = FloatParameter('Delay Time', units='s', default=0.2) DATA_COLUMNS = ['Iteration', 'Power (W)'] def startup(self): log.info("Setting up the power meter") # Open the test connection to the powermeter with some sample responses responses = ["POW"] responses.extend(f"{random.random()}" for i in range(100)) communication = b"\n".join(item.encode() for item in responses) self.powermeter = PM100USB.open_test(BytesIO(communication)) self.powermeter.cache_units = True # In order to connect to an actual device at COM Port 5, use instead: # self.powermeter = PM100USB.open_serial("COM5") def execute(self): log.info("Starting to measure the laser power") for i in range(self.iterations): data = { 'Iteration': i, # Read the powermeter and store the sensor reading in Watts. 'Power (W)': self.powermeter.read().m_as(u.W), } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay'], displays=['iterations', 'delay'], x_axis='Iteration', y_axis='Power (W)', ) self.setWindowTitle('GUI Example for Foreign Instrument') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_sequencer.py0000644000175100017510000000661615203313266021337 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface, and uses a random number generator to simulate data so that it does not require an instrument to use. It also demonstrates the use of the sequencer module. Run the program by changing to the directory containing this file and calling: python gui_sequencer.py """ import sys import random from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, \ FloatParameter from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(int(self.seed)) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], x_axis='Iteration', y_axis='Random Number', sequencer=True, sequencer_inputs=['iterations', 'delay', 'seed'], sequence_file="gui_sequencer_example_sequence.txt", inputs_in_scrollarea=True ) self.setWindowTitle('GUI Example') if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_sequencer_example_sequence.txt0000644000175100017510000000023615203313266025121 0ustar00runnerrunner- "Delay Time", "arange(0.25, 1, 0.25)" -- "Random Seed", "[1, 4, 8]" --- "Loop Iterations", "exp(linspace(1, 5, 3))" -- "Random Seed", "arange(10, 100, 10)" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/gui_table.py0000644000175100017510000001004215203313266020420 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface, and uses a random number generator to simulate data so that it does not require an instrument to use. In particular, this example shows how to display data in tabular format. Run the program by changing to the directory containing this file and calling: python gui_table.py """ import sys import random from time import sleep from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.experiment import Results, unique_filename from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindowBase from pymeasure.display.widgets import TableWidget, LogWidget import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=10) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100 * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") class MainWindow(ManagedWindowBase): def __init__(self): widget_list = (TableWidget("Experiment Table", TestProcedure.DATA_COLUMNS, by_column=True, ), LogWidget("Experiment Log"), ) super().__init__( procedure_class=TestProcedure, inputs=['iterations', 'delay', 'seed'], displays=['iterations', 'delay', 'seed'], widget_list=widget_list, enable_file_input=False, ) logging.getLogger().addHandler(widget_list[1].handler) log.setLevel(self.log_level) log.info("ManagedWindow connected to logging") self.setWindowTitle('GUI Example') def queue(self): direc = '.' filename = unique_filename(direc, 'gui_table') procedure = self.make_procedure() results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/image_gui.py0000644000175100017510000001124215203313266020416 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface which contains an image plotting tab, and uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python image_gui.py """ from time import sleep import sys import numpy as np from pymeasure.experiment import Results, unique_filename from pymeasure.experiment import Procedure from pymeasure.display.windows import ManagedImageWindow # new ManagedWindow class from pymeasure.experiment import FloatParameter from pymeasure.display.Qt import QtWidgets import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class TestImageProcedure(Procedure): # We will be using X and Y as coordinates for our images. We must have # parameters called X_start, X_end and X_step and similarly for Y. X and # Y can be replaced with other names, but the suffixes must remain. X_start = FloatParameter("X Start Position", units="m", default=0.) X_end = FloatParameter("X End Position", units="m", default=2.) X_step = FloatParameter("X Scan Step Size", units="m", default=0.1) Y_start = FloatParameter("Y Start Position", units="m", default=-1.) Y_end = FloatParameter("Y End Position", units="m", default=1.) Y_step = FloatParameter("Y Scan Step Size", units="m", default=0.1) delay = FloatParameter("Delay", units="s", default=0.01) # There must be two special data columns which correspond to the two things # which will act as coordinates for our image. If X and Y are changed # in the parameter names, their names must change in DATA_COLUMNS as well. DATA_COLUMNS = ["X", "Y", "pixel_data"] def startup(self): log.info("starting up...") def execute(self): xs = np.arange(self.X_start, self.X_end, self.X_step) ys = np.arange(self.Y_start, self.Y_end, self.Y_step) nprog = xs.size * ys.size progit = 0 for x in xs: for y in ys: self.emit('progress', int(100 * progit / nprog)) progit += 1 self.emit("results", { 'X': x, 'Y': y, 'pixel_data': np.random.rand(1)[0] }) sleep(self.delay) if self.should_stop(): break if self.should_stop(): break def shutdown(self): log.info('shutting down') class TestImageGUI(ManagedImageWindow): def __init__(self): # Note the new z axis. This can be changed in the GUI. the X and Y axes # must be the DATA_COLUMNS corresponding to our special parameters. super().__init__( procedure_class=TestImageProcedure, x_axis='X', y_axis='Y', z_axis='pixel_data', inputs=['X_start', 'X_end', 'X_step', 'Y_start', 'Y_end', 'Y_step', 'delay'], displays=['X_start', 'X_end', 'Y_start', 'Y_end', 'delay'], enable_file_input=False, ) self.setWindowTitle('PyMeasure Image Test') def queue(self): direc = '.' filename = unique_filename(direc, 'test') procedure = self.make_procedure() results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = TestImageGUI() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/script.py0000644000175100017510000000664215203313266020004 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a simple command line interface, and uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python script.py """ import random import tempfile from time import sleep from pymeasure.log import console_log from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.experiment import Results, Worker import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100. * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") if __name__ == "__main__": scribe = console_log(log, level=logging.DEBUG) scribe.start() filename = tempfile.mktemp() log.info("Using data file: %s" % filename) procedure = TestProcedure() procedure.iterations = 1000 procedure.delay = 0.01 log.info("Set up TestProcedure with %d iterations" % procedure.iterations) results = Results(procedure, filename) log.info("Set up Results") worker = Worker(results, scribe.queue, log_level=logging.DEBUG) log.info("Created worker for TestProcedure") log.info("Starting worker...") worker.start() log.info("Joining with the worker in at most 20 min") worker.join(60 * 20) log.info("Worker has joined") log.info("Stopping the logging") scribe.stop() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Basic/script_plotter.py0000644000175100017510000000714715203313266021556 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a command line interface with a live-plotting interface, and uses a random number generator to simulate data so that it does not require an instrument to use. Run the program by changing to the directory containing this file and calling: python script_plotter.py """ import random import tempfile from time import sleep from pymeasure.log import console_log from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter from pymeasure.experiment import Results, Worker from pymeasure.display import Plotter import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class TestProcedure(Procedure): iterations = IntegerParameter('Loop Iterations', default=100) delay = FloatParameter('Delay Time', units='s', default=0.2) seed = Parameter('Random Seed', default='12345') DATA_COLUMNS = ['Iteration', 'Random Number'] def startup(self): log.info("Setting up random number generator") random.seed(self.seed) def execute(self): log.info("Starting to generate numbers") for i in range(self.iterations): data = { 'Iteration': i, 'Random Number': random.random() } log.debug("Produced numbers: %s" % data) self.emit('results', data) self.emit('progress', 100. * i / self.iterations) sleep(self.delay) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): log.info("Finished") if __name__ == "__main__": scribe = console_log(log, level=logging.DEBUG) scribe.start() filename = tempfile.mktemp() log.info("Using data file: %s" % filename) procedure = TestProcedure() procedure.iterations = 200 procedure.delay = 0.1 log.info("Set up TestProcedure with %d iterations" % procedure.iterations) results = Results(procedure, filename) log.info("Set up Results") plotter = Plotter(results) plotter.start() worker = Worker(results, scribe.queue, log_level=logging.DEBUG) log.info("Created worker for TestProcedure") log.info("Starting worker...") worker.start() log.info("Joining with the worker in at most 20 min") worker.join(60 * 20) log.info("Waiting for Plotter to close") plotter.wait_for_close() log.info("Plotter closed") log.info("Stopping the logging") scribe.stop() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9987931 pymeasure-0.16.0/examples/Current-Voltage Measurements/0000755000175100017510000000000015203313301022535 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Current-Voltage Measurements/iv_keithley.py0000644000175100017510000001224315203313266025437 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface to preform IV characteristic measurements. There are a two items that need to be changed for your system: 1) Correct the GPIB addresses in IVProcedure.startup for your instruments 2) Correct the directory to save files in MainWindow.queue Run the program by changing to the directory containing this file and calling: python iv_keithley.py """ import logging import sys from time import sleep import numpy as np from pymeasure.instruments.keithley import Keithley2000, Keithley2400 from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow from pymeasure.experiment import Procedure, FloatParameter, unique_filename, Results log = logging.getLogger("") log.addHandler(logging.NullHandler()) class IVProcedure(Procedure): max_current = FloatParameter("Maximum Current", units="mA", default=10) min_current = FloatParameter("Minimum Current", units="mA", default=-10) current_step = FloatParameter("Current Step", units="mA", default=0.1) delay = FloatParameter("Delay Time", units="ms", default=20) voltage_range = FloatParameter("Voltage Range", units="V", default=10) DATA_COLUMNS = ["Current (A)", "Voltage (V)", "Resistance (ohm)"] def startup(self): log.info("Setting up instruments") self.meter = Keithley2000("GPIB::25") self.meter.measure_voltage() self.meter.voltage_range = self.voltage_range self.meter.voltage_nplc = 1 # Integration constant to Medium self.source = Keithley2400("GPIB::1") self.source.source_mode = "current" self.source.source_current_range = self.max_current * 1e-3 # A self.source.compliance_voltage = self.voltage_range self.source.source_enabled = True sleep(2) def execute(self): currents_up = np.arange(self.min_current, self.max_current, self.current_step) currents_down = np.arange(self.max_current, self.min_current, -self.current_step) currents = np.concatenate((currents_up, currents_down)) # Include the reverse currents *= 1e-3 # to mA from A steps = len(currents) log.info("Starting to sweep through current") for i, current in enumerate(currents): log.debug("Measuring current: %g mA" % current) self.source.source_current = current # Or use self.source.ramp_to_current(current, delay=0.1) sleep(self.delay * 1e-3) voltage = self.meter.voltage if abs(current) <= 1e-10: resistance = np.nan else: resistance = voltage / current data = {"Current (A)": current, "Voltage (V)": voltage, "Resistance (ohm)": resistance} self.emit("results", data) self.emit("progress", 100.0 * i / steps) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): self.source.shutdown() log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=IVProcedure, inputs=["max_current", "min_current", "current_step", "delay", "voltage_range"], displays=["max_current", "min_current", "current_step", "delay", "voltage_range"], x_axis="Current (A)", y_axis="Voltage (V)", ) self.setWindowTitle("IV Measurement") def queue(self): directory = "./" # Change this to the desired directory filename = unique_filename(directory, prefix="IV") procedure = self.make_procedure() results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Current-Voltage Measurements/iv_yokogawa.py0000644000175100017510000001255315203313266025446 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """ This example demonstrates how to make a graphical interface to preform IV characteristic measurements. There are a two items that need to be changed for your system: 1) Correct the GPIB addresses in IVProcedure.startup for your instruments 2) Correct the directory to save files in MainWindow.queue Run the program by changing to the directory containing this file and calling: python iv_yokogawa.py """ import sys from time import sleep import numpy as np from pymeasure.instruments.keithley import Keithley2000 from pymeasure.instruments.yokogawa import Yokogawa7651 from pymeasure.display.Qt import QtWidgets from pymeasure.display.windows import ManagedWindow from pymeasure.experiment import ( Procedure, FloatParameter, unique_filename, Results ) import logging log = logging.getLogger('') log.addHandler(logging.NullHandler()) class IVProcedure(Procedure): max_current = FloatParameter('Maximum Current', units='mA', default=10) min_current = FloatParameter('Minimum Current', units='mA', default=-10) current_step = FloatParameter('Current Step', units='mA', default=0.1) delay = FloatParameter('Delay Time', units='ms', default=20) voltage_range = FloatParameter('Voltage Range', units='V', default=10) DATA_COLUMNS = ['Current (A)', 'Voltage (V)', 'Resistance (ohm)'] def startup(self): log.info("Setting up instruments") self.meter = Keithley2000("GPIB::25") self.meter.measure_voltage() self.meter.voltage_range = self.voltage_range self.meter.voltage_nplc = 1 # Integration constant to Medium self.source = Yokogawa7651("GPIB::4") self.source.apply_current() self.source.source_current_range = self.max_current * 1e-3 # A self.source.complinance_voltage = self.voltage_range self.source.enable_source() sleep(1) def execute(self): currents_up = np.arange(self.min_current, self.max_current, self.current_step) currents_down = np.arange(self.max_current, self.min_current, -self.current_step) currents = np.concatenate((currents_up, currents_down)) # Include the reverse currents *= 1e-3 # to mA from A steps = len(currents) log.info("Starting to sweep through current") for i, current in enumerate(currents): log.debug("Measuring current: %g mA" % current) self.source.source_current = current # Or use self.source.ramp_to_current(current, delay=0.1) sleep(self.delay * 1e-3) voltage = self.meter.voltage if abs(current) <= 1e-10: resistance = np.nan else: resistance = voltage / current data = { 'Current (A)': current, 'Voltage (V)': voltage, 'Resistance (ohm)': resistance } self.emit('results', data) self.emit('progress', 100. * i / steps) if self.should_stop(): log.warning("Catch stop command in procedure") break def shutdown(self): self.source.shutdown() log.info("Finished") class MainWindow(ManagedWindow): def __init__(self): super().__init__( procedure_class=IVProcedure, inputs=[ 'max_current', 'min_current', 'current_step', 'delay', 'voltage_range' ], displays=[ 'max_current', 'min_current', 'current_step', 'delay', 'voltage_range' ], x_axis='Current (A)', y_axis='Voltage (V)' ) self.setWindowTitle('IV Measurement') def queue(self): directory = "./" # Change this to the desired directory filename = unique_filename(directory, prefix='IV') procedure = self.make_procedure() results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) if __name__ == "__main__": app = QtWidgets.QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec()) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275456.9991941 pymeasure-0.16.0/examples/Notebook Experiments/0000755000175100017510000000000015203313301021127 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Notebook Experiments/default_config.ini0000644000175100017510000000024615203313266024615 0ustar00runnerrunner[Filename] directory = data ext = csv [Logging] console = 1 console_level = INFO filename = test.log file_level = DEBUG [matplotlib.rcParams] figure.figsize = [6,4]././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Notebook Experiments/script.ipynb0000644000175100017510000000606515203313266023517 0ustar00runnerrunner{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# ```Experiment``` class for live in-line plotting with jupyter\n", "This example uses the ```Experiment``` class to create a measurement from a ```procedure``` object." ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "%%writefile procedures.py\n", "import random\n", "from time import sleep\n", "\n", "import logging\n", "log = logging.getLogger('')\n", "log.addHandler(logging.NullHandler())\n", "\n", "from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter\n", "\n", "class TestProcedure(Procedure):\n", "\n", " iterations = IntegerParameter('Loop Iterations', default=100)\n", " delay = FloatParameter('Delay Time', units='s', default=0.2)\n", " seed = Parameter('Random Seed', default='12345')\n", "\n", " DATA_COLUMNS = ['Iteration', 'Random Number']\n", "\n", " def startup(self):\n", " log.info(\"Setting up random number generator\")\n", " random.seed(self.seed)\n", "\n", " def execute(self):\n", " log.info(\"Starting to generate numbers\")\n", " for i in range(self.iterations):\n", " data = {\n", " 'Iteration': i,\n", " 'Random Number': random.random()\n", " }\n", " log.debug(\"Produced numbers: %s\" % data)\n", " self.emit('results', data)\n", " self.emit('progress', 100.*i/self.iterations)\n", " sleep(self.delay)\n", " if self.should_stop():\n", " log.warning(\"Catch stop command in procedure\")\n", " break\n", "\n", " def shutdown(self):\n", " log.info(\"Finished\")" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "from pymeasure.experiment import Experiment\n", "from procedures import TestProcedure\n", "%matplotlib inline" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "experiment = Experiment('test', TestProcedure(iterations=100, delay=.1))" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "experiment.start()\n", "experiment.plot_live('Iteration', 'Random Number')" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.7.9" } }, "nbformat": 4, "nbformat_minor": 1 } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/Notebook Experiments/script2.ipynb0000644000175100017510000001657415203313266023607 0ustar00runnerrunner{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# More features for ```Experiment``` class: custom config, `Measurable` parameter, `analysis` function\n", "\n", "This example uses the ```Experiment``` class to create a measurement from a ```procedure``` object, with the ```Measurable``` parameter to automatically generate sorted ```DATA_COLUMNS``` and ```MEASURE``` lists (which is then passed to the ```get_datapoint``` function of the ```Procedure``` class).\n", "\n", "The file ```my_config.ini``` is passed to set custom data saving, logging and matplotlib options.\n", "\n", "The ```analysis``` function is passed as an optional attribute, to produce on-the-fly data analysis for live plotting (only the raw data is saved on disk). To have analysed data save on disk, create an empty ```Measurable``` and update it in the ```measure``` loop as also shown in the example below." ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "%%writefile my_config.ini\n", "[Filename]\n", "prefix = my_data_\n", "dated_folder = 1\n", "directory = data\n", "ext = csv\n", "index = \n", "datetimeformat = %Y%m%d_%H%M%S\n", "\n", "[Logging]\n", "console = 1\n", "console_level = WARNING\n", "filename = test.log\n", "file_level = DEBUG\n", "\n", "[matplotlib.rcParams]\n", "axes.axisbelow = True\n", "axes.prop_cycle = cycler('color', ['b', 'g', 'r', 'c', 'm', 'y', 'k'])\n", "axes.edgecolor = 'white'\n", "axes.facecolor = '#EAEAF2'\n", "axes.grid = True\n", "axes.labelcolor = '.15'\n", "axes.labelsize = 11.0\n", "axes.linewidth = 0.0\n", "axes.titlesize = 12.0\n", "figure.facecolor = 'white'\n", "figure.figsize = [8.0, 5.5]\n", "font.sans-serif = ['Arial', 'Liberation Sans', 'Bitstream Vera Sans', 'sans-serif']\n", "grid.color = 'white'\n", "grid.linestyle = '-'\n", "grid.linewidth = 1.0\n", "image.cmap = 'Greys'\n", "legend.fontsize = 10.0\n", "legend.frameon = False\n", "legend.numpoints = 1\n", "legend.scatterpoints = 1\n", "lines.linewidth = 1.75\n", "lines.markeredgewidth = 0.0\n", "lines.markersize = 7.0\n", "lines.solid_capstyle = 'round'\n", "patch.facecolor = (0.2980392156862745, 0.4470588235294118, 0.6901960784313725)\n", "patch.linewidth = 0.3\n", "text.color = '.15'\n", "xtick.color = '.15'\n", "xtick.direction = 'out'\n", "xtick.labelsize = 10.0\n", "xtick.major.pad = 7.0\n", "xtick.major.size = 0.0\n", "xtick.major.width = 1.0\n", "xtick.minor.size = 0.0\n", "ytick.color = '.15'\n", "ytick.direction = 'out'\n", "ytick.labelsize = 10.0\n", "ytick.major.pad = 7.0\n", "ytick.major.size = 0.0\n", "ytick.major.width = 1.0\n", "ytick.minor.size = 0.0" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "%%writefile procedures.py\n", "import random\n", "from time import sleep\n", "\n", "import logging\n", "log = logging.getLogger('')\n", "log.addHandler(logging.NullHandler())\n", "\n", "from pymeasure.experiment import Procedure, IntegerParameter, Parameter, FloatParameter, Measurable\n", "\n", "class TestProcedure(Procedure):\n", " \n", " iterations = IntegerParameter('Loop Iterations', default=100)\n", " delay = FloatParameter('Delay Time', units='s', default=0.2)\n", " seed = Parameter('Random Seed', default='12345')\n", " iteration = Measurable('Iteration', default = 0)\n", " random_number = Measurable('Random Number', random.random)\n", " offset = Measurable('Random Number + 1', default = 0)\n", "\n", " def startup(self):\n", " log.info(\"Setting up random number generator\")\n", " random.seed(self.seed)\n", " \n", " def measure(self):\n", " data = self.get_datapoint()\n", " data['Random Number + 1'] = data['Random Number'] + 1\n", " log.debug(\"Produced numbers: %s\" % data)\n", " self.emit('results', data)\n", " self.emit('progress', 100.*self.iteration.value/self.iterations)\n", "\n", " def execute(self):\n", " log.info(\"Starting to generate numbers\")\n", " for self.iteration.value in range(self.iterations):\n", " self.measure()\n", " sleep(self.delay)\n", " if self.should_stop():\n", " log.warning(\"Catch stop command in procedure\")\n", " break\n", "\n", " def shutdown(self):\n", " log.info(\"Finished\")" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "%%writefile analysis.py\n", "def add_offset(data, offset):\n", " return data['Random Number'] + offset\n", "\n", "def analyse(data):\n", " data['Random Number + 2'] = add_offset(data, 2)\n", " return data" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "from pymeasure.experiment import Experiment, config\n", "from procedures import TestProcedure\n", "from analysis import analyse\n", "config.set_file('my_config.ini')\n", "%matplotlib inline" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "scrolled": true }, "outputs": [], "source": [ "procedure = TestProcedure(iterations=10, delay=.1)\n", "experiment = Experiment('test', procedure, analyse)" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "experiment.start()\n", "import pylab as pl\n", "pl.figure(figsize=(10,4))\n", "ax1 = pl.subplot(121)\n", "experiment.plot('Iteration', 'Random Number', ax=ax1)\n", "ax2 = pl.subplot(122)\n", "experiment.plot('Iteration', 'Random Number + 1', ax=ax2)\n", "experiment.plot_live()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Analysed data" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "experiment.data" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Raw data (as saved on disk)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "scrolled": true }, "outputs": [], "source": [ "experiment.results.data" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Filename generated by config preferences" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "experiment.filename" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.7.9" } }, "nbformat": 4, "nbformat_minor": 1 } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/examples/README.md0000644000175100017510000000473215203313266016362 0ustar00runnerrunner# Examples There are a number of examples for learning how to use PyMeasure. Many of them make a great starting point for your own graphical user interface (GUI) or command line script. Run one of the examples in the command line (or "Anaconda prompt"). ```bash python gui.py ``` ## Basic The following examples simulate data using a random number generator, so they do not require an instrument to be connected. They show off the basic structure for setting up your measurement. 1. [gui.py](Basic/gui.py) - A graphical user interface example with live-plotting and full features. 2. [script_plotter.py](Basic/script.py) - A command line example, which also has a live-plot. 3. [script.py](Basic/script.py) - A simple command line example. 4. [gui_custom_inputs.py](Basic/gui_custom_inputs.py) - An extension of [gui.py](Basic/gui.py), which uses a [custom Qt Creator file](Basic/gui_custom_inputs.ui) for the inputs. Notice in all of these examples, the Procedure class is the same. Once you define your Procedure, the choice of interface is up to you. ## Current-Voltage Measurements There are two examples of for measuring current-voltage (IV) characteristics, which use different instruments to make the measurement. They are based on [gui.py](Basic/gui.py). 1. [iv_yokogawa.py](Current-Voltage Measurements/iv_yokogawa.py) - Uses the Yokogawa 7651 Programmable Source to provide a current and measures the voltage with a Keithley 2000 Multimeter. 2. [iv_keithley.py](Current-Voltage Measurements/iv_keithley.py) - Uses the Keithley 2400 SourceMeter to provide a current and measures the voltage with a Keithley 2000 Multimeter. This has higher precision in the voltage than using the SourceMeter allow. ## Notebook Experiments Besides the interfaces shown in the [Basic examples](#basic), you can also make measurements in Jupyter notebooks. It is recommended that you use caution when using this technique, as the notebooks allow scripts to be executed out of order and they do not provide the same level of performance as the standard interfaces. Despite these caveats, the notebooks can be a flexible method for running custom experiments, where the Procedure needs to be modified often. 1. [script.ipynb](Notebook Experiments/script.ipynb) - Runs the simulated random number Procedure from [gui.py](Basic/gui.py) in a notebook. 2. [script2.ipynb](Notebook Experiments/script2.ipynb) - Extends [script.ipynb](Notebook Experiments/script.ipynb), using custom configurations and Measureable parameters. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0004134 pymeasure-0.16.0/pymeasure/0000755000175100017510000000000015203313301015257 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/__init__.py0000644000175100017510000000522215203313266017403 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import warnings # Maximally flexible approach to obtain version numbers, based on this approach: # https://github.com/pypa/setuptools_scm/issues/143#issuecomment-672878863 # Sadly, this does not work with editable installs, which bake in version info on installation. # see also https://github.com/pyusb/pyusb/pull/307#issuecomment-650797688 try: # If a user has setuptools_scm installed, assume they want the most up to date version string. # Alternatively, we could use a dummy dev module that is never packaged whose presence signals # that we are in an editable install/repo, see https://github.com/pycalphad/pycalphad/pull/341 import setuptools_scm __version__ = setuptools_scm.get_version(root='..', relative_to=__file__) del setuptools_scm except (ImportError, LookupError): # Setuptools_scm was not found, or it could not find a version, so use installation metadata. from importlib.metadata import version, PackageNotFoundError try: __version__ = version("pymeasure") # Alternatively, if the current approach is too slow, we could add # 'write_to = "pymeasure/_version.py"' in pyproject.toml and use the generated file here: # from ._version import version as __version__ except PackageNotFoundError: warnings.warn('Could not find pymeasure version, it does not seem to be installed. ' 'Either install it (editable or full) or install setuptools_scm') __version__ = '0.0.0' finally: del version, PackageNotFoundError ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0012143 pymeasure-0.16.0/pymeasure/adapters/0000755000175100017510000000000015203313301017062 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/__init__.py0000644000175100017510000000317015203313266021206 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from .adapter import Adapter, FakeAdapter from .protocol import ProtocolAdapter log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: from pymeasure.adapters.visa import VISAAdapter from pymeasure.adapters.prologix import PrologixAdapter except ImportError: log.warning("PyVISA library could not be loaded") try: from pymeasure.adapters.serial import SerialAdapter except ImportError: log.warning("PySerial library could not be loaded") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/adapter.py0000644000175100017510000002435315203313266021075 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from typing import Optional, Protocol, Sequence, Union, runtime_checkable import numpy as np from copy import copy from pyvisa.util import to_ieee_block, to_hp_block, to_binary_block, BINARY_DATATYPES @runtime_checkable class ConnectionProtocol(Protocol): """Protocol defining the minimal interface for an Adapter's connection object. All connection objects used by :class:`Adapter` subclasses must at least implement a :meth:`close` method. Specific adapter subclasses may require additional methods from their connection objects. """ def close(self) -> None: """Close the connection.""" ... class Adapter: """ Base class for Adapter child classes, which adapt between the Instrument object and the connection, to allow flexible use of different connection techniques. This class should only be inherited from. :param log: Parent logger of the 'Adapter' logger. :param \\**kwargs: Keyword arguments just to be cooperative. """ connection: ConnectionProtocol def __init__(self, log: Optional[logging.Logger] = None, **kwargs): super().__init__(**kwargs) if log is None: self.log = logging.getLogger("Adapter") else: self.log = log.getChild("Adapter") self.log.addHandler(logging.NullHandler()) def __del__(self) -> None: """Close connection upon garbage collection of the device.""" self.close() def close(self) -> None: """Close the connection.""" connection = getattr(self, "connection", None) if connection is not None: self.connection.close() # Directly called methods, which ensure proper logging of the communication # without the termination characters added by the particular adapters. # DO NOT OVERRIDE IN SUBCLASS! def write(self, command: str, **kwargs) -> None: """Write a string command to the instrument appending `write_termination`. Do not override in a subclass! :param str command: Command string to be sent to the instrument (without termination). :param \\**kwargs: Keyword arguments for the connection itself. """ self.log.debug("WRITE:%s", command) self._write(command, **kwargs) def write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content` to the instrument. Do not override in a subclass! :param bytes content: The bytes to write to the instrument. :param \\**kwargs: Keyword arguments for the connection itself. """ self.log.debug("WRITE:%s", content) self._write_bytes(content, **kwargs) def read(self, **kwargs) -> str: """Read up to (excluding) `read_termination` or the whole read buffer. Do not override in a subclass! :param \\**kwargs: Keyword arguments for the connection itself. :returns str: ASCII response of the instrument (excluding read_termination). """ read = self._read(**kwargs) self.log.debug("READ:%s", read) return read def read_bytes(self, count: int = -1, break_on_termchar: bool = False, **kwargs) -> bytes: """Read a certain number of bytes from the instrument. Do not override in a subclass! :param int count: Number of bytes to read. A value of -1 indicates to read from the whole read buffer. :param bool break_on_termchar: Stop reading at a termination character. :param \\**kwargs: Keyword arguments for the connection itself. :returns bytes: Bytes response of the instrument (including termination). """ read = self._read_bytes(count, break_on_termchar, **kwargs) self.log.debug("READ:%s", read) return read # Methods to implement in the subclasses. def _write(self, command: str, **kwargs) -> None: """Write string to the instrument. Implement in subclass.""" raise NotImplementedError("Adapter class has not implemented writing.") def _write_bytes(self, content: bytes, **kwargs) -> None: """Write bytes to the instrument. Implement in subclass.""" raise NotImplementedError("Adapter class has not implemented writing bytes.") def _read(self, **kwargs) -> str: """Read string from the instrument. Implement in subclass.""" raise NotImplementedError("Adapter class has not implemented reading.") def _read_bytes(self, count: int, break_on_termchar: bool, **kwargs) -> bytes: """Read bytes from the instrument. Implement in subclass.""" raise NotImplementedError("Adapter class has not implemented reading bytes.") def flush_read_buffer(self) -> None: """Flush and discard the input buffer. Implement in subclass.""" raise NotImplementedError("Adapter class has not implemented input flush.") # Binary format methods def read_binary_values( self, header_bytes: int = 0, termination_bytes: Optional[int] = None, dtype=np.float32, sep: str = "", **kwargs, ): """ Returns a numpy array from a query for binary data :param int header_bytes: Number of bytes to ignore in header. :param int termination_bytes: Number of bytes to strip at end of message or None. :param dtype: The NumPy data type to format the values with. :param string sep: Separator between chars. If given, use fromstring, otherwise frombytes. :param \\**kwargs: Further arguments for the NumPy fromstring / frombytes method. :returns: NumPy array of values :raises ValueError: if the data buffer is empty or malformed """ binary = self.read_bytes(-1) # header = binary[:header_bytes] data = binary[header_bytes:termination_bytes] if sep == "": return np.frombuffer(data, dtype=dtype, **kwargs) else: return np.fromstring(data, dtype=dtype, sep=sep, **kwargs) def _format_binary_values( self, values: Sequence[Union[int, float]], datatype: BINARY_DATATYPES = "f", is_big_endian: bool = False, header_fmt: str = "ieee", ) -> bytes: """Format values in binary format, used internally in :meth:`Adapter.write_binary_values`. :param values: data to be written to the device. :param datatype: format string for a single element (valid values: 'b', 'B', 'h', 'H', 'i', 'I', 'l', 'L', 'q', 'Q', 'f', 'd', 's'). :param is_big_endian: boolean indicating endianness. :param header_fmt: format of the header prefixing the data ("ieee", "hp", "empty"). :return: binary string. """ if header_fmt == "ieee": block = to_ieee_block(values, datatype, is_big_endian) elif header_fmt == "hp": block = to_hp_block(values, datatype, is_big_endian) elif header_fmt == "empty": block = to_binary_block(values, b"", datatype, is_big_endian) else: raise ValueError("Unsupported header_fmt: %s" % header_fmt) return block def write_binary_values( self, command: str, values: Sequence[Union[int, float]], termination: str = "", **kwargs ) -> int: """ Write binary data to the instrument, e.g. waveform for signal generators :param command: command string to be sent to the instrument :param values: iterable representing the binary values :param termination: String added afterwards to terminate the message. :param \\**kwargs: Key-word arguments to pass onto :meth:`Adapter._format_binary_values` :returns: number of bytes written """ block = self._format_binary_values(values, **kwargs) message = command.encode() + block + termination.encode() self.write_bytes(message) return len(message) class FakeAdapter(Adapter): """Provides a fake adapter for debugging purposes, which bounces back the command so that arbitrary values testing is possible. .. code-block:: python a = FakeAdapter() assert a.read() == "" a.write("5") assert a.read() == "5" assert a.read() == "" assert a.ask("10") == "10" assert a.values("10") == [10] """ _buffer: str = "" def _read(self, **kwargs) -> str: """Return the last commands given after the last read call.""" result = copy(self._buffer) # Reset the buffer self._buffer = "" return result def _read_bytes(self, count: int, break_on_termchar: bool, **kwargs) -> bytes: """Return the last commands given after the last read call.""" result = copy(self._buffer) # Reset the buffer self._buffer = "" return result[:count].encode() def _write(self, command: str, **kwargs) -> None: """Write the command to a buffer, so that it can be read back.""" self._buffer += command def _write_bytes(self, content: bytes, **kwargs) -> None: """Write the content to a buffer, so that it can be read back.""" self._buffer += content.decode() def __repr__(self) -> str: return "" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/prologix.py0000644000175100017510000003143715203313266021321 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import time from pymeasure.adapters import VISAAdapter from pyvisa.constants import VI_ATTR_ASRL_AVAIL_NUM class PrologixAdapter(VISAAdapter): """ Encapsulates the additional commands necessary to communicate over a Prologix GPIB-USB Adapter, using the :class:`VISAAdapter`. Each PrologixAdapter is constructed based on a connection to the Prologix device itself and the GPIB address of the instrument to be communicated to. Connection sharing is achieved by using the :meth:`.gpib` method to spawn new PrologixAdapters for different GPIB addresses. :param resource_name: A `VISA resource string `__ that identifies the connection to the Prologix device itself, for example "ASRL5" for the 5th COM port. :param address: Integer GPIB address of the desired instrument. :param auto: Enable or disable read-after-write and address instrument to listen. :param eoi: Enable or disable EOI assertion. :param eos: Set command termination string (CR+LF, CR, LF, or "") :param gpib_read_timeout: Set read timeout for GPIB communication in milliseconds from 1..3000 :param kwargs: Key-word arguments if constructing a new serial object :ivar address: Integer GPIB address of the desired instrument. Usage example: .. code:: adapter = PrologixAdapter("ASRL5::INSTR", 7) sourcemeter = Keithley2400(adapter) # at GPIB address 7 # generate another instance with a different GPIB address: adapter2 = adapter.gpib(9) multimeter = Keithley2000(adapter2) # at GPIB address 9 To allow user access to the Prologix adapter in Linux, create the file: :code:`/etc/udev/rules.d/51-prologix.rules`, with contents: .. code-block:: bash SUBSYSTEMS=="usb",ATTRS{idVendor}=="0403",ATTRS{idProduct}=="6001",MODE="0666" Then reload the udev rules with: .. code-block:: bash sudo udevadm control --reload-rules sudo udevadm trigger Since the Prologix adapter uses the same communication channel (an USB CDC) for both, communication with the adapter itself, as well as communication over GPIB, certain things need to be kept in mind: - Operations that need to read from GPIB use the standard :meth:`read` method. - Operations that just read responses from the Prologix itself need to add the parameter :code:`prologix=True` to :meth:`read`; this avoids requesting data from GPIB. This is also necessary when the adapter is put into "listen-only" mode, where all GPIB traffic is automatically being passed up. - Binary data must be passed to the bus using :meth:`write_binary_values`. This takes care of properly escaping those binary values that would otherwise be interpreted by the Prologix adapter. Note that the default for :meth:`write_binary_values` are to assume floating-point binary data, and prepend IEEE headers. In order to pass just plain bytes to the adapter, tune the :code:`datatype` and :code:`header_fmt` parameters: .. code:: multimeter.write_binary_values('W', [addr], datatype='B', header_fmt='empty') """ def __init__(self, resource_name, address=None, auto=False, eoi=True, eos="\n", gpib_read_timeout=None, **kwargs): super().__init__(resource_name, asrl={ 'timeout': 500, 'write_termination': "\n", }, **kwargs) self.address = address if not isinstance(resource_name, PrologixAdapter): self.auto = auto self.eoi = eoi self.eos = eos if gpib_read_timeout is not None: self.gpib_read_timeout = gpib_read_timeout @property def auto(self): """Control whether to address instruments to talk after sending them a command (bool). Configure Prologix GPIB controller to automatically address instruments to talk after sending them a command in order to read their response. The feature called, Read-After-Write, saves the user from having to issue read commands repeatedly. This property enables (True) or disables (False) this feature. """ self.write("++auto") return bool(int(self.read(prologix=True))) @auto.setter def auto(self, value): self.write(f"++auto {int(value)}") @property def eoi(self): """Control whether to assert the EOI signal with the last character of any command sent over GPIB port (bool). Some instruments require EOI signal to be asserted in order to properly detect the end of a command. """ self.write("++eoi") return bool(int(self.read(prologix=True))) self.read(prologix=True) @eoi.setter def eoi(self, value): self.write(f"++eoi {int(value)}") @property def eos(self): """Control GPIB termination characters (str). possible values: - CR+LF - CR - LF - empty string When data from host is received, all non-escaped LF, CR and ESC characters are removed and GPIB terminators, as specified by this command, are appended before sending the data to instruments. This command does not affect data from instruments received over GPIB port. """ values = {0: "\r\n", 1: "\r", 2: "\n", 3: ""} self.write("++eos") return values[int(self.read(prologix=True))] @eos.setter def eos(self, value): values = {"\r\n": 0, "\r": 1, "\n": 2, "": 3} self.write(f"++eos {values[value]}") @property def gpib_read_timeout(self): """Control the timeout value for the GPIB communication in milliseconds possible values: 1 - 3000 """ self.write("++read_tmo_ms") return int(self.read(prologix=True)) @gpib_read_timeout.setter def gpib_read_timeout(self, value): self.write(f"++read_tmo_ms {value}") @property def version(self): """Get the version string of the Prologix controller. """ self.write('++ver') return self.read(prologix=True) def reset(self): """Perform a power-on reset of the controller. The process takes about 5 seconds. All input received during this time is ignored and the connection is closed. """ self.write('++rst') def write(self, command, **kwargs): """Write a string command to the instrument appending `write_termination`. If the GPIB address in :attr:`address` is defined, it is sent first. :param str command: Command string to be sent to the instrument (without termination). :param kwargs: Keyword arguments for the connection itself. """ # Overrides write instead of _write in order to ensure proper logging if self.address is not None and not command.startswith("++"): super().write("++addr %d" % self.address, **kwargs) super().write(command, **kwargs) def _format_binary_values(self, values, datatype='f', is_big_endian=False, header_fmt="ieee"): """Format values in binary format, used internally in :meth:`.write_binary_values`. :param values: data to be written to the device. :param datatype: the format string for a single element. See struct module. :param is_big_endian: boolean indicating endianess. :param header_fmt: Format of the header prefixing the data ("ieee", "hp", "empty"). :return: binary string. :rtype: bytes """ block = super()._format_binary_values(values, datatype, is_big_endian, header_fmt) # Prologix needs certian characters to be escaped. # Special care must be taken when sending binary data to instruments. If any of the # following characters occur in the binary data -- CR (ASCII 13), LF (ASCII 10), ESC # (ASCII 27), '+' (ASCII 43) - they must be escaped by preceding them with an ESC # character. special_chars = b'\x0d\x0a\x1b\x2b' new_block = b'' for b in block: escape = b'' if b in special_chars: escape = b'\x1b' new_block += (escape + bytes((b,))) return new_block def write_binary_values(self, command, values, **kwargs): """ Write binary data to the instrument, e.g. waveform for signal generators. values are encoded in a binary format according to IEEE 488.2 Definite Length Arbitrary Block Response Data block. :param command: SCPI command to be sent to the instrument :param values: iterable representing the binary values :param kwargs: Key-word arguments to pass onto :meth:`._format_binary_values` :returns: number of bytes written """ if self.address is not None: address_command = "++addr %d\n" % self.address self.write(address_command) super().write_binary_values(command, values, "\n", **kwargs) def _read(self, prologix=False, **kwargs): """Read up to (excluding) `read_termination` or the whole read buffer. :param prologix: Read the prologix adapter itself. :param kwargs: Keyword arguments for the connection itself. :returns str: ASCII response of the instrument (excluding read_termination). """ if not prologix: self.write("++read eoi") return super()._read() def _read_bytes(self, count, break_on_termchar=False, **kwargs): """Read bytes from the instrument. :param int count: Number of bytes to read. A value of -1 indicates to read from the whole read buffer. :param bool break_on_termchar: Stop reading at a termination character. :param \\**kwargs: Keyword arguments for the connection itself. :returns bytes: Bytes response of the instrument (including termination). """ avail = self.connection.get_visa_attribute(VI_ATTR_ASRL_AVAIL_NUM) if avail == 0: # nothing buffered, need to request data from Prologix self.write("++read eoi") return super()._read_bytes(count, break_on_termchar, **kwargs) def gpib(self, address, **kwargs): """ Return a PrologixAdapter object that references the GPIB address specified, while sharing the Serial connection with other calls of this function :param address: Integer GPIB address of the desired instrument :param kwargs: Arguments for the initialization :returns: PrologixAdapter for specific GPIB address """ return PrologixAdapter(self, address, **kwargs) def _check_for_srq(self): # it was int(self.ask("++srq")) self.write("++srq") return int(self.read()) def wait_for_srq(self, timeout=25, delay=0.1): """ Blocks until a SRQ, and leaves the bit high :param timeout: Timeout duration in seconds. :param delay: Time delay between checking SRQ in seconds. :raises TimeoutError: "Waiting for SRQ timed out." """ stop = time.perf_counter() + timeout while self._check_for_srq() != 1: if time.perf_counter() > stop: raise TimeoutError("Waiting for SRQ timed out.") time.sleep(delay) def __repr__(self): if self.address is not None: return (f"") else: return f"" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/protocol.py0000644000175100017510000002117115203313266021311 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from __future__ import annotations import logging from typing import Optional, Sequence, Union from unittest.mock import MagicMock from warnings import warn from .adapter import Adapter log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) BYTABLE = Union[bytes, bytearray, str, list[int], tuple[int, ...], int, float] def to_bytes( command: BYTABLE, ) -> bytes: """Change `command` to a bytes object""" if isinstance(command, bytes): return command elif isinstance(command, bytearray): return bytes(command) elif isinstance(command, str): return command.encode("utf-8") elif isinstance(command, (list, tuple)): return bytes(command) elif isinstance(command, (int, float)): return str(command).encode("utf-8") raise TypeError(f"Invalid input of type {type(command).__name__}.") class ProtocolAdapter(Adapter): """ Adapter class for testing the command exchange protocol without instrument hardware. This adapter is primarily meant for use within :func:`pymeasure.test.expected_protocol()`. The :attr:`connection` attribute is a :class:`unittest.mock.MagicMock` such that every call returns. If you want to set a return value, you can use :code:`adapter.connection.some_method.return_value = 7`, such that a call to :code:`adapter.connection.some_method()` will return `7`. Similarly, you can verify that this call to the connection method happened with :code:`assert adapter.connection.some_method.called is True`. You can specify dictionaries with return values of attributes and methods. :param list comm_pairs: List of "reference" message pair tuples. The first element is what is sent to the instrument, the second one is the returned message. 'None' indicates that a pair member (write or read) does not exist. The messages do **not** include the termination characters. :param connection_attributes: Dictionary of connection attributes and their values. :param connection_methods: Dictionary of method names of the connection and their return values. """ connection: MagicMock def __init__( self, comm_pairs: Optional[Sequence[tuple[Union[BYTABLE, None], Union[BYTABLE, None]]]] = None, connection_attributes: Optional[dict] = None, connection_methods: Optional[dict] = None, **kwargs, ): """Generate the adapter and initialize internal buffers.""" super().__init__(**kwargs) # Setup communication if comm_pairs is None: comm_pairs = [] assert isinstance(comm_pairs, (list, tuple)), ( "Parameter comm_pairs has to be a list or tuple.") for pair in comm_pairs: if len(pair) != 2: raise ValueError(f'Comm_pairs element {pair} does not have two elements!') self._read_buffer: Optional[bytes] = None self._write_buffer: Optional[bytes] = None self.comm_pairs = comm_pairs self._index = 0 # Setup attributes self._setup_connection(connection_attributes, connection_methods) def _setup_connection( self, connection_attributes: Optional[dict], connection_methods: Optional[dict] ) -> None: self.connection = MagicMock() if connection_attributes is not None: for key, value in connection_attributes.items(): setattr(self.connection, key, value) if connection_methods is not None: for key, value in connection_methods.items(): getattr(self.connection, key).return_value = value def _write(self, command: str, **kwargs) -> None: """Compare the command with the expected one and fill the read.""" self._write_bytes(to_bytes(command)) assert self._write_buffer is None, ( f"Written bytes '{self._write_buffer!r}' do not match expected " f"'{self.comm_pairs[self._index][0]}'.") def _write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content`. If a command is full, fill the read.""" if self._write_buffer is None: self._write_buffer = content else: self._write_buffer += content try: p_write, p_read = self.comm_pairs[self._index] except IndexError: raise ValueError(f"No communication pair left to write '{content!r}'.") if p_write is not None and self._write_buffer == to_bytes(p_write): assert self._read_buffer is None, ( f"Unread response '{self._read_buffer!r}' present when writing. " "Maybe a property's 'check_set_errors' is not accounted for, " "a read() call is missing in a method, or the defined protocol is incorrect?" ) # Clear the write buffer self._write_buffer = None if p_read is not None: self._read_buffer = to_bytes(p_read) self._index += 1 # If _write_buffer does _not_ agree with p_write, this is not cause for # concern, because you can in principle compose a message over several writes. # It's not clear how relevant this is in real-world use, but it's analogous # to the possibility to fetch a (binary) message over several reads. def _read(self, **kwargs) -> str: """Return an already present or freshly fetched read buffer as a string.""" return self._read_bytes(-1).decode("utf-8") def _read_bytes(self, count: int, break_on_termchar: bool = False, **kwargs) -> bytes: """Read `count` number of bytes from the buffer. :param int count: Number of bytes to read. If -1, return the buffer. """ if break_on_termchar: warn(("Breaking on termination character in `read_bytes` cannot be tested. " "You have to separate the message parts in the com_pairs."), UserWarning) if self._read_buffer is not None: if count == -1 or count >= len(self._read_buffer): read = self._read_buffer self._read_buffer = None else: read = self._read_buffer[:count] self._read_buffer = self._read_buffer[count:] return read else: try: p_write, p_read = self.comm_pairs[self._index] except IndexError: raise ValueError("No communication pair left for reading.") assert p_write is None, ( f"Written '{self._write_buffer!r}' do not match expected '{p_write!r}' " "prior to read." if self._write_buffer else "Unexpected read without prior write." ) assert p_read is not None, "Communication pair cannot be (None, None)." self._index += 1 p_read = to_bytes(p_read) if count == -1 or count >= len(p_read): # _read_buffer is already empty, no action required. return p_read else: self._read_buffer = p_read[count:] return p_read[:count] def flush_read_buffer(self) -> None: """ Flush and discard the input buffer As detailed by pyvisa, discard the read buffer contents and if data was present in the read buffer and no END-indicator was present, read from the device until encountering an END indicator (which causes loss of data). """ self.connection.flush("pyvisa.constants.BufferOperation.discard_read_buffer") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/serial.py0000644000175100017510000001217215203313266020730 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from typing import Union import serial from .adapter import Adapter log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class SerialAdapter(Adapter): """Adapter class for using the Python Serial package to allow serial communication to instrument :param port: Serial port :param write_termination: String appended to messages before writing them. :param read_termination: String expected at end of read message and removed. :param \\**kwargs: Any valid key-word argument for serial.Serial """ connection: serial.Serial def __init__( self, port: Union[str, serial.SerialBase], write_termination: str = "", read_termination: str = "", **kwargs, ): super().__init__() if isinstance(port, serial.SerialBase): self.connection = port else: self.connection = serial.Serial(port, **kwargs) self.write_termination = write_termination self.read_termination = read_termination def _write(self, command: str, **kwargs) -> None: """Write a string command to the instrument appending `write_termination`. :param str command: Command string to be sent to the instrument (without termination). :param \\**kwargs: Keyword arguments for the connection itself. """ command += self.write_termination self._write_bytes(command.encode(), **kwargs) def _write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content` to the instrument. :param bytes content: The bytes to write to the instrument. :param \\**kwargs: Keyword arguments for the connection itself. """ self.connection.write(content, **kwargs) def _read(self, **kwargs) -> str: """Read up to (excluding) `read_termination` or the whole read buffer. :param \\**kwargs: Keyword arguments for the connection itself. :returns str: ASCII response of the instrument (read_termination is removed first). """ read = self._read_bytes(-1, break_on_termchar=True, **kwargs).decode() return read.removesuffix(self.read_termination) if self.read_termination else read def _read_bytes(self, count: int, break_on_termchar: bool, **kwargs) -> bytes: """Read a certain number of bytes from the instrument. :param int count: Number of bytes to read. A value of -1 indicates to read from the whole read buffer (waits for timeout). :param bool break_on_termchar: Stop reading at a termination character. :param \\**kwargs: Keyword arguments for the connection itself. :returns bytes: Bytes response of the instrument (including termination). """ if break_on_termchar and self.read_termination: return self.connection.read_until( self.read_termination.encode(), count if count > 0 else None, **kwargs ) elif count >= 0: return self.connection.read(count, **kwargs) else: # For -1 we empty the buffer completely return self._read_bytes_until_timeout() def _read_bytes_until_timeout(self, chunk_size: int = 256, **kwargs) -> bytes: """Read from the serial until a timeout occurs, regardless of the number of bytes. :chunk_size: The number of bytes attempted to in a single transaction. Multiple of these transactions will occur. """ # `Serial.readlines()` has an unpredictable timeout, see PR #866 data = bytes() while True: chunk = self.connection.read(chunk_size, **kwargs) data += chunk if len(chunk) < chunk_size: # If fewer bytes got returned, we had a timeout return data def flush_read_buffer(self) -> None: """Flush and discard the input buffer.""" self.connection.reset_input_buffer() def __repr__(self) -> str: return "" % self.connection.port ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/adapters/visa.py0000644000175100017510000002375015203313266020417 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from typing import cast, Optional, Union import pyvisa from .adapter import Adapter from .protocol import ProtocolAdapter log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) # noinspection PyPep8Naming,PyUnresolvedReferences class VISAAdapter(Adapter): """ Adapter class for the VISA library, using PyVISA to communicate with instruments. The workhorse of our library, used by most instruments. :param resource_name: A `VISA resource string `__ or GPIB address integer that identifies the target of the connection :param visa_library: PyVISA VisaLibrary Instance, path of the VISA library or VisaLibrary spec string (``@py`` or ``@ivi``). If not given, the default for the platform will be used. :param log: Parent logger of the 'Adapter' logger. :param \\**kwargs: Keyword arguments for configuring the PyVISA connection. :Kwargs: Keyword arguments are used to configure the connection created by PyVISA. This is complicated by the fact that *which* arguments are valid depends on the interface (e.g. serial, GPIB, TCPI/IP, USB) determined by the current ``resource_name``. A flexible process is used to easily define reasonable *default values* for different instrument interfaces, but also enable the instrument user to *override any setting* if their situation demands it. A kwarg that names a pyVISA interface type (most commonly ``asrl``, ``gpib``, ``tcpip``, or ``usb``) is a dictionary with keyword arguments defining defaults specific to that interface. Example: ``asrl={'baud_rate': 4200}``. All other kwargs are either generally valid (e.g. ``timeout=500``) or override any default settings from the interface-specific entries above. For example, passing ``baud_rate=115200`` when connecting via a resource name ``ASRL1`` would override a default of 4200 defined as above. See :ref:`connection_settings` for how to tweak settings when *connecting* to an instrument. See :ref:`default_connection_settings` for how to best define default settings when *implementing an instrument*. """ connection: Union[ProtocolAdapter, pyvisa.resources.MessageBasedResource] def __init__( self, resource_name: Union[ProtocolAdapter, "VISAAdapter", int, str], visa_library: str = "", log: Optional[logging.Logger] = None, **kwargs, ): super().__init__(log=log) if isinstance(resource_name, ProtocolAdapter): self.connection = resource_name self.connection.write_raw = self.connection.write_bytes # type: ignore[assignment] self.read_bytes = self.connection.read_bytes # type: ignore[method-assign] return elif isinstance(resource_name, VISAAdapter): # Allow to reuse the connection. self.resource_name = getattr(resource_name, "resource_name", None) self.connection = resource_name.connection self.manager = resource_name.manager return elif isinstance(resource_name, int): resource_name = "GPIB0::%d::INSTR" % resource_name self.resource_name = resource_name self.manager = pyvisa.ResourceManager(visa_library) # Clean up kwargs considering the interface type matching resource_name if_type = self.manager.resource_info(self.resource_name).interface_type for key in list(kwargs.keys()): # iterate over a copy of the keys as we modify kwargs # Remove all interface-specific kwargs: if key in pyvisa.constants.InterfaceType.__members__: if getattr(pyvisa.constants.InterfaceType, key) is if_type: # For the present interface, dump contents into kwargs first if they are not # present already. This way, it is possible to override default values with # kwargs passed to Instrument.__init__() for k, v in kwargs[key].items(): kwargs.setdefault(k, v) del kwargs[key] self.connection = cast(pyvisa.resources.MessageBasedResource, self.manager.open_resource( resource_name, **kwargs )) def close(self) -> None: """Close the connection. .. note:: This closes the connection to the resource for all adapters using it currently (e.g. different adapters using the same GPIB line). """ super().close() try: if self.manager.visalib.library_path == "unset": # if using the pyvisa-sim library the manager has to be also closed. # this works around https://github.com/pyvisa/pyvisa-sim/issues/82 self.manager.close() except AttributeError: # AttributeError can occur during __del__ calling close pass def _write(self, command: str, **kwargs) -> None: """Write a string command to the instrument appending `write_termination`. :param str command: Command string to be sent to the instrument (without termination). :param \\**kwargs: Keyword arguments for the connection itself. """ self.connection.write(command, **kwargs) def _write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content` to the instrument. :param bytes content: The bytes to write to the instrument. :param \\**kwargs: Keyword arguments for the connection itself. """ self.connection.write_raw(content, **kwargs) def _read(self, **kwargs) -> str: """Read up to (excluding) `read_termination` or the whole read buffer. :param \\**kwargs: Keyword arguments for the connection itself. :returns str: ASCII response of the instrument (excluding read_termination). """ return self.connection.read(**kwargs) def _read_bytes(self, count: int, break_on_termchar: bool = False, **kwargs) -> bytes: """Read a certain number of bytes from the instrument. :param int count: Number of bytes to read. A value of -1 indicates to read from the whole read buffer until timeout. :param bool break_on_termchar: Stop reading at a termination character. :param \\**kwargs: Keyword arguments for the connection itself. :returns bytes: Bytes response of the instrument (including termination). """ if count >= 0: return self.connection.read_bytes(count, break_on_termchar=break_on_termchar, **kwargs) elif break_on_termchar: return self.connection.read_raw(None, **kwargs) else: # pyvisa's `read_raw` reads until newline, if no termination_character defined # and if not configured to stop at a termination lane etc. # see https://github.com/pyvisa/pyvisa/issues/728 result = bytearray() while True: try: result.extend(self.connection.read_bytes(1)) except pyvisa.errors.VisaIOError as exc: if exc.error_code == pyvisa.constants.StatusCode.error_timeout: return bytes(result) raise def wait_for_srq(self, timeout: float = 25, delay: float = 0.1) -> None: """ Block until a SRQ, and leave the bit high :param timeout: Timeout duration in seconds :param delay: Time delay between checking SRQ in seconds """ self.connection.wait_for_srq(int(timeout * 1000)) def flush_read_buffer(self) -> None: """ Flush and discard the input buffer As detailed by pyvisa, discard the read and receivee buffer contents and if data was present in the read buffer and no END-indicator was present, read from the device until encountering an END indicator (which causes loss of data). """ try: self.connection.flush(pyvisa.constants.BufferOperation.discard_read_buffer) self.connection.flush(pyvisa.constants.BufferOperation.discard_receive_buffer) except NotImplementedError: # NotImplementedError is raised when using resource types other than `asrl` # in conjunction with pyvisa-py. # Upstream issue: https://github.com/pyvisa/pyvisa-py/issues/348 # fake discarding the read buffer by reading all available messages. timeout = self.connection.timeout self.connection.timeout = 0 try: self.read_bytes(-1) except pyvisa.errors.VisaIOError: pass finally: self.connection.timeout = timeout def __repr__(self) -> str: return "" % self.connection.resource_name ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/console.py0000644000175100017510000000411315203313266017304 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import numpy as np log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) log.warning('not implemented yet') class ProgressBar: """ ProgressBar keeps track of the progress, predicts the estimated time of arrival (ETA), and formats the bar for display in the console """ def __init__(self): self.data = np.empty() self.progress_percentage = [] self.progress_times = [] def advance(self, progress): """ Appends the progress state and the current time to the data, so that a more accurate prediction for the ETA can be made """ pass def __str__(self): """ Returns a string representation of the progress bar """ pass def display(log, port, level=logging.INFO): """ Displays the log to the console with a progress bar that always remains at the bottom of the screen and refreshes itself """ pass ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0027459 pymeasure-0.16.0/pymeasure/display/0000755000175100017510000000000015203313301016724 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/Qt.py0000644000175100017510000000355315203313266017702 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from qtpy import QtCore, QtGui, QtWidgets # noqa: F401 from qtpy.uic import loadUiType log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def fromUi(*args, **kwargs): """ Returns a Qt object constructed using loadUiType based on its arguments. All QWidget objects in the form class are set in the returned object for easy accessibility. """ form_class, base_class = loadUiType(*args, **kwargs) widget = base_class() form = form_class() form.setupUi(widget) form.retranslateUi(widget) for name in dir(form): element = getattr(form, name) if isinstance(element, QtWidgets.QWidget): setattr(widget, name, element) return widget ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/__init__.py0000644000175100017510000000342515203313266021053 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: from .manager import Manager from .plotter import Plotter except ImportError: log.warning("Python bindings for Qt (PySide, PyQt) can not be imported") def run_in_ipython(app): """ Attempts to run the QApplication in the IPython main loop, which requires the command "%gui qt" to be run prior to the script execution. On failure the Qt main loop is initialized instead """ try: from IPython.lib.guisupport import start_event_loop_qt4 except ImportError: app.exec_() else: start_event_loop_qt4(app) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/browser.py0000644000175100017510000001350315203313266020775 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from os.path import basename from .Qt import QtCore, QtGui, QtWidgets from ..experiment import Procedure log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class BaseBrowserItem: """ Base class for an experiment's browser item. BaseBrowerItem outlines core functionality for displaying progress of an experiment to the user. """ status_label = { Procedure.QUEUED: 'Queued', Procedure.RUNNING: 'Running', Procedure.FAILED: 'Failed', Procedure.ABORTED: 'Aborted', Procedure.FINISHED: 'Finished'} def setStatus(self, status): raise NotImplementedError('Must be reimplemented by subclasses') def setProgress(self, status): raise NotImplementedError('Must be reimplemented by subclasses') class BrowserItem(QtWidgets.QTreeWidgetItem, BaseBrowserItem): """ Represent a row in the :class:`~pymeasure.display.browser.Browser` tree widget """ def __init__(self, results, color, parent=None): super().__init__(parent) pixelmap = QtGui.QPixmap(24, 24) pixelmap.fill(color) self.setIcon(0, QtGui.QIcon(pixelmap)) self.setFlags(self.flags() | QtCore.Qt.ItemFlag.ItemIsUserCheckable) self.setCheckState(0, QtCore.Qt.CheckState.Checked) self.setText(1, basename(results.data_filename)) self.setStatus(results.procedure.status) self.progressbar = QtWidgets.QProgressBar() self.progressbar.setRange(0, 100) self.progressbar.setValue(0) def setStatus(self, status): self.setText(3, self.status_label[status]) if status == Procedure.FAILED or status == Procedure.ABORTED: # Set progress bar color to red return # Commented this out self.progressbar.setStyleSheet(""" QProgressBar { border: 1px solid #AAAAAA; border-radius: 5px; text-align: center; } QProgressBar::chunk { background-color: red; } """) def setProgress(self, progress): self.progressbar.setValue(int(progress)) class Browser(QtWidgets.QTreeWidget): """Graphical list view of :class:`Experiment` objects allowing the user to view the status of queued Experiments as well as loading and displaying data from previous runs. In order that different Experiments be displayed within the same Browser, they must have entries in `DATA_COLUMNS` corresponding to the `measured_quantities` of the Browser. """ def __init__(self, procedure_class, display_parameters, measured_quantities, sort_by_filename=False, parent=None): super().__init__(parent) self.display_parameters = display_parameters self.procedure_class = procedure_class self.measured_quantities = set(measured_quantities) header_labels = ["Graph", "Filename", "Progress", "Status"] for parameter in self.display_parameters: header_labels.append(getattr(self.procedure_class, parameter).name) self.setColumnCount(len(header_labels)) self.setHeaderLabels(header_labels) self.setSortingEnabled(True) self.setSelectionMode(QtWidgets.QAbstractItemView.SelectionMode.ExtendedSelection) if sort_by_filename: self.sortItems(1, QtCore.Qt.SortOrder.AscendingOrder) for i, width in enumerate([80, 140]): self.header().resizeSection(i, width) def add(self, experiment): """Add a :class:`Experiment` object to the Browser. This function checks to make sure that the Experiment measures the appropriate quantities to warrant its inclusion, and then adds a BrowserItem to the Browser, filling all relevant columns with Parameter data. """ experiment_parameters = experiment.procedure.parameter_objects() experiment_parameter_names = list(experiment_parameters.keys()) for measured_quantity in self.measured_quantities: if measured_quantity not in experiment.procedure.DATA_COLUMNS: raise Exception("Procedure does not measure the" " %s quantity." % measured_quantity) # Set the relevant fields within the BrowserItem if # that Parameter is implemented item = experiment.browser_item for i, column in enumerate(self.display_parameters): if column in experiment_parameter_names: item.setText(i + 4, str(experiment_parameters[column])) self.addTopLevelItem(item) self.setItemWidget(item, 2, item.progressbar) return item ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/console.py0000644000175100017510000002446315203313266020763 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import copy import argparse try: import progressbar # Check that progressbar is progressbar2 progressbar.streams except (AttributeError, ImportError): progressbar = None from .Qt import QtCore import signal from ..log import console_log from .browser import BaseBrowserItem from .manager import BaseManager, Experiment from ..experiment import Results, Procedure, unique_filename log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ConsoleBrowserItem(BaseBrowserItem): def __init__(self, progress_bar): self.bar = progress_bar def setStatus(self, status): if self.bar: self.bar.update(status=self.status_label[status]) def setProgress(self, progress): if self.bar: self.bar.update(progress) class ConsoleArgumentParser(argparse.ArgumentParser): special_options = { "no-progressbar": {"default": False, "desc": "Disable progressbar", "help_fields": ["default"], "action": 'store_true'}, "log-level": {"default": 'INFO', "choices": list(logging._nameToLevel.keys()), "desc": "Set log level (logging module values)", "help_fields": ["default"]}, "sequence-file": {"default": None, "desc": "Sequencer file as used/defined by the sequencer widget to " "execute a sequence of measurements", "help_fields": ["default"]}, "result-directory": {"default": ".", "desc": "Directory where experiment's result are saved", "help_fields": ["default"]}, "result-file": {"default": None, "desc": "File name where results are stored; this string is handled " "by the `unique_filename` function and hence allows for " "filling in parameter values and is suffixed by the date " "(`YYYY-MM-DD`) and an index number", "help_fields": ["default"]}, "use-result-file": {"default": None, "desc": "Result file to retrieve params from", "help_fields": ["default"]}, } def __init__(self, procedure_class, **kwargs): super().__init__(**kwargs) self.procedure_class = procedure_class self.setup_parser() def setup_parser(self): """ Setup command line arguments parsing from parameters information """ self.procedure = self.procedure_class() parameter_objects = self.procedure.parameter_objects() special_options = copy.deepcopy(self.special_options) special_opts_group = self.add_argument_group("Common options") for option, kwargs in special_options.items(): help_fields = [('units are', 'units')] + kwargs.pop('help_fields') desc = kwargs.pop('desc') kwargs['help'] = self._cli_help_fields(desc, kwargs, help_fields) special_opts_group.add_argument("--" + option, **kwargs) experiment_opts_group = self.add_argument_group("Experiment options") for name in parameter_objects: if name in special_options: raise Exception(f"Experiment option {name} " + "is already defined as common options") kwargs = {} parameter = parameter_objects[name] default, _, _type = parameter.cli_args kwargs['help'] = parameter._cli_help_fields().replace("%", "%%") kwargs['default'] = default if _type is not None: kwargs['type'] = _type experiment_opts_group.add_argument("--" + name, **kwargs) @staticmethod def _cli_help_fields(description, kwargs, help_fields): if not isinstance(kwargs, dict): raise ValueError("kwargs must be a dictionary") message = "" if isinstance(description, str): if not description.endswith("."): description += "." message += description for field in help_fields: if isinstance(field, str): field = (f"{field} is", field) if (value := kwargs.get(field[1])) is not None: prefix = field[0].capitalize() if isinstance(value, str): value = f'"{value}"' message += f" {prefix} {value}." message = message.replace("%", "%%") return message class ManagedConsole(QtCore.QCoreApplication): """ Base class for console experiment management. Parameters for :code:`__init__` constructor. :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param log_channel: :code:`logging.Logger` instance to use for logging output :param log_level: logging level :param kwargs: additional keyword arguments to be passed to the :class:`~pymeasure.display.console.ConsoleArgumentParser` constructor """ def __init__(self, procedure_class, log_channel='', log_level=logging.INFO, **kwargs, ): super().__init__([]) self.procedure_class = procedure_class self.log_channel = log_channel self.log = logging.getLogger(log_channel) self.log_level = log_level log.setLevel(log_level) self.log.setLevel(log_level) # Check if the get_estimates function is reimplemented self.use_estimator = not self.procedure_class.get_estimates == Procedure.get_estimates if self.use_estimator: log.warning("Estimator not yet implemented") # Handle Ctrl+C nicely signal.signal(signal.SIGINT, lambda sig, _: self.abort()) # Parse command line arguments parser = ConsoleArgumentParser(procedure_class, **kwargs) args = vars(parser.parse_args()) self.directory = args['result_directory'] self.filename = args['result_file'] try: log_level = int(args['log_level']) except ValueError: # Ignore and assume it is a valid level string log_level = args['log_level'] self.log_level = log_level log.setLevel(self.log_level) self.log.setLevel(self.log_level) if args['sequence_file'] is not None: raise NotImplementedError("Sequencer not yet implemented") # Set procedure parameters self.parameter_values = {} if args['use_result_file'] is not None: # Special case set parameters from log file results = Results.load(args['use_result_file']) for name in results.parameters: self.parameter_values[name] = results.parameters[name].value else: for name in args: opt_name = name.replace("_", "-") if not (opt_name in parser.special_options): self.parameter_values[name] = args[name] if progressbar and not args['no_progressbar']: progressbar.streams.wrap_stderr() self.bar = progressbar.ProgressBar(max_value=100, prefix='{variables.status}: ', variables={'status': "Unknown"}) else: self.bar = None scribe = console_log(self.log, level=self.log_level) scribe.start() # Setup Manager self.manager = BaseManager( log_level=self.log_level, parent=self) self.manager.abort_returned.connect(self._terminate) self.manager.failed.connect(self._terminate) self.manager.finished.connect(self._terminate) self.manager.log.connect(self.log.handle) def get_filename(self, directory, procedure=None): """ Return filename for saving results file :param directory: directory of the returned filename. """ if self.filename is not None: return unique_filename(directory, prefix=self.filename, procedure=procedure) else: return unique_filename(directory) def queue(self): procedure = self.procedure_class() procedure.set_parameters(self.parameter_values) filename = self.get_filename(self.directory, procedure) results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) def _terminate(self): if not self.manager.experiments.has_next(): self.quit() def abort(self): """ Aborts the currently running Experiment, but raises an exception if there is no running experiment """ self.manager.abort() def new_experiment(self, results): browser_item = ConsoleBrowserItem(self.bar) return Experiment(results, browser_item=browser_item) def exec(self): self.queue() super().exec() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/curves.py0000644000175100017510000002002215203313266020613 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import numpy as np import pyqtgraph as pg from .Qt import QtCore, QtGui log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ResultsCurve(pg.PlotDataItem): """ Creates a curve loaded dynamically from a file through the Results object. The data can be forced to fully reload on each update, useful for cases when the data is changing across the full file instead of just appending. """ def __init__(self, results, x, y, force_reload=False, wdg=None, **kwargs): super().__init__(**kwargs) self.results = results self.wdg = wdg self.pen = kwargs.get('pen', None) self.x, self.y = x, y self.force_reload = force_reload self.color = self.opts['pen'].color() def update_data(self): """Updates the data by polling the results""" if self.force_reload: self.results.reload() data = self.results.data # get the current snapshot # Set x-y data self.setData(data[self.x], data[self.y]) def set_color(self, color): self.pen.setColor(color) self.color = self.opts['pen'].color() self.updateItems(styleUpdate=True) # TODO: Add method for changing x and y class ResultsImage(pg.ImageItem): """ Creates an image loaded dynamically from a file through the Results object.""" def __init__(self, results, x, y, z, force_reload=False, wdg=None, **kwargs): self.results = results self.wdg = wdg self.x = x self.y = y self.z = z self.xstart = getattr(self.results.procedure, self.x + '_start') self.xend = getattr(self.results.procedure, self.x + '_end') self.xstep = getattr(self.results.procedure, self.x + '_step') self.xsize = int(np.ceil((self.xend - self.xstart) / self.xstep)) + 1 self.ystart = getattr(self.results.procedure, self.y + '_start') self.yend = getattr(self.results.procedure, self.y + '_end') self.ystep = getattr(self.results.procedure, self.y + '_step') self.ysize = int(np.ceil((self.yend - self.ystart) / self.ystep)) + 1 self.img_data = np.zeros((self.ysize, self.xsize, 4)) self.force_reload = force_reload self.cm = pg.colormap.get('viridis') super().__init__(image=self.img_data) # Scale and translate image so that the pixels are in the correct # position in "data coordinates" tr = QtGui.QTransform() tr.scale(self.xstep, self.ystep) tr.translate(int(self.xstart / self.xstep) - 0.5, int(self.ystart / self.ystep) - 0.5) # 0.5 so pixels centered self.setTransform(tr) def update_data(self): if self.force_reload: self.results.reload() data = self.results.data zmin = data[self.z].min() zmax = data[self.z].max() # populate the image array with the new data for idx, row in data.iterrows(): xdat = row[self.x] ydat = row[self.y] xidx, yidx = self.find_img_index(xdat, ydat) self.img_data[yidx, xidx, :] = self.colormap((row[self.z] - zmin) / (zmax - zmin)) # set image data, need to transpose since pyqtgraph assumes column-major order self.setImage(image=np.transpose(self.img_data, axes=(1, 0, 2))) def find_img_index(self, x, y): """ Finds the integer image indices corresponding to the closest x and y points of the data given some x and y data. """ indices = [self.xsize - 1, self.ysize - 1] # default to the final pixel if self.xstart <= x <= self.xend: # only change if within reasonable range indices[0] = self.round_up((x - self.xstart) / self.xstep) if self.ystart <= y <= self.yend: indices[1] = self.round_up((y - self.ystart) / self.ystep) return indices def round_up(self, x): """Convenience function since numpy rounds to even""" if x % 1 >= 0.5: return int(x) + 1 else: return int(x) def colormap(self, x): """ Return mapped color as 0.0-1.0 floats RGBA """ return self.cm.map(x, mode='float') # TODO: colormap selection class BufferCurve(pg.PlotDataItem): """ Creates a curve based on a predefined buffer size and allows data to be added dynamically. """ data_updated = QtCore.Signal() def __init__(self, **kwargs): super().__init__(**kwargs) self._buffer = None def prepare(self, size, dtype=np.float32): """ Prepares the buffer based on its size, data type """ self._buffer = np.empty((size, 2), dtype=dtype) self._ptr = 0 def append(self, x, y): """ Appends data to the curve with optional errors """ if self._buffer is None: raise Exception("BufferCurve buffer must be prepared") if len(self._buffer) <= self._ptr: raise Exception("BufferCurve overflow") # Set x-y data self._buffer[self._ptr, :2] = [x, y] self.setData(self._buffer[:self._ptr, :2]) self._ptr += 1 self.data_updated.emit() class Crosshairs(QtCore.QObject): """ Attaches crosshairs to the a plot and provides a signal with the x and y graph coordinates """ coordinates = QtCore.Signal(float, float) def __init__(self, plot, pen=None): """ Initiates the crosshars onto a plot given the pen style. Example pen: pen=pg.mkPen(color='#AAAAAA', style=QtCore.Qt.PenStyle.DashLine) """ super().__init__() self.vertical = pg.InfiniteLine(angle=90, movable=False, pen=pen) self.horizontal = pg.InfiniteLine(angle=0, movable=False, pen=pen) plot.addItem(self.vertical, ignoreBounds=True) plot.addItem(self.horizontal, ignoreBounds=True) self.position = None self.proxy = pg.SignalProxy(plot.scene().sigMouseMoved, rateLimit=60, slot=self.mouseMoved) self.plot = plot def hide(self): self.vertical.hide() self.horizontal.hide() def show(self): self.vertical.show() self.horizontal.show() def update(self): """ Updates the mouse position based on the data in the plot. For dynamic plots, this is called each time the data changes to ensure the x and y values correspond to those on the display. """ if self.position is not None: mouse_point = self.plot.vb.mapSceneToView(self.position) self.coordinates.emit(mouse_point.x(), mouse_point.y()) self.vertical.setPos(mouse_point.x()) self.horizontal.setPos(mouse_point.y()) def mouseMoved(self, event=None): """ Updates the mouse position upon mouse movement """ if event is not None: self.position = event[0] self.update() else: raise Exception("Mouse location not known") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/inputs.py0000644000175100017510000002333215203313266020635 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import re from .Qt import QtGui, QtWidgets log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Input: """ Mix-in class that connects a :mod:`Parameter <.parameters>` object to a GUI input box. :param parameter: The parameter to connect to this input box. :attr parameter: Read-only property to access the associated parameter. """ def __init__(self, parameter, **kwargs): super().__init__(**kwargs) self._parameter = None self.set_parameter(parameter) def set_parameter(self, parameter): """ Connects a new parameter to the input box, and initializes the box value. :param parameter: parameter to connect. """ self._parameter = parameter if parameter.is_set(): self.setValue(parameter.value) if hasattr(parameter, 'units') and parameter.units: self.setSuffix(" %s" % parameter.units) self.setToolTip(parameter._cli_help_fields()) def update_parameter(self): """ Update the parameter value with the Input GUI element's current value. """ self._parameter.value = self.value() @property def parameter(self): """ The connected parameter object. Read-only property; see :meth:`set_parameter`. Note that reading this property will have the side-effect of updating its value from the GUI input box. """ self.update_parameter() return self._parameter class StringInput(Input, QtWidgets.QLineEdit): """ String input box connected to a :class:`Parameter`. Parameter subclasses that are string-based may also use this input, but non-string parameters should use more specialised input classes. """ def __init__(self, parameter, parent=None, **kwargs): super().__init__(parameter=parameter, parent=parent, **kwargs) def setValue(self, value): # QtWidgets.QLineEdit has a setText() method instead of setValue() return super().setText(value) def setSuffix(self, value): pass def value(self): # QtWidgets.QLineEdit has a text() method instead of value() return super().text() class IntegerInput(Input, QtWidgets.QSpinBox): """ Spin input box for integer values, connected to a :class:`IntegerParameter`. """ def __init__(self, parameter, parent=None, **kwargs): super().__init__(parameter=parameter, parent=parent, **kwargs) if parameter.step: self.setButtonSymbols(QtWidgets.QAbstractSpinBox.ButtonSymbols.UpDownArrows) self.setSingleStep(parameter.step) self.setEnabled(True) else: self.setButtonSymbols(QtWidgets.QAbstractSpinBox.ButtonSymbols.NoButtons) def set_parameter(self, parameter): # Override from :class:`Input` self.setMinimum(parameter.minimum) self.setMaximum(parameter.maximum) super().set_parameter(parameter) # default gets set here, after min/max def stepEnabled(self): if self.parameter.step: return QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepUpEnabled | \ QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepDownEnabled else: return QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepNone class BooleanInput(Input, QtWidgets.QCheckBox): """ Checkbox for boolean values, connected to a :class:`BooleanParameter`. """ def __init__(self, parameter, parent=None, **kwargs): super().__init__(parameter=parameter, parent=parent, **kwargs) def set_parameter(self, parameter): # Override from :class:`Input` self.setText(parameter.name) super().set_parameter(parameter) def setValue(self, value): return super().setChecked(value) def setSuffix(self, value): pass def value(self): return super().isChecked() class ListInput(Input, QtWidgets.QComboBox): """ Dropdown for list values, connected to a :class:`ListParameter`. """ def __init__(self, parameter, parent=None, **kwargs): super().__init__(parameter=parameter, parent=parent, **kwargs) self._stringChoices = None self.setEditable(False) def set_parameter(self, parameter): # Override from :class:`Input` try: if hasattr(parameter, 'units') and parameter.units: suffix = " %s" % parameter.units else: suffix = "" self._stringChoices = tuple((str(choice) + suffix) for choice in parameter.choices) except TypeError: # choices is None self._stringChoices = tuple() self.clear() self.addItems(self._stringChoices) super().set_parameter(parameter) def setValue(self, value): try: index = self._parameter.choices.index(value) self.setCurrentIndex(index) except (TypeError, ValueError) as e: # no choices or choice invalid raise ValueError("Invalid choice for parameter. " "Must be one of %s" % str(self._parameter.choices)) from e def setSuffix(self, value): pass def value(self): return self._parameter.choices[self.currentIndex()] class ScientificInput(Input, QtWidgets.QDoubleSpinBox): """ Spinner input box for floating-point values, connected to a :class:`FloatParameter`. This box will display and accept values in scientific notation when appropriate. .. seealso:: Class :class:`~.FloatInput` For a non-scientific floating-point input box. """ def __init__(self, parameter, parent=None, **kwargs): super().__init__(parameter=parameter, parent=parent, **kwargs) if parameter.step: self.setButtonSymbols(QtWidgets.QAbstractSpinBox.ButtonSymbols.UpDownArrows) self.setSingleStep(parameter.step) self.setEnabled(True) else: self.setButtonSymbols(QtWidgets.QAbstractSpinBox.ButtonSymbols.NoButtons) def set_parameter(self, parameter): # Override from :class:`Input` self._parameter = parameter # required before super().set_parameter # for self.validate which is called when setting self.decimals() self.validator = QtGui.QDoubleValidator( parameter.minimum, parameter.maximum, parameter.decimals, self) self.setDecimals(parameter.decimals) self.setMinimum(parameter.minimum) self.setMaximum(parameter.maximum) self.validator.setNotation(QtGui.QDoubleValidator.Notation.ScientificNotation) super().set_parameter(parameter) # default gets set here, after min/max def validate(self, text, pos): if self._parameter.units: text = text[:-(len(self._parameter.units) + 1)] result = self.validator.validate(text, pos) return result[0], result[1] + " %s" % self._parameter.units, result[2] else: return self.validator.validate(text, pos) def fixCase(self, text): self.lineEdit().setText(text.toLower()) def toDouble(self, string): value, success = self.validator.locale().toDouble(string) if not success: raise ValueError('String could not be converted to a double') else: return value def toString(self, value, format='g', precision=6): return self.validator.locale().toString(value, format, precision) def valueFromText(self, text): text = str(text) if self._parameter.units: text = text[:-(len(self._parameter.units) + 1)] try: val = self.toDouble(text) except ValueError: val = self._parameter.default return val def textFromValue(self, value): string = self.toString(value).replace("e+", "e") string = re.sub(r"e(-?)0*(\d+)", r"e\1\2", string) return string def stepEnabled(self): if self.parameter.step: return QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepUpEnabled | \ QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepDownEnabled else: return QtWidgets.QAbstractSpinBox.StepEnabledFlag.StepNone class VectorInput(StringInput): """ String input box connected to a :class:`VectorParameter`. This box will display and accept lists. """ def setValue(self, value): # override the method from StringInput value = "[" + ", ".join(map(str, value)) + "]" # QtWidgets.QLineEdit has a setText() method instead of setValue() return super().setText(value) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/listeners.py0000644000175100017510000001064715203313266021330 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from .Qt import QtCore from .thread import StoppableQThread from ..experiment.procedure import Procedure log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: import zmq import cloudpickle except ImportError: zmq = None cloudpickle = None log.warning("ZMQ and cloudpickle are required for TCP communication") class QListener(StoppableQThread): """Base class for QThreads that need to listen for messages on a ZMQ TCP port and can be stopped by a thread- and process-safe method call """ def __init__(self, port, topic='', timeout=0.01): """ Constructs the Listener object with a subscriber port over which to listen for messages :param port: TCP port to listen on :param topic: Topic to listen on :param timeout: Timeout in seconds to recheck stop flag """ super().__init__() self.port = port self.topic = topic self.context = zmq.Context() log.debug(f"{self.__class__.__name__} has ZMQ Context: {self.context!r}") self.subscriber = self.context.socket(zmq.SUB) self.subscriber.connect('tcp://localhost:%d' % port) self.subscriber.setsockopt(zmq.SUBSCRIBE, topic.encode()) log.info("%s connected to '%s' topic on tcp://localhost:%d" % ( self.__class__.__name__, topic, port)) self.poller = zmq.Poller() self.poller.register(self.subscriber, zmq.POLLIN) self.timeout = timeout def receive(self, flags=0): topic, record = self.subscriber.recv_serialized( deserialize=lambda msg: (msg[0].decode(), cloudpickle.loads(msg[1])), flags=flags ) return topic, record def message_waiting(self): return self.poller.poll(self.timeout) def __repr__(self): return "<{}(port={},topic={},should_stop={})>".format( self.__class__.__name__, self.port, self.topic, self.should_stop()) class Monitor(QtCore.QThread): """ Monitor listens for status and progress messages from a Worker through a queue to ensure no messages are losts """ status = QtCore.Signal(int) progress = QtCore.Signal(float) log = QtCore.Signal(object) worker_running = QtCore.Signal() worker_failed = QtCore.Signal() worker_finished = QtCore.Signal() # Distinguished from QThread.finished worker_abort_returned = QtCore.Signal() def __init__(self, queue): super().__init__() self.queue = queue def run(self): while True: data = self.queue.get() if data is None: break topic, data = data if topic == 'status': self.status.emit(data) if data == Procedure.RUNNING: self.worker_running.emit() elif data == Procedure.FAILED: self.worker_failed.emit() elif data == Procedure.FINISHED: self.worker_finished.emit() elif data == Procedure.ABORTED: self.worker_abort_returned.emit() elif topic == 'progress': self.progress.emit(data) elif topic == 'log': self.log.emit(data) log.info("Monitor caught stop command") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/log.py0000644000175100017510000000406015203313266020071 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from logging import Handler from .Qt import QtCore log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class LogHandler(Handler): # Class Emitter is added to keep compatibility with PySide2 # 1. Signal needs to be class attribute of a QObject subclass # 2. logging Handler emit method clashes with QObject emit method # 3. As a consequence, the LogHandler cannot inherit both from # Handler and QObject # 4. A new utility class Emitter subclass of QObject is # introduced to handle record Signal and workaround the problem class Emitter(QtCore.QObject): record = QtCore.Signal(object) def __init__(self): super().__init__() self.emitter = self.Emitter() def connect(self, *args, **kwargs): return self.emitter.record.connect(*args, **kwargs) def emit(self, record): self.emitter.record.emit(self.format(record)) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/manager.py0000644000175100017510000002607415203313266020733 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from os.path import basename from .Qt import QtCore from .listeners import Monitor from ..experiment import Procedure from ..experiment.workers import Worker log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Experiment(QtCore.QObject): """ The Experiment class helps group the :class:`.Procedure`, :class:`.Results`, and their display functionality. Its function is only a convenient container. :param results: :class:`.Results` object :param curve_list: :class:`.ResultsCurve` list. List of curves associated with an experiment. They could represent different views of the same experiment. Not required for `.ManagedConsole` displayed experiments. :param browser_item: :class:`.BaseBrowserItem` based object """ def __init__(self, results, curve_list=None, browser_item=None, parent=None): super().__init__(parent) self.results = results self.data_filename = self.results.data_filename self.procedure = self.results.procedure self.curve_list = curve_list self.browser_item = browser_item class ExperimentQueue(QtCore.QObject): """ Represents a queue of Experiments and allows queries to be easily preformed. """ def __init__(self): super().__init__() self.queue = [] def append(self, experiment): self.queue.append(experiment) def remove(self, experiment): if experiment not in self.queue: raise Exception("Attempting to remove an Experiment that is " "not in the ExperimentQueue") else: if experiment.procedure.status == Procedure.RUNNING: raise Exception("Attempting to remove a running experiment") else: self.queue.pop(self.queue.index(experiment)) def __contains__(self, value): if isinstance(value, Experiment): return value in self.queue if isinstance(value, str): for experiment in self.queue: if basename(experiment.data_filename) == basename(value): return True return False return False def __getitem__(self, key): return self.queue[key] def next(self): """ Returns the next experiment on the queue """ for experiment in self.queue: if experiment.procedure.status == Procedure.QUEUED: return experiment raise StopIteration("There are no queued experiments") def has_next(self): """ Returns True if another item is on the queue """ try: self.next() except StopIteration: return False return True def with_browser_item(self, item): for experiment in self.queue: if experiment.browser_item is item: return experiment return None class BaseManager(QtCore.QObject): """Controls the execution of :class:`.Experiment` classes by implementing a queue system in which Experiments are added, removed, executed, or aborted. """ _is_continuous = True _start_on_add = True queued = QtCore.Signal(object) running = QtCore.Signal(object) finished = QtCore.Signal(object) failed = QtCore.Signal(object) aborted = QtCore.Signal(object) abort_returned = QtCore.Signal(object) log = QtCore.Signal(object) def __init__(self, port=5888, log_level=logging.INFO, parent=None): super().__init__(parent) self.experiments = ExperimentQueue() self._worker = None self._running_experiment = None self._monitor = None self.log_level = log_level self.port = port def is_running(self): """ Returns True if a procedure is currently running """ return self._running_experiment is not None def running_experiment(self): if self.is_running(): return self._running_experiment else: raise Exception("There is no Experiment running") def _update_progress(self, progress): if self.is_running(): self._running_experiment.browser_item.setProgress(progress) def _update_status(self, status): if self.is_running(): self._running_experiment.procedure.status = status self._running_experiment.browser_item.setStatus(status) def _update_log(self, record): self.log.emit(record) def load(self, experiment): """ Load a previously executed Experiment """ self.experiments.append(experiment) def queue(self, experiment): """ Adds an experiment to the queue. """ self.load(experiment) self.queued.emit(experiment) if self._start_on_add and not self.is_running(): self.next() def remove(self, experiment): """ Removes an Experiment """ self.experiments.remove(experiment) def clear(self): """ Remove all Experiments """ for experiment in self.experiments[:]: self.remove(experiment) def next(self): """ Initiates the start of the next experiment in the queue as long as no other experiments are currently running and there is a procedure in the queue. """ if self.is_running(): raise Exception("Another procedure is already running") else: if self.experiments.has_next(): log.debug("Manager is initiating the next experiment") experiment = self.experiments.next() self._running_experiment = experiment self._worker = Worker(experiment.results, port=self.port, log_level=self.log_level) self._worker.is_last = lambda: not self.experiments.has_next() self._monitor = Monitor(self._worker.monitor_queue) self._monitor.worker_running.connect(self._running) self._monitor.worker_failed.connect(self._failed) self._monitor.worker_abort_returned.connect(self._abort_returned) self._monitor.worker_finished.connect(self._finish) self._monitor.progress.connect(self._update_progress) self._monitor.status.connect(self._update_status) self._monitor.log.connect(self._update_log) self._monitor.start() self._worker.start() def _running(self): if self.is_running(): self.running.emit(self._running_experiment) def _clean_up(self): self._worker.join() del self._worker self._monitor.wait() del self._monitor self._worker = None self._running_experiment = None log.debug("Manager has cleaned up after the Worker") def _failed(self): log.debug("Manager's running experiment has failed") experiment = self._running_experiment self._clean_up() self.failed.emit(experiment) def _abort_returned(self): log.debug("Manager's running experiment has returned after an abort") experiment = self._running_experiment self._clean_up() self.abort_returned.emit(experiment) def _finish(self): log.debug("Manager's running experiment has finished") experiment = self._running_experiment self._clean_up() experiment.browser_item.setProgress(100) self.finished.emit(experiment) if self._is_continuous: # Continue running procedures self.next() def resume(self): """ Resume processing of the queue. """ self._start_on_add = True self._is_continuous = True self.next() def abort(self): """ Aborts the currently running Experiment, but raises an exception if there is no running experiment """ if not self.is_running(): raise Exception("Attempting to abort when no experiment " "is running") else: self._start_on_add = False self._is_continuous = False self._worker.stop() self.aborted.emit(self._running_experiment) class Manager(BaseManager): """Controls the execution of :class:`.Experiment` classes by implementing a queue system in which Experiments are added, removed, executed, or aborted. When instantiated, the Manager is linked to a :class:`.Browser` and a PyQtGraph `PlotItem` within the user interface, which are updated in accordance with the execution status of the Experiments. """ def __init__(self, widget_list, browser, port=5888, log_level=logging.INFO, parent=None): super().__init__(parent) self.experiments = ExperimentQueue() self._worker = None self._running_experiment = None self._monitor = None self.log_level = log_level self.widget_list = widget_list self.browser = browser self.port = port def load(self, experiment): """ Load a previously executed Experiment """ super().load(experiment) self.browser.add(experiment) for curve in experiment.curve_list: if curve: curve.wdg.load(curve) def remove(self, experiment): """ Removes an Experiment """ super().remove(experiment) self.browser.takeTopLevelItem( self.browser.indexOfTopLevelItem(experiment.browser_item)) for curve in experiment.curve_list: if curve: curve.wdg.remove(curve) def _finish(self): log.debug("Manager's running experiment has finished") experiment = self._running_experiment self._clean_up() experiment.browser_item.setProgress(100) for curve in experiment.curve_list: if curve: curve.update_data() self.finished.emit(experiment) if self._is_continuous: # Continue running procedures self.next() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/plotter.py0000644000175100017510000000510615203313266021003 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import sys import time from .Qt import QtWidgets from .windows import PlotterWindow from ..thread import StoppableThread log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Plotter(StoppableThread): """ Plotter dynamically plots data from a file through the Results object. .. seealso:: Tutorial :ref:`tutorial-plotterwindow` A tutorial and example on using the Plotter and PlotterWindow. """ def __init__(self, results, refresh_time=0.1, linewidth=1): super().__init__() self.results = results self.refresh_time = refresh_time self.linewidth = linewidth def run(self): app = QtWidgets.QApplication(sys.argv) window = PlotterWindow(self, refresh_time=self.refresh_time, linewidth=self.linewidth) self.setup_plot(window.plot) app.aboutToQuit.connect(window.quit) window.show() app.exec() def setup_plot(self, plot): """ This method does nothing by default, but can be overridden by the child class in order to set up custom options for the plot window, via its PlotItem_. :param plot: This window's PlotItem_ instance. .. _PlotItem: https://pyqtgraph.readthedocs.io/en/latest/graphicsItems/plotitem.html """ pass def wait_for_close(self, check_time=0.1): while not self.should_stop(): time.sleep(check_time) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/thread.py0000644000175100017510000000416215203313266020562 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from threading import Event from .Qt import QtCore log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class StoppableQThread(QtCore.QThread): """ Base class for QThreads which require the ability to be stopped by a thread-safe method call """ def __init__(self, parent=None): super().__init__(parent) self._should_stop = Event() self._should_stop.clear() def join(self, timeout=0): """ Joins the current thread and forces it to stop after the timeout if necessary :param timeout: Timeout duration in seconds """ self._should_stop.wait(timeout) if not self.should_stop(): self.stop() super().wait() def stop(self): self._should_stop.set() def should_stop(self): return self._should_stop.is_set() def __repr__(self): return "<{}(should_stop={})>".format( self.__class__.__name__, self.should_stop()) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0052097 pymeasure-0.16.0/pymeasure/display/widgets/0000755000175100017510000000000015203313301020372 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/__init__.py0000644000175100017510000000330015203313266022511 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .browser_widget import BrowserWidget from .fileinput_widget import FileInputWidget from .estimator_widget import EstimatorWidget, EstimatorThread from .image_frame import ImageFrame from .image_widget import ImageWidget from .inputs_widget import InputsWidget from .log_widget import LogWidget from .plot_frame import PlotFrame from .plot_widget import PlotWidget from .results_dialog import ResultsDialog from .sequencer_widget import SequencerWidget from .tab_widget import TabWidget from .table_widget import TableWidget from .console_widget import ConsoleWidget ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/browser_widget.py0000644000175100017510000000507715203313266024015 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..browser import Browser from ..Qt import QtWidgets log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class BrowserWidget(QtWidgets.QWidget): """ Widget wrapper for :class:`Browser` class """ def __init__(self, *args, parent=None): super().__init__(parent) self.browser_args = args self._setup_ui() self._layout() def _setup_ui(self): self.browser = Browser(*self.browser_args, parent=self) self.clear_button = QtWidgets.QPushButton('Clear all', self) self.clear_button.setEnabled(False) self.hide_button = QtWidgets.QPushButton('Hide all', self) self.hide_button.setEnabled(False) self.show_button = QtWidgets.QPushButton('Show all', self) self.show_button.setEnabled(False) self.open_button = QtWidgets.QPushButton('Open', self) self.open_button.setEnabled(True) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) hbox = QtWidgets.QHBoxLayout() hbox.setSpacing(10) hbox.setContentsMargins(-1, 6, -1, 6) hbox.addWidget(self.show_button) hbox.addWidget(self.hide_button) hbox.addWidget(self.clear_button) hbox.addStretch() hbox.addWidget(self.open_button) vbox.addLayout(hbox) vbox.addWidget(self.browser) self.setLayout(vbox) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/console_widget.py0000644000175100017510000000370215203313266023765 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pyqtgraph.console import ConsoleWidget as PGConsoleWidget from .tab_widget import TabWidget class ConsoleWidget(TabWidget, PGConsoleWidget): """Display an interactive Python console in the GUI. Allow executing arbitrary Python commands at runtime and debugging the application. It can be included in subclasses of :class:`ManagedWindowBase` by adding it to the widget_list. :param name: Name of the widget, displayed on the tab in the GUI. :param parent: The Qt parent widget. :param namespace: A dictionary of variables and modules to expose to the console. For example, ``{'window': self, 'device': your_device}``. :param text: The initial welcome message displayed in the console. """ pass ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/directory_widget.py0000644000175100017510000000543715203313266024336 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..Qt import QtCore, QtGui, QtWidgets log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class DirectoryLineEdit(QtWidgets.QLineEdit): """ Widget that allows to choose a directory path. A completer is implemented for quick completion. A browse button is available. """ def __init__(self, parent=None): super().__init__(parent=parent) completer = QtWidgets.QCompleter(self) completer.setCompletionMode(QtWidgets.QCompleter.CompletionMode.PopupCompletion) model = QtGui.QFileSystemModel(completer) model.setRootPath(model.myComputer()) model.setFilter(QtCore.QDir.Filter.Dirs | QtCore.QDir.Filter.Drives | QtCore.QDir.Filter.NoDotAndDotDot | QtCore.QDir.Filter.AllDirs) completer.setModel(model) self.setCompleter(completer) browse_action = QtGui.QAction(self) browse_action.setIcon(self.style().standardIcon( getattr(QtWidgets.QStyle.StandardPixmap, 'SP_DialogOpenButton'))) browse_action.triggered.connect(self.browse_triggered) self.addAction(browse_action, QtWidgets.QLineEdit.ActionPosition.TrailingPosition) def _get_starting_directory(self): current_text = self.text() if current_text != '' and QtCore.QDir(current_text).exists(): return current_text else: return '/' def browse_triggered(self): path = QtWidgets.QFileDialog.getExistingDirectory( self, 'Directory', self._get_starting_directory()) if path != '': self.setText(path) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/dock_widget.py0000644000175100017510000001621615203313266023247 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from os import path import json from pyqtgraph.dockarea import Dock, DockArea from pyqtgraph.dockarea.Dock import DockLabel import pyqtgraph as pg from .plot_widget import PlotWidget, PlotFrame from ..Qt import QtWidgets from .tab_widget import TabWidget log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class DockWidget(TabWidget, QtWidgets.QWidget): """ Widget that contains a DockArea with a number of Docks as determined by the length of the longest x_axis_labels or y_axis_labels list. :param name: Name for the TabWidget :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param x_axis_labels: List of data column(s) for the x-axis of the plot. If the list is shorter than y_axis_labels the last item in the list to match y_axis_labels length. :param y_axis_labels: List of data column(s) for the y-axis of the plot. If the list is shorter than x_axis_labels the last item in the list to match x_axis_labels length. :param linewidth: line width for plots in :class:`~pymeasure.display.widgets.plot_widget.PlotWidget` :param layout_path: Directory path to save dock layout state. Default is './' :param layout_filename: Optional filename for dock layout file. Default: *current procedure class* + "_dock_layout.json" :param parent: Passed on to QtWidgets.QWidget. Default is None """ def __init__(self, name, procedure_class, x_axis_labels=None, y_axis_labels=None, linewidth=1, layout_path='./', layout_filename='', parent=None): super().__init__(name, parent) self.procedure_class = procedure_class if layout_filename: self.dock_layout_filename = path.join(layout_path, layout_filename) else: self.dock_layout_filename = path.join(layout_path, procedure_class.__name__ + '_dock_layout.json') self.x_axis_labels = x_axis_labels self.y_axis_labels = y_axis_labels self.num_plots = max(len(self.x_axis_labels), len(self.y_axis_labels)) self.linewidth = linewidth self.dock_area = DockArea() self.docks = [] self.plot_frames = [] self._setup_ui() self._layout() def save_dock_layout(self): """ Save the current layout of the docks and the plot settings. When running the GUI you can access this function by right-clicking in the widget area to bring up the context menu and selecting "Save Dock Layout" """ layout = { 'docks': self.dock_area.saveState(), 'plots': [i.plot_frame.plot_widget.saveState() for i in self.plot_frames] } with open(self.dock_layout_filename, 'w') as f: f.write(json.dumps(layout)) log.info('Saved dock layout to file %s' % self.dock_layout_filename) def save_dock_action(self): save_dock_action = QtWidgets.QWidgetAction(self) save_dock_action.setText("Save Dock Layout") save_dock_action.triggered.connect(self.save_dock_layout) return save_dock_action def contextMenuEvent(self, event): position = event.pos() # Create menu outside pyqtgraph.PlotWidget position if isinstance(self.childAt(position), (PlotWidget, DockLabel, QtWidgets.QLabel, PlotFrame)): menu = QtWidgets.QMenu(self) menu.addAction(self.save_dock_action()) menu.exec(self.mapToGlobal(position)) def _setup_ui(self): for i in range(self.num_plots): # Set the default label for current dock from x_axis_labels and y_axis_labels # However, if list is shorter than num_plots, repeat last item in the list. x_label = self.x_axis_labels[min(i, len(self.x_axis_labels) - 1)] y_label = self.y_axis_labels[min(i, len(self.y_axis_labels) - 1)] dock = Dock("Dock " + str(i + 1), closable=False, size=(200, 50)) self.dock_area.addDock(dock) self.plot_frames.append( PlotWidget("Results Graph", self.procedure_class.DATA_COLUMNS, x_label, y_label, linewidth=self.linewidth)) self.plot_frames[i].plot_frame.plot_widget.scene().contextMenu.append( self.save_dock_action()) dock.addWidget(self.plot_frames[i]) self.docks.append(dock) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) vbox.addWidget(self.dock_area) self.setLayout(vbox) # Load dock layout file if it exists in the directory of the current procedure if path.exists(self.dock_layout_filename): with open(self.dock_layout_filename, 'r') as f: dock_layout = f.read() layout = json.loads(dock_layout) docks = layout['docks'] plots = layout['plots'] # Make sure number of plots in the file matches num_plots if len(plots) == self.num_plots: self.dock_area.restoreState(docks) for idx, i in enumerate(self.plot_frames): i.plot_frame.plot_widget.restoreState(plots[idx]) log.info('Loaded dock layout from file %s' % self.dock_layout_filename) else: log.warning( 'Number of displayed docks does not match number of docks in layout file %s' % self.dock_layout_filename) def new_curve(self, results, color=pg.intColor(0), **kwargs): if 'pen' not in kwargs: kwargs['pen'] = pg.mkPen(color=color, width=self.linewidth) if 'antialias' not in kwargs: kwargs['antialias'] = False curves = [] for i in range(self.num_plots): curves.append(self.plot_frames[i].new_curve(results, color=color, **kwargs)) return curves def clear(self): for i in range(self.num_plots): self.plot_frames[i].plot.clear() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/estimator_widget.py0000644000175100017510000002141415203313266024332 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from inspect import signature from datetime import datetime, timedelta from ..thread import StoppableQThread from ..Qt import QtCore, QtWidgets from .sequencer_widget import SequenceEvaluationError log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class EstimatorThread(StoppableQThread): new_estimates = QtCore.Signal(list) def __init__(self, get_estimates_callable): StoppableQThread.__init__(self) self._get_estimates = get_estimates_callable self.delay = 2 def __del__(self): self.wait() def run(self): self._should_stop.clear() while not self._should_stop.wait(self.delay): estimates = self._get_estimates() self.new_estimates.emit(estimates) class EstimatorWidget(QtWidgets.QWidget): """ Widget that allows to display up-front estimates of the measurement procedure. This widget relies on a `get_estimates` method of the :class:`Procedure` class. `get_estimates` is expected to return a list of tuples, where each tuple contains two strings: a label and the estimate. If the :class:`SequencerWidget` is also used, it is possible to ask for the current sequencer or its length by asking for two keyword arguments in the Implementation of the `get_estimates` function: `sequence` and `sequence_length`, respectively. """ provide_sequence = False provide_sequence_length = False number_of_estimates = 0 sequencer = None def __init__(self, parent=None): super().__init__(parent) self._parent = parent self.check_get_estimates_signature() self.update_thread = EstimatorThread(self.get_estimates) self.update_thread.new_estimates.connect(self.display_estimates) self._setup_ui() self._layout() self.update_estimates() self.update_box.setCheckState(QtCore.Qt.CheckState.PartiallyChecked) def check_get_estimates_signature(self): """ Method that checks the signature of the get_estimates function. It checks which input arguments are allowed and, if the output is correct for the EstimatorWidget, stores the number of estimates. """ # Check function arguments proc = self._parent.make_procedure() call_signature = signature(proc.get_estimates) if "sequence" in call_signature.parameters: self.provide_sequence = True if "sequence_length" in call_signature.parameters: self.provide_sequence_length = True estimates = self.get_estimates() # Check if the output of the function is acceptable raise_error = True if isinstance(estimates, (list, tuple)): if all([isinstance(est, (tuple, list)) for est in estimates]): if all([len(est) == 2 for est in estimates]): raise_error = False if raise_error: raise TypeError( "If implemented, the get_estimates function is expected to" "return an int or float representing the estimated duration," "or a list of tuples of strings, where each tuple represents" "an estimate containing two string: the first is a label for" "the estimate, the second is the estimate itself." ) # Store the number of estimates self.number_of_estimates = len(estimates) def _setup_ui(self): self.line_edits = list() for idx in range(self.number_of_estimates): qlb = QtWidgets.QLabel(self) qle = QtWidgets.QLineEdit(self) qle.setEnabled(False) qle.setAlignment(QtCore.Qt.AlignmentFlag.AlignRight) self.line_edits.append((qlb, qle)) # Add a checkbox for continuous updating self.update_box = QtWidgets.QCheckBox(self) self.update_box.setTristate(True) self.update_box.stateChanged.connect(self._set_continuous_updating) # Add a button for instant updating self.update_button = QtWidgets.QPushButton("Update", self) self.update_button.clicked.connect(self.update_estimates) def _layout(self): f_layout = QtWidgets.QFormLayout(self) for row in self.line_edits: f_layout.addRow(*row) update_hbox = QtWidgets.QHBoxLayout() update_hbox.addWidget(self.update_box) update_hbox.addWidget(self.update_button) f_layout.addRow("Update continuously", update_hbox) def get_estimates(self): """ Method that makes a procedure with the currently entered parameters and returns the estimates for these parameters. """ # Make a procedure procedure = self._parent.make_procedure() kwargs = dict() sequence = None sequence_length = None if hasattr(self._parent, "sequencer"): try: sequence = self._parent.sequencer.get_sequence() except SequenceEvaluationError: sequence_length = 0 else: sequence_length = len(sequence) if self.provide_sequence: kwargs["sequence"] = sequence if self.provide_sequence_length: kwargs["sequence_length"] = sequence_length estimates = procedure.get_estimates(**kwargs) if isinstance(estimates, (int, float)): estimates = self._estimates_from_duration(estimates, sequence_length) return estimates def update_estimates(self): """ Method that gets and displays the estimates. Implemented for connecting to the 'update'-button. """ estimates = self.get_estimates() self.display_estimates(estimates) def display_estimates(self, estimates): """ Method that updates the shown estimates for the given set of estimates. :param estimates: The set of estimates to be shown in the form of a list of tuples of (2) strings """ if len(estimates) != self.number_of_estimates: raise ValueError( "Number of estimates changed after initialisation " "(from %d to %d)." % (self.number_of_estimates, len(estimates)) ) for idx, estimate in enumerate(estimates): self.line_edits[idx][0].setText(estimate[0]) self.line_edits[idx][1].setText(estimate[1]) def _estimates_from_duration(self, duration, sequence_length): estimates = list() estimates.append(("Duration", "%d s" % int(duration))) if hasattr(self._parent, "sequencer"): estimates.append(("Sequence length", str(sequence_length))) estimates.append(("Sequence duration", "%d s" % int(sequence_length * duration))) estimates.append(('Measurement finished at', str(datetime.now() + timedelta( seconds=duration))[:-7])) if hasattr(self._parent, "sequencer"): estimates.append(('Sequence finished at', str(datetime.now() + timedelta( seconds=duration * sequence_length))[:-7])) return estimates def _set_continuous_updating(self): state = self.update_box.checkState() self.update_thread.stop() self.update_thread.join() if state == QtCore.Qt.CheckState.Unchecked: pass elif state == QtCore.Qt.CheckState.PartiallyChecked: self.update_thread.delay = 2 self.update_thread.start() elif state == QtCore.Qt.CheckState.Checked: self.update_thread.delay = 0.1 self.update_thread.start() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/fileinput_widget.py0000644000175100017510000001400215203313266024315 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..Qt import QtCore, QtWidgets from .filename_widget import FilenameLineEdit from .directory_widget import DirectoryLineEdit log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class FileInputWidget(QtWidgets.QWidget): """ Widget for controlling where the data of an experiment will be stored. The widget consists of a field for the filename (:class:`~pymeasure.display.widgets.filename_widget.FilenameLineEdit`), a field for the directory (:class:`~pymeasure.display.widgets.directory_widget.DirectoryLineEdit`), and a checkbox to control whether the measurement is stored. """ _extensions = ["csv", "txt"] _filename_fixed = False def __init__(self, parent=None): super().__init__(parent) self._setup_ui() self._layout() def _setup_ui(self): self.writefile_toggle = QtWidgets.QCheckBox('Save data', self) self.writefile_toggle.setLayoutDirection(QtCore.Qt.RightToLeft) self.writefile_toggle.setChecked(True) self.writefile_toggle.stateChanged.connect(self.set_input_fields_enabled) self.writefile_toggle.setToolTip( "Control whether the measurement is saved to a file with the filename that is\n" "specified in the field below (checked) or not (unchecked; the data is stored\n" "in a temporary file)." ) self.filename_input = FilenameLineEdit(self.parent().procedure_class, parent=self) self.directory_input = DirectoryLineEdit(parent=self) def _layout(self): vbox = QtWidgets.QVBoxLayout() vbox.setContentsMargins(0, 0, 0, 0) filename_label = QtWidgets.QLabel(self) filename_label.setText('Filename') filename_label.setToolTip(self.filename_input.toolTip()) filename_box = QtWidgets.QHBoxLayout() filename_box.addWidget(filename_label) filename_box.addWidget(self.writefile_toggle) vbox.addLayout(filename_box) vbox.addWidget(self.filename_input) directory_label = QtWidgets.QLabel(self) directory_label.setText('Directory') vbox.addWidget(directory_label) vbox.addWidget(self.directory_input) self.setLayout(vbox) @property def directory(self): """String controlling the directory where the file will be stored.""" return self.directory_input.text() @directory.setter def directory(self, value): self.directory_input.setText(str(value)) @property def filename(self): """String controlling the filename that is shown in the filename input field.""" return self.filename_input.text() @filename.setter def filename(self, value): self.filename_input.setText(str(value)) @property def filename_base(self): """String containing the base of the filename with which the file will be stored. Can only be read. """ filename_split = self.filename.rsplit('.', 1) if len(filename_split) > 1 and filename_split[1] in self.extensions: return filename_split[0] else: return self.filename @property def filename_extension(self): """String containing the file extension with which the file will be stored. Can only be read. """ filename_split = self.filename.rsplit('.', 1) if len(filename_split) > 1 and filename_split[1] in self.extensions: return filename_split[1] else: return self.extensions[0] @property def extensions(self): """List of extensions that are recognized by the widget. The first value of this list will be used as default value in case no extension is provided in the filename input field. """ return self._extensions @extensions.setter def extensions(self, value): self._extensions = [ext.lstrip('.') for ext in value] self.filename_input.set_tool_tip() @property def store_measurement(self): """Boolean controlling whether the measurement will be stored.""" return self.writefile_toggle.isChecked() @store_measurement.setter def store_measurement(self, value): self.writefile_toggle.setChecked(bool(value)) @property def filename_fixed(self): """Boolean controlling whether the filename input field is frozen. If `True`, the filename field will be visible but disabled (i.e., grayed out).""" return self._filename_fixed @filename_fixed.setter def filename_fixed(self, value): self._filename_fixed = value # Reassess if the input fields should be enabled or disabled self.set_input_fields_enabled(self.store_measurement) def set_input_fields_enabled(self, state): self.filename_input.setEnabled(bool(state) and not self.filename_fixed) self.directory_input.setEnabled(bool(state)) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/filename_widget.py0000644000175100017510000001444215203313266024106 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import re import textwrap from ..Qt import QtCore, QtWidgets, QtGui log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class FilenameLineEdit(QtWidgets.QLineEdit): """ Widget that allows to choose a filename. A completer is implemented for quick completion of placeholders """ def __init__(self, procedure_class, parent=None): super().__init__("DATA", parent=parent) self.placeholders = procedure_class.placeholder_names() self.placeholders.extend(["date", "time"]) completer = PlaceholderCompleter(self.placeholders) self.setCompleter(completer) validator = FilenameValidator(self.placeholders, self) self.setValidator(validator) self.set_tool_tip() def set_tool_tip(self): ext = self.parent().extensions[0] extensions = ("'." + "', '.".join(self.parent().extensions[:-1]) + f"', or '.{self.parent().extensions[-1]}'") placeholders = "'" + "';\n- '".join(self.placeholders) + "'" self.setToolTip("\n".join(textwrap.wrap( "The filename of the file to which the measurement will be stored. Placeholders (in " "standard python format, i.e.: '{variable name:formatspec}') will be replaced by " f"the respective value. The extension '.{ext}' will be appended, unless an extension " f"(one of {extensions}) is recognized. Additionally, an index number ('_#') is " "added to ensure the uniqueness of the filename.", width=100)) + f"\nValid placeholders are:\n- {placeholders}." ) class PlaceholderCompleter(QtWidgets.QCompleter): def __init__(self, placeholders): super().__init__() self.placeholders = placeholders self.setCompletionMode(QtWidgets.QCompleter.CompletionMode.PopupCompletion) self.setModelSorting(QtWidgets.QCompleter.ModelSorting.CaseInsensitivelySortedModel) self.setCaseSensitivity(QtCore.Qt.CaseInsensitive) self.setFilterMode(QtCore.Qt.MatchContains) def splitPath(self, path): if path.endswith("{"): options = [path + placeholder + "}" for placeholder in self.placeholders] model = QtCore.QStringListModel(options) self.setModel(model) elif path.count("{") == path.count("}"): # Clear the autocomplete options self.setModel(QtCore.QStringListModel()) return [path] class FilenameValidator(QtGui.QValidator): def __init__(self, placeholders, parent): self.parent = parent self.placeholders = placeholders self.full_placeholder = re.compile(r"{([^{}:]*)(:[^{}]*)?}") self.half_placeholder = re.compile(r"{([^{}:]*)(:[^{}]*)?$") self.valid_filename = re.compile(r"^[^<>:\"/\\|?*{}]*$") super().__init__() def fixup(self, input): half_placeholder = self.half_placeholder.findall(input) if half_placeholder: input = input + "}" return input def validate(self, input, pos): test_input = input full_placeholders = self.full_placeholder.findall(input) half_placeholder = self.half_placeholder.findall(input) test_input = self.full_placeholder.sub("_plchldr_", test_input) test_input = self.half_placeholder.sub("_plchldr", test_input) valid_filename = self.valid_filename.fullmatch(test_input) # Determine state of input if not valid_filename: state = QtGui.QValidator.Invalid elif half_placeholder: state = QtGui.QValidator.Intermediate else: state = QtGui.QValidator.Acceptable # Control the warning for the invalid placeholders incorrect_placeholders = [p for p in full_placeholders if p[0] not in self.placeholders] if incorrect_placeholders: if not self.parent.actions(): pixmapi = QtWidgets.QStyle.StandardPixmap.SP_MessageBoxCritical icon = self.parent.style().standardIcon(pixmapi) self.parent.addAction(icon, self.parent.ActionPosition.TrailingPosition) # Add tooltip to show which placeholders are not valid act = self.parent.actions()[0] marked_input = input for placeholder in [f"{{{p[0] + p[1]}}}" for p in incorrect_placeholders]: marked_input = marked_input.replace( placeholder, f"{placeholder}" ) act.setToolTip( "

" "The input filename contains placeholders with
invalid variable names:
" " - '" + "',
- '".join([p[0] for p in incorrect_placeholders]) + "'." "

Received input:
" + marked_input + "

" ) else: # Remove action, if it exists if self.parent.actions(): assert len(self.parent.actions()) == 1, ( "More than 1 action defined, not sure " "which to remove." ) self.parent.removeAction(self.parent.actions()[0]) return state, input, pos ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/image_frame.py0000644000175100017510000000430115203313266023210 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..curves import ResultsImage from ..Qt import QtCore from .plot_frame import PlotFrame log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ImageFrame(PlotFrame): """ Extends :class:`PlotFrame` to plot also axis Z using colors """ ResultsClass = ResultsImage z_axis_changed = QtCore.Signal(str) def __init__(self, x_axis, y_axis, z_axis=None, refresh_time=0.2, check_status=True, parent=None): super().__init__(x_axis, y_axis, refresh_time, check_status, parent) self.change_z_axis(z_axis) def change_z_axis(self, axis): for item in self.plot.items: if isinstance(item, self.ResultsClass): item.z = axis item.update_data() label, units = self.parse_axis(axis) if units is not None: self.plot.setTitle(label + ' (%s)' % units) else: self.plot.setTitle(label) self.z_axis = axis self.z_axis_changed.emit(axis) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/image_widget.py0000644000175100017510000001002615203313266023402 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import pyqtgraph as pg from ..curves import ResultsImage from ..Qt import QtCore, QtWidgets from .tab_widget import TabWidget from .image_frame import ImageFrame log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ImageWidget(TabWidget, QtWidgets.QWidget): """ Extends the :class:`ImageFrame` to allow different columns of the data to be dynamically chosen """ def __init__(self, name, columns, x_axis, y_axis, z_axis=None, refresh_time=0.2, check_status=True, parent=None): super().__init__(name, parent) self.columns = columns self.refresh_time = refresh_time self.check_status = check_status self.x_axis = x_axis self.y_axis = y_axis self._setup_ui() self._layout() if z_axis is not None: self.columns_z.setCurrentIndex(self.columns_z.findText(z_axis)) self.image_frame.change_z_axis(z_axis) def _setup_ui(self): self.columns_z_label = QtWidgets.QLabel(self) self.columns_z_label.setMaximumSize(QtCore.QSize(45, 16777215)) self.columns_z_label.setText('Z Axis:') self.columns_z = QtWidgets.QComboBox(self) for column in self.columns: self.columns_z.addItem(column) self.columns_z.activated.connect(self.update_z_column) self.image_frame = ImageFrame( self.x_axis, self.y_axis, self.columns[0], self.refresh_time, self.check_status ) self.updated = self.image_frame.updated self.plot = self.image_frame.plot self.columns_z.setCurrentIndex(2) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) hbox = QtWidgets.QHBoxLayout() hbox.setSpacing(10) hbox.setContentsMargins(-1, 6, -1, 6) hbox.addWidget(self.columns_z_label) hbox.addWidget(self.columns_z) vbox.addLayout(hbox) vbox.addWidget(self.image_frame) self.setLayout(vbox) def sizeHint(self): return QtCore.QSize(300, 600) def new_curve(self, results, color=pg.intColor(0), **kwargs): """ Creates a new image """ image = ResultsImage(results, wdg=self, x=self.image_frame.x_axis, y=self.image_frame.y_axis, z=self.image_frame.z_axis, **kwargs ) return image def update_z_column(self, index): axis = self.columns_z.itemText(index) self.image_frame.change_z_axis(axis) def load(self, curve): curve.z = self.columns_z.currentText() curve.update_data() self.plot.addItem(curve) def remove(self, curve): self.plot.removeItem(curve) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/inputs_widget.py0000644000175100017510000001654115203313266023652 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from functools import partial from ..inputs import (BooleanInput, IntegerInput, ListInput, ScientificInput, StringInput, VectorInput) from ..Qt import QtWidgets, QtCore from ...experiment import parameters log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class InputsWidget(QtWidgets.QWidget): """ Widget wrapper for various :doc:`inputs` """ # tuple of Input classes that do not need an external label NO_LABEL_INPUTS = (BooleanInput,) def __init__(self, procedure_class, inputs=(), parent=None, hide_groups=True, inputs_in_scrollarea=False): super().__init__(parent) self._procedure_class = procedure_class self._procedure = procedure_class() self._inputs = inputs self._setup_ui() self._layout(inputs_in_scrollarea) self._hide_groups = hide_groups self._setup_visibility_groups() def _setup_ui(self): parameter_objects = self._procedure.parameter_objects() for name in self._inputs: parameter = parameter_objects[name] if parameter.ui_class is not None: element = parameter.ui_class(parameter) elif isinstance(parameter, parameters.FloatParameter): element = ScientificInput(parameter) elif isinstance(parameter, parameters.IntegerParameter): element = IntegerInput(parameter) elif isinstance(parameter, parameters.BooleanParameter): element = BooleanInput(parameter) elif isinstance(parameter, parameters.ListParameter): element = ListInput(parameter) elif isinstance(parameter, parameters.VectorParameter): element = VectorInput(parameter) elif isinstance(parameter, parameters.Parameter): element = StringInput(parameter) setattr(self, name, element) def _layout(self, inputs_in_scrollarea): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(6) vbox.setContentsMargins(0, 0, 0, 0) self.labels = {} parameters = self._procedure.parameter_objects() for name in self._inputs: if not isinstance(getattr(self, name), self.NO_LABEL_INPUTS): label = QtWidgets.QLabel(self) label.setText("%s:" % parameters[name].name) vbox.addWidget(label) self.labels[name] = label vbox.addWidget(getattr(self, name)) if inputs_in_scrollarea: scroll_area = QtWidgets.QScrollArea() scroll_area.setWidgetResizable(True) scroll_area.setFrameStyle(QtWidgets.QScrollArea.Shape.NoFrame) scroll_area.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarPolicy.ScrollBarAlwaysOff) inputs = QtWidgets.QWidget(self) inputs.setLayout(vbox) inputs.setSizePolicy(QtWidgets.QSizePolicy.Policy.Minimum, QtWidgets.QSizePolicy.Policy.Fixed) scroll_area.setWidget(inputs) vbox = QtWidgets.QVBoxLayout(self) vbox.setContentsMargins(0, 0, 0, 0) vbox.addWidget(scroll_area, 1) self.setLayout(vbox) def _setup_visibility_groups(self): groups = {} parameters = self._procedure.parameter_objects() for name in self._inputs: parameter = parameters[name] group_state = {g: True for g in parameter.group_by} for group_name, condition in parameter.group_by.items(): if group_name not in self._inputs or group_name == name: continue if isinstance(getattr(self, group_name), BooleanInput): # Adjust the boolean condition to a condition suitable for a checkbox condition = bool(condition) if group_name not in groups: groups[group_name] = [] groups[group_name].append((name, condition, group_state)) for group_name, group in groups.items(): toggle = partial(self.toggle_group, group_name=group_name, group=group) group_el = getattr(self, group_name) if isinstance(group_el, BooleanInput): group_el.toggled.connect(toggle) toggle(group_el.isChecked()) elif isinstance(group_el, (StringInput, VectorInput)): group_el.textChanged.connect(toggle) toggle(group_el.text()) elif isinstance(group_el, (IntegerInput, ScientificInput)): group_el.valueChanged.connect(toggle) toggle(group_el.value()) elif isinstance(group_el, ListInput): group_el.currentTextChanged.connect(toggle) toggle(group_el.currentText()) else: raise NotImplementedError( f"Grouping based on {group_name} ({group_el}) is not implemented.") def toggle_group(self, state, group_name, group): for (name, condition, group_state) in group: if callable(condition): group_state[group_name] = condition(state) else: group_state[group_name] = (state == condition) visible = all(group_state.values()) if self._hide_groups: getattr(self, name).setHidden(not visible) else: getattr(self, name).setDisabled(not visible) if name in self.labels: if self._hide_groups: self.labels[name].setHidden(not visible) else: self.labels[name].setDisabled(not visible) def set_parameters(self, parameter_objects): for name in self._inputs: element = getattr(self, name) element.set_parameter(parameter_objects[name]) def get_procedure(self): """ Returns the current procedure """ self._procedure = self._procedure_class() parameter_values = {} for name in self._inputs: element = getattr(self, name) parameter_values[name] = element.parameter.value self._procedure.set_parameters(parameter_values) return self._procedure ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/log_widget.py0000644000175100017510000001275315203313266023112 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..log import LogHandler from ..Qt import QtWidgets, QtCore, QtGui from .tab_widget import TabWidget log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class HTMLFormatter(logging.Formatter): level_colors = { "DEBUG": "DarkGray", # "INFO": "Black", "WARNING": "DarkOrange", "ERROR": "Red", "CRITICAL": "DarkRed", } html_replacements = { "\r\n": "
", "\n": "
", "\r": "
", " ": " " * 2, "\t": " " * 4, } def format(self, record): formatted = super().format(record) # Apply color if a level-color is defined if record.levelname in self.level_colors: formatted = f"{formatted}" # ensure newlines and indents are preserved for replacement in self.html_replacements.items(): formatted = formatted.replace(*replacement) # Prepend the level as HTML comment formatted = f"{formatted}" return formatted class LogWidget(TabWidget, QtWidgets.QWidget): """ Widget to display logging information in GUI It is recommended to include this widget in all subclasses of :class:`ManagedWindowBase` """ fmt = '%(asctime)s : %(message)s (%(levelname)s)' datefmt = '%m/%d/%Y %I:%M:%S %p' tab_widget = None tab_index = None _blink_qtimer = QtCore.QTimer() _blink_color = None _blink_state = False def __init__(self, name, parent=None, fmt=None, datefmt=None): if fmt is not None: self.fmt = fmt if datefmt is not None: self.datefmt = datefmt super().__init__(name, parent) self._setup_ui() self._layout() # Setup blinking self._blink_qtimer.timeout.connect(self._blink) self.handler.connect(self._blinking_start) def _setup_ui(self): self.view = QtWidgets.QPlainTextEdit() self.view.setReadOnly(True) self.handler = LogHandler() self.handler.setFormatter(HTMLFormatter( fmt=self.fmt, datefmt=self.datefmt, )) self.handler.connect(self.view.appendHtml) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) vbox.addWidget(self.view) self.setLayout(vbox) def _blink(self): self.tab_widget.tabBar().setTabTextColor( self.tab_index, QtGui.QColor("black" if self._blink_state else self._blink_color) ) self._blink_state = not self._blink_state def _blinking_stop(self, index): if index == self.tab_index: self._blink_qtimer.stop() self._blink_state = True self._blink() self._blink_color = None self.tab_widget.setTabIcon(self.tab_index, QtGui.QIcon()) def _blinking_start(self, message): # Delayed setup, since only now the widget is added to the TabWidget if self.tab_widget is None: self.tab_widget = self.parent().parent() self.tab_index = self.tab_widget.indexOf(self) self.tab_widget.tabBar().setIconSize(QtCore.QSize(12, 12)) self.tab_widget.tabBar().currentChanged.connect(self._blinking_stop) if message.startswith("") or message.startswith(""): error = True elif message.startswith(""): error = False else: # no blinking return # Check if the current tab is actually the log-tab if self.tab_widget.currentIndex() == self.tab_index: self._blinking_stop(self.tab_widget.currentIndex()) return # Define color and icon based on severity # If already red, this should not be updated if not self._blink_color == "red": self._blink_color = "red" if error else "darkorange" pixmapi = QtWidgets.QStyle.StandardPixmap.SP_MessageBoxCritical if \ error else QtWidgets.QStyle.StandardPixmap.SP_MessageBoxWarning icon = self.style().standardIcon(pixmapi) self.tab_widget.setTabIcon(self.tab_index, icon) # Start timer self._blink_qtimer.start(500) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/plot_frame.py0000644000175100017510000001215515203313266023112 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import re import pyqtgraph as pg from ..curves import ResultsCurve, Crosshairs from ..Qt import QtCore, QtWidgets from ...experiment import Procedure log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class PlotFrame(QtWidgets.QFrame): """ Combines a PyQtGraph Plot with Crosshairs. Refreshes the plot based on the refresh_time, and allows the axes to be changed on the fly, which updates the plotted data """ LABEL_STYLE = {'font-size': '10pt', 'font-family': 'Arial', 'color': '#000000'} updated = QtCore.Signal() ResultsClass = ResultsCurve x_axis_changed = QtCore.Signal(str) y_axis_changed = QtCore.Signal(str) def __init__(self, x_axis=None, y_axis=None, refresh_time=0.2, check_status=True, parent=None): super().__init__(parent) self.refresh_time = refresh_time self.check_status = check_status self._setup_ui() self.change_x_axis(x_axis) self.change_y_axis(y_axis) def _setup_ui(self): self.setAutoFillBackground(False) self.setStyleSheet("background: #fff") self.setFrameShape(QtWidgets.QFrame.Shape.StyledPanel) self.setFrameShadow(QtWidgets.QFrame.Shadow.Sunken) self.setMidLineWidth(1) vbox = QtWidgets.QVBoxLayout(self) self.plot_widget = pg.PlotWidget(self, background='#ffffff') vbox.addWidget(self.plot_widget) self.setLayout(vbox) self.plot = self.plot_widget.getPlotItem() style = dict(self.LABEL_STYLE, justify='right') if "font-size" in style: # LabelItem wants the size as 'size' rather than 'font-size' style["size"] = style.pop("font-size") self.coordinates = pg.LabelItem("", parent=self.plot, **style) self.coordinates.anchor(itemPos=(1, 1), parentPos=(1, 1), offset=(0, 3)) self.crosshairs = Crosshairs(self.plot, pen=pg.mkPen(color='#AAAAAA', style=QtCore.Qt.PenStyle.DashLine)) self.crosshairs.coordinates.connect(self.update_coordinates) self.timer = QtCore.QTimer(self) self.timer.timeout.connect(self.update_curves) self.timer.timeout.connect(self.crosshairs.update) self.timer.timeout.connect(self.updated) self.timer.start(int(self.refresh_time * 1e3)) def update_coordinates(self, x, y): self.coordinates.setText(f"({x:g}, {y:g})") def update_curves(self): for item in self.plot.items: if isinstance(item, self.ResultsClass): if self.check_status: if item.results.procedure.status == Procedure.RUNNING: item.update_data() else: item.update_data() def parse_axis(self, axis): """ Returns the units of an axis by searching the string """ units_pattern = r"\((?P\w+)\)" try: match = re.search(units_pattern, axis) except TypeError: match = None if match: if 'units' in match.groupdict(): label = re.sub(units_pattern, '', axis) return label, match.groupdict()['units'] else: return axis, None def change_x_axis(self, axis): for item in self.plot.items: if isinstance(item, self.ResultsClass): item.x = axis item.update_data() label, units = self.parse_axis(axis) self.plot.setLabel('bottom', label, units=units, **self.LABEL_STYLE) self.x_axis = axis self.x_axis_changed.emit(axis) def change_y_axis(self, axis): for item in self.plot.items: if isinstance(item, self.ResultsClass): item.y = axis item.update_data() label, units = self.parse_axis(axis) self.plot.setLabel('left', label, units=units, **self.LABEL_STYLE) self.y_axis = axis self.y_axis_changed.emit(axis) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/plot_widget.py0000644000175100017510000001272015203313266023301 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import pyqtgraph as pg from ..curves import ResultsCurve from ..Qt import QtCore, QtWidgets from .tab_widget import TabWidget from .plot_frame import PlotFrame log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class PlotWidget(TabWidget, QtWidgets.QWidget): """ Extends :class:`PlotFrame` to allow different columns of the data to be dynamically chosen """ def __init__(self, name, columns, x_axis=None, y_axis=None, refresh_time=0.2, check_status=True, linewidth=1, parent=None): super().__init__(name, parent) self.columns = columns self.refresh_time = refresh_time self.check_status = check_status self.linewidth = linewidth self._setup_ui() self._layout() if x_axis is not None: self.columns_x.setCurrentIndex(self.columns_x.findText(x_axis)) self.plot_frame.change_x_axis(x_axis) if y_axis is not None: self.columns_y.setCurrentIndex(self.columns_y.findText(y_axis)) self.plot_frame.change_y_axis(y_axis) def _setup_ui(self): self.columns_x_label = QtWidgets.QLabel(self) self.columns_x_label.setMaximumSize(QtCore.QSize(45, 16777215)) self.columns_x_label.setText('X Axis:') self.columns_y_label = QtWidgets.QLabel(self) self.columns_y_label.setMaximumSize(QtCore.QSize(45, 16777215)) self.columns_y_label.setText('Y Axis:') self.columns_x = QtWidgets.QComboBox(self) self.columns_y = QtWidgets.QComboBox(self) for column in self.columns: self.columns_x.addItem(column) self.columns_y.addItem(column) self.columns_x.activated.connect(self.update_x_column) self.columns_y.activated.connect(self.update_y_column) self.plot_frame = PlotFrame( self.columns[0], self.columns[1], self.refresh_time, self.check_status, parent=self, ) self.updated = self.plot_frame.updated self.plot = self.plot_frame.plot self.columns_x.setCurrentIndex(0) self.columns_y.setCurrentIndex(1) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) hbox = QtWidgets.QHBoxLayout() hbox.setSpacing(10) hbox.setContentsMargins(-1, 6, -1, 6) hbox.addWidget(self.columns_x_label) hbox.addWidget(self.columns_x) hbox.addWidget(self.columns_y_label) hbox.addWidget(self.columns_y) vbox.addLayout(hbox) vbox.addWidget(self.plot_frame) self.setLayout(vbox) def sizeHint(self): return QtCore.QSize(300, 600) def new_curve(self, results, color=pg.intColor(0), **kwargs): if 'pen' not in kwargs: kwargs['pen'] = pg.mkPen(color=color, width=self.linewidth) if 'antialias' not in kwargs: kwargs['antialias'] = False curve = ResultsCurve(results, wdg=self, x=self.plot_frame.x_axis, y=self.plot_frame.y_axis, **kwargs, ) curve.setSymbol(None) curve.setSymbolBrush(None) return curve def update_x_column(self, index): axis = self.columns_x.itemText(index) self.plot_frame.change_x_axis(axis) def update_y_column(self, index): axis = self.columns_y.itemText(index) self.plot_frame.change_y_axis(axis) def load(self, curve): curve.x = self.columns_x.currentText() curve.y = self.columns_y.currentText() curve.update_data() self.plot.addItem(curve) def remove(self, curve): self.plot.removeItem(curve) def set_color(self, curve, color): """ Change the color of the pen of the curve """ curve.set_color(color) def preview_widget(self, parent=None): """ Return a widget suitable for preview during loading """ return PlotWidget("Plot preview", self.columns, self.plot_frame.x_axis, self.plot_frame.y_axis, parent=parent, ) def clear_widget(self): self.plot.clear() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/results_dialog.py0000644000175100017510000001177615203313266024012 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import os from ..Qt import QtCore, QtWidgets from ...experiment.results import Results log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ResultsDialog(QtWidgets.QFileDialog): """ Widget that displays a dialog box for loading a past experiment run. It shows a preview of curves from the results file when selected in the dialog box. This widget used by the `open_experiment` method in :class:`ManagedWindowBase` class """ def __init__(self, procedure_class, widget_list=(), parent=None): super().__init__(parent) self.procedure_class = procedure_class self.widget_list = widget_list self.setOption(QtWidgets.QFileDialog.Option.DontUseNativeDialog, True) self._setup_ui() def _setup_ui(self): preview_tab = QtWidgets.QTabWidget() param_vbox = QtWidgets.QVBoxLayout() metadata_vbox = QtWidgets.QVBoxLayout() param_vbox_widget = QtWidgets.QWidget() metadata_vbox_widget = QtWidgets.QWidget() self.preview_widget_list = [] # Add preview tabs as appropriate for widget in self.widget_list: preview_widget = widget.preview_widget(parent=self) if preview_widget: self.preview_widget_list.append(preview_widget) vbox = QtWidgets.QVBoxLayout() vbox_widget = QtWidgets.QWidget() vbox.addWidget(preview_widget) vbox_widget.setLayout(vbox) preview_tab.addTab(vbox_widget, preview_widget.name) self.preview_param = QtWidgets.QTreeWidget() param_header = QtWidgets.QTreeWidgetItem(["Name", "Value"]) self.preview_param.setHeaderItem(param_header) self.preview_param.setColumnWidth(0, 150) self.preview_param.setAlternatingRowColors(True) self.preview_metadata = QtWidgets.QTreeWidget() param_header = QtWidgets.QTreeWidgetItem(["Name", "Value"]) self.preview_metadata.setHeaderItem(param_header) self.preview_metadata.setColumnWidth(0, 150) self.preview_metadata.setAlternatingRowColors(True) param_vbox.addWidget(self.preview_param) metadata_vbox.addWidget(self.preview_metadata) param_vbox_widget.setLayout(param_vbox) metadata_vbox_widget.setLayout(metadata_vbox) preview_tab.addTab(param_vbox_widget, "Run Parameters") preview_tab.addTab(metadata_vbox_widget, "Metadata") self.layout().addWidget(preview_tab, 0, 5, 4, 1) self.layout().setColumnStretch(5, 1) self.setMinimumSize(900, 500) self.resize(900, 500) self.setFileMode(QtWidgets.QFileDialog.FileMode.ExistingFiles) self.currentChanged.connect(self.update_preview) def update_preview(self, filename): # Add preview tabs as appropriate if not os.path.isdir(filename) and filename != '': try: results = Results.load(str(filename)) except ValueError: return for widget in self.preview_widget_list: widget.clear_widget() widget.load(widget.new_curve(results)) self.preview_param.clear() for key, param in results.procedure.parameter_objects().items(): new_item = QtWidgets.QTreeWidgetItem([param.name, str(param)]) self.preview_param.addTopLevelItem(new_item) self.preview_param.sortItems(0, QtCore.Qt.SortOrder.AscendingOrder) self.preview_metadata.clear() for key, metadata in results.procedure.metadata_objects().items(): new_item = QtWidgets.QTreeWidgetItem([metadata.name, str(metadata)]) self.preview_metadata.addTopLevelItem(new_item) self.preview_metadata.sortItems(0, QtCore.Qt.SortOrder.AscendingOrder) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/sequencer_widget.py0000644000175100017510000005230115203313266024314 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import os from functools import partial from inspect import signature from collections import ChainMap from ..Qt import QtCore, QtWidgets, QtGui from ...experiment.sequencer import SequenceHandler, SequenceEvaluationError log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class SequencerTreeModel(QtCore.QAbstractItemModel): """ Model for sequencer data :param header: List of string representing header data :param data: data associated with the model :param parent: A QWidget that QT will give ownership of this Widget to. """ def __init__(self, data, header=("Level", "Parameter", "Sequence"), parent=None): super().__init__(parent) self.header = header self.root = data def add_node(self, parameter, parent=None): """ Add a row in the sequencer """ if parent is None: parent = self.createIndex(-1, -1) idx = len(self.root.children(parent)) parent_seq_item = parent.internalPointer() self.beginInsertRows(parent, idx, idx) seq_item, child_row = self.root.add_node(parameter, parent_seq_item) self.endInsertRows() return self.createIndex(child_row, 0, seq_item) def remove_node(self, index): """ Remove a row in the sequencer """ children = self.rowCount(index) seq_item = index.internalPointer() # Remove children from last to first while (children > 0): child = children - 1 children_seq_item = self.root.get_children(seq_item, child) self.remove_node(self.createIndex(child, 0, children_seq_item)) children = self.rowCount(index) self.beginRemoveRows(index.parent(), index.row(), index.row()) parent_seq_item, parent_row = self.root.remove_node(seq_item) self.endRemoveRows() return self.createIndex(parent_row, 0, parent_seq_item) def flags(self, index): """ Set the flags for the item at the given QModelIndex. Here, we just set all indexes to enabled, and selectable. """ if not index.isValid(): return_value = QtCore.Qt.ItemFlag.NoItemFlags else: return_value = QtCore.Qt.ItemFlag.ItemIsEnabled | \ QtCore.Qt.ItemFlag.ItemIsSelectable if index.column() >= 1: return_value |= QtCore.Qt.ItemFlag.ItemIsEditable return return_value def data(self, index, role): """ Return the data to display for the given index and the given role. This method should not be called directly. This method is called implicitly by the QTreeView that is displaying us, as the way of finding out what to display where. """ if not index.isValid(): return elif not role == QtCore.Qt.ItemDataRole.DisplayRole: return data = index.internalPointer()[index.column()] if not isinstance(data, QtCore.QObject): data = str(data) return data def index(self, row, col, parent): """ Return a QModelIndex instance pointing the row and column underneath the parent given. This method should not be called directly. This method is called implicitly by the QTreeView that is displaying us, as the way of finding out what to display where. """ if not parent or not parent.isValid(): parent_data = None else: parent_data = parent.internalPointer() seq_item = self.root.get_children(parent_data, row) child = seq_item if child is None: return QtCore.QModelIndex() index = self.createIndex(row, col, child) return index def parent(self, index=None): """ Return the index of the parent of a given index. If index is not supplied, return an invalid QModelIndex. :param index: QModelIndex optional. :return: """ if not index or not index.isValid(): return QtCore.QModelIndex() child = index.internalPointer() parent, parent_row = self.root.get_parent(child) if parent is None: return QtCore.QModelIndex() index = self.createIndex(parent_row, 0, parent) return index def rowCount(self, parent): """ Return the number of children of a given parent. If an invalid QModelIndex is supplied, return the number of children under the root. :param parent: QModelIndex """ if parent.column() > 0: return 0 if not parent.isValid(): parent = None else: parent = parent.internalPointer() rows = len(self.root.children(parent)) return rows def columnCount(self, parent): """ Return the number of columns in the model header. The parent parameter exists only to support the signature of QAbstractItemModel. """ return len(self.header) def headerData(self, section, orientation, role): """ Return the header data for the given section, orientation and role. This method should not be called directly. This method is called implicitly by the QTreeView that is displaying us, as the way of finding out what to display where. """ if orientation == QtCore.Qt.Orientation.Horizontal and \ role == QtCore.Qt.ItemDataRole.DisplayRole: return self.header[section] def setData(self, index, value, role=QtCore.Qt.ItemDataRole.EditRole): return_value = False if role == QtCore.Qt.ItemDataRole.EditRole: return_value = self.root.set_data(index.internalPointer(), index.row(), index.column(), value) if return_value: self.dataChanged.emit(index, index, [role]) return return_value def visit_tree(self, parent): """ Return a generator to enumerate all the nodes in the tree """ parent_data = None if parent: parent_data = parent.internalPointer() for row, child in enumerate(self.root.children(parent_data)): node = self.index(row, 0, parent) if node.isValid(): yield node yield from self.visit_tree(node) def __iter__(self): yield from self.visit_tree(None) def save(self, file_obj): self.root.save(file_obj) def load(self, file_obj, append=False): # Since we are loading new data, following Qt documentation, # we call beginResetModel to inform that any previous data reported # from the model is now invalid and has to be queried for again. # This also means that the current item and any selected items will become invalid. self.beginResetModel() try: self.root.load(file_obj, append=append) except SequenceEvaluationError as e: log.error(f"Error during sequence loading: {e}") # Complete model reset operation self.endResetModel() class ComboBoxDelegate(QtWidgets.QStyledItemDelegate): def __init__(self, owner, choices): super().__init__(owner) self.items = choices def createEditor(self, parent, option, index): editor = QtWidgets.QComboBox(parent) editor.addItems(self.items) return editor def setEditorData(self, editor, index): value = index.data(QtCore.Qt.ItemDataRole.DisplayRole) num = self.items.index(value) editor.setCurrentIndex(num) def setModelData(self, editor, model, index): value = editor.currentText() model.setData(index, value, QtCore.Qt.ItemDataRole.EditRole) def updateEditorGeometry(self, editor, option, index): editor.setGeometry(option.rect) class ExpressionValidator(QtGui.QValidator): def validate(self, input_string, pos): return_value = QtGui.QValidator.State.Acceptable try: SequenceHandler.eval_string(input_string, log_enabled=False) except SequenceEvaluationError: return_value = QtGui.QValidator.State.Intermediate return (return_value, input_string, pos) class LineEditDelegate(QtWidgets.QStyledItemDelegate): def createEditor(self, parent, option, index): editor = QtWidgets.QLineEdit(parent) editor.setValidator(ExpressionValidator()) return editor def setEditorData(self, editor, index): value = index.data(QtCore.Qt.ItemDataRole.DisplayRole) editor.setText(value) def setModelData(self, editor, model, index): value = editor.text() model.setData(index, value, QtCore.Qt.ItemDataRole.EditRole) def updateEditorGeometry(self, editor, option, index): editor.setGeometry(option.rect) class SequencerTreeView(QtWidgets.QTreeView): def __init__(self, parent=None): super().__init__(parent) self.width = self.viewport().size().width() def save(self, filename=None): self.model().save(filename) def selectRow(self, index): selection_model = self.selectionModel() selection_model.select(index, QtCore.QItemSelectionModel.SelectionFlag.Clear) for column in range(self.model().columnCount(index)): idx = self.model().createIndex(index.row(), column, index.internalPointer()) selection_model.select(idx, QtCore.QItemSelectionModel.SelectionFlag.Select) def activate_persistent_editor(self): model = self.model() for item in model: index = model.index(item.row(), 1, model.parent(item)) self.openPersistentEditor(index) def setModel(self, model): super().setModel(model) self.setColumnWidth(0, int(0.7 * self.width)) self.setColumnWidth(1, int(0.9 * self.width)) self.setColumnWidth(2, int(0.9 * self.width)) self.model().layoutChanged.connect(self.activate_persistent_editor) self.model().modelReset.connect(self.activate_persistent_editor) class SequenceDialog(QtWidgets.QFileDialog): """ Widget that displays a dialog box for loading or saving a sequence tree. It also shows a preview of sequence tree in the dialog box :param save: True if we are saving a file. Default False. """ def __init__(self, save=False, parent=None): """ Generate a serialized form of the sequence tree :param save: True if we are saving a file. Default False. :param parent: Passed on to QtWidgets.QWidget. Default is None """ super().__init__(parent) self.save = save self.setOption(QtWidgets.QFileDialog.Option.DontUseNativeDialog, True) self._setup_ui() def _setup_ui(self): preview_tab = QtWidgets.QTabWidget() vbox = QtWidgets.QVBoxLayout() param_vbox = QtWidgets.QVBoxLayout() vbox_widget = QtWidgets.QWidget() param_vbox_widget = QtWidgets.QWidget() self.preview_param = SequencerTreeView(parent=self) triggers = QtWidgets.QAbstractItemView.EditTrigger.NoEditTriggers self.preview_param.setEditTriggers(triggers) param_vbox.addWidget(self.preview_param) vbox_widget.setLayout(vbox) param_vbox_widget.setLayout(param_vbox) preview_tab.addTab(param_vbox_widget, "Sequence Parameters") if not self.save: self.append_checkbox = QtWidgets.QCheckBox("Append to existing sequence") self.append_checkbox.setCheckState(QtCore.Qt.CheckState.Checked) self.layout().addWidget(self.append_checkbox) self.setFileMode(QtWidgets.QFileDialog.FileMode.ExistingFile) else: self.setAcceptMode(QtWidgets.QFileDialog.AcceptMode.AcceptSave) self.setFileMode(QtWidgets.QFileDialog.FileMode.AnyFile) self.layout().addWidget(preview_tab, 0, 5, 4, 1) self.layout().setColumnStretch(5, 1) self.setMinimumSize(900, 500) self.resize(900, 500) self.currentChanged.connect(self.update_preview) def update_preview(self, filename): if not os.path.isdir(filename) and filename != '': with open(filename, 'r') as file_object: data = SequenceHandler(file_obj=file_object) tree_model = SequencerTreeModel(data=data) self.preview_param.setModel(tree_model) self.preview_param.expandAll() class SequencerWidget(QtWidgets.QWidget): """ Widget that allows to generate a sequence of measurements It allows sweeping parameters and moreover, one can write a simple text file to easily load a sequence. Sequences can also be saved Currently requires a queue function of the :class:`ManagedWindow` to have a "procedure" argument. :param inputs: List of strings representing the parameters name """ def __init__(self, inputs=None, sequence_file=None, parent=None): super().__init__(parent) self._parent = parent self._check_queue_signature() # if no explicit inputs are given, use the displayed parameters if inputs is not None: self._inputs = inputs else: self._inputs = self._parent.displays self._get_properties() self._setup_ui() self._layout() self.data = SequenceHandler(list(self.names_inv.keys())) self.tree.setModel(SequencerTreeModel(data=self.data)) if sequence_file is not None: self.load_sequence(filename=sequence_file) def _check_queue_signature(self): """ Check if the call signature of the implementation of the`ManagedWindow.queue` method accepts the `procedure` keyword argument, which is required for using the sequencer. """ call_signature = signature(self._parent.queue) if 'procedure' not in call_signature.parameters: raise AttributeError( "The queue method of of the ManagedWindow does not accept the 'procedure'" "keyword argument. Accepting this keyword argument is required when using" "the 'SequencerWidget'." ) def _get_properties(self): """ Obtain the names of the input parameters. """ parameter_objects = self._parent.procedure_class().parameter_objects() self.names = {key: parameter.name for key, parameter in parameter_objects.items() if key in self._inputs} self.names_inv = {name: key for key, name in self.names.items()} self.names_choices = list(sorted(self.names_inv.keys())) def _setup_ui(self): self.tree = SequencerTreeView(self) self.tree.setHeaderHidden(False) self.tree.setItemDelegateForColumn(1, ComboBoxDelegate(self, self.names_choices)) self.tree.setItemDelegateForColumn(2, LineEditDelegate(self)) self.load_seq_button = QtWidgets.QPushButton("Load sequence") self.load_seq_button.clicked.connect(self.load_sequence) self.load_seq_button.setToolTip("Load a sequence from a file.") self.save_seq_button = QtWidgets.QPushButton("Save sequence") self.save_seq_button.clicked.connect(self.save_sequence) self.save_seq_button.setToolTip("Save a sequence to a file.") self.queue_button = QtWidgets.QPushButton("Queue sequence") self.queue_button.clicked.connect(self.queue_sequence) self.add_root_item_btn = QtWidgets.QPushButton("Add root item") self.add_root_item_btn.clicked.connect( partial(self._add_tree_item, level=0) ) self.add_tree_item_btn = QtWidgets.QPushButton("Add item") self.add_tree_item_btn.clicked.connect(self._add_tree_item) self.remove_tree_item_btn = QtWidgets.QPushButton("Remove item") self.remove_tree_item_btn.clicked.connect(self._remove_selected_tree_item) def _layout(self): btn_box = QtWidgets.QHBoxLayout() btn_box.addWidget(self.load_seq_button) btn_box.addWidget(self.save_seq_button) btn_box_2 = QtWidgets.QHBoxLayout() btn_box_2.addWidget(self.add_root_item_btn) btn_box_2.addWidget(self.add_tree_item_btn) btn_box_2.addWidget(self.remove_tree_item_btn) btn_box_3 = QtWidgets.QHBoxLayout() btn_box_3.addWidget(self.queue_button) vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(6) vbox.addLayout(btn_box) vbox.addWidget(self.tree) vbox.addLayout(btn_box_2) vbox.addLayout(btn_box_3) self.setLayout(vbox) def _add_tree_item(self, *, level=None, parameter=None): """ Add an item to the sequence tree. An item will be added as a child to the selected (existing) item, except when level is given. :param level: An integer value determining the level at which an item is added. If level is 0, a root item will be added. :param parameter: If given, the parameter field is pre-filled """ selected = self.tree.selectionModel().selection().indexes() if len(selected) >= 1 and level != 0: parent = selected[0] else: parent = None if parameter is None: parameter = self.names_choices[0] model = self.tree.model() node_index = model.add_node(parameter=parameter, parent=parent) self.tree.openPersistentEditor(model.index(node_index.row(), 1, parent)) self.tree.expandAll() self.tree.selectRow(node_index) def _remove_selected_tree_item(self): """ Remove the selected item (and any child items) from the sequence tree. """ selected = self.tree.selectionModel().selection().indexes() if len(selected) == 0: return node_index = self.tree.model().remove_node(selected[0]) if node_index.isValid(): self.tree.selectRow(node_index) def get_sequence(self): return self.data.parameters_sequence(self.names_inv) def queue_sequence(self): """ Obtain a list of parameters from the sequence tree, enter these into procedures, and queue these procedures. """ self.queue_button.setEnabled(False) try: sequence = self.get_sequence() except SequenceEvaluationError: log.error("Evaluation of one of the sequence strings went wrong, no sequence queued.") else: log.info( "Queuing %d measurements based on the entered sequences." % len(sequence) ) for entry in sequence: QtWidgets.QApplication.processEvents() parameters = dict(ChainMap(*entry[::-1])) procedure = self._parent.make_procedure() procedure.set_parameters(parameters) self._parent.queue(procedure=procedure) finally: self.queue_button.setEnabled(True) def save_sequence(self): dialog = SequenceDialog(save=True) if dialog.exec(): filename = dialog.selectedFiles()[0] with open(filename, 'w') as file_object: self.tree.save(file_object) log.info('Saved sequence file %s' % filename) def load_sequence(self, *, filename=None): """ Load a sequence from a .txt file. :param filename: Filename (string) of the to-be-loaded file. """ append_flag = False if (filename is None) or (filename == ''): dialog = SequenceDialog() if dialog.exec(): append_flag = dialog.append_checkbox.checkState() == QtCore.Qt.CheckState.Checked filenames = dialog.selectedFiles() filename = filenames[0] else: return with open(filename, 'r') as file_object: self.tree.model().load(file_object, append=append_flag) self.tree.expandAll() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/tab_widget.py0000644000175100017510000000503015203313266023065 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class TabWidget: """ Utility class to define default implementation for some basic methods. When defining a widget to be used in subclasses of :class:`ManagedWindowBase`, users should inherit from this class and provide an implementation of these methods """ def __init__(self, name, *args, **kwargs): super().__init__(*args, **kwargs) self.name = name def new_curve(self, *args, **kwargs): """ Create a new curve """ return None def load(self, curve): """ Add curve to widget """ pass def remove(self, curve): """ Remove curve from widget """ pass def set_color(self, curve, color): """ Set color for widget """ pass def preview_widget(self, parent=None): """ Return a Qt widget suitable for preview during loading See also :class:`ResultsDialog` If the object returned is not None, then it should have also an attribute `name`. """ return None def clear_widget(self): """ Clear widget content Behaviour is widget specific and it is currently used in preview mode """ return None ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/widgets/table_widget.py0000644000175100017510000006026015203313266023414 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from functools import partial import numpy as np import pyqtgraph as pg import pandas as pd from ..Qt import QtCore, QtWidgets, QtGui from .tab_widget import TabWidget from ...experiment import Procedure SORT_ROLE = QtCore.Qt.ItemDataRole.UserRole + 1 SORTING_ENABLED = True # Allow to disable sorting, for debug purpose only log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ResultsTable(QtCore.QObject): """ Class representing a panda dataframe """ data_changed = QtCore.Signal(int, int, int, int) def __init__(self, results, color, column_index=None, force_reload=False, wdg=None, **kwargs): super().__init__() self.results = results self.color = color self.force_reload = force_reload self.last_row_count = 0 self.wdg = wdg self.column_index = column_index self.data = self.results.data self._started = False @property def data(self): return self._data @data.setter def data(self, value): self._data = value if self.column_index is not None: self._data = self._data.set_index(self.column_index) else: self._data.reset_index() @property def rows(self): return self._data.shape[0] @property def columns(self): return self._data.shape[1] def init(self): self.last_row_count = 0 def start(self): self._started = True def stop(self): self._started = False def update_data(self): if not self._started: return if self.force_reload: self.results.reload() self.data = self.results.data current_row_count, columns = self._data.shape if (self.last_row_count < current_row_count): # Request cells content update self.data_changed.emit(self.last_row_count, 0, current_row_count - 1, columns - 1) self.last_row_count = current_row_count def set_color(self, color): self.color = color def set_index(self, index): self.column_index = index class PandasModelBase(QtCore.QAbstractTableModel): """ This class provided a model to manage multiple panda dataframes and display them as a single table. The multiple pandas dataframes are provided as ResultTable class instances and all of them share the same number of columns. There are some assumptions: - Series in the dataframe are identical, we call this number k - Series length can be different, we call this number l(x), where x=1..n The data can be presented as follow: - By column: each series in a separate column, in this case table shape will be: (k*n) x (max(l(x) x=1..n) - By row: column fixed to the number of series, in this case table shape will be: k x (sum of l(x) x=1..n) """ float_digits = 6 concat_axis = 0 def __init__(self, column_index=None, results_list=[], parent=None): super().__init__(parent) self.column_index = column_index self._init_data(results_list) def _init_data(self, results_list=None): if results_list is None: results_list = [] self.results_list = results_list self.row_count = self.pandas_row_count() self.column_count = self.pandas_column_count() def clear(self): self.beginResetModel() for results in self.results_list: results.stop() self._init_data() self.endResetModel() def add_results(self, results): if results not in self.results_list: self.beginResetModel() self.results_list.append(results) results.data_changed.connect(partial(self._data_changed, results)) self.endResetModel() results.init() results.start() results.update_data() def remove_results(self, results): self.beginResetModel() if results in self.results_list: self.results_list.remove(results) self.row_count = self.pandas_row_count() self.column_count = self.pandas_column_count() results.stop() self.endResetModel() def rowCount(self, parent=None): return self.row_count def columnCount(self, parent=None): return self.column_count def data(self, index, role=QtCore.Qt.ItemDataRole.DisplayRole): if index.isValid() and role in (QtCore.Qt.ItemDataRole.DisplayRole, SORT_ROLE): try: results, row, col = self.translate_to_local(index.row(), index.column()) value = results.data.iat[row, col] column_type = results.data.dtypes.iat[col] # Cast to column type value_render = column_type.type(value) except (IndexError, ValueError, TypeError): value = np.nan value_render = "" if isinstance(value_render, np.float64): # limit maximum number of decimal digits displayed value_render = f"{value_render:.{self.float_digits:d}g}" # noqa: E231 if role == QtCore.Qt.ItemDataRole.DisplayRole: return str(value_render) elif role == SORT_ROLE: # For numerical sort return float(value) return None def _get_new_rows_columns(self, results, r1, c1, r2, c2): new_rows = self.pandas_row_count() - self.row_count new_rows_start = self.row_count new_columns = self.pandas_column_count() - self.column_count new_columns_start = self.column_count return new_rows, new_rows_start, new_columns, new_columns_start def headerData(self, section, orientation, role): """ Return header information Override method from QAbstractTableModel """ if role == QtCore.Qt.ItemDataRole.DisplayRole: if orientation == QtCore.Qt.Orientation.Horizontal: return str(self.horizontal_header[section]) if orientation == QtCore.Qt.Orientation.Vertical: return str(self.vertical_header[section]) elif role == QtCore.Qt.ItemDataRole.DecorationRole: if orientation == QtCore.Qt.Orientation.Horizontal: return self.horizontal_header_decoration(section) if orientation == QtCore.Qt.Orientation.Vertical: return self.vertical_header_decoration(section) return None def _data_changed(self, results, r1, c1, r2, c2): """ Internal method to handle data changed signal """ rows, rows_start, columns, columns_start = \ self._get_new_rows_columns(results, r1, c1, r2, c2) if rows or columns: if rows > 0: # New rows available self.beginInsertRows(QtCore.QModelIndex(), rows_start, rows_start + rows - 1) self.row_count += rows self.endInsertRows() if columns > 0: # New columns available self.beginInsertColumns(QtCore.QModelIndex(), columns_start, columns_start + columns - 1) self.column_count += columns self.endInsertColumns() else: top_bottom = self._get_row_column_set(results, r1, c1, r2, c2) for r1, c1, r2, c2 in top_bottom: self.dataChanged.emit(self.createIndex(r1, c1), self.createIndex(r2, c2)) def pandas_row_count(self): """ Return total row count of the panda dataframes The value depends on the geometry selected to display dataframes """ raise Exception("Subclass should implement it") def pandas_column_count(self): """ Return total column count of the panda dataframes The value depends on the geometry selected to display dataframes """ raise Exception("Subclass should implement it") def _get_row_column_set(self, results, r1, c1, r2, c2): """ Return set of top/bottom coordinates for data changed event. Depending on the geometry of the table a single top/bottom could be translated in multiple tops/bottoms """ raise Exception("Subclass should implement it") def translate_to_local(self, row, col): """ Translate from full table coordinate to single results coordinates """ raise Exception("Subclass should implement it") def translate_to_global(self, results, row, col): """ Translate from single results coordinates to full table coordinates """ raise Exception("Subclass should implement it") @property def horizontal_header(self): raise Exception("Subclass should implement it") @property def vertical_header(self): return range(self.row_count) def horizontal_header_decoration(self, section): return None def vertical_header_decoration(self, section): return None def export_df(self): df_list = [results.data for results in self.results_list] if not df_list: # Empty list df = None else: # Concatenate pandas data frames df = pd.concat(df_list, axis=self.concat_axis, sort=False) df = df.replace(to_replace=np.nan, value="") return df def set_index(self, index): self.column_index = index # Update results list for r in self.results_list: r.stop() r.set_index(index) self.beginResetModel() for r in self.results_list: r.start() r.update_data() self.row_count = self.pandas_row_count() self.column_count = self.pandas_column_count() self.endResetModel() def copy_model(self, model_class): model = model_class(self.column_index, self.results_list[:]) return model class PandasModelByRow(PandasModelBase): concat_axis = 0 def pandas_row_count(self): rows = 0 for r in self.results_list: rows += r.rows return rows def pandas_column_count(self): cols = 0 if self.results_list: cols = self.results_list[0].columns return cols def _get_row_column_set(self, results, r1, c1, r2, c2): top = self.translate_to_global(results, r1, c1) bottom = self.translate_to_global(results, r2, c2) return (top + bottom), def translate_to_local(self, row, col): """ Translate from full table coordinate to single results coordinates """ for index, results in enumerate(self.results_list): if row < results.rows: break row -= results.rows return results, row, col def translate_to_global(self, results, row, col): """ Translate from single results coordinates to full table coordinates """ rows = 0 for res in self.results_list: if res == results: break rows += results.rows return rows + row, col @property def vertical_header(self): if self.column_index is None: header = range(self.row_count) else: header = [] for r in self.results_list: header.extend(r.data.index) return header @property def horizontal_header(self): if self.results_list: return self.results_list[0].data.columns else: return [] def vertical_header_decoration(self, section): results, _, _ = self.translate_to_local(section, 0) pixelmap = QtGui.QPixmap(6, 6) pixelmap.fill(results.color) return pixelmap class PandasModelByColumn(PandasModelBase): concat_axis = 1 def pandas_row_count(self): if self.column_index is None: return max([0] + [r.rows for r in self.results_list]) else: return len(self.vertical_header) def pandas_column_count(self): cols = 0 size = len(self.results_list) if size > 0: cols = self.results_list[0].columns * size return cols def _get_row_column_set(self, results, r1, c1, r2, c2): top_bottoms = [] for i in range(c1, c2 + 1): top = self.translate_to_global(results, r1, i) bottom = self.translate_to_global(results, r2, i) top_bottoms.append(top + bottom) return top_bottoms def translate_to_local(self, row, col): """ Translate from full table coordinate to single results coordinates """ columns = 0 for index, results in enumerate(self.results_list): if col < (columns + results.columns): break columns += results.columns if (self.column_index is not None): # Remap row to matching index entry when indexing is used try: index = self.vertical_header[row] row = list(results.data.index).index(index) except ValueError: row = None return results, row, col - columns def translate_to_global(self, results, row, col): """ Translate from single results coordinates to full table coordinates """ columns = 0 for res in self.results_list: if res == results: break columns += results.columns return row, col + columns @property def horizontal_header(self): size = len(self.results_list) if size: v = list(self.results_list[0].data.columns) return v * size else: return [] def horizontal_header_decoration(self, section): results, _, _ = self.translate_to_local(0, section) pixelmap = QtGui.QPixmap(6, 6) pixelmap.fill(results.color) return pixelmap @property def vertical_header(self): header = set([]) for r in self.results_list: header = header.union(set(r.data.index)) header = sorted(list(header)) return header class Table(QtWidgets.QTableView): """ Table format view of :class:`Experiment` objects """ supported_formats = { "CSV file (*.csv)": 'csv', "Excel file (*.xlsx)": 'excel', "HTML file (*.html *.htm)": 'html', "JSON file (*.json)": 'json', "LaTeX file (*.tex)": 'latex', "Markdown file (*.md)": 'markdown', "XML file (*.xml)": 'xml', } def __init__(self, refresh_time=0.2, check_status=True, force_reload=False, layout_class=PandasModelByColumn, column_index=None, float_digits=6, parent=None): super().__init__(parent) self.force_reload = force_reload self.float_digits = float_digits model = layout_class(column_index=column_index) self.setModel(model) self.horizontalHeader().setStyleSheet("font: bold;") self.sortByColumn(-1, QtCore.Qt.SortOrder.AscendingOrder) self.setSortingEnabled(True) self.horizontalHeader().setSectionsMovable(True) self.horizontalHeader().setSectionResizeMode( QtWidgets.QHeaderView.ResizeMode.ResizeToContents ) self.setup_context_menu() self.refresh_time = refresh_time self.check_status = check_status if self.refresh_time is not None: self.timer = QtCore.QTimer(self) self.timer.timeout.connect(self.update_tables) self.timer.start(int(self.refresh_time * 1e3)) def setModel(self, model): model.float_digits = self.float_digits if SORTING_ENABLED: proxyModel = QtCore.QSortFilterProxyModel(self) proxyModel.setSourceModel(model) model = proxyModel model.setSortRole(SORT_ROLE) super().setModel(model) def source_model(self): model = self.model() if SORTING_ENABLED: model = model.sourceModel() return model def export_action(self): df = self.source_model().export_df() if df is not None: formats = ";;".join(self.supported_formats.keys()) filename_and_ext = QtWidgets.QFileDialog.getSaveFileName( self, "Save File", "", formats, ) filename = filename_and_ext[0] ext = filename_and_ext[1] if filename: mode = self.supported_formats[ext] prefix = df.style if mode == "latex" else df getattr(prefix, 'to_' + mode)(filename) def refresh_action(self): self.update_tables() def copy_action(self): df = self.source_model().export_df() if df is not None: df.to_clipboard() def setup_context_menu(self): self.setContextMenuPolicy(QtCore.Qt.ContextMenuPolicy.CustomContextMenu) self.customContextMenuRequested.connect(self.context_menu) self.copy = QtGui.QAction("Copy table data", self) self.copy.triggered.connect(self.copy_action) self.refresh = QtGui.QAction("Refresh table data", self) self.refresh.triggered.connect(self.refresh_action) self.export = QtGui.QAction("Export table data", self) self.export.triggered.connect(self.export_action) def context_menu(self, point): menu = QtWidgets.QMenu(self) menu.addAction(self.copy) menu.addAction(self.refresh) menu.addAction(self.export) menu.exec(self.mapToGlobal(point)) def update_tables(self, force=False): model = self.source_model() for item in model.results_list: if not self.check_status or force: item.update_data() else: if item.results.procedure.status == Procedure.RUNNING: item.update_data() def set_color(self, table, color): table.set_color(color) def add_table(self, table): model = self.source_model() model.add_results(table) def remove_table(self, table): model = self.source_model() model.remove_results(table) table.stop() if model.rowCount() == 0: # Empty table, reset sorting policy self.setSortingEnabled(False) self.sortByColumn(-1, QtCore.Qt.SortOrder.AscendingOrder) self.setSortingEnabled(True) def clear(self): model = self.source_model() model.clear() self.setSortingEnabled(False) self.sortByColumn(-1, QtCore.Qt.SortOrder.AscendingOrder) self.setSortingEnabled(True) def set_index(self, index): model = self.source_model() model.set_index(index) def set_model(self, model_class): """ Replace model with new instance of model_class """ model = self.source_model() new_model = model.copy_model(model_class) self.setModel(new_model) class TableWidget(TabWidget, QtWidgets.QWidget): """ Widget to display experiment data in a tabular format """ layout_class_map = { 'By Row': PandasModelByRow, 'By Column': PandasModelByColumn, } def __init__(self, name, columns, by_column=True, column_index=None, refresh_time=0.2, float_digits=6, check_status=True, parent=None): super().__init__(name, parent) self.columns = columns self.layout_names = list(self.layout_class_map.keys()) self.table_layout = self.layout_names[1] if by_column else self.layout_names[0] self.column_index = column_index self.refresh_time = refresh_time self.check_status = check_status self.float_digits = float_digits self._setup_ui() self._layout() def _setup_ui(self): self.column_index_label = QtWidgets.QLabel(self) self.column_index_label.setMaximumSize(QtCore.QSize(45, 16777215)) self.column_index_label.setText('Index:') self.layout_label = QtWidgets.QLabel(self) self.layout_label.setMaximumSize(QtCore.QSize(45, 16777215)) self.layout_label.setText('Layout:') self.column_index_combo = QtWidgets.QComboBox(self) self.layout = QtWidgets.QComboBox(self) self.column_index_combo.addItem('') for column in self.columns: self.column_index_combo.addItem(column) if self.column_index is not None: self.column_index_combo.setCurrentText(self.column_index) for key in self.layout_names: self.layout.addItem(key) self.layout.setCurrentText(self.table_layout) self.column_index_combo.activated.connect(self.update_column_index) self.layout.activated.connect(self.update_layout) self.table = Table(refresh_time=self.refresh_time, check_status=self.check_status, force_reload=False, layout_class=self.layout_class_map[self.table_layout], column_index=self.column_index, float_digits=self.float_digits, parent=self, ) def _layout(self): vbox = QtWidgets.QVBoxLayout(self) vbox.setSpacing(0) hbox = QtWidgets.QHBoxLayout() hbox.setSpacing(10) hbox.setContentsMargins(-1, 6, -1, 6) hbox.addWidget(self.column_index_label) hbox.addWidget(self.column_index_combo) hbox.addWidget(self.layout_label) hbox.addWidget(self.layout) vbox.addLayout(hbox) vbox.addWidget(self.table) self.setLayout(vbox) def update_layout(self, entry): model = self.layout.itemText(entry) self.table_layout = entry self.table.set_model(self.layout_class_map[model]) def update_column_index(self, entry): index = self.column_index_combo.itemText(entry) if index == '': index = None self.column_index = index self.table.set_index(index) def new_curve(self, results, color=pg.intColor(0), **kwargs): return ResultsTable(results, color, self.column_index, wdg=self, **kwargs) def load(self, table): self.table.add_table(table) def remove(self, table): self.table.remove_table(table) def set_color(self, table, color): """ Change the color of the pen of the curve """ self.table.set_color(table, color) def preview_widget(self, parent=None): """ Return a widget suitable for preview during loading """ by_column = False if self.table_layout == self.layout_names[0] else True return TableWidget("Table preview", columns=self.columns, by_column=by_column, refresh_time=None, check_status=False, float_digits=self.float_digits, parent=None, ) def clear_widget(self): self.table.clear() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0059128 pymeasure-0.16.0/pymeasure/display/windows/0000755000175100017510000000000015203313301020416 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/windows/__init__.py0000644000175100017510000000244115203313266022542 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .plotter_window import PlotterWindow from .managed_window import ManagedWindowBase, ManagedWindow from .managed_image_window import ManagedImageWindow ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/windows/managed_dock_window.py0000644000175100017510000001021315203313266024762 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..widgets.dock_widget import DockWidget from ..widgets.log_widget import LogWidget from .managed_window import ManagedWindowBase log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ManagedDockWindow(ManagedWindowBase): """ Display experiment output with multiple docking windows with :class:`~pymeasure.display.widgets.dock_widget.DockWidget` class. :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param x_axis: the data column(s) for the x-axis of the plot. This may be a string or a list of strings from the data columns of the procedure. The list length determines the number of plots :param y_axis: the data column(s) for the y-axis of the plot. This may be a string or a list of strings from the data columns of the procedure. The list length determines the number of plots :param linewidth: linewidth for the displayed curves, default is 1 :param log_fmt: formatting string for the log-widget :param log_datefmt: formatting string for the date in the log-widget :param \\**kwargs: optional keyword arguments that will be passed to :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` """ def __init__(self, procedure_class, x_axis=None, y_axis=None, linewidth=1, log_fmt=None, log_datefmt=None, **kwargs): self.x_axis = x_axis self.y_axis = y_axis measure_quantities = [] # Expand x_axis if it is a list if isinstance(self.x_axis, list): measure_quantities += [*self.x_axis] self.x_axis_labels = self.x_axis # Change x_axis to a string from list for ResultsDialog self.x_axis = self.x_axis[0] else: self.x_axis_labels = [self.x_axis, ] measure_quantities.append(self.x_axis) # Expand y_axis if it is a list if isinstance(self.y_axis, list): measure_quantities += [*self.y_axis] self.y_axis_labels = self.y_axis # Change y_axis to a string from list for ResultsDialog self.y_axis = self.y_axis[0] else: self.y_axis_labels = [self.y_axis, ] measure_quantities.append(self.y_axis) self.log_widget = LogWidget("Experiment Log", fmt=log_fmt, datefmt=log_datefmt) self.dock_widget = DockWidget("Dock Tab", procedure_class, self.x_axis_labels, self.y_axis_labels, linewidth=linewidth) if "widget_list" not in kwargs: kwargs["widget_list"] = () kwargs["widget_list"] = kwargs["widget_list"] + (self.dock_widget, self.log_widget) super().__init__(procedure_class, **kwargs) self.browser_widget.browser.measured_quantities.update(measure_quantities) logging.getLogger().addHandler(self.log_widget.handler) log.setLevel(self.log_level) log.info("DockWindow connected to logging") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/windows/managed_image_window.py0000644000175100017510000000524315203313266025133 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from ..widgets import ( ImageWidget, ) from .managed_window import ManagedWindow log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ManagedImageWindow(ManagedWindow): """ Display experiment output with an :class:`~pymeasure.display.widgets.image_widget.ImageWidget` class. :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param x_axis: the data-column for the x-axis of the plot, cannot be changed afterwards for the image-plot :param y_axis: the data-column for the y-axis of the plot, cannot be changed afterwards for the image-plot :param z_axis: the initial data-column for the z-axis of the plot, can be changed afterwards :param \\**kwargs: optional keyword arguments that will be passed to :class:`~pymeasure.display.windows.managed_image_window.ManagedWindow` """ def __init__(self, procedure_class, x_axis, y_axis, z_axis=None, **kwargs): self.z_axis = z_axis self.image_widget = ImageWidget( "Image", procedure_class.DATA_COLUMNS, x_axis, y_axis, z_axis) if "widget_list" not in kwargs: kwargs["widget_list"] = () kwargs["widget_list"] = kwargs["widget_list"] + (self.image_widget,) super().__init__(procedure_class, x_axis=x_axis, y_axis=y_axis, **kwargs) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/windows/managed_window.py0000644000175100017510000007604715203313266024003 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import os import platform import subprocess import tempfile import shutil import pyqtgraph as pg from ..browser import BrowserItem from ..manager import Manager, Experiment from ..Qt import QtCore, QtWidgets, QtGui from ..widgets import ( PlotWidget, BrowserWidget, InputsWidget, LogWidget, ResultsDialog, SequencerWidget, FileInputWidget, EstimatorWidget, ) from ...experiment import Results, Procedure, unique_filename log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ManagedWindowBase(QtWidgets.QMainWindow): """ Base class for GUI experiment management . The ManagedWindowBase provides an interface for inputting experiment parameters, running several experiments (:class:`~pymeasure.experiment.procedure.Procedure`), plotting result curves, and listing the experiments conducted during a session. The ManagedWindowBase uses a Manager to control Workers in a Queue, and provides a simple interface. The :meth:`~pymeasure.display.windows.managed_window.ManagedWindowBase.queue` method must be overridden by the child class. The ManagedWindowBase allow user to define a set of widget that display information about the experiment. The information displayed may include: plots, tabular view, logging information,... This class is not intended to be used directly, but it should be subclassed to provide some appropriate widget list. Example of classes usable as element of widget list are: - :class:`~pymeasure.display.widgets.log_widget.LogWidget` - :class:`~pymeasure.display.widgets.plot_widget.PlotWidget` - :class:`~pymeasure.display.widgets.image_widget.ImageWidget` Of course, users can define its own widget making sure that inherits from :class:`~pymeasure.display.widgets.tab_widget.TabWidget`. Examples of ready to use classes inherited from ManagedWindowBase are: - :class:`~pymeasure.display.windows.managed_window.ManagedWindow` - :class:`~pymeasure.display.windows.managed_image_window.ManagedImageWindow` .. seealso:: Tutorial :ref:`tutorial-managedwindow` A tutorial and example on the basic configuration and usage of ManagedWindow. Parameters for :code:`__init__` constructor. :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param widget_list: list of widget to be displayed in the GUI :param inputs: list of :class:`~pymeasure.experiment.parameters.Parameter` instance variable names, which the display will generate graphical fields for :param displays: list of :class:`~pymeasure.experiment.parameters.Parameter` instance variable names displayed in the browser window :param log_channel: :code:`logging.Logger` instance to use for logging output :param log_level: logging level :param parent: Parent widget or :code:`None` :param sequencer: a boolean stating whether or not the sequencer has to be included into the window :param sequencer_inputs: either :code:`None` or a list of the parameter names to be scanned over. If no list of parameters is given, the parameters displayed in the manager queue are used. :param sequence_file: simple text file to quickly load a pre-defined sequence with the :code:`Load sequence` button :param inputs_in_scrollarea: boolean that display or hide a scrollbar to the input area :param enable_file_input: a boolean controlling whether a :class:`~pymeasure.display.widgets.fileinput_widget.FileInputWidget` to specify where the experiment's result will be saved is displayed (True, default) or not (False). This widget contains a field to enter the (base of the) filename (with or without extension; if absent, the extension will be appended). This field also allows for placeholders to use parameter-values and metadata-value in the filename. The widget also has a field to select the directory where the file is to be stored, and a toggle to control whether the data should be saved to the selected file, or not (i.e., to a temporary file instead). :param hide_groups: a boolean controlling whether parameter groups are hidden (True, default) or disabled/grayed-out (False) when the group conditions are not met. """ def __init__(self, procedure_class, widget_list=(), inputs=(), displays=(), log_channel='', log_level=logging.INFO, parent=None, sequencer=False, sequencer_inputs=None, sequence_file=None, inputs_in_scrollarea=False, enable_file_input=True, hide_groups=True, ): super().__init__(parent) app = QtCore.QCoreApplication.instance() app.aboutToQuit.connect(self.quit) self.procedure_class = procedure_class self.inputs = inputs self.hide_groups = hide_groups self.displays = displays self.use_sequencer = sequencer self.sequencer_inputs = sequencer_inputs self.sequence_file = sequence_file self.inputs_in_scrollarea = inputs_in_scrollarea self.enable_file_input = enable_file_input self.log = logging.getLogger(log_channel) self.log_level = log_level log.setLevel(log_level) self.log.setLevel(log_level) self.widget_list = widget_list # Check if the get_estimates function is reimplemented self.use_estimator = not self.procedure_class.get_estimates == Procedure.get_estimates # Validate DATA_COLUMNS fit pymeasure column header format Procedure.parse_columns(self.procedure_class.DATA_COLUMNS) self._setup_ui() self._layout() def _setup_ui(self): self.queue_button = QtWidgets.QPushButton('Queue', self) self.queue_button.clicked.connect(self._queue) self.abort_button = QtWidgets.QPushButton('Abort', self) self.abort_button.setEnabled(False) self.abort_button.clicked.connect(self.abort) self.browser_widget = BrowserWidget( self.procedure_class, self.displays, [], # This value will be patched by subclasses, if needed parent=self ) self.browser_widget.show_button.clicked.connect(self.show_experiments) self.browser_widget.hide_button.clicked.connect(self.hide_experiments) self.browser_widget.clear_button.clicked.connect(self.clear_experiments) self.browser_widget.open_button.clicked.connect(self.open_experiment) self.browser = self.browser_widget.browser self.browser.setContextMenuPolicy(QtCore.Qt.ContextMenuPolicy.CustomContextMenu) self.browser.customContextMenuRequested.connect(self.browser_item_menu) self.browser.itemChanged.connect(self.browser_item_changed) self.inputs = InputsWidget( self.procedure_class, self.inputs, parent=self, hide_groups=self.hide_groups, inputs_in_scrollarea=self.inputs_in_scrollarea, ) if self.enable_file_input: self.file_input = FileInputWidget(parent=self) self.manager = Manager(self.widget_list, self.browser, log_level=self.log_level, parent=self) self.manager.abort_returned.connect(self.abort_returned) self.manager.queued.connect(self.queued) self.manager.running.connect(self.running) self.manager.finished.connect(self.finished) self.manager.log.connect(self.log.handle) if self.use_sequencer: self.sequencer = SequencerWidget( self.sequencer_inputs, self.sequence_file, parent=self ) if self.use_estimator: self.estimator = EstimatorWidget( parent=self ) def _layout(self): self.main = QtWidgets.QWidget(self) inputs_dock = QtWidgets.QWidget(self) inputs_vbox = QtWidgets.QVBoxLayout(self.main) queue_abort_hbox = QtWidgets.QHBoxLayout() queue_abort_hbox.setSpacing(10) queue_abort_hbox.setContentsMargins(-1, 6, -1, 6) queue_abort_hbox.addWidget(self.queue_button) queue_abort_hbox.addWidget(self.abort_button) queue_abort_hbox.addStretch() inputs_vbox.addWidget(self.inputs) inputs_vbox.addSpacing(15) if self.enable_file_input: inputs_vbox.addWidget(self.file_input) inputs_vbox.addSpacing(15) inputs_vbox.addLayout(queue_abort_hbox) inputs_vbox.addStretch(0) inputs_dock.setLayout(inputs_vbox) dock = QtWidgets.QDockWidget('Input Parameters') dock.setWidget(inputs_dock) dock.setFeatures(QtWidgets.QDockWidget.DockWidgetFeature.NoDockWidgetFeatures) self.addDockWidget(QtCore.Qt.DockWidgetArea.LeftDockWidgetArea, dock) if self.use_sequencer: sequencer_dock = QtWidgets.QDockWidget('Sequencer') sequencer_dock.setWidget(self.sequencer) sequencer_dock.setFeatures(QtWidgets.QDockWidget.DockWidgetFeature.NoDockWidgetFeatures) self.addDockWidget(QtCore.Qt.DockWidgetArea.LeftDockWidgetArea, sequencer_dock) if self.use_estimator: estimator_dock = QtWidgets.QDockWidget('Estimator') estimator_dock.setWidget(self.estimator) estimator_dock.setFeatures(QtWidgets.QDockWidget.DockWidgetFeature.NoDockWidgetFeatures) self.addDockWidget(QtCore.Qt.DockWidgetArea.LeftDockWidgetArea, estimator_dock) self.tabs = QtWidgets.QTabWidget(self.main) for wdg in self.widget_list: self.tabs.addTab(wdg, wdg.name) splitter = QtWidgets.QSplitter(QtCore.Qt.Orientation.Vertical) splitter.addWidget(self.tabs) splitter.addWidget(self.browser_widget) vbox = QtWidgets.QVBoxLayout(self.main) vbox.setSpacing(0) vbox.addWidget(splitter) self.main.setLayout(vbox) self.setCentralWidget(self.main) self.main.show() self.resize(1000, 800) def quit(self, evt=None): if self.manager.is_running(): self.abort() self.close() def browser_item_changed(self, item, column): if column == 0: state = item.checkState(0) experiment = self.manager.experiments.with_browser_item(item) if state == QtCore.Qt.CheckState.Unchecked: for curve in experiment.curve_list: if curve: curve.wdg.remove(curve) else: for curve in experiment.curve_list: if curve: curve.wdg.load(curve) def browser_item_menu(self, position): item = self.browser.itemAt(position) if item is not None: selected_items = self.browser.selectedItems() if item not in selected_items: selected_items = [item] experiments = [self.manager.experiments.with_browser_item(i) for i in selected_items] experiment = self.manager.experiments.with_browser_item(item) menu = QtWidgets.QMenu(self) # Open action_open = QtGui.QAction(menu) action_open.setText("Open Data Externally") if len(experiments) > 1: action_open.setEnabled(False) action_open.triggered.connect( lambda: self.open_file_externally(experiment.results.data_filename)) menu.addAction(action_open) # Reveal in file explorer action_reveal = QtGui.QAction(menu) action_reveal.setText("Reveal in File Explorer") if len(experiments) > 1: action_reveal.setEnabled(False) action_reveal.triggered.connect( lambda: self.reveal_in_file_explorer(experiment.results.data_filename)) menu.addAction(action_reveal) # Save a copy of the datafile action_save = QtGui.QAction(menu) action_save.setText("Save Data File Copy") if len(experiments) > 1: action_save.setEnabled(False) action_save.triggered.connect( lambda: self.save_experiment_copy(experiment.results.data_filename)) menu.addAction(action_save) # Change Color action_change_color = QtGui.QAction(menu) action_change_color.setText("Change Color") if len(experiments) > 1: action_change_color.setEnabled(False) action_change_color.triggered.connect( lambda: self.change_color(experiment)) menu.addAction(action_change_color) # Remove action_remove = QtGui.QAction(menu) action_remove.setText(f"Remove Graph{'s' if len(experiments) > 1 else ''}") if self.manager.is_running(): if self.manager.running_experiment() in experiments: # Experiment running action_remove.setEnabled(False) action_remove.triggered.connect(lambda: self.remove_experiment(experiments)) menu.addAction(action_remove) # Delete action_delete = QtGui.QAction(menu) action_delete.setText(f"Delete Data File{'s' if len(experiments) > 1 else ''}") if self.manager.is_running(): if self.manager.running_experiment() in experiments: # Experiment running action_delete.setEnabled(False) action_delete.triggered.connect(lambda: self.delete_experiment_data(experiments)) menu.addAction(action_delete) # Use parameters action_use = QtGui.QAction(menu) action_use.setText("Use These Parameters") if len(experiments) > 1: action_use.setEnabled(False) action_use.triggered.connect( lambda: self.set_parameters(experiment.procedure.parameter_objects())) menu.addAction(action_use) menu.exec(self.browser.viewport().mapToGlobal(position)) def remove_experiment(self, experiment): experiments = experiment if isinstance(experiment, list) else [experiment] if len(experiments) > 1: message = f"Are you sure you want to remove these {len(experiments)} graphs?" else: message = "Are you sure you want to remove the graph?" reply = QtWidgets.QMessageBox.question(self, 'Remove Graph', message, QtWidgets.QMessageBox.StandardButton.Yes | QtWidgets.QMessageBox.StandardButton.No, QtWidgets.QMessageBox.StandardButton.No) if reply == QtWidgets.QMessageBox.StandardButton.Yes: for exp in experiments: self.manager.remove(exp) def delete_experiment_data(self, experiment): experiments = experiment if isinstance(experiment, list) else [experiment] if len(experiments) > 1: message = f"Are you sure you want to delete these {len(experiments)} data files?" else: message = "Are you sure you want to delete this data file?" reply = QtWidgets.QMessageBox.question(self, 'Delete Data', message, QtWidgets.QMessageBox.StandardButton.Yes | QtWidgets.QMessageBox.StandardButton.No, QtWidgets.QMessageBox.StandardButton.No) if reply == QtWidgets.QMessageBox.StandardButton.Yes: for exp in experiments: self.manager.remove(exp) try: os.unlink(exp.data_filename) except OSError: log.warning(f"Could not delete file {exp.data_filename}") def show_experiments(self): root = self.browser.invisibleRootItem() for i in range(root.childCount()): item = root.child(i) item.setCheckState(0, QtCore.Qt.CheckState.Checked) def hide_experiments(self): root = self.browser.invisibleRootItem() for i in range(root.childCount()): item = root.child(i) item.setCheckState(0, QtCore.Qt.CheckState.Unchecked) def clear_experiments(self): self.manager.clear() def open_experiment(self): dialog = ResultsDialog(self.procedure_class, widget_list=self.widget_list) if dialog.exec(): filenames = dialog.selectedFiles() for filename in map(str, filenames): if filename in self.manager.experiments: QtWidgets.QMessageBox.warning( self, "Load Error", "The file %s cannot be opened twice." % os.path.basename(filename) ) elif filename == '': return else: results = Results.load(filename) experiment = self.new_experiment(results) for curve in experiment.curve_list: if curve: curve.update_data() experiment.browser_item.progressbar.setValue(100) self.manager.load(experiment) log.info('Opened data file %s' % filename) def save_experiment_copy(self, source_filename): """Save a copy of the datafile to a selected folder and file. Primarily useful for experiments that are stored in a temporary file. """ dialog = QtWidgets.QFileDialog(self) dialog.setFileMode(QtWidgets.QFileDialog.AnyFile) dialog.setAcceptMode(QtWidgets.QFileDialog.AcceptSave) dialog.setDefaultSuffix('.csv') if dialog.exec(): filename = dialog.selectedFiles()[0] shutil.copy2(source_filename, filename) log.info(f"Copied data from '{source_filename}' to '{filename}'.") def change_color(self, experiment): color = QtWidgets.QColorDialog.getColor( parent=self) if color.isValid(): pixelmap = QtGui.QPixmap(24, 24) pixelmap.fill(color) experiment.browser_item.setIcon(0, QtGui.QIcon(pixelmap)) for curve in experiment.curve_list: if curve: curve.wdg.set_color(curve, color=color) def open_file_externally(self, filename): """ Method to open the datafile using an external editor or viewer. Uses the default application to open a datafile of this filetype, but can be overridden by the child class in order to open the file in another application of choice. """ system = platform.system() if (system == 'Windows'): # The empty argument after the start is needed to be able to cope # correctly with filenames with spaces _ = subprocess.Popen(['start', '', filename], shell=True) elif (system == 'Linux'): _ = subprocess.Popen(['xdg-open', filename]) elif (system == 'Darwin'): _ = subprocess.Popen(['open', filename]) else: raise Exception("{cls} method open_file_externally does not support {system} OS".format( cls=type(self).__name__, system=system)) def reveal_in_file_explorer(self, filename: str) -> None: """Method to open the file explorer at the location of the given filename. Args: filename (str): Path to the file to be revealed in the file explorer. """ path = os.path.normpath(filename) system = platform.system() if system == "Windows": _ = subprocess.Popen(["explorer", "/select,", path], shell=True) elif system == "Linux": _ = subprocess.Popen(["xdg-open", os.path.dirname(path)]) elif system == "Darwin": _ = subprocess.Popen(["open", "-R", path]) else: raise Exception( "{cls} method reveal_in_file_explorer does not support {system} OS".format( cls=type(self).__name__, system=system ) ) def make_procedure(self): if not isinstance(self.inputs, InputsWidget): raise Exception("ManagedWindow can not make a Procedure" " without a InputsWidget type") return self.inputs.get_procedure() def new_curve(self, wdg, results, color=None, **kwargs): if color is None: color = pg.intColor(self.browser.topLevelItemCount() % 8) return wdg.new_curve(results, color=color, **kwargs) def new_experiment(self, results, curve=None): if curve is None: curve_list = [] for wdg in self.widget_list: new_curve = self.new_curve(wdg, results) if isinstance(new_curve, (tuple, list)): curve_list.extend(new_curve) else: curve_list.append(new_curve) else: curve_list = curve[:] curve_color = pg.intColor(0) for curve in curve_list: if hasattr(curve, 'color'): curve_color = curve.color break browser_item = BrowserItem(results, curve_color) return Experiment(results, curve_list, browser_item) def set_parameters(self, parameters): """ This method should be overwritten by the child class. The parameters argument is a dictionary of Parameter objects. The Parameters should overwrite the GUI values so that a user can click "Queue" to capture the same parameters. """ if not isinstance(self.inputs, InputsWidget): raise Exception("ManagedWindow can not set parameters" " without a InputsWidget") self.inputs.set_parameters(parameters) def _queue(self, checked): """ This method is a wrapper for the `self.queue` method to be connected to the `queue` button. It catches the positional argument that is passed when it is called by the button and calls the `self.queue` method without any arguments. """ self.queue() def queue(self, procedure=None): """ Queue a measurement based on the parameters in the input-widget. Semi-abstract method, which must be overridden by the child class if the filename- and directory-inputs are disabled. When filename- and directory inputs are enabled, overwriting is not required, but can be done for custom naming, input processing, or other features. Implementations must call ``self.manager.queue(experiment)`` and pass an ``experiment`` (:class:`~pymeasure.experiment.experiment.Experiment`) object which contains the :class:`~pymeasure.experiment.results.Results` and :class:`~pymeasure.experiment.procedure.Procedure` to be run. The optional `procedure` argument is not required for a basic implementation, but is required when the :class:`~pymeasure.display.widgets.sequencer_widget.SequencerWidget` is used. For example: .. code-block:: python def queue(self): filename = unique_filename('results', prefix="data") # from pymeasure.experiment procedure = self.make_procedure() # Procedure class was passed at construction results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) """ # Check if the filename and the directory inputs are available if not self.enable_file_input: raise NotImplementedError("Queue method must be overwritten if the filename- and " "directory-inputs are disabled.") if procedure is None: procedure = self.make_procedure() if self.store_measurement: try: filename = unique_filename( self.directory, prefix=self.file_input.filename_base, datetimeformat="", procedure=procedure, ext=self.file_input.filename_extension, ) except KeyError as E: if not E.args[0].startswith("The following placeholder-keys are not valid:"): raise E from None log.error(f"Invalid filename provided: {E.args[0]}") return else: filename = tempfile.mktemp(prefix='TempFile_', suffix='.csv') results = Results(procedure, filename) experiment = self.new_experiment(results) self.manager.queue(experiment) def abort(self): self.abort_button.setEnabled(False) self.abort_button.setText("Resume") self.abort_button.clicked.disconnect() self.abort_button.clicked.connect(self.resume) try: self.manager.abort() except: # noqa log.error('Failed to abort experiment', exc_info=True) self.abort_button.setText("Abort") self.abort_button.clicked.disconnect() self.abort_button.clicked.connect(self.abort) def resume(self): self.abort_button.setText("Abort") self.abort_button.clicked.disconnect() self.abort_button.clicked.connect(self.abort) if self.manager.experiments.has_next(): self.manager.resume() else: self.abort_button.setEnabled(False) def queued(self, experiment): self.abort_button.setEnabled(True) self.browser_widget.show_button.setEnabled(True) self.browser_widget.hide_button.setEnabled(True) self.browser_widget.clear_button.setEnabled(True) def running(self, experiment): self.browser_widget.clear_button.setEnabled(False) def abort_returned(self, experiment): if self.manager.experiments.has_next(): self.abort_button.setText("Resume") self.abort_button.setEnabled(True) else: self.browser_widget.clear_button.setEnabled(True) def finished(self, experiment): if not self.manager.experiments.has_next(): self.abort_button.setEnabled(False) self.browser_widget.clear_button.setEnabled(True) @property def directory(self): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") return self.file_input.directory @directory.setter def directory(self, value): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") self.file_input.directory = value @property def filename(self): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") return self.file_input.filename @filename.setter def filename(self, value): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") self.file_input.filename = value @property def store_measurement(self): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") return self.file_input.store_measurement @store_measurement.setter def store_measurement(self, value): if not self.enable_file_input: raise AttributeError("File-input widget not enabled (i.e., enable_file_input == False)") self.file_input.store_measurement = value class ManagedWindow(ManagedWindowBase): """ Display experiment output with an :class:`~pymeasure.display.widgets.plot_widget.PlotWidget` class. .. seealso:: Tutorial :ref:`tutorial-managedwindow` A tutorial and example on the basic configuration and usage of ManagedWindow. :param procedure_class: procedure class describing the experiment (see :class:`~pymeasure.experiment.procedure.Procedure`) :param x_axis: the initial data-column for the x-axis of the plot :param y_axis: the initial data-column for the y-axis of the plot :param linewidth: linewidth for the displayed curves, default is 1 :param log_fmt: formatting string for the log-widget :param log_datefmt: formatting string for the date in the log-widget :param \\**kwargs: optional keyword arguments that will be passed to :class:`~pymeasure.display.windows.managed_window.ManagedWindowBase` """ def __init__(self, procedure_class, x_axis=None, y_axis=None, linewidth=1, log_fmt=None, log_datefmt=None, **kwargs): self.x_axis = x_axis self.y_axis = y_axis self.log_widget = LogWidget("Experiment Log", fmt=log_fmt, datefmt=log_datefmt) self.plot_widget = PlotWidget("Results Graph", procedure_class.DATA_COLUMNS, self.x_axis, self.y_axis, linewidth=linewidth) self.plot_widget.setMinimumSize(100, 200) if "widget_list" not in kwargs: kwargs["widget_list"] = () kwargs["widget_list"] = kwargs["widget_list"] + (self.plot_widget, self.log_widget) super().__init__(procedure_class, **kwargs) # Setup measured_quantities once we know x_axis and y_axis self.browser_widget.browser.measured_quantities.update([self.x_axis, self.y_axis]) logging.getLogger().addHandler(self.log_widget.handler) # needs to be in Qt context? log.setLevel(self.log_level) log.info("ManagedWindow connected to logging") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/display/windows/plotter_window.py0000644000175100017510000000753515203313266024074 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import pyqtgraph as pg from ..curves import ResultsCurve from ..Qt import QtCore, QtWidgets from ..widgets import ( PlotWidget, ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class PlotterWindow(QtWidgets.QMainWindow): """ A window for plotting experiment results. Should not be instantiated directly, but only via the :class:`~pymeasure.display.plotter.Plotter` class. .. seealso:: Tutorial :ref:`tutorial-plotterwindow` A tutorial and example code for using the Plotter and PlotterWindow. .. attribute plot:: The `pyqtgraph.PlotItem`_ object for this window. Can be accessed to further customise the plot view programmatically, e.g., display log-log or semi-log axes by default, change axis range, etc. .. pyqtgraph.PlotItem: http://www.pyqtgraph.org/documentation/graphicsItems/plotitem.html """ def __init__(self, plotter, refresh_time=0.1, linewidth=1, parent=None): super().__init__(parent) self.plotter = plotter self.refresh_time = refresh_time columns = plotter.results.procedure.DATA_COLUMNS self.setWindowTitle('Results Plotter') self.main = QtWidgets.QWidget(self) vbox = QtWidgets.QVBoxLayout(self.main) vbox.setSpacing(0) hbox = QtWidgets.QHBoxLayout() hbox.setSpacing(6) hbox.setContentsMargins(-1, 6, -1, -1) file_label = QtWidgets.QLabel(self.main) file_label.setText('Data Filename:') self.file = QtWidgets.QLineEdit(self.main) self.file.setText(plotter.results.data_filename) hbox.addWidget(file_label) hbox.addWidget(self.file) vbox.addLayout(hbox) self.plot_widget = PlotWidget("Plotter", columns, refresh_time=self.refresh_time, check_status=False, linewidth=linewidth) self.plot = self.plot_widget.plot vbox.addWidget(self.plot_widget) self.main.setLayout(vbox) self.setCentralWidget(self.main) self.main.show() self.resize(800, 600) self.curve = ResultsCurve(plotter.results, columns[0], columns[1], pen=pg.mkPen(color=pg.intColor(0), width=linewidth), antialias=False) self.plot.addItem(self.curve) self.plot_widget.updated.connect(self.check_stop) def quit(self, evt=None): log.info("Quitting the Plotter") self.close() self.plotter.stop() def check_stop(self): """ Checks if the Plotter should stop and exits the Qt main loop if so """ if self.plotter.should_stop(): QtCore.QCoreApplication.instance().quit() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/errors.py0000644000175100017510000000241515203313266017161 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # class Error(Exception): pass class RangeError(Error): pass # TODO should be deprecated someday RangeException = RangeError ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.007173 pymeasure-0.16.0/pymeasure/experiment/0000755000175100017510000000000015203313301017437 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/__init__.py0000644000175100017510000000316015203313266021562 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .parameters import (Parameter, IntegerParameter, FloatParameter, VectorParameter, ListParameter, BooleanParameter, Measurable, Metadata) from .procedure import Procedure, UnknownProcedure from .results import Results, unique_filename, replace_placeholders from .workers import Worker from .listeners import Listener, Recorder from .config import get_config from .experiment import Experiment, get_array, get_array_steps, get_array_zero ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/config.py0000644000175100017510000000346715203313266021302 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import configparser import logging import os log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def set_file(filename): os.environ['CONFIG'] = filename def get_config(filename='default_config.ini'): if 'CONFIG' in os.environ.keys(): filename = os.environ['CONFIG'] config = configparser.ConfigParser() config.read(filename) return config # noinspection PyProtectedMember def set_mpl_rcparams(config): if 'matplotlib.rcParams' in config._sections.keys(): import matplotlib for key in config._sections['matplotlib.rcParams']: matplotlib.rcParams[key] = eval(config._sections['matplotlib.rcParams'][key]) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/experiment.py0000644000175100017510000001742515203313266022214 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import time import tempfile import gc import numpy as np from .results import unique_filename from .config import get_config, set_mpl_rcparams from pymeasure.log import setup_logging, console_log from pymeasure.experiment import Results, Worker log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: from IPython import display except ImportError: log.warning("IPython could not be imported") def get_array(start, stop, step): """Returns a numpy array from start to stop""" step = np.sign(stop - start) * abs(step) return np.arange(start, stop + step, step) def get_array_steps(start, stop, numsteps): """Returns a numpy array from start to stop in numsteps""" return get_array(start, stop, (abs(stop - start) / numsteps)) def get_array_zero(maxval, step): """Returns a numpy array from 0 to maxval to -maxval to 0""" return np.concatenate((np.arange(0, maxval, step), np.arange(maxval, -maxval, -step), np.arange(-maxval, 0, step))) def create_filename(title): """ Create a new filename according to the style defined in the config file. If no config is specified, create a temporary file. """ config = get_config() if 'Filename' in config._sections.keys(): filename = unique_filename(suffix='_%s' % title, **config._sections['Filename']) else: filename = tempfile.mktemp() return filename class Experiment: """ Class which starts logging and creates/runs the results and worker processes. .. code-block:: python procedure = Procedure() experiment = Experiment(title, procedure) experiment.start() experiment.plot_live('x', 'y', style='.-') for a multi-subplot graph: import pylab as pl ax1 = pl.subplot(121) experiment.plot('x','y',ax=ax1) ax2 = pl.subplot(122) experiment.plot('x','z',ax=ax2) experiment.plot_live() :var value: The value of the parameter :param title: The experiment title :param procedure: The procedure object :param analyse: Post-analysis function, which takes a pandas dataframe as input and returns it with added (analysed) columns. The analysed results are accessible via experiment.data, as opposed to experiment.results.data for the 'raw' data. :param _data_timeout: Time limit for how long live plotting should wait for datapoints. """ def __init__(self, title, procedure, analyse=(lambda x: x)): self.title = title self.procedure = procedure self.measlist = [] self.port = 5888 self.plots = [] self.figs = [] self._data = [] self.analyse = analyse self._data_timeout = 10 config = get_config() set_mpl_rcparams(config) if 'Logging' in config._sections.keys(): self.scribe = setup_logging(log, **config._sections['Logging']) else: self.scribe = console_log(log) self.scribe.start() self.filename = create_filename(self.title) log.info("Using data file: %s" % self.filename) self.results = Results(self.procedure, self.filename) log.info("Set up Results") self.worker = Worker(self.results, self.scribe.queue, logging.DEBUG) log.info("Create worker") def start(self): """Start the worker""" log.info("Starting worker...") self.worker.start() @property def data(self): """Data property which returns analysed data, if an analyse function is defined, otherwise returns the raw data.""" self._data = self.analyse(self.results.data.copy()) return self._data def wait_for_data(self): """Wait for the data attribute to fill with datapoints.""" t = time.time() while self.data.empty: time.sleep(.1) if (time.time() - t) > self._data_timeout: log.warning('Timeout, no data received for liveplot') return False return True def plot_live(self, *args, **kwargs): """Live plotting loop for jupyter notebook, which automatically updates (an) in-line matplotlib graph(s). Will create a new plot as specified by input arguments, or will update (an) existing plot(s).""" if self.wait_for_data(): if not (self.plots): self.plot(*args, **kwargs) while not self.worker.should_stop(): self.update_plot() display.clear_output(wait=True) if self.worker.is_alive(): self.worker.terminate() self.scribe.stop() def plot(self, *args, **kwargs): """Plot the results from the experiment.data pandas dataframe. Store the plots in a plots list attribute.""" if self.wait_for_data(): kwargs['title'] = self.title ax = self.data.plot(*args, **kwargs) self.plots.append({'type': 'plot', 'args': args, 'kwargs': kwargs, 'ax': ax}) if ax.get_figure() not in self.figs: self.figs.append(ax.get_figure()) self._user_interrupt = False def clear_plot(self): """Clear the figures and plot lists.""" for fig in self.figs: fig.clf() for pl in self.plots: pl.close() self.figs = [] self.plots = [] gc.collect() def update_plot(self): """Update the plots in the plots list with new data from the experiment.data pandas dataframe.""" try: self.data for plot in self.plots: ax = plot['ax'] if plot['type'] == 'plot': x, y = plot['args'][0], plot['args'][1] if isinstance(y, str): y = [y] for yname, line in zip(y, ax.lines): self.update_line(ax, line, x, yname) display.clear_output(wait=True) display.display(*self.figs) time.sleep(0.1) except KeyboardInterrupt: display.clear_output(wait=True) display.display(*self.figs) self._user_interrupt = True def update_line(self, ax, hl, xname, yname): """Update a line in a matplotlib graph with new data.""" del hl._xorig, hl._yorig hl.set_xdata(self._data[xname]) hl.set_ydata(self._data[yname]) ax.relim() ax.autoscale() gc.collect() def __del__(self): self.scribe.stop() if self.worker.is_alive(): self.worker.recorder_queue.put(None) self.worker.monitor_queue.put(None) self.worker.stop() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/listeners.py0000644000175100017510000001026515203313266022037 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from logging import StreamHandler, FileHandler from ..log import QueueListener from ..thread import StoppableThread log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: import zmq import cloudpickle except ImportError: zmq = None cloudpickle = None log.warning("ZMQ and cloudpickle are required for TCP communication") class Monitor(QueueListener): def __init__(self, results, queue): console = StreamHandler() console.setFormatter(results.formatter) super().__init__(queue, console) class Listener(StoppableThread): """Base class for Threads that need to listen for messages on a ZMQ TCP port and can be stopped by a thread-safe method call """ def __init__(self, port, topic='', timeout=0.01): """ Constructs the Listener object with a subscriber port over which to listen for messages :param port: TCP port to listen on :param topic: Topic to listen on :param timeout: Timeout in seconds to recheck stop flag """ super().__init__() self.port = port self.topic = topic self.context = zmq.Context() log.debug(f"{self.__class__.__name__} has ZMQ Context: {self.context!r}") self.subscriber = self.context.socket(zmq.SUB) self.subscriber.setsockopt(zmq.SUBSCRIBE, topic.encode()) self.subscriber.connect('tcp://localhost:%d' % port) log.info("%s connected to '%s' topic on tcp://localhost:%d" % ( self.__class__.__name__, topic, port)) self.poller = zmq.Poller() self.poller.register(self.subscriber, zmq.POLLIN) self.timeout = timeout def receive(self, flags=0): topic, record = self.subscriber.recv_serialized( deserialize=lambda msg: (msg[0].decode(), cloudpickle.loads(msg[1])), flags=flags ) return topic, record def message_waiting(self): """Check if we have a message, wait at most until timeout.""" return self.poller.poll(self.timeout * 1000) # poll timeout is in ms def __repr__(self): return "<{}(port={},topic={},should_stop={})>".format( self.__class__.__name__, self.port, self.topic, self.should_stop()) class Recorder(QueueListener): """ Recorder loads the initial Results for a filepath and appends data by listening for it over a queue. The queue ensures that no data is lost between the Recorder and Worker. """ def __init__(self, results, queue, **kwargs): """ Constructs a Recorder to record the Procedure data into the file path, by waiting for data on the subscription port """ handlers = [] for filename in results.data_filenames: fh = FileHandler(filename=filename, **kwargs) fh.setFormatter(results.formatter) fh.setLevel(logging.NOTSET) handlers.append(fh) super().__init__(queue, *handlers) def stop(self): for handler in self.handlers: handler.close() super().stop() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/parameters.py0000644000175100017510000005616015203313266022176 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import numpy as np class Parameter: """ Encapsulates the information for an experiment parameter with information about the name, and units if supplied. :var value: The value of the parameter :param name: The parameter name :param default: The default value :param ui_class: A Qt class to use for the UI of this parameter :param group_by: Defines the Parameter(s) that controls the visibility of the associated input; can be a string containing the Parameter name, a list of strings with multiple Parameter names, or a dict containing {"Parameter name": condition} pairs. :param group_condition: The condition for the group_by Parameter that controls the visibility of this parameter, provided as a value or a (lambda)function. If the group_by argument is provided as a list of strings, this argument can be either a single condition or a list of conditions. If the group_by argument is provided as a dict this argument is ignored. :description: A string providing a human-friendly description for the parameter. """ def __init__(self, name, default=None, ui_class=None, group_by=None, group_condition=True, description=None): self.name = name separator = ": " if separator in name: raise ValueError(f"The provided name argument '{name}' contains the " f"separator '{separator}'.") self._value = None if default is not None: self.value = default self.default = default self.ui_class = ui_class self._help_fields = [('units are', 'units'), 'default'] self.group_by = {} if isinstance(group_by, dict): self.group_by = group_by elif isinstance(group_by, str): self.group_by = {group_by: group_condition} elif isinstance(group_by, (list, tuple)) and all(isinstance(e, str) for e in group_by): if isinstance(group_condition, (list, tuple)): self.group_by = {g: c for g, c in zip(group_by, group_condition)} else: self.group_by = {g: group_condition for g in group_by} elif group_by is not None: raise TypeError("The provided group_by argument is not valid, should be either a " "string, a list of strings, or a dict with {string: condition} pairs.") if description is not None and not isinstance(description, str): raise TypeError("The provided description argument is not a string.") self.description = description @property def value(self): if self.is_set(): return self._value else: raise ValueError("Parameter value is not set") @value.setter def value(self, value): self._value = self.convert(value) @property def cli_args(self): """ helper for command line interface parsing of parameters This property returns a list of data to help formatting a command line interface interpreter, the list is composed of the following elements: - index 0: default value - index 1: List of value to format an help string, that is either, the name of the fields to be documented or a tuple with (helps_string, field) - index 2: type """ return (self.default, self._help_fields, self.convert) def is_set(self): """ Returns True if the Parameter value is set """ return self._value is not None def convert(self, value): """ Convert user input to python data format Subclasses are expected to customize this method. Default implementation is the identity function :param value: value to be converted :return: converted value """ return value def _cli_help_fields(self): message = f"{self.name}:\n" if (description := self.description) is not None: if not description.endswith("."): description += "." message += f"{description}\n" for field in self._help_fields: if isinstance(field, str): field = (f"{field} is", field) if (value := getattr(self, field[1], None)) is not None: prefix = field[0].capitalize() if isinstance(value, str): value = f'"{value}"' message += f"\n{prefix} {value}." return message def __str__(self): return str(self._value) if self.is_set() else '' def __repr__(self): return "<{}(name={},value={},default={})>".format( self.__class__.__name__, self.name, self._value, self.default) class IntegerParameter(Parameter): """ :class:`.Parameter` sub-class that uses the integer type to store the value. :var value: The integer value of the parameter :param name: The parameter name :param units: The units of measure for the parameter :param minimum: The minimum allowed value (default: -1e9) :param maximum: The maximum allowed value (default: 1e9) :param default: The default integer value :param ui_class: A Qt class to use for the UI of this parameter :param step: int step size for parameter's UI spinbox. If None, spinbox will have step disabled """ def __init__(self, name, units=None, minimum=-1e9, maximum=1e9, step=None, **kwargs): self.units = units self.minimum = int(minimum) self.maximum = int(maximum) super().__init__(name, **kwargs) self.step = int(step) if step else None self._help_fields.append('minimum') self._help_fields.append('maximum') def convert(self, value): if isinstance(value, str): value, _, units = value.strip().partition(" ") if units != "" and units != self.units: raise ValueError("Units included in string (%s) do not match" "the units of the IntegerParameter (%s)" % (units, self.units)) try: value = int(value) except ValueError: raise ValueError("IntegerParameter given non-integer value of " "type '%s'" % type(value)) if value < self.minimum: raise ValueError("IntegerParameter value is below the minimum") elif value > self.maximum: raise ValueError("IntegerParameter value is above the maximum") return value def __str__(self): if not self.is_set(): return '' result = "%d" % self._value if self.units: result += " %s" % self.units return result def __repr__(self): return "<{}(name={},value={},units={},default={})>".format( self.__class__.__name__, self.name, self._value, self.units, self.default) class BooleanParameter(Parameter): """ :class:`.Parameter` sub-class that uses the boolean type to store the value. :var value: The boolean value of the parameter :param name: The parameter name :param default: The default boolean value :param ui_class: A Qt class to use for the UI of this parameter """ def convert(self, value): if isinstance(value, str): if value.lower() == "true": value = True elif value.lower() == "false": value = False else: raise ValueError("BooleanParameter given string value of '%s'" % value) elif isinstance(value, (int, float)) and value in [0, 1]: value = bool(value) elif isinstance(value, bool): value = value elif isinstance(value, np.bool_): value = bool(value) else: raise ValueError("BooleanParameter given non-boolean value of " "type '%s'" % type(value)) return value class FloatParameter(Parameter): """ :class:`.Parameter` sub-class that uses the floating point type to store the value. :var value: The floating point value of the parameter :param name: The parameter name :param units: The units of measure for the parameter :param minimum: The minimum allowed value (default: -1e9) :param maximum: The maximum allowed value (default: 1e9) :param decimals: The number of decimals considered (default: 15) :param default: The default floating point value :param ui_class: A Qt class to use for the UI of this parameter :param step: step size for parameter's UI spinbox. If None, spinbox will have step disabled """ def __init__(self, name, units=None, minimum=-1e9, maximum=1e9, decimals=15, step=None, **kwargs): self.units = units self.minimum = minimum self.maximum = maximum super().__init__(name, **kwargs) self.decimals = decimals self.step = step self._help_fields.append(('decimals are', 'decimals')) def convert(self, value): if isinstance(value, str): value, _, units = value.strip().partition(" ") if units != "" and units != self.units: raise ValueError("Units included in string (%s) do not match" "the units of the FloatParameter (%s)" % (units, self.units)) try: value = float(value) except ValueError: raise ValueError("FloatParameter given non-float value of " "type '%s'" % type(value)) if value < self.minimum: raise ValueError("FloatParameter value is below the minimum") elif value > self.maximum: raise ValueError("FloatParameter value is above the maximum") return value def __str__(self): if not self.is_set(): return '' result = "%g" % self._value if self.units: result += " %s" % self.units return result def __repr__(self): return "<{}(name={},value={},units={},default={})>".format( self.__class__.__name__, self.name, self._value, self.units, self.default) class VectorParameter(Parameter): """ :class:`.Parameter` sub-class that stores the value in a vector format. :var value: The value of the parameter as a list of floating point numbers :param name: The parameter name :param length: The integer dimensions of the vector :param units: The units of measure for the parameter :param default: The default value :param ui_class: A Qt class to use for the UI of this parameter """ def __init__(self, name, length=3, units=None, **kwargs): self._length = length self.units = units super().__init__(name, **kwargs) self._help_fields.append(('length is', '_length')) def convert(self, value): if isinstance(value, str): # strip units if included if self.units is not None and value.endswith(" " + self.units): value = value[:-len(self.units)].strip() # Strip initial and final brackets if (value[0] != '[') or (value[-1] != ']'): raise ValueError("VectorParameter must be passed a vector" " denoted by square brackets if initializing" " by string.") raw_list = value[1:-1].split(",") elif isinstance(value, (list, tuple, np.ndarray)): raw_list = value else: raise ValueError("VectorParameter given undesired value of " "type '%s'" % type(value)) if len(raw_list) != self._length: raise ValueError("VectorParameter given value of length " "%d instead of %d" % (len(raw_list), self._length)) try: value = [float(ve) for ve in raw_list] except ValueError: raise ValueError("VectorParameter given input '%s' that could " "not be converted to floats." % str(value)) return value def __str__(self): """If we eliminate spaces within the list __repr__ then the csv parser will interpret it as a single value.""" if not self.is_set(): return '' result = "".join(repr(self.value).split()) if self.units: result += " %s" % self.units return result def __repr__(self): return "<{}(name={},value={},units={},length={})>".format( self.__class__.__name__, self.name, self._value, self.units, self._length) class ListParameter(Parameter): """ :class:`.Parameter` sub-class that stores the value as a list. String representation of choices must be unique. :param name: The parameter name :param choices: An explicit list of choices, which is disregarded if None :param units: The units of measure for the parameter :param default: The default value :param ui_class: A Qt class to use for the UI of this parameter """ def __init__(self, name, choices=None, units=None, **kwargs): self.units = units if choices is not None: keys = [str(c) for c in choices] # check that string representation is unique if not len(keys) == len(set(keys)): raise ValueError( "String representation of choices is not unique!") self._choices = {k: c for k, c in zip(keys, choices)} else: self._choices = None super().__init__(name, **kwargs) self._help_fields.append(('choices are', 'choices')) def convert(self, value): if self._choices is None: raise ValueError("ListParameter cannot be set since " "allowed choices are set to None.") # strip units if included if isinstance(value, str): if self.units is not None and value.endswith(" " + self.units): value = value[:-len(self.units)].strip() if str(value) in self._choices.keys(): value = self._choices[str(value)] else: raise ValueError("Invalid choice for parameter. " "Must be one of %s" % str(self._choices)) return value @property def choices(self): """ Returns an immutable iterable of choices, or None if not set. """ return tuple(self._choices.values()) class PhysicalParameter(VectorParameter): """ :class:`.VectorParameter` sub-class of 2 dimensions to store a value and its uncertainty. :var value: The value of the parameter as a list of 2 floating point numbers :param name: The parameter name :param uncertainty_type: Type of uncertainty, 'absolute', 'relative' or 'percentage' :param units: The units of measure for the parameter :param default: The default value :param ui_class: A Qt class to use for the UI of this parameter """ def __init__(self, name, uncertaintyType='absolute', **kwargs): super().__init__(name, length=2, **kwargs) self._utype = ListParameter("uncertainty type", choices=['absolute', 'relative', 'percentage'], default=None) self._utype.value = uncertaintyType def convert(self, value): if isinstance(value, str): # strip units if included if self.units is not None and value.endswith(" " + self.units): value = value[:-len(self.units)].strip() # Strip initial and final brackets if (value[0] != '[') or (value[-1] != ']'): raise ValueError("VectorParameter must be passed a vector" " denoted by square brackets if initializing" " by string.") raw_list = value[1:-1].split(",") elif isinstance(value, (list, tuple)): raw_list = value else: raise ValueError("VectorParameter given undesired value of " "type '%s'" % type(value)) if len(raw_list) != self._length: raise ValueError("VectorParameter given value of length " "%d instead of %d" % (len(raw_list), self._length)) try: value = [float(ve) for ve in raw_list] except ValueError: raise ValueError("VectorParameter given input '%s' that could " "not be converted to floats." % str(value)) # Uncertainty must be non-negative value[1] = abs(value[1]) return value @property def uncertainty_type(self): return self._utype.value @uncertainty_type.setter def uncertainty_type(self, uncertaintyType): oldType = self._utype.value self._utype.value = uncertaintyType newType = self._utype.value if self.is_set(): # Convert uncertainty value to the new type if (oldType, newType) == ('absolute', 'relative'): self._value[1] = abs(self._value[1] / self._value[0]) if (oldType, newType) == ('relative', 'absolute'): self._value[1] = abs(self._value[1] * self._value[0]) if (oldType, newType) == ('relative', 'percentage'): self._value[1] = abs(self._value[1] * 100.0) if (oldType, newType) == ('percentage', 'relative'): self._value[1] = abs(self._value[1] * 0.01) if (oldType, newType) == ('percentage', 'absolute'): self._value[1] = abs(self._value[1] * self._value[0] * 0.01) if (oldType, newType) == ('absolute', 'percentage'): self._value[1] = abs(self._value[1] * 100.0 / self._value[0]) def __str__(self): if not self.is_set(): return '' result = f"{self._value[0]:g} +/- {self._value[1]:g}" if self.units: result += " %s" % self.units if self._utype.value is not None: result += " (%s)" % self._utype.value return result def __repr__(self): return "<{}(name={},value={},units={},uncertaintyType={})>".format( self.__class__.__name__, self.name, self._value, self.units, self._utype.value) class Measurable: """ Encapsulates the information for a measurable experiment parameter with information about the name, fget function and units if supplied. The value property is called when the procedure retrieves a datapoint and calls the fget function. If no fget function is specified, the value property will return the latest set value of the parameter (or default if never set). :var value: The value of the parameter :param name: The parameter name :param fget: The parameter fget function (e.g. an instrument parameter) :param default: The default value """ DATA_COLUMNS = [] def __init__(self, name, fget=None, units=None, measure=True, default=None, **kwargs): self.name = name self.units = units self.measure = measure if fget is not None: self.fget = fget self._value = fget() else: self._value = default Measurable.DATA_COLUMNS.append(name) def fget(self): return self._value @property def value(self): if hasattr(self, 'fget'): self._value = self.fget() return self._value @value.setter def value(self, value): self._value = value class Metadata(object): """ Encapsulates the information for metadata of the experiment with information about the name, the fget function and the units, if supplied. If no fget function is specified, the value property will return the latest set value of the parameter (or default if never set). :var value: The value of the parameter. This returns (if a value is set) the value obtained from the `fget` (after evaluation) or a manually set value. Returns `None` if no value has been set :param name: The parameter name :param fget: The parameter fget function; can be provided as a callable, or as a string, in which case it is assumed to be the name of a method or attribute of the `Procedure` class in which the Metadata is defined. Passing a string also allows for nested attributes by separating them with a period (e.g. to access an attribute or method of an instrument) where only the last attribute can be a method. :param units: The parameter units :param default: The default value, in case no value is assigned or if no fget method is provided :param fmt: A string used to format the value upon writing it to a file. Default is "%s" """ def __init__(self, name, fget=None, units=None, default=None, fmt="%s"): self.name = name self.units = units self._value = default self.fget = fget self.fmt = fmt self.evaluated = False @property def value(self): if self.is_set(): return self._value else: raise ValueError("Metadata value is not set") def is_set(self): """ Returns True if the Parameter value is set """ return self._value is not None def evaluate(self, parent=None, new_value=None): if new_value is not None and self.fget is not None: raise ValueError("Metadata with a defined fget method" " cannot be manually assigned a value") elif new_value is not None: self._value = new_value elif self.fget is not None: self._value = self.eval_fget(parent) self.evaluated = True return self.value def eval_fget(self, parent): fget = self.fget if isinstance(fget, str): obj = parent for obj_name in fget.split('.'): obj = getattr(obj, obj_name) fget = obj if callable(fget): return fget() else: return fget def __str__(self): result = self.fmt % self.value if self.units is not None: result += " %s" % self.units return result ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/procedure.py0000644000175100017510000003266115203313266022023 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import sys import inspect from copy import deepcopy import importlib.util import re from pint import UndefinedUnitError from .parameters import Parameter, Measurable, Metadata from pymeasure.units import ureg log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Procedure: """Provides the base class of a procedure to organize the experiment execution. Procedures should be run by Workers to ensure that asynchronous execution is properly managed. .. code-block:: python procedure = Procedure() results = Results(procedure, data_filename) worker = Worker(results, port) worker.start() Inheriting classes should define the startup, execute, and shutdown methods as needed. The shutdown method is called even with a software exception or abort event during the execute method. If keyword arguments are provided, they are added to the object as attributes. """ DATA_COLUMNS = [] MEASURE = {} FINISHED, FAILED, ABORTED, QUEUED, RUNNING = 0, 1, 2, 3, 4 STATUS_STRINGS = { FINISHED: 'Finished', FAILED: 'Failed', ABORTED: 'Aborted', QUEUED: 'Queued', RUNNING: 'Running' } _parameters = {} def __init__(self, **kwargs): self.status = Procedure.QUEUED self._update_parameters() self._update_metadata() for key in kwargs: if key in self._parameters.keys(): setattr(self, key, kwargs[key]) log.info(f'Setting parameter {key} to {kwargs[key]}') self.gen_measurement() @staticmethod def parse_columns(columns): """Get columns with any units in parentheses. For each column, if there are matching parentheses containing text with no spaces, parse the value between the parentheses as a Pint unit. For example, "Source Voltage (V)" will be parsed and matched to :code:`Unit('volt')`. Raises an error if a parsed value is undefined in Pint unit registry. Return a dictionary of matched columns with their units. :param columns: List of columns to be parsed. :type record: dict :return: Dictionary of columns with Pint units. """ units_pattern = r"\((?P[\w/\(\)\*\t]+)\)" units = {} for column in columns: match = re.search(units_pattern, column) if match: try: units[column] = ureg.Quantity(match.groupdict()['units']).units except UndefinedUnitError: raise ValueError( f"Column \"{column}\" with unit \"{match.groupdict()['units']}\"" " is not defined in Pint registry. Check procedure " "DATA_COLUMNS contains valid Pint units.") return units def gen_measurement(self): """Create MEASURE and DATA_COLUMNS variables for get_datapoint method.""" # TODO: Refactor measurable-s implementation to be consistent with parameters self.MEASURE = {} for item, parameter in inspect.getmembers(self.__class__): if isinstance(parameter, Measurable): if parameter.measure: self.MEASURE.update({parameter.name: item}) if not self.DATA_COLUMNS: self.DATA_COLUMNS = Measurable.DATA_COLUMNS # Validate DATA_COLUMNS fit pymeasure column header format self.parse_columns(self.DATA_COLUMNS) def get_datapoint(self): data = {key: getattr(self, self.MEASURE[key]).value for key in self.MEASURE} return data def measure(self): data = self.get_datapoint() log.debug("Produced numbers: %s" % data) self.emit('results', data) def _update_parameters(self): """ Collects all the Parameter objects for the procedure and stores them in a meta dictionary so that the actual values can be set in their stead """ if not self._parameters: self._parameters = {} for item, parameter in inspect.getmembers(self.__class__): if isinstance(parameter, Parameter): self._parameters[item] = deepcopy(parameter) if parameter.is_set(): setattr(self, item, parameter.value) else: setattr(self, item, None) def parameters_are_set(self): """ Returns True if all parameters are set """ for name, parameter in self._parameters.items(): if getattr(self, name) is None: return False return True def check_parameters(self): """ Raises an exception if any parameter is missing before calling the associated function. Ensures that each value can be set and got, which should cast it into the right format. Used as a decorator @check_parameters on the startup method """ for name, parameter in self._parameters.items(): value = getattr(self, name) if value is None: raise NameError("Missing {} '{}' in {}".format( parameter.__class__, name, self.__class__)) def parameter_values(self): """ Returns a dictionary of all the Parameter values and grabs any current values that are not in the default definitions """ result = {} for name, parameter in self._parameters.items(): value = getattr(self, name) if value is not None: parameter.value = value setattr(self, name, parameter.value) result[name] = parameter.value else: result[name] = None return result def parameter_objects(self): """ Returns a dictionary of all the Parameter objects and grabs any current values that are not in the default definitions """ result = {} for name, parameter in self._parameters.items(): value = getattr(self, name) if value is not None: parameter.value = value setattr(self, name, parameter.value) result[name] = parameter return result def refresh_parameters(self): """ Enforces that all the parameters are re-cast and updated in the meta dictionary """ for name, parameter in self._parameters.items(): value = getattr(self, name) parameter.value = value setattr(self, name, parameter.value) def set_parameters(self, parameters, except_missing=True): """ Sets a dictionary of parameters and raises an exception if additional parameters are present if except_missing is True """ for name, value in parameters.items(): if name in self._parameters: self._parameters[name].value = value setattr(self, name, self._parameters[name].value) else: if except_missing: raise NameError("Parameter '{}' does not belong to '{}'".format( name, repr(self))) def _update_metadata(self): """ Collects all the Metadata objects for the procedure and stores them in a meta dictionary so that the actual values can be set and used in their stead """ self._metadata = {} for item, metadata in inspect.getmembers(self.__class__): if isinstance(metadata, Metadata): self._metadata[item] = deepcopy(metadata) if metadata.is_set(): setattr(self, item, metadata.value) else: setattr(self, item, None) def evaluate_metadata(self): """ Evaluates all Metadata objects, fixing their values to the current value """ for item, metadata in self._metadata.items(): # Evaluate the metadata, fixing its value value = metadata.evaluate(parent=self, new_value=getattr(self, item)) # Make the value of the metadata easily accessible setattr(self, item, value) def metadata_objects(self): """ Returns a dictionary of all the Metadata objects """ return self._metadata def placeholder_objects(self): """ Collect all eligible placeholders (parameters & metadata) with their value in a dict. """ return {**self.parameter_objects(), **self.metadata_objects()} @classmethod def placeholder_names(cls): """ Collect the names of all eligible placeholders (parameters & metadata)""" placeholders = [] for _, item in inspect.getmembers(cls): if isinstance(item, Metadata) or isinstance(item, Parameter): placeholders.append(item.name) return list(set(placeholders)) def startup(self): """ Executes the commands needed at the start-up of the measurement """ pass def execute(self): """ Preforms the commands needed for the measurement itself. During execution the shutdown method will always be run following this method. This includes when Exceptions are raised. """ pass def shutdown(self): """ Executes the commands necessary to shut down the instruments and leave them in a safe state. This method is always run at the end. """ pass def emit(self, topic, record): raise NotImplementedError('should be monkey patched by a worker') def should_stop(self): raise NotImplementedError('should be monkey patched by a worker') def is_last(self) -> bool: """Check if the procedure is the last one in the queue. This method must be monkey patched by a worker to provide functionality. Returns: bool: True if the procedure is the last one in the queue, False otherwise. """ raise NotImplementedError("should be monkey patched by a worker") def get_estimates(self): """ Function that returns estimates that are to be displayed by the EstimatorWidget. Must be reimplemented by subclasses. Should return an int or float representing the duration in seconds, or a list with a tuple for each estimate. The tuple should consists of two strings: the first will be used as the label of the estimate, the second as the displayed estimate. """ raise NotImplementedError('Must be reimplemented by subclasses') def __str__(self): result = repr(self) + "\n" for parameter in self._parameters.items(): result += str(parameter) return result def __repr__(self): return "<{}(status={},parameters_are_set={})>".format( self.__class__.__name__, self.STATUS_STRINGS[self.status], self.parameters_are_set() ) class UnknownProcedure(Procedure): """ Handles the case when a :class:`.Procedure` object can not be imported during loading in the :class:`.Results` class """ def __init__(self, parameters): super().__init__() self._parameters = parameters def startup(self): raise NotImplementedError("UnknownProcedure can not be run") class ProcedureWrapper: def __init__(self, procedure): self.procedure = procedure def __getstate__(self): # Get all information needed to reconstruct procedure self._parameters = self.procedure.parameter_values() self._class = self.procedure.__class__.__name__ module = sys.modules[self.procedure.__module__] self._package = module.__package__ self._module = module.__name__ self._file = module.__file__ state = self.__dict__.copy() del state['procedure'] return state def __setstate__(self, state): self.__dict__.update(state) # Restore the procedure spec = importlib.util.spec_from_file_location(self._module, self._file) module = importlib.util.module_from_spec(spec) sys.modules[self._module] = module spec.loader.exec_module(module) cls = getattr(module, self._class) self.procedure = cls() self.procedure.set_parameters(self._parameters) self.procedure.refresh_parameters() del self._parameters del self._class del self._package del self._module del self._file ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/results.py0000644000175100017510000004610215203313266021527 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from decimal import Decimal import logging import os import re import sys from importlib import import_module import importlib.util from datetime import datetime from string import Formatter import pandas as pd import pint from .procedure import Procedure, UnknownProcedure from pymeasure.units import ureg log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def replace_placeholders(string, procedure, date_format="%Y-%m-%d", time_format="%H:%M:%S"): """Replace placeholders in string with values from procedure parameters. Replaces the placeholders in the provided string with the values of the associated parameters, as provided by the procedure. This uses the standard python string.format syntax. Apart from the parameter in the procedure (which should be called by their full names) "date" and "time" are also added as optional placeholders. :param string: The string in which the placeholders are to be replaced. Python string.format syntax is used, e.g. "{Parameter Name}" to insert a FloatParameter called "Parameter Name", or "{Parameter Name:.2f}" to also specifically format the parameter. :param procedure: The procedure from which to get the parameter values. :param date_format: A string to represent how the additional placeholder "date" will be formatted. :param time_format: A string to represent how the additional placeholder "time" will be formatted. """ now = datetime.now() parameters = procedure.placeholder_objects() placeholders = {param.name: param.value for param in parameters.values()} placeholders["date"] = now.strftime(date_format) placeholders["time"] = now.strftime(time_format) # Check keys against available parameters invalid_keys = [i[1] for i in Formatter().parse(string) if i[1] is not None and i[1] not in placeholders] if invalid_keys: raise KeyError("The following placeholder-keys are not valid: '%s'; " "valid keys are: '%s'." % ( "', '".join(invalid_keys), "', '".join(placeholders.keys()) )) return string.format(**placeholders) def unique_filename(directory, prefix='DATA', suffix='', ext='csv', dated_folder=False, index=True, datetimeformat="%Y-%m-%d", procedure=None): """ Returns a unique filename based on the directory and prefix """ now = datetime.now() directory = os.path.abspath(directory) if procedure is not None: prefix = replace_placeholders(prefix, procedure) suffix = replace_placeholders(suffix, procedure) if dated_folder: directory = os.path.join(directory, now.strftime('%Y-%m-%d')) if not os.path.exists(directory): os.makedirs(directory) if index: i = 1 basename = f"{prefix}{now.strftime(datetimeformat)}" basepath = os.path.join(directory, basename) filename = "%s_%d%s.%s" % (basepath, i, suffix, ext) while os.path.exists(filename): i += 1 filename = "%s_%d%s.%s" % (basepath, i, suffix, ext) else: basename = f"{prefix}{now.strftime(datetimeformat)}{suffix}.{ext}" filename = os.path.join(directory, basename) return filename class CSVFormatter(logging.Formatter): """ Formatter of data results """ def __init__(self, columns, delimiter=','): """Creates a csv formatter for a given list of columns (=header). :param columns: list of column names. :type columns: list :param delimiter: delimiter between columns. :type delimiter: str """ super().__init__() self.columns = columns self.units = Procedure.parse_columns(columns) self.delimiter = delimiter def format(self, record): """Formats a record as csv. :param record: record to format. :type record: dict :return: a string """ line = [] for x in self.columns: value = record.get(x, float("nan")) if isinstance(value, (float, int, Decimal)) and type(value) is not bool: line.append(f"{value}") else: units = self.units.get(x, None) if units is not None: if isinstance(value, str): try: value = ureg.Quantity(value) except pint.UndefinedUnitError: log.warning( f"Value {value} for column {x} cannot be parsed to" f" unit {units}.") if isinstance(value, pint.Quantity): try: line.append(f"{value.m_as(units)}") except pint.DimensionalityError: line.append("nan") log.warning( f"Value {value} for column {x} does not have the " f"right unit {units}.") elif isinstance(value, bool): line.append("nan") log.warning( f"Boolean for column {x} does not have unit {units}.") else: line.append("nan") log.warning( f"Value {value} for column {x} does not have the right" f" type for unit {units}.") else: if isinstance(value, pint.Quantity): if value.units == ureg.dimensionless: line.append(f"{value.magnitude}") else: self.units[x] = value.to_base_units().units line.append(f"{value.m_as(self.units[x])}") log.info(f"Column {x} units was set to {self.units[x]}") else: line.append(f"{value}") return self.delimiter.join(line) def format_header(self): return self.delimiter.join(self.columns) class Results: """ The Results class provides a convenient interface to reading and writing data in connection with a :class:`.Procedure` object. :cvar COMMENT: The character used to identify a comment (default: #) :cvar DELIMITER: The character used to delimit the data (default: ,) :cvar LINE_BREAK: The character used for line breaks (default \\n) :cvar CHUNK_SIZE: The length of the data chuck that is read :param procedure: Procedure object :param data_filename: The data filename where the data is or should be stored """ COMMENT = '#' DELIMITER = ',' LINE_BREAK = "\n" CHUNK_SIZE = 1000 ENCODING = "utf-8" def __init__(self, procedure, data_filename): if not isinstance(procedure, Procedure): raise ValueError("Results require a Procedure object") self.procedure = procedure self.procedure_class = procedure.__class__ self.parameters = procedure.parameter_objects() self._header_count = -1 self._metadata_count = -1 self._last_file_size = 0 self.formatter = CSVFormatter(columns=self.procedure.DATA_COLUMNS) if isinstance(data_filename, (list, tuple)): data_filenames, data_filename = data_filename, data_filename[0] else: data_filenames = [data_filename] self.data_filename = data_filename self.data_filenames = data_filenames if os.path.exists(data_filename): # Assume header is already written self.reload() self.procedure.status = Procedure.FINISHED # TODO: Correctly store and retrieve status else: for filename in self.data_filenames: with open(filename, 'w', encoding=Results.ENCODING) as f: f.write(self.header()) f.write(self.labels()) self._data = None def __getstate__(self): # Get all information needed to reconstruct procedure self._parameters = self.procedure.parameter_values() self._class = self.procedure.__class__.__name__ module = sys.modules[self.procedure.__module__] self._package = module.__package__ self._module = module.__name__ self._file = module.__file__ state = self.__dict__.copy() del state['procedure'] del state['procedure_class'] return state def __setstate__(self, state): self.__dict__.update(state) # Restore the procedure spec = importlib.util.spec_from_file_location(self._module, self._file) module = importlib.util.module_from_spec(spec) sys.modules[self._module] = module spec.loader.exec_module(module) cls = getattr(module, self._class) self.procedure = cls() self.procedure.set_parameters(self._parameters) self.procedure.refresh_parameters() self.procedure_class = cls del self._parameters del self._class del self._package del self._module del self._file def header(self): """ Returns a text header to accompany a datafile so that the procedure can be reconstructed """ h = [] procedure = re.search("'(?P[^']+)'", repr(self.procedure_class)).group("name") h.append("Procedure: <%s>" % procedure) h.append("Parameters:") for name, parameter in self.parameters.items(): h.append("\t{}: {}".format(parameter.name, str( parameter).encode("unicode_escape").decode("utf-8"))) h.append("Data:") self._header_count = len(h) h = [Results.COMMENT + line for line in h] # Comment each line return Results.LINE_BREAK.join(h) + Results.LINE_BREAK def labels(self): """ Returns the columns labels as a string to be written to the file """ return self.formatter.format_header() + Results.LINE_BREAK def format(self, data): """ Returns a formatted string containing the data to be written to a file """ return self.formatter.format(data) def parse(self, line): """ Returns a dictionary containing the data from the line """ data = {} items = line.split(Results.DELIMITER) for i, key in enumerate(self.procedure.DATA_COLUMNS): data[key] = items[i] return data def metadata(self): """ Returns a text header for the metadata to write into the datafile """ if not self.procedure.metadata_objects(): return m = ["Metadata:"] for _, metadata in self.procedure.metadata_objects().items(): value = str(metadata).encode("unicode_escape").decode("utf-8") m.append(f"\t{metadata.name}: {value}") self._metadata_count = len(m) m = [Results.COMMENT + line for line in m] # Comment each line return Results.LINE_BREAK.join(m) + Results.LINE_BREAK def store_metadata(self): """ Inserts the metadata header (if any) into the datafile """ c_header = self.metadata() if c_header is None: return for filename in self.data_filenames: with open(filename, 'r+', encoding=Results.ENCODING) as f: contents = f.readlines() contents.insert(self._header_count - 1, c_header) f.seek(0) f.writelines(contents) self._header_count += self._metadata_count @staticmethod def parse_header(header, procedure_class=None): """ Returns a Procedure object with the parameters as defined in the header text. """ if procedure_class is not None: procedure = procedure_class() else: procedure = None header = header.split(Results.LINE_BREAK) procedure_module = None parameters = {} for line in header: if line.startswith(Results.COMMENT): line = line[1:] # Uncomment else: raise ValueError("Parsing a header which contains " "uncommented sections") if line.startswith("Procedure"): regex = r"<(?:(?P[^>]+)\.)?(?P[^.>]+)>" search = re.search(regex, line) procedure_module = search.group("module") procedure_class = search.group("class") elif line.startswith("\t"): separator = ": " partitioned_line = line[1:].partition(separator) if partitioned_line[1] != separator: raise Exception("Error partitioning header line %s." % line) else: parameters[partitioned_line[0]] = partitioned_line[2] if procedure is None: if procedure_class is None: raise ValueError("Header does not contain the Procedure class") try: procedure_module = import_module(procedure_module) procedure_class = getattr(procedure_module, procedure_class) procedure = procedure_class() except ImportError: procedure = UnknownProcedure(parameters) log.warning("Unknown Procedure being used") # Fill the procedure with the parameters found for name, parameter in procedure.parameter_objects().items(): if parameter.name in parameters: value = parameters[parameter.name] setattr(procedure, name, value) else: log.warning( f"Parameter \"{parameter.name}\" not found when loading " + f"'{procedure_class}', setting default value") setattr(procedure, name, parameter.default) procedure.refresh_parameters() # Enforce update of meta data # Fill the procedure with the metadata found for name, metadata in procedure.metadata_objects().items(): if metadata.name in parameters: value = parameters[metadata.name] setattr(procedure, name, value) # Set the value in the metadata metadata._value = value metadata.evaluated = True return procedure @staticmethod def load(data_filename, procedure_class=None): """ Returns a Results object with the associated Procedure object and data """ header = "" header_read = False header_count = 0 with open(data_filename, "r", encoding=Results.ENCODING) as f: while not header_read: line = f.readline() if line.startswith(Results.COMMENT): header += line.strip('\t\v\n\r\f') + Results.LINE_BREAK header_count += 1 else: header_read = True procedure = Results.parse_header(header[:-1], procedure_class) results = Results(procedure, data_filename) results._header_count = header_count return results @property def data(self): # Need to update header count for correct referencing if self._header_count == -1: self._header_count = len( self.header()[-1].split(Results.LINE_BREAK)) if self._data is None or len(self._data) == 0: # Data has not been read try: self.reload() except Exception: # Empty dataframe self._data = pd.DataFrame(columns=self.procedure.DATA_COLUMNS) else: # Concatenate additional data, if any, to already loaded data # Get current filesize, if same as _last_file_size, return data try: current_size = os.path.getsize(self.data_filename) except OSError: return self._data if current_size == self._last_file_size: return self._data skiprows = len(self._data) + self._header_count chunks = pd.read_csv( self.data_filename, comment=Results.COMMENT, header=0, names=self._data.columns, chunksize=Results.CHUNK_SIZE, skiprows=skiprows, iterator=True, encoding=Results.ENCODING, ) try: tmp_frame = pd.concat(chunks, ignore_index=True, sort=False) # only append new data if there is any # if no new data, tmp_frame dtype is object, which override's # self._data's original dtype - this can cause problems plotting # (e.g. if trying to plot int data on a log axis) if len(tmp_frame) > 0: self._data = pd.concat([self._data, tmp_frame], ignore_index=True, sort=False) except Exception: pass # All data is up to date # Update _last_file_size self._last_file_size = current_size return self._data def reload(self): """ Preforms a full reloading of the file data, neglecting any changes in the comments """ chunks = pd.read_csv( self.data_filename, comment=Results.COMMENT, chunksize=Results.CHUNK_SIZE, iterator=True, encoding=Results.ENCODING, ) try: self._data = pd.concat(chunks, ignore_index=True, sort=False) except Exception: self._data = chunks.read() def __repr__(self): return "<{}(filename='{}',procedure={},shape={})>".format( self.__class__.__name__, self.data_filename, self.procedure.__class__.__name__, self.data.shape ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/sequencer.py0000644000175100017510000003505015203313266022020 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import re from itertools import product import numpy as np log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class SequenceEvaluationError(Exception): """Raised when the evaluation of a sequence string goes wrong.""" pass class SequenceItem(object): """ Class representing a sequence row """ column_map = { 0: "level", 1: "parameter", 2: "expression", } def __init__(self, level, parameter, expression, parent): self.level = level self.parameter = parameter self.expression = expression self.parent = parent def __getitem__(self, idx): if idx in self.column_map: return getattr(self, self.column_map[idx]) else: return super().__getitem__(idx) def __setitem__(self, idx, value): if idx in self.column_map: return setattr(self, self.column_map[idx], value) else: return super().__setitem__(idx, value) def __str__(self): return "{} \"{}\", \"{}\"".format("-" * (self.level + 1), self.parameter, self.expression) class SequenceHandler: """ It represents a sequence, that is a tree of parameter sweep. A sequence can be loaded from a file or created programmatically with :meth:`~.add_node` and :meth:`~.remove_node` The internal representation is a nodes tree with each node composed of 3 elements: - Level: that is the distance from the root node - Parameter: A string that is the parameter name - Expression: A python expression which describes the list of values to be assumed by the Parameter. The syntax of the file is as follow: :: - "Parameter1", "(1,2,3)" -- "Parameter2", "(4,5,6)" --- "Parameter3", "(6,7,8)" - "Parameter4", "range(1,3)" In this case, the tree is composed of a root node with two children (Parameter1 and Parameter4) Parameter2 is the only child of Parameter1 and Parameter3 is the only child of Parameter2. Parameter4 has no child. Data is stored internally as a list where each item matches a row of the sequence file. Data can also be saved back to the file object provided. """ MAXDEPTH = 10 SAFE_FUNCTIONS = { 'range': range, 'sorted': sorted, 'list': list, 'arange': np.arange, 'linspace': np.linspace, 'arccos': np.arccos, 'arcsin': np.arcsin, 'arctan': np.arctan, 'arctan2': np.arctan2, 'ceil': np.ceil, 'cos': np.cos, 'cosh': np.cosh, 'degrees': np.degrees, 'e': np.e, 'exp': np.exp, 'fabs': np.fabs, 'floor': np.floor, 'fmod': np.fmod, 'frexp': np.frexp, 'hypot': np.hypot, 'ldexp': np.ldexp, 'log': np.log, 'log10': np.log10, 'modf': np.modf, 'pi': np.pi, 'power': np.power, 'radians': np.radians, 'sin': np.sin, 'sinh': np.sinh, 'sqrt': np.sqrt, 'tan': np.tan, 'tanh': np.tanh, } def __init__(self, valid_inputs=(), file_obj=None): self._sequences = [] self.valid_inputs = valid_inputs if file_obj: self.load(file_obj) @staticmethod def eval_string(string, name=None, depth=None, log_enabled=True): """ Evaluate the given string. The string is evaluated using a list of pre-defined functions that are deemed safe to use, to prevent the execution of malicious code. For this purpose, also any built-in functions or global variables are not available. :param string: String to be interpreted. :param name: Name of the to-be-interpreted string, only used for error messages. :param depth: Depth of the to-be-interpreted string, only used for error messages. :param log_enabled: Enable log messages. """ evaluated_string = None if len(string) > 0: try: evaluated_string = eval( string, {"__builtins__": None}, SequenceHandler.SAFE_FUNCTIONS ) except TypeError: if log_enabled: log.error("TypeError, likely a typo in one of the " + "functions for parameter '{}', depth {}".format( name, depth )) raise SequenceEvaluationError("TypeError, likely a typo") except SyntaxError: if log_enabled: log.error("SyntaxError, likely unbalanced brackets " + "for parameter '{}', depth {}".format(name, depth)) raise SequenceEvaluationError("SyntaxError, likely unbalanced brackets") except ValueError: if log_enabled: log.error("ValueError, likely wrong function argument " + "for parameter '{}', depth {}".format(name, depth)) raise SequenceEvaluationError("ValueError, likely wrong function argument") except Exception as e: raise SequenceEvaluationError(e) else: if log_enabled: log.error("No sequence entered for " + "for parameter '{}', depth {}".format(name, depth)) raise SequenceEvaluationError("No sequence entered") evaluated_string = np.array(evaluated_string) return evaluated_string def _get_idx(self, seq_item): """ Return the index and level of the list whose value correspond to sequence """ try: idx = self._sequences.index(seq_item) except ValueError: idx = -1 # Sequence not found, assuming idenx does not exist if idx < 0: level = -1 else: level = self._sequences[idx].level return idx, level def add_node(self, name, parent_seq_item=None): """ Add a node under the parent identified by parent_seq_item """ parent_idx, level = self._get_idx(parent_seq_item) seq_item = SequenceItem(level + 1, name, "", parent_seq_item) # Find position where to insert new row idx = parent_idx + 1 while idx < len(self._sequences): if self._sequences[idx].level <= level: break idx += 1 self._sequences.insert(idx, seq_item) return seq_item, self.get_children_order(seq_item) def remove_node(self, seq_item): """ Remove node identified by seq_item """ # if node identified by idx has children, we need to remove them first for child_seq_item in self.children(seq_item): self.remove_node(child_seq_item) self._sequences.remove(seq_item) return seq_item.parent, self.get_children_order(seq_item.parent) def children(self, seq_item): """ return a list of children of node identified by seq_item """ idx, current_level = self._get_idx(seq_item) child_list = [] idx += 1 while idx < len(self._sequences): if self._sequences[idx].level == (current_level + 1): child_list.append(self._sequences[idx]) if self._sequences[idx].level <= current_level: break idx += 1 return child_list def get_children(self, seq_item, index): """ Return the children of order index of the node seq_item """ child_list = self.children(seq_item) if index >= len(child_list): child = None else: child = child_list[index] return child def get_children_order(self, seq_item): """ Return the children order of the node identified by seq_item The children order is the index related to the parent's children list. :param seq_item: SequenceItem instance or None """ if seq_item is None: return -1 # Get parent's children list children_list = self.children(seq_item.parent) return children_list.index(seq_item) def get_parent(self, seq_item): """ Return parent of node identified by seq_item """ return seq_item.parent, self.get_children_order(seq_item.parent) def set_data(self, seq_item, row, column, value): """ Set data for node identified by seq_item """ idx, _ = self._get_idx(seq_item) if idx < 0: return False self._sequences[idx][column] = value return True def load(self, file_obj, append=False): """ Read and parse a sequence stored in a file. :params file_obj: file object :params append: flag to control whether to append to or replace current sequence """ _sequences = [] if append: _sequences += self._sequences current_parent = None pattern = re.compile("([-]+) \"(.*?)\", \"(.*?)\"") file_obj.seek(0) for line in file_obj: line = line.strip() match = pattern.search(line) if not match: continue level = len(match.group(1)) - 1 if level < 0: continue parameter = match.group(2) sequence = match.group(3) parent_level = -1 if current_parent is None else current_parent.level if level == (parent_level + 1): pass elif (level <= parent_level): # Find parent current_parent = current_parent.parent while current_parent is not None: if level == (current_parent.level + 1): break current_parent = current_parent.parent else: raise SequenceEvaluationError("Invalid file format: level missing ?") if self.valid_inputs and parameter not in self.valid_inputs: error_message = f'Unexpected parameter name "{parameter:s}", ' + \ f'valid parameters name are {self.valid_inputs}' raise SequenceEvaluationError(error_message) data = SequenceItem(level, parameter, sequence, current_parent) current_parent = data _sequences.append(data) # No errors, update internal data self._sequences = _sequences def save(self, file_obj): """ Save modified sequence to file stream :param file_obj: file object """ file_obj.write("\n".join(str(item) for item in self._sequences)) def parameters_sequence(self, names_map=None): """ Generate a list of parameters from the sequence tree. :param names_map: an optional dict to map parameter name :return: A list of dictionaries. Each dictionary represents a parameters setting for running an experiment. """ sequences = [] current_sequence = [[] for i in range(self.MAXDEPTH)] temp_sequence = [[] for i in range(self.MAXDEPTH)] idx = 0 while (idx < len(self._sequences)): depth, parameter, seq = self._sequences[idx].level, \ self._sequences[idx].parameter, \ self._sequences[idx].expression values = self.eval_string(seq, parameter, depth) if names_map is not None: parameter = names_map[parameter] try: sequence_entry = [{parameter: value} for value in values] except TypeError: log.error( "TypeError, likely no sequence for one of the parameters" ) else: current_sequence[depth].extend(sequence_entry) idx += 1 next_depth = -1 if idx >= len(self._sequences) else self._sequences[idx].level for depth_idx in range(depth, next_depth, -1): temp_sequence[depth_idx].extend(current_sequence[depth_idx]) if depth_idx != 0: sequence_products = list(product( current_sequence[depth_idx - 1], temp_sequence[depth_idx] )) for i in range(len(sequence_products)): try: element = sequence_products[i][1] except IndexError: log.error( "IndexError, likely empty nested parameter" ) else: if isinstance(element, tuple): sequence_products[i] = ( sequence_products[i][0], *element) temp_sequence[depth_idx - 1].extend(sequence_products) temp_sequence[depth_idx] = [] current_sequence[depth_idx] = [] current_sequence[depth_idx - 1] = [] if depth == next_depth: temp_sequence[depth].extend(current_sequence[depth]) current_sequence[depth] = [] sequences = temp_sequence[0] for idx in range(len(sequences)): if not isinstance(sequences[idx], tuple): sequences[idx] = (sequences[idx],) return sequences ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/experiment/workers.py0000644000175100017510000002107515203313266021524 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from __future__ import annotations import logging import time import traceback from queue import Queue from typing import Any, Sequence import numpy as np from .listeners import Recorder from .procedure import Procedure from .results import Results from ..thread import StoppableThread log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: import zmq import cloudpickle except ImportError: zmq = None cloudpickle = None log.warning("ZMQ and cloudpickle are required for TCP communication") class Worker(StoppableThread): """ Worker runs the procedure and emits information about the procedure and its status over a ZMQ TCP port. In a child thread, a Recorder is run to write the results to """ def __init__(self, results, log_queue=None, log_level=logging.INFO, port=None): """ Constructs a Worker to perform the Procedure defined in the file at the filepath """ super().__init__() self.port = port if not isinstance(results, Results): raise ValueError("Invalid Results object during Worker construction") self.results = results self.results.procedure.check_parameters() self.results.procedure.status = Procedure.QUEUED self.recorder = None self.recorder_queue = Queue() self.monitor_queue = Queue() if log_queue is None: log_queue = Queue() self.log_queue = log_queue self.log_level = log_level global log log = logging.getLogger(__name__) log.setLevel(self.log_level) # log.handlers = [] # Remove all other handlers # log.addHandler(TopicQueueHandler(self.monitor_queue)) # log.addHandler(QueueHandler(self.log_queue)) self.context = None self.publisher = None if self.port is not None and zmq is not None: try: self.context = zmq.Context() log.debug("Worker ZMQ Context: %r" % self.context) self.publisher = self.context.socket(zmq.PUB) self.publisher.bind('tcp://*:%d' % self.port) log.info("Worker connected to tcp://*:%d" % self.port) # wait so that the socket will be ready before starting to emit messages time.sleep(0.3) except Exception: log.exception("Couldn't establish ZMQ publisher!") self.context = None self.publisher = None def join(self, timeout: int = 0): try: super().join(timeout) except (KeyboardInterrupt, SystemExit): log.warning("User stopped Worker join prematurely") self.stop() super().join(0) def emit(self, topic: str, record: Any): """ Emits data of some topic over TCP """ log.debug("Emitting message: %s %s", topic, record) try: self.publisher.send_serialized( record, serialize=lambda rec: (topic.encode(), cloudpickle.dumps(rec)), ) except (NameError, AttributeError): pass # No dumps defined if topic == 'results': self.handle_record(record) elif topic == 'batch results': self.handle_batch_record(record) elif topic == 'status' or topic == 'progress': self.monitor_queue.put((topic, record)) def handle_record(self, record: dict[str, Any]): self.recorder.handle(record) def handle_batch_record(self, record: Any): if self._is_dictionary_of_sequences(record): lengths = list(len(value) for value in record.values()) if not all(length == lengths[0] for length in lengths): log.error( 'Data loss detected: not all sequences in the batch have the same length.' ) self.stop() return for index in range(lengths[0]): # Handle the records one by one. single_record = {key: value[index] for key, value in record.items()} self.handle_record(single_record) else: log.error(f'Unsupported type ({type(record)}) for batch results.') self.stop() def _is_dictionary_of_sequences(self, record: Any) -> bool: """ Checks if the record is a dictionary of sequences, there are a couple data types that we do not want to treat as sequences, such as strings and bytes. This function will return False if any of the values in the dictionary are strings or bytes or not a sequence. """ sequence_types = (Sequence, np.ndarray) type_exceptions = (str, bytes) if not isinstance(record, dict): return False return all( isinstance(value, sequence_types) and not isinstance(value, type_exceptions) for value in record.values() ) def handle_abort(self): log.exception("User stopped Worker execution prematurely") self.update_status(Procedure.ABORTED) def handle_error(self): log.exception("Worker caught an error on %r", self.procedure) traceback_str = traceback.format_exc() self.emit('error', traceback_str) self.update_status(Procedure.FAILED) def is_last(self): raise NotImplementedError('should be monkey patched by a manager') def update_status(self, status: int): self.procedure.status = status self.emit('status', status) def shutdown(self): self.procedure.shutdown() if self.should_stop() and self.procedure.status == Procedure.RUNNING: self.update_status(Procedure.ABORTED) elif self.procedure.status == Procedure.RUNNING: self.update_status(Procedure.FINISHED) self.emit('progress', 100.) self.recorder.stop() self.monitor_queue.put(None) if self.context is not None: # Cleanly close down ZMQ context and associated socket # For some reason, we need to close the socket before the # context, otherwise context termination hangs. self.publisher.close() self.context.term() def run(self): log.info("Worker thread started") self.procedure = self.results.procedure self.recorder = Recorder(self.results, self.recorder_queue) self.recorder.start() # locals()[self.procedures_file] = __import__(self.procedures_file) # route Procedure methods & log self.procedure.should_stop = self.should_stop self.procedure.emit = self.emit self.procedure.is_last = self.is_last log.info("Worker started running an instance of %r", self.procedure.__class__.__name__) self.update_status(Procedure.RUNNING) self.emit('progress', 0.) try: self.procedure.startup() if self.should_stop(): return self.procedure.evaluate_metadata() self.results.store_metadata() self.procedure.execute() except (KeyboardInterrupt, SystemExit): self.handle_abort() except Exception: self.handle_error() finally: self.shutdown() self.stop() def __repr__(self): return "<{}(port={},procedure={},should_stop={})>".format( self.__class__.__name__, self.port, self.procedure.__class__.__name__, self.should_stop() ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/generator.py0000644000175100017510000005304715203313266017642 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import io import logging from pymeasure.adapters import VISAAdapter from pymeasure.instruments import Channel log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def write_generic_test(file, header_text, cls_name, comm_text, test, inkwargs=None): """Write a generic test. :param fileLike file: File to write to. :param list[str] header_text: Text of the header (parametrization, test name etc.) :param str cls_name: Name of the instrument class. :param list[str] comm_text: List of str of communication pairs :param str test: Test to assert for. :param dict[str, Any] inkwargs: Dictionary of instrument instantiation kwargs. """ if inkwargs is None: args_text = "", else: args_text = [f' {key}={repr(value)},\n' for key, value in inkwargs.items()] inst = " as inst" if "inst" in test else "" # file.writelines([ # "\n", # "\n", # *header_text, # " with expected_protocol(\n", # f" {cls_name},\n", # *comm_text, # *args_text, # f" ){inst}:\n", # f" {test}\n" # ]) file.write( f""" {''.join(header_text)}\ with expected_protocol( {cls_name}, {''.join(comm_text)}\ {''.join(args_text)}\ ){inst}: {test} """ ) def write_test(file, test_name, cls_name, comm_pairs, test, inkwargs=None, ): """Write a single test. :param file: File to write to. :param str test_name: Name of the test. :param str cls_name: Name of the instrument class. :param list[tuple[bytes | None, bytes | None]] comm_pairs_list: List of communication pairs. :param str test: Test to assert for. :param dict[str, Any] inkwargs: Dictionary of instrument instantiation kwargs. """ write_generic_test( file=file, header_text=[f"def test_{test_name.replace('.', '_')}():\n"], cls_name=cls_name, comm_text=[f" {comm_pairs},\n".replace("), (", "),\n (")], test=test, inkwargs=inkwargs, ) def write_parametrized_test(file, test_name, cls_name, comm_pairs_list, values_list, test, inkwargs=None, ): """Write a parametrized test for properties. :param file: File to write to. :param str test_name: Name of the test. :param str cls_name: Name of the instrument class. :param list[list[tuple[bytes | None, bytes | None]]] comm_pairs_list: List of communication pairs list for each test. :param list[Any] values_list: List of expected values. :param str test: Test to assert for. :code:`'value'` is the expected parametrized value. :param dict inkwargs: Dictionary of instrument instantiation kwargs. """ params = [f" ({cp},\n {v}),\n".replace( "), (", "),\n (") for cp, v in zip(comm_pairs_list, values_list)] header_text = ['@pytest.mark.parametrize("comm_pairs, value", (\n', *params, "))\n", f"def test_{test_name.replace('.', '_')}(comm_pairs, value):\n", ] write_generic_test(file=file, header_text=header_text, cls_name=cls_name, comm_text=[" comm_pairs,\n"], test=test, inkwargs=inkwargs, ) def write_parametrized_method_test(file, test_name, cls_name, comm_pairs_list, args_list, kwargs_list, values_list, test, inkwargs=None, ): """Write a parametrized test for a method, taking in account additional arguments. :param file: File to write to. :param str name: Name of the test. :param str cls_name: Name of the instrument class. :param list[list[tuple[bytes | None, bytes | None]]] comm_pairs_list: List of communication pairs list for each test. :param list[tuple[Any, ...]] args_list: List of arguments lists for the method. :param list[dict[str, Any]] kwargs_list: List of keyword dictionaries for the method. :param list[Any] values_list: List of expected values. :param str test: Test to assert for. :code:`'value'` is the expected parametrized value. :param dict inkwargs: Dictionary of instrument instantiation kwargs. """ z = zip(comm_pairs_list, args_list, kwargs_list, values_list) params = [f" ({cp},\n {a}, {k}, {v}),\n".replace( "), (", "),\n (") for cp, a, k, v in z] header_text = ['@pytest.mark.parametrize("comm_pairs, args, kwargs, value", (\n', *params, "))\n", f"def test_{test_name.replace('.', '_')}(comm_pairs, args, kwargs, value):\n", ] write_generic_test( file=file, cls_name=cls_name, header_text=header_text, comm_text=[" comm_pairs,\n"], test=test, inkwargs=inkwargs ) def parse_stream(stream): """ Parse the data stream. It is expected, that a message is always written in one write, while reading may extend over several reads, e.g. reading bytes. :return list[tuple[bytes | None, bytes | None]]: List of communication pairs """ comm = [] lines = stream.readlines() write = None read = None mode = None for line in lines: if line.startswith(b"WRITE:"): # Store the last comm_pair unless there is none. if write is not None or read is not None: comm.append((write, read)) read = None write = line[6:-1] mode = "W" elif line.startswith(b"READ:"): if read is not None: read += line[5:-1] else: read = line[5:-1] mode = "R" else: # newline due to "\n" character in communication if mode == "W": write += b"\n" + line[:-1] elif mode == "R": read += b"\n" + line[:-1] else: raise ValueError("Very first line does not contain 'WRITE' or 'READ'!") if read is not None or write is not None: comm.append((write, read)) return comm class ByteFormatter(logging.Formatter): """Logging formatter with bytes values for the test generation.""" @staticmethod def make_bytes(value): if isinstance(value, (bytes, bytearray)): return value if isinstance(value, str): return value.encode() raise ValueError(f"value '{value}' is neither str nor bytes.") def format(self, record): return b"".join((record.msg.replace(r"%s", "").encode(), *[self.make_bytes(arg) for arg in record.args])) # type: ignore class ByteStreamHandler(logging.StreamHandler): """Logging handler using bytes streams.""" terminator = b"\n" # type: ignore def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.formatter = ByteFormatter() class TestInstrument: """A man-in-the-middle instrument, which logs property access and method calls. :param instrument: The real instrument, given by the generator. :param generator: The generator which writes the tests. :param name: Name in case of a channel with trailing period, for example :code:`"ch_1."`. """ def __init__(self, instrument, generator, name=""): self._inst = instrument self._generator = generator self._name = name def __getattr__(self, name): if name.startswith("_"): # return private and special attributes to prevent recursion return super().__getattribute__(name) elif name == "adapter": # transparently return the instrument's adapter without writing tests return self._inst.adapter else: # transparently get the attribute from the instrument and write an appropriate test value = getattr(self._inst, name) if callable(value): # the attribute is a callable, we have to return a special method which writes the # test while returning the value def test_method(*args, **kwargs): return self._generator._test_method(value, self._name + name, *args, **kwargs) return test_method elif isinstance(value, Channel): # the attribute is not a property or method, but a Channel, return a TestInstrument return TestInstrument(value, self._generator, f"{self._name}{name}.") else: # the attribute is a plain property, return the value and write a test self._generator._store_property_getter_test(self._name + name, value) return value def __setattr__(self, name, value): if name.startswith("_"): # set private and special attributes to prevent recursion super().__setattr__(name, value) else: # set an attribute transparently while writing a test setattr(self._inst, name, value) self._generator._store_property_setter_test(self._name + name, value) def __dir__(self): # To get autocompletion support for instrument members. return super().__dir__() + dir(self._inst) class Generator: """ Generates tests from the communication with an instrument. Example usage: .. code:: g = Generator() inst = g.instantiate(TC038, "COM5", 'hcp', adapter_kwargs={'baud_rate': 9600}) inst.information # returns the 'information' property and adds it to the tests inst.setpoint = 20 inst.setpoint == 20 # should be True g.write_file("test_tc038.py") # write the tests to a file """ def __init__(self): self._stream = io.BytesIO() self._index = 0 self._init_comm_pairs = [] # Initializiation comm_pairs # Dictionaries for parametrized tests self._getters = {} self._setters = {} self._calls = {} def write_init_test(self, file): """Write the header and init test.""" file.write(self._header) write_test(file, "init", self._class, self._init_comm_pairs, "pass # Verify the expected communication.", self._inkwargs, ) def write_getter_test(self, file, property, parameters): """Write a getter test.""" if len(parameters[0]) == 1: v = parameters[1][0] comparison = "is" if isinstance(v, bool) or v is None else "==" write_test(file, test_name=property.replace(".", "_") + "_getter", cls_name=self._class, comm_pairs=parameters[0][0], test=f"assert inst.{property} {comparison} {v}", inkwargs=self._inkwargs, ) else: write_parametrized_test(file, test_name=property.replace(".", "_") + "_getter", cls_name=self._class, comm_pairs_list=parameters[0], values_list=parameters[1], test=f"assert inst.{property} == value", inkwargs=self._inkwargs, ) def write_setter_test(self, file, property, parameters): """Write a setter test.""" if len(parameters[0]) == 1: v = parameters[1][0] write_test(file, test_name=property.replace(".", "_") + "_setter", cls_name=self._class, comm_pairs=parameters[0][0], test=f"inst.{property} = {v}", # inkwargs=self._inkwargs, TODO ) else: write_parametrized_test(file, test_name=property.replace(".", "_") + "_setter", cls_name=self._class, comm_pairs_list=parameters[0], values_list=parameters[-1], test=f"inst.{property} = value", inkwargs=self._inkwargs, ) def write_method_test(self, file, method, parameters): """Write a test for a method.""" if len(parameters[0]) == 1: v = parameters[-1][0] comparison = "is" if isinstance(v, bool) or v is None else "==" arg_string = f"*{parameters[1][0]}, " if parameters[1][0] else "" kwarg_string = f"**{parameters[2][0]}" if parameters[2][0] else "" write_test(file, test_name=method.replace(".", "_"), cls_name=self._class, comm_pairs=parameters[0][0], test=f"assert inst.{method}({arg_string}{kwarg_string}) {comparison} {v}", inkwargs=self._inkwargs, ) else: write_parametrized_method_test(file, test_name=method.replace(".", "_"), cls_name=self._class, comm_pairs_list=parameters[0], args_list=parameters[1], kwargs_list=parameters[2], values_list=parameters[-1], test=f"assert inst.{method}(*args, **kwargs) == value", inkwargs=self._inkwargs, ) def write_property_tests(self, file): """Write tests for properties in alphabetic order. If getter and setter exist, the setter is the first test. """ # Get a sorted list of all properties, without repeating them property_names = sorted(set(self._getters.keys() | set(self._setters.keys()))) for property in property_names: if property in self._setters: self.write_setter_test(file, property, self._setters[property]) if property in self._getters: # new condition (not elif), as properties can be in setters and in getters tests. self.write_getter_test(file, property, self._getters[property]) def write_method_tests(self, file): """Write all parametrized method tests in alphabetic order.""" for method in sorted(self._calls.keys()): self.write_method_test(file, method, self._calls[method]) def write_file(self, filename="tests.py"): """Write the tests into the file. :param filename: Name to save the tests to, may contain the path, e.g. "/tests/test_abc.py". """ file = filename if isinstance(filename, io.StringIO) else open(filename, "w") self.write_init_test(file) self.write_property_tests(file) self.write_method_tests(file) file.close() def parse_stream(self): """Parse the stream not yet read.""" self._stream.seek(self._index) comm = parse_stream(self._stream) self._index = self._stream.tell() return self._init_comm_pairs + comm def instantiate(self, instrument_class, adapter, manufacturer, adapter_kwargs=None, **kwargs): """ Instantiate the instrument and store the instantiation communication. ..note:: You have to give all keyword arguments necessary for adapter instantiation in `adapter_kwargs`, even those, which are defined somewhere in the instrument's ``__init__`` method, be it as a default value, be it directly in the ``Instrument.__init__()`` call. :param instrument_class: Class of the instrument to test. :param adapter: Adapter (instance or str) for the instrument instantiation. :param manufacturer: Module from which to import the instrument, e.g. 'hcp' if instrument_class is 'pymeasure.hcp.tc038'. :param adapter_kwargs: Keyword arguments for the adapter instantiation (see note above). :param \\**kwargs: Keyword arguments for the instrument instantiation. :return: A man-in-the-middle instrument, which can be used like a normal instrument. """ self._class = instrument_class.__name__ log.info(f"Instantiate {self._class}.") self._header = ( "import pytest\n\n" "from pymeasure.test import expected_protocol\n" f"from pymeasure.instruments.{manufacturer} import {self._class}\n") if isinstance(adapter, (int, str)): if adapter_kwargs is None: adapter_kwargs = {} try: adapter = VISAAdapter(adapter, **adapter_kwargs) except ImportError: raise Exception("Invalid Adapter provided for Instrument since" " PyVISA is not present") adapter.log.addHandler(ByteStreamHandler(self._stream)) adapter.log.setLevel(logging.DEBUG) self.inst = instrument_class(adapter, **kwargs) self._init_comm_pairs = self.parse_stream() # communication of instantiation. self._inkwargs = kwargs # instantiation kwargs self.test_inst = TestInstrument(self.inst, self) return self.test_inst def _store_property_getter_test(self, property, value): """Store the property getter test with returned `value`.""" comm = self.parse_stream() if property not in self._getters: self._getters[property] = [], [] c, v = self._getters[property] c.append(comm) v.append(f"\'{value}\'" if isinstance(value, str) else value) return value def test_property_getter(self, property): """Test getting the `property` of the instrument, adding it to the list.""" log.info(f"Test property {property} getter.") value = getattr(self.inst, property) self._store_property_getter_test(property, value) return value def _store_property_setter_test(self, property, value): """Store the property setter test with `value`.""" comm = self.parse_stream() if property not in self._setters: self._setters[property] = [], [] c, v = self._setters[property] c.append(comm) v.append(f"\'{value}\'" if isinstance(value, str) else value) def test_property_setter(self, property, value): """Test setting the `property` of the instrument to `value`, adding it to the list.""" log.info(f"Test property {property} setter.") setattr(self.inst, property, value) self._store_property_setter_test(property, value) def _test_method(self, method, method_name, *args, **kwargs): """Test calling `method` with the full `method_name` and `args` and `kwargs`.""" value = method(*args, **kwargs) comm = self.parse_stream() if method_name not in self._calls: self._calls[method_name] = [], [], [], [] c, a, k, v = self._calls[method_name] c.append(comm) a.append(args) k.append(kwargs) v.append(f"\'{value}\'" if isinstance(value, str) else value) return value def test_method(self, method_name, *args, **kwargs): """Test calling the `method_name` of the instruments with `args` and `kwargs`.""" log.info(f"Test method {method_name}.") method = getattr(self.inst, method_name) return self._test_method(method, method_name, *args, **kwargs) # batch tests def test_property_setter_batch(self, property, values): """Test setting `property` to each element in `values`.""" for value in values: self.test_property_setter(property, value) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0084813 pymeasure-0.16.0/pymeasure/instruments/0000755000175100017510000000000015203313301017652 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/__init__.py0000644000175100017510000000246415203313266022003 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .channel import Channel from .instrument import Instrument from .resources import find_serial_port, list_resources from .generic_types import SCPIMixin, SCPIUnknownMixin ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.008788 pymeasure-0.16.0/pymeasure/instruments/activetechnologies/0000755000175100017510000000000015203313301023531 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/activetechnologies/AWG401x.py0000644000175100017510000011432115203313266025152 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # """This module implements an interface for Active Technologies AWG-401x, both for the Arbitrary Waveform Generator (AWG) mode and the Arbitrary Function Generator (AFG) mode. The module has been developed from the official documentation available on https://www.activetechnologies.it""" from collections import abc, namedtuple import pprint from pymeasure.instruments import Instrument, Channel, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set, \ strict_range class ChannelBase(Channel): """Implementation of a base Active Technologies AWG-4000 channel.""" def __init__(self, instrument, id): super().__init__(instrument, id) self.delay_values = [self.delay_min, self.delay_max] enabled = Instrument.control( "OUTPut{ch}:STATe?", "OUTPut{ch}:STATe %d", """Control output state (bool).""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) polarity = Instrument.control( "OUTPut{ch}:POLarity?", "OUTPut{ch}:POLarity %s", """Control output polarity (str in [NORMAL, NORM, INVERTED, INV]).""", validator=strict_discrete_set, values=["NORMAL", "NORM", "INVERTED", "INV"], get_process=lambda v: "NORM" if v == 0 else ("INV" if v == 1 else v) ) delay = Instrument.control( None, None, """Control initial delay, set 0 for disable it. When you send this command in AFG mode, if the instrument is running, it will be stopped.""", dynamic=True ) delay_max = Instrument.measurement( None, """Get maximum delay (int).""", dynamic=True ) delay_min = Instrument.measurement( None, """Get minimum delay (int).""", dynamic=True ) class ChannelAFG(ChannelBase): """Implementation of a Active Technologies AWG-4000 channel in AFG mode.""" def __init__(self, instrument, id): super().__init__(instrument, id) self.calculate_voltage_range() self.frequency_values = [self.frequency_min, self.frequency_max] self.phase_values = [self.phase_min, self.phase_max] load_impedance = Instrument.control( "OUTPut{ch}:IMPedance?", "OUTPut{ch}:IMPedance %d", """Control the output load impedance for the specified channel. The specified value is used for amplitude, offset, and high/low level settings. You can set the impedance to any value from 1 Ω to 1 MΩ. The default value is 50 Ω.""", validator=strict_range, values=[1, 1000000] ) output_impedance = Instrument.control( "OUTPut{ch}:LOW:IMPedance?", "OUTPut{ch}:LOW:IMPedance %d", """Control the instrument output impedance, the possible values are: 5 Ohm or 50 Ohm (default).""", validator=strict_discrete_set, values={5: 1, 50: 0}, map_values=True ) shape = Instrument.control( "SOURce{ch}:FUNCtion:SHAPe?", "SOURce{ch}:FUNCtion:SHAPe %s", """Control the shape of the carrier waveform. Allowed choices depends on the choosen modality, please refer on instrument manual. When you set this property with a different value, if the instrument is running it will be stopped. Can be set to: SIN, SQU, PULS, RAMP, PRN, DC, SINC, GAUS, LOR, ERIS, EDEC, HAV, ARBB, EFIL, DOUBLEPUL""", validator=strict_discrete_set, values=["SINUSOID", "SIN", "SQUARE", "SQU", "PULSE", "PULS", "RAMP", "PRNOISE", "PRN", "DC", "SINC", "GAUSSIAN", "GAUS", "LORENTZ", "LOR", "ERISE", "ERIS", "EDECAY", "EDEC", "HAVERSINE", "HAV", "ARBB", "EFILE", "EFIL", "DOUBLEPULSE", "DOUBLEPUL"] ) # Default delay override delay_get_command = "SOURce{ch}:INITDELay?" delay_set_command = "SOURce{ch}:INITDELay %s" delay_max_get_command = "SOURce{ch}:INITDELay? MAXimum" delay_min_get_command = "SOURce{ch}:INITDELay? MINimum" frequency = Instrument.control( "SOURce{ch}:FREQuency?", "SOURce{ch}:FREQuency %s", """Control the frequency of the output waveform. This command is available when the Run Mode is set to any setting other than Sweep. The output frequency range setting depends on the type of output waveform. If you change the type of output waveform, it may change the output frequency because changing waveform types affects the setting range of the output frequency. The output frequency range setting depends also on the amplitude parameter.""", validator=strict_range, dynamic=True ) frequency_max = Instrument.measurement( "SOURce{ch}:FREQuency? MAXimum", """Get the maximum frequency that can be set to the output waveform.""" ) frequency_min = Instrument.measurement( "SOURce{ch}:FREQuency? MINimum", """Get the minimum frequency that can be set to the output waveform.""" ) phase = Instrument.control( "SOURce{ch}:PHASe:ADJust?", "SOURce{ch}:PHASe:ADJust %s", """Control the phase of the output waveform for the specified channel. The value is in degrees.""", validator=strict_range, dynamic=True ) phase_max = Instrument.measurement( "SOURce{ch}:PHASe:ADJust? MAXimum", """Get the maximum phase that can be set to the output waveform.""" ) phase_min = Instrument.measurement( "SOURce{ch}:PHASe:ADJust? MINimum", """Get the minimum phase that can be set to the output waveform.""" ) voltage_unit = Instrument.control( "OUTPut{ch}:VOLTage:UNIT?", "OUTPut{ch}:VOLTage:UNIT %s", """Control the units of output amplitude, the possible choices are: VPP, VRMS, DBM. This command does not affect the offset, high level, or low level of output.""", validator=strict_discrete_set, values=["VPP", "VRMS", "DBM"] ) voltage_low = Instrument.control( "SOURce{ch}:VOLTage:LEVel:IMMediate:LOW?", "SOURce{ch}:VOLTage:LEVel:IMMediate:LOW %s", """Control the low level of the waveform. The low level could be limited by noise level to not exceed the maximum amplitude. If the carrier is Noise or DC level, this command and this query cause an error.""", validator=strict_range, dynamic=True ) voltage_low_max = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:LOW? MAXimum", """Get the maximum low voltage level that can be set to the output waveform.""" ) voltage_low_min = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:LOW? MINimum", """Get the minimum low voltage level that can be set to the output waveform.""" ) voltage_high = Instrument.control( "SOURce{ch}:VOLTage:LEVel:IMMediate:HIGH?", "SOURce{ch}:VOLTage:LEVel:IMMediate:HIGH %s", """Control the high level of the waveform. The high level could be limited by noise level to not exceed the maximum amplitude. If the carrier is Noise or DC level, this command and this query cause an error.""", validator=strict_range, dynamic=True ) voltage_high_max = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:HIGH? MAXimum", """Get the maximum high voltage level that can be set to the output waveform.""" ) voltage_high_min = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:HIGH? MINimum", """Get the minimum high voltage level that can be set to the output waveform.""" ) voltage_amplitude = Instrument.control( "SOURce{ch}:VOLTage:LEVel:IMMediate:AMPLitude?", "SOURce{ch}:VOLTage:LEVel:IMMediate:AMPLitude %s", """Control the output amplitude for the specified channel. The measurement unit of amplitude depends on the selection operated using the voltage_unit property. If the carrier is Noise the amplitude is Vpk instead of Vpp. If the carrier is DC level this command causes an error. The range of the amplitude setting could be limited by the frequency and offset parameter of the carrier waveform. """, validator=strict_range, dynamic=True ) voltage_amplitude_max = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:AMPLitude? MAXimum", """Get the maximum amplitude voltage level that can be set to the output waveform.""", get_process=lambda value: float(value.replace("VPP", "")) ) voltage_amplitude_min = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:AMPLitude? MINimum", """Get the minimum amplitude voltage level that can be set to the output waveform.""", get_process=lambda value: float(value.replace("VPP", "")) ) voltage_offset = Instrument.control( "SOURce{ch}:VOLTage:LEVel:IMMediate:OFFSet?", "SOURce{ch}:VOLTage:LEVel:IMMediate:OFFSet %s", """Control the offset level for the specified channel. The offset range setting depends on the amplitude parameter. """, validator=strict_range, dynamic=True ) voltage_offset_max = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:OFFSet? MAXimum", """Get the maximum offset voltage level that can be set to the output waveform.""" ) voltage_offset_min = Instrument.measurement( "SOURce{ch}:VOLTage:LEVel:IMMediate:OFFSet? MINimum", """Get the minimum offset voltage level that can be set to the output waveform.""" ) baseline_offset = Instrument.control( "SOURce{ch}:VOLTage:BASELINE:OFFSET?", "SOURce{ch}:VOLTage:BASELINE:OFFSET %s", """Control the offset level for the specified channel. The offset range setting depends on the amplitude parameter. """, validator=strict_range, dynamic=True ) baseline_offset_max = Instrument.measurement( "SOURce{ch}:VOLTage:BASELINE:OFFSET? MAXimum", """Get the maximum offset voltage level that can be set to the output waveform.""" ) baseline_offset_min = Instrument.measurement( "SOURce{ch}:VOLTage:BASELINE:OFFSET? MINimum", """Get the minimum offset voltage level that can be set to the output waveform.""" ) def calculate_voltage_range(self): self.voltage_low_values = [self.voltage_low_min, self.voltage_low_max] self.voltage_high_values = [self.voltage_high_min, self.voltage_high_max] self.voltage_amplitude_values = [self.voltage_amplitude_min, self.voltage_amplitude_max] self.voltage_offset_values = [self.voltage_offset_min, self.voltage_offset_max] self.baseline_offset_values = [self.baseline_offset_min, self.baseline_offset_max] class ChannelAWG(ChannelBase): """Implementation of a Active Technologies AWG-4000 channel in AWG mode.""" # Default delay override delay_get_command = "OUTPut{ch}:DELay?" delay_set_command = "OUTPut{ch}:DELay %s" delay_max_get_command = "OUTPut{ch}:DELay? MAXimum" delay_min_get_command = "OUTPut{ch}:DELay? MINimum" scale = Instrument.control( "OUTPut{ch}:SCALe?", "OUTPut{ch}:SCALe %f", """Control the Amplitude Scale parameter of the analog channel “n”. This property can be modified at run-time to adjust the waveform amplitude while the instrument is running and it is applied to all the waveforms contained in the sequencer. It is expressed in % and it has a range of 0% to 100%. 100% means that the waveform keeps its original amplitude.""", validator=strict_range, values=[0, 100] ) class AWG401x_base(SCPIUnknownMixin, Instrument): """AWG-401x base class""" def __init__(self, adapter, name="Active Technologies AWG-4014 1.2GS/s Arbitrary Waveform Generator", **kwargs): # Insert an higher timeout because, often, when starting the # instrument, can pass some time and the adapted goes in timeout kwargs.setdefault('timeout', 7500) super().__init__( adapter, name, **kwargs ) def beep(self): """Causes a system beep.""" self.write("SYST:BEEP") def save(self, position): """Save the actual configuration in memory. :param int position: Instrument save position [0,4] :raises ValueError: If position is outside permitted limit [0,4]. """ if position >= 0 or position <= 4: self.write(f"*SAV {position}") else: raise ValueError("position value outside permitted range [0,4]") def load(self, position): """Load the actual configuration in memory. :param int position: Instrument load position [0,4] :raises ValueError: If position is outside permitted limit [0,4]. """ if position >= 0 or position <= 4: self.write(f"*RCL {position}") else: raise ValueError("position value outside permitted range [0,4]") def wait_last(self): """Wait for last operation completion""" self.write("*WAI") class AWG401x_AFG(AWG401x_base): """Represents the Active Technologies AWG-401x Arbitrary Waveform Generator in AFG mode. .. code-block:: python wfg = AWG401x_AFG("TCPIP::192.168.0.123::INSTR") wfg.reset() # Reset the instrument at default state wfg.channels[1].shape = "SINUSOID" # Sets a sine waveform on CH1 wfg.channels[1].frequency = 4.7e3 # Sets the frequency to 4.7 kHz on CH1 wfg.channels[1].amplitude = 1 # Set amplitude of 1 V on CH1 wfg.channels[1].offset = 0 # Set the amplitude to 0 V on CH1 wfg.channels[1].enabled = True # Enables the CH1 wfg.channels[2].shape = "SQUARE" # Sets a square waveform on CH2 wfg.channels[2].frequency = 100e6 # Sets the frequency to 100 MHz on CH2 wfg.channels[2].amplitude = 0.5 # Set amplitude of 0.5 V on CH2 wfg.channels[2].offset = 0 # Set the amplitude to 0 V on CH2 wfg.channels[2].enabled = True # Enables the CH2 wfg.enabled = True # Enable output of waveform generator wfg.beep() # "beep" print(wfg.check_errors()) # Get the error queue """ ch_1 = Instrument.ChannelCreator(ChannelAFG, 1) ch_2 = Instrument.ChannelCreator(ChannelAFG, 2) enabled = Instrument.control( "AFGControl:STATus?", "AFGControl:%s", """Control whether the generation of signals is enabled (bool).""", validator=strict_discrete_set, values={True: "START", False: "STOP"}, map_values=True, get_process=lambda v: "START" if v == 1 else ("STOP" if v == 0 else v) ) def __init__(self, adapter, **kwargs): super().__init__(adapter, **kwargs) model = self.id.split(",")[1] if model == "AWG4012": num_ch = 2 elif model == "AWG4014": num_ch = 4 elif model == "AWG4018": num_ch = 8 else: raise NotImplementedError(f"Instrument {model} not implemented in" "class AWG401x") for i in range(3, num_ch + 1): child = self.add_child(ChannelAFG, i) child._protected = True class AWG401x_AWG(AWG401x_base): """Represents the Active Technologies AWG-401x Arbitrary Waveform Generator in AWG mode. .. code-block:: python wfg = AWG401x_AWG("TCPIP::192.168.0.123::INSTR") wfg.reset() # Reset the instrument at default state # Set a oscillating waveform wfg.waveforms["MyWaveform"] = [1, 0] * 8 for i in range(1, wfg.num_ch + 1): wfg.entries[1].channels[i].voltage_high = 1 # Sets high voltage = 1 wfg.entries[1].channels[i].voltage_low = 0 # Sets low voltage = 1 wfg.entries[1].channels[i].waveform = "SQUARE" # Sets a square wave wfg.setting_ch[i].enabled = True # Enable channel wfg.entries.resize(2) # Resize the number of entries to 2 wfg.entries[2].channels[1].waveform = "MyWaveform" # Set custom waveform wfg.enabled = True # Enable output of waveform generator wfg.beep() # "beep" print(wfg.check_errors()) # Get the error queue """ def __init__(self, adapter, **kwargs): super().__init__(adapter, **kwargs) for i in range(1, self.num_ch + 1): self.add_child(ChannelAWG, i, collection="setting_ch") self.entries = self.DummyEntriesElements(self, self.num_ch) self.burst_count_values = [self.burst_count_min, self.burst_count_max] self.sampling_rate_values = [self.sampling_rate_min, self.sampling_rate_max] self._waveforms = self.WaveformsLazyDict(self) num_ch = Instrument.measurement( "AWGControl:CONFigure:CNUMber?", """Get the number of analog channels.""", cast=int ) num_dch = Instrument.measurement( "AWGControl:CONFigure:DNUMber?", """Get the number of digital channels.""", cast=int ) sample_decreasing_strategy = Instrument.control( "AWGControl:DECreasing?", "AWGControl:DECreasing %s", """Control the Sample Decreasing Strategy. The “Sample decreasing strategy” parameter defines the strategy used to adapt the waveform length to the sequencer entry length in the case where the original waveform length is longer than the sequencer entry length. Can be set to: DECIM, CUTT, CUTH""", validator=strict_discrete_set, values=["DECIMATION", "DECIM", "CUTTAIL", "CUTT", "CUTHEAD", "CUTH"] ) sample_increasing_strategy = Instrument.control( "AWGControl:INCreasing?", "AWGControl:INCreasing %s", """Control the Sample Increasing Strategy. The “Sample increasing strategy” parameter defines the strategy used to adapt the waveform length to the sequencer entry length in the case where the original waveform length is shorter than the sequencer entry length. Can be set to: INTER, RETURN, HOLD, SAMPLESM""", validator=strict_discrete_set, values=["INTERPOLATION", "INTER", "RETURNZERO", "RETURN", "HOLDLAST", "HOLD", "SAMPLESMULTIPLICATION", "SAMPLESM"] ) entry_level_strategy = Instrument.control( "AWGControl:LENGth:MODE?", "AWGControl:LENGth:MODE %s", """Control the Entry Length Strategy. This strategy manages the length of the sequencer entries in relationship with the length of the channel waveforms defined for each entry. The possible values are: * ADAPTL: the length of an entry of the sequencer by default will be equal to the length of the longer channel waveform, among all analog channels, assigned to the entry. * ADAPTS: the length of an entry of the sequencer by default will be equal to the length of the shorter channel waveform, among all analog channels, assigned to the entry. * DEF:the length of an entry of the sequencer by default will be equal to the value specified in the Sequencer Item Default Length [N] parameter""", validator=strict_discrete_set, values=["ADAPTLONGER", "ADAPTL", "ADAPTSHORTER", "ADAPTS", "DEFAULT", "DEF"] ) run_mode = Instrument.control( "AWGControl:RMODe?", "AWGControl:RMODe %s", """Control the AWG run mode. The possible values are: * CONT: each waveform will loop as written in the entry repetition parameter and the entire sequence is repeated circularly * BURS: the AWG waits for a trigger event. When the trigger event occurs each waveform will loop as written in the entry repetition parameter and the entire sequence will be repeated circularly many times as written in the Burst Count[N] parameter. If you set Burst Count[N]=1 the instrument is in Single mode and the sequence will be repeated only once. * TCON: the AWG waits for a trigger event. When the trigger event occurs each waveform will loop as written in the entry repetition parameter and the entire sequence will be repeated circularly. * STEP: the AWG, for each entry, waits for a trigger event before the execution of the sequencer entry. The waveform of the entry will loop as written in the entry repetition parameter. After the generation of an entry has completed, the last sample of the current entry or the first sample of the next entry is held until the next trigger is received. At the end of the entire sequence the execution will restart from the first entry. * ADVA: it enables the “Advanced” mode. In this mode the execution of the sequence can be changed by using conditional and unconditional jumps (JUMPTO and GOTO commands) and dynamic jumps (PATTERN JUMP commands). The \\*RST command sets this parameter to CONTinuous.""", validator=strict_discrete_set, values=["CONTINUOUS", "CONT", "BURST", "BURS", "TCONTINUOUS", "TCON", "STEPPED", "STEP", "ADVANCED", "ADVA"] ) burst_count = Instrument.control( "AWGControl:BURST?", "AWGControl:BURST %d", """Control the burst count parameter.""", validator=strict_range, dynamic=True ) burst_count_max = Instrument.measurement( "AWGControl:BURST? MAXimum", """Get the maximum burst count parameter.""", cast=int ) burst_count_min = Instrument.measurement( "AWGControl:BURST? MINimum", """Get the minimum burst count parameter.""", cast=int ) sampling_rate = Instrument.control( "AWGControl:SRATe?", "AWGControl:SRATe %f", """Control the sample rate for the Sampling Clock.""", validator=strict_range, dynamic=True ) sampling_rate_max = Instrument.measurement( "AWGControl:SRATe? MAXimum", """Get the maximum sample rate for the Sampling Clock.""" ) sampling_rate_min = Instrument.measurement( "AWGControl:SRATe? MINimum", """Get the minimum sample rate for the Sampling Clock.""" ) run_status = Instrument.measurement( "AWGControl:RSTATe?", """Get the run state of the AWG. The possible values are: STOPPED, WAITING_TRIGGER, RUNNING""", values={"STOPPED": 0, "WAITING_TRIGGER": 1, "RUNNING": 2}, map_values=True ) enabled = Instrument.control( "AWGControl:RSTATe?", "AWGControl:%s", """Control whether generation of signals in enabled.""", validator=strict_discrete_set, values={True: "RUN", False: "STOP"}, map_values=True, get_process=lambda v: "STOP" if v == 0 else "RUN" ) trigger_source = Instrument.control( "TRIGger:SEQuence:SOURce?", "TRIGger:SEQuence:SOURce %s", """Control the instrument trigger source. The possible values are: * TIM: the trigger is sent at regular intervals. * EXT: the trigger come from the external BNC connector. * MAN: the trigger is sent via software or using the trigger button on front panel.""", validator=strict_discrete_set, values=["TIMER", "TIM", "EXTERNAL", "EXT", "MANUAL", "MAN"] ) waveforms = property( lambda self: self._waveforms, doc="""Get a dict with all the waveform present in the instrument system (Wave. List). It is possible to modify the values, delete them or create new waveforms""") def trigger(self): """Force a trigger event to occour.""" self.write("TRIGger:SEQuence:IMMediate") def save_file(self, file_name, data, path=None, override_existing=False): """Write a string in a file in the instrument""" if path is not None: raise NotImplementedError("Specify path is not implemented") if file_name in [file.name for file in self.list_files(path=path) if file.type == '']: if override_existing: self.remove_file(file_name, path=path) else: raise ValueError("File already exist and override is disabled") self.adapter.write_binary_values( 'MMEM:DATA "' + file_name + '", 0, ', data.encode("ASCII"), datatype='s') # HACK: Send an unuseful command to ensure the last command was # executed because if it is more than 1024 bytes it doesn't work self.wait_last() def remove_file(self, file_name, path=None): """Remove a specified file""" if path is not None: raise NotImplementedError("Specify path is not implemented") if file_name not in [file.name for file in self.list_files(path=path) if file.type == '']: raise ValueError("File do not exist") self.write('MMEMORY:DELETE "' + file_name + '"') def list_files(self, path=None): """Return a List of tuples with all file found in a directory. If the path is not specified the current directory will be used""" if path is not None: raise NotImplementedError("Specify path is not implemented") catalog = self.values("MMEMory:CATalog?") catalog = catalog[1:] FS_Element = namedtuple("FS_Element", "name type dimension") elements = [] for i in range(int(len(catalog) / 3)): elements.append(FS_Element(catalog[i * 3 + 0], catalog[i * 3 + 1], catalog[i * 3 + 2])) return elements class WaveformsLazyDict(abc.MutableMapping): """This class inherit from MutableMapping in order to create a custom dict to lazy load, modify, delete and create instrument waveform.""" def __init__(self, parent): self.parent = parent self.reset() def __getitem__(self, key): """Load data from instrument if not present""" if self._data[key] is None: self._data[key] = self._get_waveform(key) return self._data[key] def __setitem__(self, key, value): """Create a new waveform from key and value""" if len(value) < 16: raise ValueError("The minimum waveform length is 16 samples") elif len(value) < 384 and len(value) % 16 != 0: raise ValueError("From 16 to 384 samples the granularity of" "the waveform is 16") class VoltageOutOfRangeError(Exception): pass if max(value) > self.parent.entries[1].channels[1].voltage_high_max: raise VoltageOutOfRangeError( f"{max(value)}V is higher than maximum possible voltage, " f"which is " f"{self.instrument.entries[1].channels[1].voltage_high_max}V") if min(value) < self.parent.entries[1].channels[1].voltage_low_min: raise VoltageOutOfRangeError( f"{min(value)}V is lower than minimum possible voltage, " f"which is " f"{self.instrument.entries[1].channels[1].voltage_low_min}V") self.parent.save_file(f"{key}.txt", "\n".join(map(str, value)), override_existing=True) try: del self[key] except KeyError: pass self.parent.write(f'WLISt:WAVeform:IMPort "{key}",' f'"{key}.txt",ANAlog') self.parent.wait_last() self.parent.remove_file(f"{key}.txt") self._data[key] = None return def __delitem__(self, key): """When removing an element this method removes also the corresponding waveform in the instrument""" del self._data[key] self.parent.write(f'WLISt:WAVeform:DELete "{key}"') return def __iter__(self): try: for el in self._data: yield el except KeyError: return def __len__(self): return len(self._data) def __str__(self): """Return a str without the waveforms points because it is useless and loads all waveforms uselessy""" return pprint.pformat({el: "Waveform Points" for el in self._data}) def reset(self): """Reset the class reloading the waveforms from instrument""" waveforms_name = self.parent.values("WLISt:LIST?") self._data = {v: None for v in waveforms_name} def _get_waveform(self, waveform_name): """Get the waveform point of a specified waveform""" bin_value = self.parent.adapter.connection.query_binary_values( 'WLISt:WAVeform:DATA? "' + waveform_name + '"', header_fmt='ieee', datatype='h') return bin_value class DummyEntriesElements(abc.Sequence): """Dummy List Class to list every sequencer entry. The content is loaded in real-time.""" def __init__(self, parent, number_of_channel): self.parent = parent self.num_ch = number_of_channel def resize(self, new_size): self.parent.write(f"SEQuence:LENGth {new_size}") def __getitem__(self, key): if key <= 0: raise IndexError("Entry numeration start from 1") if key > int(self.parent.values("SEQuence:LENGth?")[0]): raise IndexError("Index out of range") return SequenceEntry(self.parent, self.num_ch, key) def __len__(self): return int(self.parent.values("SEQuence:LENGth?")[0]) class SequenceEntry(Channel): """Implementation of sequencer entry.""" def __init__(self, parent, number_of_channels, sequence_number): super().__init__(parent, sequence_number) self.number_of_channels = number_of_channels self.length_values = [self.length_min, self.length_max] self.loop_count_values = [self.loop_count_min, self.loop_count_max] for i in range(1, self.number_of_channels + 1): self.add_child(self.AnalogChannel, i, sequence_number=sequence_number) def insert_id(self, command): return command.format(ent=self.id) length = Instrument.control( "SEQuence:ELEM{ent}:LENGth?", "SEQuence:ELEM{ent}:LENGth %s", """Control the number of samples of the entry. """, validator=strict_range, dynamic=True ) length_max = Instrument.measurement( "SEQuence:ELEM{ent}:LENGth? MAXimum", """Get the maximum entry samples length.""", get_process=lambda v: int(v) ) length_min = Instrument.measurement( "SEQuence:ELEM{ent}:LENGth? MINimum", """Get the minimum entry samples length.""", get_process=lambda v: int(v) ) loop_count = Instrument.control( "SEQuence:ELEM{ent}:LOOP:COUNt?", "SEQuence:ELEM{ent}:LOOP:COUNt %s", """Control the number of waveform repetitions for the entry. """, validator=strict_range, dynamic=True ) loop_count_max = Instrument.measurement( "SEQuence:ELEM{ent}:LOOP:COUNt? MAXimum", """Get the maximum number of waveform repetitions for the entry.""", get_process=lambda v: int(v) ) loop_count_min = Instrument.measurement( "SEQuence:ELEM{ent}:LOOP:COUNt? MINimum", """Get the minimum number of waveform repetitions for the entry.""", get_process=lambda v: int(v) ) class AnalogChannel(Channel): """Implementation of an analog channel for a single sequencer entry.""" def __init__(self, parent, id, sequence_number): super().__init__(parent, id) self.seq_num = sequence_number self.waveform_values = list(self.parent.parent.waveforms.keys()) self.calculate_voltage_range() def insert_id(self, command): return command.format(ent=self.seq_num, ch=self.id) voltage_amplitude = Instrument.control( "SEQuence:ELEM{ent}:AMPlitude{ch}?", "SEQuence:ELEM{ent}:AMPlitude{ch} %s", """Control the voltage peak-to-peak amplitude.""", validator=strict_range, dynamic=True ) voltage_amplitude_max = Instrument.measurement( "SEQuence:ELEM{ent}:AMPlitude{ch}? MAXimum", """Get the maximum amplitude voltage level that can be set.""" ) voltage_amplitude_min = Instrument.measurement( "SEQuence:ELEM{ent}:AMPlitude{ch}? MINimum", """Get the minimum amplitude voltage level that can be set.""" ) voltage_offset = Instrument.control( "SEQuence:ELEM{ent}:OFFset{ch}?", "SEQuence:ELEM{ent}:OFFset{ch} %s", """Control the voltage offset.""", validator=strict_range, dynamic=True ) voltage_offset_max = Instrument.measurement( "SEQuence:ELEM{ent}:OFFset{ch}? MAXimum", """Get the maximum voltage offset that can be set.""" ) voltage_offset_min = Instrument.measurement( "SEQuence:ELEM{ent}:OFFset{ch}? MINimum", """Get the minimum voltage offset that can be set.""" ) voltage_high = Instrument.control( "SEQuence:ELEM{ent}:VOLTage:HIGH{ch}?", "SEQuence:ELEM{ent}:VOLTage:HIGH{ch} %s", """Control the high voltage level of the waveform.""", validator=strict_range, dynamic=True ) voltage_high_max = Instrument.measurement( "SEQuence:ELEM{ent}:VOLTage:HIGH{ch}? MAXimum", """Get the maximum high voltage level of the waveform that can be set to the output waveform.""" ) voltage_high_min = Instrument.measurement( "SEQuence:ELEM{ent}:VOLTage:HIGH{ch}? MINimum", """Get the minimum high voltage level of the waveform that can be set to the output waveform.""" ) voltage_low = Instrument.control( "SEQuence:ELEM{ent}:VOLTage:LOW{ch}?", "SEQuence:ELEM{ent}:VOLTage:LOW{ch} %s", """Control the low voltage level of the waveform.""", validator=strict_range, dynamic=True ) voltage_low_max = Instrument.measurement( "SEQuence:ELEM{ent}:VOLTage:LOW{ch}? MAXimum", """Get the maximum low voltage level of the waveform that can be set to the output waveform.""" ) voltage_low_min = Instrument.measurement( "SEQuence:ELEM{ent}:VOLTage:LOW{ch}? MINimum", """Get the minimum low voltage level of the waveform that can be set to the output waveform.""" ) waveform = Instrument.control( "SEQuence:ELEM{ent}:WAVeform{ch}?", "SEQuence:ELEM{ent}:WAVeform{ch} %s", """Control the waveform. It’s possible select a waveform only from those in the waveform list. In waveform list are already present 10 predefined waveform: Sine, Ramp, Square, Sync, DC, Gaussian, Lorentz, Haversine, Exp_Rise and Exp_Decay but user can import in the list others customized waveforms.""", validator=strict_discrete_set, set_process=lambda v: f"\"{v}\"", dynamic=True ) def calculate_voltage_range(self): self.voltage_amplitude_values = [self.voltage_amplitude_min, self.voltage_amplitude_max] self.voltage_offset_values = [self.voltage_offset_min, self.voltage_offset_max] self.voltage_high_values = [self.voltage_high_min, self.voltage_high_max] self.voltage_low_values = [self.voltage_low_min, self.voltage_low_max] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/activetechnologies/__init__.py0000644000175100017510000000230715203313266025656 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .AWG401x import AWG401x_AFG from .AWG401x import AWG401x_AWG ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.009092 pymeasure-0.16.0/pymeasure/instruments/aculight/0000755000175100017510000000000015203313301021452 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/aculight/__init__.py0000644000175100017510000000223615203313266023600 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .argos import Argos ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/aculight/argos.py0000644000175100017510000001337115203313266023156 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # # Standard packages from typing import NamedTuple # third party packages from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range # local packages def state_to_float(line: str) -> float: """Extract the float of the value line ' name = value'.""" return float(line.split("=")[-1]) def generate_state_extraction_method(index): """Generate a method, which returns one of the states according to the index.""" def extract_state(values): return state_to_float(values[index]) return extract_state class State(NamedTuple): crystal_temperature_setpoint: float crystal_temperature: float etalon_angle: float seed_voltage: float class Argos(Instrument): """Communication model for the Aculight Argos 2400 OPO system. Note that the device can only return all values at once, which takes around 100 ms. If you need more than one value, read the :attr:`state` property instead of individual properties. Reading any property reads all properties and returns the corresponding value. Note also, that the block temperature cannot be set remotely, only via the front panel. Cable type: RS232 null modem female DB9 connectors: The pins 2 and 3 have to be crossed between both sides. Pin2 is RX and Pin3 is Tx, Pin 5 is ground. :param adapter: resource name :param query_delay: Delay between write and read in seconds. """ def __init__(self, adapter, name="Argos 2400 OPO system", query_delay=0.01, **kwargs): super().__init__( adapter, name, baud_rate=4800, write_termination="\n", read_termination="\n\rOPO>", includeSCPI=False, **kwargs) """ 8 data bits, no parity, 1 stop bit, no flow control """ self.query_delay = query_delay # read starts with space and ends with "\n\rOPO>" def wait_for(self, query_delay=None): """Wait for some time. Used by 'ask' to wait before reading. :param query_delay: Delay between writing and reading in seconds. None is default delay. """ super().wait_for(self.query_delay if query_delay is None else query_delay) def check_set_errors(self): """Read after setting.""" got = self.read() if "setting changed" not in got: raise ConnectionError(f"Change setting failed: {got}") return [] @property def state(self) -> State: """Get the current state of the system as a namped tuple :return named tuple: with 'crystal_temperature', 'crystal_temperature_setpoint', 'etalon_angle', and 'seed_voltage'. """ got = self.ask("state") # got is in form (note the spaces at the begin): # Crystal Temp Set = 55.000\n\r # Etalon Angle Set = -0.020\n\r # Seed Source Set = 0.000\n\r # Crystal Temp = 54.900\n\r # OPO> tempSet, etalon, seed, temp = got.split("\n\r") state = State(crystal_temperature=state_to_float(temp), crystal_temperature_setpoint=state_to_float(tempSet), etalon_angle=state_to_float(etalon), seed_voltage=state_to_float(seed)) return state version = Instrument.measurement("ver", "Get the firmware version.", cast=str) # type: ignore temperature_setpoint = Instrument.control( "state", "temp %.3f", "Control the crystal temperature setpoint in °C.", separator="\n\r", cast=str, # type: ignore get_process_list=generate_state_extraction_method(0), validator=strict_range, values=[30, 100], check_set_errors=True, ) etalon = Instrument.control( "state", "etalon %.3f", "Control the etalon angle in degrees.", separator="\n\r", cast=str, # type: ignore get_process_list=generate_state_extraction_method(1), validator=strict_range, values=[-12, 12], check_set_errors=True, ) seed_voltage = Instrument.control( "state", "seed %.3f", "Control the seed source tuning voltage.", separator="\n\r", cast=str, # type: ignore get_process_list=generate_state_extraction_method(2), validator=strict_range, values=[0, 5], check_set_errors=True, ) temperature = Instrument.measurement( "state", "Get the current crystal temperature in °C.", separator="\n\r", cast=str, # type: ignore get_process_list=generate_state_extraction_method(3), ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0095425 pymeasure-0.16.0/pymeasure/instruments/advantest/0000755000175100017510000000000015203313301021643 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/advantest/__init__.py0000644000175100017510000000241215203313266023765 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .advantestR3767CG import AdvantestR3767CG from .advantestR624X import AdvantestR6245 from .advantestR624X import AdvantestR6246 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/advantest/advantestR3767CG.py0000644000175100017510000000534715203313266025114 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_range class AdvantestR3767CG(SCPIUnknownMixin, Instrument): """ Represents the Advantest R3767CG VNA. Implements controls to change the analysis range and to retrieve the data for the trace. """ def __init__(self, adapter, name="Advantest R3767CG", **kwargs): super().__init__( adapter, name, **kwargs ) # Tell unit to operate in IEEE488.2-1987 command mode. self.write("OLDC OFF") id = Instrument.measurement( "*IDN?", """Get the instrument identification.""" ) center_frequency = Instrument.control( ":FREQ:CENT?", ":FREQ:CENT %d", """Control the center Frequency in Hz.""", validator=strict_range, values=[300000, 8000000000] ) span_frequency = Instrument.control( ":FREQ:SPAN?", ":FREQ:SPAN %d", """Control the frequency span in Hz.""", validator=strict_range, values=[1, 8000000000] ) start_frequency = Instrument.control( ":FREQ:STAR?", ":FREQ:STAR %d", """Control the starting frequency in Hz.""", validator=strict_range, values=[1, 8000000000] ) stop_frequency = Instrument.control( ":FREQ:STOP?", ":FREQ:STOP %d", """Control the stopping frequency in Hz.""", validator=strict_range, values=[1, 8000000000] ) trace_1 = Instrument.measurement( "TRAC:DATA? FDAT1", """Get the data array from trace 1 after formatting.""" ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/advantest/advantestR624X.py0000644000175100017510000034636615203313266024750 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from enum import IntEnum, IntFlag from warnings import warn from pymeasure.instruments import Instrument, Channel from pymeasure.instruments.validators import truncated_range, strict_discrete_set, \ strict_range # Setup logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class SampleHold(IntEnum): MODE_0 = 0 MODE_100uS = 6 MODE_200uS = 7 MODE_500uS = 8 MODE_1mS = 9 MODE_2mS = 10 MODE_5mS = 11 MODE_10mS = 12 MODE_1PLC = 13 # Number of power line cycles MODE_2PLC = 14 MODE_5PLC = 15 MODE_10PLC = 16 MODE_20PLC = 17 class SampleMode(IntEnum): ASYNC = 1 # Asynchronous operation PULSED_SYNC = 2 # Synchronous operation of DC measurement and pulse measurement PULSED_POSITIVE = 3 # Positive tracking operation for DC measurement and pulse measurement PULSED_REVERSE = 4 # DC measurement, pulse measurement reverse polarity tracking operation SWEEP_SYNC = 5 # Synchronous operation of sweep measurement SWEEP_DELAYED = 6 # Delayed sweep operation SWEEP_DOUBLE = 7 # Double synchronous sweep operation BINARY_SEARCH = 8 # Binary search LINEAR_SEARCH = 9 # Linear search class VoltageRange(IntEnum): # When the integration time is sample hold mode (SH) and between 100 μs to 500 μs, the # resolution is as follows. # # Integration time Decomposition energy (digit) # SH, 100μs 10 digits # 200μs 5 digits # 500μs 2 digits # The range that maximizes the number of digits in the measurement data is automatically # selected. # It cannot be specified for pulse measurement and pulse sweep. AUTO = 0 # ±1μV resolution # Limited auto range # It operates in the same way as the auto range except that the specified range is minimized. # It cannot be specified for pulse measurement and pulse sweep. AUTO_600mV = 23 # ±1μV resolution AUTO_6V = 24 # ±10μV resolution AUTO_60V = 25 # ±100μV resolution AUTO_200V = 26 # ±1mV resolution # Best fixed range # - Voltage generation When measuring voltage (VSVM), the range is the same as the generation # range. # - In the case of current generation voltage measurement (ISVM), it is in the same range as the # compliance range. FIXED_BEST = 20 # ±1μV - 1mV resolution # Measure in the specified range. FIXED_600mV = 3 # ±1μV resolution FIXED_6V = 4 # ±10μV resolution FIXED_60V = 5 # ±100μV resolution FIXED_200V = 6 # ±1mV resolution class CurrentRange(IntEnum): """Current measurement/source range selection. .. warning:: ``AUTO`` and ``AUTO_*`` (limited auto) ranges cannot be used for pulse measurement or pulse sweep. Using them in pulsed modes causes error 00211 ("command cannot be executed in current settings"). Use a fixed range such as ``FIXED_BEST`` instead. When the integration time is sample hold mode (SH) and between 100 μs to 500 μs, the resolution is reduced (10 digits at 100 μs, 5 at 200 μs, 2 at 500 μs). """ #: Auto range — automatically selects the range that maximizes digits. #: **Cannot be used for pulse measurement or pulse sweep.** AUTO = 0 # ±10fA resolution #: Limited auto range (minimum = 6nA). Same as auto but with a floor. #: **Cannot be used for pulse measurement or pulse sweep.** AUTO_6nA = 23 # ±10fA resolution AUTO_60nA = 24 # ±100fA resolution AUTO_600nA = 25 # ±1pA resolution AUTO_6μA = 26 # ±10pA resolution AUTO_60μA = 27 # ±100pA resolution AUTO_600μA = 28 # ±1nA resolution AUTO_6mA = 29 # ±10nA resolution AUTO_60mA = 30 # ±100nA resolution AUTO_600mA = 31 # ±1μA resolution AUTO_2A_6A = 32 # ±10μA resolution AUTO_20A = 33 # ±100μA resolution # Current generation when measuring current (ISIM), the range is the same as the generation # range. When measuring voltage generation current (VSIM), it is in the same # range as the compliance range. FIXED_BEST = 20 # ±10fA - ±100μA resolution # A fixed range cannot be specified for internal measurements. # It can be specified only for external measurement. MEASURE INPUT-ANALOG COMMON # Also measures the voltage between the terminals as the specified current range data. FIXED_6nA = 3 # ±10fA resolution FIXED_60nA = 4 # ±100fA resolution FIXED_600nA = 5 # ±1pA resolution FIXED_6μA = 6 # ±10pA resolution FIXED_60μA = 7 # ±100pA resolution FIXED_600μA = 8 # ±1nA resolution FIXED_6mA = 9 # ±10nA resolution FIXED_60mA = 10 # ±100nA resolution FIXED_600mA = 11 # ±1μA resolution FIXED_2A_6A = 12 # ±10μA resolution FIXED_20A = 13 # ±100μA resolution class SweepMode(IntEnum): LINEAR_ONE_WAY_SWEEP = 1 LOG_ONE_WAY_SWEEP = 2 LINEAR_ROUND_TRIP_SWEEP = 3 LOG_ROUND_TRIP_SWEEP = 4 class OutputType(IntEnum): REAL_TIME_OUTPUT = 1 # there is output every time it is measured BUFFERING_OUTPUT_ALL = 2 # output all at once after sweeping BUFFERING_OUTPUT_SPECIFIED = 3 # After sweeping, only output the specified data class TriggerInputType(IntEnum): ALL = 1 SOFTWARE_ONLY = 2 CHANNELS_ONLY = 3 class MeasurementType(IntEnum): MEASURE_DATA = 1 MEASURE_DATA_AND_OCCURENCE = 2 class SequenceInterruptionType(IntEnum): """ 1. Release pause state is a valid command only in the sequence program pause state. otherwise it is ignored. 2. Pause state enters the pause state when the currently executing program ends. 3. Abort sequence program stops the sequence program when the currently executing program ends. If the currently running program is a sweep operation, interrupt the sweep operation and stop the sequence program. The output value will be the bias value. """ RELEASE_PAUSE = 1 PAUSE = 2 INTERRUPT_SEQUENCE = 3 class DOR(IntFlag): """ bit assigment for the Device Operation Register (DOR): ========= ========================== Bit (dec) Description ========= ========================== 13 Indicates that the fast tokens program is running. 12 Error in search measurement 11 End of sequence program/high-speed sequence program execution 10 Sequence program Pause state 9 Fan stop detection 8 Self-test error occurred (logic part) 7 Trigger wait state in trigger link master operation 6 Calibration mode status 5 Trigger link ON state 4 Trigger link bus error 3 Sequence program/high-speed sequence 1 program/add/de) waiting 2 Wait for sequence program wait time 1 Sequence program running 0 Synchronous operation state ========= ========================== """ FAST_TOKENS_PROGRAM_IS_RUNNING = 1 << 13 ERROR_IN_SEARCH_MEASUREMENT = 1 << 12 END_OF_SEQUENCE_PROGRAM = 1 << 11 SEQUENCE_PROGRAM_PAUSE_STATE = 1 << 10 FAN_STOP_DETECTION = 1 << 9 SELF_TEST_ERROR_LOGIC = 1 << 8 TRIGGER_WAIT_STATE = 1 << 7 CALIBRATION_MODE_STATUS = 1 << 6 TRIGGER_LINK_ON_STATE = 1 << 5 TRIGGER_LINK_BUS_ERROR = 1 << 4 SEQUENCE_PROGRAM_WAITING = 1 << 3 WAIT_FOR_SEQUENCE_PROGRAM_WAIT_TIME = 1 << 2 SEQUENCE_PROGRAM_RUNNING = 1 << 1 SYNCHRONOUS_OPERATION_STATE = 1 << 0 class COR(IntFlag): """ bit assigment for the Channel Operations Register (COR): ========= ============================================= Bit (dec) Description ========= ============================================= 14 The result of the comparison operation is HI 13 The result of the comparison operation is GO 12 The result of the comparison operation is LO 11 Overheat detection 10 Overload detection 9 Oscillation detection 8 Compliance detection 7 Synchronous operation master channel 6 Measurement data output specification 5 There is measurement data 4 Self-test error occurrence (analog part) 3 Measurement data buffer full 2 Waiting for trigger 1 End of sweep 0 Operated state ========= ============================================= """ COMPARISON_RESULT_HI = 1 << 14 COMPARISON_RESULT_GO = 1 << 13 COMPARISON_RESULT_LO = 1 << 12 OVERHEAT_DETECTION = 1 << 11 OVERLOAD_DETECTION = 1 << 10 OSCILLATION_DETECTION = 1 << 9 COMPLIANCE_DETECTION = 1 << 8 SYNCHRONOUS_OPERATION_MASTER_CHANNEL = 1 << 7 MEASUREMENT_DATA_OUTPUT_SPECIFICATION = 1 << 6 HAS_MEASUREMENT_DATA = 1 << 5 SELF_TEST_ERROR_ANALOG_SECTION = 1 << 4 MEASUREMENT_DATA_BUFFER_FULL = 1 << 3 WAITING_FOR_TRIGGER = 1 << 2 END_OF_SWEEP = 1 << 1 OPERATED_STATE = 1 << 0 class SRER(IntFlag): """ bit assigment for the Service Request Enable Register (SRER): ========= =========================================================== Bit (dec) Description ========= =========================================================== 0 none 1 ERR Set when any of QYE, DDE, EXE, or CME in the Standard Event Status Register (SESR) is set. 2 DOP Set when a bit in the device operation register for which the enable register is set to enabled is set. Cleared by reading the device operation register. 3 none 4 MAV Set when output data is set in the output queue. Cleared when output data is read. 5 ESB Set when a bit in the Standard Event Status Register (SESR) is set and the enable register is set to Enabled. Cleared by reading SESR. 6 RQS (MSS) Set when bit O to bit 5 and bit 7 of the Status Byte register are set. (this bit is read-only) 7 COP Set when a bit in the Channel Operations Register is set with the Enable Register set to Enable. Cleared by reading the Channel Operations Register. ========= =========================================================== """ ERR = 1 << 1 DOP = 1 << 2 MAV = 1 << 4 ESB = 1 << 5 RQS = 1 << 6 COP = 1 << 7 class SESR(IntFlag): """ bit assigment for the Standard Event Status Register (SESR): ========= ========================== Bit (dec) Description ========= ========================== 0 OPC (Operation Complete) not used 1 RQC unused 2 QYE (Query Error) Set when the output queue overflows when reading without output data. 3 DDE (Device Dependent Error) Set when an error occurs in the self-test. 4 EXE (Execution Error) Set when the input data is outside the range set internally, or when the command cannot be executed. 5 CME (Command Error) Set when an undefined header or data format is wrong, or when there is a syntax error in the command. 6 URQ unused 7 PON Set when power is switched from OFF to ON. ========= ========================== """ OPC = 1 << 0 RQC = 1 << 1 QYE = 1 << 2 DDE = 1 << 3 EXE = 1 << 4 CME = 1 << 5 URQ = 1 << 6 PON = 1 << 7 class TriggerOutputSignalTiming(IntFlag): """ bit assigment for the timing of the trigger output signal output from TRIGGER OUT on the rear panel: ========= ============================= Bit (dec) Description ========= ============================= 5 At the end of the sweep 4 At the end of the pulse width 3 At the end of the pulse cycle 2 At the end of measurement 1 At the start of measurement 0 At the start of occurrence ========= ============================= """ END_OF_SWEEP = 1 << 5 END_OF_THE_PULSE_WIDTH = 1 << 4 END_OF_THE_PULSE_CYCLE = 1 << 3 END_OF_MEASUREMENT = 1 << 2 START_OF_MEASUREMENT = 1 << 1 START_OF_OCCURRENCE = 1 << 0 class SearchMode(IntEnum): BINARY_SENSE = 1 BINARY_SEARCH_NEGATIVE = 2 BINARY_SEARCH_POSITIVE = 3 LINEAR_SENSE = 4 LINEAR_SEARCH = 5 class OccurrenceAfterStop(IntEnum): GENERATE_BIAS = 1 LEAVE_AS_IS = 2 GENERATE_STOP = 3 class HighSpeedTriggerMode(IntEnum): CONTINUOUS = 1 STEP = 2 EXECUTION_TRIGGER = 3 class JumpCondition(IntEnum): HI_PROCEED = 1 GO_PROCEED = 2 LO_PROCEED = 3 FAIL_PROCEED = 4 CANCEL = 5 UNCONDITIONAL = 6 HI_STAY = 7 GO_STAY = 8 LO_STAY = 9 FAIL_STAY = 10 class ProgramClearMode(IntEnum): SPECIFIED_ONLY = 1 SPECIFIED_AND_SUBSEQUENT = 2 class ComparisonMode(IntEnum): """Comparison mode for search comparison setup.""" OFF = 1 ON_WITH_POLARITY = 2 ON_WITH_ABS_VALUE = 3 class ComparisonValueType(IntEnum): """Value type for search comparison setup.""" VOLTAGE = 1 CURRENT = 2 class SequenceWaitMode(IntEnum): """Wait mode for the WAIT sequence command.""" WAIT_TIME = 1 TRIGGER_COUNT = 2 HIGHSPEED_SEQUENCE_COMMANDS = [ # Unconditional commands 'dv', 'di', 'pv', 'pi', 'wt', 'mst', 'rv', 'ri', 'cmd', 'cn', 'cl', 'opm', 'fl', 'ltl', 'dios', 'dioe', 'ext', 'pcel', 'mar', 'nent', # MAR-context commands (used within MAR~;NENT blocks) 'fxv', 'fxi', 'pxv', 'pxi', 'wv', 'wi', 'pwv', 'pwi', # JM command 'jm', ] def map_values(value, values): return values[strict_discrete_set(value, values)] # --- Sequence command builder functions --- # These return formatted command strings for use with # store_highspeed_sequence(), store_sequence_command(), and # search_measurement_setup(). def seq_voltage_source(channel, source_range, source_value, compliance): """Build a DV (DC voltage source) command string. :param int channel: Channel number (1=A, 2=B). :param source_range: Voltage source range. :type source_range: int or :class:`.VoltageRange` :param float source_value: Source voltage value. :param float compliance: Current compliance value. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) source_range = VoltageRange(source_range) return f'dv {channel},{source_range.value},{source_value:.4e},{compliance:.4e}' def seq_current_source(channel, source_range, source_value, compliance): """Build a DI (DC current source) command string. :param int channel: Channel number (1=A, 2=B). :param source_range: Current source range. :type source_range: int or :class:`.CurrentRange` :param float source_value: Source current value. :param float compliance: Voltage compliance value. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) source_range = CurrentRange(source_range) return f'di {channel},{source_range.value},{source_value:.4e},{compliance:.4e}' def seq_voltage_pulsed_source(channel, source_range, pulse_value, base_value, compliance): """Build a PV (pulsed voltage source) command string. :param int channel: Channel number (1=A, 2=B). :param source_range: Voltage source range. :type source_range: int or :class:`.VoltageRange` :param float pulse_value: Pulse voltage value. :param float base_value: Base voltage value. :param float compliance: Current compliance value. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) source_range = VoltageRange(source_range) return (f'pv {channel},{source_range.value},{pulse_value:.4e},' f'{base_value:.4e},{compliance:.4e}') def seq_current_pulsed_source(channel, source_range, pulse_value, base_value, compliance): """Build a PI (pulsed current source) command string. :param int channel: Channel number (1=A, 2=B). :param source_range: Current source range. :type source_range: int or :class:`.CurrentRange` :param float pulse_value: Pulse current value. :param float base_value: Base current value. :param float compliance: Voltage compliance value. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) source_range = CurrentRange(source_range) return (f'pi {channel},{source_range.value},{pulse_value:.4e},' f'{base_value:.4e},{compliance:.4e}') def seq_measure_voltage(channel, enable=True, internal_measurement=True, voltage_range=VoltageRange.AUTO): """Build an RV (voltage measurement) command string. :param int channel: Channel number (1=A, 2=B). :param bool enable: Enable voltage measurement. :param bool internal_measurement: Use internal measurement input. :param voltage_range: Voltage measurement range. :type voltage_range: int or :class:`.VoltageRange` :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) voltage_range = VoltageRange(voltage_range) enable = map_values(enable, {True: 1, False: 2}) internal_measurement = map_values(internal_measurement, {True: 1, False: 2}) return f'rv {channel},{enable},{internal_measurement},{voltage_range.value}' def seq_measure_current(channel, enable=True, internal_measurement=True, current_range=CurrentRange.AUTO): """Build an RI (current measurement) command string. :param int channel: Channel number (1=A, 2=B). :param bool enable: Enable current measurement. :param bool internal_measurement: Use internal measurement input. :param current_range: Current measurement range. :type current_range: int or :class:`.CurrentRange` :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) current_range = CurrentRange(current_range) enable = map_values(enable, {True: 1, False: 2}) internal_measurement = map_values(internal_measurement, {True: 1, False: 2}) return f'ri {channel},{enable},{internal_measurement},{current_range.value}' def seq_timing_parameters(channel, hold_time, measurement_delay, pulsed_width, pulsed_period): """Build a WT (timing parameters) command string. :param int channel: Channel number (1=A, 2=B). :param float hold_time: Hold time in seconds. :param float measurement_delay: Measurement delay time in seconds. :param float pulsed_width: Pulse width in seconds. :param float pulsed_period: Pulse period in seconds. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) return (f'wt {channel},{hold_time:.4e},{measurement_delay:.4e},' f'{pulsed_width:.4e},{pulsed_period:.4e}') def seq_sample_hold_mode(channel, mode): """Build an MST (sample/hold mode) command string. :param int channel: Channel number (1=A, 2=B). :param mode: Integration time mode. :type mode: int or :class:`.SampleHold` :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) mode = SampleHold(mode) return f'mst {channel},{mode.value}' def seq_comparison_limits(channel, comparison, voltage_value, upper_limit, lower_limit): """Build a CMD (comparison limits) command string. :param int channel: Channel number (1=A, 2=B). :param bool comparison: Enable comparison (True=ON, False=OFF). :param bool voltage_value: True for voltage, False for current. :param float upper_limit: Upper comparison limit. :param float lower_limit: Lower comparison limit. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) comparison = map_values(comparison, {True: 2, False: 1}) voltage_value = map_values(voltage_value, {True: 1, False: 2}) return (f'cmd {channel},{comparison},{voltage_value},' f'{upper_limit:.4e},{lower_limit:.4e}') def seq_enable_source(channel): """Build a CN (enable output) command string. :param int channel: Channel number (1=A, 2=B). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) return f'cn {channel}' def seq_standby(channel): """Build a CL (standby/disable output) command string. :param int channel: Channel number (1=A, 2=B). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) return f'cl {channel}' def seq_relay_mode(channel, mode): """Build an OPM (relay mode) command string. :param int channel: Channel number (1=A, 2=B). :param int mode: Relay mode (1-4). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) mode = strict_discrete_set(mode, [1, 2, 3, 4]) return f'opm {channel},{mode}' def seq_fast_mode(channel, fast): """Build an FL (fast/slow response) command string. :param int channel: Channel number (1=A, 2=B). :param bool fast: True for fast response, False for slow. :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) fast = map_values(fast, {True: 1, False: 2}) return f'fl {channel},{fast}' def seq_voltage_fixed_level_sweep(channel, voltage_range, voltage_level, measurement_count, current_compliance, bias=0): """Build an FXV (fixed level voltage sweep) command string. :param int channel: Channel number (1=A, 2=B). :param voltage_range: Voltage source range. :type voltage_range: int or :class:`.VoltageRange` :param float voltage_level: Voltage level value. :param int measurement_count: Number of measurements. :param float current_compliance: Current compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) voltage_range = VoltageRange(voltage_range) return (f'fxv {channel},{voltage_range.value},{voltage_level:.4e},' f'{measurement_count},{current_compliance:.4e},{bias:.4e}') def seq_current_fixed_level_sweep(channel, current_range, current_level, measurement_count, voltage_compliance, bias=0): """Build an FXI (fixed level current sweep) command string. :param int channel: Channel number (1=A, 2=B). :param current_range: Current source range. :type current_range: int or :class:`.CurrentRange` :param float current_level: Current level value. :param int measurement_count: Number of measurements. :param float voltage_compliance: Voltage compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) current_range = CurrentRange(current_range) return (f'fxi {channel},{current_range.value},{current_level:.4e},' f'{measurement_count},{voltage_compliance:.4e},{bias:.4e}') def seq_voltage_fixed_pulsed_sweep(channel, voltage_range, pulse, base, measurement_count, current_compliance, bias=0): """Build a PXV (fixed pulsed voltage sweep) command string. :param int channel: Channel number (1=A, 2=B). :param voltage_range: Voltage source range. :type voltage_range: int or :class:`.VoltageRange` :param float pulse: Pulse voltage value. :param float base: Base voltage value. :param int measurement_count: Number of measurements. :param float current_compliance: Current compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) voltage_range = VoltageRange(voltage_range) return (f'pxv {channel},{voltage_range.value},{pulse:.4e},{base:.4e},' f'{measurement_count},{current_compliance:.4e},{bias:.4e}') def seq_current_fixed_pulsed_sweep(channel, current_range, pulse, base, measurement_count, voltage_compliance, bias=0): """Build a PXI (fixed pulsed current sweep) command string. :param int channel: Channel number (1=A, 2=B). :param current_range: Current source range. :type current_range: int or :class:`.CurrentRange` :param float pulse: Pulse current value. :param float base: Base current value. :param int measurement_count: Number of measurements. :param float voltage_compliance: Voltage compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) current_range = CurrentRange(current_range) return (f'pxi {channel},{current_range.value},{pulse:.4e},{base:.4e},' f'{measurement_count},{voltage_compliance:.4e},{bias:.4e}') def seq_voltage_sweep(channel, sweep_mode, repeat, voltage_range, start_value, stop_value, steps, current_compliance, bias=0): """Build a WV (staircase voltage sweep) command string. :param int channel: Channel number (1=A, 2=B). :param sweep_mode: Sweep mode. :type sweep_mode: int or :class:`.SweepMode` :param int repeat: Number of repeats (0-1024). :param voltage_range: Voltage source range. :type voltage_range: int or :class:`.VoltageRange` :param float start_value: Start voltage value. :param float stop_value: Stop voltage value. :param int steps: Number of steps (2-2048). :param float current_compliance: Current compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) voltage_range = VoltageRange(voltage_range) return (f'wv {channel},{sweep_mode.value},{repeat},{voltage_range.value},' f'{start_value:.4e},{stop_value:.4e},{steps},' f'{current_compliance:.4e},{bias:.4e}') def seq_current_sweep(channel, sweep_mode, repeat, current_range, start_value, stop_value, steps, voltage_compliance, bias=0): """Build a WI (staircase current sweep) command string. :param int channel: Channel number (1=A, 2=B). :param sweep_mode: Sweep mode. :type sweep_mode: int or :class:`.SweepMode` :param int repeat: Number of repeats (0-1024). :param current_range: Current source range. :type current_range: int or :class:`.CurrentRange` :param float start_value: Start current value. :param float stop_value: Stop current value. :param int steps: Number of steps (2-2048). :param float voltage_compliance: Voltage compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) current_range = CurrentRange(current_range) return (f'wi {channel},{sweep_mode.value},{repeat},{current_range.value},' f'{start_value:.4e},{stop_value:.4e},{steps},' f'{voltage_compliance:.4e},{bias:.4e}') def seq_voltage_pulsed_sweep(channel, sweep_mode, repeat, voltage_range, base, start_value, stop_value, steps, current_compliance, bias=0): """Build a PWV (pulsed voltage sweep) command string. :param int channel: Channel number (1=A, 2=B). :param sweep_mode: Sweep mode. :type sweep_mode: int or :class:`.SweepMode` :param int repeat: Number of repeats (0-1024). :param voltage_range: Voltage source range. :type voltage_range: int or :class:`.VoltageRange` :param float base: Base voltage value. :param float start_value: Start voltage value. :param float stop_value: Stop voltage value. :param int steps: Number of steps (2-2048). :param float current_compliance: Current compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) voltage_range = VoltageRange(voltage_range) return (f'pwv {channel},{sweep_mode.value},{repeat},{voltage_range.value},' f'{base:.4e},{start_value:.4e},{stop_value:.4e},{steps},' f'{current_compliance:.4e},{bias:.4e}') def seq_current_pulsed_sweep(channel, sweep_mode, repeat, current_range, base, start_value, stop_value, steps, voltage_compliance, bias=0): """Build a PWI (pulsed current sweep) command string. :param int channel: Channel number (1=A, 2=B). :param sweep_mode: Sweep mode. :type sweep_mode: int or :class:`.SweepMode` :param int repeat: Number of repeats (0-1024). :param current_range: Current source range. :type current_range: int or :class:`.CurrentRange` :param float base: Base current value. :param float start_value: Start current value. :param float stop_value: Stop current value. :param int steps: Number of steps (2-2048). :param float voltage_compliance: Voltage compliance value. :param float bias: Bias value (default 0). :rtype: str """ channel = strict_discrete_set(channel, [1, 2]) sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) current_range = CurrentRange(current_range) return (f'pwi {channel},{sweep_mode.value},{repeat},{current_range.value},' f'{base:.4e},{start_value:.4e},{stop_value:.4e},{steps},' f'{voltage_compliance:.4e},{bias:.4e}') def seq_sample_mode(mode, auto_sampling=True, channel=1): """Build a JM (sample mode) command string. :param mode: Sample mode. :type mode: int or :class:`.SampleMode` :param bool auto_sampling: Enable auto sampling. When True, measurement data is automatically output after each trigger. When False, data is output only on explicit request (e.g. ``FCH?``). Use False for dual-channel synchronous modes (``PULSED_SYNC``, ``SWEEP_SYNC``, etc.) to get actual measurement results. :param int channel: Channel number (1=A, 2=B). :rtype: str """ mode = SampleMode(mode) auto_sampling = map_values(auto_sampling, {True: 1, False: 2}) channel = strict_discrete_set(channel, [1, 2]) return f'jm {mode.value},{auto_sampling},{channel}' def seq_lo_common_relay(enable, lo_relay=None): """Build an LTL (LO common connection relay) command string. :param bool enable: Enable the connection relay. :param lo_relay: Enable internal analog common relay (None=no change). :type lo_relay: bool or None :rtype: str """ enable = map_values(enable, {True: 2, False: 1}) lo_relay = map_values(lo_relay, {True: 2, False: 1, None: 3}) return f'ltl 0,{enable},{lo_relay}' def seq_digital_output(values): """Build a DIOS (digital output) command string. :param values: Digital output bit values. :type values: int or list :rtype: str """ if isinstance(values, list): values = ','.join(str(i) for i in values) return f'dios 0,{values}' def seq_digital_output_enable(data): """Build a DIOE (digital output enable) command string. :param int data: Digital output enable data (0-65535). :rtype: str """ data = truncated_range(data, [0, 65535]) return f'dioe 0,{data}' def seq_conditional_jump(channel, condition, destination): """Build an EXT (conditional jump) command string. :param int channel: Channel selection (1=A, 2=B, 3=A|B OR). :param condition: Jump condition. :type condition: int or :class:`.JumpCondition` :param int destination: Jump destination program number (1-20). :rtype: str """ channel = strict_discrete_set(channel, [1, 2, 3]) condition = JumpCondition(condition) destination = truncated_range(destination, [1, 20]) return f'ext {channel},{condition},{destination}' def seq_clear_program(program_number, clear_mode): """Build a PCEL (program clear) command string. :param int program_number: Program number (1-20). :param clear_mode: Clear mode. :type clear_mode: int or :class:`.ProgramClearMode` :rtype: str """ program_number = truncated_range(program_number, [1, 20]) clear_mode = ProgramClearMode(clear_mode) return f'pcel {program_number},{clear_mode}' def seq_wait(wait_mode, wait_value): """Build a WAIT (sequence wait) command string. :param wait_mode: Wait mode (1=wait time, 2=trigger input count). :type wait_mode: int or :class:`.SequenceWaitMode` :param float wait_value: Wait time or trigger count. :rtype: str """ wait_mode = SequenceWaitMode(wait_mode) return f'wait {wait_mode},{wait_value}' def seq_join(*commands): """Join multiple sequence command strings with semicolons. :param commands: One or more command strings from ``seq_*`` functions. :rtype: str Example:: cmd = seq_join( seq_voltage_source(1, VoltageRange.FIXED_BEST, 5.0, 0.1), seq_enable_source(1), ) inst.store_highspeed_sequence(1, cmd) """ return ';'.join(commands) class AdvantestR624X(Instrument): """ Represents the Advantest R624X series (channel A and B) SourceMeter and provides a high-level interface for interacting with the instrument. This is the base class for both AdvantestR6245 and AdvantestR6246 devices. It's not necessary to instantiate this class directly instead create an instance of the AdvantestR6245 or AdvantestR6246 class as shown in the following example: .. code-block:: python smu = AdvantestR6246("GPIB::1") smu.reset() # Set default parameters smu.ch_A.current_source(source_range = CurrentRange.FIXED_60mA, source_value = 0, # Source current at 0 A voltage_compliance = 10) # Voltage compliance at 10 V smu.ch_A.enable_source() # Enables the source output smu.ch_A.measure_voltage() smu.ch_A.current_change_source = 5e-3 # Change to 5mA print(smu.read_measurement()) # Read and print the voltage smu.ch_A.standby() # Put channel A in standby """ def __init__(self, adapter, name="R624X Source meter Base Class", **kwargs): super().__init__(adapter, name, includeSCPI=False, **kwargs) self.sequence = [] self.store_to_sequence = False self.sequence_line_count = 0 def write(self, command, **kwargs): if self.store_to_sequence: self.append_sequence_command(command) else: super().write(command, **kwargs) def check_errors(self): """Check the error register and raise an exception if an error occurred.""" errors = { 100: "A fan stop was detected.", 101: "Since the overload detection of the {0} channel was activated, it was set to" "standby.", 102: "Since the overheat detection of the {0} channel worked, I made it a standby.", 200: "Received an undefined command.", 201: "There is an error in the data format.", 210: "Received data outside the set range.", 211: "A command was received that cannot be executed in the current settings.", 221: "Data output buffer overflowed.", } error = self.ask('err?') unit = int(error[0:2]) err = int(error[2:5]) channel = f'{"B" if unit > 1 else "A"}' if err in errors: message = errors[err].format(channel) elif err > 0 and err < 100: if unit == 0: message = "As a result of the self-test, an abnormality was found in the logic" \ "part." else: message = f"Result of self-test {channel}-channel was found to be abnormal." elif err > 99 and err < 200: message = "Internal error, calibration error" else: message = "Setting error" if err == 0: return else: raise OSError( f"{self.name} Error {error[0:5]}: {message}") def enable_source(self): """Enable channel A and B output (``CN``). .. note:: When the 'interlock control' of the 'SCT' command is '2' and the clock signal is 'HI', it will not enter the operating state. """ self.write('cn 0') def standby(self): """Put channel A and B in standby mode (``CL``).""" self.write('cl 0') def reset(self): """Reset the instrument to default settings (``*RST``).""" self.write('*rst') def clear_status_register(self): """Clear the Standard Event Status Register (SESR) and related queues (excluding output queues) (``*CLS``). """ self.write('*cls') srq_enabled = Instrument.setting( "s%d", """Set whether the GPIB SRQ feature is enabled (bool) (``S0/S1``). :type: bool The SRQ feature of the GPIB bus provides hardware handshaking between the GPIB controller card in the PC and the instrument. This allows synchronization between moving data to the PC with the state of the instrument without the need to use time delay functions. """, validator=strict_discrete_set, values={False: 1, True: 0}, map_values=True ) def trigger(self): """Output the trigger signal or start sweep and search measurement for both A and B channels and the trigger link (``XE``). .. note:: * When both A channel and B channel are waiting for a trigger, both channels are triggered. * When either channel A or B is waiting for a trigger, only the channel that is waiting for a trigger is triggered. * When both A channel and B channel are waiting for sweep start, this will apply sweep start to both channels. * When either channel A or B is in the sweep start waiting state, only the channel in the sweep start waiting state is started. * When either channel A or B is waiting for a trigger and the other is waiting for a sweep start, trigger and sweep start are applied, respectively. * When the trigger link is ON and this is the master unit, set the \\*TRG signal on the trigger link bus to TRUE. * When the trigger link is ON and the master unit, the trigger link is activated. """ self.write('xe 0') def stop(self): """Stop the sweep started by the XE command or the trigger input signal (``SP``).""" self.write('sp 0') def set_digital_output(self, values): """Output a 16-bit signal from the DIGITAL OUT output terminal on the rear panel (``DIOS``). If there are multiple values specified, the data is output at intervals of about 2ms and fixed as the final data. :param values: Digital out bit values :type values: int or list .. note:: The output of digital data to the DIGITAL OUT pin is only the bits specified by the DIOE command. Bits that are not specified will result in alarm output or unused, and no digital data will be output. """ if isinstance(values, list): values = [str(i) for i in values] values = ",".join(values) self.write(f'dios 0,{values}') sweep_delay_time = Instrument.setting( "gdly 0,%.4e", """Set the sweep delay time (Ta) or generation/delay time (Ta) of the master and slave channels during delayed sweep or synchronous pulse measurement operation (``GDLY``). :type: float .. note:: If the sweep delay time does not meet (Ta upper_limit: raise ValueError( f"Lower limit ({lower_limit}) must not exceed " f"upper limit ({upper_limit}).") self.write( f'mar 0,{search_mode},{occurrence_after_stop};' f'cmd {channel},{comparison},{comparison_function},' f'{upper_limit:.4e},{lower_limit:.4e};nent') def append_sequence_command(self, command): """Append a command to the sequence being recorded.""" valid_commands = [ 'jm', 'gdly', 'fl', 'dv', 'di', 'fxv', 'fxi', 'wv', 'wi', 'mdwv', 'mdwi', 'pv', 'pi', 'pxv', 'pxi', 'pwv', 'pwi', 'mpwv', 'mpwi', 'rv', 'ri', 'mst', 'wt', 'cm', 'cmd', 'nug', 'ofm', 'fmt', 'mbc', 'wm', 'cn', 'cl', 'opm', 'osl', 'ltl', 'tjm', 'xe', '*trg', 'tot', 'sct', 'osig', 'dios', 'dioe', 'ian', 'tlnk', 'wait', 'sav', 'rcl', '*sre', '*ese', '*cls', 'coe', 'doe'] if not self.store_to_sequence: raise ValueError("init_sequence() should be called first") for s in valid_commands: if s == command.lower()[:len(s)]: self.sequence.append(command) def init_sequence(self): """Start redirecting :meth:`~.write` calls to build a sequence program.""" self.sequence = [] self.store_to_sequence = True self.sequence_line_count = 0 def start_sequence(self, repeat=1): """Start the sequence program built by :meth:`~.init_sequence`.""" self.start_sequence_program(1, self.sequence_line_count, repeat) def end_sequence(self): """End sequence recording started by :meth:`~.init_sequence` and store the program.""" command = '' self.store_to_sequence = False for s in self.sequence: # Sequence memory has a maximum of 128x100 characters if len(command) + len(s) + 1 < 128: command += s + ';' else: self.sequence_line_count += 1 if self.sequence_line_count > 100: raise OSError( f"{self.name} Error out of sequence memory") self.store_sequence_command(self.sequence_line_count, command) command = s + ';' self.sequence_line_count += 1 self.store_sequence_command(self.sequence_line_count, command) self.sequence = [] def sequence_wait(self, wait_mode, wait_value): """Wait during sequence program execution (``WAIT``). :param wait_mode: Whether wait time (1) or trigger input count (2) is specified. :type wait_mode: int or :class:`.SequenceWaitMode` :param float wait_value: Wait time or trigger input count as specified by wait_mode. This command has the following functions: * Make the execution of the next program wait for the specified time. * Makes the next program execution wait until the specified number of triggers is input. Regardless of the wait mode, if the wait data is 0, the wait operation is not performed. When the wait mode is "2", the following commands and signals can be used as trigger inputs: * XE (XE 0, XE 1, XE 2) * \\*TRG * GET command (group execute trigger) * Trigger input signal on rear panel """ wait_mode = SequenceWaitMode(wait_mode) self.write(f'wait {wait_mode},{wait_value}') def start_sequence_program(self, start, stop, repeat): """Execute the sequence program from start to stop line, repeating as specified (``RU``). :param int start: Number of the program to start from ranging 1 to 100 :param int stop: Number of the program to stop at ranging from 1 to 100 :param int repeat: Number of times repeated from 1 to 100 """ start = truncated_range(start, [1, 100]) stop = truncated_range(stop, [1, 100]) repeat = truncated_range(repeat, [1, 100]) self.write(f'ru 0,{start},{stop},{repeat}') def store_sequence_command(self, line, command): """Store a command string at the specified sequence program line (``ST``). :param int line: Line number specified of memory location :param str command: Command(s) specified to be stored delimited by a semicolon (;) """ line = truncated_range(line, [1, 100]) if command[-1:] != ';': command += ';' self.write(f'st {line};{command}end') def interrupt_sequence(self, action): """Interrupt the sequence program executed by :py:meth:`~start_sequence_program` (``SQSP``). :param action: Specifies sequence interruption setup :type action: :class:`SequenceInterruptionType` """ action = SequenceInterruptionType(action) self.write(f'sqsp {action}') def interrupt_sequence_command(self, action): """Interrupt the sequence program. .. deprecated:: 0.16 Use :meth:`interrupt_sequence` instead. """ warn("`interrupt_sequence_command` is deprecated, use " "`interrupt_sequence` instead.", FutureWarning) return self.interrupt_sequence(action) sequence_program_number = Instrument.measurement( "lnub?", """Get the number of program sequences stored in sequence memory (``LNUB?``). The response has the format ``#3XXX,line1,line2,...`` where ``XXX`` is a 3-digit count of stored programs and the remaining values are line numbers. This property returns only the count as an integer. """, cast=int, preprocess_reply=lambda v: v[2:5] if v.startswith('#') else v, ) def query_sequence_program(self, line): """Query the commands stored at a sequence program line (``LST?``). :param int line: Line number specifying the memory location to read. :return: Commands stored in sequence memory. :rtype: str """ line = truncated_range(line, [1, 100]) return self.ask(f'lst? {line}') def sequence_program_listing(self, line): """Query the commands stored at a sequence program line. .. deprecated:: 0.16 Use :meth:`query_sequence_program` instead. """ warn("`sequence_program_listing` is deprecated, use " "`query_sequence_program` instead.", FutureWarning) return self.query_sequence_program(line) def store_highspeed_sequence(self, program_number, command): """Store commands in a high-speed sequence program number (``PGST~;END``). :param int program_number: Program number from 1 to 20. :param str command: Semicolon-delimited command string to store. .. note:: This method should not be called while a standard sequence is being built (between :meth:`~.init_sequence` and :meth:`~.end_sequence`), as the write will be intercepted by the standard sequence system. """ program_number = truncated_range(program_number, [1, 20]) if command.endswith(';'): command = command[:-1] for subcmd in command.split(';'): prefix = subcmd.strip().split()[0].lower() if subcmd.strip() else '' if prefix and prefix not in HIGHSPEED_SEQUENCE_COMMANDS: raise ValueError( f"Command '{subcmd.strip()}' is not allowed in " f"high-speed sequence programs.") self.write(f'pgst {program_number};{command};end') def conditional_jump(self, channel, condition, destination): """Set a conditional jump in a high-speed sequence program (``EXT``). :param int channel: Channel selection (1=A, 2=B, 3=A|B OR condition). :param condition: Jump condition. :type condition: int or :class:`.JumpCondition` :param int destination: Jump destination program number (1 to 20). .. note:: - Conditions 1-4: proceed to the next program if condition is not met. - Conditions 7-10: stay at the current program if condition is not met. - Condition 5: cancel conditional jump. - Condition 6: jump unconditionally (channel data is ignored). - Destination must be >= current program number to be executed. """ channel = strict_discrete_set(channel, [1, 2, 3]) condition = JumpCondition(condition) destination = truncated_range(destination, [1, 20]) self.write(f'ext {channel},{condition},{destination}') def enable_highspeed_sequence(self, trigger_mode): """Enable the start of a high-speed sequence program (``PGON``). :param trigger_mode: Trigger mode for program execution. :type trigger_mode: int or :class:`.HighSpeedTriggerMode` Trigger modes: 1. Continuous: executes all programs sequentially on one trigger. 2. Step: executes one program per trigger. 3. Execution trigger measurement: applies settings, then waits for a trigger before each measurement. .. note:: Store programs in program numbers 1-20 using :meth:`~.store_highspeed_sequence` before calling this method. Program numbers without stored programs are skipped. """ trigger_mode = HighSpeedTriggerMode(trigger_mode) self.write(f'pgon 0,{trigger_mode}') def disable_highspeed_sequence(self): """Cancel the start/enable state of the high-speed sequence program set by :meth:`~.enable_highspeed_sequence` (``PGOF``). """ self.write('pgof') def clear_highspeed_sequence(self, program_number, clear_mode): """Clear program(s) stored in high-speed sequence memory (``PCEL``). :param int program_number: Program number from 1 to 20. :param clear_mode: Clear mode. :type clear_mode: int or :class:`.ProgramClearMode` Clear modes: 1. Clear only the specified program number. 2. Clear the specified program number and all subsequent programs. """ program_number = truncated_range(program_number, [1, 20]) clear_mode = ProgramClearMode(clear_mode) self.write(f'pcel {program_number},{clear_mode}') def trigger_output_signal(self, trigger_output, alarm_output, scanner_output): """Output the trigger, alarm, and scanner (start/stop) signals from GPIB (``OSIG``). :param int trigger_output: Number specifying type of trigger output :param int alarm_output: Number specifying type of alarm output :param int scanner_output: Number specifying the type of scanner output Trigger output: 1. Do not output to trigger output. 2. Output a negative pulse to the trigger output. Alarm output: 1. Finish output GO, LO.HI both set to HI level. (reset) 2. Finish output Set GO to LO level. 3. Set home output LO to LO level. 4. Terminate output HI to LO level. Scanner - (start/stop) output: 1. Set the scanner scoot output to HI level. Output a negative pulse to the stop output. 2. Make the scanner start output low. 3. Output a HI level for the scanner start output and a negative pulse for the stop output. """ trigger_output = strict_discrete_set(trigger_output, [1, 2]) alarm_output = strict_discrete_set(alarm_output, [1, 2, 3, 4]) scanner_output = strict_discrete_set(scanner_output, [1, 2, 3]) self.write(f'osig 0,{trigger_output},{alarm_output},{scanner_output}') def set_output_format(self, delimiter_format, block_delimiter, terminator): """Set the format and terminator of the GPIB output data (``FMT``). :param int delimiter_format: Type of delimiter format :param int block_delimiter: Type of block delimiter :param int terminator: Type of termination character The output of (End or Identify) is output at the following timing: 1,2: Simultaneously with LF 4: Simultaneously with the last output data If the output data format is specified as binary format, the terminator is fixed to only and the terminator selection is ignored. delimiter_format: 1. ASCII format with header 2. No header, ASCII format 3. Binary format block_delimiter: 1. Make it the same as the terminator. 2. Use semicolon ; 3. Use comma , terminator: 1. CR, LF 2. LF 3. LF 4. === ================================================================================= 1st character header: ------------------------------------------------------------------------------------- A) Normal measurement data B) Measurement data during overrange C) Compliance (limiter) is working. D) Oscillation detection is working. E) [Indicates the generated data] F) Measurement data when an error occurs in the search measurement Z) Measurement data is not stored in the buffer memory. === ================================================================================= === ================================================================================= 2nd character header: ------------------------------------------------------------------------------------- A) A-channel data during asynchronous operation (A-channel generation data) B) B-channel data during asynchronous operation (B channel generation data) I) A-channel data for synchronous, sweeping, delayed sweep, and double synchronous sweep operations. J) B-channel data for synchronous, sweeping, delayed sweep, and double synchronous sweep operations. === ================================================================================= === ================================================================================= 3rd character header: ------------------------------------------------------------------------------------- A) Current generation, voltage measurement (ISVM) [Current generation] B) Voltage generation, current measurement (VSIM) [Voltage generation] C) Current generation, current measurement (ISIM) D) Voltage generation, voltage measurement (VSVM) E) Current generation, external voltage measurement (IS, EXT, VM) F) Voltage generation, external current measurement (VS, EXT, IM) G) Current generation, external current measurement (IS, EXT. IM) H) Voltage generation, external voltage measurement (VS, EXT, VM) Z) The measurement data is not stored in the buffer memory. === ================================================================================= === ================================================================================= 4th character header: ------------------------------------------------------------------------------------- A) No operation (fixed to A) B) Null operation result C) The result of the comparison operation is GO. D) The result of the comparison operation is LO. E) The result of the comparison operation is HI. F) The result of null operation + comparison operation is GO. G) The result of null operation + comparison operation is LO. H) The result of null operation + comparison operation is HI. Z) Measurement data is not stored in the buffer memory. === ================================================================================= """ delimiter_format = strict_discrete_set(delimiter_format, [1, 2, 3]) block_delimiter = strict_discrete_set(block_delimiter, [1, 2, 3]) terminator = strict_discrete_set(terminator, [1, 2, 3, 4]) self.write(f'fmt 0,{delimiter_format},{block_delimiter},{terminator}') service_request_enable_register = Instrument.control( '*sre?', '*sre %i', """Control the service request enable register (SRER) as a :class:`SRER` ``IntFlag`` (``*SRE``). .. note:: Bits other than the RQS bit are not cleared by serial polling. When :meth:`~.power_on_clear` is set, status byte enable register, SESER, device operation enable register, channel operation, the enable register is cleared and no SRQ is issued. """, validator=truncated_range, values=[0, 255], get_process=lambda v: SRER(int(v)), ) event_status_enable = Instrument.control( '*ese?', '*ese %i', """Control the standard event status enable register (``*ESE``).""", validator=truncated_range, values=[0, 255], ) power_on_clear = Instrument.control( '*psc?', '*psc %i', """Control the power-on clear flag (bool) (``*PSC``).""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) device_operation_enable_register = Instrument.control( 'doe?', 'doe %i', """Control the device operation output enable register (DOER) (``DOE?``).""", validator=truncated_range, values=[0, 65535], ) digital_output_enable = Instrument.control( 'dioe?', 'dioe 0,%i', """Control the digital output enable data register (``DIOE``).""", validator=truncated_range, values=[0, 65535], ) @property def digital_out_enable_data(self): """Control the digital output enable data register. .. deprecated:: 0.16 Use :attr:`digital_output_enable` instead. """ warn("`digital_out_enable_data` is deprecated, use " "`digital_output_enable` instead.", FutureWarning) return self.digital_output_enable @digital_out_enable_data.setter def digital_out_enable_data(self, value): warn("`digital_out_enable_data` is deprecated, use " "`digital_output_enable` instead.", FutureWarning) self.digital_output_enable = value status_byte_register = Instrument.measurement( "*stb?", """Measure the status byte register and MSS bits without using a serial poll (``*STB?``). The Status Byte Register has a hierarchical structure. ERR, DOP, ESB, and COP bits, except RQS and MAV, have lower-level status registers. Each register is paired with an enable register that can be selected to output to the Status Byte register or not. The status byte register also has an enable register, which allows you to select whether or not to issue a service request SRQ. .. note:: \\*STB? command can read bit 6 as MSS (logical OR of other bits). """, cast=int, ) event_status_register = Instrument.measurement( "*esr?", """Measure the standard event status register (SESR) as a :class:`SESR` ``IntFlag`` (``*ESR?``). .. note:: SESR is cleared after being read. """, get_process=lambda v: SESR(int(v)), ) device_operation_register = Instrument.measurement( "doc?", """Measure the device operations register (DOR) as a :class:`DOR` ``IntFlag`` (``DOC?``).""", get_process=lambda v: DOR(int(v)), ) error_register = Instrument.measurement( "err?", """Measure the error register contents as a 5-digit integer (``ERR?``). The response format is ``UUEEN`` where ``UU`` is the unit number (00=system, 01=ch A, 02=ch B) and ``EEN`` is the error code. Use :meth:`check_errors` for structured error checking with messages. """, cast=int, ) self_test = Instrument.measurement( "*tst?", """Get the result of the self-test (``*TST?``). .. warning:: This command may take a long time to complete or may not be supported on all models. A VISA timeout error is possible. Consider wrapping in a try/except block or increasing the adapter timeout before calling. """, cast=int, ) trigger_link_enabled = Instrument.setting( "tlnk 0,%d", """Set whether the trigger link function is enabled (bool) (``TLNK``). :type: bool """, validator=strict_discrete_set, values={False: 1, True: 2}, map_values=True ) display_enabled = Instrument.setting( "disp 0,%d", """Set whether the front panel display is enabled (bool) (``DISP``). :type: bool """, validator=strict_discrete_set, values={False: 2, True: 1}, map_values=True ) line_frequency = Instrument.setting( "lf 0,%d", """Set the power supply frequency to 50 or 60 Hz (``LF``). :type: int The integration time per PLC for measurements is set to one cycle of the specified power supply frequency. """, validator=strict_discrete_set, values={50: 1, 60: 2}, map_values=True ) store_config = Instrument.setting( "sav %d", """Set the memory area (0-4) to store the configuration (``SAV``). :type: int """, validator=strict_range, values=range(0, 5), ) load_config = Instrument.setting( "rcl %d", """Set the memory area (0-4) to load the configuration from (``RCL``). :type: int """, validator=strict_range, values=range(0, 5), ) def set_lo_common_connection_relay(self, enable, lo_relay=None): """Configure the LO common connection relay between channels A and B (``LTL``). :param bool enable: A boolean property that controls whether or not the connection relay is enabled. Valid values are True and False. :param lo_relay: A boolean property that controls whether or not the internal analog common relay is enabled. Valid values are True, False and None (don't change lo relay setting). :type lo_relay: bool, optional """ enable = map_values(enable, {True: 2, False: 1}) lo_relay = map_values(lo_relay, {True: 2, False: 1, None: 3}) self.write(f'ltl 0,{enable},{lo_relay}') def parse_measurement(self, measurement): """Parse a measurement response string into a (value, header) tuple.""" if ' ' in measurement: measurement = measurement.split(' ') return (float(measurement[1]), measurement[0]) else: return (float(measurement), None) def read_measurement(self): """Read the last triggered measurement value.""" return self.parse_measurement(self.read())[0] class SMUChannel(Channel): """Represent a single SMU channel (A or B) of the Advantest R624X.""" def __init__(self, parent, id, voltage_range, current_range): super().__init__(parent, id) self.voltage_range = voltage_range[id] self.current_range = current_range[id] def insert_id(self, command): return command.format_map({self.placeholder: ord(self.id) - 64}) def clear_measurement_buffer(self): """Clear the measurement data buffer (``MBC``).""" self.write('mbc {ch}') @property def output_waveform_settings(self): """Get the output waveform settings for this channel (``LDS_0x?``).""" return self.ask('lds_0{ch}?') def query_output_waveform(self): """Get the output waveform settings for this channel. .. deprecated:: 0.16 Use :attr:`output_waveform_settings` instead. """ warn("`query_output_waveform` is deprecated, use " "`output_waveform_settings` property instead.", FutureWarning) return self.output_waveform_settings @property def measurement_range_settings(self): """Get the measurement range, integration time, hold time, delay time, pulse width, and pulse period for this channel (``LDS_1x?``).""" return self.ask('lds_1{ch}?') def query_measurement_settings(self): """Get the measurement range settings for this channel. .. deprecated:: 0.16 Use :attr:`measurement_range_settings` instead. """ warn("`query_measurement_settings` is deprecated, use " "`measurement_range_settings` property instead.", FutureWarning) return self.measurement_range_settings @property def response_settings(self): """Get the response mode, operate mode, and remote sense settings for this channel (``LDS_2x?``).""" return self.ask('lds_2{ch}?') def query_response_settings(self): """Get the response mode settings for this channel. .. deprecated:: 0.16 Use :attr:`response_settings` instead. """ warn("`query_response_settings` is deprecated, use " "`response_settings` property instead.", FutureWarning) return self.response_settings @property def data_output_settings(self): """Get the null operation, comparison operation, output data type, and sweep stop condition for this channel (``LDS_3x?``).""" return self.ask('lds_3{ch}?') def query_data_output_settings(self): """Get the data output settings for this channel. .. deprecated:: 0.16 Use :attr:`data_output_settings` instead. """ warn("`query_data_output_settings` is deprecated, use " "`data_output_settings` property instead.", FutureWarning) return self.data_output_settings @property def io_settings(self): """Get the analog input, trigger output timing, trigger input type, scanner control, and interlock control for this channel (``LDS_4x?``).""" return self.ask('lds_4{ch}?') def query_io_settings(self): """Get the I/O settings for this channel. .. deprecated:: 0.16 Use :attr:`io_settings` instead. """ warn("`query_io_settings` is deprecated, use " "`io_settings` property instead.", FutureWarning) return self.io_settings def set_output_type(self, output_type, measurement_type): """Set the output method and type of the GPIB output (``OFM``). :param output_type: A property that controls the type of output :type output_type: int or :class:`OutputType` :param measurement_type: A property that controls the measurement type :type measurement_type: int or :class:`MeasurementType` .. note:: For the format of the output data, refer to :meth:`AdvantestR624X.set_output_format`. For DC and pulse measurements, the output method is fixed to '1' (real-time output). When the output method '3' (buffering output) is specified, the measured data is not stored in memory. """ output_type = OutputType(output_type) measurement_type = MeasurementType(measurement_type) self.write(f'ofm {{ch}},{output_type.value},{measurement_type.value}') analog_input = Channel.setting( "ian {ch},%d", """Set the analog input terminal (ANALOG INPUT) on the rear panel ON or OFF (``IAN``). :type: int 1. Turn off the analog input. 2. Analog input ON, gain x1. 3. Analog input ON, gain x2.5. """, validator=strict_range, values=range(1, 4), ) trigger_output_timing = Channel.setting( "tot {ch},%d", """Set the timing of the trigger output signal from TRIGGER OUT on the rear panel (``TOT``). :type: :class:`.TriggerOutputSignalTiming` """, validator=strict_range, values=range(0, 63), # get_process=lambda v: TriggerOutputSignalTiming(int(v)), ) def set_scanner_control(self, output, interlock): """Set the SCANNER CONTROL (START, STOP) output signal and INTERLOCK input signal on the rear panel (``SCT``). :param int output: A property that controls the scanner output :param int interlock: A property that controls the scanner interlock type output: 1. Scanner, Turn off the control signal output. 2. Output to the scanner control signal at the start / stop of the sweep. 3. Operate / Standby Scanner, Output to the control signal. interlock: 1. Turn off the interlock signal input. 2. Set as a stamper when the interlock signal input is HI. 3. When the interlock signal input is HI, it is on standby, and when it is LO, it is operated. """ output = strict_discrete_set(output, [1, 2, 3]) interlock = strict_discrete_set(interlock, [1, 2, 3]) self.write(f'sct {{ch}},{output},{interlock}') trigger_input = Channel.setting( "tjm {ch},%d", """Set the type of trigger input (``TJM``). :type: :class:`.TriggerInputType` +------------------------+---+---+---+ | Trigger input types | 1 | 2 | 3 | +========================+===+===+===+ | \\*TRG | O | O | X | +------------------------+---+---+---+ | XE 0 | O | O | X | +------------------------+---+---+---+ | XE Channel | O | O | O | +------------------------+---+---+---+ | GET | O | O | X | +------------------------+---+---+---+ | Trigger input signal | O | X | X | +------------------------+---+---+---+ O can be used, X cannot be used .. note:: The sweep operation cannot be started by the trigger input signal. Be sure to start it with the 'XE' command. Once started, it is possible to advance the sweep with a trigger input signal. """, validator=strict_range, values=range(1, 4), # get_process=lambda v: TriggerInputType(int(v)), ) fast_mode_enabled = Channel.setting( "fl {ch},%d", """Set the channel response mode to fast or slow (bool) (``FL``). :type: bool """, validator=strict_discrete_set, values={False: 2, True: 1}, map_values=True ) sample_hold_mode = Channel.setting( "mst {ch},%d", """Set the integration time of the measurement (``MST``). :type: :class:`.SampleHold` .. note:: - Valid only for pulse measurement and pulse sweep measurement. - In sample hold mode, the AD transformation is just before the fall of the pulse width. - The sample hold mode cannot be set during DC measurement and DC sweep measurement. When set to sample-and-hold mode, the integration time is 100 µs. However, in 2-channel synchronous operation, if one channel is in pulse generation and the other is in sample-and-hold mode, the DC measurement side also operates in sample-and-hold mode. - When performing pulse measurement and pulse sweep measurement, it is necessary to satisfy the restrictions on the pulse width (Tw), pulse period (Tp), and measure delay time (Td) of the WT command. If the constraint is not satisfied, the integration time is unchanged. To lengthen the integration time, first change the pulse width (Tw) and pulse period (Tp). When shortening the pulse width and pulse cycle, shorten the integration time first. """, validator=strict_discrete_set, values=[0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], # get_process=lambda v: SampleHold(int(v)), ) def set_sample_mode(self, mode, auto_sampling=True): """Set the synchronous, asynchronous, or tracking operation and search measurement mode between channels (``JM``). :param mode: Sample Mode :type mode: :class:`.SampleMode` :param auto_sampling: Whether or not auto sampling is enabled, defaults to True. When True, measurement data is automatically output after each trigger. When False, data is output only on explicit request (e.g. ``FCH?``). :type auto_sampling: bool, optional .. warning:: For dual-channel synchronous modes (``PULSED_SYNC``, ``SWEEP_SYNC``, etc.), use ``auto_sampling=False``. With ``auto_sampling=True`` (the default), the auto-output data contains the generated/source value rather than the actual measurement result when reading via ``select_for_output()`` / ``FCH?``. """ mode = SampleMode(mode) auto_sampling = map_values(auto_sampling, {True: 1, False: 2}) self.write(f'jm {mode.value},{auto_sampling},{{ch}}') def set_timing_parameters(self, hold_time, measurement_delay, pulsed_width, pulsed_period): """Set the hold time, measurement delay, pulse width, and pulse period (``WT``). :param float hold_time: total amount of time for the complete pulse, until next pulse comes :param float measurement_delay: time between measurements :param float pulsed_width: Time specifying the pulse width :param float pulsed_period: Time specifying the pulse period .. note:: Pulse measurement has the following restrictions depending on the pulse period (Tp) setting. (For pulse sweep measurements, there are no restrictions.) - Tp < 2ms : Not measured. - 2ms <= Tp < 10ms : Measure once every 5 ~ 20ms. - 10ms <= Tp: Measured at each pulse generation. """ self.write(f"wt {{ch}},{hold_time:.4e},{measurement_delay:.4e},{pulsed_width:.4e}," f"{pulsed_period:.4e}") def select_for_output(self): """Select this channel for measurement data output (``FCH?``). Sends the FCH? query to select which channel's measurement data will be output. Call :meth:`~.AdvantestR624X.read_measurement` afterward to read the data. The recommended usage pattern (per the instrument manual) is:: smu.ch_A.select_for_output() # Select channel A smu.trigger() # Trigger measurement value = smu.read_measurement() # Read channel A data Or, when data already exists from a previous trigger:: smu.ch_B.select_for_output() # Switch to channel B value = smu.read_measurement() # Read channel B data .. note:: Reading measurements with the RMM command does not affect channel specification with the FCH command. In the default state, the measurement data of channel A is output. """ self.write("fch_0{ch}?") def trigger(self): """Send a measurement trigger for sweep, search measurement, or sweep step (``XE``).""" self.write('xe {ch}') ############### # Voltage (V) # ############### def measure_voltage(self, enable=True, internal_measurement=True, voltage_range=VoltageRange.AUTO): """Set the voltage measurement ON/OFF, measurement input, and voltage measurement range (``RV``). :param enable: boolean property that enables or disables voltage measurement. Valid values are True (Measure the voltage flowing at the OUTPUT terminal) and False (Measure the voltage from the rear panel -ANALOG COMMON). :type enable: bool, optional :param internal_measurement: A boolean property that enables or disables the internal measurement. :type internal_measurement: bool, optional :param voltage_range: Specifying voltage range :type voltage_range: :class:`.VoltageRange`, optional """ voltage_range = VoltageRange(voltage_range) enable = map_values(enable, {True: 1, False: 2}) internal_measurement = map_values(internal_measurement, {True: 1, False: 2}) self.write(f'rv {{ch}},{enable},{internal_measurement},{voltage_range.value}') def voltage_source(self, source_range, source_value, current_compliance): """Set the source range, source value, and current compliance for DC (constant voltage) measurement (``DV``). :param source_range: Specifying source range :type source_range: :class:`.VoltageRange` :param float source_value: A number specifying the source voltage value :param float current_compliance: A number specifying the current compliance .. note:: Regardless of the specified current compliance polarity, both polarities (+ and -) are set. The current compliance range is automatically set to the minimum range that includes the set value. """ source_range = VoltageRange(source_range) source_value = truncated_range(source_value, self.voltage_range) self.write(f'dv {{ch}},{source_range.value},{source_value:.4e},{current_compliance:.4e}') def voltage_pulsed_source(self, source_range, pulse_value, base_value, current_compliance): """Set the source range, pulse value, base value, and current compliance for pulse (voltage) measurement (``PV``). .. note:: Regardless of the specified current compliance polarity, both polarities (+ and -) are set. The current compliance range is automatically set to the minimum range that includes the set value. .. warning:: When using pulsed sources, ``measure_current()`` must be called with a fixed range (e.g. ``CurrentRange.FIXED_BEST``). ``CurrentRange.AUTO`` and ``AUTO_*`` ranges are not supported in pulsed modes (error 00211). """ source_range = VoltageRange(source_range) pulse_value = truncated_range(pulse_value, self.voltage_range) base_value = truncated_range(base_value, self.voltage_range) self.write(f'pv {{ch}},{source_range.value},{pulse_value:.4e},{base_value:.4e},' f'{current_compliance:.4e}') change_source_voltage = Channel.setting( "spot {ch},%.4e", """Set new target voltage (``SPOT``). :type: float .. note:: Only the DC action source value and pulse action pulse value are changed using the currently set DC action and pulse action parameters. Measure after the change and set the channel to output the measured data to the specified ch. In other words, it's the same as running the following commands: 1. DV/DI/PV/PI 2. XE xx 3. FCH xx """, ) def voltage_fixed_level_sweep( self, voltage_range, voltage_level, measurement_count, current_compliance, bias=0): """Set the fixed level sweep (voltage) generation range, level value, current compliance, and bias value (``FXV``). .. note:: Regardless of the specified current compliance polarity, both polarities (+ and -) are set. The current compliance range is automatically set to the minimum range that includes the set value. """ voltage_range = VoltageRange(voltage_range) voltage_level = truncated_range(voltage_level, self.voltage_range) self.write(f'fxv {{ch}},{voltage_range.value},{voltage_level:.4e},' f'{measurement_count},{current_compliance:.4e},{bias:.4e}') def voltage_fixed_pulsed_sweep( self, voltage_range, pulse, base, measurement_count, current_compliance, bias=0): """Set the fixed pulse (voltage) sweep generation range, pulse value, base value, number of measurements, current compliance, and bias value (``PXV``). .. note:: Regardless of the specified current compliance polarity, both polarities (+ and -) are set. The current compliance range is automatically set to the minimum range that includes the set value. .. warning:: When using pulsed sweeps, ``measure_current()`` must use a fixed range (e.g. ``CurrentRange.FIXED_BEST``). Auto ranges are not supported (error 00211). """ voltage_range = VoltageRange(voltage_range) pulse = truncated_range(pulse, self.voltage_range) base = truncated_range(base, self.voltage_range) self.write(f'pxv {{ch}},{voltage_range.value},{pulse:.4e},{base:.4e},' f'{measurement_count},{current_compliance:.4e},{bias:.4e}') def voltage_sweep( self, sweep_mode, repeat, voltage_range, start_value, stop_value, steps, current_compliance, bias=0): """Set the sweep mode, number of repeats, source range, start value, stop value, number of steps, current compliance, and bias value for staircase (linear/log) voltage sweep (``WV``). .. note:: - Sweep mode, number of repeats, and number of steps are subject to the following restrictions. - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2 m x number of refreshes x N <= 2048 - m x N <= 2048 when the OFM command sets the output data output method to 3. - Regardless of the specified current compliance polarity, both polarities (+ and -) are set. - The current compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) voltage_range = VoltageRange(voltage_range) self.write(f'wv {{ch}},{sweep_mode.value},{repeat},{voltage_range.value},' f'{start_value:.4e},{stop_value:.4e},{steps},' f'{current_compliance:.4e},{bias:.4e}') def voltage_pulsed_sweep( self, sweep_mode, repeat, voltage_range, base, start_value, stop_value, steps, current_compliance, bias=0): """Set the sweep mode, repeat count, generation range, base value, start value, stop value, number of steps, current compliance, and bias value for pulse wave (linear/log) voltage sweep (``PWV``). .. note:: - The sweep mode, number of refreshes, and number of steps are subject to the following restrictions: - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2 m x number of refreshes x N <= 2048 - m x N <= 2048 when the OFM command sets the output data output method to 3. - For the current compliance polarity, regardless of the specified current compliance polarity, the compliance of both polarities (+ and -) is set. - The current compliance range is automatically set to the minimum range that includes the set value. .. warning:: When using pulsed sweeps, ``measure_current()`` must use a fixed range (e.g. ``CurrentRange.FIXED_BEST``). Auto ranges are not supported (error 00211). """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) voltage_range = VoltageRange(voltage_range) self.write(f'pwv {{ch}},{sweep_mode.value},{repeat},{voltage_range.value},{base:.4e},' f'{start_value:.4e},{stop_value:.4e},{steps},{current_compliance:.4e},' f'{bias:.4e}') def voltage_random_sweep( self, sweep_mode, repeat, start_address, stop_address, current_compliance, bias=0): """Set the sweep mode, repeat count, start address, stop address, current compliance, and bias value for constant voltage random sweep (``MDWV``). .. note:: - Sweep mode, number of repeats, start address and stop address are subject to the following restrictions: - Start address < Stop address - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2 m x number of refreshes x N <= 2048 - m x N <= 2048 when the OFM command sets the output data output method to 3. - Regardless of the specified current compliance polarity, both polarities (+ and -) are set. - The current compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) start_address = truncated_range(start_address, [1, 2048]) stop_address = truncated_range(stop_address, [1, 2048]) self.write(f'mdwv {{ch}},{sweep_mode.value},{repeat},{start_address},{stop_address},' f'{current_compliance:.4e},{bias:.4e}') def voltage_random_pulsed_sweep( self, sweep_mode, repeat, start_address, stop_address, current_compliance, bias=0): """Set the sweep mode, repeat count, base value, start address, stop address, current compliance, and bias value for constant voltage random pulse sweep (``MPWV``). .. note:: - Sweep mode, number of repeats, start address and stop address are subject to the following restrictions: - Start address < Stop address - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2 m x number of refreshes x N <= 2048 - m x N <= 2048 when the OFM command sets the output data output method to 3. - Regardless of the specified current compliance polarity, both polarities (+ and -) are set. - The current compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) start_address = truncated_range(start_address, [1, 2048]) stop_address = truncated_range(stop_address, [1, 2048]) self.write(f'mpwv {{ch}},{sweep_mode.value},{repeat},{start_address},{stop_address},' f'{current_compliance:.4e},{bias:.4e}') def set_voltage_random_memory(self, address, voltage_range, output, current_compliance): """Store voltage parameters to the random sweep data memory (``RMS``). Stored generated values are swept within the specified memory address range by the MDWV, MDWI, MPWV, MPWI commands. """ voltage_range = VoltageRange(voltage_range) address = truncated_range(address, [1, 2048]) self.write(f'rms {address};dv{{ch}},{voltage_range.value},{output:.4e},' f'{current_compliance:.4e};rend') ############### # Current (A) # ############### def current_source(self, source_range, source_value, voltage_compliance): """Set the source range, source value, and voltage compliance for DC (constant current) measurement (``DI``). :param source_range: Specifying source range :type source_range: :class:`.CurrentRange` :param float source_value: A number specifying the source current value :param float voltage_compliance: A number specifying the voltage compliance .. note:: Regardless of the specified voltage compliance polarity, both polarities (+ and -) are set. The voltage compliance range is automatically set to the minimum range that includes the set value. """ source_range = CurrentRange(source_range) source_value = truncated_range(source_value, self.current_range) self.write(f'di {{ch}},{source_range.value},{source_value:.4e},{voltage_compliance:.4e}') def current_pulsed_source(self, source_range, pulse_value, base_value, voltage_compliance): """Set the source range, pulse value, base value, and voltage compliance for pulse (current) measurement (``PI``). .. note:: Regardless of the specified voltage compliance polarity, both polarities (+ and -) are set. The voltage compliance range is automatically set to the minimum range that includes the set value. .. warning:: The ``source_range`` must be a fixed range (e.g. ``CurrentRange.FIXED_BEST``). ``CurrentRange.AUTO`` and ``AUTO_*`` ranges are not supported in pulsed modes (error 00211). """ source_range = CurrentRange(source_range) pulse_value = truncated_range(pulse_value, self.current_range) base_value = truncated_range(base_value, self.current_range) self.write(f'pi {{ch}},{source_range.value},{pulse_value:.4e},{base_value:.4e},' f'{voltage_compliance:.4e}') change_source_current = Channel.setting( "spot {ch},%.4e", """Set new target current (``SPOT``). :type: float .. note:: Only the DC action source value and pulse action pulse value are changed using the currently set DC action and pulse action parameters. Measure after the change and set the channel to output the measured data to the specified ch. In other words, it's the same as running the following commands: 1. DV/DI/PV/PI 2. XE xx 3. FCH xx """ ) def current_fixed_level_sweep( self, current_range, current_level, measurement_count, voltage_compliance, bias=0): """Set the fixed level sweep (current) generation range, level value, voltage compliance, and bias value (``FXI``). .. note:: Regardless of the specified voltage compliance polarity, both polarities (+ and -) are set. The voltage compliance range is automatically set to the minimum range that includes the set value. """ current_range = CurrentRange(current_range) self.write(f'fxi {{ch}},{current_range.value},{current_level:.4e},{measurement_count},' f'{voltage_compliance:.4e},{bias:.4e}') def current_fixed_pulsed_sweep( self, current_range, pulse, base, measurement_count, voltage_compliance, bias=0): """Set the fixed pulse (current) sweep generation range, pulse value, base value, number of measurements, voltage compliance, and bias value (``PXI``). .. note:: Regardless of the specified voltage compliance polarity, both polarities of + and - are set. The voltage compliance range is automatically set to the minimum range that includes the set value. .. warning:: The ``current_range`` must be a fixed range (e.g. ``CurrentRange.FIXED_BEST``). ``CurrentRange.AUTO`` and ``AUTO_*`` ranges are not supported for pulse sweep (error 00211). """ current_range = CurrentRange(current_range) self.write(f'pxi {{ch}},{current_range.value},{pulse:.4e},{base:.4e},{measurement_count},' f'{voltage_compliance:.4e},{bias:.4e}') def current_sweep( self, sweep_mode, repeat, current_range, start_value, stop_value, steps, voltage_compliance, bias=0): """Set the sweep mode, number of repeats, source range, start value, stop value, number of steps, voltage compliance, and bias value for staircase (linear/log) current sweep (``WI``). .. note:: - The sweep mode, number of refreshes, and number of steps are subject to the following restrictions: - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2, m x number of repeats x N <= 2048. - m x N <= 2048 when the OFM command sets the output data output method to 3. - Regardless of the specified voltage compliance polarity, both polarities (+ and -) are set. - The voltage compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) current_range = CurrentRange(current_range) self.write(f'wi {{ch}},{sweep_mode.value},{repeat},{current_range.value},' f'{start_value:.4e},{stop_value:.4e},{steps},{voltage_compliance:.4e},' f'{bias:.4e}') def current_pulsed_sweep( self, sweep_mode, repeat, current_range, base, start_value, stop_value, steps, voltage_compliance, bias=0): """Set the sweep mode, repeat count, generation range, base value, start value, stop value, number of steps, voltage compliance, and bias value for pulse wave (linear/log) current sweep (``PWI``). .. note:: - The sweep mode, number of refreshes, and number of steps are subject to the following restrictions: - Let N = number of steps, m = l (one-way sweep), m = 2 (round-trip sweep). - When the OFM command sets the output data output method to 1 or 2, m x number of repeats x N <= 2048. - m x N <= 2048 when the OFM command sets the output data output method to 3. - Regardless of the specified voltage compliance polarity, both polarities (+ and -) are set. - The voltage compliance range is automatically set to the minimum range that includes the set value. .. warning:: The ``current_range`` must be a fixed range (e.g. ``CurrentRange.FIXED_BEST``). ``CurrentRange.AUTO`` and ``AUTO_*`` ranges are not supported for pulse sweep (error 00211). """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) steps = truncated_range(steps, [2, 2048]) current_range = CurrentRange(current_range) self.write( f'pwi {{ch}},{sweep_mode.value},{repeat},{current_range.value},{base:.4e},' f'{start_value:.4e},{stop_value:.4e},{steps},{voltage_compliance:.4e},{bias:.4e}') def measure_current(self, enable=True, internal_measurement=True, current_range=CurrentRange.AUTO): """Set the current measurement ON/OFF, measurement input, and current measurement range (``RI``). :param enable: boolean property that enables or disables current measurement. Valid values are True (Measure the current flowing at the OUTPUT terminal) and False (Measure the current from the rear panel -ANALOG COMMON). :type enable: bool, optional :param internal_measurement: A boolean property that enables or disables the internal measurement. :type internal_measurement: bool, optional :param current_range: Specifying current range. :type current_range: :class:`.CurrentRange`, optional .. warning:: ``CurrentRange.AUTO`` and ``AUTO_*`` ranges cannot be used when the channel is configured for pulse measurement or pulse sweep (error 00211). Use a fixed range such as ``CurrentRange.FIXED_BEST`` for pulsed modes. """ current_range = CurrentRange(current_range) enable = map_values(enable, {True: 1, False: 2}) internal_measurement = map_values(internal_measurement, {True: 1, False: 2}) self.write(f'ri {{ch}},{enable},{internal_measurement},{current_range.value}') def current_random_sweep( self, sweep_mode, repeat, start_address, stop_address, current_compliance, bias=0): """Set the sweep mode, repeat count, start address, stop address, voltage compliance, and bias value for constant current random sweep (``MDWI``). .. note:: - Sweep mode, number of repeats, start address and stop address are subject to the following restrictions: - Start address < Stop address - Let N = (stop number 1 - start number + 1), m = 1 (one-way sweep), m = 2 (round-trip sweep). - When the output data output method is set to 1 or 2 with the OFM command m x number of repeats x N <= 2048 - When the output data output method is set to 3 with the OFM command m x N <= 2048 - For the voltage compliance polarity, regardless of the specified voltage compliance polarity, both polarities of + and – are set. - The voltage compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) start_address = truncated_range(start_address, [1, 2048]) stop_address = truncated_range(stop_address, [1, 2048]) self.write( f'mdwi {{ch}},{sweep_mode.value},{repeat},{start_address},{stop_address},' f'{current_compliance:.4e},{bias:.4e}') def current_random_pulsed_sweep( self, sweep_mode, repeat, start_address, stop_address, current_compliance, bias=0): """Set the sweep mode, repeat count, base value, start address, stop address, voltage compliance, and bias value for constant current random pulse sweep (``MPWI``). .. note:: - Sweep mode, number of repeats, start address and stop address are subject to the following restrictions: - Start address < Stop address - Let N = (stop number 1 - start number + 1), m = 1 (one-way sweep), m = 2 (round-trip sweep). - When the output data output method is set to 1 or 2 with the OFM command m x number of repeats x N <= 2048 - When the output data output method is set to 3 with the OFM command m x N <= 2048 - For the voltage compliance polarity, regardless of the specified voltage compliance polarity, both polarities of + and – are set. - The voltage compliance range is automatically set to the minimum range that includes the set value. """ sweep_mode = SweepMode(sweep_mode) repeat = truncated_range(repeat, [0, 1024]) start_address = truncated_range(start_address, [1, 2048]) stop_address = truncated_range(stop_address, [1, 2048]) self.write( f'mpwi {{ch}},{sweep_mode.value},{repeat},{start_address},{stop_address},' f'{current_compliance:.4e},{bias:.4e}') def set_current_random_memory(self, address, current_range, output, voltage_compliance): """Store current parameters to the random sweep data memory (``RMS``). Stored generated values are swept within the specified memory address range by the MDWV, MDWI, MPWV, MPWI commands. """ current_range = CurrentRange(current_range) address = truncated_range(address, [1, 2048]) self.write( f'rms {address};di{{ch}},{current_range.value},{output:.4e},' f'{voltage_compliance:.4e};rend') def read_random_memory(self, address): """Read the random sweep memory at the specified address (``RMS?``). :param int address: Address to specify memory location. :returns: Set values returned by the device from the specified address location. :rtype: str """ address = truncated_range(address, [1, 2048]) return self.ask(f'rms_1{{ch}}? {address}').strip() def enable_source(self): """Put this channel into the operating state (``CN``).""" self.write('cn {ch}') def standby(self): """Put this channel into standby state (``CL``).""" self.write('cl {ch}') def stop(self): """Stop the sweep started by the XE command or trigger input signal (``SP``).""" self.write('sp {ch}') def output_all_measurements(self): """Output all measurements from this channel's measurement data buffer (``RMM?``). .. note:: For the output format, refer to :meth:`AdvantestR624X.output_format`. When a memory address where no measurement data is stored is read, 999.999E+99 will be returned. """ self.write('rmm_0{ch}?') def read_measurement_from_addr(self, addr): """Read one measurement at the specified memory address from this channel's measurement data buffer (``RMM?``). :param int addr: Specifies the address to read from. :return: float Measurement data .. note:: For the output format, refer to :meth:`AdvantestR624X.output_format`. When a memory address where no measurement data is stored is read, 999.999E+99 will be returned. """ measurement = self.ask(f'rmm_1{{ch}}? {addr}') return self.parent.parse_measurement(measurement) measurement_count = Channel.measurement( "nub_0{ch}?", """Measure the number of measurements in the measurement data buffer (``NUB?``).""", cast=int ) null_operation_enabled = Channel.setting( "nug {ch},%d", """Set whether the null operation is enabled (bool) (``NUG``). :type: bool .. Acquisition timing of null data:: - Null data captures the next measurement data for which null computation is enabled as null data during DC measurement or pulse measurement. - A sweep operation does not capture null data. - If null calculation is enabled during sweep operation, null data obtained by DC operation or pulse operation will be used for calculation. - Indicates the timing of null data acquisition during DC operation. .. note:: - Null data is not rewritten even if the null operation is disabled. - Null data is rewritten only when null operation is changed from OFF to ON or initialized in case of DC operation or pulse operation. """, validator=strict_discrete_set, values={False: 1, True: 2}, map_values=True ) def set_wire_mode(self, four_wire, lo_guard=True): """Switch remote sense and set the LO-GUARD relay ON/OFF (``OSL``). :param bool four_wire: A boolean property that enables or disables four wire measurements. Valid values are True (enables 4-wire sensing) and False (enables two-terminal sensing). :param bool lo_guard: A boolean property that enables or disables the LO-GUARD relay. """ four_wire = map_values(four_wire, {True: 1, False: 2}) lo_guard = map_values(lo_guard, {True: 1, False: 2}) self.write(f'osl {{ch}},{four_wire},{lo_guard}') auto_zero_enabled = Channel.setting( "cm {ch},%d", """Set the auto zero option ON or OFF (bool) (``CM``). :type: bool This command sets auto zero (automatically calibrate the zero point of the measured value operation. 1. Periodically perform auto zero. 2. Auto zero once, no periodic auto zeros thereafter. When the auto zero mode is set to True, the following operations are performed. - For DC operation and pulse operation: - At the end of one sweep, if he has exceeded the last autozero by more than 10 seconds, he will do one autozero. - If sweep start is specified during auto zero, the sweep will start after auto zero ends. - Sweep operation - Auto zero is performed once every 10 seconds. - If measurement or pulse output is specified during auto zero, it will be executed after auto zero ends. """, validator=strict_discrete_set, values={False: 2, True: 1}, map_values=True ) def set_comparison_limits(self, comparison, voltage_value, upper_limit, lower_limit): """Set the measurement comparison ON/OFF and the upper/lower limit values (``CMD``). :param bool comparison: A boolean property that controls whether or not the comparison function is enabled. Valid values are True or False. :param bool voltage_value: A boolean property that controls whether or not voltage or current values are passed. Valid values are True or False. :param float upper_limit: Number specifying the upper comparison limit :param float lower_limit: Number specifying the lower comparison limit """ comparison = map_values(comparison, {True: 2, False: 1}) voltage_value = map_values(voltage_value, {True: 1, False: 2}) self.write(f'cmd {{ch}},{comparison},{voltage_value},{upper_limit:.4e},{lower_limit:.4e}') relay_mode = Channel.setting( "opm {ch},%d", """Set the HI/LO relays for standby mode (``OPM``). :type: int 1. When executing an operation only the HI side turns ON, in standby both HI and LO are turned OFF. 2. When executing an operation only the LO side turns ON, in standby both HI and LO are turned OFF. 3. When executing an operation both HI and LO turn ON, in standby both HI and LO are turned OFF. 4. When executing an operation only the HI side turns ON, in standby only the HI side is turned OFF. """, validator=strict_range, values=range(1, 5), ) operation_register = Channel.measurement( "coc_0{ch}?", """Measure the Channel Operations Register (COR) as a :class:`COR` ``IntFlag`` (``COC?``).""", values=range(0, 65535), get_process=lambda v: COR(int(v)), ) output_enable_register = Channel.control( "coe_0{ch}?", "coe_0{ch} %d", """Control the channel operation output enable register (COER) as a :class:`COR` ``IntFlag`` (``COE?``).""", validator=strict_range, values=range(0, 65535), get_process=lambda v: COR(int(v)), ) def init_calibration(self): """Initialize the calibration data (``CINI``).""" self.write('cini {ch}') def store_calibration_factor(self): """Store the calibration factor in non-volatile memory (EEPROM) (``CSRT``).""" self.write('csrt {ch}') def calibration_init(self): """Initialize the calibration data. .. deprecated:: 0.16 Use :meth:`init_calibration` instead. """ warn("`calibration_init` is deprecated, use " "`init_calibration` instead.", FutureWarning) return self.init_calibration() def calibration_store_factor(self): """Store the calibration factor. .. deprecated:: 0.16 Use :meth:`store_calibration_factor` instead. """ warn("`calibration_store_factor` is deprecated, use " "`store_calibration_factor` instead.", FutureWarning) return self.store_calibration_factor() calibration_measured_value = Channel.setting( "std {ch},%.4e", """Set the externally measured standard value and start calibration (``STD``). :type: float """, ) calibration_generation_factor = Channel.setting( "ccs {ch},%.4e", """Set the increment or decrement for the generation calibration factor of the current generation range (``CCS``). :type: float """, ) calibration_measurement_factor = Channel.setting( "ccm {ch},%.4e", """Set the increment of the measurement calibration factor for the current measurement range (``CCM``). :type: float """, ) class AdvantestR6245(AdvantestR624X): """Represent the Advantest R6245 DC Voltage/Current Source/Monitor.""" voltage_range = {'A': [-220.0, 220.0], 'B': [-220.0, 220.0]} current_range = {'A': [-2.0, 2.0], 'B': [-2.0, 2.0]} ch_A = Instrument.ChannelCreator(SMUChannel, 'A', voltage_range=voltage_range, current_range=current_range) ch_B = Instrument.ChannelCreator(SMUChannel, 'B', voltage_range=voltage_range, current_range=current_range) def __init__(self, adapter, name="Advantest R6245 SourceMeter", **kwargs): super().__init__( adapter, name, **kwargs ) class AdvantestR6246(AdvantestR624X): """Represent the Advantest R6246 DC Voltage/Current Source/Monitor.""" voltage_range = {'A': [-62.0, 62.0], 'B': [-220.0, 220.0]} current_range = {'A': [-20.0, 20.0], 'B': [-2.0, 2.0]} ch_A = Instrument.ChannelCreator(SMUChannel, 'A', voltage_range=voltage_range, current_range=current_range) ch_B = Instrument.ChannelCreator(SMUChannel, 'B', voltage_range=voltage_range, current_range=current_range) def __init__(self, adapter, name="Advantest R6246 SourceMeter", **kwargs): super().__init__( adapter, name, **kwargs ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0125113 pymeasure-0.16.0/pymeasure/instruments/agilent/0000755000175100017510000000000015203313301021275 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/__init__.py0000644000175100017510000000365115203313266023425 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .agilent8257D import Agilent8257D from .agilent8722ES import Agilent8722ES from .agilentE4408B import AgilentE4408B from .agilentE4980 import AgilentE4980 from .agilentE5062A import AgilentE5062A from .agilent34410A import Agilent34410A from .agilent34450A import Agilent34450A from .agilent4156 import Agilent4156 from .agilent4294A import Agilent4294A from .agilent33220A import Agilent33220A from .agilent33500 import Agilent33500 from .agilent33521A import Agilent33521A from .agilentB1500 import AgilentB1500 from .agilent4284A import Agilent4284A from .agilentB298x import (AgilentB2981, AgilentB2983, AgilentB2985, AgilentB2987) from .agilentE5270B import AgilentE5270B from .agilentN8975A import AgilentN8975A ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent33220A.py0000644000175100017510000002627315203313266024011 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set, \ strict_range, joined_validators from time import time from pyvisa.errors import VisaIOError import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) # Capitalize string arguments to allow for better conformity with other WFG's def capitalize_string(string: str, *args, **kwargs): return string.upper() # Combine the capitalize function and validator string_validator = joined_validators(capitalize_string, strict_discrete_set) class Agilent33220A(SCPIUnknownMixin, Instrument): """Represents the Agilent 33220A Arbitrary Waveform Generator. .. code-block:: python # Default channel for the Agilent 33220A wfg = Agilent33220A("GPIB::10") wfg.shape = "SINUSOID" # Sets a sine waveform wfg.frequency = 4.7e3 # Sets the frequency to 4.7 kHz wfg.amplitude = 1 # Set amplitude of 1 V wfg.offset = 0 # Set the amplitude to 0 V wfg.burst_state = True # Enable burst mode wfg.burst_ncycles = 10 # A burst will consist of 10 cycles wfg.burst_mode = "TRIGGERED" # A burst will be applied on a trigger wfg.trigger_source = "BUS" # A burst will be triggered on TRG* wfg.output = True # Enable output of waveform generator wfg.trigger() # Trigger a burst wfg.wait_for_trigger() # Wait until the triggering is finished wfg.beep() # "beep" print(wfg.check_errors()) # Get the error queue """ def __init__(self, adapter, name="Agilent 33220A Arbitrary Waveform generator", **kwargs): super().__init__( adapter, name, **kwargs ) shape = Instrument.control( "FUNC?", "FUNC %s", """Control the output waveform (string, strict from SINUSOID, SIN, SQUARE, SQU, RAMP, PULSE, PULS, NOISE, NOIS, DC, USER).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["SINUSOID", "SIN", "SQUARE", "SQU", "RAMP", "PULSE", "PULS", "NOISE", "NOIS", "DC", "USER"], ], ) frequency = Instrument.control( "FREQ?", "FREQ %f", """Control the frequency of the output waveform. Depending on the output shape, the supported frequency range changes. Supplying out-of-bound values may silently be clipped by the device (float, in Hz)""" ) amplitude = Instrument.control( "VOLT?", "VOLT %f", """Control the amplitude of the output waveform. Depending on amplitude unit, the unit is Volt (peak-to-peak), Volt (RMS) or dBm. The limits depend on the configured output termination (50 Ohm to High Impedance changes by a factor of 2) and the offset. Supplying out-of-bound values may silently be clipped by the device (float, in V or dBm)""" ) amplitude_unit = Instrument.control( "VOLT:UNIT?", "VOLT:UNIT %s", """Control the units of the amplitude (string, strict from VPP, VRMS, DBM).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["VPP", "VRMS", "DBM"], ], ) offset = Instrument.control( "VOLT:OFFS?", "VOLT:OFFS %f", """Control the voltage offset of the output waveform. This is limited by the amplitude and output termination. Supplying out-of-bound values may silently be clipped by the device. (float, in V)""" ) voltage_high = Instrument.control( "VOLT:HIGH?", "VOLT:HIGH %f", """Control the upper voltage of the output waveform. The limits depend on the output termination. Supplying out-of-bound values may silently be clipped by the device. (float, in V)""" ) voltage_low = Instrument.control( "VOLT:LOW?", "VOLT:LOW %f", """Control the lower voltage of the output waveform. The limits depend on the output termination. Supplying out-of-bound values may silently be clipped by the device. (float, in V)""" ) square_dutycycle = Instrument.control( "FUNC:SQU:DCYC?", "FUNC:SQU:DCYC %f", """Control the duty cycle of a square waveform function (float, strict from 20 to 80).""", validator=strict_range, values=[20, 80], ) ramp_symmetry = Instrument.control( "FUNC:RAMP:SYMM?", "FUNC:RAMP:SYMM %f", """Control the symmetry percentage for the ramp waveform (float, strict from 0 to 100).""", validator=strict_range, values=[0, 100], ) pulse_period = Instrument.control( "PULS:PER?", "PULS:PER %f", """Control the period of a pulse waveform function in seconds (float, strict from 200e-9 to 2e3). The period overwrites the frequency for all waveforms. If the period is shorter than the pulse width + the edge time, the edge time and pulse width will be adjusted accordingly.""", validator=strict_range, values=[200e-9, 2e3], ) pulse_hold = Instrument.control( "FUNC:PULS:HOLD?", "FUNC:PULS:HOLD %s", """Control if either the pulse width or the duty cycle is retained when changing the period or frequency of the waveform (string, strict from WIDT, WIDTH, DCYC, DCYCLE).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["WIDT", "WIDTH", "DCYC", "DCYCLE"], ], ) pulse_width = Instrument.control( "FUNC:PULS:WIDT?", "FUNC:PULS:WIDT %f", """Control the width of a pulse waveform function in seconds (float, strict from 20e-9 to 2e3).""", validator=strict_range, values=[20e-9, 2e3], ) pulse_dutycycle = Instrument.control( "FUNC:PULS:DCYC?", "FUNC:PULS:DCYC %f", """Control the duty cycle of a pulse waveform function in percent (float, strict from 0 to 100).""", validator=strict_range, values=[0, 100], ) pulse_transition = Instrument.control( "FUNC:PULS:TRAN?", "FUNC:PULS:TRAN %g", """Control the edge time in seconds for both the rising and falling edges. It is defined as the time between 0.1 and 0.9 of the threshold. Valid values are between 5 ns to 100 ns. The transition time has to be smaller than 0.625 * the pulse width.""", validator=strict_range, values=[5e-9, 100e-9], ) output = Instrument.control( "OUTP?", "OUTP %d", """Control the output of the function generator (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, ) burst_state = Instrument.control( "BURS:STAT?", "BURS:STAT %d", """Control whether the burst mode is on (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, ) burst_mode = Instrument.control( "BURS:MODE?", "BURS:MODE %s", """Control the burst mode (string, strict from TRIG, TRIGGERED, GAT, GATED).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["TRIG", "TRIGGERED", "GAT", "GATED"], ], ) burst_ncycles = Instrument.control( "BURS:NCYC?", "BURS:NCYC %d", """Control the number of cycles to be output when a burst is triggered (int, strict from 1 to 50000).""", validator=strict_discrete_set, values=range(1, 50001), cast=lambda v: int(float(v)) ) def trigger(self): """ Send a trigger signal to the function generator. """ self.write("*TRG;*WAI") def wait_for_trigger(self, timeout=3600, should_stop=lambda: False): """ Wait until the triggering has finished or timeout is reached. :param timeout: The maximum time the waiting is allowed to take. If timeout is exceeded, a TimeoutError is raised. If timeout is set to zero, no timeout will be used. :param should_stop: Optional function (returning a bool) to allow the waiting to be stopped before its end. """ self.write("*OPC?") t0 = time() while True: try: ready = bool(self.read()) except VisaIOError: ready = False if ready: return if timeout != 0 and time() - t0 > timeout: raise TimeoutError( "Timeout expired while waiting for the Agilent 33220A to finish the triggering." ) if should_stop(): return trigger_source = Instrument.control( "TRIG:SOUR?", "TRIG:SOUR %s", """Control the trigger source (string, strict from IMM, IMMEDIATE, EXT, EXTERNAL, BUS).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["IMM", "IMMEDIATE", "EXT", "EXTERNAL", "BUS"], ], ) trigger_state = Instrument.control( "OUTP:TRIG?", "OUTP:TRIG %d", """Control whether the output is triggered (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, ) remote_local_state = Instrument.setting( "SYST:COMM:RLST %s", """Set the remote/local state of the function generator (string, strict from LOC, LOCAL, REM, REMOTE, RWL, RWLOCK).""", validator=joined_validators( strict_discrete_set, string_validator ), values=[["LOC", "LOCAL", "REM", "REMOTE", "RWL", "RWLOCK"], ], ) beeper_state = Instrument.control( "SYST:BEEP:STAT?", "SYST:BEEP:STAT %d", """Control the state of the beeper (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, ) def beep(self): """ Causes a system beep. """ self.write("SYST:BEEP") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent33500.py0000644000175100017510000006610415203313266023706 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # # Parts of this code were copied and adapted from the Agilent33220A class. import logging from pymeasure.instruments import Instrument, Channel, SCPIMixin from pymeasure.instruments.validators import strict_discrete_set, strict_range from time import time from pyvisa.errors import VisaIOError log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) # Capitalize string arguments to allow for better conformity with other WFG's # FIXME: Currently not used since it does not combine well with the strict_discrete_set validator # def capitalize_string(string: str, *args, **kwargs): # return string.upper() # Combine the capitalize function and validator # FIXME: This validator is not doing anything other then self.capitalize_string # FIXME: I removed it from this class for now # string_validator = joined_validators(capitalize_string, strict_discrete_set) class Agilent33500Channel(Channel): """Implementation of a base Agilent 33500 channel""" shape = Instrument.control( "SOUR{ch}:FUNC?", "SOUR{ch}:FUNC %s", """ Control the output waveform shape (str).""", validator=strict_discrete_set, values=["SIN", "SQU", "TRI", "RAMP", "PULS", "PRBS", "NOIS", "ARB", "DC"], dynamic=True, ) frequency = Instrument.control( "SOUR{ch}:FREQ?", "SOUR{ch}:FREQ %f", """ Control the waveform frequency in Hz (float). Depends on the specified shape.""", validator=strict_range, values=[1e-6, 120e6], dynamic=True, ) amplitude = Instrument.control( "SOUR{ch}:VOLT?", "SOUR{ch}:VOLT %f", """ Control the voltage amplitude in Volts (float).""", validator=strict_range, values=[10e-3, 10], dynamic=True, ) amplitude_unit = Instrument.control( "SOUR{ch}:VOLT:UNIT?", "SOUR{ch}:VOLT:UNIT %s", """ Control the amplitude units (string, strictly 'VPP', 'VRMS', or 'DBM').""", validator=strict_discrete_set, values=["VPP", "VRMS", "DBM"], dynamic=True, ) offset = Instrument.control( "SOUR{ch}:VOLT:OFFS?", "SOUR{ch}:VOLT:OFFS %f", """ Control the voltage offset in Volts (float).""", validator=strict_range, values=[-4.995, +4.995], dynamic=True, ) voltage_high = Instrument.control( "SOUR{ch}:VOLT:HIGH?", "SOUR{ch}:VOLT:HIGH %f", """ Control the upper voltage level in Volts (float).""", validator=strict_range, values=[-4.999, 5], dynamic=True, ) voltage_low = Instrument.control( "SOUR{ch}:VOLT:LOW?", "SOUR{ch}:VOLT:LOW %f", """ Control the lower voltage level in Volts (float).""", validator=strict_range, values=[-5, 4.999], dynamic=True, ) phase = Instrument.control( "SOUR{ch}:PHAS?", "SOUR{ch}:PHAS %f", """ Control the waveform phase in degrees (float, from -360 to 360).""", validator=strict_range, values=[-360, 360], ) square_dutycycle = Instrument.control( "SOUR{ch}:FUNC:SQU:DCYC?", "SOUR{ch}:FUNC:SQU:DCYC %f", """ Control the square wave duty cycle in percent (float).""", validator=strict_range, values=[0.01, 99.98], dynamic=True, ) ramp_symmetry = Instrument.control( "SOUR{ch}:FUNC:RAMP:SYMM?", "SOUR{ch}:FUNC:RAMP:SYMM %f", """ Control the ramp waveform symmetry in percent (float, from 0 to 100).""", validator=strict_range, values=[0, 100], dynamic=True, ) pulse_period = Instrument.control( "SOUR{ch}:FUNC:PULS:PER?", "SOUR{ch}:FUNC:PULS:PER %e", """ Control the pulse period in seconds (float). Overwrites frequency. If the period is shorter than the pulse width + the edge time, the edge time and pulse width are adjusted.""", validator=strict_range, values=[33e-9, 1e6], dynamic=True, ) pulse_hold = Instrument.control( "SOUR{ch}:FUNC:PULS:HOLD?", "SOUR{ch}:FUNC:PULS:HOLD %s", """ Control whether pulse width or duty cycle is maintained when the period or frequency of the waveform is changed (str).""", validator=strict_discrete_set, values=["WIDT", "WIDTH", "DCYC", "DCYCLE"], dynamic=True, ) pulse_width = Instrument.control( "SOUR{ch}:FUNC:PULS:WIDT?", "SOUR{ch}:FUNC:PULS:WIDT %e", """ Control the pulse width in seconds (float).""", validator=strict_range, values=[16e-9, 1e6], dynamic=True, ) pulse_dutycycle = Instrument.control( "SOUR{ch}:FUNC:PULS:DCYC?", "SOUR{ch}:FUNC:PULS:DCYC %f", """ Control the pulse duty cycle in percent (float, from 0 to 100).""", validator=strict_range, values=[0, 100], dynamic=True, ) pulse_transition = Instrument.control( "SOUR{ch}:FUNC:PULS:TRAN?", "SOUR{ch}:FUNC:PULS:TRAN:BOTH %e", """ Control the pulse edge time (both rising and falling) in seconds (float).""", validator=strict_range, values=[8.4e-9, 1e-6], dynamic=True, ) output = Instrument.control( "OUTP{ch}?", "OUTP{ch} %d", """ Control the output state (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, "on": 1, "ON": 1, False: 0, "off": 0, "OFF": 0}, dynamic=True, ) output_load = Instrument.control( "OUTP{ch}:LOAD?", "OUTP{ch}:LOAD %s", """ Control the expected load resistance in Ohms (str or float). The output impedance is always 50 Ohm, this setting can be used to correct the displayed voltage for loads unmatched to 50 Ohm.""", dynamic=True, ) burst_state = Instrument.control( "SOUR{ch}:BURS:STAT?", "SOUR{ch}:BURS:STAT %d", """ Control the burst mode state (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, dynamic=True, ) burst_mode = Instrument.control( "SOUR{ch}:BURS:MODE?", "SOUR{ch}:BURS:MODE %s", """ Control the burst mode type (str, strictly 'TRIG' or 'GAT').""", validator=strict_discrete_set, values=["TRIG", "TRIGGERED", "GAT", "GATED"], dynamic=True, ) burst_period = Instrument.control( "SOUR{ch}:BURS:INT:PER?", "SOUR{ch}:BURS:INT:PER %e", """ Control the period of subsequent bursts in seconds (float).""", validator=strict_range, values=[1e-6, 8000], dynamic=True, ) burst_ncycles = Instrument.control( "SOUR{ch}:BURS:NCYC?", "SOUR{ch}:BURS:NCYC %d", """ Control the number of cycles to be output when a burst is triggered (int).""", validator=strict_range, values=range(1, 100000), dynamic=True, ) arb_file = Instrument.control( "SOUR{ch}:FUNC:ARB?", "SOUR{ch}:FUNC:ARB %s", """ Control the arbitrary signal to use from the volatile memory of the device.""", dynamic=True, ) arb_advance = Instrument.control( "SOUR{ch}:FUNC:ARB:ADV?", "SOUR{ch}:FUNC:ARB:ADV %s", """ Control how the device advances from data point to data point (str). Can be set to 'TRIG' or 'SRAT' (default).""", validator=strict_discrete_set, values=["TRIG", "TRIGGER", "SRAT", "SRATE"], ) arb_filter = Instrument.control( "SOUR{ch}:FUNC:ARB:FILT?", "SOUR{ch}:FUNC:ARB:FILT %s", """ Control the filter setting for arbitrary signals (str). Can be set to 'NORM', 'STEP' and 'OFF'.""", validator=strict_discrete_set, values=["NORM", "NORMAL", "STEP", "OFF"], ) arb_srate = Instrument.control( "SOUR{ch}:FUNC:ARB:SRAT?", "SOUR{ch}:FUNC:ARB:SRAT %f", """ Control the sample rate of the currently selected arbitrary signal in Sa/s (float). Valid values range from 1 µSa/s to 250 MSa/s (maximum range, device-dependent).""", validator=strict_range, values=[1e-6, 250e6], ) def data_volatile_clear(self): """ Clear all arbitrary signals from volatile memory for a given channel. This should be done if the same name is used continuously to load different arbitrary signals into the memory, since an error will occur if a trace is loaded which already exists in memory. """ self.write("SOUR{ch}:DATA:VOL:CLE") def data_arb(self, arb_name, data_points, data_format="DAC"): """ Uploads an arbitrary trace into the volatile memory of the device for a given channel. The data_points can be given as: comma separated 16 bit DAC values (ranging from -32767 to +32767), as comma separated floating point values (ranging from -1.0 to +1.0), or as a binary data stream. Check the manual for more information. The storage depends on the device type and ranges from 8 Sa to 16 MSa (maximum). :param arb_name: The name of the trace in the volatile memory. This is used to access the trace. :param data_points: Individual points of the trace. The format depends on the format parameter. format = 'DAC' (default): Accepts list of integer values ranging from -32767 to +32767. Minimum of 8 a maximum of 65536 points. format = 'float': Accepts list of floating point values ranging from -1.0 to +1.0. Minimum of 8 a maximum of 65536 points. format = 'binary': Accepts a binary stream of 8 bit data. :param data_format: Defines the format of data_points. Can be 'DAC' (default), 'float' or 'binary'. See documentation on parameter data_points above. """ if data_format == "DAC": separator = ", " data_points_str = [str(item) for item in data_points] # Turn list entries into strings data_string = separator.join(data_points_str) # Join strings with separator self.write(f"SOUR{{ch}}:DATA:ARB:DAC {arb_name}, {data_string}") return elif data_format == "float": separator = ", " data_points_str = [str(item) for item in data_points] # Turn list entries into strings data_string = separator.join(data_points_str) # Join strings with separator self.write(f"SOUR{{ch}}:DATA:ARB {arb_name}, {data_string}") return elif data_format == "binary": # TODO: *Binary is not yet implemented* raise NotImplementedError( 'The binary format has not yet been implemented. Use "DAC" or "float" instead.' ) else: raise ValueError( 'Undefined format keyword was used. Valid entries are "DAC", "float" and "binary"' ) class Agilent33500(SCPIMixin, Instrument): """ Represents the Agilent 33500 Function/Arbitrary Waveform Generator family. Individual devices are represented by subclasses. User can specify a channel to control, if no channel specified, a default channel is picked based on the device e.g. For Agilent33500B the default channel is channel 1. See reference manual for your device .. code-block:: python generator = Agilent33500("GPIB::1") generator.shape = 'SIN' # Sets default channel output signal shape to sine generator.channels[1].shape = 'SIN' # Sets channel 1 output signal shape to sine generator.frequency = 1e3 # Sets default channel output frequency to 1 kHz generator.channels[1].frequency = 1e3 # Sets channel 1 output frequency to 1 kHz generator.channels[2].amplitude = 5 # Sets channel 2 output amplitude to 5 Vpp generator.channels[2].output = 'on' # Enables channel 2 output generator.channels[1].shape = 'ARB' # Set channel 1 shape to arbitrary generator.channels[1].arb_srate = 1e6 # Set channel 1 sample rate to 1MSa/s generator.channels[1].data_volatile_clear() # Clear channel 1 volatile internal memory generator.channels[1].data_arb( # Send data of arbitrary waveform to channel 1 'test', range(-10000, 10000, +20), # In this case a simple ramp data_format='DAC' # Data format is set to 'DAC' ) generator.channels[1].arb_file = 'test' # Select the transmitted waveform 'test' """ ch_1 = Instrument.ChannelCreator(Agilent33500Channel, 1) ch_2 = Instrument.ChannelCreator(Agilent33500Channel, 2) def __init__(self, adapter, name="Agilent 33500 Function/Arbitrary Waveform generator family", **kwargs): super().__init__( adapter, name, **kwargs ) def beep(self): """Causes a system beep.""" self.write("SYST:BEEP") shape = Instrument.control( "FUNC?", "FUNC %s", """ Control the output waveform shape (str).""", validator=strict_discrete_set, values=["SIN", "SQU", "TRI", "RAMP", "PULS", "PRBS", "NOIS", "ARB", "DC"], dynamic=True, ) frequency = Instrument.control( "FREQ?", "FREQ %f", """ Control the waveform frequency in Hz (float). Depends on the specified shape.""", validator=strict_range, values=[1e-6, 120e6], dynamic=True, ) amplitude = Instrument.control( "VOLT?", "VOLT %f", """ Control the voltage amplitude in Volts (float).""", validator=strict_range, values=[10e-3, 10], dynamic=True, ) amplitude_unit = Instrument.control( "VOLT:UNIT?", "VOLT:UNIT %s", """ Control the amplitude units (string, strictly 'VPP', 'VRMS', or 'DBM').""", validator=strict_discrete_set, values=["VPP", "VRMS", "DBM"], dynamic=True, ) offset = Instrument.control( "VOLT:OFFS?", "VOLT:OFFS %f", """ Control the voltage offset in Volts (float).""", validator=strict_range, values=[-4.995, +4.995], dynamic=True, ) voltage_high = Instrument.control( "VOLT:HIGH?", "VOLT:HIGH %f", """ Control the upper voltage level in Volts (float).""", validator=strict_range, values=[-4.999, 5], dynamic=True, ) voltage_low = Instrument.control( "VOLT:LOW?", "VOLT:LOW %f", """ Control the lower voltage level in Volts (float).""", validator=strict_range, values=[-5, 4.999], dynamic=True, ) phase = Instrument.control( "PHAS?", "PHAS %f", """ Control the waveform phase in degrees (float, from -360 to 360).""", validator=strict_range, values=[-360, 360], ) square_dutycycle = Instrument.control( "FUNC:SQU:DCYC?", "FUNC:SQU:DCYC %f", """ Control the square wave duty cycle in percent (float).""", validator=strict_range, values=[0.01, 99.98], dynamic=True, ) ramp_symmetry = Instrument.control( "FUNC:RAMP:SYMM?", "FUNC:RAMP:SYMM %f", """ Control the ramp waveform symmetry in percent (float, from 0 to 100).""", validator=strict_range, values=[0, 100], dynamic=True, ) pulse_period = Instrument.control( "FUNC:PULS:PER?", "FUNC:PULS:PER %e", """ Control the pulse period in seconds (float). Overwrites frequency. If the period is shorter than the pulse width + the edge time, the edge time and pulse width are adjusted.""", validator=strict_range, values=[33e-9, 1e6], dynamic=True, ) pulse_hold = Instrument.control( "FUNC:PULS:HOLD?", "FUNC:PULS:HOLD %s", """ Control whether pulse width or duty cycle is maintained when the period or frequency of the waveform is changed (str).""", validator=strict_discrete_set, values=["WIDT", "WIDTH", "DCYC", "DCYCLE"], dynamic=True, ) pulse_width = Instrument.control( "FUNC:PULS:WIDT?", "FUNC:PULS:WIDT %e", """ Control the pulse width in seconds (float).""", validator=strict_range, values=[16e-9, 1e6], dynamic=True, ) pulse_dutycycle = Instrument.control( "FUNC:PULS:DCYC?", "FUNC:PULS:DCYC %f", """ Control the pulse duty cycle in percent (float, from 0 to 100).""", validator=strict_range, values=[0, 100], dynamic=True, ) pulse_transition = Instrument.control( "FUNC:PULS:TRAN?", "FUNC:PULS:TRAN:BOTH %e", """ Control the pulse edge time (both rising and falling) in seconds (float).""", validator=strict_range, values=[8.4e-9, 1e-6], dynamic=True, ) output = Instrument.control( "OUTP?", "OUTP %d", """ Control the output state (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, "on": 1, "ON": 1, False: 0, "off": 0, "OFF": 0}, dynamic=True, ) output_load = Instrument.control( "OUTP:LOAD?", "OUTP:LOAD %s", """ Control the expected load resistance in Ohms (str or float). The output impedance is always 50 Ohm, this setting can be used to correct the displayed voltage for loads unmatched to 50 Ohm.""", dynamic=True, ) burst_state = Instrument.control( "BURS:STAT?", "BURS:STAT %d", """ Control the burst mode state (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, dynamic=True, ) burst_mode = Instrument.control( "BURS:MODE?", "BURS:MODE %s", """ Control the burst mode type (str, strictly 'TRIG' or 'GAT').""", validator=strict_discrete_set, values=["TRIG", "TRIGGERED", "GAT", "GATED"], dynamic=True, ) burst_period = Instrument.control( "BURS:INT:PER?", "BURS:INT:PER %e", """ Control the period of subsequent bursts in seconds (float).""", validator=strict_range, values=[1e-6, 8000], dynamic=True, ) burst_ncycles = Instrument.control( "BURS:NCYC?", "BURS:NCYC %d", """ Control the number of cycles to be output when a burst is triggered (int).""", validator=strict_range, values=range(1, 100000), dynamic=True, ) arb_file = Instrument.control( "FUNC:ARB?", "FUNC:ARB %s", """ Control the arbitrary signal to use from the volatile memory of the device.""", dynamic=True, ) arb_advance = Instrument.control( "FUNC:ARB:ADV?", "FUNC:ARB:ADV %s", """ Control how the device advances from data point to data point (str). Can be set to 'TRIG' or 'SRAT' (default).""", validator=strict_discrete_set, values=["TRIG", "TRIGGER", "SRAT", "SRATE"], ) arb_filter = Instrument.control( "FUNC:ARB:FILT?", "FUNC:ARB:FILT %s", """ Control the filter setting for arbitrary signals (str). Can be set to 'NORM', 'STEP' and 'OFF'.""", validator=strict_discrete_set, values=["NORM", "NORMAL", "STEP", "OFF"], ) # TODO: This implementation is currently not working. Do not know why. # arb_period = Instrument.control( # "FUNC:ARB:PER?", "FUNC:ARB:PER %e", # """ Control (float) the period of the arbitrary signal. # Limited by number of signal points. Check for instrument errors when setting # this property.""", # validator=strict_range, # values=[33e-9, 1e6], # ) # # arb_frequency = Instrument.control( # "FUNC:ARB:FREQ?", "FUNC:ARB:FREQ %f", # """ Control (float) the frequency of the arbitrary signal. # Limited by number of signal points. Check for instrument # errors when setting this property.""", # validator=strict_range, # values=[1e-6, 30e+6], # ) # # arb_npoints = Instrument.measurement( # "FUNC:ARB:POIN?", # """ Returns the number of points in the currently selected arbitrary trace. """ # ) # # arb_voltage = Instrument.control( # "FUNC:ARB:PTP?", "FUNC:ARB:PTP %f", # """ Control (float) the peak-to-peak voltage for the # currently selected arbitrary signal. Valid values are 1 mV to 10 V. This can be # set. """, # validator=strict_range, # values=[0.001, 10], # ) arb_srate = Instrument.control( "FUNC:ARB:SRAT?", "FUNC:ARB:SRAT %f", """ Control the sample rate of the currently selected arbitrary signal in Sa/s (float). Valid values range from 1 µSa/s to 250 MSa/s (maximum range, device-dependent).""", validator=strict_range, values=[1e-6, 250e6], ) def data_volatile_clear(self): """ Clear all arbitrary signals from volatile memory. This should be done if the same name is used continuously to load different arbitrary signals into the memory, since an error will occur if a trace is loaded which already exists in the memory. """ self.write("DATA:VOL:CLE") def phase_sync(self): """ Synchronize the phase of all channels.""" self.write("PHAS:SYNC") def data_arb(self, arb_name, data_points, data_format="DAC"): """ Uploads an arbitrary trace into the volatile memory of the device. The data_points can be given as: comma separated 16 bit DAC values (ranging from -32767 to +32767), as comma separated floating point values (ranging from -1.0 to +1.0) or as a binary data stream. Check the manual for more information. The storage depends on the device type and ranges from 8 Sa to 16 MSa (maximum). :param arb_name: The name of the trace in the volatile memory. This is used to access the trace. :param data_points: Individual points of the trace. The format depends on the format parameter. format = 'DAC' (default): Accepts list of integer values ranging from -32767 to +32767. Minimum of 8 a maximum of 65536 points. format = 'float': Accepts list of floating point values ranging from -1.0 to +1.0. Minimum of 8 a maximum of 65536 points. format = 'binary': Accepts a binary stream of 8 bit data. :param data_format: Defines the format of data_points. Can be 'DAC' (default), 'float' or 'binary'. See documentation on parameter data_points above. """ if data_format == "DAC": separator = ", " data_points_str = [str(item) for item in data_points] # Turn list entries into strings data_string = separator.join(data_points_str) # Join strings with separator self.write(f"DATA:ARB:DAC {arb_name}, {data_string}") return elif data_format == "float": separator = ", " data_points_str = [str(item) for item in data_points] # Turn list entries into strings data_string = separator.join(data_points_str) # Join strings with separator self.write(f"DATA:ARB {arb_name}, {data_string}") return elif data_format == "binary": # TODO: *Binary is not yet implemented* raise NotImplementedError( 'The binary format has not yet been implemented. Use "DAC" or "float" instead.' ) else: raise ValueError( 'Undefined format keyword was used. Valid entries are "DAC", "float" and "binary"' ) display = Instrument.setting( "DISP:TEXT '%s'", """ Set text to be displayed on the front panel of the device (string).""", ) def clear_display(self): """Removes a text message from the display.""" self.write("DISP:TEXT:CLE") def trigger(self): """Send a trigger signal to the function generator.""" self.write("*TRG;*WAI") def wait_for_trigger(self, timeout=3600, should_stop=lambda: False): """ Wait until the triggering has finished or timeout is reached. :param timeout: The maximum time the waiting is allowed to take. If timeout is exceeded, a TimeoutError is raised. If timeout is set to zero, no timeout will be used. :param should_stop: Optional function (returning a bool) to allow the waiting to be stopped before its end. """ self.write("*OPC?") t0 = time() while True: try: ready = bool(self.read()) except VisaIOError: ready = False if ready: return if timeout != 0 and time() - t0 > timeout: raise TimeoutError( "Timeout expired while waiting for the Agilent 33220A" + " to finish the triggering." ) if should_stop: return trigger_source = Instrument.control( "TRIG:SOUR?", "TRIG:SOUR %s", """ Control the trigger source (str).""", validator=strict_discrete_set, values=["IMM", "IMMEDIATE", "EXT", "EXTERNAL", "BUS"], ) ext_trig_out = Instrument.control( "OUTP:TRIG?", "OUTP:TRIG %d", """ Control whether the trigger out signal is active (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0}, ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent33521A.py0000644000175100017510000000454215203313266024010 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range from .agilent33500 import Agilent33500 log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Agilent33521A(Agilent33500): """Represents the Agilent 33521A Function/Arbitrary Waveform Generator. This documentation page shows only methods different from the parent class :doc:`Agilent33500 `. """ def __init__(self, adapter, **kwargs): super().__init__( adapter, **kwargs ) frequency = Instrument.control( "FREQ?", "FREQ %f", """ A floating point property that controls the frequency of the output waveform in Hz, from 1 uHz to 30 MHz, depending on the specified function. Can be set. """, validator=strict_range, values=[1e-6, 30e+6], ) arb_srate = Instrument.control( "FUNC:ARB:SRAT?", "FUNC:ARB:SRAT %f", """ An floating point property that sets the sample rate of the currently selected arbitrary signal. Valid values are 1 µSa/s to 250 MSa/s. This can be set. """, validator=strict_range, values=[1e-6, 250e6], ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent34410A.py0000644000175100017510000000434315203313266024005 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin class Agilent34410A(SCPIUnknownMixin, Instrument): """ Represent the HP/Agilent/Keysight 34410A and related multimeters. Implemented measurements: voltage_dc, voltage_ac, current_dc, current_ac, resistance, resistance_4w """ def __init__(self, adapter, name="HP/Agilent/Keysight 34410A Multimeter", **kwargs): super().__init__( adapter, name, **kwargs ) # only the most simple functions are implemented voltage_dc = Instrument.measurement("MEAS:VOLT:DC? DEF,DEF", "Get DC voltage, in Volts") voltage_ac = Instrument.measurement("MEAS:VOLT:AC? DEF,DEF", "Get AC voltage, in Volts") current_dc = Instrument.measurement("MEAS:CURR:DC? DEF,DEF", "Get DC current, in Amps") current_ac = Instrument.measurement("MEAS:CURR:AC? DEF,DEF", "Get AC current, in Amps") resistance = Instrument.measurement("MEAS:RES? DEF,DEF", "Get Resistance, in Ohms") resistance_4w = Instrument.measurement( "MEAS:FRES? DEF,DEF", "Get Four-wires (remote sensing) resistance, in Ohms") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent34450A.py0000644000175100017510000005733315203313266024020 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import re import logging from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Agilent34450A(SCPIUnknownMixin, Instrument): """ Represent the HP/Agilent/Keysight 34450A and related multimeters. .. code-block:: python dmm = Agilent34450A("USB0::...") dmm.reset() dmm.configure_voltage() print(dmm.voltage) dmm.shutdown() """ BOOLS = {True: 1, False: 0} MODES = {'current': 'CURR', 'ac current': 'CURR:AC', 'voltage': 'VOLT', 'ac voltage': 'VOLT:AC', 'resistance': 'RES', '4w resistance': 'FRES', 'current frequency': 'FREQ:ACI', 'voltage frequency': 'FREQ:ACV', 'continuity': 'CONT', 'diode': 'DIOD', 'temperature': 'TEMP', 'capacitance': 'CAP'} @property def mode(self): """ Control the measurement mode of the multimeter. Can be "current", "ac current", "voltage", "ac voltage", "resistance", "4w resistance", "current frequency", "voltage frequency", "continuity", "diode", "temperature", or "capacitance".""" get_command = ":configure?" vals = self._conf_parser(self.values(get_command)) # Return only the mode parameter inv_modes = {v: k for k, v in self.MODES.items()} mode = inv_modes[vals[0]] return mode @mode.setter def mode(self, value): if value in self.MODES: if value not in ['current frequency', 'voltage frequency']: self.write(':configure:' + self.MODES[value]) else: if value == 'current frequency': self.mode = 'ac current' else: self.mode = 'ac voltage' self.write(":configure:freq") else: raise ValueError(f'Value {value} is not a supported mode for this device.') ############### # Current (A) # ############### current = Instrument.measurement(":READ?", """ Get a DC current measurement in Amps, based on the active :attr:`~.Agilent34450A.mode`. """ ) current_ac = Instrument.measurement(":READ?", """ Get an AC current measurement in Amps, based on the active :attr:`~.Agilent34450A.mode`. """ ) current_range = Instrument.control( ":SENS:CURR:RANG?", ":SENS:CURR:RANG:AUTO 0;:SENS:CURR:RANG %s", """ Control the DC current range in Amps, which can take values 100E-6, 1E-3, 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", or "DEF" (100 mA). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100E-6, 1E-3, 10E-3, 100E-3, 1, 10, "MIN", "DEF", "MAX"] ) current_auto_range = Instrument.control( ":SENS:CURR:RANG:AUTO?", ":SENS:CURR:RANG:AUTO %d", """ Control auto ranging for DC current. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) current_resolution = Instrument.control( ":SENS:CURR:RES?", ":SENS:CURR:RES %s", """ Control the resolution in the DC current readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", and "DEF" (3.00E-5). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) current_ac_range = Instrument.control( ":SENS:CURR:AC:RANG?", ":SENS:CURR:AC:RANG:AUTO 0;:SENS:CURR:AC:RANG %s", """ Control the AC current range in Amps, which can take values 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", or "DEF" (100 mA). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[10E-3, 100E-3, 1, 10, "MIN", "MAX", "DEF"] ) current_ac_auto_range = Instrument.control( ":SENS:CURR:AC:RANG:AUTO?", ":SENS:CURR:AC:RANG:AUTO %d", """ Control auto ranging for AC current. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) current_ac_resolution = Instrument.control( ":SENS:CURR:AC:RES?", ":SENS:CURR:AC:RES %s", """ Control the resolution in the AC current readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) ############### # Voltage (V) # ############### voltage = Instrument.measurement(":READ?", """ Get a DC voltage measurement in Volts, based on the active :attr:`~.Agilent34450A.mode`. """ ) voltage_ac = Instrument.measurement(":READ?", """ Get an AC voltage measurement in Volts, based on the active :attr:`~.Agilent34450A.mode`. """ ) voltage_range = Instrument.control( ":SENS:VOLT:RANG?", ":SENS:VOLT:RANG:AUTO 0;:SENS:VOLT:RANG %s", """ Control the DC voltage range in Volts, which can take values 100E-3, 1, 10, 100, 1000, as well as "MIN", "MAX", or "DEF" (10 V). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100E-3, 1, 10, 100, 1000, "MAX", "MIN", "DEF"] ) voltage_auto_range = Instrument.control( ":SENS:VOLT:RANG:AUTO?", ":SENS:VOLT:RANG:AUTO %d", """ Control auto ranging for DC voltage. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) voltage_resolution = Instrument.control( ":SENS:VOLT:RES?", ":SENS:VOLT:RES %s", """ Control the resolution in the DC voltage readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) voltage_ac_range = Instrument.control( ":SENS:VOLT:AC:RANG?", ":SENS:VOLT:AC:RANG:AUTO 0;:SENS:VOLT:AC:RANG %s", """ Control the AC voltage range in Volts, which can take values 100E-3, 1, 10, 100, 750, as well as "MIN", "MAX", or "DEF" (10 V). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100E-3, 1, 10, 100, 750, "MAX", "MIN", "DEF"] ) voltage_ac_auto_range = Instrument.control( ":SENS:VOLT:AC:RANG:AUTO?", ":SENS:VOLT:AC:RANG:AUTO %d", """ Control auto ranging for AC voltage. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) voltage_ac_resolution = Instrument.control( ":SENS:VOLT:AC:RES?", ":SENS:VOLT:AC:RES %s", """ Control the resolution in the AC voltage readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) #################### # Resistance (Ohm) # #################### resistance = Instrument.measurement(":READ?", """ Get a resistance measurement in Ohms for 2-wire configuration, based on the active :attr:`~.Agilent34450A.mode`. """ ) resistance_4w = Instrument.measurement(":READ?", """ Get a resistance measurement in Ohms for 4-wire configuration, based on the active :attr:`~.Agilent34450A.mode`. """ ) resistance_range = Instrument.control( ":SENS:RES:RANG?", ":SENS:RES:RANG:AUTO 0;:SENS:RES:RANG %s", """ Control the 2-wire resistance range in Ohms, which can take values 100, 1E3, 10E3, 100E3, 1E6, 10E6, 100E6, as well as "MIN", "MAX", or "DEF" (1E3). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100, 1E3, 10E3, 100E3, 1E6, 10E6, 100E6, "MAX", "MIN", "DEF"] ) resistance_auto_range = Instrument.control( ":SENS:RES:RANG:AUTO?", ":SENS:RES:RANG:AUTO %d", """ Control auto ranging for 2-wire resistance. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) resistance_resolution = Instrument.control( ":SENS:RES:RES?", ":SENS:RES:RES %s", """ Control the resolution in the 2-wire resistance readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) resistance_4w_range = Instrument.control( ":SENS:FRES:RANG?", ":SENS:FRES:RANG:AUTO 0;:SENS:FRES:RANG %s", """ Control the 4-wire resistance range in Ohms, which can take values 100, 1E3, 10E3, 100E3, 1E6, 10E6, 100E6, as well as "MIN", "MAX", or "DEF" (1E3). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100, 1E3, 10E3, 100E3, 1E6, 10E6, 100E6, "MAX", "MIN", "DEF"] ) resistance_4w_auto_range = Instrument.control( ":SENS:FRES:RANG:AUTO?", ":SENS:FRES:RANG:AUTO %d", """ Control auto ranging for 4-wire resistance. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) resistance_4w_resolution = Instrument.control( ":SENS:FRES:RES?", ":SENS:FRES:RES %s", """ Control the resolution in the 4-wire resistance readings, which can take values 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """, validator=strict_discrete_set, values=[3.00E-5, 2.00E-5, 1.50E-6, "MAX", "MIN", "DEF"] ) ################## # Frequency (Hz) # ################## frequency = Instrument.measurement(":READ?", """ Get a frequency measurement in Hz, based on the active :attr:`~.Agilent34450A.mode`. """ ) frequency_current_range = Instrument.control( ":SENS:FREQ:CURR:RANG?", ":SENS:FREQ:CURR:RANG:AUTO 0;:SENS:FREQ:CURR:RANG %s", """ Control the current range in Amps for frequency on AC current measurements, which can take values 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", or "DEF" (100 mA). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[10E-3, 100E-3, 1, 10, "MIN", "MAX", "DEF"] ) frequency_current_auto_range = Instrument.control( ":SENS:FREQ:CURR:RANG:AUTO?", ":SENS:FREQ:CURR:RANG:AUTO %d", """ Control whether auto ranging for AC current in frequency measurements is enabled.""", validator=strict_discrete_set, values=BOOLS, map_values=True ) frequency_voltage_range = Instrument.control( ":SENS:FREQ:VOLT:RANG?", ":SENS:FREQ:VOLT:RANG:AUTO 0;:SENS:FREQ:VOLT:RANG %s", """ Control the voltage range in Volts for frequency on AC voltage measurements, which can take values 100E-3, 1, 10, 100, 750, as well as "MIN", "MAX", or "DEF" (10 V). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[100E-3, 1, 10, 100, 750, "MAX", "MIN", "DEF"] ) frequency_voltage_auto_range = Instrument.control( ":SENS:FREQ:VOLT:RANG:AUTO?", ":SENS:FREQ:VOLT:RANG:AUTO %d", """Control whether auto ranging for AC voltage in frequency measurements is enabled. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) frequency_aperture = Instrument.control( ":SENS:FREQ:APER?", ":SENS:FREQ:APER %s", """ Control the frequency aperture in seconds, which sets the integration period and measurement speed. Takes values 100 ms, 1 s, as well as "MIN", "MAX", or "DEF" (1 s). """, validator=strict_discrete_set, values=[100E-3, 1, "MIN", "MAX", "DEF"] ) ################### # Temperature (C) # ################### temperature = Instrument.measurement( ":READ?", """ Get a temperature measurement in Celsius, based on the active :attr:`~.Agilent34450A.mode`. """ # noqa: E501 ) ############# # Diode (V) # ############# diode = Instrument.measurement( ":READ?", """ Get a diode measurement in Volts, based on the active :attr:`~.Agilent34450A.mode`. """ ) ################### # Capacitance (F) # ################### capacitance = Instrument.measurement( ":READ?", """ Get a capacitance measurement in Farads, based on the active :attr:`~.Agilent34450A.mode`. """ # noqa: E501 ) capacitance_range = Instrument.control( ":SENS:CAP:RANG?", ":SENS:CAP:RANG:AUTO 0;:SENS:CAP:RANG %s", """ Control the capacitance range in Farads, which can take values 1E-9, 10E-9, 100E-9, 1E-6, 10E-6, 100E-6, 1E-3, 10E-3, as well as "MIN", "MAX", or "DEF" (1E-6). Auto-range is disabled when this property is set. """, validator=strict_discrete_set, values=[1E-9, 10E-9, 100E-9, 1E-6, 10E-6, 100E-6, 1E-3, 10E-3, "MAX", "MIN", "DEF"] ) capacitance_auto_range = Instrument.control( ":SENS:CAP:RANG:AUTO?", ":SENS:CAP:RANG:AUTO %d", """ Control auto ranging for capacitance. """, validator=strict_discrete_set, values=BOOLS, map_values=True ) #################### # Continuity (Ohm) # #################### continuity = Instrument.measurement(":READ?", """ Get a continuity measurement in Ohms, based on the active :attr:`~.Agilent34450A.mode`. """ ) def __init__(self, adapter, name="HP/Agilent/Keysight 34450A Multimeter", **kwargs): super().__init__( adapter, name, timeout=10000, **kwargs ) # Configuration changes can necessitate up to 8.8 secs (per datasheet) self.check_errors() def configure_voltage(self, voltage_range="AUTO", ac=False, resolution="DEF"): """ Configures the instrument to measure voltage. :param voltage_range: A voltage in Volts to set the voltage range. DC values can be 100E-3, 1, 10, 100, 1000, as well as "MIN", "MAX", "DEF" (10 V), or "AUTO". AC values can be 100E-3, 1, 10, 100, 750, as well as "MIN", "MAX", "DEF" (10 V), or "AUTO". :param ac: False for DC voltage, True for AC voltage :param resolution: Desired resolution, can be 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """ if ac is True: self.mode = 'ac voltage' self.voltage_ac_resolution = resolution if voltage_range == "AUTO": self.voltage_ac_auto_range = True else: self.voltage_ac_range = voltage_range elif ac is False: self.mode = 'voltage' self.voltage_resolution = resolution if voltage_range == "AUTO": self.voltage_auto_range = True else: self.voltage_range = voltage_range else: raise TypeError('Value of ac should be a boolean.') def configure_current(self, current_range="AUTO", ac=False, resolution="DEF"): """ Configures the instrument to measure current. :param current_range: A current in Amps to set the current range. DC values can be 100E-6, 1E-3, 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", "DEF" (100 mA), or "AUTO". AC values can be 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", "DEF" (100 mA), or "AUTO". :param ac: False for DC current, and True for AC current :param resolution: Desired resolution, can be 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """ if ac is True: self.mode = 'ac current' self.current_ac_resolution = resolution if current_range == "AUTO": self.current_ac_auto_range = True else: self.current_ac_range = current_range elif ac is False: self.mode = 'current' self.current_resolution = resolution if current_range == "AUTO": self.current_auto_range = True else: self.current_range = current_range else: raise TypeError('Value of ac should be a boolean.') def configure_resistance(self, resistance_range="AUTO", wires=2, resolution="DEF"): """ Configures the instrument to measure resistance. :param resistance_range: A resistance in Ohms to set the resistance range, can be 100, 1E3, 10E3, 100E3, 1E6, 10E6, 100E6, as well as "MIN", "MAX", "DEF" (1E3), or "AUTO". :param wires: Number of wires used for measurement, can be 2 or 4. :param resolution: Desired resolution, can be 3.00E-5, 2.00E-5, 1.50E-6 (5 1/2 digits), as well as "MIN", "MAX", or "DEF" (1.50E-6). """ if wires == 2: self.mode = 'resistance' self.resistance_resolution = resolution if resistance_range == "AUTO": self.resistance_auto_range = True else: self.resistance_range = resistance_range elif wires == 4: self.mode = '4w resistance' self.resistance_4w_resolution = resolution if resistance_range == "AUTO": self.resistance_4w_auto_range = True else: self.resistance_4w_range = resistance_range else: raise ValueError("Incorrect wires value, Agilent 34450A only supports 2 or 4 wire" "resistance measurement.") def configure_frequency(self, measured_from="voltage_ac", measured_from_range="AUTO", aperture="DEF"): """ Configures the instrument to measure frequency. :param measured_from: "voltage_ac" or "current_ac" :param measured_from_range: range of measured_from. AC voltage can have ranges 100E-3, 1, 10, 100, 750, as well as "MIN", "MAX", "DEF" (10 V), or "AUTO". AC current can have ranges 10E-3, 100E-3, 1, 10, as well as "MIN", "MAX", "DEF" (100 mA), or "AUTO". :param aperture: Aperture time in Seconds, can be 100 ms, 1 s, as well as "MIN", "MAX", or "DEF" (1 s). """ if measured_from == "voltage_ac": self.mode = "voltage frequency" if measured_from_range == "AUTO": self.frequency_voltage_auto_range = True else: self.frequency_voltage_range = measured_from_range elif measured_from == "current_ac": self.mode = "current frequency" if measured_from_range == "AUTO": self.frequency_current_auto_range = True else: self.frequency_current_range = measured_from_range else: raise ValueError('Incorrect value for measured_from parameter. Use ' '"voltage_ac" or "current_ac".') self.frequency_aperture = aperture def configure_temperature(self): """ Configures the instrument to measure temperature. """ self.mode = 'temperature' def configure_diode(self): """ Configures the instrument to measure diode voltage. """ self.mode = 'diode' def configure_capacitance(self, capacitance_range="AUTO"): """ Configures the instrument to measure capacitance. :param capacitance_range: A capacitance in Farads to set the capacitance range, can be 1E-9, 10E-9, 100E-9, 1E-6, 10E-6, 100E-6, 1E-3, 10E-3, as well as "MIN", "MAX", "DEF" (1E-6), or "AUTO". """ self.mode = 'capacitance' if capacitance_range == "AUTO": self.capacitance_auto_range = True else: self.capacitance_range = capacitance_range def configure_continuity(self): """ Configures the instrument to measure continuity. """ self.mode = 'continuity' def beep(self): """ Sounds a system beep. """ self.write(":SYST:BEEP") def local(self): """ Set the instrument to local mode and return control to its front panel. """ self.write(":SYST:LOC") def _conf_parser(self, conf_values): """ Parse the string of configuration parameters read from Agilent34450A with command ":configure?" and returns a list of parameters. Use cases: ['"CURR +1.000000E-01', '+1.500000E-06"'] from Instrument.measurement or Instrument.control '"CURR +1.000000E-01,+1.500000E-06"' from Instrument.ask becomes ["CURR", +1000000E-01, +1.500000E-06] """ # If not already one string, get one string if isinstance(conf_values, list): one_long_string = ', '.join(map(str, conf_values)) else: one_long_string = conf_values # Split string in elements list_of_elements = re.split(r'["\s,]', one_long_string) # Eliminate empty string elements list_without_empty_elements = list(filter(lambda v: v != '', list_of_elements)) # Convert numbers from str to float, where applicable for i, v in enumerate(list_without_empty_elements): try: list_without_empty_elements[i] = float(v) except ValueError as e: log.error(e) return list_without_empty_elements ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent4156.py0000644000175100017510000007143715203313266023640 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import time import os import json import numpy as np import pandas as pd from pymeasure.instruments import Channel, Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import (strict_discrete_set, truncated_discrete_set, strict_range) import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) ###### # MAIN ###### class Agilent4156(SCPIUnknownMixin, Instrument): """ Represents the Agilent 4155/4156 Semiconductor Parameter Analyzer and provides a high-level interface for taking current-voltage (I-V) measurements. .. code-block:: python from pymeasure.instruments.agilent import Agilent4156 # explicitly define r/w terminations; set sufficiently large timeout or None. smu = Agilent4156("GPIB0::25", read_termination = '\\n', write_termination = '\\n', timeout=None) # reset the instrument smu.reset() # define configuration file for instrument and load config smu.configure("configuration_file.json") # save data variables, some or all of which are defined in the json config file. smu.save(['VC', 'IC', 'VB', 'IB']) # take measurements status = smu.measure() # measured data is a pandas dataframe and can be exported to csv. data = smu.get_data(path='./t1.csv') The JSON file is an ascii text configuration file that defines the settings of each channel on the instrument. The JSON file is used to configure the instrument using the convenience function :meth:`~.Agilent4156.configure` as shown in the example above. For example, the instrument setup for a bipolar transistor measurement is shown below. .. code-block:: json { "SMU1": { "voltage_name" : "VC", "current_name" : "IC", "channel_function" : "VAR1", "channel_mode" : "V", "series_resistance" : "0OHM" }, "SMU2": { "voltage_name" : "VB", "current_name" : "IB", "channel_function" : "VAR2", "channel_mode" : "I", "series_resistance" : "0OHM" }, "SMU3": { "voltage_name" : "VE", "current_name" : "IE", "channel_function" : "CONS", "channel_mode" : "V", "constant_value" : 0, "compliance" : 0.1 }, "SMU4": { "voltage_name" : "VS", "current_name" : "IS", "channel_function" : "CONS", "channel_mode" : "V", "constant_value" : 0, "compliance" : 0.1 }, "VAR1": { "start" : 1, "stop" : 2, "step" : 0.1, "spacing" : "LINEAR", "compliance" : 0.1 }, "VAR2": { "start" : 0, "step" : 10e-6, "points" : 3, "compliance" : 2 } } """ def __init__(self, adapter, name="Agilent 4155/4156 Semiconductor Parameter Analyzer", **kwargs): super().__init__( adapter, name, **kwargs ) self.smu1 = SMU(self, 'SMU1') self.smu2 = SMU(self, 'SMU2') self.smu3 = SMU(self, 'SMU3') self.smu4 = SMU(self, 'SMU4') self.vmu1 = VMU(self, 'VMU1') self.vmu2 = VMU(self, 'VMU2') self.vsu1 = VSU(self, 'VSU1') self.vsu2 = VSU(self, 'VSU2') self.var1 = VAR1(self) self.var2 = VAR2(self) self.vard = VARD(self) analyzer_mode = Instrument.control( ":PAGE:CHAN:MODE?", ":PAGE:CHAN:MODE %s", """Control the instrument operating mode. - Values: :code:`SWEEP`, :code:`SAMPLING` .. code-block:: python smu.analyzer_mode = "SWEEP" """, validator=strict_discrete_set, values={'SWEEP': 'SWE', 'SAMPLING': 'SAMP'}, map_values=True, check_set_errors=True, check_get_errors=True ) integration_time = Instrument.control( ":PAGE:MEAS:MSET:ITIM?", ":PAGE:MEAS:MSET:ITIM %s", """Control the integration time. - Values: :code:`SHORT`, :code:`MEDIUM`, :code:`LONG` .. code-block:: python instr.integration_time = "MEDIUM" """, validator=strict_discrete_set, values={'SHORT': 'SHOR', 'MEDIUM': 'MED', 'LONG': 'LONG'}, map_values=True, check_set_errors=True, check_get_errors=True ) delay_time = Instrument.control( ":PAGE:MEAS:DEL?", ":PAGE:MEAS:DEL %g", """Control the measurement delay time in seconds, which can take the values from 0 to 65s in 0.1s steps. .. code-block:: python instr.delay_time = 1 # delay time of 1-sec """, validator=truncated_discrete_set, values=np.arange(0, 65.1, 0.1), check_set_errors=True, check_get_errors=True ) hold_time = Instrument.control( ":PAGE:MEAS:HTIME?", ":PAGE:MEAS:HTIME %g", """Control the measurement hold time in seconds, which can take the values from 0 to 655s in 1s steps. .. code-block:: python instr.hold_time = 2 # hold time of 2-secs. """, validator=truncated_discrete_set, values=np.arange(0, 655, 1), check_set_errors=True, check_get_errors=True ) def stop(self): """Stop the ongoing measurement. .. code-block:: python instr.stop() """ self.write(":PAGE:SCON:STOP") def measure(self, period="INF", points=100): """ Perform a single measurement and wait for completion in sweep mode. In sampling mode, the measurement period and number of points can be specified. :param period: Period of sampling measurement from 6E-6 to 1E11 seconds. Default setting is :code:`INF`. :param points: Number of samples to be measured, from 1 to 10001. Default setting is :code:`100`. .. code-block::python instr.measure() #for sweep measurement instr.measure(period=100, points=100) #for sampling measurement """ if self.analyzer_mode == "SWEEP": self.write(":PAGE:SCON:MEAS:SING; *OPC?") else: self.write(f":PAGE:MEAS:SAMP:PER {period}") self.write(f":PAGE:MEAS:SAMP:POIN {points}") self.write(":PAGE:SCON:MEAS:SING; *OPC?") def disable_all(self): """ Disable all channels in the instrument. .. code-block:: python instr.disable_all() """ self.smu1.reset_settings() time.sleep(0.1) self.smu2.reset_settings() time.sleep(0.1) self.smu3.reset_settings() time.sleep(0.1) self.smu4.reset_settings() time.sleep(0.1) self.vmu1.reset_settings() time.sleep(0.1) self.vmu2.reset_settings() time.sleep(0.1) def configure(self, config_file): """ Configure the channel setup and sweep using a JSON configuration file. (JSON is the `JavaScript Object Notation`_) .. _`JavaScript Object Notation`: https://www.json.org/ :param config_file: JSON file to configure instrument channels. .. code-block:: python instr.configure('config.json') """ self.disable_all() obj_dict = {'SMU1': self.smu1, 'SMU2': self.smu2, 'SMU3': self.smu3, 'SMU4': self.smu4, 'VMU1': self.vmu1, 'VMU2': self.vmu2, 'VSU1': self.vsu1, 'VSU2': self.vsu2, 'VAR1': self.var1, 'VAR2': self.var2, 'VARD': self.vard } with open(config_file) as stream: try: instr_settings = json.load(stream) except json.JSONDecodeError as e: print(e) # replace dict keys with Instrument objects new_settings_dict = {} for key, value in instr_settings.items(): new_settings_dict[obj_dict[key]] = value for obj, setup in new_settings_dict.items(): for setting, value in setup.items(): setattr(obj, setting, value) time.sleep(0.1) def save(self, trace_list): """ Save the voltage or current in the instrument display list :param trace_list: A list of channel variables whose measured data should be saved. A maximum of 8 variables are allowed. If only one variable is being saved, a string can be specified. .. code-block:: python instr.save(['IC', 'IB', 'VC', 'VB']) #for list of variables instr.save('IC') #for single variable """ self.write(":PAGE:DISP:MODE LIST") if isinstance(trace_list, list): if len(trace_list) > 8: raise RuntimeError('Maximum of 8 variables allowed') else: for name in trace_list: self.write(f":PAGE:DISP:LIST \'{name}\'") elif isinstance(trace_list, str): self.write(f":PAGE:DISP:LIST \'{trace_list}\'") else: raise TypeError( 'Must be a string if only one variable is saved, or else a list if' 'multiple variables are being saved.' ) def save_var(self, trace_list): """ Save the voltage or current in the instrument variable list. This is useful if one or two more variables need to be saved in addition to the 8 variables allowed by :meth:`~.Agilent4156.save`. :param trace_list: A list of channel variables whose measured data should be saved. A maximum of 2 variables are allowed. If only one variable is being saved, a string can be specified. .. code-block:: python instr.save_var(['VA', 'VB']) """ self.write(":PAGE:DISP:MODE LIST") if isinstance(trace_list, list): if len(trace_list) > 2: raise RuntimeError('Maximum of 2 variables allowed') else: for name in trace_list: self.write(f":PAGE:DISP:DVAR \'{name}\'") elif isinstance(trace_list, str): self.write(f":PAGE:DISP:DVAR \'{trace_list}\'") else: raise TypeError( 'Must be a string if only one variable is saved, or else a list if' 'multiple variables are being saved.' ) @property def data_variables(self): """ Get a string list of data variables for which measured data is available. This looks for all the variables saved by the :meth:`~.Agilent4156.save` and :meth:`~.Agilent4156.save_var` methods and returns it. This is useful for creation of dataframe headers. :returns: List .. code-block:: python header = instr.data_variables """ dlist = self.ask(":PAGE:DISP:LIST?").split(',') dvar = self.ask(":PAGE:DISP:DVAR?").split(',') varlist = dlist + dvar return list(filter(None, varlist)) def get_data(self, path=None): """ Get the measurement data from the instrument after completion. If the measurement period is set to :code:`INF` in the :meth:`~.Agilent4156.measure` method, then the measurement must be stopped using :meth:`~.Agilent4156.stop` before getting valid data. :param path: Path for optional data export to CSV. :returns: Pandas Dataframe .. code-block:: python df = instr.get_data(path='./datafolder/data1.csv') """ if int(self.ask('*OPC?')): header = self.data_variables self.write(":FORM:DATA ASC") # recursively get data for each variable for i, listvar in enumerate(header): data = self.values(f":DATA? \'{listvar}\'") time.sleep(0.01) if i == 0: lastdata = data else: data = np.column_stack((lastdata, data)) lastdata = data df = pd.DataFrame(data=data, columns=header, index=None) if path is not None: _, ext = os.path.splitext(path) if ext != ".csv": path = path + ".csv" df.to_csv(path, index=False) return df def check_current_voltage_name(name): if (len(name) > 6) or not name[0].isalpha(): new_name = 'a' + name[:5] log.info(f"Renaming {name} to {new_name}...") name = new_name return name ########## # CHANNELS ########## class AgilentMeasurementChannel(Channel): """Offers some common properties.""" voltage_name = Channel.control( "PAGE:CHAN:{ch}:VNAME?", ":PAGE:CHAN:{ch}:VNAME \'%s\'", """ Control the voltage name of the channel. If input is greater than 6 characters long or starts with a number, the name is autocorrected and prepended with 'a'. Event is logged. .. code-block:: python instr.smu1.voltage_name = "Vbase" """, set_process=check_current_voltage_name, ) def reset_settings(self): """Reset the settings of this channel to default value. .. code-block:: python instr.smu1.reset_settings() """ self.write(":PAGE:CHAN:{ch}:DIS") return self.check_errors() @property def disable(self): """Set the settings of this channel to default value. .. code-block:: python instr.smu1.disable """ self.reset_settings() channel_mode = Channel.control( ":PAGE:CHAN:{ch}:MODE?", ":PAGE:CHAN:{ch}:MODE %s", """Control the channel mode.""", values=[], validator=strict_discrete_set, check_get_errors=True, check_set_errors=True, dynamic=True, ) channel_function = Channel.control( ":PAGE:CHAN:{ch}:FUNC?", ":PAGE:CHAN:{ch}:FUNC %s", """Control the channel function. - Values: :code:`VAR1`, :code:`VAR2`, :code:`VARD` or :code:`CONS`. """, check_get_errors=True, check_set_errors=True, validator=strict_discrete_set, values=["VAR1", "VAR2", "VARD", "CONS"], ) class SMU(AgilentMeasurementChannel): """SMU of Agilent 4155/4156 Semiconductor Parameter Analyzer""" def __init__(self, parent, id, **kwargs): super().__init__( parent, id.upper(), **kwargs ) self.channel_mode_values = ["V", "I", "COMM"] series_resistance = Channel.control( ":PAGE:CHAN:{ch}:SRES?", ":PAGE:CHAN:{ch}:SRES %s", """ Control the series resistance of SMU. - Values: :code:`0OHM`, :code:`10KOHM`, :code:`100KOHM`, or :code:`1MOHM` .. code-block:: python instr.smu1.series_resistance = "10KOHM" """, check_get_errors=True, check_set_errors=True, validator=strict_discrete_set, values=["0OHM", "10KOHM", "100KOHM", "1MOHM"], ) @property def constant_value(self): """Control the constant source value of SMU. You use this command only if :meth:`~.SMU.channel_function` is :code:`CONS` and also :meth:`~.SMU.channel_mode` should not be :code:`COMM`. :param const_value: Voltage in (-200V, 200V) and current in (-1A, 1A). Voltage or current depends on if :meth:`~.SMU.channel_mode` is set to :code:`V` or :code:`I`. .. code-block:: python instr.smu1.constant_value = 1 """ if self.parent.analyzer_mode == "SWEEP": value = self.ask(":PAGE:MEAS:CONS:{ch}?") else: value = self.ask(":PAGE:MEAS:SAMP:CONS:{ch}?") self.check_errors() return value @constant_value.setter def constant_value(self, const_value): validator = strict_range values = self.__validate_cons() value = validator(const_value, values) if self.parent.analyzer_mode == 'SWEEP': self.write(f":PAGE:MEAS:CONS:{{ch}} {value}") else: self.write(":PAGE:MEAS:SAMP:CONS:{} {}".format( self.channel, value)) self.check_errors() @property def compliance(self): """Control the *constant* compliance value of SMU. If the SMU channel is setup as a variable (VAR1, VAR2, VARD) then compliance limits are set by the variable definition. - Value: Voltage in (-200V, 200V) and current in (-1A, 1A) based on :meth:`~.SMU.channel_mode`. .. code-block:: python instr.smu1.compliance = 0.1 """ if self.parent.analyzer_mode == "SWEEP": value = self.ask(":PAGE:MEAS:CONS:{ch}:COMP?") else: value = self.ask( ":PAGE:MEAS:SAMP:CONS:{ch}:COMP?") self.check_errors() return value @compliance.setter def compliance(self, comp): validator = strict_range values = self.__validate_compl() value = validator(comp, values) if self.parent.analyzer_mode == 'SWEEP': self.write(":PAGE:MEAS:CONS:{}:COMP {}".format( self.channel, value)) else: self.write(":PAGE:MEAS:SAMP:CONS:{}:COMP {}".format( self.channel, value)) self.check_errors() current_name = Channel.control( "PAGE:CHAN:{ch}:INAME?", ":PAGE:CHAN:{ch}:INAME \'%s\'", """ Control the current name of the channel. If input is greater than 6 characters long or starts with a number, the name is autocorrected and prepended with 'a'. Event is logged. .. code-block:: python instr.smu1.voltage_name = "Vbase" """, set_process=check_current_voltage_name, ) def __validate_cons(self): """Validates the instrument settings for operation in constant mode. """ if not ((self.channel_mode != 'COMM') and ( self.channel_function == 'CONS')): raise ValueError( 'Cannot set constant SMU function when SMU mode is COMMON, ' 'or when SMU function is not CONSTANT.' ) else: values = valid_iv(self.channel_mode) return values def __validate_compl(self): """Validates the instrument compliance for operation in constant mode. """ if not ((self.channel_mode != 'COMM') and ( self.channel_function == 'CONS')): raise ValueError( 'Cannot set constant SMU parameters when SMU mode is COMMON, ' 'or when SMU function is not CONSTANT.' ) else: values = valid_compliance(self.channel_mode) return values class VMU(AgilentMeasurementChannel): """VMU of Agilent 4155/4156 Semiconductor Parameter Analyzer""" def __init__(self, parent, id, **kwargs): super().__init__( parent, id=id.upper(), **kwargs ) self.channel_mode_values = ["V", "DVOL"] class VSU(AgilentMeasurementChannel): """VSU of Agilent 4155/4156 Semiconductor Parameter Analyzer""" def __init__(self, parent, id, **kwargs): super().__init__( parent, id.upper(), **kwargs ) @property def constant_value(self): """Control the constant source value of VSU. .. code-block:: python instr.vsu1.constant_value = 0 """ if self.parent.analyzer_mode == "SWEEP": value = self.ask(":PAGE:MEAS:CONS:{ch}?") else: value = self.ask(":PAGE:MEAS:SAMP:CONS:{ch}?") self.check_errors() return value @constant_value.setter def constant_value(self, const_value): validator = strict_range values = [-200, 200] value = validator(const_value, values) if self.parent.analyzer_mode == 'SWEEP': self.write(f":PAGE:MEAS:CONS:{{ch}} {value}") else: self.write(":PAGE:MEAS:SAMP:CONS:{} {}".format( self.channel, value)) self.check_errors() ################# # SWEEP VARIABLES ################# class VARX(Channel): """ Base class to define sweep variable settings.""" def __init__(self, parent, id, **kwargs): super().__init__( parent, id.upper(), **kwargs ) @property def channel_mode(self): """Control the channel mode.""" channels = ['SMU1', 'SMU2', 'SMU3', 'SMU4', 'VSU1', 'VSU2'] for ch in channels: ch_func = self.ask(f":PAGE:CHAN:{ch}:FUNC?") if ch_func == self.id: ch_mode = self.ask(f":PAGE:CHAN:{ch}:MODE?") return ch_mode @property def start(self): """Control the sweep START value. .. code-block:: python instr.var1.start = 0 """ value = self.ask(":PAGE:MEAS:{ch}:STAR?") self.check_errors() return value @start.setter def start(self, value): validator = strict_range values = valid_iv(self.channel_mode) set_value = validator(value, values) self.write(f":PAGE:MEAS:{{ch}}:STAR {set_value}") self.check_errors() @property def stop(self): """Control the sweep STOP value. .. code-block:: python instr.var1.stop = 3 """ value = self.ask(":PAGE:MEAS:{ch}:STOP?") self.check_errors() return value @stop.setter def stop(self, value): validator = strict_range values = valid_iv(self.channel_mode) set_value = validator(value, values) self.write(f":PAGE:MEAS:{{ch}}:STOP {set_value}") self.check_errors() @property def step(self): """Control the sweep STEP value. .. code-block:: python instr.var1.step = 0.1 """ value = self.ask(":PAGE:MEAS:{ch}:STEP?") self.check_errors() return value @step.setter def step(self, value): validator = strict_range values = 2 * valid_iv(self.channel_mode) set_value = validator(value, values) self.write(f":PAGE:MEAS:{{ch}}:STEP {set_value}") self.check_errors() @property def compliance(self): """Control the sweep COMPLIANCE value. .. code-block:: python instr.var1.compliance = 0.1 """ value = self.ask(":PAGE:MEAS:{}:COMP?") self.check_errors() return value @compliance.setter def compliance(self, value): validator = strict_range values = 2 * valid_compliance(self.channel_mode) set_value = validator(value, values) self.write(f":PAGE:MEAS:{{ch}}:COMP {set_value}") self.check_errors() class VAR1(VARX): """ Class to handle all the specific definitions needed for VAR1. Most common methods are inherited from base class. """ def __init__(self, parent, **kwargs): super().__init__( parent, "VAR1", **kwargs ) spacing = Channel.control( ":PAGE:MEAS:{ch}:SPAC?", ":PAGE:MEAS:{ch}:SPAC %s", """ Control the sweep type of VAR1. - Values: :code:`LINEAR`, :code:`LOG10`, :code:`LOG25`, :code:`LOG50`. """, validator=strict_discrete_set, values={'LINEAR': 'LIN', 'LOG10': 'L10', 'LOG25': 'L25', 'LOG50': 'L50'}, map_values=True, check_set_errors=True, check_get_errors=True ) class VAR2(VARX): """ Class to handle all the specific definitions needed for VAR2. Common methods are imported from base class. """ def __init__(self, adapter, **kwargs): super().__init__( adapter, "VAR2", **kwargs ) points = Channel.control( ":PAGE:MEAS:{ch}:POINTS?", ":PAGE:MEAS:{ch}:POINTS %g", """ Control the number of sweep steps of VAR2. You use this command only if there is an SMU or VSU whose function (FCTN) is VAR2. .. code-block:: python instr.var2.points = 10 """, validator=strict_discrete_set, values=range(1, 128), check_set_errors=True, check_get_errors=True ) class VARD(Channel): """ Class to handle all the definitions needed for VARD. VARD is always defined in relation to VAR1. """ def __init__(self, parent, id="VARD", **kwargs): super().__init__( parent, id, **kwargs ) @property def channel_mode(self): """Control the channel mode.""" channels = ['SMU1', 'SMU2', 'SMU3', 'SMU4', 'VSU1', 'VSU2'] for ch in channels: ch_func = self.ask(f":PAGE:CHAN:{ch}:FUNC?") if ch_func == "VARD": ch_mode = self.ask(f":PAGE:CHAN:{ch}:MODE?") return ch_mode @property def offset(self): """ Control the OFFSET value of VARD. For each step of sweep, the output values of VAR1' are determined by the following equation: VARD = VAR1 X RATio + OFFSet You use this command only if there is an SMU or VSU whose function is VARD. .. code-block:: python instr.vard.offset = 1 """ value = self.ask(":PAGE:MEAS:VARD:OFFSET?") self.check_errors() return value @offset.setter def offset(self, offset_value): validator = strict_range values = 2 * valid_iv(self.channel_mode) value = validator(offset_value, values) self.write(f":PAGE:MEAS:VARD:OFFSET {value}") self.check_errors() ratio = Instrument.control( ":PAGE:MEAS:VARD:RATIO?", ":PAGE:MEAS:VARD:RATIO %g", """ Control the RATIO of VAR1'. For each step of sweep, the output values of VAR1' are determined by the following equation: VAR1’ = VAR1 * RATio + OFFSet You use this command only if there is an SMU or VSU whose function (FCTN) is VAR1'. .. code-block:: python instr.vard.ratio = 1 """, ) @property def compliance(self): """Control the sweep COMPLIANCE value of VARD. .. code-block:: python instr.vard.compliance = 0.1 """ value = self.ask(":PAGE:MEAS:VARD:COMP?") self.check_errors() return value @compliance.setter def compliance(self, value): validator = strict_range values = 2 * valid_compliance(self.channel_mode) set_value = validator(value, values) self.write(f":PAGE:MEAS:VARD:COMP {set_value}") self.check_errors() def valid_iv(channel_mode): if channel_mode == 'V': values = [-200, 200] elif channel_mode == 'I': values = [-1, 1] else: raise ValueError( 'Channel is not in V or I mode. It might be disabled.') return values def valid_compliance(channel_mode): if channel_mode == 'I': values = [-200, 200] elif channel_mode == 'V': values = [-1, 1] else: raise ValueError( 'Channel is not in V or I mode. It might be disabled.') return values ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent4284A.py0000644000175100017510000004133315203313266023733 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from time import sleep from pymeasure.instruments import Instrument, Channel, SCPIMixin from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) IMPEDANCE_MODES = ( "CPD", "CPQ", "CPG", "CPRP", "CSD", "CSQ", "CSRS", "LPQ", "LPD", "LPG", "LPRP", "LSD", "LSQ", "LSRS", "RX", "ZTD", "ZTR", "GB", "YTD", "YTR" ) class Agilent4284ASpot(Channel): """A class representing the spot correction functions.""" def measure_open(self): """Measure the OPEN correction standard of this spot.""" self.write(":CORR:SPOT{ch}:OPEN") def measure_short(self): """Measure the SHORT correction standard of this spot.""" self.write(":CORR:SPOT{ch}:SHOR") def measure_load(self): """Measure the LOAD correction standard of this spot.""" self.write(":CORR:SPOT{ch}:LOAD") enabled = Channel.control( ":CORR:SPOT{ch}:STAT?", ":CORR:SPOT{ch}:STAT %d", """Control this spot correction (bool).""", map_values=True, values={True: 1, False: 0} ) frequency = Channel.control( ":CORR:SPOT{ch}:FREQ?", ":CORR:SPOT{ch}:FREQ %g", """Control the frequency of this spot in Hz.""", ) load_function = Channel.control( ":CORR:SPOT{ch}:LOAD:STAN?", ":CORR:SPOT{ch}:LOAD:STAN %s", """Control the LOAD standard of this spot. :type: str, strictly in ``CPD``, ``CPQ``, ``CPG``, ``CPRP``, ``CSD``, ``CSQ``, ``CSRS``, ``LPQ``, ``LPD``, ``LPG``, ``LPRP``, ``LSD``, ``LSQ``, ``LSRS``, ``RX``, ``ZTD``, ``ZTR``, ``GB``, ``YTD``, ``YTR`` See :attr:`.Agilent4284A.impedance_mode` for detailed explanation. """, validator=strict_discrete_set, values=IMPEDANCE_MODES ) class Agilent4284ACorrection(Channel): """A class representing the correction functions.""" spot1 = Channel.ChannelCreator(Agilent4284ASpot, 1, collection="spots") spot2 = Channel.ChannelCreator(Agilent4284ASpot, 2, collection="spots") spot3 = Channel.ChannelCreator(Agilent4284ASpot, 3, collection="spots") def measure_open(self): """Measure the OPEN correction standard.""" self.write(":CORR:OPEN") def measure_short(self): """Measure the SHORT correction standard.""" self.write(":CORR:SHOR") def measure_load(self): """Measure the LOAD correction standard.""" self.write(":CORR:LOAD") open_enabled = Channel.control( ":CORR:OPEN:STAT?", ":CORR:OPEN:STAT %d", """Control the OPEN correction (bool).""", map_values=True, values={True: 1, False: 0} ) short_enabled = Channel.control( ":CORR:SHOR:STAT?", ":CORR:SHOR:STAT %d", """Control the SHORT correction (bool).""", map_values=True, values={True: 1, False: 0} ) load_enabled = Channel.control( ":CORR:LOAD:STAT?", ":CORR:LOAD:STAT %d", """Control the LOAD correction (bool).""", map_values=True, values={True: 1, False: 0} ) load_function = Channel.control( ":CORR:LOAD:TYPE?", ":CORR:LOAD:TYPE %s", """Control the spot LOAD standard. :type: str, strictly in ``CPD``, ``CPQ``, ``CPG``, ``CPRP``, ``CSD``, ``CSQ``, ``CSRS``, ``LPQ``, ``LPD``, ``LPG``, ``LPRP``, ``LSD``, ``LSQ``, ``LSRS``, ``RX``, ``ZTD``, ``ZTR``, ``GB``, ``YTD``, ``YTR`` See :attr:`.Agilent4284A.impedance_mode` for detailed explanation. """, validator=strict_discrete_set, values=IMPEDANCE_MODES ) cable_length = Channel.control( ":CORR:LENG?", ":CORR:LENG %d", """ Control the correction setting for cable length in meters, (int strictly 0, 1, 2 or 4). """, validator=strict_discrete_set, values=[0, 1, 2, 4] ) class Agilent4284A(SCPIMixin, Instrument): """Represents the Agilent 4284A precision LCR meter. .. code-block:: python agilent = Agilent4284A("GPIB::1::INSTR") agilent.reset() # Return instrument settings to default values agilent.frequency = 10e3 # Set frequency to 10 kHz agilent.voltage = 0.02 # Set AC voltage to 20 mV agilent.mode = 'ZTR' # Set impedance mode to measure impedance magnitude [Ohm] and phase [rad] agilent.sweep_measurement( 'frequency', [1e4, 1e3, 100] # Perform frequency sweep measurement ) # at 10 kHz, 1 kHz, and 100 Hz agilent.enable_high_power() # Enable upper current, voltage, and bias limits, if properly configured. agilent.correction.open_enabled = True # Enable the OPEN correction agilent.correction.spot1.enabled = True # Enable the correction for SPOT1 agilent.correction.spot1.frequency = 10e3 # Set SPOT1 frequency to 10 kHz agilent.correction.spot1.measure_open() # Measure the OPEN structure for SPOT1 """ def __init__(self, adapter, name="Agilent 4284A LCR meter", **kwargs): kwargs.setdefault("read_termination", '\n') kwargs.setdefault("write_termination", '\n') kwargs.setdefault("timeout", 10000) super().__init__(adapter, name, **kwargs) self._set_ranges(0) correction = Instrument.ChannelCreator(Agilent4284ACorrection) frequency = Instrument.control( "FREQ?", "FREQ %g", """Control AC frequency in Hertz, from 20 Hz to 1 MHz.""", validator=strict_range, values=(20, 1e6), dynamic=True ) ac_current = Instrument.control( "CURR:LEV?", "CURR:LEV %g", """Control AC current level in Amps. Valid range is 50 uA to 20 mA for default, 50 uA to 200 mA in high-power mode.""", validator=strict_range, values=(50e-6, 0.02), dynamic=True ) ac_voltage = Instrument.control( "VOLT:LEV?", "VOLT:LEV %g", """Control AC voltage level in Volts. Range is 5 mV to 2 V for default, 5 mV to 20 V in high-power mode.""", validator=strict_range, values=(0.005, 2), dynamic=True ) bias_enabled = Instrument.control( "BIAS:STAT?", "BIAS:STAT %d", """Control whether DC bias is enabled.""", validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) bias_voltage = Instrument.control( "BIAS:VOLT?", "BIAS:VOLT %g", """Control the DC bias voltage in Volts. Maximum is 2 V by default, 40 V in high-power mode.""", validator=strict_range, values=(0, 2), dynamic=True ) bias_current = Instrument.control( "BIAS:CURR?", "BIAS:CURR %g", """Control the DC bias current in Amps. Requires Option 001 (power amplifier / DC bias) to be installed. Maximum is 100 mA.""", validator=strict_range, values=(0, 0), dynamic=True ) impedance_mode = Instrument.control( "FUNC:IMP?", "FUNC:IMP %s", """Control impedance measurement function. * CPD: Parallel capacitance [F] and dissipation factor [number] * CPQ: Parallel capacitance [F] and quality factor [number] * CPG: Parallel capacitance [F] and parallel conductance [S] * CPRP: Parallel capacitance [F] and parallel resistance [Ohm] * CSD: Series capacitance [F] and dissipation factor [number] * CSQ: Series capacitance [F] and quality factor [number] * CSRS: Series capacitance [F] and series resistance [Ohm] * LPQ: Parallel inductance [H] and quality factor [number] * LPD: Parallel inductance [H] and dissipation factor [number] * LPG: Parallel inductance [H] and parallel conductance [S] * LPRP: Parallel inductance [H] and parallel resistance [Ohm] * LSD: Series inductance [H] and dissipation factor [number] * LSQ: Seriesinductance [H] and quality factor [number] * LSRS: Series inductance [H] and series resistance [Ohm] * RX: Resistance [Ohm] and reactance [Ohm] * ZTD: Impedance, magnitude [Ohm] and phase [deg] * ZTR: Impedance, magnitude [Ohm] and phase [rad] * GB: Conductance [S] and susceptance [S] * YTD: Admittance, magnitude [Ohm] and phase [deg] * YTR: Admittance magnitude [Ohm] and phase [rad] """, validator=strict_discrete_set, values=IMPEDANCE_MODES ) impedance_range = Instrument.control( "FUNC:IMP:RANG?", "FUNC:IMP:RANG %g", """Control the impedance measurement range. The 4284A will select an appropriate measurement range for the setting value.""" ) auto_range_enabled = Instrument.control( "FUNC:IMP:RANG:AUTO?", "FUNC:IMP:RANG:AUTO %d", """Control whether the impedance auto range is enabled.""", validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) trigger_source = Instrument.control( "TRIG:SOUR?", "TRIG:SOUR %s", """Control trigger mode. Valid options are `INT`, `EXT`, `BUS`, or `HOLD`.""", validator=strict_discrete_set, values=('INT', 'EXT', 'BUS', 'HOLD'), cast=str ) trigger_delay = Instrument.control( "TRIG:DEL?", "TRIG:DEL %g", """Control trigger delay in seconds. Valid range is 0 to 60, with 1 ms resolution.""", validator=strict_range, values=(0, 60) ) trigger_continuous_enabled = Instrument.control( "TRIG:CONT?", "TRIG:CONT %d", """Control whether trigger state automatically returns to WAIT FOR TRIGGER after measurement.""", validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) def _set_ranges(self, high_power_mode): """Set dynamic property values and make copies for sweep_measurement to reference.""" if high_power_mode: self.ac_current_values = (50e-6, 0.2) self.ac_voltage_values = (0.005, 20) self.bias_voltage_values = (0, 40) self.bias_current_values = (0, 0.1) self._ac_current_values = (50e-6, 0.2) self._ac_voltage_values = (0.005, 20) self._bias_voltage_values = (0, 40) self._bias_current_values = (0, 0.1) else: self.ac_current_values = (50e-6, 0.02) self.ac_voltage_values = (0.005, 2) self.bias_voltage_values = (0, 2) self.bias_current_values = (0, 0) self._ac_current_values = (50e-6, 0.02) self._ac_voltage_values = (0.005, 2) self._bias_voltage_values = (0, 2) self._bias_current_values = (0, 0) @property def high_power_enabled(self): """Control whether high power mode is enabled. Enabling requires option 001 (power amplifier / DC bias) to be installed. """ mode = self.values("OUTP:HPOW?", cast=int) return bool(mode) @high_power_enabled.setter def high_power_enabled(self, val): if not val: self._set_ranges(0) self.write("OUTP:HPOW 0") elif val and self.options[0] == '0': raise AttributeError("Agilent 4284A power amplifier is not installed.") else: self._set_ranges(1) self.write("OUTP:HPOW 1") def sweep_measurement(self, sweep_mode, sweep_values): """Run list sweep measurement using sequential trigger. :param str sweep_mode: parameter to sweep across. Must be one of `frequency`, `voltage`, `current`, `bias_voltage`, or `bias_current`. :param sweep_values: list of parameter values to sweep across. :returns: values as configured with :attr:`~.Agilent4284A.impedance_mode` and list of sweep parameters in format ([val A], [val B], [sweep_values]) """ param_dict = { "frequency": ("FREQ", (20, 1e6)), "voltage": ("VOLT", self._ac_voltage_values), "current": ("CURR", self._ac_current_values), "bias_voltage": ("BIAS:VOLT", self._bias_voltage_values), "bias_current": ("BIAS:CURR", self._bias_current_values) } if sweep_mode not in param_dict: raise KeyError( f"Sweep mode but be one of {list(param_dict.keys())}, not '{sweep_mode}'." ) low_limit = param_dict[sweep_mode][1][0] high_limit = param_dict[sweep_mode][1][1] if (min(sweep_values) < low_limit or max(sweep_values) > high_limit): log.warning( "%s values are outside valid Agilent 4284A range of %g and %g " "and will be truncated.", sweep_mode, low_limit, high_limit ) sweep_truncated = [] for val in sweep_values: if low_limit <= val <= high_limit: sweep_truncated.append(val) sweep_values = sweep_truncated loops = (len(sweep_values) - 1) // 10 # 4284A sweeps 10 points at a time param_div = [] for i in range(loops): param_div.append(sweep_values[10*i:10*(i+1)]) param_div.append(sweep_values[loops*10:]) self.clear() self.write("TRIG:SOUR BUS;:DISP:PAGE LIST;:FORM ASC;:LIST:MODE SEQ;:INIT:CONT ON") a_data = [] b_data = [] sweep_return = [] for i in range(loops + 1): param_str = ",".join(['%g' % p for p in param_div[i]]) self.write(f"LIST:{param_dict[sweep_mode][0]} {param_str};:TRIG:IMM") status_event_register = int(self.ask("STAT:OPER?")) while (status_event_register & 8) != 8: # Sweep bit no. 3 sleep(0.1) status_event_register = int(self.ask("STAT:OPER?")) measured = self.values("FETCH?") # gets 4-ples of numbers, first two are data A and B a_data += [measured[_] for _ in range(0, 4 * len(param_div[i]), 4)] b_data += [measured[_] for _ in range(1, 4 * len(param_div[i]), 4)] sweep_return += self.values(f"LIST:{param_dict[sweep_mode][0]}?") # Return to manual trigger and reset display self.write(":TRIG:SOUR HOLD;:DISP:PAGE MEAS") self.check_errors() return a_data, b_data, sweep_return def trigger(self): """Execute a bus trigger, regardless of trigger state. Can be used when :attr:`trigger_source` is set to `BUS`. Returns result of triggered measurement. """ return self.values("*TRG") def trigger_immediate(self): """Execute a bus trigger, regardless of trigger state. Can be used when :attr:`trigger_source` is set to `BUS`. Measurement result must be retrieved with `FETCH?` command. """ self.write("TRIG:IMM") def trigger_initiate(self): """Change the trigger state from IDLE to WAIT FOR TRIGGER for one trigger sequence.""" self.write("TRIG:INIT:IMM") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent4294A.py0000644000175100017510000001340115203313266023727 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.validators import strict_range, strict_discrete_set import pandas as pd import numpy as np import os # Set of valid arguments for the MEAS? command MEASUREMENT_TYPES = [ "IMPH", "IRIM", "LSR", "LSQ", "CSR", "CSQ", "CSD", "AMPH", "ARIM", "LPG", "LPQ", "CPG", "CPQ", "CPD", "COMP", "IMLS", "IMCS", "IMLP", "IMCP", "IMRS", "IMQ", "IMD", "LPR", "CPR", ] class Agilent4294A(SCPIMixin, Instrument): """ Represents the Agilent 4294A Precision Impedance Analyzer """ def __init__(self, adapter, name="Agilent 4294A Precision Impedance Analyzer", read_termination="\n", write_termination="\n", timeout=5000, **kwargs): super().__init__( adapter, name, read_termination=read_termination, write_termination=write_termination, timeout=timeout, **kwargs ) start_frequency = Instrument.control( "STAR?", "STAR %d HZ", "Control the start frequency in Hz", validator=strict_range, values=[40, 140E6] ) stop_frequency = Instrument.control( "STOP?", "STOP %d HZ", "Control the stop frequency in Hz", validator=strict_range, values=[40, 140E6] ) num_points = Instrument.control( "POIN?", "POIN %d", "Control the number of points measured at each sweep", validator=strict_discrete_set, values=range(2, 802), cast=int, ) measurement_type = Instrument.control( "MEAS?", "MEAS %d", "Control the measurement type. See MEASUREMENT_TYPES", validator=strict_discrete_set, values=MEASUREMENT_TYPES, ) active_trace = Instrument.control( "TRAC?", "TRAC %s", "Control the active trace", validator=strict_discrete_set, values=["A", "B"] ) title = Instrument.control( "TITL?", 'TITL "%s"', "Control the title of the active trace" ) def save_graphics(self, path=""): """ Save graphics on the screen to a file on the local computer. Adapted from: https://www.keysight.com/se/en/lib/software-detail/programming-examples/4294a-data-transfer-program-excel-vba-1645196.html """ self.write("STOD MEMO") # store to internal memory self.write("PRIC VARI") # save a color image root, ext = os.path.splitext(path) if ext != ".tiff": ext = ".tiff" if not root: root = "graphics" path = root + ext REMOTE_FILE = "agt4294a.tiff" # Filename of the in-memory file on the device self.write(f'SAVDTIF "{REMOTE_FILE}"') vErr = self.ask("OUTPERRO?").split(",") if not int(vErr[0]) == 0: self.write(f'PURG "{REMOTE_FILE}"') self.write(f'SAVDTIF "{REMOTE_FILE}"') vErr = self.ask("OUTPERRO?").split(",") self.write(f'ROPEN "{REMOTE_FILE}"') lngFileSize = int(self.ask(f'FSIZE? "{REMOTE_FILE}"')) MAX_BUFF_SIZE = 16384 iBufCnt = lngFileSize // MAX_BUFF_SIZE if lngFileSize % MAX_BUFF_SIZE > 0: iBufCnt += 1 with open(path, 'wb') as file: for _ in range(iBufCnt): data = self.adapter.connection.query_binary_values("READ?", datatype='B', container=bytes) file.write(data) self.write(f'PURG "{REMOTE_FILE}"') return path def get_data(self, path=None): """ Get the measurement data from the instrument after completion. :param path: Path for optional data export to CSV. :returns: Pandas Dataframe """ prev_active_trace = self.active_trace num_points = self.num_points freqs = np.array(self.ask("OUTPSWPRM?").split(","), dtype=float) self.active_trace = "A" adata = np.array(self.ask("OUTPDTRC?").split(","), dtype=float).reshape(num_points, 2) self.active_trace = "B" bdata = np.array(self.ask("OUTPDTRC?").split(","), dtype=float).reshape(num_points, 2) # restore the previous state self.active_trace = prev_active_trace df = pd.DataFrame( np.hstack((freqs.reshape(-1, 1), adata, bdata)), columns=["Frequency", "A Real", "A Imag", "B Real", "B Imag"] ) if path is not None: _, ext = os.path.splitext(path) if ext != ".csv": path = path + ".csv" df.to_csv(path, index=False) return df ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent8257D.py0000644000175100017510000003047615203313266023750 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import truncated_range, strict_discrete_set class Agilent8257D(SCPIUnknownMixin, Instrument): """Represents the Agilent 8257D Signal Generator and provides a high-level interface for interacting with the instrument. .. code-block:: python generator = Agilent8257D("GPIB::1") generator.power = 0 # Sets the output power to 0 dBm generator.frequency = 5 # Sets the output frequency to 5 GHz generator.enable() # Enables the output """ power = Instrument.control( ":POW?;", ":POW %g dBm;", """ A floating point property that represents the output power in dBm. This property can be set. """ ) frequency = Instrument.control( ":FREQ?;", ":FREQ %e Hz;", """ A floating point property that represents the output frequency in Hz. This property can be set. """ ) start_frequency = Instrument.control( ":SOUR:FREQ:STAR?", ":SOUR:FREQ:STAR %e Hz", """ A floating point property that represents the start frequency in Hz. This property can be set. """ ) center_frequency = Instrument.control( ":SOUR:FREQ:CENT?", ":SOUR:FREQ:CENT %e Hz;", """ A floating point property that represents the center frequency in Hz. This property can be set. """ ) stop_frequency = Instrument.control( ":SOUR:FREQ:STOP?", ":SOUR:FREQ:STOP %e Hz", """ A floating point property that represents the stop frequency in Hz. This property can be set. """ ) start_power = Instrument.control( ":SOUR:POW:STAR?", ":SOUR:POW:STAR %e dBm", """ A floating point property that represents the start power in dBm. This property can be set. """ ) stop_power = Instrument.control( ":SOUR:POW:STOP?", ":SOUR:POW:STOP %e dBm", """ A floating point property that represents the stop power in dBm. This property can be set. """ ) dwell_time = Instrument.control( ":SOUR:SWE:DWEL1?", ":SOUR:SWE:DWEL1 %.3f", """ A floating point property that represents the settling time in seconds at the current frequency or power setting. This property can be set. """ ) step_points = Instrument.control( ":SOUR:SWE:POIN?", ":SOUR:SWE:POIN %d", """ An integer number of points in a step sweep. This property can be set. """ ) is_enabled = Instrument.measurement( ":OUTPUT?", """ Reads a boolean value that is True if the output is on. """, cast=bool ) has_modulation = Instrument.measurement( ":OUTPUT:MOD?", """ Reads a boolean value that is True if the modulation is enabled. """, cast=bool ) ######################## # Amplitude modulation # ######################## has_amplitude_modulation = Instrument.measurement( ":SOUR:AM:STAT?", """ Reads a boolean value that is True if the amplitude modulation is enabled. """, cast=bool ) amplitude_depth = Instrument.control( ":SOUR:AM:DEPT?", ":SOUR:AM:DEPT %g", """ A floating point property that controls the amplitude modulation in percent, which can take values from 0 to 100 %. """, validator=truncated_range, values=[0, 100] ) AMPLITUDE_SOURCES = { 'internal': 'INT', 'internal 2': 'INT2', 'external': 'EXT', 'external 2': 'EXT2' } amplitude_source = Instrument.control( ":SOUR:AM:SOUR?", ":SOUR:AM:SOUR %s", """ A string property that controls the source of the amplitude modulation signal, which can take the values: 'internal', 'internal 2', 'external', and 'external 2'. """, validator=strict_discrete_set, values=AMPLITUDE_SOURCES, map_values=True ) #################### # Pulse modulation # #################### has_pulse_modulation = Instrument.measurement( ":SOUR:PULM:STAT?", """ Reads a boolean value that is True if the pulse modulation is enabled. """, cast=bool ) PULSE_SOURCES = { 'internal': 'INT', 'external': 'EXT', 'scalar': 'SCAL' } pulse_source = Instrument.control( ":SOUR:PULM:SOUR?", ":SOUR:PULM:SOUR %s", """ A string property that controls the source of the pulse modulation signal, which can take the values: 'internal', 'external', and 'scalar'. """, validator=strict_discrete_set, values=PULSE_SOURCES, map_values=True ) PULSE_INPUTS = { 'square': 'SQU', 'free-run': 'FRUN', 'triggered': 'TRIG', 'doublet': 'DOUB', 'gated': 'GATE' } pulse_input = Instrument.control( ":SOUR:PULM:SOUR:INT?", ":SOUR:PULM:SOUR:INT %s", """ A string property that controls the internally generated modulation input for the pulse modulation, which can take the values: 'square', 'free-run', 'triggered', 'doublet', and 'gated'. """, validator=strict_discrete_set, values=PULSE_INPUTS, map_values=True ) pulse_frequency = Instrument.control( ":SOUR:PULM:INT:FREQ?", ":SOUR:PULM:INT:FREQ %g", """ A floating point property that controls the pulse rate frequency in Hertz, which can take values from 0.1 Hz to 10 MHz. """, validator=truncated_range, values=[0.1, 10e6] ) ######################## # Low-Frequency Output # ######################## low_freq_out_amplitude = Instrument.control( ":SOUR:LFO:AMPL? ", ":SOUR:LFO:AMPL %g VP", """A floating point property that controls the peak voltage (amplitude) of the low frequency output in volts, which can take values from 0-3.5V""", validator=truncated_range, values=[0, 3.5] ) LOW_FREQUENCY_SOURCES = { 'internal': 'INT', 'internal 2': 'INT2', 'function': 'FUNC', 'function 2': 'FUNC2' } low_freq_out_source = Instrument.control( ":SOUR:LFO:SOUR?", ":SOUR:LFO:SOUR %s", """A string property which controls the source of the low frequency output, which can take the values 'internal [2]' for the internal source, or 'function [2]' for an internal function generator which can be configured.""", validator=strict_discrete_set, values=LOW_FREQUENCY_SOURCES, map_values=True ) def enable_low_freq_out(self): """Enables low frequency output""" self.write(":SOUR:LFO:STAT ON") def disable_low_freq_out(self): """Disables low frequency output""" self.write(":SOUR:LFO:STAT OFF") def config_low_freq_out(self, source='internal', amplitude=3): """ Configures the low-frequency output signal. :param source: The source for the low-frequency output signal. :param amplitude: Amplitude of the low-frequency output """ self.enable_low_freq_out() self.low_freq_out_source = source self.low_freq_out_amplitude = amplitude ####################### # Internal Oscillator # ####################### internal_frequency = Instrument.control( ":SOUR:AM:INT:FREQ?", ":SOUR:AM:INT:FREQ %g", """ A floating point property that controls the frequency of the internal oscillator in Hertz, which can take values from 0.5 Hz to 1 MHz. """, validator=truncated_range, values=[0.5, 1e6] ) INTERNAL_SHAPES = { 'sine': 'SINE', 'triangle': 'TRI', 'square': 'SQU', 'ramp': 'RAMP', 'noise': 'NOIS', 'dual-sine': 'DUAL', 'swept-sine': 'SWEP' } internal_shape = Instrument.control( ":SOUR:AM:INT:FUNC:SHAP?", ":SOUR:AM:INT:FUNC:SHAP %s", """ A string property that controls the shape of the internal oscillations, which can take the values: 'sine', 'triangle', 'square', 'ramp', 'noise', 'dual-sine', and 'swept-sine'. """, validator=strict_discrete_set, values=INTERNAL_SHAPES, map_values=True ) def __init__(self, adapter, name="Agilent 8257D RF Signal Generator", **kwargs): super().__init__( adapter, name, **kwargs ) def enable(self): """ Enables the output of the signal. """ self.write(":OUTPUT ON;") def disable(self): """ Disables the output of the signal. """ self.write(":OUTPUT OFF;") def enable_modulation(self): self.write(":OUTPUT:MOD ON;") self.write(":lfo:sour int; :lfo:ampl 2.0vp; :lfo:stat on;") def disable_modulation(self): """ Disables the signal modulation. """ self.write(":OUTPUT:MOD OFF;") self.write(":lfo:stat off;") def config_amplitude_modulation(self, frequency=1e3, depth=100.0, shape='sine'): """ Configures the amplitude modulation of the output signal. :param frequency: A modulation frequency for the internal oscillator :param depth: A linear depth percentage :param shape: A string that describes the shape for the internal oscillator """ self.enable_amplitude_modulation() self.amplitude_source = 'internal' self.internal_frequency = frequency self.internal_shape = shape self.amplitude_depth = depth def enable_amplitude_modulation(self): """ Enables amplitude modulation of the output signal. """ self.write(":SOUR:AM:STAT ON") def disable_amplitude_modulation(self): """ Disables amplitude modulation of the output signal. """ self.write(":SOUR:AM:STAT OFF") def config_pulse_modulation(self, frequency=1e3, input='square'): """ Configures the pulse modulation of the output signal. :param frequency: A pulse rate frequency in Hertz :param input: A string that describes the internal pulse input """ self.enable_pulse_modulation() self.pulse_source = 'internal' self.pulse_input = input self.pulse_frequency = frequency def enable_pulse_modulation(self): """ Enables pulse modulation of the output signal. """ self.write(":SOUR:PULM:STAT ON") def disable_pulse_modulation(self): """ Disables pulse modulation of the output signal. """ self.write(":SOUR:PULM:STAT OFF") def config_step_sweep(self): """ Configures a step sweep through frequency """ self.write(":SOUR:FREQ:MODE SWE;" ":SOUR:SWE:GEN STEP;" ":SOUR:SWE:MODE AUTO;") def enable_retrace(self): self.write(":SOUR:LIST:RETR 1") def disable_retrace(self): self.write(":SOUR:LIST:RETR 0") def single_sweep(self): self.write(":SOUR:TSW") def start_step_sweep(self): """ Starts a step sweep. """ self.write(":SOUR:SWE:CONT:STAT ON") def stop_step_sweep(self): """ Stops a step sweep. """ self.write(":SOUR:SWE:CONT:STAT OFF") def shutdown(self): """ Shuts down the instrument by disabling any modulation and the output signal. """ self.disable_modulation() self.disable() super().shutdown() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilent8722ES.py0000644000175100017510000002345015203313266024063 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import discreteTruncate from pymeasure.errors import RangeException from pyvisa import VisaIOError import numpy as np import re from io import BytesIO import warnings class Agilent8722ES(SCPIUnknownMixin, Instrument): """ Represents the Agilent8722ES Vector Network Analyzer and provides a high-level interface for taking scans of the scattering parameters. """ SCAN_POINT_VALUES = [3, 11, 21, 26, 51, 101, 201, 401, 801, 1601] SCATTERING_PARAMETERS = ("S11", "S12", "S21", "S22") S11, S12, S21, S22 = SCATTERING_PARAMETERS start_frequency = Instrument.control( "STAR?", "STAR %e Hz", """ A floating point property that represents the start frequency in Hz. This property can be set. """ ) stop_frequency = Instrument.control( "STOP?", "STOP %e Hz", """ A floating point property that represents the stop frequency in Hz. This property can be set. """ ) sweep_time = Instrument.control( "SWET?", "SWET%.2e", """ A floating point property that represents the sweep time in seconds. This property can be set. """ ) averages = Instrument.control( "AVERFACT?", "AVERFACT%d", """ An integer representing the number of averages to take. Note that averaging must be enabled for this to take effect. This property can be set. """, cast=lambda x: int(float(x)) # need float() to convert scientific notation in strings ) averaging_enabled = Instrument.control( "AVERO?", "AVERO%d", """ A bool that indicates whether or not averaging is enabled. This property can be set.""", cast=bool ) def __init__(self, adapter, name="Agilent 8722ES Vector Network Analyzer", **kwargs): super().__init__( adapter, name, **kwargs ) def set_fixed_frequency(self, frequency): """ Sets the scan to be of only one frequency in Hz """ self.start_frequency = frequency self.stop_frequency = frequency self.scan_points = 3 @property def parameter(self): for parameter in Agilent8722ES.SCATTERING_PARAMETERS: if int(self.values("%s?" % parameter)) == 1: return parameter return None @parameter.setter def parameter(self, value): if value in Agilent8722ES.SCATTERING_PARAMETERS: self.write("%s" % value) else: raise Exception("Invalid scattering parameter requested" " for Agilent 8722ES") @property def scan_points(self): """ Gets the number of scan points """ search = re.search(r"\d\.\d+E[+-]\d{2}$", self.ask("POIN?"), re.MULTILINE) if search: return int(float(search.group())) else: raise Exception("Improper message returned for the" " number of points") @scan_points.setter def scan_points(self, points): """ Sets the number of scan points, truncating to an allowed value if not properly provided """ points = discreteTruncate(points, Agilent8722ES.SCAN_POINT_VALUES) if points: self.write("POIN%d" % points) else: raise RangeException("Maximum scan points (1601) for" " Agilent 8722ES exceeded") def set_IF_bandwidth(self, bandwidth): """ Sets the resolution bandwidth (IF bandwidth) """ allowedBandwidth = [10, 30, 100, 300, 1000, 3000, 3700, 6000] bandwidth = discreteTruncate(bandwidth, allowedBandwidth) if bandwidth: self.write("IFBW%d" % bandwidth) else: raise RangeException("Maximum IF bandwidth (6000) for Agilent " "8722ES exceeded") def set_averaging(self, averages): """Sets the number of averages and enables/disables averaging. Should be between 1 and 999""" averages = int(averages) if not 1 <= averages <= 999: assert RangeException("Set", averages, "must be in the range 1 to 999") self.averages = averages self.averaging_enabled = (averages > 1) def disable_averaging(self): """Disables averaging""" warnings.warn( "Don't use disable_averaging(), use averaging_enabled = False instead", FutureWarning) self.averaging_enabled = False def enable_averaging(self): """Enables averaging""" warnings.warn( "Don't use enable_averaging(), use averaging_enabled = True instead", FutureWarning) self.averaging_enabled = True def is_averaging(self): """ Returns True if averaging is enabled """ warnings.warn("Don't use is_averaging(), use averaging_enabled instead", FutureWarning) return self.averaging_enabled def restart_averaging(self, averages): warnings.warn("Don't use restart_averaging(), use scan_single() instead", FutureWarning) self.scan_single() def scan(self, averages=None, blocking=None, timeout=None, delay=None): """ Initiates a scan with the number of averages specified and blocks until the operation is complete. """ if averages is not None or blocking is not None or timeout is not None or delay is not None: warnings.warn( "averages, blocking, timeout, and delay arguments are no longer used by scan()", FutureWarning ) self.write("*CLS") self.scan_single() # All queries will block until the scan is done, so use NOOP? to check. # These queries will time out after several seconds though, # so query repeatedly until the scan finishes. while True: try: self.ask("NOOP?") except VisaIOError as e: if e.abbreviation != "VI_ERROR_TMO": raise e else: break def scan_single(self): """ Initiates a single scan """ if self.averaging_enabled: self.write("NUMG%d" % self.averages) else: self.write("SING") def scan_continuous(self): """ Initiates a continuous scan """ self.write("CONT") @property def frequencies(self): """ Returns a list of frequencies from the last scan """ return np.linspace( self.start_frequency, self.stop_frequency, num=self.scan_points ) @property def data_complex(self): """ Returns the complex power from the last scan """ # TODO: Implement binary transfer instead of ASCII data = np.loadtxt( BytesIO(self.ask("FORM4;OUTPDATA").encode()), delimiter=',', dtype=np.float32 ) data_complex = data[:, 0] + 1j * data[:, 1] return data_complex @property def data_log_magnitude(self): """ Returns the absolute magnitude values in dB from the last scan """ return 20 * np.log10(self.data_magnitude) @property def data_magnitude(self): """ Returns the absolute magnitude values from the last scan """ return np.abs(self.data_complex) @property def data_phase(self): """ Returns the phase in degrees from the last scan """ return np.degrees(np.angle(self.data_complex)) @property def data(self): """ Returns the real and imaginary data from the last scan """ warnings.warn("Don't use this function, use data_complex instead", FutureWarning) data_complex = self.data_complex return data_complex.real, data_complex.complex def log_magnitude(self, real, imaginary): """ Returns the magnitude in dB from a real and imaginary number or numpy arrays """ warnings.warn("Don't use log_magnitude(), use data_log_magnitude instead", FutureWarning) return 20 * np.log10(self.magnitude(real, imaginary)) def magnitude(self, real, imaginary): """ Returns the magnitude from a real and imaginary number or numpy arrays """ warnings.warn("Don't use magnitude(), use data_magnitude", FutureWarning) return np.sqrt(real**2 + imaginary**2) def phase(self, real, imaginary): """ Returns the phase in degrees from a real and imaginary number or numpy arrays """ warnings.warn("Don't use phase(), use data_phase instead", FutureWarning) return np.arctan2(imaginary, real) * 180 / np.pi ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilentB1500.py0000644000175100017510000027211215203313266023721 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from __future__ import annotations import logging import re import time from collections import Counter, OrderedDict, namedtuple from enum import IntEnum import numpy as np import pandas as pd from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.channel import Channel from pymeasure.instruments.validators import ( strict_discrete_range, strict_discrete_set, strict_range, ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) ###################################### # Agilent B1500 Mainframe ###################################### class AgilentB1500(SCPIMixin, Instrument): """Represent the Agilent B1500 Semiconductor Parameter Analyzer and provide a high-level interface for taking different kinds of measurements. """ def __init__(self, adapter, name="Agilent B1500 Semiconductor Parameter Analyzer", **kwargs): super().__init__(adapter, name, read_termination="\r\n", write_termination="\r\n", **kwargs) self._smu_names = {} self._smu_references = {} @property def smu_references(self): """Get all SMU instances as dict_values.""" return self.smus.values() @property def smu_names(self): """Get all SMU names as dict.""" return self._smu_names def query_learn(self, query_type): """Query settings from the instrument. (``*LRN?``) :param int or str query_type: Query type (number according to manual) :rtype: dict """ return QueryLearn.query_learn(self.ask, query_type) def query_learn_header(self, query_type, **kwargs): """Query settings from the instrument. (``*LRN?``) Return dict of settings in human-readable format for debugging or file headers. For optional arguments check the underlying definition of :meth:`QueryLearn.query_learn_header`. :param int or str query_type: Query type (number according to manual) :rtype: dict """ return QueryLearn.query_learn_header(self.ask, query_type, self._smu_references, **kwargs) def query_modules(self): """Query module models from the instrument. Return dictionary of channel and module type. :return: Channel:Module Type :rtype: dict """ modules = self.ask("UNT?") modules = modules.split(";") module_names = { "B1525A": "SPGU", "B1517A": "HRSMU", "B1511A": "MPSMU", "B1511B": "MPSMU", "B1510A": "HPSMU", "B1514A": "MCSMU", "B1520A": "MFCMU", "B1530A": "WGFMU", "B1520A/N1301A": "MFCMU", } out = {} for i, module in enumerate(modules): module = module.split(",") if not module[0] == "0": try: out[i + 1] = module_names[module[0]] # i+1: channels start at 1 not at 0 except Exception: raise NotImplementedError(f"Module {module[0]} is not implemented yet!") return out def initialize_all_smus(self): """Initialize all SMUs. Query available modules and create a :class:`.SMU` instance for each. SMUs are accessible via attributes such as ``.smu1``, etc. """ modules = self.query_modules() i = 1 for channel, module_type in modules.items(): if "SMU" in module_type: self.add_child( SMU, i, collection="smus", prefix="smu", smu_type=module_type, name=f"SMU{i}", slot=channel, ) self._smu_references[channel] = self.smus[i] self._smu_names[channel] = self.smus[i].name i += 1 def initialize_all_spgus(self): """Initialize all SPGUs. Query available modules and create a :class:`.SPGU` instance for each. SPGUs are accessible via attributes such as ``.spgu1``, etc. """ modules = self.query_modules() for channel, module_type in modules.items(): if module_type == "SPGU": self.add_child(SPGU, channel, collection="spgus", prefix="spgu") def initialize_cmu(self): """Initialize CMU. Query available modules and create a :class:`.CMU` instance for the CMU. CMU is accessible via attribute ``.cmu``. """ modules = self.query_modules() for channel, module_type in modules.items(): if "CMU" in module_type: self.add_child(CMU, id=channel, collection="cmu", prefix=None) def pause(self, pause_seconds): """Pause command execution for given time in seconds. (``PA``) :param int pause_seconds: Seconds to pause """ self.write(f"PA {pause_seconds}") def abort(self): """Abort the present operation but channels may still output current/voltage. (``AB``)""" self.write("AB") def force_gnd(self): """Force 0 V on all channels immediately. Current settings can be restored with :meth:`restore_settings`. (``DZ``) """ self.write("DZ") def restore_settings(self): """Restore the settings of all channels to the state before using :meth:`force_gnd`. (``RZ``) """ self.write("RZ") io_control_mode = Instrument.control( "ERMOD?", "ERMOD %s", "Control the control mode for the digital I/O ports (:class:`ControlMode`). (``ERMOD``)", get_process=lambda v: ControlMode(v), set_process=lambda v: ControlMode(v).value, ) def set_port_connection(self, port, status): """Set the connection status for a specific port. (``ERSSP``) :param PgSelectorPort port: Port number :param PgSelectorConnectionStatus status: Connection status """ self.write(f"ERSSP {port.value}, {status.value}") def check_errors(self): """Check for errors. (``ERRX?``)""" error = self.ask("ERRX?") error = re.match( r'(?P[+-]?\d+(?:\.\d+)?),"(?P[\w\s.]+)', error ).groups() if int(error[0]) == 0: return else: raise OSError(f"Agilent B1500 Error {error[0]}: {error[1]}") def check_idle(self): """Check if instrument is idle. (``*OPC?``) Alias for :meth:`~.SCPIMixin.complete`. """ return self.complete def clear_buffer(self): """Clear output data buffer. (``BC``)""" self.write("BC") def clear_timer(self): """Clear timer count. (``TSR``)""" self.write("TSR") def send_trigger(self): """Send trigger to start measurement (except High Speed Spot). (``XE``)""" self.write("XE") @property def auto_calibration(self): """Control SMU auto-calibration every 30 minutes (bool). (``CM``)""" response = self.query_learn(31)["CM"] response = bool(int(response)) return response @auto_calibration.setter def auto_calibration(self, setting): setting = int(setting) self.write(f"CM {setting}") self.check_errors() ###################################### # Data Formatting ###################################### class _data_formatting_generic: """Format data output head of measurement value into user-readable values. :param str output_format_str: Format string of measurement value :param dict smu_names: Dictionary of channel and SMU name """ channels = { "A": 101, "B": 201, "C": 301, "D": 401, "E": 501, "F": 601, "G": 701, "H": 801, "I": 901, "J": 1001, "a": 102, "b": 202, "c": 302, "d": 402, "e": 502, "f": 602, "g": 702, "h": 802, "i": 902, "j": 1002, "V": "GNDU", "Z": "MISC", } status = { "W": "First or intermediate sweep step data", "E": "Last sweep step data", "T": "Another channel reached its compliance setting.", "C": "This channel reached its compliance setting", "V": ( "Measurement data is over the measurement range/Sweep was " "aborted by automatic stop function or power compliance. " "D will be 199.999E+99 (no meaning)." ), "X": ( "One or more channels are oscillating. Or source output did " "not settle before measurement." ), "F": "SMU is in the force saturation condition.", "G": ( "Linear/Binary search measurement: Target value was not " "found within the search range. " "Returns source output value. " "Quasi-pulsed spot measurement: " "The detection time was over the limit." ), "S": ( "Linear/Binary search measurement: The search measurement " "was stopped. Returns source output value. " "Quasi-pulsed spot measurement: Output slew rate was too " "slow to perform the settling detection. " "Or quasi-pulsed source channel reached compliance before " "the source output voltage changed 10 V " "from the start voltage." ), "U": "CMU is in the NULL loop unbalance condition.", "D": "CMU is in the IV amplifier saturation condition.", } smu_status = { 1: "A/D converter overflowed.", 2: "Oscillation of force or saturation current.", 4: "Another unit reached its compliance setting.", 8: "This unit reached its compliance setting.", 16: "Target value was not found within the search range.", 32: "Search measurement was automatically stopped.", 64: "Invalid data is returned. D is not used.", 128: "End of data", } cmu_status = { 1: "A/D converter overflowed.", 2: "CMU is in the NULL loop unbalance condition.", 4: "CMU is in the IV amplifier saturation condition.", 64: "Invalid data is returned. D is not used.", 128: "End of data", } data_names_int = {"Sampling index"} # convert to int instead of float def __init__(self, smu_names, output_format_str): """Store parameters of the chosen output format for later usage in data processing. Data Names: e.g. "Voltage (V)" or "Current Measurement (A)" """ sizes = {"FMT1": 16, "FMT11": 17, "FMT21": 19} try: self.size = sizes[output_format_str] except Exception: raise NotImplementedError( f"Data Format {output_format_str} is not implemented so far." ) self.format = output_format_str data_names_C = { "V": "Voltage (V)", "I": "Current (A)", "F": "Frequency (Hz)", } data_names_CG = { "Z": "Impedance (Ohm)", "Y": "Admittance (S)", "C": "Capacitance (F)", "L": "Inductance (H)", "R": "Phase (rad)", "P": "Phase (deg)", "D": "Dissipation factor", "Q": "Quality factor", "X": "Sampling index", "T": "Time (s)", } data_names_G = { "V": "Voltage Measurement (V)", "I": "Current Measurement (A)", "v": "Voltage Output (V)", "i": "Current Output (A)", "f": "Frequency (Hz)", "z": "invalid data", } if output_format_str in ["FMT1", "FMT5", "FMT11", "FMT15"]: self.data_names = {**data_names_C, **data_names_CG} elif output_format_str in ["FMT21", "FMT25"]: self.data_names = {**data_names_G, **data_names_CG} else: self.data_names = {} # no header self.smu_names = smu_names def check_status(self, status_string, name=None, cmu=False): """Check returned status of instrument. If not null or end of data, message is written to log.info. :param str status_string: Status string returned by the instrument when reading data. :param str name: Name of the SMU channel, defaults to None :param bool cmu: Whether or not channel is CMU, defaults to False (SMU) """ def log_failed(): log.info("Agilent B1500: check_status not possible for status %s", status_string) if name is None: name = "" else: name = f" {name}" status = re.search(r"(?P[0-9]*)(?P[ A-Z]*)", status_string) # depending on FMT, status may be a letter or up to 3 digits if len(status.group("number")) > 0: status = int(status.group("number")) if status in (0, 128): # 0: no error; 128: End of data return if cmu is True: status_dict = self.cmu_status else: status_dict = self.smu_status for index, digit in enumerate(bin(status)[2:]): # [2:] to chop off 0b if digit == "1": log.info("Agilent B1500%s: %s", name, status_dict[2**index]) elif len(status.group("letter")) > 0: status = status.group("letter") status = status.strip() # remove whitespaces if status not in ["N", "W", "E"]: try: status = self.status[status] log.info("Agilent B1500%s: %s", name, status) except KeyError: log_failed() else: log_failed() def format_channel_check_status(self, status_string, channel_string): """Return channel number for given channel letter. Check for not null status of the channel and write according message to log.info. :param str status_string: Status string returned by the instrument when reading data. :param str channel_string: Channel string returned by the instrument :return: Channel name :rtype: str """ channel = self.channels[channel_string] if isinstance(channel, int): channel = int(str(channel)[0:-2]) # subchannels not relevant for SMU/CMU try: smu_name = self.smu_names[channel] if "SMU" in smu_name: self.check_status(status_string, name=smu_name, cmu=False) if "CMU" in smu_name: self.check_status(status_string, name=smu_name, cmu=True) return smu_name except KeyError: self.check_status(status_string) return channel class _data_formatting_FMT1(_data_formatting_generic): """Data formatting for FMT1 format.""" def __init__(self, smu_names={}, output_format_string="FMT1"): super().__init__(smu_names, output_format_string) def format_single(self, element): """Format single measurement value. :param str element: Single measurement value read from the instrument :return: Status, channel, data name, value :rtype: (str, str, str, float) """ status = element[0] # one character channel = element[1] data_name = element[2] data_name = self.data_names[data_name] if data_name in self.data_names_int: value = int(float(element[3:])) else: value = float(element[3:]) channel = self.format_channel_check_status(status, channel) return (status, channel, data_name, value) class _data_formatting_FMT11(_data_formatting_FMT1): """Data formatting for FMT11 format (based on FMT1).""" def __init__(self, smu_names={}): super().__init__(smu_names, "FMT11") class _data_formatting_FMT21(_data_formatting_generic): """Data formatting for FMT21 format.""" def __init__(self, smu_names={}): super().__init__(smu_names, "FMT21") def format_single(self, element): """Format single measurement value. :param str element: Single measurement value read from the instrument :return: Status (three digits), channel, data name, value :rtype: (str, str, str, float) """ status = element[0:3] # three digits channel = element[3] data_name = element[4] data_name = self.data_names[data_name] if data_name in self.data_names_int: value = int(float(element[5:])) else: value = float(element[5:]) channel = self.format_channel_check_status(status, channel) return (status, channel, data_name, value) def _data_formatting(self, output_format_str, smu_names={}): """Return data formatting class for given data format string. :param str output_format_str: Data output format, e.g. ``FMT21`` :param dict smu_names: Dictionary of channels and SMU names, defaults to {} :return: Corresponding formatting class :rtype: class """ classes = { "FMT1": self._data_formatting_FMT1, "FMT11": self._data_formatting_FMT11, "FMT21": self._data_formatting_FMT21, } try: format_class = classes[output_format_str] except KeyError: log.error( "Data Format %s is not implemented so far. Please set appropriate Data Format.", output_format_str, ) return else: return format_class(smu_names=smu_names) def data_format(self, output_format, mode=0): """Specify data output format. Check documentation for parameters. (``FMT``) Should be called once per session to set the data format for interpreting the measurement values read from the instrument. Currently implemented are format 1, 11, and 21. :param str output_format: Output format string, e.g. ``FMT21`` :param int mode: Data output mode, defaults to 0 (only measurement data is returned) """ # restrict to implemented formats output_format = strict_discrete_set(output_format, [1, 11, 21]) # possible: [1, 2, 3, 4, 5, 11, 12, 13, 14, 15, 21, 22, 25] mode = strict_range(mode, range(0, 11)) self.write(f"FMT {output_format}, {mode}") self.check_errors() if self._smu_names == {}: print( "No SMU names available for formatting, " "instead channel numbers will be used. " "Call data_format after initializing all SMUs." ) log.info( "No SMU names available for formatting, " "instead channel numbers will be used. " "Call data_format after initializing all SMUs." ) self._data_format = self._data_formatting(f"FMT{output_format}", self._smu_names) ###################################### # Measurement Settings ###################################### @property def parallel_meas(self): """Control whether parallel measurements are enabled (bool). (``PAD``) Effective for SMUs using HSADC and measurement modes 1, 2, 10, 18. :type: bool """ response = self.query_learn(110)["PAD"] response = bool(int(response)) return response @parallel_meas.setter def parallel_meas(self, setting): setting = int(setting) self.write(f"PAD {setting}") self.check_errors() def query_meas_settings(self): """Read settings for ``TM``, ``AV``, ``CM``, ``FMT`` and ``MM`` commands (31) from the instrument. """ return self.query_learn_header(31) def query_meas_mode(self): """Read settings for ``MM`` command (part of 31) from the instrument.""" return self.query_learn_header(31, single_command="MM") def meas_mode(self, mode, *args): """Set measurement mode of channels. (``MM``) Measurements will be taken in the same order as the SMU or CMU references are passed. :param MeasMode mode: Measurement mode :param SMU args: SMU or CMU references """ mode = MeasMode.get(mode) cmd = f"MM {mode.value}" for smu in args: if isinstance(smu, (SMU, CMU)): cmd += f", {smu.id}" self.write(cmd) self.check_errors() # ADC Setup: AAD, AIT, AV, AZ def query_adc_setup(self): """Read ADC settings (55, 56) from the instrument.""" return {**self.query_learn_header(55), **self.query_learn_header(56)} def adc_setup(self, adc_type, mode, N=""): """Set up operation mode and parameters of ADC for each ADC type. (``AIT``) Defaults: - HSADC: Auto N=1, Manual N=1, PLC N=1, Time N=0.000002(s) - HRADC: Auto N=6, Manual N=3, PLC N=1 :param ADCType adc_type: ADC type :param ADCMode mode: ADC mode :param str N: additional parameter, check documentation, defaults to ``''`` """ adc_type = ADCType.get(adc_type) mode = ADCMode.get(mode) if (adc_type == ADCType["HRADC"]) and (mode == ADCMode["TIME"]): raise ValueError("Time ADC mode is not available for HRADC") command = f"AIT {adc_type.value}, {mode.value}" if not N == "": if mode == ADCMode["TIME"]: command += f", {N}" else: command += f", {N}" self.write(command) self.check_errors() def adc_averaging(self, number, mode="Auto"): """Set number of averaging samples of the HSADC. (``AV``) Defaults: N=1, Auto :param int number: Number of averages :param AutoManual mode: Mode (``'Auto','Manual'``), defaults to 'Auto' """ if number > 0: number = strict_range(number, range(1, 1024)) mode = AutoManual.get(mode).value self.write(f"AV {number}, {mode}") else: number = strict_range(number, range(-1, -101, -1)) self.write(f"AV {number}") self.check_errors() @property def adc_auto_zero(self): """Control ADC zero function (bool). (``AZ``) Halves the integration time when disabled. """ response = self.query_learn(56)["AZ"] response = bool(int(response)) return response @adc_auto_zero.setter def adc_auto_zero(self, setting): setting = int(setting) self.write(f"AZ {setting}") self.check_errors() @property def time_stamp(self): """Control Time Stamp function (bool). (``TSC``)""" response = self.query_learn(60)["TSC"] response = bool(int(response)) return response @time_stamp.setter def time_stamp(self, setting): setting = int(setting) self.write(f"TSC {setting}") self.check_errors() def query_time_stamp_setting(self): """Read time stamp settings (60) from the instrument.""" return self.query_learn_header(60) def wait_time(self, wait_type, N, offset=0): """Configure wait time. (``WAT``) :param WaitTimeType wait_type: Wait time type :param float N: Coefficient for initial wait time, default: 1 :param int offset: Offset for wait time, defaults to 0 """ wait_type = WaitTimeType.get(wait_type).value self.write(f"WAT {wait_type}, {N}, {offset}") self.check_errors() ###################################### # Sweep Setup ###################################### def query_staircase_sweep_settings(self): """Read Staircase Sweep Measurement settings (33) from the instrument.""" return self.query_learn_header(33) def sweep_timing( self, hold, delay, step_delay=0, step_trigger_delay=0, measurement_trigger_delay=0 ): """Set timing parameters for staircase or multi channel sweep. (``WT``) :param float hold: Hold time :param float delay: Delay time :param float step_delay: Step delay time, defaults to 0 :param float step_trigger_delay: Trigger delay time, defaults to 0 :param float measurement_trigger_delay: Measurement trigger delay time, defaults to 0 """ hold = strict_discrete_range(hold, (0, 655.35), 0.01) delay = strict_discrete_range(delay, (0, 65.535), 0.0001) step_delay = strict_discrete_range(step_delay, (0, 1), 0.0001) step_trigger_delay = strict_discrete_range(step_trigger_delay, (0, delay), 0.0001) measurement_trigger_delay = strict_discrete_range( measurement_trigger_delay, (0, 65.535), 0.0001 ) self.write( "WT %g, %g, %g, %g, %g" % (hold, delay, step_delay, step_trigger_delay, measurement_trigger_delay) ) self.check_errors() def sweep_auto_abort(self, abort, post="START"): """Enable/Disable the automatic abort function. (``WM``) Also set the post measurement condition. :param bool abort: Enable/Disable automatic abort :param StaircaseSweepPostOutput post: Output after measurement, defaults to 'Start' """ abort_values = {True: 2, False: 1} abort = strict_discrete_set(abort, abort_values) abort = abort_values[abort] post = StaircaseSweepPostOutput.get(post) self.write(f"WM {abort}, {post.value}") self.check_errors() ###################################### # Sampling Setup ###################################### def query_sampling_settings(self): """Read sampling measurement settings (47) from the instrument.""" return self.query_learn_header(47) @property def sampling_mode(self): """Control sampling mode, linear or logarithmic. (``ML``) :type: :class:`.SamplingMode` """ response = self.query_learn(47) response = response["ML"] return SamplingMode(response) @sampling_mode.setter def sampling_mode(self, mode): mode = SamplingMode.get(mode).value self.write(f"ML {mode}") self.check_errors() def sampling_timing(self, hold_bias, interval, number, hold_base=0): """Set timing parameters for the sampling measurement. (``MT``) :param float hold_bias: Bias hold time :param float interval: Sampling interval :param int number: Number of Samples :param float hold_base: Base hold time, defaults to 0 """ n_channels = self.query_meas_settings()["Measurement Channels"] n_channels = len(n_channels.split(", ")) if interval >= 0.002: hold_bias = strict_discrete_range(hold_bias, (0, 655.35), 0.01) interval = strict_discrete_range(interval, (0, 65.535), 0.001) else: try: hold_bias = strict_discrete_range(hold_bias, (-0.09, -0.0001), 0.0001) except ValueError as error1: try: hold_bias = strict_discrete_range(hold_bias, (0, 655.35), 0.01) except ValueError as error2: raise ValueError( "Bias hold time does not match either " + "of the two possible specifications: " + f"{error1} {error2}" ) if interval >= 0.0001 + 0.00002 * (n_channels - 1): interval = strict_discrete_range(interval, (0, 0.00199), 0.00001) else: raise ValueError(f"Sampling interval {interval} is too short.") number = strict_discrete_range(number, (0, int(100001 / n_channels)), 1) # ToDo: different restrictions apply for logarithmic sampling! hold_base = strict_discrete_range(hold_base, (0, 655.35), 0.01) self.write(f"MT {hold_bias}, {interval}, {number}, {hold_base}") self.check_errors() def sampling_auto_abort(self, abort, post="Bias"): """Enable/Disable the automatic abort function. (``MSC``) Also set the post measurement condition. :param bool abort: Enable/Disable automatic abort :param SamplingPostOutput post: Output after measurement, defaults to 'Bias' """ abort_values = {True: 2, False: 1} abort = strict_discrete_set(abort, abort_values) abort = abort_values[abort] post = SamplingPostOutput.get(post).value self.write(f"MSC {abort}, {post}") self.check_errors() ###################################### # Read out of data ###################################### def read_data(self, number_of_points): """Read all data from buffer and return Pandas DataFrame. Specify number of measurement points for correct splitting of the data list. :param int number_of_points: Number of measurement points :return: Measurement Data :rtype: pd.DataFrame """ data = self.read() data = data.split(",") data = np.array(data) data = np.split(data, number_of_points) data = pd.DataFrame(data=data) data = data.applymap(self._data_format.format_single) heads = data.iloc[[0]].applymap(lambda x: " ".join(x[1:3])) # channel & data_type heads = heads.to_numpy().tolist() # 2D List heads = heads[0] # first row data = data.applymap(lambda x: x[3]) data.columns = heads return data def read_channels(self, nchannels): """Read data for 1 measurement point from the buffer for the specified number of channels. :param int nchannels: Number of channels which return data (includes measurement channels and sweep sources, depending on data output settings) :return: Measurement data :rtype: tuple """ data = self.read_bytes(self._data_format.size * nchannels) data = data.decode("ASCII") data = data.rstrip("\r,") # ',' if more data in buffer, '\r' if last data point data = data.split(",") data = map(self._data_format.format_single, data) data = tuple(data) return data ###################################### # Queries on all SMUs ###################################### def query_series_resistor(self): """Read series resistor status (53) for all SMUs.""" return self.query_learn_header(53) def query_meas_range_current_auto(self): """Read auto ranging mode status (54) for all SMUs.""" return self.query_learn_header(54) def query_meas_op_mode(self): """Read SMU measurement operation mode (46) for all SMUs.""" return self.query_learn_header(46) def query_meas_ranges(self): """Read measurement ranging status (32) for all SMUs.""" return self.query_learn_header(32) ###################################### # SMU Setup ###################################### class SMU(Channel): """Provide specific methods for the SMUs of the Agilent B1500 mainframe. :param AgilentB1500 parent: Instance of the B1500 mainframe class :param int index: Index of the SMU :param str smu_type: Type of the SMU :param str name: Name of the SMU :param int slot: Slot number of the SMU """ def __init__(self, parent, index, smu_type, name, slot, **kwargs): slot = strict_discrete_set(slot, range(1, 11)) smu_type = strict_discrete_set( smu_type, [ "HRSMU", "MPSMU", "HPSMU", "MCSMU", "HCSMU", "DHCSMU", "HVSMU", "UHCU", "HVMCU", "UHVU", ], ) super().__init__(parent, slot, **kwargs) self.channel = slot self.voltage_ranging = SMUVoltageRanging(smu_type) self.current_ranging = SMUCurrentRanging(smu_type) self.name = name self.type = smu_type ########################################## # Wrappers of B1500 communication methods ########################################## def query_learn(self, query_type, command): """Wrap :meth:`~.AgilentB1500.query_learn` method of B1500.""" response = self.parent.query_learn(query_type) # query_learn returns settings of all smus # pick setting for this smu only response = response[command + str(self.id)] return response def check_errors(self): """Wrap :meth:`~.AgilentB1500.check_errors` method of B1500.""" return self.parent.check_errors() ########################################## def _query_status_raw(self): return self.parent.query_learn(str(self.id)) @property def status(self): """Get status of the SMU.""" return self.parent.query_learn_header(str(self.id)) def enable(self): """Enable source/measurement channel. (``CN``)""" self.write("CN {ch}") def disable(self): """Disable source/measurement channel. (``CL``)""" self.write("CL {ch}") def force_gnd(self): """Force output to 0 V immediately. (``DZ``) Current settings can be restored with :meth:`restore_settings`. """ self.write("DZ {ch}") def restore_settings(self): """Restore the settings of the channel to the state before using :meth:`force_gnd`. (``RZ``) """ self.write("RZ {ch}") @property def filter(self): """Control SMU filter enable/disable state (bool). (``FL``)""" # different than other SMU specific settings (grouped by setting) # read via raw command response = self.parent.query_learn(30) if "FL" in response.keys(): # only present if filters of all channels are off return False else: if str(self.id) in response["FL0"]: return False elif str(self.id) in response["FL1"]: return True else: raise NotImplementedError("Filter Value cannot be read!") @filter.setter def filter(self, setting): setting = strict_discrete_set(int(setting), (0, 1)) self.write(f"FL {setting}, {{ch}}") self.check_errors() @property def series_resistor(self): """Control 1 MOhm series resistor enable/disable state (bool). (``SSR``)""" response = self.query_learn(53, "SSR") response = bool(int(response)) return response @series_resistor.setter def series_resistor(self, setting): setting = strict_discrete_set(int(setting), (0, 1)) self.write(f"SSR {{ch}}, {setting}") self.check_errors() @property def meas_op_mode(self): """Control SMU measurement operation mode. (``CMM``) :type: :class:`.MeasOpMode` """ response = self.query_learn(46, "CMM") response = int(response) return MeasOpMode(response) @meas_op_mode.setter def meas_op_mode(self, op_mode): op_mode = MeasOpMode.get(op_mode) self.write(f"CMM {{ch}}, {op_mode.value}") self.check_errors() @property def adc_type(self): """Control ADC type of individual measurement channel. (``AAD``) :type: :class:`.ADCType` """ response = self.query_learn(55, "AAD") response = int(response) return ADCType(response) @adc_type.setter def adc_type(self, adc_type): adc_type = ADCType.get(adc_type) self.write(f"AAD {{ch}}, {adc_type.value}") self.check_errors() ###################################### # Force Constant Output ###################################### def force(self, source_type, source_range, output, comp="", comp_polarity="", comp_range=""): """Apply DC current or voltage from SMU immediately. (``DI``, ``DV``) :param str source_type: Source type (``'Voltage','Current'``) :param int or str source_range: Output range index or name :param float output: Source output value in A or V :param float comp: Compliance value, defaults to previous setting :param CompliancePolarity comp_polarity: Compliance polarity, defaults to auto :param int or str comp_range: Compliance ranging type, defaults to auto """ if source_type.upper() == "VOLTAGE": cmd = "DV" source_range = self.voltage_ranging.output(source_range).index if not comp_range == "": comp_range = self.current_ranging.meas(comp_range).index elif source_type.upper() == "CURRENT": cmd = "DI" source_range = self.current_ranging.output(source_range).index if not comp_range == "": comp_range = self.voltage_ranging.meas(comp_range).index else: raise ValueError("Source Type must be Current or Voltage.") cmd += f" {{ch}}, {source_range}, {output}" if not comp == "": cmd += f", {comp}" if not comp_polarity == "": comp_polarity = CompliancePolarity.get(comp_polarity).value cmd += f", {comp_polarity}" if not comp_range == "": cmd += f", {comp_range}" self.write(cmd) self.check_errors() def ramp_source( self, source_type, source_range, target_output, comp="", comp_polarity="", comp_range="", stepsize=0.001, pause=20e-3, ): """Ramp to a target output from the set value with a given step size. Each step is separated by a pause duration. :param str source_type: Source type (``'Voltage'`` or ``'Current'``) :param int or str source_range: Output range index or name :param float target_output: Target output voltage or current :param float comp: Compliance, defaults to previous setting :param CompliancePolarity comp_polarity: Compliance polarity, defaults to auto :param int or str comp_range: Compliance ranging type, defaults to auto :param float stepsize: Maximum size of steps :param float pause: Duration in seconds to wait between steps """ if source_type.upper() == "VOLTAGE": source_type = "VOLTAGE" cmd = f"DI{self.id}" source_range = self.voltage_ranging.output(source_range).index unit = "V" if not comp_range == "": comp_range = self.current_ranging.meas(comp_range).index elif source_type.upper() == "CURRENT": source_type = "CURRENT" cmd = f"DI{self.id}" source_range = self.current_ranging.output(source_range).index unit = "A" if not comp_range == "": comp_range = self.voltage_ranging.meas(comp_range).index else: raise ValueError("Source Type must be Current or Voltage.") status = self._query_status_raw() if "CL" in status: # SMU is OFF start = 0 elif cmd in status: start = float(status[cmd][1]) # current output value else: log.info("%s in different state. Changing to %s Source.", self.name, source_type) start = 0 # calculate number of points based on maximum stepsize nop = np.ceil(abs((target_output - start) / stepsize)) nop = int(nop) log.info( "%s ramping from %g%s to %g%s in %d steps", self.name, start, unit, target_output, unit, nop, ) outputs = np.linspace(start, target_output, nop, endpoint=False) for output in outputs: # loop is only executed if target_output != start self.force(source_type, source_range, output, comp, comp_polarity, comp_range) time.sleep(pause) # call force even if start==target_output # to set compliance self.force(source_type, source_range, target_output, comp, comp_polarity, comp_range) ###################################### # Measurement Range # implemented: RI, RV # not implemented: RC, TI, TTI, TV, TTV, TIV, TTIV, TC, TTC ###################################### @property def meas_range_current(self): """Control current measurement range index. (``RI``) Possible settings depend on SMU type, e.g. ``0`` for Auto Ranging: :class:`.SMUCurrentRanging` """ response = self.query_learn(32, "RI") response = self.current_ranging.meas(response) return response @meas_range_current.setter def meas_range_current(self, meas_range): meas_range_index = self.current_ranging.meas(meas_range).index self.write(f"RI {{ch}}, {meas_range_index}") self.check_errors() @property def meas_range_voltage(self): """Control voltage measurement range index. (``RV``) Possible settings depend on SMU type, e.g. ``0`` for Auto Ranging: :class:`.SMUVoltageRanging` """ response = self.query_learn(32, "RV") response = self.voltage_ranging.meas(response) return response @meas_range_voltage.setter def meas_range_voltage(self, meas_range): meas_range_index = self.voltage_ranging.meas(meas_range).index self.write(f"RV {{ch}}, {meas_range_index}") self.check_errors() def meas_range_current_auto(self, mode, rate=50): """Specify the auto range operation. Check Documentation. (``RM``) :param int mode: Range changing operation mode :param int rate: Parameter used to calculate the *current* value, defaults to 50 """ mode = strict_range(mode, range(1, 4)) if mode == 1: self.write(f"RM {{ch}}, {mode}") else: self.write(f"RM {{ch}}, {mode}, {rate}") ###################################### # Staircase Sweep Measurement: (WT, WM -> Instrument) # implemented: # WV, WI, # WSI, WSV (synchronous output) # not implemented: BSSI, BSSV, LSSI, LSSV ###################################### def staircase_sweep_source( self, source_type, mode, source_range, start, stop, steps, comp, Pcomp="" ): """Specify staircase sweep source parameters. (``WV`` or ``WI``) :param str source_type: Source type (``'Voltage', 'Current'``) :param SweepMode mode: Sweep mode :param int source_range: Source range index :param float start: Sweep start value :param float stop: Sweep stop value :param int steps: Number of sweep steps :param float comp: Compliance value :param float Pcomp: Power compliance, defaults to not set """ if source_type.upper() == "VOLTAGE": cmd = "WV" source_range = self.voltage_ranging.output(source_range).index elif source_type.upper() == "CURRENT": cmd = "WI" source_range = self.current_ranging.output(source_range).index else: raise ValueError("Source Type must be Current or Voltage.") mode = SweepMode.get(mode).value if mode in [2, 4]: if start >= 0 and stop >= 0: pass elif start <= 0 and stop <= 0: pass else: raise ValueError("For Log Sweep Start and Stop Values must have the same polarity.") steps = strict_range(steps, range(1, 10002)) # check on comp value not yet implemented cmd += f"{{ch}}, {mode}, {source_range}, {start}, {stop}, {steps}, {comp}" if not Pcomp == "": cmd += f", {Pcomp}" self.write(cmd) self.check_errors() # Synchronous Output: WSI, WSV, BSSI, BSSV, LSSI, LSSV def synchronous_sweep_source(self, source_type, source_range, start, stop, comp, Pcomp=""): """Specify synchronous staircase sweep source (current or voltage) and its parameters. (``WSV`` or ``WSI``) :param str source_type: Source type (``'Voltage','Current'``) :param int source_range: Source range index :param float start: Sweep start value :param float stop: Sweep stop value :param float comp: Compliance value :param float Pcomp: Power compliance, defaults to not set """ if source_type.upper() == "VOLTAGE": cmd = "WSV" source_range = self.voltage_ranging.output(source_range).index elif source_type.upper() == "CURRENT": cmd = "WSI" source_range = self.current_ranging.output(source_range).index else: raise ValueError("Source Type must be Current or Voltage.") # check on comp value not yet implemented cmd += f"{{ch}}, {source_range}, {start}, {stop}, {comp}" if not Pcomp == "": cmd += f", {Pcomp}" self.write(cmd) self.check_errors() ###################################### # Sampling Measurements: (ML, MT -> Instrument) # implemented: MV, MI # not implemented: MSP, MCC, MSC ###################################### def sampling_source(self, source_type, source_range, base, bias, comp): """Set DC source (current or voltage) for sampling measurement. (``MV`` or ``MI``) :meth:`force` commands on the same channel overwrite this setting. :param str source_type: Source type (``'Voltage','Current'``) :param int source_range: Source range index :param float base: Base voltage/current :param float bias: Bias voltage/current :param float comp: Compliance value """ if source_type.upper() == "VOLTAGE": cmd = "MV" source_range = self.voltage_ranging.output(source_range).index elif source_type.upper() == "CURRENT": cmd = "MI" source_range = self.current_ranging.output(source_range).index else: raise ValueError("Source Type must be Current or Voltage.") # check on comp value not yet implemented cmd += f"{{ch}}, {source_range}, {base}, {bias}, {comp}" self.write(cmd) self.check_errors() def set_cv_parameters( self, mode: SweepMode, start: float, stop: float, steps: int, comp: float | None = None ) -> None: """Set the mode and sweep parameters for :attr:`MeasMode.CV_SWEEP` measurement. (``WDCV``) :param mode: Sweep mode :param start: Sweep start voltage in V :param stop: Sweep stop voltage in V :param steps: Number of steps for staircase sweep :param comp: Compliance current in A. The previous value is used if not set. """ cmd = _set_cv_parameters_base(self.id, mode, start, stop, steps, comp) self.write(cmd) ############################################################################### # Additional Classes / Constants ############################################################################### class Ranging: """Possible Settings for SMU current/voltage output/measurement ranges. Transformation of available voltage/current range names to index and back. :param list supported_ranges: Ranges which are supported (list of range indices) :param dict ranges: All range names ``{Name: Indices}`` :param bool fixed_ranges: Add fixed ranges (negative indices), defaults to False .. automethod:: __call__ """ _Range = namedtuple("Range", "name index") def __init__(self, supported_ranges, ranges, fixed_ranges=False): if fixed_ranges: # add negative indizes for measurement ranges (fixed ranging) supported_ranges += [-i for i in supported_ranges] # remove duplicates (0) supported_ranges = list(dict.fromkeys(supported_ranges)) # create dictionary {Index: Range Name} # distinguish between limited and fixed ranging # omitting 'limited auto ranging'/'range fixed' # defaults to 'limited auto ranging' inverse_ranges = {0: "Auto Ranging"} for key, value in ranges.items(): if isinstance(value, tuple): for v in value: inverse_ranges[v] = (key + " limited auto ranging", key) inverse_ranges[-v] = key + " range fixed" else: inverse_ranges[value] = (key + " limited auto ranging", key) inverse_ranges[-value] = key + " range fixed" ranges = {} indizes = {} # only take ranges supported by SMU for i in supported_ranges: name = inverse_ranges[i] # check if multiple names exist for index i if isinstance(name, tuple): ranges[i] = name[0] # first entry is main name (unique) and # returned as .name attribute, # additional entries are just synonyms and can # be used to get the range tuple # e.g. '1 nA limited auto ranging' is identifier and # returned as range name # but '1 nA' also works to get the range tuple for name2 in name: indizes[name2] = i else: # only one name per index ranges[i] = name # Index -> Name, Name not unique indizes[name] = i # Name -> Index, only one Index per Name # convert all string type keys to uppercase, to avoid case-sensitivity indizes = {key.upper(): value for key, value in indizes.items()} self.indizes = indizes # Name -> Index self.ranges = ranges # Index -> Name def __call__(self, input_value): """Give named tuple (name/index) of given Range. Throws error if range is not supported by this SMU. :param str or int input_value: Range name or index :return: Named tuple (name/index) of range :rtype: namedtuple """ # set index if isinstance(input_value, int): index = input_value else: try: index = self.indizes[input_value.upper()] except Exception: raise ValueError( f"Specified Range Name {input_value.upper()} is not valid or not supported by" f" this SMU" ) # get name try: name = self.ranges[index] except Exception: raise ValueError(f"Specified Range {index} is not supported by this SMU") return self._Range(name=name, index=index) class SMUVoltageRanging: """Provide Range Name/Index transformation for voltage measurement/sourcing. Validity of ranges is checked against the type of the SMU. Omitting the 'limited auto ranging'/'range fixed' specification in the range string for voltage measurement defaults to 'limited auto ranging'. Full specification: ``'2 V range fixed'`` or ``'2 V limited auto ranging'`` ``'2 V'`` defaults to ``'2 V limited auto ranging'`` """ def __init__(self, smu_type): supported_ranges = { "HRSMU": [0, 5, 11, 20, 50, 12, 200, 13, 400, 14, 1000], "MPSMU": [0, 5, 11, 20, 50, 12, 200, 13, 400, 14, 1000], "HPSMU": [0, 11, 20, 12, 200, 13, 400, 14, 1000, 15, 2000], "MCSMU": [0, 2, 11, 20, 12, 200, 13, 400], "HCSMU": [0, 2, 11, 20, 12, 200, 13, 400], "DHCSMU": [0, 2, 11, 20, 12, 200, 13, 400], "HVSMU": [0, 15, 2000, 5000, 15000, 30000], "UHCU": [0, 14, 1000], "HVMCU": [0, 15000, 30000], "UHVU": [0, 103], } supported_ranges = supported_ranges[smu_type] ranges = { "0.2 V": 2, "0.5 V": 5, "2 V": (11, 20), "5 V": 50, "20 V": (12, 200), "40 V": (13, 400), "100 V": (14, 1000), "200 V": (15, 2000), "500 V": 5000, "1500 V": 15000, "3000 V": 30000, "10 kV": 103, } # set range attributes self.output = Ranging(supported_ranges, ranges) self.meas = Ranging(supported_ranges, ranges, fixed_ranges=True) class SMUCurrentRanging: """Provide Range Name/Index transformation for current measurement/sourcing. Validity of ranges is checked against the type of the SMU. Omitting the 'limited auto ranging'/'range fixed' specification in the range string for current measurement defaults to 'limited auto ranging'. Full specification: ``'1 nA range fixed'`` or ``'1 nA limited auto ranging'`` ``'1 nA'`` defaults to ``'1 nA limited auto ranging'`` """ def __init__(self, smu_type): supported_output_ranges = { # in combination with ASU also 8 "HRSMU": [0, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19], # in combination with ASU also 8,9,10 "MPSMU": [0, 11, 12, 13, 14, 15, 16, 17, 18, 19], "HPSMU": [0, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], "MCSMU": [0, 15, 16, 17, 18, 19, 20], "HCSMU": [0, 15, 16, 17, 18, 19, 20, 22], "DHCSMU": [0, 15, 16, 17, 18, 19, 20, 21, 23], "HVSMU": [0, 11, 12, 13, 14, 15, 16, 17, 18], "UHCU": [0, 26, 28], "HVMCU": [], "UHVU": [], } supported_meas_ranges = { **supported_output_ranges, # overwrite output ranges: "HVMCU": [0, 19, 21], "UHVU": [0, 15, 16, 17, 18, 19], } supported_output_ranges = supported_output_ranges[smu_type] supported_meas_ranges = supported_meas_ranges[smu_type] ranges = { "1 pA": 8, # for ASU "10 pA": 9, "100 pA": 10, "1 nA": 11, "10 nA": 12, "100 nA": 13, "1 uA": 14, "10 uA": 15, "100 uA": 16, "1 mA": 17, "10 mA": 18, "100 mA": 19, "1 A": 20, "2 A": 21, "20 A": 22, "40 A": 23, "500 A": 26, "2000 A": 28, } # set range attributes self.output = Ranging(supported_output_ranges, ranges) self.meas = Ranging(supported_meas_ranges, ranges, fixed_ranges=True) ###################################### # SPGU Setup ###################################### class SPGU(Channel): """Provide specific methods for the SPGU module of the Agilent B1500 mainframe. :param AgilentB1500 parent: Instance of the B1500 mainframe class :param int channel: Channel number of the SPGU """ def __init__(self, parent, channel, **kwargs): super().__init__(parent, channel, **kwargs) self.ch1 = self.add_child(SPGUChannel, int(f"{self.id}01"), prefix="ch") self.ch2 = self.add_child(SPGUChannel, int(f"{self.id}02"), prefix="ch") output = Channel.setting( "%s", """Set SPGU output state. (``SRP``, ``SPP``) When enabled, starts SPGU output. When disabled, stops output and channels output base voltage.""", validator=strict_discrete_set, values={False: "SPP", True: "SRP"}, map_values=True, ) operation_mode = Channel.control( "SIM?", "SIM %d", """Control mode for the Semiconductor Pulse Generator Unit (SPGU). (``SIM``) The setting is effective for the all SPGU modules installed in the B1500. This command also triggers 0 V output of the SPGU channels which output switch has been ON.""", get_process=lambda v: SPGUOperationMode(v), set_process=lambda v: SPGUOperationMode(v).value, ) period = Channel.control( "SPPER?", "SPPER %f", """Control the pulse period for SPGU channels (``SPPER``) in seconds (float). Applies to all installed SPGU modules.""", validator=strict_range, values=[2e-8, 10], ) def set_output_mode(self, mode, condition=None): """Set the operating mode for SPGU channel outputs. (``SPRM``) This setting applies to all SPGU modules installed in the B1500. :param SPGUOperationMode mode: SPGU operation mode :param int or float or None condition: Number of pulses for :attr:`SPGUOutputMode.COUNT` or output duration for :attr:`SPGUOutputMode.DURATION`. Not used for :attr:`SPGUOutputMode.FREE_RUN` """ mode = SPGUOutputMode.get(mode) if mode == SPGUOutputMode.FREE_RUN: self.write(f"SPRM {mode.value}") return if condition is None: raise ValueError(f"Condition must be specified when mode is {mode}") if mode == SPGUOutputMode.COUNT: if not (1 <= condition <= 1_000_000): raise ValueError("Condition must be between 1 and 1,000,000 when mode is COUNT.") elif mode == SPGUOutputMode.DURATION: if not (1e-6 <= condition <= 31_556_926): raise ValueError( "Condition must be between 0.000001 and 31,556,926 seconds (1 year) " "when mode is DURATION." ) self.write(f"SPRM {mode.value}, {int(condition)}") def get_output_mode(self): """Get the current operating mode and condition for SPGU channel outputs. (``SPRM?``) :return: Tuple of (mode, condition) :rtype: tuple """ response = self.ask("SPRM?") mode, condition = response.split(",") return SPGUOutputMode(int(mode)), float(condition) if condition else None complete = Channel.measurement( "SPST?", """Get whether the SPGU output has finished. (``SPST?``)""", get_process=lambda v: not bool(v), ) class SPGUChannel(Channel): """SPGU Channel of the Agilent B1500 mainframe.""" enabled = Channel.setting( "%s {ch}", """Control SPGU channel enable/disable state. (``CN``, ``CL``)""", validator=strict_discrete_set, values={False: "CL", True: "CN"}, map_values=True, ) load_impedance = Channel.control( "SER? {ch}", "SER {ch}, %f", """Control the load impedance (``SER``) in Ohm (float).""", ) def set_output_voltage(self, source=1, base_voltage=0, peak_voltage=0): """Set the output voltage of the SPGU channel. (``SPV``) :param SPGUSignalSource or int source: Signal source for the output voltage, defaults to :attr:`SPGUSignalSource.PULSE_SIGNAL_1` :param float base_voltage: Pulse base voltage or DC output voltage in V, defaults to 0 :param float peak_voltage: Pulse peak voltage in V, defaults to 0 """ source = SPGUSignalSource.get(source).value base_voltage = strict_range(base_voltage, (-40, 40)) peak_voltage = strict_range(peak_voltage, (-40, 40)) self.write(f"SPV {{ch}}, {source}, {base_voltage}, {peak_voltage}") def get_output_voltage(self, source=1): """Get the output voltage of the specified signal source. (``SPV?``) :param SPGUSignalSource or int source: Signal source :return: Tuple of (base_voltage, peak_voltage) :rtype: tuple """ source = SPGUSignalSource.get(source).value response = self.ask(f"SPV? {{ch}}, {source}") base_voltage, peak_voltage = map(float, response.split(",")) return base_voltage, peak_voltage output_mode = Channel.control( "SPM? {ch}", "SPM {ch}, %d", """Control the output mode of the SPGU channel. (``SPM``) The SPGU operating mode must be set to PG with the SIM 0 command before setting the output mode.""", get_process=lambda v: SPGUChannelOutputMode(int(v)), set_process=lambda v: SPGUChannelOutputMode.get(v).value, ) def set_pulse_timings( self, source=1, delay=0, width=1e-7, rise_time=2e-8, fall_time=None, ): """Set the timing parameters for the SPGU channel. (``SPT``) The SPGU operating mode must be set to PG with the ``SIM 0`` command before setting the pulse timings. :param SPGUSignalSource or int source: Signal source for the pulse timings, defaults to :attr:`SPGUSignalSource.PULSE_SIGNAL_1` :param float delay: Pulse delay in seconds, defaults to 0 :param float width: Pulse width in seconds, defaults to 1e-7 :param float rise_time: Pulse rise time in seconds, defaults to 2e-8 :param float fall_time: Pulse fall time in seconds, defaults to rise_time if None """ source = SPGUSignalSource.get(source) if source == SPGUSignalSource.DC: raise ValueError("Pulse timings can only be set for pulse sources.") command = f"SPT {{ch}}, {source.value}, {delay}, {width}, {rise_time}" if fall_time is not None: command += f", {fall_time}" self.write(command) def get_pulse_timings(self, source=1): """Get the timing parameters for the SPGU channel. (``SPT?``) The SPGU operating mode must be set to PG with the ``SIM 0`` command before getting the pulse timings. :param SPGUSignalSource or int source: Signal source for the pulse timings, defaults to :attr:`SPGUSignalSource.PULSE_SIGNAL_1` :return: Tuple of (delay, width, rise_time, fall_time) :rtype: tuple """ source = SPGUSignalSource.get(source).value response = self.ask(f"SPT? {{ch}}, {source}") return tuple(map(float, response.split(","))) def apply_setup(self): """Apply the current setup to the SPGU channel. (``SPUPD``) Depends on the :attr:`SPGU.operation_mode` (``SIM``): * PG mode: output base voltage set by ``SPV`` command * ALWG mode: output initial value of waveform """ self.write("SPUPD {ch}") class CMU(Channel): """Provide specific methods for the CMU of the Agilent B1500 mainframe. :param parent: Instance of the B1500 mainframe class :param slot: Slot number of the CMU """ def __init__(self, parent: AgilentB1500, slot: int, **kwargs): slot = strict_discrete_set(slot, range(1, 11)) super().__init__(parent, slot, **kwargs) enabled = Channel.setting( "%s {ch}", """Control CMU enable/disable state. (``CN``, ``CL``)""", validator=strict_discrete_set, values={False: "CL", True: "CN"}, map_values=True, ) voltage_ac = Channel.setting( "ACV {ch}, %f", """Set AC voltage amplitude in V. (``ACV``)""", validator=strict_range, values=[0.0, 0.25], ) frequency_ac = Channel.setting( "FC {ch}, %f", """Set AC voltage frequency in Hz. (``FC``)""", validator=strict_range, values=[1e3, 5e6], ) def set_measurement_mode(self, measurement_mode: MFCMUMeasurementMode) -> None: """Set the impedance measurement mode for the MFCMU. (``IMP``) The MFCMU measures two parameters per mode. Defaults to :attr:`MFCMUMeasurementMode.CP_G`. .. note:: This command is not effective for binary data output formats (FMT3, FMT4, FMT13, FMT14). :param measurement_mode: Measurement mode. """ if hasattr(self.parent, "_data_format") and self.parent._data_format.format in [ "FMT3", "FMT4", "FMT13", "FMT14", ]: log.warning( "The IMP command is not effective for binary data output format " f"{self.parent._data_format.format}." ) self.write(f"IMP {measurement_mode.value}") def set_cv_timings( self, hold_time: float, delay_time: float, step_delay_time: float = 0.0, step_source_trigger_delay_time: float = 0.0, ) -> None: """Set the timing parameters for :attr:`MeasMode.CV_SWEEP` measurement. (``WTDCV``) :param hold_time: Wait time (in seconds) after starting measurement and before starting delay time for the first step. :param delay_time: Wait time (in seconds) after starting to force a step output and before starting a step measurement. :param step_delay_time: Wait time (in seconds) after starting a step measurement and before starting to force the next step output. If step_delay_time is shorter than the measurement time, the B1500 waits until the measurement completes, then forces the next step output. :param step_source_trigger_delay_time: Wait time (in seconds) after completing a step output setup and before sending a step output setup completion trigger. """ hold_time = strict_range(hold_time, [0.0, 655.35]) delay_time = strict_range(delay_time, [0.0, 65.535]) step_delay_time = strict_range(step_delay_time, [0.0, 1.0]) step_source_trigger_delay_time = strict_range( step_source_trigger_delay_time, [0.0, delay_time] ) self.write( f"WTDCV {{ch}}, {hold_time}, {delay_time}, {step_delay_time}, " f"{step_source_trigger_delay_time}" ) def set_cv_parameters(self, mode: SweepMode, start: float, stop: float, steps: int) -> None: """Set the mode and sweep parameters for :attr:`MeasMode.CV_SWEEP` measurement. (``WDCV``) :param mode: Sweep mode :param start: Sweep start voltage in V :param stop: Sweep stop voltage in V :param steps: Number of steps for staircase sweep """ cmd = _set_cv_parameters_base(self.id, mode, start, stop, steps) self.write(cmd) def force_dc_bias(self, voltage: float) -> None: """Apply DC voltage from CMU immediately. (``DCV``) :param voltage: DC bias voltage in V """ voltage = strict_range(voltage, [-100, 100]) self.write(f"DCV {{ch}}, {voltage}") def set_scuu_path(self, path: SCUUPath) -> None: """Set the connection path of the SMU CMU unify unit (SCUU). (``SSP``) This function is available when CMU and SMU CMU unify unit (SCUU) are installed. :param path: Path for the SCUU measurement """ def log_settings_change(voltage, range, compliance, series_resistance): log.info( "SMU output settings changed:\n\t" f"output voltage = {voltage} V\n\t" f"output range = {range} V\n\t" f"compliance = {compliance}\n\t" f"series resistance = {series_resistance}" ) path = SCUUPath.get(path) if path == SCUUPath.CMU: log_settings_change(0, 100, "20 mA", "OFF") else: log_settings_change( 0, 20, "100 uA", "Condition before the connection is changed from SMU to MFCMU" ) self.write(f"SSP {{ch}}, {path.value}") def _set_cv_parameters_base( id: int, mode: SweepMode | int | str, start: float, stop: float, steps: int, comp: float | None = None, ) -> str: mode = SweepMode.get(mode) if mode in [SweepMode.LOG_SINGLE, SweepMode.LOG_DOUBLE]: if not ((start >= 0 and stop >= 0) or (start <= 0 and stop <= 0)): raise ValueError(f"For {mode=} start and stop values must have the same sign.") start = strict_range(start, [-100, 100]) stop = strict_range(stop, [-100, 100]) steps = strict_range(steps, range(1, 1001)) cmd = f"WDCV {id}, {mode.value}, {start}, {stop}, {steps}" if comp is not None: cmd += f", {comp}" return cmd class CustomIntEnum(IntEnum): """Provide additional methods to IntEnum: * Conversion to string automatically replaces '_' with ' ' in names and converts to title case * get classmethod to get enum reference with name or integer .. automethod:: __str__ """ def __str__(self): """Give title case string of enum value.""" return str(self.name).replace("_", " ").title() # str() conversion just because of pylint bug @classmethod def get(cls, input_value): """Give Enum member by specifying name or value. :param str or int input_value: Enum name or value :return: Enum member """ if isinstance(input_value, int): return cls(input_value) else: return cls[input_value.upper()] class ADCType(CustomIntEnum): """ADC Type.""" HSADC = (0,) #: High-speed ADC HRADC = (1,) #: High-resolution ADC HSADC_PULSED = (2,) #: High-speed ADC for pulsed measurements def __str__(self): return str(self.name).replace("_", " ") # .title() str() conversion just because of pylint bug class ADCMode(CustomIntEnum): """ADC Mode.""" AUTO = 0 #: MANUAL = 1 #: PLC = 2 #: Power line cycle mode TIME = 3 #: Measurement time mode class AutoManual(CustomIntEnum): """Auto/Manual selection.""" AUTO = 0 #: MANUAL = 1 #: class ControlMode(CustomIntEnum): """Control mode for the digital I/O ports.""" GENERAL = 0 #: General purpose control mode (default) SMU_PGU_SELECTOR = 1 #: 16440A SMU/PGU selector (B1500A-A04) control mode N1258A_N1259A = 2 #: N1258A/N1259A module selector control mode N1265A = 4 #: N1265A Ultra High Current Expander/Fixture control mode N1266A = 8 #: N1266A High Voltage Source Monitor Unit Current Expander control mode N1268A = 16 #: N1268A Ultra High Voltage Expander control mode N1272A = 32 #: N1272A Device Capacitance Selector control mode class MeasMode(CustomIntEnum): """Measurement Mode.""" SPOT = 1 #: STAIRCASE_SWEEP = 2 #: SAMPLING = 10 #: SPOT_C = 17 #: Spot capacitance measurement (MFCMU) CV_SWEEP = 18 #: CV (DC bias) sweep measurement (SMU/MFCMU) PULSED_SPOT_C = 19 #: Pulsed spot capacitance measurement (MFCMU) PULSED_CV_SWEEP = 20 #: Pulsed CV sweep measurement (MFCMU) C_F_SWEEP = 22 #: Capacitance frequency sweep (MFCMU) CV_AC_SWEEP = 23 #: CV (AC bias) sweep measurement (MFCMU) C_T_SAMPLING = 26 #: Capacitance sampling measurement (MFCMU) class MeasOpMode(CustomIntEnum): """Measurement Operation Mode.""" COMPLIANCE_SIDE = 0 """ Measure current in the voltage source operation or voltage in the current source operation. """ CURRENT = 1 #: VOLTAGE = 2 #: FORCE_SIDE = 3 #: """ Measure current in the current source operation or voltage in the voltage source operation. """ COMPLIANCE_AND_FORCE_SIDE = 4 """ Current and voltage synchronous measurement. Measurement result contains the compliance side data and the force side data in this order. """ class PgSelectorPort(CustomIntEnum): """Output port of SMU/PG selector.""" OUTPUT_1_FIRST = 0 #: Output 1 on the first selector OUTPUT_2_FIRST = 1 #: Output 2 on the first selector OUTPUT_1_SECOND = 2 #: Output 1 on the second selector OUTPUT_2_SECOND = 3 #: Output 2 on the second selector class PgSelectorConnectionStatus(CustomIntEnum): """Connection status of I/O port.""" NO_CONNECTION = 0 #: All open. Breaks connection. Initial setting SMU_ON = 1 #: SMU on. Makes connection to the SMU input. PGU_ON = 2 #: PGU on. Makes connection to the PGU input. PGU_OPEN = 3 #: PGU open. Made by opening the semiconductor relay installed on the PGU on port. class SCUUPath(CustomIntEnum): """Connection path of the SMU CMU unify unit (SCUU)""" SMU1 = 1 #: Output SMU in slot cmu.id - 1 SMU2 = 2 #: Output SMU in slot cmu.id - 2 SMU_BOTH = 3 #: Output SMU in slot cmu.id - 1 and cmu.id - 2 CMU = 4 #: Output CMU class SweepMode(CustomIntEnum): """Sweep Mode.""" LINEAR_SINGLE = 1 #: Linear sweep (single stair, start to stop.) LOG_SINGLE = 2 #: Log sweep (single stair, start to stop.) LINEAR_DOUBLE = 3 #: Linear sweep (double stair, start to stop to start.) LOG_DOUBLE = 4 #: Log sweep (double stair, start to stop to start.) class SamplingMode(CustomIntEnum): """Sampling Mode.""" LINEAR = 1 #: LOG_10 = 2 #: Logarithmic 10 data points/decade LOG_25 = 3 #: Logarithmic 25 data points/decade LOG_50 = 4 #: Logarithmic 50 data points/decade LOG_100 = 5 #: Logarithmic 100 data points/decade LOG_250 = 6 #: Logarithmic 250 data points/decade LOG_5000 = 7 #: Logarithmic 5000 data points/decade def __str__(self): names = { 1: "Linear", 2: "Log 10 data/decade", 3: "Log 25 data/decade", 4: "Log 50 data/decade", 5: "Log 100 data/decade", 6: "Log 250 data/decade", 7: "Log 5000 data/decade", } return names[self.value] class SamplingPostOutput(CustomIntEnum): """Output after sampling.""" BASE = 1 #: BIAS = 2 #: class SPGUChannelOutputMode(CustomIntEnum): """Output mode of SPGU channel.""" DC = 0 #: DC output mode SIGNAL_SOURCE_1 = 1 #: 2-level pulse output mode using pulse signal source 1 SIGNAL_SOURCE_2 = 2 #: 2-level pulse output mode using pulse signal source 2 SIGNAL_SOURCE_1_2 = 3 #: 3-level pulse output mode using pulse signal source 1 and 2 class SPGUSignalSource(CustomIntEnum): """Signal source for SPGU.""" DC = 0 #: PULSE_SIGNAL_1 = 1 #: PULSE_SIGNAL_2 = 2 #: class SPGUOperationMode(CustomIntEnum): """Operation mode of Semiconductor Pulse Generator Unit (SPGU)""" PG = 0 #: PG (pulse output) mode ALWG = 1 #: ALWG (arbitrary linear wave output) mode class SPGUOutputMode(CustomIntEnum): """Operating mode for SPGU channel outputs""" FREE_RUN = 0 """ Free Run mode. Continues outputting until the ``SPP`` command is executed. The condition parameter is not required. """ COUNT = 1 """ Count mode. Outputs the number of pulses (when set to PG mode with the ``SIM 0`` command), or the number of sequences (when set to ALWG mode with the ``SIM 1`` command) specified by the condition parameter. """ DURATION = 2 """ Duration mode. Outputs for a duration specified by the condition parameter. """ class MFCMUMeasurementMode(CustomIntEnum): """Measurement mode for the Multi Frequency Capacitance Measurement Unit (MFCMU).""" R_X = 1 #: R (resistance, Ohm) and X (reactance, Ohm) G_B = 2 #: G (conductance, S) and B (susceptance, S) Z_PHASE_RAD = 10 #: Z (impedance, Ohm) and phase (radian) Z_PHASE_DEG = 11 #: Z (impedance, Ohm) and phase (degree) Y_PHASE_RAD = 20 #: Y (admittance, S) and phase (radian) Y_PHASE_DEG = 21 #: Y (admittance, S) and phase (degree) CP_G = 100 #: Cp (parallel capacitance, F) and G (conductance, S) CP_D = 101 #: Cp (parallel capacitance, F) and D (dissipation factor) CP_Q = 102 #: Cp (parallel capacitance, F) and Q (quality factor) CP_RP = 103 #: Cp (parallel capacitance, F) and Rp (parallel resistance, Ohm) CS_RS = 200 #: Cs (series capacitance, F) and Rs (series resistance, Ohm) CS_D = 201 #: Cs (series capacitance, F) and D (dissipation factor) CS_Q = 202 #: Cs (series capacitance, F) and Q (quality factor) LP_G = 300 #: Lp (parallel inductance, H) and G (conductance, S) LP_D = 301 #: Lp (parallel inductance, H) and D (dissipation factor) LP_Q = 302 #: Lp (parallel inductance, H) and Q (quality factor) LP_RP = 303 #: Lp (parallel inductance, H) and Rp (parallel resistance, Ohm) LS_RS = 400 #: Ls (series inductance, H) and Rs (series resistance, Ohm) LS_D = 401 #: Ls (series inductance, H) and D (dissipation factor) LS_Q = 402 #: Ls (series inductance, H) and Q (quality factor) class StaircaseSweepPostOutput(CustomIntEnum): """Output after staircase sweep.""" START = 1 #: STOP = 2 #: class CompliancePolarity(CustomIntEnum): """Compliance polarity.""" AUTO = 0 #: MANUAL = 1 #: class WaitTimeType(CustomIntEnum): """Wait time type.""" SMU_SOURCE = 1 #: wait before changing the output value SMU_MEASUREMENT = 2 #: wait before starting the measurement CMU_MEASUREMENT = 3 #: wait before starting the measurement ############################################################################### # Query Learn: Parse Instrument settings into human readable format ############################################################################### class QueryLearn: """Methods to issue and process ``*LRN?`` (learn) command and response.""" @staticmethod def query_learn(ask, query_type): """Issue ``*LRN?`` (learn) command to the instrument to read configuration. Return dictionary of commands and set values. :param int query_type: Query type according to the programming guide :return: Dictionary of command and set values :rtype: dict """ response = ask("*LRN? " + str(query_type)) # response.split(';') response = re.findall(r"(?P[A-Z]+)(?P[0-9,\+\-\.E]+)", response) # check if commands are unique -> suitable as keys for dict counts = Counter([item[0] for item in response]) # responses that start with a channel number # the channel number should always be included in the key include_chnum = [ "DI", "DV", # Sourcing "RI", "RV", # Ranging "WV", "WI", "WSV", "WSI", # Staircase Sweep "PV", "PI", "PWV", "PWI", # Pulsed Source "MV", "MI", "MSP", # Sampling "SSR", "RM", "AAD", # Series Resistor, Auto Ranging, ADC ] # probably not complete yet... response_dict = {} for element in response: parameters = element[1].split(",") name = element[0] if (counts[name] > 1) or (name in include_chnum): # append channel (first parameter) to command as dict key name += parameters[0] parameters = parameters[1:] if len(parameters) == 1: parameters = parameters[0] # skip second AAD entry for each channel -> contains no information if "AAD" in name and name in response_dict.keys(): continue response_dict[name] = parameters return response_dict @classmethod def query_learn_header(cls, ask, query_type, smu_references, single_command=False): """Issue ``*LRN?`` (learn) command to the instrument to read configuration. Processes information to human readable values for debugging purposes or file headers. :param Instrument.ask ask: ask method of the instrument :param int or str query_type: Number according to Programming Guide :param dict smu_references: SMU references by channel :param str single_command: if only a single command should be returned, defaults to False :return: Read configuration :rtype: dict """ response = cls.query_learn(ask, query_type) if single_command is not False: response = response[single_command] ret = {} for key, value in response.items(): # command without channel command = re.findall(r"(?P[A-Z]+)", key)[0] new_dict = getattr(cls, command)(key, value, smu_references=smu_references) ret = {**ret, **new_dict} return ret @staticmethod def to_dict(parameters, names, *args): """Take parameters returned by :meth:`query_learn` and ordered list of corresponding parameter names (optional function) and return dict of parameters including names. :param dict parameters: Parameters for one command returned by :meth:`query_learn` :param list names: list of names or (name, function) tuples, ordered :return: Parameter name and (processed) parameter :rtype: dict """ ret = OrderedDict() if isinstance(parameters, str): # otherwise string is enumerated parameters_iter = [(0, parameters)] else: parameters_iter = enumerate(parameters) for i, parameter in parameters_iter: if isinstance(names[i], tuple): ret[names[i][0]] = names[i][1](parameter, *args) else: ret[names[i]] = parameter return ret @staticmethod def _get_smu(key, smu_references): # command without channel command = re.findall(r"(?P[A-Z]+)", key)[0] channel = key[len(command) :] # noqa: E203 return smu_references[int(channel)] # SMU Modes @classmethod def DI(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Current Range", lambda parameter: smu.current_ranging.output(int(parameter)).name), "Current Output (A)", "Compliance Voltage (V)", ("Compliance Polarity", lambda parameter: str(CompliancePolarity.get(int(parameter)))), ( "Voltage Compliance Ranging Type", lambda parameter: smu.voltage_ranging.meas(int(parameter)).name, ), ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Constant Current" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def DV(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Voltage Range", lambda parameter: smu.voltage_ranging.output(int(parameter)).name), "Voltage Output (V)", "Compliance Current (A)", ("Compliance Polarity", lambda parameter: str(CompliancePolarity.get(int(parameter)))), ( "Current Compliance Ranging Type", lambda parameter: smu.current_ranging.meas(int(parameter)).name, ), ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Constant Voltage" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def CL(cls, key, parameters, smu_references={}): smu = cls._get_smu(key + parameters, smu_references) return {smu.name: "OFF"} # Instrument Settings: 31 @classmethod def TM(cls, key, parameters, smu_references={}): names = ["Trigger Mode"] # enum + setting not implemented yet return cls.to_dict(parameters, names) @classmethod def AV(cls, key, parameters, smu_references={}): names = [ "ADC Averaging Number", ("ADC Averaging Mode", lambda parameter: str(AutoManual(int(parameter)))), ] return cls.to_dict(parameters, names) @classmethod def CM(cls, key, parameters, smu_references={}): names = [("Auto Calibration Mode", lambda parameter: bool(int(parameter)))] return cls.to_dict(parameters, names) @classmethod def FMT(cls, key, parameters, smu_references={}): names = ["Output Data Format", "Output Data Mode"] # enum + setting not implemented yet return cls.to_dict(parameters, names) @classmethod def MM(cls, key, parameters, smu_references={}): names = [("Measurement Mode", lambda parameter: str(MeasMode(int(parameter))))] ret = cls.to_dict(parameters[0], names) smu_names = [] for channel in parameters[1:]: smu_names.append(smu_references[int(channel)].name) ret["Measurement Channels"] = ", ".join(smu_names) return ret # Measurement Ranging: 32 @classmethod def RI(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ( smu.name + " Current Measurement Range", lambda parameter: smu.current_ranging.meas(int(parameter)).name, ) ] return cls.to_dict(parameters, names) @classmethod def RV(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ( smu.name + " Voltage Measurement Range", lambda parameter: smu.voltage_ranging.meas(int(parameter)).name, ) ] return cls.to_dict(parameters, names) # Sweep: 33 @classmethod def WM(cls, key, parameters, smu_references={}): names = [ ("Auto Abort Status", lambda parameter: {2: True, 1: False}[int(parameter)]), ( "Output after Measurement", lambda parameter: str(StaircaseSweepPostOutput(int(parameter))), ), ] return cls.to_dict(parameters, names) @classmethod def WT(cls, key, parameters, smu_references={}): names = [ "Hold Time (s)", "Delay Time (s)", "Step Delay Time (s)", "Step Source Trigger Delay Time (s)", "Step Measurement Trigger Delay Time (s)", ] return cls.to_dict(parameters, names) @classmethod def WV(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Sweep Mode", lambda parameter: str(SweepMode(int(parameter)))), ("Voltage Range", lambda parameter: smu.voltage_ranging.output(int(parameter)).name), "Start Voltage (V)", "Stop Voltage (V)", "Number of Steps", "Current Compliance (A)", "Power Compliance (W)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Voltage Sweep Source" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def WI(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Sweep Mode", lambda parameter: str(SweepMode(int(parameter)))), ("Current Range", lambda parameter: smu.current_ranging.output(int(parameter)).name), "Start Current (A)", "Stop Current (A)", "Number of Steps", "Voltage Compliance (V)", "Power Compliance (W)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Current Sweep Source" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def WSV(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Voltage Range", lambda parameter: smu.voltage_ranging.output(int(parameter)).name), "Start Voltage (V)", "Stop Voltage (V)", "Current Compliance (A)", "Power Compliance (W)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Synchronous Voltage Sweep Source" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def WSI(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Current Range", lambda parameter: smu.current_ranging.output(int(parameter)).name), "Start Current (A)", "Stop Current (A)", "Voltage Compliance (V)", "Power Compliance (W)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Synchronous Current Sweep Source" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} # SMU Measurement Operation Mode: 46 @classmethod def CMM(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ( smu.name + " Measurement Operation Mode", lambda parameter: str(MeasOpMode(int(parameter))), ) ] return cls.to_dict(parameters, names) # Sampling: 47 @classmethod def MSC(cls, key, parameters, smu_references={}): names = [ ("Auto Abort Status", lambda parameter: {2: True, 1: False}[int(parameter)]), ("Output after Measurement", lambda parameter: str(SamplingPostOutput(int(parameter)))), ] return cls.to_dict(parameters, names) @classmethod def MT(cls, key, parameters, smu_references={}): names = [ "Hold Bias Time (s)", "Sampling Interval (s)", "Number of Samples", "Hold Base Time (s)", ] return cls.to_dict(parameters, names) @classmethod def ML(cls, key, parameters, smu_references={}): names = [("Sampling Mode", lambda parameter: str(SamplingMode(int(parameter))))] return cls.to_dict(parameters, names) @classmethod def MV(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Voltage Range", lambda parameter: smu.voltage_ranging.output(int(parameter)).name), "Base Voltage (V)", "Bias Voltage (V)", "Current Compliance (A)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Voltage Source Sampling" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} @classmethod def MI(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [ ("Current Range", lambda parameter: smu.current_ranging.output(int(parameter)).name), "Base Current (A)", "Bias Current (A)", "Voltage Compliance (V)", ] ret = cls.to_dict(parameters, names) ret["Source Type"] = "Current Source Sampling" ret.move_to_end("Source Type", last=False) # make first entry return {smu.name: ret} # SMU Series Resistor: 53 @classmethod def SSR(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [(smu.name + " Series Resistor", lambda parameter: bool(int(parameter)))] return cls.to_dict(parameters, names) # Auto Ranging Mode: 54 @classmethod def RM(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [smu.name + " Ranging Mode", smu.name + " Ranging Mode Parameter"] return cls.to_dict(parameters, names) # ADC: 55, 56 @classmethod def AAD(cls, key, parameters, smu_references={}): smu = cls._get_smu(key, smu_references) names = [(smu.name + " ADC", lambda parameter: str(ADCType(int(parameter))))] return cls.to_dict(parameters, names) @classmethod def AIT(cls, key, parameters, smu_references={}): adc_type = key[3:] adc_name = str(ADCType(int(adc_type))) names = [ (adc_name + " Mode", lambda parameter: str(ADCMode(int(parameter)))), adc_name + " Parameter", ] return cls.to_dict(parameters, names) @classmethod def AZ(cls, key, parameters, smu_references={}): names = [("ADC Auto Zero", lambda parameter: str(bool(int(parameter))))] return cls.to_dict(parameters, names) # Time Stamp: 60 @classmethod def TSC(cls, key, parameters, smu_references={}): names = [("Time Stamp", lambda parameter: str(bool(int(parameter))))] return cls.to_dict(parameters, names) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilentB298x.py0000644000175100017510000012171415203313266024047 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import SCPIMixin, Instrument from pymeasure.instruments.validators import (strict_discrete_set, strict_range, joined_validators ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class BatteryMixin: """A class representing the B2983/7 battery functions.""" battery_level = Instrument.measurement( ":SYST:BATT?", """Get the percentage of the remaining battery capacity (int).""", cast=int, ) battery_cycles = Instrument.measurement( ":SYST:BATT:CYCL?", """Get the battery cycle count (int).""", cast=int, ) battery_selftest_passed = Instrument.measurement( ":SYST:BATT:TEST?", """Get the battery self-test result (bool).""", map_values=True, values={True: 0, False: 1} # 0: passed, 1: failed ) class AgilentB2981(SCPIMixin, Instrument): """A class representing the Agilent/Keysight B2981A/B. The B2981 is a Femto/Picoammeter.""" def __init__(self, adapter, name="Agilent/Keysight B2980A/B series", **kwargs): super().__init__( adapter, name, **kwargs ) input_enabled = Instrument.control( ":INP?", ":INP %d", """Control the instrument input relay (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) zero_corrected = Instrument.control( ":INP:ZCOR?", ":INP:ZCOR %d", """Control the zero correction function (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) measure = Instrument.measurement( ":MEAS?", """Measure the defined parameter(s) with a spot measurement. :return: float or list of float """ ) current = Instrument.measurement( ":MEAS:CURR?", """Measure current with a spot measurement in Amps. :return: float """ ) current_range = Instrument.control( ":CURR:RANG?", ":CURR:RANG %s", """Control the range for the current measurement in Amps. :type: - float, strictly from ``2E-12`` to ``20E-3`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``UP``, ``DOWN`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'UP', 'DOWN'], [2E-12, 20E-3]] ) interlock_enabled = Instrument.measurement( ":SYST:INT:TRIP?", """Get the interlock status (bool).""", map_values=True, values={True: 0, False: 1} ) data_buffer_size = Instrument.measurement( ":SYST:DATA:QUAN?", """Get the data buffer size (int).""", cast=int ) ################## # Trigger system # ################## def abort(self): """Abort the all actions.""" self.write(":ABOR:ALL") def arm(self): """Send an immediate arm trigger for all actions. When the status of all actions is initiated, the arm trigger causes a layer change from arm to trigger. """ self.write(":ARM:ALL") def init(self): """Initiate a trigger for all actions.""" self.write(":INIT:ALL") def abort_acquisition(self): """Abort action 'ACQuire'.""" self.write(":ABOR:ACQ") def arm_acquisition(self): """Send an immediate arm trigger for action 'ACQuire'. When the status of action 'ACQuire' is initiated, the arm trigger causes a layer change from arm to trigger. """ self.write(":ARM:ACQ") def init_acquisition(self): """Initiate a trigger for action 'ACQuire'.""" self.write(":INIT:ACQ") ########################################### # Trigger properties for action 'ACQuire' # ########################################### arm_acquisition_bypass_once_enabled = Instrument.control( ":ARM:ACQ:BYP?", ":ARM:ACQ:BYP %s", """Control the bypass for the event detector in the arm layer for action 'ACQuire' (bool). """, validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) arm_acquisition_count = Instrument.control( ":ARM:ACQ:COUN?", ":ARM:ACQ:COUN %s", """Control the arm trigger count for action 'ACQuire'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) arm_acquisition_delay = Instrument.control( ":ARM:ACQ:DEL?", ":ARM:ACQ:DEL %s", """Control the arm trigger delay for action 'ACQuire' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) arm_acquisition_source = Instrument.control( ":ARM:ACQ:SOUR?", ":ARM:ACQ:SOUR %s", """Control the arm trigger source for action 'ACQuire'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the arm source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by the arm_timer command. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by the arm_source_lan_id command. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_acquisition_source_lan_id = Instrument.control( ":ARM:ACQ:SOUR:LAN?", ":ARM:ACQ:SOUR:LAN %s", """Control the source for LAN arm triggers for action 'ACQuire'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) arm_acquisition_timer = Instrument.control( ":ARM:ACQ:TIM?", ":ARM:ACQ:TIM %s", """Control the timer interval of the arm trigger source for action 'ACQuire' in seconds. :type: - float, strictly from ``1E-5`` to ``1E5`` - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) arm_acquisition_output_signal = Instrument.control( ":ARM:ACQ:TOUT:SIGN?", ":ARM:ACQ:TOUT:SIGN %s", """Control the arm trigger output for action 'ACQuire'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1`` or ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT`` selects the BNC Trigger Out. It is for the status change between the idle state and the arm layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_acquisition_output_enabled = Instrument.control( ":ARM:ACQ:TOUT?", ":ARM:ACQ:TOUT %s", """Control the arm trigger output for action 'ACQuire' (bool). It is for the status change between the idle state and the arm layer. """, validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) trigger_acquisition_is_idle = Instrument.measurement( ":IDLE:ACQ?", """Get the idle status of action 'ACQuire' (bool). The command waits until the status is changed to idle. """, map_values=True, values={True: 1, False: 0} ) trigger_acquisition_bypass_once_enabled = Instrument.control( ":TRIG:ACQ:BYP?", ":TRIG:ACQ:BYP %s", """ Control the bypass for the event detector in the trigger layer for action 'ACQuire' (bool). """, validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) trigger_acquisition_count = Instrument.control( ":TRIG:ACQ:COUN?", ":TRIG:ACQ:COUN %s", """Control the trigger count for action 'ACQuire'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647``. """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) trigger_acquisition_delay = Instrument.control( ":TRIG:ACQ:DEL?", ":TRIG:ACQ:DEL %s", """Control the trigger delay for action 'ACQuire' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) trigger_acquisition_source = Instrument.control( ":TRIG:ACQ:SOUR?", ":TRIG:ACQ:SOUR %s", """Control the trigger source for action 'ACQuire'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the trigger source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by the :attr:`trigger_acquisition_timer`. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by :attr:`trigger_acquisition_source_lan_id`. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_acquisition_source_lan_id = Instrument.control( ":TRIG:ACQ:SOUR:LAN?", ":TRIG:ACQ:SOUR:LAN %s", """Control the source for LAN triggers for action 'ACQuire'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) trigger_acquisition_timer = Instrument.control( ":TRIG:ACQ:TIM?", ":TRIG:ACQ:TIM %s", """Control the timer interval of the trigger source for action 'ACQuire' in seconds. :type: - float, strictly from ``1E-5`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) trigger_acquisition_output_signal = Instrument.control( ":TRIG:ACQ:TOUT:SIGN?", ":TRIG:ACQ:TOUT:SIGN %s", """Control the trigger signal output for action 'ACQuire'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1`` and ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT``: selects the BNC Trigger Out. It is for the status change between the idle state and the trigger layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_acquisition_output_enabled = Instrument.control( ":TRIG:ACQ:TOUT?", ":TRIG:ACQ:TOUT %s", """Control the trigger output for action 'ACQuire' (bool). It is for the status change between the idle state and the trigger layer.""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) #################################### # Trigger setters for action 'ALL' # #################################### arm_all_bypass_once_enabled = Instrument.setting( ":ARM:ALL:BYP %s", """Set the bypass for the event detector in the arm layer for action 'ALL' (bool).""", validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) arm_all_count = Instrument.setting( ":ARM:ALL:COUN %s", """Set the arm trigger counter for action 'ALL'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647``. """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) arm_all_delay = Instrument.setting( ":ARM:ALL:DEL %s", """Set the arm trigger delay for action 'ALL' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) arm_all_source = Instrument.setting( ":ARM:ALL:SOUR %s", """Set the arm trigger source for action 'ALL'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the arm source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by attr:`arm_all_timer`. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by :attr:`arm_all_source_lan_id`. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_all_source_lan_id = Instrument.setting( ":ARM:ALL:SOUR:LAN %s", """Set the source for LAN arm triggers for action 'ALL'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) arm_all_timer = Instrument.setting( ":ARM:ALL:TIM %s", """Set the timer interval of the arm trigger source for action 'ALL' in seconds. :type: - float, strictly from ``1E-5`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) arm_all_output_signal = Instrument.setting( ":ARM:ALL:TOUT:SIGN %s", """Set the arm trigger output for action 'ALL'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1`` and ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT`` selects the BNC Trigger Out. It is for the status change between the idle state and the arm layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_all_output_enabled = Instrument.setting( ":ARM:ALL:TOUT %s", """Set the arm trigger output for action 'ALL' (bool). It is for the status change between the idle state and the arm layer.""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) trigger_all_is_idle = Instrument.measurement( ":IDLE:ALL?", """Get the trigger idle status for action 'ALL' (bool). The command waits until the status is changed to idle. """, map_values=True, values={True: 1, False: 0} ) trigger_all_bypass_once_enabled = Instrument.setting( ":TRIG:ALL:BYP %s", """Set the bypass for the event detector in the trigger layer for action 'ALL' (bool).""", validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) trigger_all_count = Instrument.setting( ":TRIG:ALL:COUN %s", """Set the trigger count for action 'ALL'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647``. """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) trigger_all_delay = Instrument.setting( ":TRIG:ALL:DEL %s", """Set the trigger delay for action 'ALL' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) trigger_all_source = Instrument.setting( ":TRIG:ALL:SOUR %s", """Set the trigger source for action 'ALL'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the trigger source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by :attr:`trigger_all_timer`. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by :attr:`trigger_all_source_lan_id`. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_all_source_lan_id = Instrument.setting( ":TRIG:ALL:SOUR:LAN %s", """Set the source for LAN triggers for action 'ALL'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) trigger_all_timer = Instrument.setting( ":TRIG:ALL:TIM %s", """Set the timer interval of the trigger source for action 'ALL' in seconds. :type: - float, strictly from ``1E-5`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) trigger_all_output_signal = Instrument.setting( ":TRIG:ALL:TOUT:SIGN %s", """Set the trigger signal output for action 'ALL'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1`` and ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT`` selects the BNC Trigger Out. It is for the status change between the idle state and the trigger layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_all_output_enabled = Instrument.setting( ":TRIG:ALL:TOUT %s", """Set the trigger output for action 'ALL' (bool). It is for the status change between the idle state and the trigger layer.""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) class AgilentB2983(AgilentB2981, BatteryMixin): """A class representing the Agilent/Keysight B2983A/B. The B2983 is a Femto/Picoammeterwith with battery operation. """ pass class AgilentB2985(AgilentB2981): """A class representing the Agilent/Keysight B2985A/B. The B2985 is a Femto/Picoammeter and Electrometer/High Resistance Meter. """ function = Instrument.control( ":FUNC?", ":FUNC '%s'", """Control the measurement function. :type: str, strictly in ``CURR``, ``CHAR``, ``VOLT``, ``RES`` """, validator=strict_discrete_set, values=['CURR', 'CHAR', 'VOLT', 'RES'], get_process=lambda v: v.strip('"'), get_process_list=lambda v: [x.strip('"') for x in v], ) charge = Instrument.measurement( ":MEAS:CHAR?", """Measure charge with a spot measurement in Coulombs. :return: float """ ) charge_range = Instrument.control( ":CHAR:RANG?", ":CHAR:RANG %s", """Control the range for the charge measurement in Coulombs. :type: - float, strictly from ``2E-9`` to ``2E-6`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``UP``, ``DOWN`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'UP', 'DOWN'], [2E-9, 2E-6]] ) resistance = Instrument.measurement( ":MEAS:RES?", """Measure resistance with a spot measurement in Ohms. :return: float """ ) resistance_range = Instrument.control( ":RES:RANG?", ":RES:RANG %s", """Control the range for the resistance measurement. :type: - float, strictly from ``1E6`` to ``1E15`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``UP``, ``DOWN`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'UP', 'DOWN'], [1E6, 1E15]] ) voltage = Instrument.measurement( ":MEAS:VOLT?", """Measure voltage with a spot (one-shot) measurement in Volts. :return: float """ ) voltage_range = Instrument.control( ":VOLT:RANG?", ":VOLT:RANG %s", """Control the range for the voltage measurement in Volts. :type: - float, strictly from ``2`` to ``20`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``UP``, ``DOWN`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'UP', 'DOWN'], [2, 20]] ) humidity = Instrument.measurement( ":SYST:HUM?", """Measure the relative humidity in percent. :return: float """ ) temperature = Instrument.measurement( ":SYST:TEMP?", """Measure the temperature. :return: float The unit of temperature is controlled by :attr:`temperature_unit`: """ ) temperature_sensor = Instrument.control( ":SYST:TEMP:SEL?", ":SYST:TEMP:SEL %s", """Control the tempertature sensor. :type: str, strictly in ``TC``, ``HSEN`` - ``TC`` selects the thermocouple. - ``HSEN`` selects the temperature sensor within the humidity sensor. """, validator=strict_discrete_set, values=['TC', 'HSEN'] ) temperature_unit = Instrument.control( ":SYST:TEMP:UNIT?", ":SYST:TEMP:UNIT %s", """Control the tempertature unit. :type: str, strictly in ``C``, ``CEL``, ``F``, ``FAR``, ``K`` - ``C``, ``CEL`` selects degree Celsius. - ``F``, ``FAR`` selects degree Fahrenheit. - ``K`` selects Kelvin. """, validator=strict_discrete_set, values=['C', 'CEL', 'F', 'FAR', 'K'] ) ############################################################ # Trigger functions for action 'TRANsient' (voltage source)# ############################################################ def abort_transient(self): """Abort action 'TRANSient'.""" self.write(":ABOR:TRAN") def arm_transient(self): """Send an immediate arm trigger for action 'TRANSient'. When the status of the specified action is initiated, the arm trigger causes a layer change from arm to trigger. """ self.write(":ARM:TRAN") def init_transient(self): """Initiate a trigger for action 'TRANSient'.""" self.write(":INIT:TRAN") ############################################################## # Trigger properties for action 'TRANsient' (voltage source) # ############################################################## arm_transient_bypass_once_enabled = Instrument.control( ":ARM:TRAN:BYP?", ":ARM:TRAN:BYP %s", """ Control the bypass for the event detector in the arm layer for action 'TRANSient' (bool). """, validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) arm_transient_count = Instrument.control( ":ARM:TRAN:COUN?", ":ARM:TRAN:COUN %s", """Control the arm trigger count for action 'TRANSient'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647``. """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) arm_transient_delay = Instrument.control( ":ARM:TRAN:DEL?", ":ARM:TRAN:DEL %s", """Control the arm trigger delay for action 'TRANSient' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) arm_transient_source = Instrument.control( ":ARM:TRAN:SOUR?", ":ARM:TRAN:SOUR %s", """Control the arm trigger source for action 'TRANSient'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the arm source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by :attr:`arm_transient_timer`. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by :attr:`arm_transient_source_lan_id`. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_transient_source_lan_id = Instrument.control( ":ARM:TRAN:SOUR:LAN?", ":ARM:TRAN:SOUR:LAN %s", """Control the source for LAN arm triggers for action 'TRANSient'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) arm_transient_timer = Instrument.control( ":ARM:TRAN:TIM?", ":ARM:TRAN:TIM %s", """Control the timer interval of the arm trigger source for action 'TRANSient' in seconds. :type: - float, strictly from ``1E-5`` to ``1E5`` - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) arm_transient_output_signal = Instrument.control( ":ARM:TRAN:TOUT:SIGN?", ":ARM:TRAN:TOUT:SIGN %s", """Control the arm trigger output for action 'TRANSient'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1`` and ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT`` selects the BNC Trigger Out. It is for the status change between the idle state and the arm layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) arm_transient_output_enabled = Instrument.control( ":ARM:TRAN:TOUT?", ":ARM:TRAN:TOUT %s", """Control the arm trigger output for action 'TRANSient' (bool). It is for the status change between the idle state and the arm layer. """, validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) trigger_transient_is_idle = Instrument.measurement( ":IDLE:TRAN?", """Get idle the status of action 'TRANSient' (bool). The command waits until the status is changed to idle. """, map_values=True, values={True: 1, False: 0} ) trigger_transient_bypass_once_enabled = Instrument.control( ":TRIG:TRAN:BYP?", ":TRIG:TRAN:BYP %s", """ Control the bypass for the event detector in trigger layer for action 'TRANSient' (bool). """, validator=strict_discrete_set, map_values=True, values={True: 'ONCE', False: 'OFF'} ) trigger_transient_count = Instrument.control( ":TRIG:TRAN:COUN?", ":TRIG:TRAN:COUN %s", """Control the trigger count for action 'TRANSient'. :type: - int, strictly from ``1`` to ``100000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF``, ``INF`` ``INF`` is equivalent to ``2147483647``. """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF', 'INF', 2147483647], [1, 100000]] ) trigger_transient_delay = Instrument.control( ":TRIG:TRAN:DEL?", ":TRIG:TRAN:DEL %s", """Control the trigger delay for action 'TRANSient' in seconds. :type: - float, strictly from ``0`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [0, 100000]] ) trigger_transient_source = Instrument.control( ":TRIG:TRAN:SOUR?", ":TRIG:TRAN:SOUR %s", """Control the trigger source for action 'TRANSient'. :type: str, strictly in ``AINT``, ``BUS``, ``TIM``, ``INT1``, ``INT2``, ``LAN``, ``TIN``, ``EXT1`` to ``EXT7`` - ``AINT`` automatically selects the trigger source most suitable for the present operating mode by using internal algorithms. - ``BUS`` selects the remote interface trigger command such as the group execute trigger (GET) and the TRG command. - ``TIM`` selects a signal internally generated every interval set by :attr:`trigger_transient_timer`. - ``INT1`` and ``INT2`` selects a signal from the internal bus 1 or 2. - ``LAN`` selects the LXI trigger specified by :attr:`trigger_transient_source_lan_id`. - ``EXT1`` to ``EXT7`` selects a signal from the GPIO pin n, which is an input port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TIN`` selects the BNC Trigger In. """, validator=strict_discrete_set, values=['AINT', 'BUS', 'TIM', 'INT1', 'INT2', 'LAN', 'TIN', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_transient_source_lan_id = Instrument.control( ":TRIG:TRAN:SOUR:LAN?", ":TRIG:TRAN:SOUR:LAN %s", """Control the source for LAN triggers for action 'TRANSient'. :type: str, strictly from ``LAN0`` to ``LAN7`` """, validator=strict_discrete_set, values=['LAN0', 'LAN1', 'LAN2', 'LAN3', 'LAN4', 'LAN5', 'LAN6', 'LAN7'] ) trigger_transient_timer = Instrument.control( ":TRIG:TRAN:TIM?", ":TRIG:TRAN:TIM %s", """Control the timer interval of the trigger source for action 'TRANSient'. :type: - float, strictly from ``1E-5`` to ``1E5`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [1E-5, 1E5]] ) trigger_transient_output_signal = Instrument.control( ":TRIG:TRAN:TOUT:SIGN?", ":TRIG:TRAN:TOUT:SIGN %s", """Control the trigger signal output for action 'TRANSient'. :type: str, strictly in ``INT1``, ``INT2``, ``LAN``, ``TOUT``, ``EXT1`` to ``EXT7`` - ``INT1``, ``INT2`` selects the internal bus 1 or 2. - ``LAN`` selects a LAN port. - ``EXT1`` to ``EXT7`` selects the GPIO pin n, which is an output port of the Digital I/O D-sub connector on the rear panel. n = 1 to 7. - ``TOUT`` selects the BNC Trigger Out. It is for the status change between the idle state and the trigger layer. """, validator=strict_discrete_set, values=['INT1', 'INT2', 'LAN', 'TOUT', 'EXT1', 'EXT2', 'EXT3', 'EXT4', 'EXT5', 'EXT6', 'EXT7'] ) trigger_transient_output_enabled = Instrument.control( ":TRIG:TRAN:TOUT?", ":TRIG:TRAN:TOUT %s", """Control the trigger output for action 'TRANSient' (bool). It is for the status change between the idle state and the trigger layer. """, validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) ############################ # Voltage source functions # ############################ source_enabled = Instrument.control( ":OUTP?", ":OUTP %d", """Control the voltage source output relay (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) source_low_state = Instrument.control( ":OUTP:LOW?", ":OUTP:LOW %s", """Control the voltage source low terminal state. :type: str, strictly ``FLO`` or ``COMM`` - ``FLO``: low terminal is floating. - ``COMM``: low terminal is connected to Common. """, validator=strict_discrete_set, values=['FLO', 'COMM'] ) source_off_state = Instrument.control( ":OUTP:OFF:MODE?", ":OUTP:OFF:MODE %s", """Control the voltage source off condition. :type: str, strictly in ``ZERO``, ``HIZ``, ``NORM`` +------------+--------------------------------------------------------------+ | ``HIGH Z`` | - Output relay: off (open) | | | - The voltage source setting is not changed. | | | - This status is available only when the 20 V range is used. | +------------+--------------------------------------------------------------+ | ``NORMAL`` | - Output voltage: 0 V | | | - Output relay: off (open) | +------------+--------------------------------------------------------------+ | ``ZERO`` | - Output voltage: 0 V in the present voltage range | +------------+--------------------------------------------------------------+ """, validator=strict_discrete_set, values=['ZERO', 'HIZ', 'NORM'] ) source_voltage = Instrument.control( ":SOUR:VOLT?", ":SOUR:VOLT %g", """Control the source voltage in Volts. :type: float, strictly from ``-1050`` to ``1050`` For voltages > 20V the interlock must be closed. +---------+------------+-------------------+-----------------+ | Range | Resolution | Output voltage | Maximum current | +---------+------------+-------------------+-----------------+ | 20 V | 700 µV | -21 V ≤ V ≤ 21 V | +/-20 mA | +---------+------------+-------------------+-----------------+ | 1000 V | 35 mV | -1 V ≤ V ≤ 1000 V | +/-1.0 mA | +---------+------------+-------------------+-----------------+ | -1000 V | 35 mV | -1000 V ≤ V ≤ 1 V | +/-1.0 mA | +---------+------------+-------------------+-----------------+ """, validator=strict_range, values=[-1050, 1050] ) source_voltage_range = Instrument.control( ":SOUR:VOLT:RANG?", ":SOUR:VOLT:RANG %s", """Control the source voltage range. :type: - float, strictly from ``-1000`` to ``1000`` or - str, strictly in ``MIN``, ``MAX``, ``DEF`` """, validator=joined_validators(strict_discrete_set, strict_range), values=[['MIN', 'MAX', 'DEF'], [-1000, 1000]] ) class AgilentB2987(AgilentB2985, BatteryMixin): """A class representing the Agilent/Keysight B2987A/B. The B2987 is a Femto/Picoammeter and Electrometer/High Resistance Meter with battery operation. """ pass ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilentE4408B.py0000644000175100017510000000733515203313266024043 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.validators import truncated_range from io import StringIO import numpy as np import pandas as pd class AgilentE4408B(SCPIMixin, Instrument): """Represents the AgilentE4408B Spectrum Analyzer and provides a high-level interface for taking scans of high-frequency spectrums. """ def __init__(self, adapter, name="Agilent E4408B Spectrum Analyzer", **kwargs): super().__init__( adapter, name, **kwargs ) start_frequency = Instrument.control( ":SENS:FREQ:STAR?;", ":SENS:FREQ:STAR %e Hz;", """Control the start frequency in Hz (float).""", ) stop_frequency = Instrument.control( ":SENS:FREQ:STOP?;", ":SENS:FREQ:STOP %e Hz;", """Control the stop frequency in Hz (float).""", ) frequency_points = Instrument.control( ":SENSe:SWEEp:POINts?;", ":SENSe:SWEEp:POINts %d;", """Control the number of frequency points in the sweep (int, truncated from 101 to 8192).""", validator=truncated_range, values=[101, 8192], cast=int ) frequency_step = Instrument.control( ":SENS:FREQ:CENT:STEP:INCR?;", ":SENS:FREQ:CENT:STEP:INCR %g Hz;", """Control the frequency step in Hz (float).""", ) center_frequency = Instrument.control( ":SENS:FREQ:CENT?;", ":SENS:FREQ:CENT %e Hz;", """Control the center frequency in Hz (float).""", ) sweep_time = Instrument.control( ":SENS:SWE:TIME?;", ":SENS:SWE:TIME %.2e;", """Control the sweep time in seconds (float).""", ) @property def frequencies(self): """Get a numpy array of frequencies in Hz corresponding to the current settings.""" return np.linspace( self.start_frequency, self.stop_frequency, self.frequency_points, dtype=np.float64 ) def trace(self, number: int = 1): """Get a numpy array of the data for a particular trace. :param number: Trace number (1, 2, or 3). """ self.write(":FORMat:TRACe:DATA ASCII;") data = np.loadtxt( StringIO(self.ask(":TRACE:DATA? TRACE%d;" % number)), delimiter=',', dtype=np.float64 ) return data def trace_df(self, number=1): """Get a pandas DataFrame containing the frequency and peak data for a particular trace.""" return pd.DataFrame({ 'Frequency (GHz)': self.frequencies * 1e-9, 'Peak (dB)': self.trace(number) }) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilentE4980.py0000644000175100017510000001561115203313266023742 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set, strict_range from pyvisa.errors import VisaIOError class AgilentE4980(SCPIUnknownMixin, Instrument): """Represents LCR meter E4980A/AL""" ac_voltage = Instrument.control(":VOLT:LEV?", ":VOLT:LEV %g", "AC voltage level, in Volts", validator=strict_range, values=[0, 20]) ac_current = Instrument.control(":CURR:LEV?", ":CURR:LEV %g", "AC current level, in Amps", validator=strict_range, values=[0, 0.1]) frequency = Instrument.control(":FREQ:CW?", ":FREQ:CW %g", "AC frequency (range depending on model), in Hertz", validator=strict_range, values=[20, 2e6]) # FETCH? returns [A,B,state]: impedance returns only A,B impedance = Instrument.measurement( ":FETCH?", "Measured data A and B, according to :attr:`~.AgilentE4980.mode`", get_process_list=lambda x: x[:2]) mode = Instrument.control("FUNCtion:IMPedance:TYPE?", "FUNCtion:IMPedance:TYPE %s", """ Select quantities to be measured: * CPD: Parallel capacitance [F] and dissipation factor [number] * CPQ: Parallel capacitance [F] and quality factor [number] * CPG: Parallel capacitance [F] and parallel conductance [S] * CPRP: Parallel capacitance [F] and parallel resistance [Ohm] - CSD: Series capacitance [F] and dissipation factor [number] - CSQ: Series capacitance [F] and quality factor [number] - CSRS: Series capacitance [F] and series resistance [Ohm] * LPD: Parallel inductance [H] and dissipation factor [number] * LPQ: Parallel inductance [H] and quality factor [number] * LPG: Parallel inductance [H] and parallel conductance [S] * LPRP: Parallel inductance [H] and parallel resistance [Ohm] - LSD: Series inductance [H] and dissipation factor [number] - LSQ: Seriesinductance [H] and quality factor [number] - LSRS: Series inductance [H] and series resistance [Ohm] * RX: Resistance [Ohm] and reactance [Ohm] * ZTD: Impedance, magnitude [Ohm] and phase [deg] * ZTR: Impedance, magnitude [Ohm] and phase [rad] * GB: Conductance [S] and susceptance [S] * YTD: Admittance, magnitude [Ohm] and phase [deg] * YTR: Admittance magnitude [Ohm] and phase [rad] """, validator=strict_discrete_set, values=["CPD", "CPQ", "CPG", "CPRP", "CSD", "CSQ", "CSRS", "LPD", "LPQ", "LPG", "LPRP", "LSD", "LSQ", "LSRS", "RX", "ZTD", "ZTR", "GB", "YTD", "YTR", ]) trigger_source = Instrument.control("TRIG:SOUR?", "TRIG:SOUR %s", """ Select trigger source; accept the values: * HOLD: manual * INT: internal * BUS: external bus (GPIB/LAN/USB) * EXT: external connector""", validator=strict_discrete_set, values=["HOLD", "INT", "BUS", "EXT"]) def __init__(self, adapter, name="Agilent E4980A/AL LCR meter", **kwargs): super().__init__( adapter, name, **kwargs ) self.timeout = 30000 # format: output ascii self.write("FORM ASC") def freq_sweep(self, freq_list, return_freq=False): """ Run frequency list sweep using sequential trigger. :param freq_list: list of frequencies :param return_freq: if True, returns the frequencies read from the instrument Returns values as configured with :attr:`~.AgilentE4980.mode` """ # manual, page 299 # self.write("*RST;*CLS") self.write("TRIG:SOUR BUS") self.write("DISP:PAGE LIST") self.write("FORM ASC") # trigger in sequential mode self.write("LIST:MODE SEQ") lista_str = ",".join(['%e' % f for f in freq_list]) self.write("LIST:FREQ %s" % lista_str) # trigger self.write("INIT:CONT ON") self.write(":TRIG:IMM") # wait for completed measurement # using the Error signal (there should be a better way) while 1: try: measured = self.values(":FETCh:IMPedance:FORMatted?") break except VisaIOError: pass # at the end return to manual trigger self.write(":TRIG:SOUR HOLD") # gets 4-ples of numbers, first two are data A and B a_data = [measured[_] for _ in range(0, 4 * len(freq_list), 4)] b_data = [measured[_] for _ in range(1, 4 * len(freq_list), 4)] if return_freq: read_freqs = self.values("LIST:FREQ?") return a_data, b_data, read_freqs else: return a_data, b_data # TODO: maybe refactor as property? def aperture(self, time=None, averages=1): """ Set and get aperture. :param time: integration time as string: SHORT, MED, LONG (case insensitive); if None, get values :param averages: number of averages, numeric """ if time is None: read_values = self.ask(":APER?").split(',') return read_values[0], int(read_values[1]) else: if time.upper() in ["SHORT", "MED", "LONG"]: self.write(f":APER {time}, {averages}") else: raise Exception("Time must be a string: SHORT, MED, LONG") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/agilent/agilentE5062A.py0000644000175100017510000005352715203313266024043 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin, Channel from pymeasure.instruments.validators import strict_range, strict_discrete_range, \ strict_discrete_set from pyvisa.errors import VisaIOError import numpy as np import functools DISPLAY_LAYOUT_OPTIONS = [ "D1", "D12", "D1_2", "D112", "D1_1_2", "D123", "D1_2_3", "D12_33", "D11_23", "D13_23", "D12_13", "D1234", "D1_2_3_4", "D12_34" ] class VNATrace(Channel): """A trace (of a channel) of the E5061A/E5062A""" placeholder = 'tr' # default ch would collide with VNAChannel def activate(self): """Select this trace. """ self.write('CALC{{ch}}:PAR{tr}:SEL') parameter = Channel.control( "CALCulate{{ch}}:PARameter{tr}:DEFine?", "CALCulate{{ch}}:PARameter{tr}:DEFine %s", """Control the measurement parameter of the trace (str). Can be S11, S21, S12, or S22""", validator=strict_discrete_set, values=['S11', 'S12', 'S21', 'S22'] ) class VNAChannel(Channel): """A measurement channel of the E5061A/E5062A""" def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self._add_trace(override_id=1) # add just a single trace to init it all self._update_trace_count(self.visible_traces) # add remaining traces if necessary self._update_power_values(self.attenuation) # update dynamic limits of power def _add_trace(self, override_id=None): """Internal method that adds a trace to the traces list""" tr_id = len(self.traces) + 1 if override_id is None else override_id self.add_child(VNATrace, tr_id, 'traces', 'tr_') def _update_trace_count(self, visible_traces): """Internal method that updates the trace list based on the number of visible traces. """ while len(self.traces) > visible_traces: self.remove_child(self.traces[max(self.traces.keys())]) while len(self.traces) < visible_traces: self._add_trace() def _update_power_values(self, attenuation): """Internal method that updates the valid range of stimulus power based on the configured attenuation""" self.power_values = ( -attenuation - 5, -attenuation + 10) start_frequency = Channel.control( "SENSe{ch}:FREQuency:STARt?", "SENSe{ch}:FREQuency:STARt %g", """Control the start frequency in Hz (float).""", validator=strict_range, values=[3e5, 3e9] ) stop_frequency = Channel.control( "SENSe{ch}:FREQuency:STOP?", "SENSe{ch}:FREQuency:STOP %g", """Control the stop frequency in Hz (float).""", validator=strict_range, values=[3e5, 3e9] ) scan_points = Channel.control( "SENSe{ch}:SWEep:POINts?", "SENSe{ch}:SWEep:POINts %g", """Control the number of points used in a sweep (int). Valid range 2 - 1601.""", cast=int, validator=functools.partial(strict_discrete_range, step=1), values=range(2, 1602) ) sweep_time = Channel.control( "SENSe{ch}:SWEep:TIME?", "SENSe{ch}:SWEep:TIME %g", """Control the sweep time in seconds (float). The allowable range varies on config and the set value is truncated. Note that ``sweep_time_auto_enabled`` needs to be ``False`` for changes to this property to have an effect.""" ) sweep_time_auto_enabled = Channel.control( "SENSe{ch}:SWEep:TIME:AUTO?", "SENSe{ch}:SWEep:TIME:AUTO %d", """Control whether to automatically set the sweep time (bool). You probably want this on to always keep the sweep time to a minimum (given the range, IF BW, and sweep delay time).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) sweep_type = Channel.control( "SENSe{ch}:SWEep:TYPE?", "SENSe{ch}:SWEep:TYPE %s", """Control the type of the sweep (string). ======= =========== Setting Description ======= =========== LIN Linear LOG Logarithmic SEGM Segment POW Power ======= =========== Defaults to linear. Note that the API for configuring segment type sweeps is not implememented in this class.""", validator=strict_discrete_set, values=['LIN', 'LOG', 'SEGM', 'POW'] ) averaging_enabled = Channel.control( "SENSe{ch}:AVERage?", "SENSe{ch}:AVERage %d", """Control whether to average the measurement data (bool).""", validator=strict_discrete_set, map_values=True, values={True: 1, False: 0} ) def restart_averaging(self): """ Clear averaging history. """ self.write("SENSe{ch}:AVERage:CLEar") averages = Channel.control( "SENSe{ch}:AVERage:COUNt?", "SENSe{ch}:AVERage:COUNt %d", """Control how many averages to take, from 1-999 (int). Note that ``averaging_enabled`` needs to be true for averaging to be enabled.""", cast=lambda x: int(float(x)), validator=strict_range, values=[1, 999] ) IF_bandwidth = Channel.control( "SENSe{ch}:BANDwidth?", "SENSe{ch}:BANDwidth %d", """Control the IF bandwidth in Hz (int), from 10 Hz to 30 kHz. Default 30 kHz.""", cast=lambda x: int(float(x)), validator=strict_range, values=[10, 30000] ) def activate(self): """Activate (select) the current channel. Note that the channel must first be displayed (via AgilentE5062A.display_layout) for it to be activatable. """ if str(self.id) not in self.parent.display_layout: raise ValueError('Cannot activate a channel that is not displayed') self.write("DISP:WIND{ch}:ACT") @property def visible_traces(self): """Control the number of traces visible in the channel (int).""" return int(self.ask("CALC{ch}:PARameter:COUNt?")) @visible_traces.setter def visible_traces(self, value): value = int(float(value)) value = strict_range(value, [1, 4]) self.write("CALC{ch}:PARameter:COUNt %d" % value) self._update_trace_count(value) power = Channel.control( "SOURce{ch}:POWer?", "SOURce{ch}:POWer %g", """Control the simulus power in dBm (float). The allowable range is influenced by the value of ``attenuation``. """, validator=strict_range, values=(-5, 10), dynamic=True, ) @property def attenuation(self): """Control the stimulus attenuation in dB (positive int), from 0 to 40 in incrememnts of 10. Default is 0 dB. The allowable stimulus power range is a 15 dB range: (``attenuation`` - 5 dB, ``attenuation`` + 10 dB). This requires the power range extension, and the command is ignored if the extension is not installed. """ return int(float(self.ask("SOURce{ch}:POWer:ATTenuation?"))) @attenuation.setter def attenuation(self, value): value = int(float(value)) value = strict_discrete_set(value, [0, 10, 20, 30, 40]) self.write("SOURce{ch}:POWer:ATTenuation %d" % value) self._update_power_values(value) display_layout = Channel.control( "DISPlay:WINDow{ch}:SPLit?", "DISPlay:WINDow{ch}:SPLit %s", """Control the graph layout of the traces in the channel (str). Does not affect how many traces are active. See the list of valid options: - D1 - D12 - D1_2 - D112 - D1_1_2 - D123 - D1_2_3 - D12_33 - D11_23 - D13_23 - D12_13 - D1234 - D1_2_3_4 - D12_34 In general, an occurance of a number denotes the associated trace having it's own subplot and an occurence of '_' denotes a vertical split. Multiple occurences of the same number denote the trace having a larger window than the other traces. Refer to Figure 3-1 in the the programmer's manual for details. If a trace is active but it's associated number is not present in the ``display_layout`` identifier, it is plotted in the first subplot. """, validator=strict_discrete_set, values=DISPLAY_LAYOUT_OPTIONS ) TRACE_FORMAT = [ 'MLOG', 'PHAS', 'GDEL', 'SLIN', 'SLOG', 'SCOM', 'SMIT', 'SADM', 'PLIN', 'PLOG', 'POL', 'MLIN', 'SWR', 'REAL', 'IMAG', 'UPH', 'PPH' ] trace_format = Channel.control( "CALCulate{ch}:FORMat?", "CALCulate{ch}:FORMat %s", """Control the data format of the *active trace* of the channel (str). Default is MLOGarithmic. From the programmer's manual: ======= ============================================= Setting Description ======= ============================================= MLOG Specifies the logarithmic magnitude format. PHAS Specifies the phase format. GDEL Specifies the group delay format. SLIN Specifies the Smith chart format (Lin/Phase). SLOG Specifies the Smith chart format (Log/Phase). SCOM Specifies the Smith chart format (Real/Imag). SMIT Specifies the Smith chart format (R+jX). SADM Specifies the Smith chart format (G+jB). PLIN Specifies the polar format (Lin). PLOG Specifies the polar format (Log). POr Specifies the polar format (Re/Im). MLI Specifies the linear magnitude format. SWR Specifies the SWR format. REAL Specifies the real format. IMAG Specifies the imaginary format. UPH Specifies the expanded phase format. PPH Specifies the positive phase format. ======= ============================================= """, validator=strict_discrete_set, values=TRACE_FORMAT ) def _read_binary_data(self): """Internal method that reads and interprents binary data arrays as floats. Assumes the query has already been sent. Uses the IEEE 64-bit fp transer format (little-endian). """ header = self.read_bytes(8) # 2 start bytes + 6 bytes if not header[0:2].decode('ascii') == '#6': raise ValueError('''Unrecognized header. Ensure the data transfer format (FORM:DATA?) is set to "REAL"''') nbytes = int(header[2:].decode('ascii')) binary_data = self.read_bytes(nbytes) terminator = self.read_bytes(1) if terminator.decode('ascii') != '\n': raise ValueError(f'Unexpected terminator {terminator} (expected \\n)') return np.frombuffer(binary_data, dtype=' str: """Remove known unit suffixes from a msg. The units of some replies depend on the mode of the device, hence all known units are removed. """ for suffix in cls.unit_suffixes: msg = msg.replace(suffix, "") return msg mode = Instrument.control( "MODE?", "MODE %s", """Control the mode of the digital load. Can be one of: ``("C", "P", "R", "G", "V")``, corresponding to (respectively) constant current, power, resistance, conductance, or voltage (string). """, validator=strict_discrete_set, values=["C", "P", "R", "G", "V"], get_process=lambda v: v.replace("MODE ", ""), ) level_select = Instrument.control( "LVLSEL?", "LVLSEL %s", """Control the selected level of the digital load. Can be one of: ``("A", "B", "T", "V", "E")``, corresponding to (respectively) Level A, Level B, Transient, Ext Voltage and Ext TTL (string). """, validator=strict_discrete_set, values=["A", "B", "T", "V", "E"], get_process=lambda v: v.replace("LVLSEL ", ""), ) level_a = Instrument.control( "A?", "A %g", """Control the A level of the current control mode (float).""", preprocess_reply=lambda v: LD400P.remove_unit_suffix(v.replace("A", "")), ) level_b = Instrument.control( "B?", "B %g", """Control the B level of the current control mode (float).""", preprocess_reply=lambda v: LD400P.remove_unit_suffix(v.replace("B", "")), ) input_enabled = Instrument.control( "INP?", "INP %d", """Control the input state of the digital load, can be ``True`` (on) or ``False`` (off). """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, preprocess_reply=lambda v: v.replace("INP ", ""), ) # Voltage / current replies are _not_ prefixed by the command, but do have a unit: voltage = Instrument.measurement( "V?", """Get the measured source input voltage (float).""", preprocess_reply=lambda v: v.replace("V", ""), ) current = Instrument.measurement( "I?", """Get the measured load current (float).""", preprocess_reply=lambda v: v.replace("A", ""), ) # Remove SCP properties that don't work on this device: @property def options(self): """Get options - Not available.""" raise AttributeError("No attribute 'options' exists") @property def next_error(self): """Get next error - Not available.""" raise AttributeError("No attribute 'next_error' exists") def check_errors(self): """Not available.""" raise NotImplementedError("This method is not available on this device") ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.013282 pymeasure-0.16.0/pymeasure/instruments/aja/0000755000175100017510000000000015203313301020405 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/aja/__init__.py0000644000175100017510000000223415203313266022531 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .dcxs import DCXS ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/aja/dcxs.py0000644000175100017510000001626515203313266021744 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, strict_range class DCXS(Instrument): """ AJA DCXS-750 or 1500 DC magnetron sputtering power supply with multiple outputs Connection to the device is made through an RS232 serial connection. The communication settings are fixed in the device at 38400, one stopbit, no parity. The device's communication protocol uses single character commands and fixed length replies, both without any terminator. :param adapter: pyvisa resource name of the instrument or adapter instance :param string name: The name of the instrument. :param kwargs: Any valid key-word argument for Instrument """ def __init__(self, adapter, name="AJA DCXS sputtering power supply", **kwargs): super().__init__( adapter, name, includeSCPI=False, write_termination="", read_termination="", asrl={"baud_rate": 38400}, **kwargs ) # here we want to flush the read buffer since the device upon power up sends some '>' # characters. self.adapter.flush_read_buffer() def ask(self, command, query_delay=None, **kwargs): """Write a command to the instrument and return the read response. :param command: Command string to be sent to the instrument. :param query_delay: Delay between writing and reading in seconds. :param \\**kwargs: Keyword arguments passed to the read method. :returns: String returned by the device without read_termination. """ self.write(command) self.wait_for(query_delay) return self.read(**kwargs) def read(self, reply_length=-1, **kwargs): return self.read_bytes(reply_length, **kwargs).decode() id = Instrument.measurement( "?", """Get the power supply type identifier.""", cast=str, values_kwargs={'reply_length': 9}, ) software_version = Instrument.measurement( "z", """Get the software revision of the power supply firmware.""", cast=str, values_kwargs={'reply_length': 5}, ) power = Instrument.measurement( "d", """Measure the actual output power in W.""", cast=int, values_kwargs={'reply_length': 4}, ) voltage = Instrument.measurement( "e", """Measure the output voltage in V.""", cast=int, values_kwargs={'reply_length': 4}, ) current = Instrument.measurement( "f", """Measure the output current in mA.""", cast=int, values_kwargs={'reply_length': 4}, ) remaining_deposition_time_min = Instrument.measurement( "k", """Get the minutes part of remaining deposition time.""", cast=int, values_kwargs={'reply_length': 3}, ) remaining_deposition_time_sec = Instrument.measurement( "l", """Get the seconds part of remaining deposition time.""", cast=int, values_kwargs={'reply_length': 2}, ) fault_code = Instrument.measurement( "o", """Get the error code from the power supply.""", values_kwargs={'reply_length': 1}, ) shutter_state = Instrument.measurement( "p", """Get the status of the gun shutters. 0 for closed and 1 for open shutters.""", values_kwargs={'reply_length': 1}, cast=lambda x: int.from_bytes(x.encode(), "big"), get_process=lambda x: [x & 1, x & 2, x & 4, x & 8, x & 16], ) enabled = Instrument.control( "a", "%s", """Control the on/off state of the power supply""", values_kwargs={'reply_length': 1}, validator=strict_discrete_set, map_values=True, cast=int, get_process=lambda c: "A" if c == 1 else "B", values={True: "A", False: "B"}, ) setpoint = Instrument.control( "b", "C%04d", """Control the setpoint value. Units are determined by regulation mode (power -> W, voltage -> V, current -> mA).""", values_kwargs={'reply_length': 4}, validator=strict_range, map_values=True, values=range(0, 1001), ) regulation_mode = Instrument.control( "c", "D%d", """Control the regulation mode of the power supply.""", values_kwargs={'reply_length': 1}, validator=strict_discrete_set, map_values=True, values={"power": 0, "voltage": 1, "current": 2, }, ) ramp_time = Instrument.control( "g", "E%02d", """Control the ramp time in seconds. Can be set only when 'enabled' is False.""", values_kwargs={'reply_length': 2}, cast=int, validator=strict_range, values=range(100), ) shutter_delay = Instrument.control( "h", "F%02d", """Control the shutter delay in seconds. Can be set only when 'enabled' is False.""", values_kwargs={'reply_length': 2}, cast=int, validator=strict_range, values=range(100), ) deposition_time_min = Instrument.control( "i", "G%03d", """Control the minutes part of deposition time. Can be set only when 'enabled' is False.""", values_kwargs={'reply_length': 3}, cast=int, validator=strict_range, values=range(1000), ) deposition_time_sec = Instrument.control( "j", "H%02d", """Control the seconds part of deposition time. Can be set only when 'enabled' is False.""", values_kwargs={'reply_length': 2}, cast=int, validator=strict_range, values=range(60), ) material = Instrument.control( "n", "I%08s", """Control the material name of the sputter target.""", cast=str, values_kwargs={'reply_length': 8}, validator=lambda value, maxlength: value[:maxlength], values=8, ) active_gun = Instrument.control( "y", "Z%d", """Control the active gun number.""", cast=int, values_kwargs={'reply_length': 1}, validator=strict_range, values=range(1, 6), ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0135813 pymeasure-0.16.0/pymeasure/instruments/ametek/0000755000175100017510000000000015203313301021120 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ametek/__init__.py0000644000175100017510000000225015203313266023242 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .ametek7270 import Ametek7270 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ametek/ametek7270.py0000644000175100017510000002637615203313266023310 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import modular_range, truncated_discrete_set, truncated_range import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def check_read_not_empty(value): """Called by some properties to check if the reply is not an empty string that would mean the properties is currently invalid (probably because the reference mode is on single or dual)""" if value == '': raise ValueError('Invalid response from measurement call, ' 'probably because the reference mode is set on single or dual') else: return value class Ametek7270(SCPIUnknownMixin, Instrument): """This is the class for the Ametek DSP 7270 lockin amplifier In this instrument, some measurements are defined only for specific modes, called Reference modes, see :meth:`set_reference_mode` and will raise errors if called incorrectly """ SENSITIVITIES = [ 0.0, 2.0e-9, 5.0e-9, 10.0e-9, 20.0e-9, 50.0e-9, 100.0e-9, 200.0e-9, 500.0e-9, 1.0e-6, 2.0e-6, 5.0e-6, 10.0e-6, 20.0e-6, 50.0e-6, 100.0e-6, 200.0e-6, 500.0e-6, 1.0e-3, 2.0e-3, 5.0e-3, 10.0e-3, 20.0e-3, 50.0e-3, 100.0e-3, 200.0e-3, 500.0e-3, 1.0 ] SENSITIVITIES_IMODE = {0: SENSITIVITIES, 1: [sen * 1e-6 for sen in SENSITIVITIES], 2: [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 2e-15, 5e-15, 10e-15, 20e-15, 50e-15, 100e-15, 200e-15, 500e-15, 1e-12, 2e-12]} TIME_CONSTANTS = [ 10.0e-6, 20.0e-6, 50.0e-6, 100.0e-6, 200.0e-6, 500.0e-6, 1.0e-3, 2.0e-3, 5.0e-3, 10.0e-3, 20.0e-3, 50.0e-3, 100.0e-3, 200.0e-3, 500.0e-3, 1.0, 2.0, 5.0, 10.0, 20.0, 50.0, 100.0, 200.0, 500.0, 1.0e3, 2.0e3, 5.0e3, 10.0e3, 20.0e3, 50.0e3, 100.0e3 ] sensitivity = Instrument.control( # NOTE: only for IMODE = 1. "SEN", "SEN %d", """Control the sensitivity range in Volts (float truncated to values from 2 nV to 1 V).""", validator=truncated_discrete_set, values=SENSITIVITIES, map_values=True, check_set_errors=True, dynamic=True, ) slope = Instrument.control( "SLOPE", "SLOPE %d", """Control the filter slope in dB/octave (integer truncated to values 6, 12, 18, 24).""", validator=truncated_discrete_set, values=[6, 12, 18, 24], map_values=True, check_set_errors=True, ) time_constant = Instrument.control( # NOTE: only for NOISEMODE = 0 "TC", "TC %d", """Control the time constant in seconds (float truncated to values from 10 microseconds to 100,000 seconds).""", validator=truncated_discrete_set, values=TIME_CONSTANTS, map_values=True, check_set_errors=True, ) x = Instrument.measurement( "X.", """Get X value in Volts (float).""", get_process=check_read_not_empty, ) y = Instrument.measurement( "Y.", """Get Y value in Volts (float).""", get_process=check_read_not_empty, ) x1 = Instrument.measurement( "X1.", """Get first harmonic X value in Volts (float).""", get_process=check_read_not_empty, ) y1 = Instrument.measurement( "Y1.", """Get first harmonic Y value in Volts (float).""", get_process=check_read_not_empty, ) x2 = Instrument.measurement( "X2.", """Get second harmonic X value in Volts (float).""", get_process=check_read_not_empty, ) y2 = Instrument.measurement( "Y2.", """Get second harmonic Y value in Volts (float).""", get_process=check_read_not_empty, ) xy = Instrument.measurement( "XY.", """Get both X and Y values in Volts (float, tuple).""", get_process=check_read_not_empty, ) mag = Instrument.measurement( "MAG.", """Get magnitude in Volts (float).""", get_process=check_read_not_empty, ) theta = Instrument.measurement( "PHA.", """Get signal phase in degrees (float).""", get_process=check_read_not_empty, ) harmonic = Instrument.control( "REFN", "REFN %d", """Control the reference harmonic mode (integer truncated to values from 1 to 127).""", validator=truncated_discrete_set, values=list(range(1, 128)), check_set_errors=True, ) phase = Instrument.control( "REFP.", "REFP. %g", """Control the reference harmonic phase in degrees (float, modular_range, values from 0 to 360).""", validator=modular_range, values=[0, 360], check_set_errors=True, ) voltage = Instrument.control( "OA.", "OA. %g", """Control the voltage in Volts (float, truncated_range, values from 0 to 5).""", validator=truncated_range, values=[0, 5], check_set_errors=True, ) frequency = Instrument.control( "OF.", "OF. %g", """Control the lock-in frequency in Hz (float, truncated_range, values from 0 to 2.5e5).""", validator=truncated_range, values=[0, 2.5e5], check_set_errors=True, ) dac1 = Instrument.control( "DAC. 1", "DAC. 1 %g", """Control the output value on DAC1 in Volts (float truncated to values from -10 to 10).""", validator=truncated_range, values=[-10, 10], check_set_errors=True, ) dac2 = Instrument.control( "DAC. 2", "DAC. 2 %g", """Control the output value on DAC2 in Volts (float truncated to values from -10 to 10).""", validator=truncated_range, values=[-10, 10], check_set_errors=True, ) dac3 = Instrument.control( "DAC. 3", "DAC. 3 %g", """Control the output value on DAC3 in Volts (float truncated to values from -10 to 10).""", validator=truncated_range, values=[-10, 10], check_set_errors=True, ) dac4 = Instrument.control( "DAC. 4", "DAC. 4 %g", """Control the output value on DAC4 in Volts (float truncated to values from -10 to 10).""", validator=truncated_range, values=[-10, 10], check_set_errors=True, ) adc1 = Instrument.measurement( "ADC. 1", """Get the input value of ADC1 in Volts (float).""", get_process=check_read_not_empty, ) adc2 = Instrument.measurement( "ADC. 2", """Get the input value of ADC2 in Volts (float).""", get_process=check_read_not_empty, ) adc3 = Instrument.measurement( "ADC. 3", """Get the input value of ADC3 in Volts (float).""", get_process=check_read_not_empty, ) adc4 = Instrument.measurement( "ADC. 4", """Get the input value of ADC4 in Volts (float).""", get_process=check_read_not_empty, ) def __init__(self, adapter, name="Ametek DSP 7270", read_termination='\x00', write_termination='\x00', **kwargs): super().__init__( adapter, name, read_termination=read_termination, write_termination=write_termination, **kwargs) def check_set_errors(self): """mandatory to be used for property setter The Ametek protocol expect the default null character to be read to check the property has been correctly set. With default termination character set as Null character, this turns out as an empty string to be read. """ if self.read() == '': return [] else: return ['Incorrect return from previously set property'] def ask(self, command, query_delay=None): """Send a command and read the response, stripping white spaces. Usually the properties use the :meth:`~pymeasure.instruments.common_base.CommonBase.values` method that adds a strip call, however several methods use directly the result from ask to be cast into some other types. It should therefore also add the strip here, as all responses end with a newline character. """ return super().ask(command, query_delay).strip() def set_reference_mode(self, mode: int = 0): """Set the instrument in Single, Dual or harmonic mode. :param mode: the integer specifying the mode: 0 for Single, 1 for Dual harmonic, and 2 for Dual reference. """ if mode not in [0, 1, 2]: raise ValueError('Invalid reference mode') self.ask(f'REFMODE {mode}') def set_voltage_mode(self): """ Sets instrument to voltage control mode """ self.ask("IMODE 0") self.sensitivity_values = self.SENSITIVITIES_IMODE[0] def set_differential_mode(self, lineFiltering=True): """ Sets instrument to differential mode -- assuming it is in voltage mode """ self.ask("VMODE 3") self.ask("LF %d 0" % 3 if lineFiltering else 0) def set_current_mode(self, low_noise=False): """ Sets instrument to current control mode with either low noise or high bandwidth""" if low_noise: self.ask("IMODE 2") self.sensitivity_values = self.SENSITIVITIES_IMODE[2] else: self.ask("IMODE 1") self.sensitivity_values = self.SENSITIVITIES_IMODE[1] def set_channel_A_mode(self): """ Sets instrument to channel A mode -- assuming it is in voltage mode """ self.ask("VMODE 1") @property def id(self): """Get the instrument ID and firmware version""" return f"{self.ask('ID')}/{self.ask('VER')}" @property def auto_gain(self): """Control whether automatic gain is enabled (bool).""" return int(self.ask("AUTOMATIC")) == 1 @auto_gain.setter def auto_gain(self, setval): if setval: self.ask("AUTOMATIC 1") else: self.ask("AUTOMATIC 0") def shutdown(self): """ Ensures the instrument in a safe state """ log.info("Shutting down %s" % self.name) self.voltage = 0. super().shutdown() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0139046 pymeasure-0.16.0/pymeasure/instruments/ami/0000755000175100017510000000000015203313301020420 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ami/__init__.py0000644000175100017510000000224015203313266022541 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .ami430 import AMI430 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ami/ami430.py0000644000175100017510000001636615203313266022015 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin from time import sleep, time import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class AMI430(SCPIMixin, Instrument): """ Represents the AMI 430 Power supply and provides a high-level for interacting with the instrument. .. code-block:: python magnet = AMI430("TCPIP::web.address.com::7180::SOCKET") magnet.coilconst = 1.182 # kGauss/A magnet.voltage_limit = 2.2 # Sets the voltage limit in V magnet.target_current = 10 # Sets the target current to 10 A magnet.target_field = 1 # Sets target field to 1 kGauss magnet.ramp_rate_current = 0.0357 # Sets the ramp rate in A/s magnet.ramp_rate_field = 0.0422 # Sets the ramp rate in kGauss/s magnet.ramp # Initiates the ramping magnet.pause # Pauses the ramping magnet.status # Returns the status of the magnet magnet.ramp_to_current(5) # Ramps the current to 5 A magnet.shutdown() # Ramps the current to zero and disables output """ def __init__(self, adapter, name="AMI superconducting magnet power supply.", **kwargs): kwargs.setdefault('read_termination', '\n') super().__init__( adapter, name, **kwargs ) # Read twice in order to remove welcome/connect message self.read() self.read() maximumfield = 1.00 maximumcurrent = 50.63 coilconst = Instrument.control( "COIL?", "CONF:COIL %g", """Control the coil constant in kGauss/A. (float)""" ) voltage_limit = Instrument.control( "VOLT:LIM?", "CONF:VOLT:LIM %g", """Control the voltage limit for charging/discharging the magnet. (float)""" ) target_current = Instrument.control( "CURR:TARG?", "CONF:CURR:TARG %g", """Control the target current in A for the magnet. (float)""" ) target_field = Instrument.control( "FIELD:TARG?", "CONF:FIELD:TARG %g", """Control the target field in kGauss for the magnet. (float)""" ) ramp_rate_current = Instrument.control( "RAMP:RATE:CURR:1?", "CONF:RAMP:RATE:CURR 1,%g", """Control the current ramping rate in A/s. (float)""" ) ramp_rate_field = Instrument.control( "RAMP:RATE:FIELD:1?", "CONF:RAMP:RATE:FIELD 1,%g,1.00", """Control the field ramping rate in kGauss/s. (float)""" ) magnet_current = Instrument.measurement("CURR:MAG?", """Get the current in Amps of the magnet. """ ) supply_current = Instrument.measurement("CURR:SUPP?", """Get the current in Amps of the power supply. """ ) field = Instrument.measurement("FIELD:MAG?", """Get the field in kGauss of the magnet. """ ) state = Instrument.measurement("STATE?", """Get the field in kGauss of the magnet. """ ) def zero(self): """ Initiates the ramping of the magnetic field to zero current/field with ramping rate previously set. """ self.write("ZERO") def pause(self): """ Pauses the ramping of the magnetic field. """ self.write("PAUSE") def ramp(self): """ Initiates the ramping of the magnetic field to set current/field with ramping rate previously set. """ self.write("RAMP") def has_persistent_switch_enabled(self): """ Returns a boolean if the persistent switch is enabled. """ return bool(self.ask("PSwitch?")) def enable_persistent_switch(self): """ Enables the persistent switch. """ self.write("PSwitch 1") def disable_persistent_switch(self): """ Disables the persistent switch. """ self.write("PSwitch 0") @property def magnet_status(self): """Get the magnet status.""" STATES = { 1: "RAMPING", 2: "HOLDING", 3: "PAUSED", 4: "Ramping in MANUAL UP", 5: "Ramping in MANUAL DOWN", 6: "ZEROING CURRENT in progress", 7: "QUENCH!!!", 8: "AT ZERO CURRENT", 9: "Heating Persistent Switch", 10: "Cooling Persistent Switch" } return STATES[self.state] def ramp_to_current(self, current, rate): """ Heats up the persistent switch and ramps the current with set ramp rate. """ self.enable_persistent_switch() self.target_current = current self.ramp_rate_current = rate self.wait_for_holding() self.ramp() def ramp_to_field(self, field, rate): """ Heats up the persistent switch and ramps the current with set ramp rate. """ self.enable_persistent_switch() self.target_field = field self.ramp_rate_field = rate self.wait_for_holding() self.ramp() def wait_for_holding(self, should_stop=lambda: False, timeout=800, interval=0.1): """ """ t = time() while self.state != 2 and self.state != 3 and self.state != 8: sleep(interval) if should_stop(): return if (time() - t) > timeout: raise Exception("Timed out waiting for AMI430 switch to warm up.") def shutdown(self, ramp_rate=0.0357): """ Turns on the persistent switch, ramps down the current to zero, and turns off the persistent switch. """ self.enable_persistent_switch() self.wait_for_holding() self.ramp_rate_current = ramp_rate self.zero() self.wait_for_holding() self.disable_persistent_switch() super().shutdown() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0142047 pymeasure-0.16.0/pymeasure/instruments/anaheimautomation/0000755000175100017510000000000015203313301023355 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anaheimautomation/__init__.py0000644000175100017510000000230215203313266025475 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .dpseriesmotorcontroller import DPSeriesMotorController ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anaheimautomation/dpseriesmotorcontroller.py0000644000175100017510000003217415203313266030753 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from time import sleep from enum import IntFlag from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range, truncated_range, strict_discrete_set log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class DPSeriesErrors(IntFlag): """ IntFlag type to decode error register queries. Error codes are as follows: 0: no error 1: Receive Overflow Error: serial communications had a receiving error. 2: Encoder Error 1: encoder needed to correct the motor position. 4: Encoder Error 2: encoder could not finish motor position correction. 8: Command Error: a bad command was sent to the controller. 16: Motor Error: motor speed profiles are set incorrectly. 32: Range Overflow Error: go to position has an overflow error. 64: Range Error: invalid number of commands and characters sent to the controller. 128: Transmit Error: Too many parameters sent back to the pc. 256: Mode Error: Controller is in a wrong mode. 512: Zero Parameters Error: Command sent to the controller that expected to see parameters follow, but none were given. 1024: Busy Error: The controller is busy indexing (moving a motor). 2048: Memory Range Error: Specified address is out of range. 4096: Memory Command Error: Command pulled from memory is invalid. 8192: Thumbwheel Read Error: Error reading the thumbwheel, or thumbwheel is not present. """ NO_ERR = 0 RCV_OVERFLOW_ERR = 1 ENC_ERR_1 = 2 ENC_ERR_2 = 4 CMD_ERR = 8 MOT_ERR = 16 RANGE_OVERFLOW_ERR = 32 RANGE_ERR = 64 TX_ERR = 128 MODE_ERR = 256 ZERO_PARAMS_ERR = 512 BUSY_ERR = 1024 MEM_RANGE_ERR = 2048 MEM_CMD_ERR = 4096 THBWHEEL_ERR = 8192 class DPSeriesMotorController(Instrument): """Base class to interface with Anaheim Automation DP series stepper motor controllers. This driver has been tested with the DPY50601 and DPE25601 motor controllers. """ address = Instrument.control( "%", "~%i", """Integer property representing the address that the motor controller uses for serial communications.""", validator=strict_range, values=[0, 99], cast=int, ) basespeed = Instrument.control( "VB", "B%i", """Integer property that represents the motor controller's starting/homing speed. This property can be set.""", validator=truncated_range, values=[1, 5000], cast=int, ) maxspeed = Instrument.control( "VM", "M%i", """Integer property that represents the motor controller's maximum (running) speed. This property can be set.""", validator=truncated_range, values=[1, 50000], cast=int, ) direction = Instrument.control( "V+", "%s", """A string property that represents the direction in which the stepper motor will rotate upon subsequent step commands. This property can be set. 'CW' corresponds to clockwise rotation and 'CCW' corresponds to counter-clockwise rotation.""", map_values=True, validator=strict_discrete_set, values={"CW": "+", "CCW": "-"}, get_process=lambda d: "+" if d == 1.0 else "-", ) encoder_autocorrect = Instrument.control( "VEA", "EA%i", """A boolean property to enable or disable the encoder auto correct function. This property can be set.""", map_values=True, values={True: 1, False: 0}, validator=strict_discrete_set, cast=int, ) encoder_delay = Instrument.control( "VED", "ED%i", """An integer property that represents the wait time in ms. after a move is finished before the encoder is read for a potential encoder auto-correct action to take place. This property can be set.""", validator=truncated_range, values=[0, 65535], cast=int, ) encoder_motor_ratio = Instrument.control( "VEM", "EM%i", """An integer property that represents the ratio of the number of encoder pulses per motor step. This property can be set.""", validator=truncated_range, values=[1, 255], cast=int, ) encoder_retries = Instrument.control( "VER", "ER%i", """An integer property that represents the number of times the motor controller will try the encoder auto correct function before setting an error flag. This property can be set.""", validator=truncated_range, values=[0, 255], cast=int, ) encoder_window = Instrument.control( "VEW", "EW%i", """An integer property that represents the allowable error in encoder pulses from the desired position before the encoder auto-correct function runs. This property can be set. """, validator=truncated_range, values=[0, 255], cast=int, ) busy = Instrument.measurement( "VF", """Query to see if the controller is currently moving a motor.""" ) error_reg = Instrument.measurement( "!", """Reads the current value of the error codes register.""", get_process=lambda err: DPSeriesErrors(int(err)), ) def check_errors(self): """ Method to read the error codes register and log when an error is detected. :return error_code: one byte with the error codes register contents """ current_errors = self.error_reg if current_errors != 0: logging.error("DP-Series motor controller error detected: %s" % current_errors) return current_errors def __init__(self, adapter, name="Anaheim Automation Stepper Motor Controller", address=0, encoder_enabled=False, **kwargs): """ Initialize communication with the motor controller with the address given by `address`. In addition to the keyword arguments that can be set for the Instrument base class, this class has the following kwargs: :param address: (int) Address that the motor controller uses for serial communiation. :param encoder_enabled: (bool) Flag to indicate if the driver should use an encoder input to set its position property. """ self._address = address self._encoder_enabled = encoder_enabled kwargs.setdefault('write_termination', '\r') kwargs.setdefault('read_termination', '\r') kwargs.setdefault('timeout', 2000) super().__init__( adapter, name, includeSCPI=False, asrl={'baud_rate': 38400}, **kwargs ) @property def encoder_enabled(self): """ A boolean property to represent whether an external encoder is connected and should be used to set the :attr:`step_position` property. """ return self._encoder_enabled @encoder_enabled.setter def encoder_enabled(self, en): self._encoder_enabled = bool(en) @property def step_position(self): """ Integer property representing the value of the motor position measured in steps counted by the motor controller or, if :attr:`encoder_enabled` is set, the steps counted by an externally connected encoder. Note that in the DP series motor controller instrument manuals, this property would be referred to as the 'absolute position' while this driver implements a conversion between steps and absolute units for the :attr:`absolute_position` property. This property can be set. """ if self._encoder_enabled: pos = self.ask("VEP") else: pos = self.ask("VZ") return int(pos) @step_position.setter def step_position(self, pos): strict_range(pos, (-8388607, 8388607)) self.write("P%i" % pos) self.write("G") @property def absolute_position(self): """ Float property representing the value of the motor position measured in absolute units. Note that in DP series motor controller instrument manuals, 'absolute position' refers to the :attr:`step_position` property rather than this property. Also note that use of this property relies on :meth:`steps_to_absolute()` and :meth:`absolute_to_steps()` being implemented in a subclass. In this way, the user can define the conversion from a motor step position into any desired absolute unit. Absolute units could be the position in meters of a linear stage or the angular position of a gimbal mount, etc. This property can be set. """ step_pos = self.step_position return self.steps_to_absolute(step_pos) @absolute_position.setter def absolute_position(self, abs_pos): steps_pos = self.absolute_to_steps(abs_pos) self.step_position = steps_pos def absolute_to_steps(self, pos): """ Convert an absolute position to a number of steps to move. This must be implemented in subclasses. :param pos: Absolute position in the units determined by the subclassed :meth:`absolute_to_steps()` method. """ raise NotImplementedError("absolute_to_steps() must be implemented in subclasses!") def steps_to_absolute(self, steps): """ Convert a position measured in steps to an absolute position. :param steps: Position in steps to be converted to an absolute position. """ raise NotImplementedError("steps_to_absolute() must be implemented in subclasses!") def reset_position(self): """ Reset position as counted by the motor controller and an externally connected encoder to 0. """ # reset encoder recorded position # self.write("ET") # reset motor recorded position # self.write("Z0") def stop(self): """Method that stops all motion on the motor controller.""" self.write(".") def move(self, direction): """ Move the stepper motor continuously in the given direction until a stop command is sent or a limit switch is reached. This method corresponds to the 'slew' command in the DP series instrument manuals. :param direction: value to set on the direction property before moving the motor. """ self.direction = direction self.write("S") def home(self, home_mode): """ Send command to the motor controller to 'home' the motor. :param home_mode: ``0`` or ``1`` specifying which homing mode to run. 0 will perform a homing operation where the controller moves the motor until a soft limit is reached, then will ramp down to base speed and continue motion until a home limit is reached. In mode 1, the controller will move the motor until a limit is reached, then will ramp down to base speed, change direction, and run until the limit is released. """ hm = int(home_mode) if hm == 0 or hm == 1: self.write("H%i" % hm) else: raise ValueError("Invalid home mode %i specified!" % hm) def write(self, command): """Override the instrument base write method to add the motor controller's address to the command string. :param command: command string to be sent to the motor controller. """ # check if @ was already prepended when using say, the SerialAdapter # if "@" in command: cmd_str = command elif "%" in command or "~" in command: cmd_str = "@%s" % command else: cmd_str = "@%i%s" % (self._address, command) super().write(cmd_str) def wait_for_completion(self, interval=0.5): """ Block until the controller is not "busy" (i.e. block until the motor is no longer moving.) :param interval: (float) seconds between queries to the "busy" flag. :return: None """ # noqa: E501 while self.busy: sleep(interval) ././@PaxHeader0000000000000000000000000000003200000000000010210 xustar0026 mtime=1779275457.01452 pymeasure-0.16.0/pymeasure/instruments/anapico/0000755000175100017510000000000015203313301021264 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anapico/__init__.py0000644000175100017510000000224415203313266023411 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .apsin12G import APSIN12G ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anapico/apsin12G.py0000644000175100017510000000546015203313266023241 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_range, strict_discrete_set class APSIN12G(SCPIUnknownMixin, Instrument): """ Represents the Anapico APSIN12G Signal Generator with option 9K, HP and GPIB. """ FREQ_LIMIT = [9e3, 12e9] POW_LIMIT = [-30, 27] def __init__(self, adapter, name="Anapico APSIN12G Signal Generator", **kwargs): super().__init__( adapter, name, **kwargs ) power = Instrument.control( "SOUR:POW:LEV:IMM:AMPL?;", "SOUR:POW:LEV:IMM:AMPL %gdBm;", """Control the output power in dBm. (float)""", validator=strict_range, values=POW_LIMIT ) frequency = Instrument.control( "SOUR:FREQ:CW?;", "SOUR:FREQ:CW %eHz;", """Control the output frequency in Hz. (float)""", validator=strict_range, values=FREQ_LIMIT ) blanking = Instrument.control( ":OUTP:BLAN:STAT?", ":OUTP:BLAN:STAT %s", """Control the blanking of output power when frequency is changed. ON makes the output to be blanked (off) while changing frequency. """, validator=strict_discrete_set, values=['ON', 'OFF'] ) reference_output = Instrument.control( "SOUR:ROSC:OUTP:STAT?", "SOUR:ROSC:OUTP:STAT %s", """Control the 10MHz reference output from the synth. (str)""", validator=strict_discrete_set, values=['ON', 'OFF'] ) def enable_rf(self): """ Enables the RF output. """ self.write("OUTP:STAT 1") def disable_rf(self): """ Disables the RF output. """ self.write("OUTP:STAT 0") ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0149724 pymeasure-0.16.0/pymeasure/instruments/andeenhagerling/0000755000175100017510000000000015203313301022765 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/andeenhagerling/__init__.py0000644000175100017510000000227715203313266025120 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .ah2500a import AH2500A from .ah2700a import AH2700A ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/andeenhagerling/ah2500a.py0000644000175100017510000001112115203313266024405 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import math import re import logging from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range log = logging.getLogger(__name__) class AH2500A(Instrument): """ Andeen Hagerling 2500A Precision Capacitance Bridge implementation """ # regular expression to extract measurement values _reclv = re.compile( r"[FHZ0-9.=\s]*C=\s*(-?[0-9.]+)\s*PF L=\s*(-?[0-9.]+)\s*NS V=\s*(-?[0-9.]+)\s*V") _renumeric = re.compile(r'[-+]?(\d*\.?\d+)') def __init__(self, adapter, name=None, timeout=3000, write_termination="\n", read_termination="\n", **kwargs): super().__init__( adapter, name or "Andeen Hagerling 2500A Precision Capacitance Bridge", write_termination=write_termination, read_termination=read_termination, timeout=timeout, includeSCPI=False, **kwargs ) self._triggered = False config = Instrument.measurement( "SHOW", """Get the configuration.""", ) caplossvolt = Instrument.measurement( "Q", """Get the result of a single capacitance, loss measurement and return the values in units of pF and nS. The used measurement voltage is returned as third value.""", # lambda function is needed here since AH2500A is otherwise undefined get_process=lambda v: AH2500A._parse_reply(v), ) vhighest = Instrument.control( "SH V", "V %.4f", """Control maximum RMS value of the used measurement voltage. Values of up to 15 V are allowed. The device will select the best suiting range below the given value.""", validator=strict_range, values=[0, 15], # typical replies: "VOLTAGE HIGHEST= 15.0 V" or # "VOLTAGE HIGHEST 1.00 V" get_process=lambda v: float(AH2500A._renumeric.search(v).group(0)), ) @classmethod def _parse_reply(cls, string): """ parse reply string from Andeen Hagerling capacitance bridges. :param string: reply string from the instrument. This commonly is: 2500A: "C= 1.234567 PF L= 0.000014 NS V= 0.750 V" 2700A: "F= 1000.00 HZ C= 4.20188 PF L=-0.0260 NS V= 15.0 V" :returns: tuple with C, L, V values """ m = cls._reclv.match(string) if m is not None: values = tuple(map(float, m.groups())) return values # if an invalid string is returned ('EXCESS NOISE') if string.strip() == "EXCESS NOISE": log.warning("Excess noise, check your experiment setup") return (math.nan, math.nan, math.nan) else: # some unknown return string (e.g. misconfigured units) raise Exception(f'Returned string "{string}" could not be parsed') def trigger(self): """ Triggers a new measurement without blocking and waiting for the return value. """ self.write("TRG") self._triggered = True def triggered_caplossvolt(self): """ reads the measurement value after the device was triggered by the trigger function. """ if not self._triggered: log.warning( "Device not triggered, trigger manually for better timing") self.trigger() self._triggered = False return AH2500A._parse_reply(self.read()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/andeenhagerling/ah2700a.py0000644000175100017510000000505415203313266024417 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range from .ah2500a import AH2500A class AH2700A(AH2500A): """ Andeen Hagerling 2700A Precision Capacitance Bridge implementation """ def __init__(self, adapter, name="Andeen Hagerling 2700A Precision Capacitance Bridge", timeout=5000, **kwargs): super().__init__( adapter, name=name, timeout=timeout, **kwargs ) id = Instrument.measurement( "*IDN?", """Get the instrument identification """ ) config = Instrument.measurement( "SHOW ALL", """Get the configuration """, ) frequency = Instrument.control( "SH FR", "FR %.1f", """Control test frequency used for the measurements. Allowed are values between 50 and 20000 Hz. The device selects the closest possible frequency to the given value.""", validator=strict_range, values=[50, 20000], # typical reply: "FREQUENCY 1200.0 Hz" get_process=lambda v: float(AH2500A._renumeric.search(v).group(0)), ) def reset(self): """ Resets the instrument. """ self.write("*RST") def trigger(self): """ Triggers a new measurement without blocking and waiting for the return value. """ self.write("*TRG") self._triggered = True ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0159056 pymeasure-0.16.0/pymeasure/instruments/anritsu/0000755000175100017510000000000015203313301021337 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/__init__.py0000644000175100017510000000264215203313266023466 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .anritsuMG3692C import AnritsuMG3692C from .anritsuMS9710C import AnritsuMS9710C from .anritsuMS9740A import AnritsuMS9740A from .anritsuMS2090A import AnritsuMS2090A from .anritsuMS464xB import AnritsuMS464xB, AnritsuMS4642B, AnritsuMS4644B, \ AnritsuMS4645B, AnritsuMS4647B ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/anritsuMG3692C.py0000644000175100017510000000476115203313266024273 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin class AnritsuMG3692C(SCPIUnknownMixin, Instrument): """ Represents the Anritsu MG3692C Signal Generator """ power = Instrument.control( ":POWER?;", ":POWER %g dBm;", """Control the output power in dBm. (float))""" ) frequency = Instrument.control( ":FREQUENCY?;", ":FREQUENCY %e Hz;", """Control the output frequency in Hz. This property can be set. (float)""" ) def __init__(self, adapter, name="Anritsu MG3692C Signal Generator", **kwargs): super().__init__( adapter, name, **kwargs ) @property def output(self): """Control the signal output state. (bool)""" return int(self.ask(":OUTPUT?")) == 1 @output.setter def output(self, value): if value: self.write(":OUTPUT ON;") else: self.write(":OUTPUT OFF;") def enable(self): """ Enables the signal output. """ self.output = True def disable(self): """ Disables the signal output. """ self.output = False def shutdown(self): """ Shuts down the instrument, putting it in a safe state. """ # TODO: Implement modulation self.modulation = False self.disable() super().shutdown() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/anritsuMS2090A.py0000644000175100017510000003455215203313266024275 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.validators import ( strict_discrete_set, truncated_range, strict_range, ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class AnritsuMS2090A(SCPIMixin, Instrument): """Anritsu MS2090A Handheld Spectrum Analyzer.""" def __init__(self, adapter, name="Anritsu MS2090A Handheld Spectrum Analyzer", **kwargs): self.analysis_mode = None super().__init__( adapter, name, **kwargs) ############# # Mappings # ############# ONOFF = {True: 'ON', False: 'OFF'} OFFFIRSTREPEAT = ['OFF', 'FIRSt', 'REPeat'] SPAMODES = ["SPECtrum", "NRADio", "RTSA", "LTE", "EMFMeter", "PANalyzer"] #################################### # GPS # #################################### gps_full = Instrument.measurement( "FETCh:GPS:FULL?", """ Returns the timestamp, latitude, longitude, altitude, and satellite count of the device. """ ) gps_all = Instrument.measurement( "FETCh:GPS:ALL?", """Returns the fix timestamp, latitude, longitude, altitude and information on the sat used. """ ) gps = Instrument.measurement( ":FETCh:GPS?", """ Returns the timestamp, latitude, and longitude of the device. """ ) gps_last = Instrument.measurement( ":FETCh:GPS:LAST?", """ Returns the timestamp, latitude, longitude, and altitude of the last fixed GPS result. """ ) external_current = Instrument.measurement( "BIAS:EXT:CURR?", """ This command queries the actual bias current in A """ ) #################################### # Spectrum Parameters - Wavelength # #################################### frequency_center = Instrument.control( "FREQuency:CENTer?", "FREQuency:CENTer %g", "Sets the center frequency in Hz", validator=strict_range, values=[9E3, 54E9] ) frequency_offset = Instrument.control( "FREQuency:OFFSet?", "FREQuency:OFFSet %g", "Sets the frequency offset in Hz", validator=strict_range, values=[-10E9, 10E9], ) frequency_span = Instrument.control( "FREQuency:SPAN?", "FREQuency:SPAN %g", "Sets the frequency span in Hz", validator=strict_range, values=[10, 400000000000], ) frequency_span_full = Instrument.setting( "FREQuency:SPAN:FULL", "Sets the frequency span to full span" ) frequency_span_last = Instrument.setting( "FREQuency:SPAN:LAST", "Sets the frequency span to the previous span value." ) frequency_start = Instrument.control( "FREQuency:STARt?", "FREQuency:STARt %g", "Sets the start frequency in Hz", validator=strict_range, values=[9E3, 54E9], ) frequency_step = Instrument.control( ":FREQuency:STEP?", ":FREQuency:STEP %g", "Set or query the step size to gradually increase or decrease frequency values in Hz", validator=strict_range, values=[1E3, 1E9], ) frequency_stop = Instrument.control( "FREQuency:STOP?", "FREQuency:STOP %g", "Sets the start frequency in Hz", validator=strict_range, values=[9E3, 54E9], ) fetch_power = Instrument.measurement( "FET:CHP:CHP?", """ Returns the most recent channel power measurement. """ ) fetch_density = Instrument.measurement( "FET:CHP:DEN?", """ Returns the most recent channel density measurement """ ) fetch_pbch_constellation = Instrument.measurement( "FET:CONS:PBCH", """ Get the latest Physical Broadcast Channel constellation hitmap """ ) fetch_pdsch_constellation = Instrument.measurement( "FET:CONS:PDSC?", """ Get the latest Physical Downlink Shared Channel constellation """ ) fetch_control = Instrument.measurement( "FET:CONT?", """ Returns the Control Channel measurement in json format. """ ) fetch_eirpower = Instrument.measurement( "FET:EIRP?", """ Returns the current EIRP, Max EIRP, Horizontal EIRP, Vertical and Sum EIRP results in dBm. """ ) fetch_eirpower_data = Instrument.measurement( "FET:EIRP:DAT?", """ This command returns the current EIRP measurement result in dBm. """ ) fetch_eirpower_max = Instrument.measurement( "FET:EIRP:MAX?", """ This command returns the Max EIRP measurement result in dBm. """ ) fetch_emf = Instrument.measurement( "FET:EMF?", """ Return the current EMF measurement data. JSON format. """ ) fetch_emf_meter = Instrument.measurement( "FET:EMF:MET?", """ Return the live EMF measurement data. JSON format. """ ) fetch_emf_meter_sample = Instrument.measurement( "FET:EMF:MET:SAM%g?", """ Return the EMF measurement data for a specified sample number. JSON format. """, values=[1, 16], ) fetch_interference_power = Instrument.measurement( "FET:INT:POW?", """ Fetch Interference Finder Integrated Power. """ ) fetch_mimo_antenas = Instrument.measurement( "FET:MIMO:ANT?", """ Returns the sync power measurement in json format. """ ) fetch_ocupied_bw = Instrument.measurement( "FET:OBW%g?", """ Returns the different set of measurement information depending on the suffix. """, values=[1, 2] ) fetch_ota_mapping = Instrument.measurement( "FET:OTA:MAPP?", """ Returns the most recent Coverage Mapping measurement result. """ ) fetch_pan = Instrument.measurement( "FET:PAN?", """ Return the current Pulse Analyzer measurement data. JSON format """ ) fetch_pci = Instrument.measurement( "FET:PCI?", """ Returns PCI measurements """ ) fetch_pdsch = Instrument.measurement( "FET:PDSC?", """ Returns the Data Channel Measurements in JSON format. """ ) fetch_peak = Instrument.measurement( "FET:PEAK?", """ Returns a pair of peak amplitude in current sweep. """ ) fetch_rrm = Instrument.measurement( "FET:RRM?", """ Returns the Radio Resource Management in JSON format. """ ) fetch_scan = Instrument.measurement( "FET:SCAN?", """ Returns the cell scanner measurements in JSON format """ ) fetch_semask = Instrument.measurement( "FET:SEM?", """ This command returns the current Spectral Emission Mask measurement result. """ ) fetch_ssb = Instrument.measurement( "FET:SSB?", """ Returns the SSB measurement """ ) fetch_sync_evm = Instrument.measurement( "FET:SYNC:EVM?", """ Returns the Sync EVM measurement in JSON format. """ ) fetch_sync_power = Instrument.measurement( "FET:SYNC:POW?", """ Returns the sync power measurements in JSON format """ ) fetch_tae = Instrument.measurement( "FET:TAE?", """ Returns the Time Alignment Error in JSON format. """ ) init_continuous = Instrument.control( "INIT:CONT?", "INIT:CONT %g", "Specified whether the sweep/measurement is triggered continuously", values=ONOFF, map_values=True, validator=strict_discrete_set ) init_spa_self = Instrument.measurement( "INIT:SPA:SELF?", docs=""" Perform a self-test and return the results. """ ) active_state = Instrument.control( "INST:ACT:STAT?", "INST:ACT:STAT %g", docs=""" The "set" state indicates that the instrument is used by someone. """, values=ONOFF, map_values=True, validator=strict_discrete_set ) meas_acpower = Instrument.measurement( "MEAS:ACP?", """ Sets the active measurement to adjacent channel power ratio, sets the default measurement parameters, triggers a new measurement and returns the main channel power, lower adjacent, upper adjacent, lower alternate and upper alternate channel power results. """ ) meas_power_all = Instrument.measurement( "MEAS:CHP?", """ Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power and channel power density results. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower? """ ) meas_power = Instrument.measurement( "MEASure:CHPower:CHPower?", """ Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power as the result. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower:CHPower? """ ) power_density = Instrument.measurement( "MEASure:CHPower:DENSity?", """ Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power density as the result. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower:DENSity? """ ) meas_emf_meter_clear_all = Instrument.setting( "MEASure:EMF:METer:CLEar:ALL", """ Clear the EMF measurement data of all samples. Sampling state will be turned off if it was on. """ ) meas_emf_meter_clear_sample = Instrument.setting( "MEASure:EMF:METer:CLEar:SAMPle%g", """ Clear the EMF measurement data for a specified sample number. Sampling state will be turned off if the specified sample is currently active. """, validator=truncated_range, values=[1, 16], ) meas_emf_meter_sample = Instrument.control( "MEASure:EMF:METer:SAMPle:STATe?", "MEASure:EMF:METer:SAMPle:STATe%g", docs=""" Start or Stop applying the measurement results to the currently selected sample """, values=ONOFF, map_values=True, validator=strict_discrete_set ) meas_int_power = Instrument.measurement( "MEASure:INTerference:POWer?", """ Sets the active measurement to interference finder, sets the default measurement parameters, triggers a new measurement and returns integrated power as the result. It is a combination of the commands :CONFigure:INTerference; :READ:INTerference:POWer? """ ) meas_iq_capture = Instrument.setting( "MEASure:IQ:CAPTure", """ This set command is used to start the IQ capture measurement. """ ) meas_iq_capture_fail = Instrument.control( "MEASure:IQ:CAPTure:FAIL?", "MEASure:IQ:CAPTure:FAIL %g", """ Sets or queries whether the instrument will automatically save an IQ capture when losing sync """, values=OFFFIRSTREPEAT ) meas_ota_mapp = Instrument.measurement( "MEASure:OTA:MAPPing?", """ Sets the active measurement to OTA Coverage Mapping, sets the default measurement parameters, triggers a new measurement, and returns the measured values. """ ) meas_ota_run = Instrument.control( "MEASure:OTA:MAPPing:RUN?", "MEASure:OTA:MAPPing:RUN %g", """ Turn on/off OTA Coverage Mapping Data Collection. The instrument must be in Coverage Mapping measurement for the command to be effective """, values=ONOFF, map_values=True, validator=strict_discrete_set ) view_sense_modes = Instrument.measurement( "MODE:CATalog?", """ Returns a list of available modes for the Spa application. The response is a comma-separated list of mode names. See command [:SENSe]:MODE for the mode name specification. """ ) sense_mode = Instrument.control( "MODE?", ":MODE %g", """ Set the operational mode of the Spa app. """, values=SPAMODES, ) preamp = Instrument.control( "POWer:RF:GAIN:STATe?", "POWer:RF:GAIN:STATe %s", """ Sets the state of the preamp. Note that this may cause a change in the reference level and/or attenuation. """, values=ONOFF, map_values=True, validator=strict_discrete_set ) def init_sweep(self): """ Initiate a sweep/measurement. """ self.write("INIT") def init_all_sweep(self): """ Initiate all sweep/measurement. """ self.write('INIT:ALL') def abort(self): """ Initiate a sweep/measurement. """ self.write("ABOR") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/anritsuMS464xB.py0000644000175100017510000010310615203313266024401 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, Channel, SCPIUnknownMixin from pymeasure.instruments.validators import ( strict_discrete_set, strict_range ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class AnritsuMS464xB(SCPIUnknownMixin, Instrument): """ A class representing the Anritsu MS464xB Vector Network Analyzer (VNA) series. This family consists of the MS4642B, MS4644B, MS4645B, and MS4647B, which are represented in their respective classes (:class:`~.AnritsuMS4642B`, :class:`~.AnritsuMS4644B`, :class:`~.AnritsuMS4645B`, :class:`~.AnritsuMS4647B`), that only differ in the available frequency range. They can contain up to 16 instances of :class:`~pymeasure.instruments.anritsu.anritsuMS464xB.MeasurementChannel` (depending on the configuration of the instrument), that are accessible via the `channels` dict or directly via `ch_` + the channel number. :param active_channels: defines the number of active channels (default=16); if active_channels is "auto", the instrument will be queried for the number of active channels. :type active_channels: int (1-16) or str ("auto") :param installed_ports: defines the number of installed ports (default=4); if "auto" is provided, the instrument will be queried for the number of ports :type installed_ports: int (1-4) or str ("auto") :param traces_per_channel: defines the number of traces that is assumed for each channel (between 1 and 16); if not provided, the maximum number is assumed; "auto" is provided, the instrument will be queried for the number of traces of each channel. :type traces_per_channel: int (1-16) or str ("auto") or None """ CHANNELS_MAX = 16 TRACES_MAX = 16 PORTS = 4 TRIGGER_TYPES = ["POIN", "SWE", "CHAN", "ALL"] FREQUENCY_RANGE = [1E7, 7E10] SPARAM_LIST = ["S11", "S12", "S21", "S22", "S13", "S23", "S33", "S31", "S32", "S14", "S24", "S34", "S41", "S42", "S43", "S44", ] DISPLAY_LAYOUTS = ["R1C1", "R1C2", "R2C1", "R1C3", "R3C1", "R2C2C1", "R2C1C2", "C2R2R1", "C2R1R2", "R1C4", "R4C1", "R2C2", "R2C3", "R3C2", "R2C4", "R4C2", "R3C3", "R5C2", "R2C5", "R4C3", "R3C4", "R4C4"] def __init__(self, adapter, name="Anritsu MS464xB Vector Network Analyzer", active_channels=16, installed_ports=4, traces_per_channel=None, **kwargs): super().__init__( adapter, name, timeout=10000, **kwargs, ) self.PORTS = self.number_of_ports if installed_ports == "auto" else installed_ports number_of_channels = None if active_channels == "auto" else active_channels self.update_channels(number_of_channels=number_of_channels, traces=traces_per_channel) def update_channels(self, number_of_channels=None, **kwargs): """Create or remove channels to be correct with the actual number of channels. :param int number_of_channels: optional, if given, defines the desired number of channels. """ if number_of_channels is None: number_of_channels = self.number_of_channels if not hasattr(self, "channels"): self.channels = {} if len(self.channels) == number_of_channels: return # Remove redundant channels while len(self.channels) > number_of_channels: self.remove_child(self.channels[len(self.channels)]) # Create new channels while len(self.channels) < number_of_channels: self.add_child(MeasurementChannel, len(self.channels) + 1, frequency_range=self.FREQUENCY_RANGE, **kwargs) def check_errors(self): """ Read all errors from the instrument. :return: list of error entries """ errors = [] while True: err = self.values("SYST:ERR?") if err[0] != "No Error": log.error(f"{self.name}: {err[0]}") errors.append(err) else: break return errors datablock_header_format = Instrument.control( "FDHX?", "FDH%d", """Control the way the arbitrary block header for output data is formed. Valid values are: ===== =========================================================== value description ===== =========================================================== 0 A block header with arbitrary length will be sent. 1 The block header will have a fixed length of 11 characters. 2 No block header will be sent. Not IEEE 488.2 compliant. ===== =========================================================== """, values=[0, 1, 2], validator=strict_discrete_set, cast=int, ) datafile_frequency_unit = Instrument.control( ":FORM:SNP:FREQ?", ":FORM:SNP:FREQ %s", """Control the frequency unit displayed in a SNP data file. Valid values are HZ, KHZ, MHZ, GHZ. """, values=["HZ", "KHZ", "MHZ", "GHZ"], validator=strict_discrete_set, ) datablock_numeric_format = Instrument.control( ":FORM:DATA?", ":FORM:DATA %s", """Control format for numeric I/O data representation. Valid values are: ===== ========================================================================== value description ===== ========================================================================== ASCII An ASCII number of 20 or 21 characters long with floating point notation. 8byte 8 bytes of binary floating point number representation limited to 64 bits. 4byte 4 bytes of floating point number representation. ===== ========================================================================== """, values={"ASCII": "ASC", "8byte": "REAL", "4byte": "REAL32"}, map_values=True, ) datafile_include_heading = Instrument.control( ":FORM:DATA:HEAD?", ":FORM:DATA:HEAD %d", """Control whether a heading is included in the data files. """, values={True: 1, False: 0}, map_values=True, ) datafile_parameter_format = Instrument.control( ":FORM:SNP:PAR?", ":FORM:SNP:PAR %s", """Control the parameter format displayed in an SNP data file. Valid values are: ===== =========================== value description ===== =========================== LINPH Linear and Phase. LOGPH Log and Phase. REIM Real and Imaginary Numbers. ===== =========================== """, values=["LINPH", "LOGPH", "REIM"], validator=strict_discrete_set, ) data_drawing_enabled = Instrument.control( "DD1?", "DD%d", """Control whether data drawing is enabled (True) or not (False). """, values={True: 1, False: 0}, map_values=True, ) event_status_enable_bits = Instrument.control( "*ESE?", "*ESE %d", """Control the Standard Event Status Enable Register bits. The register can be queried using the :meth:`~.query_event_status_register` method. Valid values are between 0 and 255. Refer to the instrument manual for an explanation of the bits. """, values=[0, 255], validator=strict_range, cast=int, ) def query_event_status_register(self): """ Query the value of the Standard Event Status Register. Note that querying this value, clears the register. Refer to the instrument manual for an explanation of the returned value. """ return self.values("*ESR?", cast=int)[0] service_request_enable_bits = Instrument.control( "*SRE?", "*SRE %d", """Control the Service Request Enable Register bits. Valid values are between 0 and 255; setting 0 performs a register reset. Refer to the instrument manual for an explanation of the bits. """, values=[0, 255], validator=strict_range, cast=int, ) def return_to_local(self): """ Returns the instrument to local operation. """ self.write("RTL") binary_data_byte_order = Instrument.control( ":FORM:BORD?", ":FORM:BORD %s", """Control the binary numeric I/O data byte order. valid values are: ===== ========================================= value description ===== ========================================= NORM The most significant byte (MSB) is first SWAP The least significant byte (LSB) is first ===== ========================================= """, values=["NORM", "SWAP"], validator=strict_discrete_set, ) max_number_of_points = Instrument.control( ":SYST:POIN:MAX?", ":SYST:POIN:MAX %d", """Control the maximum number of points the instrument can measure in a sweep. Note that when this value is changed, the instrument will be rebooted. Valid values are 25000 and 100000. When 25000 points is selected, the instrument supports 16 channels with 16 traces each; when 100000 is selected, the instrument supports 1 channel with 16 traces. """, values=[25000, 100000], validator=strict_discrete_set, cast=int, ) number_of_ports = Instrument.measurement( ":SYST:PORT:COUN?", """Get the number of instrument test ports. """, cast=int, ) number_of_channels = Instrument.control( ":DISP:COUN?", ":DISP:COUN %d", """Control the number of displayed (and therefore accessible) channels. When the system is in 25000 points mode, the number of channels can be 1, 2, 3, 4, 6, 8, 9, 10, 12, or 16; when the system is in 100000 points mode, the system only supports 1 channel. If a value is provided that is not valid in the present mode, the instrument is set to the next higher channel number. """, values=[1, CHANNELS_MAX], validator=strict_range, cast=int, ) display_layout = Instrument.control( ":DISP:SPL?", ":DISP:SPL %s", """Control the channel display layout in a Row-by-Column format. Valid values are: {}. The number following the R indicates the number of rows, following the C the number of columns; e.g. R2C2 results in a 2-by-2 layout. The options that contain two C's or R's result in asymmetric layouts; e.g. R2C1C2 results in a layout with 1 channel on top and two channels side-by-side on the bottom row. """.format(", ".join(DISPLAY_LAYOUTS)), values=DISPLAY_LAYOUTS, validator=strict_discrete_set, cast=str, ) active_channel = Instrument.control( ":DISP:WIND:ACT?", ":DISP:WIND%d:ACT", """Control the active channel. """, values=[1, CHANNELS_MAX], validator=strict_range, cast=int, ) bandwidth_enhancer_enabled = Instrument.control( ":SENS:BAND:ENH?", ":SENS:BAND:ENH %d", """Control the state of the IF bandwidth enhancer. """, values={True: 1, False: 0}, map_values=True, ) trigger_source = Instrument.control( ":TRIG:SOUR?", ":TRIG:SOUR %s", """Control the source of the sweep/measurement triggering. Valid values are: ===== ================================================== value description ===== ================================================== AUTO Automatic triggering MAN Manual triggering EXTT Triggering from rear panel BNC via the GPIB parser EXT External triggering port REM Remote triggering ===== ================================================== """, values=["AUTO", "MAN", "EXTT", "EXT", "REM"], validator=strict_discrete_set, ) external_trigger_type = Instrument.control( ":TRIG:EXT:TYP?", ":TRIG:EXT:TYP %s", """Control the type of trigger that will be associated with the external trigger. Valid values are POIN (for point), SWE (for sweep), CHAN (for channel), and ALL. """, values=TRIGGER_TYPES, validator=strict_discrete_set, ) external_trigger_delay = Instrument.control( ":TRIG:EXT:DEL?", ":TRIG:EXT:DEL %g", """Control the delay time of the external trigger in seconds. Valid values are between 0 [s] and 10 [s] in steps of 1e-9 [s] (i.e. 1 ns). """, values=[0, 10], validator=strict_range, ) external_trigger_edge = Instrument.control( ":TRIG:EXT:EDG?", ":TRIG:EXT:EDG %s", """Control the edge type of the external trigger. Valid values are POS (for positive or leading edge) or NEG (for negative or trailing edge). """, values=["POS", "NEG"], validator=strict_discrete_set, ) external_trigger_handshake = Instrument.control( ":TRIG:EXT:HAND?", ":TRIG:EXT:HAND %s", """Control status of the external trigger handshake. """, values={True: 1, False: 0}, map_values=True, ) remote_trigger_type = Instrument.control( ":TRIG:REM:TYP?", ":TRIG:REM:TYP %s", """Control the type of trigger that will be associated with the remote trigger. Valid values are POIN (for point), SWE (for sweep), CHAN (for channel), and ALL. """, values=TRIGGER_TYPES, validator=strict_discrete_set, ) manual_trigger_type = Instrument.control( ":TRIG:MAN:TYP?", ":TRIG:MAN:TYP %s", """Control the type of trigger that will be associated with the manual trigger. Valid values are POIN (for point), SWE (for sweep), CHAN (for channel), and ALL. """, values=TRIGGER_TYPES, validator=strict_discrete_set, ) def trigger(self): """ Trigger a continuous sweep from the remote interface. """ self.write("*TRG") def trigger_single(self): """ Trigger a single sweep with synchronization from the remote interface. """ self.write(":TRIG:SING") def trigger_continuous(self): """ Trigger a continuous sweep from the remote interface. """ self.write(":TRIG") hold_function_all_channels = Instrument.control( ":SENS:HOLD:FUNC?", ":SENS:HOLD:FUNC %s", """Control the hold function of all channels. Valid values are: ===== ================================================= value description ===== ================================================= CONT Perform continuous sweeps on all channels HOLD Hold the sweep on all channels SING Perform a single sweep and then hold all channels ===== ================================================= """, values=["CONT", "HOLD", "SING"], validator=strict_discrete_set, ) def load_data_file(self, filename): """Load a data file from the VNA HDD into the VNA memory. :param str filename: full filename including path """ self.write(f":MMEM:LOAD '{filename}'") def delete_data_file(self, filename): """Delete a file on the VNA HDD. :param str filename: full filename including path """ self.write(f":MMEM:DEL '{filename}'") def copy_data_file(self, from_filename, to_filename): """Copy a file on the VNA HDD. :param str from_filename: full filename including pat :param str to_filename: full filename including path """ self.write(f":MMEM:COPY '{from_filename}', '{to_filename}'") def load_data_file_to_memory(self, filename): """Load a data file to a memory trace. :param str filename: full filename including path """ self.write(f":MMEM:LOAD:MDATA '{filename}'") def create_directory(self, dir_name): """Create a directory on the VNA HDD. :param str dir_name: directory name """ self.write(f":MMEM:MDIR '{dir_name}'") def delete_directory(self, dir_name): """Delete a directory on the VNA HDD. :param str dir_name: directory name """ self.write(f":MMEM:RDIR '{dir_name}'") def store_image(self, filename): """Capture a screenshot to the file specified. :param str filename: full filename including path """ self.write(f":MMEM:STOR:IMAG '{filename}'") def read_datafile( self, channel, sweep_points, datafile_freq, datafile_par, filename, ): """Read a data file from the VNA. :param int channel: Channel Index :param int sweep_points: number of sweep point as an integer :param DataFileFrequencyUnits datafile_freq: Data file frequency unit :param DataFileParameter datafile_par: Data file parameter format :param str filename: full path of the file to be saved """ cur_ch = self.channels[channel] # type: MeasurementChannel cur_ch.sweep_points = sweep_points self.datafile_frequency_unit = datafile_freq self.datafile_parameter_format = datafile_par self.write("TRS;WFS;OS2P") bytes_to_transfer = int(self.read_bytes(11)[2:11]) data = self.read_bytes(bytes_to_transfer) with open(filename, "w") as textfile: data_list = data.split(b"\r\n") for s in data_list: textfile.write(str(s)[2 : len(s)] + "\n") # noqa class Port(Channel): """Represents a port within a :class:`~pymeasure.instruments.anritsu.anritsuMS464xB.MeasurementChannel` of the Anritsu MS464xB VNA.""" placeholder = "pt" power_level = Channel.control( ":SOUR{{ch}}:POW:PORT{pt}?", ":SOUR{{ch}}:POW:PORT{pt} %g", """Control the power level (in dBm) of the indicated port on the indicated channel. """, values=[-3E1, 3E1], validator=strict_range, ) class Trace(Channel): """Represents a trace within a :class:`~pymeasure.instruments.anritsu.anritsuMS464xB.MeasurementChannel` of the Anritsu MS464xB VNA.""" placeholder = "tr" def activate(self): """ Set the indicated trace as the active one. """ self.write(":CALC{{ch}}:PAR{tr}:SEL") measurement_parameter = Channel.control( ":CALC{{ch}}:PAR{tr}:DEF?", ":CALC{{ch}}:PAR{tr}:DEF %s", """Control the measurement parameter of the indicated trace. Valid values are any S-parameter (e.g. S11, S12, S41) for 4 ports, or one of the following: ===== ================================================================ value description ===== ================================================================ Sxx S-parameters (1-4 for both x) MIX Response Mixed Mode NFIG Noise Figure trace response (only with option 41 or 48) NPOW Noise Power trace response (only with option 41 or 48) NTEMP Noise Temperature trace response (only with option 41 or 48) AGA Noise Figure Available Gain trace response (only with option 48) IGA Noise Figure Insertion Gain trace response (only with option 48) ===== ================================================================ """, values=AnritsuMS464xB.SPARAM_LIST + ["MIX", "NFIG", "NPOW", "NTEMP", "AGA", "IGA"], validator=strict_discrete_set, ) class MeasurementChannel(Channel): """Represents a channel of Anritsu MS464xB VNA. Contains 4 instances of :class:`~.Port` (accessible via the `ports` dict or directly `pt_` + the port number) and up to 16 instances of :class:`~.Trace` (accessible via the `traces` dict or directly `tr_` + the trace number). :param frequency_range: defines the number of installed ports (default=4). :type frequency_range: list of floats :param traces: defines the number of traces that is assumed for the channel (between 1 and 16); if not provided, the maximum number is assumed; "auto" is provided, the instrument will be queried for the number of traces. :type traces: int (1-16) or str ("auto") or None """ def __init__(self, *args, frequency_range=None, traces=None, **kwargs): super().__init__(*args, **kwargs) for pt in range(self.parent.PORTS): self.add_child(Port, pt + 1, collection="ports", prefix="pt_") if traces is None: number_of_traces = self.parent.TRACES_MAX elif traces == "auto": number_of_traces = None else: number_of_traces = traces self.update_traces(number_of_traces) if frequency_range is not None: self.update_frequency_range(frequency_range) def update_frequency_range(self, frequency_range): """Update the values-attribute of the frequency-related dynamic properties. :param list frequency_range: the frequency range that the instrument is capable of. """ self.frequency_start_values = frequency_range self.frequency_stop_values = frequency_range self.frequency_center_values = frequency_range self.frequency_CW_values = frequency_range self.frequency_span_values = [2, frequency_range[1]] def update_traces(self, number_of_traces=None): """Create or remove traces to be correct with the actual number of traces. :param int number_of_traces: optional, if given defines the desired number of traces. """ if number_of_traces is None: number_of_traces = self.number_of_traces if not hasattr(self, "traces"): self.traces = {} if len(self.traces) == number_of_traces: return # Remove redant channels while len(self.traces) > number_of_traces: self.remove_child(self.traces[len(self.traces)]) # Remove create new channels while len(self.traces) < number_of_traces: self.add_child(Trace, len(self.traces) + 1, collection="traces", prefix="tr_") def check_errors(self): return self.parent.check_errors() def activate(self): """ Set the indicated channel as the active channel. """ self.write(":DISP:WIND{ch}:ACT") number_of_traces = Channel.control( ":CALC{ch}:PAR:COUN?", ":CALC{ch}:PAR:COUN %d", """Control the number of traces on the specified channel Valid values are between 1 and 16. """, values=[1, AnritsuMS464xB.TRACES_MAX], validator=strict_range, cast=int, ) active_trace = Channel.setting( ":CALC{ch}:PAR%d:SEL", """Set the active trace on the indicated channel. """, values=[1, AnritsuMS464xB.TRACES_MAX], validator=strict_range, ) display_layout = Channel.control( ":DISP:WIND{ch}:SPL?", ":DISP:WIND{ch}:SPL %s", """Control the trace display layout in a Row-by-Column format for the indicated channel. Valid values are: {}. The number following the R indicates the number of rows, following the C the number of columns; e.g. R2C2 results in a 2-by-2 layout. The options that contain two C's or R's result in asymmetric layouts; e.g. R2C1C2 results in a layout with 1 trace on top and two traces side-by-side on the bottom row. """.format(", ".join(AnritsuMS464xB.DISPLAY_LAYOUTS)), values=AnritsuMS464xB.DISPLAY_LAYOUTS, validator=strict_discrete_set, cast=str, ) application_type = Channel.control( ":CALC{ch}:APPL:MEAS:TYP?", ":CALC{ch}:APPL:MEAS:TYP %s", """Control the application type of the specified channel. Valid values are TRAN (for transmission/reflection), NFIG (for noise figure measurement), PULS (for PulseView). """, values=["TRAN", "NFIG", "PULS"], validator=strict_discrete_set, ) hold_function = Channel.control( ":SENS{ch}:HOLD:FUNC?", ":SENS{ch}:HOLD:FUNC %s", """Control the hold function of the specified channel. valid values are: ===== ================================================= value description ===== ================================================= CONT Perform continuous sweeps on all channels HOLD Hold the sweep on all channels SING Perform a single sweep and then hold all channels ===== ================================================= """, values=["CONT", "HOLD", "SING"], validator=strict_discrete_set, ) cw_mode_enabled = Channel.control( ":SENS{ch}:SWE:CW?", ":SENS{ch}:SWE:CW %d", """Control the state of the CW sweep mode of the indicated channel. """, values={True: 1, False: 0}, map_values=True, ) cw_number_of_points = Channel.control( ":SENS{ch}:SWE:CW:POIN?", ":SENS{ch}:SWE:CW:POIN %g", """Control the CW sweep mode number of points of the indicated channel. Valid values are between 1 and 25000 or 100000 depending on the maximum points setting. """, values=[1, 100000], validator=strict_range, cast=int, ) number_of_points = Channel.control( "SENS{ch}:SWE:POIN?", "SENS{ch}:SWE:POIN %g", """Control the number of measurement points in a frequency sweep of the indicated channel. Valid values are between 1 and 25000 or 100000 depending on the maximum points setting. """, values=[1, 100000], validator=strict_range, cast=int, ) frequency_start = Channel.control( ":SENS{ch}:FREQ:STAR?", ":SENS{ch}:FREQ:STAR %g", """Control the start value of the sweep range of the indicated channel in hertz. Valid values are between 1E7 [Hz] (i.e. 10 MHz) and 4E10 [Hz] (i.e. 40 GHz). """, values=AnritsuMS464xB.FREQUENCY_RANGE, validator=strict_range, dynamic=True, ) frequency_stop = Channel.control( ":SENS{ch}:FREQ:STOP?", ":SENS{ch}:FREQ:STOP %g", """Control the stop value of the sweep range of the indicated channel in hertz. Valid values are between 1E7 [Hz] (i.e. 10 MHz) and 4E10 [Hz] (i.e. 40 GHz). """, values=AnritsuMS464xB.FREQUENCY_RANGE, validator=strict_range, dynamic=True, ) frequency_span = Channel.control( ":SENS{ch}:FREQ:SPAN?", ":SENS{ch}:FREQ:SPAN %g", """Control the span value of the sweep range of the indicated channel in hertz. Valid values are between 2 [Hz] and 4E10 [Hz] (i.e. 40 GHz). """, values=[2, AnritsuMS464xB.FREQUENCY_RANGE[1]], validator=strict_range, dynamic=True, ) frequency_center = Channel.control( ":SENS{ch}:FREQ:CENT?", ":SENS{ch}:FREQ:CENT %g", """Control the center value of the sweep range of the indicated channel in hertz. Valid values are between 1E7 [Hz] (i.e. 10 MHz) and 4E10 [Hz] (i.e. 40 GHz). """, values=AnritsuMS464xB.FREQUENCY_RANGE, validator=strict_range, dynamic=True, ) frequency_CW = Channel.control( ":SENS{ch}:FREQ:CW?", ":SENS{ch}:FREQ:CW %g", """Control the CW frequency of the indicated channel in hertz. Valid values are between 1E7 [Hz] (i.e. 10 MHz) and 4E10 [Hz] (i.e. 40 GHz). """, values=AnritsuMS464xB.FREQUENCY_RANGE, validator=strict_range, dynamic=True, ) def clear_average_count(self): """ Clear and restart the averaging sweep count of the indicated channel. """ self.write(":SENS{ch}:AVER:CLE") average_count = Channel.control( ":SENS{ch}:AVER:COUN?", ":SENS{ch}:AVER:COUN %d", """Control the averaging count for the indicated channel. The channel must be turned on. Valid values are between 1 and 1024. """, values=[1, 1024], validator=strict_range, cast=int, ) average_sweep_count = Channel.measurement( ":SENS{ch}:AVER:SWE?", """Get the averaging sweep count for the indicated channel. """, cast=int, ) average_type = Channel.control( ":SENS{ch}:AVER:TYP?", ":SENS{ch}:AVER:TYP %s", """Control the averaging type to for the indicated channel. Valid values are POIN (point-by-point) or SWE (sweep-by-sweep) """, values=["POIN", "SWE"], validator=strict_discrete_set, ) averaging_enabled = Channel.control( ":SENS{ch}:AVER?", ":SENS{ch}:AVER %d", """Control whether the averaging is turned on for the indicated channel. """, values={True: 1, False: 0}, map_values=True, ) sweep_type = Channel.control( ":SENS{ch}:SWE:TYP?", ":SENS{ch}:SWE:TYP %s", """Control the sweep type of the indicated channel. Valid options are: ===== =============================================================== value description ===== =============================================================== LIN Frequency-based linear sweep LOG Frequency-based logarithmic sweep FSEGM Segment-based sweep with frequency-based segments ISEGM Index-based sweep with frequency-based segments POW Power-based sweep with either a CW frequency or swept-frequency MFGC Multiple frequency gain compression ===== =============================================================== """, validator=strict_discrete_set, values=["LIN", "LOG", "FSEGM", "ISEGM", "POW", "MFGC"], ) sweep_mode = Channel.control( ":SENS{ch}:SA:MODE?", ":SENS{ch}:SA:MODE %s", """Control the sweep mode for Spectrum Analysis on the indicated channel. Valid options are VNA (for a VNA-like mode where the instrument will only measure at points in the frequency list) or CLAS (for a classical mode, where the instrument will scan all frequencies in the range).""", validator=strict_discrete_set, values=["VNA", "CLAS"], ) sweep_time = Channel.control( ":SENS{ch}:SWE:TIM?", ":SENS{ch}:SWE:TIM %d", """Control the sweep time of the indicated channel. Valid values are between 2 and 100000.""", validator=strict_range, values=[2, 100000], ) bandwidth = Channel.control( ":SENS{ch}:BWID?", ":SENS{ch}:BWID %g", """Control the IF bandwidth for the indicated channel. Valid values are between 1 [Hz] and 1E6 [Hz] (i.e. 1 MHz). The system will automatically select the closest IF bandwidth from the available options (1, 3, 10 ... 1E5, 3E5, 1E6). """, values=[1, 1E6], validator=strict_range, ) calibration_enabled = Channel.control( ":SENS{ch}:CORR:STAT?", ":SENS{ch}:CORR:STAT %d", """Control whether the RF correction (calibration) is enabled for indicated channel. """, values={True: 1, False: 0}, map_values=True, ) class AnritsuMS4642B(AnritsuMS464xB): """A class representing the Anritsu MS4642B Vector Network Analyzer (VNA). This VNA has a frequency range from 10 MHz to 20 GHz and is part of the :class:`~.AnritsuMS464xB` family of instruments; for documentation, for documentation refer to this base class. """ FREQUENCY_RANGE = [1E7, 2E10] class AnritsuMS4644B(AnritsuMS464xB): """A class representing the Anritsu MS4644B Vector Network Analyzer (VNA). This VNA has a frequency range from 10 MHz to 40 GHz and is part of the :class:`~.AnritsuMS464xB` family of instruments; for documentation, for documentation refer to this base class. """ FREQUENCY_RANGE = [1E7, 4E10] class AnritsuMS4645B(AnritsuMS464xB): """A class representing the Anritsu MS4645B Vector Network Analyzer (VNA). This VNA has a frequency range from 10 MHz to 50 GHz and is part of the :class:`~.AnritsuMS464xB` family of instruments; for documentation, for documentation refer to this base class. """ FREQUENCY_RANGE = [1E7, 5E10] class AnritsuMS4647B(AnritsuMS464xB): """A class representing the Anritsu MS4647B Vector Network Analyzer (VNA). This VNA has a frequency range from 10 MHz to 70 GHz and is part of the :class:`~.AnritsuMS464xB` family of instruments; for documentation, for documentation refer to this base class. """ FREQUENCY_RANGE = [1E7, 7E10] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/anritsuMS9710C.py0000644000175100017510000002512515203313266024301 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from time import sleep import numpy as np from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import ( strict_discrete_set, truncated_discrete_set, truncated_range, joined_validators ) import re log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) # Analysis Results with Units, ie -24.5DBM -> (-24.5, 'DBM') r_value_units = re.compile(r"([-\d]*\.\d*)(.*)") # Join validators to allow for special sets of characters truncated_range_or_off = joined_validators(strict_discrete_set, truncated_range) def _int_or_neg_one(v): try: return int(v) except ValueError: return -1 def _parse_trace_peak(vals): """Parse the returned value from a trace peak query.""" l, p = vals res = [l] m = r_value_units.match(p) if m is not None: data = list(m.groups()) data[0] = float(data[0]) res.extend(data) else: res.append(float(p)) return res class AnritsuMS9710C(SCPIUnknownMixin, Instrument): """Anritsu MS9710C Optical Spectrum Analyzer.""" def __init__(self, adapter, name="Anritsu MS9710C Optical Spectrum Analyzer", **kwargs): """Constructor.""" self.analysis_mode = None super().__init__(adapter, name=name, **kwargs) ############# # Mappings # ############# ONOFF = ["ON", "OFF"] ONOFF_MAPPING = {True: 'ON', False: 'OFF', 1: 'ON', 0: 'OFF', 'ON': 'ON', 'OFF': 'OFF'} ###################### # Status Registers # ###################### ese2 = Instrument.control( "ESE2?", "ESE2 %d", "Control Extended Event Status Enable Register 2", get_process=int ) esr2 = Instrument.control( "ESR2?", "ESR2 %d", "Control Extended Event Status Register 2", get_process=_int_or_neg_one ) ########### # Modes # ########### measure_mode = Instrument.measurement( "MOD?", "Get the current Measure Mode the OSA is in.", values={None: 0, "SINGLE": 1.0, "AUTO": 2.0, "POWER": 3.0}, map_values=True ) #################################### # Spectrum Parameters - Wavelength # #################################### wavelength_center = Instrument.control( 'CNT?', 'CNT %g', "Control Center Wavelength of Spectrum Scan in nm.") wavelength_span = Instrument.control( 'SPN?', 'SPN %g', "Control Wavelength Span of Spectrum Scan in nm.") wavelength_start = Instrument.control( 'STA?', 'STA %g', "Control Wavelength Start of Spectrum Scan in nm.") wavelength_stop = Instrument.control( 'STO?', 'STO %g', "Control Wavelength Stop of Spectrum Scan in nm.") wavelength_marker_value = Instrument.control( 'MKV?', 'MKV %s', "Control Wavelength Marker Value (wavelength or freq.?)", validator=strict_discrete_set, values=["WL", "FREQ"] ) wavelength_value_in = Instrument.control( 'WDP?', 'WDP %s', "Control Wavelength value in Vacuum or Air", validator=strict_discrete_set, values=["VACUUM", "AIR"] ) level_scale = Instrument.measurement( 'LVS?', "Get Current Level Scale", values=["LOG", "LIN"] ) level_log = Instrument.control( "LOG?", "LOG %f", "Control Level Log Scale (/div)", validator=truncated_range, values=[0.1, 10.0] ) level_lin = Instrument.control( "LIN?", "LIN %f", "Control Level Linear Scale (/div)", validator=truncated_range, values=[1e-12, 1] ) level_opt_attn = Instrument.control( "ATT?", "ATT %s", "Control Optical Attenuation Status (ON/OFF)", validator=strict_discrete_set, values=ONOFF ) resolution = Instrument.control( "RES?", "RES %f", "Control Resolution (nm)", validator=truncated_discrete_set, values=[0.05, 0.07, 0.1, 0.2, 0.5, 1.0] ) resolution_actual = Instrument.control( "ARES?", "ARES %s", "Control Resolution Actual (ON/OFF)", validator=strict_discrete_set, values=ONOFF, map_values=True ) resolution_vbw = Instrument.control( "VBW?", "VBW %s", "Control Video Bandwidth Resolution", validator=strict_discrete_set, values=["1MHz", "100kHz", "10kHz", "1kHz", "100Hz", "10Hz"] ) average_point = Instrument.control( "AVT?", "AVT %d", "Control number of averages to take on each point (2-1000), or OFF", validator=truncated_range_or_off, values=[["OFF"], [2, 1000]] ) average_sweep = Instrument.control( "AVS?", "AVS %d", "Control number of averages to make on a sweep (2-1000) or OFF", validator=truncated_range_or_off, values=[["OFF"], [2, 1000]] ) sampling_points = Instrument.control( "MPT?", "MPT %d", "Control number of sampling points", validator=truncated_discrete_set, values=[51, 101, 251, 501, 1001, 2001, 5001], get_process=lambda v: int(v) ) ##################################### # Analysis Peak Search Parameters # ##################################### peak_search = Instrument.control( "PKS?", "PKS %s", "Control Peak Search Mode", validator=strict_discrete_set, values=["PEAK", "NEXT", "LAST", "LEFT", "RIGHT"] ) dip_search = Instrument.control( "DPS?", "DPS %s", "Control Dip Search Mode", validator=strict_discrete_set, values=["DIP", "NEXT", "LAST", "LEFT", "RIGHT"] ) analysis = Instrument.control( "ANA?", "ANA %s", "Control Analysis Control" ) analysis_result = Instrument.measurement( "ANAR?", "Get anaysis result from current scan." ) ########################## # Data Memory Commands # ########################## data_memory_a_size = Instrument.measurement( 'DBA?', "Get the number of points sampled in data memory register A." ) data_memory_b_size = Instrument.measurement( 'DBB?', "Get the number of points sampled in data memory register B." ) data_memory_a_condition = Instrument.measurement( "DCA?", """Get the data condition of data memory register A. Starting wavelength, and a sampling point (l1, l2, n).""" ) data_memory_b_condition = Instrument.measurement( "DCB?", """Get the data condition of data memory register B. Starting wavelength, and a sampling point (l1, l2, n).""" ) data_memory_a_values = Instrument.measurement( "DMA?", "Get the binary data from memory register A." ) data_memory_b_values = Instrument.measurement( "DMA?", "Get the binary data from memory register B." ) data_memory_select = Instrument.control( "MSL?", "MSL %s", "Control Memory Data Select.", validator=strict_discrete_set, values=["A", "B"] ) ########################### # Trace Marker Commands # ########################### trace_marker_center = Instrument.setting( "TMC %s", "Set Trace Marker at Center. Set to 1 or True to initiate command", map_values=True, values={True: ''} ) trace_marker = Instrument.control( "TMK?", "TMK %f", "Control the trace marker with a wavelength. Returns the trace wavelength and power.", get_process_list=_parse_trace_peak ) @property def wavelengths(self): """Get a numpy array of the current wavelengths of scans.""" return np.linspace( self.wavelength_start, self.wavelength_stop, self.sampling_points ) def read_memory(self, slot="A"): """Read the scan saved in a memory slot.""" cond_attr = f"data_memory_{slot.lower()}_condition" data_attr = f"data_memory_{slot.lower()}_values" scan = getattr(self, cond_attr) wavelengths = np.linspace(scan[0], scan[1], int(scan[2])) power = np.fromstring(getattr(self, data_attr), sep="\r\n") return wavelengths, power def wait(self, n=3, delay=1): """Query OPC Command and waits for appropriate response.""" log.info("Wait for OPC") res = self.ask("*OPC?") n_attempts = n while res == '': log.debug(f"Empty OPC Response. {n_attempts} remaining") if n_attempts == 0: break n_attempts -= 1 sleep(delay) res = self.read().strip() log.debug(res) def wait_for_sweep(self, n=20, delay=0.5): """Wait for a sweep to stop. This is performed by checking bit 1 of the ESR2. """ log.debug("Waiting for spectrum sweep") while self.esr2 != 3 and n > 0: log.debug(f"Wait for sweep [{n}]") # log.debug("ESR2: {}".format(esr2)) sleep(delay) n -= 1 if n <= 0: log.warning(f"Sweep Timeout Occurred ({int(delay * n)} s)") def single_sweep(self, **kwargs): """Perform a single sweep and wait for completion.""" log.debug("Performing a Spectrum Sweep") self.clear() self.write('SSI') self.wait_for_sweep(**kwargs) def center_at_peak(self, **kwargs): """Center the spectrum at the measured peak.""" self.write("PKC") self.wait(**kwargs) def measure_peak(self): """Measure the peak and return the trace marker.""" self.peak_search = "PEAK" return self.trace_marker ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/anritsu/anritsuMS9740A.py0000644000175100017510000000653415203313266024305 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument from pymeasure.instruments.anritsu import AnritsuMS9710C from pymeasure.instruments.validators import ( strict_discrete_set, truncated_discrete_set, truncated_range, ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class AnritsuMS9740A(AnritsuMS9710C): """Anritsu MS9740A Optical Spectrum Analyzer.""" def __init__(self, adapter, name="Anritsu MS9740A Optical Spectrum Analyzer", **kwargs): """Constructor.""" self.analysis_mode = None super().__init__( adapter, name, **kwargs) #################################### # Spectrum Parameters - Wavelength # #################################### resolution = Instrument.control( "RES?", "RES %s", "Control Resolution (nm)", validator=truncated_discrete_set, values=[0.03, 0.05, 0.07, 0.1, 0.2, 0.5, 1.0], ) resolution_vbw = Instrument.control( "VBW?", "VBW %s", "Control Video Bandwidth Resolution", validator=strict_discrete_set, values=["1MHz", "100kHz", "10kHz", "2kHz", "1kHz", "200Hz", "100Hz", "10Hz"] ) average_sweep = Instrument.control( "AVS?", "AVS %d", """Control number of averages to make on a sweep (1-1000), with 1 being a single (non-averaged) sweep""", validator=truncated_range, values=[1, 1000] ) sampling_points = Instrument.control( "MPT?", "MPT %d", "Control number of sampling points", validator=truncated_discrete_set, values=[51, 101, 251, 501, 1001, 2001, 5001, 10001, 20001, 50001], get_process=lambda v: int(v) ) ########################## # Data Memory Commands # ########################## data_memory_select = Instrument.control( "TTP?", "TTP %s", "Control Memory Data Select.", validator=strict_discrete_set, values=["A", "B", "C", "D", "E", "F", "G", "H", "I", "J"] ) def repeat_sweep(self, n=20, delay=0.5): """Perform a single sweep and wait for completion.""" log.debug("Performing a repeat Spectrum Sweep") self.clear() self.write('SRT') self.wait_for_sweep(n=n, delay=delay) ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.016208 pymeasure-0.16.0/pymeasure/instruments/attocube/0000755000175100017510000000000015203313301021460 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/attocube/__init__.py0000644000175100017510000000225215203313266023604 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .anc300 import ANC300Controller ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/attocube/anc300.py0000644000175100017510000003714215203313266023037 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import re from math import inf, isfinite, isinf from warnings import warn from pymeasure.adapters import Adapter from pymeasure.instruments import Instrument, Channel from pymeasure.instruments.validators import (joined_validators, strict_discrete_set, strict_range) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def deprecated_strict_range(value, values): warn("This property is deprecated, use meth:`move_raw` instead.", FutureWarning) return strict_range(value, values) def strict_length(value, values): if len(value) != values: raise ValueError( f"Value {value} does not have an appropriate length of {values}") return value def truncated_int_array(value, values): ret = [] for i, v in enumerate(value): if values[0] <= v <= values[1]: if float(v).is_integer(): ret.append(int(v)) else: raise ValueError(f"Entry {v} at index {i} has no integer value") elif float(v).is_integer(): ret.append(max(min(values[1], v), values[0])) else: raise ValueError(f"Entry {v} at index {i} has no integer value and" f"is out of the boundaries {values}") return ret truncated_int_array_strict_length = joined_validators(strict_length, truncated_int_array) class Axis(Channel): """ Represents a single open loop axis of the Attocube ANC350 :param axis: axis identifier, integer from 1 to 7 :param controller: ANC300Controller instance used for the communication """ serial_nr = Instrument.measurement("getser", "Get the serial number of the axis.") voltage = Instrument.control( "getv", "setv %.3f", """Control the amplitude of the stepping voltage in volts from 0 to 150 V.""", validator=strict_range, values=[0, 150], check_set_errors=True) frequency = Instrument.control( "getf", "setf %.3f", """Control the frequency of the stepping motion in Hertz from 1 to 10000 Hz.""", validator=strict_range, values=[1, 10000], cast=int, check_set_errors=True) mode = Instrument.control( "getm", "setm %s", """Control axis mode. This can be 'gnd', 'inp', 'cap', 'stp', 'off', 'stp+', 'stp-'. Available modes depend on the actual axis model.""", validator=strict_discrete_set, values=['gnd', 'inp', 'cap', 'stp', 'off', 'stp+', 'stp-'], check_set_errors=True) offset_voltage = Instrument.control( "geta", "seta %.3f", """Control offset voltage in Volts from 0 to 150 V.""", validator=strict_range, values=[0, 150], check_set_errors=True) pattern_up = Instrument.control( "getpu", "setpu %s", """Control step up pattern of the piezo drive. 256 values ranging from 0 to 255 representing the sequence of output voltages within one step of the piezo drive. This property can be set, the set value needs to be an array with 256 integer values. """, validator=truncated_int_array_strict_length, values=[256, [0, 255]], set_process=lambda a: " ".join("%d" % v for v in a), separator='\r\n', cast=int, check_set_errors=True) pattern_down = Instrument.control( "getpd", "setpd %s", """Control step down pattern of the piezo drive. 256 values ranging from 0 to 255 representing the sequence of output voltages within one step of the piezo drive. This property can be set, the set value needs to be an array with 256 integer values. """, validator=truncated_int_array_strict_length, values=[256, [0, 255]], set_process=lambda a: " ".join("%d" % v for v in a), separator='\r\n', cast=int, check_set_errors=True) output_voltage = Instrument.measurement( "geto", """Measure the output voltage in volts.""") capacity = Instrument.measurement( "getc", """Measure the saved capacity value in nF of the axis.""") stepu = Instrument.setting( "stepu %d", """Set the steps upwards for N steps. Mode must be 'stp' and N must be positive. 0 causes a continuous movement until stop is called. .. deprecated:: 0.13.0 Use meth:`move_raw` instead. """, validator=deprecated_strict_range, values=[0, inf], check_set_errors=True, ) stepd = Instrument.setting( "stepd %d", """Set the steps downwards for N steps. Mode must be 'stp' and N must be positive. 0 causes a continuous movement until stop is called. .. deprecated:: 0.13.0 Use meth:`move_raw` instead. """, validator=deprecated_strict_range, values=[0, inf], check_set_errors=True, ) def insert_id(self, command): """Insert the channel id in a command replacing `placeholder`. Add axis id to a command string at the correct position after the initial command, but before a potential value. """ cmdparts = command.split() cmdparts.insert(1, self.id) return ' '.join(cmdparts) def stop(self): """ Stop any motion of the axis """ self.write('stop') self.check_set_errors() def move_raw(self, steps): """Move 'steps' steps in the direction given by the sign of the argument. This method assumes the mode of the axis is set to 'stp' and it is non-blocking, i.e. it will return immediately after sending the command. :param steps: integer value of steps to be performed. A positive sign corresponds to upwards steps, a negative sign to downwards steps. The values of +/-inf trigger a continuous movement. The axis can be halted by the stop method. """ if isfinite(steps) and abs(steps) > 0: if steps > 0: self.write(f"stepu {steps:d}") else: self.write(f"stepd {abs(steps):d}") elif isinf(steps): if steps > 0: self.write("stepu c") else: self.write("stepd c") else: # ignore zero and nan values return self.check_set_errors() def move(self, steps, gnd=True): """Move 'steps' steps in the direction given by the sign of the argument. This method will change the mode of the axis automatically and ground the axis on the end if 'gnd' is True. The method is blocking and returns only when the movement is finished. :param steps: finite integer value of steps to be performed. A positive sign corresponds to upwards steps, a negative sign to downwards steps. :param gnd: bool, flag to decide if the axis should be grounded after completion of the movement """ if not isfinite(steps): raise ValueError("Only finite number of steps are allowed.") self.mode = 'stp' # perform the movement self.move_raw(steps) # wait for the move to finish self.wait_for(abs(steps) / self.frequency) # ask if movement finished self.ask('stepw') if gnd: self.mode = 'gnd' def measure_capacity(self): """ Obtains a new measurement of the capacity. The mode of the axis returns to 'gnd' after the measurement. :returns capacity: the freshly measured capacity in nF. """ self.mode = 'cap' # wait for the measurement to finish self.wait_for(1) # ask if really finished self.ask('capw') return self.capacity class ANC300Controller(Instrument): """ Attocube ANC300 Piezo stage controller with several axes :param adapter: The VISA resource name of the controller (e.g. "TCPIP::
::::SOCKET") or a created Adapter. The instruments default communication port is 7230. :param axisnames: a list of axis names which will be used to create properties with these names :param passwd: password for the attocube standard console :param query_delay: default delay between sending and reading in s (default 0.05) :param host: host address of the instrument (e.g. 169.254.0.1) .. deprecated:: 0.11.2 The 'host' argument is deprecated. Use 'adapter' argument instead. :param kwargs: Any valid key-word argument for VISAAdapter """ version = Instrument.measurement( "ver", """ Get the version number and instrument identification. """ ) controllerBoardVersion = Instrument.measurement( "getcser", """ Get the serial number of the controller board. """ ) _reg_value = re.compile(r"\w+\s+=\s+([\w\.]+)") def __init__( self, adapter=None, name="attocube ANC300 Piezo Controller", axisnames="", passwd="", query_delay=0.05, **kwargs, ): adapter = self.handle_deprecated_host_arg(adapter, kwargs) if not isinstance(name, str): warn( f"ANC300Controller.__init__: `name` was provided was {type(name)} but should be a " + "string. This is likely because `name` was added as a keyword argument. " + "All positional arguments after `adapter` should be provided as keyword argument" + " (i.e. `axisnames=['x', 'y']`).", FutureWarning ) self.query_delay = query_delay self.termination_str = "\r\n" super().__init__( adapter, name, includeSCPI=False, read_termination=self.termination_str, write_termination=self.termination_str, **kwargs ) self._axisnames = axisnames for i, axis in enumerate(axisnames): setattr(self, axis, self.add_child(Axis, id=str(i + 1))) self.wait_for() # clear messages sent upon opening the connection, # this contains some non-ascii characters! self.adapter.flush_read_buffer() # send password and check authorization self.write(passwd) self.wait_for() super().read() # ignore echo of password auth_msg = super().read() if auth_msg != 'Authorization success': raise Exception(f"Attocube authorization failed '{auth_msg}'") # switch console echo off self.ask('echo off') def check_set_errors(self): """Check for errors after having set a property and log them. Called if :code:`check_set_errors=True` is set for that property. :return: List of error entries. """ try: self.read() except Exception as exc: log.exception("Setting a property failed.", exc_info=exc) raise else: return [] def ground_all(self): """ Grounds all axis of the controller. """ for attr in self._axisnames: attribute = getattr(self, attr) if isinstance(attribute, Axis): attribute.mode = 'gnd' def stop_all(self): """ Stop all movements of the axis. """ for attr in self._axisnames: attribute = getattr(self, attr) if isinstance(attribute, Axis): attribute.stop() def handle_deprecated_host_arg(self, adapter, kwargs): """ This function formats user input to the __init__ function to be compatible with the current definition of the __init__ function. This is used to support outdated (deprecated) code. and separated out to make it easier to remove in the future. To whoever removes this: This function should be removed and the `adapter` argument in the __init__ method should be made non-optional. :param dict kwargs: keyword arguments passed to the __init__ function, including the deprecated `host` argument. :return str: resource string for the VISAAdapter """ host = kwargs.pop("host", None) if not (host or adapter): raise TypeError("ANC300Controller: missing 'adapter' argument") if not adapter: # because the host argument is deprecated, prompt for the desired # argument which is the adapter argument. warn("The 'host' argument is deprecated. Use 'adapter' instead.", FutureWarning) adapter = host if isinstance(adapter, str): if adapter.find("::") > -1: # adapter is a resource string, so use it return adapter # otherwise, `adapter` can only be a (deprecated) hostname, so display a # deprecation warning and create the resource string warn( "Using a hostname is deprecated. Use a full VISA resource string instead.", FutureWarning, ) return f"TCPIP::{adapter}::7230::SOCKET" elif isinstance(adapter, Adapter): return adapter raise TypeError("ANC300Controller: 'adapter' argument must be a string or Adapter") def _extract_value(self, reply): """ preprocess_reply function for the Attocube console. This function tries to extract from 'name = [unit]'. If can not be identified the original string is returned. :param reply: reply string :returns: string with only the numerical value, or the original string """ r = self._reg_value.search(reply) if r: return r.groups()[0] else: return reply def read(self): """Read after setting a value.""" lines = [] while True: lines.append(super().read()) if lines[-1] in ["OK", "ERROR"]: break msg = self.termination_str.join(lines[:-1]) if lines[-1] != 'OK': self.adapter.flush_read_buffer() raise ValueError("ANC300Controller: Error after previous " f"command with message {msg}") return self._extract_value(msg) def wait_for(self, query_delay=None): """Wait for some time. Used by 'ask' to wait before reading. :param query_delay: Delay between writing and reading in seconds. None means :attr:`query_delay`. """ super().wait_for(self.query_delay if query_delay is None else query_delay) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0165112 pymeasure-0.16.0/pymeasure/instruments/bkprecision/0000755000175100017510000000000015203313301022162 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/bkprecision/__init__.py0000644000175100017510000000226415203313266024311 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .bkprecision9130b import BKPrecision9130B ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/bkprecision/bkprecision9130b.py0000644000175100017510000000556315203313266025546 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set, truncated_range CHANNEL_NUMS = [1, 2, 3] class BKPrecision9130B(SCPIUnknownMixin, Instrument): """ Represents the BK Precision 9130B DC Power Supply interface for interacting with the instrument. """ current = Instrument.control( 'MEASure:SCALar:CURRent:DC?', 'SOURce:CURRent:LEVel:IMMediate:AMPLitude %g', """Control the current of the selected channel. (float)""", validator=truncated_range, values=[0, 3] ) source_enabled = Instrument.control( 'SOURce:CHANnel:OUTPut:STATe?', 'SOURce:CHANnel:OUTPut:STATe %d', """Control whether the source is enabled. (bool) """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) channel = Instrument.control( 'INSTrument:SELect?', 'INSTrument:SELect CH%d', f"""Control which channel is selected. Can only take values {CHANNEL_NUMS}. (int)""", validator=strict_discrete_set, values=CHANNEL_NUMS, get_process_list=lambda x: int(x[2]) ) def __init__(self, adapter, name="BK Precision 9130B Source", **kwargs): super().__init__( adapter, name, **kwargs ) @property def voltage(self): """Control voltage of the selected channel. (float)""" return float(self.ask("MEASure:SCALar:VOLTage:DC?")) @voltage.setter def voltage(self, level): voltage_range = [0, 5] if self.channel == 3 else [0, 30] new_level = truncated_range(level, voltage_range) self.write("SOURce:VOLTage:LEVel:IMMediate:AMPLitude %g" % new_level) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/channel.py0000644000175100017510000001300015203313266021640 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from typing import Optional, Sequence, Union from .common_base import CommonBase, IdType log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Channel(CommonBase): """The base class for channel definitions. This class supports dynamic properties like :class:`Instrument`, but requires an :class:`Instrument` instance as a parent for communication. :meth:`insert_id` inserts the channel id into the command string sent to the instrument. The default implementation replaces the Channel's `placeholder` (default "ch") with the channel id in all command strings (e.g. "CHANnel{ch}:foo"). :param parent: The instrument (an instance of :class:`~pymeasure.instruments.Instrument`) to which the channel belongs. :param id: Identifier of the channel, as it is used for the communication. """ placeholder: str = "ch" def __init__(self, parent: CommonBase, id: IdType, **kwargs): self.parent = parent self.id = id super().__init__(**kwargs) def insert_id(self, command: str) -> str: """Insert the channel id in a command replacing `placeholder`. Subclass this method if you want to do something else, like always prepending the channel id. """ return command.format_map({self.placeholder: self.id}) # Calls to the instrument def write(self, command: str, **kwargs) -> None: """Write a string command to the instrument appending `write_termination`. :param command: command string to be sent to the instrument. '{ch}' is replaced by the channel id. :param kwargs: Keyword arguments for the adapter. """ self.parent.write(self.insert_id(command), **kwargs) def write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content` to the instrument.""" self.parent.write_bytes(content, **kwargs) def read(self, **kwargs) -> str: """Read up to (excluding) `read_termination` or the whole read buffer.""" return self.parent.read(**kwargs) def read_bytes(self, count: int, **kwargs) -> bytes: """Read a certain number of bytes from the instrument. :param int count: Number of bytes to read. A value of -1 indicates to read the whole read buffer. :param kwargs: Keyword arguments for the adapter. :returns bytes: Bytes response of the instrument (including termination). """ return self.parent.read_bytes(count, **kwargs) def write_binary_values( self, command: str, values: Sequence[Union[int, float]], *args, **kwargs ) -> None: """Write binary values to the instrument. :param command: Command to send. :param values: The values to transmit. :param \\*args, \\**kwargs: Further arguments to hand to the Adapter. """ self.parent.write_binary_values(self.insert_id(command), values, *args, **kwargs) def read_binary_values(self, **kwargs): """Read binary values from the instrument.""" return self.parent.read_binary_values(**kwargs) def check_errors(self) -> list: """Read all errors from the instrument and log them. :return: List of error entries. """ return self.parent.check_errors() def check_get_errors(self) -> list: """Check for errors after having gotten a property and log them. Called if :code:`check_get_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ return self.parent.check_get_errors() def check_set_errors(self) -> list: """Check for errors after having set a property and log them. Called if :code:`check_set_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ return self.parent.check_set_errors() # Communication functions def wait_for(self, query_delay: Optional[float] = None) -> None: """Wait for some time. Used by 'ask' to wait before reading. :param query_delay: Delay between writing and reading in seconds. None is default delay. """ self.parent.wait_for(query_delay) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/comedi.py0000644000175100017510000001504615203313266021504 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import numpy as np from time import sleep from importlib.util import find_spec if find_spec('pycomedi'): # Guard against pycomedi not being installed from pycomedi.subdevice import StreamingSubdevice from pycomedi.constant import AREF, CMDF, SUBDEVICE_TYPE, TRIG_SRC, UNIT from pycomedi.constant import _NamedInt from pycomedi.channel import AnalogChannel from pycomedi.utility import inttrig_insn def getAI(device, channel, range=None): """ Returns the analog input channel as specified for a given device """ ai = device.find_subdevice_by_type( SUBDEVICE_TYPE.ai, factory=StreamingSubdevice ).channel(channel, factory=AnalogChannel, aref=AREF.diff) if range is not None: ai.range = ai.find_range(unit=UNIT.volt, min=range[0], max=range[1]) return ai def getAO(device, channel, range=None): """ Returns the analog output channel as specified for a given device """ ao = device.find_subdevice_by_type( SUBDEVICE_TYPE.ao, factory=StreamingSubdevice ).channel(channel, factory=AnalogChannel, aref=AREF.diff) if range is not None: ao.range = ao.find_range(unit=UNIT.volt, min=range[0], max=range[1]) return ao def readAI(device, channel, range=None, count=1): """ Reads a single measurement (count==1) from the analog input channel of the device specified. Multiple readings can be preformed with count not equal to one, which are seperated by an arbitrary time """ ai = getAI(device, channel, range) converter = ai.get_converter() if count == 1: return converter.to_physical(ai.data_read()) else: return converter.to_physical(ai.data_read_n(count)) def writeAO(device, channel, voltage, range=None): """ Writes a single voltage to the analog output channel of the device specified """ ao = getAO(device, channel, range) converter = ao.get_converter() ao.data_write(converter.from_physical(voltage)) class SynchronousAI: def __init__(self, channels, period, samples): self.channels = channels self.samples = samples self.period = period self.scanPeriod = int(1e9 * float(period) / float(samples)) # nano-seconds self.subdevice = self.channels[0].subdevice self.subdevice.cmd = self._command() def _command(self): """ Returns the command used to initiate and end the sampling """ command = self.subdevice.get_cmd_generic_timed(len(self.channels), self.scanPeriod) command.start_src = TRIG_SRC.int command.start_arg = 0 command.stop_src = TRIG_SRC.count command.stop_arg = self.samples command.chanlist = self.channels # Adding to remove chunk transfers (TRIG_WAKE_EOS) wake_eos = _NamedInt('wake_eos', 32) if wake_eos not in CMDF: CMDF.append(wake_eos) command.flags = CMDF.wake_eos return command def _verifyCommand(self): """ Checks the command over three times and allows comedi to correct the command given any device specific conflicts """ for i in range(3): rc = self.subdevice.command_test() # Verify command is correct if rc is None: break def measure(self, hasAborted=lambda: False): """ Initiates the scan after first checking the command and does not block, returns the starting timestamp """ self._verifyCommand() sleep(0.01) self.subdevice.command() length = len(self.channels) dtype = self.subdevice.get_dtype() converters = [c.get_converter() for c in self.channels] self.data = np.zeros((self.samples, length), dtype=np.float32) # Trigger AI self.subdevice.device.do_insn(inttrig_insn(self.subdevice)) # Measurement loop count = 0 size = int(self.data.itemsize / 2) * length previous_bin_slice = b'' while not hasAborted() and self.samples > count: bin_slice = previous_bin_slice while len(bin_slice) < size: bin_slice += self.subdevice.device.file.read(size) previous_bin_slice = bin_slice[size:] bin_slice = bin_slice[:size] slice = np.fromstring( bin_slice, dtype=dtype, count=length ) if len(slice) != length: # Reading finished break # Convert to physical values for i, c in enumerate(converters): self.data[count, i] = c.to_physical(slice[i]) self.emit_progress(100. * count / self.samples) self.emit_data(self.data[count]) count += 1 # Cancel measurement if it is still running (abort event) if self.subdevice.get_flags().running: self.subdevice.cancel() """ Command for limited samples command = self.subdevice.get_cmd_generic_timed(len(self.channels), self.scanPeriod) command.start_src = TRIG_SRC.int command.start_arg = 0 command.stop_src = TRIG_SRC.count command.stop_arg = self.samples command.chanlist = self.channels Command for continuous AI command = self.subdevice.get_cmd_generic_timed(len(self.channels), self.scanPeriod) command.start_src = TRIG_SRC.int command.start_arg = 0 command.stop_src = TRIG_SRC.none command.stop_arg = 0 command.chanlist = self.channels """ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/common_base.py0000644000175100017510000011435415203313266022530 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from inspect import getmembers import logging from typing import Any, Callable, cast, Optional, Protocol, Union, Sequence, TypeVar from warnings import warn log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) IdType = Union[int, str, None] class Child(Protocol): parent: "CommonBase" id: IdType _name: str _protected: bool _collection: str def __init__(self, parent: "CommonBase", id: IdType, **kwargs) -> None: ... child = TypeVar("child", bound=Child) T = TypeVar("T") V0 = TypeVar("V0") Vs = TypeVar("Vs") V2 = TypeVar("V2") class DynamicProperty(property): """ Class that allows managing python property behaviour in a "dynamic" fashion The class allows passing, in addition to regular property parameters, a list of runtime configurable parameters. The effect is that the behaviour of fget/fset not only depends on the obj parameter, but also on a set of keyword parameters with a default value. These extra parameters are read from instance, if available, or left with the default value. Dynamic behaviour is achieved by changing class or instance variables with special names defined as ` + + `. Code has been based on Python equivalent implementation of properties provided in the python documentation `here `_. :param fget: class property fget parameter whose signature is expanded with a set of keyword arguments as in fget_params_list :param fset: class property fget parameter whose signature is expanded with a set of keyword arguments as in fset_params_list :param fdel: class property fdel parameter :param doc: class property doc parameter :param fget_params_list: List of parameter names that are dynamically configurable :param fset_params_list: List of parameter names that are dynamically configurable :param prefix: String to be prefixed to get dynamically configurable parameters. """ def __init__(self, fget=None, fset=None, fdel=None, doc=None, fget_params_list=None, fset_params_list=None, prefix=""): super().__init__(fget, fset, fdel, doc) self.fget_params_list = () if fget_params_list is None else fget_params_list self.fset_params_list = () if fset_params_list is None else fset_params_list self.name = "" self.prefix = prefix def __get__(self, obj, objtype=None): if obj is None: # Property return itself when invoked from a class return self if self.fget is None: raise AttributeError(f"Unreadable attribute {self.name}") kwargs = {} for attr in self.fget_params_list: attr_instance_name = self.prefix + "_".join([self.name, attr]) if hasattr(obj, attr_instance_name): kwargs[attr] = getattr(obj, attr_instance_name) return self.fget(obj, **kwargs) def __set__(self, obj, value): if self.fset is None: raise AttributeError(f"Can't set attribute {self.name}") kwargs = {} for attr in self.fset_params_list: attr_instance_name = self.prefix + "_".join([self.name, attr]) if hasattr(obj, attr_instance_name): kwargs[attr] = getattr(obj, attr_instance_name) self.fset(obj, value, **kwargs) def __set_name__(self, owner, name): self.name = name class CommonBase: """Base class for instruments and channels. This class contains everything needed for pymeasure's property creator :meth:`control` and its derivatives :meth:`measurement` and :meth:`setting`. """ # Variable holding the list of DynamicProperty parameters that are configurable # by users _fget_params_list = ('get_command', 'values', 'map_values', 'get_process', 'get_process_list', 'command_process', 'check_get_errors') _fset_params_list = ('set_command', 'validator', 'values', 'map_values', 'set_process', 'command_process', 'check_set_errors') # Prefix used to store reserved variables __reserved_prefix = "___" def __init__(self, **kwargs): self._special_names = self._setup_special_names() self._create_channels() super().__init__(**kwargs) def write(self, command: str, **kwargs) -> None: raise NotImplementedError("Subclasses must implement write.") def write_bytes(self, content: bytes, **kwargs) -> None: raise NotImplementedError("Subclasses must implement write_bytes.") def write_binary_values( self, command: str, values: Sequence[Union[int, float]], *args, **kwargs ) -> None: raise NotImplementedError("Subclasses must implement write_binary_values.") def read(self, **kwargs) -> str: raise NotImplementedError("Subclasses must implement read.") def read_bytes(self, count: int, **kwargs) -> bytes: raise NotImplementedError("Subclasses must implement read_bytes.") def read_binary_values(self, **kwargs): raise NotImplementedError("Subclasses must implement read_binary_values.") class BaseChannelCreator: """Base class for ChannelCreator and MultiChannelCreator. :param cls: Class for all children or tuple/list of classes, one for each child. :param \\**kwargs: Keyword arguments for all children. """ pairs: Sequence[tuple[type[Child], IdType]] = () kwargs: dict def __init__(self, **kwargs) -> None: self.kwargs = kwargs def check_for_valid_class(self, cls: Any) -> bool: try: valid_class = issubclass(cls, CommonBase) except TypeError: valid_class = False return valid_class class ChannelCreator(BaseChannelCreator): """Add a single channel to the parent class. The child will be added to the parent instance at instantiation with :func:`CommonBase.add_child`. The attribute name that ChannelCreator was assigned to in the `Instrument` class will be the name of the channel interface. .. code:: class Extreme5000(Instrument): # Two output channels, accessible by their property names # and both are accessible through the 'channels' collection output_A = Instrument.ChannelCreator(Extreme5000Channel, "A") output_B = Instrument.ChannelCreator(Extreme5000Channel, "B") # A channel without a channel accessible through the 'motor' collection motor = Instrument.ChannelCreator(MotorControl) inst = SomeInstrument() # Set the extreme_temp for channel A of Extreme5000 instrument inst.output_A.extreme_temp = 42 :param cls: Channel class for channel interface :param id: The id of the channel on the instrument, integer or string. :param \\**kwargs: Keyword arguments for all children. """ def __init__(self, cls: type[Child], id: IdType = None, **kwargs): super().__init__(**kwargs) if (isinstance(id, (str, int)) or id is None) and self.check_for_valid_class(cls): self.pairs = ((cls, id),) else: raise ValueError(f"Invalid definition of class '{cls}' and id '{id}'.") class MultiChannelCreator(BaseChannelCreator): """Add channels to the parent class. The children will be added to the parent instance at instantiation with :func:`CommonBase.add_child`. The attribute name (e.g. :code:`channels`) will be used as the `collection` of the children. You may define the attribute prefix. If there are no other pressing reasons, use :code:`channels` as the attribute name and leave the prefix at the default :code:`"ch_"`. .. code:: class Extreme5000(Instrument): # Three channels of the same type: 'ch_A', 'ch_B', 'ch_C' # and add them to the 'channels' collection channels = Instrument.MultiChannelCreator(Extreme5000Channel, ["A", "B", "C"]) # Two channel interfaces of different types: 'fn_power', 'fn_voltage' # and add them to the 'functions' collection functions = Instrument.MultiChannelCreator((PowerChannel, VoltageChannel), ["power", "voltage"], prefix="fn_") :param cls: Class for all children or tuple/list of classes, one for each child. :param id: tuple/list of ids of the channels on the instrument. :param prefix: Collection prefix for the attributes, e.g. `"ch_"` creates attribute `self.ch_A`. If prefix evaluates False, the child will be added directly under the variable name. Required if id is tuple/list. :param \\**kwargs: Keyword arguments for all children. """ def __init__( self, cls: Union[type[Child], Sequence[type[Child]]], id: IdType = None, prefix: Optional[str] = "ch_", **kwargs, ) -> None: super().__init__(**kwargs) if isinstance(id, (list, tuple)) and isinstance(cls, (list, tuple)): assert (len(id) == len(cls)), "Lengths of cls and id do not match." self.pairs = list(zip(cls, id)) elif isinstance(id, (list, tuple)) and self.check_for_valid_class(cls): self.pairs = list(zip((cast(type[Child], cls),) * len(id), id)) else: raise ValueError(f"Invalid definition of classes '{cls}' and ids '{id}'.") self.kwargs.setdefault("prefix", prefix) def _setup_special_names(self) -> list[str]: """ Return list of class/instance special names. Compute the list of special names based on the list of class attributes that are a DynamicProperty. Check also for class variables with special name and copy them at instance level Internal method, not intended to be accessed at user level.""" special_names = [] dynamic_params = tuple(set(self._fget_params_list + self._fset_params_list)) # Check whether class variables of DynamicProperty type are present for attr_name, attr in getmembers(self.__class__): if isinstance(attr, DynamicProperty): special_names += [attr_name + "_" + key for key in dynamic_params] # Check if special variables are defined at class level for attr, value in getmembers(self.__class__): if attr in special_names: # Copy class special variable at instance level, prefixing reserved_prefix setattr(self, self.__reserved_prefix + attr, value) return special_names @staticmethod def get_channels(cls: type["CommonBase"]) -> list[tuple[str, "CommonBase.BaseChannelCreator"]]: """Return a list of all the Instrument's ChannelCreator and MultiChannelCreator instances""" class_members = getmembers(cls) channels = [] for name, member in class_members: if isinstance(member, CommonBase.BaseChannelCreator): channels.append((name, member)) return channels @staticmethod def get_channel_pairs(cls: type["CommonBase"]): """Return a list of all the Instrument's channel pairs""" channel_pairs = [] for name, creator in CommonBase.get_channels(cls): for pair in creator.pairs: channel_pairs.append(pair) return channel_pairs def _create_channels(self) -> None: """Create channel interfaces for all the Instrument's channel pairs.""" for name, creator in CommonBase.get_channels(self.__class__): for cls, id in creator.pairs: # If channel pair was created with MultiChannelCreator # add channel interface to collection with passed attribute name if isinstance(creator, CommonBase.MultiChannelCreator): child = self.add_child(cls, id, collection=name, **creator.kwargs) # If channel pair was created with ChannelCreator # name channel interface with passed attribute name elif isinstance(creator, CommonBase.ChannelCreator): child = self.add_child(cls, id, attr_name=name, **creator.kwargs) else: raise ValueError(f"Invalid class '{creator}' for channel creation.") child._protected = True def __setattr__(self, name: str, value: Any) -> None: """ Add reserved_prefix in front of special variables.""" if hasattr(self, '_special_names'): if name in self._special_names: name = self.__reserved_prefix + name super().__setattr__(name, value) def __getattribute__(self, name: str) -> Any: """ Prevent read access to variables with special names used to support dynamic property behaviour.""" if name in ('_special_names', '__dict__'): return super().__getattribute__(name) if hasattr(self, '_special_names'): if name in self._special_names: raise AttributeError(f"{name} is a reserved variable name and it cannot be read") return super().__getattribute__(name) # Channel management def add_child( self, cls: type[child], id: IdType = None, collection: str = "channels", prefix: Optional[str] = "ch_", attr_name: Optional[str] = "", **kwargs, ) -> child: """Add a child to this instance and return its index in the children list. The newly created child may be accessed either by the id in the children dictionary or by the created attribute, e.g. the fifth channel of `instrument` with id "F" has two access options: :code:`instrument.channels["F"] == instrument.ch_F` .. note:: Do not change the default `collection` or `prefix` parameter, unless you have to distinguish several collections of different children, e.g. different channel types (analog and digital). :param cls: Class of the channel. :param id: Child id how it is used in communication, e.g. `"A"`. :param collection: Name of the collection of children, used for dictionary access to the channel interfaces. :param prefix: For creating multiple channel interfaces, the prefix e.g. `"ch_"` is prepended to the attribute name of the channel interface `self.ch_A`. If prefix evaluates False, the child will be added directly under the collection name. :param attr_name: For creating a single channel interface, the attr_name argument is used when setting the attribute name of the channel interface. :param \\**kwargs: Keyword arguments for the channel creator. :returns: Instance of the created child. """ child = cls(self, id, **kwargs) collection_data = getattr(self, collection, {}) if isinstance(collection_data, CommonBase.BaseChannelCreator): collection_data = {} # Create channel interface if prefix or name is present if (prefix or attr_name) and id is not None: if not collection_data: # Add a grouplist to the parent. setattr(self, collection, collection_data) collection_data[id] = child child._collection = collection if attr_name: setattr(self, attr_name, child) child._name = attr_name else: setattr(self, f"{prefix}{id}", child) child._name = f"{prefix}{id}" elif attr_name and id is None: # If attribute name is passed with no channel id # set the child to the attribute name. setattr(self, attr_name, child) child._name = attr_name else: if collection_data: raise ValueError(f"An attribute '{collection}' already exists.") setattr(self, collection, child) child._name = collection return child def remove_child(self, child: Child) -> None: """Remove the child from the instrument and the corresponding collection. :param child: Instance of the child to delete. """ if hasattr(child, "_protected"): raise TypeError("You cannot remove channels defined at class level.") if hasattr(child, "_collection"): collection = getattr(self, child._collection) del collection[child.id] delattr(self, child._name) # Communication functions def wait_for(self, query_delay: Optional[float] = None) -> None: """Wait for some time. Used by 'ask' to wait before reading. Implement in subclass! :param query_delay: Delay between writing and reading in seconds. None is default delay. """ raise NotImplementedError("Implement in subclass!") def ask(self, command: str, query_delay: Optional[float] = None) -> str: """Write a command to the instrument and return the read response. :param command: Command string to be sent to the instrument. :param query_delay: Delay between writing and reading in seconds. :returns: String returned by the device without read_termination. """ self.write(command) self.wait_for(query_delay) return self.read() def values( self, command: str, separator: str = ",", cast: Callable[[str], T] = float, # type: ignore[assignment] preprocess_reply: Optional[Callable[[str], str]] = None, maxsplit: int = -1, **kwargs, ) -> list[Union[T, str]]: """Write a command to the instrument and return a list of formatted values from the result. :param command: SCPI command to be sent to the instrument. :param preprocess_reply: Optional callable used to preprocess the string received from the instrument, before splitting it. The callable returns the processed string. :param separator: A separator character to split the string returned by the device into a list. :param maxsplit: The string returned by the device is split at most `maxsplit` times. -1 (default) indicates no limit. :param cast: A type to cast each element of the split string. :param \\**kwargs: Keyword arguments to be passed to the :meth:`ask` method. :returns: A list of the desired type, or strings where the casting fails. """ response = self.ask(command, **kwargs).strip() if callable(preprocess_reply): response = preprocess_reply(response) results: list[Union[T, str]] = [] for result in response.split(separator, maxsplit=maxsplit): try: if cast is bool: # Need to cast to float first since results are usually # strings and bool of a non-empty string is always True results.append(bool(float(result))) # type: ignore[arg-type] else: results.append(cast(result)) except Exception: # Keep as string results.append(result) return results def binary_values(self, command: str, query_delay: Optional[float] = None, **kwargs): """ Write a command to the instrument and return a numpy array of the binary data. :param command: Command to be sent to the instrument. :param query_delay: Delay between writing and reading in seconds. :param kwargs: Arguments for :meth:`~pymeasure.Adapter.read_binary_values`. :returns: NumPy array of values. """ self.write(command) self.wait_for(query_delay) return self.read_binary_values(**kwargs) # Property creators @staticmethod def control( # noqa: C901 accept that this is a complex method get_command: Union[str, None], set_command: Union[str, None], docs: str, validator: Callable[[Any, Vs], V2] = lambda v, vs: v, values: Vs = (), map_values: bool = False, get_process: Callable[[Any], Any] = lambda v: v, get_process_list: Callable[[list[Any]], Any] = lambda v: v, set_process: Callable[[V2], Any] = lambda v: v, command_process: Optional[Callable] = None, check_set_errors: bool = False, check_get_errors: bool = False, dynamic: bool = False, preprocess_reply: Optional[Callable[[str], str]] = None, separator: str = ",", maxsplit: int = -1, cast: Callable[[str], T] = float, values_kwargs: Optional[dict] = None, **kwargs, ) -> Union[property, DynamicProperty]: """Return a property for the class based on the supplied commands. This property may be set and read from the instrument. See also :meth:`measurement` and :meth:`setting`. :param get_command: A string command that asks for the value, set to `None` if get is not supported (see also :meth:`setting`). :param set_command: A string command that writes the value, set to `None` if set is not supported (see also :meth:`measurement`). :param docs: A docstring that will be included in the documentation :param validator: A function that takes both a value and a group of valid values and returns a valid value, while it otherwise raises an exception :param values: A list, tuple, range, or dictionary of valid values, that can be used as to map values if :code:`map_values` is True. :param map_values: A boolean flag that determines if the values should be interpreted as a map :param get_process: A function that takes a value and allows processing before value mapping, returning the processed value :param get_process_list: A function that takes the value list and processes it. :param set_process: A function that takes a value and allows processing before value mapping, returning the processed value :param command_process: A function that takes a command and allows processing before executing the command .. deprecated:: 0.12 Use a dynamic property instead. :param check_set_errors: Toggles checking errors after setting :param check_get_errors: Toggles checking errors after getting :param dynamic: Specify whether the property parameters are meant to be changed in instances or subclasses. :param preprocess_reply: Optional callable used to preprocess the string received from the instrument, before splitting it. The callable returns the processed string. :param separator: A separator character to split the string returned by the device into a list. :param maxsplit: The string returned by the device is split at most `maxsplit` times. -1 (default) indicates no limit. :param cast: A type to cast each element of the split string. :param dict values_kwargs: Further keyword arguments for :meth:`values`. :param \\**kwargs: Keyword arguments for :meth:`values`. .. deprecated:: 0.12 Use `values_kwargs` dictionary parameter instead. Example of usage of dynamic parameter is as follows: .. code-block:: python class GenericInstrument(Instrument): center_frequency = Instrument.control( ":SENS:FREQ:CENT?;", ":SENS:FREQ:CENT %e GHz;", " A floating point property that represents the frequency ... ", validator=strict_range, # Redefine this in subclasses to reflect actual instrument value: values=(1, 20), dynamic=True # enable changing property parameters on-the-fly ) class SpecificInstrument(GenericInstrument): # Identical to GenericInstrument, except for frequency range # Override the "values" parameter of the "center_frequency" property center_frequency_values = (1, 10) # Redefined at subclass level instrument = SpecificInstrument() instrument.center_frequency_values = (1, 6e9) # Redefined at instance level .. warning:: Unexpected side effects when using dynamic properties Users must pay attention when using dynamic properties, since definition of class and/or instance attributes matching specific patterns could have unwanted side effect. The attribute name pattern `property_param`, where `property` is the name of the dynamic property (e.g. `center_frequency` in the example) and `param` is any of this method parameters name except `dynamic` and `docs` (e.g. `values` in the example) has to be considered reserved for dynamic property control. """ if values_kwargs is None: values_kwargs = {} if kwargs: warn(f"Do not use keyword arguments {kwargs} as `control` parameter " f"for the `values` method, use `values_kwargs` parameter instead. docs:\n{docs}", FutureWarning) values_kwargs.update(kwargs) if command_process is None: command_process = lambda c: c # noqa: E731 else: warn("Do not use `command_process`, use a dynamic property instead.", FutureWarning) def fget( self: "CommonBase", get_command: Optional[str] = get_command, values: Vs = values, map_values: bool = map_values, get_process: Callable[[Any], Any] = get_process, get_process_list: Callable[[list[Any]], Any] = get_process_list, command_process=command_process, check_get_errors: bool = check_get_errors, ) -> Any: if get_command is None: raise LookupError("Property can not be read.") vals = self.values(command_process(get_command), separator=separator, cast=cast, preprocess_reply=preprocess_reply, maxsplit=maxsplit, **values_kwargs) if check_get_errors: try: error_list = self.check_get_errors() except Exception as exc: log.error("Exception raised while getting a property with the command " f"""'{command_process(get_command)}': '{str(exc)}'.""") raise errors = [str(error) for error in error_list] if errors: log.error("Error received after trying to get a property with the command " f"""'{command_process(get_command)}': '{"', '".join(errors)}'.""") if len(vals) == 1: value = get_process(vals[0]) if not map_values: return value elif isinstance(values, (list, tuple, range)): return values[int(value)] elif isinstance(values, dict): for k, v in values.items(): if v == value: return k raise KeyError(f"Value {value} not found in mapped values") else: raise ValueError( 'Values of type `{}` are not allowed ' 'for Instrument.control'.format(type(values)) ) else: vals = get_process_list(vals) return vals def fset( self: "CommonBase", value: V0, set_command: Optional[str] = set_command, validator: Callable[[V0, Vs], V2] = validator, values: Vs = values, map_values: bool = map_values, set_process: Callable[[V2], Any] = set_process, command_process=command_process, check_set_errors: bool = check_set_errors, ) -> None: if set_command is None: raise LookupError("Property can not be set.") val = set_process(validator(value, values)) if not map_values: pass elif isinstance(values, (list, tuple, range)): val = values.index(val) elif isinstance(values, dict): val = values[val] else: raise ValueError( 'Values of type `{}` are not allowed ' 'for CommonBase.control'.format(type(values)) ) self.write(command_process(set_command) % val) if check_set_errors: try: error_list = self.check_set_errors() except Exception as exc: log.error("Exception raised while setting a property with the command " f"""'{command_process(set_command) % val}': '{str(exc)}'.""") raise errors = [str(error) for error in error_list] if errors: log.error( "Error received after trying to set a property with the command " f"""'{command_process(set_command) % val}': '{"', '".join(errors)}'.""" ) # Add the specified document string to the getter fget.__doc__ = docs if dynamic: fget.__doc__ += "(dynamic)" return DynamicProperty(fget=fget, fset=fset, fget_params_list=CommonBase._fget_params_list, fset_params_list=CommonBase._fset_params_list, prefix=CommonBase.__reserved_prefix) else: return property(fget, fset) @staticmethod def measurement( get_command: str, docs: str, values: Any = (), map_values: bool = False, get_process: Callable[[Any], Any] = lambda v: v, get_process_list: Callable[[list[Any]], Any] = lambda v: v, command_process: Optional[Callable] = None, check_get_errors: bool = False, dynamic: bool = False, preprocess_reply: Optional[Callable[[str], str]] = None, separator: str = ",", maxsplit: int = -1, cast: Callable[[str], T] = float, values_kwargs: Optional[dict] = None, **kwargs, ) -> Union[property, DynamicProperty]: """ Return a property for the class based on the supplied commands. This is a measurement quantity that may only be read from the instrument, not set. :param get_command: A string command that asks for the value :param docs: A docstring that will be included in the documentation :param values: A list, tuple, range, or dictionary of valid values, that can be used as to map values if :code:`map_values` is True. :param map_values: A boolean flag that determines if the values should be interpreted as a map :param get_process: A function that takes a value and allows processing before value mapping, returning the processed value :param get_process_list: A function that takes the value list and processes it. :param command_process: A function that take a command and allows processing before executing the command, for getting .. deprecated:: 0.12 Use a dynamic property instead. :param check_get_errors: Toggles checking errors after getting :param dynamic: Specify whether the property parameters are meant to be changed in instances or subclasses. See :meth:`control` for an usage example. :param preprocess_reply: Optional callable used to preprocess the string received from the instrument, before splitting it. The callable returns the processed string. :param separator: A separator character to split the string returned by the device into a list. :param maxsplit: The string returned by the device is split at most `maxsplit` times. -1 (default) indicates no limit. :param cast: A type to cast each element of the split string. :param dict values_kwargs: Further keyword arguments for :meth:`values`. :param \\**kwargs: Keyword arguments for :meth:`values`. .. deprecated:: 0.12 Use `values_kwargs` dictionary parameter instead. """ if values_kwargs is None: values_kwargs = {} if kwargs: warn(f"Do not use keyword arguments {kwargs} as `measurement` parameter " f"for the `values` method, use `values_kwargs` parameter instead. docs:\n{docs}", FutureWarning) values_kwargs.update(kwargs) return CommonBase.control(get_command=get_command, set_command=None, docs=docs, values=values, map_values=map_values, get_process=get_process, get_process_list=get_process_list, command_process=command_process, check_get_errors=check_get_errors, dynamic=dynamic, preprocess_reply=preprocess_reply, separator=separator, maxsplit=maxsplit, cast=cast, values_kwargs=values_kwargs, ) @staticmethod def setting( set_command: str, docs: str, validator: Callable[[Any, Vs], Any] = lambda x, y: x, values: Vs = (), map_values: bool = False, set_process: Callable[[Any], Any] = lambda v: v, check_set_errors: bool = False, dynamic: bool = False, ) -> Union[property, DynamicProperty]: """Return a property for the class based on the supplied commands. This property may be set, but raises an exception when being read from the instrument. :param set_command: A string command that writes the value :param docs: A docstring that will be included in the documentation :param validator: A function that takes both a value and a group of valid values and returns a valid value, while it otherwise raises an exception :param values: A list, tuple, range, or dictionary of valid values, that can be used as to map values if :code:`map_values` is True. :param map_values: A boolean flag that determines if the values should be interpreted as a map :param set_process: A function that takes a value and allows processing before value mapping, returning the processed value :param check_set_errors: Toggles checking errors after setting :param dynamic: Specify whether the property parameters are meant to be changed in instances or subclasses. See :meth:`control` for an usage example. """ return CommonBase.control(get_command=None, set_command=set_command, docs=docs, validator=validator, values=values, map_values=map_values, set_process=set_process, check_set_errors=check_set_errors, dynamic=dynamic, ) def check_errors(self) -> list: """Read all errors from the instrument and log them. :return: List of error entries. """ raise NotImplementedError("Implement it in a subclass.") def check_get_errors(self) -> list: """Check for errors after having gotten a property and log them. Called if :code:`check_get_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ raise NotImplementedError("Implement it in a subclass.") def check_set_errors(self) -> list: """Check for errors after having set a property and log them. Called if :code:`check_set_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ raise NotImplementedError("Implement it in a subclass.") ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0168178 pymeasure-0.16.0/pymeasure/instruments/danfysik/0000755000175100017510000000000015203313301021462 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/danfysik/__init__.py0000644000175100017510000000225415203313266023610 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .danfysik8500 import Danfysik8500 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/danfysik/danfysik8500.py0000644000175100017510000003105715203313266024201 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.errors import RangeException from time import sleep import numpy as np import re class Danfysik8500(Instrument): """ Represents the Danfysik 8500 Electromanget Current Supply and provides a high-level interface for interacting with the instrument To allow user access to the Prolific Technology PL2303 Serial port adapter in Linux, create the file: :code:`/etc/udev/rules.d/50-danfysik.rules`, with contents: .. code-block:: none SUBSYSTEMS=="usb",ATTRS{idVendor}=="067b",ATTRS{idProduct}=="2303",MODE="0666",SYMLINK+="danfysik" Then reload the udev rules with: .. code-block:: bash sudo udevadm control --reload-rules sudo udevadm trigger The device will be accessible through the port :code:`/dev/danfysik`. """ id = Instrument.measurement( "PRINT", """Get the idenfitication information. """ ) def __init__(self, adapter, name="Danfysik 8500 Current Supply", **kwargs): super().__init__( adapter, name, includeSCPI=False, write_termination="\r", read_termination="\r", timeout=500, **kwargs ) # TODO verify serial connection. self.write("ERRT") # Use text error messages self.write("UNLOCK") # Unlock from remote or local mode def read(self): """ Read the device and raise exceptions if errors are reported by the instrument. :returns: String ASCII response of the instrument :raises: An :code:`Exception` if the Danfysik raises an error """ result = super().read() search = re.search(r"^\?\x07\s(?P.*)$", result, re.MULTILINE) if search: raise Exception("Danfysik raised the error: %s" % ( search.groups()[0])) else: return result def local(self): """ Sets the instrument in local mode, where the front panel can be used. """ self.write("LOC") def remote(self): """ Sets the instrument in remote mode, where the the front panel is disabled. """ self.write("REM") @property def polarity(self): """Control the polarity of the current supply, being either -1 or 1. This property can be set by supplying one of these values. """ return 1 if self.ask("PO").strip() == '+' else -1 @polarity.setter def polarity(self, value): polarity = "+" if value > 0 else "-" self.write("PO %s" % polarity) def reset_interlocks(self): """ Resets the instrument interlocks. """ self.write("RS") def enable(self): """ Enables the flow of current. """ self.write("N") def disable(self): """ Disables the flow of current. """ self.write("F") def is_enabled(self): """ Returns True if the current supply is enabled. """ return self.status_hex & 0x800000 == 0 @property def status_hex(self): """Get the status in hexadecimal. This value is parsed in :attr:`~.Danfysik8500.status` into a human-readable list. """ status = self.ask("S1H") match = re.search(r'(?P[A-Z0-9]{6})', status) if match is not None: return int(match.groupdict()['hex'], 16) else: raise Exception("Danfysik status not properly returned. Instead " "got '%s'" % status) @property def current(self): """Control the actual current in Amps. This property can be set through :attr:`~.current_ppm`. """ return int(self.ask("AD 8")) * 1e-2 * self.polarity @current.setter def current(self, amps): if amps > 160 or amps < -160: raise RangeException("Danfysik 8500 is only capable of sourcing " "+/- 160 Amps") self.current_ppm = int((1e6 / 160) * amps) @property def current_ppm(self): """Control the current in parts per million.. """ return int(self.ask("DA 0")[2:]) @current_ppm.setter def current_ppm(self, ppm): if abs(ppm) < 0 or abs(ppm) > 1e6: raise RangeException("Danfysik 8500 requires parts per million " "to be an appropriate integer") self.write("DA 0,%d" % ppm) @property def current_setpoint(self): """Get the setpoint for the current, which can deviate from the actual current (:attr:`~.Danfysik8500.current`) while the supply is in the process of setting the value. """ return self.current_ppm * (160 / 1e6) @property def slew_rate(self): """Get the slew rate of the current sweep. """ return float(self.ask("R3")) def wait_for_current(self, has_aborted=lambda: False, delay=0.01): """ Blocks the process until the current has stabilized. A provided function :code:`has_aborted` can be supplied, which is checked after each delay time (in seconds) in addition to the stability check. This allows an abort feature to be integrated. :param has_aborted: A function that returns True if the process should stop waiting :param delay: The delay time in seconds between each check for stability """ self.wait_for_ready(has_aborted, delay) while not has_aborted() and not self.is_current_stable(): sleep(delay) def is_current_stable(self): """ Returns True if the current is within 0.02 A of the setpoint value. """ return abs(self.current - self.current_setpoint) <= 0.02 def is_ready(self): """ Returns True if the instrument is in the ready state. """ return self.status_hex & 0b10 == 0 def wait_for_ready(self, has_aborted=lambda: False, delay=0.01): """ Blocks the process until the instrument is ready. A provided function :code:`has_aborted` can be supplied, which is checked after each delay time (in seconds) in addition to the readiness check. This allows an abort feature to be integrated. :param has_aborted: A function that returns True if the process should stop waiting :param delay: The delay time in seconds between each check for readiness """ while not has_aborted() and not self.is_ready(): sleep(delay) @property def status(self): """Get a list of human-readable strings that contain the instrument status information, based on :attr:`~.status_hex`. """ status = [] indicator = self.ask("S1") if indicator[0] == "!": status.append("Main Power OFF") else: status.append("Main Power ON") # Skipping 5, 6 and 7 (from Appendix Manual on command S1) messages = { 1: "Polarity Normal", 2: "Polarity Reversed", 3: "Regulation Transformer is not equal to zero", 7: "Spare Interlock", 8: "One Transistor Fault", 9: "Sum - Interlock", 10: "DC Overcurrent (OCP)", 11: "DC Overload", 12: "Regulation Module Failure", 13: "Preregulator Failure", 14: "Phase Failure", 15: "MPS Waterflow Failure", 16: "Earth Leakage Failure", 17: "Thermal Breaker/Fuses", 18: "MPS Overtemperature", 19: "Panic Button/Door Switch", 20: "Magnet Waterflow Failure", 21: "Magnet Overtemperature", 22: "MPS Not Ready" } for index, message in messages.items(): if indicator[index] == "!": status.append(message) return status def clear_ramp_set(self): """ Clears the ramp set. """ self.write("RAMPSET C") def set_ramp_delay(self, time): """ Sets the ramp delay time in seconds. :param time: The time delay time in seconds """ self.write("RAMPSET %f" % time) def start_ramp(self): """ Starts the current ramp. """ self.write("RAMP R") def add_ramp_step(self, current): """ Adds a current step to the ramp set. :param current: A current in Amps """ self.write("R %.6f" % (current / 160.)) def stop_ramp(self): """ Stops the current ramp. """ self.ask("RAMP S") def set_ramp_to_current(self, current, points, delay_time=1): """ Sets up a linear ramp from the initial current to a different current, with a number of points, and delay time. :param current: The final current in Amps :param points: The number of linear points to traverse :param delay_time: A delay time in seconds """ initial_current = self.current self.clear_ramp_set() self.set_ramp_delay(delay_time) steps = np.linspace(initial_current, current, num=points) cmds = ["R %.6f" % (step / 160.) for step in steps] self.write("\r".join(cmds)) def ramp_to_current(self, current, points, delay_time=1): """ Executes :meth:`~.set_ramp_to_current` and starts the ramp. """ self.set_ramp_to_current(current, points, delay_time) self.start_ramp() # self.setSequence(0, [0, 10], [0.01]) def set_sequence(self, stack, currents, times, multiplier=999999): """ Sets up an arbitrary ramp profile with a list of currents (Amps) and a list of interval times (seconds) on the specified stack number (0-15) """ self.clear_sequence(stack) if min(times) >= 1 and max(times) <= 65535: self.write("SLOW %i" % stack) elif min(times) >= 0.1 and max(times) <= 6553.5: self.write("FAST %i" % stack) times = [0.1 * x for x in times] else: raise RangeException("Timing for Danfysik 8500 ramp sequence is" " out of range") for i in range(len(times)): self.write("WSA %i,%i,%i,%i" % ( stack, int(6250 * abs(currents[i])), int(6250 * abs(currents[i + 1])), times[i]) ) self.write("MULT %i,%i" % (stack, multiplier)) def clear_sequence(self, stack): """ Clears the sequence by the stack number. :param stack: A stack number between 0-15 """ self.write("CSS %i" % stack) def sync_sequence(self, stack, delay=0): """ Arms the ramp sequence to be triggered by a hardware input to pin P33 1&2 (10 to 24 V) or a TS command. If a delay is provided, the sequence will start after the delay. :param stack: A stack number between 0-15 :param delay: A delay time in seconds """ self.write("SYNC %i, %i" % (stack, delay)) def start_sequence(self, stack): """ Starts a sequence by the stack number. :param stack: A stack number between 0-15 """ self.write("TS %i" % stack) def stop_sequence(self): """ Stops the currently running sequence. """ self.write("STOP") def is_sequence_running(self, stack): """ Returns True if a sequence is running with a given stack number :param stack: A stack number between 0-15 """ return re.search("R%i," % stack, self.ask("S2")) is not None ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0171227 pymeasure-0.16.0/pymeasure/instruments/deltaelektronika/0000755000175100017510000000000015203313301023174 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/deltaelektronika/__init__.py0000644000175100017510000000224215203313266025317 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .sm7045d import SM7045D ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/deltaelektronika/sm7045d.py0000644000175100017510000001152015203313266024662 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_range from time import sleep import numpy as np class SM7045D(SCPIUnknownMixin, Instrument): """ This is the class for the SM 70-45 D power supply. .. code-block:: python source = SM7045D("GPIB::8") source.ramp_to_zero(1) # Set output to 0 before enabling source.enable() # Enables the output source.current = 1 # Sets a current of 1 Amps """ VOLTAGE_RANGE = [0, 70] CURRENT_RANGE = [0, 45] voltage = Instrument.control( "SO:VO?", "SO:VO %g", """ A floating point property that represents the output voltage setting of the power supply in Volts. This property can be set. """, validator=strict_range, values=VOLTAGE_RANGE ) current = Instrument.control( "SO:CU?", "SO:CU %g", """ A floating point property that represents the output current of the power supply in Amps. This property can be set. """, validator=strict_range, values=CURRENT_RANGE ) max_voltage = Instrument.control( "SO:VO:MA?", "SO:VO:MA %g", """ A floating point property that represents the maximum output voltage of the power supply in Volts. This property can be set. """, validator=strict_range, values=VOLTAGE_RANGE ) max_current = Instrument.control( "SO:CU:MA?", "SO:CU:MA %g", """ A floating point property that represents the maximum output current of the power supply in Amps. This property can be set. """, validator=strict_range, values=CURRENT_RANGE ) measure_voltage = Instrument.measurement( "ME:VO?", """ Measures the actual output voltage of the power supply in Volts. """, ) measure_current = Instrument.measurement( "ME:CU?", """ Measures the actual output current of the power supply in Amps. """, ) rsd = Instrument.measurement( "SO:FU:RSD?", """ Check whether remote shutdown is enabled/disabled and thus if the output of the power supply is disabled/enabled. """, ) def __init__(self, adapter, name="Delta Elektronika SM 70-45 D", **kwargs): super().__init__( adapter, name, **kwargs ) def enable(self): """ Disable remote shutdown, hence output will be enabled. """ self.write("SO:FU:RSD 0") def disable(self): """ Enables remote shutdown, hence input will be disabled. """ self.write("SO:FU:RSD 1") def ramp_to_current(self, target_current, current_step=0.1): """ Gradually increase/decrease current to target current. :param target_current: Float that sets the target current (in A) :param current_step: Optional float that sets the current steps / ramp rate (in A/s) """ curr = self.current n = round(abs(curr - target_current) / current_step) + 1 for i in np.linspace(curr, target_current, n): self.current = i sleep(0.1) def ramp_to_zero(self, current_step=0.1): """ Gradually decrease the current to zero. :param current_step: Optional float that sets the current steps / ramp rate (in A/s) """ self.ramp_to_current(0, current_step) def shutdown(self): """ Set the current to 0 A and disable the output of the power source. """ self.ramp_to_zero() self.disable() super().shutdown() ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.017416 pymeasure-0.16.0/pymeasure/instruments/edwards/0000755000175100017510000000000015203313301021303 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/edwards/__init__.py0000644000175100017510000000223415203313266023427 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .nxds import Nxds ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/edwards/nxds.py0000644000175100017510000000373115203313266022647 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set class Nxds(Instrument): """ Represents the Edwards nXDS (10i) Vacuum Pump and provides a low-level interaction with the instrument. This could potentially work with Edwards pump that has a RS232 interface. This instrument is constructed to only start and stop pump. """ enable = Instrument.setting("!C802 %d", """ Set the pump enabled state with default settings.""", validator=strict_discrete_set, values=(0, 1),) def __init__(self, adapter, name="Edwards NXDS Vacuum Pump", **kwargs): super().__init__( adapter, name, includeSCPI=False, **kwargs ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0177302 pymeasure-0.16.0/pymeasure/instruments/eurotest/0000755000175100017510000000000015203313301021524 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/eurotest/__init__.py0000644000175100017510000000226515203313266023654 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .eurotestHPP120256 import EurotestHPP120256 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/eurotest/eurotestHPP120256.py0000644000175100017510000004246315203313266025023 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import math import re import time from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range from pymeasure.instruments.validators import strict_discrete_set from enum import IntFlag log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class EurotestHPP120256(Instrument): """ Represents the Euro Test High Voltage DC Source model HPP-120-256 and provides a high-level interface for interacting with the instrument using the Euro Test command set (Not SCPI command set). .. code-block:: python hpp120256 = EurotestHPP120256("GPIB0::20::INSTR") print(hpp120256.id) print(hpp120256.lam_status) print(hpp120256.status) hpp120256.ramp_to_zero(100.0) hpp120256.voltage_ramp = 50.0 # V/s hpp120256.current_limit = 2.0 # mA inst.kill_enabled = True # Enable over-current protection time.sleep(1.0) # Give time to enable kill inst.output_enabled = True time.sleep(1.0) # Give time to output on abs_output_voltage_error = 0.02 # kV hpp120256.wait_for_output_voltage_reached(abs_output_voltage_error, 1.0, 40.0) # Here voltage HV output should be at 0.0 kV print("Setting the output voltage to 1.0kV...") hpp120256.voltage_setpoint = 1.0 # kV # Now HV output should be rising to reach the 1.0kV at 50.0 V/s hpp120256.wait_for_output_voltage_reached(abs_output_voltage_error, 1.0, 40.0) # Here voltage HV output should be at 1.0 kV hpp120256.shutdown() hpp120256.wait_for_output_voltage_reached(abs_output_voltage_error, 1.0, 60.0) # Here voltage HV output should be at 0.0 kV inst.output_enabled = False # Now the HV voltage source is in safe state """ VOLTAGE_RANGE = [0.0, 12.0] # kVolts CURRENT_RANGE = [0.0, 25.0] # mAmps VOLTAGE_RAMP_RANGE = [10, 3000] # V/s COMMAND_DELAY = 0.2 # s response_encoding = "iso-8859-2" regex = re.compile(r'([+-]?([\d]*\.)?[\d]+)') def __init__(self, adapter, name="Euro Test High Voltage DC Source model HPP-120-256", query_delay=0.1, write_delay=0.4, timeout=5000, **kwargs): super().__init__( adapter, name, write_termination="\n", read_termination="", send_end=True, includeSCPI=False, timeout=timeout, **kwargs ) self.write_delay = write_delay self.query_delay = query_delay self.last_write_timestamp = 0.0 # #################################### # # EuroTest-Command set. Non SCPI commands. # #################################### voltage_setpoint = Instrument.control( "STATUS,U", "U,%.3fkV", """Control the voltage set-point in kVolts (float strictly from 0 to 12).""", # getter device response: "U, RANGE=3.000kV, VALUE=2.458kV" validator=strict_range, values=VOLTAGE_RANGE, get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[2].strip()).groups()[0]) ) current_limit = Instrument.control( "STATUS,I", "I,%.3fmA", """Control the current limit in mAmps (float strictly from 0 to 25).""", # When this property acts as get, the instrument will return a string like this: # "I, RANGE=5000mA, VALUE=1739mA", then current_limit will return 1739.0, # hence the convenience of the get_process. validator=strict_range, values=CURRENT_RANGE, get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[2].strip()).groups()[0]) ) voltage_ramp = Instrument.control( "STATUS,RAMP", "RAMP,%dV/s", """Control the voltage ramp in Volts/second (int strictly from 10 to 3000).""", # When this property acts as get, the instrument will return a string like this: # "RAMP, RANGE=3000V/s, VALUE=1000V/s", then voltage_ramp will return 1000.0, # hence the convenience of the get_process. validator=strict_range, values=VOLTAGE_RAMP_RANGE, get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[2].strip()).groups()[0]) ) voltage = Instrument.measurement( "STATUS,MU", """Measure the actual output voltage in kVolts (float).""", # This property is a get so, the instrument will return a string like this: # "U, RANGE=3.000kV, VALUE=2.458kV", then voltage will return 2458.0, # hence the convenience of the get_process. get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[2].strip()).groups()[0]) ) voltage_range = Instrument.measurement( "STATUS,MU", """Measure the actual output voltage range in kVolts (float).""", # This property is a get so, the instrument will return a string like this: # "U, RANGE=3.000kV, VALUE=2.458kV", then voltage_range will return 3000.0, # hence the convenience of the get_process. get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[1]).groups()[0]) ) current = Instrument.measurement( "STATUS,MI", """Measure the actual output current in mAmps (float).""", # This property is a get so, the instrument will return a string like this: # "I, RANGE=5000mA, VALUE=1739mA", then current will return a 1739.0, # hence the convenience of the get_process.""" get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[2].strip()).groups()[0]) ) current_range = Instrument.measurement( "STATUS,MI", """Measure the actual output current range in mAmps (float).""", # This property is a get so, the instrument will return a string like this: # "I, RANGE=5000mA, VALUE=1739mA, then current_range will return a 5000.0, # hence the convenience of the get_process. get_process_list=lambda r: float(EurotestHPP120256.regex.search(r[1].strip()).groups()[0]) ) kill_enabled = Instrument.control( "STATUS,DI", "KILL,%s", """Control the instrument kill enable (boolean).""", # When Kill is enabled yellow led is flashing and the output # will be shut OFF permanently without ramp if Iout > IOUTmax. validator=strict_discrete_set, values={True: 'ENable', False: 'DISable'}, map_values=True, get_process_list=lambda r: EurotestHPP120256.EurotestHPP120256Status( int(r[1].strip()[:-1].encode(EurotestHPP120256.response_encoding). decode('utf-8', 'ignore'), 2) ) == EurotestHPP120256.EurotestHPP120256Status.KILL_ENABLE ) output_enabled = Instrument.control( "STATUS,DI", "HV,%s", """Control the instrument output enable (boolean).""", # When output voltage is enabled green led is ON and the # voltage_setting will be present on the output. validator=strict_discrete_set, values={True: 'ON', False: 'OFF'}, map_values=True, get_process_list=lambda r: EurotestHPP120256.EurotestHPP120256Status( int(r[1].strip()[:-1].encode(EurotestHPP120256.response_encoding). decode('utf-8', 'ignore'), 2) ) == EurotestHPP120256.EurotestHPP120256Status.OUTPUT_ON ) id = Instrument.measurement( "ID", """Get the identification of the instrument (string) """, get_process_list=lambda r: r[1].strip().encode(EurotestHPP120256.response_encoding).decode('utf-8', 'ignore') ) status = Instrument.measurement( "STATUS,DI", """Get the instrument status (EurotestHPP120256Status).""", # Every bit indicates the state of one subsystem of the HV Source. # response DI, b15 b14 b13 b12 b11 b10 b9 b8 b7 b6 b5 b4 b3 b2 b1 b0, # 0 1 # IpErr b15 no input error input error # Ramp b14 no ramp ramp # CutOut b13 - emergency off # TpErr b12 no trip error trip error # F3 b11 reserved # F2 b10 reserved # menu1 b9 submenu off submenu on # menu0 b8 menu off menu on # err b7 no error error # Creg b6 no current control current control # Vreg b5 no voltage control voltage control # pol b4 negative positive # inh b3 no ext. inhibit external inhibit # local b2 remote local # kilena b1 kill disable kill enable # on b0 off high voltage is ON get_process_list=lambda r: EurotestHPP120256.EurotestHPP120256Status( int(r[1].strip()[:-1].encode(EurotestHPP120256.response_encoding). decode('utf-8', 'ignore'), 2) ) ) lam_status = Instrument.measurement( "STATUS,LAM", """Get the instrument lam status (string).""", # LAM status is the status of the unit from the point # of view of the process. Fo example, as a response of asking STATUS,LAM, the HV # voltage could response one of the messages from the next list: # LAM,ERROR External Inhibit occurred during Kill enable # LAM,INHIBIT External Inhibit occurred # LAM,TRIP ERROR Software current trip occurred # LAM,INPUT ERROR Wrong command received # LAM,OK Status OK get_process_list=lambda r: r[1].strip().encode(EurotestHPP120256.response_encoding).decode('utf-8', 'ignore') ) def emergency_off(self): """ The output of the HV source will be switched OFF permanently and the values of the voltage and current settings set to zero""" log.info("Sending emergency off command to the instrument.") self.write("EMCY OFF") def shutdown(self, voltage_rate=200.0): """ Change the output voltage setting (V) to zero and the ramp speed - voltage_rate (V/s) of the output voltage. After calling shutdown, if the HV voltage output > 0 it should drop to zero at a certain rate given by the voltage_rate parameter. :param voltage_rate: indicates the changing rate (V/s) of the voltage output """ log.info(f"Executing the shutdown function with voltage_rate: {voltage_rate} V/s.") self.ramp_to_zero(voltage_rate) super().shutdown() def ramp_to_zero(self, voltage_rate=200.0): """ Sets the voltage output setting to zero and the ramp setting to a value determined by the voltage_rate parameter. In summary, the method conducts (ramps) the voltage output to zero at a determinated voltage changing rate (ramp in V/s). :param voltage_rate: Is the changing rate (ramp in V/s) for the ramp setting """ log.info(f"Executing the ramp_to_zero function with ramp: {voltage_rate} V/s.") self.voltage_ramp = voltage_rate self.voltage_setpoint = 0 def wait_for_output_voltage_reached(self, voltage_setpoint, abs_output_voltage_error=0.03, check_period=1.0, timeout=60.0): """ Wait until HV voltage output reaches the voltage setpoint. Checks the voltage output every check_period seconds and raises an exception if the voltage output doesn't reach the voltage setting until the timeout time. :param voltage_setpoint: the voltage in kVolts setted in the HV power supply which should be present at the output after some time (depends on the ramp setting). :param abs_output_voltage_error: absolute error in kVolts for being considered an output voltage reached. :param check_period: voltage output will be measured every check_period (seconds) time. :param timeout: time (seconds) give to the voltage output to reach the voltage setting. :return: None :raises: Exception if the voltage output can't reach the voltage setting before the timeout completes (seconds). """ log.info("Executing the wait_for_output_voltage_reached function.") ref_time = time.time() future_time = ref_time + timeout log.debug(f"\tWaiting for voltage output set. " f"Reading output voltage every {check_period} seconds.\n" f"\tTimeout: {timeout} seconds.") while True: actual_time = time.time() time.sleep(check_period) # wait for voltage output reaches the voltage output setting voltage_output = self.voltage # check if voltage_output is set. If so then no more wait if math.isclose(voltage_output, voltage_setpoint, rel_tol=0.0, abs_tol=abs_output_voltage_error): break log.debug("voltage_output_valid_range: " "[" + str(voltage_setpoint - abs_output_voltage_error) + ", " + str(voltage_setpoint + abs_output_voltage_error) + "]") log.debug("voltage_output: " + str(voltage_output)) log.debug(f"Elapsed time: {round(actual_time - ref_time, ndigits=1)} seconds.") if actual_time > future_time: self.shutdown() # in case the voltage were applied at the output raise TimeoutError("Timeout for wait_for_output_voltage_reached function") log.info("Waiting for voltage output set done.") # Wrapper functions for the Adapter object def write(self, command, **kwargs): """Overrides Instrument write method for including write_delay time after the parent call. :param command: command string to be sent to the instrument """ actual_write_delay = time.time() - self.last_write_timestamp time.sleep(max(0, self.write_delay - actual_write_delay)) super().write(command, **kwargs) self.last_write_timestamp = time.time() def ask(self, command): """ Overrides Instrument ask method for including query_delay time on parent call. :param command: Command string to be sent to the instrument. :returns: String returned by the device without read_termination. """ return super().ask(command, self.query_delay) class EurotestHPP120256Status(IntFlag): """ Auxiliary class create for translating the instrument 16bits_status_string into an Enum_IntFlag that will help to the user to understand such status. """ # Status response from the instrument has to be interpreted as follows: # # response DI, b15 b14 b13 b12 b11 b10 b9 b8 b7 b6 b5 b4 b3 b2 b1 b0, # bit = 0,1 # IpErr b15 no input error input error # Ramp b14 no ramp ramp # CutOut b13 - emergency off # TpErr b12 no trip error trip error # F3 b11 reserved # F2 b10 reserved # menu1 b9 submenu off submenu on # menu0 b8 menu off menu on # err b7 no error error # Creg b6 no current control current control # Vreg b5 no voltage control voltage control # pol b4 negative positive # inh b3 no ext. inhibit external inhibit # local b2 remote local # kilena b1 kill disable kill enable # on b0 off high voltage is ON # # For example, a status_string = "0100000000000111" will be translated to # EurotestHPP120256_status.RAMP|LOCAL|KILL_ENABLE|OUTPUT_ON INPUT_ERROR = 32768 RAMP = 16384 EMERGENCY_OFF = 8192 TRIP_ERROR = 4096 F3 = 2048 F2 = 1024 SUBMENU_ON = 512 MENU_ON = 256 ERROR = 128 CURRENT_CONTROL = 64 VOLTAGE_CONTROL = 32 POLARIZATION_POSITIVE = 16 EXTERNAL_INHIBIT = 8 LOCAL = 4 KILL_ENABLE = 2 OUTPUT_ON = 1 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/fakes.py0000644000175100017510000001510715203313266021333 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import re import time import numpy as np from pymeasure.adapters import FakeAdapter from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set class FakeInstrument(Instrument): """ Provides a fake implementation of the Instrument class for testing purposes. """ def __init__(self, adapter=None, name="Fake Instrument", includeSCPI=False, **kwargs): super().__init__( FakeAdapter(**kwargs), name, includeSCPI=includeSCPI, **kwargs ) @staticmethod def control(get_command, set_command, docs, validator=lambda v, vs: v, values=(), map_values=False, get_process=lambda v: v, set_process=lambda v: v, check_set_errors=False, check_get_errors=False, **kwargs): """Fake Instrument.control. Strip commands and only store and return values indicated by format strings to mimic many simple commands. This is analogous how the tests in test_instrument are handled. """ # Regex search to find first format specifier in the command fmt_spec_pattern = r'(%[\w.#-+ *]*[diouxXeEfFgGcrsa%])' match = re.findall(fmt_spec_pattern, set_command) if match: # format_specifier = match.group(0) format_specifier = ','.join(match) else: format_specifier = '' # To preserve as much functionality as possible, call the real # control method with modified get_command and set_command. return Instrument.control(get_command="", set_command=format_specifier, docs=docs, validator=validator, values=values, map_values=map_values, get_process=get_process, set_process=set_process, check_set_errors=check_set_errors, check_get_errors=check_get_errors, **kwargs) class SwissArmyFake(FakeInstrument): """Dummy instrument class useful for testing. Like a Swiss Army knife, this class provides multi-tool functionality in the form of streams of multiple types of fake data. Data streams that can currently be generated by this class include 'voltages', sinusoidal 'waveforms', and mono channel 'image data'. """ def __init__(self, name="Mock instrument", wait=.1, **kwargs): super().__init__( name=name, includeSCPI=False, **kwargs ) self._wait = wait self._tstart = 0 self._voltage = 10 self._output_voltage = 0 self._time = 0 self._wave = self.wave self._units = {'voltage': 'V', 'output_voltage': 'V', 'time': 's', 'wave': 'a.u.'} # mock image attributes self._w = 1920 self._h = 1080 self._frame_format = "mono_8" @property def time(self): """Control the elapsed time.""" if self._tstart == 0: self._tstart = time.time() self._time = time.time() - self._tstart return self._time @time.setter def time(self, value): if value == 0: self._tstart = 0 else: while self.time < value: time.sleep(0.001) @property def wave(self): """Measure a waveform.""" return float(np.sin(self.time)) @property def voltage(self): """Measure the voltage.""" time.sleep(self._wait) return self._voltage @property def output_voltage(self): """Control the voltage.""" return self._output_voltage @output_voltage.setter def output_voltage(self, value): time.sleep(self._wait) self._output_voltage = value @property def frame_width(self): """Control frame width in pixels.""" time.sleep(self._wait) return self._w @frame_width.setter def frame_width(self, w): time.sleep(self._wait) self._w = w @property def frame_height(self): """Control frame height in pixels.""" time.sleep(self._wait) return self._h @frame_height.setter def frame_height(self, h): time.sleep(self._wait) self._h = h @property def frame_format(self): """Control the format for image data returned from the get_frame() method. Allowed values are: mono_8: single channel 8-bit image. mono_16: single channel 16-bit image. """ time.sleep(self._wait) return self._frame_format @frame_format.setter def frame_format(self, form): allowed_formats = ["mono_8", "mono_16"] strict_discrete_set(form, allowed_formats) self._frame_format = form @property def frame(self): """Get a new image frame.""" im_format_maxval_dict = {"8": 255, "16": 65535} im_format_type_dict = {"8": np.uint8, "16": np.uint16} bit_depth = self.frame_format.split("_")[1] time.sleep(self._wait) return np.array( im_format_maxval_dict[bit_depth] * np.random.rand(self.frame_height, self.frame_width), dtype=im_format_type_dict[bit_depth] ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0180333 pymeasure-0.16.0/pymeasure/instruments/fluke/0000755000175100017510000000000015203313301020760 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/fluke/__init__.py0000644000175100017510000000224615203313266023107 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .fluke7341 import Fluke7341 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/fluke/fluke7341.py0000644000175100017510000000647315203313266023003 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, strict_range class Fluke7341(Instrument): """ Represents the compact constant temperature bath from Fluke. """ def __init__(self, adapter, name="Fluke 7341", **kwargs): kwargs.setdefault('timeout', 2000) kwargs.setdefault('write_termination', '\r\n') super().__init__( adapter, name, includeSCPI=False, asrl={'baud_rate': 2400}, **kwargs ) def read(self): """Read up to (excluding) `read_termination` or the whole read buffer. Extract the value from the response string. Responses are in the format "`type`: `value` `optional information`". Optional information is for example the unit (degree centigrade or Fahrenheit). """ return super().read().split(":")[-1] set_point = Instrument.control("s", "s=%g", """Control the temperature setpoint (float from -40 to 150 °C) The unit is as defined in property :attr:`~.unit`.""", validator=strict_range, values=(-40, 150), preprocess_reply=lambda x: x.split()[0], ) unit = Instrument.control( "u", "u=%s", """Control the temperature unit: `c` for Celsius and `f` for Fahrenheit`.""", validator=strict_discrete_set, values=('c', 'f'), ) temperature = Instrument.measurement("t", """Measure the current bath temperature. The unit is as defined in property :attr:`unit`.""", preprocess_reply=lambda x: x.split()[0], ) id = Instrument.measurement("*ver", """Get the instrument model.""", cast=str, get_process_list=lambda x: f"Fluke,{x[0][4:]},NA,{x[1]}", ) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0183372 pymeasure-0.16.0/pymeasure/instruments/formfactor/0000755000175100017510000000000015203313301022014 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/formfactor/__init__.py0000644000175100017510000000223615203313266024142 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .velox import Velox ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/formfactor/velox.py0000644000175100017510000002210115203313266023531 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Channel, Instrument, SCPIMixin from pymeasure.instruments.validators import strict_range, strict_discrete_set log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) VELOCITY_RANGE = [0.1, 100] PROBER_UNITS = {"microns": "Y", "mils": "I", "jogs": "J", "encoder": "E", "index": "X", } PROBER_REFERENCES = {"home": "H", "zero": "Z", "relative": "R", "center": "C", "diehome": "D", } class Chuck(Channel): """A class representing the Chuck functions of the wafer prober.""" def move_contact(self, velocity=100): """Move the chuck to the contact height. :param float velocity: Speed in percent, strictly from ``0.1`` to ``100``. """ strict_range(velocity, VELOCITY_RANGE) return self.ask(f"MoveChuckContact {velocity}") def move_align(self, velocity=100): """Move the chuck to the align height. :param float velocity: Speed in percent, strictly from ``0.1`` to ``100``. """ strict_range(velocity, VELOCITY_RANGE) return self.ask(f"MoveChuckAlign {velocity}") def move_separation(self, velocity=100): """Move the chuck to the separation height. :param float velocity: Speed in percent, strictly from ``0.1`` to ``100``. """ strict_range(velocity, VELOCITY_RANGE) return self.ask(f"MoveChuckSeparation {velocity}") def move_index(self, x_steps, y_steps, pos_ref="home", velocity=100): """Move the chuck in index steps. :param int x_steps: Index steps in X direction :param int y_steps: Index steps in Y direction :param str pos_ref: Position reference, strictly ``home``, ``zero``, ``center`` or ``diehome``. :param float velocity: Speed in percent, strictly from ``0.1`` to ``100``. """ pos_ref = pos_ref.lower() strict_discrete_set(pos_ref, PROBER_REFERENCES.keys()) strict_range(velocity, VELOCITY_RANGE) _ref = PROBER_REFERENCES[pos_ref] return self.ask(f"MoveChuckIndex {x_steps} {y_steps} {_ref} {velocity}") def move(self, x, y, pos_ref="home", unit="microns", velocity=100): """Move the chuck by the specified distance. :param float x: Distance in X direction :param float y: Distance in Y direction :param str pos_ref: Position reference, strictly ``home``, ``zero``, ``center`` or ``diehome``. :param str unit: Unit of **x** and **y**, strictly ``micron``, ``mils``, ``jogs``, ``encoder`` or ``index``. :param float velocity: Speed in percent, strictly from ``0.1`` to ``100``. """ pos_ref = pos_ref.lower() strict_discrete_set(pos_ref, PROBER_REFERENCES.keys()) _ref = PROBER_REFERENCES[pos_ref] unit = unit.lower() strict_discrete_set(unit, PROBER_UNITS.keys()) _unit = PROBER_UNITS[unit] strict_range(velocity, VELOCITY_RANGE) return self.ask(f"MoveChuck {x} {y} {_ref} {_unit} {velocity}") index = Channel.control( "ReadChuckIndex Y", "SetChuckIndex %f %f Y", """Control the chuck index (x, y) in micrometer (float, float).""", separator=" ", check_set_errors=True, ) class WaferMap(Channel): """A class representing the functions of the Wafermap module.""" end_reached = False """Get whether the end of the wafermap is reached or not (bool).""" def step_first_die(self): """Move the chuck to the first die and clear the the binning results. :return: List of the int containing the coordinates of the first die. - item[0]: X coordinate - item[1]: Y coordinate - item[2]: Current subdie index - item[3]: Total number of subdies in the die """ return self.values("StepFirstDie", separator=" ", cast=int, ) def step_next_die(self): """Move the chuck to the next logical die. :return: List of the int containing the coordinates of the new die. - item[0]: X coordinate - item[1]: Y coordinate - item[2]: Current subdie index - item[3]: Total number of subdies in the die """ return self.values("StepNextDie", separator=" ", cast=int, ) def step_to_die(self, x_pos, y_pos, s_pos=None): """Move the chuck to the specified die coordinates. :param int x_pos: X coordinate. :param int y_pos: Y coordinate. :param int s_pos: subdie index. """ coordinates = [x_pos, y_pos] if s_pos: coordinates.append(s_pos) _coord = " ".join(map(str, coordinates)) self.ask(f"StepNextDie {_coord}") enabled = Channel.measurement( "IsAppRegistered WaferMap", """Get whether the WaferMap module is loaded or not (bool).""", map_values=True, values={True: 1, False: 0} ) class Velox(SCPIMixin, Instrument): """A class representing the FormFactor Velox wafer prober. Example for a measurement of an entire wafer: .. code-block:: python from pymeasure.instruments.formfactor.velox import Velox prober = Velox("GPIB0::28::INSTR") # replace the resource to your needs coordinates = prober.wafermap.step_first_die() # move to the first die in the wafermap while not self.wafermap.end_reached: prober.chuck.move_contact() # move to contact height # ... # code for measurement, processing and storing data # ... prober.chuck.move_separation() # move to separation height coordinates = prober.wafermap.step_next_die() # move to the next die in the wafermap """ error_code = 0 error_message = "" chuck = Instrument.ChannelCreator(Chuck) wafermap = Instrument.ChannelCreator(WaferMap) def __init__(self, adapter, name="FormFactor Velox", timeout=40000, **kwargs): super().__init__( adapter, name, timeout=timeout, **kwargs ) @property def options(self): """Get the installed options. Raises *NotImplementedError* since command ``*OPT?`` is not implemented in Velox.""" raise NotImplementedError("*OPT? is not implemented in Velox.") version = Instrument.measurement( "ReportSoftwareVersion", """Get the main software version of Velox (str).""", ) def read(self): """ Read the response and check for errors. :raise: *ConnectionError* if an error is detected. """ self.error_code = 0 self.error_message = "" self.wafermap.end_reached = False got = super().read() # some commands like *IDN do not return '0: ...' # in such a case return the entire response string if ":" not in got: return got got = got.partition(":") self.error_code = int(got[0]) response = got[2].strip() if self.error_code: self.error_message = response if self.error_code == 703: # 703 means end of wafermap reached, it's not a hard error # more a status indicator, so it doesn't throw an exception self.wafermap.end_reached = True log.info(f"{self.error_code}: {self.error_message}") else: raise ConnectionError(f"{self.error_code}: {self.error_message}") return response def check_errors(self): """Invoke :meth:`read`. """ return self.read() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0185113 pymeasure-0.16.0/pymeasure/instruments/fwbell/0000755000175100017510000000000015203313301021125 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/fwbell/__init__.py0000644000175100017510000000225015203313266023247 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .fwbell5080 import FWBell5080 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/fwbell/fwbell5080.py0000644000175100017510000001240115203313266023277 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.validators import strict_discrete_set from time import sleep import numpy as np class FWBell5080(SCPIMixin, Instrument): """ Represents the F.W. Bell 5080 Handheld Gaussmeter and provides a high-level interface for interacting with the instrument :param port: The serial port of the instrument .. code-block:: python meter = FWBell5080('/dev/ttyUSB0') # Connects over serial port /dev/ttyUSB0 (Linux) meter.units = 'gauss' # Sets the measurement units to Gauss meter.range = 1 # Sets the range to 3 kG print(meter.field) # Reads and prints a field measurement in G fields = meter.fields(100) # Samples 100 field measurements print(fields.mean(), fields.std()) # Prints the mean and standard deviation of the samples """ def __init__(self, adapter, name="F.W. Bell 5080 Handheld Gaussmeter", **kwargs): kwargs.setdefault('timeout', 500) kwargs.setdefault('baudrate', 2400) super().__init__( adapter, name, **kwargs ) field = Instrument.measurement( ":MEASure:FLUX?", """ Measure the field in the appropriate units (float). """, # Remove units get_process=lambda v: float(v.replace('T', '').replace('G', '').replace('Am', '')) ) UNITS = { 'gauss': 'DC:GAUSS', 'gauss ac': 'AC:GAUSS', 'tesla': 'DC:TESLA', 'tesla ac': 'AC:TESLA', 'amp-meter': 'DC:AM', 'amp-meter ac': 'AC:AM' } units = Instrument.control( ":UNIT:FLUX?", ":UNIT:FLUX:%s", """ Get the field units (str), which can take the values: 'gauss', 'gauss ac', 'tesla', 'tesla ac', 'amp-meter', and 'amp-meter ac'. The AC versions configure the instrument to measure AC. """, validator=strict_discrete_set, values=UNITS, map_values=True ) range = Instrument.control( ":SENS:FLUX:RANG?", ":SENS:FLUX:RANG %d", """ Control the maximum field range in the active units (int). The range unit is dependent on the current units mode (gauss, tesla, amp-meter). Value sets an equivalent range across units that increases in magnitude (1, 10, 100). +--------+--------+---------+-----------+ | Value | gauss | tesla | amp-meter | +--------+--------+---------+-----------+ | 0 | 300 G | 30 mT | 23.88 kAm | +--------+--------+---------+-----------+ | 1 | 3 kG | 300 mT | 238.8 kAm | +--------+--------+---------+-----------+ | 2 | 30 kG | 3 T | 2388 kAm | +--------+--------+---------+-----------+ """, validator=strict_discrete_set, values=[0, 1, 2], cast=int ) def read(self): """ Overwrites the :meth:`Instrument.read ` method to remove semicolons and replace spaces with colons. """ # To set the unit mode to DC Tesla you need to write(':UNIT:FLUX:DC:TESLA') # However the response from ask(':UNIT:FLUX?') is "DC TESLA", with no colon. # We replace space with colon to preserve the mapping in UNITS. # Semicolons may be appended to end of response from FW Bell 5080, and are removed return super().read().replace(' ', ':').replace(';', '') def reset(self): """ Resets the instrument. """ self.clear() def fields(self, samples=1): """ Returns a numpy array of field samples for a given sample number. :param samples: The number of samples to preform """ if samples < 1: raise Exception("F.W. Bell 5080 does not support samples less than 1.") else: data = [self.field for i in range(int(samples))] return np.array(data, dtype=np.float64) def auto_range(self): """ Enables the auto range functionality. """ self.write(":SENS:FLUX:RANG:AUTO") # Instrument needs a delay before next command sleep(2) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/generic_types.py0000644000175100017510000000715615203313266023107 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from warnings import warn from .instrument import Instrument log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class SCPIMixin: """Mixin class for SCPI instruments with the default implementation of base SCPI commands.""" def __init__(self, *args, **kwargs): kwargs.setdefault("includeSCPI", False) # in order not to trigger the deprecation warning super().__init__(*args, **kwargs) # SCPI default properties complete = Instrument.measurement( "*OPC?", """Get the synchronization bit. This property allows synchronization between a controller and a device. The Operation Complete query places an ASCII character 1 into the device's Output Queue when all pending selected device operations have been finished. """, cast=str, ) status = Instrument.measurement( "*STB?", """Get the status byte and Master Summary Status bit.""", cast=str, ) options = Instrument.measurement( "*OPT?", """Get the device options installed.""", cast=str, ) id = Instrument.measurement( "*IDN?", """Get the identification of the instrument.""", cast=str, maxsplit=0, ) next_error = Instrument.measurement( "SYST:ERR?", """Get the next error in the queue. If you want to read and log all errors, use :meth:`check_errors` instead. """, ) # SCPI default methods def clear(self): """Clear the instrument status byte.""" self.write("*CLS") def reset(self): """Reset the instrument.""" self.write("*RST") def check_errors(self): """ Read all errors from the instrument. :return: List of error entries. """ errors = [] while True: err = self.next_error if int(err[0]) != 0: log.error(f"{self.name}: {err[0]}, {err[1]}") errors.append(err) else: break return errors class SCPIUnknownMixin(SCPIMixin): """Mixin which adds SCPI commands to an instrument from which it is not known whether it supports SCPI commands or not. """ def __init__(self, *args, **kwargs): warn("It is not known whether this device support SCPI commands or not. Please inform " "the pymeasure maintainers if you know the answer.", FutureWarning) super().__init__(*args, **kwargs) ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.019103 pymeasure-0.16.0/pymeasure/instruments/hcp/0000755000175100017510000000000015203313301020424 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hcp/__init__.py0000644000175100017510000000227115203313266022551 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .tc038d import TC038D from .tc038 import TC038 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hcp/tc038.py0000644000175100017510000001416115203313266021654 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from typing import Union from pymeasure.instruments import Instrument from pymeasure.adapters import Adapter from pyvisa.constants import Parity log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def _data_to_temp(data: str) -> float: """Convert the returned hex value "data" to a temperature in °C.""" return int(data[7:11], 16) / 10.0 # get the hex number, convert to int and shift the decimal sign registers: dict[str, str] = { "temperature": "D0002", "setpoint": "D0120", } def _check_errors(response: str) -> list[str]: """Return a list of error messages from the device response string.""" errors: dict[str, str] = { "02": "Command does not exist or is not executable.", "03": "Register number does not exist.", "04": "Out of setpoint range.", "05": "Out of data number range.", "06": "Executed monitor without specifying what to monitor.", "08": "Illegal parameter is set.", "42": "Sum does not match the expected value.", "43": "Data value greater than specified received.", "44": "End of data or end of text character is not received.", } if response[5:7] == "OK": return [] else: # got[5:7] == "ER" """If communication is completed abnormally, TC038 returns a character string “ER” and error code (EC1 and EC2)""" EC1 = response[7:9] if EC1 in ("03", "04", "05", "08"): EC2 = response[9:11] return [errors[EC1] + f" Wrong parameter has number {EC2}."] return [errors[EC1]] class TC038(Instrument): """ Communication with the HCP TC038 oven. This is the older version with an AC power supply and AC heater. It has parity or framing errors from time to time. Handle them in your application. The oven always responds with an "OK" to all valid requests or commands. :param adapter: Name of the COM-Port. :param name: Name of the instrument. :param address: Address of the device. Should be between 1 and 99. :param timeout: Timeout in ms. :param kwargs: Additional arguments for the Instrument base class. """ def __init__( self, adapter: Union[Adapter, int, str], name: str = "TC038", address: int = 1, timeout: int = 1000, **kwargs, ) -> None: super().__init__( adapter, name, timeout=timeout, write_termination="\r", read_termination="\r", parity=Parity.even, includeSCPI=False, **kwargs, ) self.address: int = address self.set_monitored_quantity() # start to monitor the temperature def write(self, command: str, **kwargs) -> None: """Send a `command` in its own protocol.""" # 010 is CPU (01) and time to wait (0), which are fix super().write(chr(2) + f"{self.address:02}" + "010" + command + chr(3), **kwargs) def read(self, **kwargs) -> str: """Do error checking on reading.""" # Response is chr(2) + address:02 + "01" + response + chr(3) got = super().read(**kwargs) errors = _check_errors(got) if errors: raise ConnectionError(errors[0]) return got def check_set_errors(self) -> list[str]: """Check for errors after having set a property. Called if :code:`check_set_errors=True` is set for that property. """ try: self.read() except ConnectionError as exc: log.exception("Setting a property failed.", exc_info=exc) raise else: return [] def set_monitored_quantity(self, quantity: str = "temperature") -> None: """ Configure the oven to monitor a certain `quantity`. `quantity` may be any key of `registers`. Default is the current temperature in °C. """ # WRS in order to setup to monitor a word # monitor 1 word # monitor the word in register D0002 self.ask(command="WRS" + "01" + registers[quantity]) setpoint = Instrument.control( "WRD" + registers["setpoint"] + ",01", "WWR" + registers["setpoint"] + ",01,%s", """Control the setpoint of the temperature controller in °C.""", get_process=_data_to_temp, set_process=lambda temp: f"{int(round(temp * 10)):04X}", check_set_errors=True, ) temperature = Instrument.measurement( "WRD" + registers["temperature"] + ",01", """Measure the current temperature in °C.""", get_process=_data_to_temp, ) monitored_value = Instrument.measurement( "WRM", """Measure the currently monitored value. For default it is the current temperature in °C.""", get_process=_data_to_temp, ) information = Instrument.measurement( "INF6", """Get the information about the device and its capabilities.""", get_process=lambda got: got[7:-1], ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hcp/tc038d.py0000644000175100017510000001502115203313266022014 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from enum import IntEnum from pymeasure.instruments import Instrument log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def CRC16(data): """Calculate the CRC16 checksum for the data byte array.""" CRC = 0xFFFF for octet in data: CRC ^= octet for j in range(8): lsb = CRC & 0x1 # least significant bit CRC = CRC >> 1 if lsb: CRC ^= 0xA001 return [CRC & 0xFF, CRC >> 8] class Functions(IntEnum): R = 0x03 WRITESINGLE = 0x06 ECHO = 0x08 # register address has to be 0 W = 0x10 # writing multiple variables class TC038D(Instrument): """ Communication with the HCP TC038D oven. This is the newer version with DC heating. The oven expects raw bytes written, no ascii code, and sends raw bytes. For the variables are two or four-byte modes available. We use the four-byte mode addresses. In that case element count has to be double the variables read. """ byteMode = 4 def __init__(self, adapter, name="TC038D", address=1, timeout=1000, **kwargs): """Initialize the device.""" super().__init__(adapter, name, timeout=timeout, includeSCPI=False, **kwargs) self.address = address def write(self, command): """Write a command to the device. :param str command: comma separated string of: - the function: read ('R') or write ('W') or 'echo', - the address to write to (e.g. '0x106' or '262'), - the values (comma separated) to write - or the number of elements to read (defaults to 1). """ function, address, *values = command.split(",") function = Functions[function] data = [self.address] # 1B device address data.append(function) # 1B function code address = int(address, 16) if "x" in address else int(address) data.extend(address.to_bytes(2, "big")) # 2B register address if function == Functions.W: elements = len(values) * self.byteMode // 2 data.extend(elements.to_bytes(2, "big")) # 2B number of elements data.append(elements * 2) # 1B number of bytes to write for element in values: data.extend(int(element).to_bytes(self.byteMode, "big", signed=True)) elif function == Functions.R: count = int(values[0]) * self.byteMode // 2 if values else self.byteMode // 2 data.extend(count.to_bytes(2, "big")) # 2B number of elements to read elif function == Functions.ECHO: data[-2:] = [0, 0] if values: data.extend(int(values[0]).to_bytes(2, "big")) # 2B test data data += CRC16(data) self.write_bytes(bytes(data)) def read(self): """Read response and interpret the number, returning it as a string.""" # Slave address, function got = self.read_bytes(2) if got[1] == Functions.R: # length of data to follow length = self.read_bytes(1) # data length, 2 Byte CRC read = self.read_bytes(length[0] + 2) if read[-2:] != bytes(CRC16(got + length + read[:-2])): raise ConnectionError("Response CRC does not match.") return str(int.from_bytes(read[:-2], byteorder="big", signed=True)) elif got[1] == Functions.W: # start address, number elements, CRC; each 2 Bytes long got += self.read_bytes(2 + 2 + 2) if got[-2:] != bytes(CRC16(got[:-2])): raise ConnectionError("Response CRC does not match.") elif got[1] == Functions.ECHO: # start address 0, data, CRC; each 2B got += self.read_bytes(2 + 2 + 2) if got[-2:] != bytes(CRC16(got[:-2])): raise ConnectionError("Response CRC does not match.") return str(int.from_bytes(got[-4:-2], "big")) else: # an error occurred # got[1] is functioncode + 0x80 end = self.read_bytes(3) # error code and CRC errors = {0x02: "Wrong start address.", 0x03: "Variable data error.", 0x04: "Operation error."} if end[0] in errors.keys(): raise ValueError(errors[end[0]]) else: raise ConnectionError(f"Unknown read error. Received: {got} {end}") def check_set_errors(self): """Check for errors after having set a property. Called if :code:`check_set_errors=True` is set for that property. """ try: self.read() except Exception as exc: log.exception("Setting a property failed.", exc_info=exc) raise else: return [] def ping(self, test_data=0): """Test the connection sending an integer up to 65535, checks the response.""" assert int(self.ask(f"ECHO,0,{test_data}")) == test_data setpoint = Instrument.control( "R,0x106", "W,0x106,%i", """Control the setpoint of the oven in °C.""", check_set_errors=True, get_process=lambda v: v / 10, set_process=lambda v: int(round(v * 10)), ) temperature = Instrument.measurement( "R,0x0", """Measure the current oven temperature in °C.""", get_process=lambda v: v / 10, ) ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.019404 pymeasure-0.16.0/pymeasure/instruments/heidenhain/0000755000175100017510000000000015203313301021746 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/heidenhain/__init__.py0000644000175100017510000000223615203313266024074 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .nd287 import ND287 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/heidenhain/nd287.py0000644000175100017510000001016315203313266023175 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pyvisa.errors import VisaIOError from pymeasure.instruments import Instrument log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class ND287(Instrument): """ Represents the Heidenhain ND287 position display unit used to readout and display absolute position measured by Heidenhain encoders. """ status = Instrument.measurement( "\x1BA0800", "Get the encoder's status bar" ) # get_process lambda functions used in the position property position_get_process_map = { "mm": lambda p: float(p.split("\x02")[-1]) * 1e-4, "inch": lambda p: float(p.split("\x02")[-1]) * 1e-5 } position = Instrument.measurement( "\x1BA0200", """Measure the encoder's current position (float). Note that the get_process performs a mapping from the returned value to a float measured in the units specified by :attr:`.ND287.units`. The get_process is modified dynamically as this mapping changes slightly between different units.""", get_process=position_get_process_map["mm"], dynamic=True ) def __init__(self, adapter, name="Heidenhain ND287", units="mm", **kwargs): """ Initialize the nd287 with a carriage return write termination. :param: units: Specify the units that the gauge is working in. Valid values are "inch" and "mm" with "mm" being the default. """ self._units = units super().__init__( adapter, name, includeSCPI=False, write_termination="\r", **kwargs ) @property def id(self): """ Get the string identification property for the device. """ self.write("\x1BA0000") id_str = self.read_bytes(37).decode("utf-8") return id_str @property def units(self): """ Control the unit of measure set on the device. Valid values are 'mm' and 'inch' Note that this parameter can only be set manually on the device. So this argument only ensures that the instance units and physical device settings match. I.e., this property does not change any physical device setting. """ return self._units @units.setter def units(self, unit): if unit in self.position_get_process_map.keys(): self._units = unit self.position_get_process = self.position_get_process_map[unit] def check_errors(self): """ Method to read an error status message and log when an error is detected. :return: String with the error message as its contents. """ self.write("\x1BA0301") try: err_str = self.read_bytes(36).decode("utf-8") except VisaIOError: err_str = None if err_str is not None: log.error("Heidenhain ND287 error message received: %s" % err_str) return err_str ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.021515 pymeasure-0.16.0/pymeasure/instruments/hp/0000755000175100017510000000000015203313301020261 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/__init__.py0000644000175100017510000000313615203313266022407 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .hp33120A import HP33120A from .hp34401A import HP34401A from .hp3478A import HP3478A from .hp3437A import HP3437A from .hp8116a import HP8116A from .hp8657b import HP8657B from .hp856Xx import HP8560A from .hp856Xx import HP8561B from .hp8753e import HP8753E from .hp11713a import HP11713A from .hp437b import HP437B from .hpsystempsu import HP6632A from .hpsystempsu import HP6633A from .hpsystempsu import HP6634A from .hplegacyinstrument import HPLegacyInstrument ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp11713a.py0000644000175100017510000001432415203313266022016 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, Channel log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) Attenuator_11dB = { 0: (False, False, False, False), 1: (True, False, False, False), 2: (False, True, False, False), 3: (True, True, False, False), 4: (False, False, False, True), 5: (True, False, False, True), 6: (False, True, False, True), 7: (True, True, False, True), 8: (False, False, True, True), 9: (True, False, True, True), 10: (False, True, True, True), 11: (True, True, True, True), } """ Mapping of logical values for use with 0 - 11 dB attenuators """ Attenuator_110dB = { 0: (False, False, False, False), 10: (True, False, False, False), 20: (False, True, False, False), 30: (True, True, False, False), 40: (False, False, False, True), 50: (True, False, False, True), 60: (False, True, False, True), 70: (True, True, False, True), 80: (False, False, True, True), 90: (True, False, True, True), 100: (False, True, True, True), 110: (True, True, True, True), } """ Mapping of logical values for use with 0 - 110 dB attenuators """ Attenuator_70dB_3_Section = { 0: (False, False, False, False), 10: (True, False, False, False), 20: (False, True, False, False), 30: (True, True, False, False), 40: (False, False, True, False), 50: (True, False, True, False), 60: (False, True, True, False), 70: (True, True, True, False), } """ Mapping of logical values for use with 0 - 70 dB attenuators with 3 switching sections """ Attenuator_70dB_4_Section = { 0: (False, False, False, False), 10: (True, False, False, False), 20: (False, False, False, True), 30: (True, False, False, True), 40: (False, True, False, True), 50: (True, True, False, True), 60: (False, True, True, True), 70: (True, True, True, True), } """ Mapping of logical values for use with 0 - 70 dB attenuators with 4 switching sections """ class SwitchDriverChannel(Channel): enabled = Instrument.setting( "%s{ch}", """ Set this channel to the polarity 'A' for True and 'B' for False. """, map_values=True, values={True: "A", False: "B"} ) class HP11713A(Instrument): """ Represents the HP 11713A Switch and Attenuator Driver and provides a high-level interface for interacting with the instrument. Usually an attenuator is hooked to either X or Y or X and Y. To ease the control of the attenuator driver you have the possibility to set an attenuator type via the attribute 'ATTENUATOR_X' or 'ATTENUATOR_Y'. The hp11713a keeps different default attenuator mappings. After setting the attenuator type you are able to use the methods 'attenuation_x' and/or 'attenuation_y' to set the switch driver to the correct value for the specified attenuation. The attenuation values are rounded. .. code-block:: python from pymeasure.instruments.hp import HP11713A from pymeasure.instruments.hp.hp11713a import Attenuator_110dB sd = HP11713A("GPIB::1") sd.ATTENUATOR_Y = Attenuator_110dB sd.attenuation_y(10) sd.ch_0.enabled = True """ ATTENUATOR_X = {} ATTENUATOR_Y = {} channels = Instrument.MultiChannelCreator(SwitchDriverChannel, list(range(0, 9))) def __init__(self, adapter, name="Hewlett-Packard HP11713A", **kwargs): super().__init__( adapter, name, includeSCPI=False, send_end=True, **kwargs, ) def attenuation_x(self, attenuation): """ Set switches according to the attenuation in dB for X The set attenuation will be rounded to the next available step. An attenuation mapping has to be set in before e.g. .. code-block:: python from pymeasure.instruments.hp.hp11713a import HP11713A, Attenuator_110dB instr.ATTENUATOR_X = Attenuator_110dB instr.attenuation_x(10) """ rounding = 0 if list(self.ATTENUATOR_X.keys())[1] == 10: rounding = -1 self.ch_1.enabled, self.ch_2.enabled, self.ch_3.enabled, self.ch_4.enabled = \ self.ATTENUATOR_X[int(round(attenuation, rounding))] def attenuation_y(self, attenuation): """ Set switches according to the attenuation in dB for Y The set attenuation will be rounded to the next available step. An attenuation mapping has to be set in before e.g. .. code-block:: python from pymeasure.instruments.hp.hp11713a import HP11713A, Attenuator_110dB instr.ATTENUATOR_Y = Attenuator_110dB instr.attenuation_y(10) """ rounding = 0 if list(self.ATTENUATOR_Y.keys())[1] == 10: rounding = -1 self.ch_5.enabled, self.ch_6.enabled, self.ch_7.enabled, self.ch_8.enabled = \ self.ATTENUATOR_Y[int(round(attenuation, rounding))] def deactivate_all(self): """ Deactivate all switches to polarity 'B'. """ self.write("B1234567890") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp33120A.py0000644000175100017510000001454415203313266021756 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class HP33120A(SCPIUnknownMixin, Instrument): """ Represents the Hewlett Packard 33120A Arbitrary Waveform Generator and provides a high-level interface for interacting with the instrument. """ def __init__(self, adapter, name="Hewlett Packard 33120A Function Generator", **kwargs): super().__init__( adapter, name, **kwargs ) self.amplitude_units = 'Vpp' SHAPES = { 'sinusoid': 'SIN', 'square': 'SQU', 'triangle': 'TRI', 'ramp': 'RAMP', 'noise': 'NOIS', 'dc': 'DC', 'user': 'USER' } shape = Instrument.control( "SOUR:FUNC:SHAP?", "SOUR:FUNC:SHAP %s", """Control the shape of the wave, which can take the values: sinusoid, square, triangle, ramp, noise, dc, and user. (str)""", validator=strict_discrete_set, values=SHAPES, map_values=True ) frequency = Instrument.control( "SOUR:FREQ?", "SOUR:FREQ %g", """Control the frequency of the output in Hz. The allowed range depends on the waveform shape and can be queried with :attr:`~.max_frequency` and :attr:`~.min_frequency`. (float)""" ) max_frequency = Instrument.measurement( "SOUR:FREQ? MAX", """ Get the maximum :attr:`~.HP33120A.frequency` in Hz for the given shape """ ) min_frequency = Instrument.measurement( "SOUR:FREQ? MIN", """ Get the minimum :attr:`~.HP33120A.frequency` in Hz for the given shape """ ) amplitude = Instrument.control( "SOUR:VOLT?", "SOUR:VOLT %g", """ Control the voltage amplitude of the output signal. The default units are in peak-to-peak Volts, but can be controlled by :attr:`~.amplitude_units`. The allowed range depends on the waveform shape and can be queried with :attr:`~.max_amplitude` and :attr:`~.min_amplitude`. (float)""" ) max_amplitude = Instrument.measurement( "SOUR:VOLT? MAX", """ Get the maximum :attr:`~.amplitude` in Volts for the given shape """ ) min_amplitude = Instrument.measurement( "SOUR:VOLT? MIN", """ Get the minimum :attr:`~.amplitude` in Volts for the given shape """ ) offset = Instrument.control( "SOUR:VOLT:OFFS?", "SOUR:VOLT:OFFS %g", """ Control the amplitude voltage offset in Volts. The allowed range depends on the waveform shape and can be queried with :attr:`~.max_offset` and :attr:`~.min_offset`. """ ) max_offset = Instrument.measurement( "SOUR:VOLT:OFFS? MAX", """ Get the maximum :attr:`~.offset` in Volts for the given shape """ ) min_offset = Instrument.measurement( "SOUR:VOLT:OFFS? MIN", """ Get the minimum :attr:`~.offset` in Volts for the given shape """ ) AMPLITUDE_UNITS = {'Vpp': 'VPP', 'Vrms': 'VRMS', 'dBm': 'DBM', 'default': 'DEF'} amplitude_units = Instrument.control( "SOUR:VOLT:UNIT?", "SOUR:VOLT:UNIT %s", """ Control the units of the amplitude, which can take the values Vpp, Vrms, dBm, and default. (str) """, validator=strict_discrete_set, values=AMPLITUDE_UNITS, map_values=True ) burst_enabled = Instrument.control( "BM:STATE?", "BM:STATE %d", """Control state of burst modulation""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) burst_source = Instrument.control( "BM:SOURCE?", "BM:SOURCE %s", """Control internal or external gate source for burst modulation""", validator=strict_discrete_set, values=['INT', 'EXT'], ) burst_count = Instrument.control( "BM:NCYC?", "BM:NCYC %d", """Control the number of cycles per burst (1 to 50,000 cycles)""", ) min_burst_count = Instrument.measurement( "BM:NCYC? MIN", """Get the minimum :attr:`~.HP33120A.burst_count`""" ) max_burst_count = Instrument.measurement( "BM:NCYC? MAX", """Get the maximum :attr:`~.HP33120A.burst_count`""" ) burst_rate = Instrument.control( "BM:INT:RATE?", "BM:INT:RATE %g", """Control the burst rate in Hz fo an internal burst source""" ) min_burst_rate = Instrument.measurement( "BM:INT:RATE? MIN", """Get the minimum :attr:`~.HP33120A.burst_rate`""" ) max_burst_rate = Instrument.measurement( "BM:INT:RATE? MAX", """Get the maximum :attr:`~.HP33120A.burst_rate`""" ) burst_phase = Instrument.control( "BM:PHAS?", "BM:PHAS %g", """Control the starting phase angle of a burst (-360 to +360 degrees)""" ) min_burst_phase = Instrument.measurement( "BM:PHAS? MIN", """Get the minimum :attr:`~.HP33120A.burst_phase`""" ) max_burst_phase = Instrument.measurement( "BM:PHAS? MAX", """Get the maximum :attr:`~.HP33120A.burst_phase`""" ) def beep(self): """ Causes a system beep. """ self.write("SYST:BEEP") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp3437A.py0000644000175100017510000002544615203313266021711 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import ctypes import logging import math from enum import IntFlag import numpy as np from pymeasure.instruments.hp.hplegacyinstrument import HPLegacyInstrument, StatusBitsBase from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) c_uint8 = ctypes.c_uint8 c_uint16 = ctypes.c_uint16 c_uint32 = ctypes.c_uint32 class Status(StatusBitsBase): """ A bitfield structure containing the assignments for the status decoding """ _pack_ = 1 _fields_ = [ # Byte 0: Function, Range and Number of Digits ("Format", c_uint8, 1), # Bit 7 ("SRQ", c_uint8, 3), # bit 4..6 ("Trigger", c_uint8, 2), # bit 2..3 ("Range", c_uint8, 2), # bit 0..1 # Byte 1 & 2: ("Number", c_uint16, 16), # Byte 1: # ("NRDGS_MSD", c_uint8, 4), # ("NRDGS_2SD", c_uint8, 4), # Byte 2: # ("NRDGS_3SD", c_uint8, 4), # ("NRDGS_LSD", c_uint8, 4), ("not_used", c_uint8, 4), ("Delay", c_uint32, 28), # Byte 3: # ("Not_Used", c_uint8, 4), # ("Delay_MSD", c_uint8, 4), # Byte 4: # ("Delay_2SD", c_uint8, 4), # ("Delay_3SD", c_uint8, 4), # Byte 5: # ("Delay_4SD", c_uint8, 4), # ("Delay_5SD", c_uint8, 4), # Byte 6: # ("Delay_6SD", c_uint8, 4), # ("Delay_LSD", c_uint8, 4), ] @staticmethod def _decode_range(r): """Method to decode current range :param range_undecoded: int to be decoded :return cur_range: float value representing the active measurement range :rtype cur_range: float """ # range decoding # (cf table 3-2, page 3-5 of the manual, HPAK document 9018-05946) decode_map = { 0: math.nan, 1: 0.1, 2: 10.0, 3: 1.0, } return decode_map[r] @staticmethod def _decode_trigger(t): """Method to decode trigger mode :param status_bytes: list of bytes to be decoded :return trigger_mode: string with the current trigger mode :rtype trigger_mode: str """ decode_map = { 0: "INVALID", 1: "internal", 2: "external", 3: "hold/manual" } return decode_map[t] _get_process_ = { "Number": StatusBitsBase._convert_from_bcd, "Delay": StatusBitsBase._convert_from_bcd, "Range": _decode_range, "Trigger": _decode_trigger, } def __str__(self): """ Returns a pretty formatted string showing the status of the instrument """ ret_str = "" for field in self._fields_: ret_str = ret_str + f"{field[0]}: {getattr(self, field[0])}\n" return ret_str class PackedBits(ctypes.BigEndianStructure): """ A bitfield structure containing the assignments for the data transfer in packed/binary mode """ _pack_ = 1 _fields_ = [ ("range", c_uint8, 2), # bit 0..1 ("sign_bit", c_uint8, 1), ("MSD", c_uint8, 1), ("SSD", c_uint8, 4), ("TSD", c_uint8, 4), ("LSD", c_uint8, 4), ] def __float__(self): """ Return a float value from the packed data of the HP3437A """ # range decoding # (cf table 3-2, page 3-5 of the manual, HPAK document 9018-05946) decode_map = { 1: 0.1, 2: 10.0, 3: 1.0, } cur_range = decode_map[self.range] signbit = 1 if self.sign_bit == 0: signbit = -1 return ( cur_range * signbit * ( self.MSD + self.SSD / 10 + self.TSD / 100 + self.LSD / 1000 ) ) class HP3437A(HPLegacyInstrument): """Represents the Hewlett Packard 3737A system voltmeter and provides a high-level interface for interacting with the instrument. """ status_desc = Status pb_desc = PackedBits def __init__(self, adapter, name="Hewlett-Packard HP3437A", **kwargs): super().__init__( adapter, name, **kwargs, ) # Definitions for different specifics of this instrument RANGE = { 1e-1: "R1", 1: "R2", 10: "R3", } TRIGGERS = { "internal": "T1", "external": "T2", "hold": "T3", "manual": "T3", } class SRQ(IntFlag): """Enum element for SRQ mask bit decoding""" DATA_READY = 4 IGNORE_TRIGGER = 2 INVALID_PROGRAM = 1 def _unpack_data(self, data): """ Method to unpack the data from the returned bytes in packed mode :param data: list of bytes to be decoded :return ret_data: float value """ ret_data = PackedBits.from_buffer(bytearray(data)) return float(ret_data) # commands overwriting the base implementation def read_data(self): """ Reads measured data from instrument, returns a np.array. (This function also takes care of unpacking the data if required) :return data: np.array containing the data """ # Adjusting the timeout to match the number of counts and the delay current_timeout = self.adapter.connection.timeout time_needed = self.number_readings * self.delay new_timeout = min(1e6, time_needed * 3 * 1000) # safety factor 3 if new_timeout > current_timeout: if new_timeout >= 1e6: # Disables timeout if measurement would take more then 1000 sec log.info("HP3437A: timeout deactivated") self.adapter.connection.timeout = new_timeout log.info("HP3437A: timeout changed to %g", new_timeout) read_data = self.read_bytes(-1) # check if data is in packed format format if self.talk_ascii: return_value = np.array(read_data[:-2].decode("ASCII").split(","), dtype=float) else: processed_data = [] for i in range(0, len(read_data), 2): processed_data.append(self._unpack_data(read_data[i : i + 2])) # noqa: E203 return_value = np.array(processed_data) self.adapter.connection.timeout = current_timeout return return_value # commands/properties for instrument control def check_errors(self): """ As this instrument does not have a error indication bit, this function always returns an empty list. """ return [] @property def talk_ascii(self): """ A boolean property, True if the instrument is set to ASCII-based communication. This property can be set. """ return bool(self.status.Format) @talk_ascii.setter def talk_ascii(self, value): if value: self.write("F1") else: self.write("F2") @property def delay(self): """Return the value (float) for the delay between two measurements, this property can be set, valid range: 100ns - 0.999999s """ return self.status.Delay * 1e-7 @delay.setter def delay(self, value): delay_str = ( "D." + format(strict_range(value, [0, 0.9999999]) * 10e6, "07.0f") + "S" ) self.write(delay_str) @property def number_readings(self): """Return value (int) for the number of consecutive measurements, this property can be set, valid range: 0 - 9999 """ return self.status.Number @number_readings.setter def number_readings(self, value): number_str = "N" + str(strict_range(value, [0, 9999])) + "S" self.write(number_str) @property def range(self): """Return the current measurement voltage range. This property can be set, valid values: 0.1, 1, 10 (V). .. Note:: This instrument does not have autorange capability. Overrange will be in indicated as 0.99,9.99 or 99.9 """ return self.status.Range @range.setter def range(self, value): range_str = "R" + format( round(math.log10(strict_discrete_set(value, [0.1, 1, 10])) + 2), "d" ) self.write(range_str) @property def SRQ_mask(self): """Return current SRQ mask, this property can be set, bit assignment for SRQ: ========= ========================== Bit (dec) Description ========= ========================== 1 SRQ when invalid program 2 SRQ when trigger is ignored 4 SRQ when data ready ========= ========================== """ mask = self.status.SRQ return self.SRQ(mask) @SRQ_mask.setter def SRQ_mask(self, value): mask_str = "E" + format(strict_range(value, [0, 7]), "o") + "S" self.write(mask_str) @property def trigger(self): """Return current selected trigger mode, this property can be set, Possible values are: =========== =========================================== Value Explanation =========== =========================================== internal automatic trigger (internal) external external trigger (connector on back or GET) hold/manual holds the measurement/issues a manual trigger =========== =========================================== """ return self.status.Trigger @trigger.setter def trigger(self, value): trig_set = self.TRIGGERS[strict_discrete_set(value, self.TRIGGERS)] self.write(trig_set) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp34401A.py0000644000175100017510000003221415203313266021753 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from warnings import warn from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set deprecated_text = """ .. deprecated:: 0.12 Use the :code:`function_` and :code:`reading` properties instead. """ def _deprecation_warning(property_name): def func(x): warn(f'Deprecated property name "{property_name}", use the "function_" ' 'and "reading" properties instead.', FutureWarning) return x return func class HP34401A(SCPIUnknownMixin, Instrument): """ Represents the HP / Agilent / Keysight 34401A Multimeter and provides a high-level interface for interacting with the instrument. .. code-block:: python dmm = HP34401A("GPIB::1") dmm.function_ = "DCV" print(dmm.reading) # -> Single float reading dmm.nplc = 0.02 dmm.autozero_enabled = False dmm.trigger_count = 100 dmm.trigger_delay = "MIN" print(dmm.reading) # -> Array of 100 very fast readings """ FUNCTIONS = {"DCV": "VOLT", "DCV_RATIO": "VOLT:RAT", "ACV": "VOLT:AC", "DCI": "CURR", "ACI": "CURR:AC", "R2W": "RES", "R4W": "FRES", "FREQ": "FREQ", "PERIOD": "PER", "CONTINUITY": "CONT", "DIODE": "DIOD"} FUNCTIONS_WITH_RANGE = { "DCV": "VOLT", "ACV": "VOLT:AC", "DCI": "CURR", "ACI": "CURR:AC", "R2W": "RES", "R4W": "FRES", "FREQ": "FREQ", "PERIOD": "PER"} BOOL_MAPPINGS = {True: 1, False: 0} # Below: stop_bits: 20 comes from # https://pyvisa.readthedocs.io/en/latest/api/constants.html#pyvisa.constants.StopBits def __init__(self, adapter, name="HP 34401A", **kwargs): super().__init__( adapter, name, asrl={'baud_rate': 9600, 'data_bits': 8, 'parity': 0, 'stop_bits': 20}, **kwargs ) # Log a deprecated warning for the old function property voltage_ac = Instrument.measurement("MEAS:VOLT:AC? DEF,DEF", "AC voltage, in Volts" + deprecated_text, get_process=_deprecation_warning('voltage_ac')) current_dc = Instrument.measurement("MEAS:CURR:DC? DEF,DEF", "DC current, in Amps" + deprecated_text, get_process=_deprecation_warning('current_dc')) current_ac = Instrument.measurement("MEAS:CURR:AC? DEF,DEF", "AC current, in Amps" + deprecated_text, get_process=_deprecation_warning('current_ac')) resistance = Instrument.measurement("MEAS:RES? DEF,DEF", "Resistance, in Ohms" + deprecated_text, get_process=_deprecation_warning('resistance')) resistance_4w = Instrument.measurement( "MEAS:FRES? DEF,DEF", "Four-wires (remote sensing) resistance, in Ohms" + deprecated_text, get_process=_deprecation_warning('resistance_4w')) function_ = Instrument.control( "FUNC?", "FUNC \"%s\"", """Control the measurement function. Allowed values: "DCV", "DCV_RATIO", "ACV", "DCI", "ACI", "R2W", "R4W", "FREQ", "PERIOD", "CONTINUITY", "DIODE".""", validator=strict_discrete_set, values=FUNCTIONS, map_values=True, get_process=lambda v: v.strip('"'), ) range_ = Instrument.control( "{function_prefix_for_range}:RANG?", "{function_prefix_for_range}:RANG %s", """Control the range for the currently active function. For frequency and period measurements, ranging applies to the signal's input voltage, not its frequency""", ) autorange = Instrument.control( "{function_prefix_for_range}:RANG:AUTO?", "{function_prefix_for_range}:RANG:AUTO %d", """Control the autorange state for the currently active function.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) resolution = Instrument.control( "{function}:RES?", "{function}:RES %g", """Control the resolution of the measurements. Not valid for frequency, period, or ratio. Specify the resolution in the same units as the measurement function, not in number of digits. Results in a "Settings Conflict" error if autorange is enabled. MIN selects the smallest value accepted, which gives the most resolution. MAX selects the largest value accepted which gives the least resolution.""", ) nplc = Instrument.control( "{function}:NPLC?", "{function}:NPLC %s", """Control the integration time in number of power line cycles (NPLC). Valid values: 0.02, 0.2, 1, 10, 100, "MIN", "MAX". This command is valid only for dc volts, ratio, dc current, 2-wire ohms, and 4-wire ohms.""", validator=strict_discrete_set, values=[0.02, 0.2, 1, 10, 100, "MIN", "MAX"], ) gate_time = Instrument.control( "{function}:APER?", "{function}:APER %s", """Control the gate time (or aperture time) for frequency or period measurements. Valid values: 0.01, 0.1, 1, "MIN", "MAX". Specifically: 10 ms (4.5 digits), 100 ms (default; 5.5 digits), or 1 second (6.5 digits).""", validator=strict_discrete_set, values=[0.01, 0.1, 1, "MIN", "MAX"], ) detector_bandwidth = Instrument.control( "DET:BAND?", "DET:BAND %s", """Control the lowest frequency expected in the input signal in Hertz. Valid values: 3, 20, 200, "MIN", "MAX".""", validator=strict_discrete_set, values=[3, 20, 200, "MIN", "MAX"], ) autozero_enabled = Instrument.control( "ZERO:AUTO?", "ZERO:AUTO %s", """Control the autozero state.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) def trigger_single_autozero(self): """Trigger an autozero measurement. Consequent autozero measurements are disabled.""" self.write("ZERO:AUTO ONCE") auto_input_impedance_enabled = Instrument.control( "INP:IMP:AUTO?", "INP:IMP:AUTO %s", """Control if automatic input resistance mode is enabled. Only valid for dc voltage measurements. When disabled (default), the input resistance is fixed at 10 MOhms for all ranges. With AUTO ON, the input resistance is set to >10 GOhms for the 100 mV, 1 V, and 10 V ranges.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) terminals_used = Instrument.measurement( "ROUT:TERM?", """Query the multimeter to determine if the front or rear input terminals are selected. Returns "FRONT" or "REAR".""", values={"FRONT": "FRON", "REAR": "REAR"}, map_values=True, ) # Trigger related commands def init_trigger(self): """Set the state of the triggering system to "wait-for-trigger". Measurements will begin when the specified trigger conditions are satisfied after this command is received.""" self.write("INIT"), reading = Instrument.measurement( "READ?", """Take a measurement of the currently selected function. Reading this property is equivalent to calling `init_trigger()`, waiting for completion and fetching the reading(s).""", ) trigger_source = Instrument.control( "TRIG:SOUR?", "TRIG:SOUR %s", """Control the trigger source. Valid values: "IMM", "BUS", "EXT" The multimeter will accept a software (bus) trigger, an immediate internal trigger (this is the default source), or a hardware trigger from the rear-panel Ext Trig (external trigger) terminal.""", validator=strict_discrete_set, values=["IMM", "BUS", "EXT"], ) trigger_delay = Instrument.control( "TRIG:DEL?", "TRIG:DEL %s", """Control the trigger delay in seconds. Valid values (incl. floats): 0 to 3600 seconds, "MIN", "MAX".""", ) trigger_auto_delay_enabled = Instrument.control( "TRIG:DEL:AUTO?", "TRIG:DEL:AUTO %s", """Control the automatic trigger delay state. If enabled, the delay is determined by function, range, integration time, and ac filter setting. Selecting a specific trigger delay value automatically turns off the automatic trigger delay.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) sample_count = Instrument.control( "SAMP:COUN?", "SAMP:COUN %s", """Controls the number of samples per trigger event. Valid values: 1 to 50000, "MIN", "MAX".""", ) trigger_count = Instrument.control( "TRIG:COUN?", "TRIG:COUN %s", """Control the number of triggers accepted before returning to the "idle" state. Valid values: 1 to 50000, "MIN", "MAX", "INF". The INFinite parameter instructs the multimeter to continuously accept triggers (you must send a device clear to return to the "idle" state).""", ) stored_reading = Instrument.measurement( "FETC?", """Measure the reading(s) currently stored in the multimeter's internal memory. Reading this property will NOT initialize a trigger. If you need that, use the `reading` property instead.""", ) # Display related commands display_enabled = Instrument.control( "DISP?", "DISP %s", """Control the display state.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) displayed_text = Instrument.control( "DISP:TEXT?", "DISP:TEXT \"%s\"", """Control the text displayed on the multimeter's display. The text can be up to 12 characters long; any additional characters are truncated my the multimeter.""", get_process=lambda x: x.strip('"'), ) # System related commands remote_control_enabled = Instrument.control( "SYST: ", "SYST:%s", """Control whether remote control is enabled.""", validator=strict_discrete_set, values={True: "REM", False: "LOC"}, map_values=True, ) remote_lock_enabled = Instrument.control( "SYST: ", "SYST:%s", """Control whether the beeper is enabled.""", validator=strict_discrete_set, values={True: "RWL", False: "LOC"}, map_values=True, ) def beep(self): """This command causes the multimeter to beep once.""" self.write("SYST:BEEP") beeper_enabled = Instrument.control( "SYST:BEEP:STAT?", "SYST:BEEP:STAT %s", """Control whether the beeper is enabled.""", validator=strict_discrete_set, values=BOOL_MAPPINGS, map_values=True, ) scpi_version = Instrument.measurement( "SYST:VERS?", """The SCPI version of the multimeter.""", ) stored_readings_count = Instrument.measurement( "DATA:POIN?", """The number of readings currently stored in the internal memory.""", ) self_test_result = Instrument.measurement( "*TST?", """Initiate a self-test of the multimeter and return the result. Be sure to set an appropriate connection timeout, otherwise the command will fail.""", ) def write(self, command): """Write a command to the instrument.""" if "{function_prefix_for_range}" in command: command = command.replace("{function_prefix_for_range}", self._get_function_prefix_for_range()) elif "{function}" in command: command = command.replace("{function}", HP34401A.FUNCTIONS[self.function_]) super().write(command) def _get_function_prefix_for_range(self): function_prefix = HP34401A.FUNCTIONS_WITH_RANGE[self.function_] if function_prefix in ["FREQ", "PER"]: function_prefix += ":VOLT" return function_prefix ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp3478A.py0000644000175100017510000004362615203313266021716 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import ctypes import logging import math from enum import IntFlag from pymeasure.instruments.hp.hplegacyinstrument import HPLegacyInstrument, StatusBitsBase from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) c_uint8 = ctypes.c_uint8 class SRQ(ctypes.BigEndianStructure): """Support class for the SRQ handling """ _fields_ = [ ("power_on", c_uint8, 1), ("not_assigned_1", c_uint8, 1), ("calibration", c_uint8, 1), ("front_panel_button", c_uint8, 1), ("internal_error", c_uint8, 1), ("syntax_error", c_uint8, 1), ("not_assigned_2", c_uint8, 1), ("data_ready", c_uint8, 1), ] def __str__(self): """ Returns a pretty formatted string showing the status of the instrument """ ret_str = "" for field in self._fields_: ret_str = ret_str + f"{field[0]}: {hex(getattr(self, field[0]))}\n" return ret_str class Status(StatusBitsBase): """ Support-Class with the bit assignments for the 5 status byte of the HP3478A """ _fields_ = [ # Byte 1: Function, Range and Number of Digits ("function", c_uint8, 3), # bit 5..7 ("range", c_uint8, 3), # bit 2..4 ("digits", c_uint8, 2), # bit 0..1 # Byte 2: Status Bits ("res1", c_uint8, 1), ("ext_trig", c_uint8, 1), ("cal_enable", c_uint8, 1), ("front_rear", c_uint8, 1), ("fifty_hz", c_uint8, 1), ("auto_zero", c_uint8, 1), ("auto_range", c_uint8, 1), ("int_trig", c_uint8, 1), # Byte 3: Serial Poll Mask (SRQ) # ("SRQ_PON", c_uint8, 1), # ("res3", c_uint8, 1), # ("SRQ_cal_error", c_uint8, 1), # ("SRQ_front_panel", c_uint8, 1), # ("SRQ_internal_error", c_uint8, 1), # ("SRQ_syntax_error", c_uint8, 1), # ("res2", c_uint8, 1), # ("SRQ_data_rdy", c_uint8, 1), ("SRQ", SRQ), # Byte 4: Error Information # ("res5", c_uint8, 1), # ("res4", c_uint8, 1), # ("ERR_AD_Link", c_uint8, 1), # ("ERR_AD", c_uint8, 1), # ("ERR_slope", c_uint8, 1), # ("ERR_ROM", c_uint8, 1), # ("ERR_RAM", c_uint8, 1), # ("ERR_cal", c_uint8, 1), ("Error_Status", c_uint8, 8), # Byte 5: DAC Value ("DAC_value", c_uint8, 8), ] class HP3478A(HPLegacyInstrument): """ Represents the Hewlett Packard 3478A 5 1/2 digit multimeter and provides a high-level interface for interacting with the instrument. """ status_desc = Status def __init__(self, adapter, name="Hewlett-Packard HP3478A", **kwargs): kwargs.setdefault('read_termination', '\r\n') kwargs.setdefault('send_end', True) super().__init__( adapter, name, **kwargs, ) # Definitions for different specifics of this instrument MODES = {"DCV": "F1", "ACV": "F2", "R2W": "F3", "R4W": "F4", "DCI": "F5", "ACI": "F6", "Rext": "F7", } INV_MODES = {v: k for k, v in MODES.items()} RANGES = {"DCV": {3E-2: "R-2", 3E-1: "R-1", 3: "R0", 30: "R1", 300: "R2", "auto": "RA"}, "ACV": {3E-1: "R-1", 3: "R0", 30: "R1", 300: "R2", "auto": "RA"}, "R2W": {30: "R1", 300: "R2", 3E3: "R3", 3E4: "R4", 3E5: "R5", 3E6: "R6", 3E7: "R7", "auto": "RA"}, "R4W": {30: "R1", 300: "R2", 3E3: "R3", 3E4: "R4", 3E5: "R5", 3E6: "R6", 3E7: "R7", "auto": "RA"}, "DCI": {3E-1: "R-1", 3: "R0", "auto": "RA"}, "ACI": {3E-1: "R-1", 3: "R0", "auto": "RA"}, "Rext": {3E7: "R7", "auto": "RA"}, } TRIGGERS = { "auto": "T1", "internal": "T1", "external": "T2", "single": "T3", "hold": "T4", "fast": "T5", } class ERRORS(IntFlag): """Enum element for errror bit decoding """ AD_LINK = 32 # AD link error AD_SELFCHK = 16 # AD self check error AD_SLOPE = 8 # AD slope error ROM = 4 # Control ROM error RAM = 2 # RAM selftest failed CALIBRATION = 1 # Calibration checksum error or cal range issue NO_ERR = 0 # Should be obvious # commands/properties for instrument control @property def active_connectors(self): """Return selected connectors ("front"/"back"), based on front-panel selector switch """ selection = self.status.front_rear if selection == 1: return "front" else: return "back" @property def auto_range_enabled(self): """ Property describing the auto-ranging status ====== ============================================ Value Status ====== ============================================ True auto-range function activated False manual range selection / auto-range disabled ====== ============================================ The range can be set with the :py:attr:`range` property """ selection = self.status.auto_range return bool(selection) @property def auto_zero_enabled(self): """ Return auto-zero status, this property can be set ====== ================== Value Status ====== ================== True auto-zero active False auto-zero disabled ====== ================== """ selection = self.status.auto_zero return bool(selection) @auto_zero_enabled.setter def auto_zero_enabled(self, value): az_set = int(value) az_str = "Z" + str(int(strict_discrete_set(az_set, [0, 1]))) self.write(az_str) @property def calibration_enabled(self): """Return calibration enable switch setting, based on front-panel selector switch ====== =================== Value Status ====== =================== True calbration possible False calibration locked ====== =================== """ selection = self.status.cal_enable return bool(selection) def check_errors(self): """ Method to read the error status register :return error_status: one byte with the error status register content :rtype error_status: int """ # Read the error status register only one time for this method, as # the manual states that reading the error status register also clears it. current_errors = self.error_status if current_errors != 0: log.error("HP3478A error detected: %s", self.ERRORS(current_errors)) return self.ERRORS(current_errors) error_status = HPLegacyInstrument.measurement( "E", """Checks the error status register """, cast=int, ) def display_reset(self): """ Reset the display of the instrument. """ self.write("D1") display_text = HPLegacyInstrument.setting( "D2%s", """Displays up to 12 upper-case ASCII characters on the display. """, set_process=(lambda x: str.upper(x[0:12])), ) display_text_no_symbol = HPLegacyInstrument.setting( "D3%s", """Displays up to 12 upper-case ASCII characters on the display and disables all symbols on the display. """, set_process=(lambda x: str.upper(x[0:12])), ) measure_ACI = HPLegacyInstrument.measurement( MODES["ACI"], """ Returns the measured value for AC current as a float in A. """, ) measure_ACV = HPLegacyInstrument.measurement( MODES["ACV"], """ Returns the measured value for AC Voltage as a float in V. """, ) measure_DCI = HPLegacyInstrument.measurement( MODES["DCI"], """ Returns the measured value for DC current as a float in A. """, ) measure_DCV = HPLegacyInstrument.measurement( MODES["DCV"], """ Returns the measured value for DC Voltage as a float in V. """, ) measure_R2W = HPLegacyInstrument.measurement( MODES["R2W"], """ Returns the measured value for 2-wire resistance as a float in Ohm. """, ) measure_R4W = HPLegacyInstrument.measurement( MODES["R4W"], """ Returns the measured value for 4-wire resistance as a float in Ohm. """, ) measure_Rext = HPLegacyInstrument.measurement( MODES["Rext"], """ Returns the measured value for extended resistance mode (>30M, 2-wire) resistance as a float in Ohm. """, ) @property def mode(self): """Return current selected measurement mode, this propery can be set. Allowed values are ==== ============================================================== Mode Function ==== ============================================================== ACI AC current ACV AC voltage DCI DC current DCV DC voltage R2W 2-wire resistance R4W 4-wire resistance Rext extended resistance method (requires additional 10 M resistor) ==== ============================================================== """ current_mode = self.INV_MODES["F" + str(self.status.function)] return current_mode @mode.setter def mode(self, value): mode_set = self.MODES[strict_discrete_set(value, self.MODES)] self.write(mode_set) @property def range(self): """Returns the current measurement range, this property can be set. Valid values are : ==== ======================================= Mode Range ==== ======================================= ACI 0.3, 3, auto ACV 0.3, 3, 30, 300, auto DCI 0.3, 3, auto DCV 0.03, 0.3, 3, 30, 300, auto R2W 30, 300, 3000, 3E4, 3E5, 3E6, 3E7, auto R4W 30, 300, 3000, 3E4, 3E5, 3E6, 3E7, auto Rext 3E7, auto ==== ======================================= """ cur_mode = self.INV_MODES["F" + str(self.status.function)] if cur_mode == "DCV": correction_factor = 3 elif cur_mode in ["ACV", "ACI", "DCI"]: correction_factor = 2 else: correction_factor = 0 current_range = 3 * math.pow(10, self.status.range - correction_factor) return current_range @range.setter def range(self, value): cur_mode = self.mode value = strict_discrete_set(value, self.RANGES[cur_mode]) set_range = self.RANGES[cur_mode][value] self.write(set_range) @property def resolution(self): """Returns current selected resolution, this property can be set. Possible values are 3,4 or 5 (for 3 1/2, 4 1/2 or 5 1/2 digits of resolution) """ number_of_digit = 6 - self.status.digits return number_of_digit @resolution.setter def resolution(self, value): resolution_string = "N" + str(strict_discrete_set(value, [3, 4, 5])) self.write(resolution_string) @property def SRQ_mask(self): """Return current SRQ mask, this property can be set, bit assigment for SRQ: ========= ========================== Bit (dec) Description ========= ========================== 1 SRQ when Data ready 4 SRQ when Syntax error 8 SRQ when internal error 16 front panel SQR button 32 SRQ by invalid calibration ========= ========================== """ return self.status.SRQ @SRQ_mask.setter def SRQ_mask(self, value): self.write(f"M{strict_range(value, [0, 63]):02o}") @property def trigger(self): """Return current selected trigger mode, this property can be set Possibe values are: ======== =========================================== Value Meaning ======== =========================================== auto automatic trigger (internal) internal automatic trigger (internal) external external trigger (connector on back or GET) hold holds the measurement fast fast trigger for AC measurements ======== =========================================== """ status = self.status i_trig = status.int_trig e_trig = status.ext_trig if i_trig == 0: if e_trig == 0: trigger_mode = "hold" else: trigger_mode = "external" else: trigger_mode = "internal" return trigger_mode @trigger.setter def trigger(self, value): trig_set = self.TRIGGERS[strict_discrete_set(value, self.TRIGGERS)] self.write(trig_set) @property def calibration_data(self): """Read or write the calibration data as an array of 256 values between 0 and 15. The calibration data of an HP 3478A is stored in a 256x4 SRAM that is permanently powered by a 3v Lithium battery. When the battery runs out, the calibration data is lost, and recalibration is required. When read, this property fetches and returns the calibration data so that it can be backed up. When assigned a value, it similarly expects an array of 256 values between 0 and 15, and writes the values back to the instrument. When writing, exceptions are raised for the following conditions: * The CAL ENABLE switch at the front of the instrument is not set to ON. * The array with values does not contain exactly 256 elements. * The array with values does not pass a verification check. IMPORTANT: changing the calibration data results in permanent loss of the previous data. Use with care! """ cal_data = [] for addr in range(0, 256): # To fetch one nibble: 'W
', where address is a raw 8-bit number. self.write_binary_values('W', [addr], datatype='B', header_fmt="empty") rvalue = self.read_bytes(1)[0] # 'W' command reads a nibble from the SRAM, but then adds a value of 64 to return # it as an ASCII value. if rvalue < 64 or rvalue >= 80: raise Exception("calibration nibble out of range") cal_data.append(rvalue-64) return cal_data @calibration_data.setter def calibration_data(self, cal_data): """Setter to write the calibration data. """ if not self.calibration_enabled: raise Exception("CAL ENABLE switch not set to ON") self.write_calibration_data(cal_data, True) def write_calibration_data(self, cal_data, verify_calibration_data=True): """Method to write calibration data. The cal_data parameter format is the same as the ``calibration_data`` property. Verification of the cal_data array can be bypassed by setting ``verify_calibration_data`` to ``False``. """ if verify_calibration_data and not self.verify_calibration_data(cal_data): raise ValueError("cal_data verification fail.") for addr in range(0, 256): # To write one nibble: 'X
', where address and byte are raw 8-bit numbers. cmd = bytes([ord('X'), addr, cal_data[addr]]) self.write_bytes(cmd) pass def verify_calibration_entry(self, cal_data, entry_nr): """Verify the checksum of one calibration entry. Expects an array of 256 values with calibration data, and an entry number from 0 to 18. Returns True when the checksum of the specified calibration entry is correct. """ if len(cal_data) != 256: raise Exception("cal_data must contain 256 values") sum = 0 for idx in range(0, 13): val = cal_data[entry_nr*13 + idx + 1] if idx != 11: sum += val else: sum += val*16 return sum == 255 def verify_calibration_data(self, cal_data): """Verify the checksums of all calibration entries. Expects an array of 256 values with calibration data. :return calibration_correct: True when all checksums are correct. :rtype calibration_correct: boolean """ for entry_nr in range(0, 19): if entry_nr in [5, 16, 18]: continue if not self.verify_calibration_entry(cal_data, entry_nr): return False return True ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp437b.py0000644000175100017510000007657715203313266021702 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, strict_range from enum import IntEnum, IntFlag import logging log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class MeasurementUnit(IntEnum): """Enumeration to represent the measurement unit the power meter will measure in""" WATTS = 0 DBM = 1 PERCENT = 2 DB = 3 class SensorType(IntEnum): """Enumeration to represent the selected sensor type for the power meter""" #: Default (100% for all frequencies) DEFAULT = 0 HP_8481A = 1 #: HP 8482A, 8482B, 8482H HP_8482X = 2 HP_8483A = 3 HP_8481D = 4 HP_8485A = 5 HP_R8486A = 6 HP_Q8486A = 7 HP_R8486D = 8 HP_8487A = 9 class OperatingMode(IntEnum): """Enumeration to represent the operating mode the power meter is currently in""" NORMAL = 0 ZEROING = 6 CALIBRATION = 8 class TriggerMode(IntEnum): """Enumeration to represent the trigger mode the power meter is currently in""" HOLD = 0 FREE_RUNNING = 3 class GroupTriggerMode(IntEnum): """Enumeration to represent the group execute trigger mode the power meter is currently in""" IGNORE = 0 TRIGGER_IMMEDIATE = 1 TRIGGER_DELAY = 2 class EventStatusRegister(IntFlag): """Enumeration to represent the Event Status Register.""" #: The bit is set when the power meter's LINE switch is set from STDBY to ON POWER_ON = 128 #: This bit is set when an incorrect HP-IB code is sent to the power meter. For example, # the command “QX” is a command error. COMMAND_ERROR = 32 #: This bit is set when incorrect data is sent to the power meter. For example, the command # “FR-3GZ” is an execution error. EXECUTION_ERROR = 16 #: This bit is set true whenever a measurement error (error 1-49) occurs. DEVICE_DEPENDENT_ERROR = 8 Errors = { 1: "Power meter cannot zero the sensor", 5: "Power meter cannot calibrate sensor", 11: "Input overload on sensor", 15: "Sensor’s zero reference has drifted negative", 17: "Input power on sensor is too high for current range", 21: "Power reading over high limit", 23: "Power reading under low limit", 31: "No sensor connected to the input", 33: "Both front and rear sensor inputs, have sensors connected (Option 002 or Option 003 only)", 50: "Entered cal factor is out of range", 51: "Entered offset is out of range", 52: "Entered range number is out of range", 54: "Entered recall register number is out of range", 55: "Entered storage register number is out of range", 56: "Entered reference cal factor is out of range", 57: "RAM ID check failure", 61: "Stack RAM failure", 62: "ROM checksum failure", 64: "RAM failure", 65: "Analog I/O PIA Failure", 66: "Keyboard and Display PIA Failure", 67: "Analog-to-Digital converter Failure", 68: "HP-IB failure", 69: "Timer failure", 70: "Keyboard/Display controller failure", 71: "Keyboard data failure", 72: "Data line to A3U26 is open.", 73: "Keyboard/Display controller self-test failure", 74: "Display not responding", 75: "Digital failure", } class StatusMessage: MeasurementErrorCode = (0, 1) EntryErrorCode = (2, 2) OperatingMode = (4, 2) AutomaticRangeStatus = (6, 1) Range = (7, 1) # 8, 9 unused AutoFilterStatus = (10, 1) Filter = (11, 1) # 12, 13 unused LinearLogStatus = (14, 1) # A PowerRefStatus = (16, 1) RelativeModeStatus = (17, 1) TriggerMode = (18, 1) GroupTriggerMode = (19, 1) LimitsCheckingStatus = (20, 1) LimitsStatus = (21, 1) # 22 unused OffsetStatus = (23, 1) DutyCycleStatus = (24, 1) MeasurementUnits = (25, 1) def _getstatus(status_type, modifier=lambda v: v): start_index, stop_offset = status_type return lambda v: modifier(int(v[start_index:start_index + stop_offset])) class HP437B(Instrument): """Represents the HP437B Power Meters. .. note:: Most command descriptions are taken from the document: 'Operating Manual 437B Power Meter' """ def __init__(self, adapter, name="Hewlett-Packard HP437B", **kwargs): super().__init__( adapter, name, includeSCPI=False, send_end=True, **kwargs, ) def check_errors(self): errors = [] while True: err = self.values("ERR?") # exclude upper limit and lower limit hit from real errors if int(err[0]) != 0 and int(err[0]) != 21 and int(err[0]) != 23: log.error(f"{self.name}: {err[0]}, {Errors[err[0]]}") errors.append(err) else: break return errors event_status = Instrument.measurement( "*ESR?", """ Get the status byte and Master Summary Status bit. .. code-block:: python print(instr.request_service_conditions) StatusRegister.PowerOn|CommandError """, cast=int, get_process=lambda v: EventStatusRegister(v) ) def activate_auto_range(self): """ The power meter divides each sensor’s power range into 5 ranges of 10 dB each. Range 1 is the most sensitive (lowest power levels), and Range 5 is the least sensitive (highest power levels). Range 5 can be less than 10 dB if the sensor’s power range is less than 50 dB. The range can be set either automatically or manually. 'activate_auto_range' automatically selects the correct range for the current measurement. """ self.write("RA") def calibrate(self, calibration_factor): """ Calibrate a sensor to the power meter with a 'calibration_factor' in percent. """ self.write("CL%.1fPCT" % calibration_factor) @property def calibration_factor(self): """ Control the calibration factor of a specific power sensor at a specific input frequency. (A chart or table of CAL FACTOR % versus Frequency is printed on each sensor and an accompanying data sheet.) Calibration factor is entered in percent. Valid entries for 'calibration_factor' range from 1.0 to 150.0%. """ self.write("KB") # returns CALFAC 097.9% display_content = self.display_output assert display_content[0:6] == "CALFAC" self.write("EX") return float(display_content[7:12]) @calibration_factor.setter def calibration_factor(self, calibration_factor): values = [1.0, 150.0] strict_range(float(calibration_factor), values) self.write("KB%3.1fPCT" % float(calibration_factor)) self.check_errors() display_enabled = Instrument.setting( "%s", """ Set the display of the power meter active or inactive. """, map_values=True, values={True: "DE", False: "DD"} ) display_all_segments_enabled = Instrument.setting( "%s", """ Set all segments of the display of the power meter active or resume normal state. """, map_values=True, values={True: "DA", False: "DE"} ) display_user_message = Instrument.setting( "DU %s", """ Set a custom user message up to 12 alpha-numerical chars. If the string is empty or None the user message gets disabled. """, validator=lambda x, y: x if str(x).isalnum() and len(str(x)) <= 12 else str(x)[0:12], set_process=lambda v: str(v).upper().ljust(12) ) display_output = Instrument.measurement( "OD", """ Get the current displayed string of values of the power meter. .. code-block:: python print(instr.display_output) -0.23 dB REL """, cast=str ) duty_cycle_enabled = Instrument.control( "SM", "DC%d", """ Control whether the duty cycle is active or inactive. See :attr:`duty_cycle` """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.DutyCycleStatus), check_set_errors=True ) @property def duty_cycle(self): """ Control the duty cycle for calculation of a pulsed input signal. This function will cause the power meter to report the pulse power of a rectangular pulsed input signal. The allowable range of values for 'duty_cycle' is 0.00001 to 0.99999. Pulse power, as reported by the power meter, is a mathematical representation of the pulse power rather than an actual measurement. The power meter measures the average power of the pulsed input signal and then divides the measurement by the duty cycle value to obtain a pulse power reading. """ self.write("DY") # returns DTYCY 01.000% display_content = self.display_output assert display_content[0:5] == "DTYCY" self.write("EX") return float(display_content[6:12]) / 100.0 @duty_cycle.setter def duty_cycle(self, duty_cycle): values = [0.00001, 0.99999] strict_range(float(duty_cycle), values) self.write("DY%02.3fPCT" % (float(duty_cycle) * 100.0)) self.check_errors() filter_automatic_enabled = Instrument.control( "SM", "%s", """ Control the filter mode. By switching over from automatic to manual (true to false) the instrument implicitly keeps (holds) the filter value from the automatic selection. """, cast=bool, get_process=_getstatus(StatusMessage.AutoFilterStatus), set_process=lambda v: "FA" if v else "FH", check_set_errors=True ) filter = Instrument.control( "SM", "FM%dEN", """ Control the filter number for averaging. Setting a value implicitly enables the manual filter mode. Setting a value of 1 basically disables the averaging. """, values=[1, 2, 4, 8, 16, 32, 64, 128, 256, 512], validator=strict_discrete_set, get_process=_getstatus(StatusMessage.Filter, (lambda x: 2 ** x)), check_set_errors=True ) @property def frequency(self): """ Control the frequency of the input signal. Entering a frequency causes the power meter to select a sensor-specific calibration factor. The allowed range of 'frequency' values is from 0.0001 to 999.9999 GHz with a 100 kHz resolution. The unit is Hz. """ self.write("FR") # returns FR 000.0500GZ display_content = self.display_output assert display_content[0:2] == "FR" self.write("EX") return_value = float(display_content[3:11]) if display_content[11:13] == "GZ": return_value *= 1e9 else: return_value *= 1e6 return return_value @frequency.setter def frequency(self, frequency): self.write("FR%08.4fGZ" % (float(frequency) / 1e9)) self.check_errors() limits_enabled = Instrument.control( "SM", "LM%d", """ Control the limits checking function to allow the power meter to monitor the power level at the sensor and to indicate when that power is outside preset limits. """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.LimitsCheckingStatus), check_set_errors=True ) @property def limit_high(self): """ Control the upper limit for the builtin limit checking. """ self.write("LH") # returns HI +299.999dB display_content = self.display_output assert display_content[0:2] == "HI" self.write("EX") return float(display_content[3:11]) @limit_high.setter def limit_high(self, limit): """ Control the upper limit for the builtin limit checking. """ values = [-299.999, 299.999] strict_range(limit, values) self.write("LH%7.3fEN" % limit) self.check_errors() @property def limit_low(self): """ Control the lower limit for the builtin limit checking. """ self.write("LL") # returns HI +299.999dB display_content = self.display_output assert display_content[0:2] == "LO" self.write("EX") return float(display_content[3:11]) @limit_low.setter def limit_low(self, limit): """ Control the lower limit for the builtin limit checking. """ values = [-299.999, 299.999] strict_range(limit, values) self.write("LL%7.3fEN" % limit) self.check_errors() limit_high_hit = Instrument.measurement( "SM", """ Get if the upper limit check got triggered. """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.LimitsStatus), ) limit_low_hit = Instrument.measurement( "SM", """ Get if the lower limit check got triggered. """, map_values=True, values={True: 2, False: 0}, cast=int, get_process=_getstatus(StatusMessage.LimitsStatus), ) # just addressing the instrument to talk (without a query string) and read until EOI results # in only reading the RF power level power = Instrument.measurement( "", """ Measure the power at the power sensor attached to the power meter in the corresponding unit. In case a measurement would be invalid the power meter responds with the value float('nan'). """, get_process=lambda v: float("nan") if v == 9.0200e+40 else v ) power_reference_enabled = Instrument.control( "SM", "OC%d", """ Control the builtin reference power source 1mW @ 50 MHz. """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.PowerRefStatus), check_set_errors=True ) offset_enabled = Instrument.control( "SM", "OF%d", """ Control the offset being applied. """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.OffsetStatus), check_set_errors=True ) @property def offset(self): """ Control the offset applied to the measured value to compensate for signal gain or loss (for example, to compensate for the loss of a 10 dB directional coupler). Offsets are entered in dB. In case the :attr:`offset_enabled` is false this returns automatically 0.0 """ if self.offset_enabled: self.write("OS") # returns OFS +00.00 dB display_content = self.display_output assert display_content[0:3] == "OFS" self.write("EX") return float(display_content[4:10]) else: return 0.0 @offset.setter def offset(self, offset): values = [-99.99, 99.99] strict_range(offset, values) self.write("OS%5.2fEN" % offset) def reset(self): self.write("*RST") def clear_status_registers(self): self.write("*CLS") def preset(self): """ Sets the power meter to a known state. Preset conditions are shown in the following table. .. list-table:: Preset values :widths: 25 25 :header-rows: 1 * - Parameter - Value/Condition * - Frequency - 50 MHz * - Resolution - 0.01 dB * - Duty Cylce - 1.000%, Off * - Relative - 0 dB, Off * - Power Reference - Off * - Range - Auto * - Unit - dBm * - Low Limit - -90.000 dBm * - High Limit - +90.000 dBm * - Limit Checking - Off * - Trigger Mode - Free Run * - Group Trigger Mode - Trigger with Delay * - Display Function - Display Enable """ self.write("PR") relative_mode_enabled = Instrument.control( "SM", "RL%d", """ Control the relative mode. In the relative mode the current measured power value will be used as reference and any further reported value from :attr:`power` will refer to this. """, map_values=True, values={True: 1, False: 0}, cast=int, get_process=_getstatus(StatusMessage.RelativeModeStatus), check_set_errors=True ) measurement_unit = Instrument.measurement( "SM", """ Get the measurement unit the power meter is currently reporting the power values in. Depends on: :attr:`relative_mode_enabled` and attr:`linear_display_enabled` .. code-block:: python instr.relative_mode_enabled = False instr.linear_display_enabled = True print(instr.measurement_unit) MeasurementUnit.Watts """, values=[e for e in MeasurementUnit], cast=int, get_process=_getstatus(StatusMessage.MeasurementUnits, lambda v: MeasurementUnit(v)), ) linear_display_enabled = Instrument.control( "SM", "%s", """ Control if the power meter displays or reports the power values in logarithmic or linear units. Set `linear_display_enabled` to 'True' to activate linear value readout. .. code-block:: python from pymeasure.instruments.hp.hp437b import LogLin instr.relative_mode_enabled = False instr.linear_display_enabled = True """, validator=strict_discrete_set, values={True: "LN", False: "LG"}, cast=bool, map_values=True, get_process=_getstatus(StatusMessage.LinearLogStatus, lambda v: {0: "LN", 1: "LG"}[v]) ) @property def resolution(self): """ Control the resolution of the power meter's measured value. Three levels of resolution can be set: 0.1 dB, 0.01 dB and 0.001 dB or if the selected unit is Watts 1%, 0.1% and 0.001%. """ linear_display_enabled = self.linear_display_enabled mapping = {} if not linear_display_enabled: mapping = {1: 0.1, 2: 0.01, 3: 0.001} else: mapping = {1: 1, 2: 0.1, 3: 0.01} self.write("RE") self.check_errors() display_content = self.display_output self.check_errors() self.write("EX") assert display_content[0:3] == "RES" return mapping[int(display_content[3])] @resolution.setter def resolution(self, resolution): """ Control the resolution of the power meter's measured value. Three levels of resolution can be set: 0.1 dB, 0.01 dB and 0.001 dB or if the selected unit is Watts 1%, 0.1% and 0.001%. """ linear_display_enabled = self.linear_display_enabled allowed_values = {} if not linear_display_enabled: allowed_values = {0.1: 1, 0.01: 2, 0.001: 3} else: allowed_values = {1: 1, 0.1: 2, 0.01: 3} strict_discrete_set(resolution, allowed_values.keys()) self.write(f"RE{allowed_values[resolution]}EN") self.check_errors() sensor_type = Instrument.setting( "SE%dEN", """ Set the sensor type connected to the power meter to select the corresponding calibration factor. .. code-block:: python from pymeasure.instruments.hp.hp437b import SensorType instr.sensor_type = SensorType.HP_8481A """, validator=strict_discrete_set, values=[e for e in SensorType], check_set_errors=True ) def sensor_data_clear(self, sensor_id): """ Clear the Sensor Data table of 'sensor_id' previous to entering new values. """ values = [0, 9] strict_range(sensor_id, values) self.write(f"CT{sensor_id}") def sensor_data_ref_cal_factor(self, sensor_id, ref_cal_factor): """ Set the power sensor's reference calibration factor to the Sensor Data table. """ values = [0, 9] strict_range(sensor_id, values) self.write(f"RF{sensor_id}{ref_cal_factor:4.1f}") self.check_errors() def sensor_data_write_cal_factor_table(self, sensor_id, frequency_table, cal_fac_table): """ Write the 'calibration_table' for 'sensor_id' to the Sensor Data table. And write the reference calibration factor for the 'sensor_id'. Frequency is given in Hz. Calibration factor as percentage. The power meter’s memory contains space for 10 tables, numbered 0—9. Tables 0-7 each contain space for 40 frequency /calibration factor pairs. Tables 8 and 9 each contain space for 80 frequency/calibration factor pairs. This function clears the sensor table before writing. Example table: .. code-block:: python calibration_table = { 10e6: 100.0, 1e9: 96.5, 2e9: 97.0 } instr.sensor_data_cal_factor_table(0, calibration_table.keys(), calibration_table.values()) """ values = [0, 9] strict_range(sensor_id, values) if sensor_id in range(0, 7) and (len(cal_fac_table) > 40 or len(frequency_table)) > 40: raise ValueError(f"For sensor id {sensor_id} there aren't more than 40 frequency " f"pairs allowed") if sensor_id in range(8, 9) and (len(cal_fac_table) > 80 or len(frequency_table)) > 80: raise ValueError(f"For sensor id {sensor_id} there aren't more than 80 frequency " f"pairs allowed") if len(cal_fac_table) != len(frequency_table): raise ValueError(f"Frequency table and calibration factor table must have the same " f"length {len(cal_fac_table)}!={len(frequency_table)}") self.sensor_data_clear(sensor_id) for frequency, cal_factor in zip(frequency_table, cal_fac_table): if frequency > 99.9e6: freq_suffix = "GZ" frequency /= 1e9 elif frequency > 99.9e3: freq_suffix = "MZ" frequency /= 1e6 else: freq_suffix = "KZ" frequency /= 1e3 self.write(f"ET{sensor_id} {frequency:5.2f}{freq_suffix} {cal_factor}% EN") self.check_errors() self.write("EX") self.check_errors() def sensor_data_read_cal_factor_table(self, sensor_id): """ Read the Sensor Data calibration table. See :meth:`sensor_data_write_cal_factor_table` Returns a tuple of frequencies as list and calibration factors as list. """ allowed_values = [0, 9] strict_range(sensor_id, allowed_values) pairs = 80 if sensor_id < 8: pairs = 40 frequency_data = [] cal_fac_data = [] self.write(f"ET{sensor_id}") self.check_errors() for i in range(0, pairs): # outputs something like 38.00GZ 100.2% display_content = self.display_output frequency = float(display_content[0:5]) if frequency == 0: break if display_content[5:7] == "GZ": frequency *= 1e9 else: frequency *= 1e6 calibration_factor = float(display_content[8:13]) cal_fac_data.append(calibration_factor) frequency_data.append(frequency) self.write("EN") self.check_errors() self.write("EX") return frequency_data, cal_fac_data def sensor_data_write_id_label(self, sensor_id, label): """ Set a particular power sensor’s ID label table to be modified. The sensor ID label must not exceed 7 characters. For example, to identify Sensor Data table #2 with an ID number of 1234567: .. code-block:: python instr.sensor_data_id_label(2, "1234567") """ values = [0, 9] strict_range(sensor_id, values) if len(label) > 7: raise ValueError("Sensor id label must not exceed length of 7") if not str(label).upper().isalnum(): raise ValueError("Sensor id label only allows 0-9, A-Z") self.write(f"SN{sensor_id}{label}") automatic_range_enabled = Instrument.control( "SM", "%s", """ Control the automatic range. The power meter divides each sensor’s power range into 5 ranges of 10 dB each. Range 1 is the most sensitive (lowest power levels), and Range 5 is the least sensitive (highest power levels). The range can be set either automatically or manually. """, get_process=_getstatus(StatusMessage.AutomaticRangeStatus, lambda v: bool(v)), set_process=lambda v: "RM0EN" if v is True else "RH" ) range = Instrument.control( "SM", "RM%dEN", """ Control the range to be selected manually. Valid range numbers are 1 through 5. See :attr:`automatic_range_enabled` for further information. """, values=[1, 5], validator=strict_range, get_process=_getstatus(StatusMessage.Range) ) def store(self, register): """ The power meter can store instrument configurations for recall at a later time. The following information can be stored in the power meter’s internal registers: - reference calibration factor value - Measurement units (dBm or watts) - relative value and status (on or off) - power reference status (on or off) - calibration factor value - SENSOR ID (sensor data table selection) - offset value and status (on or off) - range (Auto or Set) - frequency value - resolution - duty cycle value and status (on or off) - Filter (number of readings averaged, auto or manual) - Limits value and status (on or off) Registers 1 through 10 are available for storing instrument configurations. """ values = [1, 10] strict_range(register, values) self.write(f"ST{register}EN") operating_mode = Instrument.measurement( "SM", """ Get the operating mode the power meter is currently in. """, get_process=_getstatus(StatusMessage.OperatingMode, lambda v: OperatingMode(v)) ) def zero(self): """ Adjust the power meter’s internal circuitry for a zero power indication when no power is applied to the sensor. .. note:: Ensure that no power is applied to the sensor while the power meter is zeroing. Any applied RF input power will cause an erroneous reading. """ self.write("ZE") trigger_mode = Instrument.control( "SM", "TR%d", """ Control the trigger mode. The power meter has two modes of triggered operation; standby mode and free run mode. Standby mode means the power meter is making measurements, but the display and HP-IB are not updated until a trigger command is received. Free run means that Meter takes measurements and updates the display and HP-IB continuously. """, values=[e for e in TriggerMode], validator=strict_discrete_set, get_process=_getstatus(StatusMessage.TriggerMode, lambda v: TriggerMode(v)), set_process=lambda v: int(v) ) def trigger_immediate(self): """ Trigger immediate. When the power meter receives the trigger immediate program code, it inputs one more data point into the digital filter, measures the reading from the filter, and then updates the display and HP-IB. (When the trigger immediate command is executed, the internal digital filter is not cleared.) The power meter then waits for the measurement results to be read by the controller. While waiting, the power meter can process most bus commands without losing the measurement results. If the power meter receives a trigger immediate command and then receives the GET (Group Execute Trigger) command, the trigger immediate command will be aborted and a new measurement cycle will be executed. Once the measurement results are read onto the bus, the power meter always reverts to standby/hold mode. Measurement results obtained via trigger immediate are normally valid only when the power meter is in a steady, settled state. """ self.write("TR1") def trigger_delay(self): """ Trigger with delay. Triggering with delay is identical to :meth:`trigger_immediate` except the power meter inserts a settling-time delay before taking the requested measurement. This settling time allows the internal digital filter to be updated with new values to produce valid, accurate measurement results. The trigger with delay command allows time for settling of the internal amplifiers and filters. It does not allow time for power sensor delay. In cases of large power changes, the delay may not be sufficient for complete settling. Accurate readings can be assured by taking two successive measurements for comparison. Once the measurement results are displayed and read onto the bus, the power meter reverts to standby mode. """ self.write("TR2") group_trigger_mode = Instrument.control( "SM", "GT%d", """ Control the group execute trigger mode. When in remote and addressed to listen, the power meter responds to a Trigger message ( the Group Execute Trigger bus command [GET]) according to the programmed mode. """, values=[e for e in GroupTriggerMode], validator=strict_discrete_set, get_process=_getstatus(StatusMessage.GroupTriggerMode, lambda v: GroupTriggerMode(v)), set_process=lambda v: int(v) ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp8116a.py0000644000175100017510000005116415203313266021744 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import time import numpy as np from enum import Enum, IntFlag from pymeasure.instruments import Instrument from pymeasure.instruments.validators import ( strict_discrete_set, strict_range, truncated_discrete_set ) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) # for Python>3.9, these two methods can be static methods in the class def _generate_1_2_5_sequence(min, max): """ Generate a list of a 1-2-5 sequence between min and max. """ exp_min = int(np.log10(min)) exp_max = int(np.log10(max)) seq_1_2_5 = np.array([1, 2, 5]) sequence = np.array([seq_1_2_5 * (10 ** exp) for exp in range(exp_min - 1, exp_max + 1)]) sequence = sequence.flatten() sequence = sequence[(sequence >= min) & (sequence <= max)] return list(sequence) def _boolean_control(identifier, state_index, docs, inverted=False, **kwargs): return Instrument.control( 'CST', identifier + '%d', docs, validator=strict_discrete_set, values=[True, False], get_process_list=lambda x: inverted ^ bool(int(x[state_index][1])), set_process=lambda x: int(inverted ^ x), **kwargs ) class Status(IntFlag): """ IntFlag type for the GPIB status byte which is returned by the :py:attr:`status` property. When the timing_error or programming_error flag is set, a more detailed error description can be obtained by calling :py:method:`check_errors()`. """ timing_error = 1 << 0 programming_error = 1 << 1 syntax_error = 1 << 2 system_failure = 1 << 3 autovernier_in_progress = 1 << 4 sweep_in_progress = 1 << 5 service_request = 1 << 6 buffer_not_empty = 1 << 7 class HP8116A(Instrument): """ Represents the Hewlett-Packard 8116A 50 MHz Pulse/Function Generator and provides a high-level interface for interacting with the instrument. The resolution for all floating point instrument parameters is 3 digits. """ def __init__(self, adapter, name="Hewlett-Packard 8116A", **kwargs): kwargs.setdefault('read_termination', '\r\n') kwargs.setdefault('write_termination', '\r\n') kwargs.setdefault('send_end', True) super().__init__( adapter, name, includeSCPI=False, **kwargs ) self.has_option_001 = self._check_has_option_001() class Digit(Enum): """ Enum of the digits used with the autovernier (see :py:meth:`HP8116A.start_autovernier()`). """ MOST_SIGNIFICANT = 'M' SECOND_SIGNIFICANT = 'S' LEAST_SIGNIFICANT = 'L' class Direction(Enum): """ Enum of the directions used with the autovernier (see :py:meth:`HP8116A.start_autovernier()`). """ UP = 'U' DOWN = 'D' OPERATING_MODES = { 'normal': 'M1', 'triggered': 'M2', 'gate': 'M3', 'external_width': 'M4', # Option 001 only 'internal_sweep': 'M5', 'external_sweep': 'M6', 'internal_burst': 'M7', 'external_burst': 'M8', } OPERATING_MODES_INV = {v: k for k, v in OPERATING_MODES.items()} CONTROL_MODES = { 'off': 'CT0', 'FM': 'CT1', 'AM': 'CT2', 'PWM': 'CT3', 'VCO': 'CT4', } CONTROL_MODES_INV = {v: k for k, v in CONTROL_MODES.items()} TRIGGER_SLOPES = { 'off': 'T0', 'positive': 'T1', 'negative': 'T2', } TRIGGER_SLOPES_INV = {v: k for k, v in TRIGGER_SLOPES.items()} SHAPES = { 'dc': 'W0', 'sine': 'W1', 'triangle': 'W2', 'square': 'W3', 'pulse': 'W4', } SHAPES_INV = {v: k for k, v in SHAPES.items()} _units_frequency = { 'milli': 'MZ', 'no_prefix': 'HZ', 'kilo': 'KHZ', 'mega': 'MHZ', } _units_voltage = { 'milli': 'MV', 'no_prefix': 'V', } _units_time = { 'nano': 'NS', 'micro': 'US', 'milli': 'MS', 'no_prefix': 'S', } _si_prefixes = { 'nano': 1e-9, 'micro': 1e-6, 'milli': 1e-3, 'no_prefix': 1, 'kilo': 1e3, 'mega': 1e6, } @staticmethod def _get_value_with_unit(value, units): """ Convert a floating point value to a string with 3 digits resolution and the appropriate unit. :param value: The value to convert. :param units: Dictionary containing a mapping of SI-prefixes to the unit strings the instrument uses, eg. 'milli' -> 'MZ' for millihertz. """ if value < 1e-6: value_str = f'{value*1e9:.3g} {units["nano"]}' elif value < 1e-3: value_str = f'{value*1e6:.3g} {units["micro"]}' elif value < 1: value_str = f'{value*1e3:.3g} {units["milli"]}' elif value < 1e3: value_str = f'{value:.3g} {units["no_prefix"]}' elif value < 1e6: value_str = f'{value*1e-3:.3g} {units["kilo"]}' else: value_str = f'{value*1e-6:.3g} {units["mega"]}' return value_str @staticmethod def _parse_value_with_unit(value_str, units): """ Convert a string with a value and a unit as returned by the HP8116A to a float. :param value_str: The string to parse. :param units: Dictionary containing a mapping of SI-prefixes to the unit strings the instrument uses, eg. 'milli' -> 'MZ' for millihertz. """ # Example value_str: 'FRQ 1.00KHZ' # Digits and unit are always positioned the same for all parameters value_str = value_str.strip() value = float(value_str[3:8].strip()) unit = value_str[8:].strip() units_inverse = {v: k for k, v in units.items()} value *= HP8116A._si_prefixes[units_inverse[unit]] return value # Instrument communication # def write(self, command): """ Write a command to the instrument and wait until the 8116A has interpreted it. """ super().write(command) # We need to read the status byte and wait until the buffer_not_empty bit # is cleared because some older units lock up if we don't. self._wait_for_commands_processed() def ask(self, command, num_bytes=None): """ Write a command to the instrument, read the response, and return the response as ASCII text. :param command: The command to send to the instrument. :param num_bytes: The number of bytes to read from the instrument. If not specified, the number of bytes is automatically determined by the command. """ # noqa: E501 self.write(command) if num_bytes is None: if command == 'CST': # We usually only need the first 29 bytes of the state response since they contain # the current boolean parameters. The other parameters all have corresponding # 'interrogate' commands. num_bytes = 29 elif command[0] == 'I': num_bytes = 14 # The first character is always a space or a leftover character from the previous command, # when the number of bytes read was too large or too small. bytes = self.read_bytes(num_bytes)[1:] return bytes.decode('ascii').strip(' ,\r\n') operating_mode = Instrument.control( 'CST', '%s', """Control the operating mode of the instrument. Possible values (without Option 001) are: 'normal', 'triggered', 'gate', 'external_width'. With Option 001, 'internal_sweep', 'external_sweep', 'external_width', 'external_pulse' are also available. """, validator=strict_discrete_set, values=OPERATING_MODES, map_values=True, get_process_list=lambda x: HP8116A.OPERATING_MODES_INV[x[0]] ) control_mode = Instrument.control( 'CST', '%s', """Control the control mode of the instrument. Possible values are 'off', 'FM', 'AM', 'PWM', 'VCO'. """, validator=strict_discrete_set, values=CONTROL_MODES, map_values=True, get_process_list=lambda x: HP8116A.CONTROL_MODES_INV[x[1]] ) trigger_slope = Instrument.control( 'CST', '%s', """Control the slope the trigger triggers on. Possible values are: 'off', 'positive', 'negative'. """, validator=strict_discrete_set, values=TRIGGER_SLOPES, map_values=True, get_process_list=lambda x: HP8116A.TRIGGER_SLOPES_INV[x[2]] ) shape = Instrument.control( 'CST', '%s', """Control the shape of the output waveform. Possible values are: 'dc', 'sine', 'triangle', 'square', 'pulse'. """, validator=strict_discrete_set, values=SHAPES, map_values=True, get_process_list=lambda x: HP8116A.SHAPES_INV[x[3]] ) haversine_enabled = _boolean_control( 'H', 4, """Control whether a haversine/havertriangle signal is generated when in 'triggered', 'internal_burst' or 'external_burst' operating mode. """, ) autovernier_enabled = _boolean_control( 'A', 5, """Control whether the autovernier is enabled (bool).""", check_set_errors=True ) limit_enabled = _boolean_control( 'L', 6, """Control whether parameter limiting is enabled (bool).""", ) complement_enabled = _boolean_control( 'C', 7, """Control whether the complement of the signal is generated (bool).""", ) output_enabled = _boolean_control( 'D', 8, """Control whether the output is enabled (bool).""", inverted=True, # The actual command is "Disable output"... ) frequency = Instrument.control( 'IFRQ', 'FRQ %s', """Control the frequency of the output in Hz (strict float from 1e-3 to 52.5e6). """, validator=strict_range, values=[1e-3, 52.5001e6], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_frequency), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_frequency) ) duty_cycle = Instrument.control( 'IDTY', 'DTY %s %%', """Control the duty cycle of the output in percent (float). The allowed range generally is 10 % to 90 %, but it also depends on the current frequency. It is valid for all shapes except 'pulse', where :py:attr:`pulse_width` is used instead. """, validator=strict_range, values=[10, 90.0001], cast=int, # get_process=lambda x: int(x[6:8]) ) pulse_width = Instrument.control( 'IWID', 'WID %s', """Control the pulse width in s (strict float from 8e-9 to 999e-3). The pulse width may not be larger than the period. """, validator=strict_range, values=[8e-9, 999.001e-3], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_time), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_time) ) amplitude = Instrument.control( 'IAMP', 'AMP %s', """Control the amplitude of the output in V (strict float from 10e-3 to 16). The allowed amplitude range is also limited by the current offset. """, validator=strict_range, values=[10e-3, 16.001], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_voltage), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_voltage) ) offset = Instrument.control( 'IOFS', 'OFS %s', """Control the offset of the output in V (strit float from -7.95 to 7.95). The allowed offset range is also limited by the amplitude. """, validator=strict_range, values=[-7.95, 7.95001], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_voltage), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_voltage) ) high_level = Instrument.control( 'IHIL', 'HIL %s', """Control the high level of the output in V (strict float from -7.9 to 8). The allowed high level range must be at least 10 mV greater than the low level. """, validator=strict_range, values=[-7.9, 8.001], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_voltage), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_voltage) ) low_level = Instrument.control( 'ILOL', 'LOL %s', """Control the low level of the output in V (strict float from -8 to 7.9). The allowed low level range must be at least 10 mV less than the high level. """, validator=strict_range, values=[-8, 7.9001], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_voltage), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_voltage) ) burst_number = Instrument.control( 'IBUR', 'BUR %s #', """Control the number of periods generated in a burst (strict int from 1 to 1999). It is only valid for units with Option 001 in one of the burst modes. """, validator=strict_range, values=[1, 1999], get_process=lambda x: int(x[4:8]) ) repetition_rate = Instrument.control( 'IRPT', 'RPT %s', """Control the repetition rate in s (i.e. the time between bursts) in 'internal_burst' mode (strict float from 20e-9 to 999e-3). """, validator=strict_range, values=[20e-9, 999.001e-3], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_time), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_time) ) sweep_start = Instrument.control( 'ISTA', 'STA %s', """Control the start frequency in both sweep modes in Hz (strict float from 1e-3 to 52.5e6). """, validator=strict_range, values=[1e-3, 52.5001e6], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_frequency), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_frequency) ) sweep_stop = Instrument.control( 'ISTP', 'STP %s', """Control the stop frequency in both sweep modes in Hz (strict float from 1e-3 to 52.5e6). """, validator=strict_range, values=[1e-3, 52.5001e6], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_frequency), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_frequency) ) sweep_marker_frequency = Instrument.control( 'IMRK', 'MRK %s', """Control the frequency marker in both sweep modes in Hz (strict float from 1e-3 to 52.5e6). At this frequency, the marker output switches from low to high. """, validator=strict_range, values=[1e-3, 52.5001e6], set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_frequency), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_frequency) ) sweep_time = Instrument.control( 'ISWT', 'SWT %s', """Control the sweep time per decade in both sweep modes in s (float). The sweep time is selectable in a 1-2-5 sequence between 10 ms and 500 s. """, validator=truncated_discrete_set, values=_generate_1_2_5_sequence(10e-3, 500), set_process=lambda x: HP8116A._get_value_with_unit(x, HP8116A._units_time), get_process=lambda x: HP8116A._parse_value_with_unit(x, HP8116A._units_time) ) @property def status(self): """Get the status byte of the 8116A as a :class:`Status` IntFlag-type enum.""" return Status(self.adapter.connection.read_stb()) @property def complete(self): """Get whether the measurement is complete (bool).""" return not (self.status & Status.buffer_not_empty) @property def options(self): """Get the device options installed. The only possible option is 001.""" if self.has_option_001: return ['001'] else: return [] def start_autovernier(self, control, digit, direction, start_value=None): """ Start the autovernier on the specified control. :param control: The control to change, pass as :code:`HP8116A.some_control`. Allowed controls are frequency, amplitude, offset, duty_cycle, and pulse_width :param digit: The digit to change, type: :py:class:`HP8116A.Digit`. :param direction: The direction in which to change the control, type: :py:class:`HP8116A.Direction`. :param start_value: An optional value to start the autovernier at. If not specified, the current value of the control is used. """ if not self.autovernier_enabled: raise RuntimeError('Autovernier has to be enabled first.') if control not in (HP8116A.frequency, HP8116A.amplitude, HP8116A.offset, HP8116A.duty_cycle, HP8116A.pulse_width): raise ValueError('Control must be one of frequency, amplitude, offset, ' + 'duty_cycle, or pulse_width.') start_value = control.fget(self) if start_value is None else start_value # The control always has to be set to select it for the autovernier. control.fset(self, start_value) self.write(digit.value + direction.value) def GPIB_trigger(self): """ Initiate trigger via low-level GPIB-command (aka GET - group execute trigger). """ self.adapter.connection.assert_trigger() def reset(self): """ Initatiate a reset (like a power-on reset) of the 8116A. """ self.adapter.connection.clear() self._wait_for_commands_processed() def shutdown(self): """ Gracefully close the connection to the 8116A. """ self.adapter.connection.clear() self.adapter.close() super().shutdown() def check_errors(self): """ Check for errors in the 8116A. :return: list of error entries or empty list if no error occurred. """ errors_response = self.ask('IERR', 100).split('\r\n')[0].strip(' ,\r\n') errors = errors_response.split('ERROR')[:-1] errors = [e.strip() + " ERROR" for e in errors] if errors[0] == 'NO ERROR': return [] else: for error in errors: log.error(f'{self.name}: {error}') return errors def _wait_for_commands_processed(self, timeout=1): """ Wait until the commands have been processed by the 8116A. """ start = time.time() while not self.complete: time.sleep(0.001) if time.time() - start > timeout: raise RuntimeError('Timeout waiting for commands to be processed.') def _check_has_option_001(self): """ Return True if the 8116A has option 001 and False otherwise. This is done by checking the length of the response to the CST (current status) command which includes sweep parameters and burst parameters only if the 8116A has option 001. """ # The longest possible state string is 163 characters long including termination characters state_string = self.ask('CST', 163).split('\r\n')[0].strip(' ,\r\n') if len(state_string) == 159: return True elif len(state_string) == 87: return False else: log.warning('Could not determine if 8116A has option 001. Assuming it has.') return True ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp856Xx.py0000644000175100017510000037245115203313266022053 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from math import log10 from enum import Enum, IntFlag from datetime import datetime import numpy as np from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, truncated_discrete_set, \ joined_validators, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) try: from enum import StrEnum except ImportError: class StrEnum(str, Enum): """Until StrEnum is broadly available / pymeasure relies on python <= 3.10.x.""" def __str__(self): return self.value class WindowType(StrEnum): """Enumeration to represent the different window mode for FFT functions""" #: Flattop provides optimum amplitude accuracy Flattop = "FLATTOP" #: Hanning provides an amplitude accuracy/frequency resolution compromise Hanning = "HANNING" #: Uniform provides equal weighting of the time record for measuring transients. Uniform = "UNIFORM" class StatusRegister(IntFlag): """Enumeration to represent the Status Register.""" #: Request Service RQS = 64 #: Set when error present ERROR_PRESENT = 32 #: Any command is completed COMMAND_COMPLETE = 16 #: Unused but sometimes set NA = 8 #: Set when any sweep is completed END_OF_SWEEP = 4 #: Set when display message appears MESSAGE = 2 #: Trigger is activated TRIGGER = 1 #: No Interrupts can interrupt the program sequence NONE = 0 class Trace(StrEnum): """Enumeration to represent either Trace A or Trace B.""" #: Trace A A = "TRA" #: Trace B B = "TRB" class SweepCoupleMode(StrEnum): """Enumeration.""" #: Stimulus Response SpectrumAnalyzer = "SA" #: Spectrum Analyeze StimulusResponse = "SR" class SweepOut(StrEnum): """Enumeration.""" #: 0 - 10V Ramp Ramp = "RAMP" #: DC Ramp 0.5V / GHz Fav = "FAV" class MixerMode(StrEnum): """Enumeration to represent the Mixer Mode of the HP8561B.""" #: Mixer Mode Internal Internal = "INT" #: Mixer Mode External External = "EXT" class SourceLevelingControlMode(StrEnum): """Enumeration to represent the Source Leveling Control Mode of the HP8560A.""" #: Source Leveling Control Mode Internal Internal = "INT" #: Source Leveling Control Mode External External = "EXT" class PeakSearchMode(StrEnum): """Enumeration to represent the Marker Peak Search Mode.""" #: Place marker to the highest value on the trace High = "HI" #: Place marker to the next highest value on the trace NextHigh = "NH" #: Place marker to the next peak to the right NextRight = "NR" #: Place marker to the next peak to the left NextLeft = "NL" class CouplingMode(StrEnum): """Enumeration to represent the Coupling Mode.""" #: AC AC = "AC" #: DC DC = "DC" class DemodulationMode(StrEnum): """Enumeration to represent the Demodulation Mode.""" #: Amplitude Modulation Amplitude = "AM" #: Frequency Modulation Frequency = "FM" #: Demodulation Off Off = "OFF" class TriggerMode(StrEnum): """Enumeration to represent the different trigger modes""" #: External Mode External = "EXT" #: Free Running Free = "FREE" #: Line Mode Line = "LINE" #: Video Mode Video = "VID" class TraceDataFormat(StrEnum): """Enumeration to represent the different trace data formats.""" #: A-Block format A_BLOCK = "A" #: Binary format BINARY = "B" #: I-Block format I_BLOCK = "I" #: ASCII format ASCII = "M" #: Real numbers format like are in Hz, volts, watts, dBm, dBmV, dBuV, dBV, or seconds. REAL = "P" class FrequencyReference(StrEnum): """Enumeration to represent the frequency reference source.""" #: Internal Frequency Reference Internal = "INT" #: External Frequency Standard External = "EXT" class DetectionModes(StrEnum): """Enumeration to represent the Detection Modes.""" #: Negative Peak Detection NegativePeak = "NEG" #: Normal Peak Detection Normal = "NRM" #: Positive Peak Detection PositivePeak = "POS" #: Sampl Mode Detection Sample = "SMP" class AmplitudeUnits(StrEnum): """Enumeration to represent the amplitude units.""" #: DB over millit Watt DBM = "DBM" #: DB over milli Volt DBMV = "DBMV" #: DB over micro Volt DBUV = "DBUV" #: Volts V = "V" #: Watt W = "W" #: Automatic Unit (Usually derives to 'DBM') AUTO = "AUTO" #: Manual Mode MANUAL = "MAN" class ErrorCode: """ Class to decode error codes from the spectrum analyzer. """ __error_code_list = { 0: ("NO ERR", "No Error at all"), 100: ("PWRON", "Power-on state is invalid; default state is loaded"), 101: ("NO STATE", "State to be RECALLed not valid or not SAVEd"), 106: ("ABORTED!", "Current operation is aborted; HP-IB parser reset"), 107: ("HELLO ??", "No HP-IB listener is present"), 108: ("TIME OUT", "Analyzer timed out when acting as controller"), 109: ("CtrlFail", "Analyzer unable to take control of the bus"), 110: ("NOT CTRL", "Analyzer is not system controller"), 111: ("# ARGMTS", "Command does not have enough arguments"), 112: ("??CMD??", "Unrecognized command"), 113: ("FREQ NQ!", "Command cannot have frequency units"), 114: ("TIME NOG!", "Command cannot have time units"), 115: ("AMPL NO!", "Command cannot have amplitude units"), 116: ("PUNITS??", "Unrecognizable units"), 117: ("NOP NUM", "Command cannot have numeric units"), 118: ("NOP EP", "Enable parameter cannot be used"), 119: ("NOP UPDN", "UP/DN are not valid arguments for command"), 120: ("NOP ONOF", "ON/OFF are not valid arguments for command"), 121: ("NOP ARG", "AUTO/MAN are not valid arguments for command"), 122: ("NOP TRC", "Trace registers are not valid for command"), 123: ("NOP ABLK", "A-block format not valid here"), 124: ("NOP IBLK", "I-block format not valid here"), 125: ("NOP STRNG", "Strings are not valid for this command"), 126: ("NO ?", "This command cannot be queried"), 127: ("BAD DTMD", "Not a valid peak detector mode"), 128: ("PK WHAT?", "Not a valid peak search parameter"), 129: ("PRE TERM", "Premature A-block termination"), 130: ("BAD TDF", "Arguments are only for TDF command"), 131: ("?? AM/FM", "AM/FM are not valid arguments for this command"), 132: ("!FAV/RMP", "FAV/RAMP are not valid arguments for this command"), 133: ("!INT/EXT", "INT/EXT are not valid arguments for this command"), 134: ("??? ZERO", "ZERO is not a valid argument for this command"), 135: ("??? CURR", "CURR is not a valid argument for this command"), 136: ("??? FULL", "FULL is not a valid argument for this command"), 137: ("??? LAST", "LAST is not a valid argument for this command"), 138: ("!GRT/DSP", "GRT/DSP are not valid arguments for this command"), 139: ("PLOTONLY", "Argument can only be used with PLOT command"), 140: ("?? PWRON", "PWRON is not a valid argument for this command"), 141: ("BAD ARG", "Argument can only be used with FDIAG command"), 142: ("BAD ARG", "Query expected for FDIAG command"), 143: ("NO PRESL", "No preselector hardware to use command with (HP 8562B)"), 200: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 201: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 250: ("OUTOF RG", "ADC input is outside of ADC range"), 251: ("NO IRQ", "Microprocessor not receiving interrupt from ADC"), 300: ("YTO UNLK", "YTO (1ST LO) phase-locked loop (PLL) is unlocked"), 301: ("YTO UNLK", "YTO PLL is unlocked"), 302: ("OFF UNLK", "Offset Roller Oscillator PLL is unlocked"), 303: ("XFR UNLK", "Transfer Roller Oscillator PLL is unlocked"), 304: ("ROL UNLK", "Main Roller Oscillator PLL is unlocked"), 305: ("FREQ ACC", "Frequency accuracy error"), 306: ("FREQ ACC", "Frequency accuracy error"), 307: ("FREQ ACC", "Frequency accuracy error"), 308: ("FREQ ACC", "Frequency accuracy error"), 309: ("FREQ ACC", "Frequency accuracy error"), 310: ("FREQ ACC", "Frequency accuracy error"), 311: ("FREQ ACC", "Frequency accuracy error"), 312: ("FREQ ACC", "Frequency accuracy error"), 313: ("FREQ ACC", "Frequency accuracy error"), 314: ("FREQ ACC", "Frequency accuracy error"), 315: ("FREQ ACC", "Frequency accuracy error"), 316: ("FREQ ACC", "Frequency accuracy error"), 317: ("FREQ ACC", "Frequency accuracy error"), 318: ("FREQ ACC", "Frequency accuracy error"), 319: ("FREQ ACC", "Frequency accuracy error"), 320: ("FREQ ACC", "Frequency accuracy error"), 321: ("FREQ ACC", "Frequency accuracy error"), 322: ("FREQ ACC", "Frequency accuracy error"), 323: ("FREQ ACC", "Frequency accuracy error"), 324: ("FREQ ACC", "Frequency accuracy error"), 325: ("FREQ ACC", "Frequency accuracy error"), 326: ("FREQ ACC", "Frequency accuracy error"), 327: ("OFF UNLK", "Offset Roller Oscillator PLL is unlocked"), 328: ("FREQ ACC", "Frequency accuracy error"), 329: ("FREQ ACC", "Frequency accuracy error"), 331: ("FREQ ACC", "Frequency accuracy error"), 333: ("600 UNLK", "600 MHz Reference Oscillator PLL is unlocked"), 334: ("LO AMPL", "YTO (ist LO) unleveled"), 400: ("AMPL 100", "Unable to adjust amplitude of 100 Hz resolution bandwidth"), 401: ("AMPL 300", "Unable to adjust amplitude of 300 Hz resolution bandwidth"), 402: ("AMPL 1K", "Unable to adjust amplitude of 1 kHz resolution bandwidth"), 403: ("AMPL 3K", "Unable to adjust amplitude of 3 kHz resolution bandwidth"), 404: ("AMPL 10K", "Unable to adjust amplitude of 10 kHz resolution bandwidth"), 405: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 406: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 407: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 408: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 409: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 410: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 411: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 412: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 413: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 414: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 415: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 416: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 417: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 418: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 419: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 420: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 421: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 422: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 423: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 424: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 425: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 426: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 427: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 428: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 429: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 430: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 431: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 432: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 433: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 434: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 435: ("RBW 301", "Unable to adjust 300 Hz resolution bandwidth"), 436: ("RBW 302", "Unable to adjust 300 Hz resolution bandwidth"), 437: ("RBW 303", "Unable to adjust 300 Hz resolution bandwidth"), 438: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 439: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 440: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 441: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 442: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 443: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 444: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 445: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 446: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 447: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 448: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 449: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 450: ("IF SYSTM", "IF hardware failure Check other error messages"), 451: ("IF SYSTM", "IF hardware failure Check other error messages"), 452: ("IF SYSTM", "IF hardware failure Check other error messages"), 454: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 455: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 456: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 457: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 458: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 459: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 460: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 461: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 462: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 463: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 464: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 465: ("FREQ ACC", "Unable to adjust step gain amplifiers"), 466: ("LIN AMPL", "Unable to adjust linear amplitude scale"), 467: ("LOG AMPL", "Unable to adjust log amplitude scale"), 468: ("LOG AMPL", "Unable to adjust log amplitude scale"), 469: ("LOG AMPL", "Unable to adjust log amplitude scale"), 470: ("LOG AMPL", "Unable to adjust log amplitude scale"), 471: ("RBW 30K", "Unable to adjust 30 kHz resolution bandwidth"), 472: ("RBW 100K", "Unable to adjust 100 kHz resolution bandwidth"), 473: ("RBW 300K", "Unable to adjust 300 kHz resolution bandwidth"), 474: ("RBW 1M", "Unable to adjust 1 MHz resolution bandwidth"), 475: ("RBW 30K", "Unable to adjust 30 kHz resolution bandwidth"), 476: ("RBW 100K", "Unable to adjust 30 kHz resolution bandwidth"), 477: ("RBW 300K", "Unable to adjust 300 kHz resolution bandwidth"), 478: ("RBW 1M", "Unable to adjust 1 MHz resolution bandwidth"), 483: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 484: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 485: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 486: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 487: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 488: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 489: ("RBW 101", "Unable to adjust 100 Hz resolution bandwidth"), 490: ("RBW 102", "Unable to adjust 100 Hz resolution bandwidth"), 491: ("RBW 103", "Unable to adjust 100 Hz resolution bandwidth"), 492: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 493: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 494: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 495: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 496: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 497: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 498: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 499: ("CAL UNLK", "A16 IF Adjustment Cal Oscillator is unlocked"), 500: ("AMPL 30K", "Unable to adjust amplitude of 30 kHz resolution bandwidth"), 501: ("AMPL 1M", "Unable to adjust amplitude of 100 kHz resolution bandwidth"), 502: ("AMPL 3M", "Unable to adjust amplitude of 300 kHz resolution bandwidth"), 503: ("AMPL 1M", "Unable to adjust amplitude of 1 MHz resolution bandwidth"), 504: ("AMPL 30K", "Unable to adjust amplitude of 30 kHz resolution bandwidth"), 505: ("AMPL 1M", "Unabie to adjust amplitude of 100 kHz resolution bandwidth"), 506: ("AMPL 3M", "Unable to adjust amplitude of 300 kHz resolution bandwidth"), 507: ("AMPL 1M", "Unable to adjust amplitude of 1 MHz resolution bandwidth"), 508: ("AMPL 30K", "Unable to adjust amplitude of 30 kHz resolution bandwidth"), 509: ("AMPL 1M", "Unable to adjust amplitude of 100 kHz resolution bandwidth"), 510: ("AMPL 3M", "Unable to adjust amplitude of 300 kHz resolution bandwidth"), 511: ("AMPL 1M", "Unable to adjust amplitude of 1 MHz resolution bandwidth"), 512: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 513: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 514: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 515: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 516: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 517: ("RBW 100", "Unable to adjust 100 Hz resolution bandwidth"), 518: ("RBW 300", "Unable to adjust 300 Hz resolution bandwidth"), 519: ("RBW 1K", "Unable to adjust 1 kHz resolution bandwidth"), 520: ("RBW 3K", "Unable to adjust 3 kHz resolution bandwidth"), 521: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth"), 522: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth SYM POLE 1"), 523: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth SYM POLE 2"), 524: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth SYM POLE 3"), 525: ("RBW 10K", "Unable to adjust 10 kHz resolution bandwidth SYM POLE 4"), 526: ("RBW <300", "Unable to adjust <300 Hz resolution bandwidths"), 527: ("RBW <301", "Step gain correction failed for <300 Hz resolution bandwidth"), 528: ("RBW <302", "Unable to adjust <300 Hz resolution bandwidths"), 529: ("RBW <303", "Unable to adjust <300 Hz resolution bandwidths"), 530: ("RBW <304", "Unable to adjust <300 Hz resolution bandwidths"), 531: ( "RBW <305", "Unable to adjust gain versus frequency for resoultion bandwidths <300 Hz"), 532: ("RBW <306", "Absolute gain data for resolution bandwidths <300 Hz not acceptable"), 533: ("RBW <307", "Unable to adjust <300 Hz resolution bandwidths"), 534: ("RBW <308", "Unable to adjust frequency accuracy for resolution bandwidths <100 Hz"), 535: ("RBW <309", "Unable to adjust <300 Hz resolution bandwidths"), 536: ("RBW <310", "Unable to adjust <300 Hz resolution bandwidths"), 537: ("RBW <311", "Unable to adjust <300 Hz resolution bandwidths"), 538: ("RBW <312", "Unable to adjust <300 Hz resolution bandwidths"), 539: ("RBW <313", "Unable to adjust <300 Hz resolution bandwidths"), 540: ("RBW <314", "Unable to adjust <300 Hz resolution bandwidths"), 551: ("AMPL", "Unable to adjust step gain amplifiers"), 552: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 553: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 554: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 555: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 556: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 557: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 558: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 559: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 560: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 561: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 562: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 563: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 564: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 565: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 566: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 567: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 568: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 569: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 570: ("LOG AMPL", "Unable to adjust amplitude of log scale"), 571: ("AMPL", "Unable to adjust step gain amplifiers"), 572: ("AMPL 1M", "Unable to adjust amplitude of 1 MHz resolution bandwidth"), 573: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 574: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 575: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 576: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 577: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 581: ("AMPL", "Unable to adjust 100 kHz and <10 kHz resolution bandwidths"), 582: ("AMPL", "Unable to adjust 100 kHz and <10 kHz resolution bandwidths"), 583: ("RBW 30K", "Unable to adjust 30 kHz resolution bandwidth"), 584: ("RBW 100K", "Unable to adjust 100 kHz resolution bandwidth"), 585: ("RBW 300K", "Unable to adjust 300 kHz resolution bandwidth"), 586: ("RBW 1M", "Unable to adjust 1 MHz resolution bandwidth"), 587: ("RBW 30K", "Unable to adjust 30 kHz resolution bandwidth"), 588: ("RBW 300K", "Unable to adjust 100 kHz resolution bandwidth"), 589: ("RBW 300K", "Unable to adjust 300 kHz resolution bandwidth"), 590: ("RBW 1M", "Unable to adjust 1 MHz resolution bandwidth"), 591: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 592: ("LOG AMPL", "Unable to adjust amplitude in log scale"), 600: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 601: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 650: ("OUTOF RG", "ADC input is outside of the ADC range"), 651: ("NO IRQ", "Microprocessor is not receiving interrupt from ADC"), 700: ("EEROM", "Checksum error of EEROM A2U501"), 701: ("AMPL CAL", "Checksum error of frequency response correction data"), 702: ("ELAP TIM", "Checksum error of elapsed time data"), 703: ("AMPL CAL", "Checksum error of frequency response correction data"), 704: ("PRESELCT", "Checksum error of customer preselector peak data"), 705: ("ROM U306", "Checksum error of program ROM A2U306"), 706: ("ROM U307", "Checksum error of program ROM A2U307"), 707: ("ROM U308", "Checksum error of program ROM A2U308"), 708: ("ROM U309", "Checksum error of program ROM A2U309"), 709: ("ROM U310", "Checksum error of program ROM A2U310"), 710: ("ROM U311", "Checksum error of program ROM A2U311"), 711: ("RAM U303", "Checksum error of system RAM A2U303"), 712: ("RAM U302", "Checksum error of system RAM A2U302"), 713: ("RAM U301", "Checksum error of system RAM A2U301"), 714: ("RAM U300", "Checksum error of system RAM A2U300"), 715: ("RAM U305", "Checksum error of system RAM A2U305"), 716: ("RAM U304", "Checksum error of system RAM A2U304"), 717: ("BAD uP!!", "Microprocessor not fully operational"), 718: ("BATTERY?", "Nonvolatile RAM not working; check battery"), 750: ("SYSTEM", "Hardware/ firmware interaction; check other errors"), 751: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 752: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 753: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 754: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 755: ("SYSTEM", "Hardware/firmware interaction; check other errors"), 900: ("TG UNLVL", "Tracking generator output is unleveled"), 901: ("TGFrqLmt", "Tracking generator output unleveled because START FREQ is set " "below tracking generator frequency limit (300 kHz)"), 902: ("BAD NORM", "The state of the stored trace does not match the current state of the analyzer"), 903: ("&> DLMT", "Unnormalized trace A is off-screen with trace math or normalization on"), 904: ( "&> DLMT", "Calibration trace (trace B) is off-screen with trace math or normalization on") } # integer representation of error code code = 0 def __init__(self, code): """Initialize an ErrorCode. :param code: Representing an error as id or short description :type code: str, int """ if not (isinstance(code, int) or isinstance(code, str)): print(type(code)) raise TypeError("Initialziation type for code must be integer or string") try: self.code = int(code) if self.code not in self.__error_code_list.keys(): raise ValueError() except (ValueError, TypeError): raise ValueError("This error code doesn't exist") (self.short, self.long) = self.__error_code_list[self.code] def __repr__(self): return "ErrorCode(\"" + self.short + " - " + self.long + "\")" def __eq__(self, other): return self.code == other.code class HP856Xx(Instrument): """Represents the HP856XX series spectrum analyzers. Don't use this class directly - use their derivative classes .. note:: Most command descriptions are taken from the document: 'HP 8560A, 8561B Operating & Programming' """ def __init__(self, adapter, name="Hewlett-Packard HP856Xx", **kwargs): super().__init__( adapter, name, includeSCPI=False, send_end=True, **kwargs, ) def adjust_all(self): """Activate the local oscillator (LO) and intermediate frequency (IF) alignment routines. These are the same routines that occur when is switched on. Commands following 'adjust_all' are not executed until after the analyzer has finished the alignment routines. """ self.write("ADJALL") def set_crt_adjustment_pattern(self): """Activate a CRT adjustment pattern, shown in Figure 5-3. Use the X POSN, Y POSN, and TRACE ALIGN adjustments (available from the rear panel) to align the display. Use X POSN and Y POSN to move the display horizontally and vertically, respectively. Use TRACE ALIGN to straighten a tilted display. To remove the pattern from the screen, execute the :meth:`preset` command.""" self.write("ADJCRT") adjust_if = Instrument.control( "ADJIF?", "ADJIF %s", """ Control the automatic IF adjustment. This function is normally on. Because the IF is continuously adjusting, executing the IF alignment routine is seldom necessary. When the IF adjustment is not active, an "A" appears on the left side of the display. - `"FULL"` IF adjustment is done for all IF settings. - `"CURR"` IF adjustment is done only for the IF settings currently displayed. - `False` turns the continuous IF adjustment off. - `True` reactivates the continuous IF adjustment. Type: :code:`bool, str` """, validator=strict_discrete_set, map_values=True, values={True: "1", False: "0", "FULL": "FULL", "CURR": "CURR"}, cast=str ) trace_a_minus_b_enabled = Instrument.control( "AMB?", "AMB %s", """ Control subtraction of the contents of trace B from trace A. It places the result, in dBm (when in log mode), in trace A. When in linear mode, the result is in volts. If trace A is in clear-write or max-hold mode, this function is continuous. When AMB is active, an "M" appears on the left side of the display. :attr:`trace_a_minus_b_plus_dl` overrides AMB. Type: :code:`bool` .. warning:: The displayed amplitude of each trace element falls in one of 600 data points. There are 10 points of overrange, which corresponds to one-sixth of a division Kg of overrange. When adding or subtracting trace data, any results exceeding this limit are clipped at the limit. """, validator=strict_discrete_set, map_values=True, values={True: "1", False: "0"}, cast=str ) trace_a_minus_b_plus_dl_enabled = Instrument.control( "AMBPL?", "AMBPL %s", """ Control subtraction of trace B from trace A and addition to the display line, and stores the result in dBm (when in log mode) in trace A. When in linear mode, the result is in volts. If trace A is in clear-write or max-hold mode, this function is continuous. When this function is active, an "M" appears on the left side of the display. Type: :code:`bool` .. warning:: The displayed amplitude of each trace element falls in one of 600 data points. There are 10 points of overrange, which corresponds to one-sixth of a division Kg of overrange. When adding or subtracting trace data, any results exceeding this limit are clipped at the limit. """, validator=strict_discrete_set, map_values=True, values={True: "1", False: "0"}, cast=str ) annotation_enabled = Instrument.control( "ANNOT?", "ANNOT %s", """ Set the display annotation off or on. Type: :code:`bool` """, validator=strict_discrete_set, map_values=True, values={True: "1", False: "0"}, cast=str ) attenuation = Instrument.control( "AT?", "AT %s", """ Control the input attenuation in decade steps from 10 to 70 db (type 'int') or set to 'AUTO' and 'MAN'(ual) Type: :code:`str`, :code:`int` .. code-block:: python instr.attenuation = 'AUTO' instr.attenuation = 60 """, validator=joined_validators(strict_discrete_set, truncated_discrete_set), values=[["AUTO", "MAN"], np.arange(10, 80, 10)], cast=int, ) amplitude_unit = Instrument.control( "AUNITS?", "AUNITS %s", """ Control the amplitude unit with a selection of the following parameters: string 'DBM', 'DBMV', 'DBUV', 'V', 'W', 'AUTO', 'MAN' or use the enum :class:`AmplitudeUnits` Type: :code:`str` .. code-block:: python instr.amplitude_unit = 'dBmV' instr.amplitude_unit = AmplitudeUnits.dBmV """, validator=strict_discrete_set, values=[str(e).upper() for e in AmplitudeUnits], set_process=lambda v: str(v).upper() ) def write(self, command, **kwargs): if "{amplitude_unit}" in command: command = command.format(amplitude_unit=self.amplitude_unit) super().write(command, **kwargs) def set_auto_couple(self): """Set the video bandwidth, resolution bandwidth, input attenuation, sweep time, and center frequency step-size to coupled mode. These functions can be recoupled individually or all at once. The spectrum analyzer chooses appropriate values for these functions. The video bandwidth and resolution bandwidth are set according to the coupled ratios stored under :attr:`resolution_bandwidth_to_span_ratio` and :attr:`video_bandwidth_to_resolution_bandwidth`. If no ratios are chosen, default ratios (1.0 and 0.011, respectively) are used instead. """ self.write("AUTOCPL") def exchange_traces(self): """Exchange the contents of trace A with those of trace B. If the traces are in clear-write or max-hold mode, the mode is changed to view. Otherwise, the traces remain in their initial mode. """ self.write("AXB") def blank_trace(self, trace): """Blank the chosen trace from the display. The current contents of the trace remain in the trace but are not updated. .. code-block:: python instr.blank_trace('TRA') instr.blank_trace(Trace.A) :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :raises TypeError: Type isn't 'string' :raises ValueError: Value is 'TRA' nor 'TRB' """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) self.write("BLANK " + trace) def subtract_display_line_from_trace_b(self): """Subtract the display line from trace B and places the result in dBm (when in log mode) in trace B, which is then set to view mode. In linear mode, the results are in volts. """ self.write("BML") center_frequency = Instrument.control( "CF?", "CF %.11E Hz", """ Control the center frequency in hertz and sets the spectrum analyzer to center frequency / span mode. The span remains constant; the start and stop frequencies change as the center frequency changes. Type: :code:`float` .. code-block:: python instr.center_frequency = 300.5e6 if instr.center_frequency == 200e3: print("Correct frequency") """, validator=strict_range, values=[0, 1], dynamic=True ) def clear_write_trace(self, trace): """Set the chosen trace to clear-write mode. This mode sets each element of the chosen trace to the bottom-screen value; then new data from the detector is put in the trace with each sweep. .. code-block:: python instr.clear_write_trace('TRA') instr.clear_write_trace(Trace.A) :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :raises TypeError: Type isn't 'string' :raises ValueError: Value is 'TRA' nor 'TRB' """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) self.write("CLRW " + trace) def set_continuous_sweep(self): """Set the instrument to continuous-sweep mode. This mode enables another sweep at the completion of the current sweep once the trigger conditions are met. """ self.write("CONTS") coupling = Instrument.control( "COUPLE?", "COUPLE %s", """ Control the input coupling of the spectrum analyzer. AC coupling protects the input of the analyzer from damaging dc signals, while limiting the lower frequency-range to 100 kHz (although the analyzer will tune down to 0 Hz with signal attenuation). Type: :code:`str` Takes a representation of the coupling mode, either from :class:`CouplingMode` or use 'AC' / 'DC' .. code-block:: python instr.coupling = 'AC' instr.coupling = CouplingMode.DC if instr.coupling == CouplingMode.DC: pass """, validator=strict_discrete_set, values=[e for e in CouplingMode] ) demodulation_mode = Instrument.control( "DEMOD?", "DEMOD %s", """ Control the demodulation mode of the spectrum analyzer. Either AM or FM demodulation, or turns the demodulation — off. Place a marker on a desired signal and then set :attr:`demodulation_mode`; demodulation takes place on this signal. If no marker is on, :attr:`demodulation_mode` automatically places a marker at the center of the trace and demodulates the frequency at that marker position. Use the volume and squelch controls to adjust the speaker and listen. Type: :code:`str` Takes a representation of the demodulation mode, either from :class:`DemodulationMode` or use 'OFF', 'AM', 'FM' .. code-block:: python instr.demodulation_mode = 'AC' instr.demodulation_mode = DemodulationMode.AM if instr.demodulation_mode == DemodulationMode.FM: instr.demodulation_mode = Demodulation.OFF """, validator=strict_discrete_set, values=[e for e in DemodulationMode] ) demodulation_agc_enabled = Instrument.control( "DEMODAGC?", "DEMODAGC %s", """ Control the demodulation automatic gain control (AGC). The AGC keeps the volume of the speaker relatively constant during AM demodulation. AGC is available only during AM demodulation and when the frequency span is greater than 0 Hz. Type: :code:`bool` .. code-block:: python instr.demodulation_agc = True if instr.demodulation_agc: instr.demodulation_agc = False """, validator=strict_discrete_set, map_values=True, values={True: "1", False: "0"}, cast=str ) demodulation_time = Instrument.control( "DEMODT?", "DEMODT %.11E", """ Control the amount of time that the sweep pauses at the marker to demodulate a signal. The default value is 1 second. When the frequency span equals 0 Hz, demodulation is continuous, except when between sweeps. For truly continuous demodulation, set the frequency span to 0 Hz and the trigger mode to single sweep (see TM). Minimum 100 ms to maximum 60 s Type: :code:`float` .. code-block:: python # set the demodulation time to 1.2 seconds instr.demodulation_time = 1.2 if instr.demodulation_time == 10: pass """, validator=strict_range, values=[100e-3, 60], ) detector_mode = Instrument.control( "DET?", "DET %s", """ Control the IF detector used for acquiring measurement data. This is normally a coupled function, in which the spectrum analyzer selects the appropriate detector mode. Four modes are available: normal, positive, negative, and sample. Type: :code:`str` Takes a representation of the detector mode, either from :class:`DetectionModes` or use 'NEG', 'NRM', 'POS', 'SMP' .. code-block:: python instr.detector_mode = DetectionModes.SMP instr.detector_mode = 'NEG' if instr.detector_mode == DetectionModes.SMP: pass """, validator=strict_discrete_set, values=[e for e in DetectionModes] ) # now implemented as a property but due to the ability of the underlying gpib command to # specify the unit, there would be an alternative implementation as a method to allow the user # to modify the setting unit without manipulating it via the 'amplitude_unit' property display_line = Instrument.control( "DL?", "DL %g.11E {amplitude_unit}", """ Control the horizontal display line for use as a visual aid or for computational purposes. The default value is 0 dBm. Type: :code:`float` Takes a value with the unit of :attr:`amplitude_unit` .. code-block:: python instr.display_line = -10 if instr.display_line == 0: pass """ ) display_line_enabled = Instrument.setting( "DL %s", """ Set the horizontal display line for use as a visual aid either on or off. .. code-block:: python instr.display_line_enabled = False """, map_values=True, validator=strict_discrete_set, values={True: "ON", False: "OFF"} ) done = Instrument.measurement( "DONE?", """ Get back (e.g. return) when all commands in a command string entered before 'done' has been completed. Sending a :meth:`trigger_sweep` command before 'done' ensures that the spectrum analyzer will complete a full sweep before continuing on in a program. Depending on the timeout a timeout error from the adapter will raise before the spectrum analyzer can finish due to an extreme long sweep time .. code-block:: python instr.trigger_sweep() # wait for a full sweep and than 'do_something' if instr.done: do_something() """ ) def check_done(self): """ Return when all commands in a command string entered before :meth:'check_done' has been completed. Sending a :meth:`trigger_sweep` command before 'check_done' ensures that the spectrum analyzer will complete a full sweep before continuing on in a program. Depending on the timeout a timeout error from the adapter will raise before the spectrum analyzer can finish due to an extreme long sweep time. .. code-block:: python instr.trigger_sweep() # wait for a full sweep and than 'do_something' instr.check_done() do_something() """ # no error checking because there is no possibility to return anything else than '1' self.ask("DONE?") errors = Instrument.measurement( "ERR?", """ Get a list of errors present (of type :class:`ErrorCode`). An empty list means there are no errors. Reading 'errors' clears all HP-IB errors. For best results, enter error data immediately after querying for errors. Type: :class:`ErrorCode` .. code-block:: python errors = instr.errors if len(errors) > 0: print(errors[0].code) for error in errors: print(error) if ErrorCode(112) in errors: print("yeah") Example result of this python snippet: .. code-block:: python 112 ErrorCode("??CMD?? - Unrecognized command") ErrorCode("NOP NUM - Command cannot have numeric units") yeah """, cast=ErrorCode, get_process=lambda value: [], ) elapsed_time = Instrument.measurement( "EL?", """ Get the elapsed time (in hours) of analyzer operation. This value can be reset only by Hewlett-Packard. Type: :code:`int` .. code-block:: python print(elapsed_time) 1998 """, cast=int ) start_frequency = Instrument.control( "FA?", "FA %.11E Hz", """ Control the start frequency and set the spectrum analyzer to start-frequency/ stop-frequency mode. If the start frequency exceeds the stop frequency, the stop frequency increases to equal the start frequency plus 100 Hz. The center frequency and span change with changes in the start frequency. Type: :code:`float` .. code-block:: python instr.start_frequency = 300.5e6 if instr.start_frequency == 200e3: print("Correct frequency") """, validator=strict_range, values=[0, 1], dynamic=True ) stop_frequency = Instrument.control( "FB?", "FB %.11E Hz", """ Control the stop frequency and set the spectrum analyzer to start-frequency/ stop-frequency mode. If the stop frequency is less than the start frequency, the start frequency decreases to equal the stop frequency minus 100 Hz. The center frequency and span change with changes in the stop frequency. Type: :code:`float` .. code-block:: python instr.stop_frequency = 300.5e6 if instr.stop_frequency == 200e3: print("Correct frequency") """, validator=strict_range, values=[0, 1], dynamic=True ) sampling_frequency = Instrument.measurement( "FDIAG SMP,?", """ Get the sampling oscillator frequency corresponding to the current start frequency. Diagnostic Attribute Type: :code:`float` """ ) lo_frequency = Instrument.measurement( "FDIAG LO,?", """ Get the first local oscillator frequency corresponding to the current start frequency. Diagnostic Attribute Type: :code:`float` """ ) mroll_frequency = Instrument.measurement( "FDIAG MROLL,?", """ Get the main roller oscillator frequency corresponding to the current start frequency, except then the resolution bandwidth is less than or equal to 100 Hz. Diagnostic Attribute Type: :code:`float` """ ) oroll_frequency = Instrument.measurement( "FDIAG OROLL,?", """ Get the offset roller oscillator frequency corresponding to the current start frequency, except when the resolution bandwidth is less than or equal to 100 Hz. Diagnostic Attribute Type: :code:`float` """ ) xroll_frequency = Instrument.measurement( "FDIAG XROLL,?", """ Get the transfer roller oscillator frequency corresponding to the current start frequency, except when the resolution bandwidth is less than or equal to 100 Hz. Diagnostic Attribute Type: :code:`float` """ ) sampler_harmonic_number = Instrument.measurement( "FDIAG HARM,?", """ Get the sampler harmonic number corresponding to the current start frequency. Diagnostic Attribute Type: :code:`int` """, get_process=lambda v: int(float(v)) ) # practically you could also write "OFF" to actively disable it or reset via "IP" frequency_display_enabled = Instrument.measurement( "FDSP?", """ Get the state of all annotations that describes the spectrum analyzer frequency. returns 'False' if no annotations are shown and vice versa 'True'. This includes the start and stop frequencies, the center frequency, the frequency span, marker readouts, the center frequency step-size, and signal identification to center frequency. To retrieve the frequency data, query the spectrum analyzer. Type: :code:`bool` .. code-block:: python if instr.frequency_display: print("Frequencies get displayed") """, map_values=True, values={True: "1", False: "0"}, cast=str ) def do_fft(self, source, destination, window): """Calculate and show a discrete Fourier transform. The FFT command performs a discrete Fourier transform on the source trace array and stores the logarithms of the magnitudes of the results in the destination array. The maximum length of any of the traces is 601 points. FFT is designed to be used in transforming zero-span amplitude-modulation information into the frequency domain. Performing an FFT on a frequency sweep will not provide time-domain results. The FFT results are displayed on the spectrum analyzer in a logarithmic amplitude scale. For the horizontal dimension, the frequency at the left side of the graph is 0 Hz, and at the right side is Finax- Fmax is equal to 300 divided by sweep time. As an example, if the sweep time of the analyzer is 60 ms, Fmax equals 5 kHz. The FFT algorithm assumes that the sampled signal is periodic with an integral number of periods within the time-record length (that is, the sweep time of the analyzer). Given this assumption, the transform computed is that of a time waveform of infinite duration, formed of concatenated time records. In actual measurements, the number of periods of the sampled signal within the time record may not be integral. In this case, there is a step discontinuity at the intersections of the concatenated time records in the assumed time waveform of infinite duration. This step discontinuity causes measurement errors, both amplitude uncertainty (where the signal level appears to vary with small changes in frequency) and frequency resolution (due to filter shape factor and sidelobes). Windows are weighting functions that are applied to the input data to force the ends of that data smoothly to zero, thus reducing the step discontinuity and reducing measuremen errors. :param source: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :param destination: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :param window: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type source: str :type destination: str :type window: str """ if not isinstance(source, str): raise TypeError("Should be of type string but is '%s'" % type(source)) if not isinstance(destination, str): raise TypeError("Should be of type string but is '%s'" % type(destination)) if not isinstance(window, str): raise TypeError("Should be of type string but is '%s'" % type(window)) if source not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], source)) if destination not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], destination)) if window not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], window)) self.write("FFT %s,%s,%s" % (source, destination, window)) frequency_offset = Instrument.control( "FOFFSET?", "FOFFSET %.11E Hz", """ Control an offset added to the displayed absolute-frequency values, including marker-frequency values. It does not affect the frequency range of the sweep, nor does it affect relative frequency readouts. When this function is active, an "F" appears on the left side of the display. Changes all the following frequency measurements. Type: :code:`float` .. code-block:: python instr.frequency_offset = 2e6 if instr.frequency_offset == 2e6: print("Correct frequency") """, validator=strict_range, values=[0, 1], dynamic=True ) frequency_reference_source = Instrument.control( "FREF?", "FREF %s", """ Control the frequency reference source. Select either the internal frequency reference (INT) or supply your own external reference (EXT). An external reference must be 10 MHz (+100 Hz) at a minimum amplitude of 0 dBm. Connect the external reference to J9 (10 MHz REF IN/OUT) on the rear panel. When the external mode is selected, an "X" appears on the left edge of the display. Type: :code:`str` Takes element of :class:`FrequencyReference` or use 'INT', 'EXT' .. code-block:: python instr.frequency_reference_source = 'INT' instr.frequency_reference_source = FrequencyReference.EXT if instr.frequency_reference_source == FrequencyReference.INT: instr.frequency_reference_source = FrequencyReference.EXT """, validator=strict_discrete_set, values=[e for e in FrequencyReference] ) def set_full_span(self): """Set the spectrum analyzer to the full frequency span as defined by the instrument. The full span is 2.9 GHz for the HP 8560A. For the HP 8561B, the full span is 6.5 GHz. """ self.write("FS") graticule_enabled = Instrument.control( "GRAT?", "GRAT %s", """ Control the display graticule. Switch it either on or off. Type: :class:`bool` .. code-block:: python instr.graticule = True if instr.graticule: pass """, map_values=True, values={True: "1", False: "0"}, validator=strict_discrete_set, cast=str ) def hold(self): """Freeze the active function at its current value. If no function is active, no operation takes place. """ self.write("HD") id = Instrument.measurement( "ID?", """ Get the identification of the device with software and hardware revision (e.g. HP8560A,002, H03) Type: :class:`str` .. code-block:: python print(instr.id) HP8560A,002,H02 """, maxsplit=0, cast=str ) def preset(self): """Set the spectrum analyzer to a known, predefined state. 'preset' does not affect the contents of any data or trace registers or stored preselector data. 'preset' does not clear the input or output data buffers; """ self.write("IP") logarithmic_scale = Instrument.control( "LG?", "LG %d DB", """ Control the logarithmic amplitude scale. When in linear mode, querying 'logarithmic_scale' returns a “0”. Allowed values are 0, 1, 2, 5, 10 Type: :class:`int` .. code-block:: python if instr.logarithmic_scale: pass # set the scale to 10 db per division instr.logarithmic_scale = 10 """, cast=int, validator=strict_discrete_set, values=[0, 1, 2, 5, 10] ) def set_linear_scale(self): """Set the spectrum analyzers display to linear amplitude scale. Measurements made on a linear scale can be read out in any units. """ self.write("LN") def set_minimum_hold(self, trace): """Update the chosen trace with the minimum signal level detected at each trace-data point from subsequent sweeps. This function employs the negative peak detector (refer to the :attr:`detector_mode` command). .. code-block:: python instr.minimum_hold('TRA') instr.minimum_hold(Trace.A) :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :raises TypeError: Type isn't 'string' :raises ValueError: Value is 'TRA' nor 'TRB' """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) self.write("MINH %s" % trace) marker_amplitude = Instrument.measurement( "MKA?", """ Get the amplitude of the active marker. If no marker is active, MKA places a marker at the center of the trace and returns that amplitude value. In the :meth:`amplitude_unit` unit. Type: :code:`float` .. code-block:: python level = instr.marker_amplitude unit = instr.amplitude_unit print("Level: %f %s" % (level, unit)) """ ) def set_marker_to_center_frequency(self): """Set the center frequency to the frequency value of an active marker.""" self.write("MKCF") marker_delta = Instrument.control( "MKD?", "MKD %.11E Hz", """ Control a second marker on the trace. The parameter value specifies the distance in frequency or time (when in zero span) between the two markers. If queried - returns the frequency or time of the second marker. Type: :code:`float` .. code-block:: python # place second marker 1 MHz apart from the first marker instr.marker_delta = 1e6 # print frequency of second marker in case it got moved automatically print(instr.marker_delta) """ ) # the documentation mentions this command, but it doesn't work on my unit and a # reference unit so I leave it here for reference but commented out # # marker_reciprocal = Instrument.control( # "MKDR?", "MKDR %.11E", # """ # Return the reciprocal of the frequency or time (when in zero span) # difference between two markers. # """ # ) marker_frequency = Instrument.control( "MKF?", "MKF %.11E Hz", """ Control the frequency of the active marker. Default units are in Hertz. Type: :code:`float` .. code-block:: python # place marker no. 1 at 100 MHz instr.marker_frequency = 100e6 # print frequency of the marker in case it got moved automatically print(instr.marker_frequency) """, validator=strict_range, values=[0, 1], dynamic=True ) frequency_counter_mode_enabled = Instrument.setting( "MKFC %s", """ Set the device into a frequency counter mode that counts the frequency of the active marker or the difference in frequency between two markers. If no marker is active, 'frequency_counter_mode_enabled' places a marker at the center of the trace and counts that marker frequency. The frequency counter provides a more accurate frequency reading; it pauses at the marker, counts the value, then continues the sweep. To adjust the frequency counter resolution, use the 'frequency_counter_resolution' command. To return the counter value, use the 'marker_frequency' command. .. code-block:: python instr.frequency_counter_mode_enabled = True """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) frequency_counter_resolution = Instrument.control( "MKFCR?", "MKFCR %d Hz", """ Control the resolution of the frequency counter. Refer to the 'frequency_counter_mode' command. The default value is 10 kHz. Type :code:`int` .. code-block:: python # activate frequency counter mode instr.frequency_counter_mode = True # adjust resolution to 1 Hz instr.frequency_counter_resolution = 1 if instr.frequency_counter_resolution: pass """, validator=strict_range, values=[1, 1e1, 1e2, 1e3, 1e4, 1e5, 1e6], maxsplit=0, preprocess_reply=lambda v: str(int(float(v))), cast=int ) def set_marker_minimum(self): """Place an active marker on the minimum signal detected on a trace.""" self.write("MKMIN") # here would be the implementation of the command 'marker_normal' ('MKN') but # it has no advantage over the 'marker_frequency' command except if no marker is active it # places it automagically to the center of the trace (I think there's no sense in # implementing it here) marker_noise_mode_enabled = Instrument.control( "MKNOISE?", "MKNOISE %s", """ Control the detector mode to sample and compute the average of 32 data points (16 points on one side of the marker, the marker itself, and 15 points on the other side of the marker). This average is corrected for effects of the log or linear amplifier, bandwidth shape factor, IF detector, and resolution bandwidth. If two markers are on (whether in 'marker_delta' mode or 1/marker delta mode), 'marker_noise_mode_enabled' works on the active marker and not on the anchor marker. This allows you to measure signal-to-noise density directly. To query the value, use the 'marker_amplitude' command. Type: :code:`bool` .. code-block:: python # activate signal-to-noise density mode instr.marker_noise_mode_enabled = True # get noise density by `marker_amplitude` print("Signal-to-noise density: %d dbm / Hz" % instr.marker_amplitude) """, map_values=True, values={True: "1", False: "0"}, cast=str ) def deactivate_marker(self, all_markers=False): """Turn off the active marker or, if specified, turn off all markers. :param all_markers: If True the call deactivates all markers, if false only the currently active marker (optional) :type all_markers: bool .. code-block:: python # place first marker at 300 MHz instr.marker_frequency = 300e6 # place second marker 2 MHz apart from first instr.marker_delta = 2e6 # deactivate active marker (delta marker) instr.deactivate_marker() # deactivate all markers instr.deactivate_marker(all_markers=True) """ if all_markers: self.write("MKOFF ALL") else: self.write("MKOFF") def search_peak(self, mode): """Place a marker on the highest point on a trace, the next-highest point, the next-left peak, or the next-right peak. The default is 'HI' (highest point). The trace peaks must meet the criteria of the marker threshold and peak excursion functions in order for a peak to be found. See also the :attr:`peak_threshold` and :attr:`peak_excursion` commands. :param mode: Takes 'HI', 'NH', 'NR', 'NL' or the enumeration :class:`PeakSearchMode` :type mode: str .. code-block:: python instr.search_peak('NL') instr.search_peak(PeakSearchMode.NextHigh) """ if not isinstance(mode, str): raise TypeError("Should be of type string but is '%s'" % type(mode)) if mode not in [e for e in PeakSearchMode]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in PeakSearchMode], mode)) self.write("MKPK %s" % mode) marker_threshold = Instrument.control( "MKPT?", "MKPT %g {amplitude_unit}", """ Control the minimum amplitude level from which a peak on the trace can be detected. The default value is -130 dBm. See also the :attr:`peak_excursion` command. Any portion of a peak that falls below the peak threshold is used to satisfy the peak excursion criteria. For example, a peak that is equal to 3 dB above the threshold when the peak excursion is equal to 6 dB will be found if the peak extends an additional 3 dB or more below the threshold level. Maximum 30 db to minimum -200 db. Type: :code:`signed int` .. code-block:: python instr.marker_threshold = -70 if instr.marker_threshold > -80: pass """, validator=strict_range, values=[-200, 30] ) peak_excursion = Instrument.control( "MKPX?", "MKPX %g DB", """ Control what constitutes a peak on a trace. The chosen value specifies the amount that a trace must increase monotonically, then decrease monotonically, in order to be a peak. For example, if the peak excursion is 10 dB, the amplitude of the sides of a candidate peak must descend at least 10 dB in order to be considered a peak (see Figure 5-4) The default value is 6 dB. In linear mode, enter the marker peak excursion as a unit-less number. Any portion of a peak that falls below the peak threshold is also used to satisfy the peak excursion criteria. For example, a peak that is equal to 3 dB above the threshold when the peak excursion is equal to 6 dB will be found if the peak extends an additional 3 dB or more below the threshold level. Type: :code:`float` .. code-block:: python instr.peak_excursion = 2 if instr.peak_excursion == 2: pass """, validator=strict_range, values=[0.1, 99] ) def set_marker_to_reference_level(self): """Set the reference level to the amplitude of an active marker. If no marker is active, 'marker_to_reference_level' places a marker at the center of the trace and uses that marker amplitude to set the reference level. """ self.write("MKRL") def set_marker_delta_to_span(self): """Set the frequency span equal to the frequency difference between two markers on a trace. The start frequency is set equal to the frequency of the left- most marker and the stop frequency is set equal to the frequency of the right-most marker. """ self.write("MKSP") def set_marker_to_center_frequency_step_size(self): """Set the center frequency step-size equal to the frequency value of the active marker.""" self.write("MKSS") marker_time = Instrument.control( "MKT?", "MKT %gS", """ Control the marker's time value. Default units are seconds. Type: :code:`float` .. code-block:: python # set marker at sweep time corresponding second two instr.marker_time = 2 if instr.marker_time == 2: pass """ ) marker_signal_tracking_enabled = Instrument.control( "MKTRACK?", "MKTRACK %s", """ Control whether the center frequency follows the active marker. This is done after every sweep, thus maintaining the marker value at the center frequency. This allows you to “zoom in” quickly from a wide span to a narrow one, without losing the signal from the screen. Or, use 'marker_signal_tracking_enabled' to keep a slowly drifting signal centered on the display. When this function is active, a "K" appears on the left edge of the display. Type: :code:`bool` """, map_values=True, validator=strict_discrete_set, values={True: "1", False: "0"}, cast=str ) mixer_level = Instrument.control( "ML?", "ML %d DB", """ Control the maximum signal level that is at the input mixer. The attenuator automatically adjusts to ensure that this level is not exceeded for signals less than the reference level. From -80 to -10 DB. Type: :code:`int` """, validator=strict_range, cast=int, values=[-80, -10] ) def set_maximum_hold(self, trace): """Set the chosen trace with the maximum signal level detected at each trace-data point from subsequent sweeps. This function employs the positive peak detector (refer to the :attr:`detector_mode` command). The detector mode can be changed, if desired, after max hold is initialized. .. code-block:: python instr.maximum_hold('TRA') instr.maximum_hold(Trace.A) :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :raises TypeError: Type isn't 'string' :raises ValueError: Value is 'TRA' nor 'TRB' """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) self.write("MXMH %s" % trace) normalize_trace_data_enabled = Instrument.control( "NORMLIZE?", "NORMLIZE %s", """ Control the normalization routine for stimulus-response measurements. This function subtracts trace B from trace A, offsets the result by the value of the normalized reference position (:attr:`normalized_reference_level`), and displays the result in trace A. 'normalize_trace_data_enabled' is intended for use with the :meth:`store_open` and :meth:`store_short` or :meth:`store_thru` commands. These functions are used to store a reference trace into trace B. Refer to the respective command descriptions for more information. Accurate normalization occurs only if the reference trace and the measured trace are on-screen. If any of these traces are off-screen, an error message will be displayed. If the error message ERR 903 A > DLMT is displayed, the range level (RL) can be adjusted to move the measured response within the displayed measurement range of the analyzer. If ERR 904 B > DLMT is displayed, the calibration is invalid and a thru or open/short calibration must be performed. If active (ON), the 'normalize_trace_data' command is automatically turned off with an instrument preset (IP) or at power on. Type: :code:`bool` """, map_values=True, validator=strict_discrete_set, values={True: "1", False: "0"}, cast=str ) normalized_reference_level = Instrument.control( "NRL?", "NRL %d {amplitude_unit}", """ Control the normalized reference level. It is intended to be used with the :attr:`normalize_trace_data` command. When using 'normalized_reference_level', the input attenuator and IF step gains are not affected. This function is a trace-offset function enabling the user to offset the displayed trace without introducing hardware-switching errors into the stimulus-response measurement. The unit of measure for 'normalized_reference_level' is dB. In absolute power mode (dBm), reference level ( :attr:`reference_level`) affects the gain and RF attenuation settings of the instrument, which affects the measurement or dynamic range. In normalized mode (relative power or dB-measurement mode), NRL offsets the trace data on-screen and does not affect the instrument gain or attenuation settings. This allows the displayed normalized trace to be moved without decreasing the measurement accuracy due to changes in gain or RF attenuation. If the measurement range must be changed to bring trace data on-screen, then the range level should be adjusted. Adjusting the range-level normalized mode has the same effect on the instrument settings as does reference level in absolute power mode (normalize off). Type: :code:`int` .. code-block:: python # reference level in case of normalization to -30 DB instr.normalized_reference_level = -30 if instr.normalized_reference_level == -30: pass """, validator=strict_range, values=[-200, 30], cast=int ) normalized_reference_position = Instrument.control( "NRPOS?", "NRPOS %f DB", """ Control the normalized reference-position that corresponds to the position on the graticule where the difference between the measured and calibrated traces resides. The dB value of the normalized reference-position is equal to the normalized reference level. The normalized reference-position may be adjusted between 0.0 and 10.0, corresponding to the bottom and top graticule lines, respectively. Type: :code:`float` .. code-block:: python instr.normalized_reference_position = 5.5 if instr.normalized_reference_position == 5.5: pass """, validator=strict_range, values=[0.0, 10.0] ) display_parameters = Instrument.measurement( "OP?", """ Get the location of the lower left (P1) and upper right (P2) vertices as a tuple of the display window. Type: :code:`tuple` .. code-block:: python repr(instr.display_parameters) (72, 16, 712, 766) """, maxsplit=4, cast=int, get_process_list=tuple ) def plot(self, p1x, p1y, p2x, p2y): """Copies the specified display contents onto any HP-GL plotter. Set the plotter address to 5, select the Pi and P2 positions, and then execute the plot command. P1 and P2 correspond to the lower-left and upper-right plotter positions, respectively. If P1 and P2 are not specified, default values (either preloaded from power-up or sent in via a previous plot command) are used. Once PLOT is executed, no subsequent commands are executed until PLOT is done. :param p1x: plotter-dependent value that specify the lower-left plotter position x-axis :type p1x: int :param p1y: plotter-dependent value that specify the lower-left plotter position y-axis :type p1y: int :param p2x: plotter-dependent values that specify the upper-right plotter position x-axis :type p2x: int :param p2y: plotter-dependent values that specify the upper-right plotter position y-axis :type p2y: int """ if not (isinstance(p1x, int) or isinstance(p1y, int) or isinstance(p2x, int) or isinstance(p2y, int)): raise TypeError("Should be of type int") self.write("PLOT %d,%d,%d,%d" % (p1x, p1y, p2x, p2y)) protect_state_enabled = Instrument.control( "PSTATE?", "PSTATE %s", """ Control the storing of any new data in the state or trace registers. If set to 'True', the registers are “locked”; the data in them cannot be erased or overwritten, although the data can be recalled. To “unlock” the registers, and store new data, set 'protect_state_enabled' to off by selecting 'False' as the parameter. Type: :code:`bool` """, map_values=True, validator=strict_discrete_set, values={True: "1", False: "0"}, cast=str ) def get_power_bandwidth(self, trace, percent): """Measure the combined power of all signal responses contained in a trace array. The command then computes the bandwidth equal to a percentage of the total power. For example, if 100% is specified, the power bandwidth equals the current frequency span. If 50% is specified, trace elements are eliminated from either end of the array, until the combined power of the remaining trace elements equals half of the total power computed. The frequency span of these remaining trace elements is the power bandwidth output to the controller. :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :param percent: Percentage of total power 0 ... 100 % :type trace: str :type percent: float .. code-block:: python # reset spectrum analyzer instr.preset() # set to single sweep mode instr.sweep_single() instr.center_frequency = 300e6 instr.span = 1e6 instr.maximum_hold() instr.trigger_sweep() if instr.done: pbw = instr.power_bandwidth(Trace.A, 99.0) print("The power bandwidth at 99 percent is %f kHz" % (pbw / 1e3)) """ ran = np.arange(0, 100, 0.1) if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if not isinstance(percent, float): raise TypeError("Should be of type float but is '%s'" % type(percent)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) if percent not in ran: raise ValueError("Only accepts values in the range of %s but was '%s'" % (ran, percent)) return float(self.ask("PWRBW %s,%.1f?" % (trace, percent))) resolution_bandwidth = Instrument.control( "RB?", "RB %s", """ Control the resolution bandwidth. This is normally a coupled function that is selected according to the ratio selected by the RBR command. If no ratio is selected, a default ratio (0.011) is used. The bandwidth, which ranges from 10 Hz to 2 MHz, may also be selected manually. Type: :code:`str, dec` """, validator=joined_validators(strict_discrete_set, truncated_discrete_set), values=[["AUTO", "MAN"], np.arange(10, 2e6)], set_process=lambda v: v if isinstance(v, str) else f"{int(v)} Hz", get_process=lambda v: v if isinstance(v, str) else int(v) ) resolution_bandwidth_to_span_ratio = Instrument.control( "RBR?", "RBR %.3f", """ Control the coupling ratio between the resolution bandwidth and the frequency span. When the frequency span is changed, the resolution bandwidth is changed to satisfy the selected ratio. The ratio ranges from 0.002 to 0.10. The “UP” and “DN” parameters adjust the ratio in a 1, 2, 5 sequence. The default ratio is 0.011. """, validator=strict_range, values=np.arange(0.002, 0.10, 0.001) ) def recall_open_short_average(self): """Set the internally stored open/short average reference trace into trace B. The instrument state is also set to the stored open/short reference state. .. code-block:: python instr.preset() instr.sweep_single() instr.start_frequency = 300e3 instr.stop_frequency = 1e9 instr.source_power_enabled = True instr.sweep_couple = SweepCoupleMode.StimulusResponse instr.source_peak_tracking() input("CONNECT OPEN. PRESS CONTINUE WHEN READY TO STORE.") instr.trigger_sweep() instr.done() instr.store_open() input("CONNECT SHORT. PRESS CONTINUE WHEN READY TO STORE AND AVERAGE.") instr.trigger_sweep() instr.done() instr.store_short() input("RECONNECT DUT. PRESS CONTINUE WHEN READY.") instr.trigger_sweep() instr.done() instr.normalize = True instr.trigger_sweep() instr.done() instr.normalized_reference_position = 8 instr.trigger_sweep() instr.preset() # demonstrate recall of open/short average trace instr.recall_open_short_average() instr.trigger_sweep() """ self.write("RCLOSCAL") def recall_state(self, inp): """Set to the display a previously saved instrument state. See :meth:`save_state`. :param inp: State to be recalled: either storage slot 0 ... 9 or 'LAST' or 'PWRON' :param inp: str, int .. code-block:: python instr.save_state(7) instr.preset() instr.recall_state(7) """ values = ["LAST", "PWRON"] + [str(f) for f in range(0, 9)] if not (isinstance(inp, str) or isinstance(inp, int)): raise TypeError("Should be of type 'str' or 'int' but is '%s'" % type(inp)) if str(inp) not in values: raise ValueError("Only accepts values of [%s] but was '%s'" % (values, str(inp))) self.write("RCLS %s" % str(inp)) def recall_trace(self, trace, number): """Recalls previously saved trace data to the display. See :meth:`save_trace`. Either as Trace A or Trace B. :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :param number: Storage location from 0 ... 7 where to store the trace :type trace: str :type number: int .. code-block:: python instr.preset() instr.center_frequency = 300e6 instr.span = 20e6 instr.save_trace(Trace.A, 7) instr.preset() # reload - at 7 stored trace - to Trace B instr.recall_trace(Trace.B, 7) """ ran = range(0, 7) if not isinstance(trace, str): raise TypeError("Should be of type str but is '%s'" % type(trace)) if not isinstance(number, int): raise TypeError("Should be of type int but is '%s'" % type(number)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) if number not in ran: raise ValueError("Only accepts values of [%s] but was '%s'" % (ran, number)) self.write("RCLT %s,%s" % (trace, number)) def recall_thru(self): """Recalls the internally stored thru-reference trace into trace B. The instrument state is also set to the stored thru-reference state. """ self.write("RCLTHRU") firmware_revision = Instrument.measurement( "REV?", """ Get the revision date code of the spectrum analyzer firmware. Type: :code:`datetime.date` """, get_process=lambda v: datetime.strptime(v, '%y%m%d').date(), cast=str ) reference_level = Instrument.control( "RL?", "RL %g {amplitude_unit}", """ Control the reference level, or range level when in normalized mode. (Range level functions the same as reference level.) The reference level is the top horizontal line on the graticule. For best measurement accuracy, place the peak of a signal of interest on the reference-level line. The spectrum analyzer input attenuator is coupled to the reference level and automatically adjusts to avoid compression of the input signal. Refer also to :attr:`amplitude_unit`. Minimum reference level is -120.0 dBm or 2.2 uV Type: :code:`float` """ ) reference_level_calibration = Instrument.control( "RLCAL?", "RLCAL %g", """ Control the calibration of the reference level remotely and retuns the current calibration. To calibrate the reference level, connect the 300 MHz calibration signal to the RF input. Set the center frequency to 300 MHz, the frequency span to 20 MHz, and the reference level to -10 dBm. Use the RLCAL command to move the input signal to the reference level. When the signal peak falls directly on the reference-level line, the reference level is calibrated. Storing this value in the analyzer in EEROM can be done only from the front panel. The RLCAL command, when queried, returns the current value. Type: :code:`float` .. code-block:: python # connect cal signal to rf input instr.preset() instr.amplitude_unit = AmplitudeUnits.DBM instr.center_frequency = 300e6 instr.span = 100e3 instr.reference_level = 0 instr.trigger_sweep() instr.peak_search(PeakSearchMode.High) level = instr.marker_amplitude rlcal = instr.reference_level_calibration - int((level + 10) / 0.17) instr.reference_level_calibration = rlcal """, cast=int, validator=strict_range, values=[-33, 33] ) reference_offset = Instrument.control( "ROFFSET?", "ROFFSET %d DB", """ Control an offset applied to all amplitude readouts (for example, the reference level and marker amplitude). The offset is in dB, regardless of the selected scale and units. The offset can be useful to account for gains of losses in accessories connected to the input of the analyzer. When this function is active, an "R" appears on the left edge of the display. Type: :code:`int` """, cast=int, values=[-100, 100], validator=strict_range ) request_service_conditions = Instrument.control( "RQS?", "RQS %d", """ Control a bit mask that specifies which service requests can interrupt a program sequence. .. code-block:: python instr.request_service_conditions = StatusRegister.ERROR_PRESENT | StatusRegister.TRIGGER print(instr.request_service_conditions) StatusRegister.ERROR_PRESENT|TRIGGER """, get_process=lambda v: StatusRegister(int(v)) ) def save_state(self, inp): """Saves the currently displayed instrument state in the specified state register. :param inp: State to be recalled: either storage slot 0 ... 9 or 'LAST' or 'PWRON' :param inp: str, int .. code-block:: python instr.preset() instr.center_frequency = 300e6 instr.span = 20e6 instr.save_state("PWRON") """ values = ["PWRON"] + [str(f) for f in range(0, 9)] if not (isinstance(inp, str) or isinstance(inp, int)): raise TypeError("Should be of type 'str' or 'int' but is '%s'" % type(inp)) if str(inp) not in values: raise ValueError("Only accepts values of [%s] but was '%s'" % (values, str(inp))) self.write("SAVES %s" % str(inp)) def save_trace(self, trace, number): """Saves the selected trace in the specified trace register. :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :param number: Storage location from 0 ... 7 where to store the trace :type trace: str :type number: int .. code-block:: python instr.preset() instr.center_frequency = 300e6 instr.span = 20e6 instr.save_trace(Trace.A, 7) instr.preset() # reload - at 7 stored trace - to Trace B instr.recall_trace(Trace.B, 7) """ ran = range(0, 7) if not isinstance(trace, str): raise TypeError("Should be of type str but is '%s'" % type(trace)) if not isinstance(number, int): raise TypeError("Should be of type int but is '%s'" % type(number)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) if number not in ran: raise ValueError("Only accepts values of [%s] but was '%s'" % (ran, number)) self.write("SAVET %s,%s" % (trace, number)) serial_number = Instrument.measurement( "SER?", """ Get the spectrum analyzer serial number. """, cast=str ) def sweep_single(self): """Sets the spectrum analyzer into single-sweep mode. This mode allows only one sweep when trigger conditions are met. When this function is active, an 'S' appears on the left edge of the display. """ self.write("SNGLS") span = Instrument.control( "SP?", "SP %s", """ Control the frequency span. The center frequency does not change with changes in the frequency span; start and stop frequencies do change. Setting the frequency span to 0 Hz effectively allows an amplitude-versus-time mode in which to view signals. This is especially useful for viewing modulation. Querying SP will leave the analyzer in center frequency /span mode. """, validator=joined_validators(strict_discrete_set, strict_range), values=[["FULL", "ZERO"], [float("-inf"), float("inf")]], set_process=lambda v: v if isinstance(v, str) else "%.11E Hz" % v, get_process=lambda v: v if isinstance(v, str) else v ) squelch = Instrument.control( "SQUELCH?", "SQUELCH %s", """ Control the squelch level for demodulation. When this function is on, a dashed line indicating the squelch level appears on the display. A marker must be active and above the squelch line for demodulation to occur. Refer to the :attr:`demodulation_mode` command. The default value is -120 dBm. Type: :code:`str,int` .. code-block:: python instr.preset() instr.start_frequency = 88e6 instr.stop_frequency = 108e6 instr.peak_search(PeakSearchMode.High) instr.demodulation_time = 10 instr.squelch = -60 instr.demodulation_mode = DemodulationMode.FM """, validator=joined_validators(strict_discrete_set, strict_range), values=[["ON", "OFF"], range(-220, 30)], set_process=lambda v: v if isinstance(v, str) else f"{v} {{amplitude_unit}}" ) squelch_enabled = Instrument.setting( "SQUELCH %s", """ Set squelch for demodulation active or inactive. For further information see :attr:`squelch` """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) def request_service(self, input): """Triggers a service request. This command allows you to force a service request and test a program designed to handle service requests. However, the service request can be triggered only if it is first masked using the :attr:`request_service_conditions` command. :param input: Bits to emulate a service request :type input: :class:`StatusRegister` """ if input not in range(0, 255): raise ValueError("Bit mask needs to be between 0 ... 255") self.write("SRQ %d" % input) # `center_frequency_step_size` would be a command but is pretty unnecesary sweep_time = Instrument.control( "ST?", "ST %s", """ Control the sweep time. This is normally a coupled function which is automatically set to the optimum value allowed by the current instrument settings. Alternatively, you may specify the sweep time. Note that when the specified sweep time is too fast for the current instrument settings, the instrument is no longer calibrated and the message 'MEAS UNCAL' appears on the display. The sweep time cannot be adjusted when the resolution bandwidth is set to 10 Hz, 30 Hz, or 100 Hz. Type: :code:`str, float` Real from 50E—3 to 100 when the span is greater than 0 Hz; 50E—6 to 60 when the span equals 0 Hz. When the resolution bandwidth is <100 Hz, the sweep time cannot be adjusted. """, validator=joined_validators(strict_discrete_set, strict_range), values=[["AUTO", "MAN"], np.arange(50E-6, 100)], set_process=lambda v: v if isinstance(v, str) else ("%.3f S" % v) ) status = Instrument.measurement( "STB?", """ Get the decimal equivalent of the bits set in the status byte (see the RQS and SRQ commands). STB is equivalent to a serial poll command. The RQS and associated bits are cleared in the same way that a serial poll command would clear them. """, get_process=lambda v: StatusRegister(int(v)) ) def store_open(self): """Save the current instrument state and trace A into nonvolatile memory. This command must be used in conjunction with the :meth:`store_short` command and must precede the :meth:`store_short` command. The data obtained during the store open procedure is averaged with the data obtained during the :meth:`store_short` procedure to provide an open/short calibration. The instrument state (that is, instrument settings) must not change between the :meth:`store_open` and :meth:`store_short` operations in order for the open/short calibration to be valid. Refer to the :meth:`store_short` command description for more information. """ self.write("STOREOPEN") def store_short(self): """Take currently displayed trace A data and averages this data with previously stored open data, and stores it in trace B. This command is used in conjunction with the :meth:`store_open` command and must be preceded by it for proper operation. Refer to the :meth:`store_open` command description for more information. The state of the open/short average trace is stored in state register #8. """ self.write("STORESHORT") def store_thru(self): """Store a thru-calibration trace into trace B and into the nonvolatile memory of the spectrum analyzer. The state of the thru information is stored in state register #9. """ self.write("STORETHRU") sweep_couple = Instrument.control( "SWPCPL?", "SWPCPL %s", """ Control the sweep couple mode which is either a stimulus-response or spectrum-analyzer auto-coupled sweep time. In stimulus-response mode, auto-coupled sweep times are usually much faster for swept-response measurements. Stimulus-response auto-coupled sweep times are typicallly valid in stimulus-response measurements when the system’s frequency span is less than 20 times the bandwidth of the device under test. Type: :code:`str` or :class:`SweepCoupleMode` """, validator=strict_discrete_set, values=[e for e in SweepCoupleMode] ) sweep_output = Instrument.control( "SWPOUT?", "SWPOUT %s", """ Control the sweep-related signal that is available from J8 on the rear panel. FAV provides a dc ramp of 0.5V/GHz. RAMP provides a 0—10 V ramp corresponding to the sweep ramp that tunes the first local oscillator (LO). For the HP 8561B, in multiband sweeps one ramp is provided for each frequency band. Type: :code:`str` or :class:`SweepOut` """, validator=strict_discrete_set, values=[e for e in SweepOut] ) trace_data_format = Instrument.control( "TDF?", "TDF %s", """ Control the format used to input and output trace data (see the TRA/TRB command, You must specify the desired format when transferring data from the spectrum analyzer to a computer; this is optional when transferring data to the analyzer. Type: :code:`str` or :class:`TraceDataFormat` .. warning:: Only needed for manual read out of trace data. Don't use this if you don't know what You are doing. """, validator=strict_discrete_set, values=[e for e in TraceDataFormat] ) threshold = Instrument.control( "TH?", "TH %.2E {amplitude_unit}", """ Control the minimum amplitude level and clips data at this value. Default value is -90 dBm. See also - :attr:`marker_threshold` does not clip data below its threshold Type: :code:`str, float` range -200 to 30 .. note:: When a trace is in max-hold mode, if the threshold is raised above any of the trace data, the data below the threshold will be permanently lost. """, validator=strict_discrete_set, values=np.arange(-200, 30), ) threshold_enabled = Instrument.setting( "TH %s", """ Set the threshold active or inactive. See :attr:`threshold` """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) def set_title(self, string): """Sets character data in the title area of the display, which is in the upper-right corner. A title can be up to two rows of sixteen characters each, Carriage return and line feed characters are not allowed. """ if not isinstance(string, str): raise TypeError("Parameter should be of type 'str'") if len(string) > 32: raise ValueError("Title should have maximum 32 chars but has '%d'" % len(string)) self.write("TITLE@%s@" % string) trigger_mode = Instrument.control( "TM?", "TM %s", """ Control the trigger mode. Selected trigger conditions must be met in order for a sweep to occur. For the available modes refer to :class:`TriggerMode`. When any trigger mode other than free run is selected, a "T" appears on the left edge of the display. """, validator=strict_discrete_set, values=[e for e in TriggerMode] ) def _get_trace_data(self, trace): self.write("TDF M") amp_units = str(self.ask("AUNITS?")) ref_lvl = float(self.ask("RL?")) log_scale = float(self.ask("LG?")) cmd_str = "" if trace is Trace.A: cmd_str += "TRA?" elif trace is Trace.B: cmd_str += "TRB?" values = self.values(cmd_str, cast=int) if amp_units is AmplitudeUnits.W: # calculate dbm from watts ref_lvl = (10 * log10(ref_lvl)) + 30 elif amp_units is AmplitudeUnits.DBUV: # calculate dbm from dbuv in 50 Ohm system ref_lvl = ref_lvl - 107 elif amp_units is AmplitudeUnits.V: # calculate dbm from volts in 50 Ohm system ref_lvl = 20 * log10((ref_lvl / 0.05) ** 0.5) elif amp_units is AmplitudeUnits.DBMV: # calculate dbm from dbmv ref_lvl = ref_lvl - 46.9897 result_values = [] for value in values: if log_scale != 0: result_value = round(ref_lvl + (log_scale * ((value - 600) / 60)), 2) result_values.append(result_value) else: raise NotImplementedError("Linear scaling isn't supported by get_trace_data_ ") return result_values def get_trace_data_a(self): """ Get the data of trace A as a list. The function returns the 601 data points as a list in the amplitude format. Right now it doesn't support the linear scaling due to the manual just being wrong. """ return self._get_trace_data(Trace.A) def get_trace_data_b(self): """ Get the data of trace B as a list. The function returns the 601 data points as a list in the amplitude format. Right now it doesn't support the linear scaling due to the manual just being wrong. """ return self._get_trace_data(Trace.B) set_trace_data_a = Instrument.setting( "TDF P;TRA %s", """ Set the trace data of trace A. .. warning:: The string based method this attribute is using takes its time. Something around 5000ms timeout at the adapter seems to work well. """, set_process=lambda v: (','.join([str(i) for i in v])), ) set_trace_data_b = Instrument.setting( "TDF P;TRB %s", """ Set the trace data of trace B also allows to write the data. .. warning:: The string based method this attribute is using takes its time. Something around 5000ms timeout at the adapter seems to work well. """, set_process=lambda v: (','.join([str(i) for i in v])) ) def trigger_sweep(self): """Command the spectrum analyzer to take one full sweep across the trace display. Commands following TS are not executed until after the analyzer has finished the trace sweep. This ensures that the instrument is set to a known condition before subsequent commands are executed. """ self.write("TS") def create_fft_trace_window(self, trace, window_mode): """Creates a window trace array for the fast Fourier transform (FFT) function. The trace-window function creates a trace array according to three built-in algorithms: UNIFORM, HANNING, and FLATTOP. When used with the FFT command, the three algorithms give resultant passband shapes that represent a compromise among amplitude uncertainty, sensitivity, and frequency resolution. Refer to the FFT command description for more information. :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :param window_mode: A representation of the window mode, either from :class:`WindowType` or use 'HANNING', 'FLATTOP' or 'UNIFORM' :type window_mode: str """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) if not isinstance(window_mode, str): raise TypeError("Should be of type string but is '%s'" % type(window_mode)) if window_mode not in [e for e in WindowType]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in WindowType], window_mode)) self.write("TWNDOW %s,%s" % (trace, window_mode)) video_average = Instrument.control( "VAVG?", "VAVG %d", """ Control the video averaging function. Video averaging smooths the displayed trace without using a narrow bandwidth. 'video_average' sets the IF detector to sample mode (see the DET command) and smooths the trace by averaging successive traces with each other. If desired, you can change the detector mode during video averaging. Video averaging is available only for trace A, and trace A must be in clear-write mode for 'video_average' to operate. After 'video_average' is executed, the number of sweeps that have been averaged appears at the top of the analyzer screen. Using video averaging allows you to view changes to the entire trace much faster than using narrow video filters. Narrow video filters require long sweep times, which may not be desired. Video averaging, though requiring more sweeps, uses faster sweep times; in some cases, it can produce a smooth trace as fast as a video filter. Type: :code:`str, int` """, validator=strict_range, values=np.arange(1, 999), cast=int ) video_average_enabled = Instrument.setting( "VAVG %s", """ Set the video averaging either active or inactive. See :attr:`video_average` """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) video_bandwidth = Instrument.control( "VB?", "VB %s", """ Control the video bandwidth. This is normally a coupled function that is selected according to the ratio selected by the VBR command. (If no ratio is selected, a default ratio, 1.0, is used instead.) Video bandwidth filters (or smooths) post-detected video information. The bandwidth, which ranges from 1 Hz to 3 MHz, may also be selected manually. If the specified video bandwidth is less than 300 Hz and the resolution bandwidth is greater than or equal to 300 Hz, the IF detector is set to sample mode. Reducing the video bandwidth or increasing the number of video averages will usually smooth the trace by about as much for the same total measurement time. Reducing the video bandwidth to one-third or less of the resolution bandwidth is desirable when the number of video averages is above 25. For the case where the number of video averages is very large, and the video bandwidth is equal to the resolution bandwidth, internal mathematical limitations allow about 0.4 dB overresponse to noise on the logarithmic scale. The overresponse is negligible (less than 0.1 dB) for narrower video bandwidths. Type: :code:`int` """, validator=joined_validators(strict_discrete_set, strict_range), values=[["AUTO", "MAN"], np.arange(1, 3e6)], cast=int, set_process=lambda v: v if isinstance(v, str) else f"{v} Hz" ) video_bandwidth_to_resolution_bandwidth = Instrument.control( "VBR?", "VBR %.3f", """ Control the coupling ratio between the video bandwidth and the resolution bandwidth. Thus, when the resolution bandwidth is changed, the video bandwidth changes to satisfy the ratio. The ratio ranges from 0.003 to 3 in a 1, 3, 10 sequence. The default ratio is 1. When a new ratio is selected, the video bandwidth changes to satisfy the new ratio—the resolution bandwidth does not change value. """, validator=strict_range, values=np.arange(0.002, 0.10, 0.001) ) def view_trace(self, trace): """Display the current contents of the selected trace, but does not update the contents. View mode may be executed before a sweep is complete when :meth:`sweep_single` and :meth:`trigger_sweep` are not used. :param trace: A representation of the trace, either from :class:`Trace` or use 'TRA' for Trace A or 'TRB' for Trace B :type trace: str :raises TypeError: Type isn't 'string' :raises ValueError: Value is 'TRA' nor 'TRB' """ if not isinstance(trace, str): raise TypeError("Should be of type string but is '%s'" % type(trace)) if trace not in [e for e in Trace]: raise ValueError("Only accepts values of [%s] but was '%s'" % ([e for e in Trace], trace)) self.write("VIEW " + trace) video_trigger_level = Instrument.control( "VTL?", "VTL %.3f {amplitude_unit}", """ Control the video trigger level when the trigger mode is set to VIDEO (refer to the :attr:`trigger_mode` command). A dashed line appears on the display to indicate the level. The default value is 0 dBm. Range -220 to 30. Type: :code:`float` """, validator=strict_range, values=[-220, 30] ) class HP8560A(HP856Xx): """Represents the HP 8560A Spectrum Analyzer and provides a high-level interface for interacting with the instrument. .. code-block:: python from pymeasure.instruments.hp import HP8560A from pymeasure.instruments.hp.hp856Xx import AmplitudeUnits sa = HP8560A("GPIB::1") sa.amplitude_unit = AmplitudeUnits.DBUV sa.start_frequency = 299.5e6 sa.stop_frequency = 300.5e6 print(sa.marker_amplitude) """ # HP8560A is able to go up to 2.9 GHz MAX_FREQUENCY = 2.9e9 def __init__(self, adapter, name="Hewlett-Packard HP8560A", **kwargs): super().__init__( adapter, name, **kwargs, ) self.center_frequency_values = [0, self.MAX_FREQUENCY] self.start_frequency_values = [0, self.MAX_FREQUENCY] self.stop_frequency_values = [0, self.MAX_FREQUENCY] self.frequency_offset_values = [0, self.MAX_FREQUENCY] self.marker_frequency_values = [0, self.MAX_FREQUENCY] self.span_values = [["FULL", "ZERO"], [0, self.MAX_FREQUENCY]] source_leveling_control = Instrument.control( "SRCALC?", "SRCALC %s", """ Control if internal or external leveling is used with the built-in tracking generator. Takes either 'INT', 'EXT' or members of enumeration :class:`SourceLevelingControlMode` Type: :code:`str` .. code-block:: python instr.preset() instr.sweep_single() instr.center_frequency = 300e6 instr.span = 1e6 instr.source_power = -5 instr.trigger_sweep() instr.source_leveling_control = SourceLevelingControlMode.External if ErrorCode(900) in instr.errors: print("UNLEVELED CONDITION. CHECK LEVELING LOOP.") .. note:: Only available with an HP 8560A Option 002. """, validator=strict_discrete_set, values=[e for e in SourceLevelingControlMode] ) tracking_adjust_coarse = Instrument.control( "SRCCRSTK?", "SRCCRSTK %d", """ Control the coarse adjustment to the frequency of the built-in tracking-generator oscillator. Once enabled, this adjustment is made in digital-to-analogconverter (DAC) values from 0 to 255. For fine adjustment, refer to the :attr:`tracking_adjust_fine` command description. Type: :code:`int` .. note:: Only available with an HP 8560A Option 002. """, validator=strict_range, values=[0, 255], cast=int ) tracking_adjust_fine = Instrument.control( "SRCFINTK?", "SRCFINTK %d", """ Control the fine adjustment of the frequency of the built-in tracking-generator oscillator. Once enabled, this adjustment is made in digital-to-analogconverter (DAC) values from 0 to 255. For coarse adjustment, refer to the :attr:`tracking_adjust_coarse` command description. Type: :code:`int` .. note:: Only available with an HP 8560A Option 002. """, validator=strict_range, values=[0, 255], cast=int ) source_power_offset = Instrument.control( "SRCPOFS?", "SRCPOFS %g {amplitude_unit}", """ Control the offset of the displayed power of the built-in tracking generator so that it is equal to the measured power at the input of the spectrum analyzer. This function may be used to take into account system losses (for example, cable loss) or gains (for example, preamplifier gain) reflecting the actual power delivered to the device under test. Type: :code:`int` .. note:: Only available with an HP 8560A Option 002. """, validator=strict_range, values=[-100, 100], cast=int ) source_power_step = Instrument.control( "SRCPSTP?", "SRCPSTP %.2f DB", """ Control the step size of the source power level, source power offset, and power-sweep range functions. Range: 0.1 ... 12.75 DB with 0.05 steps. Type: :code:`float` .. note:: Only available with an HP 8560A Option 002. """, validator=strict_range, values=np.arange(0.1, 12.75, 0.05) ) source_power_sweep = Instrument.control( "SRCPSWP?", "SRCPSWP %.2f DB", """ Control the power-sweep function, where the output power of the tracking generator is swept over the power-sweep range chosen. The starting source power level is set using the :attr:`source_power` command. The output power of the tracking generator is swept according to the sweep rate of the spectrum analyzer. Type: :code:`str, float` .. note:: Only available with an HP 8560A Option 002. """, validator=truncated_discrete_set, values=np.arange(0.1, 12.75, 0.05), ) source_power_sweep_enabled = Instrument.setting( "SRCPSWP %s", """ Set the power sweep active or inactive. See :attr:`source_power_sweep`. """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) source_power = Instrument.control( "SRCPWR?", "SRCPWR %s", """ Control the built-in tracking generator's output power. Type: :code:`str, float` .. note:: Only available with an HP 8560A Option 002. """, validator=joined_validators(strict_discrete_set, truncated_discrete_set), values=[["OFF", "ON"], np.arange(-10, 2.8, 0.05)], set_process=lambda v: v if isinstance(v, str) else ("%.2f {amplitude_unit}" % v) ) source_power_enabled = Instrument.setting( "SRCPWR %s", """ Set the built-in tracking generator on or off. See :attr:`source_power` """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) def activate_source_peak_tracking(self): """Activate a routine which automatically adjusts both the coarse and fine-tracking adjustments to obtain the peak response of the tracking generator on the spectrum-analyzer display. Tracking peak is not necessary for resolution bandwidths greater than or equal to 300 kHz. A thru connection should be made prior to peaking in order to ensure accuracy. .. note:: Only available with an HP 8560A Option 002. """ self.write("SRCTKPK") class HP8561B(HP856Xx): """Represents the HP 8561B Spectrum Analyzer and provides a high-level interface for interacting with the instrument. .. code-block:: python from pymeasure.instruments.hp import 8561B from pymeasure.instruments.hp.hp856Xx import AmplitudeUnits sa = HP8560A("GPIB::1") sa.amplitude_unit = AmplitudeUnits.DBUV sa.start_frequency = 6.4e9 sa.stop_frequency = 6.5e9 print(sa.marker_amplitude) """ # HP8561B is able to go up to 6.5 GHz MAX_FREQUENCY = 6.5e9 def __init__(self, adapter, name="Hewlett-Packard HP8561B", **kwargs): super().__init__( adapter, name, **kwargs, ) self.center_frequency_values = [0, self.MAX_FREQUENCY] self.start_frequency_values = [0, self.MAX_FREQUENCY] self.stop_frequency_values = [0, self.MAX_FREQUENCY] self.frequency_offset_values = [0, self.MAX_FREQUENCY] self.marker_frequency_values = [0, self.MAX_FREQUENCY] self.span_values = [["FULL", "ZERO"], [0, self.MAX_FREQUENCY]] conversion_loss = Instrument.control( "CNVLOSS?", "CNVLOSS %s DB", """ Control the compensation for losses outside the instrument when in external mixer mode (such as losses within connector cables, external mixers, etc.). 'conversion_loss' specifies the mean conversion loss for the current harmonic band. In a full frequency band (such as band K), the mean conversion loss is defined as the minimum loss plus the maximum loss for that band divided by two. Adjusting for conversion loss allows the system to remain calibrated (that is, the displayed amplitude values have the conversion loss incorporated into them). The default value for any band is 30 dB. The spectrum analyzer must be in external-mixer mode in order for this command to work. When in internal-mixer mode, querying 'conversion_loss' returns a zero. """, validator=strict_range, values=[0, float("inf")] ) def set_fullband(self, band): """Select a commonly-used, external-mixer frequency band, as shown in the table. The harmonic lock function :attr:`harmonic_number_lock` is also set; this locks the harmonic of the chosen band. External-mixing functions are not available with an HP 8560A Option 002. Takes frequency band letter as string. .. list-table:: Title :widths: 25 25 25 25 :header-rows: 1 * - Frequency Band - Frequency Range (GHz) - Mixing Harmonic - Conversion Loss * - K - 18.0 — 26.5 - 6 - 30 dB * - A - 26.5 — 40.0 - 8 - 30 dB * - Q - 33.0—50.0 - 10 - 30 dB * - U - 40.0—60.0 - 10 - 30 dB * - V - 50.0—75.0 - 14 - 30 dB * - E - 60.0—-90.0 - 16 - 30 dB * - W - 75.0—110.0 - 18 - 30 dB * - F - 90.0—140.0 - 24 - 30 dB * - D - 110.0—170.0 - 30 - 30 dB * - G - 140.0—220.0 - 36 - 30 dB * - Y - 170.0—260.0 - 44 - 30 dB * - J - 220.0—325.0 - 54 - 30 dB """ frequency_mapping = { "K": [18e9, 26.5e9], "A": [26.5e9, 40e9], "Q": [33e9, 50e9], "U": [40e9, 60e9], "V": [50e9, 75e9], "E": [60e9, 90e9], "W": [75e9, 110e9], "F": [90e9, 140e9], "D": [110e9, 170e9], "G": [140e9, 220e9], "Y": [170e9, 260e9], "J": [220e9, 325e9], } if not isinstance(band, str): raise TypeError("Frequency band should be of type string but is '%s'" % type(band)) if band not in frequency_mapping.keys(): raise ValueError("Should be one of the available bands but is '%s'" % band) self.center_frequency_values = frequency_mapping[band] self.start_frequency_values = frequency_mapping[band] self.stop_frequency_values = frequency_mapping[band] self.write("FULLBAND %s" % band) harmonic_number_lock = Instrument.control( "HNLOCK?", "HNLOCK %d", """ Control the lock to a chosen harmonic so only that harmonic is used to sweep an external frequency band. To select a frequency band, use the 'fullband' command; it selects an appropriate harmonic for the desired band. To change the harmonic number, use 'harmonic_number_lock'. Note that 'harmonic_number_lock' also works in internal-mixing modes. Once 'fullband' or 'harmonic_number_lock' are set, only center frequencies and spans that fall within the frequency band of the current harmonic may be entered. When the 'set_full_span' command is activated, the span is limited to the frequency band of the selected harmonic. """, validator=strict_range, values=[1, 54], cast=int ) harmonic_number_lock_enabled = Instrument.setting( "HNLOCK %s", """ Set the harmonic number locking active or inactive. See :attr:`harmonic_number_lock`. """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) def unlock_harmonic_number(self): """Unlock the harmonic number, allowing you to select frequencies and spans outside the range of the locked harmonic number. Also, when HNUNLK is executed, more than one harmonic can then be used to sweep across a desired span. For example, sweep a span from 18 GHz to 40 GHz. In this case, the analyzer will automatically sweep first using 6—, then using 8—. """ self.write("HUNLK") def set_signal_identification_to_center_frequency(self): """Set the center frequency to the frequency obtained from the command SIGID. SIGID must be in AUTO mode and have found a valid result for this command to execute properly. Use SIGID on signals greater than 18 GHz {i.e., in external mixing mode). SIGID and IDCF may also be used on signals less than 6.5 GHz in an HP 8561B. """ self.write("IDCF") signal_identification_frequency = Instrument.measurement( "IDFREQ?", """ Measure the frequency of the last identified signal. After an instrument preset or an invalid signal identification, IDFREQ returns a “0”. """ ) mixer_bias = Instrument.control( "MBIAS?", "MBIAS %.3f MA", """ Set the bias for an external mixer that requires diode bias for efficient mixer operation. The bias, which is provided on the center conductor of the IF input, is activated when MBIAS is executed. A "+" or "—" appears on the left edge of the spectrum analyzer display, indicating that positive or negative bias is on. When the bias is turned off, MBIAS is set to 0. Default units are in milliamps. """, validator=strict_range, values=[float(-10E3), int(10E3)], cast=float ) mixer_bias_enabled = Instrument.setting( "MBIAS %s", """ Control the bias for an external mixer. See :attr:`mixer_bias`. """, map_values=True, values={True: "ON", False: "OFF"}, validator=strict_discrete_set ) mixer_mode = Instrument.control( "MXRMODE?", "MXRMODE %s", """ Control the mixer mode. Select either the internal mixer or supply an external mixer. Takes enum 'MixerMode' or string 'INT', 'EXT' """, validator=strict_discrete_set, values=[e for e in MixerMode] ) def peak_preselector(self): """Peaks the preselector in the HP 8561B Spectrum Analyzer. Make sure the entire frequency span is in high band, set the desired trace to clear-write mode, place a marker on a desired signal, then execute PP. The peaking routine zooms to zero span, peaks the preselector tracking, then returns to the original position. To read the new preselector peaking number, use the PSDAC command. Commands following PP are not executed until after the analyzer has finished peaking the preselector. """ self.write("PP") preselector_dac_number = Instrument.control( "PSDAC?", "PSDAC %d", """ Control the preselector peak DAC number. For use with an HP 8561B Spectrum Analyzer. Type: :code:`int` """, cast=int, validator=strict_range, values=[0, 255] ) signal_identification = Instrument.control( "SIGID?", "SIGID %s", """ Control the signal identification for identifying signals for the external mixing frequency bands. Two signal identification methods are available. AUTO employs the image response method for locating correct mixer responses. Place a marker on the desired signal, then activate signal_identification = 'AUTO'. The frequency of a correct response appears in the active function block. Use this mode before executing the :meth:`signal_identification_to_center_frequency` command. The second method of signal identification, 'MAN', shifts responses both horizontally and vertically. A correct response is shifted horizontally by less than 80 kHz. To ensure accuracy in MAN mode, limit the frequency span to less than 20 MHz. Where True = manual mode is active and False = auto mode is active or 'signal_identification' is off. """, map_values=True, validator=strict_discrete_set, values={True: "1", False: "0", "AUTO": "AUTO", "MAN": "MAN"}, cast=str ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp8657b.py0000644000175100017510000001512215203313266021751 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from enum import IntEnum from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class HP8657B(Instrument): """ Represents the Hewlett Packard 8657B signal generator and provides a high-level interface for interacting with the instrument. """ def __init__(self, adapter, name="Hewlett-Packard HP8657B", **kwargs): super().__init__( adapter, name, includeSCPI=False, send_end=True, **kwargs, ) class Modulation(IntEnum): """ IntEnum for the different modulation sources """ EXTERNAL = 1 INT_400HZ = 2 INT_1000HZ = 3 OFF = 4 DC_FM = 5 def check_errors(self): """ Method to read the error status register as the 8657B does not support any readout of values, this will return 0 and log a warning """ log.warning("HP8657B Does not support error status readout") def clear(self): """ Reset the instrument to power-on default settings """ self.adapter.connection.clear() id = "HP,8657B,N/A,N/A" #: Manual ID entry am_depth = Instrument.setting( "AM %2.1f PC", """ Set the modulation depth for AM, usable range 0-99.9% """, validator=strict_range, values=[0, 99.9], ) am_source = Instrument.setting( "AM S%i", """ Set the source for the AM function with :attr:`Modulation` enumeration. ========== ======= Value Meaning ========== ======= OFF no modulation active INT_400HZ internal 400 Hz modulation source INT_1000HZ internal 1000 Hz modulation source EXTERNAL External source, AC coupling ========== ======= *Note:* * AM & FM can be active at the same time * only one internal source can be active at the time * use "OFF" to deactivate AM usage example: .. code-block:: python sig_gen = HP8657B("GPIB::7") ... sig_gen.am_source = sig_gen.Modulation.INT_400HZ # Enable int. 400 Hz source for AM sig_gen.am_depth = 50 # Set AM modulation depth to 50% ... sig_gen.am_source = sig_gen.Modulation.OFF # Turn AM off """, validator=strict_discrete_set, values=Modulation, ) fm_deviation = Instrument.setting( "FM %3.1fKZ", """ Set the peak deviation in kHz for the FM function, useable range 0.1 - 400 kHz *NOTE*: the maximum usable deviation is depending on the output frequency, refer to the instrument documentation for further detail. """, validator=strict_range, values=[0.1, 400], ) fm_source = Instrument.setting( "FM S%i", """ Set the source for the FM function with :attr:`Modulation` enumeration. ========== ======= Value Meaning ========== ======= OFF no modulation active INT_400HZ internal 400 Hz modulation source INT_1000HZ internal 1000 Hz modulation source EXTERNAL External source, AC coupling DC_FM External source, DC coupling (FM only) ========== ======= *Note:* * AM & FM can be active at the same time * only one internal source can be active at the time * use "OFF" to deactivate FM * refer to the documentation rearding details on use of DC FM mode usage example: .. code-block:: python sig_gen = HP8657B("GPIB::7") ... sig_gen.fm_source = sig_gen.Modulation.EXTERNAL # Enable external source for FM sig_gen.fm_deviation = 15 # Set FM peak deviation to 15 kHz ... sig_gen.fm_source = sig_gen.Modulation.OFF # Turn FM off """, validator=strict_discrete_set, values=Modulation, ) frequency = Instrument.setting( "FR %10.0f HZ", """ Set the output frequency of the instrument in Hz. For the 8567B the valid range is 100 kHz to 2060 MHz. """, validator=strict_range, values=[1.0E5, 2.060E9], ) level = Instrument.setting( "AP %g DM", """ Set the output level in dBm. For the 8657B the range is -143.5 to +17 dBm/ """, validator=strict_range, values=[-143.5, 17.0], ) level_offset = Instrument.setting( "AO %g DB", """ Set the output offset in dB, usable range -199 to +199 dB. """, validator=strict_range, values=[-199.0, 199.0], ) output_enabled = Instrument.setting( "R%d", """ Control whether the output is enabled. """, validator=strict_discrete_set, values={False: 2, True: 3}, map_values=True ) def reset(self): self.adapter.connection.clear() def shutdown(self): self.adapter.connection.clear() self.output_enabled = False self.adapter.connection.close() super().shutdown() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hp8753e.py0000644000175100017510000003554715203313266021766 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from time import sleep from time import time as now import numpy as np from pyvisa import VisaIOError from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class HP8753E(Instrument): """Represents the HP8753E Vector Network Analyzer and provides a high-level interface for taking sweeps of the scattering or measurement parameters. :param name: Optional set the name of the instrument (str). :param min_frequency: Optional set the minimum validator for `HP8753E.start_frequency`, `HP8753E.stop_frequency`, `HP8753E.span_frequency`, `HP8753E.center_frequency` on initialization (float in Hz). :param max_frequency: Optional set the maximum validator for `HP8753E.start_frequency`, `HP8753E.stop_frequency`, `HP8753E.span_frequency`, `HP8753E.center_frequency` on initialization (float in Hz). :param min_power: Optional set the minimum validator for `HP8753E.power` on initialization (float in dBm). :param max_power: Optional set the maximum validator for `HP8753E.power` on initialization (float in dBm). """ def __init__( self, adapter=None, name=None, min_frequency=30.0e3, max_frequency=6.0e9, min_power=-70, max_power=10, **kwargs, ): super().__init__(adapter=adapter, name=name, includeSCPI=False, **kwargs) self._manu = "" self._model = "" self._fw = "" self._sn = "" self._options = "" self.start_frequency_values = [min_frequency, max_frequency] self.stop_frequency_values = [min_frequency, max_frequency] self.center_frequency_values = [min_frequency, max_frequency] self.span_frequency_values = [0, max_frequency - min_frequency] self.power_values = [min_power, max_power] if name is None: # written this way to pass 'test_all_instruments.py' while allowing the # *IDN? to populate the name of the VNA try: self._manu, self._model, _, self._fw = self.id except ValueError: self._manu = "Hewlett Packard" self._model = "8753E" self._desc = "Vector Network Analyzer" name = self.name = f"{self._manu} {self._model} {self._desc}" else: self.name = name ALLOWED_BANDWIDTH = [10, 30, 100, 300, 1000, 3000, 3700, 6000] SCAN_POINT_VALUES = [3, 11, 21, 26, 51, 101, 201, 401, 801, 1601] MEASURING_PARAMETERS = ["S11", "S12", "S21", "S22", "A/R", "B/R", "A/B", "A", "B", "R"] MEASURING_PARAMETER_MAP = { "A/R": "AR", "B/R": "BR", "A/B": "AB", "A": "MEASA", "B": "MEASB", "R": "MEASR", } start_frequency = Instrument.control( "STAR?", "STAR %e Hz", """Control the start frequency in Hz. (float).""", validator=strict_range, cast=float, dynamic=True, values=[30.0e3, 6.0e9], ) stop_frequency = Instrument.control( "STOP?", "STOP %e Hz", """Control the stop frequency in Hz. (float).""", validator=strict_range, cast=float, dynamic=True, values=[30e3, 6e9], ) center_frequency = Instrument.control( "CENT?", "CENT %e Hz", """Control the center frequency in Hz (float).""", cast=float, validator=strict_range, dynamic=True, values=[30e3, 6e9], ) span_frequency = Instrument.control( "SPAN?", "SPAN %e Hz", """Control the span of the sweep frequency in Hz (float).""", cast=float, validator=strict_range, dynamic=True, values=[0, 6e9 - 30e3], ) sweep_time = Instrument.control( "SWET?", "SWET%.2e", """Control the sweep time in seconds. (float truncated from 0.0 to 36_400.0) """, validator=strict_range, cast=float, values=[0.01, 36_400.0], ) def set_sweep_time_fastest(self): """Set instrument scan sweep time to select fastest possible time.""" self.write("SWEA") averages = Instrument.control( "AVERFACT?", "AVERFACT%d", """Control the number of averages for a scan sweep. (int truncated from 1 to 999). """, cast=lambda x: int(float(x)), # need float() to convert scientific notation in strings validator=strict_range, values=[1, 999], ) averaging_enabled = Instrument.control( "AVERO?", "AVERO%d", """Control whether or not averaging is enabled. (boolean)""", cast=bool, validator=strict_discrete_set, map_values=True, values={True: 1, False: 0, "ON": 1, "OFF": 0, "1": True, "0": False}, ) correction_enabled = Instrument.control( "CORR?", "CORR%d", """Control whether or not correction is enabled. (boolean)""", cast=bool, validator=strict_discrete_set, map_values=True, values={True: 1, False: 0, "ON": 1, "OFF": 0}, ) def averaging_restart(self): """Restart sweep averaging.""" self.write("AVERREST") def emit_beep(self): """Make the VNA emit a beep""" self.write("EMIB") power = Instrument.control( "POWE?", "POWE%.3e", """Control the output RF power of the instrument's active port. (float).""", cast=float, validator=strict_range, dynamic=True, values=[-70, 10], ) output_enabled = Instrument.control( "SOUP?", "SOUP%s", """Control RF Output State (boolean)""", cast=bool, map_values=True, validator=strict_discrete_set, values={True: 1, False: 0, "ON": 1, "OFF": 0}, ) trigger_hold = Instrument.control( "HOLD?", "%s", """Control Sweep Scan Trigger State (boolean)""", cast=str, set_process=lambda x: "HOLD" if x else "CONT", get_process=lambda x: x == "1", ) trigger_continuous = Instrument.control( "CONT?", "%s", """Control Sweep Scan Trigger State (boolean)""", cast=str, set_process=lambda x: "CONT" if x else "HOLD", get_process=lambda x: x == "1", ) scan_points = Instrument.control( "POIN?", "POIN%d", f"""Control the number of points used for a scan sweep. From the set {SCAN_POINT_VALUES}""", cast=lambda x: int(float(x)), validator=strict_discrete_set, values=SCAN_POINT_VALUES, ) id = Instrument.measurement( "*IDN?", """Get the identification of the instrument (list of strings)""", cast=str, ) sn = Instrument.measurement( "OUTPSERN", """Get the serial number for the instrument""", ) options = Instrument.measurement( "OUTPOPTS", """Get the installed options for the instrument""", ) @property def manu(self): """Get the manufacturer of the instrument.""" if self._manu == "": self._manu, self._model, _, self._fw = self.id return self._manu @property def model(self): """Get the model of the instrument.""" if self._model == "": self._manu, self._model, _, self._fw = self.id return self._model @property def fw(self): """Get the firmware of the instrument.""" if self._fw == "": self._manu, self._model, _, self._fw = self.id return self._fw def set_fixed_frequency(self, frequency): """Set the sweep to be a fixed frequency in Hz.""" self.start_frequency = frequency self.stop_frequency = frequency self.scan_points = 3 @property def measuring_parameter(self): """Get the active Scattering or Measuring Parameter being measured. (str from ['S11', 'S21', 'S12', 'S22', 'A', 'B', 'R'])""" for parameter in self.MEASURING_PARAMETERS: if parameter in self.MEASURING_PARAMETER_MAP: if int(self.ask(f"{self.MEASURING_PARAMETER_MAP[parameter]}?")) == 1: return parameter elif int(self.ask(f"{parameter}?")) == 1: return parameter return None @measuring_parameter.setter def measuring_parameter(self, value): """Set the active Measuring Parameter to be measured. (str from ['S11', 'S21', 'S12', 'S22', 'A', 'B', 'R'])""" if value in self.MEASURING_PARAMETERS: if value in self.MEASURING_PARAMETER_MAP: self.write("%s" % self.MEASURING_PARAMETER_MAP[value]) else: self.write("%s" % value) else: raise ValueError( f"Invalid value '{value}' scattering parameter requested for \ {self._manu} {self._model}. Valid values are: {self.MEASURING_PARAMETERS}" ) IFBW = Instrument.control( "IFBW?", "IFBW%d", f"""Control the IF Bandwidth of the instrument for a scan sweep. (int from the set {ALLOWED_BANDWIDTH}).""", cast=lambda x: int(float(x)), validator=strict_discrete_set, values=ALLOWED_BANDWIDTH, ) def reset(self): """Reset the instrument. May cause RF Output power to be enabled!""" self.write("*RST") sleep(0.25) def scan(self, timeout=10): """Initiates a scan with the number of averages specified and blocks until the operation is complete. :param timeout: Optional value in seconds to add to the sweep time before timeout occurs. :raise TimeoutError: If the VNA fails to complete the sweep before timeout occurs. :return: None. """ # get time to perform sweep sweep_time = self.sweep_time + timeout # get number of averages if enabled if self.averaging_enabled: sweep_time = sweep_time * self.averages self.scan_single() # create a time limit start = now() # All queries will block until the scan is done, so use NOOP? to check. # These queries will time out after several seconds though, # so query repeatedly until the scan finishes. while True: try: # status = self.ask("NOOP?") self.ask("NOOP?") break except VisaIOError: pass # calculate time sweep should be complete by if now() > (start + sweep_time): raise TimeoutError( f"VNA Scan took longer than {sweep_time} seconds to complete and timed out." ) sleep(0.5) while self.adapter.connection.bytes_in_buffer > 0: _ = self.read() sleep(0.25) def scan_single(self): """Initiates a single scan or N scans averaged based on averaging This function is not blocking. """ if self.averaging_enabled: self.write(f"NUMG{self.averages}") else: self.write("SING") @property def frequencies(self): """ Get a list of frequencies from the last scan. :return: An array of frequencies sized by number of points in sweep) :rtype: numpy.ndarray """ return np.linspace(self.start_frequency, self.stop_frequency, num=self.scan_points) @property def data_complex(self, timeout=10): """ Get the complex s-parameter measurements from the last scan. This function is blocking until it is completed. :param timeout: Optional value in seconds to wait until a timeout occurs. :raise TimeoutError: If the VNA fails to complete the sweep before timeout occurs. :return: An array of s-parameters for the measurement_parameter. :rtype: numpy.ndarray """ points = 0 counter = 0 start = now() while points == 0: try: # get number of points points = self.scan_points except VisaIOError: sleep(0.1) counter += 1 pass if now() > start + timeout: raise TimeoutError( f"Failed to read data. Data transfer method timed \ out after {timeout} seconds" ) # read the extra self.scan_points out of the buffer for i in range(counter): self.read() sleep(0.1) # get time to perform sweep # sweep_time = self.sweep_time # Only written for ASCII data transfer self.write("FORM4") temp_data = [] start = now() self.write("OUTPDATA") while len(temp_data) < (points): try: if self.adapter.connection.bytes_in_buffer >= 50: temp_data.append(self.read_bytes(50).decode("utf-8").strip("\n").split(",")) else: sleep(0.001) # break the loop if the sweep gets interrupted or takes too long if now() > start + timeout: raise TimeoutError( f"Failed to read data. Data transfer method timed \ out after {timeout} seconds" ) except VisaIOError: pass # process string data into complex numbers preformat_data = [float(point[0]) + float(point[1]) * 1j for point in temp_data] data = np.array(preformat_data) return data def shutdown(self): """Shutdown - Disables RF Output.""" self.output_enabled = False ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hplegacyinstrument.py0000644000175100017510000001163415203313266024577 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import ctypes import logging from pymeasure.instruments import Instrument log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) c_uint8 = ctypes.c_uint8 c_uint16 = ctypes.c_uint16 c_uint32 = ctypes.c_uint32 class StatusBitsBase(ctypes.BigEndianStructure): """ A bitfield structure containing the assignments for the status decoding """ _pack_ = 1 _get_process_ = {} # decoder functions # decimal to BCD & BCD to decimal conversion copied from # https://pymodbus.readthedocs.io/en/latest/source/example/bcd_payload.html @staticmethod def _convert_from_bcd(bcd): """Converts a bcd value to a decimal value :param value: The value to unpack from bcd :returns: The number in decimal form """ place, decimal = 1, 0 while bcd > 0: nibble = bcd & 0xF decimal += nibble * place bcd >>= 4 place *= 10 return decimal @staticmethod def _convert_to_bcd(decimal): """Converts a decimal value to a bcd value :param value: The decimal value to to pack into bcd :returns: The number in bcd form """ place, bcd = 0, 0 while decimal > 0: nibble = decimal % 10 bcd += nibble << place decimal //= 10 place += 4 return bcd def __str__(self): """ Returns a pretty formatted string showing the status of the instrument """ ret_str = "" for field in self._fields_: ret_str = ret_str + f"{field[0]}: {hex(getattr(self, field[0]))}\n" return ret_str def __getattribute__(self, name): val = super().__getattribute__(name) if name == "fields": return val if name in self.fields(): process = super().__getattribute__('_get_process_') if name in process: val = process[name](val) return val def fields(self): return [desc[0] for desc in super().__getattribute__('_fields_')] class HPLegacyInstrument(Instrument): """ Class for legacy HP instruments from the era before SPCI, based on `pymeasure.Instrument` """ status_desc = StatusBitsBase # To be overriden by subclasses def __init__(self, adapter, name="HP legacy instrument", **kwargs): super().__init__( adapter, name, includeSCPI=False, **kwargs, ) self.status_bytes_count = ctypes.sizeof(self.status_desc) self.status_bits = self.status_desc log.info(f"Initializing {self.name}") def write(self, command): if command == "B": self.write_bytes(b"B") else: super().write(command) def values(self, command, **kwargs): if command == "B": self.write_bytes(b"B") return self.read_bytes(-1, **kwargs) else: return super().values(command, **kwargs) @property def status(self): """ Get an object representing the current status of the unit. """ self.write_bytes(b"B") reply = bytearray(self.read_bytes(self.status_bytes_count)) return self.status_bits.from_buffer(reply) def GPIB_trigger(self): """ Initate trigger via low-level GPIB-command (aka GET - group execute trigger) """ self.adapter.connection.assert_trigger() def reset(self): """ Initatiates a reset (like a power-on reset) of the HP3478A """ self.adapter.connection.clear() def shutdown(self): """ provides a way to gracefully close the connection to the HP3478A """ self.adapter.connection.clear() self.adapter.close() super().shutdown() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/hp/hpsystempsu.py0000644000175100017510000002353015203313266023254 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import ctypes import logging from enum import Enum from pymeasure.instruments.hp.hplegacyinstrument import HPLegacyInstrument, StatusBitsBase from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) c_uint8 = ctypes.c_uint8 class Status(StatusBitsBase): """ Support-Class with the bit assignments for the 2 status byte(12bits used) of the HP6632A """ _fields_ = [ # Byte 1: Function, Range and Number of Digits ("Error_pending", c_uint8, 1), # bit 7 ("Overcurrent", c_uint8, 1), # bit 6 ("not_assigned", c_uint8, 1), # bit 5 ("Overtempeature", c_uint8, 1), # bit 4 ("Overvoltage", c_uint8, 1), # bit 3 ("Unregulated", c_uint8, 1), # bit 2 ("CCpos", c_uint8, 1), # bit 1 ("CV", c_uint8, 1), # bit 0 # Byte 2: Status Bits ("not_assigned", c_uint8, 4), # bits 16..12 ("NORM", c_uint8, 1), # bit 11 ("FAST", c_uint8, 1), # bit 10 ("CCneg", c_uint8, 1), # bit 9 ("Inhibit_active", c_uint8, 1), # bit 8 ] limits = { "HP6632A": {"Volt_lim": 20.475, "OVP_lim": 22.0, "Cur_lim": 5.118}, "HP6633A": {"Volt_lim": 51.118, "OVP_lim": 55.0, "Cur_lim": 2.0475}, "HP6634A": {"Volt_lim": 102.38, "OVP_lim": 110.0, "Cur_lim": 1.0238}} class HP6632A(HPLegacyInstrument): """ Represents the Hewlett Packard 6632A system power supply and provides a high-level interface for interacting with the instrument. """ status_desc = Status def __init__(self, adapter, name="Hewlett-Packard HP6632A", **kwargs): kwargs.setdefault('read_termination', '\r\n') kwargs.setdefault('send_end', True) super().__init__( adapter, name, **kwargs, ) class ERRORS(Enum): """ Enum class for error messages """ NO_ERR = 0 EEPROM = 1 PON_2ND = 2 DCPON_2MD = 4 NORELAY = 5 NOTHING_SAY = 8 HEADER_EXPECTED = 10 UNRECOGNISED_HEADER = 11 NUMBER_EXPECTED = 20 NUMBER_SYNTAX = 21 OUT_OF_RANGE = 22 COMMA_EXPECTED = 30 TERM_EXPECTED = 31 PARAM_OUT = 41 V_PGM_ERR = 42 I_PGM_ERR = 43 OV_PGM_ERR = 44 DLY_PGM_ERR = 45 MASK_PGM_ERR = 46 MULT_CSAVE_ERR = 50 EEPROM_CJLSUM_ERR = 51 CALMODE_DISABLED = 52 CAL_CHNL_ERR = 53 CAL_FS_ERR = 54 CAL_OFFSET = 55 CAL_JMP_ERR = 59 class ST_ERRORS(Enum): """ Enum class for selftest errors """ NO_ST_ERR = 0 ROM_CKSSUM = 1 RAM_TEST = 2 HPIB_CHIP = 3 HPIB_TIMER_SLOW = 4 HPIB_TIMER_FAST = 5 PSI_ROM_CHKSUM = 11 PSI_RAM_TEST = 12 PSI_TIMER_SLOW = 14 PSI_TIMER_FAST = 15 AD_TEST_HIGH = 16 AD_TEST_LOW = 17 CCCV_ZERO_HIGH = 18 CCCV_ZERO_LOW = 19 CV_REF_HIGH = 20 CV_REF_LOW = 21 CC_REF_HIGH = 22 CC_REF_LOW = 23 DAC_FAIL = 24 EEPROM_CHKSUM = 51 def check_errors(self): """ Method to read the error status register :return error_status: one byte with the error status register content :rtype error_status: int """ # Read the error status register only one time for this method, as # the manual states that reading the error status register also clears it. current_errors = int(self.ask("ERR?")) if current_errors != 0: log.error("HP6632 Error detected: %s", self.ERRORS(current_errors)) return self.ERRORS(current_errors) def check_selftest_errors(self): """ Method to read the error status register :return error_status: one byte with the error status register content :rtype error_status: int """ # Read the error status register only one time for this method, as # the manual states that reading the error status register also clears it. current_errors = int(self.ask("TEST?")) if current_errors != 0: log.error("HP6632 Error detected: %s", self.ERRORS(current_errors)) return self.ST_ERRORS(current_errors) def clear(self): """ Resets the instrument to power-on default settings """ self.write("CLR") delay = HPLegacyInstrument.setting( "DELAY %g", """ A float property that changes the reprogamming delay Default values: 8 ms in FAST mode 80 ms in NORM mode Values will be rounded to the next 4 ms by the instrument """, validator=strict_range, values=[0, 32.768], ) display_active = HPLegacyInstrument.setting( "DIS %d", """ A boot property which controls if the display is enabled """, validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) @property def status(self): """ Returns an object representing the current status of the unit. """ # overloading the already existing property because of the different command reply = bytearray(int(self.ask("STS?")).to_bytes( self.status_bytes_count, "little")) return self.status_bits.from_buffer(reply) id = HPLegacyInstrument.measurement( "ID?", """ Reads the ID of the instrument and returns this value for now """, ) current = HPLegacyInstrument.control( "IOUT?", "ISET %g", """ A floating point property that controls the output current of the device. """, dynamic=True, validator=strict_range, values=[0, limits["HP6632A"]["Cur_lim"]], ) over_voltage_limit = HPLegacyInstrument.setting( "OVSET %g", """ A floationg point property that sets the OVP threshold. """, dynamic=True, validator=strict_range, values=[0, limits["HP6632A"]["OVP_lim"]], ) OCP_enabled = HPLegacyInstrument.setting( "OCP %d", """ A bool property which controls if the OCP (OverCurrent Protection) is enabled """, validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) output_enabled = HPLegacyInstrument.setting( "OUT %d", """ A bool property which controls if the outputis enabled """, validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) @output_enabled.getter def output_enabled(self): """ A bool property which controls if the output is enabled """ output_status = bool(self.status.CV or self.status.CCpos or self.status.CCneg or self.status.Unregulated) return output_status def reset_OVP_OCP(self): """ Resets Overvoltage and Overcurrent protections """ self.write("RST") rom_version = HPLegacyInstrument.measurement( "ROM?", """ Reads the ROM id (software version) of the instrument and returns this value for now """, ) SRQ_enabled = HPLegacyInstrument.setting( "SRQ %d", """ A bool property which controls if the SRQ (ServiceReQuest) is enabled """, validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) voltage = HPLegacyInstrument.control( "VOUT?", "VSET %g", """ A floating point proptery that controls the output voltage of the device. """, dynamic=True, validator=strict_range, values=[0, limits["HP6632A"]["Volt_lim"]], ) class HP6633A(HP6632A): """ Represents the Hewlett Packard 6633A system power supply and provides a high-level interface for interacting with the instrument. """ def __init__(self, adapter, name="Hewlett Packard HP6633A", **kwargs): super().__init__(adapter, name, **kwargs) current_values = [0, limits["HP6633A"]["Cur_lim"]] OVP_values = [0, limits["HP6633A"]["OVP_lim"]] voltage_values = [0, limits["HP6633A"]["Volt_lim"]] class HP6634A(HP6632A): """ Represents the Hewlett Packard 6634A system power supply and provides a high-level interface for interacting with the instrument. """ def __init__(self, adapter, name="Hewlett Packard HP6634A", **kwargs): super().__init__(adapter, name, **kwargs) current_values = [0, limits["HP6634A"]["Cur_lim"]] OVP_values = [0, limits["HP6634A"]["OVP_lim"]] voltage_values = [0, limits["HP6634A"]["Volt_lim"]] ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0218384 pymeasure-0.16.0/pymeasure/instruments/ilxlightwave/0000755000175100017510000000000015203313301022361 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ilxlightwave/__init__.py0000644000175100017510000000224215203313266024504 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .ldp3811 import LDP3811 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ilxlightwave/ldp3811.py0000644000175100017510000001544715203313266024054 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument from pymeasure.instruments.validators import strict_range, strict_discrete_set try: from enum import StrEnum except ImportError: from enum import Enum class StrEnum(str, Enum): """Until StrEnum is broadly available from the standard library""" # Python>3.10 remove it. def __str__(self): return str(self.value) log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class LDP3811Mode(StrEnum): """Enumerator of LDP3811 modes.""" CONTINUOUS_WAVE = "CW" CONST_DUTY_CYCLE = "CDC" CONST_REPETITION_INTERVAL = "PRI" EXTERNAL_TRIGGER = "EXT" class LDP3811(Instrument): """Represents the ILX Lightwave LDP3811 Pulsed Laser Diode Driver and provides a high-level interface for interacting with the instrument.""" def __init__(self, adapter, name="ILX Lightwave LDP 3811", includeSCPI=False, **kwargs): super().__init__(adapter, name, includeSCPI, **kwargs) def check_errors(self): errors = self.values("ERRORS?") for err in errors: log.error(err) return errors output_enabled = Instrument.control( "OUTPUT?", "OUTPUT %d", """Control whether the current output is enabled (bool).""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) mode = Instrument.control( "MODE?", "MODE %s", """Control the mode as an :class:`LDP3811Mode` enum.""", validator=strict_discrete_set, values=LDP3811Mode, get_process=lambda v: LDP3811Mode(v), ) # --- Current Control --- current = Instrument.measurement( "LDI?", """Measure the current, in mA (float).""", ) @property def current_setpoint(self): """Control the current setpoint, in mA (float, strictly in range 0 to (:attr:`~.current_limit_500` if :attr:`~.current_range_500_enabled` else :attr:`~.current_limit_200`)).""" return self.values("SET:LDI?")[0] @current_setpoint.setter def current_setpoint(self, value): current_limit = ( self.current_limit_500 if self.current_range_500_enabled else self.current_limit_200 ) value = strict_range(value, (0, current_limit)) self.write(f"LDI {value}") current_range_500_enabled = Instrument.control( "RANGE?", "RANGE %d", """Control whether the 500mA output current range is enabled (bool). If False the 200mA output current range is selected.""", validator=strict_discrete_set, values={True: 500, False: 200}, map_values=True, ) current_limit_200 = Instrument.control( "LIMIT:I200?", "LIMIT:I200 %g", """Control the current limit for the 200mA range, in mA (float, strictly in range 0 to 200).""", validator=strict_range, values=(0, 200), ) current_limit_500 = Instrument.control( "LIMIT:I500?", "LIMIT:I500 %g", """Control the current limit for the 500mA range, in mA (float, strictly in range 0 to 500).""", validator=strict_range, values=(0, 500), ) # --- Pulse control --- duty_cycle = Instrument.measurement( "CDC?", """Measure the duty cycle (pulse width / pulse repetition interval), as a percentage (float).""", ) @property def duty_cycle_setpoint(self): """Control the duty cycle (pulse width / pulse repetition interval) as a percentage (float, strictly in range (100 * :attr:`~.pulse_width` / 6500) to 100).""" return self.values("SET:CDC?")[0] @duty_cycle_setpoint.setter def duty_cycle_setpoint(self, value): value = strict_range(value, (100 * self.pulse_width / 6500, 100)) self.write(f"CDC {value}") def set_to_min_duty_cycle(self): """Set the duty cycle to the minimum valid value given the present mode, pulse width, and pulse repetition interval, and return the duty cycle.""" self.write("CDC 0.01") # The instrument implicitly truncates to the closest valid value self.check_errors() return self.duty_cycle_setpoint def set_to_max_duty_cycle(self): """Set the duty cycle to the maximum valid value given the present mode, pulse width, and pulse repetition interval, and return the duty cycle.""" self.write("CDC 100") # The instrument implicitly truncates to the closest valid value self.check_errors() return self.duty_cycle_setpoint pulse_repetition_interval = Instrument.measurement( "PRI?", """Measure the pulse repetition interval, in us (float).""", ) @property def pulse_repetition_interval_setpoint(self): """Control the pulse repetition interval, in us (float, strictly in range max(1, :attr:`~.pulse_width`) to 6500).""" return self.values("SET:PRI?")[0] @pulse_repetition_interval_setpoint.setter def pulse_repetition_interval_setpoint(self, value): value = strict_range(value, (max(1, self.pulse_width), 6500)) self.write(f"PRI {value}") pulse_width = Instrument.measurement( "PW?", """Measure the pulse width, in us (float).""", ) @property def pulse_width_setpoint(self): """Control the pulse width, in us (float strictly in range 0.1 to :attr:`~.pulse_repetition_interval`.""" return self.values("SET:PW?")[0] @pulse_width_setpoint.setter def pulse_width_setpoint(self, value): value = strict_range(value, (0.1, self.pulse_repetition_interval)) self.write(f"PW {value}") ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1779275457.022138 pymeasure-0.16.0/pymeasure/instruments/inficon/0000755000175100017510000000000015203313301021277 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/inficon/__init__.py0000644000175100017510000000224015203313266023420 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .sqm160 import SQM160 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/inficon/sqm160.py0000644000175100017510000002027015203313266022713 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Channel, Instrument def calculate_checksum(msg): """calculate a two byte Cyclic Redundancy Check based on 14 bits Parameters ---------- msg: bytes Message of the device without the sync character """ # check if message contains data if not msg: return chr(0) + chr(0) # initialize CRC crc = 0x3fff # loop over characters in message for char in msg: crc ^= char for i in range(8): tmpcrc = crc crc = crc >> 1 if tmpcrc & 1 == 1: crc ^= 0x2001 crc &= 0x3fff # separate 14 significant bits in two byte checksum return bytes(((crc & 0x7f) + 34, ((crc >> 7) & 0x7f) + 34)) class SensorChannel(Channel): """Sensor channel for individual rate measurements.""" rate = Channel.measurement( "L{ch}?", """Get the current rate for a sensor in Angstrom per second""", cast=float, ) thickness = Channel.measurement( "N{ch}", """Get the current thickness for a sensor in Angstrom""", cast=float, ) frequency = Channel.measurement( "P{ch}", """Get the current frequency for a sensor in Hz""", cast=float, ) crystal_life = Channel.measurement( "R{ch}", """Get the crystal life value in percent""", cast=float, ) class SQM160(Instrument): """Inficon SQM-160 multi-film rate/thickness monitor. Uses a quartz crystal sensor to measure rate and thickness in a thin film deposition process. Connection to the device is commonly made through a serial connection (RS232) or optionally via USB or Ethernet. A command packet always consists of the following: - 1 Byte: Sync character ('!' appears only at the start of a message). - 1 Byte: length character obtained from the message length without CRC. A value of 34 is added so that no '!' can occur. - Command message with variable length. - 2 Byte: Cyclic Redundancy Check (CRC) checksum. A response packet always consists of: - 1 Byte: Sync character ('!' appears only at the start of a message). - 1 Byte: length character obtained from the message length without CRC. A value of 35 is added. - 1 Byte: Response status character indicating the status of the command. - Response message with variable length. - 2 Byte: Cyclic Redundancy Check (CRC) checksum. :param adapter: pyvisa resource name of the instrument or adapter instance :param string name: Name of the instrument. :param string baud_rate: Baud rate used by the serial connection. :param kwargs: Any valid key-word argument for Instrument """ sensor_1 = Instrument.ChannelCreator(SensorChannel, 1) sensor_2 = Instrument.ChannelCreator(SensorChannel, 2) sensor_3 = Instrument.ChannelCreator(SensorChannel, 3) sensor_4 = Instrument.ChannelCreator(SensorChannel, 4) sensor_5 = Instrument.ChannelCreator(SensorChannel, 5) sensor_6 = Instrument.ChannelCreator(SensorChannel, 6) def __init__(self, adapter, name="Inficon SQM-160 thickness monitor", baud_rate=19200, **kwargs): super().__init__(adapter, name, includeSCPI=False, write_termination="", read_termination="", asrl=dict(baud_rate=baud_rate), timeout=3000, **kwargs) def read(self): """Reads a response message from the instrument. This method also checks for a correct checksum. :returns: the response packet :rtype: string :raises ConnectionError: if a checksum error is detected or a wrong response status is detected. """ header = self.read_bytes(2) # check valid header if header[0] != 33: # b"!" raise ConnectionError(f"invalid header start byte '{header[0]}' received") length = header[1] - 35 if length <= 0: raise ConnectionError(f"invalid message length '{header[1]}' -> length {length}") response_status = self.read_bytes(1) if response_status == b"C": raise ConnectionError("invalid command response received") elif response_status == b"D": raise ConnectionError("Problem with data in command") elif response_status != b"A": raise ConnectionError(f"unknown response status character '{response_status}'") if length - 1 > 0: data = self.read_bytes(length - 1) else: data = b"" chksum = self.read_bytes(2) calculated_checksum = calculate_checksum( header[1].to_bytes(length=1, byteorder='big') + response_status + data) if chksum == calculated_checksum: return data.decode() else: raise ConnectionError( f"checksum error in received message '{header + response_status + data}' " f"with checksum '{calculated_checksum}' but received '{chksum}'") def write(self, command): """Write a command to the device.""" length = chr(len(command) + 34) message = f"{length}{command}".encode() self.write_bytes(b"!" + message + calculate_checksum(message)) def check_set_errors(self): """Check the errors after setting a property.""" self.read() return [] # no error happened firmware_version = Instrument.measurement( "@", """Get the firmware version.""", cast=str, ) number_of_channels = Instrument.measurement( "J", """Get the number of installed channels""", cast=int, ) average_rate = Instrument.measurement( "M", """Get the current average rate in Angstrom per second""", cast=float, ) average_thickness = Instrument.measurement( "O", """Get the current average thickness in Angstrom""", cast=float, ) all_values = Instrument.measurement( "W", """Get the current rate (Angstrom/s), Thickness (Angstrom), and frequency (Hz) for each sensor""", cast=float, preprocess_reply=lambda msg: msg[5:], # ingore first '00.00' ) reset_flag = Instrument.measurement( "Y", """Get the power-up reset flag. It is True only when read first after a power cycle.""", cast=int, values={True: 1, False: 0}, map_values=True, ) def reset_system_parameters(self): """Reset all film and system parameters.""" self.write("Z") self.read() # read obligatory response message def reset_thickness_rate(self): """Reset the average thickness and rate. This also sets all active Sensor Rates and Thicknesses to zero """ self.write("S") self.read() # read obligatory response message def reset_time(self): """Reset the time of the monitor to zero. """ self.write("T") self.read() # read obligatory response message ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/instrument.py0000644000175100017510000002453415203313266022456 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import time from typing import Optional, Sequence, TypeVar, Union from warnings import warn from .common_base import CommonBase from ..adapters.adapter import Adapter from ..adapters.visa import VISAAdapter _Self = TypeVar("_Self", bound="Instrument") # typing.Self for Python>3.10 log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Instrument(CommonBase): """The base class for all Instrument definitions. It makes use of one of the :py:class:`~pymeasure.adapters.Adapter` classes for communication with the connected hardware device. This decouples the instrument/command definition from the specific communication interface used. When ``adapter`` is a string, this is taken as an appropriate resource name. Depending on your installed VISA library, this can be something simple like ``COM1`` or ``ASRL2``, or a more complicated `VISA resource name `__ defining the target of your connection. When ``adapter`` is an integer, a GPIB resource name is created based on that. In either case a :py:class:`~pymeasure.adapters.VISAAdapter` is constructed based on that resource name. Keyword arguments can be used to further configure the connection. Otherwise, the passed :py:class:`~pymeasure.adapters.Adapter` object is used and any keyword arguments are discarded. This class defines basic SCPI commands by default. This can be disabled with :code:`includeSCPI` for instruments not compatible with the standard SCPI commands. :param adapter: A string, integer, or :py:class:`~pymeasure.adapters.Adapter` subclass object :param string name: The name of the instrument. Often the model designation by default. :param includeSCPI: An obligatory boolean, which toggles the inclusion of standard SCPI commands .. deprecated:: 0.14 If True, inherit the :class:`~pymeasure.instruments.generic_types.SCPIMixin` class instead. :param \\**kwargs: In case ``adapter`` is a string or integer, additional arguments passed on to :py:class:`~pymeasure.adapters.VISAAdapter` (check there for details). Discarded otherwise. """ adapter: Adapter # noinspection PyPep8Naming def __init__( self, adapter: Union[Adapter, int, str], name: str, includeSCPI: Optional[bool] = None, **kwargs, ): # Setup communication before possible children require the adapter. if isinstance(adapter, (int, str)): try: adapter = VISAAdapter(adapter, **kwargs) except ImportError: raise Exception("Invalid Adapter provided for Instrument since" " PyVISA is not present") self.adapter = adapter if includeSCPI is True: warn("Defining SCPI base functionality with `includeSCPI=True` is deprecated, inherit " "the `SCPIMixin` class instead.", FutureWarning) elif includeSCPI is None: warn("It is deprecated to specify `includeSCPI` implicitly, use " "`includeSCPI=False` or inherit the `SCPIMixin` class instead.", FutureWarning) includeSCPI = True self.SCPI = includeSCPI self.isShutdown = False self.name = name super().__init__() log.info("Initializing %s." % self.name) def __enter__(self: _Self) -> _Self: return self def __exit__(self, exc_type, exc_val, exc_tb) -> Optional[bool]: self.shutdown() return None # SCPI default properties @property def complete(self): """Get the synchronization bit. This property allows synchronization between a controller and a device. The Operation Complete query places an ASCII character 1 into the device's Output Queue when all pending selected device operations have been finished. """ if self.SCPI: return self.ask("*OPC?").strip() else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") @property def status(self): """ Get the status byte and Master Summary Status bit. """ if self.SCPI: return self.ask("*STB?").strip() else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") @property def options(self): """ Get the device options installed. """ if self.SCPI: return self.ask("*OPT?").strip() else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") @property def id(self): """ Get the identification of the instrument. """ if self.SCPI: return self.ask("*IDN?").strip() else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") @property def next_error(self): """Get the next error of the instrument (tuple of code and message).""" if self.SCPI: return self.values("SYST:ERR?") else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") # Wrapper functions for the Adapter object def write(self, command: str, **kwargs) -> None: """Write a string command to the instrument appending `write_termination`. :param command: command string to be sent to the instrument :param kwargs: Keyword arguments for the adapter. """ self.adapter.write(command, **kwargs) def write_bytes(self, content: bytes, **kwargs) -> None: """Write the bytes `content` to the instrument.""" self.adapter.write_bytes(content, **kwargs) def read(self, **kwargs) -> str: """Read up to (excluding) `read_termination` or the whole read buffer.""" return self.adapter.read(**kwargs) def read_bytes(self, count: int, **kwargs) -> bytes: """Read a certain number of bytes from the instrument. :param int count: Number of bytes to read. A value of -1 indicates to read the whole read buffer. :param kwargs: Keyword arguments for the adapter. :returns bytes: Bytes response of the instrument (including termination). """ return self.adapter.read_bytes(count, **kwargs) def write_binary_values( self, command: str, values: Sequence[Union[int, float]], *args, **kwargs ) -> None: """Write binary values to the device. :param command: Command to send. :param values: The values to transmit. :param \\*args, \\**kwargs: Further arguments to hand to the Adapter. """ self.adapter.write_binary_values(command, values, *args, **kwargs) def read_binary_values(self, **kwargs): """Read binary values from the device.""" return self.adapter.read_binary_values(**kwargs) # Communication functions def wait_for(self, query_delay: Optional[float] = None) -> None: """Wait for some time. Used by 'ask' to wait before reading. :param query_delay: Delay between writing and reading in seconds. None is default delay. """ if query_delay: time.sleep(query_delay) # SCPI default methods def clear(self) -> None: """ Clears the instrument status byte """ if self.SCPI: self.write("*CLS") else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") def reset(self) -> None: """ Resets the instrument. """ if self.SCPI: self.write("*RST") else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") def shutdown(self) -> None: """Brings the instrument to a safe and stable state""" self.isShutdown = True log.info(f"Finished shutting down {self.name}") def check_errors(self) -> list: """Read all errors from the instrument and log them. :return: List of error entries. """ if self.SCPI: errors = [] while True: err = self.next_error if int(err[0]) != 0: log.error(f"{self.name}: {err[0]}, {err[1]}") errors.append(err) else: break return errors else: raise NotImplementedError("Non SCPI instruments require implementation in subclasses") def check_get_errors(self) -> list: """Check for errors after having gotten a property and log them. Called if :code:`check_get_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ return self.check_errors() def check_set_errors(self) -> list: """Check for errors after having set a property and log them. Called if :code:`check_set_errors=True` is set for that property. If you override this method, you may choose to raise an Exception for certain errors. :return: List of error entries. """ return self.check_errors() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0224364 pymeasure-0.16.0/pymeasure/instruments/ipgphotonics/0000755000175100017510000000000015203313301022360 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ipgphotonics/__init__.py0000644000175100017510000000223215203313266024502 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .yar import YAR ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/ipgphotonics/yar.py0000644000175100017510000001401215203313266023535 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from enum import IntFlag from pymeasure.instruments import Instrument, validators from pyvisa.constants import Parity, StopBits log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def emission_validator(value, values): if value is True: return "ON" elif value is False: return "OFF" raise ValueError(f"Value is {value}, but a boolean or 'ON' or 'OFF' required.") def setpoint_validator(value, values): if value == 0: return value else: return validators.strict_range(value, values) def power_get_process_generator(minimum): """Generate a get_process for the power property.""" def get_process(value): if isinstance(value, float): return value elif value == "Off": return 0 elif value == "Low": return minimum else: return value return get_process class YAR(Instrument): """Communication with the YAR fiber amplifier series by IPG Photonics. This is the RS232 command set. GPIB has different commands. """ def __init__(self, adapter, name="YAR fiber amplifier", **kwargs): """Establish communication with the device.""" kwargs.setdefault("write_termination", "\r") kwargs.setdefault("read_termination", "\r") super().__init__(adapter, name=name, includeSCPI=False, asrl={'parity': Parity.none, 'stop_bits': StopBits.one}, **kwargs) # Commands are 3-4 letters, followed by a parameter, a separation # by space is option. Commands are case-insensitive. # Response is command echoed back, followed by ': ' and the return # value. # get valid range of power setpoint: self.power_setpoint_values = self.power_range self.power_get_process = power_get_process_generator(self.minimum_display_power) class Status(IntFlag): EMISSION = 0x1 # emission is fully on STARTUP_DELAY = 0x2 # it is in 3 s startup HIGH_TEMPERATURE = 1 << 16 HIGH_BACKREFLECTION = 1 << 17 UNEXPECTED_EMISSION = 1 << 19 SEEDLASER_FAIL = 1 << 20 def read(self): """Read an instrument answer and check whether it is an error.""" reply = super().read().split(":") if reply[0] == "ERR": raise ConnectionError(f"Reading error '{reply}'.") else: return reply[-1].strip() def check_set_errors(self): """Check for errors after having set a property. Called if :code:`check_set_errors=True` is set for that property. """ try: self.read() except ConnectionError as exc: log.exception("Setting a property failed.", exc_info=exc) raise else: return [] # COMMUNICATION FUNCTIONS @property def id(self): """Get the model number.""" return self.values("RMN")[0] @property def status(self): """Get the current status.""" got = int(self.values("STA")[0]) return self.Status(got) emission_enabled = Instrument.control( "STA", "EM%s", """Control emission of the amplifier (bool).""", cast=int, values=("ON", "OFF"), validator=emission_validator, get_process=lambda v: bool(v & YAR.Status.EMISSION), check_set_errors=True, ) power = Instrument.measurement( "ROP", "Measure current output power in W.", get_process=power_get_process_generator(0.1), dynamic=True, ) @property def power_range(self): """Get the power limits in W.""" low = self.values("RNP")[0] high = self.values("RMP")[0] return [low, high] power_setpoint = Instrument.control( "RPS", "SPS %g", """Control output power setpoint in W.""", values=(1, 2), validator=setpoint_validator, check_set_errors=True, dynamic=True, ) current = Instrument.measurement("RDC", """Measure the diode current in A.""") temperature = Instrument.measurement("RCT", """Measure case temperature in °C.""") wavelength_temperature = Instrument.control( "RWA", "SWA %g", """Control temperature in °C for seed wavelength control.""", check_set_errors=True) temperature_seed = Instrument.measurement( "RST", "Measure current seed temperature in °C") firmware = Instrument.measurement("RFV", """Get firmware version""", cast=str) maximum_case_temperature = Instrument.measurement( "RMT", """Measure the maximum temperature for the optical module in °C.""") minimum_display_power = Instrument.measurement( "RDPT", """Measure the minimum displayable output power in W.""") def clear(self): """Reset all errors.""" return self.ask("RERR") ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1779275457.0255115 pymeasure-0.16.0/pymeasure/instruments/keithley/0000755000175100017510000000000015203313301021470 5ustar00runnerrunner././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/__init__.py0000644000175100017510000000354215203313266023617 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from .keithley2000 import Keithley2000 from .keithley2200 import Keithley2200 from .keithley2260B import Keithley2260B from .keithley2281S import Keithley2281S from .keithley2306 import Keithley2306 from .keithley2400 import Keithley2400 from .keithley2400_legacy import Keithley2400Legacy from .keithley2450 import Keithley2450 from .keithley2510 import Keithley2510 from .keithley2600 import Keithley2600 from .keithley2700 import Keithley2700 from .keithley2750 import Keithley2750 from .keithley6221 import Keithley6221 from .keithley6517b import Keithley6517B from .keithleyDMM6500 import KeithleyDMM6500 from .keithley2182 import Keithley2182 from .keithleyDAQ6510 import KeithleyDAQ6510 from .keithley4200 import Keithley4200 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/buffer.py0000644000175100017510000001110115203313266023317 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from time import sleep, time import numpy as np from pymeasure.instruments import Instrument from pymeasure.instruments.validators import truncated_range from pymeasure.adapters import PrologixAdapter log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class KeithleyBuffer: """ Implements the basic buffering capability found in many Keithley instruments. """ buffer_points = Instrument.control( ":TRAC:POIN?", ":TRAC:POIN %d", """ Control the number of buffer points. This does not represent actual points in the buffer, but the configuration value instead. """, validator=truncated_range, values=[2, 1024], cast=int ) def config_buffer(self, points=64, delay=0): """ Configure the measurement buffer for a number of points, to be taken with a specified delay. :param points: The number of points in the buffer. :param delay: The delay time in seconds. """ # Enable measurement status bit # Enable buffer full measurement bit self.write(":STAT:PRES;*CLS;*SRE 1;:STAT:MEAS:ENAB 512;") self.write(":TRAC:CLEAR;") self.buffer_points = points self.trigger_count = points self.trigger_delay = delay self.write(":TRAC:FEED SENSE;:TRAC:FEED:CONT NEXT;") self.check_errors() def is_buffer_full(self): """ Return True if the buffer is full of measurements. """ status_byte = int(self.ask("*STB?")) return (status_byte & 65) == 65 def wait_for_buffer(self, should_stop=lambda: False, timeout=60, interval=0.1): """ Block the program, waiting for a full buffer. This function returns early if the :code:`should_stop` function returns True or the timeout is reached before the buffer is full. :param should_stop: A function that returns True when this function should return early :param timeout: A time in seconds after which this function should return early :param interval: A time in seconds for how often to check if the buffer is full """ # TODO: Use SRQ initially instead of constant polling # self.adapter.wait_for_srq() t = time() while not self.is_buffer_full(): sleep(interval) if should_stop(): return if (time() - t) > timeout: raise Exception("Timed out waiting for Keithley buffer to fill.") @property def buffer_data(self): """ Get a numpy array of values from the buffer. """ self.write(":FORM:DATA ASCII") return np.array(self.values(":TRAC:DATA?"), dtype=np.float64) def start_buffer(self): """ Starts the buffer. """ self.write(":INIT") def reset_buffer(self): """ Reset the buffer. """ self.write(":STAT:PRES;*CLS;:TRAC:CLEAR;:TRAC:FEED:CONT NEXT;") def stop_buffer(self): """ Abort the buffering measurement, by stopping the measurement arming and triggering sequence. If possible, a Selected Device Clear (SDC) is used. """ if type(self.adapter) is PrologixAdapter: self.write("++clr") else: self.write(":ABOR") def disable_buffer(self): """ Disable the connection between measurements and the buffer, but does not abort the measurement process. """ self.write(":TRAC:FEED:CONT NEV") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2000.py0000644000175100017510000005561115203313266024204 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, SCPIUnknownMixin from pymeasure.instruments.validators import ( truncated_range, truncated_discrete_set, strict_discrete_set ) from .buffer import KeithleyBuffer log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Keithley2000(KeithleyBuffer, SCPIUnknownMixin, Instrument): """ Represents the Keithley 2000 Multimeter and provides a high-level interface for interacting with the instrument. .. code-block:: python meter = Keithley2000("GPIB::1") meter.measure_voltage() print(meter.voltage) """ MODES = { 'current': 'CURR:DC', 'current ac': 'CURR:AC', 'voltage': 'VOLT:DC', 'voltage ac': 'VOLT:AC', 'resistance': 'RES', 'resistance 4W': 'FRES', 'period': 'PER', 'frequency': 'FREQ', 'temperature': 'TEMP', 'diode': 'DIOD', 'continuity': 'CONT' } mode = Instrument.control( ":CONF?", ":CONF:%s", """ Control (string) the configuration mode for measurements, which can take the values: ``current`` (DC), ``current ac``, ``voltage`` (DC), ``voltage ac``, ``resistance`` (2-wire), ``resistance 4W`` (4-wire), ``period``, ``temperature``, ``diode``, and ``frequency``.""", validator=strict_discrete_set, values=MODES, map_values=True, get_process=lambda v: v.replace('"', '') ) beep_state = Instrument.control( ":SYST:BEEP:STAT?", ":SYST:BEEP:STAT %g", """ Control whether the system status beeper is enabled, which can take the values: ``enabled`` and ``disabled``. """, validator=strict_discrete_set, values={'enabled': 1, 'disabled': 0}, map_values=True ) ############### # Current (A) # ############### current = Instrument.measurement( ":READ?", """ Get a DC or AC current measurement in Amps, based on the active :attr:`~.Keithley2000.mode`. """ ) current_range = Instrument.control( ":SENS:CURR:RANG?", ":SENS:CURR:RANG:AUTO 0;:SENS:CURR:RANG %g", """ Control (floating) the DC current range in Amps, which can take values from 0 to 3.1 A. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 3.1] ) current_reference = Instrument.control( ":SENS:CURR:REF?", ":SENS:CURR:REF %g", """ Control (floating) the DC current reference value in Amps, which can take values from -3.1 to 3.1 A. """, validator=truncated_range, values=[-3.1, 3.1] ) current_nplc = Instrument.control( ":SENS:CURR:NPLC?", ":SENS:CURR:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the DC current measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) current_digits = Instrument.control( ":SENS:CURR:DIG?", ":SENS:CURR:DIG %d", """ Control (integer) the number of digits in the DC current readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int, ) current_ac_range = Instrument.control( ":SENS:CURR:AC:RANG?", ":SENS:CURR:AC:RANG:AUTO 0;:SENS:CURR:AC:RANG %g", """ Control (floating) the AC current range in Amps, which can take values from 0 to 3.1 A. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 3.1] ) current_ac_reference = Instrument.control( ":SENS:CURR:AC:REF?", ":SENS:CURR:AC:REF %g", """ Control (floating) the AC current reference value in Amps, which can take values from -3.1 to 3.1 A. """, validator=truncated_range, values=[-3.1, 3.1] ) current_ac_nplc = Instrument.control( ":SENS:CURR:AC:NPLC?", ":SENS:CURR:AC:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the AC current measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) current_ac_digits = Instrument.control( ":SENS:CURR:AC:DIG?", ":SENS:CURR:AC:DIG %d", """ Control (integer) the number of digits in the AC current readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) current_ac_bandwidth = Instrument.control( ":SENS:CURR:AC:DET:BAND?", ":SENS:CURR:AC:DET:BAND %g", """ Control (floating) the AC current detector bandwidth in Hz, which can take the values 3, 30, and 300 Hz. """, validator=truncated_discrete_set, values=[3, 30, 300] ) ############### # Voltage (V) # ############### voltage = Instrument.measurement( ":READ?", """ Get a DC or AC voltage measurement in Volts, based on the active :attr:`~.Keithley2000.mode`. """ ) voltage_range = Instrument.control( ":SENS:VOLT:RANG?", ":SENS:VOLT:RANG:AUTO 0;:SENS:VOLT:RANG %g", """ Control (floating) the DC voltage range in Volts, which can take values from 0 to 1010 V. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 1010] ) voltage_reference = Instrument.control( ":SENS:VOLT:REF?", ":SENS:VOLT:REF %g", """ Control (floating) the DC voltage reference value in Volts, which can take values from -1010 to 1010 V. """, validator=truncated_range, values=[-1010, 1010] ) voltage_nplc = Instrument.control( ":SENS:VOLT:NPLC?", ":SENS:VOLT:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the DC voltage measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) voltage_digits = Instrument.control( ":SENS:VOLT:DIG?", ":SENS:VOLT:DIG %d", """ Control (integer) the number of digits in the DC voltage readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) voltage_ac_range = Instrument.control( ":SENS:VOLT:AC:RANG?", ":SENS:VOLT:RANG:AUTO 0;:SENS:VOLT:AC:RANG %g", """ Control (floating) the AC voltage range in Volts, which can take values from 0 to 757.5 V. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 757.5] ) voltage_ac_reference = Instrument.control( ":SENS:VOLT:AC:REF?", ":SENS:VOLT:AC:REF %g", """ Control (floating) the AC voltage reference value in Volts, which can take values from -757.5 to 757.5 Volts. """, validator=truncated_range, values=[-757.5, 757.5] ) voltage_ac_nplc = Instrument.control( ":SENS:VOLT:AC:NPLC?", ":SENS:VOLT:AC:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the AC voltage measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) voltage_ac_digits = Instrument.control( ":SENS:VOLT:AC:DIG?", ":SENS:VOLT:AC:DIG %d", """ Control (integer) the number of digits in the AC voltage readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) voltage_ac_bandwidth = Instrument.control( ":SENS:VOLT:AC:DET:BAND?", ":SENS:VOLT:AC:DET:BAND %g", """ Control (floating) the AC voltage detector bandwidth in Hz, which can take the values 3, 30, and 300 Hz. """, validator=truncated_discrete_set, values=[3, 30, 300] ) #################### # Resistance (Ohm) # #################### resistance = Instrument.measurement( ":READ?", """ Get a resistance measurement in Ohms for both 2-wire and 4-wire configurations, based on the active :attr:`~.Keithley2000.mode`. """ ) resistance_range = Instrument.control( ":SENS:RES:RANG?", ":SENS:RES:RANG:AUTO 0;:SENS:RES:RANG %g", """ Control (floating) the 2-wire resistance range in Ohms, which can take values from 0 to 120 MOhms. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 120e6] ) resistance_reference = Instrument.control( ":SENS:RES:REF?", ":SENS:RES:REF %g", """ Control (floating) the 2-wire resistance reference value in Ohms, which can take values from 0 to 120 MOhms. """, validator=truncated_range, values=[0, 120e6] ) resistance_nplc = Instrument.control( ":SENS:RES:NPLC?", ":SENS:RES:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the 2-wire resistance measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) resistance_digits = Instrument.control( ":SENS:RES:DIG?", ":SENS:RES:DIG %d", """ Control (integer) the number of digits in the 2-wire resistance readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) resistance_4W_range = Instrument.control( ":SENS:FRES:RANG?", ":SENS:FRES:RANG:AUTO 0;:SENS:FRES:RANG %g", """ Control (floating) the 4-wire resistance range in Ohms, which can take values from 0 to 120 MOhms. Auto-range is disabled when this property is set. """, validator=truncated_range, values=[0, 120e6] ) resistance_4W_reference = Instrument.control( ":SENS:FRES:REF?", ":SENS:FRES:REF %g", """ Control (floating) the 4-wire resistance reference value in Ohms, which can take values from 0 to 120 MOhms. """, validator=truncated_range, values=[0, 120e6] ) resistance_4W_nplc = Instrument.control( ":SENS:FRES:NPLC?", ":SENS:FRES:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the 4-wire resistance measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) resistance_4W_digits = Instrument.control( ":SENS:FRES:DIG?", ":SENS:FRES:DIG %d", """ Control (integer) the number of digits in the 4-wire resistance readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) ################## # Frequency (Hz) # ################## frequency = Instrument.measurement( ":READ?", """ Get a frequency measurement in Hz, based on the active :attr:`~.Keithley2000.mode`. """ ) frequency_reference = Instrument.control( ":SENS:FREQ:REF?", ":SENS:FREQ:REF %g", """ Control (floating) the frequency reference value in Hz, which can take values from 0 to 15 MHz. """, validator=truncated_range, values=[0, 15e6] ) frequency_digits = Instrument.control( ":SENS:FREQ:DIG?", ":SENS:FREQ:DIG %d", """ Control (integer) the number of digits in the frequency readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) frequency_threshold = Instrument.control( ":SENS:FREQ:THR:VOLT:RANG?", ":SENS:FREQ:THR:VOLT:RANG %g", """ Control (floating) the voltage signal threshold level in Volts for the frequency measurement, which can take values from 0 to 1010 V. """, validator=truncated_range, values=[0, 1010] ) frequency_aperature = Instrument.control( ":SENS:FREQ:APER?", ":SENS:FREQ:APER %g", """ Control (floating) the frequency aperature in seconds, which sets the integration period and measurement speed. Takes values from 0.01 to 1.0 s. """, validator=truncated_range, values=[0.01, 1.0] ) ############## # Period (s) # ############## period = Instrument.measurement( ":READ?", """ Get a period measurement in seconds, based on the active :attr:`~.Keithley2000.mode`. """ ) period_reference = Instrument.control( ":SENS:PER:REF?", ":SENS:PER:REF %g", """ Control (floating) the period reference value in seconds, which can take values from 0 to 1 s. """, validator=truncated_range, values=[0, 1] ) period_digits = Instrument.control( ":SENS:PER:DIG?", ":SENS:PER:DIG %d", """ Control (integer) the number of digits in the period readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) period_threshold = Instrument.control( ":SENS:PER:THR:VOLT:RANG?", ":SENS:PRE:THR:VOLT:RANG %g", """ Control (floating) the voltage signal threshold level in Volts for the period measurement, which can take values from 0 to 1010 V. """, validator=truncated_range, values=[0, 1010] ) period_aperature = Instrument.control( ":SENS:PER:APER?", ":SENS:PER:APER %g", """ Control (floating) the period aperature in seconds, which sets the integration period and measurement speed. Takes values from 0.01 to 1.0 s. """, validator=truncated_range, values=[0.01, 1.0] ) ################### # Temperature (C) # ################### temperature = Instrument.measurement( ":READ?", """ Get a temperature measurement in Celsius, based on the active :attr:`~.Keithley2000.mode`. """ ) temperature_reference = Instrument.control( ":SENS:TEMP:REF?", ":SENS:TEMP:REF %g", """ Control (floating) the temperature reference value in Celsius, which can take values from -200 to 1372 C. """, validator=truncated_range, values=[-200, 1372] ) temperature_nplc = Instrument.control( ":SENS:TEMP:NPLC?", ":SENS:TEMP:NPLC %g", """ Control (floating) the number of power line cycles (NPLC) for the temperature measurements, which sets the integration period and measurement speed. Takes values from 0.01 to 10, where 0.1, 1, and 10 are Fast, Medium, and Slow respectively. """ ) temperature_digits = Instrument.control( ":SENS:TEMP:DIG?", ":SENS:TEMP:DIG %d", """ Control (integer) the number of digits in the temperature readings, which can take values from 4 to 7. """, validator=truncated_discrete_set, values=[4, 5, 6, 7], cast=int ) ########### # Trigger # ########### trigger_count = Instrument.control( ":TRIG:COUN?", ":TRIG:COUN %d", """ Control (integer) the trigger count, which can take values from 1 to 9,999. """, validator=truncated_range, values=[1, 9999], cast=int ) trigger_delay = Instrument.control( ":TRIG:SEQ:DEL?", ":TRIG:SEQ:DEL %g", """ Control (floating) the trigger delay in seconds, which can take values from 1 to 9,999,999.999 s. """, validator=truncated_range, values=[0, 999999.999] ) def __init__(self, adapter, name="Keithley 2000 Multimeter", **kwargs): super().__init__( adapter, name, **kwargs ) def measure_voltage(self, max_voltage=1, ac=False): """ Configures the instrument to measure voltage, based on a maximum voltage to set the range, and a boolean flag to determine if DC or AC is required. :param max_voltage: A voltage in Volts to set the voltage range :param ac: False for DC voltage, and True for AC voltage """ if ac: self.mode = 'voltage ac' self.voltage_ac_range = max_voltage else: self.mode = 'voltage' self.voltage_range = max_voltage def measure_current(self, max_current=10e-3, ac=False): """ Configures the instrument to measure current, based on a maximum current to set the range, and a boolean flag to determine if DC or AC is required. :param max_current: A current in Volts to set the current range :param ac: False for DC current, and True for AC current """ if ac: self.mode = 'current ac' self.current_ac_range = max_current else: self.mode = 'current' self.current_range = max_current def measure_resistance(self, max_resistance=10e6, wires=2): """ Configures the instrument to measure resistance, based on a maximum resistance to set the range, and the number of wires utilized. :param max_resistance: A resistance in ohms to set the resistance range :param wires: Number of wires employed (2 or 4) """ if wires == 2: self.mode = 'resistance' self.resistance_range = max_resistance elif wires == 4: self.mode = 'resistance 4W' self.resistance_4W_range = max_resistance else: raise ValueError("Keithley 2000 only supports 2 or 4 wire" " resistance measurements.") def measure_period(self): """ Configures the instrument to measure the period. """ self.mode = 'period' def measure_frequency(self): """ Configures the instrument to measure the frequency. """ self.mode = 'frequency' def measure_temperature(self): """ Configures the instrument to measure the temperature. """ self.mode = 'temperature' def measure_diode(self): """ Configures the instrument to perform diode testing. """ self.mode = 'diode' def measure_continuity(self): """ Configures the instrument to perform continuity testing. """ self.mode = 'continuity' def _mode_command(self, mode=None): if mode is None: mode = self.mode return self.MODES[mode] def auto_range(self, mode=None): """ Sets the active mode to use auto-range, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode """ self.write(":SENS:%s:RANG:AUTO 1" % self._mode_command(mode)) def enable_reference(self, mode=None): """ Enables the reference for the active mode, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode """ self.write(":SENS:%s:REF:STAT 1" % self._mode_command(mode)) def disable_reference(self, mode=None): """ Disables the reference for the active mode, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode """ self.write(":SENS:%s:REF:STAT 0" % self._mode_command(mode)) def acquire_reference(self, mode=None): """ Sets the active value as the reference for the active mode, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode """ self.write(":SENS:%s:REF:ACQ" % self._mode_command(mode)) def enable_filter(self, mode=None, type='repeat', count=1): """ Enables the averaging filter for the active mode, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode :param type: The type of averaging filter, either 'repeat' or 'moving'. :param count: A number of averages, which can take take values from 1 to 100 """ self.write(f":SENS:{self._mode_command(mode)}:AVER:STAT 1") self.write(f":SENS:{self._mode_command(mode)}:AVER:TCON {type}") self.write(f":SENS:{self._mode_command(mode)}:AVER:COUN {count}") def disable_filter(self, mode=None): """ Disables the averaging filter for the active mode, or can set another mode by its name. :param mode: A valid :attr:`~.Keithley2000.mode` name, or None for the active mode """ self.write(":SENS:%s:AVER:STAT 0" % self._mode_command(mode)) def local(self): """ Returns control to the instrument panel, and enables the panel if disabled. """ self.write(":SYST:LOC") def remote(self): """ Places the instrument in the remote state, which is does not need to be explicitly called in general. """ self.write(":SYST:REM") def remote_lock(self): """ Disables and locks the front panel controls to prevent changes during remote operations. This is disabled by calling :meth:`~.Keithley2000.local`. """ self.write(":SYST:RWL") def reset(self): """ Resets the instrument state. """ self.write(":STAT:QUEUE:CLEAR;*RST;:STAT:PRES;:*CLS;") def beep(self, frequency, duration): """ Sounds a system beep. :param frequency: A frequency in Hz between 65 Hz and 2 MHz :param duration: A time in seconds between 0 and 7.9 seconds """ self.write(f":SYST:BEEP {frequency:g}, {duration:g}") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2182.py0000644000175100017510000003344315203313266024216 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, Channel, SCPIMixin from pymeasure.instruments.validators import strict_discrete_set, strict_range from .buffer import KeithleyBuffer log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Keithley2182Channel(Channel): """Implementation of a Keithley 2182 channel. Channel 1 is the fundamental measurement channel, while channel 2 provides sense measurements. Channel 2 inputs are referenced to Channel 1 LO. Possible configurations are Voltage (Channel 1) Temperature (Channel 1) Voltage (Channel 1) and Voltage (Channel 2) Voltage (Channel 1) and Temperature (Channel 2) """ def __init__(self, parent, id): """Set max voltage depending on channel.""" if id == 1: self.voltage_range_values = (0, 120) self.voltage_offset_values = (-120, 120) else: self.voltage_range_values = (0, 12) self.voltage_offset_values = (-12, 12) super().__init__(parent, id) voltage_range = Channel.control( ":SENS:VOLT:CHAN{ch}:RANG?", ":SENS:VOLT:CHAN{ch}:RANG %g", """Control the positive full-scale measurement voltage range in Volts. The Keithley 2182 selects a measurement range based on the expected voltage. DCV1 has five ranges: 10 mV, 100 mV, 1 V, 10 V, and 100 V. DCV2 has three ranges: 100 mV, 1 V, and 10 V. Valid limits are from 0 to 120 V for Ch. 1, and 0 to 12 V for Ch. 2. Auto-range is automatically disabled when this property is set.""", validator=strict_range, values=(0, 120), dynamic=True, ) voltage_range_auto_enabled = Channel.control( ":SENS:VOLT:CHAN{ch}:RANG:AUTO?", ":SENS:VOLT:CHAN{ch}:RANG:AUTO %d", """Control the auto voltage ranging option (bool).""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) voltage_offset = Channel.control( ":SENS:VOLT:CHAN{ch}:REF?", ":SENS:VOLT:CHAN{ch}:REF %g", """Control the relative offset for measuring voltage. Displayed value = actual value - offset value. Valid ranges are -120 V to +120 V for Ch. 1, and -12 V to +12 V for Ch. 2.""", validator=strict_range, values=(-120, 120), dynamic=True, ) temperature_offset = Channel.control( ":SENS:TEMP:CHAN{ch}:REF?", ":SENS:TEMP:CHAN{ch}:REF %g", """Control the relative offset for measuring temperature. Displayed value = actual value - offset value. Valid values are -273 C to 1800 C.""", validator=strict_range, values=(-273, 1800), ) voltage_offset_enabled = Channel.control( ":SENS:VOLT:CHAN{ch}:REF:STAT?", ":SENS:VOLT:CHAN{ch}:REF:STAT %s", """Control whether voltage is measured as a relative or absolute value (bool). Enabled by default for Ch. 2 voltage, which is measured relative to Ch. 1 voltage.""", validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) temperature_offset_enabled = Channel.control( ":SENS:TEMP:CHAN{ch}:REF:STAT?", ":SENS:TEMP:CHAN{ch}:REF:STAT %s", """Control whether temperature is measured as a relative or absolute value (bool). Disabled by default.""", validator=strict_discrete_set, values={False: 0, True: 1}, map_values=True ) def setup_voltage(self, auto_range=True, nplc=5): """Set active channel and configure channel for voltage measurement. :param auto_range: Enables auto_range if True, else uses set voltage range :param nplc: Number of power line cycles (NPLC) from 0.01 to 50/60 """ self.write(":SENS:CHAN {ch};" ":SENS:FUNC 'VOLT';" f":SENS:VOLT:NPLC {nplc};") if auto_range: self.write(":SENS:VOLT:RANG:AUTO 1") self.check_errors() def setup_temperature(self, nplc=5): """Change active channel and configure channel for temperature measurement. :param nplc: Number of power line cycles (NPLC) from 0.01 to 50/60 """ self.write(":SENS:CHAN {ch};" ":SENS:FUNC 'TEMP';" f":SENS:TEMP:NPLC {nplc}") self.check_errors() def acquire_temperature_reference(self): """Acquire a temperature measurement and store it as the relative offset value. Only acquires reference if temperature offset is enabled. """ self.write(":SENS:TEMP:CHAN{ch}:REF:ACQ") def acquire_voltage_reference(self): """Acquire a voltage measurement and store it as the relative offset value. Only acquires reference if voltage offset is enabled. """ self.write(":SENS:VOLT:CHAN{ch}:REF:ACQ") class Keithley2182(SCPIMixin, KeithleyBuffer, Instrument): """Represents the Keithley 2182 Nanovoltmeter and provides a high-level interface for interacting with the instrument. .. code-block:: python keithley = Keithley2182("GPIB::1") keithley.reset() # Return instrument settings to default values keithley.thermocouple = 'S' # Sets thermocouple type to S keithley.active_channel = 1 # Sets channel 1 for active measurement keithley.channel_function = 'voltage' # Configures active channel for voltage measurement print(keithley.voltage) # Prints the voltage in volts keithley.ch_1.setup_voltage() # Set channel 1 active and prepare voltage measurement keithley.ch_2.setup_temperature() # Set channel 2 active and prepare temperature measurement """ def __init__(self, adapter, name="Keithley 2182 Nanovoltmeter", read_termination='\r', **kwargs): super().__init__(adapter, name, read_termination=read_termination, **kwargs) ch_1 = Instrument.ChannelCreator(Keithley2182Channel, 1) ch_2 = Instrument.ChannelCreator(Keithley2182Channel, 2) ################# # Configuration # ################# auto_zero_enabled = Instrument.control( ":SYST:AZER:STAT?", ":SYST:AZER:STAT %d", """Control the auto zero option (bool).""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) line_frequency = Instrument.measurement( ":SYST:LFR?", """Get the line frequency in Hertz. Values are 50 or 60. Cannot be set on 2182.""", ) display_enabled = Instrument.control( ":DISP:ENAB?", ":DISP:ENAB %d", """Control whether the front display of the voltmeter is enabled. Valid values are True and False.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) active_channel = Instrument.control( ":SENS:CHAN?", ":SENS:CHAN %d", """Control which channel is active for measurement. Valid values are 0 (internal temperature sensor), 1, and 2.""", validator=strict_discrete_set, values=(0, 1, 2), cast=int ) channel_function = Instrument.control( ":SENS:FUNC?", "SENS:FUNC %s", """Control the measurement mode of the active channel. Valid options are `voltage` and `temperature`.""", validator=strict_discrete_set, values={'voltage': '"VOLT:DC"', 'temperature': '"TEMP"'}, map_values=True ) ############### # Voltage (V) # ############### voltage = Instrument.measurement( ":READ?", """Measure the voltage in Volts, if active channel is configured for this reading.""" ) voltage_nplc = Instrument.control( ":SENS:VOLT:NPLC?", ":SENS:VOLT:NPLC %g", """Control the number of power line cycles (NPLC) for voltage measurements, which sets the integration period and measurement speed. Valid values are from 0.01 to 50 or 60, depending on the line frequency. Default is 5.""", validator=strict_range, values=(0.01, 60), dynamic=True, ) ################### # Temperature (C) # ################### temperature = Instrument.measurement( ":READ?", """Measure the temperature in Celsius, if active channel is configured for this reading.""" ) thermocouple = Instrument.control( ":SENS:TEMP:TC?", ":SENS:TEMP:TC %s", """Control the thermocouple type for temperature measurements. Valid options are B, E, J, K, N, R, S, and T.""", validator=strict_discrete_set, values=('B', 'E', 'J', 'K', 'N', 'R', 'S', 'T') ) temperature_nplc = Instrument.control( ":SENS:TEMP:NPLC?", ":SENS:TEMP:NPLC %g", """Control the number of power line cycles (NPLC) for temperature measurements, which sets the integration period and measurement speed. Valid values are from 0.01 to 50 or 60, depending on the line frequency. Default is 5.""", validator=strict_range, values=(0.01, 60), dynamic=True, ) temperature_reference_junction = Instrument.control( ":SENS:TEMP:RJUN:RSEL?", ":SENS:TEMP:RJUN:RSEL %s", """Control whether the thermocouple reference junction is internal (INT) or simulated (SIM). Default is INT.""", validator=strict_discrete_set, values=('SIM', 'INT'), ) temperature_simulated_reference = Instrument.control( ":SENS:TEMP:RJUN:SIM?", ":SENS:TEMP:RJUN:SIM %g", """Control the value of the simulated thermocouple reference junction in Celsius. Default is 23 C.""", validator=strict_range, values=(0, 60), ) internal_temperature = Instrument.measurement( ":SENS:TEMP:RTEM?", """Measure the internal temperature in Celsius.""" ) ############## # Statistics # ############## mean = Instrument.measurement( ":CALC2:FORM MEAN;:CALC2:STAT ON;:CALC2:IMM?;", """Get the calculated mean (average) from the buffer data.""" ) maximum = Instrument.measurement( ":CALC2:FORM MAX;:CALC2:STAT ON;:CALC2:IMM?;", """Get the calculated maximum from the buffer data.""" ) minimum = Instrument.measurement( ":CALC2:FORM MIN;:CALC2:STAT ON;:CALC2:IMM?;", """Get the calculated minimum from the buffer data.""" ) standard_dev = Instrument.measurement( ":CALC2:FORM SDEV;:CALC2:STAT ON;:CALC2:IMM?;", """Get the calculated standard deviation from the buffer data.""" ) ########### # Trigger # ########### trigger_count = Instrument.control( ":TRIG:COUN?", ":TRIG:COUN %d", """Control the trigger count which can take values from 1 to 9,999. Default is 1.""", validator=strict_range, values=(1, 9999), cast=int ) trigger_delay = Instrument.control( ":TRIG:DEL?", ":TRIG:DEL %g", """Control the trigger delay in seconds, which can take values from 0 to 999999.999 s. Default is 0.""", validator=strict_range, values=(0, 999999.999) ) ########### # Methods # ########### def auto_line_frequency(self): """Set appropriate limits for NPLC voltage and temperature readings.""" if self.line_frequency == 50: self.temperature_nplc_values = (0.01, 50) self.voltage_nplc_values = (0.01, 50) else: self.temperature_nplc_values = (0.01, 60) self.voltage_nplc_values = (0.01, 60) def reset(self): """Reset the instrument and clear the queue.""" self.write("status:queue:clear;*RST;:stat:pres;:*CLS;") def trigger(self): """Execute a bus trigger, which can be used when :meth:`~.trigger_on_bus` is configured. """ return self.write("*TRG") def trigger_immediately(self): """Configure measurements to be taken with the internal trigger at the maximum sampling rate. """ self.write(":TRIG:SOUR IMM;") def trigger_on_bus(self): """Configure the trigger to detect events based on the bus trigger, which can be activated by :meth:`~.trigger`. """ self.write(":TRIG:SOUR BUS") def sample_continuously(self): """Configure the instrument to continuously read samples and turn off any buffer or output triggering. """ self.disable_buffer() self.trigger_immediately() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2200.py0000644000175100017510000000752215203313266024204 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, Channel, SCPIUnknownMixin from pymeasure.instruments.validators import strict_discrete_set, strict_range log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class PSChannel(Channel): """Implementation of a Keithley 2200 channel.""" VOLTAGE_RANGE = [0, 70] CURRENT_RANGE = [0, 45] output_enabled = Instrument.control( "SOURCE:OUTP:ENAB?", "SOURCE:OUTP:ENAB %d", """ Control the output state.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) voltage_setpoint = Instrument.control( "VOLT?", "VOLT %g", """ Control output voltage in Volts.""", validator=strict_range, values=VOLTAGE_RANGE, ) current_limit = Instrument.control( "CURR?", "CURR %g", """ Control output current in Amps.""", validator=strict_range, values=CURRENT_RANGE, ) current = Instrument.measurement( "MEAS:CURR?", """ Measure the current in Amps.""", ) voltage = Instrument.measurement( "MEAS:VOLT?", """ Measure the voltage in Volts.""", ) power = Instrument.measurement( "MEAS:POW?", """ Measure the power in watts.""", ) voltage_limit = Instrument.control( "VOLT:LIM?", "VOLT:LIM %g", """ Control the maximum voltage that can be set.""", validator=strict_range, values=VOLTAGE_RANGE, ) voltage_limit_enabled = Instrument.control( "VOLT:LIM:STAT?", "VOLT:LIM:STAT %d", """ Control whether the maximum voltage limit is enabled.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) def insert_id(self, command): return f"INST:SEL CH{self.id};{command}" class Keithley2200(SCPIUnknownMixin, Instrument): """Represents the Keithley 2200 Power Supply.""" def __init__(self, adapter, name="Keithley2200", **kwargs): super().__init__(adapter, name, **kwargs) ch_1 = Instrument.ChannelCreator(PSChannel, 1) ch_2 = Instrument.ChannelCreator(PSChannel, 2) ch_3 = Instrument.ChannelCreator(PSChannel, 3) display_enabled = Instrument.control( "DISP?", ":DISP %d", """Control whether the display is enabled.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) display_text_data = Instrument.control( ":DISP:TEXT:DATA?", ":DISP:TEXT:DATA '%s'", """Control text to be displayed(32 characters).""", get_process=lambda v: v.replace('"', ""), ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2260B.py0000644000175100017510000001172615203313266024315 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.validators import strict_discrete_set import logging from warnings import warn log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Keithley2260B(SCPIMixin, Instrument): """ Represents the Keithley 2260B Power Supply (minimal implementation) and provides a high-level interface for interacting with the instrument. For a connection through tcpip, the device only accepts connections at port 2268, which cannot be configured otherwise. example connection string: 'TCPIP::xxx.xxx.xxx.xxx::2268::SOCKET' the read termination for this interface is \n .. code-block:: python source = Keithley2260B("GPIB::1") source.voltage = 1 print(source.voltage) print(source.current) print(source.power) print(source.applied) """ def __init__(self, adapter, name="Keithley 2260B DC Power Supply", read_termination="\n", **kwargs): super().__init__( adapter, name, read_termination=read_termination, **kwargs ) output_enabled = Instrument.control( "OUTPut?", "OUTPut %d", """Control whether the source is enabled, takes values True or False. (bool)""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) current_limit = Instrument.control( ":SOUR:CURR?", ":SOUR:CURR %g", """Control the source current in amps. This is not checked against the allowed range. Depending on whether the instrument is in constant current or constant voltage mode, this might differ from the actual current achieved. (float)""", ) voltage_setpoint = Instrument.control( ":SOUR:VOLT?", ":SOUR:VOLT %g", """Control the source voltage in volts. This is not checked against the allowed range. Depending on whether the instrument is in constant current or constant voltage mode, this might differ from the actual voltage achieved. (float)""", ) power = Instrument.measurement( ":MEAS:POW?", """Get the power (in Watt) the dc power supply is putting out. """, ) voltage = Instrument.measurement( ":MEAS:VOLT?", """Get the voltage (in Volt) the dc power supply is putting out. """, ) current = Instrument.measurement( ":MEAS:CURR?", """Get the current (in Ampere) the dc power supply is putting out. """, ) applied = Instrument.control( ":APPly?", ":APPly %g,%g", """Control voltage (volts) and current (amps) simultaneously. Values need to be supplied as tuple of (voltage, current). Depending on whether the instrument is in constant current or constant voltage mode, the values achieved by the instrument will differ from the ones set. """, ) @property def error(self): """Get the next error of the instrument (list of code and message).""" warn("Deprecated to use `error`, use `next_error` instead.", FutureWarning) return self.next_error @property def enabled(self): """Control whether the output is enabled, see :attr:`output_enabled`.""" log.warning('Deprecated property name "enabled", use the identical "output_enabled", ' 'instead.', FutureWarning) return self.output_enabled @enabled.setter def enabled(self, value): log.warning('Deprecated property name "enabled", use the identical "output_enabled", ' 'instead.', FutureWarning) self.output_enabled = value def shutdown(self): """ Disable output, call parent function""" self.output_enabled = False super().shutdown() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2281S.py0000644000175100017510000004764515203313266024352 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import enum import time import numpy as np import pandas as pd from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.instruments.channel import Channel from pymeasure.instruments.keithley.buffer import KeithleyBuffer from pymeasure.instruments.validators import strict_discrete_set, strict_range, truncated_range @enum.unique class Keithley2281SOperationEventRegister(enum.IntFlag): """ Enum containing Keithley2281S Operation Instrument Summary Event Register definition """ CALIBRATION = 1 # Performing calibration _RESERVED_1 = 2 _RESERVED_2 = 4 _RESERVED_3 = 8 MEASUREMENT = 16 # Performing measurement TRIGGER = 32 # Waiting for trigger ARM = 64 # Waiting for arm event _RESERVED_4 = 128 FILTER_SETTLED = 256 # Filter has settled or is disabled LIST = 512 # Running a list IDLE = 1024 # Idling _RESERVED_5 = 2048 _RESERVED_6 = 4096 _RESERVED_7 = 8192 _RESERVED_8 = 16384 @enum.unique class Keithley2281SMeasurementEventRegister(enum.IntFlag): """ Enum containing Keithley2281S Measurement Instrument Summary Event Register definition """ READING_OVERFLOW = 1 _RESERVED_1 = 2 _RESERVED_2 = 4 _RESERVED_3 = 8 _RESERVED_4 = 16 _RESERVED_5 = 32 READING_AVAILABLE = 64 BUFFER_HALF_FULL = 128 BUFFER_FULL = 256 BUFFER_THREE_QUARTERS_FULL = 512 BUFFER_ONE_QUARTER_FULL = 1024 _RESERVED_6 = 2048 _RESERVED_7 = 4096 _RESERVED_8 = 8192 _RESERVED_9 = 16384 # Constants needed in multiple classes _VOLTAGE_RANGE = [0.0, 20] _CURRENT_RANGE_BT_BS = [0.0, 6.1] _INTERNAL_MEMORY_SLOTS = list(range(1, 10)) _PLC_RANGE = [0.002, 12] _CURRENT_RANGE = [0.1, 6.1] class PowerSupplyChannel(Channel): """ Power Supply Mode of the device The channels are just a virtual representation of the different functions this device offers, but are mutually exclusive! Make sure that the parent's instrument `function_mode` property is set to `POWER` before using this channel. """ _data_buffer = Instrument.measurement( ':DATA:DATA? "READ,SOUR,REL"', """Get the buffer in power supply mode.""", separator=",", ) @property def buffer_data(self) -> pd.DataFrame: """Get the buffer in power supply mode and return its content as a pandas dataframe.""" if not self.parent.reading_available: return pd.DataFrame({"current": [], "voltage": [], "time": []}) data = np.array(self._data_buffer, dtype=np.float32) return pd.DataFrame({"current": data[0::3], "voltage": data[1::3], "time": data[2::3]}) voltage_setpoint = Instrument.control( ":VOLT?", ":VOLT %g", """Control the output voltage in Volts.""", validator=strict_range, values=_VOLTAGE_RANGE, ) current_limit = Instrument.control( ":CURR?", ":CURR %g", """Control the output current limit in Amps.""", validator=strict_range, values=_CURRENT_RANGE, ) voltage_limit = Instrument.control( ":VOLT:LIM?", ":VOLT:LIM %g", """Control the maximum voltage that can be set.""", validator=strict_range, values=_VOLTAGE_RANGE, ) output_enabled = Instrument.control( ":OUTP:STAT?", ":OUTP:STAT %s", """Control the output state.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) power_line_cycles = Instrument.control( ":SENS:CONC:NPLC?", ":SENS:CONC:NPLC %g", """ Control the number of power line cycles for current and voltage measurements. The upper limit depends on the line frequency and is adapted at startup. """, validator=truncated_range, values=_PLC_RANGE, ) class BatteryTestChannel(Channel): """ Battery Test Mode of the device The channels are just a virtual representation of the different functions this device offers, but are mutually exclusive! Make sure that the parent's instrument `function_mode` property is set to `TEST` before using this channel. """ charge_voltage_setpoint = Instrument.control( ":BATT:TEST:VOLT?", ":BATT:TEST:VOLT %g", """ Control the target voltage for battery tests. If it is lower than terminal voltage, the battery gets discharged, if it is higher than the terminal voltage the battery gets charged. """, validator=strict_range, values=_VOLTAGE_RANGE, ) charge_voltage_limit = Instrument.control( ":BATT:TEST:SENS:AH:VFUL?", ":BATT:TEST:SENS:AH:VFUL %g", """Control the charging target voltage for battery tests.""", validator=strict_range, values=_VOLTAGE_RANGE, ) charge_current_limit = Instrument.control( ":BATT:TEST:SENS:AH:ILIM?", ":BATT:TEST:SENS:AH:ILIM %g", """Control the maximum charging current for battery tests.""", validator=strict_range, values=_CURRENT_RANGE_BT_BS, ) termination_current = Instrument.control( ":BATT:TEST:CURR:END?", ":BATT:TEST:CURR:END %g", """Control the termination current for battery charging and discharging.""", validator=truncated_range, values=[0, 0.1], ) output_enabled = Instrument.control( ":BATT:OUTP?", ":BATT:OUTP %s", """Control the output state.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) test_control = Instrument.setting( ":BATT:TEST:SENS:AH:EXEC %s", """ Set the battery-characterization state. Set to "START", "STOP", "PAUSE" or "CONTINUE". This will en-/disable the output for the characterization process. The device will measure and collect data for the battery model. See the Keithley 077114601 p. 251 for details. """, validator=strict_discrete_set, values={"START", "STOP", "PAUSE", "CONTINUE"}, ) save_model_internal = Instrument.setting( ":BATT:TEST:SENS:AH:GMOD:SAVE:INTE %d", """Set the memory slot the battery model will be saved to.""", validator=strict_discrete_set, values=_INTERNAL_MEMORY_SLOTS, ) _data_buffer = Instrument.measurement( ':BATT:DATA:DATA? "VOLT, CURR, RES, AH, REL"', """Get the buffer in battery test mode.""", separator=",", ) def set_battery_model_range(self, lower_voltage: float, upper_voltage: float): """Set the lower and upper end voltage of the model. Args: lower_voltage (float): discharge end voltage upper_voltage (float): charge end voltage """ self.write(f":BATT:TEST:SENS:AH:GMOD:RANG {lower_voltage}, {upper_voltage}") def save_model_to_usb(self, memory_slot: int, model_file_name: str): """Save battery model to USB. Args: memory_slot (int): Number of memory slot to save model from. Valid values are 1 to 10. model_file_name (str): Name of battery model to save. '.csv' will be appended by device Raises: ValueError: invalid memory slot given """ if _INTERNAL_MEMORY_SLOTS[0] > memory_slot > _INTERNAL_MEMORY_SLOTS[-1]: raise ValueError self.write(f":BATT:MOD:SAVE:USB {memory_slot}, \"{model_file_name}\"") @property def buffer_data(self) -> pd.DataFrame: """Get the buffer in battery test mode and return its content as a pandas dataframe.""" if not self.parent.reading_available: return pd.DataFrame( {"current": [], "voltage": [], "capacity": [], "resistance": [], "time": []} ) data = np.array(self._data_buffer, dtype=np.float32) return pd.DataFrame( { "voltage": data[0::5], "current": data[1::5], "resistance": data[2::5], "capacity": data[3::5], "time": data[4::5], } ) class BatterySimulationChannel(Channel): """ Battery Simulation Mode of the device The channels are just a virtual representation of the different functions this device offers, but are mutually exclusive! Make sure that the parent's instrument `function_mode` property is set to `SIMULATION` before using this channel. """ select_model_internal = Instrument.setting( ":BATT:MOD:RCL %d", """Set the battery model from internal memory.""", validator=strict_discrete_set, values=_INTERNAL_MEMORY_SLOTS, ) def load_model_from_usb(self, memory_slot: int, model_file_name: str): """Load battery model from USB. Args: memory_slot (int): Number of memory slot to load model to. Valid values are 1 to 10. model_file_name (str): Name of battery model to load. Omit '.csv' Raises: ValueError: invalid memory slot given """ if _INTERNAL_MEMORY_SLOTS[0] > memory_slot > _INTERNAL_MEMORY_SLOTS[-1]: raise ValueError self.write(f":BATT:MOD:LOAD:USB {memory_slot}, \"{model_file_name}\"") output_enabled = Instrument.control( ":BATT:OUTP?", ":BATT:OUTP %s", """Control the output state.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) dynamic_soc = Instrument.control( ":BATT:SIM:METH?", ":BATT:SIM:METH %s", """ Control simulation mode to use. I.e. does the State of Charge (SoC) change when charging or discharging. """, validator=strict_discrete_set, values={True: "DYN", False: "STAT"}, map_values=True, ) capacity_limit = Instrument.control( ":BATT:SIM:CAP:LIM?", ":BATT:SIM:CAP:LIM %g", """ Control maximum capacity of the simulated battery in Ah. Output needs to be disabled to set this property! """, validator=truncated_range, values=[0.001, 99], ) current_capacity = Instrument.measurement( ":BATT:SIM:CAP?", """Get the real-time capacity of the simulated battery in Ah.""", ) current_limit = Instrument.control( ":BATT:SIM:CURR:LIM?", ":BATT:SIM:CURR:LIM %g", """Control maximum current of the simulated battery.""", validator=truncated_range, values=_CURRENT_RANGE_BT_BS, ) resistance_offset = Instrument.control( ":BATT:SIM:RES:OFFS?", ":BATT:SIM:RES:OFFS %g", """ Control an offset for the internal resistance of the simulated battery. ESR might not be displayed correctly until display is updated (e.g. via enabled output). """, validator=truncated_range, values=[-100, 100], ) soc_setpoint = Instrument.control( ":BATT:SIM:SOC?", ":BATT:SIM:SOC %g", """Control the State of Charge (SoC) of the simulated battery.""", validator=truncated_range, values=[0.0, 100], ) voc_setpoint = Instrument.control( ":BATT:SIM:VOC?", ":BATT:SIM:VOC %g", """ Control the Voc (Open Circuit Voltage) of the simulated battery. The set voltage will internally be converted to an equivalent State of Charge (SoC) in the device. """, validator=truncated_range, values=_VOLTAGE_RANGE, ) voc_full = Instrument.control( ":BATT:SIM:VOC:FULL?", ":BATT:SIM:VOC:FULL %g", """Control the Voc for the full simulated battery.""", validator=truncated_range, values=_VOLTAGE_RANGE, ) voc_empty = Instrument.control( ":BATT:SIM:VOC:EMPT?", ":BATT:SIM:VOC:EMPT %g", """Control the Voc for the empty simulated battery.""", validator=truncated_range, values=_VOLTAGE_RANGE, ) _data_buffer = Instrument.measurement( ':BATT:DATA:DATA? "VOLT, CURR, SOC, RES,REL"', """Get the buffer in battery simulator mode.""", separator=",", ) @property def buffer_data(self) -> pd.DataFrame: """Get the buffer in battery simulator mode and return its content as a pandas dataframe.""" if not self.parent.reading_available: return pd.DataFrame( {"current": [], "voltage": [], "soc": [], "resistance": [], "time": []} ) data = np.array(self._data_buffer, dtype=np.float32) return pd.DataFrame( { "voltage": data[0::5], "current": data[1::5], "soc": data[2::5], "resistance": data[3::5], "time": data[4::5], } ) class Keithley2281S(SCPIMixin, Instrument, KeithleyBuffer): """ Represents the Keithley 2281S-20-6 power supply and battery simulator / characterizer. Common commands beside `function_mode` and power supply commands should also work for Keithley 2280S power supplies, although this is untested. """ ps = Instrument.ChannelCreator(PowerSupplyChannel, "PS") bt = Instrument.ChannelCreator(BatteryTestChannel, "BT") bs = Instrument.ChannelCreator(BatterySimulationChannel, "BS") def __init__(self, adapter, name="Keithley2281S", **kwargs): super().__init__(adapter, name, **kwargs) if self.line_frequency == 60: _PLC_RANGE[1] = 15 # Overwritten parent property @property def buffer_data(self): """Get a pandas dataframe of values from the buffer.""" # Replace with match case, once Python>=3.10 is required function_mode = self.function_mode if function_mode == "POWER": return self.ps.buffer_data if function_mode == "TEST": return self.bt.buffer_data if function_mode == "SIMULATOR": return self.bs.buffer_data display_text_data = Instrument.setting( ":DISP:USER:TEXT '%s'", """Set control text to be displayed(24 characters).""" ) function_mode = Instrument.control( ":ENTR:FUNC?", ":ENTR:FUNC %s", """ Control function mode to use. Valid values are "POWER", "TEST" and "SIMULATOR". """, validator=strict_discrete_set, values=["POWER", "TEST", "SIMULATOR"], ) buffer_points = Instrument.control( ":TRAC:POIN?", ":TRAC:POIN %d", """Control the maximum number of buffer points to store.""", validator=truncated_range, values=[2, 2500], cast=int, ) summary_event = Instrument.measurement( ":STAT:OPER:INST:ISUM:COND?", """Get summary event register.""", get_process=lambda x: Keithley2281SOperationEventRegister(int(x)), ) measurement_event = Instrument.measurement( ":STAT:MEAS:INST:ISUM:COND?", """Get measurement event register.""", get_process=lambda x: Keithley2281SMeasurementEventRegister(int(x)), ) line_frequency = Instrument.measurement( ":SYST:LFR?", """Get line frequency.""", cast=int, ) @property def measurement_ongoing(self) -> bool: """Get measurement status.""" return Keithley2281SOperationEventRegister.MEASUREMENT in self.summary_event @property def reading_available(self) -> bool: """Get availability of a reading.""" return Keithley2281SMeasurementEventRegister.READING_AVAILABLE in self.measurement_event def characterize( self, lower_voltage: float, upper_voltage: float, charge_current: float, memory_slot: int, model_voltage_offset: float = 0.05, charge_delay: float = 0, ): """ Convenience function for testing a battery and saving its model to the internal memory. The device can only discharge the battery at a fixed 1A! If this current is too high, a series resistor has to be used during discharge to limit the current! If the battery is discharged below the lower limit, it will be charged with a 10th of the set charge current till it reaches the lower limit, then the battery profile will be characterized. The function will block until the end of the measurement! :param lower_voltage: discharge end voltage, set this slightly lower (~0.05V) than in normal operation :type lower_voltage: float :param upper_voltage: charge end voltage, set this slightly higher (~0.05V) than in normal operation :type upper_voltage: float :param charge_current: maximum charge current. A 1/100th is used as (dis-)charge end current. :type charge_current: float :param memory_slot: Internal memory slot to save the model to :type memory_slot: int :param model_voltage_offset: Voltage offset for the generated model upper and lower limits. These have to be in the range of the actual measured values, i.e. in between the hard limits of the measurement. Defaults to 0.05 :type model_voltage_offset: float, optional :param charge_delay: Seconds to wait between discharging and charging. Actual time is higher since the device has some internal delay on reporting end of a test. Defaults to 0. :type charge_delay: float, optional """ # Reset device to known state self.reset() self.function_mode = "TEST" # Set discharging conditions and start discharging self.bt.charge_voltage_setpoint = lower_voltage self.bt.charge_current_limit = charge_current / 10 self.bt.termination_current = charge_current / 100 self.bt.output_enabled = True self.display_text_data = "Measurement Ongoing! Discharging..." while self.measurement_ongoing: time.sleep(1) # Discharging finished, wait some time if set time.sleep(charge_delay) # Set charging conditions and start charging self.bt.charge_voltage_limit = upper_voltage self.bt.charge_current_limit = charge_current self.bt.termination_current = charge_current / 100 self.bt.test_control = "START" self.display_text_data = "Measurement Ongoing! Charging..." while self.measurement_ongoing: time.sleep(1) # Charging finished, generate and save model self.bt.set_battery_model_range( lower_voltage+model_voltage_offset, upper_voltage-model_voltage_offset ) self.bt.save_model_internal = memory_slot self.display_text_data = "Measurement Finished!" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2306.py0000644000175100017510000005671715203313266024225 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging from pymeasure.instruments import Instrument, Channel, SCPIUnknownMixin from pymeasure.instruments.validators import truncated_range, strict_discrete_set log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) class Keithley2306Channel(Channel): """ Implementation of a Keithley 2306 channel. """ enabled = Channel.control( ":OUTPUT{ch}:STAT?", ":OUTPUT{ch}:STAT %d", """Control (boolean) whether the output is enabled, takes values True or False. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) bandwidth = Channel.control( ":OUTPUT{ch}:BAND?", ":OUTPUT{ch}:BAND %s", """Control (string) the output bandwidth when the output is enabled and the current range is set to 5 A. Takes values 'HIGH' or 'LOW'. If the output is disabled or the current range is set to 5 mA the bandwidth is 'LOW'. """, validator=strict_discrete_set, values={'low': 'LOW', 'high': 'HIGH'}, map_values=True, ) sense_mode = Channel.control( ":SENS{ch}:FUNC?", ":SENS{ch}:FUNC \"%s\"", """Control (string) the channel sense mode, which can take the values 'voltage', 'current', 'dvm', 'pulse_current', or 'long_integration'. """, validator=strict_discrete_set, values={'voltage': 'VOLT', 'current': 'CURR', 'dvm': 'DVM', 'pulse_current': 'PCUR', 'long_integration': 'LINT'}, map_values=True, get_process=lambda v: v.replace('"', ''), ) nplc = Channel.control( ":SENS{ch}:NPLC?", ":SENS{ch}:NPLC %g", """Control (floating) the number of power line cycles (NPLC) for voltage, current, and DVM measurements. Takes values from 0.01 to 10. """, validator=truncated_range, values=[0.01, 10], ) average_count = Channel.control( ":SENS{ch}:AVER?", ":SENS{ch}:AVER %d", """Control (integer) the average count for voltage, current, and DVM measurements. Takes values from 1 to 10. """, validator=truncated_range, values=[1, 10], ) current_range = Channel.control( ":SENS{ch}:CURR:RANG?", ":SENS{ch}:CURR:RANG %g", """Control (floating) the current range which takes values of 5 mA and 5 A (or 500 mA and 5 A for the 2306-PJ).""", validator=strict_discrete_set, values=[0.005, 0.5, 5], ) current_range_auto = Channel.control( ":SENS{ch}:CURR:RANG:AUTO?", ":SENS{ch}:CURR:RANG:AUTO %d", """Control (boolean) whether current range is in auto mode. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_average_count = Channel.control( ":SENS{ch}:PCUR:AVER?", ":SENS{ch}:PCUR:AVER %d", """Control (integer) the average count for pulse current measurements. Takes values from 1 to either 100 if pulse_current_measure_enabled is set to True, 5000 otherwise. """, validator=truncated_range, values=[1, 5000], ) pulse_current_measure_enabled = Channel.control( ":SENS{ch}:PCUR:SYNC?", ":SENS{ch}:PCUR:SYNC %d", """Control (boolean) whether pulse current measurements are enabled (True) or whether the channel is in digitization mode (False). """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_trigger_delay = Channel.control( ":SENS{ch}:PCUR:SYNC:DEL?", ":SENS{ch}:PCUR:SYNC:DEL %g", """Control (floating) the pulse current trigger delay in seconds. Takes values from 0 to either 0.1 if pulse_current_measure_enabled is set to True, 5 otherwise.""", validator=truncated_range, values=[0, 5], ) pulse_current_trigger_level = Channel.control( ":SENS{ch}:PCUR:SYNC:TLEV?", ":SENS{ch}:PCUR:SYNC:TLEV %g", """Control (floating) the pulse current trigger level in amps. Takes values between 0 and 5.""", validator=truncated_range, values=[0, 5], ) pulse_current_mode = Channel.control( ":SENS{ch}:PCUR:MODE?", ":SENS{ch}:PCUR:MODE %s", """Control (string) the pulse current measurement mode, which can take the values 'high', 'low', or 'average'. """, validator=strict_discrete_set, values={'high': 'HIGH', 'low': 'LOW', 'average': 'AVER'}, map_values=True, ) def pulse_current_time_auto(self): """Arranges for the instrument to control integration times. """ self.write(":SENS{ch}:PCUR:TIME:AUTO") pulse_current_time_high = Channel.control( ":SENS{ch}:PCUR:TIME:HIGH?", ":SENS{ch}:PCUR:TIME:HIGH %g", """Control (floating) the integration time (in seconds) for high pulse measurements. Takes on values between 33.33333e-06 and 0.8333. """, validator=truncated_range, values=[33.33333e-06, 0.8333], ) pulse_current_time_low = Channel.control( ":SENS{ch}:PCUR:TIME:LOW?", ":SENS{ch}:PCUR:TIME:LOW %g", """Control (floating) the integration time (in seconds) for low pulse measurements. Takes on values between 33.33333e-06 and 0.8333. """, validator=truncated_range, values=[33.33333e-06, 0.8333], ) pulse_current_time_average = Channel.control( ":SENS{ch}:PCUR:TIME:AVER?", ":SENS{ch}:PCUR:TIME:AVER %g", """Control (floating) the integration time (in seconds) for average pulse measurements. Takes on values between 33.33333e-06 and 0.8333. """, validator=truncated_range, values=[33.33333e-06, 0.8333], ) pulse_current_time_digitize = Channel.control( ":SENS{ch}:PCUR:TIME:DIG?", ":SENS{ch}:PCUR:TIME:DIG %g", """Control (floating) the integration time (in seconds) for digitizing or burst pulse measurements. Takes on values between 33.33333e-06 and 0.8333. """, validator=truncated_range, values=[33.33333e-06, 0.8333], ) pulse_current_fast_enabled = Channel.control( ":SENS{ch}:PCUR:FAST?", ":SENS{ch}:PCUR:FAST %d", """Control (boolean) whether pulse current fast readings are enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_search_enabled = Channel.control( ":SENS{ch}:PCUR:SEAR?", ":SENS{ch}:PCUR:SEAR %d", """Control (boolean) whether pulse current search is enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_detect_enabled = Channel.control( ":SENS{ch}:PCUR:DET?", ":SENS{ch}:PCUR:DET %d", """Control (boolean) whether pulse current detection mode is enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_timeout = Channel.control( ":SENS{ch}:PCUR:TOUT?", ":SENS{ch}:PCUR:TOUT %g", """Control (floating) the pulse current timeout in seconds, which takes on values between 0.005 and 32. """, validator=truncated_range, values=[0.005, 32], ) long_integration_trigger_edge = Channel.control( ":SENS{ch}:LINT:TEDG?", ":SENS{ch}:LINT:TEDG %s", """Control (string) the long integration trigger edge, which can take the values 'rising', 'falling', or 'neither'. """, validator=strict_discrete_set, values={'rising': 'RISING', 'falling': 'FALLING', 'neither': 'NEITHER'}, map_values=True, ) long_integration_time = Channel.control( ":SENS{ch}:LINT:TIME?", ":SENS{ch}:LINT:TIME %g", """Control (floating) the long integration time in seconds, which takes on values in the range of 0.850 for 60 Hz and 0.840 for 50 Hz up to 60. """, validator=truncated_range, values=[0.840, 60], ) def long_integration_time_auto(self): """Arranges for the instrument to control integration times. """ self.write(":SENS{ch}:LINT:TIME:AUTO") long_integration_trigger_level = Channel.control( ":SENS{ch}:LINT:TLEV?", ":SENS{ch}:LINT:TLEV %g", """Control (floating) the long integration trigger level in amps, which takes values between 0 and 5. """, validator=truncated_range, values=[0, 5], ) long_integration_timeout = Channel.control( ":SENS{ch}:LINT:TOUT?", ":SENS{ch}:LINT:TOUT %g", """Control (floating) the long integration timeout in seconds, which takes values between 1 and 63. """, validator=truncated_range, values=[1, 63], ) long_integration_fast_enabled = Channel.control( ":SENS{ch}:LINT:FAST?", ":SENS{ch}:LINT:FAST %d", """Control (boolean) whether long integration fast readings are enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) long_integration_search_enabled = Channel.control( ":SENS{ch}:LINT:SEAR?", ":SENS{ch}:LINT:SEAR %d", """Control (boolean) whether long integration search is enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) long_integration_detect_enabled = Channel.control( ":SENS{ch}:LINT:DET?", ":SENS{ch}:LINT:DET %d", """Control (boolean) whether long integration detection mode is enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) source_voltage = Channel.control( ":SOUR{ch}:VOLT?", ":SOUR{ch}:VOLT %g", """Control (floating) the source voltage in volts, which takes values between 0 and 15. """, validator=truncated_range, values=[0, 15], ) source_voltage_protection = Channel.control( ":SOUR{ch}:VOLT:PROT?", ":SOUR{ch}:VOLT:PROT %g", """Control (floating) the source voltage protection offset in volts, which takes values between 0 and 8. """, validator=truncated_range, values=[0, 8], ) source_voltage_protection_enabled = Channel.measurement( ":SOUR{ch}:VOLT:PROT:STAT?", """Get (boolean) the source voltage protection state. If this property is True, the source has been shut off in accordance with the source voltage protection settings. If this property is False, the source has not been shut off due to voltage protection. """, cast=bool ) source_voltage_protection_clamp_enabled = Channel.control( ":SOUR{ch}:VOLT:PROT:CLAM?", ":SOUR{ch}:VOLT:PROT:CLAM %d", """Control (boolean) whether source voltage protection clamp is enabled. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) source_current_limit = Channel.control( ":SOUR{ch}:CURR?", ":SOUR{ch}:CURR %g", """Control (floating) the source current limit in amps, which takes values between 0.006 and 5. """, validator=truncated_range, values=[0.006, 5], ) source_current_limit_type = Channel.control( ":SOUR{ch}:CURR:TYPE?", ":SOUR{ch}:CURR:TYPE %s", """Control (string) source current limit type, which can take the values 'limit' or 'trip'. """, validator=strict_discrete_set, values={'limit': 'LIM', 'trip': 'TRIP'}, map_values=True, ) source_current_limit_enabled = Channel.measurement( ":SOUR{ch}:CURR:STAT?", """Get (boolean) the source current limit state. If this property is True, the source is in either in current limit mode, or has tripped (shut off), based on the `source_current_limit_type` setting. If this property is False, the source is not being limited and has not been tripped. """, cast=bool ) last_reading = Channel.measurement( ":FETCH{ch}?", """Get (floating) the last reading. """ ) last_readings = Channel.measurement( ":FETCH{ch}:ARR?", """Get the last readings. """, get_process=lambda v: [v], ) reading = Channel.measurement( ":READ{ch}?", """Get (floating) a reading in accordance with sense_mode. """ ) readings = Channel.measurement( ":READ{ch}:ARR?", """Get (floating) readings in accordance with sense_mode. """, get_process=lambda v: v if isinstance(v, list) else [v] ) measured_voltage = Channel.measurement( ":MEAS{ch}:VOLT?", """Get (floating) a voltage reading. """ ) measured_voltages = Channel.measurement( ":MEAS{ch}:ARR:VOLT?", """Get (floating) voltage readings. """, get_process=lambda v: [v], ) measured_current = Channel.measurement( ":MEAS{ch}:CURR?", """Get (floating) a current reading. """ ) measured_currents = Channel.measurement( ":MEAS{ch}:ARR:CURR?", """Get (floating) current readings. """, get_process=lambda v: [v], ) dvm_voltage = Channel.measurement( ":MEAS{ch}:DVM?", """Get (floating) a DVM voltage reading. """ ) dvm_voltages = Channel.measurement( ":MEAS{ch}:ARR:DVM?", """Get (floating) DVM voltage readings. """, get_process=lambda v: [v], ) pulse_current = Channel.measurement( ":MEAS{ch}:PCUR?", """Get (floating) a pulse current reading. """ ) pulse_currents = Channel.measurement( ":MEAS{ch}:ARR:PCUR?", """Get (floating) pulse current readings. """, get_process=lambda v: [v], ) long_integration_current = Channel.measurement( ":MEAS{ch}:LINT?", """Get (floating) a long integration current reading. """ ) long_integration_currents = Channel.measurement( ":MEAS{ch}:ARR:LINT?", """Get the current readings after a triggering a long integrateion. """, get_process=lambda v: [v], ) class BatteryChannel(Keithley2306Channel): """ Implementation of a Keithley 2306 battery channel. """ impedance = Keithley2306Channel.control( ":OUTPUT{ch}:IMP?", ":OUTPUT{ch}:IMP %g", """Control (floating) the output impedance in ohms. Takes values from 0 to 1, in 10 milliohm steps.""", validator=truncated_range, values=[0, 1], ) pulse_current_step_enabled = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP?", ":SENS{ch}:PCUR:STEP %d", """Control (boolean) whether a series of pulse current step measurements is enabled.""", validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) pulse_current_step_up_count = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:UP?", ":SENS{ch}:PCUR:STEP:UP %d", """Control (integer) the number of up steps. Takes values from 0 to 20 (max is both up and down combined). """, validator=truncated_range, values=[0, 20], ) pulse_current_step_down_count = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:DOWN?", ":SENS{ch}:PCUR:STEP:DOWN %d", """Control (integer) the number of down steps. Takes values from 0 to 20 (max is both up and down combined). """, validator=truncated_range, values=[0, 20], ) pulse_current_step_time = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:TIME?", ":SENS{ch}:PCUR:STEP:TIME %g", """Control (floating) the integration time for up plus down steps in seconds. Takes values from 33.33333e-06 to 100e-3. """, validator=truncated_range, values=[33.33333e-06, 100e-3], ) pulse_current_step_timeout = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:TOUT?", ":SENS{ch}:PCUR:STEP:TOUT %g", """Control (floating) the integration timeout for pulse current steps in seconds (for all but the first step). Takes values from 2e-3 to 200e-3. """, validator=truncated_range, values=[2e-3, 200e-3], ) pulse_current_step_timeout_initial = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:TOUT:INIT?", ":SENS{ch}:PCUR:STEP:TOUT:INIT %g", """Control (floating) the integration timeout for the initial pulse current step in seconds. Takes values from 10e-3 to 60. """, validator=truncated_range, values=[10e-3, 60], ) pulse_current_step_delay = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:DEL?", ":SENS{ch}:PCUR:STEP:DEL %g", """Control (floating) the pulse current step delay in seconds. Takes values from 0 to 100e-3 in 10e-6 increments. """, validator=truncated_range, values=[0, 100e-3], ) pulse_current_step_range = Keithley2306Channel.control( ":SENS{ch}:PCUR:STEP:RANG?", ":SENS{ch}:PCUR:STEP:RANG %g", """Control (floating) the pulse current step trigger level range in amps. Takes values of 100e-3, 1, or 5. """, validator=strict_discrete_set, values=[100e-3, 1, 5], ) pulse_current_trigger_level_range = Keithley2306Channel.control( ":SENS{ch}:PCUR:SYNC:TLEV:RANG?", ":SENS{ch}:PCUR:SYNC:TLEV:RANG %g", """Control (floating) the pulse current trigger level range in amps. Takes values of 100e-3, 1, or 5. """, validator=strict_discrete_set, values=[100e-3, 1, 5], ) long_integration_trigger_level_range = Keithley2306Channel.control( ":SENS{ch}:LINT:TLEV:RANG?", ":SENS{ch}:LINT:TLEV:RANG %g", """Control (floating) the long integration trigger level range in amps. Takes values of 100e-3, 1, or 5. """, validator=strict_discrete_set, values=[100e-3, 1, 5], ) def pulse_current_step(self, step_number): """Create a new current step point for this instrument. :param: step_number: int: the number of the step to be created :type: :class:`.Step` """ return Step(self.parent, step_number) class Step(Channel): """ Implementation of a Keithley 2306 step. """ placeholder = 'step' trigger_level = Channel.control( ":SENS:PCUR:STEP:TLEV{step}?", ":SENS:PCUR:STEP:TLEV{step} %g", """Control (floating) the pulse current step trigger level range in amps. Takes values from 0 up to the range set via pulse_current_step_range.""", validator=truncated_range, values=[0, 5], ) def __init__(self, instrument, number, **kwargs): super().__init__(instrument, number, **kwargs) class Relay(Channel): """ Implementation of a Keithley 2306 relay. """ closed = Channel.control( ":OUTP:REL{ch}?", ":OUTP:REL{ch} %s", """Control (boolean) whether the relay is closed (True) or open (False). """, validator=strict_discrete_set, values={True: 'ONE', False: 'ZERO'}, map_values=True ) class Keithley2306(SCPIUnknownMixin, Instrument): """ Represents the Keithley 2306 Dual Channel Battery/Charger Simulator. """ def __init__(self, adapter, name="Keithley 2306", **kwargs): super().__init__( adapter, name, **kwargs ) self.ch1 = BatteryChannel(self, 1) self.ch2 = Keithley2306Channel(self, 2) self.relay1 = Relay(self, 1) self.relay2 = Relay(self, 2) self.relay3 = Relay(self, 3) self.relay4 = Relay(self, 4) display_enabled = Instrument.control( ":DISP:ENAB?", ":DISP:ENAB %d", """Control (boolean) whether the display is enabled, takes values True or False. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True ) display_brightness = Instrument.control( ":DISP:BRIG?", ":DISP:BRIG %g", """Control (floating) the display brightness, takes values beteween 0.0 and 1.0. A blank display is 0.0, 1/4 brightness is for values less or equal to 0.25, otherwise 1/2 brightness for values less than or equal to 0.5, otherwise 3/4 brightness for values less than or equal to 0.75, otherwise full brightness. """, validator=truncated_range, values=[0, 1], ) display_channel = Instrument.control( ":DISP:CHAN?", ":DISP:CHAN %d", """Control (integer) the display channel, takes values 1 or 2. """, validator=strict_discrete_set, values=[1, 2], ) display_text_data = Instrument.control( ":DISP:TEXT:DATA?", ":DISP:TEXT:DATA \"%s\"", """Control text to be displayed, takes strings up to 32 characters. """, get_process=lambda v: v.replace('"', '') ) display_text_enabled = Instrument.control( ":DISP:TEXT:STAT?", ":DISP:TEXT:STAT %d", """Control (boolean) whether display text is enabled, takes values True or False. """, validator=strict_discrete_set, values={True: 1, False: 0}, map_values=True, ) both_channels_enabled = Instrument.setting( ":BOTHOUT%s", """Set whether both channel outputs are enabled, takes values of True or False. """, validator=strict_discrete_set, values={True: "ON", False: "OFF"}, map_values=True, ) def ch(self, channel_number): """Get a channel from this instrument. :param: channel_number: int: the number of the channel to be selected :type: :class:`.Keithley2306Channel` """ if channel_number == 1: return self.ch1 elif channel_number == 2: return self.ch2 else: raise ValueError("Invalid channel number. Must be 1 or 2.") def relay(self, relay_number): """Get a relay channel from this instrument. :param: relay_number: int: the number of the relay to be selected :type: :class:`~Relay` """ if relay_number == 1: return self.relay1 elif relay_number == 2: return self.relay2 elif relay_number == 3: return self.relay3 elif relay_number == 4: return self.relay4 else: raise ValueError("Invalid relay number. Must be 1, 2, 3, or 4") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1779275446.0 pymeasure-0.16.0/pymeasure/instruments/keithley/keithley2400.py0000644000175100017510000013241515203313266024206 0ustar00runnerrunner# # This file is part of the PyMeasure package. # # Copyright (c) 2013-2026 PyMeasure Developers # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import logging import time from warnings import warn import numpy as np from pymeasure.instruments import Instrument, SCPIMixin from pymeasure.errors import RangeException from pymeasure.instruments.validators import ( strict_range, strict_discrete_range, strict_discrete_set, ) from .buffer import KeithleyBuffer log = logging.getLogger(__name__) log.addHandler(logging.NullHandler()) def _deprecate_process(msg): return lambda v: (warn(msg, FutureWarning), v)[1] class Keithley2400(KeithleyBuffer, SCPIMixin, Instrument): """Represent the Keithley 2400 SourceMeter and provide a high-level interface for interacting with the instrument. .. code-block:: python smu = Keithley2400("GPIB::1") smu.reset() # Resets the instrument smu.source_mode = "current" # Sets up to source current smu.source_enabled = True # Enables the source output smu.ramp_to_current(5e-3) # Ramps the current to 5 mA print(smu.voltage) # Prints the voltage in Volts smu.reset() # Resets the instrument """ def __init__(self, adapter, name="Keithley 2400 SourceMeter", **kwargs): super().__init__(adapter, name, **kwargs) self.reset_data_format() def reset_data_format(self): """Reset the data format to the format expected by :class:`Keithley2400`. The expected data format is [, , ,

/d>&es :##lqL7*&7%鰸M-NeMB6ȵig.S-$ۗe@AeD(*Yr٭-iby hsyV|a4M#Y8{dogFN{0 9c.sC39s!>yM᲏ZF?n3# 7Acxc9-lcet#Y8c#c=# @?=NcA2"C0;.DTdEpX DF6y0%8?D hQY <AHY2f_9&dfyBă4lI<\<%^?H><Ķ-iqG"(# M@D#X@(pXSPY"&H.&ql4A28C#VFLeEd^\6dHPd43e Z&z'Fm3@ BXfBL@TeDG*,7<@%`l6@T*TV#؅ZX)Dt؅f( ~*,t;l!4K4 )U B _J|K,BFP”(AiZՑ&)]v IqBs'__J,(E *V7BG,{UA *0ͿܚBljb{7D)<]v^%sHPD|ßnCB=*oM[^҃5@ELG>)+A0<$~E`GfY~`"[ăPsgWğ5}Fԁ4p@XhEK4=-ƥ ur2xE:WBP:@jL$6(AX4"AlX)ĘjFHCLlmULC:8DQ:MM8 n :.N.I.^.Ul6\F| 9.9y趄.붮.쒮鲄.J.A[Qi.fno4onnnndNcmFaEt - o@norJoRb@Mɭ"oKL&'o,#?G+0W0w'opcWpK͒EaJ Jl07 3p03 kp  L@/  0,1 {ppJH61'08qqCq pgSJx1*D1 WN4M>Cև";/"5|\( )RKT(]2&O2Kl2'w'&O)2A2* K$&&߱;3CK3S3ϱ[3)nJCD2*-2#c.$C1\RI3c3k33s44s5s,הR3s0'Pj!C7ӖooEoFF[EkoGc4GL&N(o\v2K4LǴLKM4NL4OôOKPO5O1NBD33K |@U_@\5!XVBWUgX5Y!5ZYuZXcZuZ[uUV۵K5_g5X{5W6`]a^5[/b#v^@ǎd 55TO5PtgoHth[h{Ginj6d˲KtM\D50sxvJ6GFǁn woowpviJXVet@;dtgEiUk7xS7sDyxzw{+\{|qzϷ}\|߷~~xַk87'8K7l.ăOxH8E 6ÿ5 6L Zt\54hX<6* 9]"6@P` W\"XH+5X:$sk_nH?Z1`j5|ÊGw,|_CKfC+˔ :4DR&-5CZxoL5`9E47L1H@P0C'PCN)54-CĞ9(9+D<@XC\C\g 0L28ҋ"Z*Ê!W<@!̮3{ b%R쁱P4oW'L3 /HC6p,`2$s'ʚ(@>< F@7X@en. 5859S]@,xx 2(J0@'@A&TaC!F8bE1f 5ia3(falLN0NcK/ `Æ F,XFa?:hQG&UiӢ0F:jUWF5+Wayq%&0V /]nRk٬wջW*6 `S,OǿFhKYU Β+Dkq,tiӧQVZj*x/0ذֿNѯ3m+xMd*e`? zwG-N|ݰ{LueΗ?Kl [ɒ'Zpq3l9[H]l 1l 2Tȷ:HZj!F\>PŻ/& 02Yhy@#eB,Ht9l+H@%%Ʌ%' S߮3L3/\ hKUcS9;S=: 42-CEEmG!TI)K!ETMY#OA UQI-POMMUUYmWBYi[q=*r Va-،du8LgViMM֥!xheo W\ m hwW޻ʵjTǙv X .8z "j &b/)⋇EzPaBa ZQNT'⸠FJqYYdY" ((fL"bYZS9"{7byN[~z!jQ ZIt>{ /.hD1x<9skd ̰vta)ugq].aMpP A. m]驏qtAF@q si=|Zoa_ Pg'u) `3Ȫ,kq.B!~h!\0 d8K]|+%4 ?@܋^! AyAAO$D6PD!QI @ 5NGLb(o?!@^AD16|-vP-<Ă EAHQe\4!Q+ ^x@ bA D!` qlr!4%^{]@2N  9yR9 )LaRm `0L0(w#:.P0Nq*^Bא&B;D@8`^osA7 e1 ftFЪW  jϝ ߔ4m#)B@~RCo`xE*HGם#?e l<`*Δbw)YNbAM FFBBQ ggv\x,SKAr@Gw8k ;fJՌrO`phMZC9;Ϊdv`): tAA1_R¯rDy"/BLê[K;G@ũp}y6&3Mr;VE5;:$ظx޴A m8۷웧=$IH""HBb9J76^^c;0)a^~l~/)^l]ɐpV;C`F6㺜k#b.^*cPF. dOs ㅬ@' ӳ^:#ĭ֣%s뤆?Z#F/@,plrƘXtj2R/u(?E^b[!1lߐYf&kH.! Xd  " & | , )m` ڃ7 hQ~a, a\ d+- " 鈈 8 .#* (p*q_'D)fdXA/ s50W(*B&¾j P"T/Áll  Xs9#5@ 46 a#BX NʐC  hF>B05 6_zj)r!0+vI da!zg4#ukcpzTRt> 3I)¾tX5Buw 2T'uK%4L sS.+$mr$8 HB $̠Y UWP4!`Ch" a@Cua %'Qg^^^[ L-?  `7a1[N+]$oj5Kl횒_BKlb*˂ "6:?UFbkcv N+ U"ZuhdϱS-ee?c(ʈ` +vx~hBhei*$fjso5f0m;5l_G 0wn`aW^`[/AK`!!<Ԗ4f`eH jEEkˆZbHzbi0O RѺE^YpwrWGS@Cު `V%%A7&AhCF̈Qr5)s.Ɯ( 07#ȑzF&/X6y"¨; @4s!D!xM# bnw f k,^D2f !!Ѧja!U}df1ę?qzy@I#Lbʎ X\O|qGY<=Go;[Ƈ۰T[KmDKR$k[%:J}-~8*5^56A>ex.TQ5gb<>a>e~imq>u~y}>^d>~陾>~ꩾ>~빾>~^Sdmu2z!>C>8>a>K?f)\LjݘF>"I]x5.u@(V%`D*"HHoWIJap!AJ!A"I #". a=daq4 AB!RNl ` 8_,.b. 2X  ẃ:* "N7v"$8… :|1ĉ )|dUB;z2ȑ$K<2ʕ,[| 3̙4k ILaS5-  Y pB)tDY"A< bGy0Blۺ} 7ܹtڽ7DkzhAN::Luz[0P؉!O{Xa^B١AI,5Y*k۾;ݼ{=!֎(1#X·( _\CM:(,%9)Qxۻ?#FL&khAePAHgvP|Gs|AUpB8'|P"BT@7'4A%Me p 54L0 y󇖳20pqZXZ/g.+lN4/,ܒ (0Z C$,s3o2K0d/ 1+ S1ӘuR *]DݶY 2^`&-n[/k.| ڂ[*  ~.d]R*˼n[V_Re\*ςKk2-J5/brI \Rź Rb75Jv{w׊/8Ehx6Rߵ`-2-i*1bAtzŋ2"Ϯx/5tմLL_ج.%{@_86N}Rc?_S[l-`Q?R>v4쇃<2o3Բ^Mt$!S4b`/A,/̍#Aa$aOq^}zq:4lVp;Ek~$*7D(Jq'i",jVܢ0fb,ψF"i61mQr<񎌓FqX-,dD*"h$8E ِ3Lj2'F!dDFl%ʬIh 22bl$!s/_L\3K\:(r3g*KNA4zin4DOS2`M8)T,5x/t2a72\A Zإ x"N=<-T@&hkY@σ(@ |h!ˈB $eKb8pBP h%8C>)ub~0$f) "TefQtj>@+ZHOYt%Ԃ:$eO8ué nxC!Zɍh ;"@YHiT+= &CLQNE# L.WB "0` CJ'\30NH]ې)dR$"NFdB0qڨ352(6Hx50$ъQmB bcb,p&]%ށ,)6Běƀ1L'BJavl.ÒO΢i,|#%|VPHh 0]'p,a@Xo.4Z@bt^Q?AZF` Q1d kd|/@X#N@W! BY CEqE}9tG*^Dbb?,l-W.=Yj Zʖ^BldCCEq0t+EPeڵQ } o^\.]ôY6+@3-zX!`-FoUi+K["0y[ ~F/ lqE>8 [!89vӁguCJ1/ @T`h@l!C7H,xm ޤS!,["R|qP;.S:%+O얨+&QA^A҉ѡFuC񅧉*.OkpC?sPޠ94rDJX‡1oKD^Yؽ ݯ !c?"yC&G: oH }t>g:g#Ț} 8~'~ }% ꧀ X0J҂1a ȁ(q q} Qv|߷#}h7h #x4pxއ58 8(7@}? }%W7SȆ(]J   '] }؆h2{P ҅K)*E xh>c=dsFK@p |@|K`| ȌȌ  +,uKF@ ` baE/`), ~k uLQi  NYU%F NKNppiY}#АHIIq S + [Rp}G(N |ڨaTo JY 8 p%AR; G g|PPy Ys k tz)S a 3ij V c):8g"tIKXy*  P*1z Q  b)b0 NQkP afm J`vAIY }*鉋1ᙣASed w9E0@ u P ܒA_a6KS1$@ۙɋ`|MnEPyiUy  ![!:N &FExI 0R W 8i [xH}[SpIwh} e K Jj*2y >h~T ! Sz xq:NpۀH@h?>ʖ |w +@a}j8 %#K%[ ,{:6 >p ¹ z  Ѵ: Q{#0*) A˴L_&k& ȱ Q*wHgWP^+;<±#e+ A'KڶHhJxw}ڹ|Z"0Y{ y{ +k[G˯;(a,*lș2Qż߫E׹'}˴R1{0{ A`U  LEK?z2+wRa ,“bˆ h|C PHx'3:1F!, H*\ȰÇ#JHŋ3jȱǏIIɓ(S\ɲ%S.cʜI͛8sɳϟ@d$ѣH*]ʴӧPv%JիXjʵׯ]U} ٳhӪ]˶ێUC D( ˷߿7{È+^̸q`Qښ,˘3k̹3˸CMCBͺװc+۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ{ݳjOYyϿ,g2+JF(!p1BK2 R /Td@$8('P-"@Q,H4C8P1"_CP@!.( 91-"`9.т@`D$@,2,N%1(;I矀Jd)mb , u-$#覜r@C9*P4AJ\D t뮼 L~,N S̱@~'Ad2b̊! ,袌@Xh̓R`.*йD@\1 S@6@ #˚ɛ/Cؒ bo.4 % \w $0#*L9e1ZB(kC4w,|? AdkPi)PJe-k@,?8TW蚒-L}$-$F8u[TJݭ#T% ^ZPFo/\  q$ > u!@Fa@hz( Mx Q:Xt '&$4#; @kds!AXQMT+$χ`@b  ":I4it dHk ^  O}1D9DrXhTR%L%D5\a  dC,ɗ$< < p@<1DUXTA @Ts:N0L M1@*@Ć4qHq ig8pqF8v/ApQBHDXrEk!DOp'*H/v6py -r2w}nt;V׸=Crnv;^冗mz &ν4|q>x`vnIUMn 9tjA˶ ֱ*K7[R}s_>!pCj[ة&*TFA-&(D0g1qӸ>1 !AFc&,D1\cPSog_Nr ߙtͧVR /2*vV 9Ktd\F }e?KTv4!eE45-Yfi1i)A z=teM]Z[ŵv]-^]5z^b!._mX {Ϯ{Z[ɱn"-p>7ufC-[vw׽otw oz-O:ԣ6'Nq8_86{܃9&8S|.yY>7?y_N9}*'̕/]F|+NpqշB] H DcObƁ@ [瞖rt{{B@ZOx; N A[&=J{61"O}Iq\xB ŲbDc1!z"E|d2s k[?!Q-hq _ߘ R^(O?%`\qIϿ8X$tMgqo h g04rq,VxÁD ءfF*p =41X1:(6PE!=5S-X&AI0O- &Q$'V+قUx'9P;\4{@ 3@ yaZ&AehFGI^ ^NwX pG~b40 !Ig8Q!*t`:!n3%WIB9DF&9yJNY TSYX9W\[ٕ`i_dcYhglykٖp)otsYxw|9{ٗY)٘O,;0j! d!y)0 . 7 1=1C)IŹg"ɹ)9r A1  SW1[ LY` 'y?ƒA34yfaƑq!>kd1c"J1 Ƞ!DL$^0-_@V~a0;1 0Md&1yɱ j@С YQaGI)IGɩ?\ #k_a[J~"qy{:Ĥl*! 1i $ذ S3,CShQ᧷b6j%5I!z}py3#j_m@+«)4D๓6K5ǚ@Jɐ R 4 *瑟R ,B@6A R $ 4g5k37cu /.Ex\KD05@G1%{cf 5@ ga@EK  Jp:X P 7 E3뀥)'Q (؁p (8`@rA$r )%E?SācTM( u~[@PD{50QS ) 9׸'Jx\RPRPL[ukh !1*3 \ +ѳC`4 4k)ӤkqCPP$0Pk;1cv1{i[ao=) pKۓOm\"D0q r;A ^kII+a+Q3 \8๴f1nF IL0pH˚c+ {K[@<@ Ul[S {<^q< Y0T|c a C- & nja KV ){1 Ǎɬ;'C | = 7D-\˲?kd˾Q }P،ra̅IT) AGq @!!C -:LDDD%k`q!>uz]}CDOb K{# +/=:0 u  +.ҍѾNPAl `Hr02a 5 ,.Pv&`G+2npݟt / )B.sv[ *rc* R?O !`Me}QX++m_!k8Ō ؁ ƃإ! AڮŘ5g!ۜLBnKĽɛг=&rL?p۽=7^=|=\M33S= VƎ#_Y;?5Z ˀ]lHQ 1(#o=-c\3h9=q`= ؋|3 ߍj) @qǓ0,u[Ia%b t'.X.p?z\L }k|p06qܕA dNh˦_.GcB!3D;wnq~t^yN@G1@W !q` _J3!NI 9OxN髎.nL a EKP` Q37;𴚩 q<=  NZiT' -,Q ]Sq`1Xom%b`g,RJ IpRVϕMEJ!?YT2Y?K2`x&<΅g?i@>YEs/Rlߘ;k GEGJ&}`4ӊ>^(&o/<1Y @ܖ`)O_s'0+ \ŀ qzɖʿl q=8[C/w|DL _үHW p"D3B@@ DPB >QD-^ĘQ#B~m6Y֬ ޸yɒWRpܘSN=}TPE% RM>羘p_.KZZlڵm8n޽}>;vpōGp͝?-W+2]ҩs{xzݿ6}|ǟ?#I}`&d9 D0A"pt0B A xFwƟ }CGt.!(AGUHAI~1G;!$xC.XlJ1h aI+\͉mR ŒIJ&4hxa2߄6yk)s3Ł2!74PΉd|t=,)lRK !jM6=%TSSWe5iP/"Z,H'5W]gWɊ"[Ҳu!DWeͣd*֠d6[mz&LREbV Iv[ueעq  ut7_}"F %~ *U%}fYD @_< &w .Ua?^S&%Ih*֘ u)X{AU ^!(2>I^VfngQ$FV&’i]*0 ktt͎Ɇ;lrnk[n[o'l Gx p]:y?d_7`FFd&|ߧt秿~?`8@@8g4Ё*`%]c8Avp( AP( 4a U D#\a e3aB5: y8 G! C$'k01Ai:)΋D04EIZ$p (PL51-7ucG>яl l\C s3 ܆dz⎮m"4tlӢA7+<0*EADn6)s) 6! P{D*HD@-6,'D.c2:y^: Ő1[ O \'yQY oAr$bWD!RKb L60?c>.a 쟶G?~YrGX;Ph&# OxA|)p#{KbҏFo<7KmvC\jg .Ɛ4nᳮFQŽZn2 AQ%WY"22pU"Cu"W=+bjMF\rfx 4c CD|X![)WaF=ACpb!5H)+pE )AW*]+ T 2rV B| feF02f[ŸmT[ oŤ.N2<>cPNr1nZH1 Zp4H2 a#gθGqՌ ]E/^{Q FY/Al\{_GRIӐ@r,ë e*A*a"YEv1a^.YΖe ڂChF$R̙'8@L eV hwָkxC~tCB-] !~]fA)<KG6AkʘY N5_VE 끀'>l+~s"]:Ž;nrFwսnvw !3Cekoe˾ c9ht@x\D(#wyE>r'GyUAdgZ7yes?zЅ>!.7zґt7fLwzuW_TϬ@a__'uKb7{O4BjC~w/({7$3z?ȑ|p&;|yyGmH N}k"e{"@ x?O* P q, )06M|v(\G%Cx!it ~ 5{bħQ_r Yus8 #?3 aX?S0,`@{ gІ g?狈yؿH҈j‰83hpAAH dH\K ԊAP0P%1< @ $/h01P+:ÁB4Å-xQ+HxR/#CAuh‰08(vpv:4v0UlT6<SB5dĝAEx 6` 7,F9t`Ɓim]0j%ġE=ŜHńE@x}`Gv \“`FB }yDT Ȁ$HT4ċqXāPȂHXT A`2DTA(~`+T2FXɖdɗtI>x;/|r81XIĐs4::7(tO=qHAcs$};O? !ݸKu1IqDb4D4HS0U T(dӻz0\}OԂ%G_;/Rd1 ZňkVE7K?0&ꂥHQL'BmWV#҈Pm 4ԁHx-;'͍ma\FX!4 xݤ˔TX`RXZ12AՉE¨ņm$QKphC]栺$p,Hƍ w܈i؇OFɆ#u,@H %$ِC* Tmj]. ڥ=P\-X2fvىq` v!0fm0}pE )&e|b(2(⍨j[p`A dsԁ _\* c;(0S`?۔#Fp>J~c/D)5zuDzYeqlO r!ySpx۫P9@Hަ L@K[\hLfL։*`R=Ci>8C. w `gOVyfm$"N}2a0aZץZ ˆvneg Xc2e^`hi膠霆he?ixj#> M͋Wpj~$z>k̉i^ˡτ>&f1p&l6k& - h8XqV8S |X؆W!O6%/ΉXY t*Ӧmㆨliff&  c^ .7DI|bfόih불n΅Camxlo8nˆI,8o(U'юP0uF鍈-hPj wW PAw><ᵈ煠VѐU KnX%7U`J&(xloZWJM< N3q {ǒ0߈qЇl,@/xpny'yGygwy8y?䡓 t`80[!BAiG7zЅp: !yzخhb&{Jp*"}*~A͈(g7ʔ Ih P02j|(‰^. ݉*_ʿm X*0(x{Lj7;0 qi=uwfn}nSow~yB@]7oLpLWyPT -qd阎?w],h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,IR oʍ7pZY_(wDi(ҤJ +ҨRRj*֬ZrN)9o`ٰ_ײ%ٴԶrҭk.޼z8f]]~!n1Ȓ'?)ng @-͊Ο?)n5زgκojh3~k)8ʗ3o,d$K0[ D%n/ mmm++9?] `I<D5@3d)CSLAlG!$@KA f*18#5"@L[w `ApAaC53 s ^;<5*EUk=C|Ie>㣿>???S?(R< @*|  R3 V  C>&O6)l! c(Cļ Cr8`>!(D԰ 9axN|E8;-r젫^<#?ud'=`m79vd!a QWZ)H/;mCyq|dH$ D M.0" @! `0 !*SB8đUr. GgHِS?6s(b<.dd F6zKd2 d3&U$9hJG,ӑ\C,Aiy'*'>Y4qDcHP7)Ёv$H? 2gA q(FьrڨGC*t&=iJҕ9*m)Lcꚗʴ6m Moӝ%<)PӠRQԑ uN}jF թR!R*VEr*2 \u7*Fk qBŃHT+^Ui=\ ҵ%CWy}4 kTk*!ƅR}܂,bX4SYHH)kœ5`E=yjhP"y#* e PL!VGBWːn?T\ @ L4'6"۔. ( A$ozPV[Tnh6A d A@AaX-0o1!Zղ b o 2a[ UC0n8;/0 ]3V o F PX CESBWPyBPXCYA2;~p%xadf,.AB1 rb%]^_%*, X^܊ !>A YLv %H@@! S\kŘ?Зx; eŰ0, H!񩫾Zڕ 5 pc;6#Q^E. |`ZPIk|6‘p㐷.>lC 0jb'vHI6CWؑQ}Y:E-=_f nb]jM| dž&ߋ>c`@bWv:?'68<p-S_%  051-T548p * A_-dS: (+1v -5  (80; x/8,R(@"R6! -p?8!v!Aa Z(5])(8hAp3"!#DĂ00@-!O"%"  88D °5BT))(-8b".O*!-@ 0A" 2^ C 0c).6@ @ !A(Cm:]]8B,@1L:]R:@^O>€u7@6D BB8@&?AB@dpGFG҆fBQǛz-CACiñ<CJ[P_H&(` (D20U%Ah @@Hv*<EVuLLH҈uh&bCPR0*C<+ADUl AjVYDT<5lǖA$NjF錠BTC;hHVphYQyHQd6Lviǜ@kRfF+"FK,,U u)rȄӰÊlGh6Hcj&P`zChIj;#BGj.F@DPl!Q--#-?#?rj*@ 4a,i1ow14q6sĞ!]11wpvjFLrBp0Ud$ %;S7@/ 3C`IAd]-8TAPt@W@A@2vlHB2+-ZNQ4LǴLϴL_)XxqBQ?KPQ:I .DˢڴBitǂBxU{0C@7W%|5'C8nwUBC4p>v !dv0?wE< W0Bv8ؘ.;<"`z'rd['C8fd`Rj #*_L,tu{`ۏGFɈ;녲;;8DW绾{ܴaK&|ȹ:2/E#XL3>-ׄJ_>'rǻIAv\>C5p;v[>>-~>ﳾ?54~GzOV.g?-#4o8$3???ǿ??>>??@8`A&TaC!F8bE1fԸcGA9dI'QTeK/aƔ9fM7qԹgO?:hQG&UiSOF:jUWfպkW_;lYgѦUm[oƕ;n]wջo_zu%Rþ{bŦ%/":MOB{ `,"!X/y Faf6Fk>6#gotĔf Y m@QFd"n 9j$s"b)F*glIDl =Z&eP <(,NH'aThJ1%HVOt9fBc dli"!Ȕ C Z\ *E "!ؤ_)AaVVՅpU>)ȏ~!q NQ%KvT %QHUYT'X[-WkӖ.h NzhWW:!kUb\S &4'҂X N 4hA]Sv-&ߦpNs1xb0T(ޅ$nȜþqUhbv?Rfe`&fJV.i0YW!CLa&% f:HPE&MZ&dy H4 d%P=(hVY6ZpXܥYQ&k&,f^hEc$T \[z[iwHb`)&Yv bYw^Dtdlga̟Ea1 O>"v^jXqh] _7&_|%i9X-=O{Xz3ߦ]^h"0`" _X/S-r _o",XdQ_B׺ %,J-j1BB5;1^GȆe4 a"B!A^HXo'Ѕ-g PyEĚ.]i" \l+!"kŁBEqE)ux^*D7|#HEt#!IIN%1IMn'A@bD(QJ8с7֨Yf-tb `hl%cκgzҍ\P 8Ns*'h ZV )js 48 hDS@! 0Ix@Z,C)/ Q`)z p+L9i@f2&dI7@ U N-H3ujk"PC5%8iX|U(-Qa1)y&M^ 2DTx+:Wh`b @EPEXG(I)$XD6*4',kAQ@ AmSP-E2 JR>,)P-lЊ`@Yb߂(xA@CAp] $+p^#$JnAuHBmFh eㅇ dTlu&E.H5^Ԑ12e68 B|r6u5>`!z3~38G8@ {98S8 A#ws:YFQ,a"6*ːBC!>PЌQ,-X+&aASZP<$J EN+*B&Գ^N;%@A+60<MHKB& U` fĀ@'!PR\ KL78MC@Go4:2`#7BqT T I?mX2:5!$PJL*(E@aPDpn `HĔ"F8"/p#cUO* .2!Pw:$sP XpEGzaB xb@Xa+HWiAPl"ŌtAJup(G_wB )McBPٲ @PCpB#2Yl`lH6!`ciռ LjIDAt9A}<9gB C[2y͜Bwt@g;vVOΙL S I`AR:U_.GHE ydg6|@[0d0+GTqVO>¢TTa*БZ&JpOdS 1J\8!J /Tь Sm4[D@t!D1b[X2v}a#+¬,f5[YJֳ-cE b6=-iɦvll? +p<-8 q8s?1(bQ1 U5d &UJGV]-nu{b;qẕ*6ȌjH u)~߇/~,`90\` 0:nLa Kxp+(~nWoU*3kDjI­A6ܳ o`"?F}a%"f2lb*YCr|d.'KTbG qBZy3j,fvh\Z:pnAz΂3YhYa;iپj*.CN{ӠDBMjOԤ>5AU!f5cjк u[k^׫6]jbzַ6v-k[cKjf1tmp[v-nm;nͭux!~BMnt׻wonwopUk;|'RN?& ٘7q$ ~GeX(OVP+gN0S71@Q O H + =NԩcV3b ͥi鞺؛C e A1z2|7c{qw!*Ep\ݭvv)+"Q/JM#=ncWֻgOϽwk~u1 jHt`y0~_z;D1$ i0x ᧜۹VJ?+0!VHe᪰kU{[ aD`qo:6jқŠ2B:1p qPP@(ZH@B@{Ӡ2nЭ * 0 r!{ѷG vR1 ?0@@sK &'#` Zp RU0 q2*g-qiTBi*g5`(0С\C5B{Ap4 *!$P\[ { ɷ _s؜۰q V\6/)d;/;y,BP+TQq\!BRDʻaX\hõ 2[t Mtq 60<аM5 B`p+ ܫ@`RQPH7- %=ԓ&Uar: Z>$:PSƻ0 ^"$9  `'ưa {= z*%\-ȻR v0<#ԌM}  Nfݟy _|y m@ٚ=%?`1*ɻ{S w71]{}G95 (r;* P<w 4aiX m+ ` p\qq۱L;1+@ȧ!'7(!.j4G]Կ# q` 6Z/J㯁1;B.92coA$ݳ` K>R" G;YL° J \p y P`MS Rܢ̔3^6g !һP<.푥!~ <0 kā d0qg3ʪ׀.(S%=Nh0Vˀ6U:׊U8A~ё$tP}ma7."9=Ή-@l.0"jc($#  掐%80 ־& >q3rF@R}pBXP,O $H=1 0^EGLl~iM[oŐ @W6  6J+|vkgՔ h4j3 ֐6ɥ}n/_{/o;ߗ@:5gN4_rÑ)_ k߶ t! p P 7ţ\j@9"D=ak|^J .B(-@!GA >QD-^ĘQF=~RH%MDR%J U2+m2|#nM=}(2 TRM>UTU9UV&$:]͞EVZmxݽ^  `,Ҳ} FXb!`Dt ?y=[ QMFZ꩑Y]2脅cƝ[)bK,OogHr͝?QfvZiQ=.6Ѥ͟G^}p\?51@jR ->$@ "UcCB /0C o#Q96$DOD1EtHd "%;BwG4>B]o0dI'#R(% "($L3w RfEQ(q<3O=C+ ROCE4QԂ1&́ F-14SM7ŋEŰKTSOE&]p藾!UYgVFV]w׽.Wa%ح26Yee$d6Zi r6[mk6\q=<"7]usIv߅7^{7_}W#i_&5`I&`8ai)8b'j  LdRl褸dO6) XgFfo& pgC ggy zpgd䡇&:kF;{ŬօIFVnv jXnxxIO'ygy矇>z?v7' d畚 */3~Gwx &h fX]ERb4E 5  D_Q!k*;#- Vt4L4TJ J BFAB+6$H6*x(vt`_ Cb.1 P1vPѭFj44Oאԉ${1 `QD ~pC 'ĊF,2X[_pUFTV z *sf#{ 5$@Bc79"r>q:( \ ej޻ks>>07C^ˇ6ҖA 64ܳcd'JLi1944 #J?(tP:2-{kSR@A{B,Ĉ8BĒxѩ/-$ vpw}KTőhC #@Bĸ6T^EW\ SA;T]gctӳJ 늢S~#L| Q! ƭS@PT odpGr0v4@[RHٙm9Ð@ЇG3ɁRȪiȏǷHȊ`7C vbmqGx A,Ɂxq"Ēv;l;";;ɚ[܆k<1$ D l踓;4 ŻlѾhZd[G1?ƴ)T(6m@m :~X:eEgІC;'dI   +( Y$UՆ@-6ԥQQq/k%^Uh1ѱL5j4܈~PNislk:g Wc0! ڄr2lM%d{Wfe"ՈRx Jzim }هTĉ8Ӈ m(7(  ē}HeYPJ$%XpԨM=#:YxS6r~L}OׇwmI}+ېe8e0Tl[10Qς0: ˆے@]teuxPhK Zb0 3ʇ -ܮyT1>~Y5zAP  tèh5\(BXYP'aŽx<U}^SU]_`=أŅ0؁h(0>5߁Nπƹ݆R9@Hx  r$%auNkC!^@ `i mO"FZ(H%Vb8)! # Uj%(dxM(cԨ 0%XxRO6F n:`RTyu>~2`^Zc[R)]ǝp?{LM0W 凛E xǐh%bddmMZnLe\VR#2W#цŰf䈰m8 d1xbIu IYFb_蟔M c;yH eep~}X6R q9m݊ ;stLQa UȃF 8)g#AxlyWrtF v ./U!~`20MTW@鳻?!8Bmsng7߆}Ȑjgؐ^YRJ9g;A v9&dmeXiKk[ֈmҥ_5 JWv 0F YkK5uE<ȅs JE?j2h)/.K8 xJHEx~.8ghRMF(R*ȃhA0:_GРApdcc\ m8Ɣˊ^nFTC pt q'qGpgqz? jqx(KmPҏ`oxgGHAp)) 8CX&G oD%Хl4/ V ,O58, -;x3je9ov֢0:'p?GtDg0S0Pr  Fpgm!#$PoN7 1W уlI`TIq;?n]S_ /ԪO]5زgӮm{m_g7D~ka39~C07Cy%n*qPoݺ=ӯo|}? 8 Jd^H1 J8!Zj!z!!b%x")^$"18#)X#9#=vA 9$EG*$M:ybOJ9%UZI_Wj%]zIS_9&ePg&mq9'"Y'y'w' z(&C2(JZz))CDd)&6*OYDĚjz+wJc wLҌ0%6~8#5@,By36zy5#T9TX)E2PW1QUe\L(T0@hsT#J3L$@m^$N +!F0Ql `O "@b F !@!AYs8KL iaqbXa&+Ph' 6 1R ) 1CZ#J#E !˜+%0 UY@dyf$:PC "\`9" 4B5 Hb@(U`7$#mEhZ !h,4IJj|0%p$Pʄ4#E5d &5REt,LCCm,r_0bYxԅ._|3D5g4zF<-g8#hwr,n2%E0xY(c0a cP (0`,izQ";օ8I:h  ` Z cB"K-k@C6-p2Ph!ֳ5x-53~[!xE14m,= hs>PȦJz-_ (fr{ni\1A. Tp2 ?T?2FgԀ)Y"!9mHٌA`1p5Ɩ5 |P B~u0d<pp p.FA x]~4 24p7fG,Uxs PGb`^(\ }{EOx(2+6 7p$s@)_x:cZXҏy]u"w0~?#د?C* !=࣠ND A ;@;uə x`$D n$D vIKBD?i;>S!(?LazvޅxA< 5b|C+: ohAx8ܨ- t?T4` >1t?bXCx56D 4֍cJ@ bC5A <\%&7t 5G8L6`a<s 4ldE J`bJʅYv!]xCN_ 2S@dăJ"z16KJ >`?dLKKC↩bPH*V։VdxCV W%L|XChAA.Te]z;< CL>c_<?dBt?%trf>DB>$r>sRȈ5?㜄g;P&ynpD6{}D8@vŧiCRQClBCUJ͂,Lݨ'EȤ2(V%bK LX!jDԠD$iB1ExXa%&D?N:FBjh@$/M\Ft;hB 5hKy AlQjx)Cdʥ<2(RaV(ALf̩Luϰ栊JAPV6bbyeu\lvjjCD:D:Xl%l5Hk)"<;4$e L2D ߢB3l3@tH,A'4_@#e6BӇA `8@N0C6dqtAF$ijIG`4TtJLf8^~Y-+&OE-3(U>SSGRGQGU^VE?\V5Mt5X[ 5ZY5[[5\ǵ\5]׵]5^^5_5MT5[C` vZ?8^#M+[kGb;6^CdKv]KeoTufO0?bvv]8 %iuZujEpkkeӶ\hsTmun7n6ppp5q7X7ror/U7sG5tGSO7uu_Lgv4wwD7x'xw>KLX:yt7{?|s47~yT<䤡N/˳l/87?8GO8W_8go8w88888Ǹ8׸88sV\|BKkMBPӆ&Ӑim87D8NPY9oa VGG1lF2|0;4H2X+KEODj,X$9oD(X)칺T_*(=6߇1:T8=C$@:QY`,ۅ)ZDCȨz9FBCQDDYz]FAtzCЀ=%'@ {X2QCD hh8,B2eTE'0D5;Dd40Ղ# %5;(QBA/Q5DD+-[C'DY!4S=)P@}pB#+DPB4 pe`AT& 8CIA@,)`BhEq{4Fip|B<{ˉ0AXDP$ DABA!O AK a CXC7QDǙ534'C UE3-5 oQ ْ/سh0H}x&xBuS1ݿx12/8G)/C0b%;|-|B\LR0P0H-- 8qM5741ѓLJ/(] 1"ύWGL>KD.R-B5-.?4D[EFY@80/&Tp!F0D1fԸcGA9dI'QlY*aƔ9fMm WN*z fR.OO&:jUWfպkW_2lϞaQDm[oƕ;n]^ջo_4vW`Ç'69(0ŏ!G<2 Ds玸zexqOtysϡG>zuױg׾{w?|yѧW}{n> ׿ ,IlAI )B윹P 9A QI)QYlhC g2t 1,S8Q]aPto\IB, \10c'40 TA @JaK`e:H Ћ*=I%'xHeS,F8%ξ:h3cT#%0TT)ӶxFɓ$*HSx!ưzh`bd|-T 3 Js VZ.:01!]n񦒁,O8a0iA2'ZIȗfEZ+@[ @`DpV#` X wHØZD,[ O=ƒQ"F.zqHY P(J@ E0"8y0j6 rع`#u6.Nc]+[f'[p9^Z)O3(&j閄,e]c+xiGZ +n)^tqzv[b\t^eݖf^&O*Ew]b7I['-ſVHZ _CLG ]xمZ&_ψxɩw5I:}#By!& /)drJ] @DAn t ' jt- ڂӑ/baAL- W]B &>xb ,nfsHBA#8F5!moEQu6aGczGA:0?cXd?` %@F(Y X2d.IHQ+G6D*?JLFD''YKP <1H3,AJ].t3 ` =%)lB݌I;1$#"GcͩXrY&CMys#`0<1u䝗|C6Oz !B!tZE-Ol@(=ǐfyh4 P,A*H$PȒ"KyvDꠌ T&4g@zӤDP :`F>3K>^Ĝ) ,"@@TwĤerɖ K#kBUJdA9>#+Z\)T UPrٺT+jPlIzZ PAg0pGDFU@-EdZY!F Vd6m$aB Ĥof!ٿ6D[5FImFrdJ%k  8UU#sS㚔%,`@薠^$`H>@nC4Ú̅ц6$" %Zq8+-IPKiB^D`@"≈"@|dn$EO6P1%ea@ @y2hL*W(_6!@B H"Ȭ;s$rb7HbmV.LE|ӻ]cQb4%εq}k]L5΁fn9 S: aE A$\m$xtAx2-A)anz"HǷa#sF ;pbwd086$!q<&Hwu0l<#H@涶 E[%3a`PDr)A8 $?O/o7UL0ҭv7G0zǞv$8W( !,H*\ȰÇ#JHŋ3jȱǏp 0$ȓ(S\ɲ˗/I͛8sɳϟ@ JѣH*]ʴӧPJJիXj*`KٳhӪ]˶۷pʝKݻx˷ߙ]KÈ+^̸1]R#C&(rdkQCMӨS^ͺװc˞M۸s6͓Ԩ 7ȓ+_μ~(DókνN7?z(JT(\˟OSPp($HD >F(}b-Bv|ʈT@gK+$At)Iaй[Tn" uAh ,+zP!SKH1I,&dN[@KM(zo3,$74yR+ $9#tEU@3>|NWtA0P'`?ma+wIw*d@K,P-+ɴ@qi |wAw0@,(sBA/K.(ALB!BBH [ -[\,K_:w(. 7כ_~.ҩ.B>Ah -j֟K.H3qD H8 %+b1AYpPPhCiL4 ZT0% G7RLP$+"xp.:ԱA0ψ0 HB bE}1PtyQ!A %A2B2taƔl#?dVHؒx d )!hFkq"4d@22,d'IITb $cZ8'0D:HoqBEf Bh%D/ brg *Tb"(A$1C  ؔ2K TW<Њ A ( Tnj<}`N "P~ cAbd$ڹR 1H )l PA1o%r p"BPT!F)ϖް!C#!@f D.@ 'q⇃| NB 1Ī1F: $q. \X NȂAJ'pbH 9|~ą`-H` ̰ ׁ4ueU=P.@eGJ٧ :%;bL,YykDWZA +!0LQUMXV 4P X!l;: >t 3J(Ȃ )@0<48+@b1=ᄦ* &(f._~58 <lHC؀Gq\cV H6p"$!V*d8*^X c3.,ktf6r y 15y'*+<[7*ъ6mGKr=|1V BZ5cgEʘg-JQdIBėS"PFq<^gAj.a,EcBeGV3c ϨV|Ђ L0tV&u"m슼DQo cAmAh"Mg7ؖ6Dms-hwnn)-osӻv}oyv8km ضna ÇdSZَv* Cr,Q(7f4@dH0"˹w9Ё.F9ғs0]>z"3z՗t'FNK?8Kh烰!hQ|u`G7sC[{u‡cG|vŧyg!w]WPʆX."zk37EzmݯWw={wޫ{~߽xUmk3vH|;@WSֿ}swߐ'?G}Sч?~7?~^ ?-8gQ( XX(Ȁ؀Q"h$X)'(+HwA6x T3 }u-5D0 ( SN' &ʤ40 ŀ$\H N%P օh ^.,HrtXJ5M$s8}X ,0` lx;"  PSX+:@5BBEX1 T6$.j a8 )C\b,G C(HHP<'8 4S҈g Rw831 .  c& ʴ7p<혏}q4($y) t6 ` 9Yyqr8i*B "9 ّ7gB,ْB293G18:<4ɎAIvu?7$$KB)DiGa<"aM$|;CE9Na[H#I6Kt^C~fY#0 }Ir ǕNQ !tFwˀaԠ y$~oYE}!R5ę 0 @h6 W$@ 08Q9,q8 FI @ V ) @PM ɚ7`)4( UFT ]S P%V3pY%jP`! Q &9%P'6ZOp +@402 /YP,Qj1b! @(bpuQGAD p!`G!y$fV`GJ#nV`( I@x4EY p]13$SP2lI a+Z! oD`DJ\Y&epYP!%B7, kJ:Jc*Pg*/q!yNY1ɥ>vp85# ]*vUEfjƆK) o¤ѤWI & C"6]ZI*B8MBZ:>80 [Z  ?8Vd 0 c`  *C S,@ 'q"JKjP GЬWqVG ' k G㰿&q('0"+?8%1 1z9mdA F{HD ܸ< x R;R{8 XK @ ^S3auxP[Ctmمd+wNC t v{xz|۷~;[{۸;[{3)J53D aʹ6 ɠP P`0G4~4 ߠºs;x A[C6 Zrp<2T%KgQw2 A Hj$"L Aaq #`]qx%+qmkl ,%l,__{$+*)p |c0^]C24L< Zt3@qS`PU!L"3g||1]4a+F@B/Ab YFKV8o<A"Wg>Qʨ,% PgᲣL|U2G {ȝvDAt78 ӀdΤ,9 R` rlS |, ,O/9.i KlL h`@]?6|i<<, Ŵ/d`WPЕ,` ]:!p$$L*=I`Ýd79=x$ "=,|f`sd 4˪˚Q04QեB?! @,'|WmsIio rvqx9)6NvqĉBq/]mDJg Pp\11` U` -l@;-(p  ! + @zc B0p&P = c/jq'sJS'þ[ @Oe`,Âj'M! 0Rz!K-Cm( 0/O]<]^ZJZ 9$ ѕ e]|@)=@@}`N9vMP߄y8.)CDC~,Qr%c0c0+gstu剂r!f_%A0lN kK!\>-ױ[ -gap’ ɰ 0’Nla؊ (9%By y9` ENYasn)` mV=qIR@; ATȎ>8@Fl5YTB`C->qoPHլmZ쪎D.Ґ Hh?~ 1899.|hE` ? Q!,_ ^ҞbmB8, b$C.E: Jh,P<)# P pܜr./fcKP-p/  tl?a CL/N8Ju O0 1 0 ,?F`ƙԀԏx̎ .` cC~ZoX, Y a1P 0&J!?-@ُИh~y]9਻?'Q51H D=@@?FPB"K^C-^ĘQF=~RH%MDR2iQ]L5męщ0T7< Z(3KR=nI`.H7r ~VXe͞UZmݾЖBXtk 1XPƙBtڐrXXdʕ-_Ƭe^+R$chefU\pōG\r=Z04R5;,vݽ^x9BY@i;jx} yǟ_ʲԮm 8Ǖ(If/B 'B /z #^;5\hO$A@ WdE_1Fb;l i8#LHSH#lDd23 ȠziI&J1$&%T Z lxO+"+0p$PC)RG}H!ZŒR5?,rp"CLOEu2j,E20Ft5W]wC7^S%+{l!Yg(g}FL]p!\sϽŖ[h%vI7ܔ!f7_fZ~pd6| ^ `TUL߰sd$$㏄ q d Ix=NN9wyB ~%c fLV{iޛ9Uh8llDz|ʦi>䆛z Yo&3O`Q7ދ;J!wt>W hv̴7Yyv Wj0/":լbǬA#9tRW=% 蝠9h 7kڱ7rpHָf0ov|F <_̍,ʼD,=$$L6gdL!7A V& B|"(THXЄ'D!JB!KFT֐?@)1audG@C16dyB 0c{Eb'.0 `W XQG@EenD?HF RqXQB>^QY4:C- C fF4iCxlEbRb"A :&Òlt<8(=r4+Gʔ0[8B1oK.×caJpُqZ0 ~K&I%W]ӛ=A1JCi9m' 2s`D h8 t jPz<جGԡE1 LHbBUHAG7|J$X:S (p@@=tc F>4F^hY˩OjT:UVժWŪSbQ`E<,I' ҇խoL'Yr!9k`;ضpC &ڐ Yi;YV$v@a X# >{CeUZi1Ak/`mmnjK8Q ָq\^$ͅnt\V׺uݷfC^5ozG׽뒡}3,{O^L<-&5pd˔!m . !<1y0C"a wBȆ6>ap'` D(&  b3;kOہxA0t"x'd dQǼgqG'zKo%Ћw3$0 Tu[o׮p+"@0joFYT1 F/~#/ HɋfC|KEM|E˧a?ooq?||◺N+~i}|7w?h"aC~ml`vMk;}7Lˤd$K.|MR_` OKeH|ڿ4ۈ>d@  $4DTdtT~3g Ajzk^$B A&"Ap46(+,-,.$jA."#o30Dx!nS8!Ł%.肁֌`bX䊸LPzԆ(VZ+Ĕ9cwc?}`:%>uXkX݈FVX̽Ȝfl&/vwfa&fy4"M֬aS4RfC`4fnp&n&o^anpt^`fcHˆgh//g4rn6ng"S#e`Fit3H&pa9d}k`P0/164uC1؆kfxJ%mC2`vgH8cNtvhi &e` oQ`gifeA kh1ial`z kBDZ3j~ᬈl}nh dlj9Nr `yJC1kfik~HIgv`np.:2=n'6F6oцi\bY5b%%i4Mp67G7 e FB 6Ia iipءeE߈ohp01zȊ ^$pObfnHWujPq`Mqa%gr&g-;qNQc pl ~0&FQw*iNn$qN^wPio0cx&?2U23'4o}^syt&g[/>^Mg~v6DƲ%)1N"%}"}C I6quxGoq#%amz&v h0dW`x@Q@Jfghv65tkwEnp`ِȰG4[ƌqPBi1pωxi_+ڇ' ^ C`$OP%x.@QxR)o o}xn /m,VgQ7?C򏨄O_xh` w FbّxwqN׊/qRz=8MȌ{M{ Mŗ09L%K {M "!3lPvh|0PW(q#8/b'LS͹oW KKPMAIKpH {[gg#=HhQ?osmrxhGGelx@Hx. 9~,h];w v1̘ t h#Ȑ"G:$ʔ*Wl%̘2gҬi&Μ:w9h?~B\)ԨRBMfu۶qbGcLLf>#ZmA됨6z/jyF*%+~:lrAqYdG+ RFΦQ]`;@:sM8qœj!Qi}!QgY;[ ;s?egQ)y$I*88EI8-yK0i:IهA@ϖ83h̅]AZ=%yOBYzSP%e!S;-<} #Gvh(:PF*I:dCRCJ:*kkG lm(u3*&c-Ej-$IzD4E 0.yEBVl;}J9KmQBݙ/ +B4o\CX*eZmYпG-v7DY82̸5aeRȠLO A-/,u]>jCA,3YkWRз`&VEi/-]WA|Nu5}mӼ>YDeeV ٕP$Ph-3I{9/!a6fbd8O JeԹ3YM;A8)LĄMCV ~;lL`K ?>O<P /aP\-JkL??GFHA,&K@&V;%"J rPkAP-) :i#$*C "`G^ YjW\ƅ[Hr$ѣ :-r[ChbDڳH Qp+l8ơN} ZbD0fFȒmXD#"7-)D4^C88Ǒ '1I&Ȗpfr!陹`G.UO%.sU2=A!#dЇX\mˉ})iRs&6ͩls>%8É$"Ib*9TmSMOjR'@0Zlny(S+^ᐈREэF4+<҈&=iDqКP=*})Lc*әT6a0A$%N䍡F1҉:R5b*Vլ2 UT Vf`N wDhJ!^ T.qyֽi5~`N$@J^_R:A6%f@X3CfJ#@iղv|7H[Ab(Ch D޲UL^[+L.2WyjZu>jhfh%qng+gh+ksX%Ơz ?rC'KħCc }0H=dUTmV*熗qe3$Ӈ0b`]fQ+SP#d0,f0CxCE[b]tyAy8QPDz D f`x|+9"l{uچ.M<5$%?Cë @%SH g b(נO$*[݊]]w V"˃+D{Y6̔n՜3Q2.Y7s(]CH /waK |CHLOۂ| iW v>yCAm2L-ġ|b(-%_ɳ \|Գ & `QYn5dqV]3RQըD}2ްs4FK;󕌩sJyeai>0]'+}߉<[__R?=S*B[=QӾ=s=/?>3>/}|ֿ>qus".b7~ЉzU_[!JIv>Cr ܰGN\C#T_F40AX@DpBHdfHAPj``C+D:D3*|]Ax@ԑ  _n:$ @7}D FnC !^ N!o]x@AHEAC`% 8@0`A8^1HdaNl 2Į7@HBf9̡8h[3x!)a(brA X;XCAAhLTE]HX`C "2`  L`AHA EE@MCAC8 ".@<-Bc>`2c`CW<??l̃3`GCx<죾M>ȕa!m"Ci!C5 x6FI:БApDDG3)dh^tWK. 3td$].<1%$R2yRR>} 9T^%V.CeV~%Xf.PeXeqZAă>[D˴>PM]ƄZYH`Ş53hȝ3C0YcZ H%\߇ ]eD^6^2V_%}lC`:Va$e/C0c&n`fgDYa҄,Y]:dDO8`>>p/xlFmZmڦ:&QZ_>8SpFCC]grre`cJ'{A\'[桌a繄VE@2 ՉEx@8lE8DAp]8Mޔz'^|Z<\L8x4C8F| ~u3C8lhWhEdIyŀ zV}47 ,2$$2% 2"-+4. \rP o\5\4FgFo4GwG4HH4II4JJ4KK5\CBD??3.4//M4-t@ @Gb4<}:lqLGTO5UWU_5VgVo5WwW5XX5YYY27ks4IHHuH5'5P3Qt&,H41v%/8Pay-PjJ8@dH 8\~Jr#IMg3[Os865hv4i3?a/|90h4@dG6e[4"F]Dp[p;Dq6^urrusN6@3DuG"eN:P8PqDxsߵ^uA+BwCRhC\7n}3l3xJJxJ8J8IH H(M lG7goxx8k888xøM833q\  x9'+9/793?G9_gyo9sw9{9yy/\ov{Ay99m߹y99x:yz/:?DO:KP9㹦﹥O:w7:惧OOiu󸀬:׺:纮zwr ;ss{]p+;q3q;{@1z8\57wzwNN{O{{{/O|P{A1;;k㻾W|<<»'<[j?|CĻOwQ_PoPH%9MNC13 K-QDJ4ǽ}F'1>?f#5{x(ք*R׽ԧ 0 !.9C4D,4گqGAMX/hCc~J֣jv3PSp`A\Ѐ/bÅd}C^0sȞB`LY>/BA$)leA@,` (@iA৻'e>XA>X"6bA@*@A)ק 6!F8bE1Rt*c{("I'QTeK/aƔ9fM7q,`HYQ ,9&UiӚx{hbV,H"x iي~|!+H4pYwջo_*} `]*qcƊ!G^SC>dOAf%a$3.ԗŊM+hvj۷qֽ%xqǑ'WysϡGo9ܕY X Bw$PksEZfQJU,X衉. ЂخZpiRnx5?tKN9./q"8 ]R͎& _njn  훈po|&\PAWI/QO]u%a]iq]C7ށ^/^ߍO^o^驯^{^/_jo?O_U ?4x@. <A Nvbя n$⧋dЃ%4 2L _Bΐc a=:$2qP>4< FDDL0L(E-n"S.e͘F51EX"G9KibG="uHAr)$!HRt#}0d J^ B䊛)Q9@P@8SKC0 y%/g! !0="B4#T:MM+3FiZDQ-1G1n!msy(8c gEw|ӨN8hYLav"?9|B>!"fB]>y*Q 5+>LTt2@ZS< GuiXciK;Ot@ӟ dCZBmci&81`#'B n64qE7T!Ut!cHC^¡}4T;D:v]@ (ȮVQCqTVK q =AeSpc󀇁H_17)a3mX8Yyc V\W"h^N@t'<^C6{~L".>M.<$:aX|V2@b!cY"1Bԑ df/F;2tlA@O7Y<4`RwcȬ8 |vbRGg1 #x%8,/ : ;HJCd%^Lal?M~$h`Ǒ] V5⑍$m?YJH(xe~,Ä5#Yh_ g@֜}LrYHY9wՐx8,4p֠6K\~8C9Cmp?E)~"lp|&; "ܧGx".#/"aPB+ &F/GY" Bq؏%VVlPz3-'z ȀBAP [Jb@j"j`^mY#jaaN  + kq!b!jر#j"q""``N2!a1B&.#©" $ %U2jd{ "!oPP(J[/KG)%! r%r(; Ҡ GB+ ,r`n `,r1U"A|'!પC'0J0]1%1!a UBJD).uȨ$bEӏ" T$" `:+2qPʹt74/"qr%!1mʝ  5tL 33"J!(@QX "> S(+r"Q#N*"j:a"~@qX *`ˆ  Q/H7<#='6b @(83:XcJA r0 Ea "46 #Js IԡtLɴLʹLtFatI 5a`fh#X3d! DA=)'"0Mk谯tBM0&O4T+u=UEnp(˒&bO~IXU4ZMz4@ifέ%'QbdA"nՃ2x !%bB@ ?qbuO^Txp5@\M&(a(!u/SbE"/.x>"xzMw~e v`  hIB. *_{a!Fv ;U`4%K"-UkW"D^!-n17:ȃ 3>b!71FS)(67 &,!ek3"s^>8LbS㪐< $m ) ^A1J  je"wp! blj;>!d B&b#}?Ab,:A$;+%!D=! EB "Pb!5@ b*` *`L R@ A!3!X &G 8Ao^5$nLaL+C$"\! Cڝ"!g B (h5eDzH!["IH!f ! B n_)DA%" !l~"]6dSd)xI;?`f .]*` !C1`? l@x,!4"J!x? V7VZ@&Xᷦ ( HF~" <80X_3 @aK A_((1^<2A-| 3̙4kڼ3Ν<{ 4(AABS*4ҥI=  'VrXIC ((@L* $!Ao@40_ Id[;~ 9ɔ+[Niq0.{ Z(+,bI[0c`Ɉn{ђ` 6k1XEXu1T&,Lq6?>O~&+ҳt1RA^/RRZI8m1xR/UGIb z(Y-l&_*b)cb6ZzY`- p - 3 3aLbK,F.8iА.-ycrIg!܉ҋ h|z,#O(JKGҤfVJjR@:穮V <` At-vԙ-ef:,d(SeFjNKmJƌv.XmN xK-V0KNRA_/Jz* R-.0OߪY-bK.Lq9%K* rˡ"L0LspAv3e6.LF!5/tN?]RI1;m22GuubMvi6>MY;qqMwvߍ7PiߛeqW x߂NxvWxۆ ߋ?yWxՓoyW՟ yࣟzꪯz" 2|»84r8/?}I;ð3o~>? #S4&Ͼ#c#O0 t/c*P'Ԡ5i#վd?a \n'#+ [DB M#@X> z4졇þc 9aشicq̏0A8E`AA. UaPI*&@Vx.< ` L{ta,q K*6r1>@ WR J**f^M" '@@AXGoA[3| aYH`? 2C Md 8Mw՚ @0TDdnز [!I3\1MŽ#R$'prBMmE. > 'IT&nw %Eoy{#_`A)ra G3х-Ӯ#{+!x9tTU,"#]P4$IF{WKUyR2׼SsLg(MQUqv w /h[@JǶ`x<1!!N(&Ad YE9XRYDjUS]^ !~[ "iV1Hx ql^8Ϥ9ʞg?ylr@J,9P4МcE,+7@0}Dő8*-vAAjHȜ) 4~*mM[:ל3@^S[ 0u XTJE*b hēo8W@9A.anKmt{<я~cQ8gd@ n!18 8qI6>.tLK)O&N3\%(_^' dߒQ: pP0"#_8̏t#񏃃w(<6iyҿvC yc! \ׅ.}|M;avO&〇>Q-ӽ-s/H ?b]xx$4 EpD~J9~cf7?~4u1 $<aB0_$ W|8ar.A@ǀ7uP}rYW03Auv'|)`0[s}/E'~yp~n `& Gt& @ېBpt e 8p U0T=GwGpY7+wA1*K*H4u̇$"7-$v40/~iod~8!1 CNp@' qngGA0Va|*\gghv' h*0(EWpw)vXH0KAz`dXJ8 `:h~6(0Ak 3[ x p10 1C1 R 1)rH8Zhw(P}¸hw`(َ(2'0AW'ad/Rӈ88#E`z YPAAr90vXwKuMpE˜Y&Q?ЍySM=~:hNx8)`0JM$ alyvP"qh+8YGp!YK@Eь/qfwp 00P!0u*䜭#~VDyꐜ 1`q` e p`<7aq"*00П"!P!Nv oW~C" 7 ~! .rajoIQHDj Hdk/Ћ41TjUT*՗  v /jaz߰Iit1y HqЧzJPÀ!:! 8  ZqG}z@( H 0"jڀ`  Od*=5*JΊɊӠE[y Lէyꈭʮj*  :Jj*Nk ;k'!ʰv 3 k* 4!@;- ;W/ *҃_1ga(Xeb 6j\`VhfaCT&($8&,0(4h8<7LːDid.=&L@DydMViXN .L/HfihɕD"j)tT."+{7*'w-[,VloKu0o_Y]=-Tϯ™@Ȏz3v`&sCjyG/]z,<+@B!@J3ּ/\ RL@@`1, IҾxb TG (X@C($D8G2p&ԂANh0B@R8x`*8yy,/ G `2_H* hEAV   Y$k:XC4H: DŽL 9l3IO 6+U ln d b=H @D)Ct,]cF hBF|yX\@'8J.r4 n@HBy,̈h&n8@1FmmyFA8Q˳dbZuT7|C]-9J E۝@vW4 K-J$(IpnqMOHugI1D`h"_ʩNw%9)P*ԡF Czԥ2Uy*T"՞:UHejVUvu_jXzէ IxXk85FekZW|mZ, cS`q9y "YpQغ,fr!,CB YІVE-fU[YJֵce;هjU·Lo*ҤmO\[lsS;V}mvcvuw-;^Wnz1[J HpUj~_W%kTz֦Fk LU/Xج6{Xc9 &0Sx.~qY<7>q_L1}*&퐇< vxrXβ.{`L2hN6pL:ۙH5A>?hHxvF;ѐ'MJ[Ҙδ7N{ӠGMRԨ@-V HNu蹈}ms%YH-.hWNf;ЎMj[ζn{MmX3GjГf [hHݼoD F(^ ~z@Ih'N T+sEԀ[Cy,$0 )h1A-F#@Ӂ|`Nϗ(Ƴ ZXMϺ,>)q N$QДA ZK-@ޗmpZeKůwFgVWǺ'Sϼ7[sGAO;O}KY#{^\eg[< DG}Kx @}oAo}F8 ~W}#F6!x:?? 7ǧF do0  xjJ,0w ا P @lh 7p` 9d  @*EW`!5J2p@à28 `'GH@/PEP TPqDp8P ͠Q9AlWH5e` AlA4X4E) 4([Xxq> a0Ni` 0 a@cQ0 kZ$? pL@ .owt7 #a p YP5Iq1 a؋(  c@)ÀPI +@z8@  q@n4D7n IP0< `?o(v` 0 T= QExDY0P~0 01 G ч n Or8 (\I0CtÀ 406*h"#i) T(}hA ð / e4#CR.o'+tCq3%wYHٚʁ1%Y9k3n嚺 iyCq*қ'*ĹyԲɜќɜy*CR"vzy* @ w)(3ٞ (Yyrn' Y9g'@ I j&O @)s :=+O3 Ϣvڡ:$Sp#3 a 4YMre ࡛76} 瀇 l PC71 12 (V"G6zH$` n 6 08N<)$Y zpS#H3&4<@8 t5LpE\ #@uz7%>[Х 3@ ?X` $zy 8lQQ<# &0l4P 9Qp #\kIa V52w3rHE8c +Up3밓17R R#Tɭ5  8_b-V%=fACgQ.qz p6( PA' L!I1i 5j)&0 ) z`a4o 5s%u(+:q0zP)೪&8 uWwA *ˇt6ek. l* Gg4!yNA %|ywv%r9Q~}u$"8A|%k Pb.q h `{;X [ʕa tyQ e01qsޅ, l2 h[q/!3 ,oj :* ! 0  P[(, k@)&B0z҄#|OŰ}1.! 4~O ]+.qҀ }p# RKvьAFժ8kT~e|C>W~]7xZ!%'dO5a~Q=#@0VqTn%@aPsM |%^ 0RaO `6NPa M 0 `-[Q~12ԞQY  3<! +."C{݋="2?\ o_z|g J<$/&4*,/n\-/_ |8:>_@;DϼFJ"l~cMGL2~KSVo!av^E^ȇ.[fh#! k^Agz1<}Ұ 1;z*ݐ | ޗ11 qrp Oڢسu N&oi pC4Pـ`_1i>''ˡIB1 5Jϝ E ှ_[4*/+@ D<f# [ -^x0Č=~RH%MwRJ-]SL5męSΙu< 0c8較qS^Ŋ3eV]~VXefԷ?~GP8~̛OZexb66Ydʕ-_ܑcmCp۶_ށɋ_ͪmn޽}c8W<>ic߸K*\^x7^}uU^|O(]z'+>$@?Ct0B 'ƒ\B YpC?10TPD3DWdEHESFo#˱G2H!$H#D2I%O fI'2J)J+2K-K/3L1$L3D3M5dM7߄3N9$p&tO?PCe7 D4-J%4SMfSO?5bB%TS?NOeUWsWgVV]wW_v<%XcyXee%p*욥ZkTdZokdͭ[pEU!7]w ^y={7_M5W_m_&XN F8a4VadaLu"8G59!UdOQ{vQ9fsPoRwg:h&hF:qfi:]x/fx.Edcg {a&;Ѧmy_ gƚ0y[p¡K. mɓl aھXE@3/}dt @6a='4.zrC3x$b%ĨA`{@n1CYoxCG8g Apunn sItP(0m*`a.#脑f hC+HAx ~AXA,d,%Ґ"$EAN *`A"2f!8Pq (H b%IjSR  QYԆ lI& $(`21n(sH0o I2ȁ0S% ZDHB0j(xC 2YDAɒ+  w6Q- U$h)Vh e@  @`3@I ]PA ȃ B҂IoxO v&EB XtM(pA H`( fa cyd@n! [D--آ"D,jAy.V4rK\Kป4bqL%#18ZT/쇋b F0p1΂°_@ ^0%-!ڦ-"ZbBƽ.ܐBF>wd3hڠyk#x:bs:&f N$W;H<銁:~SX' ׻cNKA6YA(=ٻVKAyB+B; A(`5%\B4Ag™)l.D㻪=}$jYΉa%2h}H[<6 }@mB=D(- x`d?GtH( ) GM0đ@ef>DE%cQS<0dA`.@Z4CŞkuhzXھQj>b\`;Td`Gk$mc*՛qǡ#CYŗz{|{~tC}HwG{ RȁXp×ӓDG ȍ Ȁɵ Ȑ$ɒ4I TIX|kIp;̫ @pɝɞɘDt;,DʤI47 u@}PʪIlq(=,J˜>ʰ\J70˽xP<;K$Kr;KT ˸,˹?IJLdLLpx(JEL'2#?pȋ[Lʴ̛<@)-JO\hdLT7 (135dFvFHNIGKLdLNeC&-8TT&TnAxXFUY$\e^[eUa^c>PedevUeXvigFhffffbnfm^R[[-۰]m}糍g+!gt^[}fg~vgggg|68YX"g[x]hkp0ƾhF>6]>FiSf葾h^鮣ii ,fj jۢVNej>:f2j76#ι)#iiQbF9b skRk#k#ռ뻦9xUn-UHnlAqV][X4S vw+S͞^4 vhɶ&2Uڶܾ{kmmn{ >zK]n.n~nyk띉՞`nnnx: on.owKmNov[onnOx; 1q_XKG|Tqk{^p9ʞpp '! [< 9!8ؓl[ELv ڋHEG:SxgyHxG iT9>8]MW һșH`l4jrxP˧D( <^ 0 a1xGϊeNs |c 1*썍ܭP蜘Fbs l0lʧ̆#8?mP9X m~kϸtpyȆ^'ӎgXnPC0ȐГ`1 I樉{O3?4v6|xz ˷9@SKt|hcP[x* @ gOпk0y4HØ ?{F#p GէOPo w΁zpDOM8:@n8䛲!x@@P/@y7={xz~ P4zx;>``R#y#x|J<W ]?7  |`z=ɟ WP y@},# D{P ?Qz+P WD@EQDs 9|ȋ=}}W3rpD.3/X`Ljl,h B.!ĈX .yÉ{(㾍1Ie(#m6Ngҍ7nmԩNNyRC@"\x5E7d6\ײ I%2>z/ b~ \1*A`A`[3[ S1cRvnke܏6꟬ WELЦX#YҵG:d3ӆu:瓜&M8WQOn%Lkv?vXB c_e☵>8!W YZj:飗H?]P:oR:Yp^V~CAf </4|_S ߜN?Ԝ<  0ܛi RZ:dIn lk!R(F# dB)wJ HC* y(D2hRA +})L9G n1_LsJ@<: ^*T>#Ce >ԥoU |j2VSUJ$*X ;dQ\BU&b}k=s!joJiUDW ?Qt o(FxKaFO 4v"h3乥Y;[1o)bf#b8c]'!xOC@ۄ`#m Ch-h[5laR02G\*P-hE[DZZ4 B\S&H[-T (<>:G-p^¡ @Q{'$ -1[-7 )X ;HCkD O8@,za`)EF?@DW[?,VdN&h+wK畒@ށ@`7Wȇ]<I,@Ƒ$yqHd/?cɃT'Ff+Dz'bt#-ISҖ43MsӞ4C-QԦ>5SUծ~5c-YӺֶ5s]׾5-a%0@"U$E &,U|` l63}S>YLmR7ɻ7}7.?838#.S#R}C)QemnBBf4qgio37Ȟ\sKE!gl;FR.H!:!D[mX3P{g1s^&W]& x` B h87$ɄDΘ  _n[mɇ}=@ bn@4St@  J>C6A\r F3w?Äq o+;p/`h*Ȳ 8 ab[ S"=E(ePCŒp""'R 0!"'"&7By>AD2B TBE`,@ @~TA} 9$AH<BH H|ZP@<ă5,6ŘA(@ L54KCD8@ Y"`<É AD^A } 4$AlG372@ 'YT,"S$ ?C4;sHQx*6h;6pR>|CtEʜ2;X>]@N S$JPH5Le85(EIiACmDAC:\nx AG?v4 I$[>4D؜MUhH,М>h eTACXVGX1)X[FxFo ?4?tIA`Q Eq@QHEcj@dfx)FV)fn)v~)))))傜)i.ʁ))H *HjC6,&**(hh2HC6vj\*3d55x꧂f483PjZ#u 0LV\hMp 4*}a*2r4iFd1e +@ nkQR4x*h_A/X+%Bd_rȂj!;@/EFDRk"ľ^O+4 DzY$B%&1FO5#W-5^@aY`eJ_hhDNC1lɂ$DC1AHB1BB2V! D :˺Z0/T 0lNB-TkU@H,E PL!BEb~-A`Pz)10-/-,C0΂,,AB΂51/5ᛪTaF-H-v-^--BC0.BE-\,PBi-& ^*-4ÔQ`[`ڂ-BD'N/@/'/N-M/07?0GO0Woh0A 0 0 0B o0_h X*]F"+ 540A ˩OŨ"Cz+-Zi+0|kQkVe@D1k 5@hȂ*qS-d`5J~&03 2%#52,Sl*\H}@A|qAL,Õ*}C^϶-G+X1 AL0ë0ZAN!.Bs5s1n "DJd3aAD-D冻Ô.JA$zAza411e*v-$l(;2|PcTT5\ݻx˷A`a]̸ǐ#K; 1-QvOV'MӨS'@An3%xh`sͻ4c-ADB$УKNo-Q|!ËOiL_Ͼu >/QFY1߀h% 6F(Vhfvc$ht!,Y/.(4K8<@)dE8H&/(3K0QɋJf*cC(AO0[pl.xNpN;Rx.gzgt*hB9 t$y j/4裐5'CnHB-n4IvU7 ]j^pb#e꫰~@4i뮼-@JKF /0kP)0-@"S-FV ܚ|J"5X/ J)J-iK4h/,9lP #\/wq/̰!WDp2,=k)A ۋsmrl$ g@#fUJ".0d j*Ey)h AUd;484F4J j.8|@o_0P !P+qSvDp{C#^$ .U?T@a Y)x U 4E-J&%Dp $.Ek a @Ss@FP%P `&JA1&n<"YiFXB?lҴD${Pq ̀ W¨ `G)`"YYZW B؄* zEh&* @` HEd%`ͨ r )rR~UL _lr_3g "," @jC]kL"_x/cCů$,`%Nz#'0ti9sJy^C'gI˔T!aAK\ )Ib*$ 2fΌ4Ų0d!5 gc 'NMd!'_v~ @JЂMBzO5@~1bfk$F7юz HGJҒ(MJWҖ0LgJӚ8=)AʉbITB:JT"pGdQ4S@PJL@Bd /na-z@Phnp, q״>k{HEn[ة2(CLdDܢP'Yp+D#YvfS_b ElI fY>IDEVÕF,|ЍtKZͮvzA.ML*^6v(z&{^Ć G8B&Ao8@gG6L [ΐ0Z8cV#` Eĵz)bmD1 P S X0 D'E[=S!EFP( 9-T*8@Q(4 H'B@&5FР΋*B Űo׌N n&,'0\")<ٙCF"@FCjJ-EނC恬rFBX4 b=ܚ'ۓS@pVqi9! :d܄@1TA"s(CGp@ Ļ5l (AVtuI@(Q p@Bfh).H`+p'p^_KjXo$ dJg61e/r[ FbN# 9Vk'-4d` >65c ֈN\es8v+c -Ht2 Y{7D}zyz Dμ7KlrN1ӷ "K\ī.*^,KY%V | Q/5=^´sd"CD >KjKϾgK{?=9Ohwe@Ͽ>[7,'|r,' T2z ,'E}B<[[x oQl[A "[F.p e%@% (8X"Pa,XE8nq#t' ]Qpt8 ꐄlF4pi 05t#a) *vXe qybW& EXB?XAoTZ2wa >u 8 Px:ҳ[|<؊S1rX EhQ eق+`["b} #!Ȓ\· % 2#AJF[JY e2q`wǀȂ<Ȅ\Ȇ|ȈȊȌȎȐɒ<ɔ\ɖ|jT_ ][ ߄ʬ r^ ^]!M^̒ ]v_x |\E,]@\ڼ<\p)<4' +[K,Ґ =]} MFbcʈ@b<芪 P U1 ):! #,Jv& pvH 'D` 0 V 031f ـnK0 <5*4 G KP ʯ }sP& Pn0 I=@p'*ua Ȁ Ұ 6=`6 @vI:` @w o) tWNgLP R?˰ V9!c@) &:"f }  =s>='ˀ 9 !w o ~&e3 afc Sf `  f NGEj&p8D&u0`w9!h!Q€ *h!2íq 0Pp^>nw2lŀ `:ģ[(6g <Σ N'0l@ o] l0U`*oV0q-F.}lP &- C0 ; .6<4@ 1&_)p2aۻjo,a /'0ze6> QS $0C 6`Aa AQ ʞ3 )BQfqmW ھC\6{ Xm ! `[ c. o & F0" B`4q#>(yb@b0VYI~ 2=PN #H c p =   W  vBKe' : WBЃ.xz< !3 w{"hWϫ0 3sjӕMn/ྂxς?_?_?_ld]<9K|3ɨ_Ey`0A?i@Mv <ʀ :yXO**IHܿ2=np&1.@ DP„PD-^ĘQF=~RH%MDRJ-]s@5męSN=}TPEWzbTRM>UTUn +vW~VXe͞E;pZqmZuśW^6 0`… FXbƍ?Yd(_ƜYfΝ=Zhҥ fSjӭ][P4[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ߳g_~ '?d;xᇦiB /dN (CG$6 f pcwJEgd!(Ao')@ 2I%믁Q xI+ĒTRhp*ƚ!$L3Q($y, eL9礓' ת3O=E6$9 p4t6pq I ̯QKGҒvڡv4%T>)gbnTW_rPXeV[oE(S\wW_6X5W6YecYg6ZiZk顁Q[oN\sc{hn]sޅ7^y}\{MWuiW/z{7_QY y [AXၪacij tllk=fZǡ8@UoV 1ϪfUgh|8耉z'$ 2cAn .6& Ⅹ^vjĝ5蛯kE~w D9PZ)x4 oln+1WDYtOJDQgu8,qvaw{>~\x㏿ʂEn䟇 *E JY8z{ܛ(^[R`(l߿}> ?guw.l\Ѐx:]# \` JЂ`a iaE8BЄ'Da UBڊ-CІ7MqKQ?b8D"шGDbD&6щOb8E*VъWbE.vы_c8F2ьgDcոF6эoc8G:юwcG>яd 9HBҐDd"HFʦ8HJJ$+ɦ\ d(ɂR$ ) bJT'+]9K2Tmh˛e0aKq2x8qMy!1؈4@&hӊx5d ׸6,c9Muօg>CrO}s$?JrEhBP6ԡhD%:QVԢhF5QvԣiHE:RԤ'%.PRԥ/iLe:SԦ7iNuSԧ?jP:T6J3H.ZȣzRKUmRVժWjVUvի_kX:VլgEkZպVխok\:W֕δk^ڨՋKQZ(FQ/`cH"§doDiV?[ymaX=-% \B3-b;{ g8@. chQtJU.Φ,ҶPPH阂#)U;`8F`&~_$y0A>NX %$I7ˊxxuBZ^aX'b_ܴ7E41 b!$k`(m9d ЈA$@cXS"#$f)ǬQ O !r O(E(ҁxعQ.8B m9Ԧ6(H3Kٶ6DP L 9J%BAdC C{4$%B :sB`"rAd%tPMP5Ly"0y׻Bt^H9P%C R2d}#7yV<#qPIAV 8QA[cq-+7y@C+G(~"6BttހzB(*k!Cu%S FE$r826^NyhՐQytR~eq^7S5Sޕ+l?KW0a)-v(*K4 5㮘y,>%~R!þk\G 2Я$©!!d(6!82L[ K1>!|~φ;Ȳ d S@Y?) y?i8P>F@RlH` QPdȆ;A "d"qYlPi<"B"B!"$ÖD'LI;(L(-H BJ]` #.ܡf!,v#CаXA5l kA9+i,P/x=T o>A@C1ZqIJKLMNO<E"Q4SDTTgˊU4VEk  YLEpE ]D^gn鱢~h8&p`+׈Z$Dg)8i h8PÜR@GBdCZW*}68 !lŅBQD>R4`)A`C-8`7x1# _HkDŽȮ!k> RiZIT|  g;mJCT 9@.H q)PHHdXaP`$ lD>ʃx<_ɁȧaK y6落|eH,ܪpxBh|H<-}ĘgxxЇ~z<˨9dI~,Zlot$OWIfAGS8),OI0tC8%|A wp(`PZqdЇH|7 m:FQ1ن4-NFUQM !%" '4oіd.A0̂qd/F>6E4Q $q7mCSV)lxk6 ~\B}hCeS쐋ygxw,dpXbԛ$+<;UhÙ@GH݆YyVFP,-DU=0l47(Ee@сHxǁ (PCƔU #Ve FP([N)f:!5mo`PzH:(T=f%y%eqhώ8[ H,X VS Ђf%n~%_G8݁ @͉ AT%`ؘC@_YHq.wOC8؁[JxY15E=XTۮe+ 5@p> xYH E8(@DՁXW %`=0\1A6J X06a (Ls)XY%}`͈dLi+7au0(l˵J ~ṕQ -X`l(|֋^}X&je2< ~hp QX Yۜqٝ=`Hv* !:0 >癞 D}X~x h{9Җ- q&n'8../Ń  c2e㈙?@A&B6CFDVEfFvd!GNVJEdj!MOPQ&R6SFTVUfVvWXYZ[\]^_`a&b6cFdVeffvg!k׉phlThkV-0o@piv&U YQ 7 ](a@Y؂u&bp (؈hhbXK -iihn^RCM#sHVepo&.0)Wp6٧b_(Z^YI^hʺ`Yd`b\X#a[\ȅ`:^YNY 롦\`#[ b([ZP8 (#_쌘l)\҅n(뗖٦ڶә^@n@@tZjpgg`ngpiІ^miu v~qs&ItiV&aB_ Adpop.)r RuokAMSg`* G8hUb(Z _/^o[1g݅i7Evv&eX,ڃ>Sh ].rSVXpP)4' .apli2HMv$S(a8Z P0)Bx7rMVNPIVAM؅]=X"ȂJD Ɓ؃"%څamSp,5NhXp ^5ZyRY*^\_lX쁘cu Bmjw1Zk`$/mp ԾU)wXx ZXwx$ [O ;0 'yhaX]y(]o0=yQ' ucTrvz}@Tz\zsm 8`ُ8{=sp-"38Ѐ {cІ ئ~ST &ç{gmhU{h͈;{ ?ҷW (< & sdN}G%hP/}ρ '}e/~.'%z>s1)E~ IЂ -*)yUTW ?}o',h „ ۧO`'Rh"ƌ7roG,i$ʔ*Wl%L+8.&Μ$)'РB-j(ҤJ2m4ӨRRj*֬ZrR)j,ڴjײmmɲeۊk.޼z뗠"0aa`3WT/Ȓ'Sl򶈗7s3ТG.m4Ԫ‹'oزg !,H*\ȰÇ#JHŋ3jȱ#CR@zATE*Lr˗0cʜI͛8sɳϟ@ jHC*]ʴӧPJJ՘F%ׯ`ÊKٳh*( EҴBFJ˷߿ L,!Ĥ#KL`E!PkvLӨS|8(Pv]7hQ͊7#R9 N6 W:NسO&घOS ˟̽Ͽ(h& 6F(VhfTK.($!A,Y.(4Vc81.(Di0F6.*,(2\vYa ⋗hf2@nD/i矀F@!@)ձ@R0褔ɜ\IN`Z)G˨jU$vG:HB.Tk̊Э % *uA6Q,6Msr@>PfmGyNk̶ 1,P2*.J, ˓o 4o  7 -&2 k/,JpM wl9л]ƴ*{, p,s|_4]RLLo. -J l)QGu`M&V`@4E3@! $x+o=P ,GQ *P[WH+0@ )]~43ZU mPTu䬷 ,+tr"r8t,bAG/Y+2BA3ԌI+&t B6Tʢb/X%U'AА*HPF(7 e'AX%IhayĢ Z,YDҒg!s5Aһ/"H 希]8+y!m,(h<R+X%6y:5 TbI̡QOvgz/T X7-vߠl:xkQb``9IHBڤFA3Ma@ƮK [jDp Lk!WJ d$AT ,!&;X,J3A*a@vaLL=GenY∲b$ջ$BNJ* +U! :is$Iώ̳'Xj!8kTM(O : ?'JъZͨF7юz HGJҒ(MJWҖ0G 7W)@ PJԢHMRԦ:PTJժZXͪVUġaRAإ7q@RLQ8E\$ L8/naH_.MA0)= b ePed7 X*1J! 8KҢ)rڔ@ligW1,mwQcIY-j\8ȅns:^C Kw)Q +UFX"zYIJ*c g-vw.|"]6 ®N;'ܥR00듢Fy4LF2xȆG{nq1e FkY}Co: 3 c,uƖ'{B@LLj(K6166RQ߻#IGy dfTY(hO))h0` lxz,? E_a Ѐ8.Ёk%8A VЂ`5AvaE8BЄ'Da UBЅ/a e8&4!Ї?b8D"шGDbD&6щOb8E*VъWbE.vы_c8F2ьgDcոF6эoc8G:юwcG>яd 9HBҐd   p" HGBҒR@(yIN.%d'EiOr J)JVZ9˘2ĥKl)K)~I2\eT|50% țٖcN2QFVryqP@F0%Ciz6d60qA 9!p~&Moh }I?Qk$>:(oP\ k ʣ]8oC =P̆3( k Qh !sAB[('t鋀IuB@mgm/D+@a$GR>Q[,L98zݓH6"ɏxH:@ mHpyL|oC 2ѥ$XIq:Ɠ"8(jFXWhhЅG!/^ 3gW$vC¨H?iw3-bsac☇/_\@m؛Ι~GޙxJ%L"y1q+N1aVzI̱cU8Lwjچ~Qa̠>&N;aTZ{e_C:ISE켮eX,?g.A]SB 1󪁌aק|}9+"q؉SuY#U3>ˠ! ӾH c:4$;3yH3aj0<lٓ R暢pRzA( <'kx%DB,+Ao* ,B(l/p3C'5"Q.7tyІq-ÿXQ> "-Ux,ĵ@T؄XI&چg8 eG<"kD#RM4"PQ$R4E4 S4"SVtXWBZ!P=E zB`,!#FI(ldE`ƄZڇ 0FѸE?C, ! ʆqd }FCtL ~@(7Ek|hx?ȆsFJE` N&1ݜʩЁ = P/I}G 5 Q賑,#ȓy-Q`Rx,;[)/qˌ @DzRQHI?(P3U')SpxHӊ,Cb@VIT3Ihk5M~`@dW7ւh;nٗ,ÉC i<bíIÔA^ڃx%`TDfbG-_xPeЁ%cN^'ׁSa>e5XidW^m%XTXL^U&bhG^H07 W@]oh,8-Xbhebpqaf6b0^g_]hGYb̨[_` Մa;a[}F#[< ƨZ΅~)[ha[{d\@Ⴂi{i[2>(j^^)NjbQkQ;KjI8k\i…^Z؅]z*Fj^v*FlQl]`Fǎl4Tl)s`s;&dPCg*XGFenlz i*&`@FiDS&o1aYgdkNlƛ\A'K[nBon Z D~UW `NRBl؅]=\xӁxYÄ昳4TRqhȃ o\p0` 7؁q.(qFrgf`"q&^Ѕ^[ȅZ]\h0Zʛk^rXFH裵Z َsJ*< =Z3GtA7C% \HYFnj?:i_thAtd)@ST]VW\!؅@Y\1чY vٰc?:hMV ^0U&yކB I:&p )NxQI@8؆ywB(3o (oW<i7  Xʈ%_  Pi7 W mcf6LˠjxjxIE~0V({ 5N@ 3 c( )T` PIhx ȀNJH6 hڏB9W vW{ '7|)ܢ B~Ņ~*g??  }gG}}x_ P}&ڨ` ~}0qXHU`h珕!,2 *\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JWPjӧPJJիXFLŵ+W`ÊKٳhӪ]˶۷pʝK*]˷߿ LÈ+Iǐ#;L˘35jᩐD  URY`cͰc˞M$z4ޤ:+B;4@7t H, ĩyNB'="c nU@u潑r"c t09νt1RwֽsZ.x["慚]𶷻n|;_5}ۗR+7ox{`0|%,_ 0~` FoE`GP<ǂi/6lc#+ָ7l3θ=lCG1d\d7OֱEBXβp-{],f-`ͬ5"n~3E|3hs,f>cnseB9ѐ'MJ[Ҙδ7N{ӠGMRԨNWUc$e4LAZw^`66=leپvkiۚڼkmӚ6-np{;.7=nv[V7ݽZ;ְWB}N}-PtB#;'N[ϸ7{_ȫr 9$N=RR!PVNS (C& @zRa!HEi fXN(?ا -Y( ǍQ@!b1) F,}(NW+^M}!j$~~[~`H; T]+{rqC-(vve?hdA,0# 2w#UNa.gcR.Z*zw_<[OOׯ5g9cr |8XZ'v0  ht ~ ! x `?'t # $X'A `+  X; D؄2 )N?Ȁ Ű(oϰΠ 0WEM&  AL  4 lm YW Q @1D v P|gXOOp  ! oU7x A#@%pB!"& )%ǧ3 0pb "oq 7P'Q {۲OL0 CRD]gG 6 PP$O1'u !N@S !8 Ch. ߠ_ Q PEQA q'@ X 1  b`r1x(, gD!P N1Wq/$M47_`.Ћ1A Y Vpp3'P R&ueir/[ `m gP0 ` rHz ~  s.-/-.޷1s4 #gp ۢ 4K0-r-,B*c b4C aIНb* , .Az ~%>A z, Ҡ*(w ʡAG)'"Zo`(:v3E22jS+ v-Qb0a,<:19#EH&rIڤJ2W-N:L - Tڥ/2 P.{fzsk@ ʠ zr')-1Qtv %szyH )}9Y v .,[azy8 BP 7T 'ʅ @P &Xpw `c dGg PJ.S8*a S.b0  ^2*vn1yi)`K`-.%70Kpvp K=I';Td96M.U w *ʋPrke*]# ()Z=(yV0w $PR-Os!e--Q3&-Vb`([JpO000V . 1] Zvv#0p0B`),*G,e -090s^ H/w,.)Bq$Ӂky)"~b*~ Q 79c5" g*v ()㣆"[W ([   ! z`ڿlw 1+|~1! | $8[*3ngxj;,. Ѹ1iLlH*:M<оp|y`о 8aPl ptm2u?@@i]dž@$`Ņ{Ȓ`p_6x VɦLiܑ|ʰ)L˸iE@̹<-,Ĝ^h` 4*<ͥ5ԓBl\ڬ,|Ll\| 1ې =wL0 1s@l-MZ@slDɌ-|Uq 3M_`a EXTD_]8 Lq hxe-;Ek7ټ$5i9hbk-Ph Xu}&\\ у \ٚ=0}ن Т 2!Cڸ TMb`=ܿmη}ǽ$]#:1*1kVPb $G-*ޭEqA,0 v@>UN?!- mT|mM]{1a ܃&* Si nۀ<<@ p !A09a04)> p1D(>6. ې ?Ai?YȰlq*eA %"5A m@ `;ޜ,}5:!+h.0;\Ênێ^^C͞\>Qlꐞx" +BMNny4>ϼ<? nz/A:|@~y-.@ q@w_(!]D .M^숗K N@1Vj o2$_>&+< (!2?M,BD_$|HJNPQD٪ZF=~RH%MDRJ-]OR#hHm% MN,RM=U*pTV]~VX0©g%E`|mSQJDTV F8+ƑY ?Ydʕ-_.eiPly @lH ldZmm @yiAt_M/@$@+Hy$-u"hl (ЇA.ygy矇>zGL F]a l2~rC?}g}߇?~zm'g)?_΅L# 5x X@1 Pς`5A &D[H4U'PЏDGPHF8!u M$FAlHc5PcH4'@x WVvM?WbE.vы_c8F0*^6 Ve r xАSĉFAӵ6E!-g `⻨[@2 bŘ{CCVi b HFX#U@˸FHhr|/Y$]ɣP@ N%&dĠB% 2͝"Y` w5!e\t/:1KC@d@b&r ,\QLxD\ X(,!a,t"$BG!pT!Ŕ)5@ D_IVAʰ !*B`HhPPk80z0&]a' QNԫ N-HIS(լT͌"` I0!#ʐ(% zJ8 \ uTAeZ7x dbGb!3P_J(*X$5[ֶmnu[ַnpkۄ\2hDyTxlB:!E%:h34hA`qHLQF a1FAn +[4`JZ1k䃚JypN"5$b  ~)@a Bd5x F'ۭ_," , ېľ0/j0Q@ 0`CX 1Yd@H0YX_ F?Y .R !fHusF6(T,H6" `" -h.d'1 hS.v\&P +^[WP-μ]zcLC@|)H)ARcuBmXg9s.ڒLȊzWbabLBj,=:?wo~ME>pG8Bްp7Mx%>qWx5qwyE>r'GyUr/ye>s7yus?zЅ>tGGzҕt7Ozԥnp @CwY]H1c>^G;v0;v=gO{ށu$E_VRk xg `GeC!/4?#I>Z?:;>p5yy24x~Oqzi| 4^<4h8xq=G%OSqA~t ^x|ҀgK{~jG׿SV/o4$4DTd@|}؇l 4 @~@   D0dt у/P~y! 5R=H3vXc0 $( x<qPA)Bs0X yp3 qeB1C4sĔ R&j C$x?DtćCzJ }k9h)K0@ y 6A3(?Pķu`z`zh]l;XF8葞`ԘY "24d+>hƑxk:P nF(ytxsFu vttLjyzx|G}ǫѰGe}4 ˋ0;1tȇȈlȂ̹܉PHE4ȎH9 qHȓH qTAəH9t_cI9,F q? ʙ$ʛ:A@Dɧ9| ?x|ʓJU9 <2,;80 ?8y8 ؇[஌;˨,+Q @> J0Q+$aw釫 ,< ֘dBt ɃW < ~H뫸~: yÊb~0SN<HܓD餿:9NHNʬqpDR3X|4OK2kyx2Btg8þ@دN-]?AB5 DDeEeTtGEHT37 )TԄM%NEOՃ RSESU5UTucՂYTXp7^=_`#[=VKVc]kgV]UgVϋkžlUp Wq%rsEרPuRpWvx}׆ze{SgvuW]WEW-W5yW WWqXfWWW WXWW XXjؔUٕX`ٗMYٗٙ]ٚ٘ٝYڇږ5YOEҎ}׏%ق}ڃڄ؅چ՗%RWڋt یۍ]Z=[o0l8L|EۦU۴ۯY-YZڵEZT:֏`[#؅\YY˵Y̝YͅYΥ٬ \spEĬW*ۅX]h݄x]݃]vw9\ƓFqpݛ%ᭊܕۺۻۼ]޽m޾Eaa`vaF  ተ a f !aN$Fiy%(6^֝b׭bؽbbbbdybbZ2>^M^Mc]cm}^8~5Uk-\ģ]ch :=i!Յ3^Lumh!`6:&6Cj9vj"jyj9Xl k90 jek38p"qX뻆9kH0l6&exe0ڨl(Ǽ9"8y8XEkY4naPkҭmRX`y0d aߖXep@h^y`v閅8`g^wvPi!3 p(O s|` #e> ߏ8{ԘvevlXegKQ$ӄB'7 @X`_l17y0Hs/kXT)9 I .ϥ!7\`f ЖyŏyX;$v0&thDV ~yy! _ ^7iph#r*|3G|#;lrR)Fpxwk4yC8 {z`VXмȆsD׊ӴyQ_[xqݏ;#OQx PMM~L' QPS71G.xŅJS )TRX1^A d>}P_?q4y6w!8K (҂E 0`S%j*֬ZrEpZiO8U%zĨWAѭ)*TqZ58.jXP\0APj"ɢQ')}'Mo4] =f-8+P!_LנԊD1iTq1&}z}eȖ\=9pJ*ИNA CH)za,,I(X  N!C`ĖlMoB)"ꝒHcÅ!!m!l6|F h"H R+)gFӎ1űvɚi# 3 2ԒC2gl$$cW3TB3&Hr\$(YProHJʣ|r|%,cY]ɨZ]򲗑a<*!|&4 ItimrGkq<>s|g,3M'>5'@*-J(4:iD(D#|T haHeZ(HJ  iҕ @% ҙҴ6nz|货>)1a(@=*RjP*T*Uh>uV*Vխr^*X*ֱf=+Z*nM3bֹҵI׽+C2+S 2}Vc:B>ezrLim6F*%8=Z_Q6ݖHE]-nۏqtlM%S mgm3=wmVKN+BO@k'ЮH,3N + i6]Ѝh^!SG'}!8~6]/" am17%\d 'X HNC8Ή!a9lr!x!be0{ y#~ EeAŇ:D2 P"0Q۬*1-Ue{6jE<>$1,<+u,Mt (Tea)_yB EU[,I0@-J,[fC,U>$=w cK% wX @S@`"U۩$[D!ZZNf R}basfxaI5g]3a0uvU !;uR%#' GɐE1xdItg_#@;Iuc޺mb.S83s8C.򑓼&?9S򕳼.9c.Ӽ69s>9Ѓ.r2AL!kЗM,X@DlgX:Ҋb SKSBӉV F?m;nC@?<3<#/S<3s];/r+3 0sѳ^8 qc/VZS2pcR%uBV3J,?MV~gt,֧mYlFy+3+T Pb]' NUE7@ p[U@)@AXW( = 0` r&Ă $  [AEŒ[E @xC@5N'\F4s|Z-J$,I'P BR_Rd]LAA\R) ::l#(`AH#@U$lBUHi@+`>b]B@AHE B<@%!)( И!b4,@TU& K,T D ?@/|bA@`1 0x+BQ5I1D4HAaW>4BP@he]>fSNeK^WW U`OUu8Be SBifEYEQeRHܖ_jOAtfBi&|n4op'qq'r&r.'s6s>'tFtN'uVu^'vfvnXpxf@|x' z尧{|\}8Ч~`((&.(6>(FN(V.-\&.lvE~((((ƨ(֨(樎()΁B 26(8DF2h6i.:i&64Qv3)"'KF]R\3(ğ 9rfR @B_1YhqBU4C1B5CW- D|ݛjr5 9t ~C7 Ģ@pBjn@nPD'.*ğg1L2MT@؉@0B%ڷ5IA NĘ=B0k6@ 2N@|' , )EifB% $`Ex/>@dMkAA:ۅ-~P $C>@E|]@\!,b,rfh-/L1ЂR,E CiAtkB/0 B.,U8-,@B-&m0\BH-‚--Ԃalks:E(-(R/dh/BRh.dhBԦ2/-@Dh-d(؂m{"-R1Mr'/,HO^uB.C/nn؞n0HzvZ.n.j-/؂-i.o.-B*jgFxN&'VY] z ٕojؚo4M6HC284`Ƞ]jQBDW4$f)24ٛZS1 4z H1R`&:(R#c4NU).h6 /0,3/0al?ո=`Ϛ@HXܮnM2W 8b)  0+pr@ hU n@ s&w] TB' TAvm $ߦ/,4GU@0-L]lNqA4@p¢zm/ C[9D3ĂW*|@v <@!DU$ ė@D@r2gm9@.-FT--xm0> 0/P-/C-t)/4,BNc/,H-Dv/JVctQ/a)"E.4thYg5gт/Ă5O,5 B2+VdZg\- u_ ,I@bsAeLЁ.ĮN=堤hficDlkxv0$ՌC9`y׎ZGxl&WK"A|OW ŢJ-f埌6KSB $va 4Lɕ 1Bj1 ꭸ~BB @lcQI*)3: *A TGPE% AJȱB'3łDTnۗ%@,+ ?Iz Q,Y@~0J+G3&A0@A{ DF + ,4 Att{P@U #7>CJ@@j d,s*P7vIP HUll=<McUN3X`bj8&]I)B7A`{ʅZW1BKDT&;nzP+<M2`<#O=s/?38sM`Ac֐=N㐝4>C*Ԟ=@=*Okԥ2N]TzTժAŪOSԫ?jSjSv:KhiM*VLk]׫5j`:د6FkbX6ld ;YVS:+Z3iZh "W6'&.iN^vfl9[l~-gnynvn];\7]gre\~IKڡr zx񊷼.zKއW}o{"6]{^׿x|֗E0|_j/׈#L iT7apx=(NW0gL8αw@ٽd#PG6dlG~I|:Xβ.{`L2hN6p<(/PγL>' Fڽ <~NF;ѐ'MJ[Ҙδ7N{ӠGMR):tWjyQugMk/w-^/浰ݓ[NOz[ЎGgK.Hf vMr+$P@^v-a,@^bM]_g@0 `Zy/[ 9_ !d\('-JOœ<0ߟzYy9ws@:G~.]"D?җ3Lw:ԧ^tS8Xx ؀8Xx؁ "8$Xy }&+Ͱ 'Fxr01  F1ŃDhx"E'̖ @ư .T`$opUNW(g`qk pow2j8tXvxxz|?Xxc  a mxwqHc18Xx}s# ыh;hn7"(Èmh"0p ~h<-R׈ArE) 0(F085;`Љm$@Hp(#ģ CYȇ{R< 3# u ϡ9vKx.4Y $Y< ;ٓD2"0E!ɔPR9TYV"wRZ \ٕ`5 bZX/i h=8Ѡ t  a})4nP@ܠA%%3f '-CPYlLYH}rXx n9Yyc nka XɊșMGIϱ9Q Ӊҹܩ9Q'p3V : p~q\y W韭1#zџDO3٠!Hj&iIꡯ *J1a}lQwS.#Cǡ(>9/0BAw5*;qы&i{) 57*7Q`b)SYP jg0swl*@`}u@T _ZqH4j :tZZةځ8zZڪi*Bz:;SZC f*:U{3j̣ꠡlںTѭ 3– zِ<Ɇ:c\:#C`< \1 *'ɰ c<)@nB] ۰z'd,epYpOP:%zQ H JN!)w:D4bKPz`byQ{ Qa{˷aa Α : o~Π[pAAKp|Kw @p{;o u kP {٦q:|н[kؖA |Ő꛾ඁmU` a P 0  s ` @ n[涿pq |'ի h!%(b),_8!h4l:<>@57D|~F|J<~LP|}R8  ; aV % {š%0 '}@  ː (P | n8' '} b 0oIq` ` p= = ]!\";I N4n 7 Pq2./Lp BF b 5 \ 7@ }it yna b11.ݏv+?ZKn6fN o}vG`0 oxcr40} (.r ORHP"RTwJ~ O& d7 U7E7|)[q۾~}N N)i'tH]ו^=lJd,X&{vA4"_?_?_ȟʿ?_ֿ ]+- $ٯ1z"}c&)O/@ DPB >QD겘QF=~RH%=7JsI0F+c&Lw0'MTВ(Hy=FTԐ^ŚUV]E~ /'T6'Ɏ=TP8Wޠ]qmWP?YLmE}1˥kw#ɥMGpH[ZvƳmƝ{+;nB:Px Ğ_:_ر^x͟G^}dݿ_|3_~P$@D0ApA0B '+0C 7.0DG$DDW̪'c1FqKqƫb1Gw{ G |0#2II'HH*2,hJ.-K1$3@/˄(L4dtS!5㤳N;ONԳO?\ЇPC(> EQGMHQ=RK NJ/:3sSOOD#6(5TGe"PUסu`YwXS ő6H}O`q׈Xe-Un!꣠70c yܫA]1]{hކl0( BVvW_ W1ݱ_ '!Cd1nky|E"8Ay8;̍4 2ŁPOԝs"P"Ț?R!Zl qӊel!y X́Rq#3GСXcćvA" )pHtFYQ< YFKqt*I1_LqmCk$!"kA`DA0 c@r 8wxJֹf},2@'TR >2![$%yX!PFic@fyR1.`+)x1s@IJd3ӳ_;pR b/ 7GFGz1 R0pȇAbG딊:E,â+Eyn8q^l@1nrE2 52 .LjZ\I:IZQDPͮV¢6qW GTh-lf5mhE;Zju+mjUsT;je;[ֶmnu'n.z׸zr\67=uq;]Z'nvYծ59Byջ^o|;_׾o~_׿pm^`0Ua WXp5̑ o0A؆l xCn?9ЬQ8<򇧜6ox+~Ӝ:8'wA3CzҕA-Lwӟ;UWձtoW^z^V3!Y՞=kwu;Dnw=߅K(fM};.ySۺ:~C{-?}k?=Գj-w*}{d8a}?1.=t!շa/b}#js?_KGo_p1O Z}slL<֫?қ?[@k@]ӿڻgpd:::::G!A! "4B"|$TB`B8c*+,-./0 !(33lAX645L84C9$B; ;C<>D9@C=C:ÉDE,7tD6|D7dDJlILDMFtA)Q$R4SDTTUdVtW 999[$9\49]D9^T9Z9۹GyAYƠX[l\|]^_LZD5 cF7mp,.q4G2!G:utdwwydy{{}}dȁ,$ȃDȅdȇȉ\rȌHH†HiHIy*lidXɼq@Hk(I,%کqIKu X&(m)$d9J1C4x!egkʫk@ɧAkp l1Kp-S@DNpK803a(w()I`ň0YXhB،MǔˆJLLiHM8p-s0SdC`nNh\P)a!Km\ N@8Lt07(+@aL'LlxwHfmfp WD_ુx((RϪbN-ihPXhbX%y!s8 <DDHXh'- %UdedD=YHLOo+ZJ ӄ(I΃@ QHyR͜bH-`HSYk dlX܊`TJQh,RXCS0*@ UPH`=ODMEMUdY, hh 70]U;!Zhn S` ׶`Z[Y^w5_&bcݖ{!i" b؅]{҄} wMZW=a0P\ӄ0Xh+_r؉!:W}Xt[[X19Y^xV;bPU͚ cpY ZZ%%3UbpYb0[ؖ Zn,^[ق(E^@ 3ͅ Yu[mA먲`XP܆ĵ܉y\s[pڵ]Zu %^ؔ!^up,u !e^^]!p QYh^ B# !M^=u8 !5_>I^ (`C(0 lFF`]C8p"@^Ya`YH`uI ޓ.`N& ?hh vb)^`Hlb0E/vとn`R\6 ^kdX7&d0;iX2eg-K.rԆl>!(Z` 㨰ȃe(KdLEʤI:XYp^AheWdMYP&U1-Xib^ށ "!iaia6xK:/<k"^"zn&d7(j"$`뼾Ͻ྆k !찦 IXlƾء#`6kYl'limɖnBeHlm߾n~lFn>vF킀mFlhn.)f5Vf$RhwB6((oBj&6k6eOf_b(0_App^)JqӃ_/!@or#_W'_*/^*Wޥ$^߳?]є!H`h8?6?p6rsNR6q._U>FwtC}"K90(())o8k {jiA(qcl$1Ts`9O0Y1[' Œ ڋqutrn  g de7o&%~E?g_2lh c׋؆q;nx3@JzU24Pwc A?qw|IwZ7HZٰX@z ) kJL8R0]X<@s7 8k8%q0 RH I'pDPUl,!w0^y2R(ziqrs 'n"(' aSp(JS?{2 Apĕ8ܽ? 8 x * :x: YAH 6j!Q3A 4‡LLCC!1 A0MJPAI*sP5O&<, N$%U$s5h#f>0&m@=C4X?T8p#O:@Sn*(i3A6d'NXAz"83OQ(ZZNCiE'BCإQx*6"B|)AbJ;]-\pQ-ݎmފ;.eN/.un;/%n/Ej/ 쯺+< :<1[|1k1{1!<2%|2)2-21<35W93=A =4E}4I+4MfQKS[}u[Uc5ci5aegDi67k]7bߝ7[7R8K^8F8A/8:o9GOPTDQHx9衋>:饛~:ꩫ:뭻:>;~FeFdyW ?<<+<;>;>??_s???(< 2| g(|< G8:,v! Sx2O.|! c(Ұ6!sÒa>)~_F<"%2N|"()RV"-r1Cl 袌f<#Ө5n|#(9ұv#=tWq!A<$"E2|$$#)IR$&3I\"$_"(C)Q<%*SU|%,c)YҲ%.s]򲗾%0)a<&2e2|&4)iRּ&6Mq C0dl!go Ș<| k!'12 SB@M{4伆1 "Y 4A' ,C@RHaÇ X!Y(L?(3)S b*Tpi,F1,q/b @xPdYBCaN$$ ֿ hH88 XƘV 19t0U B%xU^ "*d q] 0#}t2M @0jq E/Pj/ Y-8FբE.t=ӋEt[q֣ eR/l]svq.l5}/|+ҷ/~q\C6IK{~ ~F_03g 8=,⇘@#F d! a` d=1‚+16MB}) o5E '؂Ad:hAZdԌƌ9[L40t)V؀]ab. 4xř5]іm/p1 X9qY?Є-F(zv@-bIڿ43MsӞ4C-QԦ>uR*̀!,H*\ȰÇ#JHŋ3jȱDŽ1Bɓ(S\ɲ˗0cʜI͛8s괈h v JѣH*]ʴӧP*kXjʵׯ`ÊIP~˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟UXA}U߀XW~&\!F8Vh5v13)&U`@/R B tC<GԌJ@@3A1 *=fgMAl#PP<MI:L1*@a$0Њ49q#@ ,hR$@""閘fU }0 AHT9P*LO4@X@tK1)B@Z3zH Akt)B@%-ʲVkmR6$@Р(EYHQ,9ɝ\AC$IP3atʬA2'n(P!wߵWLS2`,5بM6)4O:iM\6H#8MaPXAE%0=",@1@@L" U@!A t dS8`6mQ<!Ȏ/Z+7nT Dm)^А~.w6slAH*&x%fnECrC3B٤-{n A Nگ׌*, -7@ca,X>ߒBظB $ _ৗoDzPrܼKD76(G=AbCO7pw<SPU Z4]`+( Hwzp hH r p0'H(,U&CA^CRK! _A~"!# A%{`[.5:!.vE͛ ^ jČ^LBF1/2GbxcXP>4Rx2Ld\F&Q$'IJZ̤&7Nz (GIRL*WV&Er,g̥B!^Q.KjBEzLb:32 )nΒ8Gi c:v~ @JЂn'0B3Ѕ:ZaXQل#v(ka@" RR c 1ҚFشNDS; *na dAHOG$)T Tͪyy(xZ x$Uᅣv[sh\J׺x{׾)`Mb:d'KZͬf7z hGKҚMj-*Y )/);X  ^-j . Z)Ռ@vQve,Mz|绐~ACƀzhG;` s?;'L [cN~z1~8GzX[ϰq1Xj;x@d#4$w Ř8!c=@foc=-ۼIw1鋍yπMBЈN4p+\Eutzq!LI q-uӡ釨G=SVOK QAYAQXFaOY@֗QLxʰjBAA(~kBd+ k&m F!X]mͰ @b?ޔٶP6&U~2WAp1L&.x[D3 gtV&OW0̕ h5yisskg{ڡ6?zfBPZtɡzշh} G>@^:?$jB xpԾv e^)AAнj\۝QyX%!fU{o!G#,O40a=Y>xAA#Їÿ&< xQw|xZbKA0#G?0tH2'[?OOϿ8XWbe8P!#Pc!X O 8_2 #0w5g 4! EN`& F `&|4(Nΰ s78j "mqz P dw .[*f2\O-F X6 iH}E@u(ɲ 1utuQ}C Ƞ8Xx4A ȉ5k|ax-hQih-lOHtHO%XDHO]،8XxAظNڸԍ(N4MxΔ8L؎HK8TJďڴyJ9T9J yqK4IyWGȑ$ ؀Ra P23Ѓz* (/e #w/2/1 Ԑ 2 Kb@QڰP =UJ@ `GI 0y0QQiN *  a v3@"P 2  Spxbאb$.0C295]!LI`WqW yME5JoA@p/'b" _sn( =51R@=.u4)!:]sA?NI XJ=inx[P6#Q`q}pU -ў =ˀML YJ: ~9,0gB 2AQ?`{W@f~U@HD$ 5/*  1`( B`Tp c@.Er@K4` Њ4$I7 i{ 7S \8 RѠh(Auo5 (iUB"K%{JR y0$fZY+/&Uΐ Bb֐c^R ĀL L "7[ XǃNV# N WT6 q !\ZJP {Z ^ J DՕq; Ȕ 5 o{P;pB A[ 7INp:nPM ʀ({,Lzq6ZʄmaĤV' BS3=Nô1 j s(P]àL[T~ 0$ւSm:_f+0^ ˚~i4E{G[D۸{>;{۹;[{ۺ;[{ۻ; [qȻ[>ۼ[h; [[6[qK껾Ѿ 1{sU[e[̈AǿZ7X=#L_b=zmwwH."~К@4 q(e!ыAŗk,Xɠ*A3b]ۛ!x|s,h| j#G,:ȘXpLǙAzw3h1P,T\[f<|&.\9V@e@f&!dm ,I|Ȝʌ u\^qb q;Q̐N!eh\|l qͫ2d^,H̄۠ l<w(Y%a L}MgL}lM !G"d% l2p Dŀ5`!蠎e[ ېٰL !+v@ +=#= X4]h:=/g ĐDDM- }`!q_TղP&`,+TPQTc= b26~@yd׃Q3ې`8M jm#x@bpYҎ!ב S2MGmaD!&N{!J0@% i Mڟ41pE %G f G&1܆1z!_=c +&~ I G>  ">$n^q(^*.014S7n;  >NaHLNPR>T^V~X&a`Z,b`^b=́hjˡnpt^v~xz|~>^e&p懞eBۏ^eP ȠW}驑%נn颾>^~븞뺾6 蠐1>j!PI X Y qBְ B.Ҟ. k !$W.L2G( ގ`p` a*!L aН,|b|@d2` zP\ ^^5KH ?@ o%*€ !l"zHN% Ҷ1v*3Z䕲 & wp!F26*H?$)0 @3 ٠3! 96W! r[1fo < m:݂fLD;6 V;V<(J @r PQD-^ FRH%MDRJ-]FuW.yEȄzy˧]5_ETRM+tUTUwOx Q.*WmݾW\u=/G\}E+X}ֲvbƍ?Yz)_ƜYfΝ=]rMFZj֭]NƝ[n޽}faik\r͝?g*|  1G ȡ^x =}{/_|=$jAڳ>D0Al(`8a `A 7C˯! `b0(_1Fg+? Ip 1H!$ȕ# p6 4J+2ぇ#eC "z @kdM7<#Li9DG!NA%\LYF><C/4SM!'P0G?H!`N;șMgV[[* !XRRe 7X\Veeْy BZ&iacYg%\sVZjKEiI&l isL-hZ_g, l7b'`먥̘E$`VՁ,8eWx G S OXF\:h]FXF`: @`(% P}fmS"Hb`x ~;pnjk!AlLbU'򽸆ˆHtOkXO^uoǝ$էm:#b܇'x&$.Z/ p7zy {dnzGzml`C)pULN?)_ "N3 π"j `%8A VЂ`5AvaE8BЄ'܌QB iia e` ;Ȏ j7Cpяd 9HBҐDd"HF6ґd$%9IJVҒd&5INvғe(E9JRҔDe*UJV(se, Re.uK^2)e0TDf@1,3Ϥ\:9̓c ԡjv.fMr2GT}ӝ2:_vҌ^\TxX91#O{etXL?F@(gEBj#]eT(ԫaڗc=݋n#؆ըl7Mn,KkR~(t >#*׾o~_׿p<`Fp`7p%z:׃\u vc*SūLt=hBЇFthF7яt%=iJWҗt5iNwӟuE=jRԧFuUjVկue=kZַuuk^׿v=lbFv}p4`#C`.ۿ~v"@ װe4dNFg'Bk;f6q|vb>rf0j<7p7x%>!@;tyE>r'GyUr/ye>s?zЅ>tGGzҕt7Ozԥ>uW!@ϵuw_{>vgG{վvo{>ww{w|,ZאxޔpS1;^Y3*Gp|dBD%|G16+$ @$(;k bt! >B`E4nQH~2P$@:@'\ h Bg2BBX$DAD1DhGBM?? - *B aB a` Ykphhb>Y0e@ X_@>' |$\b ZA[]AFr8[_ 3 ع'\1802ذ.45d6t789:;?CS¼pCO @,% 4QDi,`@DF$HBDM7p*L$eP`GHfK;Q$+\$5?XE_ۄh+c]Z5)8*#,4ƦFfĤpID(M¸t$|:/vEyz{Oڭ|~3Cj !,H*\ȰÇ#JHŋ3jȱF@yIɓ(S\ɲ˗0cʜI͛83jh!DJѣH*]ʴӧP~ `VԫXjʵׯ`ÊmhiPMƪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȳ•҉Nسk}-"?KO}?(+B 6X,"Vh!_vWRˆd(8T7 @(*h/mXJD#@)E2@L5L6@8im36ʎ *BC`ipQ!`J2Ų,QAG-RA $Л1A%9Pb,@x2)B&Ejʁ,a1ellE,AݬBK"R(H+{Y* L:, P49J$kP+8P4|JP|+)PLD b/BT"$@*g|@`:a8\s ?HӐ>h<ɈiBQo 0D &*p@ +@% D@ 5%N8`6}8fi˃M42f4bo3Hc)+GY+p* *ĩ@D&@4ʭm-O6n 3p7:&6hN8]7F~뵉Hx,=X*/+A!fJ@+^_-4xoE^% AˮR_w, Џ ,@7R[ڐ/L _;'p,Ă`Khpa^+цF@yz$!%(a Bkp"^A&$" Dr !(D DԐ!#RHźDR.DU b;h 5\6^#HG x, 8P>, fHBL"F:򑐌$'IJZ̤&7Nz$ GIRL*WV򕰌,gIZ̥.wE`qD6A ^ ,PsiVA4Ya.QtD7{Q E0N^҂9A~zJX=󟺄<JX1,BІ:D'JъZͨF7юz HGJҒ(M)GO2OgXJT1ւ\#F9ڙibcjAFXC @F1~'Ȩ]}\AvhMZ npm2dEڕ@Jr0/P`6=B |ᰐuOFi^zq c@ 0KZ(!/ʋ\ -Yf F^ֶ.2dMr\B͍.qJk+v{ xKMz|Kͯ~ NXbN[J@S~0r ys1Z1T<,碵$BabgL8αw@L"FNr%;PL*[Xβ.w`M-(b0Ylv3͹|eb;G~>?!OH.6H3g%3&$!ӝL:ּG Rr!<+tN^iv"Mg@<una<;׮#-U t&?Sձ yvOU/>'O[ϼ7{GOқOWGg֮oG Z0Wd H>|D:qXU~%.cF2$>D_+:rՊ|ioQF2UTvGPs & vGdHUwT oh%:%f5`)Q 'eu6c5M 8.h1}}!@6, UePNFP 7EQ% 20 8 j!|1x8e/!U X7 [X7ŀuYwؒZHHK蠎яP/iqr CU@((HЂЂPޔOP&V HQ, A(QPŀ )I0 K-AoXV& A[a(~Q- tEULL 79K WqH9'Y0 e;xW@VHO4` \iA x͆*5=IƆ$|x>'s`L^[0 !DŽ@  &>it96 3f X1 n0V6 Ky)vCd 'PQd_ hJT5&hawa)`jQS) °!) `%`.0/N״0[u ip) uEOAaMM WE `pP  ( $ )f_2&t2aVTiN6%#*6*Q p VU0  Z_MjЛN p(qQ `eO!5a7bU uxxz_Rq`VQ j#cPei#Vz/6@9q:Zzڪ:Zzګ:ZzȚʺڬ: Gj#z*ڊ"ڭ!y 1Py UQ:r үJ 2 {  ۰"o fK*P 2$ &{*-[!,2K4[q8:OihA+]0سUBGQ4kZv;KM Ub2.k |HWs(G鰷3U6$ifzYybPn]4 @{w"@ g;'f~kZQQ}`~Yj qQ}ۻ˻ !~K;ȗK`Qw[»`Kk$#Q!a p J0e;" x| P|qeZq#AovP1!uL t! mo5%<p#L8({]2Q#6_q t oR ϰ l [ }v oG<9L2 ozK,@[fgD[}7P 41f 166et}纮%o|<˶|˸˺{˾W aܸ |yrHڱ]',y,U/@|͘ؼ<\|<\|٠%ϟ+H 6 =]} "=i%( JL҇@ 0.ғrf0G4p Y |U+HJ]+ԆNMՐ1TV}ՌZ\Ո`P={!f=hցln}r}e]tAx=C‡#U\Kqԅ8 <A(п3؇x kT0x ԰"6! Ge 4*Cd.bzh Zc |&HQB *MFf+ 0/5hDaU`!Pi|Y @J! }7Ca] 0Y!` dHA` PiXVa +1 1Ȁ F P%/V "8ۆb } ) -6 }V -0~ղJ2 AN)ap;!ŐZ ^4a7'LP ~v(!(A&ޠ"?06 /=Ơ ]YZ VaF Z`a 2 b^ r 0s]  j BTIE |1V3b[[I by^buP麠btj nZw|jFĠ 5 S^ à[P:Tʰ Ea3w ޛ`][q| _:* ;P Ea/NaomaZ%b&? / (UQZ ~S/PcQ%0o%o&?(FQD-^ĘQF=~RH%MDRJ-]SL5mٳl"B~ )X`…7>UTU^ŚUV]6lȀRB!H\WuśW^}{M0r XFI#Dd.\ XfΝ=Z諽. F_.ӆQp"m|93i޽}\p3]&\Z!gH7z#7ݽ^xQ'./Sw Syyy0@9;O9pÅmY&0:۶m@ /0C 7Gp)c -*0FgF;.5E]~&q䑇Vh6F'2J)T)Glv1\Fi V!ЏJ5dM7c/ Pb@^|PCE4Q3:t3b R`PE?5TQG*NjtTdjYZXK T]wW_)2UlęY&B x~6[m=~ GXPRc@[y祷^ 0(rea&_}b!! bG&dl (@ˆ.hLgnIihp i0B stA\:k@hhScZs5߆;zM:"(:~W;p".jXp'PÿF<{rG'/;sܡ!tg]{!#"g%ra{G_" J!ҧ~SZjik`n"C @6"t&RVЂ `.AbkE"tЄ'm06P8CjO$ PЇëAhSшKxD&6r9tb(nWbE.vы_c8F2ьgDcոF6zscx!8mwģxG>qd>7)tOk(%r!(&lçuU*d uܶѐ7JWQIJ2;vCZ|*0^*LZHTH!X+׆V ^4d[5 x5#hPgY *63FWȡ!lli #FJ"%x+ۃ6T@Z-%x!%`WZ.v]-\|ѵg"zf_Ѭ6d~WQE /iy]+:D b|3'کpGxp7x%>qWx5qwB>rqHɪ8d>s7yus?zЅ>tGGzҕ.p4Ozԥ>uWWzֵuw_{>v^h!Jx8]6`r}N|?x<o.gI/$?yW|5yw}E?zҗG}S_7}e?{}u{~?|G~|7χ~?}W~O U H?Of!Ap2*i^{C 9?˝5~0ǿv0$phPY3p._ |=@,+ bs@ x,x02zĈ '@H`'![?!L__(Ye[YBXp` aa0ZB-[C-bxӚ,[^AB]CdbG@փJKLMNOPO E-:E*U2PpE.C<)KŬE%ͺa(\l2Z| %FDw3S8F{a(/E,a`F?68[h>>{<C5X@ۄ[QhW*|>o_@h ($b]VZ6Å]軅3J|ZHCs3|H&cɖ<2\h2GI&#I#ɟʠʡ\>$ʣDJɤ$!,H*\ȰÇ#JHŋ3jȱG>Iɓ(S\ɲ˗0cʜI͛4jg>JѣH*]ʴӧPf+|ׯ`ÊKٳh N 0I$MKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μl]УK˹سGËO^l^ӫO˟O}Ͽ(h& 6*BUfd܂ -(∀K'^H,XV)K))`*.HR@XH<i%1@?HF)J+:, &]JTi#F8c@xEB( YA~'8JЂMBІ:-#ъZͨanB L* (/Rd%@jыEf! 7b NJԃ1 EP(ժZ5)wծMXJֲhMZֶp\J׺xͫ^Չ}`xVi=b%Uvx 3 9 ıR,g X01ihV6=mAhh- : }õŘiU{9i1KIMn1 ʍ.Rp`ˆ?v4S8 IX2Zmj 2̥E|!d(pAz7a@C .pO1 R\ {>(HXb,>"~xWtHqP,rȋ[hB-a /F[,JZUl) HNr]q̢ʊSS-9@d>DĮE#8. @?gfπMBЈNF;ѐ'MJ[Ҙδ7N{ӠGmMaP)8H)~qGR/OU2ոKނQ WsMl]4\addE-nje.2T aMnd!0wvMoNP#񭾏ct!1v7?Iҏ=c$ϸ7{ GN|@~T5/-M χ!}Hѓ"+ ;@e?wqGqc]$!t2\ 8{f.r/׷[YynG CƧyC?(t9rѓOW\7c?{ϽwOO;ЏO[~},}ROߧ_i]Jg?C d4zlatd- b -GwB6 h b-q[6t Hh,01,q0\$hvD0q+8i286&w у?H%F_G( 5yű/381OW 'T95y]hXexg8W"> fhqPkx(?w(|j5ze7e 9DjHhf0fv)P቎8 B^h,}fvVZzZ UY؊vxcyH-w(gVňȨfƌ-Z&Gh/ꠍ~Ǎ(&GqLJ`Ȏhf۰ HZWxY7a>Y) ꀋa9Ww"y1'P- wezVU  ; ! &ɐ AGp*Y4V&pQpoHU (stͲ^Iwh AxSP-QbZ#r ,V 5uQ T )in9f e~ie 8 -ls A,R I㋠ iIH1P A1@ Mi AOB~ڰY ;yǔDr 깞Yd!9\e \U Ȑ\ IZQ ٟMT(sB `GTU YZM `{b A0 eiMt sV` aKӗ%Tv YFJڤN*QsETW`WWנ[* y6c_jX g:~jWe5elڦtZvzxWi*ҡoŧVjZ0 }:ciuzVJeѩ:V꧓:dUڪ^*VEj*UʪzU::TzZUPv"*DڊSڭ6~u R WZVRZqL Alu tԡ",n)^zǶ>@ S # NӡYR5aZIX ѯ keʩ,Rc`ѓEN3 ;M +[y jSI0a 1YŢ CPlo9  Nc` q0Ǧ5[ `/ Z %"L,;p@U8 C o\+Q5JU 3N  ph+ˀ$r"Z4^)#[D(\* qd)Lp QbY" i$k&0H\O1a K2\5Гe Ƌn0[! 006"&0 e1Xb0 F€\ uk#+%G>:KK[ޠWQ p"\5 ` LJT `4q lp$ @^@ Zu ogs1p3lc*X*aSb7(QWJe q(62 k0 | 5| Pw8P3% CC0SK c3S 9s0VP[J` 0 I u|  0Y9" p " RHP  P udzRd% Tez  9CW p )]_5fgm ="Mytg_ !"~wYK۫jɞxzqߎX2  ׭ߜ͚e!.En') -E6Q8- @.QB>UF~,IPHN5T^V~XZ\^`b>d^f~hLaHg6l?r>v7&>NX p>voM 陾uN^P0p0 m.0 <. >NP..)3 NGlǮƮ >5^&Z.^Nl^dqn>`1Q0X NQߎmre"d& !ƅ[7*?V,.0?_qٱ<>!CE_:gyNoP?eQ@HKGccUpuApFadP.oeI%+`q{M9"Q5o$悯2 !Ooo"\)z5^""@w J/@/$WM_D_U:Yd;?# "/u-a$q-_b@/@@ DPB >QDH&d2~RȌLD2I-]SL5mę`KPE(QM>UTU^}ӧB~KbRmM1ځ+ǖb}śW^ZX±ϖ6qL&թsXbqٕ*OeDPYt֞FMZ7~xܸ?\p,ἳƖjrd r\]k&P3nyorf{u(y/t @mn>ќ `6rS') 㐸  ( k"0P,ģi.9 f ;W$BYd7f 2" PCš:8QqXFF1Q&g #6E qij!Q xFY-OMh @0K,R4p*%(Jg%i BPS;OeU=3x'[ vgy矟r觧ziL{?|)|g?nۇ?~}?~`?ЀD`@6P/s`%8A d%ۑvQAvt+E8B؍' P /a BІ7auCЇ?b8D"шGDb%6щOK8E*V(RbE!1_c%E1ьb$ոF*oG:֑scC/яd 9HBҐDd"HF6ґd$%9IJVҒd&5INvғe(E9JRҔDe*UJVҕe,e9KZRR-uK".%/9̇l $f2i s\&9MbJe]aӛf79NrӜDg:չNvӝg<9OzӞg>pӟ(P"-AP. uh?!щ: gF-QG/Б&4-)ASГb6hu)NE T4@jRTOM*D UNURUn^*XjT&Ħ9q<ZjFtmR@! `"FGl0>%6a Dh*RzZb]ȘF$RfQaBQX6:&`aZ60: tc!,f0&2'9kB` a'" zs`X{lC!@+a@1P:S-e@`@@ ==A(- [@30>0 젎[= a(űAu@@XX`@3da!~;>+0vi14BrpZ@_v) C=P QHC9 s+ȿPCQ`5` < Xho@`^B0pVD N(J<a/,"x# )LPA&ā0W<؂UBT< ^Y[cYȅ`xd^ D&!ă[8؅\?w܅Cf^@ȄDH; ]xZ0s|Ec>rDa&]\4ǁIYX>THn銉a!5ʊH\X8FXJ bk\DePH]ȴԅYpGp\]8FbȅaIXx!JcZt7|FAHc؅`(ʁ eǟJ^4Kô[ɐ,u,<̜lHIԅtlI 8M N|!lĤ&qtrm8i8J\IJ\M4䊁 ʟ,/Ou{NNjxeN OZO[ZmOINHЃ0ЄhPtkv{΄ig ] } PPUQV1Q ]œ EQQR Pe# UR=ҁ؁%h5 $.& "}R.2 g_DR$59 4}a`#(? \$dX#!0R@uԯZ`X`-mGTxNi(pR8FT$݁hpNUZi#T}XZE֙xiJ " @8RcMmUVp\qCh"ke(VYw}_\X >mcׁyW\OrV XXuW؂']bm@ !# ؉%YWŅ_mm6`uRؒYxNqH\kl3 TWٛUZYM[d ֥ZqHX30 HZ%ӮہٰMIePhX%ָ[}t @j0W v-ТX?P^0H @]?X:缆`X(d Etݛ]bpGb@ ( H]T !  dé=axl8]`-m^Ѣg@p^Uc-SHl8N_G__bYс_pM?]ލB9lT%N`~ʺR NU ߈aJӃST2^=aa hb #Vb~a˥`)U*&%b؁'5Gbb6$ePUKc$_0v  ;V$6n`- BVaCfcF&F&HHcD@M5V_On䂀QZMKU(fed䁀TFe"`[VZԵ\`ZEWbZEfa^^hf i.Aflno6WgnLm5s.)UgxQ>q6hg!zU?\(Xe}FVM`vT(30a3h/MR+04Fc`gH^R%#؄0b-\(h:&oH[VыVP$pVkjh.2~i3fj ] .?MRi [NHLVuv jjEyxjL8i%Z2+(8jWJ5 g‰mq&O1hc8jfXJk 6gv4>Ul kq j>ޤІ) "p%@>f ^ zX Th } cv|r}wpww x7@iHkpq Zhuf 8zgh?oIs8ڠn oK'7GWgwׇؗ}DśqоH8Pٿ6w}xv'h{`}`0@C$HQ } `,~i3@_dP|x|fXtn_~(h „ 2l!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*WlRܼmio6~_qv`OJ2m)ԨRRj*֬Z?n Ά? #0ִjײm-ܸrҭPܸI*'Т:uv.l0Ċ3!߄~/nl2̚7sY%P/?ҧ;5زgӮm[hMV]‡/n8ʗ3o9ҧSn:ڷs;Ǔ/o<׳o=ӯo>? 8 x * : J8!Zx!j!z!!8"%x")"-"18#5x#9#=#A 9$Ey$I*$M:$QJ9%UZy%Yj%]z%a9&ey&i&m&q9'uy'y'}5c 5z8\(:(J:)Zz)j)z):꟥V4A~Q -j*WH3+ ;,{,*,:,J;-B"#<%+Fmh3M"Z58׼з{J  C;0 Y60PpK<1[|1k1{L!<2%,At2-21<35|393=3A͐A44QK=5Pr5Yk5]{5a=6e}6i6mv* ]uEp}7y7}w'28~8+.b-,Υ-[~9k^!!#y1 B Ewnf3^%:>;~;;;߮z<+<;K?=[=k={=?>>髿>>?????(< H+HB F|@,!x$5'(/AG\!PD/bM<~\08hT ADpH 1!}LH AG Š `h&Ib b 0-\[ 1GZ彂 ZIJ 81}%`k/j˄.jL"t03Oqvs.2MfsFEN73Q7ىrByρ=(BЅ2}(D#*щpXD Aэ'(5ё ISZMB$Jc*d 2g(:"OCDAiTXcNv?}sYĂ89b9P<}aBd*Qxh\3Ƀ, doa% RHq#qM@- ٴ$,\ \4+mBxQ瘆̅ %8BmKdjEUfN+q۔t(Js+Rֽ.vr.x{!1 !,H*\ȰÇ#JHŋ3jȱ#FCIɓ(S\ɲ˗0cʜI͒@ɳϟ@ JѣHB@g,PJJիXjj駁rKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ NK$_μA*16{bpQË'x @3ǫ_>8A 6$pRtހ(/ T@2,.⋁fd@@KpK-raO"/0(`L a..c#.58L6YNF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駪 ꨤ%Zꪬ0r1)#,6ċ/*-P03 bˇ+)c D29+sˉԖknA30@ W0 gH8̡w@ H"HL&:PH*EV̢.ʈ^ c(2fLxШ6fns(:ṿp>~ $n)BΆLdDpF:򑐌#HEZ!̤&IKzR6(AQr3<*-U22|,Y0.] fcz)b҅L[fΌIM@ش5ͨl<7IN3%(:!rNcTH;Ixs!>WO>9=d'AP,#x:jχvh<-t$H5őT&=JҖ$.GeJ_?!Ƀ @=kJԊ4My1/ (T%T>:ծ:7 y Yh@Z&Cx-ZoӼU{+YJXMbXgJ8ZU'jdmCK?V֮vkq $`oDkf5:&JdP56GvQO~D4\vkϠmq]Ĝ%C0 "pځCpq-MtL`:L1V˸툰@ƀ)r R̢DE@ U UEN ?EEU8dy@sqec)1LksP.b,}ģH1] PO9U)p5J O쏽fR*Ϭ4:n,偯A4\2NAN&H0jB8vBVrghLkұ%kC.l [Ӛ(b@Ypu`m)QLRc1Ȃ `RU؝:va N%M~4~25=I-ЇxCUIY[ۤ*LF&a>h'7 oJoP"F8~&VK:Z6BzFA,)qc0Ug~1`H-Q8h<2xn43H# y`#E fTvbSljT; 9vƧ&5cr(p<펹;iIc+T.xH|a  {w;3ߖ'ϖq~ḍÔc>L04o*0~.Ǣ7۩H5åf}QlʕV璇i`2><[v_G{otu R~ v}pFPs:7nfsyoql@xbx;g'HhwbwX{se0H(X."у@NB8TFMHմL(MNRLTXtX(LZԅ^K`4d8KfxjJl؆p8Jr8TvgbzK|؇hK8TJVgKS?Ȉt;%C8牏(r(Q/6nPaq&M@10(c q9`ۀP5~TNB1b8’0J?u[#S zw!mq)36 00r,A~S c`-{} z954 F9p 1r @A2 1 ϗQ20 :yq<@\p_ 99QeT{ 9♝ 虞iH9΀`iHY )HŰE.C!DP j$ (r*GFjF$Z#cf*E,ڢ02:4Z6z8:<ڣ>@B:DZFzHJLڤNP$0T:QjCUZWZCYJ[JC]j_*Ca*cBez1 ?_Pol*?˅$ XoÕ |q!\ ! 0 Idd @Yx˅ 0?/&a7M߹D0a Ȁ ȀӀ C6IĠ~.jDj :x"6Fym 71 `YCDY` k&&`[W09 64 c YD!IP:h0*va # 0#pDnP/ Q g9t`(PU٦"7 D+{0n` h@p+ aWM!u2`Ί>S᫥R ͠W zhEP P@ T!bNbp  fK)t0BI  cz[ \ip`+Bꊭ 3 vtŽX$E2uKka *96kG% [p Z )"HS Ыa 3=󽋂  c u# Ġ Q R )J"9iG€p ,08u˅ wwA>a xpl C 0p p G=Y h" *irl`HP,`"tZ|&u ג0 d<> lhbR|I<w,ȏ" ql5/AȘ 1#qę@ϋɣ^L!QRᨢ)\#ywlʒʦL d˜0<\|Ȝʼ<\|؜ڼ<\|<\|=]} u{rq*}ݔb='pn]i0Zi]e$&쀸nRV8{8]&9%cjTpsDMDsH5,ԍXYV-&:׊]~b=&&ZV_Z^enZr=t]v-jldw׀y{eٴ݂Ra܃h^ဨfTvY0^(T`V\{JHVC5 5=ʲ k7K@Q>]KHJNPR>T^V~XZ\^`b>d^f~hjlnpr>t^v~xz|~0^x>~>q镞階^Р1~Nnl걮.鹎꽮-yʾ̮>^־؞u~]1^N].nON_Ju{ H, n.+2/4_.8:S>@?Ԡq+GK_~QSU_W[N X PRTV/X6~@ `A 탟o?_N?Q/O_ &?_/6oȿO/ o?:)_aɿ/%qM@ DPB >QD-^(1F=~RH%MDbʕ([|i2fə$k)2gJ=}TPEETRM>Uԏ;AZV\az XdEVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ݺF .4ӆ?O$ 893J#])%j 0JdSL%'żLil պfxG]oҍ*%W~ qBdKha{MUP}V<]t!Ҕ:$k<5:- pqP @Atu3WNV1TxnZN@ r1w^zv[*uNY8'Qv5\pH\#^@e_"& [9(IpF`Ү=X0y(p3ChFlniVfZ,gHn;p&Ǿ)Ϣy쳗Np')?R\˖+=t}ܣ<7rFj^u_'NGRg؅=w[#;Jyw'~wga(槧(~Y>' {8|j\hAa|?m~ohaB?3@6<Z m؟48 8q,ZG:B0:|E PЅ?o:Xx@bK;"8E*f=At<Z5u(갊gDk2\B ?6-eaӸG>fU`/qmP 0-dq(ёc(] xY+d(E9IF0@?mAn'A9JZ0+Pf8jC HіDf`p Z00CgLnv.*^a 1h 0k f<ٖ+ndxD`_0@ (jPL<ӠJ=)D,5`Wt2C'B5Qthb!@hPa<Ge:Sx X `B' zMԨG5MAj$"@ h!hVU~D1q cI& dzj\iJ1r$8n9ptni:؍5o l$ld I5bc="XrVEaW.#mj)Zm[!%dU;Qt$1liGvv#Y!jy;\Hw+jg56ׅ=Iv"L׹M#t[Zo nQ9b}.pL@po~ߑ!5B(lлE0[H| MpT?Bdt=hBЇFthF7У%uTzҗ> "miLw4ؙE=jR+I uUM=B?djZC&C?jk䁱HGukbwv=u { mj%Ӯv\kw=nrFwսnvw=ozwo~x>pGxp7x%>qWx5qwyE>r'GyUr/ye>s7yus?zЅ>tGGzҕt7Ozԥ>uWWzֵuw_{>vgG{վvo5ww{w|?xG|d|%?yWyw}E?zҗG}Uzַ}e?{}u!*=وFV&<$֘F@l 8-] #"@-+  lO(Ί  ,H3`aXNQHd X0M@ qYp;*؈Yb`:3)_>"coYV v]#b٘$^HB[ e0@aXZx%1š5t789:;<=>@Eď(D @H A@DpDXĐXAMEC|'i l0Sdds۔>S؇k^ũp`F# a AElFUdLЕSȸ裆oo jHjgEps9G"cd? n$B|ƞkhǸGd6 tdȆȆԒ$韢@$qi\1HIHߠSG0Gdȵ6y?vQȆɊɂL|EH+1g!PyI(Ihi$,WAy)ȫJz>ǎWG(bHdXB{Ű1}ij 6aF¨G. SMQ6IaG*̞46H#?H K ?X  R$,#XBko v1Q\Yhx@E D(䈉eɑDcH+[4 I*fXJ`h`R wDQhX iý [@0$R38ڏEA=R0%,@  ^ȅZxؒq-_h`ݐR݈ohh0x}W:^OI}A u*(a=$R=ZR XH^ȅ\U6U&(Ch]愋bb"U4R4PU<ƙpSJ4Ze0J0Y :UTpl a2OM C ] bvWPNXVQߟMA?e˾i](؍PԆݍ0^\A*. )XS%HW ,pQސ r6`E  @\x`z@ 5 C 5nxH'fHbN݈B ! 5vRV0npQ؄vY \[PC.Zx֔@̍Rx1$]d"g[^vk5]P뚱[ZGuވ腚ލ|aBZ ^0_8c\@YU% cS{]YYҎZj%Į\He\ mم,Qkm!b=0pXmf ~oBZƆ ocI Xch92bvݘ(W܏8n.̟TvphZqw0R qa5  +]Zf:- UPZrV-s?85y<7 ;:8ՍvB_BX&Z}Q*u=$A$4VCTiCTAyF :ēăАP 5 ŇɒM? l&j)KR%4ĉM[6cjĦ,eqy'ʉ#S\?c?L6YBȤBEx8s5{Mv<ȳ?8~y*B )Rsezl e#N>B<㍨MVQ2H QJ 9e:,p&'3ceBO{<#\6Nυ>KAê<UDj{wiۯE<0F?k1{ܨOABHhr&21,8V_3A =4{)xDK=+4QK=Hۘ4Ѳ8q"QIG?yH4$(Kb2 (GIR SJ};ll%^}Lc@.w hCrAv\_jG;Y<~p 3NcrqnzG fwz/;d ]t z?y󞏌Q,NxS(>YάqjB]m ECR`,4 ,rQ.ʥsv8 xԄJ.pd<㉕O/؉Ʉ7VG3i"#C|:TT:5d&ţz425\(J] 6!D'A*P*H] )0 rqH=Ѹ}$%I>o  IksAo7oX*14PFV ~ mcpaq1s c<1-0u S% X&`Au8` (8C @ba MV|pq4 l6rр! `43<ݠ@7u Vg plX qn lhDpL`R5cypk mFbPpgt)a |.~4Ra2Mw p3 :p m& ÐakԆHM0 ( GU # r 7 x߲5C %2 ք  w@ [s 02@ " f4nV.uRk2KUq5/Qv w(l$C@ ذ.a  )` [(@QPcrL H00 ! o q' O\pLІ)4m 7%hD t &57rw#l)P )4VH#Q9MdtF-  6"hyLP,Vv0w"CxśsEdYyșʹٜ9Yyؙڹٝ9Yy虞깞ٞ9Yyٟ:Zz ڠ !zڡЉhm^ !  }D7DAz#C HjJLʜ֤Q*1O1P^h1P^`jHgjbzdU۠@dvmjojrM&wD1ObHp~c!JP6O:VQXWz* V ku:lZD !jD*Rja `4#HEJCZȸ  oARAL _?YEj$QhjZp蚮'ڮ:Zz\aC}$:[y_D*PeIR{T6WP PkX;ظ:б t:&{(*,۲.02;4[6{8:<۳>@B;D[F{HJL۴NPR;T[XZ;^_bd[Y{h˵ in p9t[qj{}[+;shD˩붇k˷뷓 +K]K)[Q{ۺ+;+ qk{ûŋǛ KK˺+Kkً۫ ٻ [˼+KkV+0)Ԁj1];]\q5 LKv c!Kl #̽%!)yi ,|K$&(3|g@\S^ĐĎ+QLŒŔ^`1dQe|hj_npsuۉ*|,"A#ǀ<{Dž|}<Ȏ}Ȇ ɍLɏ<ɘ|ɜ,ɂʁ<ʄɜ\ʨ ʦ\ɬ|ɗʙKܶkoŖ˘˚KMOlr+˵ SUlWY[̹ ͻ,ͽ<|؜ڼ<\ yƖ ` Sβ!hC\*ϳ1 G & Fmˀ jlqr-P }3_S `ђ p FVϩ-|j 1A pmbH9n iy_e9m |DyqmiГ! mIK3 RVM[]],2?3>a  Y>ՇG}i>;.NyDbC9\ư&tx p[X$؏m=ؖ}T2 Ґ Fڞ-I 2ڥ ګ : t@ Dڦڪ}۹  LP*=۵]ܬ}Nw I0 mMMm!" 20 @ۍ -KAޱL0 Fp] א x6SM@ 0  M  =0~~  Ȁ 3NKὀ 5f` @ ? A.Ipo0 pR.0a0 0 N { `Z^ pl> T@{ ~ 0 fZ`Z`oЉ> @ b p p@ `& F S~ nLvP GN.1&`N ?.8@ (Z ێ.#" @ @LP ^DP bP 2@AP`0 }N3o ?%o2T(Pv ,2_4_7-^>9mv9g dS0a10meZ[‿AC_kgO4k1reO81xozlp17 /2p=@/\}h5|C`6>BquaO6_hA6?_ȟʿ?_؟ڿ?_?_@@ DPB >QD-^ĘQF=~RH%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DOD1EWdE_1FgFo1GwG2H!$H#D2I%dI'2J)J+2K-K/3L1$L3D3M5dM7߄3N9礳N;3O=O?4PA%PCE4QEem)j]NkR8)f:Ai9jH]3fnB&TKE.9hO:&8f(5:T`@dM.䄠$ XjfZil)Z !ZhU*E_ҍW]ސV%؀D _.jMW `bf F[΍` &e͒wY^cdXaReadeMXYYFs[~N灜f:jΠj:kk;l&lF;m@y;nm;SCY5QTx "(5M仦r5)đoN9YBU7GCs 0AQ -*2(2 eC!@!6J}_0!epPaU@3R (;a(FIC"S7b2$V Ͱh pUL uJE pb !Qs)eN$pw-K A8S0$ĀbH@f Lȓ>T~F; IME #x Ae*)(&I!Y ,,LabK"qâ4Q pщB">an 8eH5V, b $ڐd (LT v C RUC_ꃌךD)a*oZF5b"X 1Xy P@ ppGA)dEB]L0j~w+'Nj @$态a UBq-;IB` z,|[Ѣ>I, ctipi~ᴓV0a큘&0YԂW`quZd׳gǺ忳o-.^W_AVV"h^o .\dR6@wb/x q7x}(oAnՋh;ĎI;kq ON-n1 nUu(a01 v6 4xeգ/Dnwr@ȿ d./_d_?C/~FEKi]p[ 30>˿+Ʌfʎ[Hh,S(=狅ԊgRF XgR4; 8:L>`*4Bpy}8&t'~Pu,yy~+B&B*B,,B/C1,CB8ߘ8l;´<x8ÃxPl`BA$/C.\Ct!$yl)܇} R$z R\4MLq !Q4Exć( ؇~`/DBHv[51HĚ`(HP㤂`Q|.hņ@thFCPBV)GІPƒF q507cj48i*DXEh$ `HYt..Ɓx`P(FÂPM}Ċ~pvdN'6qppX'ĆȠL H#*3X`еXH ,L}`2D#qHڍ05ad EC8ޱ`GCJxIPK 1xȁhɚb Bllctȉ9JXlL*H1Z?t[ t)xJxGpi Do\$\\$pHodЂ̶3plL$„[@1ĺ0xr*:@ѠG< XI0JdgІL\](ljGtpHk`еBuXІ *1)mE H1,˄<(ZH YdDz@Sk8(YHjwMȇlxl؆x.Me/F܆RЀ%|ЇYIm0M ޴BϵDZ+-ԇ~SC?? ũÁpCPP mDDTGBuE !сR] k*:%YU:]%^UcEVdefu)bgVyDd !,H*\ȰÇ#JHŋ3jȱBECIɓ(S\ɲ˗0cʜIM ϟ@ JѣH*]ʔQJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸ss >\UУKNسk߮ɹ'O:ӫ_o;*˟O_%0AeSK}hbaK.-Pxfׂv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)RP0T!A- 9P袌J1 )@H^f C:@=ij@)E%͡*k P)'b@2n2,t 3`$Hk`AZ2 +DtsОpa˧GJ+)(aA~ C`{}D@y1VLe0QJ3hA`F* lˆ, CqA4̃=cΞK/#.UѴ _ G-+˷qx k衁m dk 1!`| 3@ز@X ˞6]{ 6aDDوw+ܲtڠrGn9‹ww褗n騧ꬷ.n/o'7G/Wogw/o觯/o HL:'H Z<2z1}b`c(&8B8 wec< bI!q$4<54qPH*ZX̢.z` H2hL6pHDAc х IH*#G?ơ}8R $'I""Rt$#%?FHV\}ģK,X 2@@нm u0-pX3B<0 ]၃ܔa/~18( 2a'`W:n&H|2Lr!ش r0!?!ʟ28`=b ,a?~8c`0gF @AfQ_$p2yƆYc!& F@lb$6P,@8c`nO;MtM/~:a #܀@(OW"'-ss_w@ЇNHOҗ;PԧN[XϺַ{`.WY5abdQ6MLrFXod·~X~P!aoD_Pl'0$I!fHӑNOW" AD>< SFW>,w'G]>0w1DpTDE75GniAFoN$Gsw]z%|ٗYy%9UR9%Q$M$YIry$Eҙ9$A2#y=#ٚ9y#95R9#1"-¹"Y)ry"ʹ%Ҝ9"!2!yڙ!ٝi 9RI虞IYqџy1:zё  ڠ:Zzڡ  k&&b]&:"D]N)! LMBk:A:JLʤ"aIED)ѤVzIjTښtJXOڥdZM}GylڦndJoz qsZ3to%3:z]3}ڨZ dH**HʧU^b YQPgQzYPYJd~ګWaQhJjZd^Ej @$1 PZGD:Qg[ڰ;[{  ";$۫V({<Ѐ)+ڲ02;4[6{8:<۳>@B;D[F{HJL۴NPR;T[V{XZ\۵^`[;0d[f qjKk۶n{pe;t;v{yK{yu˶;hw۷no[˸j x{ qkw KIKѺ;˺{ۻ 1ƛ˼뼴 +K[ ߻K 㻼{ۼ;[KaKE$@xs! , \l ub@ Fyt˾/ 1,3L5l7+9,vP.k024 6,8b$ ΀ pp˷aceܸ+gk,m̹ rЦ!ZV2 q(,Q ho@N !4)i & +u$l J"'< g Cl[Mqo1GX`"]=''3P֪! 0zs Oj c l-7 'OhOA 1=0{ =z0 >cу RV >"-_Y-c=N @ p&iN0(\ 0f 2n o4 p @ \*Rn7t@ c{/4GqH }%1-t0QD-^ĘQF=~RH%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pōG\r͝?]tխ_Ǟ]vݽ^x͟G^zݿ_|ǟ_~0@$@D0AdA0B 'B /0C 7C?1DG$DOD1EWdE_1FgFo1GwG2H!$H#D2I%dI'2J)J+2K-K/3L1$L3D3M5dM7߄3N9礳N;3O=O?4PA%PCE4QEeQG4RI'RK/4SM7SO?5TQG%TSOE5UUWeUW_5VYgV[o5W]wW_6Xa%XcE6YeeYg}T61xyd 6Ů3YYfH $g̥Nbwnx`bWb 7(]9} &h_ s" @a~˜Pz:8Sf)FK֫` af9q&N,_E9%bH\)^yz_NR;ZR󲅖f;oo yMk xC\)%g Ol| @FeńG Rd)$%'U-.;62U %`r Ak  Z[#&T' )3X 2ߜ` V @JB|R AhŠHR(@ BS z / wi !50?uX5A$,^ C xk3#"H -f gr2U-,^`2,=ˤn8/86[M _~YЂEL{2riy[|os \|x |[Ca ^!1v| v#k/g~ e n15iJۍ $>h ' #HZ:.]Э؅-j!+|EN?ȕCR#DS]~gI<ima7XL#x4ۯNW}Ȣa/V,^_P; a!s<8 \y`0ky @%ه}m~ lu T  A}0~AtuAABd # D)qu'+4VD_(h .txEAF x(HtЃVPp`A%$( e ;dc<S6`Ʉ 9龨tkHl$5X" `7 PB`8#rBlHIx@SI8ISl`(DtXEr#vxf@ Jt,0mExvDJ|6ˆ8AOTp'8X ɁL&F oPUG̀L PM'BoH+;< d`pEdq½JbC5*`BnAƙmX͂ԉ|%Kdζ  y$0D%d CtNVAi }PÃсQ֤ hyq`]yC `Qy؟ "]~Q0$-'*'+}xR_q5!,H*\ȰÇ#JHŋ3jȱcFyIɓ(S\ɲ˗0cʜI͛8gϟ@ JѣH*]j1VZNJJիXjʵCK^ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ N|r%_*μF ,U سܴH+ C7p0=b9wWYb Aܲ߁&Y.‹@((NK. FpHP-rP/R(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix橧Y砄ˡ&&*-*1 BDd,18-*jI<$@&jiB̨j1(t /b,HQ D)XP"RD&(fKP z4BLAlTM'p:`^rB*26r3  ("RFL"&⇉Nx(*jV"t.^ #p(2fLmШ6ƆncDHA:x̣G9! IBr|"q,I#HZ#K%/Il|'CIJŌ,)SJLd,gWr%.w]h%0CbSL#̹\3WhZ"< q` gDYrs ?1mgݐNDH:O쳟=?JP t$(h>:)4 ݈8ХL4=gD5ьBԣ FCJ҃RJWq.EL9R3)FԱm/թP)lHMjOԈl6jٚJՅ>*PUJNh 3@ldfM\Ǒ |٪\Zy^zցu]8Q"JHR+6ա1,N-;TMV x c9Suu %jGsRG ^##Mk3;ikۍ#nӆ Ѝtv1ZE0:QFH9v{kh <[A;ŏ?ZLr'yPqpz ۜj 1 `%q9wk^0 <y@@6H$H`GAȐa gGQ7ȁd5PVd;c(@dLe?v!_)p X 8A8[xH-fN`1.MPX]Ȱߜe6KYAqX)z SEtxQW ӷmZpr 4nR n.{0Ha0~a`4+ )2i>D" J sd `%q[נr QW:`~!k(1 b0 *6Qb4t*3k{Hmy)a fCp Qw9}oW ΰp' ঘi cs#Ciw NN` `6(-1i!1s1 `ZBr0zHnP/1 O1֗1̀ A00B`3 :va ow 0g*Y0bP,pRhЖ  *4AS y:@iZBR i8)?ȅMXyz: g_c:\3 Q> Z#&:\Pk u ͠W  ,P 1 1Z  `[4dp{RX;4B YeN  30p57@tc11g %W4 U4π PW @q8"9-3 0  N@ $k<?6 ;A g )d ggڸ !Sec rT^V~XZ\^`b>d^f~hjlnpr>t^v~xz|~>^~F`.^~蚾^%}].N>n>vmЭ롮Nn쳎쵮NԵ>^~؎ھ..qٞ<Ξ¾>n^Y.~ /. O?  @ QzQJzN/135E (Z  b086E[]_aocGoIOI אSA?Atf|xOvu~(qB/__ qOք /@_O?̿_ןԿ/?o2]w\/^O`ob @@p DnB >4P@'NČ 76H%MDRJ-]SL5męSN=}TPEETRM>UTU^ŚUV]~VXe͞EVZmݾW\uśW^}X`… FXbƍ?Ydʕ-_ƜYfΝ=ZhҥMFZj֭][lڵmƝ[n޽}\pō} r͝@Zpڞ_Ǟ]{pIf}x],iF|4 pگ֜0@_GRBA0B +PVmy#0D% Glz;bT*E[1^1E bA&HzE#_3I9hzqE+FKđ.6Yo:r<\P[|PR܎M<6iqJLt ̮=HB9 qY&xƙdN dXr^b`xk: ^WeZd9^Uk2a WFmI&zkxv]hpH]e][\uՖ7E?T6]^U܁|_[pjQaVn{e&! ^[i1S]OccZ$X%┆ ["y8ugAD(zj+y~x_٤gi-FQD1Tm bntgnm'r~j^a=L'A0Öm䣆Tg ٖޘEl8?=\z9xd戥ggZtotZc pIg̸mqgu[h0@1yڝ??Q@ 07y~ԽG`b)`q m C~ʻ_b6p@bІ3-Oe&`1g8a eȤ5+L A8h48Hш.hBBoP-E.'*LG] ZD1!үol`(F,b ZSZc ٚ9avŮ kid$%Y%1ǰ1Ivғi!IMrDefBDRҕTet!ʷre.#cȻ2.9𲗺$ubJb6ә}X2'gVӚs1/kvӛo6Mr- 8iNv,pg<xӞJ=O~6Eh@OԠ9AГ\C%:Ѷ (E5PN$hHQ|@"Ei@Iڐč)i5Wʐ10g9*,w:d @ı6uCHQGSVUPM'H]jUR Dq]EU ; 縕Vnq-)k]ûկ_ְElbX6ֱld%;YVֲlf5YvֳmhE;ZҖִEmjUZֵֶmle;[ֶmnu[ַnp;\׸Enr\6׹υnt;]V׺nv]v׻ox;^׼Eozջ^׽o|;_׾o~_׿p<`Fp`7p%t=hBЇFthF7яt%=iJWҗt5iNwӟuE=jRԧFuUjVկ5$F<-xrnmZGDә@` y)5$lQN @Y' !˚B $!dcsD'BX P!h d 9"9 zc"@Qww{.^kʸNNS?)f<,> "5yoC?z̟'A{AL~F3!9cƶ}???ЏWZ|sh5!dH~%˿<#gxhlh?ł> Y~8 p(6O9lq@X@蓿k F  Ph k g5"m8)eЖ $$ia4d)6qcpCP#BMbX,bt_Bg@#94 QȄ|)B-DC/Q`. F    559 PDH-D! iDbPbWi,-xJi5 5 O Y3 )$9YhY`Dp bx2Xb`h`Thk gEX@DqsGY F:vTF6'sk[o6HHfhh?SnYƭ0UF/hPplWkX{8K+`wkȅ8l (LUhI'`UXd7h8˩§c \> 8_Y`Ip Kw< A S8̚ hP# 7S 0ƼHL~2@ex. 9%HRXrUB9X7CP39c [K`Ml sʘ (Ht0R`NȖ=$΅X?ȹ8(WH90H^sqLR7'hA\S89Y\(- ɟLPNY0X0Xή ljٸPCҁV8 iN8axUX7U p>tyPρЁpy %^n`+Xt4KhD)LҠ0$=ЅR\] Y8ԯ;؄oP'Z4 oHM(C 1S` T Neb͏҃ P=u`]dMP`T(\ ?de'er-W5 p sT_hsC]њ Nx_5] HՁ85tu47(XP_ՑxKHV,_8WpfW@@ tЁIhUNX٫طR;X71]Xh5pY腧ՅYJ)(ӧRAvH]8N8\XhOX WHpդLԆPTS[WfKU D`ZXd2ё@T%ׅhXPN'\a\Rl]M %X=0>h)=A=(S҉ NZȃ{*H X07ȘYxu[^Hˆ0uN݈"] }3 )* )ZIh*MX+ }e ՁЅOPQP؃R҆X"``VzP UӅZɠ} ^ ^ +ȹcpoq UQ:b^yb6΂1w0b(QU0͍_ r4];^`[ X^PX^cY]x]:N۳Gdd\ȅQbYȹb?7~7x9e[(9]:t1e\_`ec[y  dzoAi8F_( 3egqF܈:^cԉ7%)ٞ@LW&8H y c~6c [g8Y(fXPXx*-[@6\piKr 9<=hHjеۆS7 jv*}ЇPuqh}}x6yꅘ> jjjh~j؆F뽐꺨셠Ff ~؇hmh~0쳠ζk5Ƕ}xB mؐNylP6m0f `Sbœ?懍횐n &Xy|+~~1n-ot mFaxn0͏`(x.f b  `GH+mNk^mn-~+nk.垫뮇+ok/ޫ믂+pl' 7G,Wlgw ,$l(, ̘Lٌ͑Ίυ ~ Mwr)kT&uXvu\wu`cudG6vh+vvlvpN#?]@Fquߝ|#6Yۍwu?(.5wVS{S:a;ܼQL?4.H?YW<ݒ=<@4.,y#P:ǿ>t3 ĉ#'1~L M(C Z&_7DG NY0o{ g%5S$=?!Q#E<+%:"M|)ZQ U'rK"(1fL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIR.FP@`J- @x@VT''PK h ℁ (:„(L#(5yL, 600'hdQJm 'b7Ď].07"@ Bb@NsTraAe(a A6xH4qI7Bl YuAbP k<"]O.RPúBa`#|@ tN`M $P_8 aCx6J Ca]yBQ:hMZֶp\J׺xͫ^׾ `KZ IG~L05Z`@pa6ԡl|ձC0KlvFmPXYX6XF6!lU-ĖHlo[a=Kls׈L9܊ȸխPoṚŮw'wa?Bz " S0ӽ/ˆ0_ro,} x0w Nΰ7{8bX5 xU&bwm *j*d<֖< _jj4)$DerlCRl-sY\^,fm:35;nVl9YXvg]϶3e%AІVmE3T~4"-iNQҚ4-MKӞCͨQQ>RjA~z5$Yֶs=]Ku-,U:6e?^iSH־vq;6o$qרݢu{E~-ѻ!7?}wB?x 1'N#̬ϸ7{ 2Lr* Jnup˹r#ao Bk#֥9듎HOҏ#8oҧNu?}'˺#$ZnH+0pv}u{$ wrx;1~>^%Z;g9CxÏ/DK7yO^3:_jA_x''JgWW8Uad=msVED"gY4?ϧ=@$#"ICr}g?3bCV"`&C/""fY8Xx ؀8Xx؁ "8$X&x(*,؂.0284X6x8:<؃>@B8DXFxHJ#]NNHP8%T8VxOZXх[`1df]lȅ`](ZHWhTX(qh4qoȇcPHaXihQ(}fgXw5ExH8ՉqQ~(XHhH8Hh(Ḧшh荽ȍ(HhȄI ^gu1FGhvh(Xc9p ɐцuИx!(I`WpE-ٍ/3ɑ+1v >E  KhhȔ( 8PVyX \i[ٕ\`b9^9fIhg)lٖU a؊_ȗ藡(Hgѐ٘阐Yyɐiə9I]zn8Yy8Y긛ٛ9Yyșy qZ)EEX6X؀:C.Yi9p :h4eRj&fbA'uj` P70  Z5 3i"@Jk&KlZ)k0K R` 0 0p+PeP5^ ۠L#.P亵Ѵ P -Pѵ.`b+5` p зQ Qp:GukZ6  n 0)P!_{{q@ e4Q b;_溹{5kZ P5{4΅Jsp` N*D )+hZk;5J@f@[At`CX _㋾xa`RE `>Z>jε.`+ \| lgJ :5Ή,7:l+$'^1"Z8+: "p1 $\Ɗr $ ÛVlRl@^`Lb<^Zݞ;g{S5|'7＠aWog]:wϽ/o觯/o HL:'H Z̠7z GH(L W0 gH8̡w@ @<>AH%*ф% 8Q Gl: ALt%MUc 6FCH1.*KA8L@ 9B{5RD&46򠡸6")/C )p0i,@*IR <𘺁c6pPQpcP6yΖ%AuӇ@QFAl~ @JЂ=̈́vmXC6Nj`@Ѓ ;8qQ \+ALfFҚ8ͩNwӞ@ ~PQm@IFNE uDgPЦ T4@` q5K=ZamYCz2\xͫ^׾b~)K’$ , M|*d xbSa=|׀P@0NMu9p=Ѹ Qq#Fמ!pHMWH[`55gxF6$>x8pB>0@du6klEaz :ܮ@7د ف1z0% ߫30s_0B,y"1ǥ'.vWcӸa0 sٸ1%!+FX-$3UN~fy,eSԊ2I-^%yYc>sҬ撙ͻb3%9vr=~nYAZ̆>tB3ш~4=i=WTti:sw4QӦNWV`0}gMZָQ>C׃jC҆1O;AeHLq`Htl7H#Nmt&wE❡uV X7Om;8+Wθ7qe1j\MGܥUCK>eR.q-sܛP3]s<1?FЇܷG?1dlh[<Q?t 9:nSxq;Bm䃎l?gx=HB8Q0(kH;OȃQShU8WxAX+Y_D[(a؂gheJHcȅm(sHuhwyqh{zfp `m=Ȉ1X=G=ȉh4P=p €LHl؇nt(vHxhz|xpȋrhPЊs臺(8XxӘo#װ]Ixׁ(h刎 Ȏ"j8(Q(HX YIxP@)yxiYّ 9"Y!y$&,.0ْ12Y4y3-yP@B9DYFyHj=)MO QSUWiYY[^`b9dYfyhjlv٠`Lp^]mo9rYtiQ"U׀y)v Ӑ ϐ FQI 2)Ruo٘ˠNUi0S`LⵙJ_ɘ )!Z\pYgq`cŚ‰ٜ˰ )"ٜo p^靈 Vy` Yyyc@ ")  I` n|1zr  J  w$Ij+ Q `v5&ɣ+ 0 AGjoMp   Gu"˩=J0  NF:pJ^E `@B=D]F}HJLNPR=T]V}XZ\^`b=d]f}hjlnpr=t]v}xz|~׀؂=؄]؆}؈؊oR  q 0 w!:!=} % a  Ӥڌڬڮڰ^ wJ` E ΀ 9} 2e uR6[נ[ MM9= %S'p;gmq3H9 T}bNb4E =0 a  4= u @m =-F{Ƞaa:@1Up1=6f!,@H`eeÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0ctZ3sɳϟ@ JѣHzјҧPJJիXjJ)$\ÊKٳhӪMb ZkʝKݻx&mk޿ L|'"H%zp˘3k\7VꔚG@IS^ͺ&=SC`ͻzeC$EPɦf_μw oK /r5ËO^t|]/hVX˟O k2'hSQ4.Bw-pIЁfbD@t.uh((r!D(4H`6<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmPits׭wLw/6$څ'~y+8H?.ETnygwg=8褗n騧ꬷ.n/o'7G/Wogw/o觯/o]up@Kɣ ؂AbѶy4g|*$; H<`@|+LQl ( b @DQ!")ܔ̦6 A y $B9NtS^|@A:D!lIͨF7ш FGbD} 1Rg-m<|Bb45XkL! x\IUjNOk;eTnX] kXSA5kWњVUXj][Wxͫ^׾ `KMb:d'KZͬf7z hGKҚMjWֺlgKͭnwV/8Mr iHC01mj: lJ?gk"o!6In'M}w "$; d8я]L [pϲ KGLb o,!>1by wlbEtUEAH>  I1 P2WD'"ysLľKAgX_fYxγ>πMBЈNF;ѐ'MJ[Ҙδ7N{ӠGMRԨNWVհgMZָεw^F5Mb۪9me/>6]iS{־vhծ-q#;">7Dmg-vomv=pxSߟk]-2f}8JU5q7<DBn G+BrJ*w8OZ<1w3?xS>'Gq^t'Oy}>uW]ƭ !p Nv[hӎn+"wӽs>|5 06:oKT%u/O\b ^/}Dy^7}~78 g #_>'wp Z8Џ>,"?֯>s~/~Sʖ\.nyI>x!_wJ(Wxn ؀Vxh㶁n8x߆|˧o'|%o)p+(p-Hp/hpGYW6x8:<؃>@B8BNQK%tDF8H~ W.'rKPx-,Ur0df, TVYqDQdqh UϰHjW?Єmxq oڠ Jчg%k$@Q `n8(W(fp i(0kx(UZaA qUE"oG0h-7M(P  GQ!ℌؘa8` fFhX(Np@  @4 `  PEq֘jŌ @@pz 6ĐCVa @L :  8$ ")$)b` `R  T ؀  T".tHau p $t OY pOQd`vՕ爋fU& e 0Ԑ pd EMbQen 0 p R W)ԙ1 Gh) dhv LVT p P9f`BMU:SY (bEUTE)G u)30@0bubu/T9yofOi  ŀ >%^ SRép  `g@% ʠk堩 `f`yձ Wࠟ0 @  >Vࠓ(`N Q`Q┟LŦ 1s` Šc;P UIg 0` Q0 (yjfV3`Mb(3 *a5{ `L` >{*bEx⥞sB@ y zZ9e9=$vE@U,ŭZH%Hz9CܺUSg*Yo^Qj_:;zf[ ۰;[{#EDDM!aR]ENꠛ]10[X$;5 ,۱1ф<;?pN@@`L۴NP`T{_PQ+T$cX`;f{1cn۶m"jr0ۯ ]ȎOa`R{]TfwC [\;[{۹;[{ۺ;[{ۻ;[{țʻۼ;[{؛ڻ۽;[{蛾껾۾;[{ۿ<\| <\|ңH` !2 D Q"+! ( !L £!,?H`A]\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸s2 Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8xX/@)dg iBL6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+ks,`.^>+]Nkm\^-[nY~+XknWs_[ VKQًLG B L' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|I V<=ANN@e8p CP)9CJ,T>"P: 3<yCX@!>#84Nز9Aߞ 8@n *@2 [iDCMP 8IGjd)"G8( HAi0iċ5gXC@8Q9`'8IH<j$xF?ŸD/^%~FG # yDH*ZX̢.z` H2t@ 4&Jnӂ9)"1-tiӴ @&ys.A65%ӟ iNLTl9@Q~"Y̏LjLe H`f)S6%= PJԢȣQd:P , &j8ND8 >I^SWJֲw3Zֶp\J׺xͫ^׾ `KMb:d'KZͬf7z hGKҚMjWֺlgKͭnw pK%Pqi.Ѝt˪R=P@q] iڀ4t7=G=v葇|q y#΅x_Ro%`oi`013L *;Lbi:!;rW,_8αw|s% (=Vq Hq){9T Um#J/9X8o<%@rZ)G!>sל7'yM.6w@Y>9ѓ3A:ԉ.GVzDuwp_a'юr~ig;>v6;=q{sϝe {8Wq:!yOP}Et/Yg+=G D^\7 Bto@0oFsxyޥwqL q\c {S}o"Do?q+(Xx 8Ȁ(XqF@Ё 8#((*x+,.-80H2X8x:h<=>@8?X9FWL؄NPR8TXgZIxWȅه}'Gxhjl؆npr8tXv8$t| =rz ;FBh@o0 pH7Ca D@ 0QߐlƉ@0=8Q(` 'S i (`8'I1VX > B@ x&QJT x  0 @X$ ڈB  &a >iQ L9` Q  /!ؐ 3 ۠0C ɐGh.o/ @9Bj 5H+Q-@_Ԋ5  N B` ȎH=hA `@um `< L Ґ _I1 t) 9 ) 0 G9Zp00IpJ1AQIiik'pY Ȱ ZP |ɚ')P $) 99 QٛqF ԰ f V1 ) pA `#[QI Р PVf Ȁ *Kyy Jo jffI. #*  ` ;K@w `Ƞ oy γLAt   ŰZ `ʤ &`N Q`yp0Mq ap  JgaO$ 0#1NөI#P Q oY Zu`؄y:;.}yf ZU*i Ȑ<5GѡbZ0D:ZzگCC|G"  e! Ű5LOu! &{:qdB*7;@1K/<۳>K=6QfB[ G{<ڴo! PKKzeS[Hk+Ad^9;`0k۶lf{iq2dA!gM˴B*DjJճ5J> D[۹;[{ۺ;[{ۻ;[{țʻۼ;[{؛ڻ۽;[{蛾껾۾;[{ۿ<\| <\| "<$\@ ` 񎢑l'@< 89 #=2Bl<p l0 J 9Y!B !F& J6i 88)%PNi%U^Yn~]~)f}ai&|ezip)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/WW]EcdoqpN;/MlqcB+2e_: @! '(̠7@ zT{A #8я@?IJ8a Sؓp/ â"q<܉c4<qD%0_)zUĉ:HFq#C2/1'd,#APy^|!(c ǛQGx' XH` p_%asI56Y"f)q򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:vQFէDЁ=>|2UhDJ.u(F3:QvG:Rh2Qԟ.eiI9ӋƔ'hNQzSNJ@ PU9Qԡ2A}*TF5"VE*Vщ` X9YӪֱa}+\*׹k\#WdM`޵Ukb:;5kdXNV+D{@3tM ֞V"u-lcis[޶fԠFđG%Lه4!mHt2݅Tͬ_7KXU@1 6kzI]ȮUl|]]#⠆3`6.\*D,թnj`'L @"1 s07&&1DR⇰X$ ט7j?njR9,M%;,},$Sǽ2-g9^E,ݩG R4<}ș,S6xγ>πMBZ*8%puTRMz%4jZ#FBa_$r ^m PůE6I?"m#%vGiL:6mh#v6½>>bȢjHF2Anx\wwA l;ր4^z_pFƑ!iȣJ3a$(OyANy-gyg<3Wo>ۢGh\<3a2u$EԧZTVz֥s}R{ֱuk`?{mlNwCqň 98A՚O;o{kW(PőbRj@n&j7iqL~ $D&Ba-Ybr']CX򗯒З?a'"|kP P~ wK2tq$ 4a %3@0` YQj,؂.4#f@r $v`P e&%42E %@ p vy0^E~_s?z f YFgH}cr` 0\Z f0b\f0{X__Q 0  bP 0pl@ȉ6`Q Q Ċe  p y` I]8 `Z nψ# 1`@&) ?P `fl  C8%  V  &Eqa* @ %)i- /a3i. 7I] X!ByL'A)G @>hE9g!TyXZ\ٕ^~`ib9fyhjlٖnpr9tYvyxz|ٗ~9Yy)7AFHً ȘIrP \`@tZd͸A'A rHGIBٚyٛ9Yyșʹٜ9Yyؙڹٝ9Yy虞깞ٞ9Yyٟ:Zz ڠ:Zzڡ ":$Z&z(*,ڢ.0zP`I_aG|`dMɗUEeFFz) _w RAJ4 t) 0 k:0 Y  n up 8 *5 $ Xz w0 YJujy a jv0` J@`qz wl'w/qha P ઻ 's ںڭJ@D?#EBץe 0{ p{@q:Nް݀ʘpp9 ;zC,!,YH*\ȰÇ#JHŋ3jȱǏ C/F\ɲ˗0cʜI͛8s,2Ο@ JѣH*ȳϥPJJիX&lSׯ`ÊKQ(ͪ]˶۷p=ݻxݻդS LϹO +^̸"K˘3k̹ϠCMӨS^:׮Y˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k&o:3 56%=oξq@0p&<\@'\6؄N2L&8 #qS@/8[-f4,35|9ۼs=3Avo/&mßէ w +Wwdl#ka B Ǒ C8t <ڢP+#K!m䃇oo)b+^dĂ|Ƀٞ$!X̢.z` H2hL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GI씨L Vl%,cYe-sK\:l0Wɷaô.yKfҙ+)K^.^1ԛ1Jn&*LlӚ$'1&v̦CIOwB'>}l'@:Pt} ?P{2lD#ʐCQz&FRxtH R|K1:S5hNEzSԤ?Ei)Cp\8&``Ԧ.!NS"UBM*Vaխ!^}MW:VdWp #! DPT/2)KRԮ4ūM%Rԯ<ҁ%|)`XVic:Yk&0L':Z 3mfjhv|lgK "lq򶷵-pw%C܆0W!!]N5,[{ZwKW-ozϫ덯{ ڷ~+ŘLNYLԖVfm];aVk1|Z GL(NWKh.QBk8Fhh;Jl!0F>`d0{y2"eLcSJ1,/e^ 1-f>Zl^ͦųn1TR36@ 2LpAhBb EAM](zя.4.hHD!.vQKKӠƎ2Qyt~:-Èg?&u.jq\׹V4 _d;؛vvZ:mk kBaNvMpOօotBPihqmrw`n/ D Lj !( N)qVQ8 6jV1ő gI= sX Ch!@#!E@(D#+WoӑO_h l}\yVX-&0P y   B/q}x#ؾ@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy٘9Yyٙ9YyٚY(tB'P0 0 @/5Y< V :9nʹٜҙv Vp֒o@H9Y E0 .8W$q8H ;.r IHhp`A4 Y}!,YH*\ȰÇ#JHŋ3jȱǏ Co߿F\ɲ˗0cʜI͛8s,2Ο@ JѣH*د_ϥPJJիX6lTׯ`ÊKҮfӪ]˶۷YKݻx˷߿ LÈ+^̸bD˘3k̹ϠCMBuS6ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfvv6 .|<#<t?^I"VT@yHF< *0+ TѾ d`A7ŃU2( @x BD!kZrh5dAL&:PH*ZX̢.z` H2hL6pH:x̣> IBL"F:򑐌$'I쒘d N^$(CQ9e)SJT:l,7Y64*uyJ^җ')J\_1;-Ift&&K,Ә1nzLfCINoB<':éu~&<9Owsk;Osd@M?Pr eBQpVt1DQ{vjhF!QT#eIR-h%vӞ "> N*Ԡ==*R&NeC*ՆPU#AG`u}8IRգgiZMVUmeda%[aWլEk`:X֭+&j8F:&kB3efavm%5il MjW u-l_+Cr{V-p"\je-\6gt9]wVwEecݷp /Wm)~-/z|o{+_²m%~.Ŀ pBApAL'L [ΰ7 ]%#I M|c1P\,иu1>n !O R[*Y)L~X,P_2KT]rwrA2Asa5lNsfyх>":~ֳ@b^B*R/,C\44-"iGSZҗI{ҟt3-KGNW}$:Ur -\ָεw^vk]Z_ʢ$TЎ@<b)Ը%jCOV?n(fyx]ȟ͉b8Űʊ'MG>(a ˘iB 0A> 5FnpD ( `g , +'fȇ5Pdc bQ2 9>5<P YtC @a C-D:j0ga@G'W; R8)Ox #%Pp{?&m0a^G==!w1Q{ rWԃ?C|P ؀ ;p;3 S! ! q `B=1b?G,a ?hp fpBa\H P :H  G | נfv0 NV@02v( P @ @ $갈5 & oY4Q 7 v{(6ш3 (`Njȋ  6  5 N f3Q 3XE7d0ro8cX㘏D ys ِ9Yyّ "9$Y&y(*,ْ.0294Y6y8:<ٓ>@B9DYFyHJLٔNPR9TYVyXZ\ٕ^`b9dYfyhjlٖnpr9tYvyxz|ٗ~9Yy٘9Yyٙ9YyٚI2!0$  @k1 B`;0Sɴ Yٜ9Y@ P 2 ޅ ` 8<3o0 9P9Yy[l80{##\p'Ct3@H 1 GtuDTCӰv耟 p` `3C .(:,!,an{ @*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,V,.Ƙ"2H"6!:!>Y!B !F& J6i`,8)%PNi%U^Yn~]~)f}ai&|ezif0O?CМs5zD9gw⩧5eJ'(v0>;9=JÏ>ayA:**B@>ݰ ?۬*첸[? @V۬?A亦SP-CPڹ>Ә5ɸ\4B 0hZ GZ*Ŧko$A*$cq$M2o0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wogw/o觯/o HL:'H Z̠7z GH(L W0 gH8̡w@ H"HL&:PH*ZX̢.z` H2hL6p: ÎGyC !E)kYTʜIgQ 6INŒԊ0R oVT,L8T:`[TGtHL2yL_ &1fZt&PqLӘ 2ӛ(fq3I-1mlЇ/ &8L,~xYd|GWJNAd.U.K89eA#4hWDѓΔ3])NI6DFI*]N&~]"dg8]B 2xO{AN+ߣ ["A{}w"^E%5k<+y|e>!wO5-lA^"Br2/xv~0HXOO~56'叐dW?b(wnE&XW ǀ"AaHRf U  ȁ%')+XYCpGB 5.vU}dF0DYpHJH9xpHP7.p\u X9H00PBTx mG7qCЄ@ p=-Y~XxM( `vXWSlH -YBC8X80- X~LX.hׄ M~` .Wgi@x& `@bu ڈXЄ@ pO rs |̔WC SWK` Ў(hh8 0 @&) )dY  pf`y)ƒ/fi ؄ @ Ԩ  g厵8  hW?Ж7PB#@P XUyB;n0p0-`N0 ȁ(0@700@@ tI7 =Fp0 [ٚkDy@D`ư EQ ` PSh Pif.a )PS9hHP ٩ٞ @p.  1* ȉџ ȠCAڡ!AD*gH(7!zq0ch15Dz=Q0 "AuV '\,59*!5`QTxhz V. 1vZ|ڧ2;ڧ*[j^ʅ95BJY3:V0 S00p։vџHz\+jګ*lڬ:Zzؚںڭ:Zz蚮꺮ڮ:Zzگ;[{ ۰;[{۱ ";$[&{(*,۲.02;4[6{8:<۳>k%(0JQ P p`ZpP g@GK@  f 0: ` avp a+7hz gjжy ||@v0:7P{vz˹빸*+j1QP @}0 Pڐ Ujм`/LjB'tŐ 0tt; כZ C罘P;ŀ K@0 jC ି0SKܠ}ǫ g' qg ! z:   ~ⶊn'l}e$q|KP du W. 9l@ 1 ; a lEl? gj`'s úy4\`,B:@պ#@`qGnK[.Բpplc6Z zz,~j`kP݀Qܬk@ ` 'Qzm8g!,anru @*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,Ȗ8.Ƙ"2H"6!:!>Y!B !F& J6i 88)%PNi%U^Yn~]~)f}ai&|ezif4?CМsO>a9gwg>mJ'(v0g?Q=JPArj*sFj?sʥvU*믽xQʢ&j )ʓM<$AP+nlb[R73iLW|nA$)Z,2fG1A?0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wogw/o觯/o HL:'H Z̠7z GH(L W0 gH8̡w@ H"HL&:PH*ZX̢.z` H2jYfL6p2G렡 ]@ iGQ@(dAABf`@9J%0mlA$JPAeTJ L90.sIK`,e/ٴS8 U?yLcxf!~*,̦6nfCyf4EMkśL7qKŰzr;9MnŞ]'>}T*24AJT_y(@#JЉCU~JAAQ{r'EWx$-:O &M]c~Nw\ vo+:PTJժZXͪVծz` XJֲhMZֶp\J׺xͫ^׾ `KMb:d'Kʒͬf7+ԈphA+r,jSղֵiiZz-ne;ZޒVg{Z6mZ!ns v%fk[ָqB or"~W"5/z+}x"_F/~4Dq"W"60,3~#,a ?pD2| sx0"b 3 FXbsXq]aH-{pƅ""9e%+N62PYVr!-KG:2 mˎf!ofH2gԙ^d˝CgWCqbD)qP@F0,"|E^REuA_"հ YֵskY׸}-a">C @ mBHڃ ns&Dq6nr;6Eվol8]v7e\VoZťxv56yuqG'ytEp_0gN8Ϲw@ЇN{is0t=BdXVUu{`Ǯg<#h/3wPB{6#0npL81Oq }- ZԂS~O7_y7|-o '߼]!OϽw~)=.HQd թ;ЏO[נq w?BvPl<#,~`??U~? b_g'QwW~~X #F#"(}-4@D0D@pG~-( - D4x@ ## `B@0<9;؃P@0pC0?`c@wtP @ pG<0ǃ!x_z |  PP=`K~tz 0`5(~d( pti^  Ґp p5 5._^  ذ5 X%X_fGH ԰  0Fo0騎fgv( ` r#8y/嗀0 P0(u)/ ` 0 0+(Œ-ivh @ `P #ӸBf.yv` @ ` ;ΈHYhD Q Y-@8. nnh 9) ` +4ȏј ir&hGw0i+5DoѸ əvs @ &I10+Cٖ! rv`jyF00GזƩcɹМBwGg  `oX *n֝) Xxwg`@ PZ oH i&rG2(BȞHvqF@ʕ[).2A @Y7q D+0:ph5C4KJRP!n` WaQB f(ShڦnpJ5Pnq*xх7NzT9z|5pz P PPUP T: 0ѧ z0i j"z}J75 z 񪽊:!Ze  1Ԛںڭ:Zz蚮꺮ڮ:Zzگ;[{ ۰;[{۱ ";$[&{(*,۲.02;4[6{8:<۳>@B;D[F{HJL۴Nv\`~& ppSkVkTJG.1   `Z r; r;Z  x{뵓 ~[˷K~иq{k +ˬs0WxQh[RP ;[+[=!,H*\ȰÇ#JHŋ3jȱǏ CO_F\ɲ˗0cʜI͛8sgΟ@ JѣH*oʔKJJիXje֯`ÊK٥^Ϫ]˶۷pKݻx˷߿ LÈ+^̸@L˘3k̹ϠCMiRN}װc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv0m>N43″M2dL2L3Ho< 8 fC55 3p6qc^8p@6 oN+@ ,8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.VWng:2ihF`1:~;M;У@:}_C?{}\#?3νo_:SG=kԿ+ه/Ǽ@S>}1/ IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ%*^e0y a%2e2yf3)Mh6d6cMl:df89NcԬ9})qQL4שLyӞ'9iN~|;JЂ"M@Є2}(DFC2цpD-:҉'mhJRb-5(>NE7zS$IҐԧ9%JRAPZT.Us8G ne5` k"ֲu!f+Dֵu5n}+k"WUwe+Tfň0@DMBS԰eHa*SԦGlRTZ/l^K٧J6jh:ګb{*F@HMzӟ´4:O֓n>O Mr:}s+]R}vf!nC{ܸB @z׋A׽|ՋD~/{K`7ND؛0};a 0!n0V[ޖD?OĻeq@]۶'qoqcXp\\"HN&;PL*[Xβ.{(21/FA 3pLgYib@c "Uw6Xilg tD\@А4@ [TwΦgrA 95GMj[Bt ]հF5.lUεqmMbNl26BhO*-l`^K6;mt+E.kUj8AȐ6ukBI 8Nb_`Lx20!2^  pB)8q $"Iq \# jЃt<?c.\x(xp 48/lyb0BН>C%R6!C?- ;-` @ p=-W(`6p Ԁ@@?xw$ 4ea#:ā!(@z Ծ`r Ob(hMt'x1# P 0PqvX'ˀ 0 Q p?P+8 Qːgwv?yHz/l!@ ` F}+05 @.r0Ah0 0@PBF f(B0}WY]h8P ð P U/mxoqBaQ |UyXQZ(mC@F`AC-@1hH“(- 6QZx DP@D0D`zw@ h`3nȘ"Ш0'p(8a*#- 0n5P0P=X!, H*\ȰÇ#JHŋ3jȱǏ C9.F\ɲ˗0cʜI͛8s\Xeʝ@ JѣH*]ϟLJJիXjM֯`ÊK٤]Q]˶۷pjM{Rݻx˗!]} La+^̸"K˘3k̹ϠCMӨS^:Sc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+kd)A2t"S5O8)O 8a'88 ,4\M6 `|  N6$[ [221\ml343k3i -3fL7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wng朳O砇.褗nzs:`FitFctх rS:C;@;SV0(< 6\}B_觯yγ/?OLϏvɟHPsKWP.@,'G8 .L!Ah׈{C2TBgq@Av-|JAJ2ŇbY^#5D{_+ dX(hL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gI]㖸̥.U]/)]<&2oe6,ᖙ̇Pּ&/m2f8kSYNjӘtf<9OiS$g/i8)!D곁tg=У1lDmhFуv hH9:ĢCI1Pԣ/iLE:SԤe)TST?-hPuVRԧGuiRaZyO21ZX*DUn\*X*ֱz!f%+ZzV y8'GP]Ӈ괧J,S+ӥ45lbka (_W2 lfvvme,zp2a>ş/߉Nmmq+OғppK\@q2}r"]RuvېpHx0E ^ox 1|k^׾ݯ+8"Ny6X'`0,`½m5}kOqlQ<[c!fmU[ƽou\b)nL"HN&;PL*[XUe CAf .&fn /<ap sEtQgZ@YjL!>І@gpZШ-g |3.h1gӠ5GA;w,vHW<էgMZָε3,p ghIW+b0!v X@h l`.U Q0Ԑ-縉` idCT+H 8@hsG(PPhP5Q~P l2Q0G艾 !xҘ8,~8' 8;ЈP*qaPg`׎AnV`Ɛ΀~5 Fp8%ȊP@ƐӐAX.`p)XW( $Q&Y& tF @e0V0P-08ƀC8IXANYy 0T[2G!,an{ @*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,V,.Ƙ"2H"6!:!>Y!B !F& J6i`,8)%PNi%U^Yn~]~)f}ai&|ezip)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'<,G/WV4XF0p=q7N;C?#6SP2??yHD)GB ĂcyE:W`"&L! G 0 gҰ71T:b(fGtD HLxDB  &ZMtNqLшX ы(b11d1mlЇ/ qxGQjH9t A:dlMi#~xF>>ٓNzaԤNth; + "OBM?pa<760IbL2f:Ќ4IjZ̦6nz 8IrL:v~ @JЂMІ:D'PRtC3ъF(H= !&e(RQ iGeQ^Ԧ)F]:#cN!:Ԑ4EuhRO4O~JժZVխj^*XՈUf=kY!ֵ>XSҨԮ7kNSt*\QTհF%l] UJUla{Wղ{l_!X>U(^(jHjSXoX:[6jnۯ,5ժ -u`AXVֹnfYFV=ȰjqYnC.ļ AoBԋĽiǐH q\#uqk\/+nD|3Xy0C' [D2a o01,{8"&&1S|byq+G87αc@Ʊ,"xGNrd%:f'['.`q} 2b6yV| 2gֺg{g>7WttNo׻6o~;޺[7qH6AD$(OW0UN Z· o[".]rNHO]i@}v/XuLP-l!w=(+0QT?M , ˽'EI&"w_ pP?>A"~tЂ-B? ϝ@pA@?\z81#<_y\?+,<-Sp0 x1P\b% ]30 8-@@ W-~ f\`Z`f0G  \ s8)y(`N N "x(o@ `Ā 718y@ `Q%  4ȁ|@PXs0vayb _em kwom vp g}}'1Gnh"Jh󶇘xHH HH0o?Z8v WHHXx 8 o˜|o ؘ ! #{8 QqxC !2@H!! ƀŵ@54U.H %+ Q7 *ɓA GB?G)A% aRYVyXZ\ٕ^`b9dYfyhjlٖnpԖ.Dg Aqɖv`s|`@ph)A٘W$0e Qi⠙h%ihI!,a`H*\ȰÇ#JHŋ3jȱǏ CIɓ(SNCG˗0cʜI͛8sɳLa| JѣH*]ʴ̖sJիXjʵKa^ÊKٳhR۷pʝKbкx˷_l LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺ)uM۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)di Iى J΁Bh2h7i wiii6jꪬ꫰*+SjϬb@k:&N:&a*59k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wogw/o觯/o>{,JO>Am$QG6ѫË|?p<@HHRLh&BKd"?.J~ Uw;A$,ۀJ t[,Gi Lc 453QvcX=Xң˃nE:b{ L?_saQ4@%>&c}qĭe*t hgɍ 5bI1B @tۈx]o!O8OtủS'ť#ԑTlPGN#߸Q:8\-(SrqkZf#AnfwH}¦PE#}Bq ݄ @4,V:{uEqbG]( wd]a;>{¡ {o(: kC|sN=#O[ϼ7{GOқOWֻgOϽwOO;ЏO[Ͼkx""7?//O7~ 釀'<ȀGǁ H~(#DXFxMuHELȄNHRhTXDxXU>XhMbQfXhȅRȆOP>kHbKhSH_Gȇ`s}E ]<؈<Xx8؉ȉx6@ ؖpȊQz ! A a JXQ5AQ 0(x[ȌumHoHWs  ΀ Bx852Ȏ/hA=Pxh؏9I ِ < Iɑ 9"YI'+&Iɒ2,6y7:ّٓ@A0YCyB;9-ٔL6y<( ghHYɕ(#'!8eɖWi[)vyxz|ٗ~9IJ.4!I *) *z3 @ @0  fGF@!.[` AY+IATLW:1d:  N3 Lp ` \:ʣ@JDJF:XXQ k* Sa]:Qe*3 p  PD ` GҘPz[;Gf P";* q )vy3 P,1*Ze J ]&N 2\ G@`o` 0\kCPگ* af B`Iqڛi!1 5!:& P Ȁ `@5+K ot00[:@0  NTJ  p 0ck6o1ڲȰ\U8 :y `Q (\K0 sj  Ԡ(qk:*Ѥ @I0 PK)ј 'Gz;+ o 2C аț! )@@K@аʽޫ v[B[Kkpƛ"1[̍[Ki [껽*t@l i{% *\,΀l(\1-\K<>E|ًI L\;,'|)<|[K)a8j<l'AtlvNs$~ ǹǃm|Ȃȍ\n ȋLaɓɜə,ɢ<ʻxɥ%IRFq%qF{F5˴x@x+@Bp̮ Lq]|zgeZBUPFx)l{ٌ[<ȲH\{'dZ< n+m+6,Ȍrf{\j@CE`l k^˻лѶQ \nuqqj w^P!Sҵp\U7]hG<ҳR( Dm+FrSӲPA`DM_5`ClЗe[U#go:!,` H*\ȰÇ#JHŋ3jȱǏ CIɓmCɲ˗0cʜI͛8s4Ylϟ@ JѣH"KʴӧPJJ0aUjʵׯ`wb KٳhӪs۷pʝKغx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tiH0ΞTy矄6(Q `: ( OMiz":ihZ[?ʪ2 iO]:ʫ+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.vTH<4 LA@y`^<\@皇.x\6؄N2ɬN8.{@498L;z/^3|x7oBx87 EV8dt?TӚ% )K;юXSJj"|΍)KCWi 'v _^Gi )́t 7 yH&!Sa:zԃ`Zmtٹ6!֮v߶yj@x;rW1&\v3Hd2>lzPj,e(8έpnjWֺV=iaZuv-ͭnaۂVOPASⶶ% )*\J,ƍ.o+ )Hll,ҕ.u=Qmx;ꖗR@vIօo>|m{ U}Q[&3{ƩxJ[ΰ7{ GL(NW0gL8αw@L"HN&;PL*[Xβ.{˚e1yf>Ӭ2?k~39ӹ!v3:ptfBdF4hj|V4%g?ۙ^iFYzZ`GMR !N!jUզ~5I-Y!5s}Q"ZسF6jfz׼vvVlhZڱln/qkj[Fwmuv}myz%K8q j. 9!p3z8됉Jxã9.F"j{'vʿp|ܾ>=u@b򘷻}^o^Hω-sqAW\iKӍzgŞh hOm.wӽp!~{CvB @A(񄀼SD7w<=Oz{>OD#?{ȋ=ao=Vu_וve~uw]F~_io|?OOхuaW8Qs ؀ (xՁ "8Xx )(+h. ` A5 :<؃ 0 QFH 4 LN Lp @ Z(Y tv-(,, Q ooV?P,,w Q0p:FXRǢ w yI@ )pH8*Њ؊auH 0  os(8C(Wh ʸ(ɢ ЉԐ `e( G @hRH 1Ƣ ؉ose85B)vtx؎@ p HAfRGḏg@׀ ` u)H fZZ`o o/w(  Ű @ `:Ȓ%8(`Q N`@ 86sHy hUkp3 &`L wyW@ Lx@ pZf Vg I h(P əj `oz Y @ &wɚBɖ  u-voTYϱ9qivp o ɑIy t5ʑ Jo$Px@Jt0 !I a p,20:6:<ڣ>@B:DZFz|HLڤNgt 3!,` H*\ȰÇ#JHŋ3jȱǏ CIɓ\ɲ˗0cʜI͛8sɳϟ@ Jя1R;ʴӧPJJhXjʵׯ43Kٳh۷pʝKUx˷b~ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)tiY?|Q٧T? jE!2ۣ#inBg\)Qb|**Ol:4]c)j"<+yk+k&6F+Vkfv+k覫+k,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.'2$i7 ^8`#4`L᎟ C 6d8\ONOlzxP)<p4W{؄;sċ:Ń57/Wogw/o觯/o H!0;v00\@& 4<~xЃ=>R6я ve \RAE!?Z?c‹61qHBă0qIl >ip%>&NЅFaI8Sٰ n2:-q22`H:?xxǽN $%§~ct*TէC8^| mfCjUJ5V}j"/9if;h wsj38dwi' ]l1t9,.,V heLCD=7QsX:Уkض"W V9H]0%>%m<+\KۤO@mQ]&ͮvK25 t˘:Ո'Z~e/y bޅg~+>8`yI ʁ'WmTd, i G|_  ~g_Ȍ(>JdV 5PL*[Xβ.{`L2hN6pL:xγ>πMBЈNF;ѐ'M醔Ҙt N_Ӟ4CQ9uSjT;ծ49YZְ6u}j^ס-jVsыifճv6k,حn{NvCMnoC>7íu6=ow{UosfOpr gqpW|1q{w܆>rg\'gxr-xI'v+">΁.=?:҇'NgC.Pz5j.9q$GǍr\,' pf.aw;rev¯]mWA g88atrmhǶ|1kE_Oջc/{Ӿm!}Cz B @|B(S'Dwط>O~{?OD??~WkFzfφky hmȀ'GG(H8s(*,؂.0284X3qk68(Ã-@p@HBHE(G=8LH y HuWV(`f0ݶ[hЅ P Uqg( phr؅x( ٰчg F$ `& e  hjXw  ,,([b@ ,Q, \0 `,  a  @<`Cp)8]` ؇ u\ `@Xh(hȂ fn`B )؏x@ `p)p?; )v,ْAPrx `onXA(@ǘ @`5$i(`QQ` ˠUY `0p F@k){ɖ} jh aN D);U Z 0 (b]y 1 s@ ` l  : dF?ЗZd 1 I)gƹf%霢)m91y 1ўٜyy!&!YjY  ZZz  ":$Z&z(*,ڢ.zE3ڠ57 :@ "Ijɤ ETZVzXZ\ڥ^`b:dZ]r[&+% S," f(q 0%y}"5(R y<} ֨[" SpZJ dU!,a`H*\ȰÇ#JHŋ3jȱǏ CIɓ(SZK˗0cʜI͛8sɳLa> JѣH*]t&PJJիX4@`KٳhӪu8)@kʝKݻx'+߿ L- +^̸x{ ˘3k̹ϠCMӨS^ͺװc˞M۸sFK Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihlp)jBى J)9 "rgibiNi:7j&wjjjv#3O?嚫@XGm8Ȏ3P`kk@Ð&@>;965tmu?Dxn\. IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:v~ @`?:(`AmcP*(1") @&J#w264 cXiAA=Ƥ(LЎ4n! $~'G-uC*t%Ԋ|⪟@Vzjjj!7*U4֮ ^uU!~&PTi*L.#Hl!ntIQec` YPF1v0O3҅h`h4xԲCf;+zw"Dʔ#0;ֱWna\"xu@t5\c&x7Ӆ!*z2/~߻ڪ45y]L<1x4E]!ߒ$&mp6$7l$_HdG>!!yQT4bǮdLa )H^摲lѰ)qȰ6bxƃcJp|0]m#~r?h|4w"UGe'l,\Fœ+9ʗ *F$,T.]:>XaTlV"{wF刡b6~ e$g&~(H%v45x7hVfҰ5y }HL؄NPR8TXVxXZ\؅^`b8dXfxhjl؆npr8tXvxxz|؇~8Xx؈8x؉艠8xȊ芤xM1X (7(MHhȌ(HhȉxMЍ Qx긎؎؍紌X؉x، I9Yy ɏ ɐ y)Ii!% N'p 006i8<ٓ C;xp Ԁ 19')WIYiU[ɑ# iFDTkm:Vٕ" )&i(Ye[ א\P9P yI)J qYNЙ)陣Yy ɚY qM 9I` ٜ9)ɜI)y!YYyiٞi㹝Y9YMoyiwqɖ ^X9MJ :9ʟ * J ":$Z&z(*,آq0v0* h<3j57;ڣ? aH=G:A:J LjO Ib GM Kb< 8D^jWA7ȐpDP?T |ڧ|# oZ8qPD0<{} j)a@ ?0y:m j `40zLt  p0 D꩞ʪH @ 0-=G᪰*: @ Nњ *`05@˚4E*6Ҁ 0*ʭ* ِ 00Ы1fꮂZ8 p Ű  骣 +Pjq +- /۰2"{,4EJT  ° 0P8K{c#۲)K89;Wk6[7\D=ۍ 0 `>b  [@ `P 0#˯C1?+` -K = PJ` NpFб˻>Ề (0 @:A ڠ 1P`1;kk)KB05c" p P50J+ ŀ 6 -`Ɋo:b:JBB)ܻ+<Ƞ 0<Bp; j<t K8ݸIjÛP5[h4*3Q`'@)zڽj:I vlo;{|"Ɓlȇ<q|,,8ǖɛ\ O)1Ơl"ʩ 'ȴl\o$mlƾ anj,\<ͺl!Q<ی L| a΍al"xaW:+bm+|U8+Pj бE6 ϴE4ZM"K6+Pm!L[|EtH%xlybLt|U=p-+EG<->d@aFK#agjO}R4E]zcZx) 'j==r=t]v}xz|~׀؂=؄]؆}؈؊،؎ْؐ=ٔ]ٖ}ٜ٘ٚٞ٠ڢ=ڤ]ڦ}ڨڪڬڮڰ۲=۴]۶}۸ۺۼ۾=]}ȝʽ=]}؝ڽ=]}=]}(P|_QOZPP a!@ = ! Q=  ^ t @} /| `@v0-*A^OQS UW{}Xu!,anru @*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,Ȗ8.Ƙ"2H"6!:!>Y!B !F& J6i 88)%PNi%U^Yn~]~)f}ai&|ezif4?CМsO>a Q:uYinqY睂'A㐝6mi?S5CP6An*l. `*EȣΜĶV:JP2z)k-j"DpFr 0(4B!^h>n")Bɜ[P Y -S!kf$ĝodO<smSP2c\^R7'D1ΔYiL3J UݐÌ}،e jAFt8)vm6b-`> sA$)#> 8W.XN2юC.r[n騧ꬷ.n/o'7G/Wog7xJo觯WG:/EzwtM HL:'H Z̠7z GH(L W0 gH8̡w@ H"HL&:PH*ZX̢.z` H2hL6pH:x̣> IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8Ir>:v΃jv9y̧>s:ʰOt h1 -(suG=2GsZWH:]"I(9NKWWĦN+a@P*Ԣ!RcԦ*kN%RE5gV1&W` XJVZ(Xհp5Ysmj\:ֹ5ve+0V~JuCy(V{*4PְU,fs#khYq Ɉ;|9vJp66 (?﷼G. frtKZͮvz xKMz|Kͯ~LN;'L [ΰr{ >.DBLbK%>1C.0c3\9 s#g6P>8MB:~9 -E/ю>4#]ISzЖt)KW:"f4C胐9#jGTCjEZҳ OCD~) gp-TKge;]{$dSԺ6mg;"Δ=F7A`?wCz/ wBhTJ@FԤ\kf8!Q#5 drt"r;tFyUf"%O&fNi>9Ѓ]F?z!?3 2TT'յ>{T;>uB0{Nvc]pGNSuyR3L*;V<1ycZ9cs^F=v}MϽw|'ChGo}`ٷ|??.k`|Oal??<=@=~HȐ %׀ F0+BH #%lSG`FPBP~ 0 g-05@'8b-/H0F9KуP pDh~F "xA93AQЁ J( Ұ P@8`? ; 6ؐ h @0<`obHxrB ~0#DP<. 7S0 x JX 00B5P0gQ ȋ`XH؋؋Ȍ ،86D٠ X ɰ ـ ~p#-PAQ (xHHǘ0 ڠ `  `#3H vٰ 8 0 0p-Bp 3vp8A8$i H f UP##@@)$ɐP p)2RIUWH˰2 ngYilY0` IC`1!H!82U )u0@ iB`)0陟y)++. 5920ؠ0@@X|%.PP #yQ)ؙ/ABОa~Iy~)CМ Hp {F q ZRX4ZZ '؟.R8.3 +Ň7J=j#Ǣ;J9C8LFOZ:6ɣVFW ZDabZfzhjlڦnpr:tZvzxz|ڧ~:Zzڨ:Zzک:Zzڪ:Zzګ:ZzȚʺڬ:Zzؚںڭ:Zz蚮꺮ڮ:Zzگ;[{ ۰K=)!p Q *Q52C`  ; 0; jp0Z  69۱ <[CE𳻰/ 9<+D+s0Ⴉv@';@ gXkh۶g+loqkvpE!,H*\ȰÇ#JHŋ3jȱǏ ClO_F\ɲ˗0cʜI͛8sgΟ@ JѣH*ոoʔKJJիXjM֯`ÊKY^Ϫ]˶۷pKݻx˷߿ LÈ+^̸0L˘3k̹ϠCMRN}װc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv (C(,0O4h8<@)DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+ A 3Dsq>#8$M6$O<43πNn 8]3c20L6`5qPqلe8-,8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7 Aw1F_|Ѻ};N~}\#%^_iB5}oGZ,7 IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ v^! .!"La<&2ye!d&0̆Pl̠yf:ӛ'2YLrs4g/"#f茦:o3g>˹sr3ok@JvBAЅ2}B"QRuF3ڐ4hEE*Q>Ԥ EiBUЋnGѐ0Fmӗt?-iPO RCMiRWԖOjT:UoGM`CJV6aZֵn%X*׳լ +Thň0@M2Ӝ԰eHaS괦F,RZO @`X:UPTEKUZմEgY}O5⸆>ms mOy斞gp9\}MMr+0u.t+.֍C{rW.x"^ƍAob%D|ڷE ׿}Nz%^Gv/|',_ w+a 6giMxX'mb5F}c3;n;dYWM&;PL*[XF,,扈yhN0zq@!.?s 7'wLρv  !ܠu D<`@!t.!n30,RtuZj Y@.൤}^ lPbh܂M2v@lYC~j@ p҅MhxYCX?]ST/ pv}|4tD8x (?@pS;7k^@ QzB HT/g>[LyXX煢ַu!tx|a3',dcf@ ZЂy*Ixvb @U;6Mf&`+@)BWor^*W@<JFe!{}Tbo3)H-j>Q`XA (BB `}GA .@4z 0$A< j`}52ghi`u-hDPϠ xe{ nD@ahcJf=聇&=0JKų0G0&|F9G!wvkkVfkFv<Cxcag;Wf`քNXQHgSxfVORȅW`86dbhjXZXkXQVrXWxz|؇~8Xx؈8Xx؉8XxdW 1_TW8>aȋ 3('_'0̘/{‍H28E؍ sq!,qH*\ȰÇ#JHŋ3jȱǏ C8.F\ɲ˗0cʜI͛8s,2Ο@ JѣH*ȳϥPJJիXlSׯ`ÊK,Q(ͪ]˶۷p=ݻxݻդS L0ιO +^̸c"K˘3k̹ϠCMӨS^iZְc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv X^4"hEޜi0`N475h? DiH&L6PF)TViXf\v`)dihlp)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6F+Vkfv+k覫+֫U)A2~"S5O8*O  8a7'8 8Pl1<,4\M6 | ) N60\#輳=w -4@3u*4s:3pJMXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.IL騧>O>c۟He * 8я O0]&z `2 KWBp,% |! )(C ְ}q]CFSE< qE  >Q4_RxL-Wb4pb[8F,!|[I⨤7m:N)y IBL"F:򑐌$'IJZ̤&7Nz (GIRL*WV򕰌,gIZ̥.w^ 0IbL2f>Ќ4i3Pф6mRޔ&8 qӜD7GNq>|'<ِyғ!T6My“ O49Nӡh?9OIj QqG(H&ґN!&hCRz҅Ԣ)Ie:RԦũFuzQb!/M\PӒԨ7EjNSԩ?]iQ7TŪGj4fWQŚTgvu8pkZ!"׺v+^׽k_+X:mbšb=xc+tVkf˺٥ճmgEڧiG1*ˆQufeYֶŭiabLp35/?%zM UA\.Ժ Ezx񊷼.zKއW}o{"6] %<ؿM0_B4pp!`X+JG'&W!g,sqɭgEN>Du\!7]"Ouu]*A.{`L2hNf/pnag9o<!{3`@ Z/Ћ˛HX:/H.t<}j7BZP0*]븐x@i`a<  ЂмfU/dS̞tUՋ^W= G82!`ˠ$`-8)]H,b pC e@ țޚ҅@Y i$vtj {f(O9VRMpYx|(SvЇ.: iBІ: 0FzN6mBXɷ.l`/,!dlcePZ`*nRcHۥaQ@Eݓa C[#O5HQO!UXRPB=&}R&oL8R( =2Yj<?}?8 p0fp4 |`RHCϿ;60F ~w~p.PhҐ"qQ0`5ir. "$ V5P=Wr5Xf.PN?(?gEHkGL؄WRXTXXZ\؅^`b870!,an{ @*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@ JѣH*]ʴӧPJJիXjʵׯ`ÊKٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3k̹ϠCMӨS^ͺװc˞M۸sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,V,.Ƙ"2H"6!:!>Y!B !F& J6i`,8)%PNi%U^Yn~]~)f}ai&|ezip)tix|矀*蠄j衈&袌6裐F*餔Vj饘f馜v駠*ꨤjꩨꪬ꫰*무j뭸뮼+k&6ІNVk-Rs5% RAהCOά+/Ck,l' 7G,Wlgw ,$l(,0,4l8<@-DmH'L7PG-TWmXg\w`-dmhlp-tmx|߀.n'7G.Wngw砇.褗n騧ꬷ.n/o'7G/Wog&O|:#vlsEͻtnԃiG;@vÁ$<\cPA4A`2F8P4QW|uBX^0a "> "wH!Ȫ27IT:'4'(z` hş`QZT26e0-~oc(pj#?B‘:82CC6bHC"r'd$ ](zd"E0"AP'\e?<#,=<'R4_&-! cަa'R̦6nz 8IrL:v~ @JЂMBІ:D'JъZͨF7юz\HGJ F(DRҕ.}Hc*ӐҴ7iN_>)PSCQQT&'MTB&jUJRTD}N U*5uRMZ*Uiu+\*׹vkDz׽U+`"ض^U)YXejdر"jfVfY^VulhÚZɶ=k5;[~vG5kj[ ;U|En^kWչp.][ Ro նx6-ikY!E/jk欭FT6ľ B&ĿAl5ҡZhڕ'Pp-af0+ wHWbH0Vc Ә6#c;!xu H&+yL2!Le&+Vr._d0`L'y"nL)Ydlg9a4߬f zZ6t-[Gt@7vzo;NWVհgMZ@wmz׼[ ,bN48>i aP)67΍k̀q;F6"`@)]LІ3&ij@"Zх7n\DGqs/H20yy g%P?x3s"U^s'':mN[4?x^ˠla "H #t]52OdÜ3nXD$`v '8_ "0@ŽM2_ny0 @FU /aXXȎ8uRXx@(x ~d>~ iH َaMT9d4bBr13YxG:O蒊4?Y OI"iMFiOH cKH_ Ihy.0_@YkٖXDq#1?!,a`H*\ȰÇ#JTHmŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sɳϟ@NCѣH*]ʴӧMYPjʵׯ`ÊKٳhӪ]˶pʝK]˷߿ LÈ&ǐ#K&)m˘3kN| ϠCMӨS^ͺװc˞M.]sͻ Nȓ+_μУKNسkνËOӫ_Ͼ˟OϿ(h& 6F(Vhfv ($h(,0(4h8<@)DiH&L6PF)TViXf\v`)dihl[nirvzy~*&6:89*iuNjt^isn)r~*pjojn꫰*무j뭸뮼+k&6F+Vkfl+k覫+k,l' 7G,Wlgw ,$l(,0,Bsusszv"D NItӿ> TWmXg-,QZH׶ `Z06d0lͶHvmw$037ދI /@/.WnIw-.褗n騧ꬷ.n/o'7G/WogFJ91$s2ҍ@e],AbO=@\r@0] /6Z@(QF b/e)i 2\H3]$@07bhʈF-`"R`zC?:p_-!Tb-d '118 ЊI,H&cJh ;#%!N y ]H>>ɏ+mJ b4COWVr*F,c?Q㖸e*]rw f0Ab0iLdNd1;hBJ6nz 8IrL:v~ @JЂMBІ:D#ylcmPE/QUt>R&6ơԤB?@ҔT@48!v4@ 8SE͈5(#zԑm<XͪVծzu'5Mi?ү'+Y iek{ָu=tkDЅ4 h@1x wmN^ԇ;Avf&'g9[TBRUMQ0jZy0ƳY,Z ږka;׌Ԧ+2t+-a@t+RZr=]jEص|^f{B} ~c`#^/M[ f:6aq#C2{a g)@Pݢ&>RRa!( ,X  w$ٱ{씲 .dԦ rx^1hN6pLgC$  30A ?Qg$&`8s PCV @q)Kԧ omw] };Vx"x8@ۤ{/k Dw2zτOi Rz!*sW}|UJv5rYh?9y>"p ؟}«sY# I'2چ$Iq* [(`21~<" `qaqm GK0ewx1@ Y7se\P ViQ!u 1 <'VLqs Y.IP6aSzl 6   \R'<o wna,(~540R&uor߰T @U6V ҆j*5 iT 3T` !Uj qц ;Q\w e`m ڠNpwF! Gap{7`@p}f-}FZWAC[zц3PqG `| p!KzaW@ulX&.Q>>ad9Pkg p1F/dA (v !X@ me@Y@s(K @ (9(   qHm` PP /X$quqv:c]7hy*30sXVCT!5evP~h2Z{j| ٙ9Yy1 120Ye qIٛy99yI2YQy؉ ܙٜ)I)V(BGᚯ)Yɜ:ZўT 1'cM ~ MZt *(  3Ԣ.Zhn2 2:Q/J8ڢ:ԣ> ?jy+z3DJ7ڤ@QSUZWjѤB7&J?åYOJeiʣgkJoZ! 2b *J @~Z ڨŨڨ:qשΥzڥ *3K$YdڦR*PJVXZj ǧ z*DQ ꫷jhʫf*nJjlj yJƪLr  @>ʡJj*yIBp !1 ۰˰1[ !˱# 50@ Q15{q`;;=6BDi`HGI[CKIN[5+8k\@<`۵VfZ+LjYKT! Q0.[KRik}{˟!qkB0u;qv# I럡 +Kky G A[.;K{ۻ;[{țpk;0"|6ٰCA`;*; x0 u½'([w _)0 T!H0kӰ]w&+'1  &@ݢ4>۸)03)@c& ,!QDLe@p h*pW:&'.D4i> 0@ç&?<PS oaEmQ pk)P A!Ah<&Y<(K!Ɓ! '*+x%C;s3;pU-fq)S` /<a% +z%Xv)3pŚRk@9ȶ% *Շ7'D1fuZ D'Ga)&+Ћ! 01 #DItQ F 3ɟb N<c7q&@, G S [ɟFD `T H<@ 7<A3Mm !H9IP ~ /4pm@0HB K00k׾G$7i %40 -C3.@&= 5< ?}' T#QHrc!4U eru,F0p;wM4qm! 2v} C{ ]5PҀ ل` =ڸ@ @ ڪ-ڥڬڤڣ=ۭڥ]۴کڶ`3]ۼ=MmM1ؑM ~-cك;Pڽ== A 2}ܰ ѭ5K׭(vW؝ -ð pj-0 V*ؼb<ײ@  0-` 0 > % L+-/> &"w:^?{ @ r`xP ZN> 0 `Rfp _>ׯdh [O fZ v {QqG{] P  0 @ İ.>~N0JSP p#0P @o Whˮ){)FQ &|.p?00P'4MWBCP.0= 3)9ȱIa p727m- 3C>C. 1˒N`4P>/u A?Zed\.u9)[O=S{4`po?JtOz_o"=?Ȓ˰eQ/"Mo! @ A_ "y-(˼ l.F" 3Hum?KY70 Y  0V߄􇗙OQQs>EtJG1nc0ɯG0 RO=TpBTq1 qQp-Qߞ}@@ Яd3Qā "HQF=~RH%MDRJ-]SL5mĉR^mչ4bPqDTRM>UTU*a2vPqeGW\uśWoanW 7\ťu+ܵz-_ƜYfΝ=`|5Xmς[lڵm 1;<F\r+<7vOO-R]x͟XYT8O@~Ϗ߾}0@ g~!X+-;B /P2lB0DG$.+6 _1FU*6$ 3J; v1I% ZF"Ԭ /K/ /eCCxXg ΄3N97319Ơn2xy4 YqOEey=+xJ~xSO?5TQG%TSOE5UUWeUW_5VYgV[o5W]wW_6Xa%XcE6YeeYg6ZiZk6[m[o7\q%\sE7]ue]w߅$⥷^^^}'7`K ӁF8af)9j9a'VW~J'Pc+jc!?&dyd_6/ʃDfo-,q~f&ڮw.:iby㥟:jj:kk;l&lF;mfm߆;n离n;oox'xG>ygy矇>z駧z>{{?|'|G?}g}߇?~秿~?`8@ЀD`@6Ё`%8A VЂ`5AvaE8BЄ'Da UBЅ/a e8CІ7auCЇ?b8D"шGDbD&6щOb8E*VъWbE.vы_c8F %fe@"n# lHCA:B >eY5q ;Q˹n(Cȓf΀$ 5HlTҒ8:mG`%4"IgÓװd&HyHÏ'(Õwģ*oO$t5BHi7 FeLC%FAhEIfM1 b,#JD$EL(2͗S* "FhDfŤ; p"쬉 Pk$ ؈,bCX'5%Q3NKnN B"ҍ"'C% PF-c `d@FYR5$UE rvO{H0: +J%:tCKQASt ĨiNnj e zC ¤,Ig M? 8A$ )\5I3e(%@F`#f@/R hF40)Dv5V_Oy@@5/aSA@P0!"#*pbn'Dy-HYB Ɍ@`t; B:f` oGh1[*]0Go׎"h, BZvE,]킕 F/_"E-f1Y|Z1Gzc쐉ud&7OrL9E?죏@0N6z`#>*(f:^hgA.)'6h#@bJׅM:?2Z8 j&6F+Vkfmfu*&[ڹnh*Zfo{)H4"Eb]4 v v bz!򢅾 qQ!"bAw [B53+sG9i3d~ HҐ#=$- E)‘$WVFiӤ@8]0JSBQl%+%J%,lf ,'9́ s6Ii~ 3h&rssY&v289p3+0'=yOpz{g?ٽ,BІ:D'JъZͨF7юz HGJҒ(MJWҖ0LgJӚ8ͩNwӞ@ PJԢHEX\Բ|U#Y{ZՆ=jWhMZֶiECa HC 6xG;@cXG;2 ImB886`"&Aܝ<jYL8αw@怄