pax_global_header00006660000000000000000000000064152526022170014514gustar00rootroot0000000000000052 comment=8de63cb3b57db066a6404ac7b6a90b56f83ddc0a pyepr-1.3.1/000077500000000000000000000000001525260221700126555ustar00rootroot00000000000000pyepr-1.3.1/.flake8000066400000000000000000000036451525260221700140400ustar00rootroot00000000000000[flake8] min-python-version = 3.11 # max_line_length = 79 # max-complexity = 10 doctests = true # https://github.com/psf/black/blob/main/docs/guides/using_black_with_other_tools.md # - E203: whitespace before ‘,’, ‘;’, or ‘:’ # - E701: multiple statements on one line (colon) # - E704: multiple statements on one line (def) # + W504: line break after binary operator # https://www.pydocstyle.org/en/stable/error_codes.html # - D105: undocumented-magic-method # - D107: undocumented-public-init # https://github.com/gforcada/flake8-builtins?tab=readme-ov-file#rules # - A003: A class attribute is shadowing a Python builtin. # - A005: A module is shadowing a Python builtin module (e.g: logging or socket) # https://github.com/PyCQA/flake8-bugbear?tab=readme-ov-file#list-of-warnings # + B950: (smart) Line too long # https://github.com/orsinium-labs/flake8-todos # - T003: add link on issue into TODO. # https://github.com/plinss/flake8-noqa?tab=readme-ov-file#error-codes # NQA102: "# noqa: X000" has no matching violations # misc # - I # flake8-import-order: not compatible with isort # - SC # flake8-spellcheck: too aggressive # - CNL # flake8-class-newline: incompatible with black # - JS # flake8-multiline-containers: not compatibel with ruff preview # - ANN # flake8-annotations: too aggressive # - C # flake8-commas: too aggressive # - PT # flake8-pytest-style: test suite compatibel with unittest extend-ignore = E203,E501,E701,W503,SC,CNL extend-select = W504,B950 per-file-ignores = tests/*: D,ANN,C812,PT009,PT027,T003,T201,NIC002 */tests/*: D,ANN,C812,PT009,PT027,T003,T201,NIC002 statistics = True count = True # extend-exclude = packagename/subpackage/* # flake8-cognitive-complexity # max-cognitive-complexity = 7 # default max-cognitive-complexity = 11 # flake8-noqa noqa-require-code = True # flake8-spellcheck dictionaries = en_US,python,technical,pandas # spellcheck-allowlist-file = .spellcheck-allowlist pyepr-1.3.1/.github/000077500000000000000000000000001525260221700142155ustar00rootroot00000000000000pyepr-1.3.1/.github/dependabot.yml000066400000000000000000000010241525260221700170420ustar00rootroot00000000000000# To get started with Dependabot version updates, you'll need to specify which # package ecosystems to update and where the package manifests are located. # Please see the documentation for all configuration options: # https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file version: 2 updates: - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly" groups: github-actions: patterns: - "*" pyepr-1.3.1/.github/workflows/000077500000000000000000000000001525260221700162525ustar00rootroot00000000000000pyepr-1.3.1/.github/workflows/ci.yml000066400000000000000000000103251525260221700173710ustar00rootroot00000000000000name: CI # concurrency: # group: ${{ github.workflow }}-${{ github.event.number }}-${{ github.event.ref }} # cancel-in-progress: true on: push: pull_request: branches: [ "main" ] # schedule: # - cron: '2 1 3 * *' # Allows you to run this workflow manually from the Actions tab workflow_dispatch: permissions: contents: read env: PACKAGE: pyepr jobs: build: runs-on: ${{ matrix.os }} strategy: fail-fast: false matrix: os: [ubuntu-latest, macos-latest, windows-latest] python-version: ['3.11', '3.12', '3.13', '3.14', '3.14t'] steps: - uses: actions/checkout@v7 with: fetch-depth: 0 submodules: 'true' - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v7 with: python-version: ${{ matrix.python-version }} - name: Install build dependencies run: | python -m pip install --upgrade pip python -m pip install build twine - name: Build the package run: | python -m build python -m twine check dist/* - name: Install shell: bash run: | WHEELNAME=$(ls dist/${PACKAGE}-*.whl) python -m pip install ${WHEELNAME} - name: Install test dependencies shell: bash run: | python -m pip install --group test - name: Test with pytest run: | python -c "\ import sys, epr, numpy as np;\ print('PyEPR: %s' % epr.__version__);\ print('EPR API: %s' % epr.EPR_C_API_VERSION);\ print('Numpy: %s' % np.__version__);\ print('Python: %s' % sys.version)" python -m pytest -v tests/test_all.py syslibs: runs-on: ubuntu-26.04 steps: - uses: actions/checkout@v7 with: fetch-depth: 0 submodules: true - name: Install system dependencies run: | sudo apt update sudo apt-get -y install \ libepr-api-dev \ python3-all-dev \ python3-build \ python3-packaging \ python3-pip \ python3-setuptools \ twine - name: Install python dependencies run: | python3 -m pip install -U build setuptools packaging twine - name: Build package run: | python -m build python -m twine check dist/* - name: Install shell: bash env: PYEPR_EPRAPI_SRC: "" run: | python -m pip install --pre --only-binary ${PACKAGE} -f dist/ ${PACKAGE} - name: Install test dependencies run: | sudo apt-get -y install python3-pytest python3-pooch - name: Test with pytest run: | python -c "\ import sys, epr, numpy as np;\ print('PyEPR: %s' % epr.__version__);\ print('EPR API: %s' % epr.EPR_C_API_VERSION);\ print('Numpy: %s' % np.__version__);\ print('Python: %s' % sys.version)" python -m pytest -v tests/test_all.py coverage: runs-on: ubuntu-latest strategy: fail-fast: false matrix: python-version: ["3.14"] env: OS: ubuntu-latest PYTHON: "3.14" steps: - uses: actions/checkout@v7 with: fetch-depth: 0 submodules: true - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v7 with: python-version: ${{ matrix.python-version }} - name: Install dependencies shell: bash run: | python -m pip install --upgrade setuptools pip python -m pip install --group coverage - name: Build and install run: | make coverage - name: Print info run: | env PYTHONPATH=src python -c "\ import sys, epr, numpy as np;\ print('PyEPR: %s' % epr.__version__);\ print('EPR API: %s' % epr.EPR_C_API_VERSION);\ print('Numpy: %s' % np.__version__);\ print('Python: %s' % sys.version)" - name: Upload coverage to Codecov uses: codecov/codecov-action@v7 with: env_vars: OS,PYTHON verbose: true pyepr-1.3.1/.github/workflows/docs.yml000066400000000000000000000022651525260221700177320ustar00rootroot00000000000000name: Docs on: push: pull_request: branches: [ "main" ] # Allows you to run this workflow manually from the Actions tab workflow_dispatch: permissions: contents: read jobs: docs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 with: fetch-depth: 0 submodules: 'true' - name: Set up Python uses: actions/setup-python@v7 with: python-version: "3.x" - name: Install docs dependencies shell: bash run: | python -m pip install --upgrade pip python -m pip install --group docs python -m pip install .[all] - name: Build docs run: | mkdir -p _static python3 -m sphinx -W -b html docs docs/_build/html - name: Check links run: | mkdir -p _static python3 -m sphinx -W -b linkcheck docs docs/_build/linkcheck # - name: Doctest # run: | # mkdir -p _static # python3 -m sphinx -W -b doctest docs docs/_build/doctest - name: Spellcheck run: | mkdir -p _static python3 -m sphinx -W -b spelling docs docs/_build/spelling pyepr-1.3.1/.github/workflows/lint.yml000066400000000000000000000031601525260221700177430ustar00rootroot00000000000000name: Lint on: push: pull_request: branches: [ "main" ] # Allows you to run this workflow manually from the Actions tab workflow_dispatch: permissions: contents: read env: PACKAGE: epr jobs: lint: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - name: Set up Python uses: actions/setup-python@v7 with: python-version: "3.x" - name: Install lint dependencies shell: bash run: | python -m pip install --upgrade pip python -m pip install --group lint - name: Lint (flake8) run: | python -m flake8 --version python -m flake8 --count --show-source --statistics src/${PACKAGE} tests - name: Lint (pydocstyle) run: | python -m pydocstyle --version python -m pydocstyle --count src/${PACKAGE} # - name: Lint (isort) # run: | # python -m isort --version # python -m isort --check src/${PACKAGE} tests - name: Lint (black) run: | python -m black --version python -m black --check src/${PACKAGE} tests # python -m black --diff src/${PACKAGE} tests - name: Lint (mypy) env: PYTHONPATH: src run: | python -m mypy --version python -m mypy --check-untyped-defs --ignore-missing-imports -p ${PACKAGE} - name: Lint (ruff) run: | ruff --version ruff check src/${PACKAGE} tests - name: Lint (codespell) run: | codespell --version codespell --count src/${PACKAGE} tests pyepr-1.3.1/.github/workflows/wheels.yml000066400000000000000000000031141525260221700202630ustar00rootroot00000000000000name: Wheels on: push: branches: - 'releases/**' - 'ci/**' tags: - v* pull_request: release: types: - published # Allows you to run this workflow manually from the Actions tab workflow_dispatch: permissions: contents: read jobs: build_sdist: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 with: submodules: 'true' - name: Set up Python uses: actions/setup-python@v7 with: python-version: "3.x" - name: Install build dependencies run: | python -m pip install --upgrade pip python -m pip install build twine - name: Build the package run: | python -m build --sdist python -m twine check dist/* - name: Upload build artifacts uses: actions/upload-artifact@v7 with: name: dist path: | dist/*.tar.gz build_wheels: name: Build wheels on ${{ matrix.os }} if: github.event_name != 'pull_request' || contains(github.event.pull_request.title, 'wheel') runs-on: ${{ matrix.os }} strategy: matrix: os: [ubuntu-latest, macos-latest, windows-latest] steps: - uses: actions/checkout@v7 with: fetch-depth: 0 submodules: 'true' - name: Build wheels uses: pypa/cibuildwheel@v4.2.1 env: PY_LIMITED_API: AUTO - uses: actions/upload-artifact@v7 with: name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }} path: ./wheelhouse/*.whl pyepr-1.3.1/.gitignore000066400000000000000000000111141525260221700146430ustar00rootroot00000000000000# Byte-compiled / optimized / DLL files __pycache__/ *.py[codz] *$py.class # C extensions *.so # Distribution / packaging .Python build/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib/ lib64/ parts/ sdist/ var/ wheels/ share/python-wheels/ *.egg-info/ .installed.cfg *.egg MANIFEST # PyInstaller # Usually these files are written by a python script from a template # before PyInstaller builds the exe, so as to inject date/other infos into it. *.manifest *.spec # Installer logs pip-log.txt pip-delete-this-directory.txt # Unit test / coverage reports htmlcov/ .tox/ .nox/ .coverage .coverage.* .cache nosetests.xml coverage.xml *.cover *.py.cover .hypothesis/ .pytest_cache/ cover/ # Translations *.mo *.pot # Django stuff: *.log local_settings.py db.sqlite3 db.sqlite3-journal # Flask stuff: instance/ .webassets-cache # Scrapy stuff: .scrapy # Sphinx documentation docs/_build/ # PyBuilder .pybuilder/ target/ # Jupyter Notebook .ipynb_checkpoints # IPython profile_default/ ipython_config.py # pyenv # For a library or package, you might want to ignore these files since the code is # intended to run in multiple environments; otherwise, check them in: # .python-version # pipenv # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. # However, in case of collaboration, if having platform-specific dependencies or dependencies # having no cross-platform support, pipenv may install dependencies that don't work, or not # install all needed dependencies. #Pipfile.lock # UV # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control. # This is especially recommended for binary packages to ensure reproducibility, and is more # commonly ignored for libraries. #uv.lock # poetry # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control. # This is especially recommended for binary packages to ensure reproducibility, and is more # commonly ignored for libraries. # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control #poetry.lock #poetry.toml # pdm # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control. # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python. # https://pdm-project.org/en/latest/usage/project/#working-with-version-control #pdm.lock #pdm.toml .pdm-python .pdm-build/ # pixi # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control. #pixi.lock # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one # in the .venv directory. It is recommended not to include this directory in version control. .pixi # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm __pypackages__/ # Celery stuff celerybeat-schedule celerybeat.pid # SageMath parsed files *.sage.py # Environments .env .envrc .venv env/ venv/ ENV/ env.bak/ venv.bak/ # Spyder project settings .spyderproject .spyproject # Rope project settings .ropeproject # mkdocs documentation /site # mypy .mypy_cache/ .dmypy.json dmypy.json # Pyre type checker .pyre/ # pytype static type analyzer .pytype/ # Cython debug symbols cython_debug/ # PyCharm # JetBrains specific template is maintained in a separate JetBrains.gitignore that can # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore # and can be added to the global gitignore or merged into this file. For a more nuclear # option (not recommended) you can uncomment the following to ignore the entire idea folder. #.idea/ # Abstra # Abstra is an AI-powered process automation framework. # Ignore directories containing user credentials, local state, and settings. # Learn more at https://abstra.io/docs .abstra/ # Visual Studio Code # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore # and can be added to the global gitignore or merged into this file. However, if you prefer, # you could uncomment the following to ignore the entire vscode folder .vscode/ # Ruff stuff: .ruff_cache/ # PyPI configuration file .pypirc # Cursor # Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to # exclude from AI features like autocomplete and code analysis. Recommended for sensitive data # refer to https://docs.cursor.com/context/ignore-files .cursorignore .cursorindexingignore # Marimo marimo/_static/ marimo/_lsp/ __marimo__/ pyepr-1.3.1/.gitmodules000066400000000000000000000001451525260221700150320ustar00rootroot00000000000000[submodule "extern/epr-api"] path = extern/epr-api url = https://github.com/avalentino/epr-api.git pyepr-1.3.1/.pre-commit-config.yaml000066400000000000000000000040131525260221700171340ustar00rootroot00000000000000# See https://pre-commit.com for more information # See https://pre-commit.com/hooks.html for more hooks repos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v6.0.0 hooks: - id: trailing-whitespace - id: end-of-file-fixer - id: check-yaml - id: check-added-large-files - id: check-toml - id: mixed-line-ending - id: requirements-txt-fixer - id: check-merge-conflict - id: detect-private-key - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.16.6 hooks: - id: ruff-check args: [--fix, --config=pyproject.toml] - id: ruff-format - repo: https://github.com/asottile/pyupgrade rev: v3.21.2 hooks: - id: pyupgrade args: [--py311-plus] # - repo: https://github.com/pycqa/flake8 # rev: 7.3.0 # hooks: # - id: flake8 # - repo: https://github.com/pycqa/pydocstyle # rev: 6.3.0 # hooks: # - id: pydocstyle # exclude: tests|examples|data|docs|setup.py # - repo: https://github.com/pycqa/isort # rev: 9.0.1 # hooks: # - id: isort # name: isort (python) # - repo: https://github.com/psf/black-pre-commit-mirror # rev: 26.5.1 # hooks: # - id: black # language_version: python3.11 # - id: black-jupyter # language_version: python3.11 # - repo: https://github.com/tweag/FawltyDeps # rev: v0.20.0 # hooks: # - id: check-undeclared # - id: check-unused # - repo: https://github.com/pre-commit/mirrors-mypy # rev: v2.3.1 # hooks: # - id: mypy # additional_dependencies: # - tokenize-rt==3.2.0 # - numpy>=1.21 # exclude: | # (?x)^( # docs/conf.py # ) # - repo: https://github.com/codespell-project/codespell # rev: v2.4.3 # hooks: # - id: codespell # additional_dependencies: [tomli] # exclude: | # (?x)^( # docs/spelling_wordlist.txt # ) pyepr-1.3.1/.readthedocs.yaml000066400000000000000000000015761525260221700161150ustar00rootroot00000000000000# Read the Docs configuration file for Sphinx projects # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details # Required version: 2 # Set the OS, Python version and other tools you might need build: os: ubuntu-lts-latest tools: python: "latest" jobs: install: # Since the install step is overridden, pip is no longer updated automatically. - pip install --upgrade pip - pip install --group docs # Build documentation in the "docs/" directory with Sphinx sphinx: configuration: docs/conf.py submodules: include: all # Optionally build your docs in additional formats such as PDF and ePub formats: - pdf # Optional but recommended, declare the Python requirements required # to build your documentation # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html python: install: - method: pip path: . pyepr-1.3.1/LICENSE.txt000066400000000000000000001045131525260221700145040ustar00rootroot00000000000000 GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . pyepr-1.3.1/LICENSES/000077500000000000000000000000001525260221700140625ustar00rootroot00000000000000pyepr-1.3.1/LICENSES/epr-api.txt000066400000000000000000001045131525260221700161640ustar00rootroot00000000000000 GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . pyepr-1.3.1/MANIFEST.in000066400000000000000000000004751525260221700144210ustar00rootroot00000000000000recursive-include LICENSES *.txt recursive-include tests *.py include tests/data/registry.txt recursive-include src/epr *.pyx *.pxd recursive-include extern/epr-api/src *.c *.h recursive-include docs *.rst *.txt *.py Makefile make.bat *.png recursive-include docs/_templates *.html # recursive-exclude docs/_build * pyepr-1.3.1/Makefile000066400000000000000000000072011525260221700143150ustar00rootroot00000000000000#!/usr/bin/make -f PYTHON=python3 SPHINX_APIDOC=sphinx-apidoc TARGET=epr CYTHON=$(PYTHON) -m cython CYTHONFLAGS=-3 TEST_DATSET = tests/data/$(shell grep N1 tests/test_all.py | cut -d '"' -f 2) EPRAPIROOT = extern/epr-api .PHONY: default help dist check fullcheck coverage clean cleaner distclean \ lint docs ext wheels \ debug cythonize ext-coverage coverage-report default: help help: @echo "Usage: make " @echo "Available targets:" @echo " help - print this help message" @echo " dist - generate the distribution packages (source and wheel)" @echo " check - run a full test (using pytest)" @echo " fullcheck - run a full test (using tox)" @echo " coverage - run tests and generate the coverage report" @echo " clean - clean build artifacts" @echo " cleaner - clean cache files and working directories of al tools" @echo " distclean - clean all the generated files" @echo " lint - perform check with code linter (flake8, black)" @echo " docs - generate the sphinx documentation" @echo " ext - build Python extensions in-place" @echo " wheels - build Python wheels" @echo " cythonize - generate cython C extensions" @echo " debug - generate debug build" @echo " ext-coverage - build the extension in-place with tracing enabled" @echo " coverage-report - generate the coverage report" @echo " stubs - generate Python typing stubs for cython modules" dist: $(PYTHON) -m build $(PYTHON) -m twine check dist/*.tar.gz dist/*.whl check: ext env PYTHONPATH=src $(PYTHON) -m pytest --doctest-modules src/$(TARGET) tests fullcheck: $(PYTHON) -m tox run coverage: clean ext-coverage env PYTHONPATH=src $(PYTHON) -m pytest --doctest-modules --cov=$(TARGET) --cov-report=html --cov-report=term src/$(TARGET) tests clean: $(RM) -r src/*.*-info build find . -name __pycache__ -type d -exec $(RM) -r {} + # $(RM) -r __pycache__ */__pycache__ */*/__pycache__ */*/*/__pycache__ $(RM) src/$(TARGET)/*.c src/$(TARGET)/*.cpp src/$(TARGET)/*.so src/$(TARGET)/*.o # if [ -f docs/Makefile ] ; then $(MAKE) -C docs clean; fi $(RM) -r docs/_build $(RM) MANIFEST find . -name '*~' -delete $(RM) src/epr/epr.html $(RM) epr.p* # workaround for Cython.Coverage bug #1985 cleaner: clean $(RM) -r .coverage htmlcov $(RM) -r .pytest_cache $(RM) -r .tox $(RM) -r .mypy_cache $(RM) -r .ruff_cache $(RM) -r .ipynb_checkpoints $(RM) -r .hypothesis distclean: cleaner $(RM) -r dist $(RM) -r wheelhouse $(RM) $(TEST_DATSET) lint: # $(PYTHON) -m flake8 --count --statistics src/$(TARGET) tests $(PYTHON) -m pydocstyle --count src/$(TARGET) # $(PYTHON) -m isort --check src/$(TARGET) tests $(PYTHON) -m black --check src/$(TARGET) tests $(PYTHON) -m mypy --check-untyped-defs src/$(TARGET) # --ignore-missing-imports # ruff check src/$(TARGET) tests codespell docs: mkdir -p docs/_static $(MAKE) -C docs html $(MAKE) -C docs doctest $(MAKE) -C docs linkcheck $(MAKE) -C docs spelling ext: src/epr/_epr.pyx src/epr/_epr.pxd $(PYTHON) setup.py build_ext --inplace --epr-api-src=$(EPRAPIROOT)/src cythonize: src/epr/_epr.c src/epr/_epr.c: src/epr/_epr.pyx src/epr/_epr.pxd $(CYTHON) $(CYTHONFLAGS) -o src/epr/_epr.c src/epr/_epr.pyx ext-coverage: src/epr/_epr.pyx src/epr/_epr.pxd env PYEPR_COVERAGE=TRUE $(PYTHON) setup.py build_ext --inplace debug: $(PYTHON)d setup.py build_ext --inplace --debug wheels: # Requires docker python3 -m cibuildwheel --platform auto stubs: env PYTHONPATH=src stubgen -v -m epr._epr -o src mv src/epr/_epr.pyi _epr.pyi grep -v _cython _epr.pyi | grep -v __pyx_ | grep -v _typeshed | grep -v Incomplete > src/epr/_epr.pyi $(RM) _epr.pyi pyepr-1.3.1/README.rst000066400000000000000000000127361525260221700143550ustar00rootroot00000000000000================================= ENVISAT Product Reader Python API ================================= :HomePage: https://pyepr.readthedocs.io :Author: Antonio Valentino :Contact: antonio.valentino@tiscali.it :Copyright: 2011-2026, Antonio Valentino :Version: 1.3.1 |PyPI Status| |GHA Status| |Documentation Status| |Python Versions| |License| |Wheels| |Coverage| .. |PyPI Status| image:: https://img.shields.io/pypi/v/pyepr :target: https://pypi.org/project/pyepr :alt: PyPI Status .. |GHA Status| image:: https://github.com/avalentino/pyepr/actions/workflows/ci.yml/badge.svg :target: https://github.com/avalentino/pyepr/actions :alt: GitHub Actions Status .. |Documentation Status| image:: https://readthedocs.org/projects/pyepr/badge :target: https://pyepr.readthedocs.io :alt: Documentation Status .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/pyepr :target: https://pypi.org/project/pyepr :alt: Supported Python versions .. |License| image:: https://img.shields.io/pypi/l/pyepr :target: https://pypi.org/project/pyepr :alt: License .. |Wheels| image:: https://img.shields.io/pypi/wheel/pyepr :target: https://pypi.org/project/pyepr :alt: Wheels Status .. |Coverage| image:: https://codecov.io/gh/avalentino/pyepr/branch/master/graph/badge.svg :target: https://codecov.io/gh/avalentino/pyepr :alt: Coverage Status Introduction ============ PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _PyEPR: https://github.com/avalentino/pyepr .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int Links ===== * HTML documentation (`stable `_, `latest `_) * `PyEPR `_ project page on `github `_ * `source browser `_ * `commit history `_ * `issue tracker `_ * `CI status page `_ * `PyEPR project page on PyPi `_ * EPR-API `project page `_ * EPR-API `documentation `_ Dependencies ============ In order to use PyEPR it is needed that the following software are correctly installed and configured: * Python3_ >= 3.9 (including PyPy3_) * numpy_ >= 1.7.0 * `EPR API`_ >= 2.2 (optional, since PyEPR 0.7 the source tar-ball comes with a copy of the EPR C API sources) * a reasonably updated C compiler (build only) * Cython_ >= 3.0 (build only) * pytest_ (optional and only needed for testing) .. _Python3: Python_ .. _PyPy3: https://www.pypy.org .. _numpy: https://numpy.org .. _gcc: https://gcc.gnu.org .. _Cython: https://cython.org .. _pytest: https://pytest.org Download ======== Official source tar-balls can be downloaded form PyPi_: https://pypi.org/project/pyepr The source code of the development versions is available on the GitHub_ project page https://github.com/avalentino/pyepr To clone the git_ repository the following command can be used:: $ git clone https://github.com/avalentino/pyepr.git To get also the EPR C API source code, the following commands are necessary:: $ cd pyepr $ git submodule init Submodule 'extern/epr-api' (https://github.com/avalentino/epr-api.git) registered for path 'extern/epr-api' $ git submodule update Cloning into '/Users/antonio valentino/projects/av/pyepr/extern/epr-api'... Submodule path 'extern/epr-api': checked out '93c1f1efce26c64d508fe882d5c72a898a068f29' .. _PyPi: https://pypi.org .. _GitHub: https://github.com .. _git: https://git-scm.com Installation ============ The easier way to install PyEPR_ is using tools like pip_:: $ python3 -m pip install pyepr or:: $ python3 -m pip install -U --prefix= PyEPR_ can be installed from the source tar-ball using the following command:: $ python3 setup.py install To install PyEPR_ in a non-standard path:: $ python3 setup.py install --prefix= .. _pip: https://pypi.python.org/pypi/pip License ======= Copyright (C) 2011-2026 Antonio Valentino PyEPR is free software: you can redistribute it and/or modify it under the terms of the `GNU General Public License`_ as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. PyEPR is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with PyEPR. If not, see . .. _`GNU General Public License`: http://www.gnu.org/licenses/gpl-3.0.html pyepr-1.3.1/docs/000077500000000000000000000000001525260221700136055ustar00rootroot00000000000000pyepr-1.3.1/docs/Makefile000066400000000000000000000011721525260221700152460ustar00rootroot00000000000000# Minimal makefile for Sphinx documentation # # You can set these variables from the command line, and also # from the environment for the first two. SPHINXOPTS ?= SPHINXBUILD ?= sphinx-build SOURCEDIR = . BUILDDIR = _build # Put it first so that "make" without argument is like "make help". help: @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) .PHONY: help Makefile # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). %: Makefile @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) pyepr-1.3.1/docs/NEWS.rst000066400000000000000000000417141525260221700151220ustar00rootroot00000000000000Change history ============== PyEPR 1.3.1 (16/09/2026) ------------------------ * Update project fields. * The minimum required Cython_ version is now v3.1. * Update pre-commit configuration. * Update project configuration files. * Use Pooch_ for test data management. * Support builds with the Python stable API. * Drop support for Python < 3.11 and numpy < 2. * Build wheels for stable API ``cp311``. .. _Pooch: https://www.fatiando.org/pooch/latest/ PyEPR 1.3.0 (03/01/2026) ------------------------ * Update the bundled epr-api library source code to v2.3. * Improve typing support. * Improve support for complex data like, e.g., SAR SLC products. New :func:`epr.Product.get_complex_band_as_array()` function. * Mark the `epr` extension module as "freethreading" compatible. Please refer to the :ref:`free-threading` section in the :doc:`usermanual` for more details about the freethreading and multi-threading compatibility of the module. PyEPR 1.2.0 (29/03/2025) ------------------------ * Drop the deprecated `print_` methods, `print` should be used instead. * Switch to cython `language_level=3`. * Fix the deprecated use of `property` is cython source files. * `epr` is now a package. * Switch to "src" project layout. * Rename `doc` folder into `docs`. * Switch to mathjax_ to build HTML docs. * Formatting. * Fix broken links. * Fix spelling. * Enable CI for linting and doc building. * Move coverage configuration to `pyproject.toml`. * Fix tests on iterators. * Fix unittests of OSX ARM. .. _mathjax: https://www.mathjax.org PyEPR 1.1.5 (15/10/2023) ------------------------ * Get rid of the deprecated `pip --install-options`. * No longer use the deprecated Cython_ `IF` statement. * Build wheels for Python 3.12. * Move project metadata to `pyproject.toml` PyEPR 1.1.4 (07/01/2023) ------------------------ * Do not use deprecated keywords in `setup.cfg`. * Silence compiler warnings. * Fix `extlinks` configuration. * Modernize documentation generation: - drop local theme - drop local sphinx extension for IPython console highlighting - use the RTD sphinx theme - update sidebar templates * Fix compatibility with `packaging` v22.0. * Modernize and re-format the Python code. * The minimum required Python version is now v3.7. PyEPR 1.1.3 (13/09/2021) ------------------------ * Do not use the deprecated distutils package. * Improve command line arguments management in ``setup.py``. * Stop distributing .c code auto-generated by Cython_ in the source tarball. Now the .c code is generated by Cython_ during the build package phase. PyEPR 1.1.2 (06/11/2021) ------------------------ * Enable CI testing with Python 3.10. * Update the internal copy of EPR C API to v2.3dev_pyepr112. PyEPR 1.1.1 (07/08/2021) ------------------------ * Fix a serious issue in sdist generation. PyEPR 1.1.0 (06/08/2021) ------------------------ * Old Python versions are no longer officially supported. Now PyEPR require Python >= 3.5 and Cython_ >= v0.29. * Introduced the ``pyproject.toml`` file. * The ``setup.py`` script has been simplified and modernized, now it always use setuptools_ and ``setup.cfg``. * Now the EPR C API is handled using git sub-module. * Fixed potential crash in cases in which the EPR C API fails to open the requested product * Update the test suite to use the public product ``ASA_APM_1PNPDE20091007_025628_000000432083_00118_39751_9244.N1``. The previously used one is no longer available. * Continuous Integration moved to GitHub Actions (GHA). * Fix a leak of resources on Windows platforms. * The ``print_()`` method of :class:`Field` and :class:`Record` classes has been renamed into ``print()``. The old ``print_()`` method is now deprecated and will be removed in future versions. * Support for :mod:`pathlib`. * Enforce type checking. PyEPR 1.0.1 (07/03/2020) ------------------------ * Fixed a problem in the test using the :data:`epr.Product._fileno` (only impacting MacOS-X). Also some advice about the correct use of :data:`epr.Product._fileno` has been added to the documentation. * Always close the product object during tests. Prevents errors during CI cleanup actions on Windows. PyEPR 1.0.0 (08/09/2019) ------------------------ * Do not use deprecated numpy_ API (requires Cython_ >= 0.29) * Minimal numpy_ version is now v1.7 * Set Cython_ 'language_level` explicitly to '3str' if Cython_ >= v0.29, to '2' otherwise * Python v2.6, v3.2, v3.3 and v3.4 are now deprecated. Support for the deprecated Python version will be removed in future releases of PyEPR PyEPR 0.9.5 (23/08/2018) ------------------------ * Fix compatibility with numpy_ >= 1.14: :func:`np.fromstring` is deprecated * Update the pypi sidebar in the documentation * Use `.rst` extension for doc source files * Fix setup script to not use system libs if epr-api sources are available * Do not access fields of bands after that the product has been closed (fix a segmentation fault on windows) * `unittest2`_ is now required for Python < 3.4 .. _unittest2: https://pypi.org/project/unittest2 PyEPR 0.9.4 (29/04/2018) ------------------------ * Fix compatibility with Cython_ >= 0.28 * PyEPR has been successfully tested with PyPy_ .. _PyPy: https://www.pypy.org PyEPR 0.9.3 (02/05/2015) ------------------------ * Fix PyEprExtension class in setup.py (closes :issue:`11`) * Updated internal EPR API version PyEPR 0.9.2 (08/03/2015) ------------------------ * Improved string representation of fields in case of :data:`E_TID_STRING` data type. Now bytes are decoded and represented as Python strings. * New tutorial :doc:`gdal_export_example` * Improved "Installation" and "Testing" sections of the user manual PyEPR 0.9.1 (27/02/2015) ------------------------ * Fix source distribution (missing EPR API C sources) PyEPR 0.9 (27/02/2015) ---------------------- * basic support for update mode: products can now be opened in update mode (`rb+`) and it is possible to call :meth:`epr.Field.set_elem` and :meth:`epr.Field.set_elems` methods to set :class:`epr.Field` elements changing the contents of the :class:`epr.Product` on disk. This feature is not available in the EPR C API. * new functions/methods and properties: - :attr:`epr.Record.index` property: returns the index of the :class:`epr.Record` within the :class:`epr.Dataset` - :attr:`epr.Band.dataset` property: returns the source :class:`epr.Dataset` object containing the raw data used to create the :class:`epr.Band`\ ’s pixel values - :attr:`epr.Band._field_index` and :attr:`epr.Band._elem_index` properties: return the :class:`epr.Field` index (within the :class:`epr.Record`) and the element index (within the :class:`epr.Field`) containing the raw data used to create the :class:`epr.Band`\ ’s pixel values - :attr:`epr.Record.dataset_name` property: returns the name of the :class:`epr.Dataset` from which the :class:`Record` has bee read - :attr:`epr.Record.tot_size` and :attr:`epr.Field.tot_size` properties: return the total size in bytes of the :class:`epr.Record` and :class:`epr.Field` respectively - :func:`epr.get_numpy_dtype` function: retrieves the numpy_ data type corresponding to the specified EPR type ID - added support for some low level feature: the *_magic* private attribute stores the identifier of EPR C stricture, the :meth:`epr.Record.get_offset` returns the offset in bytes of the :class:`epr.Record` within the file, and the :meth:`epr.Field.get_offset` method returns the :clasS:`epr.Field` offset within the :class:`epr.Record` * improved functions/methods: - :meth:`epr.Field.get_elems` now also handles :data:`epr.E_TID_STRING` and :data:`epr.E_TID_TIME` data types - improved :func:`epr.get_data_type_size`, :func:`epr.data_type_id_to_str`, :func:`epr.get_scaling_method_name` and :func:`epr.get_sample_model_name` functions that are now defined using the cython `cpdef` directive - the :meth:`epr.Field.get_elems` method has been re-written to remove loops and unnecessary data copy - now generator expressions are used to implement `__iter__` special methods * the *index* parameter of the :meth:`epr.Dataset.read_record` method is now optional (defaults to zero) * the deprecated `__revision__` variable has been removed * declarations of the EPR C API have been moved to the new :file:`epr.pxd` * the `const_char` and `const_void` definitions have been dropped, no longer necessary with Cython_ >= 0.19 * minimum required version for Cython_ is now 0.19 * the :file:`setup.py` script has been completely rewritten to be more "pip_ friendly". The new script uses setuptools_ if available and functions that use numpy_ are evaluated lazily so to give a chance to pip_ and setuptools_ to install dependencies, numpy_, before they are actually used. This should make PyEPR "pip-installable" even on system there numpy_ is not already installed. * the :file:`test` directory has been renamed into :file:`tests` * the test suite now has a :func:`setUpModule` function that automatically downloads the ENVISAT test data required for test execution. The download only happens if the test dataset is not already available. * tests can now be run using the :file:`setup.py` script:: $ python3 setup.py test * enable continuous integration and testing in for Windows_ using AppVeyor_ (32bit only) * status badges for `AppVeyor CI `_ and PyPI_ added to the HTML doc index .. _pip: https://pip.pypa.io .. _setuptools: https://github.com/pypa/setuptools .. _numpy: https://numpy.org .. _Windows: https://windows.microsoft.com .. _AppVeyor: https://www.appveyor.com .. _PyPI: https://pypi.org/project/pyepr PyEPR 0.8.2 (03/08/2014) ------------------------ * fixed segfault caused by incorrect access to :attr:`epr.Dataset.description` string in case of closed products * fixed a memory leak in :class:`epr.Raster` (closes :issue:`10`) * the size parameters (*src_width* and *src_height*) in :meth:`epr.Band.create_compatible_raster` are now optional. By default a :class:`epr.Raster` with the same size of the scene is created * the test suite have been improved * improved the :doc:`NDVI computation example ` * updates sphinx config * small clarification in the :ref:`installation` section of the :doc:`usermanual`. * EPR C API (version bundled with the official source tar-ball) - in case of error always free resources before setting the error code. This avoids error shadowing in some cases. - fixed a bug that caused reading of the incorrect portion of data in case of mirrored annotation datasets (closes :issue:`9`) - fixed a bug that caused incorrect data sub-sampling in case of mirrored datasets PyEPR 0.8.1 (07/09/2013) ------------------------ * fixed an important bug in the error checking code introduced in previous release (closes :issue:`8`) * fixed the NDVI example * no more display link URL in footnotes of the PDF User Manual PyEPR 0.8 (07/09/2013) ---------------------- * now the :class:`epr.Product` objects have a :meth:`epr.Product.close` method that can be used to explicitly close products without relying on the garbage collector behavior (closes :issue:`7`) * new :attr:`epr.Product.closed` (read-only) attribute that can be used to check if a :class:`epr.Product` has been closed * the :class:`Product` class now supports context management so they can be used in ``with`` statements * added entries for :data:`epr.__version__` and :data:`epr.__revision__` in the reference manual * the :data:`epr.__revision__` module attribute is now deprecated * some *cythonization* warnings have been fixed * several small improvements to the documentation PyEPR 0.7.1 (19/08/2013) ------------------------ * fixed potential issues with conversion from python strings to ``char*`` * new snapshot of the EPR C API sources (2.3dev): - the size of the record tables has been fixed - the EPR_NUM_PRODUCT_TABLES has been fixed - fixed a missing prototype - several GCC warnings has been silenced - additional checks on return codes - now and error is raised when an invalid flag name is used * better factorization of Python 3 specific code * use the *CLOUD* flag instead of *BRIGHT* in unit tests * added function/method signature to all doc-strings for better interactive help * several improvements to the documentation: - updated the :file:`README.txt` file to mention EPR C API sources inclusion in the PyEPR 0.7 (and latest) source tar-ball - small fix in the installation instructions: the pip_ tool does not have a "--prefix" parameter - always use the python3 syntax for the *print* function in all examples in the documentation - links to older (and dev) versions of the documentation have been added in the man page of the HTML doc - removed *date* form the doc meta-data. The documentation build date is reported in the front page of the LaTeX (PDF) doc and, starting from this release, in the footer of the HTML doc. - the Ohloh_ widget has been added in the sidebar of the HTML doc - improved the regexp for detecting the SW version in the :file`setup.py` script - formatting .. _Ohloh: https://www.openhub.net PyEPR 0.7 (04/08/2013) ---------------------- * more detailed error messages in case of open failures * new sphinx theme for the HTML documentation * `Travis-CI`_ has been set-up for the project * now the source tar-ball also includes a copy of the EPR C API sources so that no external C library is required to build PyEPR. This features also makes it easier to install PyEPR using pip_. The user can still guild PyEPR against a system version of the ERP-API library simply using the `--epr-api-src` option of the :file:`setup.py` script with "None"" as value. The ERP C API included in the source tar-ball is version *2.3dev-pyepr062*, a development and patched version that allows the following enhancements. - support for ERS products in ENVISAT format - support for ASAR products generated with the new ASAR SW version 6.02 (ref. doc. PO-RS-MDA-GS-2009_4/C - fix incorrect reading of "incident_angle" bands (closes :issue:`6`). The issue is in the EPR C API. .. _`Travis-CI`: https://travis-ci.org/avalentino/pyepr PyEPR 0.6.1 (26/04/2012) ------------------------ * fix compatibility with Cython_ 0.16 * added a new option to the setup script (`--epr-api-src`) to build PyEPR using the EPR-API C sources PyEPR 0.6 (12/08/2011) ---------------------- * full support for `Python 3`_ * improved code highlighting in the documentation * depend from cython >= 0.13 instead of cython >= 0.14.1. Cythonizing :file:`epr.pyx` with `Python 3`_ requires cython >= 0.15 PyEPR 0.5 (25/04/2011) ---------------------- * stop using :c:func:`PyFile_AsFile` that is no more available in `Python 3`_ * now documentation uses intersphinx_ capabilities * code examples added to documentation * tutorials added to documentation * the LICENSE.txt file is now included in the source distribution * the Cython_ construct ``with nogil`` is now used instead of calling :c:func:`Py_BEGIN_ALLOW_THREADS` and :c:func:`Py_END_ALLOW_THREADS` directly * dropped old versions of Cython_; now Cython_ 0.14.1 or newer is required * suppressed several constness related warnings .. _`Python 3`: https://docs.python.org/3 .. _intersphinx: https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html .. _Cython: https://cython.org PyEPR 0.4 (10/04/2011) ---------------------- * fixed a bug in the :meth:`epr.Product.__str__`, :meth:`Dataset.__str__` and :meth:`erp.Band.__repr__` methods (bad formatting) * fixed :meth:`epr.Field.get_elems` method for char and uchar data types * implemented :meth:`epr.Product.read_bitmask_raster`, now the :class:`epr.Product` API is complete * fixed segfault in :meth:`epr.Field.get_unit` method when the field has no unit * a smaller dataset is now used for unit tests * a new tutorial section has been added to the user documentation PyEPR 0.3 (01/04/2011) ---------------------- * version string of the EPR C API is now exposed as module attribute :data:`epr.EPR_C_API_VERSION` * implemented ``__repr__``, ``__str__``, ``__eq__``, ``__ne__`` and ``__iter__`` special methods * added utility methods (not included in the C API) like: - :meth:`epr.Record.get_field_names` - :meth:`epr.Record.fields` - :meth:`epr.Dataset.records` - :meth:`epr.Product.get_dataset_names` - :meth:`epr.Product.get_band_names` - :meth:`epr.Product.datasets` - :meth:`epr.Product.bands` * fixed a logic error that caused empty messages in custom EPR exceptions PyEPR 0.2 (20/03/2011) ---------------------- * sphinx_ documentation added * added docstrings to all method and classes * renamed some method and parameter in order to avoid redundancies and have a more *pythonic* API * in case of null pointers a :exc:`epr.EPRValueError` is raised * improved C library shutdown management * introduced some utility methods to :class:`epr.Product` and :class:`epr.Record` classes .. _sphinx: https://www.sphinx-doc.org PyEPR 0.1 (09/03/2011) ---------------------- Initial release pyepr-1.3.1/docs/_static/000077500000000000000000000000001525260221700152335ustar00rootroot00000000000000pyepr-1.3.1/docs/_static/.gitkeep000066400000000000000000000000001525260221700166520ustar00rootroot00000000000000pyepr-1.3.1/docs/_templates/000077500000000000000000000000001525260221700157425ustar00rootroot00000000000000pyepr-1.3.1/docs/_templates/codecov.html000066400000000000000000000003641525260221700202550ustar00rootroot00000000000000 pyepr-1.3.1/docs/_templates/gha.html000066400000000000000000000004251525260221700173700ustar00rootroot00000000000000 pyepr-1.3.1/docs/_templates/layout.html000066400000000000000000000004621525260221700201470ustar00rootroot00000000000000{% extends "!layout.html" %} {%- block menu %} {{ super() }} {%- if sidebars != None and pagename == root_doc %}
{#- new style sidebar: explicitly include/exclude templates #} {%- for sidebartemplate in sidebars %} {%- include sidebartemplate %} {%- endfor %} {%- endif %} {% endblock %} pyepr-1.3.1/docs/_templates/ohloh.html000066400000000000000000000003211525260221700177350ustar00rootroot00000000000000
pyepr-1.3.1/docs/_templates/pypi.html000066400000000000000000000014521525260221700176130ustar00rootroot00000000000000 pyepr-1.3.1/docs/_templates/readthedocs.html000066400000000000000000000003271525260221700211170ustar00rootroot00000000000000
  • readthedocs status
    • pyepr-1.3.1/docs/bands_example.rst000066400000000000000000000112571525260221700171470ustar00rootroot00000000000000Exporting band data ------------------- .. index:: ENVISAT, band, raster This tutorial shows how to convert ENVISAT_ raster information from dataset and generate flat binary (raster) files using PyEPR_. The program generates as many raster as the dataset specified in input. The example code (:download:`examples/write_bands.py`) is a direct translation of the C sample program `write_bands.c`_ bundled with the EPR API distribution. The program is invoked as follows: .. code-block:: sh $ python write_bands.py \ \ [ ... ] .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _PyEPR: https://github.com/avalentino/pyepr .. _`write_bands.c`: https://github.com/bcdev/epr-api/blob/master/src/examples/write_bands.c Import section ~~~~~~~~~~~~~~ To use the Python_ EPR API one have to import :mod:`epr` module. At first import time the underlying C library is opportunely initialized. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 1-12 The main program ~~~~~~~~~~~~~~~~ The main program in quite simple (this is just an example). .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 49- It performs some basic command line arguments handling and then open the input product. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 95-96 Finally the core function (:func:`write_raw_image`) is called on each band specified on the command: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 97-98 The :func:`write_raw_image` core function ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The core function is :func:`write_raw_image`. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :pyobject: write_raw_image It generates a flat binary file with data of a single band whose name is specified as input parameter. First the output file name is computed using the :mod:`os` module. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 20-21 Then the desired band is retrieved using the :meth:`epr.Product.get_band` method and some of its parameters are loaded in to local variables: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 23 Band data are accessed by means of a :class:`epr.Raster` object. .. seealso:: :func:`epr.Band.read_as_array` The :meth:`epr.Band.create_compatible_raster` is a facility method that allows to instantiate a :class:`epr.Raster` object with a data type compatible with the band data: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 29-31 Then data are read using the :meth:`epr.Band.read_raster` method: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 33-34 Then the output file object is created (in binary mode of course) and data are copied to the output file one line at time .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bands.py :language: python :lines: 36-38 Please note that it has been used :data:`epr.Raster.data` attribute of the :class:`epr.Raster` objects that exposes :class:`epr.Raster` data with the powerful :class:`numpy.ndarray` interface. .. note:: copying one line at time is not the best way to perform the task in Python_. It has been done just to mimic the original C code: .. code-block:: c out_stream = fopen(image_file_path, "wb"); if (out_stream == NULL) { printf("Error: can't open '%s'\n", image_file_path); return 3; } for (y = 0; y < (uint)raster->raster_height; ++y) { numwritten = fwrite(epr_get_raster_line_addr(raster, y), raster->elem_size, raster->raster_width, out_stream); if (numwritten != raster->raster_width) { printf("Error: can't write to %s\n", image_file_path); return 4; } } fclose(out_stream); A by far more "pythonic" solution would be:: raster.data.tofile(out_stream) .. _Python: https://www.python.org .. raw:: latex \clearpage pyepr-1.3.1/docs/bitmask_example.rst000066400000000000000000000071051525260221700175070ustar00rootroot00000000000000Exporting bit-masks ------------------- .. index:: bitmask, ENVISAT This tutorial shows how to generate bit masks from ENVISAT_ flags information as "raw" image using PyEPR_. The example code (:download:`examples/write_bitmask.py`) is a direct translation of the C sample program `write_bitmask.c`_ bundled with the EPR API distribution. The program is invoked as follows: .. code-block:: sh $ python write_bitmask.py \ .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _PyEPR: https://github.com/avalentino/pyepr .. _`write_bitmask.c`: https://github.com/bcdev/epr-api/blob/master/src/examples/write_bitmask.c The :download:`examples/write_bitmask.py` code consists in a single function that also includes command line arguments handling: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python .. index:: EPR-API, module pair: epr; module In order to use the Python_ EPR API the :mod:`epr` module is imported: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :lines: 26 .. index:: product, open pair: with; statement As usual the ENVISAT_ product is opened using the :func:`epr.open` function that returns an :class:`epr.Product` instance. In this case the :func:`epr.open` is used together with a ``with`` statement so that the :class:`epr.Product` instance is closed automatically when the program exits the ``with`` block. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python :lines: 58-59 .. index:: product Scene size parameters are retrieved form the :class:`epr.Product` object using the :meth:`epr.Product.get_scene_width` and :meth:`epr.Product.get_scene_height` methods: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python :lines: 62-63 The EPR API allows to manage data by means of :class:`epr.Raster` objects, so the function :func:`epr.create_bitmask_raster`, specific for bit-masks, is used to create a :class:`epr.Raster` instance. .. seealso:: :func:`epr.create_raster` Data are actually read using the :meth:`epr.Product.read_bitmask_raster` method of the :class:`epr.Product` class: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python :lines: 71 The :meth:`epr.Product.read_bitmask_raster` method receives in input the *bm_expr* parameter that is set via command line: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python :lines: 55 *bm_expr* is a string that define the logical expression for the definition of the bit-mask. In a bit-mask expression, any number of the flag-names (found in the DDDB) can be composed with “(”, ”)”, “NOT”, “AND”, “OR”. .. index:: AND, OR, NOT, DDDB Valid bit-mask expression are for example:: flags.LAND OR flags.CLOUD or:: NOT flags.WATER AND flags.TURBID_S Finally data are written to disk as a flat binary file using the :meth:`numpy.ndarray.tofile` method of the :data:`epr.Raster.data` attribute of the :class:`epr.Raster` objects that exposes data via the :class:`numpy.ndarray` interface: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_bitmask.py :language: python :lines: 73-74 .. _Python: https://www.python.org .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. raw:: latex \clearpage pyepr-1.3.1/docs/conf.py000066400000000000000000000110141525260221700151010ustar00rootroot00000000000000# Configuration file for the Sphinx documentation builder. # # For the full list of built-in configuration values, see the documentation: # https://www.sphinx-doc.org/en/master/usage/configuration.html # -- Version utils ----------------------------------------------------------- def _get_version(filename): import re from packaging.version import parse as Version with open(filename, encoding="utf-8") as fd: data = fd.read() mobj = re.search( r"""^__version__\s*=\s*(?P['"])(?P.*)(?P=quote)""", data, re.MULTILINE, ) return Version(mobj.group("version")) # -- Project information ----------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information project = "PyEPR" copyright = "2011-2026, Antonio Valentino" author = "Antonio Valentino" _version = _get_version("../src/epr/__init__.py") version = _version.base_version release = str(_version) # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration extensions = [ # "sphinx.ext.autodoc", # "sphinx.ext.autosectionlabel", # "sphinx.ext.autosummary", # "sphinx.ext.coverage", "sphinx.ext.doctest", # "sphinx.ext.duration", "sphinx.ext.extlinks", # "sphinx.ext.githubpages", # "sphinx.ext.graphviz", "sphinx.ext.ifconfig", # "sphinx.ext.imgconverter", # "sphinx.ext.inheritance_diagram", "sphinx.ext.intersphinx", # "sphinx.ext.linkcode", # needs_sphinx = "1.2" # "sphinx.ext.napoleon", "sphinx.ext.todo", "sphinx.ext.viewcode", # "sphinx.ext.imgmath", # "sphinx.ext.jsmath", "sphinx.ext.mathjax", "sphinx_rtd_theme", "IPython.sphinxext.ipython_console_highlighting", "IPython.sphinxext.ipython_directive", ] try: import sphinxcontrib.spelling # noqa: F401 except ImportError: pass else: extensions.append("sphinxcontrib.spelling") templates_path = ["_templates"] master_doc = "index" exclude_patterns = [ "_build", "Thumbs.db", ".DS_Store", "**/.gitkeep", ] # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output # html_theme = 'alabaster' html_theme = "sphinx_rtd_theme" html_theme_options = { # 'prev_next_buttons_location': 'both', } html_static_path = ["_static"] html_last_updated_fmt = "%b %d, %Y" html_sidebars = { "index": [ # 'globaltoc.html', # 'relations.html', # 'sourcelink.html', # 'searchbox.html', "pypi.html", "gha.html", "readthedocs.html", "codecov.html", "ohloh.html", ], } html_domain_indices = False html_context = { "display_github": True, "github_user": "avalentino", "github_repo": "pyepr", "github_version": "master", "conf_py_path": "/docs/", } # -- Options for LaTeX output ------------------------------------------------ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-latex-output latex_elements = { "papersize": "a4paper", "pointsize": "12pt", # 'preamble': '', # 'figure_align': 'htbp', } latex_documents = [ (master_doc, "pyepr.tex", "PyEPR Documentation", author, "manual"), ] latex_domain_indices = False # -- Options for linkcheck ------------------------------------------------ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-the-linkcheck-builder linkcheck_ignore = [ f"https://pyepr.readthedocs.io/en/v{version}", "https://www.openhub.net", "https://www.gnu.org/licenses/gpl-3.0.html", ] # -- Extension configuration ------------------------------------------------- # -- Options for intersphinx extension --------------------------------------- # https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#configuration intersphinx_mapping = { "python": ("https://docs.python.org/3", None), "numpy": ("https://docs.scipy.org/doc/numpy", None), } # -- Options for extlinks extension ------------------------------------------ # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html#module-sphinx.ext.extlinks extlinks = { "issue": ("https://github.com/avalentino/pyepr/issues/%s", "gh-%s"), } # -- Options for todo extension ---------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/extensions/todo.html#configuration todo_include_todos = True pyepr-1.3.1/docs/examples/000077500000000000000000000000001525260221700154235ustar00rootroot00000000000000pyepr-1.3.1/docs/examples/export_gdalvrt.py000077500000000000000000000133621525260221700210510ustar00rootroot00000000000000#!/usr/bin/env python3 import os from osgeo import gdal import epr epr_to_gdal_type = { epr.E_TID_UNKNOWN: gdal.GDT_Unknown, epr.E_TID_UCHAR: gdal.GDT_Byte, epr.E_TID_CHAR: gdal.GDT_Byte, epr.E_TID_USHORT: gdal.GDT_UInt16, epr.E_TID_SHORT: gdal.GDT_Int16, epr.E_TID_UINT: gdal.GDT_UInt32, epr.E_TID_INT: gdal.GDT_Int32, epr.E_TID_FLOAT: gdal.GDT_Float32, epr.E_TID_DOUBLE: gdal.GDT_Float64, # epr.E_TID_STRING: gdal.GDT_Unknown, # epr.E_TID_SPARE: gdal.GDT_Unknown, # epr.E_TID_TIME: gdal.GDT_Unknown, } def epr2gdal_band(band, vrt): # noqa: C901, PLR0914 product = band.product dataset = band.dataset record = dataset.read_record(0) field = record.get_field_at(band._field_index - 1) # noqa: SLF001 ysize = product.get_scene_height() xsize = product.get_scene_width() if isinstance(vrt, gdal.Dataset): if (vrt.RasterYSize, vrt.RasterXSize) != (ysize, xsize): raise ValueError("dataset size do not match") gdal_ds = vrt elif os.path.exists(vrt): gdal_ds = gdal.Open(vrt, gdal.GA_Update) if gdal_ds is None: raise RuntimeError(f"unable to open {vrt!r}") driver = gdal_ds.GetDriver() if driver.ShortName != "VRT": raise TypeError( f"unexpected GDAL driver ({driver.ShortName}). " f"VRT driver expected" ) else: driver = gdal.GetDriverByName("VRT") if driver is None: raise RuntimeError("unable to get driver 'VRT'") gdal_ds = driver.Create(vrt, xsize, ysize, 0) if gdal_ds is None: raise RuntimeError(f"unable to create {vrt!r} dataset") filename = os.pathsep.join(product.file_path.split("/")) # denormalize offset = dataset.get_dsd().ds_offset + field.get_offset() line_offset = record.tot_size pixel_offset = epr.get_data_type_size(field.get_type()) if band.sample_model == epr.E_SMOD_1OF2: pixel_offset *= 2 elif band.sample_model == epr.E_SMOD_2OF2: offset += pixel_offset pixel_offset *= 2 options = [ "subClass=VRTRawRasterBand", f"SourceFilename={filename}", f"ImageOffset={offset}", f"LineOffset={line_offset}", f"PixelOffset={pixel_offset}", "ByteOrder=MSB", ] gtype = epr_to_gdal_type[field.get_type()] ret = gdal_ds.AddBand(gtype, options=options) if ret != gdal.CE_None: raise RuntimeError(f"unable to add VRTRawRasterBand to {vrt!r}") gdal_band = gdal_ds.GetRasterBand(gdal_ds.RasterCount) gdal_band.SetDescription(band.description) metadata = { "name": band.get_name(), "dataset_name": dataset.get_name(), "dataset_description": dataset.description, "lines_mirrored": str(band.lines_mirrored), "sample_model": epr.get_sample_model_name(band.sample_model), "scaling_factor": str(band.scaling_factor), "scaling_offset": str(band.scaling_offset), "scaling_method": epr.get_scaling_method_name(band.scaling_method), "spectr_band_index": str(band.spectr_band_index), "unit": band.unit if band.unit else "", "bm_expr": band.bm_expr if band.bm_expr else "", } gdal_band.SetMetadata(metadata) return gdal_ds def epr2gdal(product, vrt, *, overwrite_existing: bool = False): if isinstance(product, str): filename = product product = epr.open(filename) ysize = product.get_scene_height() xsize = product.get_scene_width() if os.path.exists(vrt) and not overwrite_existing: raise ValueError(f"unable to create {vrt!r}. Already exists") driver = gdal.GetDriverByName("VRT") if driver is None: raise RuntimeError("unable to get driver 'VRT'") gdal_ds = driver.Create(vrt, xsize, ysize, 0) if gdal_ds is None: raise RuntimeError(f"unable to create {vrt!r} dataset") metadata = { "id_string": product.id_string, "meris_iodd_version": str(product.meris_iodd_version), "dataset_names": ",".join(product.get_dataset_names()), "num_datasets": str(product.get_num_datasets()), "num_dsds": str(product.get_num_dsds()), } gdal_ds.SetMetadata(metadata) mph = product.get_mph() metadata = str(mph).replace(" = ", "=").split("\n") gdal_ds.SetMetadata(metadata, "MPH") sph = product.get_sph() metadata = str(sph).replace(" = ", "=").split("\n") gdal_ds.SetMetadata(metadata, "SPH") for band in product.bands(): epr2gdal_band(band, gdal_ds) # @TODO: set geographic info return gdal_ds if __name__ == "__main__": filename = "MER_LRC_2PTGMV20000620_104318_00000104X000_00000_00000_0001.N1" vrtfilename = os.path.splitext(filename)[0] + ".vrt" gdal_ds = epr2gdal(filename, vrtfilename) with epr.open(filename) as product: band_index = product.get_band_names().index("water_vapour") band = product.get_band("water_vapour") eprdata = band.read_as_array() unit = band.unit lines_mirrored = band.lines_mirrored scaling_offset = band.scaling_offset scaling_factor = band.scaling_factor gdal_band = gdal_ds.GetRasterBand(band_index + 1) vrtdata = gdal_band.ReadAsArray() if lines_mirrored: vrtdata = vrtdata[:, ::-1] vrtdata = vrtdata * scaling_factor + scaling_offset print("Max absolute error:", abs(vrtdata - eprdata).max()) # plot from matplotlib import pyplot as plt plt.figure() plt.subplot(2, 1, 1) plt.imshow(eprdata) plt.grid() cb = plt.colorbar() cb.set_label(unit) plt.title("EPR data") plt.subplot(2, 1, 2) plt.imshow(vrtdata) plt.grid() cb = plt.colorbar() cb.set_label(unit) plt.title("VRT data") plt.show() pyepr-1.3.1/docs/examples/update_elements.py000077500000000000000000000044361525260221700211650ustar00rootroot00000000000000#!/usr/bin/env python3 import numpy as np from matplotlib import pyplot as plt import epr FILENAME = "MER_LRC_2PTGMV20000620_104318_00000104X000_00000_00000_0001.N1" # load original data with epr.open(FILENAME) as product: band = product.get_band("water_vapour") wv_orig_histogram, orig_bins = np.histogram(band.read_as_array().flat, 50) # plot water vapour histogram plt.figure() plt.bar(orig_bins[:-1], wv_orig_histogram, 0.02, label="original") plt.grid() plt.title("Water Vapour Histogram") plt.savefig("water_vapour_histogram_01.png") # modily scaling facotrs with epr.open(FILENAME, "rb+") as product: dataset = product.get_dataset("Scaling_Factor_GADS") record = dataset.read_record(0) field = record.get_field("sf_wvapour") scaling = field.get_elem() scaling *= 1.1 field.set_elem(scaling) # re-open the product and load modified data with epr.open(FILENAME) as product: band = product.get_band("water_vapour") unit = band.unit new_data = band.read_as_array() wv_new_histogram, new_bins = np.histogram(new_data.flat, 50) # plot histogram of modified data plt.figure() plt.bar(orig_bins[:-1], wv_orig_histogram, 0.02, label="original") plt.grid() plt.title("Water Vapour Histogram") plt.hold() plt.bar(new_bins[:-1], wv_new_histogram, 0.02, color="red", label="new") plt.legend() plt.savefig("water_vapour_histogram_02.png") # plot the water vapour map plt.figure(figsize=(8, 4)) plt.imshow(new_data) plt.grid() plt.title("Water Vapour") cb = plt.colorbar() cb.set_label(f"[{unit}]") plt.savefig("modified_water_vapour.png") # modify the "Vapour_Content" dataset with epr.open(FILENAME, "rb+") as product: dataset = product.get_dataset("Vapour_Content") for line in range(70, 100): record = dataset.read_record(line) field = record.get_field_at(2) elems = field.get_elems() elems[50:100] = 0 field.set_elems(elems) # re-open the product and load modified data with epr.open(FILENAME) as product: band = product.get_band("water_vapour") unit = band.unit data = band.read_as_array() # plot the water vapour map plt.figure(figsize=(8, 4)) plt.imshow(data) plt.grid() plt.title("Water Vapour with box") cb = plt.colorbar() cb.set_label(f"[{unit}]") plt.savefig("modified_water_vapour_with_box.png") plt.show() pyepr-1.3.1/docs/examples/write_bands.py000077500000000000000000000056161525260221700203110ustar00rootroot00000000000000#!/usr/bin/env python3 # This program is a direct translation of the sample program # "write_bands.c" bundled with the EPR-API distribution. # # Source code of the C program is available at: # https://github.com/bcdev/epr-api/blob/master/src/examples/write_bands.c import os import sys import epr def write_raw_image(output_dir, product, band_name): """Generate the ENVI binary pattern image file for an actual DS. The first parameter is the output directory path. """ # Build ENVI file path, DS name specifically image_file_path = os.path.join(output_dir, band_name + ".raw") band = product.get_band(band_name) source_w = product.get_scene_width() source_h = product.get_scene_height() source_step_x = 1 source_step_y = 1 raster = band.create_compatible_raster( source_w, source_h, source_step_x, source_step_y ) print(f"Reading band {band_name!r}...") raster = band.read_raster(0, 0, raster) with open(image_file_path, "wb") as out_stream: for line in raster.data: out_stream.write(line.tostring()) # or better: raster.data.tofile(out_stream) print(f"Raw image data successfully written to {image_file_path!r}.") print( f"C data type is {epr.data_type_id_to_str(raster.data_type)!r}, " f"element size {raster.get_elem_size()} byte(s), " f"raster size is {raster.get_width()} x {raster.get_height()} pixels." ) def main(*argv): """A program for converting producing ENVI raster information from dataset. It generates as many raster as there are dataset entrance parameters. Call:: $ python3 write_bands.py [ ... ] Example:: $ python3 write_bands.py \ MER_RR__1PNPDK20020415_103725_000002702005_00094_00649_1059.N1 \ . latitude """ if not argv: argv = sys.argv if len(argv) <= 3: print( """Usage: python3 write_bands.py [ ... ] where envisat-product is the input filename and output-dir is the output directory and dataset-name-1 is the name of the first band to be extracted (mandatory) and dataset-name-2 ... dataset-name-N are the names of further bands to be extracted (optional) Example: python3 write_bands MER_RR__2P_TEST.N1 . latitude """ ) sys.exit(1) product_file_path = argv[1] output_dir_path = argv[2] # Open the product; the argument is the path to product the data file with epr.open(product_file_path) as product: for band_name in argv[3:]: write_raw_image(output_dir_path, product, band_name) if __name__ == "__main__": main() pyepr-1.3.1/docs/examples/write_bitmask.py000077500000000000000000000040141525260221700206430ustar00rootroot00000000000000#!/usr/bin/env python3 # This program is a direct translation of the sample program # "write_bitmask.c" bundled with the EPR-API distribution. # # Source code of the C program is available at: # https://github.com/bcdev/epr-api/blob/master/src/examples/write_bitmask.c """Generates bit mask from ENVISAT flags information as "raw" image for (e.g.) Photoshop. Call:: $ python3 write_bitmask.py Example to call the main function:: $ python3 write_bitmask.py MER_RR__2P_TEST.N1 \ 'l2_flags.LAND and !l2_flags.BRIGHT' my_flags.raw """ import sys import epr def main(*argv): if not argv: argv = sys.argv if len(argv) != 4: print( """\ Usage: python3 write_bitmask where envisat-product is the input filename and bitmask-expression is a string containing the bitmask logic and output-file is the output filename. Example: MER_RR__2P_TEST.N1 'l2_flags.LAND and not l2_flags.BRIGHT' my_flags.raw """ ) sys.exit(1) product_file_path = argv[1] bm_expr = argv[2] image_file_path = argv[3] # Open the product; an argument is a path to product data file with epr.open(product_file_path) as product: offset_x = 0 offset_y = 0 source_width = product.get_scene_width() source_height = product.get_scene_height() source_step_x = 1 source_step_y = 1 bm_raster = epr.create_bitmask_raster( source_width, source_height, source_step_x, source_step_y ) product.read_bitmask_raster(bm_expr, offset_x, offset_y, bm_raster) with open(image_file_path, "wb") as out_stream: bm_raster.data.tofile(out_stream) print(f"Raw image data successfully written to {image_file_path!r}.") print( f"Data type is 'byte', size is {source_width} x {source_height} " f"pixels." ) if __name__ == "__main__": main() pyepr-1.3.1/docs/examples/write_ndvi.py000077500000000000000000000055131525260221700201560ustar00rootroot00000000000000#!/usr/bin/env python3 # This program is a direct translation of the sample program # "write_ndvi.c" bundled with the EPR-API distribution. # # Source code of the C program is available at: # https://github.com/bcdev/epr-api/blob/master/src/examples/write_ndvi.c """Example for using the epr-api. Demonstrates how to open a MERIS L1b product and calculate the NDVI. This example does not demonstrate how to write good and safe code. It is reduced to the essentials for working with the epr-api. Calling sequence:: $ python3 write_ndvi.py for example:: $ python3 write_ndvi.py MER_RR__1P_test.N1 my_ndvi.raw """ import sys import struct import logging import epr def main(*argv): if not argv: argv = sys.argv if len(argv) != 3: print( """" Usage: python3 write_ndvi where envisat-product is the input filename and output-file is the output filename. Example: MER_RR__1P_TEST.N1 my_ndvi.raw """ ) sys.exit(1) # Open the product with epr.open(argv[1]) as product: # The NDVI shall be calculated using bands 6 and 8. band1_name = "radiance_6" band2_name = "radiance_10" band1 = product.get_band(band1_name) band2 = product.get_band(band2_name) # Allocate memory for the rasters width = product.get_scene_width() height = product.get_scene_height() subsampling_x = 1 subsampling_y = 1 raster1 = band1.create_compatible_raster( width, height, subsampling_x, subsampling_y ) raster2 = band2.create_compatible_raster( width, height, subsampling_x, subsampling_y ) # Read the radiance into the raster. offset_x = 0 offset_y = 0 logging.info("read %r data", band1_name) band1.read_raster(offset_x, offset_y, raster1) logging.info("read %r data", band2_name) band2.read_raster(offset_x, offset_y, raster2) # Open the output file logging.info("write ndvi to %r", argv[2]) with open(argv[2], "wb") as out_stream: # Loop over all pixel and calculate the NDVI. # # @NOTE: looping over data matrices is not the best solution. # It is done here just for demostrative purposes for j in range(height): for i in range(width): rad1 = raster1.get_pixel(i, j) rad2 = raster2.get_pixel(i, j) if (rad1 + rad2) != 0.0: ndvi = (rad2 - rad1) / (rad2 + rad1) else: ndvi = -1.0 out_stream.write(struct.pack("f", ndvi)) logging.info("ndvi was written success") if __name__ == "__main__": main() pyepr-1.3.1/docs/gdal_export_example.rst000066400000000000000000000146141525260221700203700ustar00rootroot00000000000000GDAL_ export example -------------------- .. index:: GDAL, export, VRT, ENVISAT, offset This tutorial explains how to use PyEPR_ to generate a file in GDAL Virtual Format (VRT) that can be used to access data with the powerful and popular GDAL_ library. GDAL_ already has support for ENVISAT_ products but this example is interesting for two reasons: * it exploits some low level feature (like e.g. offset management) that are rarely used but that can be very useful in some cases * the generated VRT file uses raw raster access and it can be opened in update mode to modify the ENVISAT_ product data. This feature is not supported by the native ENVISAT_ driver of the GDAL_ library export_gdalvrt module ~~~~~~~~~~~~~~~~~~~~~ The complete code of the example is available in the :download:`examples/export_gdalvrt.py` file. It is organized so that it can also be imported as a module in any program. The :mod:`export_gdalvrt` module provides two functions: .. module:: export_gdalvrt .. function:: epr2gdal_band(band, vrt) Takes in input an :class:`epr.Band` object and a VRT dataset and add a GDAL_ band to the VRT dataset .. function:: epr2gdal(product, vrt, overwrite_existing=False) Takes in input a PyEPR_ :class:`Product` (or a filename) and the file name of the output VRT file and generates the VRT file itself containing a band for each :class:`epr.Band` present in the original :class:`epr.Product` and also associated metadata. The :func:`epr2gdal` function first creates the VRT dataset .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 102-118 and then loops on all :class:`epr.Band`\ s of the PyEPR_ :class:`epr.Product` calling the :func:`epr2gdal_band` function on each of them: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 137-138 The :mod:`export_gdalvrt` module also provides a :data:`epr_to_gdal_type` mapping between EPR and GDAL data type identifiers. .. index:: VRTRawRasterBand Generating *VRTRawRasterBand*\ s ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The core of the example is the part of the code in the :func:`epr2gdal_band` function that generates the GDAL_ *VRTRawRasterBand*. It is a description of a raster file that the GDAL_ library uses for low level data access. Of course the entire machinery works because data in :class:`epr.Band`\s and :class:`epr.Dataset`\ s of ENVISAT_ products are stored as contiguous raster files. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 56-79 .. index:: offset The fundamental part is the computation of the: **ImageOffset**: the offset in bytes to the beginning of the first pixel of data with respect to the beginning of the file. In the example it is computed using * the :data:`epr.DSD.ds_offset` attribute, that represents the offset in bytes of the :class:`epr.Dataset` from the beginning of the file, and * the :meth:`epr.Field.get_offset` method that returns the offset in bytes of the :class:`epr.Field` containing :class:`epr.Band` data from the beginning of the :class:`epr.Record` :: offset = dataset.get_dsd().ds_offset + field.get_offset() **LineOffset**: the offset in bytes from the beginning of one *scanline* of data and the next scanline of data. In the example it is set to the :class:`epr.Record` size in bytes using the :attr:`epr.Record.tot_size` attribute:: line_offset = record.tot_size **PixelOffset**: the offset in bytes from the beginning of one pixel and the next on the same line. Usually it corresponds to the size in bytes of the elementary data type. It is set using the :meth:`epr.Field.get_type` method and the :func:`epr.get_data_type_size` function:: pixel_offset = epr.get_data_type_size(field.get_type()) The band size in lines and columns of the GDAL_ bands is fixed at GDAL_ dataset level when it is created: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 52-54 .. index:: dataset, band Please note that in case of :class:`epr.Dataset`\ s storing complex values, like in `MDS1` :class:`epr.Dataset` of ASAR IMS :class:`epr.Product`\ s, pixels of real and imaginary parts are interleaved, so to represent :class:`epr.Band`\ s of the two components the pixel offset have to be doubled and an additional offset (one pixel) must be added to the *ImageOffset* of the :class:`epr.Band` representing the imaginary part: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 61-65 .. note:: the PyEPR_ API does not supports complex :class:`Band`\ s. :class:`epr.Dataset`\s containing complex data, like the `MDS1` :class:`epr.Dataset` of ASAR IMS :class:`epr.Product`\ s, are associated to two distinct :class:`epr.Band`\s containing the real (I) and the imaginary (Q) component respectively. GDAL_, instead, supports complex data types, so it is possible to map a complex ENVISAT_ :class:`epr.Dataset` onto a single GDAL_ bands with complex data type. This case is not handled in the example. .. index:: metadata Metadata ~~~~~~~~ The :func:`epr2gdal_band` function also stores a small set of metadata for each :class:`epr.Band`: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 82-96 Metadata are also stored at GDAL_ dataset level by the :func:`epr2gdal` function: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 120-127 .. index:: MPH, SPH The :func:`epr2gdal` function also stores the contents of the *MPH* and the *SPH* records as GDAL_ dataset metadata in custom domains: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python :lines: 129-135 Complete listing ~~~~~~~~~~~~~~~~ .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/export_gdalvrt.py :language: python .. _GDAL: https://gdal.org .. _PyEPR: https://github.com/avalentino/pyepr .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. raw:: latex \clearpage pyepr-1.3.1/docs/images/000077500000000000000000000000001525260221700150525ustar00rootroot00000000000000pyepr-1.3.1/docs/images/ASA_IMP_crop.png000066400000000000000000010574361525260221700177340ustar00rootroot00000000000000PNG  IHDR L1sBIT|d pHYsaa?i IDATxydU}Uݳ130"3E "E;ᫀ[0 DM4č$bD&TDDP "twuwuU{~5l0[6ٳ*,d޿)pBJ%=C[* 4[ id왂r}k'?isS\VzpٲeZl$ixxXwt饗k_nV-\pOYcccOna#f٢C [3K6!!aȈկN 7ܠ?~ laٲe u~ӊ+|`KWO.h~)+!!!!+T*i{t'kSVӲetmI~ oxΝjC=T9GyD^h֬YT*iWZ/!s}s\j5z[ߪիW?n#ԬYT>Wl6;80/| qSX5sL~+6x%\}ݷUV=n=7fcJ%qϏ#vmd[6X/\t~{uC={q s^{w](rIHHHTH)X [w^C[=+tQGnЉ' 3ЪU/Y{nv-^8@gl2qӯk}Է-|: ~[ߪ~i7Yַ'T__ߴvi˴^{ oxu- .}]wu*ӣSO=UЇ_R}s%Iv[_җ@K,zoK_RG?Ҿ:K+WJ~>yަO}Sq7YrYW_}~o6wC`ʕzы^^oxl6`IEq9sN8㎺te~h]v e=9CtgR讻?ys9u]qһn}{7M9sVX[oUW_}^W:%Io?_}s7Y+WWp iHիW;Nʕ+u׍7ި>[fS{4>>|+:Stu騣 ԇ?aqZ|z!}5\o}[:c ۿ[=ќ9stꩧj̙tR͚5k_/X;^Wjӝwީ5\ǚ1c,M{,,O}S>Y僃yWʳ,<+V'&&=c9~<˲|ɒ%Pl/~,w߽pϗ<˲ oxCjHc=Y_?/JGVK.-~0ϲ,?v>ye~7ߜgY/^8_fM|||<_tfk_\j/{,O?=|~_Ŵ~_罽\ݏ㼯/? vaye>i #8bΞ=;_pal6r/X w}k7pCeY~GFݕW^gYoi$$$$l9$$!a3 EMw]eY>s){ߘgY_qӮOڼlٲ}{_/?%KYxp}eyV׭[7ye 7YrJ~<˲E/zѓk7?c=1 O޻3k|޼yO9N2@64jZ^*GydZy-zJ?,~8|ye?i?cyOOϴ~8R]???WBBBFJJH8}6|IҾ;-%T*iܹZfʹ?CgLVR eY+Wj$~ʲѶ{Hh4\;찃>яvmKT=-7z_o~zы^),0<<_-N;4%ַvmʲLGqĴ9iTm馛tM7I*vuW-o?-쳏~믿>xGttO~I<]5>9:Sta̙3ާ_CZ >Fl7vH{sl}~7듟nXb>;,iyhѢiu-O<-eOZ+VК5k4{'hyBBBG2@09`iD.|O~Rs̙>Z,UW]皘׳Qu֬Y]ˏI%ϣ>l=OԜ9s^{n>s=ǻ'˲iTm袋t>k7D4mτkddDvZIܹsJU K^{K_Zc?x}{{N RNڰ!<36'˲iϿꪫt'^裏֞{~J%x㍺馛8ՀXj. OHBB3IHxj颋..;c;T׮]y\CCC!t~m65y.RВ%KGG^|!<ڵkCɯTmC0sLeY! <ܕ+W>ge;N\R?կ~UW^yn67 :5 .PisYvhn92C2!!!aK"Û,c=!-]tl6u7OtA\?wkttw_u]]ӿ67G駟j=нޫ=/;蠃g|wai<^;!!!ᙎd$$< 0gU*z뭅Wys=W+Vv_zI>[.|l6ws=\5M~]ߒh4tw>v~ktUWN{O?tu:mo+¬\R\p,+sꩧJZf7(uyu}ƦnYg^s9zᇧ}tt뭷: /7߬O|Ӯ*i{1jmX`icNƎW*? y;k9#Izӛ5499%$$$8R VB³jUgq.=y_reY~zGuO~:3w}WBA-X` Ж/_֧?i:`W~>O?s1Owko|Cp=X5 ]yZrw/|a/|>l}SҒ%KtI'WW_}n;-X`ڦ槃E_N;4-^Xk/m=~9s_l2{W?\믿^w}w= .FKjkwؘzu]z_^x/M7//{e/{vm7MLL{M7ݤ;L\sFmkBBBF9{+!aû| sGvn…ӎ8mZ_/\0,XSOzh>_xqחN[|y:=^ϟ??/̙3>8;ޑWzR2袋R}|YgCCC])dCx</SO=5mJj|믿~Vw-Z;;%-[Vpҗ4ar rH< 6$˧_O4F:>.\cxX{_r%ŋJϛ7/+^~oi˿K~j5?~׽.C=43gNG?_W;cۛ_~gz#!!!a!JHHCi…zի^/|KW'!aDutMKHHHZ$$l7drrR{$餓NUJHzijy?_F#ÄgR$!a{ۿ^kZzZ=z_zKW1!Y~>>Z;FFF_w}>`|ͪT*[  izB6%uWkժUVZh:,moKH&?_|z{{ .лd|$$$<" iHBBBBBBBBSȈw/}͛R/뵷v^hppPgI'x뵟ԧxbUpLu՚vc=SO=US^&< ###z߮vIZMx-]g1V\}sԉ'(I^)Is-[V+R_FK.ʕ+ ~v|ɺtgCַQGoQo}[~u1L{U3)k+K_Rg?h_WjKW/!!!!!!YUVi޼y袋t{+_nIw$?9y9}# e:S|&XWK쳏$ӟ:,r-z/Ij:400' Rd+5\}{g>7M:#:wSNgKW1!!!!!!Y []'tR0>$i]wՑG*||GZ|y˗+s} ]uUZxq0>$G}kӟT6V6㪫#[oB5KHHHHHHq}i||\o?ͦ$鮻 ;va͝;Ww}w쮻` &<3݊A8T*ڑ>;w+Ww]-\PZm5!!!!!ي1=?͝;w?{&+ppPys}V$͙3gwsQZf~{ZJ}}}]ٳCYwnLn3يj*^>~W}k7y5|_k^{W{&o~e$$tC2@1jyP^9eyjfʳPr+)k{zzez{{=f_VeYx.rV+(WZ B֭V+u#{trпs'LNN1:>>,TTB9- mxdxQoPoooX^=2q]\pk5ȁ;u={t1t499>5Mv ?6d@ȴ^ZjՅy̏ Ef|Fٮ Q tY6 e.9 ϧl3 2]N^g?7XC.ȚqM9={vm'i}"իefϞ(~Z(wCesHVۮk zvFFF"ק͚5@gΜ RuiΜ9ZrjZX,Jf̘AibbBJEVKccc**˪T* CR),~R)@HR699H D rb1p-?nt![rnSZo`Ť EnJI eMLLbE0# /9 GȓS*TB1Jhrli4E ?ȃz@\ cbbBRIj5 񞜜,f Gڄ2@S򄸣̃YqRW7TC91ͼw8+N`nZjrh7cbŊͦ5>>y̙%###aF7'gtA[ݰ{V;/~ =9 {:NQGժUdɒ~2%Mxщe IDATf"mBߊWմӮ,J5kzXXƤl`Z-MLLhxxXf*,a9HĄͦ,@Iƈ 'P!6Nc(gp/{Y i 2!νN] BCJ[IY0GGG, 7șhN5F SHB'7dhˀƻ4n@b܃J$I#_9d B O{<*s#ף NZ }>1){= wC##<9n6An@8+ e<^&''Gq|)#^g N'Gv2ne/TJ 8}}}ύa|{t I^WDFcAθn48]}W kG3ͦh4HrcuK?^FFF=nFs1V e\veʲL'pBO=ܣV/z ^vw¦Gl8}N_W2|~eiv*OT* '6 ph4GV GMR $BY :`58#%7 DDQȅ4E܀ 9AȽ,x"Wv@~cIGt-n@}ywp{Luw.8:x2[>w. ,4>>"#Mn`y$6xɍJ򘘘z ag|1\/=͟utXGj7 anpc#/y> GdnÛWXSn荏ydو3BZ[_%Ij.bzz^=Ӆ^ e͞=[W .@sG_7MZxqNӥ^??G>͛7Ou{&DD2@bs1:E֭Ӟ{u]/q=2FCJEN'I=A̙3>,(Ҕ7Љ6Rxtt4۔ezţ xzYĻ@<$qbdѣC1ys//x`I*ِT ș6C{ {rMXk57'#8/rH$B τ=ݼ1kyzԂn Q_tDDg8a:"X ƕ?6B]ܘ O'aӼ)(u Xmw:C; \nX0'w6sQɝ@}y|)I=pܖpg귿rW+Tez뮻jѢEO'r:JǦԥ^}cZ`/R}{ U*}׻.}j4:ujҥ Oo|C}{ujg}կ~F&|Bx|C1Ld<[B###a!# Y0M|R!M B7<>{d{|CqB~B6I#u!>!b9' 2v{EhKAAP>rsp/=3bqGۘscȍ@sȝݨu#.+ҮN Ɓ{||lXL@1̳p2~8 ejZp"vli:1=: ]Oڳ>[g}^7iZ [_'O|)\ccc{0.f;&zB{bi=,N'읠 :u5Z*OwwFOWqR bᆑ oDYrR勺/,hIll c{x FyuYrG(69~'x-ĽIbrH1 'jfhO?q2Q8^'݌7은{ʌ #lq{d5SH{d/J{xqR*Hp i,5dG20@H_Ӗ>WS}} 2<=66/̃^G A!zQ=pĺJoBB“G2@Qp@^ 3&R#CkFFF"Q266^5jvfX v"GWN8aR6D(w2^NI>NxbqkcBsæZԡգ}چw{`L_oOO7dSa(qӢo -d,I Ř:3dljN%hQ1zdˢ~[ ͸Tx@NET\q2ڐb/2HSZF'ԛv8 ^0Y*‘~sއvg Q?YA<81!WxWW dG) ʣ^8hGPCS>E)c7tG:߱\֮ͦ][XcvmٳgO[W8GKHHxHmz=O^J7@5kք(I;L$h4BTsY8C!ip) {K 21'NL{n1mҔqy*JNT*HO$=ӽ=ZfvS}2'Li*M&^`C$] 8ģӍ 'Ryɫ0}{nOE }L|C{f|8C3?8y>.Ƶ73G̜938Jp4lIhEւdlXn]xqTeaE֬YSxv~FFF`{4+X,H[u,F 4ػS,X}}}~8u{([ƽ9  "jaϢ?)נɘh{:7ybRu/芧yǕFҍÄ>b`L{ 7;OU(eV efys2t׍78ƝnvҟDDΝzR=2-Н3VK-߯-Iؚ m֗/МRĄz``fN= OoNuBŽq Őzc ;xX|o BSӣFQw}Z 7)EnXQ7C~dk'+ ON8{VGH:Bexj.wjBt^zўV<NMz㊾s #<nƕ׏~Ep»zOz {*֭[W s s#m'&|F[5BqTCD0 KD]1J=0`h#cGE GI=82 P__)FCg;/IZ d|?EH9YFyWXo,[?H*"J/o;d䗗@4N B*=C$y.Jz@R N>'}ƣ 1d1i.OsﰧOuTl4g>}w/GhKT A_,ߞrGٴapp@$/wNPKR!%7<0\G@<qTT*>Id/~#e^4i菏[Goa7EEc3GzܻGsh'eCDƈ&{$W:FCÍF`ɀ>og !"Q̙MG \Cu0}^1ID܏q* /˚1cFpD6T*ψ(HBւdl[l65cƌDΦsI={v 2!$XȈ$M;s z7?׉cZ $Ņk(`qu'l7\w6llʑz'r)8ɧ~,r>ς <DJC^g7S A$5::ZHqy`BI冞=zჃ +VI.H{=jG}z^Ðu'|0:"!I6qBGe'<,/|URDkE IDAT.#-Ϥo|w @)`R_D!'U ?[zc#k=6<F!X{SW:܃<}zc@Rxc҉>z։UʧQW^7 +O_z)~zG }"{9=Dѱ8/fx7xDŽ3Ut܅!c]󵁾xG F{!.<jH~>|0T1$36ȑ; 7Kc:} O8 @.~BNRkQߌ`OYĐ?=Jcĝ/z$xC>#j'à}HVK'эjZurϖϛ'!aS `mJ i}ࠆAӣ3f4.'þP2j3/"!%tZ\NJ|?s$ m^6׶Z"y|v) S ͱ2 s C>z';N`1}lsyyzs9HG$: \T3֩QNUI?9$P??OjʲpjϓnL!DTO;\###4׳,[v|}SHu}㙐 d$l 6 .IhX֭ͦ[ԭ]6DQ 'wB7}Qd;';уx cLh:?^>]0ƀ4Ex2TIS)tￓ'bnl:1qc2uM8r#@:ݰC_mrNf1\8"$$#}_$wA7XAv !OW藓?qˍ#rw܋GɾGE.a{g)w9:6|Έ @f<7>PWOsA{\?=86zW=wi{[MQ774}nhՉ>3pg1߯Z\_" (Hm Yi```w =1]",\xF*zynE8N{s}o|7xĂP3{eAĢ)',nXF ȷ[82{ǝP/Ӎ%dQ,'.{'%">=NS]q/`ynBGkiC7]Fv[t̠+ >fYq_p F{ۜ8.z?7N=*}nzŘvr|6螧^|C3637~3wNliHքdl{ xl@x9Iq'vll,g11fd8ŇŖ4$7D# /n"HLXTi)l`iQN^L{س^ys ?'xY3ø1<яo| Q 4'7b96Xrƈg,KL]Ia>e0oq.wx$0Q OFy/_5|mjON'UxiM"JSy"$н!DZ<,i`AGz0t:=7y62|O|NtG_~tEO?d.q?C<~Xwz{{cwG\YȸP>@;!edYn9ieiO ȡZ<ˣbdž;+#)q7## 9Ӎq^[V~CH;<2QK_s1mm>|^RMH#&aj!H,Nvx9ZOV^#'~:U g<xArb),N@7jń vďMe'7:a?éC/rD7|Nn>'ޯD|^ʣAr&%Fo}Tdo]&:RT[!{KSot: {!Ґ ʂ2ѻ'bGDX`}/LNvqEEw\raauRĞ<*wZHG ߻hq~a___0 !$r~-}A]$y?I{rݐ% !T=ِR넘7u E&A=hX,'W7>TI7]眘_^6q$`4G3ߏ~ucs!Ys˹Vixxpr$1hL臧DQAhv2u2}nɲI#A###g*8 +7 FFcd|ѣW蘿H>i]qϡ13NFt jittp.FJ^WRȈJVX3f%g?>>{zUuOM= d!ẞ < gD!(݋ !x!NzcR7RxT|gm$]Z DSw$ 9q>('W8zBqDÍ(9rc :Kߛ>K7=799ZC?i ‰d>0c+/&L,zĂzo@7q{,SV+u F; ⨛? :+ឞ`aŇk $9_L<A/|7NI>u&ϳ,+3fݧ>nt0&H-sCz3%a~CBj>t9҇"&W$dsllLN"^x 6{KN |OQ`HсQ3dPC}[SctxZ=BJV+8G1XbAw+J!/)]hy^@L{|z7==/9\K ,fTb̸8[XK`K=F1>awV++qg,Cu_2lijm [F1>>@(UT¦r3/"u D:4xJMZbR-  0K񄸳q|0cLb*Jx*9ِl6Po6:iCfXc1Xܸ XHS"}$M#Z(a35qr"'ԙwr?N eRR6G[z{{Ñ5Ӟ<). 3uy͏7}O#t>e{~=Vj H3dHS%FQJ'͞s{om~+i Dv'&&400 V܃зȟgC7J\'\Nccc0Cw/Gb(đ8tZh g9GCwg``Q[ϔz$$<$dE o2oRV`aޭfQU*CBwYnW8@U@\kc cdd$/+s?҅q4izC[ӟtzB*J*J?#$dʽxZB}yy)ȸT*ill?2J B)1X~OIrO=<{hh s Gi'=.Ƽztb;H+QWt!q⑍~:N#GFFBʬh_?s # _1^oB"s7#n1cDcp3< ?Vk갎Q-\PV ijyԼyczK#E@&$d ,|x ]8a 9 Zثy߳B³Fu=Mɉ9D,HRMbODe֬Y!ꂗf Z$ɪ{ᖦ՟{ݘ熖G /7SOrqȏvݤ wZx_b8A]Ѕ :몧rlʼxcŊkʕ(ؐ,/|M8Q|,p6{ǓϽ1F pF>KTiWnY:t0oI$C(akA2@Q0Q=Ix,hdYm@<1BqA #YdYM"OAT0 X< / N9.O'N&ftSgxHUHe|f pϻ/Ki<'Nx4N Frw̉@/tHdC{J{oAew>uw=nDo73.L{}OƩuww>oO^o 7V} ^ {/rn0ohr.D]N->&hB=r@nĹ T£DnXG#\ƣ́||Gn{D O'~|7nbV+:[)5!p{V<f/MyN^8i1& IDATpYbj4dXy߉x;)RNrCuNbb21<"v9Soȉ?Ï)_ F∀P's./O@Fn ?'O\q=IvrCѳ8OT͐8d@E(KҴh2ob]IU9ʈufAivrmo<:⮓n{\&f=>{gcU5g@ XS*PT_H˃m"јBL KM&@L/$hb(0>BmJDK{{gu{ov2s~{Zk͘iC>ӀJ{Τ' q)vuBn:t`sTcPIۜ^kcþ;_m߲2:]˘(##vHdkDv@pc1kvԡ#ڕm'Ԥ.OE1u%G \%?z>?1 O ў"*&Y (ړX$mqw:j`=rԋLLcqG%;+8] y3d{2lv^=$z;;Yw~7Ä.u˓/u9&)cvDt2 +}\f '9D-K^꓏ {a3q$=&K{7x;D /0@%yΑ1(]]]_5Z[[.~4فH<mBf iOS lxXTOb׽u//kz衸0>O'?ַ~\}(nx[_[nw㢵.O}hQT#2Hވ@vLZbQ(</43* 𺭬,29*½Du|AgN/LD&x[ۭm~eKi t.FnUOۦ;z!l?i&rXT0ԗrqxMIٳg+eC@O-˩H`v6J']ꎌ#3el@_بd@ 4<9]ޝ]&c\э I_ٌJ*.&es/) &K_,YƕL09ȍz[ޱgxŵQOñ3}f ˓gL!?Sn:gc⾏`xi1isZ^ހ.s+9yNm!a_}E/wOOo=v{""╯|e\s5q]wG>򑈈8sLy=Έxk^qmŭ/yK.xrK9Ɏ7/u^|/&XzF8]N<.t:%BB6ZNN`OYт|g{%i{󳧒9^{uM4E50jpa9g8*S $ y$nw سJ3<#wc"sǭFų2 gEFȏzak& \|;]]{c4y'gД9WDgX3&.irᅶORSy1:3`}rd=nlle]%ҕQDE|(#[ˏrMf';\i" vN`yw6eZUGK?D$hٹc"e.@]1Lb<W3ջQY)Iׅ9?sD:N\|%~8{7nB>""ꪸⳟl|ӧ+:}t,{.r K902V&𕕕zOn9`nx]__̙3ei9#i )zEf9:侅̐Is}}aXD׫80 ,,zGmsT=RIx їrZ%G]ӀO)v:dZG &wQrҊwx ƷNWk_r

    wys~| ZRKQjrBW&{npYDDߏ|ɤxϹL̐* Rx# il)>߂k?2t:#*nk3}#xȅsA,3C^D{YDxEz2ij10N{ptaYH !3|cM U??bE>)&mV+&Iٜe۬ `VT=:M.{DًjCLL!Dyq@u7$Ξ=?#TRco1FL8ޅ0S8{bX38r99o':26x42gnx.㍝EѨ-p&R`.QKagrz!b/}y y|_t*>۱X,<9|ﲵUUg~ -z&䃉@b` h۱*&VN'yT搁t:1N 4ۋdRZQ"#Ѩlk/O%Eo&ag.*Sɳݩ\9j s%|E0nä|쩶>Gk &? uuu9>z@1b9I|N.b4=I.h4ۖ蔼y6c3i]VUdg5V@FNK3=P"s!{&D4as^`C]8۠k4Uc}8kتӋpI aSDu~_(sӳh}si}޸c>դƳ_A\r!1o~o~s?n=}t'E/F4^~flooW0h~qԩ1 g}4`0_"2zqI^#&X@4p9Zr &dy DgN{K>Nc89XX2=`ckrJ2A@*!Zv4$ .!@iXw/ E~lhN"ƻ3jAU׫,v*jww7vV<\7LJJ 􍍍vnz:VRh;$ =B uxaik!@DWAȓwiB'H bsdvtyiٌpX+d2)Qkdh‹U ޑ ףG#dQA_=̘3N+QAt[t:NSld/k"[nꩳShW,iq;;;c\Α8S< [2Bq!`PHx<.r:=yO9s&xwgϞ^|+#"/|a7y\s5e`H3g^EuXвedh6#8# bjtK:ц`G'1h۱S@s%:{l 9&"Jf0T FTwqڊv9`LѨi3 @B]J|%Z, ԓ|fלqQ dЏSER& NU'e`:XzPCi#.6X^lvXjZ~xˑJ"ka w<9#dtL02B~@66 L&9nm~_ >x2].8i ؑɅ9QN7؈x\ z]6G,xvEjU@bCȅg1Sg r͜ȡ=߳Ip8,dqϡq:VR<><.XOsTY__?>Olmm-7g>?}//ǻn)ZV} ;VVV-oy˅n^].Q -F#cPtʄY~:u+vP6b6E)cXDžH!N1+핌 B!%I*qB7Llk Y $>,dxabKz0:88(t>{Y ڞza"u9LN)snlyWIa]wcLx>uu=ܠGd5w)@#mt:ް)G< 2 d2\ <EoN"v+R@fЅL\j\{uԅ4 ~F - O5`AEBF^YW^',U*C6 &o9gN+b. j)K<؁;w[ i2d2DvxDdb(4blc8<^=]w]#H/??\{wu]o|}{_L&+@loo׿wqGmokb7.OQ -4Ξ=[&ONe(ԩScUSQ7&] /%9l64ղ6L@tbDxdg#{ 0 DD1Ia4iX0{^#v@S-@~{/~q}{⮻*xu]=/~?.䄖@Mӊ4bgx<܌gϖt29OK/'xv(}ڊv?x%y|fC=pS/gPO{w=@)L;N˂P*@33˄8 G> ؋kpPuAw8A&Q{$EDF{;r6Aި = }yFo5%e8eU&ګ )QI1@ЏQ1ipD҄ΑA+@SW1!bY }WzDZ<Ŏz$śO?sZu\bk5!XGݩ+}T8e 4`ǖ !Լ)Nц%sRFQ=69H}ԩSe= nL4nN'a;w.NRk??_Ե|;|k ("\""677ckkL3(;Aa" ޳,a֏ɜgp2 21Qgmu-" axWDTA2sN8vy|&l7G4H3n"N)UL<#5dgu}>.R,Bu[ N^elFhpm]8Jb|9m2;N% D;mX\ȀvƩ*b{Mo@AwPVl[7wɧp:=G\ol8mƩqgn&; yqa`暵JuB'xAdζ{t%Ɂoێ N*g}JDtRRZ񵵵<[FFӉGy.39 h:![xi^Ggy]6pŽY(G412#b"7Y^@=|8#C#ly6sJN9y><<,[b [fMlMN2&mgvHc{9ζfB"Oy.2tti|<ooQ58x?u˅.59;]q70Gx\L&ǢuqdD,s;N%t^2<^KOyWƠ|-arsA^vD3E?lBf2LJM~t ڏ| e* r.ltb0j0u{c A\kl}:1Gq2P4\/n:A ,۫ewn?mÀ_m8 M70w bd"u{3,:mC^Yav| GW;-;\rv>}}NW^yer 'sN4iKuՊ2I{iUǗz -_ 3F gq8Z7DP)Lر@-_!CaLLCx&g^s;';Ј%A^bо$S ()S py/y&BS +Gd L Л {<{^ˊZ^^<Hn]> {R7l@ D2Q cF[S } Y~Ӹ9&BrC/&~:Ng[6N8L IߝS{-75ʞc.&؊u PWG ),>ׁ1d=!lyz8:$ c:ý8pCΎ@G[93Yyt:v+7G"l1t (=Y2ca ّlVR ԝMϩeJvPE=Nږ#-chmgy<$#*װ: fdžSvʻŘdXzG.#)ؘihۥ8G}n :x{4p8,{Okkknb!QT-겱Q1fߎa L"`\iĪl萁R {]4XW6\`5JɓA4UMZ˹VUD|ik)ؓG})뎴4l^oDx}'`dĞWG&<ОjXI>l۞w1qӇxm~~xxɤbEèӌ);89,O4TdЁsm~G$}Y1=`=>L"~%[&OD{Fo ^SNSt(Μv㡇2r s<& c҇F|G?h;mD'd"G r h5\)!gtAh=Wd1rtvEz/-@/)k6N]11wK"go)Kޤdʘ9%t:-kUx3h8V" ځ.gpVF,eNelHFJ {wbDkp$l:mdny{!Jc}36ե.uy& 'Ҝ[[dn4&,vU4N^7 7+++1 $h4b{{;.I^h`/b  .iT|@",ZyA8 0@OȮ? )E B,1byX`h4t:M&e5x b4L ~ӑ#3VGMO1i); )Nt54ٲtK;B~h7(n]g^Ol2}p;%BnL &/_ 5c2@r ; g+dhҘ*꾞ISSb{\[[+ ЎX=zccqAȍ*)u8lYGfP0c.o Ҏx\dh lq[%eNϩ8fn†nlv^ty N777+ЌفNi'<&]&rȋ(r$) ^MHb\DzGxGkkk% *cGDTtbQ!'ZR;UR{ -t$b h@=3q1!zcN$ =D.MooO5v M~ MxXS{}]O띮+04=>"r ="]c6h~T$6{o.Q1{q6#?8ۋ6 %BA#-m>Lh3PvPڻo>5G&r?){/IS\uq_LollIuO۬>c#RpN8A ze-V<c6J.| șh8}yv0ե.uyr& 'P"Ο4#SٌsΕ -#&C҈ -x '"{@G{>ylGyqqApn;:7.{Ge{+rdhA ёoѶ(irN (g#E;ڋ ӍɋS" ]ړ 2BTK6~4SLp`չ|=СF;;;?$afykCNqT5e]m`뤙![;# 1EӟL IH\rE!(.Hǀq:QV &N3K0ϵ^Sf&F!NMcI" H8Fļvxx1ls'D'M{ Ȅ405S-着U#L>)>Gh HJ;=L@ymBGA{}#bArtg0zl`W ]vLN3BG֟sBrd*Souc"K] FO3Gxσ#g@ !o^gYs>m2/!7;N&:]1(Bfn!1N Cڏ#ez#*Bs$ݰ;㷣ȏ:aO^\[VO&r#v'ԥ.O0 YhSO {c t v k;T!AL<\?HA'yp[y*G^xL؜fm2Gh`6/> ۲t eLm?X-75u]<Jg;pJK~6v~=0t#,^kXb &.ƜBc/X_ޝ:XD;S]7G)~vf#Skw45g EFF,I]ۅfbE8%"*/k[s[zLsʎ-:3^xl6n+yt)u.Ϥrcu$`jOC~/'=E)fr&0-pG;@1v]@c*&2|do;rr  mh'^wEb2{ ( }5džM˂:R7uɜa_8 .T{-7g&d tӓ Nљ!~em2J 7#~ l)y{VmkO FY+c7u_ݬ,O]Nˢn^ BS vS[n;͋]7 B<cH'4ix{НeLiR\Ȏރ~ݟ(NSϵul8 L/MX<핈!?,?n|`ɤ8(&LvPC\u~RXz'#c‰Xrg syV׫Y\rx 'LV<+{r#" ȋ4y̹Y4A0^F_s6@e IDATIY&=e2\CN$`&Gy 6k@؞畃ۨi"L:bbi3-o=$:GM,CMxy{NDE,2)EGʶ%dO}28sZYNclC93"^oշ l׹"'s%"d<77Oֻ d9[9C[h)@?xm鸈#XtcmPfs-6O-'~/3@^h#f9 ǎ:GLlg \/1Xd.؞uۥIm^>s>_qԏu ,cY۞x#8O~>Byȟ뜎uWf%A)$xЋ-gb;j8 EA3 ˀʑl{g[PkQ'dcay7yMd#:gYHl?G'Kls&&x{B}r$~bq M#G>=:h[D= W|Ghnt\Q܇k9DLI.X7 rQ!v)3@N]fYv:ַH\&?$.Zy%@cH=b2eG-`pX":qRĸV9a~/4!HY܇,X,)~q3y~Ʌa#FT70}yqIC' dƿg,mr4Yؖw$Q&\K4ĺvT 4I0i٫m6n;Ȁ,dл{&W<m}rsh #K . .bI 0c9bȟ& ׻&Q;x eN!2I38Wȋ=dBnD>쀅?X<qџ`te] sQ&QGX/U_/[gC  id1`BLϤlVRH0=t?_ubnA.^/-뉅}Pm>Qg@1{gg~}v0W-#7&995냰!3G&BfǬg7>˄l\T(u .^P7A!Ń GӔ Ep<G׫t{>##SO@=Τep u1)! ɳ/ɂ#$9-[SӇ=şV`=X&\m<(ˁgǥ8(r,+O1hm{7ʽ*A~7";2qmmɞyXڎqH@ /L\"/S9m[؋AI8cO*&gD5:b)Hř3gG5Y9*a\T ҶR2/O.xFzF;-'{!bLJ%p 3"^y"MHS@,u{9cPei"mRt <@"XQm4z<#V9uu:q/vEg5{ȱUmx&=ȖzWRЁ6 r|e766JMa04>ý26³xyVir:z3!M7u:Ne,"t2DDD/mv;ğ)K]7䎾vv Ʊ|g#2/GiWR3b@<^1ҧ7sL-ꪫG-uFv0a7Qj`: @&R1c_&(GOԩSv˵<}Ƥ0O?><c*P RRZ~N X"v=03IөX7h4b0`0D1A ÈXnJj SLLdL(? O 7uؘux~<⡋X$०>"`Pa gADrKth3fY # ᰤ0 :soR"vtg8vTDTӿr_Cw9{ϋwۍ%Cf&* C׀ڃN}càv#";mbMsJ 6 Y0Q#o=[eb"lۦ}*/:(uZ#N뼎 ˆSËq0`:"//G"i h4;M2'L&ꪫ+(B~b/N3sɹsN#v\RH( sS,rh;: (e d GOHy*ik6 4n{ )ˆ(g:}$n#3rgmy;dTP'G.Rz{-+tڂ# `np8pG6^{9r0eb{BHѳS(Mnj6%O qn#g_ilnnh4qpp;;;ǽ3NOl<1K]JM@Np$$h;6Ͳ7{6AdIXĩS*XQT v˻ie!x<.#a9S2g?b Yeo 0Hcmg6SG14er'b&|H13x7,Y&&tNɉ 8G~ee,Iq/o{q4 eh^ "u?͊0lg,DxSS#qc&%G;:bW9 p8u8sGgsٹv.DH4æЫUh~huc0vP@Н?d?1qcS5Npѧ WD=Df9˄۰t@f̼oӸzp}QB@ \:z ;M:n+UqcKgፍHk,EY~xmYGD9tN dYB +8 VD,=Ҏ0 4{|`ewR~" 1aBM[Lch2]Ȁ5G,ecRv9>r'Zb5Ndl:9ETRqw;#"5yMmzk%/y0;'uЏ ^=u>͞h#%c{'r8G} +`!=feszKGڠxeeB "B~ q{,[ԍzw {< ,_Ȇ#b($Ӳ>Ļ. m eݚ u }#/tb`Mz똝n 1ˤ{] {>d; vB@ݜɁ.|&ʈxի^?cXĩS.3KPțpxx{o|ͥFz 7g??ۋӧOWqX,q=z(u$G@ȠPSHKljYd|?=yس::=*m%9`&GC kQMa"6 0ȞqipͩOsku&682V<``vFf+248F6`])sG:"AۉL!Alj"+pG١@<4k6q3[g{LiuCqwrdekk+^UdBߥֈ>~Z& IDATؖljS\xŹY,ۖ %A{O_C2H3dH=, N9u;n؅&kFf!szH|CN1,cg/^׀ft ;Z(:΋IZ0^WM7Tn;1V "p}} vu#t,>bux#(:[7( $yE3Hdi6?Lr 1ջYy6;NJ[n1Lߍ~IpM]Nz}"xsgΜfYȀV%5 $ xA0 "gYycNlgL:N3piKLZxx ̖=AZh?42qgIN8irBY8AНۃ^ 4y ɜeA{M7H6Hd85S{ҭw/V&AN-ʠDv+xpv]RPظs&&NN=/}qш0!rި?ّsG&\o&Gǩ\c[྽<K](Zd}w_`pW_}u|K_7qUWo?.ϜRZi9̏޿$q٬N]tؙ0XI bQ@!" b؜AL&9:;=2 ߀ПE7Gn yr:u(j:^i ̓mτ,f;$jUR# T !N3ynzE>.sKװ5 Rto*{y.供x961N!xԁ/|!^ H 8:ggTTvG|gSw<X{WȾ,@(g:ATZ"?v۟ߵb Bowvi4I(7xcx㍕z}nWMހb @Bn&c g\b Cƀ`αKڋynqNw23AxcYo\ڊ~H$(a |,q2Ui!&N}0#[G/2җ+z$r==8;suk6G6H[S{;ur;PfY|J>~=NNvt`Bmn+ALЯAheBԍ~( ~9 i+)*.mXn(O#W/8lvsN$JK9hWwˑfRnz a^Vi+>KD}H)qʿ^G;\^k*5yxӛgb8Ͽŗ_M7V+3XYY-?]xxĜŘlI`aINL:ɤI0@I dn<&x$sN:ij9erc ň%bbMh {}}=677˄x.=&oHK@: V<tz0LNXy!+GZ 8Zm:B7x2 " Vq* -q M=vn~5AW>w{` jw5H-m `B}Nඛ :k' Od2)+o~s\yKiQSaӎ@V n}Y~FvvO3A؎!t]\AE=cN;v v땭ױOOUvBzro{^a]֖Px;;;1-t:-N>݅9\}o~4~??VWW/3)X|shTt=77˿n;뮻.7Do+]zWyVvm| oxC|_;#ŵ^#벷WR 'Kh|mm-&ID- QӉXYYNS챎Xx%de]9M`uu 8!k?:ND,#%aQ&d!o\k^#:s*`}<F(h`0a|xq9qX3QHi씌lV+z^p8`YLc&wf1~O>{3x`l `d6 + !JPE@IP f !.rADHD" (" a6={j8|pT*n _͛#";G{N]}{_o߈}sO|e[[?7\3)X4ڏ~T8~xD=R);b%>\.Ǜ뮻~}.|ɸ+]zW|$fr}ū_7L(I:/"| uotB[6&G9Ep<چ7w 677Sc o5dȓqr=EQwD8s!^&r)7৏!)qƔ5j4EIVp* 8&&pƱcR+tyo E_b;ް$,mOyVt èI68Ś<{X7qYٓib177< x{m\^/5`qq1+tߋ(d 5$+0:AhVĽv۞sUo9?p}׾g{~W^ye-oO|qB+\3)eB@YajZqСjƯ뱶~ fss2qJalR'cmM7-0DDCۺOm7(& =n5Q`6ĩX"{bsXݴ"d5[=ޮj~86Y$z 5݄Dk$z=33N'=?7׃,:I^ < 9e&ϴt!]/'`Bt#9JAn0,~FWNkz#g$>C+#R>tsr=M;v>96ʍ7^o}0ُ~By#m(JtRs)k!q+78$m'eRʄF`0eLb3`M !,,~9V4|HڃhEM7l9"4նGD:%{h lx9-9`?lyA-C"X ih4> p#Ơ'"#fk%ur9z^j 6M|@΀\,b [mE Au92{t|j XW#_sL~ NxϽf&ۂFz6'z5Ogy@Fx |3>D?^"ECƈa/mmTcmN LRd~^_r."4)(7)_&+^ $Mƞ b eSbspց7vEcy.Gg7 cCś2޼{Szr97# SlDf&bÖ &.<#OZf,wboԟCò @ ,L:,K{ #ch/Ǒa]l& m3s 0̤r-5G068 !뽟nic>HƍuӳxQZM28lmmHrͭ+B(&)~ +/y 3vNw0zF{ A:or^) =sg yn]tT cz7[/WIӳ3)l ٧`+߂ldlٻ`!Vwrcp盛 L.6ut0M`р( '䑓{z܃@ۜO0!Bۀ`屩3;m-Nt5!msH,ܲ'@ržqrǜ }p r۟՞<)$k#Cc6n7{ jwLcsnck=25" /4I䚸2's$mc)@9`$pʡ x~~&x:!b6hYnϫjD>AO* ?.!'~s]8/_fGq(`FlέG!֡bRu!!e@r+8hjNbg"oG2B~^N`M -(f_{] s93X>ỎA7:`BqO99)2)?[`BM ̖]^d21N>Z#!H6 w}(ol0L6P6x6i-{qŀ2|r\LڜCB)aE=9j0w&mP1~qX&y[soc0*N&Gኜg&>C۞^0Zr3)ldDOUr8,l޶rq@enρAs9lM39cevGCR( $,}r`)?‘k9`ֺq"D Ky(-Ͷ8oqBL D7s?pȊ)=k)%b|*s 4at¬J}LG'a36AzwX3a @[w{L"20@~6Iά)g6#hKO2dȝb/^ zK1c] O ^X^20Iw$}+u̺/Gg2m>=kAq|a rLʤleŋv-miKoe@ͅz[F1g;K|N,_<e~ٰGD:+L[vZoi%g RjgiҔ$#DJm@p8LVN.9YcQ`!wXV=^[}1 z))H@m6e1X.?bxLa'v.v7srATxZ|06 $MYMϜxJ_x;F#Ć~8o/@NOw$c5'q P>]1븽A<)$JctHN:D=<;c݇S\Iy˄ӂ8b:.x) VѦl-c/ ـ=a%r؛#K=;}@ n}'²j^4^>4rIu̞pX蟭\kKt!TXIBq1sgn+{{oor0>C'L{*k~:y`Ҕe|}X=1 ;;;Nsg8|&d zf3UzUUz^x$y Sῑ k{ /Ēq({2&x苽1Ax+Jk3Mnxbn0n<{<'eR&g/}Zc0Ƃ-6#B!)+C75ۊFeK ^185ᾜDm%,{78ڞprQckk+j{Y/[!5x69s²-&gSx B>.4?qᴁ#NKT*&É&}| ?ZV azw>cD8/w>-|LrqȮ5d Ƣmfnzz|Jv4K/Ƅzx`v0&&~8;;~[#ƞr\uU79ZV|_/{~ u]7Ib?X[وB푮j) \[TkjZcSTQ1Tn`0HdFpgg'LR&}\p'YlvT,0Q1Ga`AV3o+: ^ ! M^߀dzf˞}W8ɷns9)`,@ 2i?4AƱ6a4p͓TmP۫aJ/lƴk ? IH q8A4aT :Siρ7o7&Cy(^O^6/1?̹3SGQGcoBSIT$沽B-/M+>-Sвa:,ޏh6nS},,Ď`a򉇄 ݛ!1x.bzz:A+о~W |V yW *mIv(b{]B8 XNeSv?!W.8l茽ɽCd5<@dRnbaE}az^haYDD4܌;wh+j܈\#^*yuR;z xz'j1>3 @xz^w0yj>1ND2r '&{=8q"zt G3n^/יH'ED);B8^䘇"WKz~~Ndt8wMr4xꩧ #{vvvq̙t:* >OM] azF*y{.grR&^&d⓽A p5g=M{ X#/фp[e I($ < lXOm4 Ҡ2nnnt4|zd'&B RXb[6& Y 5z >-mO0.7lyhCZ 7ns(.cA8  e1G!<`#W{|36t]FvN5ͭ@v:Fɽs*!qqnZ-E/(D.\ړiA HS&,~#`n7?i-n[dy;`B&t!cVE߿ c\ 3 @e8'k@nĴArN4apNzha}}hО,=ȋyYVs8}e^Fh6i. [#;14vsaP 4/+aI|NJsJt:I~1 ѽnF#M 8Uo ?:ĺla=NN'mw`ii)n4ى[n%n8p@̤Zf3z^=Ęu 47sCx^jZ\b޲ 1`R&eR~2! 8q6[ɽ 9 ak= ;K4Y VZ Y?V,b:DZ6/P!_ 17sB|d*@sk6773 : W@3Tj 9\ˀd 4c:#'",Ĕ;tVhT.QDܸ8:5rC#:!A`ȃqM qI9ciNn9BLqؕs,/3,Ƙtnu^o:눋^h4J tRJDOЛX\\L991d~Að\E^%blpXĄ9h6I@gM#fcՊe177?Ӆ0r@h!@^ x '{8]{;Ngs2)HeB@iu`͚뜬kCU6[@|D7&'84 @ܗ/`zpذCa!6^ɛ<7)X+@$b>*oഅ$N|L؃A6{d&xJ }t?"!U<=0 !1Eqp.sɄk4mqq7W7Ź& a0F 'v ~WĞ{LZ * >G9\Ję1 |q61/fggBF>3ȁyX-Ws+79dq %ُ~ގwCC=o0}r2fSL}.zHHCl by9sE@&eR2! *Jn0` dXmMJ4݀1@1Cl>j4!@1:q @UՈa"l*c\Hz`k^ICk3,@0!B\ >@R i<À(Pfl G Y:7$IHgdݡ6" aYCr@HG賍 1&lgl{W|A,c3AYZZ4WGv SkHZ#a{LE677S ]AdžFd)C0/2?q0cm$k?17Nnqk=/2!5\ ٧%ـ(p.G٠3;آ[p+/V81;9ă~cp\Pm6lDL, ;b~2/Co) GFɠ k=*"ڑ԰CsRO! `$ Cpx<1851܁D9uW&NKs -㝑7},JqK 2<ϵ7OEeF#666 c,?iy9 :xX?dE(m #GЉ#}0OOF핱גz/b|D#^4 N^3zvss3N8ڌ˧DD>Va$6 qn Lʤ2! .c: 9@>pJ8[,c l,,l:l{̝+ak9#7)" 29d }?O@1!W`8 {=vvvaK:5ER16-q{/N䢟r urC66\r0rA*_a*ԛ[= t.h4Jm060s1)2:\1e(@7GBt[&zoH-A|nh:"= a_qoNX|p! |^/*Jɯsu>~a}IyBؗ4-Gt4?9 UwD>ól6 9Rx##"%#1휘񤭞K|A)/41>bR~Qʄb>!b|Ɔ 10s61NyX 1?Xr7mVh`p.6*8󙭨n \Y&8aVa@cJ~C-<:u@LC^~Q$8d6{w@ fG #P|*홚*uj nii)Ο?r9n_syأ6R[dcOγ9;&6<؊T0@9cEDa-3ץrU9e(vY|g}NZKˍ@&ncNH}*YnezL3<.g:J|r/_׼&&}&vB_%g1c@fs ' Qg̖htx`ŋbO F,܇.pLtv8ng;[m0A^7 qZˤ޺|nǕ^{I> ^RNH&}F nOu'NMMle+ף_(6}SƬOFt 355Is>?gz^uhR&^&A|SlAobrVB61a /*kK7Er5l˺e A]?|=l~56A ੩dQ$&-^ ˛!!C[}N>cBv<荭?@%:^cb[޴ V!|oAuw-ק9܈~KڒQ|!äomooj&?an+>u &s2˄պ˒{XX&.8|ުd^r RQtԐ@7 aϴ.si5DŽF( -{# GLR* D:?$$1c=YK|k 晍mV+5!7ʄLsU&}Z kD+Q7 eEO.lѿ&0lyh)oK'Y^9xn3m5x⚜ 9vXE Yp g`]%"RqX#,{ 'ncմ +cE}&_*Z֗,̈́H9À{BI\dr7 yS&@izeXs"@T0@b깒؆ ^H^ '{7cCl-ds[L~^uz^D>:n0b"w<&PAcr[y d~;ϭ 4cwwpF&ԍ~jb|L¤" ٧Pb 2b l5g-l*z΁|:VYh%bl @pPg/Slt8f[Q<Bv-6?9VEƋM|\'}ՠ9Ϻ۠zdlrw =ubRfbBXR/kiAd `}:nϥ]?a)q~I >+)Y9cP ,&n:lƉ'z8 KA _dc"bo㔇>D#\)/!K}M걡{Ǖukyｼd93.+}=9N;6yc& G>lf`b '} !^?9,lLʤo λ1)P-Big6`Nn7k,m5X677 An^{Bvd:WʡaBhf4jOy@X_*wn> `z.hI^˂yh}anx2q1Hwn_Ċ,.X_07^hjls}-Jh4bx=|BsbB% "2)U`m,(l, 7#;#Ƥ%Rf뷷{#Ynm56̘x&R{S$ƚӚ|/}1Nt.An r}<>a\mi,GxcMD[IA$}2hvQ#ۡS ڐ%Eu42f͘YOV蔽CDlȏ5r81ϋ'1VHX爭j5%9MqAo9y.PQmeoJ9}>" @{/#Ù[uboG*'u% k/{U\r92{^*V5 1j9; j=2{I_2! x!,EDa 扉:F7b| M^=; `!\@Ŋ2qrrDb62(n{I32whNGQa4P4a=wgn/`o0ElEkNdlWDӈ ;<30G m1)vj%A?:Gyli %tp>fh$ݦruzss3jZg#"M=^+J{ȆI?!&Nh4{l6Ӿ.`zV4 }ɍ[(7ƩSL5뇍/h4#}zLR&doXK@87ۉycQt×QEct͑[O 8m(5f$v{ rˡ7B[b TZ˥1\} a &>}1F?tt,;Hz?o!v/$,;<k4A 333)(π8dEZMzEJmC6ɫjI={~rR ˯AjeyaeD۶t=%\ΦuXAhdPLȢn/ܠܱgoG<ȐGG%? {W3%HB _e%/ozIG\Ov dɞNH>ĉ밡cBN4Bc'|vi kUۍVwqGkn0$dαVB;zOiI+OVZD/f1MjE7JDr$"rCxΡ X#3Tbuvmll6~~`K:mA΀!m1~$2f vBF@럁=LZ- NGc:D~m2 #@8fA._VK=E큂LS'Da7xŽZ2w(5!_=DSDg e0{s!3-ll~,,,r9KR,..zT*`0(_p,^~ ۖSo"F91uC"ɝlj5YWx ؘ YoMH1z=C#ofXCp8 ء/R@'-HC$|My@T!ql PtT*ƚvڢ pAGcrJx%wڊnlnn&=ͽv2jmIG$0\/k>cN-@_1{Q!36!KƗyAXn mq8Hd-'{峇k2?2[&P d4=~_Hk?k1C?1 G7Y&~/yqO{H2|㩙گqر^WT.wx@&\3)Bٔ< bٲX-R{zo X VPÁ^ MrhK/ Iޜ`qO".`2 P`0NY"Vq[͂%=~AHc0$ !ΉyXh4l&.3sss)w^G89 Suٌf@-!1f: <@DK{<&;'\{sf)E`0>X=/! +<^9E71VwC45+z`C-)O9a >*:RLsq. k:ͅ cx#݀G`EDll@[l„,v99[`sX{ǘo=Lop{ ~`:R豤/\Dsh+';@6z<|L)`:&S[؂| fo%m:sy`½ʼnX}tG"c[ڙ92 ɳy&r)cs1acoV%Oϳ9=:u3W|zqWzBƉjA>l`=;z^r!И|8Ddk Bl0333vp•$VQ㪫fsssi^&7vy]wZl4[֨jqGD?˿v[|K_~wuWoqt>뮻`zs=|$yk&-O-6Ȳ du fpZbg XXnefCI\DV 0sy7d6CAHZ5Db24C L@ ܑAD$#c*[ 0`^Lí x:jZ0Х<<#< 獠OԪj+WɑI/< CB5ww7⊘P}UVF*J;w.fggcaa!%B`fqGn+^y{>pDG6J❯  [c{"Bx $ bvzdB{om3㽱,ɄtQ=H<@`] EȖ=ȴudwwp}r{bό P&C>sÅ/tCu5^l,--nEJ3n7yxG<R酝< _}\ϾohOwuWjWf3""^WǍ7w}w|ӟ .'?x'#";G>}{/}sI9 ϳYZ HcSu(L>P620— !w\e6Y7ąπ\V{4h  ${ vi"ealL:p?V+bh6k+ djJ;J&1ds>r&ajXXXH=Wߏn-ʸ}N'Ey6O<z=VVV +:a"<1Ga!߁ϝlX2ܲ﹀%rdnmm$tu^Dy.1TaD\~w3k&~W~%/'}-677]zWw]8L L>-ސi D`f1&㍽Do(P=6$͘8Gc0(~C Çli3&ğW>"_c_62w=Xg}(@?<~BbcLlYP xl9lB? [./ƍhh61baa!nzQd\dE]XXHm8w\:t(*J:u*vtݘO&3P,G՘Or̙|n8{lq_VVcee%Μ9~?؈"l1sf{n?q+V<۫fBǵ)ĒnId^8􆺘SK+9:'^'x+rp8LDjqq1666 ((4,7l[#lȊukBF9u9 aW&SSS#'Z-=r9VWWqɴFD:{[;mt9$ 7)暈xc0ĭzx+f>sÇǁ|;1)?2! 2&ћwn3pp Ŗn#_-X9\`ĆJBlxll9Ysaga3v#d\Mܡ<0D1A*X9$/<:xɂ38m4’n:r08v 8_}󞟟y6ūɓ<|رHrz4E/m=I̫rlG]H=yc4yr|d70X{Q.j</ 8'< w~?XګuF/a&7}m>xjj*^^f3VWWcww7ZV߉jOAԬG^k |[ߊ(|{~Z y?".UED,--]rRFX]]CŅ Rw,..&Q&d'ܱ,N4EXf3w" >HIcĘ@٢J{hmQ` l] `+3o?'ckjs L.9A֋||N D'CB dK& [Gg gvv6^GZXXXx+_ǎϧpO?tz$DGK"JǏQE/zQ\{sO\wuqdmZ155W^yeh4XYYI9{ n{P '?L=kbRe&N27sh}fl7x0xa#'ymB ^C3A,..|!{B^c9y ='h4>/:{[1r8q%" ]._nwwpB( Dd!d$d,iXNCvómuyxcu?M`K&Q6sX }Ͻ=MLI{bF#!x'ɍ=J^9j)N@HQKKK1??|+ũSb}}=r:u*zt:n D2?dlll6vH ΡL2Ov8w\j8|G?hªjZZ>}:\ѣnϝ;>`4bp܂뮻.Yz"\3dI$/{֬N'2bN]$o爍):ob{yNz"70isE#J0L!dUR rcFdAl!ewka>˒ z3^>R)rkk+N8_Wcss39ϟsf|_X^^N/}'c}}=N:kkkhJ&6jd?x{[-//GD%t-t _˩Z(-~IU83bbs^[LJruY["$,E:/vBnK{l9r$8`GuWt\{q8sLʼn'ig$ӖrO}N)фyl1 ZhsJ{ Ogo 2=x8p {Y/DFk\3W IDAT{30quPDCIV!}p O<.\H{Z\p!N>KKKqСXYYDZcG/Qf,vs0,φ'??7pCj/?ax㍉'rk^tӧ… ݇Iy ٧އM'bxpo{Y m(KK]c`eK9}aa.//ÇhIݎ'1rZ +ǹCgff0^F#Ձeff&VEՋ^8uTTոߞzꩈh6+jT*ř3gbcc#cnn.⦛nqܹxg%{bXWIq!7t1T*Na=q($$qgfuGN!>3Q^눏ySk!9u}G\ tSO=oӵj5/(J?MϥL>-p=-Z^ I_@D3 `6@$rpɐ@a 9K`rF85yںfOZ`bi~^`0 V{tzoy % \dU k ɰNB!OOO8| ~1!? Y\k+Nlll$UV{ Zq qݍ .q[YYI-//vzLOOR)dkww7|hZqɘ8}tFՊSN<8|jq7㪫|0;+++Iynk!Fى>$;C1=rO0J?nfcRq 3c}# ynPug\<0;EىzD@N<O=TF%Y^F񩅹ǗQm$F)B3}pu=FVKs… 7 dBgnxK^W]uU8q"a^YYӧO.|%VWW/~P>ۿ^DxWb|#~o~n|??oYפ\2! A:^ 6Hq1??_ ʖ.6[ ʉB|b7&Id`+u8]`Մ8Q3X^i I~a4)g?<=cLI׵ZD088Cpmy&^GV^Wx}N5?b!R)X^^NGFD9s&SjjX__Onnn|!\.Q2tNr42K}9 O!8lnnٳg̙3׽.;cww7'h4jbss3X,--ɓqԩT*nꫯN^x&ֽ 6?!1bǽ6`hZ}.+`|~3)Ϗ2! 8@އ pi7òX 4rρ=Q019ذAqX4/?55i?q.o@(&s-uA8lE=(LƲc† /93pV kw([];Gfx<`Eg^Nj²K;ɫDFQ4z={nv]HpI)ϕ< D}J@rለxїzk?~<^җ}ݗY4jZ\p!baa!JG/,,\h6\bckk+J8{l&vرhn[nWqM7}=XFttIsȽlo4o'BrKRT #*!(#{@N(:ٳg kPVVV??o{}c4s00?XcrCBd5h5\_}ɟIhꯍY{[Y}R8p@PGFex:$ Ar#"晙84B}t,:`Mh 6BJ t:h4 =a9XQԖhLJ~$pøNٰ* QJ%%wF8p@[^^[o5:GM%/2W_R)?@DB#<1SSSqСX]]M`XjŹs\.G׋t- ^Gݎ iZj5Nϻ曣Rc=Tq_򘟟'sW\󱺺~? buu5{J8q{{;x駣^?gΜknn?ɓchnF1ڌ% Xf$=n7f(zx^Wx D cZng#cO8ك@x ~{{;N>N'>OEՊ%Q^tkQL^^#FQx)1bzz:T*Sx)iDUW]?wR&eR&dߖܢcE%TTFN ~,úll:.=c"0;;z=m~NVemlFlJ3BƋp#,~6<! &lnyp(9!333 l#Gߨ"s{Jtd~<3ǚyB!32Fxk^+++SOǣZFT#"ԩSqWF׋'|ൈX]]Mpee%?8~x8q"^Wƣ>qWǡC̙3 \8___+›ޭ=31;;}:h61gKۼN=z4nRę3gҼezqܹ#GN?^?Lʤoʄ !?lXu˱lވ"!<)M1[ i/ Ǔ;Bb ]R޳@{xc*P/dY: #=> k7)4&I|8ޮH(d1~=lFR)<<2oxbjj*>?x/~^{m,,,~X[[GZv.\8tP:浯}mO?NJc;/N8~?GZPZf3cCڊ#G`0Hσ&E|j(Jqѣ裏l\wu)|g}}=ɋn8qD?>('Dݎh}~z="":NF>oxkv+++qWc=\sMzԎ~b_[[͸pB:t(Ë  nj0V&u{q뭷[F|%DV+!Q=:wy^:Aɯ7'psi CX7O!GTy A:NZX^^ztnοt:—Xw3NА3n[A;N 끼~?{CFQ?~qݴn#m6EE? ME@?%AEPHP A5:vT[QlYbyWڥvK.93@^J-,vy\}_\ mKR~FGGC@.foccc*J!X+xR$l]vp>Oi}}]!mB O%zK>cNpI뒽;]v~z`a,c!)JDϐ`w}jnnNa8b#nF#;ޟ셾J FpAC6=אz4o?|>@4]JL&QmllhzzZw^LyIT(~(H{ CZ8L9 *csP`Itoec N|x@)_H{xz 6bsB$~2^x@DBz=%2Ƞ,'qUUJ%iԮz=mmm0899x<l6{ Er0J0Gi\D-?zWty=t钾o{pG֗+Ld2xsRhH'%oto0d#6{&RTkBАΜ9˗/ZR,n!9'{1<S'Bxx*,<{syΚѐ1H} N677س +*Nx2ꍍ˺yZ߿i:uJ׽{B Oz8А99!^3y6+ခpD-yȤ?9Q ,(V6TXTZs^^,nM:dn'TZmllpa`R:u-1jJI(Vc@h %@l NC mU՞K7=,pwwWB[@`NRouVbƪ^B@\#LJzǵ]Ϊ\.Xɸ688TJ=;T*gff4<<bǺ^xA333שStppW^yE[[[Ns{[W~;I_٨Inlat2^!Άqt҉L7Z]]5<<)؏^xO}!;<<+%֞CiK"N>W IDATVd{?}3733z3u/߽{7e2hssSF#}6 axx85_/}? VރA, Y>^{b͆83>o!aT:Hf*!:&&&tTTT. {=,C\n[ #)d`p #vc&ݻb[ǝW2F.=hv> ^7H\x ܨ^.= /iXrppd0b1C%DBJ%*5??'xBTJ :K N8!'p Fֳ{!p6u%I&''u)ia3?s:c2W뒩h&Y|d7=Sw3VxJwxn?;>w]~][[[*=!\9ړH$O}JJyt5} _tE; 0f8::T n"o"Mp9}U511UmnnrU!u2LH/7ɻ^>3?oZC!fme*Nx(ie|bͼp.ýgG||G.0sW;{YJX%ƆF^\Th4Bd2&V}+… :}Cg72@$:v{!mbg7'xwXO{ Qa' ^jҗR$vIZ`h.E;]Zq|Cb'>g.T$\.|>0$KQQ:˅;wZuMjrrRt:x0ͅ%I|^A.}HWJ;v[+++QZ {QR,aO4gt{Qchh(xҤc/Ȉzb[x& eeExD"r9u]ʕ+)ݹsG=}IXL_WC,]VƆX~A>yHKTTw 83<(K'JO]=N[H3.ޏ^'l3JA<"n 29RPm}fggl6 /nCF+A~OK 0'D~ ,<+v7o|BjDKI=2*;>0 ElRDq@}x0n,`RB4662%IUU @pyC>j4;;g}Vvڛ q R,'|>rh\cMXs'oW9ޱ;c>F{>w$F7g25 {P{N8ƣ=RVd2MxNLLL.,,hcc#xR25==T*o!۵kO͛mܢ1L*//pPzS1v;X5]Ra ^(avtm.}@BA P3$Dtx[y/Q=4ap R>+WljwwWVKSSS!rL1.NGpb#Zyimdd$[FT(T.HuYF. cv3$<7\.\@S݀. k))b&GHF%}>ݣhlr0yus\.R>W"PX ]#NKQTƆvvvty=j4w^!YoN;؁wԳT !ϼ ?}XDbč4CNx7C>gϪhiiIӺvZX8˩hd*Jt:!^a ݹsGCCCzAHh4N$p\Ȟ^w= ^*}hkuR_nE, 1`Oepe|2 $׵<o A]p":<< Ȏz9 (-p@HgҞB~ZFCׯ_PKёffffRprbc0WzH[[;œl鴒ɤ&&&z^a N,GFg8CS1.d^y4c(5s JhDI2c(y[{(zA#xy|}>QI= | رT']X裏k_Z/r)=C!58G K5}qcPP18i˄DDŽ>G,hpDz/@]6 2<ЩSjtyutt .1VJ&:{ժRnݺpKV677C=J"IѩS![ʊOVp {I\V7E@_ގ' q f˥8Vܴ2V-q8={,uk tS}'9|ĻK?$۰]#ϐ3qiU}<CCC!Љ``@k55pZ v[kkkJ&JRa=e1#XRyt vuvppf'JEgϞZybbBr9;/^`J 1K|߽i\$}C1p / q 'ѵ^o'_8uugscFX\PI}B>CH*^TPP&Qޞժ422FT(ZDhO ^ammmi=Szz0O:zԹ~b]c ub]̽D ȭh3K=! qżcC3!yx/ZFGGUTJ10cz>NLS.ٳg599ݻwOn7qmooҥKb|}ڵk!ݻ* * 133x<%MNNu022 boww7xE J c||\B M<WT $5Q,}R/oG`Ap׿K@ꇸqsߤ90|G˶ v~^V{tn$8m4A&p)߅aNR羏Z,x4e2moo+hzzZú~cQДhddD*!&144_H'M0,q!h`d2J$ }M;;; ޽{=cs+-I䠌:)I'ϻ<ɽ=Ǐ"Yc@*9L2t~e9ϝ N$抹ѽ)|`xx8\FL^dį*k||<رHCCCa0?A2ŢTוH$6o}+zȺJ\z%{X.Od{6ݻo\2fChQ\ǚV/NdoY_CkL&U| 1882!u ()LZ[[Ӈ>!% =!9`llLBA7ns.NkuuUx\G}ƍ!+㾱aMLLr 재\.39677($X/' ibA,MQL.[ <>"u@]M=pyq! r)@OL[\'=6zH{xF ϰ`3FFFT,ijffFbjZ@(* qL&Ð>d2.L,_kM\Nu]`}Ro&!_& Rx80䉠QI=g4y1T9*ժJRЋenGU.{=ȬU{d|I'@ct댺zUIa.|+!&P<88|>G|c! itϜ9 j59sFlVZ^^ID {慰@ęa2d0OmtyzzZΝ A+++z饗422{,x"/AWTW=* Z[[S>WTȈfffTt=-..TՂ1`hhHrYJ%=偩TJbM6![`= v>y <<[ ,N]N K=8L;Pt "cSx6c8;n\xkx s|F%;ӭ F*HhjjJ<^yp}@?aGf(d27!Hh9l!_Z-XMoVRknnNHaflW1` P\P.'VLosٍ{@`GGG%gc *cNfgPgq/.0ߧ?:sc677U.y.6Vi?yV꣣#{1͛zAX>| 3uR' <}9j{"Rx7P0}K F2 q={831+g`ppPŢn޼`|ӧ /^kqqQ~ĉ0{GK|O@a3[9X.bwKG@3>@PDГsCsdnـm׼D `w!' r5'/p=ӑ9t\B ˗o~T*VTv~Xs\qd;a5v \Or͞$XaDHyb~:PóR#حޗ{H? CjU,0=\1dNy@Rq ?bDBh| OE$ 1BNńXj;88l6.|V:9x0YhLjh|)x4M-낹+|ylK.+޽vFK ayLq5%$8g]rnmfZXXٳgUT(ׯkgg'nT*GFF׵y]tI[[[jArf^J\vۨT*)Joݺ9$Iu\6JC*\C6-@F ;D"scL;NZX mHJ$ZXXЙ3gt ---rdL蝱) ` u/r1R9Ǝ6{JF1HnpK2N^ w`o'%rʊ> ~b_pGFчǫW=4Q)y^b5MqPvkAQ=c'!3;icNIZk:7d9?NPP,&`>@ǜ*d2a]e2jjjJnw󝞸[g[Ϙ{k_<~[{_/cL= ǟ9}BAW\ѥK@sy{GT͛7ug?5j@4˩^ T^1r{R83~n.$&.ᡡߑȃS(6vu/v!-nCZRX;@KbDr=uEwn`9v'` :Эn.Y/=+x3\@G톻> `etKԣoooOTJFCRIL&hL.aXI)wkooOsssrZZZ I$!4x1d8h[/N"cLX ϟsyB9p(ʼn3\$Ɨu 闷 C\88IrbAbA[4e)pԫa<Ȃh= wE{x[:=F&ڟԛ !H$_͛7%J< )܊B7[]EvC&,!K!e-RzG_.wp`'>2+jskzt^:{g@kyI9 K3yUc LFdR<_+!w]ݼy3ommܚmQ?>n! yooO֘{r}.GםGV1 !sL^BSmX%'He^f___ӧU411oH$TA;8.S2T6 7 fGG'!-R8UT<?,zK|?O@288*nNnscۭoAWZwu"J]GjQC+~~(nD-XB٬fggumꫪ!KhpB, css3\J788T*'|<)pvz`Xݓpwފ(rRI}0W;!^.p%]utシ }λoW\.g}VN^}Umll?ee2u:Q. $6LLLZXX͛7jڳ}^Qw~đy1.~p# u` ܙGdt>z߻͉\⹌sppPbQJ%ԙ5F ܨ03N'}H䁱XL< ɪVrvXT~xxT*pH絺|T 2"V5I?$Nk{{[;;;{E@_ގ' iq ;j ӢDRynF-Nn<[)Jbx[7R8)zz $^E#eppM2ڵk=,KW Y !7X7] N"  |vBAv;0>\If8tB\vc֒]g%[lɐ{_\'*q .Ab=u}_ʊ]% }Ԕ>χq'@ (*J9 @t4==iZ-ݸq#e\0ώ{ uy7Ih49$N% JmNۍ hۢs>{},y5:w/ }D_8wJ_hay{nwch;ܹZohdd$\*>>pQ_, j6/^Թs紶WX,*u ˒؏xE / c@1sSDɯ3Cawu}- &u9%S_Kgq{<~ѣ>T*Ja<mffFAZl65::&^Rx7?uu޽{s411MU*iJ%ۥRpUD:TMrpcA7VN :|߁[y6R x٥a.B^A[).~q0Vf/\R)٨w.^tx,*}Rbt r˿U,h4g0ܿ?߽4HS uώ-KҘ{nz]|,e(ԑ:{ sԁ=;ÃHXs|-95\.e{#F\?0?!__Gbx'uݼyS7nNtf=? }ߴ%Jf~+ 9>ea `K:ad2%n=\H ~B@_ |:aEbLFtϻ9AV#Ƅt:o#jg<x}(-wpH'^h&Ƌ9eUҎ[R\u{q6/=A^zTT444bbFGGH$/kiiC bg… jZzWx?w<:A滾2|{9an:91uOW_}U###NSRQV Am...jljgg'ė+LjrrRہİ!uFFF4;;9yH @[h|D=!nv[\wMD?J\J'yK_:_x<ncatAS:!?.ps0LQEPw9懇~7ѽ{B>Β<U!nH=wb-.͠o]k,bM,9q4H -4{Cs$y6"랓(T2uK82= I)4}?X3?y'e s{p?س= % H|MF Q b* ąqaeE̲hh``@N"\.PVXs\hlw^ȢE'kjjJnW|>^S2ԩSž&˩ZΝ;x';[s_~ХO@ق8j. ҭu I`0E}ZnWřfgg,}/2?/OO׹s4<u%% ;wN_p}R gr*K+0 [G9`j5LEu# %48zv^LR"mErZ.L&577Zo}[f`JǚG[@]:V6 t_RK_ Bf3%DR:I$ʎ˜od2laf|i9/ׄT$N,_|ׁ< qGn M>>~v'Q.,7 wпLr3oАD[RHk%\:aFi +͆U qFH pNu9U*kiiI+++*Z^^WUχHze1ăȝBt: ɩT*amWB\.\.۷o֭[!cGRE}yظvsw{ k9*211L&˗/ʕ+j:{lbI 0NBS,5==ׯcCv|>@ɤt޽l*ƄX@bggojllLúp>|6)}666?Wl6?znܸ}c:::~o#HB Owїe/>~闾:qPPyh4۟!ͥG5\|+ p)`M;qva988|>!NW8}S,x6fffd$GP8m3HP(>tHL U,m ~4>>nCVb㋺hc1~Lj'4aK*?g xvRT*ƔK'Q>hH x\7n=ĊqDL&{8˘P/Yp i$u睐-" miZ!xrrRӚՕ+W455>=t:GyD.\^]moo[>+AUQo'DBT*!}=2움W6gοrK-Hh}}=ܩBm @]788$ggg533VY}ӟֿwNЇe]z5Nܿ_###[o\.T*)χ7s{y2Ӂ]|Y * ֣>w_ixŗx?z$t?j?}cSP/E=~=(w{ĺ}^455V .ҥK?IW_t8޽/o$X,jaaA Mگ]{-+詧 8]H_ФvݓeLlX_saрL ӕ7]'AjMD܌G9x!X.S[s3kڋ*16cx 4s/bNBBx<+ZrvPRXi-,,ŋbzG /huuUDBsss*?Ӛ]w }A<>Db,87x$ߍA1 jjj*x{R2Yܨ|f {p'A琞__?P_oUZU2T\H0P(ꩧRzx={VT*ѽ=i}>}_T ժZ2]aVKOܸB; NG[[[a~_c}{400-9dt ݼySzǔ577I}'> u]kjjJ|^dR:88ؘ.\FWT :sX,^/C!5V?=/:ئ_;O@ޥRTo[O<$׏؏W\ѭ[ڵs/333k=ߏCnppPz]Z-z*r28] 'K:}8oS!xf!5f38-|^x;;V7oxh1Lї)oE߁ŞHg<>61I!3ƻ! sY@ 6D~v9z2/y.I8(b3;x\`2/c84:: 57otmMMM$.A27J >兞 9 Аv{ϙs{fHhvnW-MNN3yMOOSy(\xi=Sy]x1d@8ƆCۿt:yieeE/n޼;whiiIˁCj?_}{_cgBw{`K~l6'cccoؘݮJU,~;Z eϳDK x/wrJ=xtg.ȍ$K (g?d?$[i mt`h4B YہR k3a =,&8y0\093W .qIqWT(~9>SpJ%Jп&ƊvC}g.9)wn؃7ljg {[&rF-* Hx-?^עfȚ6::$ylVJEׯ_7M]tI.]Z' y ,IٟY}_?'K5::pR^?/*Nہ+ɼ[X }FGGtꫯ.(kkkj4y}>_]vM?;mS](뿮??ߕ:D3i!p(!dD,DO.ޤ!⣣:E|̤j>x88<$`ePCFx }yKplNLL39EԻnyFOG,V Yl6U(zcEI[}!5 wz'9&ANwƞx3 [!u>E5MŐ=תaOv3[@&&''U.kGQҥKB5`\V-mll7>>J%菂o}K/RHb-q//K>*3O4~hw|oos~14oSǃ7wwwOz 򘏨DJ:;H:e?,9JB~q+t AZ:te8*m=](y`ft:Tqe5 Ep@ġ@ 9#/ŭN $qKd\D.ArYP`B:{5|mPg}x3k\JRq" |`vD4ЃԝlڧK`vR+s] \txxJ!Fd2kii)\ɥtt:Xv8֤V);MOOEmllƍ=@߽nN>ٷ?kOrI-2Ooe_cŜU2TRt̏wDI{W\BĊ;aܻbzc)SR& T*g‚nܸ/}KZ[[ JӧO+LҥKٟgGGG!cssSu떖?ӊzG/|A~իaUU u:)hffFJE b7HλY|M-O?0ݻw}M׭[_CINǀ峟l++=;ɤ{W^ŋ$-e*|[: xP5]2 -`y!sj@w|Ի;h,ψJ`f>~AMᗽ83悅PR)x%vh՟ Z z8oZ|S?:u[vXCI灾r (j;Ng9L?`l>Nx>uK6~ԋfgM.'o卤(t`MNb~{D3O>cgQB<˽p3gC_=%]<PPy^zUoF|`CCC+՛UT4??eaܣ߄,!Kc8ȁ*Ax{'dǜ'ȍ{SRƆy;_o'W>#stWΩV|\_]=}Y_GGj6jZZYYQVS\ܜo}{|կvww577gyFַkmmM'7ojnnNgq[nikkK7o^/wLI7~>OIOO$I5006i@7я~T}$yH{1/?j6?) B 2cccG>_~Y_ӧ>9(6 "7;$W' <%!HQat:E-ü+o['D|'GQQ%]~Y\1^%7Qjp{1%b^ "h8pOxs ?H(>܇XܛjuUܛ`OB΃C tkr\n^cs ;nx.eľđ@0n9щАjZs+*d B3HR(s Ce}1I{]/k)@crK=C?#ݻ!djܹs?o~هXF+wg FjFv_=$E-//v};QX=ܣ\.^{Mv[LFJ%xfffJӚ#<|>U-,,hhhHjZ^^uĉ:qnܸW_}U?~~AvC>9}Hb~{> gyFXL>}ٞ98uꔾo곟>O+H~~/~~KlV_{{?g,T?ݢ 0P&uԁ[H`3 BiI?Q.B4Tr0 ˳\w71?200sTn޼$i!'`J;|s;c`:P9 qp#Ws;Ip[sF&@2BGĢ_>>^w/8n'N ~Tɷ@^rC4iΨ' Zh I:CP(gj Z!ܹsT* I^9VJ՝d<}2sUS|X;1D }h͛z#fϺ%3EsO>] P.]vwwCQzfl6@*JA0HhmmMVWWCN_ښjfffkffFz/jaaA$ʯx ٟ{Μ9)}ֿZn;"oվ/ _Z^^$wO@{~Ϟ={6܌oo2i&s$×L[ynD>w-֐I=9%Xۼ@%wyV,fOƂk{4iKbQ;<d``@j[_AoXuoD"%\$r! CnO`xT}V:tr땁7|A-N2nv49!u?ϥOiB`.CP7bq% *SH'ԣG57J 瞽()t#C!̭kFGGCeF>ПQG6FPD{O!>4< tIRD /ilssSsss:t2L(l(d9ry~d@t 1[[[fj4d2A6\܈ljݧH$T.500J%^ִRI}ٳgu:tHO{OhqqQVKo֑#GwuE =:rVWW500Q$I~w/|O ۻ ]<Pa ^CܺG5-Ǟ Nb BM*vK-Xw-P/U hx^rK$U*+mކnU*>3,v[|^zGx$ܮ w/[֙gq" síyN%$ҍ$)8I'ZⴽQݺuKSSSښFFF422x<)j5D{922 =o pȼ\t{|_ICWJPJR:|^3xJt <2bCCC!_y) ! PB?q }k_ӹs¾JBr! *I O~W֯ʯhiiI?~\333۷uM]~]z]>_) H' wil{OD~ Q\ -~prp0K )q8z]]8LqoPpPN,qzzN8#F-iM XtBaX iVtDog,Ro'N bΎvvvByH-xX,B08b.ɸd=pA=Av!Iˁ*!e^ mԒU0a.WP"wIl07 s4cOkCsY`nż9o'wP:rK=D+r#r}/1Vh44::Vq/]dMzX %!VL&H!;'ٝtfqp 9_iB nd!ymllx33Pv=9t3I*U,S\di{{[e]vM:p@ɓZ__MePzȑ#z٬~WUjU_5<<~ZwvÇϝ;zGVW6ܜ|M-..I+U鷷 ]ܼr3@.[;;;ePj99 )qB @un{@~8H'1. pqhts;pq`hEjЊbfFh <N\< ^ F+PͷoNT3nFOZ.x<};Nȇ|rz|.gϜts`5>bvej\d2l}F2:F=N[v;ȕ9=Y@hNY۬yN8FNٹu!pO16Â`v]e2w>ڵkZXX1oo? ]8OA '@Jگ䇰[9L,Jr,#>eHj4@!C`>N8YC2j^qr,d2-ڀU߹MjZO4tp6'рJrq{ބ=_{AkD_*SER<O q7}.s𤊑{J; <!ONFc=靝MMMpJFj)mllT*x70@ Cưxwww-;;;=g,r"JRUWk6aͣU:uJO>X7o)BΜ tZlVj5S1|&Q\ݮn߾@>7/--ijjJCCC+B777u%I}{.]%Z@*GGG裏jyyYVK/RE~:OFCki}}='NٳgNMO@a7IF-< X齲[f9J<ӽf';Ѱ0ޅ?xq ( 'x:P(3<LGx&xRhww7xA 1TJccc!n\.Kڳ p*0$'\"߫z$ $LR\!,/7CwA2RT%:B#wscA%ݕm^9˫1AQ;Id]֢y<,. DÀ?knnNG+aMLLh{{[RIӪT*~| 9|PhOKup++,{_[KR%!QiԵ{Q$t#3߻"j||\A\ܙP/4`&)>xRE?أTc#w*W$@* r#$Vp onn p,!(wГL@3N>~H;Añb $d x-@W"T+9r^%t`V@=Ƚ3& {. *D~ƚ♬";vC=DI7nd>x46@Ŀ3ȰNbժN>d4::HT CiﮌCiyy9Xc&| ﰃ~7`8igcS< r`P6 dޅ7nS̽nO9#dRZ-{[`܍x|Fki?C]>L&:a>vo >Bak${a4<5Q CCC#yS`zY_/s{{ ރ}-bxGt @zƴzkkKbJK/'Oy#oGMa@A'3<<ܓC{ Gk hx|srH(kV+=ܣY@Y{x[F#t%* H2w/%{M"WBw\.A!V y"\PX(t!nݺʖ:uJΝw]hrrR>}Qcg?YСC:xkrrRuQ>}ZӚT"еkzΰ' v>K'Vz KS2ٹ=+"X$ -ioO `e!2`>FLnGHzk2- i?l`ϱ!{T*=d@° />j4*I~4 | o'B !:~0ap{dJ#[|@{uPmb񐡳Qqf;0w=s500l6BMD"'^<]9~իW2;88qMNNWw{bIh@n֖{*u:-//Y/jۚ 塡!]rEsssj k~:J3l\rEbQ\NgΜ… }% MNN__w]~뷷OcxK2ŁwnŗqxI9HTlx"anED 1FvE[49q˦y) !ëR)L&588l6a%IR) D"+Jwċl dx[3=.>]Qrz'< x艴_w jbbBӚ̌RTM7aCֵ5oa.xg1x!d:<IdwRւA_{Y'H^'[NaHv[Z[[ʊ;֖Ţ{.֭[*:rH'J_׽nk g.*O2RQoj+|BvBXB Wνd1`p/+9H~ @׃X,{L*}ݧ#GP[rгT*{GteJ$* :rHȓzz״SN}Ţ ~~[r7'zCi{8!Hnw sVn? h' \@s/u~9s`T{}v;v/}766B>N\pcó5>>L&L&1MLLhyyY~H'~UtDuɥ?y1xL32uqcz;vLGѵkz<|ndd'(BFn[Hb{, "gU^ٳgOW_ {r-ѣz֣>rx ͩ*jZ\\ܜ>OirrRsssT*W= ni}r6׎>Xy}!p P`r9t=(~2V2|<ghIoI@{~yܾ}[Ŵz=ܿQ,{Lr;Ȁ0V',7ĭf/|FCg< :@O C5"T KQvC$HmC!H^T*Q% =cvZYYы/h=Agi'dD3kp {5C.]zHsssr!OF YT*zާzHA.`ȟPȽGN|L3<<rN~ÜCZ3gΨʕ+=e C>L+̻l6Cnƅ/ v[[fT* .= ggg5==.,,ʕ+_%% =sra=!OԩS|z(my:q?.m89 q[  =">"䇃`wCDwNVIvR%v [=Aހ]MNN_P/3âdrT|' vqqQdRof :݈$7}lz=袏=1c%P%>0|^OK/}bnۓ(>*< HN4bNj*JU< Iz'$T*ibb"sT,{cq;m 9=P_&|<Nuuk``'7C}O D)J&_4\I+K؍?y^zCv.Q*EsjuuUXLbQ|(3u 0by+ƽe|@X ~I ;\.l6 ~E'紹zggGJE333T**9CxPF+Uh4A^__dh||\_~YRI|^nW/511C=H3\xQg>rM]pAsss-BAw= nj}r6:a*fh<vppKy S>.~Q2`=Rp ?D/zzwΜ9X,??a 9AdRj5T' COdXdUBȈ{XAps9G"HVt@Tukgg'~p :z AɧqpŔtaMNNJfffnWSSS.BZ IDATWN֧߯X< :vA#`Z{4p*뵏hiiIV2 rd2Clu\^^{^---:cxq!:q04;V=_w<5W0}i4˗5;;\.jŸvw8(_n qrT*zI<NJ2T&Q"Ɔnݺ`^{{Z ^bJ펌hssS>l؋oܸ\.\sss?kiiI//~HիWcno~{;Zܥ+uk")^V99`yN,{c[y~PD+V$zN8|pS]P<`w' |9TU>W^W2Tv.\ Ip30WQKA!ֽ,BZ0Fw*T=ђ舏ji~~^Vzh<ߞ|;έAg|<&R`rrRlVgΜQ"ЛoWȑ#d2ZYYŋ#S {8ym'>@vpoGT'Ks$6E=D>uݺu+\7;;17Qq90; cs|'Qo:{{=EO9Nw<9pf/x  }-r&LOOO^.Pȱ{D;;;Nǃ!P)ORvr!J%%I9r$g_TUЉ'v?J&W_|QZ-\`XVu…;?Ojh}r6Pܺ{'9Ppp+?j;1ae-~s03248pp 9pt+ghL{E:}[ Áǥ'`w$ir:m!En=w!8X=~X91zG1t>z1D3'x<*Pq }EI|Ay8p@D"x }v[W\{Bopw}*9Bܺ-w?'v%x.3;ڵk:}~-..*kddDkkkJ$J w~b1UUU*MLL(رc&eop^@ + wCB[[vvvB6 5??*r qRZ6U& DU*!JZ*+J*Jx[[[YP@zJFFFQTh4d+(ϫhٳU}<2ȑ'ǁW'1eYV.^>orHt{%v=-9qO0$h!%@T###=`ʘ4nwg',8pqr_p@XhH=z+\ߐV'N;{sOw!_`褃糞^@ @ﺥ?j}ͽ###:~UTT599B :p@(}ʕrGV~[oy^%fSlO>2{B'O ZEe7?f3\_(ZP6Gz/f7t:{'|'&&絼@\}C֖488gyFFCwt Sɡ!|+7S-J~q>K':Xf?t8`y)C._OQ|sxci ,8 C祂ȸA{Epf 롇RXȈd\; d #Opcw-]qB0V`>$hUʏW ;츷="XrIy' c`=8C?Nkq<fvZ[[ R!54t1:srϿ)lE( 넮26{>^uU./qSbeeEf3xZj#сBΫz ȁ=Ud2- %;^:t 'u!Cx =sayr= Mx<z 4 rcGFF4991NkjjJ7n|ggGdRd2U‚~?55IJ6_vMKKKj4&&&B ^,ӡCꫯߢO@燔j{%vZ~?Ap pk4/5xCt$xBps{;nx>@҃e:8lO\(;22zfNnhAf]~=TboݕfYq/K>7;,H.3vxaqo3@+'K wcXkJRd2:w[e2!3QVU(l6XX\\5==F@;Y+x( |}ԇ?a ׿E:xy7R$I?!bx~~Md_uUUh}oE[Z 0H9ȆBWi$*rLȃF|0e݌jhhHcccCnJ&aJR!r``@tZjU[[[O?Cݾ}; Nl jB(aƴBĕ+W466<0f3HRT*!dbb"jZrѣGq^ZZґ#G4==pQLFBAt :u*$K?XNGC?.j}RooG鷟XHx'ԍV,ryG4~[R <\9|8('l=b{hH:'!ϹwhhHL&?Iˊ.믿]vMs l%C` I-J;XSbL1y9RHЫX,Wib[g9 }\=z{ޣ|3r=ijM",@2\.JU288nW todc̐#ϟh@R'й\. oi-2 &BNȸhJaMm`!wa%H'tL&sagR666T( ͛7ÚC766$)x766tɠs`anwd2@_ys ɣn7nX,yx.Dw>쁐0?:!|52.r@wX'NPٜl6o"$"rZ__!/xNd25͐AH+3ghss37?cB(R^‚zAhCeX ux i]vMl6jRj_?C5n ԇ>!mnn֭[*Jj6Z]]U~GC='N77uAkim}ooG(F_\ -um\<=$|{[\UFTp.)\“_G= @i?2jCw}7z8ypA DOU`+$ A{WT2XL@%sҖNU.CUB42.twY?ɄY3hr]?ؘ|&{̓0t"J4\|^[2aX.֎>4y6k"STzcbmaz;rY###t:}v ###Z[[ {Ji-,,C&XB-e̞~1^` Bbz}e=q .E!A&  kRh||\gϞUX 5će||\dRZ__W6 1==( bz:55r6:bekjjJ!܎ܑP T*)hii)T?~\ǎ۷uy]pA7oʊ~~NZYY;~{7~]<ɆoCP Xf `xL&B2:xlcaY^=kxx8^x[9X!UBȉ{Y0H S{hcy)cI™Jti-..j{{[ޓ|dPOR%,>z<0'& @HD bYH8Qp.@&!zBjX,o$(S^˲HȈ4;;[<7?j,z=~4s||͂ؑސPm9+!蕗e.3 ^5 <nes(B=d * :||HfjᝩTJê!d)2N^C>{'{B=_ Ya/< yu쏄DX[xbajh֋/rӧO=BdRL Ɔ&&&ziu:{*f!_N A?b?? /7xC|^XLѧ>)}O<,--;S5Oۏ= wi-ib|F, V_B2}-p)'|~:=M:wM觴_&I@䰬*JpQu]---1'5a^׫06Ct+qiyXcyu0.)?na' $1KBck9v!~@>w$[TTV%y#x'`zd2z-p2z bXaw0ws^ynF d\ܶQ=b 4~n566K.9&I57qƴ\. }p`}`.Y367aGvK{C?GB?D/߻a"wQcVzN:T. 2tR\*4>>Z-y-,,1d^6cyfgg1iZ-MMMKrZ:7nlرcRP쬒ɤ6664;;7>I{1]pA_`$~ ]`5L@C1lQr(rϿJ؃!  pOL:}~[,JAe#2(k{`B<K0`qĂr|Nyyqf8qe+8s!mQkLWJP(2S.rwT󊞶mc=BVTc1 ~؟%:244b!Q)0χ{m4=aY8x&,gy#k N'{$=G% d aܹs!gxTXؘfggy7Hc仁2~F&sz`xۘ;B پ{INmoo\%I@8VVPАժnܸ{L400Qmll422@wvvԳ.j2rnY9F#xE!\șd ezB.W>2/]>O֙3g(P(ɓ'U.umV= v>K PyB8؜w" I~ ;,Q/"s/?6;\;w`aȡDeqR)]zU׮] 㧆R "ZQ0yȁR8`|xt'c "u-.l,/?;;Ue2pw$+CE?`ܚcW>/CqI=!5fSb1&QvמW>sN79^C}|: oH4}K =Kg;kC<izzZNG?O4X__[  IDATۏ.mXSxؒC= ݲߕz;wKBH=Qyqy$|g~ Ͽ qsyPMNNT*izz:ҏ<Ɓ^)>0+z_<ljښB)%d`v`=v'=tbrCnpXl,p\pg Fr0hq`wB.}<2dIQli'TvL>ct/-IA^1 /<33n aVkl\UX+d -}vB'4|t{\zN+L&=8bQRINT!A.|Q|=>A/|ovZ]]n߾l6d2ܧœZ-}իW>:<  )`2 y[xa'@߁C<&ruo9xo'o:xǵIOMڷF!1SsE;$*W.(yh8v+:v.ΎtMȃ* !g()byH~ccǃxƐ#` o $O}g>W|8a`N!}%U.x)!)`/x"ys!_(!H EUjfCՖ7xRO8D.Y;d-K 2DER\sgg'Tð{gggPƍr:q^y啞8)f3^<"7![B}³!d#4T*\G 0Bewww-7s\oo?ZWKiP|ϱŋT*_P*͆ժ*$)ϫV\. udscʏOۏ= wi`r\89!Ŀs p7_5 +_hE-H }YP @n]wag?`+k \rEA6~g @R1rK{[spạEs^9~nmm`ct?\icc-=iOA-]ԣC\9ˉokk+ \gq")(Y3Ro_c袓 jZ+[9bndnK$}jRgWpGRR;X:DnǏ+L8΋P=C${H۔Jff/X,Ad ĉJR:Ϸik}ooG[>$$Z9]ZIǫE,x.AֹwDڿ`GQ0UO҇'V+T4JӪV*=I;l[;Vc9)  95.#+C?@E[Kh [RQ6ƴr GFFJѭuqK)>X !HR*I1l  8Enwϓdν +#{5z=!g͉-zkҌ=N@迯A:s=VȏrObOcccj4͛7H5nZXX)w܍+ sfI0û{'+'Jpa$ iGbF\.CCCZ[[S&ĄFH`4::Yݿ aRfWjww7!!]xԝHĥU{ww@X~i=!=| `t@>|>;ފ~{7~]B8=Y=!+Qk[ޟCxC*Z 6ju7HL/X=n-TI,pJ%ĉ{Øyn4Ɓ x 8g4n:EDI{Fr\ 3QʽUFCor6 T-rI?P> G;PT3uTVBE%g ԁqiA::Z"!3f{ 1z~S9a'cs%0%#o|dp4s} =eQtO77nYkkkz7C?)E^dDZƌ zB U5teclmxB(H$TVCr!RIBA{o&Ii}~ 666B~{x[n߾1r}{fcڋEQ$-S)i%nknM))":Jlimh TFIhYl,WII.ry-%wwΝcf{FnkY9@p~sߟyB^RrpfauasooU*$I0FFF%VKrYbQϟWT s?凑{,O?tw>;Cr_>}u/}I{Аjo;@l -,֗6nRd2A;:S788X΃% B8AObPt; Z%!'mp1ד6},S"P>W_X,#Iׅ I =}Bq9K|yă==AAlVWaMjj4WXT& 22X,*NmH$T*4<<#H-r@G@&D_ 43,!g@ iffFZXXhj1-307{AQe yk*B67;㢯o~J͊{q@&UeMOOk߾}ti]{z{ޣhǎcZ^^b 8PocccccHfL&~,--馛nRRE={Vj5x`blYv'$"f7{ގ+o]ߨh賟n=sA~,I~Vs.=? .?{^yK\ٽ nt8}j:0uxOƲ XX`]]tP\31p< M]y@NEZMVK\s&''v@' Pv[[6sA}Z[[ 5\R<҆widd$H4 ]w}YI  Mꪫ466W_}5ĀlڴI.7q0#~x>HmH;sۭ}3_ҹ:{ץBn=gnP u@OR'$pM3/s >c)a_k/>{Z\\쬶m"7dsx 8oדO>5?^G b}Gv#D6TV k*maÇ{:88dgńbg3j2 ٬VVVJh4+ZXXĄ~W~E[nwE"=׾`\r@&bo߮z'O6 !imZ^ɓ'u!k aoDp RtjY" k޽[|;gx7jݺ{/|AT(}Nw}>InVӟ~w~G1=U٥G@@r/2HuBzT*x5{ unApYGZzC Գa"A.B@Zn%sMyd\N/^ # t~~^\NH$qh4fU(BC\8`a` CfnHrfgg˜D" m3і00ue 3qR gCrTw_vBw(m^66U5f@'^?ӫҏcecԅPT422x<ӧOkll,3gX^ZZɓ'u׫\.aiB5duqqQ}}}I~7&@zߘW催yt. e@p~d1AH^WP2 nǓꫯj֭7?~\<;˒ƫjppPvRR zbbBd2*:sւjxx8=ʊŢ>яj``@wUV}v?ZoY7 =C! X,Ӯ]/*/ՕX=^ͦx}8qz{߫끀ڝŸcGQ /8ؘHI&0.]*:A1x^R%"H(Jd -ԇǚ=<>߯O' IAr5gu8`ឞvD"ёH 2Y;wN/_Ν;C D"j|+ڽ{BW a|ؐD"zjadq#&(x2+5pV~xqq1x yB~7ĥtk6ӝwީr|P0.#$WOFRN>X,zJfI-//kbb"-ca k݊* ZYYmݦr[q]>1-..꥗^ \p!if7C[[_e%I|g>JN<%]裏ǎ {ٴiFGG/+?# WhAZt  Alb Q@bwljDԄuKl?:td]z#$sk* ; y !W4Յ eT(Ev2p%P$\ǁt˲N`z%bnC9Z[[⢖dPCwnvq8qBz׻BV"\.ɓ ӧOkyyYh+xGAFJqO\NSSS 1~|iiI Tإ7@|fYEQe뚟a`uu5؇|g.kbm-..2c\\wb}ւ%Խ\Cx6Va߯M6)ͪ\.krrR*kN,SXΝ;f;S{=9Fu~,c^'ԙz!U*08itt4ܓ#JR0 -//kddDT*ʊݫBZB\.m۶)ܹs:rGv=ںu>듟~wW'Nг>X,Y[[S:V6UT )|O}Jvto鮻 |>yLLLP(݋kF+W6-I6<6J~,^0fZp?q턆x,{n\2q%ⴍgbs^WV… !PVqBoʵZ#>{I ŀ+'r?+TV;~ @!#@J|-^iaa!ribU@.&''599J۶mӱctEm޼Y+++:|ПsY,?l62j H6 bڱc"N8Ɵ"^ "<24`ӦfIJRaL2^ '7 f-3G1üf.1?X/r'R"H"aLAT {Zy+JrjaLiRD~]JRڲe^~ux1R-xnCv;ː>Ǚ<;} !c \g ;`eYj`A'nxeeEGѶm466V}Cҗcǎ55'y˖-d2*ZYY cxggg]?4>>[*Nŋz[ArYwy:d2|?'xB?jΝھ}ſzgw^߿_/z!r9:tHofqĀ=z4x"(.r 7nw~}S]wT^.=r^exH)_jΆv]6cpod7Wt[]gh?5p" p`.k||\x[nEڼyz)ɟI0R)=c;3g߿5ُٟ{,_ )I*nXT$Q.$ӝָX,x## Wh8bp@T$X8 =6c>w}7 EYܴϋyϳj5)YSX[[? K+66Tr0A_Py:A$pyѿX@m<ׁJ@)`i\,SR j/cǎs-=d2\.ŋNzaa!CpOPP]0mۦL=㕏Hj@3L?po/9lQ>'t8isgͽlݝ;A}z F]>`1Of]tITJzW;2vHӾiǎS:~Ml ږv{vy4N6=;ĭx`x~ޅ2iiưjaxܘWsСn{}XcX(u<+rYx<KŢnfo/qP(;vC`٬| wNͦ{1?~\[lѻnٳG<Ν;az3ˏîS"vڥx<^x5=zD^xᅎZ.]RP[z; -n23As g-,] 96!:v5q tNןzl|>11\.2ik||<ؽO_'pNx>ǽnm`PhwyȔS6hUȤ;maGX7k7 <#j4 Kzr?N,:soG +zi]"EJ E0}qwrD;b5 N6<<9~N\u۳B1Wz$=fi>uތ)O̷X,dBJǵ}vm۶M3%;Hi"PVl8bcq#Ƃˬ8RI, X=x}}}Z$o3DF yXG=}GO aÚЁo߾u6 apamՙKkQ60z-,,{*.r-*zWu%5M|D7xR*:5E}k_ HcGGGǵm6 ?gZzTuw?!w}׼D|YzOy@&q0 ,+ ;wɦu^:Om^ceozdAX ^,n07n=B?{by^BF3ܓF:as@IDA7VD"-[ҥK 6M-,,x<ЩS455ܻljxx8e% ]|9{߹mȃ{l3@6g޸49%܏y餓P{KN}2!̌mO|yR,Eh4$=47Qv'0RSGfL3>xߓ0ZvBI&߽:gs+埞Tؘy}Ξ=omY[;x=Kc~uuU\Nz]ZMgϞ?ڽ{>ȑ#:u4==O~a=zTG>gѱc455;wn쬎97QV>Oꫯvi:uJ{fff{GwGA'?OZguwg7~7wޟس_z -XR|r`OK?te͑~!Ha`Svˠqx-<w6sn$~m+rv{GOkd&uA:j'fXioG's.F'џY `]Gq A@G >~(dJ$!OR^G$&ڿ/顇O<zHFC Bdpn6xb?OMXYYpB@z`xe;Z >vxɼ}o' <*ڧ[t2wyFdF ZZFGGe|sD+4.GD6%c^ܳ='xF3+<1'i_ #<>]HRi@`$0ȑ#zdBMBD b1x՘닋ZXXFM6R/pt5ׄ/| :~VWWggj׿k?#MRP<L ϟW֎;sg0Rg_XFC###[_Ս7{Lԧ}L}}}z߯{7ĈP@򗿬{W7o=ܣ??|CW~G@ |έ:6&P,l4X[5Iͳx pۃ ƫ[6x=/뎉q0}mt $tuu5dv{Ɠѭub& KёH$reU*`t:r^&А BhHCP*1?={詧 nB|V+&2j.u&\ `,So'VVux!b{Ľb>@اO(PWd=qJƴ}vU*♉$OhZU2\I;0?ˢ;14+3n>H0f{ $׽E'O| &I]tIJ$9w+`;aaaAdRR)̫L&x<)=󚛛߯ÇwHGuw!s&ѣ>ZM6ꫯVɓ'u%j5]{]ofI{@s=?w8G}Goo_+?G@r'8.aT[޾e"[^/VL^6}ipIC___8`ӦMڶm{@s.󞿦]x>~v~۟ĩۓpxåѢOܚVxRub쎏Chc@ hn+w8b!K :o6:t<}W}}>G#W q 62h85]C"'e),Tɸd~p=.v'u6m] {aƁv ! ϑL&Cj'%@jȨ{Ӿ>ٽGbV ȁ;'I_'%v cQR<m+oWT ޾>MNNԵ^3S0*pN 뗏phP&*|Ie+T*gϞFGGui=G?H$˿ N>]vo͛CBSzE@~W# Wh<K]7ı!Ο9kM-Rgf6(3c?"-EHL7pϵ'|6޳gjaa!,l$B'$ ~K@uN ,͝\Υ`oI @{w,S.FGG5??D"QI >t~jp 9=N8Fp5 ѥ=חe8qB__Ғclcuh#2X-#EyϻvϜG40)ܛ27Ym1}s $!ԏ!#xUO<_tuC4ʍ*χqM{$ =sDŽÌ3uܯ[Ez9gqof-!. C<{\cH}]uO&[NNNWWc^о}t7{^HA͛7+JihhHR)x2zF\.X,jh4|>gϪZLyJ%x.|E/_ĄoꡇR$]w:pFe i}{WzG/=r3>u[P\Ha# bcM][%ĹSȔ=AbAEL rP4sssA` ]?:yu&{ Z|=]ݲIr_!CH5͆ϗfdTTB6jH{ ʊ B K %p7DG1PT/R(JG=P:N# 0.8ǫ˧;8\{l-CDC\gs0$>tᤀq-ޯh7ηp{6|=@k {uc``@l6=22idesBmy޽na=۽Ѭ=܃vurx:I2 ܏q*mȹ|}x@;VhNQ^}:00 ]듟uERh~~^vҎ;488'|2dr.) v2ثU}TV5995tMJR׷-MOO… _?_J[+?-G@v3#ٜ\mM`Es.INR!BL0=nsIXA Vҡ!߿_FC.\Wxe@8o -: !ǃx{hIg[n T*\.hk@ }Q5 YhϞ=J&gp0,)SX!!MNNCc?~\wkffFgΜH {9҆ jx#\E?1{JnnTq!]1ϭE m+N''O>!NKk8jZ!K1 W]u *Ji s y 㒓}}aHN-ύ<=5kǑK՘n ?pI$alV0!։DB\.V*ootEEQΪnkrrR:znVĄŢͦn&Z-=3a,|E\|X{566vmzu9]pAdRccc*J:~mo{^~pZŋ5==={;zWzG/=rRkx@ 69S\L\@L |@Ƚ\ˉHM[0\=,=X98d_N\&mM~U.o0Gѐkee%5X0~҆MZׂݻַUz].\ܜ,OtZ|>x8u4u6t‘  T*irr2L&#iZ_ו催b||<}qJ%=zTSSSjZ!5l-\ ÌQ=huvXKDcIU.;,% ^iq_{!k p/(3?Z}}}"CY6?aA?VqʊdGbfεXYYQ. EZ-=Du R7>jbhh(d}c`Jv5{܃y& BVPc`~bx饗o>}ݺ|?[oU^{VVVdtw'ӧ}HhT/^TPP萱1N1Hvf=߶m~~K/_ֱcǴ\.~U*__;ב#GsNԉ'f7+.=r~6K8w{8%7gڱaحklXJnԙ% ^|Fv[y'rDT({Bi@ k:HP?I{n E"% -..v.,x,=1Np>.\ဧlҥK!ؘVWWUմÇT*+h'eb,,,{ AR2N`y_efLu̙39/bSRo. d#y!PrHxPˑ3GXѩr5?#uD +&#}%\Nx+ O {(6mҎ;wj5g,hT!Y˗C̒soC.BG֞f;Ϗ7뉱9õ\׀nbڐ1*}qF>9>~teɓD"|>}C[CԔ BG; ̜DTV/Y.\е^Ǐ4x†UV5==)b1s=J&˿KJʏ^z -tvPGRشqs{҆ϐ-}3H=P|.tll~{.%0lH#nݪH$3ghiiIZC|rG~~ҋK\@,X쵧6}9,K!~'MrZTN500d2)I?cf|TU% E w~H$ѯ迩RIxs9-6Cw\Bzl@~a XzI*Jھ}{HKZC9Hڃ<[]]3>#ɳ|ll,hbzN!J!u۶mAbXr/dK4E!x8Ċ9b;D6!"x|G2r/ixHgqPn hx}ćqאwxH|ݠ^2.]!رCtUWVlKcccVu7СC* ap!H0Zch?[ں[.2<m%I---8$8D"nSfmT*z;ߩL&3ghddD/Μ9w~~Nwq^xp:Fߏ tҺ!N=L IDATw :00K.o2/*j˖-~WCCC==ú[t]wuzꩧ~ HG@`uKol.ͤjǵ<0 % =pC]܃ucu'md,&U4<<͛7)@ˠ{K m#4v&dqi뺽Mݚ\@#mW./},hcqj>sd`:r h*JeeِI[ 6P7_!:ƙ} ֔J@xvpMl Gѽ(.!\萐InP2^7wE{@,ˍzB0gӦM* Z\\TT R*Ji`` O)ΐ9H{̕ڐN8|a`>x@h<>!;kǎT*J&X``4<+DժvڥihgQR>߃OOw[ZXXP*Ҷm۔L&uY HV;%}G???PV̌$'>!iPT,Ӄ>}f7+FKwKܺw @aC6*.-ul fl6j|:4lH}ZG 8LvlC$[$]jK<-v'25s5\Rkkk!-mR #Fi4٨xDݒ:44BGb CT*˗/kyyYw.f_@aQvMbGpt ]v{]Ҟ:Qg>B=8= Y1;??M'dG~>m(mdn,.s D;r؄@h 9cnCb/H5#m/SdK;np`ι2̺<88D"H$RzD"]tICu 9Z-r9=:t岢Ѩy}^|E%I}ʊo}ݧJbARIkkkJڶm¡l65==jvvVBASSS!^JR =ΝS6U>G>MLL'Uz^i*=rfE6R]@P6\l^FAJR#B `t: G"a$;H2LR%@}ZC$?f>N`"F}6@I\ U``؉f Y -R8cRHP`y.OCCCAB-[hyyYA722`ՀfLFJR!'mL]ؗJ{K( `?<O 〾,>1ǜSnBmiG|q9Nciz.a̠^|2#f'3G|qu bqqQ/&''CqRQ>А¼]H߳V⭊D"J')Q_@u)"mmb,I_6 =b)3L,P(P(WUmڴI>VVV411*J> _^~@1$ óI{@ͦ^~e%ItM ܤW_[l?A׫G@z姥ZCl[y7jdT@g5bCt糖f9{ @/Z@@]Cgj``@J%5iWKx.l dz3A﹌+}:tx`>Xah3LT-UT,fll,GF|1q ewwyV{^8 >@xolS>#N]rn_+$<{:.lvx/HF~e2E=VFġ Ij5x0Ĝuqp'ĂWrLH>p$cVw{5E!Yd2YO& hll5[H$$`lWU S C=K'SO dLf4<ph ٦lz֝!Òhژva7@T:@Ue@-$%MA0۽g.sOa1vϑե%xA4Vemm=Qƥ[~(! 3a[ZZꐡ hݒXl0 ;vLbQZMovy#^g+Hu/h 3py95%u]囥.9r8@Q$kߥMN\4kkk*!6`E-//w'N:)'([5niZBpLv[8J ^Cp2*HhbbBzp]tĉ4*IKdKd*JAM;~399RB&*JxxrmL'`ȦYqz2P۫H$q{x VfPI 8RNSOϏϙnCE.({Hp9bs=:D圬Y%hTdRtZlV LGH$B 7MMOOk͛w^m=zC^*[R ^'̙3ꪫtm)H`;#~855ӧO~U^+^4bFyu/D7h9(섅t߇Գh;Ȁ[H%)Ν;C Ąժ"HAe8i#խ$o3A)k:qk%6d 8P0VLa:+)ꫯօ h4t9e2 *2=Vk,H"bH{˸+288bh4\.yjZGVg˜+xs'x+8X, q$Mx{9?O닷cdc3ǩ.s=6z ԇuֽK\3w}gyCoB!).am} x\ub $"ىGFFBvEKd">e27rKΝ;M6}{ZsBye2`pX]]RCAr>_ElV=ַJ}U.++?z+&4FgEasrAJt G| z6ílN\ظ,Xf͆cZ-={6Z |sw{l\³ Vǁ}9y˫j@έ hzA200YE!uuuUaZ%<*4 pjht=S[^:`qΝ:w\G@Z/}D>Xq-pEѐ B`@u0gTF"F,9kP?R!{o;uc) +ܯ\666,dcӁhh||\CCC gook؝oܫ^7oӍcېh4BOlJx)} 7d2sBĄU.n+Nv#m6---Sfgg)I>ijjJ3d cwjtacgՑ#GIZ\\Lz3y@z(=rƭRll|'>'m,^ln.ªAFp.@$;` 4yD4eΝ~Kcm|w{ n! <>ċ-<cWx]ݒ2+<1~u ߯s)LI.5r$EdR|>\"Jd2-[(̙3$&qIWWWC\{g`NZ{$)"H\ύqƜ4j>Dy=xFusYbva`,0<.a6u:-XA|z/uf^kƗs 2saڼdzA|dF``` #/uk%m!ZV, A;v5>>\'o˗:N:{j޽ڱcN>0>CΜ9Ǐ+Hkі-[533bt:VzWވ# Whq׸K<2gMKX8p77uk,y0:<'vu@y!̌Znݪcǎ)[?9pp[}z 'φ턑{eIu!Ͻ}_GQ?\A夵z=HY|LZP pi@`\G\Oc1~J,~wXT\pj{,g;`Mӟ`3Ma<5s܃@[38eqq1x|$|ubM[P\%req=5sI͛C OX 0s .J$ҒRT +++ "IL&dJRz[ޢw]RPP4~࠶l٢iEQٳGwq>VCɄH3~cKKKr};566BoC,oWz(=rnIڸ?=^k^zfziKb8=/ԍg6:2 @H$SNuP6n+=f- s4d8yy,~SG @PnEf:TJv[B!ܜh?:ʩ#@\VT FӸu`lGzt:AL&U*B=}ӽUx0zzRK"~ŚvJrDHSZVC{tK $= .˒6`XN~]O JIR{8qc-փILIf:sEudI۹ښRTG{{ xVWWOҥK?ڼyvءGyDx\tg^# Whqb%uO,kkgq8x0>-a#=%>|sw{ aD'!kHA20;;BD*RTR&Q2TZ hоV}wK9JM.\B!kB*@jى$ j6j49sk1}xQ|Z)6!SXixgb9㡮KKK!3/utpfSW϶ CQ@ٰ|VyLIg{2:N,z]kk:wU 58af|{038VFtqV:2&..]O[C:qhT[lXy@a8qׅ:=7=x񼲾2'ht#@__*JJ.--)JlPчxgHfd2bXHK.NsyFFFzȸZYY kBRщ't}cwܡq zݱ.=HBb66/l4,TRnk* d;Z@Kbu/ IDATI{J%m޼9fM6ԩSZ -JLmq")ڿ (mw2@6YZZR.upLf0?J:$&v;%? }֭[uyTf3u> H$|A?KŨt TN.8Ek2dq2* _ؘɤvܩ鎸Ld&h,O{nVU=` I^* qff&x YZZ mbQ'JELFv&''裏\.+ill,Vhx^ Bc|Y nI ~H u 3?h8+%H@rD{k̗t:SAVLxRb֝?^+++P>W6 iI˗sN9rD{X7=a![6%zu/$ 0SX xCFX#X<>̍P<{3boUP6j ubQzG,S\V& DMŋj4ڷo_^B֓l6L&i~~^z2 k*{ jTT$Iccc*z+… 7J4B l``ڈ,4wdCR =d l:?qi$ ݸ&ꖙu`x]fij5m۶M6m=:uJx<PϰSS{Zāunel!!pPIx31 n]n7Vd2@=fS ZOP q\.fqzƲ}ZZZRPmqq1M6V٬fff455u]|P.\6oެs΅yX}lF=\.vF3HU---wiI Ȼ* S暓B~-<ccVVVW K\^gK:ۼ5#}Ou&ѶmtYZ-ڵKO?&&&T.9\.o֩S:,ɲd2k q󱰰bqhg)^9J7ġ\.kppPOHrZ;k4͜sLev{=:N\.+L41^ӋVZHoxaP`YL9 8"aB I*Tfc"N1vYLcm<ͳi$vu7u%u~ӯ }0Lߪ.ssN/Jr䜐ŵٵn:LLL^d̖D7oƅ^Mo<^-/d+Jv뙟d윥gR`bbp. ī~S H[iDk+ hTyԼI Q=%]ګe+ &@FʣVHZ˱RO (f@*$>!}AJR-|*R8nv;[[9G/c^8*}B ŊȋQʿ >j 8 3蝗*ZOXE p<ڢ`֭>k#GX n$8RnRب|@k(ZLRt>4n1s.ybG&KtZVѠfffLYBr6ryQJWR'_EySfʓzN>#GXnP(L3)TVi&eVeZNQ,188t:m R8NAJlٲO63772 [Uh9VT tz<Oޥ 3 J{R{^UG38ߩ+@KsCSo$-Q bii23g055eJcb`<ɓ'1) 8B@il̳gaahm4qNX@ ~|R),..ׁ3F-?C8;ߏ.Y8%T*lذ&sssC6E4E,C4^XZZgw5U^G2}Ylٲ>&'' sɓؽڭiRk+ h%FX(Zyw؁Çف;gƝRd4nl۶ u^)YRΚLZD*4\Kʇ<%8U9`|L%T>**hpRyk /ypMBT)xAyJ;@%Efo[ZZºu /`||ܼD-Zbڵزe >`߾} `_)Ѡ8Uи->j" Ni*@2o{Z"[f>[׃rx<9j4&JCCC6mڄI\<֭[gI*Q*z}ve;?|޽wo^3THcb&''_vkssZE<ɠG~4*!>)ya;A5R68 Twj)5gD.//c``VC5T2lx e|/ A-jTeG:g2NI Tgg'rI乧K=(+|?r̃}V,dlZ l^x!oFB``155t:m#{zzxV DNMMxb>|[dG򵸸H$$I$I̠REϫv{-r6Z`'AsVʕ^ļx;zŝ(C/C^~ڬs׃QԣLL`%䤁*,|/ǩT׆b*:ߣTpl6[ ֢#HRh6HeM9KplGᜑZى1ґRBYszn%XQ~$~?v܉rǏ#N<h {lk1^=餶&5=y¸*ºibXf ;fƆRԢJ ŹZXVMvynK)rrr 9& +HObv޲(8r-МZ^}}}q/Ncǎh68r䈥zu0;;k]TpJ`0hg3KvkvZ[9GzaET-^faS>CiKLzw'Ei,*-G-T4 "9W%>~I^8BYxLZ3h @ŚH`6Z_UfTbT!"¹`0h5zzzP(,S:_ "5D-PPD:QWW&(>v2j*˵MI[έΕRhf=}}}&566fY|p'kzø5kK}RG@Z Ϝ?MӣI.S>KYTF֬Y\.f3g`bb֗2B8TNF9"xܲ<yv3[Rguv裏É'9B!ttt`jj1qqPϦטi&27[jT*efz?]@ `ԸJbrlJp89 #!4 ܹǏǾ}pWWcR^Uf4ONRnV@ѦVq^sJkg3>,=7f¤Eatuu!Ͷ?2űs DŴ@j O E?RZ"P(d%ST JƓfсh4iKv Z7j9WU׉"xBT DbOS*zCeRD Ř@yll(UJ-M\aKi* :,"MqԽh4~kk 8ҩ,fT`_8s-1U|_<dž pLMMG_gg'RjgУ\'͌q}}}p\((Nj*q*É ~ƵZ JR<]]](4 3QA"kƍ( B$"ySpoaÆ 𰭍n~}j75Ե[r6^djaT@H-tx"u;S4 5ۍ6UDy>)RgbV?eRW*aoOieʑohTAP*F:~\q ( rC~FFDKR"8&,--Y\۽ZrffX恲h4VR׍216|'YT!'2AFؘmfJc-8JYS"׎`vzT)W|۷oG65 088Reݏahh@Jɓ'QT4ǽuF^Zz+cEŁg ׀=*{MRoiߔx<1S>OC=N臺gt*JEEE6F{IGшG c(vuuY}^S.fW#''^ fr{i XM|Z@L<`4<*s\.c||d+chhCCCD駟ϚGdϞ=Wjg.TVMjF "\.[ *j%`xyij솎ABALI duS ,D BW~=_u~nR,+ՁȨ*N[-6rn~ }>%eʔI4RU)߁@zcccVFB(2 a?Ε*|3r^ZYjF&>h%-J}}}22ed24ׁGR8f\U=׈g*KӃX,D"dTZ5Eg1==9>fH7~HNVrxgg'"B|sss}χd2[bVP(ȑ#8uJ"͕[nE*YH$D"bQFa|> ̌:4 Yww

    ozTxr=1KKK8s持_V<E,.."HX:Xe ø Iar9u &JSo*Q|abDEp~ʶzem#XFIަ499i6U!еb5אϥ{Fo: ߏxzjV4׋P(dh4l\.<h4jKm^QzyvZ1|>~aaa{Ŗ-[d0== ߏu֡x^Ӗ "LPG5LSfSo8Q~*mbb7t^MvZ[9KMoz7k0n6S@/ك-[[o??X r[r k>S;_'^luX@GJSS<|f4Rz;$ 0 `V2)L&Ip[լH!ߧ@KPqzs5* ׇvRT RqhsUA ss,T tnSՌFK&йE)W BEJ;vr˺,ܑvn6W=^|E*ף2DSΩ3r_}9zXQ-FBP0ZuUBם{Q 9vg|ek5lB5&-E3kjPVc@ uT66i3ےڕ465y}{Yϫh4^YlҒQX^}=c֮]~Sւ ֬Yc1r fֿ9T*tww#Զ0b~yO8arx={g?*mrr-V65O p ͙!kHx4pR*/5 ; H&bJP$:H0)ł9Թg zB(]NSPsZQZϒ6ZGTB MT`YS\.c~~(T׊".p4 .^(, UX,bff\Ωi"bΝzؼy3\pݍ^z FWWk.!#" bǎ&k>3[\'dffԧx&iNkSr>n e 0*D<X7ˡsssfyqX,fE"/K^j~^`j保'/2gJVi lK"U9HP'-Mal^8سh#yyyR D%sCl`>]걢YS7gpT$ZcTt8wTTz&p;2 hw^0 oF\ų\%[+p7T&/{@&P$Rr/a>K-<`j +1>[911!Aсi,..b˖-FKJFfBF+TsZ4R=<7JQgbVaUh;^~^s2PjH&rrjn3)n  N7~}R>靨jSgX g>|m@ `i^׬YJCy 9C`zs oUВȠhdž%E^) 5xĩX?Ydhߩ$Q"tzMSAA 8z(,.R_TY<(J-F_*l?F;*Jr:4&PN4NՅT*eټ8 9Z VgAzzzpLƊq1" ݋p8rl2/aXmy> o7ۍ}?J >O"'E]G}^wfggMQzWx<ESvڅ'OЇ099O}S-E)r} BGN:ᖟJ.~ 鮵Xk+ g1'9o-܂|#H$`{ڲ٬JZjB#gK WLW\TZRpu.yVK.W) a"|>KX mݺ[n,C3qOGRWD`}V!IZXX0vMad_(KtzETzVTT,}->2O`\X199B~ H$( kДr@>Ke{ FAV"Ԥn+|>o2hoU)##gRᡑn$"JC@45XS i&>|-p\.:t000_|P]]]r򗿌{Z|GG>a߾}طoRشi&&&&z-]޽{-@]x7>>Ufz0^Z bm6m¦MZ~dZ4J'ۋ|>v. x޳m ȫكF3g`Ϟ=_Ca˖-v1KyA\r%iuZBZ;::^GA-/,*g*UM+@M_H eȕKE,R%vZ r\.ѨQ5|"r-Y<}`K"'Os|rPUn1ѓXyEPϨW,ǵlAhgT*r{gg5טqT҂ $fggQV n[CM+ ! Ͽ2Y tuuO~۶mF!Rn,~\f T*jA`MSlNJwRjz86 X)RaԣA"e5z艢Fy%=*iWz󖖖LAsz3UN`0w8tU~?~}8F:JR|ڵk8qℝ![uQf56g;_)ՔƽO815ב ׬RY@3[aV"֯_fT*e/zփ mf%<* Bzzzi&?~X__كx衇pwmhhzQVk+xgLMM᪫Be4MLOO̙3uD"j]w݅~R)s=v&*ƵR,E=%k)5L[q뭷X 7pmAr{Gxyfx^\Rd9s ~a뮃Ýw;. 7p/}fcQ ** TВJz>۞d``fX ҢO>6 `ṳ.\ &cLA:1,f5??xzJMM%`ZU=T_2AgʟG ƅ__G??0ַG-sְMvZr?qDQ\ve㘛=|__K_݋wk+֓JX,q\s5xg/} g۷bSjպN`\ZDi#ZYiܩ0-,,ՓϢEʙ !J,3JIVkUX,Z@ 1S|&M,JDwwwKLz þ+&X;CiZ,VGʹZps]w,--dRfib'N`͚5G.X*Jk6&3p=\]``p h q NZ=<HQ<{5øIr98p7oF<޽{ }Ę=c]o|Kî.WMF`0RdNŚ%28/ZH$b=D{A:6ф ?;O9*4Yy饗vQ,qy:eڸq#:Ṭl$)~foox<+gg ۴kك;_׌rEᮻ~ܶm#3 -oy nVSR>" +_ nVo Z"wv8~ .$рb>CJoCK$O /h~cOx^7/v >%BD"bf%T*G. ÑHO;:CR8hTx;nN*qT>:?2 GrLT9.FplqHӦSy 7)$\΂iRvd;xLa9NŹ(ƍ(GFHRh6F/8ufgg흔1L=_iU zlz6J'$p{*s^>RD/R w}QoБ#G022al۶rlpF\ݻQV5-` ye_a, gMq9"9E٦JQ+ȳsjbMrd|Kqqlݺׯc=fEXz혘<4NYNEǎ3E{^TU8q~Pk׮_cii 6l3gP*FACPC=-[`֭6+CӃb1=z6l@2D<?A oߎ#G`jj+v<g=vMv vg f}#P`Z4(?˦- @(!o?R=J `d*eb1޽rsss( CT2+7tpp\Ǐoj0,ǫV_.DOL=Pԃ%IASfB#߫컮&cM=J7#8kD8ny@b$I,,,XAHoT*Y+& Pl{^>X̨z8.DƆD7 1 nB!bӦMسgbjj3ǵTPum{ *<)D}S,)sl*\'UX2Utq )O7 UPT0887 xꩧ#Ϸx)\ cUNp_8? ԣHS04EgA$AGGr\Kr5N< IDATtuuYFc%)Lk.LOOIEɓuݘ7: bzzdؼy]vַ~^b1lݺSSSp\d2x;߉k֬[JuoDZ=܃뮻~7lOܹG֮]mž={f\vex'qØi1ґz?7H```;wıcp=K.Fq `,Mʾߺ`] 3A ט{kAx} (_ZKQi1Xs4*ˤձG1z͚5Dww7099B}kH_M5pI$I3.*8Nʄfs;HgkS=g\.9l޼ٲ8p1tvvי TQy0'˟kIO|Jr^ /.."H YY٨8R@ L+*" t>Ti*]]CsMVO~k_AP& = sMA"`~~<s\K,3k+חOLу wӒJyzF h6BXXX0RjHRJ$A<7FXD6ŶmLF8* 6oތ>⩧~軨r09':;48{N *TT(2˸MTݗd:C ID"D M RsjVΏAoZqj^9=cùE3lqܑHdԹs<GXD>GTB8F 쬝-˔p8L&R|>kעP(rY b13TyjX#3>aۓ\qDsssBزe :zzz0<VEGGz~yPUz˨0sLYƾ84@H 'TCg=(A<b>Sg2uI `%r'O""@Ha~~ނ׫*BdF`!h4j{{{Oo~-};ށ/B,3x9sT ~pxwF4ER,J.b{81矏??Ν;X(0;;D"׿?SR)nÍIo+ Y@X-FCARLh X%X@Ciz&A~FIkw&YXZbX,-o 5c%hg㸕¢^$9TEM"U;$zc\~8.c1AUdGJ*TTTl t1+\C~SLQ' X{p===4`p>Yfu\wEa-zn~" X333H$nsm6$IA~f@)[>?sT4ׁ<=_DkEK9UQ/i60Tpt {/( ^5A`/< ׽+]H ~Ȁfs$X,f®J۽SVBvWc׮]f鱺#F 6`||. SSSFd ) gK2_zDoI.Xqk`1 Oo &`0p8l6`0+Ç199@ p8l ?|\.8p#\wuO~b|ptABrAl{;Iܜ^\J R!Zk];5p}jXj= фz4)j``1Fa^=OTTIzF6lMp?!<exrVLˢL4A&&&|y¹|6JK|d'q0_,h欮.SPH[೩T(UE)TT~yBH$P(LiP )qù|¦M022b1jM%Z^/ŢZK^G86y(1Hن*Z(7 byy^z)N8b͚5Vh\.رcm\.cjj JfVE[PM^$[1D Jcr- `|tS Ħ@ijpP{7\RtQh0Y\gzzzJpQd2OX-сDQwy8sL;4x*QiM X@)WTԹ(Rn琦^^^){1<*I4 ,G3&z^?p*^=FHsIT*VѼl"͚ҽDiKؽ{}m2Ѩ).*3mm:6e:XQz{{z-vZbnn\>[n<7! btt·a}.Jjju Xɛq ՂOh4;CjVe@_vEw#srŨVnTV~ޠ@2׆J=<Pj@lP8|>SsF3uww[1E['zL@ ~twwHH$7ݻ-N^333FT*5k HR,ׇf+*k5SN!X)===H$BVe1(,h833csS*<9r4&''{nE38pKb> *Sc&|>H$2 ('?I\uUرc*q?͛kFvkv[r6* JMZ=y9ӲKAk5AFpCf3Zi* Vд "T"Zc׬4J`ybwuu!`vvzXXX 022bNpKTk(J?ǹc97j)8L:'T94(9ʏlINkT[=F41׿zCB``Ԙbh맲} v9t\FŘV媳xhuBxrŢͬWDP, 4Hγ:zY%4l-$,`;6T(L"qeHA!".~@ ~*&!,la)KьfGיӏ~1jY IDATTf^}9:1KMţwVV (L$8{bnv\r|X 333]TF/? P{羥LR 4JRt9 TeN#4-kH)F&I2컎]cﯮv_^ GϢ y\; -4pr:' *Td2!HǎN$Zg槅ӋFիW111ؽ{7:dߏyRԕv_FBTB<G4E\Zfggׇ`0({: T*aii X O(TtN'J*j$fffggQ؞L&o} \. . Jd2h4XZZjCnݻL&qQ|>Lztv ˅FPE\?W{(X=J\Ǎ4/Feȋ] <4 XK3M t &ki:>`k˼i (QJH~_G,x J 7V~tVO贺\?z4`;gKzʚ1FB1Q Eovs]_&ן?3Y*$wʬ aC+%sd)8Awv]2qV'+=̐FD+j4RIJo2F٩>11!皲=Eg3=ˉrGhT:n7"0<<)) . !NS|>$Inr9H:X,l۶ j ]__8 U>\N䗞BF>#LO< < ੧ݻׇ|+Q H ϑd2 ˅ }O֭[aZEvDQL&8pv>Ozw\MJbŭ| :A4. ~t -D[CkњNz=/v3> cbOB vK1,^Z1X:i#iY%h<&J玔76Rt@iS $#*T]h&X=Պj*[U/+fr8XYY=UZNh5״^zR erH$hnZsRX,H 6ݱc6o, l ݇Zvp\.rd2ajj ###k׮ {A.2vڅ%y H$'OG h}}]Mˊ¥ZitLm@BrJjm1A+jU~WpMt }ӊ)_0ShrcVݰlCP:;:*"mՊ13Z-x^B!,//cii ^W|@RůVcii B|X[[b~\VA9WU QTkB%r R{d^F^Dxgw^lٲ7|3~򓟈wM704Ο?/t:iZtN^>;v@*SL&xrH$F, d3[kN\H -Xy(ѺŦ7-|'IPh#A`-WN,ǁ(ij  I@taܹ+^n˅ONN4mixIA^&s o@H4='Y3P7-לC t ~00udddRdYT*s 9!:YN\.)Y(?ڃ6[V'DNJF‚r~?mמ-|>/1z+%Mn޽{qeapA XJEғRi3%/ٳ>sI5㔴2ʞrrur#4.heߣ}F9WˬSqTjӱ`Kq8ߔ*ʚvכ3X;HAv;c8SRi(ѩǩd|>oFC2 QבL&Q.ndE1 pXYYA"&}jff~& rLsaz8SKCMC=A]X3gHl> uV|OSԻ6 ؿ?\.㥗^kڵ JT zǎORTd2t:ƫt:h4fd2H$T*%I leɓC n:͛7o{^|_ťKd.Uʹqy&p?iÁVP5ŊsHyʺ+X,&6G!lH~:FEpY >2}9<_M&|>Á/bqqBVUdJ!^W<cE~P( JId(Z nZ PH$ z&&&zaX6FXZ-Q+$VċB/׀g=y::`xx>OvpofEBR$g;Ѭ\.@ur9pNv. X HARb{o&Yp\BRu,_N"駟ơCP*`2"gqZ nc߾}Xabbz/_oooij>+g4Vv vQ. f7kFr7#%a0k/t^ldkσ t Kq Jg 4TZ, +Jv\ZZˈAպq @MoW{E'' ҠAfMa?t-=ӤB77Zu0|fRX[X," P(ty(ƌMM S-///K A~G恞 +:u0-3| `Ϟ=1VkZSO=x<.ښ&6mڄvSDt*JfR*@'h\.K{A$k3J'@Z<׊JΞ=[ɓ]{I8F(S Agqt6 Pf\N,YN!JIqBIf3|>T*!ϣT*ɜcByvR)a :ښ$!`tzxLCfW.&^|Eazz###p\XYY ~a,//̙3ؼy3]&XZe,~8qg?VVV`2 ~%^_S@Ӧ n "%{Mїjzk/Ep@ !ǪFk:b} =`0(6'''$f ʵAK(= i?QLk^siʛVTc<G.d#G?My2X]]E /品ETծx2s-JsgR(.\nɄ=|^p8Jt: ۍL&H$"sOep,pͨ4(p8(nR)"cΝBXD<G(*vڅW dTLg<?-ҠU{D"A +Lb֭zjT*ph4bBUM0f"8^! 4Xє'=@Z>hK,MB-|6OO[54;11O@ajkFygd2I].^,pLd/1Q};ĉ2 N'غu+|ITUE,,,[oٲE\>G8F$^y:iVu9ahz֨ko#j𮽯>͝`/ҥK6u{ҐʛR Wg*-ZcbyhJ@6Nh;v@RA>I]KϠV|6?\5ɦ |.K7oQðHl:ɅnN.J|xv:N{ػw/&&&r0<< ͆%8 wzۑ%0ii hR >VXLG4yMl=ވS@ FY[; ;AZӊ9/IѠB[5&x^}p:}֖S#___x@hEB±οEL0yZX9~ݖX+FOi!&d_4SShpdhߥe2D7MX Xڒxe[kZeSǚf%J$phWVgL~N_P@PŋEawjb8y'JkdիWq5v "I5kvë13~5*s}㐴jP˹QQd|EQ{9ek Ir1lUZAc4|ҞKwxUUq,..d2E٫n1dXd2P(N}/Ld,dfn[maSKoSY3A @\5ǁ]J?=2zTz]j5\.D"m aqq< N(f{zqw LQ! ^ciiI [16K\=T.7iezWrg @ab^G:HXZeJFkz"1wu22AFSEtz;~\.w0` mrŹ5z n9#5zXyXN[IS2=m'T(/0P@Uʄ6)b:rIK* b6q뭷8x(X鿏='NOV{n#!n˹wT~\7Q HO7-v^ڂZu9W൞Z>Mo Tnzi2&XҖpZt*fff000 l‚'t 5UD+T;A3אwbZpFf6%(\+ V \>PKHeI%ѩ9ךY܎;H]9qRRg :+ 1 '-Z '0eV.>O{h5f6-Sf Nmےravv.] 0}>.]vo?я`2uiŢS4 7R&9ZaqS ʽl6%siy:#12>0.\ }~{^Eχr~_+:~E)b>Wot\pRftt-iZq7oÇEa zR)_7v'E<ɤ(h<$=q4Z-Qb%Ɔp~M#X4R>z)7T18{saa###rxߎH$^zIVtUTU;wN[n,n7 Zp53z?~T/O0xѺ *w#A+~8|>#GHisaJ IDATA8Fr)B|D"4/p>S/We1bVT @,)3OJq-^1`0kK.3in{^%s%"5x6<t!N1ׅ!p(<xQ~ؐ"qhJ/A*-BE>G<G__*̅lƉ'`6wVaXVF} ___Hz6+"ǖNQT$F &( d$ [ٔ~&yVVhzzh4).`-Ͼr nV R`ll fbQj\.oE"3f\.# b||=vލF!chhCCCؿ?۶m8HXy3C~z~ѭNrzxAӊKY_:@QgxVFU^?4~ W3|kkEj! !`qqQχQn\|Yrk>:HE`̋DZεDŽV_~X5cVD#u]! Dy5*I3zp,N ;Lvi%/JJ{Hz1X>&D{`4Ŕ"K\k*7RVu_bn7$ZvIho39`0d2@ tQ"rFFF]z;K.Vaǎ-܂cǎayy?ۍR>GMЮhp`buɸF<7{D֩,Q n~>RC}&zh)DVhkM%dIl߾]5Gb2_LߏzXXX@(B4E*T*_im$ @ϭedhV EI_*)TIT*G /&S'n2ssGye^χjt: ,Np8,ASSS2j;wbeeǏ 2qM7aii gΜKp5zNt=2@}AT4eGam)ש t 3/pP]G* fSRQ,j/rlX<pE'Oٳ3/Z>5λTfpZyp:5H:YM+D.K@-@w%u~^lF@V1 ZjJ ȭל]f#1FC싎uW˞1[jPC(Z/RIAZ"2!NBFP($2DFH$0;;B@ ={  a۶mhےrnch4x饗d?쳸t̝\RY9Ÿs͘$Fңpl,hH/K6[BC$8qmahh@@ҹ2[8z|jUK l唁 >ϳ)J%*n~H;v쐠k׮a}}]1fggqQ$2 H Lw(˘XV%6rıFQdYٷq&xg@R"2Аup_QnV+"dj|z̘?ӧql6l߾R ΝIIl6}p8XYYs$V:}s8x "N>uI#H$^嶞~N/---XhqԞu`N{C / h!36^.j bwM!Zg0:ȚMZAgڵ 'N@ѐ۶mCPla=D!λ  ;΁1Ҵ* A2 ].:~l6# dꤻm6R9=o|f T2DRzL&Q(XVwq(|YLNN"͊2Z n*|j`\W-_+0RN9r\|XYY;P133h4* +g2ڵ wlɓ'qI4MI1M\+T9sC{8* GD{C^/HӱcjS*N<)9r9ަFARԁ4ŇΈT \X,' ` A6?)@wM ~bdI&|zhZBEjiwrXF/G.iҡgtMҴ+~n ҆2(mFB`)L9JhR)G@EYPt zkdLTJђp8xSrn) @Q[,`#S+.fd2$Ix^8N?)d{K/?88Ʉ%;b۱w^\rE(-OP3z%"hC)Z(34Lp_=\'6zMiܠ\paeB18F#&m'elZP:Ν;|Їh4կ~Ә޽{ĉV7L8wFGG~8qÑ#Gpw#g>;NE}7,qnn7(g5 @~r9)JDtD)a}P@݆ONPZ;>NW\V'Ŕ{^+tG29yfl6~uKx.\}8Nann###dpw H*c!YKlo7< Yvmu5z /AOi;{:e ]`A[JNM2f6k- F0:lwۇ) T*x4w=:k*~z=@9^hu6 i* A{g3Ap>p\x<( +v*}:[nGZ1j%0)(^WRҋAry7oF<w:Nee:ͫqq4-bMH+FVK8FR V BaZ[[A__FFF$yvvHrY*ӒM ӳR IC>FeV1h?\Mok?GI{hAlQIԞY]<h,k<(Lx<ø馛r裏JeJ2B I,7nömp7K'捚KKKr$(h!xo4fp݈D"rp8EmXa1˅X,۷# NGd"DXZZn BD/'S:\|E6<^|E;w|^B+DE9wZw)T~xP14ݍ̴T}mr066|>{lj'8)J$ g ?N,..ٳR_|>,--ljpYx<AQfRժд(S.--: /^I,..\.^v̾1=H3Z*z%^ʕ+"GsPiWy<3X__G<zH%?1$N'nL&?~r)_S@F ld⠩l/z+z4K[ \ŷX,x- 컶P'}XͦX]u܊v,NOO;wŋ(b՗:N:FŃW{$H,ho泀΅xV@6[c48OYc$+=A/0 <2iNp>شZ-x<ueIIH12B*kP>9sNKK{tWsƽfz tgn#jaaaT FC^R'x###(b˗v%*:PوE$NJʙxPxgcuB M{T֙u2KzRjd2ɓl,.."NKP($iz)+n4 \z`v\fX,H&8r䈜7f@dZ LR l6[HgPHͦ(fSI-JZ )il6Es *I, P^VD‚x荙GXD<G\2Jn7h4066~G ٳgDP& O~zJM\v4l6K%=@w} MѱJ |O'uCWe4el^F(LIK^ϐĊ/@K4-NF*k1u/ycҖy󽬬"|t3DoݝT+.|KF+KtrPw3ׁϦ|wc|H1俩HͤQ8׺V>#?B1fI_-+y@'˺  1΂;n1#Zٳ8s 6oތ5|SB$E?~\l<=HPGE^D"}8wț*E.zJ¹Xśrni&\t Nݻp8$xɢ(2 t0 xI&lx'F%(Kru\lqYwdnƧׇ[baaG{ " du|>"KD&AhTZ-ay&aCh4$&XłR`0( Z8tZ1>>ETUA9#B݋L&h4ӧOcvvx6Z^ h+̄@,kFKuV)MQ~j?4Za lJ5D`4yŬ+&S'(b*buw0W^~`MSJ9'A#7yZd6Fj eglPQ8? du8p:~?^oH+: Z+.K62E }ca%rN% dėhKˎjTI"PsCd6%Zbyykkk8o.&+N4aٰ Ʉgx/>x EX'3G HP|c=\+?ԥ:deetZi]ڃsڵ'H:FC_Ț>p4H@WAKcjb6fscbH/'&̙3Bў9KKX}]p!p 8ps#^&4z:X|i3|9О}>tՔ fjc'a*f`PK(Z&!R^FZQP]QBBP3J4=T }JndǺp4gۑ$ 3z ֐f [i<nP/EyaV8i׋t:-1\Z xvCCCh]n9i2D`Dfi {)wxƄB!l޼B[lAŋ1;;-[;$\.nFLNNldzߎ SNa~~B###&I[>ڝwމ;Ｓ뽋e IDATgs^o|j< 򗿌#GH< K:cݖs}L h %ҫſa2LRw$ۚ7RI%XjJ۩)Z9/KKKX_djK$X,VuvP@\,RL&#AQ"U)Bi=M/ =J%Lz^ t:8t?ן l|"L7x#^~e>}F3gСCx"VWWGGؽ{7 .^^xKKKXXXBW^ 2L!zo`Pl6OFFFp]w{X]]G?Ѯ}E_Zy@Ӧ!/\]I@Ug'ﴅSӂ.4Vtؠl:UQ16kkV4clyڒ?zLFy2۱L&#ʀ6fOdl⢌;NcӦM!SS`DZŕ+WV.ߏ`0(u(w$/3q\ 4gz6R JFT> =t:-{ |>T@[__zXfy6 ט d> 033)}ɓ'a6sNܹ׮]w܁Z˗/|P8~{zx ??uٳ5۽{79"r=11!?׭HΝ~Zr6G` BQt*^uY|еWa$ύ1hm9m&^e>6mYJbR@ i9L@2iФm T5c08/\ ` 멭g-z޵E^+\]߄fM]=5Mx^X,KzQ.M&"<,^:k`@ZZvr1Z@&V!6;;+tB t+:j>iVcǻޛzr_j 8e=O2}@p kC%ʴVwPn: ,5dOFBիVؾ}VnF\1b1T*xEij^2fJ;veuu˒򙙣 hmR颺RrH&[yaRZ  B^ Sܑ1OgrxLd҅;wŋHR?}Cx;v}000 .`ffVUhtUt={@xvB!|c=??a nwRJTލ- ʳz7< qqLH:kO6^NS AV^=dh ߓN?zh&-F MVC.C\i0z# '%)xg0R}0zmgI{41(zw:tI[*DfI>T|>)vQ>?e>u1^G#=k2˔.%fn"@6jEPZ TFt,,ψbUte {YXXbόt8 z)$ ɾj?ʯ:c9/d1k0niZ&idהki@VV2KX]tEV%#ə%ER'VL&t:-VeU#Տsqʹgv@5I`eeEYĘҕu8“]9b(% R4齤)ߩi7#z=>Rh8G׊]hZr|v;8iR):u /_C6ؘj'µl6B!W_EZR(Vld!4188WD g?Yx<T*QN' (Tw`XJMzfC6E ZRѵh42B/nߏ|>J)y$(|A9sh[lq59p)n׿uɓعs'b;&͛7cǎ넼M~V(ӟa .fp8 baRfk3~-oy5^j= uH)1u_[ Ieb^ |sM pgUd {~vU8-bKWICh v Lwڅ!b1~)B~CCCRŗW0;ښ^dq=N7_{C6f^$=Zԗ(׼VX,J܁Q97fLcA6c/nheN&f] 4)/$ZtRt!S瘘USǼ^/JpAyċGK`4Z<FGG_$EtNc~^Jεq]k9&ߡ.>sNO+ ~_23% <l8wJN'$ * ?.^'*LqlXDu| =:k2$=Pi'o}}G8z(9"J5rv-NB:"LX%R:, 6m$ZMZx?쬬(ʕJEj0(K0Μ9@ W駟F__>aaagΜATիWowy'z1<wYl۶Mh1~%ww~iNiEV"x:lhp)'-Ji;~ђ-j˦4# l6j~D? _BpkkkrA(x<Er9޽ 0LRJ+8Z)T.ҧ\Es~Z{8ڳ@`PBL5  >hJ]\_tRl4PRF*.WV‚[+|rp^c&L8 Xϯ@R3LTqe|>Z-$ LMM fii H+P Ȯ|yf+SבL&L0aMe 1דMz ާ|jl6eR`Q>jY6%&!'b/APN'"(X ϟG"@Ղd( j*.\ uS6+jbrrG &&&P.Ox#a׮]8~8h4Dۺu(׿֫ /b`֭Zx{ރ'|_%ivvGŧ?i;N&n7ML& ~%ZON%cVtOCӡd,ѢltS:x]*?G CiV> R`\.X+n]>A#lC,t: ÁS^9;Ny`߾}8qBPW0hy`*1ڋJ{6hwe9RCE~s,JKcLvJH+Lp8\.'e5Xz,Pa"8Jכ)Gky7R8Zx<CӋ@9rx$ٳRc15EFCTprך23iq|6 @tZdV5;~]#K,QlP&9A3\.WW-d2# tbqqfYb$c-2n&Hh4*%⢜3T1BAh\ٽ{7J4v;0 $HpݨT*2|k_~3'<2]ا@ g,8٬@x!)cVnݺ\& 8uHevU"!Jl}݇Ns=F! .L&FFF0??O}SH&B2g|D aߏjIR)|Ʊcǻl M#}o}+B2 |I|[g>__5__J!X,֥A<#>P({ac+.ؾcg<[Ɠ@@@EZMRUU*D[n BQմ K!$a d,_o׾.?ܗi~_4H}ss/??'> ,,,m^6$ i# UbUAI-! ^ZyDh}ޏ`Aft@$Ri (s1kBf@XR䅯e>~בJD62X-bu^J5N{hEY89-҄F{;5١ISU5Qg"Ӟ6!N3^{󷶶&D=z`4 X,$=qq?sμ^@L@<5ǭLz򴊛L&̈Gr*~J_dpGJ-Ώfñcr.ǃWT*!JI6lbccCŸ$Á /`eeFnWŢ *cccc +cv111-w1<3?|Zx;ށ~BR~_~g>#E mڴׁ`T%9@/$cJL ܩg|մiKK1(W뽵̆EBg-1_hur꺯^ LMMl"N5dLA###Hu,-Ȝ @,z)SZ `ժI#cAMpGpI+*c]iܳ?Ԗ{Z1~j zz D=rziE' &)Մ%X&3q cSG IEsZxdSB#: bZ7pe|PPT n#O=wyJlsO½E.=TqߑlhecǠ0=͹$dңf)T=e?y{ͣ'=˅@ 0Bn+f\.Kp5EJ%3@O^,C^k77$ZǽĽJo&$_$ZFp+Y&#  "HX,"\.t""`llL@4ETg- 2~?n޼)ww^O5-dpۍϋvP( Ns={)$ feyv4 $I!r!^rajjJInrrVKD籸($f^v3ZDq]w=yP0;;'x˸t8} gi|ŋ`0Ʉ^x'?7n`bb;7_k= 6l/mH@nkdh ɀqkhJ:C6o:4aXRI@@2,hDtCy 3y5X,(J0LmdyǪI |T jIyZ͹~:ƀ9~'x-n֎s1xS=%Aip idDa삎|ir>q޸7A.hP FuIOĿ5q{ FFFD}  `Q.f%51:-:{]|;NT*`MYMz8/NPrTJk\N<-ttrv; m xꩧG6vvvDH$LİѣGfevyaX066XZZ"bt]ڵk8|_3S.EIt:%[v)8Hoj> ^4u|>DQ$ ,//jMoz$bH* rxIC666`ZZ7oބnܸ@ |3뮻P*;FLx;`۱o7ÇV+{6&''.]BGӉv؆mnن6mtu@gP|4jYd38J VJ_>4k_Bb-ut= j6ZҵG{| {>7hVɸ &&&$f$]^ ދn|JNo 伎%qIͦȱ8:`!z :22"+n>.7[Ekiז{:G/־9:,h$狟3H:i_(`qw^K VUvQ. wPWzӉgҥKI8NyhG1=@:%_@`EM.sl2qItLOFŲ#1(4t0.+j\. (A b܏ɴXZ/&I$M|"N:='2N]G'z\.1It:%٥*'nG4ū{vh4o|=^[[C ˗Qհ/RW_EP3<9=zЇL&cnCoŰQڐܦMKRzc"W$`Qh4k 0IY. TЪKPіnEa爖~T*ƍttTJ{3d2cccc@\pLrY%$A{y`?=YZS$[Z=;XksH 2U{0g8VdW:h]d `O{`H[ʜh1E>EϘ y=v^yv;:666dYZIp8 gYx^GBOV"$ HRu ~_2Po^8z xBo˅q+z lbxP^Jߑ@Nxr,7χr,FAYY$D@``]. Mѐ5krrZMX?+YLH2`uu~hv.K֞D\oJۍD"m0:N81^z:uQC"^gΜAP FFFPTc=-AUidE7b~~fY2kcZHp8$X@x$5KVqTkg; pq޸ R҉p("btP;p IlFϵGPI-q$be2q 譢4^ ^Eh0OKoXFIRm2pQl6WDK,εфUqY&zp͆h4)\.,//YC8Kz.ϸn$IT*DQ~y~$It:>}ZRI˘1TFR8|>/dscc;;;5͘g(Img!\N֐'qϸOIzjv#cj6 bQ0"+o&?Ǩj.\ix^l6b1 q gJz9LOO… z*2 Ν;'Pw？um~mH@nFMI&|YЪI`AuAK :(K_PJ|/= p (5@'AʿXʘGi+xbblb\NlT/_F\(GIh7y`|c6]m[K}gMM{8o#N@=I@Z0s?A& g6M{}_D36I~l[%Z_׋H$`0l6R$$$+\΋cQ*rpQh6B JR{@{^Zn>loڻ -:rRn-H$|l6Mx<C͆qJ;v W\rrsq? Oz4Pf, a{{fS2=<rn)㼔eEL&! |n(U.R6::ϰΈEύC$jիWl6QՐJh4paDQ<8{,9J")s?_F6E"@ՒXVnzbqą pIu?omH@h?'fFA _vze|gZk@ghZe6_Rr<lZF3 im7ǣe#Zrvp\r}eJf΢b`vv'N@˗H$DГnQ(,VKR\}Ly\"@V%Ziyg4˭>uh c8&:j Hzs@?&z~q9!aYgj^hb}ܔz̦~=|^g(hmnn"JIj^>FQ8q Z?8.4A-5ưx8f!~"Y}2zqq~ &͚-T zf2on[29Nx^x^b1Y#ɇzbBFGGEh4%d2P(rI\Lp8PVe^R`~~tZ$b9NIEze1CS[,ACE l6KA\̑#Gp8$bxߍ9E,,,j̙3pw#)4" t$c?񏱴D"^Ϝ9ߏ\.'$l3lZ!M: p/s-/u>&QK"X@K&dV5^/.}Ѥlpzzt1>Z i B@$&''1==~+W`ccNGOIsLZ#eu~p>5q8Oz]dD1^_轡y7Z)i` c1N{AzyqGܟz=8vcl /~h4iXv~/A̷m}V~/Vsx9sa=z^ObȴRMV:sF%ϟ~.nNGb<0xzb1<xC㔦v]j*An"r9?\x'OR) H`ttcccxg/#s  aqqKǃvd2Ulnnȑ#X]]ŋQc?mHBhC m4dӲ `#!˝ez}Qqנ/*'m% (=08*uEEb1a! {~^W{{{8tFFFP(piς=F{< &?3Qб>FLҡc ➣}^w?5)0Y <|s=0Axu9^{I_[K8o6cY̵Pǁh/>oaƫ~/N#{J!I(C&(֙xۨT*@\pPd]iF?_ B||}(OȈX{vwwyb.K0X,J-V&!dHZI3f(fO{^uj¢c>J^<11%$Aw0$q4 rq|D3ȟ9NŠm-Y^L75 圱io,il6p8$Z8H @pv/^D\ :;SH 9^RvZM,CR J/vvvJEĒ. X__ؘxRaP(tJeufr@Gp$zLt:rycvvVO?4&''ҳ>9>}6 .]B/%ܼySRrP} p. zx׻%@ 4z/x@mHmH@nӦF|Yk` Z5%e'M&P 06uZM /c(IWf_u౶<Խho A0?z~+ vww199)&FvсԜO¹'@QvGF8A_GHr]&V+ N8Iq|_Ф*h( AiBKԌCψڳiw?Ʌȥqp$e>}?>@_-c5^__1$vpy~PfC1#KC,U]'Qjy6C=C Ӹ6MTU >& e:kqq$ ΢P( ^fֵ:(#cZ&YPcoo333S6Ȕܧ|^pL&_JEB<G<8&''c}}Z ?񏱸Gyo{p|_E*J4`ggNΝCXDӑfY Clr.n7fgg1;;}{X]] wz+҆6nFk&ڲ-Dʡ(E#hP7pc#X24ncF"_N[[["C9|l6%h/t-#I^#ٌ;C2i5 q"HӅtzUc =A\g]ل咽E2H$l6%slsq8wCJ-"t: Ht;P{ ';^n%c=}=p COll >h«_0z)aZiY$=p zn6h|d2y%Țfx^DQ[lzh%S#Χ.EyD(B4r011MG&ۍl6f)u:hZ(2~zH&"Stp JIL&#D  \)i1e2|>R)9ZMȿwɄt: `rq0k<#RcT \||(JX\\͛7E>V$iN_0 dcaF ՊL&bee2'O+_gEyJǑJm6%o(<6666 {EXQV133#5`za m"+ _t5om; ի5`ٸp ]Yi V2 9e#T*bu@Qn\.cmmM,j9?яddFI~i477p8 /ՅwI7];X, `R:- ג 䓅4Ւ*J5)Ж\-NK8"$Q\[b׋rJX,_.SOȑ#j~~F>& o~qUloocwwN>|nWH60BBDrr033j˗/V!\.X,bccǏ//" }{oVauuUjܰ(GR 4i}dիv0=NP(… x;lnCr6 [r,D"`J$/—ޞhA\lX$Ke,Ɨ-,ު&"-DIkbw IDATIJK/t&\ߺ =܃|wD&mFFObHaf! :8C@}Q-Pj2Xp-{} H2>-ƴi˹ԤP(|\ѓ~N:Uql<iB6~SFD'%u#xmJ̴!nԏdroo"qb1339n%+I*[Á-`er]A^hH%z;>!Na۾ mdP˗hEˢπp8hpZD-AHV@Y,9 k EPO-`4M W|8__F2qZҦ&9|.\,7c8W>bWUq쒀;@"ι1Nh,Rnt$ }Zq]wZ .=J1tzh'Z\/ߝN@kp^s_%bsνD  mhM ^/7#HH-cMb1rg27Yq4$7אsIOͽ̌VnLNN" bddDbH*\||;|>B!iA;v tE*yx099MD"qQft:%x 蟜8'|H^B:ykZT}xP,cST;C煘"3ѣp89vc}}Nn[zOgԔvxkXI>K_N8iB!]xdnW2sq ʕ+D"A*cRD>ǩS033e;v D˗L&ŐL&O}J2gՆa{#!MhЁA t2A _L] Ҟm-}W 4"aBT E`krN42L^ׅh&w$a3JGMP511χBW^yLVu@I7I{-ET*R^# \.yckc'!Yjy~0kX 1NcP,5x 1ܧ5<h:`CLs^Y#=2.Hrp5EIIiӑ$FX__21A|>E9w=ƚ4:F@(1T*1E{z\.łB ,OFZ֖H,t:煘fT*G-O:66X,R@ ~j]qt:L=>>頸+T, xʷH|(V*|t]~XViL&y&IA ʯjBrŰJ"V|>ߏi<3FD"hZ_͛7q~?L&<_rdNLLH,̿css ȰmH@nFE`Vx~Du'8%^mmKhEڲMЯH|j@tpA0G3J}r呁4ca58&٤n޼)@.^KfOyP*dI " FGGem[' ʾUtLY*j1Jϐ43Q9N!ʼnDR#hիXYYɓ'(JիWquuA飣Hz|xcjj l("ZT*jFy&8.\ ^Zy@m^6$ q#stN@g (6ʝxEЁ(A%J3O_bl?C %_0i0f0Lb9 jc b묖py<8qxa6 8Mo Kği S"c+qv'\=N}MV}ho$Z8.3/_a&^WjýE &xާ }FkQBkh ^ -} I ÁY" ɣL}-A!ekI=G %r<3$:\X,#dvK }ɄP($ϤT*n|>l6+R)CZGӑ ׋RF!23ZooOMOOP(76#Ȟ$ĄrM#ҵx<.Vٌl6+2̀t-nU8l~,GX,J$$/3xF8͛7vsg>{<6q[<[ݮdzkHe6 ^.\D<ǹsJdf3F ˿ַ6$5Z!@˩`N @]7_BkB@=(X,IA# lm;a`" q3`fL[c$R-2Nੵ###B0D>ͦ;96Ӊj*M HZT }ֲ&%/$Ap)/b^)J65l\3/?kܓPjʱqh ) qO\k}HT'EMOĹ%ygbO«&oz9ְT*% Yz~z3  B\HtDJ'> z<\.,,,V Aw:BIY k=ʽ {@E$K$Zz-^`08vr$XEP2нZ ah4d2V0h){B!R ȳ/HG_,0 $⼱x&1/2I^D"'O" =y]&1vHSSS(H&8s _+++B:⒬ ZzX"~u@(n$CfEVJp }7R۴iK*`9p`F:&|_H h 4}x^d258XCKR4u $s X?άĹ#Hvp:bݜDVõkvvQ.f $Eݼ^d5 @h&`<@+eYz gG{NG91rN[ fEH0 3:^Ux&jAB::::(<Iѣ 3?ApAܯ^4^Cm4̐h'FE2D&Ar!ˡX,4dD\)}|0K Wu(&3(1a INf`pKX3e-3xL&e>{L=s:ΝNSnpRod#&Lү~/ʎ $a$It:GA21[Gɴ_ı^zkQ$_?1??bX,\.u}sp!EDQ|ċ/SNImd2)=il#Y<^̩{jh`<a mڴ$FKZJZeh"a_jM@_zZk(c&/}BLFb333O2U*Ұ2ЬazL 8i0 \?LN1Zl$A0W~ 9vxʿޚT}=[z^ĎA?I{N4I1K9s33iqyN6LZ- ,//cjjJ9$co$?V+|>nȱ&I2T9Na7DplXFCX0ՊH$׋@ FU9e25ZGGGQ([G9g*I&nWR w:V:$@{>9<<;|tH \Fz-Fjv-i~HɩSzaXv8$I~H׿5|ӟO?l6+)tV+V =p$y|G\---rM{!tbll RDl Ϻ:mа7#XÝZ[tJm%m]&8$$MKӠ8xj/A-:3_F~A oEe% []UCL#Ii2ĒrPmzNn7B><(¬Ƀ@}}ʾ^/Zj½h$~ Ϛc9\kυqpz= "y=Z-dM'6d\Dt###đ#G`2077'GA"@ZX+9ZiLRHsV)xӛބSNazzz|۰ ܆۴QJ G=#:HVk@ 4pwj&F+*ǭSq Ƙ ̵%0JG8&$ VNh4 ͆l6+|j=^0ʂuoD"!`6Hv'zb);::*;Sla_GGGD011?ȉ٬܋sTxČ5ZE'틀ޡX,&]ؐFʿ(T*TW(x0xHHFGGQ*v%gnaVx-?*2;}Azqa3χ~}ϣ\.g[V/Ѓ>gV @@^~bd2)) z&0 @m0,Ic$($$ljRaӱ1DR,OLLn#L˽=$:bHDVZMD) =FRI<%Lo._̰Ev%TR$$B|=Q:Nt:qy'@\ƵkīW~_\\DE"/2<666p]wn_,^xᅁ|p|.K I- pcyyY-Z-LOOZ_D>LJ>!<җaaڐMj5/" hd8i`P~Hc'-" a`i ßŭ%[i0,OG:JxzmX,LOOcaaA1iI\8'VK<&Ԗ;NNt)@СIǪS:ރ ]{9RZTji^O=T* ɪ$6~_"p{{{T8>M48E{JUFyqΌ#+&F3e#-k&a{eJ2@J!gEA}|P]ރ=ے`T* bg1ַ^/3^V V GE(*ժLTPQ(xO$Y2=,@=;|>0.j󉇢ۯjd} &1rr~W=gI}>4}z$jڀH=w78ωC\pՋs! YH_' `FedY=zǎ9d2LOOcii @8~8bJ N# #Ht( BY\'+J͸f~x[ߊX]]dѣGemm؆oCr6 Ͽu,-`mٵĈ6)`@uڂ3 j 9X5Yb5A^jG{^-au2yĉXr6M3u*% _LivLZ\7?' O@@59ᵍS7-DN{Icszy~PM^15iDp\~7'gf ̿h^K˗t{vLp-JAdYוJEo_i*ɂZJxaXp%Cj3Bks0557n +HҙJ9cuuu YZg T*햘.ÁL&#kB>\Aq\u:]c2Mb _zT(9qxݎH$"II"R*;(bIM™v *n7oZJh4UcjsΡC_u|S˽ދsڵkr$l6K^{Ν7Sk޵$VcKh4?!@?M fr^9`İHj@%y>i"{E޻$쟎wV~+GfҊ~ЫFb͟ 5:@"q2΄5ʧuGGGG /СCB~:"ol68Nx^r9T* ?!x;;;BB(˲Gm6d=ppYH,)O't:D"X]]GT%3ؚFFF055B c\Gx<&z.,psnZMl LslZ%×N+[iap|&COOE+&3ZZ@0hae?ă8V ^ d´ޛa L&mgϠ^'[.j=!6Mx<ttp AF/^7~|8_:ڻBkZ*ƀ[4qeZMMW0z\h\rqĝw ߏ^'@pdd^HDդ(#uKdnZ Z {T%cߗy&)Ϙf!HHr3xF3n^ 0l?AD"O_O`K$Jj^Qzz  Q,Qx|> ͊ş@)'#guJx&٬N{ N$/JΘ`0N\^z1:: ۍp8 ߏx<.ħP(3䅒&p8 -7-DH,$͛`wwO=b}}bQe~t_22VVVH$`2p8cqqQ^P&I4~łk׮assS6p]݌υşaע = i#L( he--X,"A2Dd3cS=N IH0dþF j?pRicp D[u d 8_&V ~ZǏKɤX~z^ 7Ui!W$杀P(HIt. 2ănzL1=70(XĬwAօ;fLLLj hD"dq>_|T NW\O;9?;s\F.ERER.R)P@c m;.EqĎViM ZVcVUvLKdQ.$Kr;;;^g,~gF6[ݙ{=99V.mmg=ng5Ro!t*OIO0<\-7^9>@c3'r1ad;<kx֖\T*k``@R VV^xi###LOΜ9c`ffFo߶D΀V1!>sHq<"֝ *6R!9Ćhy.Sg4 MQ:6'?I(k~~,Tʖd` d~{'?k9F&9a_}<_I7=&^ ϛdbOami{{[Ɔɤ~[ vU04^:VRQZt֖0D{$uȸժJ!R)uZ-)YCH$T*d2iYժY1XkVKhvccCLFjV KYKJRҹsk}}]CCCZ[[S<WVwSl$)jrrRKKK/n+Jxs0LɂݼyS333{UTY}ݺtVVVя~{>O_];wNW\e;55%yQzk_~Y߷;<wi-x1xB~x& t:5Mv>x[Sg5 w&^\[9#h9dr/!"NNN*LۚRղdA$U%ڮ^P(IVju +t_bX޸?c X^B844'NGQ6s=5N GbN<z饗\NO}Sg?iMNN%I/^xHXOH(z)!@@>W>~g~s^B="bv)"g)788hd2)I0p8l do =AjUZMdRDBbQ`P>\fi0XP(X,ĥDQNE"5 U*m9rD+++vU*0zXoxecccyɤ677MuMkkkvNDQA )HX}7nHe+ eN9ψe VGo$#ߑHDzݾe`OX_|Q7oԩS4??\l*HhhhHO<~gVT*eb>EQݼySkkkJ$Z[[=1СCFL_yݸqCr* R{U Ѕ 4::󚙙;" 栽 ] @bd`ﳢx pqX}+@@@"g?v/ߡϐ <")'G~<2/HAQ@ of4޺l6Og6>h^[qmllصbudlZ%'N̙36.>Sp˸~3/HpjKBft!MOO۳Տȏ_ޫŽ D, kpF?}/ _'H_тt]))Ro;=F  nw?}=7?) :ue"<"3[2Olxt%گoZ[[ӿZGzxG'Ҥ4 9 r:99i {C&_6 À DQ}ST^scrra6U>5I׵dRp8H$ZVbhRCࠑ-sA^G-$ /p P"Ą&'' UTTT/)j<HqjdUыŢ:|>ojccÊ2x6b8*JFH`a)LZFlookyyYPHfxXZZR$OOk_.]e}[֖I666T,5;;t:=j6 :zǏ̙3zg}MBA>hjjJ{~~I??aON7o~yʊ?'7|A=_]??=}+_Q׮]<`i_Cq}ׯ[:voomo:wb666Q~]pAԧ~T*zf_~VW_ճ>|3;~tEIx^ M2[QyvcݯEɂϦ9 ާ2c ϐIq/O c<2,y2 >1ʛ3b15 E"}v*Fш'ưl%)LQTcYh4,keh_akԔF9~WUsss'>a˯P(d}c>xZ\\`,}`k,;wNbQ@@6#>Hzb#?.cu:􏳗f~OB2'd j4U訊Ţ$)Z=QJ%Sic}:Bׯk``@Ν۷ڡPH{vvvo}2!YYYÇuMmmmYlD r|@?ժyCNI⢝w$4vwlݮjT.mh4by$&&&%ݾ}XE$ٙ:V/:tHU,vꫯP(##B5{ժN>[n_? .jϞ=kgk6zWlb m8qBO7 Iӊ7b1IܜN</IO<55ӿ֮/~QgtMCDF/;c\z;jPɾ)9Hmt ?Ѩ{9us=g$AhH]nR7j5ۜ:uJOVW)d% ٙN^Z?{-,,H?}QaI:||A}_5\ci{{[z}L˿}k䇨H{{?co65g~gԍJnk_/,􁗤K>D- Oj?/\XzCHo;bk1t_G290_$Rl6-Y^^x=\gH$t:mĞ ;<A2b1+@Bg#48A O OI$f6)}<#mX9 &cj۷oOPOƔMի]hbbBgΜʊUa%o6(9HXJOhssS˿,i_!Ɋcdv-q^8]p >Oٳ_7Q Ÿy%.ɬ^#xE`z%)y?I2Ŀc c4>=B<IcUޒϵx1߼ySV4ay,x'b~GQj5#DVߺ̓uB#^K.1Nߒ~Ȝu, $cF19tV >.PɨxCx׃9d1V~}n!k[ oO:Cɟ#.J*g# $\,xa+8 E>FmC qN1rc !Zx \\2BIwd{l M2k4`PvV^IK BVy+GJYdGHO1/3$28Qlmw!=}]>|Xnbr666 W۳3o~~^PHh7Z-E"E" [[[[[7d(ґ#G'NҥKcg5yehii e27A[^}s__?q訤}bH>NrYw3?퀀 h?PPX k|gOoعvVeL?-`\o/$_o~:~G'_&~u콵k{7 % R)MNNQ-..b`` 0.Ifd\Z` P5.$kdge f\.\./ߧ &ړnk񦧧ptGVX3>P[Y[x]zx=$hDŽyBȸu=!KIV"<1|˃~b8ĄY눹'p!9/388hIU5Ɔ~Q+H 2AJ(K2|uF(b3g&%tqOOloSh^ Pj5b1[x[0u]M|3˓ν=|ۊJ$:qΝ;7nXp8ܓ rZ[.t]w !eYuݹ\.)mnn_VT_ t:zgҒ555eXͫ}|SK/{/NEedbmg8:uJ=fgguIhnnNR8 ͙|.胃^jjD@;վkk>|3_7> ~__4O>?~Q OOt޶v@@ކ6>>'|NJv/}IO={1eY }d{-~KK~q/D x{nyO! ~G Ie`gО3v̋ŢjΜ91u{*+AD=Uҝ TQ,STe}`a%6v:wlssRr_dsGY:55rH$#GZjccC.]2 2 8v-ٳJ$Z__} T{ ֯Eȋ76xL'{tR$ﱔd;skkk:uƴlj A/4N7{Zg`evwwWz0!Ě$}GlD~ƅބ`0hnWD€o04%jqWoD"V}}}][[[&_"tY5 [^"FuСIBp>^L FQ.S$э7l)PHp<$xH^Wȇd5M#Z*{3_8{ƆffftIuu:V戥Qk?SЋ/h簗QR)ҥKfPy[E@k??AOoG~G${H>}Co{pM:6"d|@=>ݿӧOߟs퀀 mxxX/>۵Q=`R! 8^Z>뭻y'&ҝ>`灳{[RۧD&P_^rƸ!8xૢ]ƒxO(xP.SPPPfFargjUL"/j@"'LJ'h٬  CV%@ZZ׿ue@0ڐ;wNBAҾRXSt󌃗0y/kݯm=2+@tP_^=K%[7|7<NRJ *cbb¼^H(k=<"S^7ښ+E5;Bm_xgg"Ź cl6DR)eѣGu}nڵku}U75lnۚ8tۍ 2E#x<ݻV&kJ$65Ɛ`0KV`.E/f:taݺuH{V!1aok* T6/wS{Gc$=~  =&=/~7S?Oڲjv@@o޾!* xۯA*^dX@LbdY07K2t"|\ǧV^{zcB4܏xK?@xFL t7/v^zPijUŋ-kWT]Tl|.Nce4ր' @1^&Ă'$3 ΁8߾9e#H | 6@ /mqb1---YjnkcyeRi% w]wiffF[^{5?{kppPKKKj:w\O;nȓO>=_… V>Oꓟ|;ؾ/_~vlT,X5y5c@B@z^>.D,{QtFFF~, -Nz@Zj:.;@OKҝ43n}|?#s=OgL=e>ummmmh:L*ݱ"CL=4RFd[gfz@D8W󚜜gi H$466SNҥK2f2MMM駟ޞn-K-\#+צSœ>Oͬ c%O`LrqV>^8V&Q,fh4j2<֋$KJ`J$K?^b 00`k4=1 kqqoQ>WV #DÇdhF2el_$O Qk4Vc$LZ]3ԭЙ3g˗/P(h{{[fREU.Sղ8 wvv MLLyu)> BrdAxV^uϻ_YYŻr\.!-,,X,1grYXL\N[[[u=? d2J&۷UV U*SOiwwE%v~y6@vvݞ* UBɉV{0 kUs=+` +Xk\<=tzrwɤx %?{-,Oǚx."0by'덗0!,>`ޓ,(H(СC*zWtD 8u:{YB!6(a^Y^k$n >22bT65 VZf%<2|^}{'xjlmm)5~(҅ 3Ϙ ^/wt6Q/1"{r=`Kj~?3n$@$;JEKKKYSxfwRQ"P:V0,O`b=/fSJň^>XljhS⽭T*V&Q<Բ@H$,+kBGzZ~G\ښjRٳ17::jj$bH&&&TTzO4Ԕy O$ vrO`遟x+~s8u{ky&2_MMMivvVL"s ---illLJE뮻4>>r|;d2Z[[S Ą٬2nݺ9EMzn_ Ɓ@@6];ZY__70477g"ʩTJXLիWkzzZgΜQЕ+WtQ _Ɔݟ}P*zx04"HWQf0~x }Zg {_ZiYț<1cOA rbJU^444 0J%[BA(͛7%,//i찎ȼu u떒ɤa#OVX@u<%B$nQ1Y‚ᰑJ'OZ]]URT$ҒN:{W7o/X,fsktmr9^j||\?c?˗/+ 㚞?c}‚ #2yAhX/DB>ymnnZA#3dBFg5$K/ihhHtZN‚Ҿ}di;LNtjZu">ihhHj4ŋ7 K^qu7A;hv@@ޥiȇ~`%>I>xGꄇ;_ #_Zx)j IDATZb^dj˱/ |8vmx@_D~,z{iXѩP시\ḽV^^CfssSn‚]I3Reӳc걈#"@ nu^bNz2 ta֭[=%qVxbUyE"J%r?~\XL`Pvb?-8qBN׿uGh=%>8nYSȓgzCП dQ>ĄE^L<[f,H60OH$'O95VXT>?n^6pFe2+닙5dݱnYoxuhhHccc=dRۊb6*]enDriّB@ [nijj 5l ^?.\𧼁ߚ{ĉ=2WkZq;l퇷x@ޥ [ҝlXޣ3TIz0eQ(p#IBC |@[uGJR{xx>ÊMH-J(`gzHK6COwNg˘@\H%8$ t`W$ѵk4::j`:==S)RtdXMS,"{\*,OsLV-kWfggGOV8ʊ^}U=zTNG JӚ]b岎9h4~U+b{̯~'{4YH+|T,3ҸMNN*Hŭ.}CCCrjZ\\ t07Nf3I6&X`e[PȊH9r<%>FjppPjU}{533X,fdĭP(h~~$O͜PcuuU*Q: Ny8~lb XP*,n$V6 Z֯[nY訢Ѩys@SY*nܸR);vRn };Çfuu#bs`NpssS|ޞJOˣGVR(ɘw蓨{ͦ%X]]U0_KI###Wi?^cccַe2#G^kqqQЇT(t%3yV.mF_^=L de{)ِ~@5t=(z$\K3V8 ^|~y qqȒ DA&exdXxb&ϭ[L5 $YҧJ%~zzZ ɐ/pFMW_. `P\NT[ k׮Y\ ;_O{Oٯ y̌U\&{1 -ռ :w/]diQY b1"/֝tNjx''+R8H-7:ț ^y啞R EQ% -..9 m:b1X L MNNƍvT(2 GGGm{{{VbKؓŹ'o`kllLKKKicc h4d2JbkxH$bٞժZ${z2uϫV)+kllLy; aӱt:|fggav9x/P,SQ*22uJ%a;;;z*g1dxJvvvYΪT*)Z^^6D Z[[SVؘeam栽퀀qҝ'VDMl+dxB^Z%4]I|VKA VcyxK$X0p\@K_y@|!/Kxo1r΋:og^Rs``@=I#Ѩej6ކ-RӱdHb )dr9hNq >b7o 'ޢSNn͛zm=R,S\ MO@"ܿN(@ _ Ɔ5 Çͣu:*H嗕m?wɤXIyB`u2A|ȈѨeL zOx&'' R)+h E請r9KeuWwr**7zn;ނnkOzmUUKF-榎9H$bUȉg BJnܸMJ%[SSS* j4z>ƣRT  IQQƑBxvvv@0!8wG͔ݸqCۊFZ]]ΎJŎmoo u -..~< wixP"zKtd?2KG@5 lLP4>_ gdd,>xzB=8=` |p!C4松uø8da&<7)Xݮ]B97";dk"HhiiI\捀۱1uS~lȈ٬jeYZZR,S4LBpت9[ZZ2 xկ*L*J)kppR`>Ē ) /u A[Bj jN&ܜw*SC 8' )ƆA2ƭA` $n[@*R2)Y[YYBxPԃw Q2ill7cikpggGX+dYl ifѰ> ëAp}}݈%=R;d40R6JieeEnWlVXC(ٳgh4ǕJeMNNAlY|^~?QT8Bf$OxxNX Y쬝j&Yq{O2{,xIOJ& @ M|׏+g=!OϰP{xՏ9239gZTR4U*rL&D8Y4ScM"3<R!.aŕ&4^5|x@<?!+Ucy{dK|d{$$9 `HLd￤B?~L3Ȋk![g522b g"k:ޞRg!S):BNDzE"r9a-//ۘj5X0| YJn޼ix +ש`@9|1nWbQFFx8P%LRo1C%akl9^k ǿ gؕ~ }yA3'7x*Xae1^d¸k\p|L$$|ƁZ~!C_Ej޶"~271x=|^*˶f=|~>>`{2˺qya U*z"B!IoˀY̕'G"f ŠGu j4޶x1X? 1iGx,Sdjt:mKi hb$ѣGÇkqqQ F2;ׯZFGGJT.-5p2T4Չ'l6-O`o9350ccc6x8? -]+2988h9D"^Ib( ؘeCh4l!Go߶vv̻y@hV>'' !|X/Xdy ' @R*{ssuyAOr{|*Bx JxkzX=^' !D{ٰuǂw,Vĩ@ d,--)X-d%R#ĨviDB`b45L>*OYH=H{\=TRO:bl}[XCJLl6aúyjmmMfSj6=Z=v"s G"KkKV3iZ%PT`{/t'ΉI q O qJJu-//['~ ]2z={ _ Ú L[3eA#лF:xn쬭ZRcǎY?MddlȈuw˺{h4d@irrRׯ_:v[kkkF95O&D(SSS֖l6H$kqpe%Inoo۪j={huw:Sޞ*TMֆhX68rbQځ.m{0wz@>/.y^ 2?~/ {by}%y zQ?1= `hչG=7^fZ~ #InO<$w=1+?Vt'!ydR Jb@˛{a]? |F}Ϗw}=xx)q=q/5!Mbx8FFFZfk{^BJbW7+^H^j iuuղj5 رcOym !&Iv$2)Qkkk#655ez %vwwM oCM dH*fͳ/nkhhHjٳg `KD6LjvvV|^Od2iWng}* bye+=4Ԃa}@HDZ^^V@soOp.rcDqC`p?3EXL'NPZ#(j443i9Oe%Ց#G"|6-<]#d-^^CF?9ndJpaa"1e7LX11[kŢI:^7zFfd|5X@ ڧŰLJtόe8Ň6FZrժUO$:|^}Us= 5 drvv:iLjP~%%HɓZ]]TC˹jlOHL&ŢRwn]x{:8,c{^ 0tzG7Ep^22`po@"-%ųx0˽<q2{8a!: =`\g*FGG5==bhE 9ƤŃq"$nj)Ne9Ɔy:|3RR_ |bbjm ƵmiIs3VsxxXH*ficIwĚqm-,,C$cfOGIz1 , Z^^?PjmCHFQ\6aZU*<'xB/Vfוd knnNfS Q<::l{r###P&*FFFK IDATtQE[;Sf +(H\.xB8 BvۂӋŢ%$ .}v߼yH2A{+y6/zٓn:L'-,J}2>aMA@Nl&ݩe9~l. >tR ~xaq *@?n3N|5}lۏAָ^O{E$Fp]>l6F%I|^[[[F XSH<<g,xI2}:e p-/w@>bL !TĤOV5>kuuG#U"ayyb?JrrIfmR)'a\8bPHq{{j ‚:dҥRg^뒒kmmȈ%#kweyoJ%5Mq#W(y/ILƂYTJJKCCCVk>nBÑdߣ>#ipXZM###Z]]Ţſm7&ZXXr$YPTlO Pv:jj$ xt䂛v횭v{((y|v, ÌHa:tH`P7n8mnn\.+عK;dq濓V.mĽÃ2/ V2 v4|^Y@>s>+E`,ϬO@.>x Y'~>V\VRgN*2"WUT uOOO+^k{{{$c B$q/,,oիWub17 _2k0@P ^133cE<٬5?? ֬~tm#o߿o^ʊ;.H P(y{RI#/C9#s 7Kb^OGֱ*2-ɤUTUU4ɓ':99Z/W^5XRRQP7H"I3]}RmX{x/ +_X !ʍ ^D ̂D4*|H)%߿$\A?u;Yá!u$ /rq-^qtsM?X ^F?kBz4z/s!A:Q*F]D^6dZr .F*˶/l333ؖ|zjwww$31Unb߮풄\]g!~z5n ܒ샍Db9`-\cNOO&ua޽g7 1$" or'9Ab LLLX\{|?35 Uyݬ?>=Tr_[>٧e\zY/2}ޞZ鴊Ţ TBrYW\V*R> K)|=I`7^`>z=J%k~~^O<bNMMi~~^~b1H{'-.ϜR3c_#o4tzz9ٞ;>>eF= 0jZZ[[STʊņ/Ţ$Y8y`<"5//&bP$r& ע/y'FC%]VkD[~Nu`pn~5z#b̬D;s@_^GH,KW[[2BiaaAjUZZZ҃455ey!;^O\NHD#vl6&eO$0["P&72/bj6z7)^1q]vپvI@HjO^ 34Rt< )4{k?p>S>eH>p l^=iL`!EXxX4*s≈t!b|^M_8p/]xz/!3˃r?Z6"SRаC$׀|2/CU{>ȓ?߳yX C<'e,1\ǓPHX̪VM*\S,SZ5bGmI (w||lٞɤbYChv+kk~~^JbG+A%X,4ʕ+#)K2וL&jjsF-yS5I&Ls$ /36٘yj,SZ%|74337nÇ=J$6tb!&&&L;hzzZoVV3rπ8sO /^c6xζ푤dϊbW,/XH$3---fggx-HA t:FVr(v{=}{%\]gy +~y x}|yZxPeW޺*i$^VP@<.bc$x>B&]d^,z=m [>y^nAbb I)a/Kn =6z ՙX2x!_o|?N> ɋZ"Xɩ+c#ZHCO}U*#`bT*5"$\9+u3!*_Tf}6U86FVR?o#/mH$c$$% &XL|^LFGGGt:Z]]"txcֈ":(zPTzԴ3͛7}գG,ٙ3srr2| a lOđQq0Xjbț'Dz?= HD"lmmM|-B!KLɢw" *JYw{ *"& p88p8]vپvI@A`{+-EAIX,'ds1/Ó P"q@\@7.ԉy`y @U=:OK|_A=,~@ؼ|x Y|)O>o^IWO4{}_Ⱦ >{Ϝ'^~xcrrҤ;@lVޖ$-,,XzfGg->C4Ţ B`]΃hCa@>yt TX㽧T*V؏{RXP(Zx`7իv!N9'@e>`p؞XF-60IK/dAd@9c  DTDAP7Fl6Jb5JF ٱƅ':<^Z({|iiICߗd?+3%jnnNyM.[s&ds٬JgggH$ JrGU(lJLMMٺ0fF֩;451c LLjU{{{ S-AqM !!QF\3!DBdR'''weFT*eϭ~D"aDާ1l풀< Ase{/^oJ`># +C^I'H=&}/Ku"Vr^^S:>#?8bn(|0q{9⃾bZ\2~d6ehEC_ ~x` -DRo5\s *A!xmO^y7TxHLEԽ{T.mH .J)HVzWtUK+ǦPejjJLF05+qJ%HoHV"cvj)`0h)JŒ0L,,}!A"pxCC*j cP{{{fH$b{晁G3"$3~6Fl.%Xh4|A{'P K2;Xpmk? ]Ĩa̕t^ y<9ùmDԓK -Ҽ,X]Yw: }Z#} 2߃v*/?ϰ A+D6~O_җlONNZZK.D}vvfIw}3!q"[YYѓ'OT*,s$lx%p8T*e3r<"ΐjQ/,KPHz]<xYr~^~K307t`y`'C~xyyO}/,70^ ?==vmsCVe<f]qOבpVU Xfseѓduf<_˽jNd,襗^vwwuvvGG IDATzRA r9iqqQgggJ$,, ZXXcԔɣ E0`OD2K8`PW\Bx}HQo4#uxxh!p8T:V(lZt+Vl򙺼Wɯ7|zP oD| .RB49{C<`E2/E&'>x/'l=|{}qL~>%0cZLXz҅ݺuK@`DVBC055ehP(dS5vMf-EVVVvϫ\.+HhwwWN,ۀJ@$1Y_,~_{{{VDdzL&dd,tͫ>fzs}<.zQhs7JtUqK{Kl ӧO-.l mկ*փh4ojfWSVݻw%I#{=mcO鑘A=fpL"^\.K^j tAZ-N,jivvv^M&F#3h43U*u<3AvPc8]]gy) i4^ǭ^:9=.R^rN>E {$y2=/@?xB Aq S^J:z/%Z^*{3^jqnOngl333ׯ+ˍ1b+rTLƈҾF2B̟T*YZZ``ޓi5 J%EKzmKwh4 H(V)ٙ٬:٬ `BlVe Rͻ[&?ѨEh~~^F6`Pzݼ;@vҴb K*JU*df UB*U45/ԝ;wuM+2N4??L&jj _'*LڼJ%{4f)-o Ϙy#</| 4RGi-//}YմVeDY0qI<Ӊ»W'(LڞByC7elE{}}k/^c(p2,/Z~p @1OJa>1 ZEcdA^ABۏbE&#]?I#kJ> KtgKO;.b?5da^} s>3oXcǾ!F>#0FOn{{;;*J+bT*(Hh{{ۼ ȲZA{pP`z 632y}áU'=3q8b_iu,UΑA.}L$---)W(2!IGGGx!e׍7P7ֿvwwWᒄ\]gA<|J]`V'//p_abbbD-]xk<{itdtz'Ixݼl}S{J̺HA0 {&|f0$Rg mmr|'0:˾v/b|B&|w7N13OEl$ &xXjղ9% qttdYEQjzzRO+G QO 6wxpx^ۢX,jggG<sssid2vXL'''F‡áyKR>| )+Nk84jooςOOOU(L&c C1;xub1q>99it]x@NNU(hccC|^=ҕ+Wt-UU D"Wd2``yݮŢ?GT*o7xC?gaZUQ"yvnooY91oȩEƬB`~ooϪsS(Ν;Bfi\.!XB!#7j՞m$aKRl6Zf)dMI p`Њaj{{{$el/ngz={kαՖl2wI_r/gd+Mx9jaŘ\{(> XȆ܃qO?<-n P}V32 SIٻ~  c5.P/xt<?^+w'''M*{<<,>΀X9,dbeJ2C_x?4==c @oVj+c X``!|h(N[8D@t;Ln̘Zn߾ɉ*^dZ/ f)J'*kyyYx\*˪Vj6>ĸ|QW^5y`:V\ jt:w^ iݮJWx* Z__ښִb7BxooOGGG}VWW577+W(hggGz|M>|hX,T*饗^ /T*Zfx CDtAjexHvvvrl{͛7u-K_įP>55vd2iVOZ*̼AdZYYښşxё=HC b`.jUi6i??Oo~~@x\tZ??w=~siffFkkk7߼kB.= h xi nesJX^/]X[B/o>+3G~ ' $- /Ê|AXچËϜ{BH~YȳF@@&߇xOd A cr.@-xW3yt:{sk Pejx T05{yia'>sd%DZrlrp8l@O{{/Yl֎w~gV??/~?}_ﲽ풀< )Z'h؂? Ae8$h؀`نx5BG{0/볝l=' 4fH kyx[/+D@`Dyd7^ s/Wߏڐ!2@?O }L8aԸ__@i86O2Db=1`tdL \5`Pܧ:j*2jh4rUB _iau ҝ;wcmnnDTdڹ9J%eiqmmms j?I-//ksssmݼyӼCXUTdzOzzWuUeݻwOLƂ㷶TV-8wtrr^{MgláyR*49y^"D?Oḍ3#bT*9eNz==yDgggZYYQё*~PD"* *˺yZ byS1&Ql7o_֮]J"I*J?}P8Z?AmllS~s?s~$I߫ng]]Jцet8Z2`˱gx b`^`!VH*K9yYXFb02vƋN~ ؼˤX}r"nkOO3^_2=e S|NB˿3d*C.#OX2yϵDxiP!8 {l'~3Ҥp8ׯڵk&{ r杹v666T*Fb5zBCiu]T*iggG^ςӤB!KQJZf@ /ɤ?,FC|^?C%I]~ݬ`PW.S:!\N7oԵkהNMRD02mqqQLFnܣѨ`}؟W677͛ fl6khDD52H$b ӧj44/ܜv۷o횧CDTOlVvV =n+NZ*knnμpVK@ZMZRľݵg.q9h2}_,yMNNjssSz]\NDBlݸ?xGU1@ݼy4(D\T*&+JS^W"rJOf4=%YO(,z񈗼jٻY3<a#g?Ytzz9Ǐj8t/풀<[TT|xRf%{ǹ|q>!tK~Hx >`mۀv/xJLq,!,>,# MNxB臏)[s$`ۓA''~Aw>O/AXG_>:߾]z92ɓ':99K/5{cOz-ܷeY~\ov)zF[5+j+HEC /g `s&x0%c^XYCD\Frp d$^b511a{K4w43ɉ9kq-0~=xPkG62{zzjB!^DŽe=9}=?z>FwvvX,f{P&Q>A5ܜZIp#"ifggU* q%I}KF1 LI,RΝ;zwG,2:=55^hDMjUPH#AؓժZ:X,ǏkqqQPHjռ0F#y4٫|;whwwWZd{gzzZZMW^ܜ^z%mmmi0apOq< Nu-mj5[^fx<{jtM5 sss z>ڵkQ2T*p8?@db1~~K{{{Ї>jBW_}UVK+++_{.,,q;<džbs3x@ XPRp84oIJGPȤ@nWVHxɼ%zvvVP=@CJ877g߃8-,,R -NָT*innN\Ϊ3FHpxDO>pRd'm_@ۚS"@2A|@|*7({_>99Q"PV))()Xy GGGjbbj4M-//_V,[o3mmm]X]__T>W,Ɔy`/X1}_?~7|So>)HQz葚ͦ٬nܸH$bq)ӽ{H$13@@x\Ir=KL^ɾ4۳i8|h+!Ϸh$Q2ɤILDQ˜zt:Ui=|ЊZ-)~zfZXXPPI3TEQ5 577g$X"/3eR45C`0PP0399ׯ[)Hl?W'> ѣG&+;==ёVWWnfD"}#я7Ύ(4 jarN|^1kȏ%>Mh2*y Y|d<{fr%I#=\Y#>{t|_<':%]JHކqIdzO'S~!+H?'d~їI zFn s?33Zf@ M<: d*b Cmnnv>Rz/ժs [o)]~]'''V#EE!NFMH$J ){x~@ JL[*X,<| II!T2Ą>y֖|>iI tmmmYƫ=}L L}R<߾}[r_k>% }_V4ҒկZѣGV̌*eP*2bCH$ZIU*K쓔@ I,Ν;+HL/--r9K\(#311ygZ`0jRfӀ.)K666l/' UU CF?>ѿjsbbB]_ kggG'c~H333_ {qپ%yF/e, %Wၘ/G<VeHHtg'/H=+X ǂ/i|{+?i ccN m\ɸ}|%O;_X!¹N\_ke2/}I'O?s=7풀< 4.y<`Do:{. t2= 0X}@HŸn`A ,{IѸ†5Ǧ?X y!{B-^" \2Oڌָ'~=gOR4=W7>XybK $V; 6*=/Ofe~~~k0\.jjY+x KRFGV󔠩TJ~Rrmrbfggm3_0+N=k_W(2};;;S2K P6U^W߷w(@ԓJ/wnL׳ /,,XjTPfddjUj۶^^FF_!FTHc*ReF񱖖trrblrrR'''j4y}׫=x@pX{{{򗿬۷oRhiiIz74 TTp+ _ ~<xH>}jHDGGGvZYYQZIA:Ї>rim}wzzj'7HDKKǨ,"\;REۋd#x3 Z3qmooK:3g>vVWWu-}^Ą_ԧ,F/T<//S?W_}uvI@"K? 褋>4W@ w">Bq[9qs^7񈌃x̓v1xCDşz 0.PO|ƛ'P|KE0}8y5G8qI4{s7sA $r8Z[29ML;cI&V&*ߏkpzz: APu p1Pb1 vT\e=zl׳w=BU!'|uuU|^O>U6i`&6+Ib:99Q\6CF&jH sc }yl >rh4FSSS&/bH˼gYX驦JY5MKG T*vV믿D"9}+_ᰎkP(7qHFV3A;ＣE(Lg( |jSqj5mmmzh4VԼlV+++&=u-F; 8}<&/_U<ڀPoaEC_M.\ۃR"C`m`Kt{9?[g/fk づxr)h9g~w#CKƽ22qu]=1R' l/a~mPd$o~$x)wAI2rIvmzI@; b|j`nfff,P\V,3 WWQg?k-8vo\.f+WX Zf$x7nP,3/b{l6JcKsZjC Z*EMhvM^FG0Cܧ9{I<@y9;d- IJ@{Qdlނxu7蓗2I'0|yи5d)a>{c'v\ 륁 Kz a6SSSXx܊=6 +}R``$!YUmx---Y^5^ 0}#vl6ABBIsV%HhT !d G&h4l6MZ- TFh4t5+T*o  V̌y0RxW<ϛ|y'{r 9qEZ[[ӛoEQmmmի4p~ɤ=z=MMMY0T60TJ7nܰO<ꪊŢ8'~_bQn Yv:5M}kZ Z[[9`GQ "b*VׅԽ^OVKTJLF_clT* J&Vɼh(N[77 C0b2yػcO 穮Ip.e%yFAz+o!h_L2>NpP^XOldx^ >'Rq`Gw` FzA:^vysE_L<@x9x⏟2 }NLyb)nkVi 2@1^ y'6\O/pXiinsX!x2 FF:<<T:@=AH$c]~]fP2`skͦD7 Z)֌x_T*#ߣĄP(d1# BV?ZutHS*񸶶u]hvvVnW[[[zZZZR.ёn޼`CUU4O, i}}]B,NǬ@`$fazzƁezH!(k{{RVg6X:VeE)ָ-}w~x C fouݿ_s}7~#Lf$vvv]ZZR0x^vmmM*& 6ڞkJ$ɬP(h}}]O>59-R1J%KHX;{Wz`bAyw:⹂Tov魸l*풀<- YVq$G3Л.gt"#ebns^;҅I'3=c*`K6r 7pxzR:x 223 |8c+^ϲG411 nWj4dLO<"Xd2iN }rYmѢL,Hl65M z~~ޮjl->|Xh4E[Ǐ۾!Psh4&Y[[3O0;ＣvYr9+Fuh4)% ۏBABAnWZ^^>|b],-*e=~XGfZ*Ni'qvb7Xl6kDɉHaCdH~K2y]zU#~~H75 Gb moo_WK/}sښ>5 L&N-5Miaaa$> i~~^y۷o[* innΤa V_ X2C `O!D r\1#㳠!zO8X{b$$~1n[ c(~UU6nܸ}摡:t^TjuF`0JR2\j53zТC>'''U(F5;;r`-C^0JZZvi uE"  )wZ^ytt@ k׮^+HhssӼSOB"ёju55MuAGdƍ:9{Yc3r9ܩuWUwW n0ˆ bdLE2, l$, Ԁd*U9gsdd_~'ODT{F}~<<906\jɟIimmM,k^\\TPgbooOZMH*4A666T׭e{oё5fL&R0ԝ;wB`FP'''?K2 >һZM??W~Q_kTV3}K_oGi}}zg`mAI/lU~~tABڇJPPTR0TR1"o:>>⢭Z+JFV{ѭ=a}}]v[RLU*t~~n\}3:~٘RFCfS@wiiɚJM#4ۃ f-2H|??as^Ӈ~hr,䞑HD_nFjj^Bͦ~wW~_oU2k6z7D~b1B6/KKK裏Tuqqa '~F+ޞ?~۷oݻ:??7 ;CƻVLGQqAmllX3KjlOM(L񫫫FrWWWh4 ]7*j47׫u^z 2m>~t<"?d$^D|U@A4@l6´' IDATo=i 2%8>Պ~/"B !4f|'%H!H7 > ,醘h!t9__{7+geWL&3&(#x822,md0{dVWWdLtJb rFMA>cz=={L{{{T*V E^D x_]]߷s;??7 Hx,ښ S*AB:j5 0 z\V(t]w뇇Z]]h4ښ񸮮TT2 ɿ7~7T?oom߾[n)O>w]뿮'O(N׃,'X`aa8R!m8R(٬h4mtB!} _PSXԟ3|f2P(hccCO<'%J׳AP},$g=ؿ"J߿oH$bF#W3 ysfȪ$Vᩬ /@ti k ^ļT,1;guda~84^ʄyB#iP#ܫX,fflQkA} 71yqi H$4-2+]Kl6#qr9d\0tJOӪjVIjeeŢ\GT2D@ຟc{FR΃ɤu0~"mAnϖL&n-0@T*g;SW*A2x<Ko썍 iuuBéVV BV g=,:;;n*xR9P )DɓC_`}Tz: .x2FJ&{=-,, ++oWc/^\YV5zLc&G\ᓩVcX^*$~zn^$"n$2>OcN@^X$ 4H馫8ʶ6|(/ Wc^ 1 =p@ZS]g>yH7G!\}+x߉7s ^,Tے4%"σn@5R8-R>8:OpNB牜x8K\'pE87Y扢4ݏBف;Ǎ qxxL&T*rlB2U ;6^$?4c*r:eX=23u2=rټ 4a#H`PX̤AFu\V4x<6KiYNG$F홣@qmUK:??7L<7@αv2,EfDLR>Np8D"Rh4v|>oP(h4j2 ~ZZ%@]\\׾5[ &DuqqT*eKJΒSYY3졭VKgggEj+_l9??W:V|mq={LuI\ x\+++*zM>֝;w̼{lEGR"U,1D-[u* 2L  V~"@ Ǐ_]]5N&s...ocN@^eI1/×pt9PRٟy(&n˸~;X/zt.x7x@@Y|qm3\' YsYy^$endH3,1"Ƶṙ~iƸDBHD'''V1`9|E>aӢH7#< %\Po( 0iz>#^jdĀENOvx 1|(@czB0K"#3>S!n{2<}.QȚ@F@K8/4'T9\? g <\,|_וѨId|&$U\a 3\YOA4r>]("" )B'^^^ԋsd =/X#\x<6=C<=uD)id/xR*ax}gL<;;;ct:zdR"RѨ?~ooݺeAzNc|2Ǭ]la#b1*HXGu2&PL0ԣGX;ZYYQ8>(H8*z0+phh Iw‚2U6Xd ~εw:R)5 z=*b1oPPaqqѺ#ǃ`wcr9---X,[Ï9yE 'llT9䁗Ŭ]Cn<@{|FwQYIЧ#皽@LU.#Kf̉z9xp99""Y#Rcm#|7Hȧ}u{{DPgZ q0;Ql6kRuFHD:99>ⅅ~t&+Oj6v^OMU׭쩗!W!+ qasipzh4jٛX,fRNcGA!XL L&%dDF3KLr<)@> )X $=f<k{{" issS/^!O_ZU^ݻwmt:F̗e(i*+S.9F.tTVH$t||X,fP(֔d,4-3M3 #sɯhd=[YYe'ͦ,x...T,ǕT׍x"L։Ve}eFfF")?G~d2Nc F;/q?cN@s%MXl/ @tY+TmxP3!%^{ f@>ɘ Ro_'>C?=`ވb{7ǜ~JoO4<@45| '+ B~{񽔌^m*2)W<7=Y[[3pyNVX"[|6PUAi D`!R(L\.lWCb@Jb~7S vyyi{P1ߟ۷ö>l6rPYYa^!@@TJKKK4pqqQB \EQyZ--,,?֗e}+_5]L&U=$ITJXLb2I  䫫J&V` {.},8@6 x8Z7=>1 Cnk}`7qA!HB=gu7w΀JӶϚohsnfmd-i6b1Sg,Ɯ0dž? @G}f&YjcfdI^jĿ+/__0.iBdžr^%+~-,..Z2D"X,gϞYɚ$ E'd?cNjs"?"d\<ɌPez}lhlB1{c9U@LFgo\y ,xجg8wÃm8G挌i 4f(4xJ}8~=c.A`@^ h?H>x|]!hhaaAt?VKTHٴh9Y $O|, )gA`;1͏ZcoNg崲s ,..*n[=R*2șY7= sc7@u<&@'sH$bUf=@NI0\]]JC}&< afd2D"F}`08?ǏǍ깿@VKHjۺurݮjɠBn߾m=NT3 zf&_|s[A%+EQ1=d.[BqccBIX<7TZfYT*eY\.g+D5MSN1πi +:x(2yYPw~ZU N72#ISh3 |?9賑 Fkof̝?7?efL?H sFz p\τxُ'pD?f. &c^4kJeb-VL&ShVG# Ywfd)- ǟ39k  YtxT%L{9!WZQbD +k:&K1lBXwH <[D3:U9r///uyy#;/9^`0h$9CFq/!q_җ$IfSHDgggR;InWB<6,,,XG$aϞ=`0P.SRNV *D " *JR-++joodᰎRլG4QԅB!E"uiT:(>wlE#XJӶX{gH&Fc/1'5Y9yE{8f#DyLy]>j.gz?/0^8D)W 2)o.>[#yia>|õs>Jz]<P}ZdlJ$2YƬ P/Ez|K}<}TʢhTfSkᰊŢ}l s9O#|ރkkk[zA=?zYRdwp^] LdBYfH Q*D}f̹%e79 sh}{ooGl>h1쇤搵)O6 @n>lDץ >4\7j>yJtZu̾\.\.'Ij4z뭷tvvE=yDv.׆) D } 0#yr{| {ْliJkggGS^W39 =$B+6?kd( i%LFh^[ĝC6///kaa$KdM0oX,fiss;kVZسgϴnI@ ~  WWW׾h4>@FCZMeg81]Wb"fiiIǒd(?U*[H7t?/ V |&F_}))bLixa ̋{fP˕8Gư (%P(t:Ǐk<Vi4Yf #,@dtrrO>DJR02#+5(cizwMitڮX,fr%2!sl*h2677-s#TwWVVt]]]]|.hyV-A$Kd H&9z`g*HXY5˩lZmZU,6w-+TDˆsJc>3J ggv2 m߶>%VKt"ٙ/LFn`s`9T2P%8rum{F#OLy<w ضm_X_tpp0ehl6`Sp~~_/z`EvqzzjDȽ^YYї%:::Z;7>:MĒ,`0D˓H,ο^g= x@ yRIϵ}G"Iy:k" \3sMZd˓NϑE|=p8#ւ'f 2ht< 666s+LT*eҽ`0Z- Cq,R%6)JY P6UޞnymllXRZ P"PWVSѳgϔJ,UTki8HX(FH[@zx򻹹i,M&ee2{ @5{nTm3,uu:z=5 Z-kVY'ΕL"~<k}}g8up]\\|wm, yg}oáb.//UV-Cu/Z_]@F!fx<|1{ŅŢy ֌l#I:99ʊnݺeRx<KKKjViEknU.Rv3yU2j427M{&@<Ǐ:}n%O|>bjh4j|>l6ϟs U*, bvϒɤ3jUggg&C%L*H~ʗ5Zf*Ǻ{^xaفl6fi$*͚1{0(ϫl"Bb9FFvfD`Iݶ_;L: b =2˩P(hqqQFZe(M b:99$֭[*-zj ?F#ݾ}۲_Nm H$R\.L&3ըX,7jiwwҒ>cmoo[~"@{Z_1Z l֞'\Ex b:88?WcN@o}[z'1r\˿lWB(|%/Y"b 5}rF}i) 1vR ݀u<=|=i:xZ_'?G:!l\$!hR0++^Gؽ,@|DD}M{y$4փEI2"{O A",j cfJU*2@'2odFmnn*BV&iaaAet:e' E V$LmB!OE If _ZZRPP ɫ qOʊZ dGfie2n@fBÛFqpMIҒ?#:Ȇ4Mv[KKKv=d2%Rg?H'(ջwT*i<階{I*7K3׽s~6?cyE/~oR$"H7gclgA; y҂ x20ʀ rK}+(pdD+^2'\oAbwFh,x@ˣ|g~O#S[d2˂qMY(̼‚Uwa _X,f2⢺ݮttt qX"dĆH(~ |\6;U&;0puuUGGGSw A$̷mUUeYk6Y0RhqqQvۤO<[@6|Ph2X5Qt:m HϺݮܹcz{h4jR!%PDg{* |D$GYB!UU={̤D}@1%``Y62跑NG۷ok2XVʲ]E!;>>-Y!i7U(~š~FD"P(d9g2([RkD"JdEh9 @ `ðiVdTT4h4+:,Ɯ $~=L&ɖ4\Tsψ MK xtK5O^8O^:'D֑+o%x#ìi/ixD=<٘ dc}>+׉^@,`J5w{{(XS[o?}7eZi9"ܫrl*kݺuKpXgggE"mooXWWWFT*z2aθOv[fSDBd0`\^^j4@# h4*)tTdGգH}jUj~B=@"0"_^r;s5|׬[H&~4Y%*L%`:N[I`g^`0PT24K\.gDt`0Н;wl"ا[c[~GY^^V۵迏C![^ObQ[[[:::9J$v\ ~Y٬][&9.:H 9͚*U ȶHפ"ٍU{Υk Y)JF"#"KbTHFuvvT*L&c8l6F2.gxc>9yE-ȗ>j@TĚ?!n:^r$=WZà OxJ]KJ&H8'$Z]]U.qbѪQl_ 0{k/0I?C!{SƠO{+}k511' `Yy  rpt@x3t"e& >It+,戟}֜3gZ|ės%[[±]/g3^|jW|:^:0|$D"ʮYXXaoR~@3Ph4߈$&hOiT0l M!0D-눍)ڢѨLb-x({0ǪVD"v|@!c<H$B~>A2ti#y0y{c/L-jggG:;;ܾ}ۢ͋A)xzh4BFRKKKe=b j49(2eqj5.Lz=%Ib1Z-j5 ˆPŊ<%]CR2at*H A2PȲN?ŢFBjUO<rtvvfAZ쯬H$kq4U""K$z왎lߥjh429{E'l6kn Q׳L9.^BsAVL$uX,f Y8V<7>e !ϛ\=uT ɖ>=#>d.Ǘ`#@?˓ gO>mM %\~ipf {/|}&g3"4C3,B XZZғ'OL(C3 trr-3f\.gCHrF#=p΀XjEs,--Y3[ՕvrfBu0,^ v]+ KRdvuueM1(IDATGQmooRXq˦HJP͈ Ă5& Ld-U*Hb%q~PcHt,3J2 ZMVy > h4 ƋdѨܹc@ HDCE|,<|*˖ "񾸸Tpɐ=ҷLX 0/LՕɤ~7xCb"+ay}#0\Xz-ߐ%IIR* Bz!s+++ٙur9eiM1 Í9yEq^Y_lx`Ч=eŚYfygþ,&K=\"]Mݳ?7ԭ^ ?̹p^KѸ>Ox2#Ȁw>En2NUZ^^HёEׇáR6y{ $Z;D;;;b9;::`0 :WWW:::2C.IĘ_0J`0P\֗ekvH F1%c-@d@(  -Κ ᚮ۔3fqáUr5ys7W@*ƞrDIo§,&eDx\T*:991 𽸸0_h4RPBVLx@4U&Q.S<t F} fLzjJo!]XlH/B!eYW} {j @9O[}mmmY${$AeY8!♆BroD Y_]1K*)908kr!>Muig5(=dAQ_/s3 ys I7(h6c@SX@E ^J%TZY~ȗnAI7%=#*^ as'Ǔd ɼ@`~{B|g{}߼?u92.IfP&5ѣG{S NÇzXdr xіd)Z*LKJ...NM> LGFL&ѣ/IE$X:VXT Э[TTTVm]qg* =$3+"immHc^7l6-; ^!9=={)I}D82&6<`E!#pP|%.8^"峥y@8]W~ b/..;R! x&| G"ۃ `T:{뭷tzzjի*666TVs[8RLe4M5Ƥ%Y4 0@=r+(%I G9OI&!B7# eKgw "O '|Ĉ'|ϔ.>ϼB,8 ,t޼=[]]U:2M3y*G!OE!WWW:??(<4܉DBx\,j6S.jkkKV w٬!GܯF*C{X,zK=R8;Ｃj4Vn*Jpa-,\E?~l\~3hj6vOgL&qP4%xXmD}i奥%I $dǤD:y2Q{$Q.S3υ@EpXD8._g+Nq6IJ0//{ C?oͿko9cgr>1/_ @N^D?3Q9LSyi2{o_/ ~X_D,`&IQM߉?wߓ "^̽7Z`(voÇԇ~TV-ޛ ,ʏ=|tFCT(5nmtc `^\\T:h4R>驑nkMx4?Cv]qmuN|`>kS2xܪZy@ I\XXPZ5JD"t:m=@| kY+ M5CɤIxR 5$I$VI rNT> )sذdRo6L~|`ӧS)r+Y.˒t}Z-U*H2TheežfuGĠyy6IV {JZ@zy;,A@y/Ŝ [}.3?K1,ښTլ %xٟ}4LTGGGJ&~j~;;wc?sO mUx;o/2$j,&}#Ή49/4|z%Rӛ=Ɖ򶼜glg pn^剀h R7=?8\;F[tJ&^ξz7JҔ߉Fm2+ݻbOZա?>#---iggGBP( B!=Q6$ B. rֈRHD_W'( *JYqHZ3%IZ->-RDy#|ufFax4EzssSu'Qe‚0Q !K&^r2y1xfSKKKRXԋ/li$ /UذH隗q---)؜ܾ}[FC*Sd\NTJ7IY@RQ&Q4ih4:忪^16g2[^Ϛ>777f7VYT*Ck$軏{BKϞNcUO>5F}dZyMV:6)hٴ&$bd~د"3+c 7xV4x<ِjwsI%jmɺݮ헃[F`/{Ig@/b??grNsċL\6"^H'$NDK^%JTY@LT X> |'/D"agɃt#ϛ}Dc~ -cy pߙ+^{a#՞ن=Sjrl)VWW[oz J%uimll裏>R<W::==5sq^WղJ7= x5J<jր, 3GԚCC-..T~_jU^O;;;Sx*Yq߸GfSl:$YD >hdfL&Fd2+E'bѢDE˚0jZ&Cryy5h3D67Cr9cy#>51Oiַf#PpH$l }h\.k<X,* Ac@岒ɤU#ãatttd{$ U}NJbJVg` z왢Ѩ,:ӳ/[T8 DNULy93zD"V}{/͚<;;`0WU} }+ɨ)J9MŅƂժo0 (^u}h4yTp8B=@&lyƇ~ o)Izќu +6xQ:$Dc;>3^}$ۃ}G "uuu5eGV:^o1L,g|fœ|c'猙-59&4#‚={6Ef˘|&D?V.ݚ-//w~wXO>5D'@*;J%3B:T :;;SXT<W׋/J#}°|uuT*%k}. C I ʊݗ@ `%v={f>@P P2d ,ʓ@ `f 5Mk C~fd>/B@ ]XX.l6Ͱ k]ZZRѰD$ꪶU׭= U*\YГ'OOR(\B !$T*:>>ֽ{t~~n}@wkN&*JvhTJe A/WWW*J_}I$:<fG`'Z㥏oӘwΟ1y߿ot=oϵ__?3?|y?S?__ޞic>c>c>ԋ/S?SkI>|hR?Ŧȇ$e2Orп(|&2?c?7|;\ww}%|ih1111Guu:~++ol>>c.?iO?jZ{oSMoc>f\51111v/ſЯگV~?e|)s +2:~~A[[[{?Os9:?'7\.`0է~w_KIXLTJoMxS?ݿÇ;w[HTmfBw,0RTEEE*aE"`BSvQ]dA*@TPt>\t2K0ş6;Ylf3]nkΜ9:o<-((9mx8q$$$H~~~xaazJ_E?ůPuuuӧeo>\ĉعsׯRXXtBQU9ydx6eB\.KssIСCr%ٻwoȿ9d Q@ѣ-"2n8yA$G{tvvCƍ'O|*׋SKK[Nv!Æ '{ш{NCt)*wUk].W'{<rJ勔ӊ+tJbbիWʕ+e̘1RTT<F *ʑ#GdϞ=2qHoWRR"˖-vM6ɧOd֭رcrisN 8jkkѻ~d#㟵eY3_JggSL 瓲2)//b{'%%ERRRDD$;;[~Y|9AGGZJ֬Y#>؏SKll,J<?^=z$AHl6rH߿ܽ{7d޽{2j(q:""\ky?|>ڸqc3i$/_{ʛ7odΝh_555'xOl"!nŋ%&&F= *쫱QfΜ)n[~!{'BaAٳgV|8d-_AAAId X8I z c( 0 c( 0 c( 0 c( 0 c( 0 c( 0 c( 0 c( 0 c( 0 c( 0o=mIENDB`pyepr-1.3.1/docs/images/modified_water_vapour.png000066400000000000000000001253771525260221700221550ustar00rootroot00000000000000PNG  IHDR V%4sBIT|d pHYsaa?i IDATxy|LϙD$BDl*XjR.Z%.^ڪVCm]EUZZkIb 17ad̙$5ss|3ds<*B!B:g B!(;B!B8 B!BD!B0R!B!F !B!H"B!p)@B!#B!aB!B8 B!BD!B0R!B!F !B!H"B!p)@B!#B!aB!B8 B!BD!B0R!B!F !B!H"B!p)@B!#B!aB!B8 B!BD!B0R!B!F !B!H"B!p)@B!#B!aB!B8 B!BD!B0R!B!F !B!B!ݩSsP~};F$DB!pQNA>ɓ'#B!ʺ1a##H"BlO> gB!3n6'N!CށQR!B8"\"B!p)|B!\<%\Bhft:ڷo(t:: .~]d2۶mC1u"kO:uBӱ~|Jݺut=zA !JGo3H"Lhh(~~~:|tt4( [lɱ}ΝFt^otؼ=K|۲e qqqtЁM:"4!D)u/"A !fE[nFoߞc-[ѣ Ym=z(Vk2d*Tয়~իy*PFЄD ! grYzE.] U1t:HHH << _~e9####~7n`͚52d"##8p u___y\ѭ[7t:L8<==WӦM#3336mD޽ӓ 0anݺoڵ 8SL5L!D%BSYEFtt4aaaqN:͛8pZl իY`jg_QF,\mr|IX>O2%UV~#Fg!..3f4i}h4渦7nбcGyW 7Yw5.\ *ϟ[n7!Cyw<נAXx1_(L2;|z͞={8p o|tЁH-9B-_e򓜜رc ˋVZ|ټy3z"88OOOѣGpwߧsC-IOO/R QBcAAA^W]6l0bŊlV<*޾zjUQum/^T322r^WGmվuVUQuԩƵxs[m2e(:w\vEQTEQÇ&IPU]v(;rlkڴԃf藞nnn uUUEmذݞvAUEꫯT777bŊS5zhUQuԨQVjRCBBrɓ'۷oj/N΄ۿ @]ek\߫W/Om۶FREQ|Z|:n8oUwءYFݻ(_g;|W{u֭ԩSU///gϞv͕(9BhSEQ춠 WUUUf`Ul3&GQf͚uԱj+y衇T֭[9F5 @m۶U(U1UX .TEQyݻw8W^V\*.YĪ={m۶aaam(:iҤU۪85gBe s@ל| ~IUE]lU> Lzj.]޽;{lUQu׮]E:p 2Hݻ_e ǹ|2aaa呞]m۶}lق(9DFFr!(tL))):tʕ+'>8q"G{ڵ (<ӌ;UV |̙3󤦦ZmOHH<]vі58sZbΝ?~<18[ٚ3!DhȚ5kaРAV 6{ҡCB`0p/Roo\m )څDgͫWT\ǏSF իgܸq|GTV}f? xb ͛7vӦM˳_nVZۛgy tR^}Uܹ÷~K6lXvX~aҥ }^O\\_~eG+ @@@ׯ_ndpm~Lͅ زe Vߪg#TR~ի|4oޜݻwS\9s,]H1e} e߾}Eڷ8늼K,X ꫯ7ߐ‹/huMHLL$22QQQy *W\zVFׯSB춬\tƍ8֥KeFXX(eܸqK, ү_?6nXYt)w??ЬY!\̂%p={*7of۶m9jҤ +Wf˖-<9 .Y涊ziڴ)GɾZu3gXcҤIܹs'OۓŋGFF{n!f!m^9fJrˑ գuߟ˗ӳgOܹsNtt4+V,5#XB*@> >9,,+Vp7nl5n 00~e˖CѫW/nݺŦM桇` ШQ#WβepssF(?O͚5 g̟?uһwojԨAbb"qqqܹ#F0~~nذa`Ν@λ`Yd a^ۯa0w6:>ǣNL唹Aׁ'j1D/؟: v:8\:t|>^1Ճ1ӎ=e _3ٿCpȽexn, f)wijGƜ)68Vak~]wgΟ̱PMב-=2׾k^bܜ Щ7<|vQ"cXTJcXK~YJudcضҌLt ,D~B8̂_~(Ɓ,[aÆ{nڷooOL m}vhb8 [ kXtaOl0.eLm_Iz۪ˇ ~/l z73/R(97fl\v)ށrFcd~Ќ 3_97t /k~2Mr-ɯ\9{_6\>sLRY补 sPRIf%5Oʕ+### ]vmp.@E!72qliHMN<(ExX[_mI~(,Ӈ^z+pC7nҥK *aqT Oq\rΧ߄=WvvX[_mI~5׃f@&& z]]_ ,Bq0C> gʕ+ܹs;wn$a1TjmJ?ɱ$ڒj`-]*@ I~,ZtvC.nij}y#kK-ɯ& zp| K3T=ܢ5E9'Dr-ɯ$ByRH=MCFkّoO`*7<ꂹ:lj˝PY"9֖W[_mmQ`RzLrΎB:A-kDM#Cuwv(B!l]P '`8ّ؟n^ЅE&n{ !p>C1^B8\(u:;;! "@Hۜ@>rÝA'9֖W[_!<)@J`gP=t rzCGPY"9֖W[_md B/K> ']Tj}0D[t0jAӞX[_mI~VQ_̜%D1!D7!RU/2p.B['ABACDNZ[CBa: ,pyەH@@z+mS^I  Uuz]peN5s5.HQ;rN`eX[_mI~()9l* FՀ*J}Z^XлY^:;|;Imsfv t؇鶙'~j;ljʌ.9jK "\J$Xn>/(qP*ձPsh1/j96eM;x{Yh)22FK\%j͟j-~˻>;ˣn\W) `|H~%Ն.D ar{o5c/n£q?3{r\<>g#%+#X 6 ky6:Tm5:;J0WㄹF5?Zzhz3\0W.f2V ͩB8Rrr2'NdŊ$&&ҨQ#&L!CoժU,_+WHN2e ճꛖܹsꫯ8w˗'44I&ѡC-/O8 %үgQjfMrv%oW?\mB;U2qcE 6-c>0W*qK;XA-ɯ642`̙3iРK.eСf{QYfQJ"""WL>PC&M1owyݻs f̘A׮]_h۶+X IR"wv Cf h .ٰfpA͡_DZ8^c;bu`ںT8aj >> 4Ȫ=<<ݛAAAs…6֋;@74 P)J.7T--$$ypRqB!HG9BƍshѣG4F#66x `7`޼yٓ0ywX"F* {9hQϹp8nb@Zk'oRVR#1P楏!lʌBƍ9go/,Ȉ#aܸqVۦOXƛeٚ5kM:e2B*hN (WիW+1119гgO|||c,I\d;qh'\_g\ƥ1bیm]h"vcmI~%F ^ l63rHv͒%KoG1m4mOÆ ի>@pr,Xk7nM6ڵk}τp uFhh(+V 55:w o1=@c\OYCFGD y~|ՙY?o 'l'9֖W[_mdGTu[yTRw9DUUFҥKYd ?Ç3w\f͚śo޷o_4io-[ }WӧO.@"""bڵ/oժuԯ_ٳg3cƌ|V `Ύq=8eO9q'}wUVI%ՖW2uDhs[hATTfjÇh,UU_$22E1lذ}= ?ln*z IDAT0hѢ;vKG\r4n8{Vڵk8p`vXfMgqix䥤^0Vv=v^FjesUǝTԞX[_mI~#XO>$ɬ\Ҫ=22`ڵkYw>"##>|xjԨ={Ӊ.JbnphѢE͛7gӦMdddP]F6/xDRGԩ49;$!LӧzW^ԭ[(6nҥKQ#Gdbcc _E1b5kfU`xxxЪU+:vHs;…^{T}]ެYDUUy&ӕ^2>¦^$9(Bb HcռDDDHƍYlc613X]EQXh-:fڵ@Q~gfϞ͊+={6˗iӦ[޽{pQGiҤI|7̙3'/v:뺭Vg*z왟pA g:;Or-ɯ$hr1w\HKKVŋ1LԬy񺸸8L&Svqr+ԩS9z(\|h)>J1R SN>`YBdqDE/GU'%r)ΎkK-ɯ64XPM:55amuˋ?#~~8 DY}1oro//\/E0=붔TK]YG} 0d4|mv13b]Ջ^GP->@gxXeݖ|B_-};'0{u[jo.uQ01'44ԡ!e}v?BsNYW8%vQv#XEɓ'ӧOcڸ;$m۶L0!{!*UX-#JZB!\FЅЂ E5Æ ذEQ0L4lؐm۶oSOa0ѣg.ʡiE/'ZzPnp8 (J7ɱ$ڒjCƀ"c@h֭yU|d eӦM$''ĪU )#T42S!8 Rn8;F/A!sQF8;Or-ɯ$ڐ1 …(d8-ܹwA7vJ)y<wz+\zMJ )^J?ɱ$ڒjC.D ɱ.m} $A8Fȸkc~~Nܡ~jn[L>-ĺ~\4v\4 #?-r2 )7pT{[$)G綎ؒٝ~n먭;˺~6Md$ڒjK+D' P³_fؚgS&d@^5,T*^2}+0"+@2O׃F+/u!^.@w*9gva 򇩅BǓ1 …H" 8 &Y'ѥ1m`򧹡B)@ A%qgCf*$kW?Z n^ΎFf09z~3>̏sT_$ڒjK .\ %8Xh8\ّj ՜6Z29m*?f>q9ɱ$ڒjC_%K   @qp,]Wn Or_i9C$9O9Gr-ɯ$ByR2'6X'[4a柞jbΔ) B!Oƀ"( p8̦drnOTt v5^Oݰ~n먮`w^X^l1vGEqRB!F B tv$ΣC3FR>'h?6c7LG!\,D(\H Umpvڐqg6Y \?mߘ쥆<{~ TPr옩 ˪'`?&9֖W[_m,X…e1*$:;"۽4nY(13 ZݠvmcU*V 7U?njpΚkk1W#9֖W[_!<)@J7 [ ZVFwU!jRH<[tzhe*YL|Kfw"3^jVZYvzTc ɱ$ڒjCƀ"(o˷7Δej- G,~UAV\>SRU }XQ !Мۊ .\ B"58umt!(9tز&uoj3h9~՛-|W^ĚpԌ#f*Wx=F ";ǝkK-ɯ6dp!RHg@ =߁l?-՗8uΛ;&& ͇oѰq']sUcmI~%̓o%ROgP,zwp/WcWx(Es}n*qu붞xa7~M, 3n\{$ڒjK .\ 2S!5 ܼn1)wym#^J*m ,H f綎~nًؔ? I3yrWͽR r]o9/RTo/v2])@ݝw@ζcV+uƳoGʺ&c3uƳ.Fΰgܗ⥤y6c !(,'''3qDVXAbb"5b„ 2$VZ߹r tԉ)SP^s٧ҲeKN>ͬYx7m(QI"qH5Z^dsuΚk},u ]伹K3ɵO]v_j&1,wC.s[P8R.pr7Bhրطo3gΤA,]Cb6:th͚5*UAzg鄆g4i~&M"%2(6\prDWp/ycjz2a3s1{#.Ir ^z%ʕ+ǝ;w[ow^ ݻwgلpTǎwOh?Dn*քF}ˢ &`pV=&ZFվoGOU>6m4xrJ)\ 0zh¨X"+Wk׮|nݚ3{lf̘ጐsW*\7`,-myySB:B_0dKIWԊl5qX>'Z Jpv7].rMC:R^Il'ක00(GhocRS(wč'F&[aěkBz BqFhdĈ0nd֬YOxyɸϲ@ }ܹcǎ;Xm3]^x!Y&aaaYD WڿZ<ﾄ:XNq ~5(1H xi a 2.uN fys#i )եBixf3#GdݬZ{FyӵA'mpƎˌ3VZgΜ!---r~(k޼9O&###3\cA~sv\̮|73ez6/w̌ 47gbjK2*U]QUQFtR"##yǭϝ;gARRIIIُ`wᚤkF&M=zt۳fݢ?r|pa<|8r>ws1^X@[3X&T].p`|Q@E1I~%F|^Q[ ֯q}-ZpÇh֬Y!ʋ/Hdd$ .dذa9=z[nQ~}硇,SsHGhʕ]C,#(f-.3s2Tw>esU%9_mI~Q1 CY^9ͽO>ʕ+<³Ӯ])g>c0aS3_tC+0d֭ #H$''3f^uIJJ~֭[ [Y((s&ISZsmt E=_mI~,X}W^+ܾ}uƍYtiB#Gdɒ%RF ^u-ZĈ#h֬{ܛtÃVZаaC6lhu޳gPn]tbEN*ׯsUfϞ}ߟe˖q]xW^^^9qaׯ{>gZ DY}1o2,ixN"u[&)u{w/7d4|mvw[sU9oau\ZP- ^k(:o{º}'0{U)5G1E8p̆:Xq瑒 ӹ4ժ_+|>+ks_!uF? 5gEuuuuD  $g 5> ^{βeˬVA7͘fTUn[v-h":t@ǎ_u [DٳgOv[3f`lذ4iO?Ͷm8}tLXԯ_7|sC֭ >N5sRKwîO-_-jYԊ,x2c=Mɩ$sm}} z^[Ps;UYZ36enFcdMŸ9,HX\(wsԒƎ,xFKQB썃Wp А>;_MlSbe)vJ.]_]v%00^O.]hԩп6l5kxǨR ofgU)|[ wy|B yoۅ=- 3{vL!R9jKB BeԽB v(]<Ӹm6xꩧAر֕/`{駠⥤⭤dc .( 8bjƬwT2Q29 ՖW.^(D1/^ŋsiSkyygGP:THS=7<7y\E#8g#)73R9 ՖW%x!B!$o;!M6{2>u:혭A`oys& 'v!(,BBrΎdpԄDs7mܢ+3t םls!¹HJ彟? _Z0D[t4കEpԊi;f fF45,x粤9 ՖWrD)@J=w6{P2 brE5tyİ "vc7~|mnęC0㔹>MIR+)R†"jK .\J$!#(ޝW]5wv*_lȱ(ɯ$Pup7CHR"4Zix5fW"/8Yf4ڒjK L6|3#X 6QPtR`W!dBQasv$•U˱*s ?e>Ysmg#.lN w@J@Ng(HnΎ[8]Sbc|1U!_mI~5a+"Lz,OHFgP5p)ΎKMqvX[_mI~5a1Io>wE CV^I$-߾w.Í88 lyU kUQ76$S`߿fqOQT/8gqSc.?fj%/%[/UIhcQL_mI~5a1^ RGDPMk-?|í nïm5 Nn `_ݕfsjK:7xhc,3{0'} jE7L0D #"/B&Tc;[`$cW{m; YNo BdX⾕pM5~UA]ɱ1dUu ǐ&BBaaYsQ^"TIwf;l\,c'}N$اJn|7ܼɱ$ڒj„ /[!K i(p8TiHr7⍢p|?W-&pN@eX[_mI~5aF C_f)@#X%RgP,#9;Myg)B!!vaz;97:᱔9cmI~%Մ`5F)j͝A)$~cmI~%̓; •jBQma; vwf;ܾaΎF!(6>evy7o~5wUUQ˗Ӹqc #GJ=-՗]GklG]< vN A@'~9}NLkK-ɯ&l=~9rTg^ɱS&ik7`TbnW8|CiLSQEp6 c lkK-ɯ&ժӮ]B5oH)@J=[\1r\/ntgGP:TPnGca ,kK-ɯ'x/ny'XQH"D!) PLU"Ng~+REQ?~9ɮ]ׯx{{ӠA}>1118p qqqNXWH'x4BVB̞!ByYGdƎKpp0^^^jՊ˗ϪUӧsyf:t@r\2\vͦ\O "o֭~~~|W_~۪ω'֭F+Vh"Nj֬IXXk֬)ę!c›Tte`A16v.__ o%o%,iqvX[_mI~]ƚ5kaРAV$$$w<} "88 .d]x}sY3:tA~nw9r 6oL?~Z ()@`ǎTTcǎCF`` wXf:s iiih"͛7ӅXCZ]>j_ѮyP/q^_0W瓴8=[j 8:=J?ɱ$ڒj¶?u7n.GEK||͖-[8w b̘1xD8hdĈ0n8sS9G}Dr믿&$$wyL&MT8cHRf4L[o@.]pwwgرlٲOOO'G) #)9zEZK !p2HA`كlfȑ޽UV\}%o޼^ɓ'c4ׯ_ڑGR%`޽{[@bbbQ?s~b6Zwee0߃ V-n;c{YM w!˩$2P3}>ɺ-?Bw>6Xmn9߃^{.{`E>™VMW/z w;xݶXd!G,up)7uO`x&Sjo<Ʈ߬quxΙ#Il=:+ub˺}]LeϛC,罟~t\Ȋկ#KIX\:XX3bJ*z"3NʨQXt)}GQϖT$&tB(B@D) X^ *_A.E4 7 \/"hT"D ZDPBXl&;8933윲Ç[q5S^v={6g歷"66XǑ1"&M|/B9sVZdSzu~iPC ܹs:u@N:̀'-ׅC[S;gL)w `|Ȼ|cZ=|K{}bkū9p٦µgcc_ axypOFk&BiVæNDı>Cg!..o@^]ڂ :?GP"U;@ ,IW tѡ!>;,?܁Y?6rm[׍F?s5q ׯ租~+>EQڵkYz5O?U/ҰaC.\XԻPVhҤ ;w:O?MZZ~mez-fϞ$Ib,!ހG/ͯuVe|dgg)5jTjd+lr7߄f%<;DТJɆ j =Q,S1$ּc&6 bZb~2[],܉ȱD~%ix/",iQ5GIvv66mؿvZBCC֭[Xv-+V(7]vO?Et9s禧zڵksJF_|M/^L>}ʼ8b  İaØ;w.,ӭ[7:ܹs>|8={ 66.]0l0f̘Ann.111ԩSS:.e*A|e_ryH_|77oqd#ԃ&=>|ׂHȽ'ai{i bR]QpAl:&AR&%.xMFI&j2dL47nмysٵk֭+3LÆ<_yV^ĉi۶-/:-"221c0i$\Œ3h׮QQeϝ?p@X}N:%Vy}gƲb bcc eʔ)̞=L˖-IHH`=NYdIKH[k 'N&# mB`#gG{_p[7&{ku[CLӍ E j^yey7!33֭[~z}ѿ!Ȳlƶmې$իWzjk6i҄ۗ۷È#c,^^o= O4@l X`A:v_/} ݯj}(`ȅlE725ҤQ[ V%@iu.^R> Lh00 ?qqqŕZf͚5Yb_JJMq 4Ah4Ӊ[W'ƀgJ !m>TQJF/cuKWPIBBB %uK؂Z ]IwECWȱD~% SٳCR~}g"TxG1ڏq\<q>UB)^|V  ._U5|W9I&1~xg#Tx"=Bl, Pp,7~ܾ};?0=K.uv8B7 pµgbaAp+WdÆ |7osv( D,Ty;:k%tw_Ύ-^<ȱD~% 5VBwF>cر2ouvD&q-_*_"B{ ^k䀩e1b;X(ȯD~Uq7ςCyfFM3FLeIWpI7g}~AΎHu{SV@4@A W o@ :-[pQg"Th-@~6ThIwuۨ[O}2Q^kNn*V|<| @N2:9"A 28; \BugGSuȿe^XM&(~(~(HV2YpF砱+YJ*uH7nKTCApSNC9r\sES.r^PON]1n9Uȯ*L۾yC-[ƍCqIG{Ύý#|"Uȯ* ǀغy9s0o<ӝP1%9v%oe~'RVeS;@6BA01طZ?T JS;w`=^͘Ƕ8I @#u'{oCday)6z$^%}ӘKW]"WB1b#,,:dU/pBdBq"P[^ܲW~tl忽V3lymKGg,0IJ.ՃOul5AH].ot'L A;Zz5-Bѐ̅ ,K{OIDD*H6m1/m  u@`޼y 6>@uffsСC>Q5j԰_F Z-^^^FmƄ 5lٲ .DñSb*7vv( PիtԉYEA$=ZGfDEEQvm&MDJJ 7od۶mX^z ___Ξ=K^^Vk׎$ h>jK2ZT^P-4*zhrv( mjMtt4raÆrpۗ5kh裏J--bbbLJZj1`*`ڶmK>} #((h &88%ހؠA$$$0b7o^;%=(deeQn2jʳk܂P0u50kz^c/n* ў ch] *:T%r._u„ ]FšCXh[q!˲⒒ýСC/ulOzz:3f ""k׮o>rr*>f(!!e >}AѼys~mj׮7o7odʕv)hjk M_u^kC$וnޜT%r._upPye+ٽ{7;}ʴi;v,M }r>L|||̚5ӧOsQ4iR6ߏD3gDe+|}}{EZ8q"O=TћL333$uwn_E6?\C2];OZ]n^)S+1(7\/)pI2LEr?.)!(~*!ɱPE"U+oٲƌc?**н{Ͻm(֑ʕ+;vE2V^MZZs̱:6g5kSO=U:c@lp ڴiS(Թsaaa8رch//rj R߆]~/>}Ky従YŦ~o6W>\c+"u|w5/-nGV,_ 0;ƾ[wZ^ {7bRZS}[ǟa[co]=àd/ch9O ~y0ג˽.9u’iLyL${Z QZfcUiI_6˼6Y;w^Wa4C͹是aVupSžQjѦg}Q0x{>KccǏuVo9ڵk{ƤI ۛ.]}vRflٲ*+؇,,DFFrQ#? >{fJKKEL:xD:u<Է<^n^+Jݷ=)c9ya}bIsT*6x#\{8h(L9.UpB B+V4ו7u"/v,̛ l>oj| n;hJtn%&t؁ >LǎLQgApGg'HLe{{xx8aaaV ˗/ʂ >}zu:t]vZ7ׯzDDD0}t$Ibҥ$$$c\{ `֭ h=>qϞ=97nTZD, >H^}Uٿ? .{ 66.]0l0f̘Ann.111ԩSS+G,}=s pr%W5wB,͎;>߿?-Z`޼yn\^ׯ_h = > ԨQh'| /Ngnϵlْz=G&**p N7F.!l(׆H59X :=t?I{}g<=ċV{@nKW]"(֭YfS8W{Lk[x=zX.O>$&&VZm۶-u닺 'ހبwQzB;v믿d-W/rH4*Q(y>[%gJ9Pu 5.!%~5'[VI.h~uOuDuW9VȯD~Ua^ףǺ?q>~>ҧ >>Y-Ɓ;v 0?WUIݩYJ2ydx z)^z%4h׿ŦMcD%vv.CABQ$5><a. jx u,  2ņZ^yݘ;/ԛ4i⽌0M[ (WN*Uȯ4׃zXJLNoX~ȑ|lڴG}hڵk [nU~у{rM̿srrHHHSN1|>ӢZ7|'x ! `YJ ~7G[ .RtopMjxp"17@iyk=դ[4ܜkJ3 2d"##4i7nܠydzk.֭[W43<Lrr2 6,:ӦM$'g|3O>zr/Eڗ.]Jff&oUlr̝;(kOj׮Oƶ# `]jRX?3{=Ɓ|4GMe>/xձ_ g]x{*L\?sx bbb̤u֬_⍈,Ȳlǝe$Ib,_I0Z {ٳYf1~} w}e#V54 a zit^~ ZsC*1,> eæv^20T%?b.5&_紩Wr ww] ]M]vk׮,Z#Gyf>sq"Me tv$UP:>>ŹCd*A65@ lR>^6=F`Rˤɍ[rCrЂ p%ʜw7СCD%bl qvlVp1#w!c62LJUI<㵊 Z빍rr,TȯD~UQK;SMRFf͚tܹܩ}K: (T ~o {SMze>\)0)XI F#|e% rr,TȯD~V\߾}Gj-+ rv6 lݟS vvaa rXcy2;B R1:WN*Uȯ* ǀغy$X`Ν#''dϟOXXO?%11Yf9;ܻx"T"1PlT0'hy!K}WB Bȕ˓ν+h_&M1cvٳgYjU+ :i` 8 9ΎFpAݼ=t?9;A^e~nﾣGwޝ{p}q%G&# Bָ>=uՔLLu醳CۃApYlyrM4xH_ZiN9;A܀?-ku,Ts޺DbtnntG?^&~7?Ew@}g^]WCy^^FcM*KrE`Ԑ:rvMX]"r~m丩-Vg?-Ɩ]%{8K#pqrrl[Z7: +AxwnOʡ4L%7nzN=2v&EnXT9h"rH^2 ~3ؗ*4@dt.{ȑ#-$I(bduvܹs9r ̞=ٳg[MLL^t: %KhAwe;w&L̙3J ;ޙP9;x#Av"G7l@=ȯ$rb! Uu SO=e9$B4BEmW^?C9+W͖pSNѯ_?:vƍ%&&޽{sjժUT111 <2k,.^|PF4ei p;gGb;?_Y.`vpSq?{~;Yub0~R,5A\ MW]n<Ň<|.:vτM% ڵkP M4!++ V\Yb|}}ٶmժUSNhт%Kp¢k̛7{yЧO f"::֭[X;hr6P|y6VFPYg p7e-&o@*q T{7{URZ@ȶmxG5lٲhΝ;'*rר(Ea֭ gv÷K!\;?Cu}_'g"  ={<"""k׎$ k׮EzQV-N8QFMZ_ ' Syd#+ߴ[/4դPs=S2k-Ŧ]29Hil!H=ȯD~Ua2i06o&xOtAFyYPAAA(BVVu%##ooo|}]d8#!4z'Fέ<,iA UV'*h#Oz}BCyj6"9X"Uɨu&%8hv hOYwŘt"\9 l!˷n0wźv\N:P=jIň{0^?ϘnZ'iv8lPe4(^fԞT<ܐ!twrUISn(խ(^n?ˋrr,TȯD~U!PƄl DSeffZD$瓗U.]ph.r$Y۝T r2V~?;b&)>A{J]Yӿa0nw8uyz rCwƾvGmiԶn55gRZxۧd cQtΘ­yoA14(jx4[u6h޼9=zرchѢEB8DMOO'##mۖQ: rK}wYq1Z4='k]Ԧ}}.>CdggMhh({lذ.\@tt4}f͚h4>#r7od޼yݛu@DDo6:%!\z:u0gbbb,=c$$$T4VZZ-Z`ԩ̟?,BCC0a~ .7ĉjډt x(_=.L쿨Z{*uߖ[#,@,tk?)x827% מ!7;JVavv΁Ki0$({/j">>kZ-xq0`իWg…ٓ.KD;ر[nqMN8M:t(ҥK ƌ3"SSN-V`` f7$((H~gbccygcKM0]`ū^_˥5xR2ufN nT)d+'BKWE1UⱮu@oݻgX'}%55iӦ1vX4;ۗ+W Ç_bf͚f1iO~gڴi\h_$55Iظq#7nD$RRRhԨ-[$!!ӧ3zht:dɒ%EcD ͜9/_Β%K_>:oF98v:zkSSf".ʡ|LvaKUԖ$XRS%VuioW) i= )/"TsKr[2_rr,TȯD~aTj:{oٲƌc?**н{ϕ&Y)_.pB K4@Rr;v+ɓ'3y3~8E9/qNnBjK:~Gs4 4xg ɬɏp2Qݴ^C'aW}n? }gI|ne 1D~%J΂E`?~֭[[(\ĉ6@o{QsYJxE+ []A{ݯܠ:ɦf=[V )6UUɦfVK դl;GM4h9!cgxGAAXX^Ӭ=oͨQʙGpWb,< Diʞњi꽔^nI*^,!]'\{`:ɱPE"U 07ao .-GzhǾVUjj*ˋ={P}H'TgHyJSbk9+h-Q3twtuܲTuoPG*>PaX"_uRǙ;u*xDDȲl1رcvJ~$o*d,4%9v?|Z eeݠ PSA9~FjH [NM>AR&D/ǖy)S+VO$Ѥ\t hOVScD~%~bȑdgg-IPhڵҭ[7F~Po 庂o@zΟHDWAjH׫t&=O}b3%_&_FqxAwZ.{hRӦ1S;N-&eK*a~7tG&$YnFy lȐ!DFF2i$nܸA͉g׮][hgy?dCa%99hѣGpOzz:V"==k4lؐP'O_)؝h.-Enʆ6 rjW&=hP[j]uykꫵW#'?& cIZ Sty7!33֭[~z}Ѣ2,#˲zw$˗|r$Id2yIRRR$'xª9sS\hK(%:HJ縢)XxqN]C$0@:A=$wMriɱPE"UG9˘֭m n"r._u ]O;c_,z66otJSldnyоo *chׅ cܼOF{"ݡlz,%Cf4mm=EcM*?`AJJ肠*%<j6>[9,Qz_gGV5:h7>|jOu$ 2QT "TJ5uoܝ"Cp+ܥ̞o>稥bⰩyJ)AܙKp#b K<ڈ 3-ӿ!+a!yG8; 5DGp؇KWbFth/G~LMgVa!yq/;; :Ԕ D#n;ƂKWz:;6otf(xM BimW^?`00rH$ɲFNNs̡iӦ,[;vϲb zI^^EDGG3zhvŋ/y饗ʉ&Ş3%~BziO{Oʱ51ڳx>cuKW"1&M@FF+W*GZZECF3f 7ofEט7o=+*k05kѴnݺh=z&i@R梅PS}.x\J(xph.F{0MC©)]nyZCUU99HW]"po@J(%Oh,t ܹ|,\BQn-A`რAΎv< e;B rH85D{GHSuX"_up%t[7.!o{kǏЮ];գVZ8r%APcwv$Uݡpq IDATt0MARChIV LUD*x"3f̠K. 6hFFZz $##Ña emo~}dAA&܈hTAff&> $axsr0`a09RG 8 R~T >܈UIYYYDFFrek4ibq<88|p .꫁x-mH,g]WY;h.ur{a"]ia8Ula[w8XGYVz:/XB;s}Ž4?ɗ)>6Ǖ%},ia%,mXo/,ۏuC*>fS׽ KY21=߷z̊*>ғb^﫜\s _)z=[[&ܿ=ޜ⦎!YQU9w׼¿}r(cGp},u JRJq}z*uaΜ9XbРAgڷ<ٿ?]v-ڟNHHgƌ$&&ҩS'?uaX[󋦱&B峯Cb!D1{x5:t^ qၹY }Shs(횝󋦧1sr_^}kxxp\4դA{'?esDiv^n/{Y_ɱPE"rH; J>|;:4gPu'šNN]{7 6*l|;w]v2d>>>]bڵk$.k  X2Nr,Rl1䤩CVqԎrCjIW.pHrׇ7w!._uY7"ƀaǎܺu7{8qM60tP~9B\\߿:uЬY3<|֬Y?Lll,>,Zr )UnL\~4M9/!NHAJ@4@/j~$I7ndƍHDJJ ,s!$I&L`E9s&,_%KP~}^ux ݓ-K;QCLt}:.+fd:V{OiaS'X"AO lf͚ƍ̤UV̘1cǖ{+Wk_C7o (G\\| TV;oҽ{JܔD))*˲Mל}:qD>3fΜɀ`…ۗhgsK(eQ]y}Z{0.Wʥ'-h=$ ncD~%ހl߾ݻw_ƣo߾2m4ƎFSpUVq Gnׯ۷^+ždž ?~R>R9Og  JCFQyR79D~ord_r79z0R͆Gˏ&I3X󌊎\|1T QWH0X"_uCA[l! 1c,ҥK8ps[jUj<>Z"ހ$~YB4x3}EYf '?}%,mR=ڎf*_ ~JFձ-pW4Zg4qVwԛyv"5t-ж5 i ޥ_9y O1 da [Lݘ1^yPz+*[grd~uԜVCcD~%?~֭[[h׮`1Ǐo߾V =y$!!!t:L{ǠA߿?̜95kVW' RܲW_otjgVP8.k3oiuC BFl}XP{A\J':›^T䈩'|iSKNZ\{VZ0/ CUC+##0AAAEKYTsϟǛ.OרQ#S4YDD*H6/Iu^Kl8HZ9FݫjhA>SZM2>sһwo_{Gdd$vCQ3qIQ-I(FOYbio7mǎV@+ ,lHs5ۼCݎ|7"*wX2 ouCBA\&9h"UGEހx}K-\[̢e[Xs;F\\/fԩExڴiÔ)SoJ'-KܖML^KJe:8(g: gnOw0 ԭׯ/ לa~L\xrD~%Ae g{:X<""xdYr1ڶm[jUڵѣV{ vR_M Ĥ9; qFg>2?lu=gB-h5|կs_-*a$K7:\ MW]"k -[/GIvv66mؿvZBCC-f*SNq}FO?z 6lhZB$&&c:. x#^9C !22I&q 7oN||fϞͭ[ƀ2o޼JܔDDPZFB)Έ >CF:;ޝGQ{vg'=B0wf#,X+X`[f^n+'bDXwX]Q[p E%&"{vAO>e*\ʯ_s0 /@xx8 .d…y7x7&33""" ##޶2#b&>^+?B>oGj4wֹ,k0M3?N96k.&̄.b=I?vMg@ dNZmro?uqNڦyc2|Wq`P{?G=~pta{@>M5ksOT${g !0p, vv4 5) 7 v\e%SP9nє_s)0,3SX}WnA{RoGHV HNG 0Љ::S9aH T\l^'-0 Y '}ѳ7y◼S1F[/:bw-F';ݐAL})\X6HC!Ҁ>M5kuB?' >ɳ? 9:ц+Gi%[isv#>AP.ggK=W:_ڴa#R~Ғfi֑%?tdG3>M5kuB?']ѳ]b=!9p-=7dֽcstBt_C_{Rq' t ??Gy&uK9T5cs)R~͡NG e)ArCG{;ePo%ۂ icÑxO ~ #tz"@ֳ:Lg/[EGQ ,]-h3NGT2oТBb}UGTzyqc!һ~C}0x5@[4\ʯ9uBwg?+Xg3c ر#VS5 aÆaZ>}zm^|EOhh(={dܹk{! r{;.noG*ͤ>rhʯ_sE |,YBbb"))),]K=C.^={b_K:[29x<B/*ʯ_s guޝ" Xti?ΟgRRRm/(('׿5O>$Æ f1k,҈}4}i L|: .C\"j/@z G ?#µAx8ӥ07&^Spi'ayȥ!1Q_T_s)"{ 4ejܾvZIMMuY̙3YregX AO}?-FCbRbsz\-" (ZY@+7RSg'D A|hy?<3|`e~G78Rfz%&#*@ܰtRl®]jm}@BB:t@^^1zCt_v$M׺# J<$C Byvi\:Dpi#QWBqѩI!9i~3ze ]@H#:t,XNjªmb,g0Y2h,Bkj|wpU'jmѕSFk0zC\mʾ*>cqk.TD]Ӆ9}!-$AEN*@ Tgԩ|bb VXba޽tڵQ{lj`,XX{1fΜYϞkpt_ 썸] ÂjB|`S냫^5W 86* ĎB;b'ϻReX(Z6\ʯ_?<{uk?Qӧ3}Fq[qD={CYa#A7y>ntY~5LMfE(e$|ɄDZ܊&K|lImgLz|ʱ_s)"= >1֣~ZVаіնjxm"l ;r:|C'1,tD8nD83w^*&SB;]Z>\ʯ_ö˘S:K緥 ѓ~åW[+ {f&""\IKK#..0xǙ}7dҤI8&M}VrFɩSxfѢE3׻ stJJJg\iTT {^3?5A+ hڰF6~Jȶzۖ8ftr':f~cs)R~Mb|@V~5[z5ׯ'++'0|p~;&NZ4yyy檫j1.3fiӦjl޼Eo2a7E^Iۼ@N9PRpticoQG ;+];f~cs)R~{GDDDb 55Ç׹oN6ȏ#G\WTTʃ>_޼">GO_\YyPt |JYZ6|ʱ_s)&7aۉ#!!pΗV׾ }ΝKYYO<[:%nyz8҆ ޽el߾}Vo߯g}UVrKS8U gL;Ey0B-uzDoNpLx -Gi !M?XEy)Sͥ˟{Obn/~ FXsTaNNk=܀+ 4l"D[Ƀg5(J* 4C8_H͔_)R~/v.>DEEj{]kW׾ .d߾}dggssSN!yO8A6mj.IO:v4{37A 凳)NhcXRk>\ʯZb~@wv9ߩZ[4,K k7!! ɓӧZtꫯjO"b8r&Mh_EDDNVVF?''!C7 ֭[0qD BxxKVVVDDDķzp}@ƌѣy8uz"++uoVs˖-cϞ=tﾛŋ3ay:vK/w}ѯ_?r}ЫWZ',x2 eIDATsLfϞMaa!՞8lذ3f0}tJJJHJJb͚5 :ԍ8%+X""""~WK8_1Q#IKK#..0xjqټyKۜFEDD?{i̟3c ر#V6&/"'44={2w\v&q ɓk/O:_ 6p]wѷo_ܹ3cǎ%''Z[ݿs`5vQ~TqƱl2̙ڵk+4iYYY/=lڴe0Mvň#X_oC/)+??%K`HIIq򩧞"--ou1uT͛Ǵiu]FDDDرc111ƨQuOC|[n52 ƒi֭[})r{ \֧ra>s/E濌:V|ᇌ?֭[Wڵ+_=w$MR[>˵kR^^Njj1RSS1 +W~mvP~/]m]xx8&00[nw}v`ƍ7΋r̘1rL, cǎT~/;;R暪uouO<^mߦ/+"s̙ .v{>cɒ%DEEqI~iVX/\mTݯ~+KN8c㏹{8tӟѣi套^bƍĐ˔)S`ٲejW֬YömߧcǎX,vA= jp.°X,}4gX"uax;8h^ """""1*@DDDDDcTǨQ""""""DDDDDDyyy= GGGxzzb֬Yo6m۶aȑprrOl_FPPlmmラSԩST*śou R'N;^""—B Ux`֭z*wӧ6oތ/cǎŨQ`ccs᫯֭[)S HvZ!..N}={>w\ 003f̀+N8{Ǟ={ iSZZ#G3f̀ ֭[y?>᫯‚ hhhy`ooxѷo_ؾ};{9\|tk8uOkkkXd N:[jlrJpvvƌ3࣏>֭[qqicH%}s֫W/kύD"1j(u9rd&''Obu\[nO~6''FBQQO#//6m۱i&L<|rXbFff&^{5aݺumTM ُ"P\\^6gMP(™3gD"V߼y H3f Z߹s`ee%<(H$aҥ:Zf,Y"H$aŊ% H{Nhjjj{A6l H#GhRpxZuƺXA"z#FDssskkkMzƱ^|EA"X޳gO!88X-^XH$Ç57D".^^6m4Wׯ0zh2A* ƫz׮]u .\X7gA"7nl5%H۷kOD"$$$h,OJJ$Gi,?v J<;;[pqq|޽{BTT Ʉ)N"SKOO>Bzz/6" P(8xz1zhH$OITW=A???X[kOY5~xDFFbϞ=z駟_~ַ.<==~zlmm|rHS\g'Nŋ4hiMlll+@.lƷXzz7|\ 8|'''_^gS4}3U;SApA$$$ 11'ODmm-IvzTsn ՚N Ϳnݺ}!((HY# dIXYa]t EEEl"H$Z7|  kkkuL9={?%Kh}ZK4`֬Yprr?ѿ/XeϜ9^viPrwwQ[[K.y ßgϢ HHH@cc, >t'RT݄LޓѣG,TTfΜGAJJ ƌŋ#9p,$,|,Uh?x͛7ƥKУGox |Ä /fN-Q@/Kн{6Ax_`xQUUNNN3gzۜ :3f ƏWWWXYY!77k׮E}}xudBIIzjz|}}] Y@@pa$$$ 2 Ǹq~bȐ!U>!.ދޓSO=~ꫯra""#cBdAz聐dgg֭[8p<<<4w!::Ǐ9t5j2&&F4{_૯/o555x5'ʐ7HMMmv)Apm7*r%%%pqqQ/S堰Z*,,P~k/u64gcǎŪU#,, =z :{Eaa!\t߾}["sSa())yxOOO$"U,C#256"0áCG=?rrr }Q֭[:jB]V;99!** .\л9M{ 8 ™3gZ?D%;;O=1tͩGcǎAP`e111n_^^3g^8qww۷u!rmؽ{7;HHHsamB,rԄcǎA"{r1QEs=|gOQPP{N+!2.6"K¨p|'(//wTu>z( zyuu5ϟfMosMhhhܹsu6iQ llχ x7k7 Zwӈ:OVg5>3\vMۨ >Xf)))8~џ@C">CuuV"-[?Z\ؾ}Ʋ?999W?GRRrssb O>>۷o9rH888`Ŋ(--U7{4?)S`ʔ) ř3gk.xzzj}G g 47oĦM ɰfS_~ӟ/B}UV_~gPOək_"2\T*\eA"RTxW& «* qqqT*_~WWWA* RTkm۶ &M|||W6l{ W\V"ȂD"8:: :9~0vX]pvvF-:s~XA* »+ BhhE* {}Q]Å~ŸbccU4ipyaɒ%:ޜ曂D" nܸqT*f͚sߠ ڵK1bݸqC)DHNNnS)))T*֮]+l߾]1b( ӦMӚE%??_x饗={ 6660eԩSm˅N\NRmTTBBf A0o yUWWwŦMPVV޽{c…9sC#ѣ&@Dd 4u< ==]O2òepE}[o &ùsI&ᣏ>WEhԩXn,Y]vaȐ!={6RSSu"t@WZbLYYb ݻ_|cixaL0غu+>S۷ F:>Ɏ;0i$j|K0n8dff"//Oٟ4pNDD EӠ er91 СCQ[['N#<+W_4ʨ#HlgggL*(((ɓ'F"ty0tc^cd2'"|:u >F13bDDD`˖-z, \pZ DGG2338R+`d"5zw{c^TVp vU/"aC ^P}~ 2~躎hli{^ ޞ]V:~E(^u dFlD^fߏx{^ N@|?HPhסʯ%^/ pu]mLP7lH[&"A-loȽ|2i$L8c>|,G~;\ 0g?~ÇG5<>݊ fX\pmӏ;oxq{vLD~{Vᱟ!v/>]ym; ?W(Z c$о_\!яF`ϰ8toAwe̱_qYr~bI(MsEAjPsiIup oÂ0I(X˴fxQTTG?Qc޽{#((v¨Cc'tL25Æ k~gg  #?~}i[Ccq1b~-Get;cСo4>OKKCVVN MD2~x$%%ᥗ^Bee%BCC={`-i?u6PT8F==!tẕ_q1ⰲd|l̠m7o֭[lO`߿?<==QPP9r+Wxl2$%%ax饗p,\HNNc"͛7wEPVVHlذ3fh}.Qf`\ h}c"".N&[ԣZYߖ{BB[5 =>sTVV C 1asbǎXh&O @gۚ-  SttA^T;8i,I3Eu0b~D d R ! mu9r rpBe4Sd]s,.W\/Κx& $i>`|4DHYɌ3WmC=]KgRS>=׸u5If'>Jk1$+EKlY*15+U}_Bf&XQMzJgnsz dAXA"޾ʿ;Xm@@t]p/FsCDq^ ,@ ^ݔFjtCyU:: _<| 2wT:AzuNDDDHG>H IDATQ q|H$}qds|آ޺w-8ďǶ;&B#q!mPcgrL1b~E' dAXtDNA467sQ 4 cn|PpڡhAD=/i2VI7W\̯H ,?vQY掠M뀳' Qrxâ1v%"p18 FZ+vB' nȘll:Ѵ_^6pb٫*q@V`9SOT98LD_@σ<Y 6" ; 2-9Qύ|^Z4ISUkF4Xׂ۠;Ңᮋƾ!M/u=|CDD'|Zfdd 11pwwSO=ORކm`x*\p"z0vLΑ3\ٙ;z٩ȁo.˥cq1b~E™ɂ_|<عs'>SܹsÇ]|qqqشiV^,=%%%-$SkfsG Z[{dlxΆG!G}pgzY_ une,x@cs,.W\̯HjAuu5^uƍ[ ~3 gAvvֶqqqJZ'ɢ >sh4~x>@|E`oom۶I;{РA6Qo?[FB:QbH}@NSNaٲe1{l( ̞=>c`ѢE C^^> -- }>44ׯXfȴX[nr9mۆ-[\8=nK#k#v>jQ vF;vsvFΨtt69];s,.W\̯HD(@v؁}!553gƍX`fΜ Twc~ Ǝ |'/5cС\Y"62 ddd ** p5ա_~ZFGG#;; Ӣ5cq\+Qe8;;c˓QPP'O6_A釩#bb jkk;JK<7oO?'⣏>dbvXt)>/^ (++ڧ XΊ_L5l&ƚFs1b~ODP(0o<?~?5ֿ??AAAx뭷uV<I&' ZtpBuǹs;Ӯ(Ө:AR\o2u |J|y8y|v hgXӈ7!MR35yVlg+?fi,k*vNq@}?bt#vNq*:T븼v?W>ǀuIZ1\wihၔΧ/XU_D̟?ׯGJJ 6]3<-3!%lKo>/^{K.չͬYp!dggGCxx8|M|Zddd`РA _:nExtv_3*z&n$g(c?Cu6 P[9ft6)#p{x'!""ݻ&N7AHOOGLLEwHhwAAgr~ 6l9spq  GJJ V^{qݾ}Xp{&l|Xx1Ə'"--M㥲tR`ҤIصklق{ >>>x7xw/ (pDDdiD>eTWWX 6}UO>RRRj*XV`ĈzG}@m6H$ڵ vX'HԤlӫW/:to6ML,_Gu!KL%fX .3)Ԙcq1b~E"B#)) /*++TٳׯD"̛7֭CNNzxװzj̝;}V=pѣGӦMC`` jkksN|HHHhs-,,@t6o{CK3V.X:n;뀭/k/ \W^o4OscoHcH7oތwy-BYY"##a̘1CBBJիzjc!''Tŋxbc #h: Hrd$˳/y@TӀv4fhs1b~T-GGGX+Vhv5k`͚5rsstPlۦ=un,@:"HΩ"~3v -zP(:!v2 4,&˾:du.(/BϷFI.IymH)+Fk(Ȼ \ Ek C@oLwQOؘ̱_q1DT{f"F45)Zevr5\ /@l' kЫQ :ib:y#pnWG.@K1/8}Tt=n[̠B0 &'Y@ѐ>R\=PDDdX0zWg:p-ilPJGg nrpTÓ1b~ |!3`\6wZ<Qcu8tHp`\nseЁ9+.W$"B$6F-4wZ9 nmoPt٣^e,hPL8QK1b~ rj'gsG#}hkA88xhaBmR^ \\ג ӏ{U'@hK،ū 7+/.]h@q\< `鏴Y &ewŅ|R` M*-cpZu zZDD6! ##f5l?B9w]@ICZ]+`PsbwO̐^'o X\̯_p, |E4wZd6PS| %TkOAP>L?T8CTڡ^cѫʝ]EaD9.KD,@:#_὘ѣQ~ (+n~R)'CtDƲj{G;vGCD;6)1b~}@Ȃ6qp"3K,Y~Lo~ CGUoc|o_4Z)ƕafD'a!D*]p`D|ADDO!ގ(#h=nQf{vƽQס4d޸ {x@ ctD?;N.F R1:v@)2S/\]s,.W\/[G#h+`c۾c66,X)pG*v^"x; u{nU7\;ets,.W\̯H , 2LֶO7sa-Q ̹k=Ȼk`yB.Af8&X!iaF ODD&NdAX]= /g£p%0 m-Alq\ tLp^IR ÅH1C%"b't ؑK M)*]PFCN.r 8Wlw}R  Pz6|5FkkT8OT &XdA#:]c=^9~Qg0F=\O0 xU(GښMGV?V].fJ[sLa~Zn?x航*u'OB&aرX|9[>hp#Vgc= k{X:.n^@@M处r2+@fz mlQgkԸu}ھ=VQC1+ʻ{ M U dAXC~~>z-R[˗/#..111شijkkh"=gΜW waE\SNF B ƞ:b#ݥ]q$};YEF~ uR!}@$U$1EsD:FȚZ.@rpd@J>զgFVVCح\=uu5[p`( :5dW\̯H,vx$h"c۶m?~B þ 7 ;xv?pGbJ/GR͂}}!>b͹9j&gK(ku%ܪ*'7 :C&!lCj=7?3f 88317|GŋN.c۶mo '''@c˖-C˞AiPY^ye.w4| Ì~N#$zΑ(i~8fR4OxFS ԩSq),[ X~=fϞ Bٳg7 ,Zaaa|O> &_Wܾ}o6p)1 Y }6^u|Z5ա_~Z뢣w^4444 Ux1vc(;vz4>v^ApA^iZbH/\RWciZ1+.rرCjj*fΜ ō7`̜9fiOX6vXO>_~^`xxGzj"]! `W^A>}(-U}ApOp4=掠s;QZK1iB*E_OdB*sM5 1CXڇ+U}_-<5ٲe 1}t(((ɓ'|}}[OSNg(fFlٲ&DO=mۦQ];6a掠sIϩff`p1-sL_q1"ȅ #::W999CT.\ͶQ΅MP]]W_}ur d2xz*ǟ-++:FYY$ ݛ?GuMVV(q@/ہMIEe`%Yڃw]1ib~DQJKKfYC-r9Ν gggxGs=Ν;X|9<<<ԯ 6޽{pwwdz>0ܹsZ8<[P~"dWG]ۓ7i8YeE8yjJ4A>/;, \y ~\ \ f~ xFsٞ=`pX(hTJhu+W?k.qQW7?¿|v м9dD8}C__I:nTk,~4S>bz'lq,eb~~44bM; r!5uXu\^+?zc$LN ]ߗ  ͛ǏcݺuosUKͪGZZ/ qaڵ ^^^ӧf͚C!;;[=V^^o>:~FF  ݧ[ADY>UW-ʿgw:; 냬='(c?Cu6 PI⌂U;F&0&BL<EZe2_"y+0罰mlhv"Ou H\ 4FDDv=7wMBn+ 2U"wH1Ѯz#P(zdff"::VϷܮYRRRj*}:^z%ܹs .Dtt4 (XA\X{혾%1# ĥ{<+p6/{gQQprʼn!ѽg 1+.W x!h2 :6+.@W[Y5v|ڎ+&+ɀ&6"3`KH/9C IDATA"""R  XN;d ָ WPoE 0 O@ #:bZ,qnsGй_vʭdHT98UOI̯_q4YI jSh2=>u掠UYsF?5RBT5cGdd 7~@D-` ~Ѥilg]t++ʁ;@v&prnr:KWYW  &2E+I$fX;r'W{Ycy1-W뾁njD- Sj->̯_q(d KM5e#4:[~r38(n pb?`my`Hb^5@r';W/ho/F= D 6mUN@GA~Mnb3TJ6"""RXdr9<*VU궵ͮIPl`GDwPyWz?iv3Eu0b~C+4AK̀M:3w35Q4o$NCHypxHc6C4] s,.W\̯8 o! HGi:@sGйt7ws,.W\/ ]up;_9\=GX%"" >!3`BFw"PY £ Q0  3 D7"2TM:?tu6=|(nd6 W?; o\C7꬙":cq1b~!ԠQ]V033h… 5wFEJ.tUN8w*\~ Na>$ QF0sGaBn1ήEEfcQ߯=+WbذamV.F䈺 Ѩ&=] g߄FL$m:ۆzHMmlX>_xN9+.mhVVVuFp1L8ppp@DD׿jlD8;;O=rss1Wp/i@`#8axoP<< x+HO[_5v܉~[c˗/#..r6mիѣGL7Jj8ރTp|*gw7ƽU2ߎ5o_k2aC =^/Cll,͛w}WݢE`oom۶a2e oߎb,_z]īr23sLznsҼws6Nd:=X\̯_q(RtHJJBdd$MӧOkm+h=x\.ǶmSOI<00زeK'ipL"(`-owQU3;P t&HSPD\~XORQX|]F."%B I !Lǐd37Sr^3zn9{r=sUWkS7BqAUWcs{Km,-Ѿk^JJJXp!3h nq7od…7777r9[lw#>SN5a< È#co(;s1H 8qOOO._SN,XbRRR(//',,LPۦH)oP3slڵncҷ\; -9p{Qacy4Cx%WZ}ѺM={6_}+V :yq|1m4F "66VaÆ7D3; 2d9Bjj*sᥗ^ߗNAȂnݢ{z#Gr/_NBB?w𠺺|:u7H"ŝgWr>й 885oSsն9딗 #ǭ AÓ" ־}!**s3ƍGjj*/fܹ?n88w\{{{ [#..8::_My뭷nX:*iFCyy9+V^`رذpB9}-h`? Pq~w84| Ʋ`ڵ ggg̙SO<ӧ9Qh0ꔟ~UVaeeQT tQxyyw|^^2 w&V2[7h R)̷ŃW,܆2GS~| VgK&]e9iyډIY(#^ u"9S}A,r_J}'מ)Ȯ:,Ѽ[{PX:>E,bn03S~8b)Tx~N֭P?{Jrr9-8sWv_muT):si?'D%'r^l;:e0븲E\ϣ&vsv5u$m9Luf|5Y/&E#44Dş'tR˥I`˗/gZ+WJRj1,X'|0`@mիWݻ7ׯ+...dnܸARRR珏gc2<ͧSSPG;L>sRV~r%T 1-sGM▷o,c/1Log! n l\fD 0aF.ޝ7j2 s{df4R)(аqǜsw3{Òߑ6h_is޸ӹ]guF~zMYY7Fѣi%--G6ϪUX|92 Zm1Ey>ۧ>|8 3fsN֭[W F_hQMj PIwv#,9< qp6n: Ipm}VW.3PuOnw wk8M5n\ -o1 s"XZ}%W5ix[sZJ#"" W_eϞ=!;;zyqpp`^qBۉH L4ӧ;h>|8qqq;̘1ѣGrJy7(++cٲe4lK*zxv~J  @g7aξoG 2%\v@r􀾃4]%A}E.yVfcG3&5 kQYSVZj`o:f^34] W_L8'6ߢELH }\M6rJyWX|y>zرcSoc=V[yf>|xbmE ʲeH* ++Hܞ8Stl#heQU Cb$e KDJK`,X>Gsͺuj'?3X[[ll߾#GΞ=[[V㧟~bԩ|? /d&NȌӀcǎI03E#Ekl%t|jbǔ6h_iЛsN,Y²eˣO>|w:oD4 FoԽd26nƍu2K!Y|9999d2BBBXj/>̙3ٴiD(PyCfea`ZyZ} !6-m,4MDJ9s@:1lذѷ_~%_~19(((<ȬYX`ӟڽN d蕚΂ B,X-tG}C;IdxYΞ+݂ ٨Y 5u4gfԨQ݅ #h?/%sz; m"XZ}%W06Z- E| 1EG\a޾й ;[m,۩u GDJK4jVBoVBoo[nȑ#6v(e&5ƈ#X \|'6vODJK4zCu4ggܹzjc)2Uj(ծaf i|NwtEn-7}(ykh_iHR=CرG}0gcԡjpćźݺAqа"M+߀h:ӦMc׮]\xءt8"-8; )@zKKt"~҃ syuԎ**l++W7K^0oeyr@N2 2[fۺet5'%AWDDpDn_;&BƎ=_+G8rFMjȪJ¦ \N#L\Je2;e޿@49ؘJt@LSgcG`Ѻz_eڕлIW H9\o8+܏lw/\Z0'XjW5YZs 71E7v [,*+kr\=wvC#7eTVRw~ }y|6X4qJCdj,vAZZeeez?C#DeDD Gz\J{qsB irp) ZA$'`NLL 3gΤ}DDWh5UdBZ2+M۩T jTdTZYSee3I͓F&#̓>~IRmU%]nJ:AiѢE 8 .P^^F': ັ#h4G04_RVɉ2nH[ CFyONRA,exvrWX+X4qJCv"zK>}Vrr2˖-#,,LLFoG3U0vRb܉Sk;//WBaܝ BAhd+x#=BIYSY)rį̄X됱h$:^zQTTd0:{n,?IEҗRj,Q3>dŊ^GMoV\ZBW N}eC\үAШnBe9]Pa }FM\Jm.tdr=Jל\Yѵk)Loqhx-Wf 6J+ z̜9SNOg#DfDD\IkItHmr[pv.[;1Hmg##2 /k?u)`g`(/[N3݋lw/ "A/Xv-rk׮qM2y'1U"ͤx()A#A-H^ӧeݍNѱV㡇GGGêUgҤI8;;#:uj|.)/SY)aɗQhԤvxO~>9TԓgYK!%RS}"_i`ٳcڵ70o<4׺o4hӦM#**Ǐdƌ^۷o3qDⰱcǎIvna H \rI&ˎ;8q֭/*:pbbb׿ų>˸qشi'OfhYPvܸqdggsA^yFc_x1{fL8'xV`x뭷h4xy'klL&k:ې{9vK/ --+Vm[b=z'JiD[1dȐ;aҥKٳW3u>y릑}^gklM/egu69JOpC}`ǐ{ޏ?u˪( M_հK)쾠[}Y[_]/F2Ju-]Uuw4:.w29 1+-i "{SCQuu6rru~G#:eJϼɺ1Dz޶yi}?΍^dSNS177zyzzJZG%n[*vO1uufg6﹟`i[;x1801^ٟ}'Qfkh'JO% WZ22D́㚷Cml͕n=]9d2d ] D¯\d/#M?Dz'F(eD/TO|/&Q}[=ݸӹ]ggF>7>}߭7ٷoNyff&{Mǰaؼyۄo˰at/a˖-K>3wfĉz>̬Y(*jB-#''ɓ'm69š5kXh`ʕ(JO΁صkӦMLJE*c+tr!9 7DAhRe2&Raaa*J;"iSr1\]]Yp!3f??<'NzرcX[[裏IHH'Nh^:_(vpRPRtG0̔Èڛ]e]oNV*6/'atM?F04R;J0$qJ& VK?eyyHQ[sJDE7Rup3$3f orp:ԺJr9]%l8>0߂ħ3 rVq-)bDBΥdyPimnޠK-m,xf#|i,}c]zIңtT֝􇰰0h4:@.]h۪/^$""BgۥK RGc^~eϟϓO>ɋ/H@@_b|SgZ(1EaLF5 u>66]9:s{=> jdN#{psۗC'wn^ qx[[5B[M3vMܿe(ӝ#߮wYf駟}v{͛7?Æ 믿W_r&SO27qFd2js ǍǾ}Xl3g3f k )oذGyDԽ{w{9%Ot@5*˱@fYs]=-gs+)׍up)-ƥ2[;]wq X4I91lذ 64ϗ_~ɗ_~WJuM4I&5{Xf CGG!((]D,St`#h-מ 9(!aTeIuUߢ`-t[ԟG0 qJCswzK?W >|!CazYj/_6vx耘~s۵2[;sݯ[<| l5O'?} 4^3 AE}au{v&̓|7r6IYon6e kz+B`„ lܸ[nO?1a>3O>}Xt)ϟ7v~,AZ]n|.A0ѻ}Yh8 eJ_^0j]`t S !XsT m42ThqJ9+7t\GrL帹1dFΑY61E)a"cGl67. 3/RΊ!9P슲μĨˍ>\(L6`SUIȪKiJ@t@#_\Y7~''q#hw/9  -m[5vZ@ GL N7z\@vSN]]hXhGEh5qJCӪ ?$99`{=nܸRڵkY`bcc믉gҥb7 BUk@U*zBK5U*_h YYB`FZ  iJ]??eTUUl28@JJ y 2 ױ: sT \< UƎFh/5v [R.s%9~8Fwȑ#1bEthxA?U^\ :]K KNǭ(4-{##` j`ѳ`Y[[_xl-W8:Z@Oѱ:Sul#hs@†k'-Ǝuz1B,)Pڽf6Xk,S2k,/_ΦM(((߬\Yf@po(jS`^d\Y X\Jp|C(5n@cJw+FV1f!;Ru(/xqR9;" o|\r+++T*YG>ߟ+V1R": (8XyC&8H7̾7(%9v)v ^?mSUKi1NTXX˘m1;fJmeUQim~֪*eDN#VBo777N88~8xzz2~x"""j7o#,"ag6 5kغdg\ %{/c# u~׮;+\t#`?r9SNeԩw Caݠ{oph!\N6T˸53V\HUkPA06*ʕX玹-+nBPnkFnNVNBWuG0Z&,,~M¨:epcGa~N8̵ gq-)䗰;/ N; &Xji@WcaLMmwo \f3iȥJKHH@T2"xD?c(,ֺhv@UUxQTB6^ 9.9-[޾;5)B[_[HCUvqYa&o^U&k:YjS6F&QAyգwy .pyrssY|9˗/7>>^{ӧOcee]?G}ƍq~~~JJJb񄇇m6Xlcƌ… xy1sweٲeL23gΰtRnݺ'|p0VR\Au *\6v$-`JHҝ߻Ni@ZYڡL2ZU}EŮ b mlDJ\_ U6hdF͛B': w@nn.}Y-[ {{{݋vٳ'ׯ߯=իyXz5cǎKpBW& P\++@̫nTz$sCi>~6d# t$o@Zq U6CCcT*{G|tڕ &k׮ڲPQQAdd9"##fN^{!&Bax*M05 n@QܾiPAA0#)))-44d*>פw ]ЪsxyypE D 3 PQ3 /4cGִ;[J{Q%E͡97AW/]'m#FHZkI1EXAJc`+ ZJhGBw] j<<frQ0<=nb_Q)p|UVퟧbN@Nmx0\J9>s!HUwTUj\BcRBlvƶm'3@~8RemG;/6X$Ճ MJa1 4TؑX.;wPT`}CTTs`ܸqxbΝ?s9uÇo: kFll 6 I j xQҥKٳvQy"u"777\7Sۙ:uH>[J5ܦwr_u2:sݕ?/?RZFCZtQXwRwGS ڲϱ,x3F~ /E_W׋Q ג"Ȫ5^ɵt2;op*! H?ru/JRJ%?<_}QV֙Iw8ԕJϼɺ1D-:mHL.G4Qse uǽ{/C_q+.ɕ<w19:lG[~U*F: Qܫw;:e=7PXo5Քeغ\]NܦWG)Os)s$)J)u6A=KvpE,Z ѯ|op2S{o7z1X]v̜9st###ӍۻwB`9s bZÊ+Xlζcǎ\ +--={h"֬Y@~~>K,!11޽{;>>cۡ#:|:e1 b휛ԓ1tHmrs? ㅞ7ze&۳0i3]wgHKCFZbPXA:%̾Q%I''c%}f$zx\z7hЕ}:`׮]L6 -ZT{.www.]'|ҥK9~8ׯgʕȌ; Ki1#^O|f+3]Oa%;4xٷr(Bs{/T4Bۈh_2 d-GM2_==M 0|^}UN>-: Ht@4r9eQ-7om++霛M-ynhȶaN w6߫ey.n;!J± t/.Ľ[>ۉA0 {` &OXXQQQh4lW.]h4NhhhI{:ĤtKgOsB93<~m2 o{(.`3h1Y:::B2 oGJVǏHnA:0 TM|>SΚ5o߮Syfu2\wlRRgΜ-ST|׌1Ν_tymÑ#G63#: vZ« |5+Jsp/*0ܔ rVRp+)ĥTVVQcYC꦳ˮ<ˤCh+-ѾQV|g?""ɓ'`>3=s=Gtt4֭Cvw3<5T~ׯs!**{1~w֮][O?ԩS/~^`ɒ%L83fS!`"i4JZZ̈Kqn^76g96LNz۫ ` v`5Bۈh_t@Zs\#vɒ%KXlyyyӇ{vFF6eccÇyxQ* 43f̘,_d2!!!ZJ'`YD y]+wB~|:vm:_` ̅A4)r l*2mB^]FrRǫq+6z|'z 8$Z{F*U +-IT m#WZ}%RF55ё 6aCCKKr6oػWI@#PfgO@vf; `TV-RXVX]8 y+XtdRnkiJ9VUJ yߜ۔ڑJ 幸ԇF F bdgrYG *^MIY¥仸IZ Q֌nk[Ah#1 ;Qbo!\Ja9%-?Mpri{*n::6J;yQfk[R3p))2< ytλm'XSm,h_i|~/`ǒ[i,_W z IDATB'ixèkߍ#'dnshR$N[imͅ JA+,1UM6}%W"d!Xh_E[1Bq!~5iozg7w+bL={щ"G'zJ*ZrF '76FDJDI y1v-qw))b8] 7ҥdSUu,%ǠL-h_iA .#MۂHrVZvv@0-۹ t >~m?W-7}d1&\ew'Sz8)Kq-)J%`$ZD~%'w@܋ } Nedxu6{^0y ΰхCH @cL9}" f=Z3%+۾ {0~`vC͗#i1R28nZؼT m#WZ}%"& f2]NRVg_QN[7LǺ$6 %ooJjR{m \|O88C +km][{TW\}EY?TU,F{dg)CDJKDDD0#b{]+rtt=@oMGGom~] bsv㗰aڳ"8O ôtӡT KvzKݺGRgA7>`:+-Ѿ 9 6}e9S~kt_w/ ?*p} þ-Ps?[޾;]NڎTq\:-˵n!gotHEigϥ>ɫ גBR}`QA+ fDt@V 7O8yJK`$m+k3}ae}#Rއ# &fe'Lt@Vqq׾-wUjj i;U~] C02o^C^ᖷ2 HJd̈b,4vm oSUic<^&֙یBF]:4v8ajmliDJKD$tMQƎ4m + frri,ʐ;rrl++:ؽL-h_iAt@LQƎM6+kF_<&hJFkdrRQhZ&C-WR(06FDJD ̈%BG K}N ʅP*ʷ,`Z3#Lt@*))^cʔ)x{{#Yr>>I&燣#}7ߤ~G;;;z;＃JeŐ /caR^\Ki1r >ypW(^ۥR{pͿUV⥯ J̈ܕç~JUUf@VgylRɊ+޽;~!geӦM=rݧw} 裏 /5kxQ^^?@Vx0 =kUk} peUc`DKKDJDt@3"+00|rssqpp -- wwڲcҵkW̙Î;ӟT{իWsϱz}Xt) .O>rF/2LH=ޮ.z 7|@JGbez=vb|s(ox*r&*lw/ E+XhѾ+xRrGCpڲPQQAddξTWW{~+n_!0a;#l>.3r(7K+ ג"ȫ5R BS#Lt@֭[ :ӧזbkk1gB#aܯ]A49 6cԩd2njp,R+p)UV֒ԑ?W$9  HOHII .{{{ glz)qttdԨQFꊉaȑ8::Mdd$wiV=Vgdffr!u{zzRQQ OOφOhv'o4ң}3ŃW,܆2GS~| N=S3?,~t-pN6E~*^OOʹҟ]Q)ZtU^Lju#;~: kSF u[/-Ii003Gq,Rws9}|j5_<븑ZFSWJm kuNRkGK~U*FϺ Qܫw;TȽm=7뀶}%u_G S:F3 ={6_}+V :yqL8Gg:uDDD'Nj?lfmNN.dzuRP_.mzT m#WZܾ7qtdwݐs95gsйug×Ǿo>ONTTsέ-HLL$-- ?c^z%N:P 0'''bcck6leee믵;uG?ou &MiǍ77o)߼y32n$ Hp#꺷!^Sn\ދ;^O =)ttơLmeE+%s}x3}%W"dڵk̙3G<22 N>豽{|( ϟϙ3gsiȑ# a׮]n|u@~JKK).. 11۷0m4@p6lRC=DKoɓ9{,+Wgw|u18r2t!8 fj䘄&gbb"#Glq{omаz=yd.C0/r^xT@ mضm2ׯhC&׿Uz/z-ٸq#ׯח7|%K5;r%בk4dxuE,\Sv&dxR1Ed> *\Kq û3*kO T3 55 77`r ˫ݯcklh_52qz i4-[G__nY }ǐ*F_<;n }*Box3l,%N4xL@vIY.12Y\JuHSm,h_iZB&;Ab)4?B d&_ºhF4r9iHыbЦSb=J¡L=BD^{U"M6}%W"I[왩9 &&KԩSzԩSHJJҫ5v1FɽA gqfuKvPp\x,r 9043 g).'P}(JI8ZZ@%R` 4|m[s3 pzv66HxDxcSprny@bgMs!8p9NK F^ƁQ0eM+}Ѹ⯉WUO#S0b|E" dlڴ ٘9s<33:3\:v…8zv9J[b 㡇֭[xbmsa"kԈ#o_Nyq_  (:)kU5۽WMRptM2(NtGљ(-|@s _puUs|4vJ@ /4{zC z 8!Г0i$,XuuuGVV8m۶ig̛7[lAII ׌;w.6n܈|s!''G:֭äI ˖-Cll,RSSY;& D]VO7kNj._㣠VKRC!qAw⏷_w S{a"صkV\իW ؾ}Z Z׶vtttR,Z Ǿ}0n8k$$$`޽Xz5N L2ׯFL@ -nM@_+¥`%q 3MRV[뉒 VwoI J7(^pp_J,?*5:% 87*b܋1b|E"puuņ aÆvl޼7o+[='NĉTlkh, `hIõ4!SZK#PYV`v=Gw  5ĸ7c|+;8 5n `EQ(Cu7\n"82dFѯ9rу_3.M 𮭆SK" kqowwgw2B"zA"AaX*t[x(,$J2#B*4DDRZGdfL@HA1yJEk>ĀR Cbܛ1b|E6ݘ̌ 5r t z ČKn=> $8Q ILD[q:& ֨-J׭I$_0 m2[qt"W{|0y\|-bXC{3W\Hsq۔J%.]DA*"==cA!Jh"u{=DEEku|]ꙹ[,݂틹_Y ( v-kqoI nN' rlڴ Æ Crr2222 t<@wƍ())u|M^˗/Gbb"=W^yW^Ň~C] 2 _cKD(;\lN dc[ z8$.B/_8y؁$ѯ|*u5|9=f(H;Yӧsà2{;10b|EAdCjͫO ֿx"VX?HNNۯP(oo?~\8 Eh Hpg /0l4*5S#FX"W\/11@:_mHLLSO=ep܌TT\{i?13A"AR)NeJl  eowD^}2D;X&c'm&1F "Ѝ*Q4  0~8; w-u@{l#" FQTTn@llNy`` |}}QXX(j-/0Q@ ,έbUptjT}+L׈}r+Q_[ 4;:B}q8A({nvpҥ( ӣk:& t& tU,^_n=B'''d2}^^^P(_hw)K|0o[!k{ ΍J[h 486E{v׺ASO|t贍!q޽>j8_¸e, H7 s='E?Y+ɩpplа RNw77]࡬S-/]~F_~q_q1"16`BлGjXvv6k[555 Q[[bhjj;OUU||:XOlUL't]8PSwůq⣓:ecԝh7_tʪEu!`ge-ӆc@'] nفӚ, cQ^bQ%yeW_A~5e&1R`?__ul.R=:~'ÿ1NNwB|^vڃ{茼px} ;H߱#gɷ:e- -1u'~ԝ頳~MЏ'6>+X㉍~~QA|&[&~T*`d2cǎ]>ś\]]oի7aHR'4ewH+#3rXf V^-OOOtm={`ԩO3x衇_}bڵXlαyyy1b|+XבW `}OOemusv?~[7 xb8c@~c'I6C|j0 yNhM_R80 {:Wv\ IDATS'ڵD`P9<Nӓ Vp|7Qy+yG 77ÇjNԈkfӶ=11ǏǺum۶!##۶mٳ;<> o>+`ں&LիWm6sxzz"22$}!qn3gy2A# 99/ x'L$33ӦM3k6kl4vNɩM#""kqc@L1޽{,̚5 K.aɒ%5kLtG F@h<Xt)>S_&E ]ۇzܼyPXXlɓ1` 0:Y^yZ ޘ4i;t̟?QQQwsuDžPdҾP[yp'@+X-Y_LDDt1vݻw))):婩o#G`̘g2ܽ{7g+P^^} ylǀe…9s&͛D;wb̙5knܸX6l@vv6qlܸ˗/ƍ;>p=}ja86-ZCV;)Tv:[рUrm_=NDŽwoVV$JJAg}? M+" mYΖ!(((@\\^yO)p|||+ߒuuZnwߢEhѢp,y߬ؓGqv@ã\p,:uʯ?z`{\ 믿}RRBCCxb|xꩧ:& DC#UZgN`ӗ>86$U4;:SLTT222T7$DVUUU5gy/Ƒ#GX1& d 4_T*7D2aQJ+Y ^kSBa#ىhVʺ1wn]!..YYYP:@111SNwxJ L@Q!u@Md,LBGKsgc.H(~m&.cK]+4wdn'2P8شi1sLmyff&ufj ѣuU*n݊ѣG#0ח?DzpG3mq,ktVF\)@sp2 ԭnY]JWtq0ɴR1b|nIII4i,X :t?<8wyGg`y˗/kΝC"%%YYY̙3q9[N[~O>?999/pB\=Lb~Sܟ!Y;gp7C_relb&jcq1b|Ţsiڵ +WիQUUhl߾]ETV6舃bҥXh}aܸqz}T*ū \DH_b>i1! 5PT\ՌiDDDSW^j8ruuņ aÆm޼7o+Gfffdž/I3ɂZ&DFm'nYi]Yǯ8 |vU@Y&UmLkq1c˖(Zmo¸d1ʛ}p(9=Tk$8tP㽁M?LAOdep`d a|-ǷJyB& ֨()jpD Qw/XZfdOj? +>X\l:5{Ϙ%D  BBB{#,ݜލ+>X\za|d & V$((YYYv횥BDDDdc@v02l`BDDDdl%GDDDDD+T*`d2cǎn J nGթ'^^^xQZZj[RK"11~~~JHOO7X;|ggg 8TwΜ9!C+wzeJR &N-kƗrss)2BnnB>w;RRRtSSSQ^^#GXeKvT*|x- #<ݻw6xv'Gss3RSSuΑ Agqo:_`|Wh\rߞJ|5A8̏ (((@tt4RGll,Ͳi/"ၤ$O}.\@SS􎋍q-s6fu'חy{{{-BuuNƷsӾ״o޿Dt/Nk """ʽk<== &Ν1a|WHLLƳ-w F@@osKB'''d2^^^1l0#&&f8x ;WWW`|_Dcc#V\ _yqL@W6l ~رHNNFll,^~e$&&ZuDݗc=x̘1x饗,2۲j*|xo:ŗ9q| tJɓ'ɓhnnƳ-wD"iK477`]] WWWaoobڵXpi % ̙3P:}tM='HLSNǠAhٞIJ={^~ y7kXzzv[l>޿=Q|W,N HNNRDvvNyff&1j( w_|x8::SL]T*p!L>݂-݉eRRsLH$L6\ͶyhllĘ1ce_XjVZot%"5k֬t#w矱i&ov܉_zP~ĉAEE̛7W^'|0V>:tagg-[=ɓ'?~~~H$8}4Xd2H$_---Cvv6^}U̝;s̱lg-cʔ)hnnFUUΟ?>˗/GTT{oXb0|\rEgׯ[J|/] ]& ? ((%!}JRx饗 I6lcK7B||) O?-?~\nnn0qDUO.X+44TH$D"RΟ/]םX,899 BzzR%Y|ӧ aaa$ |iGNKDDDdB'"""""aBDDDdg^R4C&!>>;vұW\AZZ TO>9993f \]]TܸqT]!0!"""yֳӱeYȑ#1{ldeeuz駟'OYːO<wENN{1ܺuˤ}"""""ĘLg޽AVVf͚HHHKd̚5 Ri'$$aҲdDEE!;;[{ΰ0;1^xLO@lu<ٽ{7ݑSr9r~DW^^'3f "##{n#{@LzO9U.,,4u ..No_llv?Y'& DDDD6:+ x{{땷) ]{-S]RK۩SD]w7p٨ s.%$$cCUUv)^T!q0!"""QEEEEWsv|xJXUVUU^+:k*+66u[nԀ|4inf%%%)66VM4ш#~m&I}L={ꫯV\\n͙3GOgϞ_Ljժz+ 66VC ӧ+W\\5k֨VZ4h$iŊԬY3ǫVZ?AѣGy<>}ZӦMSӦM뮻Ng֙3goӦM;Tvmƪy4iM4#Qf dv*oѣ>-ZFUz :TtkԩS7oڴiժUKݺuK/&c.\nAqqqjذƎ.h+V?7xCݺuUW]qkjj޼jԨ5jCZp222xtA-^XZR||4i'xpرjԨziر:ue<UU /.l0$I={TLL֭[}믗$}Tn]tMW_}UK.mݦ犉G}e˖iݺuW $I8zգG\s +Vq8pjժ;wjƍUFեK]uU8p1Ç+''G˖-nӧO'I5jZn=z(%%EǎoCPs X О={4`UVMk׮լYg[o%K4fլYSTRRl٢zJ֭ӻﾫ>p~ҥ<>}%c<_] Rf.i>}Z}ю;ԪU+3F?zj=O2zhU _ZժUӺu{n+&&&9^Z6l/~ 5J6ydUREiiijР?͛7Gݻ /=c=m۶)==]wq^{5͘1CNR:u4m4_=zЦMgjɒ%T6\bTb;{W_m{qo[q 87_ӧOJ*桇ߺuqdeek(++m֬Yq~qСCٳg/=cLN8UV?7yeeegϞZjСC~u8cZha??uIKK3?jժ۷X=q >ok1M6 z~3g4۷_nf0㘫̜9q zLkf1|ot݆} ;\OA?SmٲE9995k{͚57=Xnܿ曀ݮΞ=b=^E=s:xf͚3fݶsN-\ /[m޼Y۶m 7ہ)߿_'8tPЏx6;طרQCZ޽{}BvԡC}*((~Y_|!qt}#wyرCڵkk߾}??Pqqq~Ibb9 n3F6mtnK[Z;5kԵ^C/}֭'_?ccǎv 8}Y#` yxu_Z}v7߀xw~>|xpޏTѬG}TOְaÂ~w+e#<|tM4mTƘz뭋~?nĩS4ydI^ZjZhc:qoWΝu-_o+;|:rHXΰadcQQq9aÆƽb͙3#mO֔)S.|>:oK ~sϞ=zj8qB-[{z//Zjڶmo]}6mڤxmkIJMMUÆ j*UVM58/ƍ+33SZdZqjԨJJJt;6lO>{1;}5p@JII޽{[oi~ٝ$jJZ߯U^uwky\s?CGV5p@խ[W۷o׮]ԲeKegg˗kȑSÆ j׮]D)6nܨǫK.땜C^S*Ubkk馛nҝwީR^ZEEE0at;^n4bwSVtZj*11Q?~ԅҹfzGm6]wuڷox w}ZjOh.uY>s]wƍ8Svmw; Zlo6m͙3G3fɓէO޽[ӦMСCtR߼2|'|RZxx m޼YݺuwׯF#GhĉJLLԞ={*V[Gzw.zg߾}jѢxJ׀T$--M__J:׀"X 6TFF}Yy4m4ݻw%K4fܹӷٳguM7FڵkrN{7⽯w8NXBoQyyyZp?^zZ`^}UTkȑ~'ܻ ,ȑ#}mVڵS֭%駟V^^}wzoL>_bb}^RRڵkyzhPz8nͷDJۀL:U#FѣGn:=:u&N(I7n^z]vsvlI@UQFjԨ$o߾}9ְaÔ>WBB{=X:uTVVSN}єt;-)) 8wT?+=Ç%@IIIQJJeTZPǎV1}+?i|G[||󍊋}]Gi޹??#_styÇnbgڳgMed֭R +:y|c}UllVX׀XB{_Fݻ}s˵rJu 4-ܢ+W턵k.}zGwa?~\+Wm}ݧ?On>2|#c׮>LÇi@.Sk@FZjcǎWzj˚0aԩ/Rփ>f͚۷k…jݺ~_iӦi]nvÕ;l0hz'%Kh߾}ڼy_ٺ5`9RGդIԦM-/ԲeKo >111kGv}dl"UK.Z|y?~\5jP۶mrJ=Zj)99Yב#GtY5iD?LՔ)STfMhJIIɓ}ߪ2|h@uf͚v |#c>2|h@uؚ.򵏌"_.E24 BQgٲen>2|#cQ"Gv}dl"9v8@:tP~~>!^]924 B@Ѐ ꤧ]BD#_.򵏌"_;D1cƸ]BD#_.򵏌"_;v #xvx@ЀDk׺]BD#_.򵏌"_;D\KhkE]pEa׮!C dh@u233.!}dlGv/ N>}.!}dlGv/`vUo^r dh@ Ύ;.!}dlGv/ SO=v |#c>2|=pQSh*>>2"Gv}dl+; :G.򵏌"_.E24 BQgn>2|#cQqn>2|#c]*7^]924 BQ"Gv}dl"р L0"Gv}dl"р ,^"Gv}dl"р =]kE]pG dh@LU B-;;['NtJm߾}:qDVXRfM]!{p|#cQ*}y?8gѢE!?<ְ]kEw1Ƹ])((Pۻ]wJ+%t$ w2^r2xEBQ"|#cQgذan6ְ]kEw4 :fr7"k.򵏌"_;Dv|mc E]pG d*]ǫN:ҥ^xᅀݻj֬Dw}:p@.ZHUf4{l;z222uE[l z͛7+--M JJJRff;veXk@;5nX?AM4ѐ!C4g߼BCZz~?W׮]v3gƍ_7nԨQ4w\=o^YYzꥭ[gѺuT^=Wo۷;TJJ֭[ jիN>m/ \Բe.!‘ma>2|Lܹiܸ `͉'|c_~1'NXC IDAToܹO?7c1v򍕗VZN:ݿcǎuٳw}8c}٠琟o$y1Fv wJF2A~FU0n':gXv}dl+WH:uT/v///믿O5jiܸz5k6lؠ2eff/33S]7fSN*Uhڽ{>,I믵g 2DD͛=>B/''"|#c6 رcZdz-=c/:unƀiF_|cP{~[>޽{+<$\1+6U.r9R${b9r$XTvծ][}WUzuMLLKJJJ*<{?@4 ԩS5b=zT֭ӣ>SNiĉnvQ]JF}۷,Y_ך>}TNIޱPIIQbbs׎ԩSAz[1gEs?&B/=="|#c6 ر˵~]{G}0?_Isƅsu־6mTxLI?+{1뮻wA$mܸ1dF_AA 9sƾ+o|ѢE?~Xiiӵc܀ %iРAGF"< t8ƌ1f̘8)<y^5mTm۶ոq]~2C 1UV5EEEc dիtɓ'JJJL\\9r͛g<|c>qǼ{3gΘVZ4wɴioޝ;wqҥKۺ26wZ^r#FVZرի"^Z/&LxSVV:v쨻[&Mɓ'5c %'';^bbMӧvں+++KÇWjjoaÔ'TRR,Y}i~ufggo׀4rH=zT&MR6mv@4t H.]|r=:~jԨmjʕz}Zhm۶iĉUjUK ,cʔ)Yrrr`hɚ:u߼i„ ;vJKKծ];_^]v۽{w曚1c~iV0cEuAj߾Dk{qJ˻N|IZIʷ@Rΰ"_.kW.b.B.Unn%D85lGv/ K/v |mc E]pG dh@ A{Xl#_Xv}dl"р "|#cQpG"_.E24 BQgǎn6ְ]kEw4 :O=%D85lGv/ ΪU.!‘ma>2|h@u.!‘ma>2|h@ A?~%D85lGv/ Nƍ.!‘ma>2|h@uƎv |mc E]pG dh@ Naa%D85lGv/ ΄ .!‘ma>2|h@u/^v |mc E]pGma>2|h@ AvG"_.EA)--uG"_.Es1"pNAA:t|orTʗ:- txvx@ЀD"Kpkk.򵏌"_;DaÆ]B#_Xv}dl"р ̚5", xa>2|h@uر65lGv/ 24 :˖-sG"_.EA)((pG"_.EAqG"_.E24 B@Ѐ ꤧ]B#_Xv}dl"р 3"|#cQO>n6ְ]kEw4 B@Ѐ ]"|#cQ'77"|#cQ祗^rG"_.E24 B@Ѐ dff]B#_Xv}dl"U$//OCU͕ {QAA߼ y<n!q-ZTƪYf={=zTJJJRBBt-[=͛%%%)33SǎpEX6ְ]kEwU.Zt;GyDZұcF;w[o={i֭~ 89s4c Mn8yzRvt?R}q!Z"|#cR9shܹ5jE_ z|cuQYYN:0Du[RRth 殻RzzOZZ(qFZlXAAUTT7>sLegg}WJOOWaaE4~xRݛtA~˖-C*.4SRs IX?^1\I&E!!]Õ<<\kMm۶ɍ`*Yfqٳ/>gϞ5q{=|q̛77֧OӲeˀΛ78c>l1СCq0E;Z_~~d/PS)H~g+W)yǕӧk|W^yE'OTZZoo߾Պ+XB{_ڽ{o\+WTΝU~}IR t-hʕ}swڥ?\{=e "T7fΜ}ꮻҮ]~$/T׮]ꭷ҆ 4ydedduկ~;^bbMKjڴiھ},X, >\Æ SV4`j8pvavv 5`m޼Y/6m} s۵ma>2|*E诿ц aٳgUV-%''k:rΞ=&M֔)Sv2ej֬-X@)))2|c.Сվ}{S)_@3ڕtPyрD O|mc E]pG3aKpkk.򵏌"_;Dŋ]B#_Xv}dl"р =mkk.򵏌"_;!C dh@u.!‘ma>2|h@uJKK.!‘ma>2|cqSPP:(??_۷w (:%N $;^]924 BQ"|#cQgذan6ְ]kEw4 :fr7"k.򵏌"_;Dv|mc E]pG dh@ βe.!‘ma>2|h@u .!‘ma>2|h@urrr.!‘ma>2|h@ 24 :n6ְ]kEw4 :cƌqG"_.EAӧ%D85lGv/ 24 :k׮uG"_.EAuG"_.EAy饗.!‘ma>2|h@ 24 :n6ְ]kEw4 :|Cmkk.򵏌"_;Dx"|#c@ЀD;v]B#_Xv}dl"р |X_kϞ=2d<8--M͛7{|^vv%D85lGv/]k@TPPVZIԩSiF_|cP{~[>޽{+<$\1+(--uG"_.Ed:yN*I*..$ծ];`nڵeѷ~[zuMLLKJJJ*<{?,Kpkk.򵏌"_npO_|Q/Vv.8v +*; YYY3gΝQFԩ#;*))8JLL-++өS;c{ DJۀdee~&Mw۵^8}Gu+&&F\qoFjݺoM6Soϊ`.]/I7nTzzzGe˖(===` 3g\W_)==]~-JKK;v\/I r<͛χT )]Q$i/Fs /_$ic\I1iҤz>"<|>[+ϣ("C {[e?/7#77ZiӦj۶ƍpHnou9fϞm13f̨pΠALzn;ydXII3#Gy1}og5{7vӪU+wN:6mmûsN8YtiК-4v ŷ6"_.kW5 ,0;ڵܹǫԬYtݬ_޼ꫦu֦aÆs1L:l۶̟?ƚ_~L֭Mƍ͋/h6mdobbbo7w۶mZj{56m2/iԨӧ :4\ DLo}dl+W=zc x<~sM޽MBBU{g1-Z0իW7M41YYY<`ޑ#GСCM:uL\\ҥ zM64gԩc222̱c*<74*xv*.X[n۷צM.iرc5v؋KNN֊+.阽{V޽/i. *E*D"_Xv}dl"р ]B#_Xv}dl"р ]B#_Xv}dl"р!C dh@u.!‘ma>2|h@uƌv |mc E]pGӧOKpkk.򵏌"_;!C dh@u֮]v |mc E]pGv |mc E]pGK/]B#_Xv}dl"р!C dh@u233.!‘ma>2|h@uX6ְ]kEw4 :<%D85lGv/ 24 :;vpG"_.EAyꩧ.!‘ma>2|h@uVZv |mc E]pGv |mc E]pG dh@ .!‘ma>2|h@u7nv |mc E]pG3vXKpkk.򵏌"_;!C dh@u .!‘ma>2|h@u&Lv |mc E]pGxbKpkk.򵏌"_;D'|mc E]pG dh@ Nvv%D85lGv/ Nii%D85lGv/c1ns ԡC}n]R$i$~g+; B@Ѐ ]B#_Xv}dl"р 6"|#cQg֬Ynf]@c E]pGÎma>2|h@ AYl%D85lGv/ NAA%D85lGv/ NNN%D85lGv/ 2 &O>JJJQVVV y<n!q-ZTƪYf={=zTJJzPv IDATJRBBt-[=͛%%%)33SǎJ5 EEEO9sF$9tn\\vK/̛3gƍ_7nԨQ4w\=o^YYzꥭ[gѺuT^=Wo۷;TJJ֭[ jիN>ˑv |mc E]pW~&Mo$瞫pn*Ut-񊋋OhĈz'$Iݺuә3g4m47N-[tn[O>D;wTN$I=zM7ݤ &h׮]?^zW6m[oUC]~"cƌqG"_.EtsEK҆ TVVLLcvZؚ5kk>sM{n>|X_kϞ=2d45o\k֬}qG"_.E Ŝ}-[w޼yqsac12쀹-Z0wqG$IN|#׮\T+ɓJKKWZb+Vqs=Pwkʕܹׯ/IjРn\Ro]{t@x_^?t IvzW$I/tQ 5k&co߮ uկ~;VbbMӧvں+++KÇWjjoaÔ'TRR,Y}i~5fggo׀4rH=zT&MR6mDJـ5J_~st^ZW8:pjժd͟?_GٳgդI=Ú2eJWSLQ͚5 (%%E'OԩS(//O&LرcUZZviڵݻ7Ԍ3xOWjJـ8ۻsώ $FxPP rb 8@DT#bU4R%-?%V"0hBP5BIH*h+F")f@ yZdԕ~Nޓdx+rT,..Vqq;ӓ~\5#Gȑ#j+,,BIk"_{dl|t@b푯5:l|푱-Eб rƏ!G-GƶA3, <ihk"_{dl|t, ٳg=Bȑ5:l|푱-Eб r-Z!G-GƶAҥ#Zö"_ ϰ "gԩ~rk"_{dl|t, =z=Bȑ5:l|푱-Eб r!E"X@xgX@9~rk"_{dl|t, iӦ=Bȑ5:l|푱-Eб r͛!G-GƶA 5:l|푱-Eб ϰ rf͚!G-GƶAȩ{#_kt#c[䋠9C;5554h5p@ZSZ=ğwzϰ "gϞ=~rk"_{dl|t, "G9Fm=2E:DΌ3!f=@a[km/+VX#_kt#c[䋠caA䔕=Bȑ5:l|푱-Eб rjjj!E"X@9{#_kt#c[䋠caDNAA#Zö"_ "gʔ)~rk"_{dl|t, |G9Fm=2E:aDΒ%K!E"X@9~rk"_{dl|t, G9Fm=2E:aaA=Bȑ5:l|푱-Eб rxXkk"_{dl|t, =Bȑ5:l|푱-Eб ϰ r֭[!G-GƶAw- ӴiӔlskjj4rH+##C^{>ϝ;wrrrԹsg}կ~Ƥvڥ'*;;[]vՐ!CjժYUUnݪCjϞ= 7QII:-_\w}~j 544hĈZzq-]TgqFk&o+PnݴtR=c҈#vp*8-{#_kt#c[䋠K{ճgO}{gizHiiizt'K ޽{kΜ9zGxGtwG$]z:pOGTVV͛7k$NЄ okΝ>Ln!Iyyy:zi͇~_~I|1M6ŏ3i͛7ǏmڴkJtm<5\@+IL\ffs ?uI')---܌$kGzC M:B|a[km/. HеKN=!E"BdeeI;))###~nCCMj:kGzC =Bȑ5:l|푱-EЅr9s{/szN:Ii4?_ݫ . ~,77kJ=-3f >~!^/_O]O>O7|SsQii&MEEE۷zJ7pmۖϚ5KUUU nPnnn8F-Gƶt,zbb.%%%?ynȑk׮SNq\s裏Z??|wI'={RؘtnVܐ!Cʕ+[+\^^KKKsYYYnĉnݭ7Ǝǵ#d,1Fm=2Ezbεn~\MM j 8qBkBH;4TRO˻Wª?3t#c[k,=KZö"_ ϰ "+5:l|푱-Eб r!E"xUp<8`y:*XZaDΞ={!E"X@9EEE~rk"_{dl|t, 3f=B{Уö"_ "WF-GƶA3, <)++{#_kt#c[䋠cA=Bȑ5:l|푱-Eб rϟ!G-GƶA3, <3, G9Fm=2E:DΔ)S!E"X@9~rk"_{dl|t~߶mۦ1$Iݻc@m۶Mwc$غu+KbA,YDW_}cIkw}EI}$tOl4!0ߍBm/S^^_̦b[#iYypöA/#r***!F-Eб ϰ "B|akk"_ "wF5Fm/3~xG9F5:l|t, <3, u=Bȑ5:l|a[䋠cA̞=B|akk"_ "gѢE~rk[#_kt"X@9]t{#_ktZöA3, <ș:u#ZE:DN=!F-Eб r!F-Eб ϰ rjkk!F-Eб rM!G5Fm/3o}JJJԧOIRYY6oެkÇ /ԴiӴa[ٳGvcIk[-EЅ; ιV?ب^{M^{m|{.Lc˖-SCC QXX(眖,Y?VYY!I'p&L~[;w[1***{#_ktZöAd:u)h_܇~_~I|oViӦCy:ӴyM6zMI {3f{G{УöASOUIIz)YF=jZ|~J233)眾'tҒȈ_KZ  8B|akk"_]h߿kܸq}ݧ|)i)+RР,I}Ǣ:b1eddHРxnӵmM?1cƨ #///L$i*((HzɓUVVpFI'cUPPڄsԩS׫@֭K8^^^2t7r!FR݄;QIofJXkv\R}}},[,iDҒfǖn&݉Q߃>tz$:8J.bN\CC;pҥ뮻λ X,6nܘpΝ;],s3gΌw}I̙3],s;wlqj'UWW yG85TvkV[|D Xɝ4Ez"/B N:)55Ucǎ՟'۷/~۵zj]s5cGVΝs%\S,W_?6n8&acc^|E]r%:3nGTSS!G5Fm/.r7W^8p233m6wݻ /+--E]J=C:u_R5jyjҤIɉ[TTף>l׶mTUUiH6|G9F5:l|t]@맊 ͟?_Sff hРA?|YFw:jĈ3gNjPzzϟ9s[nz&שS'\RӦMSqq5`:t'QhOw_8pVXѦsU\\|N?.R_, ^"|akk"_ "gʔ)~rk[#_kt"X@9~rk[#_kt"X@xgX@9K,{#_ktZöA)//{#_ktZöAȩ{#_ktZöA3, <3, BG9F5:l|t, !ZE:D!F-Eб ϰ r֭[!G5Fm/3{lG9F5:l|t, E=Bȑ5:l|a[䋠cAtB|akk"_ ϰ "gԩ~rk[#_kt"X@9=z{#_ktZöA)..{#_ktZöA3, <ȩ{#_ktZöAș6m#ZE:Dμy!F-Eб rxyBkk[#_kt"X@xgX@9f{#_ktZöAȩ{#_ktZöA)--{#_ktZöA3, <ٳg#ZET@-[=$)==]{{WTTK=FI"_KtFm/$&Lq[n 2c G~zt =:l|t, kIc|a ꫯ| 8B|akk"_ H a/ "B|akk"_?ȩm!V#|-akt>6۶mkf/рLg +e, =Bȑ5:l|᣷m6wym>ņ|' o>~0R&p#^);~ gX@9~rk[#_kt"X@9SL< rIDAT{#_ktZ{#_ktZ3, ۧu]iii0`*** kF/f̘e˖颋.U^^hdG9F5:l|l, F^uUUU'ФI4l0=S5jN=bd͚5B|akk[#_ JO8^XX;vhƍ>MlG9F5:l|l, F6mڤ>}(%%1\I͛  {*333xӱ{z=;I{juuuϷm|/$}ن-T3g_%I]tQ׮]xќkqMIZrݓk޽{]ҖWI ozz<ҹ+W~L;ݼÇjk%NUVcO-pKl9H1{0Or} h"tMz뭷t%$|RRR>ƌѷHǚ~ 6LzRRRϷz>˗[ƯnK]tQ^4a}-KdkUUU5jwΝ;3Ј#oz>8>"5j(z)f7i$…  .-\UUUڝx7L8w͚5.55Ս7UUU :溆6̝{nƍ ?,o-05իWln&?t6_:|l<؍;=nڵ_t?]zzۼys¹Qsdk{q/[vt_~b_L8g Hb[hQ|׽{wΟ?b1aÆF׷o_7xs/"w$\ﭷrX=t7UÆ s;q=Ln善78y睧̷?6C{2>h d;wMݻwק~?Kd$=nO-IMM)ϸI;, hӦMӧOfI͕$m޼ׯ_ݴi$zn2߿ ?CeeeOԹ瞫ӧkkOG>TGۄwL}o߮}&<Kd$=|;sؗö9nͥgy;]-B;&tÆ s }$ n 233O?VZT}7[b7nԩ[vmsYƝxkq+Vp ,p[]]q̭X-]u].55Ս9{˱fs/v/;eʔCa|go>u͝tIIĉ]JJO[ouYYY.-- 2ĭ\Ybsiii.++M8޽쾂:>]yr;wviii /t3gΌ_ε/X,HIIIMt3ٳgB~+ya3z5ٳg/effTwi+½->8>s0oK<3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <3, <\!9mIENDB`pyepr-1.3.1/docs/images/water_vapour_histogram_02.png000066400000000000000000000767421525260221700226740ustar00rootroot00000000000000PNG  IHDR XvpsBIT|d pHYsaa?i IDATx{\Tu?(h(X*.i(mQA[k^ʒKòMkytLJĆͬ 8xgyy7!4`л"""""zp!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"""""Ͱ!"JAA .tΝ;[}===Ox~<<}[n5j@=t>>>pvvF&M0zhfBϞ=)))t kѣ֭ <裘={6]fQ`@=/ ::~~~pttĪU#FkתW\\C ahڴ)\]]'|}m`0ڵkHLLD`` #`̙~m߾O=իggg4o r&MT{JTrr|e2S]rYkhѢ鉠 9ǏPSVVsupss'uO>jMB,Z>(\\\ШQ#ʕ+VsMKK`U_[nSf6lѼys۷ǢEp `0PPP%K $$hҤ f͚ej>SthРPVV& уAj ѣqF#((p%8phӦ ?ѳgO,ƍ'N^2e \|8q"ۇ5kX믿lDFF⩧_|ӧ Gbb" pl߾K.Eee%-[&  "ґppp.\0 6Lԭ[WܸqC^KNNf㊢EQȑ#EeeeCBtI("kBBB`4?~b^yyѣU8}kݻw-Z˗/DXXPE|G'NZju|m3F("Fe6@7c (عsٸlf'Nu3fT(0 Vm/(bĉ~())1ۭٳg EQDdd1;wN:u Gff&~g\z_~~wn1fMcV^^^h׮vڅ#GN%3UÁO'@۶mk ())Ѹqc<#׬1_+'|b~N.o:ub,X_}?RϜ9c}۷knMDd "U эn~h?G7qD,Z=~iXr%N:U.]pfΜY(bcc}v7oikGk͚5ӧq1w]ݻw[߻w܎q2k^cBD3~oZsNom@x׮]f7QFYgQ706 SLb >jŋlIII())11ܹ3_+WOKK7|s|aO?sYpvv6n@I&Ǣ"P111qXg6;ڵk:uLT]#')ED36 ?#>֭CII Zliv{ ?k׮E۶mѧO\r۷o+ڶmkv5QFXv-jժƍCQK@tt4rrrl24k O=7n/ĉصkbbb _v`p +W /֭[1xjv!!! /GGG|8~8{9 >4??BBBϣVZ?xyyᡇRu!$&&bȑX|i^yy9:t_̓/,Y/֭Y{F~0~x;w'O_SmpڵKzO~~>ZhCꄅ_~ɓ'l@>"5BTT}]ܹsC.\lbccgӽ+++ѦMc޽?z*{W{O?cDDw\^~}ӽȍj[mٲf_7/Bd6{𓃃}nx߿#F0$,, ͛7륎NoKo6DEEEؼy3惈6 BTTT… Xln݊_lիWGGG4nqqqB,\cǎ5޶m[kZp^o6233wߙP\\ڵk|+///ŋQ^=y1\?{6Pz8t78""{g ȴi0zh?7nk2L<0azBv /`ŊxW(_"""""lҸqc4nзo_70`ߚׯr=h Gǎ^xb1énuk Mג~~~zalcǎxpĉj!Si]?7={ŦSo5><8~:mު>SCalB$Mc888YfpU ggg5 iiiP7 0ƍþ}Ls+**zjtdfSǣ~8y$aÆiӦB`ΝXhZj/yyy!11IIIW)))5jMscbbtR 4̓-[|ddd9| رcqy$$$ue˖ 9'''f3cfrzLs#\ҥK\V˗mb6lX`Ν;J4i*NjqǫSK.… )SnL#..h׮6oތ]޽;+L>puuE~`ԪUކjѢ%f&07FZ$** QQQ8nݺJC\\m"--Fݻ7z"""""{f"$"""""s=w 6an139M=f&؀]شi%f&07FZcBv!99Yl3cfrzLs#ED139M=f&|]ջ.!"""͛]ٸG ؀]0~zjlRjpo=6 dRSS/]MafrzLsSoÆ -[6/B'sWcfrzLsS///O؀]Xt%f&07.j i i iw"7]MafrzLsSo„ s?~{^rr2fΜ;v{FϞ=1c ̘1.Vx{QQQQPPMMֱ!w 6an139M!C`׮]վn+*(nmOz헬cBv!""Bl3cfrzaaaX ~|P׃bcc1tP4nөS'.UBul@TXGx;...6iٙO>]v'\]]Ѻuk̝;f4i@xW )))n^b0_[c͚5 +4h^z a0Ά`0m8sAPPx\vb6lѼys۷ǢEpƍ;4† .039M=f&cK/L<CE~~>F8!0m4DDD릹=z_~~ po&FSN!** 1118|0|I\rk.:t(,Yݻcܸqpqq… 1zhSLW^y/JJJ0qD1BEREv!==׻ 07֭[.Aw`4i3]s1gOW_} `ԩn^qYj wmqqL6 >>>ͅ?`ܹ6l֮]'Nয়~BݺufB6mzj̛7 64ꫯ,$!^z%Y :uj-~BvO>ѻ07޼y.Aw+W$&&]z fQ .Q1*++gj>͛gqUM曦\]]/ƍ5kEQLa޾}؀ى@Q͛_MxT|IT1KQtbQFK.#!!=a0`0бcG3gTퟴSĕ+W씥[ƕ+WPN>4h` ԩSa1xcjeeiر# ЩS'DEE^zpttĥKh" Nxzz ѴiS (i!}ܹshy*ΝS=5VX= IDAT$''cfٳ-g`]ֻ07^rr%.44Bdgg[v1>}&Bv>uɓ知};ǎ 8ⵝ;w޳3cfrz;wֻy"xee%^u!/> GGG,^O6 !0eʔ{,YYYfܹs~bBvaСz`s3۷%.,, (((@Vxm7nD׮]1iҤ;GӦM1sLM67nСCݻmڴQuZs_z%ԫW'N1yd<ܹ3}Y!"""zѻjܝ͛vaɒ%qu<#={6.n(V$$$QFx뭷rJԩSO=ϟ>}]c"^î]ݻwc֭hٲ%}] k׮U҇"ԴtO}1_IDDD5sGѼys*Sѣ һ )+4hPֻUj9!{n#139M=f&g|>EupQhTz6|j2UTTo˭^$Nd›oɿUbfrzLsSoժUc mg}ӧO>hԨ.^h߾=bcc.cl@.X;3cfrzseӦΝ;#<<| Ο?0yd899\!؀]puuջ07榞%<0ڶmO?T2F6DDDDD6 DDDDD6 dJ"f&07] z`s3kذ%Q !w 6an139M?z@D544B^^%f&07N8w DTl@.]afrzLsSoѢEz@D5']Xd%f&07&O]v|hTz һ { ޮR=f&07|4o\j=zM56 DDD@0~@K}K} (-] مczq_|紴4DEEݳ:u >scfrziiiz4m#GČ3 o 3Я_?ǁP^^@⋘4iLz!8886{? 1sL$&&7oތg}ӧOGrr=;n-l@.]}v;/^XjuΡZSanꕕ]}ɓԩ5k#G| ۷gϞ111HKKC@@ OOOٳIIIĶmx#c^f=zK^^ f Hff}DFl@.]}|h}38^C͵33f >˸/dgg#%%IIIaÆo߾XpIKKCZZ >ێ`ҥxW={Ě5kij@MF>}sN\z...\]]qm`B@ggMD@o" ""7Mc->dYԀرcMXl߾wF>}P\\oP6 DDDDvm۶Pbqo<ￇz-qrrB^^ 007n ;;޽;>}`ǎ`vDQQ.`fjq07.]w OOO㎎qu̜9mUmdz>7pe uAsAKALךzLsSͨclRBCCqƍj*++gF#33Ӣٳ'8K.!33uEh(O%sl@.~2.&q07׿]MqwwGHH:ۣ=z@Qdee!++ -ZC=#7n~cǎ!<<``cBvuE33k~|^õk+WX~%8pl!!!صkvmvUXX1w\cBDDDB=::ƍ_|f͚_DBBF>}ꭍ{~ f 3x ?4*k@9r/wXd~6mBII 1a =zX}aÆV6&;;[3FYFdggM6C EQĬYL9"<<|8NB̙3ؿ?͛gj>f5oׯgr-]Tl33KHHup?1B.\e˰uV?(++c=f֭[رcvСC[5l8|iСCniq5NDDDDo@Ǝo!.\cyZԫW}Ճ.]B P\\ڵkbi[pjy~o[IDDDD dڴi=z4Ο?7^CYY&OwiуfOjܸ1BCCѷo_,[ _"ԯ_o,x"E׎\㶌sۦ[Y[IwGdd% f&kM=f&gvDt;ǏGf~bޏ? 899uU={hժiuniͽu<34 Æ m۶_PǏGjjXnn."##QTTd6>c ̟?lԩSŋ1i$RDFFbf!CqԩS.^>-G,!6TxUr[Te=w}f{,0XsE:,~{'s]_{dDǎѠAaݺuOo:)%%;vs=\zӧO/D$%%^zӧ;`ԨQ6͍ҥK1h ̛7>>>Xl󑑑aVѧO 4cǎ瑐֭[[/;DDDDDk@t邕+WbժU|2Ѷm[^Æ 3kѢ1yd pttD^pBk0N ,] .Lbz2338]vؼy3vj6{ꫯ0}tDFF PV{}(DEEhnhh(o^qqq<___h{F޽k4̆ п˰103cfrz;v9rDJqh"kj`ךzLsS/330|p+![w v مO>Dl33ꫯK!ၠ ˰{l@n#nBDDDDD?6 DDDDD6 dlLךzLsSan56 d""".13\k139M=f&؀]:t% f&kM=f&07""""" """""  wֻdp07FZcBv7Իdp07FZcBvaڵz` 53Hkl@.] bf2cfrzLs#!"""""Ͱ!"""""Ͱ!0i$KALךzLsSan56 d.13\k139M=f&؀]ӻdp07FZcBDDDDDaBDDDDDaBv!//Ol33cfri مxKALךzLsSan56 d,Yw 6ZSan139̍o!(ZSan139̍44.13\k139M=f&؀](--ջdp07FZSB"\o999 ջ5rMh^gv i i م"KALךzLsSan56 dbbb.13\k139M=f&؀]HNNֻw6kM=f&07 f&kM=f&07""""" """""  z` 53Hkl@.] bf2cfrzLs#!tRKALךzLsSan56 DDDDD6 DDDDD6 DDDDD6 d"##.13\k139M=f&؀]ջdp07FZcBv!""Bl33cfri i i م 6] bf2cfrzLs#!w 6ZSan139̍'|w 6ZSan139̍444Btt% f&kM=f&07Қ5 9r$7o7774jGnnټ( G}v/^`8;;iӦ9s&***,?QQQ񁛛t邬,@XXh\pC | f&kM=f&07Қ|r\p'NDHH.\ܹ3n݊=z溸`ǎfwqqٳ1}tL2طoq,_4z¯wyXd 틌 t4wΝxѯ_?̚5 ΝɓѫW/߿NNN СC.13\k139M=f&lYd |}}Gys1k@1k,=ft ׯ_Gbb"&L-[RSSqaٳ:uM6޽{M۝4ig`ES`` x Ę1c< """""cs`Um> -[ӧƅޖ-[P^^nqctt4fO]~=Mp>|8ۇB3g~1|@XX7o`5 \r 1z*ƍ#...]2s!@֭6looo>|lc=f{s۬nu{vޭw 6ZSan139̍f qUL64ֶm[իuVDEEaʕx'ovV Bqq_xճg35n7|Sl33cfri*)) 1,Yvڙ'L`6W^h׮^xX֥(۾ڵk.13\k139M=f&l̞=sqn;pss÷~k_>QVVf1ŋ_܋/Zg|V7mZ3 22',,zضm"##-?~x"22EEEf3fN:H噍/^&M2+--Edd׷V+>dȐ{rϷW` , ` UƷ<`<*c-2ŻO>3b>QKŞ={Jqq>\]]8~vqFZ]pbh۶& F%'' EQ̙3kJ*j㏅(o5[XX(Es5EDD-[ZlwܹBQQXX(BQ1|-ZO=rrrSc"#5@hZvBO9""{M~o %%IIIHJJ>3\zaaa}iiifsҠ( o0`o>XEEV^Ν;aÆ0h ddd?Ѻuk_ҝ,33cfri.BߴiE-[eEAee%<== ܹsD&Mꫯbԩw:u*<<}:"##~aUֽ w 6ZSan139̍Q&rssѾ}{ 44Tr@5 {ߞ?GDDtOڝSv!"""""Ͱ!PTLךzLsSan56 d.13\k139M=f&؀]Xd% f&kM=f&07 f&kM=f&07""""" """""  ׻dp07FZcBvTl33cfriMBrssѾ}{ 44Tr@5 {ߞ?GDDtOڝ7 DDDDD6 DDDDD6 d.13\k139M=f&؀]ѻdp07FZcBv!99YlP$53Hkl@..2 53Hkl@H3l@H3l@.] bf2cfrzLs#!w 6ZSan139̍ҥK.13\k139M=f&؀f؀f؀f؀]Իdp07FZcBv!66Vl33cfri مKALךzLsSan56 DDDDD6 DDDDD6 d6lؠw 6ZSan139̍Bzz% f&kM=f&07 |% f&kM=f&07""""" """"" """""  z` 53Hkl@.𑩎7 IDAT)2 53Hkl@. :Tl33cfri i i مݻw] bf2cfrzLs#!o] bf2cfrzLs#!vZKALךzLsSan56 d\]].13\k139M=f&؀f؀f؀]4i% f&kM=f&07 z` 53Hkl@.] bf2cfrzLs#!"""""Ͱ!"""""Ͱ!w 6ZSan139̍B||% f&kM=f&07 K,ѻdp07FZ$33#GDF͵޽{^^^8p N8au/Fpp0ѴiS̜9Ο?( ]tAVVmfdd ,, nnnAtt4.\pgU f&kM=f&07Қ5 ˗/ǩS0qDl޼-ѹsgر4///ᨨuGE׮]QTTdٳgc„ xm67s敗W^رcylܸ 4@߾}_ݹs'~iaƍXh222ЫW/\vDDDDDt?6ܹscEÆ E޽Mc 4vI$&Ol+**b̘1fۜ3g0 ⧟~2-]T("k!!!SNfرhժ4}7BQZ=@.1) GBßײ;}+vl___1777lOTTT`ӦM8p MУG_4e#::lB`Æ #88:u2988`طo gΜ1b 8,, ͛77?׻dp07FZĚ+W 77!!!?(++c=f1u8v4CoհaCx{{æCUMmV7:=z` 53Hkvр?W^ŴizY̭Wtinڵb1˴-xbۼuۤ#%%El33cfriQTRR>c,YڵӻQEta߀`٘3gƍg_>XTuE(///rYkܖqnuۼu$""""zlbIHH0{Yfpqq?`AAAprr4={,ѪU+X֭&\?{6ygifvA<l۶ ?~kSO=e6md^xӶm[,f_uuٳҥYdY~5jiݺٲeKM6VZѣGכŋGW^ Gf}i ByGfv;2Cn 2x`d"H#)))foii:tIMM5:t0G6|IKꫯ6mڴ1]v5EEE6nW_}e>aRRR̀̆ s&''Ǥ 3~xsСFShZ|vw76zo߾}~F-((PAA9uQ-j1C6j/MPh 2AyGfv;2CnpPVVw Df65yGfv 1 ϟw Df65yGfv 1p3 aA(]B z;2Cnޑrk ɓ']B z;2Cnޑrk \K 2AyGfv;2Cnp3 aA(Zlkޑr\cA(]B z;2Cnޑrk e˖]B z;2Cnޑrk a g@ ~@df^쐛wdfBOqAf65yGfv 1 Ǝw Df65yGfv 1p3 []B z;2Cnޑrk 9s]B z;2Cnޑrk K]B z;2Cnޑrk v]B z;2Cnޑrk a Baʔ)~@df^쐛wdfBK.~@df^쐛wdfBlkޑr\c g@ ~@df^쐛wdfBaԩ~@df^쐛wdfB_"3wdfܼ#3;@ B٠׼#3;!70 fϞw Df65yGfv 1 .!!71]N*++S~TZZ}]BRI.{LR?g=}f,~ g@8P"3wdfܼ#3;@ &L"3wdfܼ#3;@ 3fwDyGfv;2Cnp](l z;2Cnޑrk a Ba…~@df^쐛wdfBlkޑr\cA(̟?lkޑr\c g7=zTSNUnn233}ǏWRRR'?IΛ7OYYYj۶.r=3wA?^JMMՀ{%\[lٻyf|ԩV^_|Q%%%2d?DiN^^%٠׼#3;!7w^uU_$z{E;>3g̙3%I7xjjj4m4{Nަnڶm/IC{CrrrtUWiʕ>4^nn%٠׼#3;!7\;uIя~'uv%IΎYKuk1{{w;fC{4ݻ飞={J6mڤ_ڰa>J:#XmڴQJJJ1tWVV*===n_Z޺_{1$GՐ!C4dWқooą4{glkޑr\ ȨQ;vD222T]]cǎTFFFʄ~ =󘉌1Byyy1 ֭[&M… cʔ~ZgώYۿT^^>ot ˗/D駟Cر^x}WյkW=z'xO}?ΝN:'SO=uڰaNUUUO>ZfwРAzw5}t]v9r^xjժy.P@>sy=@ױcǸjСC5tPOuN~~2&_yEyGfv;2CnpEŧ 3wdfܼ#3;@ cǎ"3wdfܼ#3;@8B'!75œ9s.!!75ҥK.!!75Bv.!!750p0eK 2AyGfv;2CnpХKK 2AyGfv;2CnpPPPw Df65yGfv 1p3 rK 2AyGfv;2Cnp0uTK 2AyGfv;2Cnp/]B z;2Cnޑrk n!hlkޑr\c g@ g"3wdfܼ#3;@ UUU~@df^쐛wdfZc.'_~*--U߾}.!PSR$=U&>sh|vx3 aA(TTT]B z;2Cnޑrk  &]B z;2Cnޑrk 3f]B@׼#3;!7P.6!750ppBK 2AyGfv;2CnpPVVw Df65yGfv 1 ϟw Df65yGfv 1p3 aA(]B z;2Cnޑrk ɓ']B z;2Cnޑrk \K 2AyGfv;2Cnp3 aA(Zlkޑr\cA(]B z;2Cnޑrk e˖]B z;2Cnޑrk a g@ ~@df^쐛wdfBOqAf65yGfv 1 Ǝw Df65yGfv 1p3 []B z;2Cnޑrk@=S*77WJJJRQQQ½eee:tڷo4~O7oԶm[]~zgT[[?~233Kx̒(55UסC/ 3g%٠׼#3;!7Bjjj4j(IR$W^^V˗/o{jϪPwq֭[GyD=&MZC ƍK/iպK4|pmٲ%f͛u7SNZz^|EhȐ!:~xK]B z;2Cnޑrk~U׮]_K>_=ӧ+%%E~H+Rs?=̙3j̙oQ5556m ս{wI… {nm۶M$ ,IJOOZzz11?զMMKKK*++<=<&Ɣ)S.!!7P Doҥ%٠׼#3;!7$##CW,ꫬT$QZZZtouu;poݱ6t3{yL4K 2AyGfv;2Cnp-ȏcs+T֭%~FÇgϞѵ))׆yDFGNNN%iݺuˋ{Ip˜2݂駟ٳc߯<Ǭϛ7/eڪ*}Qqqq%鮻:|i:I!MZ٩-O,>O? Vujo(Vb۶mGX:#Q\\^[nݻ L:tD"STT\r%o}gu'UVV<֬Y&))ٳ'`D̎;k555G&'''7ￏm۶D"+$R#ɔ62zJ*5q8nOj̩s\~5khŊ ݧVX+Vﾓ$Jz֮]+W[nQǎ_"z4M6MM͛7kܹ***ĉ;aCcƌQqqJJJtwj߾}qٳU^^1cƨDK,ѝwީ8O+ 3wdfܼ#3;ltD"DLRRR?g}fС&55t=|' K/ڴitڸ}_}LFFIII1 06lHxכb222͡C.&j{#G _+ 5yGfv_;c4?8WVV~T}@ٿ?wHRI{jNXe%]uUְw^nªUtm]FDf^kv$uQO}qVb=jNV55Bqq1yzV,5/K+i_\KU7z;2Cnp7#-[w Df65df^\c g@8P"3 2AyGfv 1 Wdf^Af655رc.!flkޑrk a Ba֭~@df^Af655œ9s.!flkޑrk K]B z٠׼#3;@ ڵ"3 2AyGfv 1p3 )S]B z٠׼#3;@ ]t"3 2AyGfv 1  .!flkޑrk a Blk6!7P:u%٠l z;2Cnp/]B z٠׼#3;@ B٠l z;2Cnp3 aA(̞=lk6!7P"3 2AyGfv 1 .!flkޑrk@6mڤ;w-++СCվ}{oק~SVVڶm/\|l Q4+R]w]_>}RRR;?$_~+5w\=Çk̙z5sLIҍ7ިM6M޽$i…ڽ{mۦKkFSNۛ[ ]|~0+zf^\ + ƘV[[wyG~{tN~ OS\2vZUWW+???2hժUѵ+W*+++:|HE]qiΝ:p@S\0aK 2A 3wdfZI&UVС?ѯ}:vzl}G:~$i׮]3]z饺⋵{ڮ]VL}$:[nZNbQ_ee"$Iֱc;VކY1bb99913u)///&M… cʔwg~:P߯<Ǭϛ7OSLYR^^n^\\~I뮻CZ+):$NRuH$-VvjoE{S;ϓ4ZթXm۶]a髆[kzZ񟪞.]zj?oO_q\Q\\^[nݻ L CH$bMMMi׮ytMꫯ%KL$1;vwD̬Yk{qǜ5kD" k+--5LiiX%\zJ*5x=ZS=NrGԬsz?wҷwdfܼע^?A}Q֭#G=ݷ~mܸQG >\m۶բEbh"E"vmѵQF<kkk[oץ^|B]B z٠׼#3;B{GݺuS߾}}__u!}EEEku뭷w}ӧcǎ/~ݗiӦ闿5l0}***ĉ;a͟?_cƌ?L7Ѿ}TRR4b~@df^Af65 zҲe4|=zT8p/^~E]}ڴi{1qJNN֐!C4wܸjojjo^W^yׄ zjL$W z!7r7n%XٻwoCȌ3|9o@l@׼#3;@.H4sH$uoqfoq|۹lk6!7rA&`w~&x:g@ ."3 2AyGfv #X2~0e+zf^o߾sԧO&?_wzl57D}wKBa~@df^Af6ۧQ{/_,5ӣkn r7pA;*zt}ǺԻ["@@@{=+FK8P"3 2A 3@ 'O"3 2A 3@ ~@df^Af65dfg@ѣGUXXΝ;+%%E}Ѳe. H3=z|M͘1Ck׮յ^cǪBgժU~@df^Af65dfH3ywURR hĉ4h^}U 6LSLщ'.1TfϞw Df65df^Af6H 14+W}3fLz~~Kرç)33lk6fl\ci&vRݕqvv$i~>|Xqukv];$]@Xedd$|2GZґzk_Jޕ%:B"ߜz͡S;V'[ujժUު*(99=555:~"Zju=DM]wYi&Z_C{Zn]?$bOMMM϶ȑ婒e(}'Xk:\j$]R(y{W'+:nժ?GǪS[[sFƘsoDԮ]TSS֭[]vVu7f߷~{";껺>ksƿj$?uu_(}ѿך3luо]vTl5~?6kIҬYw D\7С]?JZ|ƿz={D./b'V~XGyҥKuw__.թS'K $fvZ1BK.՝w]>|vޭ+=:pRAN>?LaÆO?U\\ui @ H3oSOw*++ս{w=1- g /g@ѣGUXXΝ;+%%E}Ѳe܃jTjj {/ޒ(55UϏ޲/h\d6x`%%%=Fԗmn 5h ?TRR~6^vo;SݺuSvԭ[77N}QJJJ4l0uYm۶%\!Ch͚5 o%3zaӦMSRR~=L֤ ԰aLZZyWͦMĉM$1K,9;fzitb,YbJJJmfZje6owӦM&99ٌ5ʔŋ.dgg漼f"A+ر#9/YqFirsswm"op/voFix e[o'}f1{鵓dFl2w3[l1+W47tD"歷ފK%3z-?Om۶K/5q_[5%&&KƬΝ;Ο?D"}Zmmѣ߿k3xD"fMt5nlРA rĉ4v<_֭[x f^;KfԘ.x1Zʌ^WSSczm ^kjVZrڷo1cĬ/Ԏ;ܬ,?vEiܸqڹsgA }ᇺ{c>0''GW]uV\Wռ3hBt[@-zfeOPOn>5SNܹ>vZc3C5,99Y:txzeV^ȑ#9sflkM ڵKݻwi4Iџ ܽ{Y۫Wݵk$5AќY㏕VZ+дitر_On^!k6赆}'ڿzs^kHkN8Z}z駵w^?9D\աN_g}V ,PjjjkM"lBW\zC*++ܺ_{s\\d&IرcN̙[jƍ ~0|rr3Y<-׼V[[ &}1k k(3^KdĈZn$]vZxn֘syiv$zL&Lo]Ç?9c;ukgGPFFF‰2=nٞ[kC{v 2n8I39uwzk͙3\wu&==$''/|wMxzk="4&\֔" oB g@80p3 a g@80p3 a g@80p3 a g@80p3 a g@80p3 aj{|IENDB`pyepr-1.3.1/docs/index.rst000066400000000000000000000071401525260221700154500ustar00rootroot00000000000000================================= ENVISAT Product Reader Python API ================================= .. raw:: latex \listoffigures % \listoftables \clearpage :HomePage: https://pyepr.readthedocs.io :Author: Antonio Valentino :Contact: antonio.valentino@tiscali.it :Copyright: 2011-2026, Antonio Valentino :Version: |release| .. only:: not latex Overview ======== PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _PyEPR: https://github.com/avalentino/pyepr .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int .. index:: ENVISAT, MERIS, AASTR, ASAR Project Links ============= * HTML documentation (`stable `_, `latest `_) * PyEPR_ project page on `github `_ * `source browser`__ * `commit history `_ * `issue tracker `_ * `CI status page `_ * `PyEPR project page on PyPi `_ * EPR-API `project page `_ __ PyEPR_ Documentation ============= .. toctree:: :maxdepth: 2 usermanual tutorials reference NEWS .. only:: not latex Other versions ============== Online documentation for other PyEPR_ versions: ============ ====================================================== PyEPR latest https://pyepr.readthedocs.io/en/latest (development) PyEPR 1.3.1 https://pyepr.readthedocs.io/en/v1.3.1 PyEPR 1.3.0 https://pyepr.readthedocs.io/en/v1.3.0 PyEPR 1.2.0 https://pyepr.readthedocs.io/en/v1.2.0 PyEPR 1.1.5 https://pyepr.readthedocs.io/en/v1.1.5 PyEPR 1.1.4 https://pyepr.readthedocs.io/en/v1.1.4 PyEPR 1.1.3 https://pyepr.readthedocs.io/en/v1.1.3 PyEPR 1.1.2 https://pyepr.readthedocs.io/en/v1.1.2 PyEPR 1.1.1 https://pyepr.readthedocs.io/en/v1.1.1 PyEPR 1.1.0 https://pyepr.readthedocs.io/en/v1.1.0 PyEPR 1.0.1 https://pyepr.readthedocs.io/en/v1.0.1 PyEPR 1.0.0 https://pyepr.readthedocs.io/en/v1.0.0 ============ ====================================================== License ======= .. index:: license Copyright (C) 2011-2026 Antonio Valentino PyEPR is free software: you can redistribute it and/or modify it under the terms of the `GNU General Public License`_ as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. PyEPR is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with PyEPR. If not, see . .. _`GNU General Public License`: https://www.gnu.org/licenses/gpl-3.0.html pyepr-1.3.1/docs/interactive_use.rst000066400000000000000000000270721525260221700175400ustar00rootroot00000000000000Interactive use of PyEPR_ ------------------------- .. highlight:: ipython .. index:: jupyter, ipython, interactive, ENVISAT, ASAR, ESA, pylab, matplotlib pair: interactive; shell pair: sample; dataset In this tutorial it is showed an example of how to use PyEPR_ interactively to open, browse and display data of an ENVISAT_ ASAR_ product. For the interactive session it is used the Jupyter_ console started with the `--pylab` option to enable the interactive plotting features provided by the matplotlib_ package. The ASAR_ product used in this example is a `free sample`_ available at the ESA_ web site. .. _PyEPR: https://github.com/avalentino/pyepr .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ASAR: https://earth.esa.int/handbooks/asar/CNTR.html .. _Jupyter: https://jupyter.org/ .. _matplotlib: https://matplotlib.org .. _`free sample`: https://esar-ds.eo.esa.int/oads/data/ASA_IMP_1P/ASA_IMP_1PNESA20060202_062238_000000152044_00435_20529_0000.N1 .. _ESA: https://earth.esa.int .. index:: module pair: epr; module :mod:`epr` module and classes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ After starting the jupyter console with the following command: .. code-block:: sh $ jupyter console -- --pylab one can import the :mod:`epr` module and start start taking confidence with available classes and functions:: Jupyter console 5.2.0 Python 3.6.5 (default, Apr 1 2018, 05:46:30) Type "copyright", "credits" or "license" for more information. IPython 5.5.0 -- An enhanced Interactive Python. ? -> Introduction and overview of IPython's features. %quickref -> Quick reference. help -> Python's own help system. object? -> Details about 'object', use 'object??' for extra details. In [1]: import epr In [2]: epr? Base Class: String Form: Namespace: Interactive File: /home/antonio/projects/pyepr/epr.so Docstring: Python bindings for ENVISAT Product Reader C API PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_ is fully object oriented and, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _PyEPR: https://pyepr.readthedocs.io .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int In [3]: epr.__version__, epr.EPR_C_API_VERSION Out[3]: ('1.0.0', '2.3dev') .. index:: __version__ Docstrings are available for almost all classes, methods and functions in the :mod:`epr` and they can be displayed using the :func:`help` python_ command or the ``?`` Jupyter_ shortcut as showed above. .. _python: https://www.python.org Also Jupyter_ provides a handy tab completion mechanism to automatically complete commands or to display available functions and classes:: In [4]: product = epr. [TAB] epr.Band epr.E_TID_STRING epr.DSD epr.E_TID_TIME epr.Dataset epr.E_TID_UCHAR epr.EPRError epr.E_TID_UINT epr.EPRTime epr.E_TID_UNKNOWN epr.EPRValueError epr.E_TID_USHORT epr.EPR_C_API_VERSION epr.EprObject epr.E_SMID_LIN epr.Field epr.E_SMID_LOG epr.Product epr.E_SMID_NON epr.Raster epr.E_SMOD_1OF1 epr.Record epr.E_SMOD_1OF2 epr.create_bitmask_raster epr.E_SMOD_2OF2 epr.create_raster epr.E_SMOD_2TOF epr.data_type_id_to_str epr.E_SMOD_3TOI epr.get_data_type_size epr.E_TID_CHAR epr.get_sample_model_name epr.E_TID_DOUBLE epr.get_scaling_method_name epr.E_TID_FLOAT epr.np epr.E_TID_INT epr.open epr.E_TID_SHORT epr.so epr.E_TID_SPARE epr.sys .. index:: product :class:`epr.Product` navigation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The first thing to do is to use the :func:`epr.open` function to get an instance of the desired ENVISAT_ :class:`epr.Product`:: In [4]: product = epr.open( 'ASA_IMP_1PNESA20060202_062238_000000152044_00435_20529_0000.N1' ) In [4]: product. product.bands product.get_mph product.close product.get_num_bands product.closed product.get_num_datasets product.datasets product.get_num_dsds product.file_path product.get_scene_height product.get_band product.get_scene_width product.get_band_at product.get_sph product.get_band_names product.id_string product.get_dataset product.meris_iodd_version product.get_dataset_at product.read_bitmask_raster product.get_dataset_names product.tot_size product.get_dsd_at In [5]: product.tot_size / 1024.**2 Out[5]: 132.01041889190674 In [6]: print(product) epr.Product(ASA_IMP_1PNUPA20060202_ ...) 7 datasets, 5 bands epr.Dataset(MDS1_SQ_ADS) 1 records epr.Dataset(MAIN_PROCESSING_PARAMS_ADS) 1 records epr.Dataset(DOP_CENTROID_COEFFS_ADS) 1 records epr.Dataset(SR_GR_ADS) 1 records epr.Dataset(CHIRP_PARAMS_ADS) 1 records epr.Dataset(GEOLOCATION_GRID_ADS) 11 records epr.Dataset(MDS1) 8192 records epr.Band(slant_range_time) of epr.Product(ASA_IMP_1PNUPA20060202_ ...) epr.Band(incident_angle) of epr.Product(ASA_IMP_1PNUPA20060202_ ...) epr.Band(latitude) of epr.Product(ASA_IMP_1PNUPA20060202 ...) epr.Band(longitude) of epr.Product(ASA_IMP_1PNUPA20060202 ...) epr.Band(proc_data) of epr.Product(ASA_IMP_1PNUPA20060202 ...) A short summary of product contents can be displayed simply printing the :class:`epr.Product` object as showed above. Being able to display contents of each object it is easy to keep browsing and get all desired information from the product:: In [7]: dataset = product.get_dataset('MAIN_PROCESSING_PARAMS_ADS') In [8]: dataset Out[8]: epr.Dataset(MAIN_PROCESSING_PARAMS_ADS) 1 records In [9]: record = dataset.[TAB] dataset.create_record dataset.get_dsd_name dataset.product dataset.description dataset.get_name dataset.read_record dataset.get_dsd dataset.get_num_records dataset.records In [9]: record = dataset.read_record(0) In [10]: record Out[10]: 220 fields In [11]: record.get_field_names()[:20] Out[11]: ['first_zero_doppler_time', 'attach_flag', 'last_zero_doppler_time', 'work_order_id', 'time_diff', 'swath_id', 'range_spacing', 'azimuth_spacing', 'line_time_interval', 'num_output_lines', 'num_samples_per_line', 'data_type', 'spare_1', 'data_analysis_flag', 'ant_elev_corr_flag', 'chirp_extract_flag', 'srgr_flag', 'dop_cen_flag', 'dop_amb_flag', 'range_spread_comp_flag'] In [12]: field = record.get_field('range_spacing') In [13]: field.get [TAB] field.get_description field.get_name field.get_unit field.get_elem field.get_num_elems field.get_elems field.get_type In [13]: field.get_description() Out[13]: 'Range sample spacing' In [14]: epr.data_type_id_to_str(field.get_type()) Out[14]: 'float' In [15]: field.get_num_elems() Out[15]: 1 In [16]: field.get_unit() Out[16]: 'm' In [17]: print(field) range_spacing = 12.500000 .. index:: iteration, iterable, record Iterating over :mod:`epr` objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :class:`epr.Record` objects are also iterable_ so one can write code like the following:: In [18]: for field in record: if field.get_num_elems() == 4: print('%s: %d elements' % (field.get_name(), len(field))) ....: nominal_chirp.1.nom_chirp_amp: 4 elements nominal_chirp.1.nom_chirp_phs: 4 elements nominal_chirp.2.nom_chirp_amp: 4 elements nominal_chirp.2.nom_chirp_phs: 4 elements nominal_chirp.3.nom_chirp_amp: 4 elements nominal_chirp.3.nom_chirp_phs: 4 elements nominal_chirp.4.nom_chirp_amp: 4 elements nominal_chirp.4.nom_chirp_phs: 4 elements nominal_chirp.5.nom_chirp_amp: 4 elements nominal_chirp.5.nom_chirp_phs: 4 elements beam_merge_sl_range: 4 elements beam_merge_alg_param: 4 elements .. index:: data, image Image data ~~~~~~~~~~ Dealing with image data is simple as well:: In [19]: product.get_band_names() Out[19]: ['slant_range_time', 'incident_angle', 'latitude', 'longitude', 'proc_data'] In [19]: band = product.get_band('proc_data') In [20]: data = band. [TAB] band.bm_expr band.read_raster band.create_compatible_raster band.sample_model band.data_type band.scaling_factor band.description band.scaling_method band.get_name band.scaling_offset band.lines_mirrored band.spectr_band_index band.product band.unit band.read_as_array In [20]: data = band.read_as_array(1000, 1000, xoffset=100, \ yoffset=6500, xstep=2, ystep=2) In [21]: data Out[21]: array([[ 146., 153., 134., ..., 51., 55., 72.], [ 198., 163., 146., ..., 26., 54., 57.], [ 127., 205., 105., ..., 64., 76., 61.], ..., [ 64., 78., 52., ..., 96., 176., 159.], [ 66., 41., 45., ..., 200., 153., 203.], [ 64., 71., 88., ..., 289., 182., 123.]], dtype=float32) In [22]: data.shape Out[22]: (500, 500) In [23]: imshow(data, cmap=cm.gray, vmin=0, vmax=1000) Out[23]: In [24]: title(band.description) Out[24]: In [25]: colorbar() Out[25]: .. figure:: images/ASA_IMP_crop.* :width: 100% Image data read from the `proc_data`` band .. _iterable: https://docs.python.org/3/glossary.html#term-iterable .. index:: close, product Closing the epr.Product ~~~~~~~~~~~~~~~~~~~~~~~ Finally the :class:`epr.Product` can be closed using the :meth:`epr.Product.close` method:: In [26]: product.close() After a product is closed no more I/O operations can be performed on it. Any attempt to do it will raise a :exc:`ValueError`:: In [27]: product.tot_size / 1024.**2 ------------------------------------------------------------------------- ValueError Traceback (most recent call last) in () ----> 1 product.tot_size / 1024.**2 epr.so in epr.Product.tot_size.__get__ (src/epr.c:16534)() epr.so in epr.Product.check_closed_product (src/epr.c:16230)() ValueError: I/O operation on closed file At any time the user can check whenever a :class:`epr.Product` is closed or not using the :attr:`epr.Product.closed` property:: In [28]: product.closed Out[28]: True .. raw:: latex \clearpage pyepr-1.3.1/docs/make.bat000066400000000000000000000013751525260221700152200ustar00rootroot00000000000000@ECHO OFF pushd %~dp0 REM Command file for Sphinx documentation if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=sphinx-build ) set SOURCEDIR=. set BUILDDIR=_build %SPHINXBUILD% >NUL 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.https://www.sphinx-doc.org/ exit /b 1 ) if "%1" == "" goto help %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% goto end :help %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% :end popd pyepr-1.3.1/docs/ndvi_example.rst000066400000000000000000000127741525260221700170250ustar00rootroot00000000000000NDVI computation ---------------- .. index:: NDVI, MERIS This tutorial shows how to use PyEPR_ to open a MERIS_ L1B product, compute the *Normalized Difference Vegetation Index* (NDVI) and store it into a flat binary file. The example code (:download:`examples/write_ndvi.py`) is a direct translation of the C sample program `write_ndvi.c`_ bundled with the EPR API distribution. The program is invoked as follows: .. code-block:: sh $ python write_ndvi.py .. _PyEPR: https://github.com/avalentino/pyepr .. _MERIS: https://earth.esa.int/handbooks/meris/CNTR.html .. _`write_ndvi.c`: https://github.com/bcdev/epr-api/blob/master/src/examples/write_ndvi.c The code have been kept very simple and it consists in a single function (:func:`main`) that also performs a minimal command line arguments handling. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py The ENVISAT_ :class:`epr.Product` is opened using the :func:`epr.open` function. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 55-56 .. index:: context, open pair: with; statement As usual in modern python programs the *with* statement has been used to ensure that the product is automatically closed as soon as the program exits the block. Of course it is possible to use a simple assignment form:: product = open(argv[1]) but in this case the user should take care of manually call:: product.close() when appropriate. The name of the product is in the first argument passed to the program. In order to keep the code simple no check is performed to ensure that the product is a valid L1B product. The NDVI is calculated using bands 6 and 8 (the names of these bands are "radiance_6" and "radiance_10"). :class:`epr.Band` objects are retrieved using the :meth:`epr.Product.get_band` method: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 57-62 *band1* and *band2* are used to read the calibrated radiances into the :class:`epr.Raster` objects that allow to access data matrices with the radiance values. .. index:: raster, memory Before reading data into the :class:`epr.Raster` objects they have to be instantiated specifying their size and data type in order to allow the library to allocate the correct amount of memory. For sake of simplicity :class:`epr.Raster` object are created with the same size of the whole product (with no sub-sampling) using the :meth:`epr.Band.create_compatible_raster` method of the :class:`epr.Band` class: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 64-74 Then data are actually loaded into memory using the :meth:`epr.Band.read_raster` method. Since :class:`epr.Raster` objects have been defined to match the whole product, offset parameters are set to zero (data are read starting from specified offset): .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 76-84 .. note:: in this simplified example it is assumed that there is enough system memory to hold the two :class:`epr.Raster` objects. After opening (in binary mode) the stream for the output .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 86-88 the program simply loops over all pixel and calculate the NDVI with the following formula: .. math:: NDVI = \frac{radiance_{10} - radiance_8}{radiance_{10} + radiance_8} .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 89-102 This part of the code tries to mimic closely the original C code (`write_ndvi.c`_) .. code-block:: c out_stream = fopen(argv[2], "wb"); for (j = 0; j < height; ++j) { for (i = 0; i < width; ++i) { rad1 = epr_get_pixel_as_float(raster1, i, j); rad2 = epr_get_pixel_as_float(raster2, i, j); if ((rad1 + rad2) != 0.0) { ndvi = (rad2 - rad1) / (rad2 + rad1); } else { ndvi = -1.0; } status = fwrite( & ndvi, sizeof(float), 1, out_stream); } } epr_log_message(e_log_info, "ndvi was written success"); and uses the :meth:`epr.Raster.get_pixel` method to access pixel values and perform computation. The Python_ :func:`struct.pack` function together with :meth:`file.write` is used to write the NDVI of the pixel n the file in binary format. .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/write_ndvi.py :lines: 101 .. note:: the entire solution is quite not "pythonic". As an alternative implementation it could be used the :class:`numpy.ndarray` interface of :class:`epr.Raster` objects available via the :data:`epr.Raster.data` property. The NDVI index is computed on all pixels altogether using vectorized expressions:: # Initialize the entire matrix to -1 ndvi = numpy.zeros((height, width), 'float32') - 1 aux = raster2.data + raster1.data # indexes of pixel with non null denominator idx = numpy.where(aux != 0) # actual NDVI computation ndvi[idx] = (raster2.data[idx] - raster1.data[idx]) / aux[idx] Finally data can be saved to file simply using the :meth:`numpy.ndarray.tofile` method:: ndvi.tofile(out_stream) .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _Python: https://www.python.org .. raw:: latex \clearpage pyepr-1.3.1/docs/reference.rst000066400000000000000000001122571525260221700163050ustar00rootroot00000000000000API Reference ============= .. module:: epr :synopsis: Python bindings for ENVISAT Product Reader C API .. index:: bindings, ENVISAT, ESA, EPR-API pair: epr; module PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_ is fully object oriented and, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _PyEPR: https://github.com/avalentino/pyepr .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int .. currentmodule:: epr Classes ------- Product ~~~~~~~ .. class:: Product ENVISAT product. The Product class provides methods and properties to get information about an ENVISAT product file. .. seealso:: :func:`open` .. rubric:: Attributes .. attribute:: file_path The file's path including the file name. .. attribute:: mode String that specifies the mode in which the file is opened. Possible values: `rb` for read-only mode, `rb+` for read-write mode. .. attribute:: id_string The product identifier string obtained from the MPH parameter 'PRODUCT'. The first 10 characters of this string identify the product type, e.g. "MER_1P__FR" for a MERIS Level 1b full resolution product. The rest of the string decodes product instance properties. .. attribute:: meris_iodd_version For MERIS L1b and RR and FR to provide backward compatibility. .. attribute:: tot_size The total size in bytes of the product file. .. rubric:: Methods .. method:: get_band(name) Gets the band corresponding to the specified name. :param str name: the name of the band :returns: the requested :class:`Band` instance, or raises a :exc:`EPRValueError` if not found .. method:: get_band_at(index) Gets the :class:`Band` at the specified position within the :class:`product`. :param int index: the index identifying the position of the :class:`Band`, starting with 0, must not be negative :returns: the requested :class:`Band` instance, or raises a :exc:`EPRValueError` if not found .. method:: get_dataset(name) Gets the :class:`Dataset` corresponding to the specified dataset name. :param str name: the :class:`Dataset` name :returns: the requested :class:`Dataset` instance .. method:: get_dataset_at(index) Gets the :class:`Dataset` at the specified position within the :class:`Product`. :param int index: the index identifying the position of the :class:`Dataset`, starting with 0, must not be negative :returns: the requested :class:`Dataset` .. method:: get_dsd_at(index) Gets the :class:`DSD` at the specified position. Gets the :class:`DSD` (:class:`Dataset` descriptor) at the specified position within the :class:`Product`. :param int index: the index identifying the position of the :class:`DSD`, starting with 0, must not be negative :returns: the requested :class:`DSD` instance .. method:: get_num_bands() Gets the number of all :class:`Band`\ s contained in a :class:`Product`. .. method:: get_num_datasets() Gets the number of all :class:`Dataset`\ s contained in a :class:`Product`. .. method:: get_num_dsds() Gets the number of all :class:`DSD`\ s (:class:`Dataset` descriptors) contained in the :class:`Product`. .. method:: get_scene_height() Gets the :class:`Product` scene height in pixels. .. method:: get_scene_width() Gets the :class:`Product` scene width in pixels. .. method:: get_mph() The :class:`Record` representing the main product header (MPH). .. method:: get_sph() The :class:`Record` representing the specific product header (SPH). .. method:: read_bitmask_raster(bm_expr, xoffset, yoffset, raster) Calculates a bit-mask raster. Calculates a bit-mask, composed of flags of the given :class:`Product` and combined as described in the given bit-mask expression, for the a certain dimension and sub-sampling as defined in the given raster. :param str bm_expr: a string holding the logical expression for the definition of the bit-mask. In a bit-mask expression, any number of the flag-names (found in the DDDB) can be composed with "(", ")", "NOT", "AND", "OR". Valid bit-mask expression are for example ``flags.LAND OR flags.CLOUD`` or ``NOT flags.WATER AND flags.TURBID_S`` :param int xoffset: across-track coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int yoffset: along-track coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int raster: the raster for the bit-mask. The data type of the raster must be either :data:`E_TID_UCHAR` or :data:`E_TID_CHAR` :returns: zero for success, an error code otherwise .. seealso:: :func:`create_bitmask_raster`. .. method:: close Closes the :class:`Product` product and free the underlying file descriptor. This method has no effect if the :class:`Product` is already closed. Once the :class:`Product` is closed, any operation on it will raise a :exc:`ValueError`. As a convenience, it is allowed to call this method more than once; only the first call, however, will have an effect. .. method:: flush() Flush the file stream. .. rubric:: High level interface methods .. note:: the following methods are part of the *high level* Python API and do not have any corresponding function in the C API. .. attribute:: closed True if the :class:`Product` is closed. .. method:: get_dataset_names() Return the list of names of the :class:`Dataset`\ s in the :class:`Product`. .. method:: get_band_names() Return the list of names of the :class:`Band`\ s in the :class:`Product`. .. method:: datasets() Return the list of :class:`Dataset`\ s in the :class:`Product`. .. method:: bands() Return the list of :class:`Band`\ s in the :class:`Product`. .. method:: get_complex_band_as_array(iname, qname, *, strict=True) Return a complex array that is the combination of two bands. Return a complex array reading the real part from the band named `iname` and the imaginary part from the band named `qname`. :param str iname: name of the band containing the real part of the complex array :param str qname: name of the band containing the imaginary part of the complex array :param bool strict: raise a `ValueError` if the and names provided in input (`iname` and `qname`) do not belong to the same dataset, or if `imane` / `qname` does not correspond to the real/imaginary components (respectively) of the dataset .. versionadded:: 1.3 .. rubric:: Special methods The :class:`Product` class provides a custom implementation of the following *special methods*: * __repr__ * __str__ * __enter__ * __exit__ .. index:: __repr__, __str__, __enter__, __exit__ pair: special; methods Dataset ~~~~~~~ .. class:: Dataset ENVISAT dataset. The Dataset class contains information about a dataset within an ENVISAT product file which has been opened with the :func:`open` function. A new Dataset instance can be obtained with the :meth:`Product.get_dataset` or :meth:`Product.get_dataset_at` methods. .. rubric:: Attributes .. attribute:: description A short description of the :class:`Band` contents. .. attribute:: product The :class:`Product` instance to which this :class:`Dataset` belongs to. .. rubric:: Methods .. method:: get_name() Gets the name of the :class:`Dataset`. .. method:: get_dsd() Gets the :class:`Dataset` descriptor (:class:`DSD`). .. method:: get_dsd_name() Gets the name of the :class:`DSD` (:class:`Dataset` descriptor). .. method:: get_num_records() Gets the number of :class:`Record`\ s of the :class:`Dataset`. .. method:: create_record() Creates a new :class:`Record`. Creates a new, empty :class:`Record` with a structure compatible with the :class:`Dataset`. Such a :class:`Record` is typically used in subsequent calls to :meth:`Dataset.read_record`. :returns: the new :class:`Record` instance .. method:: read_record(index[, record]) Reads specified :class:`Record` of the :class:`Dataset`. The :class:`Record` is identified through the given zero-based :class:`Record` index. In order to reduce memory reallocation, a :class:`Record` (pre-)created by the method :meth:`Dataset.create_record` can be passed to this method. Data is then read into this given :class:`Record`. If no :class:`Record` (``None``) is given, the method initiates a new one. In both cases, the :class:`Record` in which the data is read into will be returned. :param int index: the zero-based :class:`Record` index (default: 0) :param epr.Record record: a pre-created :class:`Record` to reduce memory reallocation, can be ``None`` (default) to let the function allocate a new :class:`Record` :returns: the record in which the data has been read into or raises an exception (:exc:`EPRValueError`) if an error occurred .. versionchanged:: 0.9 The *index* parameter now defaults to zero. .. rubric:: High level interface methods .. note:: the following methods are part of the *high level* Python API and do not have any corresponding function in the C API. .. method:: records() Return the list of :class:`Record`\ s contained in the :class:`Dataset`. .. rubric:: Special methods The :class:`Dataset` class provides a custom implementation of the following *special methods*: * __repr__ * __str__ * __iter__ .. index:: __repr__, __str__, __iter__ pair: special; methods Record ~~~~~~ .. class:: Record Represents a record read from an ENVISAT dataset. A record is composed of multiple fields. .. seealso:: :class:`Field` .. rubric:: Attributes .. attribute:: dataset_name The name of the :class:`Dataset` to which this :class:`Record` belongs to. .. versionadded:: 0.9 .. attribute:: tot_size The total size in bytes of the :class:`Record`. It includes all data elements of all :class:`Field`\ s of a :class:`Record` in a :class:`Product` file. *tot_size* is a derived variable, it is computed at run-time and not stored in the DSD-DB. .. versionadded:: 0.9 .. attribute:: index Index of the :class:`Record` within the :class:`Dataset`. It is *None* for empty :class:`Record`\ s (created with :meth:`Dataset.create_record` but still not read) and for *MPH* (see :meth:`Product.get_mph`) and *SPH* (see :meth:`Product.get_sph`) :class:`Record`\ s. .. seealso:: :meth:`Dataset.read_record` .. versionadded:: 0.9 .. rubric:: Methods .. method:: get_field(name) Gets a :class:`Field` specified by name. The :class:`Field` is here identified through the given name. It contains the :class:`Field` info and all corresponding values. :param str name: the the name of required :class:`Field` :returns: the specified :class:`Field` or raises an exception (:exc:`EPRValueError`) if an error occurred .. method:: get_field_at(index) Gets a :class:`Field` at the specified position within the :class:`Record`. :param int index: the zero-based index (position within :class:`Record`) of the :class:`Field` :returns: the :class:`Field` or raises and exception (:exc:`EPRValueError`) if an error occurred .. method:: get_num_fields() Gets the number of :class:`Field`\ s contained in the :class:`Record`. .. method:: print([ostream]) Write the :class:`Record` to specified file (default: :data:`sys.stdout`). This method writes formatted contents of the :class:`Record` to specified *ostream* text file or (default) the ASCII output is be printed to standard output (:data:`sys.stdout`). :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances. .. method:: print_element(field_index, element_index[, ostream]) Write the specified field element to file (default: :data:`sys.stdout`). This method writes formatted contents of the specified :class:`Field` element to the *ostream* text file or (default) the ASCII output will be printed to standard output (:data:`sys.stdout`). :param int field_index: the index of :class:`Field` in the :class:`Record` :param int element_index: the index of element in the specified :class:`Field` :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances. .. method:: get_offset() :class:`Record` offset in bytes within the :class:`Dataset`. .. versionadded:: 0.9 .. rubric:: High level interface methods .. note:: the following methods are part of the *high level* Python API and do not have any corresponding function in the C API. .. method:: get_field_names Return the list of names of the :class:`Field`\ s in the :class:`Record`. .. method:: fields() Return the list of :class:`Field`\ s contained in the :class:`Record`. .. rubric:: Special methods The :class:`Record` class provides a custom implementation of the following *special methods*: * __repr__ * __str__ * __iter__ .. index:: __repr__, __str__, __iter__ pair: special; methods Field ~~~~~ .. class:: Field Represents a field within a record. A :class:`Field` is composed of one or more data elements of one of the types defined in the internal ``field_info`` structure. .. seealso:: :class:`Record` .. rubric:: Attributes .. attribute:: tot_size The total size in bytes of all data elements of a :class:`Field`. *tot_size* is a derived variable, it is computed at run-time and not stored in the DSD-DB. .. versionadded:: 0.9 .. method:: get_description() Gets the description of the :class:`Field`. .. method:: get_name() Gets the name of the :class:`Field`. .. method:: get_num_elems() Gets the number of elements of the :class:`Field`. .. method:: get_type() Gets the type of the :class:`Field`. .. method:: get_unit() Gets the unit of the :class:`Field`. .. method:: get_elem([index]) :class:`Field` single element access. This function is for getting the elements of a :class:`Field`. :param int index: the zero-based index of element to be returned, must not be negative. Default: 0. :returns: the typed value from given :class:`Field` .. method:: get_elems() :class:`Field` array element access. This function is for getting an array of field elements of the :class:`Field`. :returns: the data array (:class:`numpy.ndarray`) having the type of the :class:`Field` .. versionchanged:: 0.9 the returned :class:`numpy.ndarray` shares the data buffer with the C :c:type:`Field` structure so any change in its contents is also reflected to the :class:`Filed` object .. method:: set_elem(elem, [index]) Set :class:`Field` array element. This function is for setting an array of field element of the :class:`Field`. :param elem: value of the element to set :param int index: the zero-based index of element to be set, must not be negative. Default: 0. .. note:: this method does not have any corresponding function in the C API. .. versionadded:: 0.9 .. method:: set_elems(elems) Set :class:`Field` array elements. This function is for setting an array of :class:`Field` elements of the :class:`Field`. :param elems: np.ndarray of elements to set .. note:: this method does not have any corresponding function in the C API. .. versionadded:: 0.9 .. method:: print([ostream]) Write the :class:`Field` to specified file (default: :data:`sys.stdout`). This method writes formatted contents of the :class:`Field` to specified *ostream* text file or (default) the ASCII output is be printed to standard output (:data:`sys.stdout`). :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances .. method:: get_offset() Field offset in bytes within the :class:`Record`. .. versionadded:: 0.9 .. rubric:: Special methods The :class:`Field` class provides a custom implementation of the following *special methods*: * __repr__ * __str__ * __eq__ * __ne__ * __len__ [#]_ .. index:: __repr__, __str__, __eq__, __ne__, __len__ pair: special; methods .. rubric:: Footnotes .. [#] if the field is a :data:`E_TID_STRING` field then the :meth:`__len__` method returns the string length, otherwise the number of elements of the field is returned (same as :meth:`Field.get_num_elems`) DSD ~~~ .. class:: DSD :class:`Dataset` descriptor. The DSD class contains information about the properties of a :class:`Dataset` and its location within an ENVISAT :class:`Product` file. .. rubric:: Attributes .. attribute:: ds_name The :class:`Dataset` name. .. attribute:: ds_offset The offset of :class:`Dataset` in the :class:`Product` file. .. attribute:: ds_size The size of :class:`Dataset` in the :class:`Product` file. .. attribute:: ds_type The :class:`Dataset` type descriptor. .. attribute:: dsr_size The size of dataset record for the given :class:`Dataset` name. .. attribute:: filename The filename in the DDDB with the description of this :class:`Dataset`. .. attribute:: index The index of this :class:`DSD` (zero-based). .. attribute:: num_dsr The number of dataset records for the given :class:`Dataset` name. .. rubric:: Special methods The :class:`DSD` class provides a custom implementation of the following *special methods*: * __repr__ * __eq__ * __ne__ .. index:: __repr__, __eq__, __ne__ pair: special; methods Band ~~~~ .. class:: Band The band of an ENVISAT :class:`Product`. The Band class contains information about a band within an ENVISAT :class:`Product` file which has been opened with the :func:`open` function. A new Band instance can be obtained with the :meth:`Product.get_band` method. .. rubric:: Attributes .. attribute:: bm_expr A bit-mask expression used to filter valid pixels. All others are set to zero. .. attribute:: data_type The data type of the :class:`Band` pixels. Possible values are: * ``*`` --> the datatype remains unchanged. * ``uint8_t`` --> 8-bit unsigned integer * ``uint32_t`` --> 32-bit unsigned integer * ``Float`` --> 32-bit IEEE floating point .. attribute:: description A short description of the :class:`Band` contents. .. attribute:: lines_mirrored Mirrored lines flag. If true (=1) lines will be mirrored (flipped) after read into a raster in order to ensure a pixel ordering in raster X direction from WEST to EAST. .. attribute:: product The :class:`Product` instance to which this :class:`Band` belongs to. .. attribute:: sample_model The sample model operation. The sample model operation applied to the source :class:`Dataset` for getting the correct samples from the MDS (for example MERIS L2). Possible values are: * ``*`` --> no operation (direct copy) * ``1OF2`` --> first byte of 2-byte interleaved MDS * ``2OF2`` --> second byte of 2-byte interleaved MDS * ``0123`` --> combine 3-bytes interleaved to 4-byte integer .. attribute:: scaling_factor The scaling factor. Possible values are: * ``*`` --> no factor provided (implies scaling_method=*) * ``const`` --> a floating point constant * ``GADS.field[.field2]`` --> value is provided in global annotation :class:`Dataset` with name `GADS` in :class:`Field` `field`. Optionally a second element index for multiple-element fields can be given too .. attribute:: scaling_method The scaling method which must be applied to the raw source data in order to get the 'real' pixel values in geo-physical units. Possible values are: * ``*`` --> no scaling applied * ``Linear_Scale`` --> linear scaling applied:: y = offset + scale * x * ``Log_Scale`` --> logarithmic scaling applied:: y = log10(offset + scale * x) .. attribute:: scaling_offset Possible values are: * ``*`` --> no offset provided (implies scaling_method=*) * ``const`` --> a floating point constant * ``GADS.field[.field2]` --> value is provided in global annotation :class:`Dataset` with name ``GADS`` in :class:`Field` ``field``. Optionally a second element index for multiple-element fields can be given too .. attribute:: spectr_band_index The (zero-based) spectral :class:`Band` index. -1 if this is not a spectral :class:`Band`. .. attribute:: unit The geophysical unit for the :class:`Band` pixel values. .. attribute:: dataset The source :class:`Dataset`. The source :class:`Dataset` containing the raw data used to create the :class:`Band` pixel values. .. versionadded:: 0.9 .. rubric:: Methods .. method:: get_name() Gets the name of the :class:`Band`. .. method:: create_compatible_raster([src_width, src_height, xstep, ystep]) Creates a :class:`Raster` which is compatible with the data type of the :class:`Band`. The created :class:`Raster` is used to read the data in it (see :meth:`Band.read_raster`). The :class:`Raster` is defined on the grid of the :class:`Product`, from which the data are read. Spatial subsets and under-sampling are possible) through the parameter of the method. A :class:`Raster` is an object that allows direct access to data of a certain portion of the ENVISAT :class:`Product` that are read into the it. Such a portion is called the source. The complete ENVISAT :class:`Product` can be much greater than the source. One can move the :class:`Raster` over the complete ENVISAT :class:`Product` and read in turn different parts (always of the size of the source) of it into the :class:`Raster`. The source is specified by the parameters *height* and *width*. A typical example is a processing in blocks. Lets say, a block has 64x32 pixel. Then, my source has a width of 64 pixel and a height of 32 pixel. Another example is a processing of complete image lines. Then, my source has a widths of the complete product (for example 1121 for a MERIS RR product), and a height of 1. One can loop over all blocks read into the :clasS:`Raster` and process it. In addition, it is possible to defined a sub-sampling step for a :class:`Raster`. This means, that the source is not read 1:1 into the :class:`Raster`, but that only every 2nd or 3rd pixel is read. This step can be set differently for the across track (source_step_x) and along track (source_step_y) directions. :param int src_width: the width (across track dimension) of the source to be read into the :class:`Raster`. Default: scene width (see :attr:`Product.get_scene_width`) :param int src_height: the height (along track dimension) of the source to be read into the :class:`Raster`. Default: scene height (see :attr:`Product.get_scene_height`) :param int xstep: the sub-sampling step across track of the source when reading into the :class:`Raster`. Default: 1. :param int ystep: the sub-sampling step along track of the source when reading into the :class:`Raster`. Default: 1. :returns: the new :class:`Raster` instance or raises an exception (:exc:`EPRValueError`) if an error occurred .. note:: *src_width* and *src_height* are the dimension of the of the source area. If one specifies a *step* parameter the resulting :class:`Raster` will have a size that is smaller that the specifies source size:: raster_size = src_size // step .. method:: read_raster([xoffset, yoffset, raster]) Reads (geo-)physical values of the :class:`Band` of the specified source-region. The source-region is a defined part of the whole ENVISAT :class:`Product` image, which shall be read into a :class:`Raster`. In this routine the coordinates are specified, where the source-region to be read starts. The dimension of the region and the sub-sampling are attributes of the :class:`Raster` into which the data are read. :param int xoffset: across-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region. Default 0. :param int yoffset: along-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region. Default 0. :param epr.Raster raster: :class:`Raster` instance set with appropriate parameters to read into. If not provided a new :class:`Raster` is instantiated :returns: the :class:`Raster` instance in which data are read This method raises an instance of the appropriate :exc:`EPRError` sub-class if case of errors .. seealso:: :meth:`Band.create_compatible_raster` and :func:`create_raster` .. rubric:: High level interface methods .. note:: the following methods are part of the *high level* Python API and do not have any corresponding function in the C API. .. method:: read_as_array([width, height, xoffset, yoffset, xstep, ystep]) Reads the specified source region as an :class:`numpy.ndarray`. The source-region is a defined part of the whole ENVISAT :class:`Product` image, which shall be read into a :class:`Raster`. In this routine the coordinates are specified, where the source-region to be read starts. The dimension of the region and the sub-sampling are attributes of the :class:`Raster` into which the data are read. :param int src_width: the width (across track dimension) of the source to be read into the :class:`Raster`. If not provided reads as much as possible :param int src_height: the height (along track dimension) of the source to be read into the :class:`Raster`, If not provided reads as much as possible :param int xoffset: across-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region. Default 0. :param int yoffset: along-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region. Default 0. :param int xstep: the sub-sampling step across track of the source when reading into the :class:`Raster`. Default: 1 :param int ystep: the sub-sampling step along track of the source when reading into the :class:`Raster`. Default: 1 :returns: the :class:`numpy.ndarray` instance in which data are read This method raises an instance of the appropriate :exc:`EPRError` sub-class if case of errors .. seealso:: :meth:`Band.create_compatible_raster`, :func:`create_raster` and :meth:`Band.read_raster` .. rubric:: Special methods The :class:`Band` class provides a custom implementation of the following *special methods*: * __repr__ .. index:: __repr__ pair: special; methods Raster ~~~~~~ .. class:: Raster Represents a raster in which data will be stored. All 'size' parameter are in PIXEL. .. rubric:: Attributes .. attribute:: data_type The data type of the :class:`Band` pixels. All ``E_TID_*`` types are possible. .. attribute:: source_height The height of the source. .. attribute:: source_width The width of the source. .. attribute:: source_step_x The sub-sampling for the across-track direction in pixel. .. attribute:: source_step_y The sub-sampling for the along-track direction in pixel. .. rubric:: High level interface attributes .. note:: the following attributes are part of the *high level* Python API and do not have a counterpart in the C API. .. attribute:: data Raster data exposed as :class:`numpy.ndarray` object. .. note:: this property shares the data buffer with the :class:`Raster` object so any change in its contents is also reflected to the :class:`Raster` object .. note:: the :class:`Raster` objects do not have a :class:`Field` named *data* in the corresponding C structure. The *EPR_SRaster* C structure have a :class:`Field` named *buffer* that is a raw pointer to the data buffer and it is not exposed as such in the Python API. .. rubric:: Methods .. method:: get_pixel(x, y) Single pixel access. This function is for getting the values of the elements of a :class:`Raster` (i.e. pixel) :param int x: the (zero-based) X coordinate of the pixel :param int y: the (zero-based) Y coordinate of the pixel :returns: the typed value at the given coordinate .. method:: get_elem_size() The size in byte of a single element (sample) of this :class:`Raster` buffer. .. method:: get_height() Gets the :class:`Raster` height in pixels. .. method:: get_width() Gets the :class:`Raster` width in pixels. .. rubric:: Special methods The :class:`Raster` class provides a custom implementation of the following *special methods*: * __repr__ .. index:: __repr__ pair: special; methods EPRTime ~~~~~~~ .. class:: EPRTime Convenience class for time data exchange. EPRTime is a :class:`collections.namedtuple` with the following fields: .. attribute:: days .. attribute:: seconds .. attribute:: microseconds .. index:: function Functions --------- .. function:: open(filename, mode=`rb`) Open the ENVISAT product. Opens the ENVISAT :class:`Product` file with the given file path, reads MPH, SPH and all :class:`DSD`\ s, organized the table with parameter of line length and tie points number. :param PathLike product_file_path: the path to the ENVISAT :class:`Product` file :param str mode: string that specifies the mode in which the file is opened. Allowed values: `rb` for read-only mode, `rb+` for read-write mode. Default: mode=`rb`. :returns: the :class:`Product` instance representing the specified product. An exception (:exc:`exceptions.ValueError`) is raised if the file could not be opened. The :class:`Product` class supports context management so the recommended way to ensure that a product is actually closed as soon as a task is completed is to use the ``with`` statement:: with open('ASA_IMP_1PNUPA20060202_ ... _3110.N1') as product: dataset = product.get_dataset('MAIN_PROCESSING_PARAMS_ADS') record = dataset.read_record(0) print(record) .. seealso :class:`Product` .. function:: data_type_id_to_str(type_id) Gets the 'C' data type string for the given data type. .. function:: get_data_type_size(type_id) Gets the size in bytes for an element of the given data type. .. function:: get_numpy_dtype(type_id) Return the numpy data-type specified EPR type ID. .. versionadded:: 0.9 .. function:: get_sample_model_name(model) Return the name of the specified sample model. .. function:: get_scaling_method_name(method) Return the name of the specified scaling method. .. function:: create_raster(data_type, src_width, src_height[, xstep, ystep]) Creates a :class:`Raster` of the specified data type. This function can be used to create any type of raster, e.g. for later use as a bit-mask. :param data_type: the type of the data to stored in the :class:`Raster`, must be one of E_TID_*. .. seealso:: `Data type Identifiers`_ :param int src_width: the width (across track dimension) of the source to be read into the :class:`Raster`. See description of :meth:`Band.create_compatible_raster` :param int src_height: the height (along track dimension) of the source to be read into the :class:`Raster`. See description of :meth:`Band.create_compatible_raster` :param int xstep: the sub-sampling step across track of the source when reading into the :class:`Raster`. Default: 1. :param int ystep: the sub-sampling step along track of the source when reading into the :class:`Raster`. Default: 1. :returns: the new :class:`Raster` instance .. seealso:: description of :meth:`Band.create_compatible_raster` .. function:: create_bitmask_raster(src_width, src_height[, xstep, ystep]) Creates a :class:`Raster` to be used for reading bit-masks. The :class:`Raster` returned always is of type ``byte``. :param int src_width: the width (across track dimension) of the source to be read into the :class:`Raster` :param int src_height: the height (along track dimension) of the source to be read into the :class:`Raster` :param int xstep: the sub-sampling step across track of the source when reading into the :class:`Raster`. Default: 1. :param int ystep: the sub-sampling step along track of the source when reading into the :class:`Raster`. Default: 1. :returns: the new :class:`Raster` instance or raises an exception (:exc:`EPRValueError`) if an error occurred .. seealso:: the description of :meth:`Band.create_compatible_raster` .. index:: exception, error Exceptions ---------- EPRError ~~~~~~~~ .. exception:: EPRError EPR API error. .. attribute:: code EPR API error code. .. method:: __init__([message[, code, *args, **kwargs]]) Initializer. :param str message: error message :param int code: EPR error code EPRValueError ~~~~~~~~~~~~~ .. exception:: EPRValueError Inherits both :exc:`EPRError` and standard :exc:`exceptions.ValueError`. Data ---- .. data:: __version__ Version string of PyEPR. .. data:: EPR_C_API_VERSION Version string of the wrapped `EPR API`_ C library. Data type identifiers ~~~~~~~~~~~~~~~~~~~~~ .. data:: E_TID_UNKNOWN .. data:: E_TID_UCHAR .. data:: E_TID_CHAR .. data:: E_TID_USHORT .. data:: E_TID_SHORT .. data:: E_TID_UINT .. data:: E_TID_INT .. data:: E_TID_FLOAT .. data:: E_TID_DOUBLE .. data:: E_TID_STRING .. data:: E_TID_SPARE .. data:: E_TID_TIME .. index:: pair: sample; model Sample Models ~~~~~~~~~~~~~ .. data:: E_SMOD_1OF1 .. data:: E_SMOD_1OF2 .. data:: E_SMOD_2OF2 .. data:: E_SMOD_3TOI .. data:: E_SMOD_2TOF .. index:: pair: scaling; method Scaling Methods ~~~~~~~~~~~~~~~ .. data:: E_SMID_NON No scaling. .. data:: E_SMID_LIN Linear pixel scaling. .. index:: linear .. data:: E_SMID_LOG Logarithmic pixel scaling. .. index:: logarithmic pyepr-1.3.1/docs/spelling_wordlist.txt000066400000000000000000000004571525260221700201200ustar00rootroot00000000000000api config constness cython Cythonizing de dev distutils docstrings Docstrings eader epr freethreading gdalvrt geo iname Initializer iter jupyter len libs matadata nd ndarray np pre py pyepr pypi pyproject pythonic qname radiances rb roduct scanline sdist src str toml uchar vapour unittests vectorized pyepr-1.3.1/docs/tutorials.rst000066400000000000000000000002701525260221700163640ustar00rootroot00000000000000Tutorials ========= .. index:: tutorial .. toctree:: :maxdepth: 2 interactive_use bands_example bitmask_example ndvi_example update_example gdal_export_example pyepr-1.3.1/docs/update_example.rst000066400000000000000000000127021525260221700173360ustar00rootroot00000000000000Update :class:`Field` elements ------------------------------ .. highlight:: ipython .. index:: update, field, read-only, EPR-API, MERIS pair: open; mode The EPR C API has been designed to provide read-only features. PyEPR_ provides and extra capability consisting in the possibility to modify (*update*) an existing ENVISAT_ :class:`Product`. Lets consider a MERIS Level 2 low resolution product ( `MER_LRC_2PTGMV20000620_104318_00000104X000_00000_00000_0001.N1`). It has a :class:`Band` named `water_vapour` containing the water vapour content at a specific position. One can load water vapour and compute an histogram using the following instructions: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 8-13 .. index:: matplotlib The resulting histogram can be plot using Matplotlib_: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 15-19 .. figure:: images/water_vapour_histogram_01.* :width: 60% Histogram of the original water vapour content The actual values of the water vapour content :class:`Band` are computed starting form data stored in the `Vapour_Content` :class:`Dataset` using scaling factors contained in the `Scaling_Factor_GADS` :class:`Dataset`. In particular :class:`Field`\ s `sf_wvapour` and `off_wvapour` are used:: In [21]: dataset = product.get_dataset('Scaling_Factor_GADS') In [22]: print(dataset) epr.Dataset(Scaling_Factor_GADS) 1 records sf_cl_opt_thick = 1.000000 sf_cloud_top_press = 4.027559 sf_wvapour = 0.100000 off_cl_opt_thick = -1.000000 off_cloud_top_press = -4.027559 off_wvapour = -0.100000 spare_1 = <> .. index:: band pair: scaling; factor Now suppose that for some reason one needs to update the `sf_wvapour` scaling factor for the water vapour content. Changing the scaling factor, of course, will change all values in the `water_vapour` :class:`Band`. The change can be performed using the :meth:`Field.set_elem` and :meth:`Field.set_elems` methods of :class:`Field` objects: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 22-30 Now the `sf_wvapour` scaling factor has been changed and it is possible to compute and display the histogram of modified data in the `water_vapour` :class:`Band`: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 32-46 .. figure:: images/water_vapour_histogram_02.* :width: 60% Histogram of the water vapour content (original and modified) Figure above shows the two different histograms, original data in blue and modified data in red, demonstrating the effect of the change of the scaling factor. The new map of water vapour is showed in the following picture: .. figure:: images/modified_water_vapour.* Modified water vapour content map .. important:: it is important to stress that it is necessary to close and re-open the :class:`Product` in order to see changes in the scaling factors applied to the `water_vapour`:class:`Band` data. This is a limitation of the current implementation that could be removed in future versions of the PyEPR_ package. It has been showed that changing the `sf_wvapour` scaling factor modifies all values of the `water_vapour` :class:`Band`. Now suppose that one needs to modify only a specific area. It can be done changing the contents of the `Vapour_Content` :class:`Dataset`. The :class:`Dataset` size can be read form the :class:`Product`:: In [44]: product.get_scene_height(), product.get_scene_width() Out[44]: (149, 281) while information about the fields in each record can be retrieved introspecting the :class:`Record` object:: In [49]: record = dataset.read_record(0) In [50]: record.get_field_names() Out[50]: ['dsr_time', 'quality_flag', 'wvapour_cont_pix'] In [51]: record.get_field('wvapour_cont_pix') Out[51]: epr.Field("wvapour_cont_pix") 281 uchar elements So the name of the :class:`Field` we need to change is the `wvapour_cont_pix`, and its index is `2`. It is possible to change a small box inside the :class:`Dataset` as follows: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 58-66 Please note that when one modifies the content of a :class:`Dataset` he/she should also take into account id the corresponding band has lines mirrored or not:: In [59]: band = p.get_band('water_vapour') In [60]: band.lines_mirrored Out[60]: True Finally the :class:`Product` can be re-opened to load and display the modified :class:`Band`: .. raw:: latex \fvset{fontsize=\footnotesize} .. literalinclude:: examples/update_elements.py :language: python :lines: 69-80 .. figure:: images/modified_water_vapour_with_box.* Modified water vapour content map with zeroed box Of course values in the box that has been set to zero in the :class:`Dataset` are transformed according to the scaling factor and offset parameters associated to `water_vapour` :class:`Band`. The complete code of the example can be found at :download:`examples/update_elements.py`. .. _PyEPR: https://github.com/avalentino/pyepr .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _Matplotlib: https://matplotlib.org .. raw:: latex \clearpage pyepr-1.3.1/docs/usermanual.rst000066400000000000000000000423111525260221700165140ustar00rootroot00000000000000User Manual =========== .. index:: EPR-API, ENVISAT, MERIS, AASTR, ASAR, ESA single: product; dataset; record; close pair: epr; module Quick start ----------- PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. Full access to the Python EPR API is provided by the :mod:`epr` module that have to be imported by the client program e.g. as follows:: import epr The following snippet open an ASAR product and dumps the "Main Processing Parameters" record to the standard output:: import epr product = epr.Product( 'ASA_IMP_1PNESA20060202_062238_000000152044_00435_20529_0000.N1' ) dataset = product.get_dataset('MAIN_PROCESSING_PARAMS_ADS') record = dataset.read_record(0) print(record) product.close() Since version 0.9 PyEPR_ also include *update* features that are not available in the EPR C API. The user can open a product in update mode (`rb+`) and call the :meth:`epr.Field.set_elem` and :meth:`epr.Field.set_elems` methods of :class:`epr.Field` class to update its elements and write changes to disk. .. seealso:: `Update support`_ and :doc:`update_example` tutorial for details. .. index:: pair: open; mode .. _PyEPR: https://github.com/avalentino/pyepr .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int .. index:: requirements, EPR-API, Python, numpy, cython, pytest, gcc, extension Requirements ------------ In order to use PyEPR it is needed that the following software are correctly installed and configured: * Python3_ >= 3.5 (including PyPy3_) * numpy_ >= 1.7.0 * `EPR API`_ >= 2.2 (optional, since PyEPR 0.7 the source tar-ball comes with a copy of the EPR C API sources) * a reasonably updated C compiler [#]_ (build only) * Cython_ >= 0.29.22 [#]_ (build only) * pytest_ (optional and only needed for testing) .. [#] PyEPR_ has been developed and tested with gcc_ 4. .. [#] The source tarball of official releases also includes the C extension code generated by cython_ so users don't strictly need cython_ to install PyEPR_. It is only needed to re-generate the C extension code (e.g. if one wants to build a development version of PyEPR_). .. _Python3: Python_ .. _PyPy3: https://www.pypy.org .. _numpy: https://numpy.org .. _gcc: http://gcc.gnu.org .. _Cython: https://cython.org .. _pytest: https://pytest.org .. index:: download, PyPi, GitHub, project, git pair: git; clone Download -------- .. highlight:: sh Official source tar-balls can be downloaded form PyPi_: https://pypi.org/project/pyepr The source code of the development versions is available on the GitHub_ project page https://github.com/avalentino/pyepr To clone the git_ repository the following command can be used:: $ git clone https://github.com/avalentino/pyepr.git To get also the EPR C API source code, the following commands are necessary:: $ cd pyepr $ git submodule init Submodule 'extern/epr-api' (https://github.com/avalentino/epr-api.git) registered for path 'extern/epr-api' $ git submodule update Cloning into '/Users/antonio valentino/projects/av/pyepr/extern/epr-api'... Submodule path 'extern/epr-api': checked out '93c1f1efce26c64d508fe882d5c72a898a068f29' .. _PyPi: https://pypi.org .. _GitHub: https://github.com .. _git: https://git-scm.com .. index:: install, pip pair: install; user pair: install; option pair: install; prefix .. _installation: Installation ------------ The easier way to install PyEPR_ is using tools like pip_:: $ python3 -m pip install pyepr For a user specific installation please use:: $ python3 -m pip install --user pyepr To install PyEPR_ in a non-standard path:: $ python3 -m pip install --install-option="--prefix=" pyepr just make sure that :file:`/lib/pythonX.Y/site-packages` is in the :envvar:`PYTHONPATH`. .. index:: single: sources; setup.py pair: standalone; mode pair: EPR-API; sources pair: dynamic; library pair: git; repository PyEPR_ can be installed from sources using the following command:: $ python3 -m pip install . The :file:`setup.py` script by default checks for the availability of the EPR C API source code in the :file:`/epr-api-src` directory and tries to build PyEPR in *standalone mode*, i.e. without linking an external dynamic library of EPR-API. If no EPR C API sources are found then the :file:`setup.py` script automatically tries to link the EPR-API dynamic library. This can happen, for example, if the user is using a copy of the PyEPR sources cloned from a git_ repository. In this case it is assumed that the `EPR API`_ C library is properly installed in the system (see the Requirements_ section). It is possible to control which `EPR API`_ C sources to use by means of the `--epr-api-src` option of the :file:`setup.py` script:: $ python3 setup.py install --epr-api-src=../epr-api/src Also it is possible to switch off the *standalone mode* and force the link with the system `EPR API`_ C library:: $ python3 setup.py install --epr-api-src="" Please note that if the ``setup.py`` script is invoked directly, then the user must make sure that setup requirements are properly installed:: $ python3 -m pip install cython numpy .. _pip: https://pypi.org/project/pip .. index:: test, setup.py, download, pytest pair: test; suite pair: sample; product Testing ------- PyEPR_ package comes with a complete test suite. The test suite can be run from the package root directory using pytest_:: $ python3 -m pytest tests or running the :file:`test_all.py` script directly:: $ python3 test_all.py In the second case please make sure that the :mod:`epr` extension module is in the Python search path (see also :envvar:`PYTHONPATH`). The test script automatically downloads and decompresses the ENVISAT sample product necessary for testing, MER_LRC_2PTGMV20000620_104318_00000104X000_00000_00000_0001.N1, if it is not already available in the :file:`tests` directory. .. note:: please note that, unless the user already have a copy of the specified sample product correctly installed, an **internet connection** is necessary the first time that the test suite is run. After the first run the sample product remains in the :file:`tests` directory so the internet access is no longer necessary. .. index:: EPR-API Python vs C API --------------- The Python_ EPR API is fully object oriented. The main structures of the C API have been implemented as objects while C function have been logically grouped and mapped onto object methods. The entire process of defining an object oriented API for Python_ has been quite easy and straightforward thanks to the good design of the C API, Of course there are also some differences that are illustrated in the following sections. .. index:: memory, product pair: allocation; de-allocation Memory management ----------------- .. highlight:: python Being Python_ a very high level language uses have never to worry about memory allocation/de-allocation. They simply have to instantiate objects:: product = epr.Product('filename.N1') and use them freely. Objects are automatically destroyed when there are no more references to them and memory is de-allocated automatically. Even better, each object holds a reference to other objects it depends on so the user never have to worry about identifiers validity or about the correct order structures have to be freed. For example: the C `EPR_DatasetId` structure has a field (`product_id`) that points to the *product* descriptor `EPR_productId` to which it belongs to. .. index:: dataset, record The reference to the parent product is used, for example, when one wants to read a record using the `epr_read_record` function: .. code-block:: c EPR_SRecord* epr_read_record(EPR_SDatasetId* dataset_id, ...); The function takes a `EPR_SDatasetId` as a parameter and assumes all fields (including ``dataset->product_id``) are valid. It is responsibility of the programmer to keep all structures valid and free them at the right moment and in the correct order. This is the standard way to go in C but not in Python_. In Python_ all is by far simpler, and the user can get a *dateset* object instance:: dataset = product.get_dataset('MAIN_PROCESSING_PARAMS_ADS') and then forget about the *product* instance it depends on. Even if the *product* variable goes out of :index:`scope` and it is no more directly accessible in the program the *dataset* object keeps staying valid since it holds an internal reference to the *product* instance it depends on. When *record* is destroyed automatically also the parent :class:`epr.Product` object is destroyed (assumed there is no other :index:`reference` to it). The entire machinery is completely automatic and transparent to the user. .. note:: of course when a *product* object is explicitly closed using the :meth:`epr.Product.close` any I/O operation on it and on other objects (bands, datasets, etc) associated to it is no more possible. .. index:: close .. index:: array, numpy, raster Arrays ------ PyEPR_ uses numpy_ in order to manage efficiently the potentially large amount of data contained in ENVISAT_ products. * :meth:`epr.Field.get_elems` return an 1D array containing elements of the field * the `Raster.data` property is a 2D array exposes data contained in the :class:`epr.Raster` object in form of :class:`numpy.ndarray` .. note:: :attr:`epr.Raster.data` directly exposes :class:`epr.Raster` i.e. shares the same memory buffer with :class:`epr.Raster`:: >>> raster.get_pixel(i, j) 5 >>> raster.data[i, j] 5 >>> raster.data[i, j] = 3 >>> raster.get_pixel(i, j) 3 * :meth:`epr.Band.read_as_array` is an additional method provided by the Python_ EPR API (does not exist any correspondent function in the C API). It is mainly a facility method that allows users to get access to band data without creating an intermediate :class:`epr.Raster` object. It read a slice of data from the :class:`epr.Band` and returns it as a 2D :class:`numpy.ndarray`. .. index:: read_as_aaray, data .. index:: enumeration pair: module; constant Enumerators ----------- Python_ does not have *enumerators* at language level (at least this is true for Python_ < 3.4). Enumerations are simply mapped as module constants that have the same name of the C enumerate but are spelled all in capital letters. For example: ============== ============== C Python ============== ============== `e_tid_double` `E_TID_DOUBLE` `e_smod_1OF1` `E_SMOD_1OF1` `e_smid_log` `E_SMID_LOG` ============== ============== .. index:: logging, error, exception, EPR-API Error handling and logging -------------------------- Currently error handling and logging functions of the EPR C API are not exposed to python. Internal library logging is completely silenced and errors are converted to Python_ exceptions. Where appropriate standard Python_ exception types are use in other cases custom exception types (e.g. :exc:`epr.EPRError`, :exc:`epr.EPRValueError`) are used. .. index:: library, module, APR-API pair: library; initialization Library initialization ---------------------- Differently from the C API library initialization is not needed: it is performed internally the first time the :mod:`epr` module is imported in Python_. .. index:: API pair: high-level; API High level API -------------- PyEPR_ provides some utility method that has no correspondent in the C API: * :meth:`epr.Record.fields` * :meth:`epr.Record.get_field_names` * :meth:`epr.Dataset.records` * :meth:`epr.Product.get_dataset_names` * :meth:`epr.Product.get_band_names` * :meth:`epr.Product.datasets` * :meth:`epr.Product.bands` Example:: for dataset in product.datasets(): for record in dataset.records(): print(record) print() Another example:: if 'proc_data' in product.band_names(): band = product.get_band('proc_data') print(band) .. index:: __str__, __repr__, print, pair: special; methods Special methods --------------- The Python_ EPR API also implements some `special method`_ in order to make EPR programming even handy and, in short, *pythonic*. The ``__repr__`` methods have been overridden to provide a little more information with respect to the standard implementation. In some cases ``__str__`` method have been overridden to output a verbose string representation of the objects and their contents. If the EPR object has a ``print`` method (like e.g. :meth:`epr.Record.print` and :meth:`epr.Field.print`) then the string representation of the object will have the same format used by the ``print`` method. So writing:: fd.write(str(record)) giver the same result of:: record.print(fd) Of course the :meth:`epr.Record.print` method is more efficient for writing to file. .. index:: __iter__ Also :class:`epr.Dataset` and :class:`epr.Record` classes implement the ``__iter__`` `special method`_ for iterating over records and fields respectively. So it is possible to write code like the following:: for record in dataset: for index, field in enumerate(record): print(index, field) .. index:: __eq__ :class:`epr.DSD` and :class:`epr.Field` classes implement the ``__eq__`` and ``__ne__`` methods for objects comparison:: if filed1 == field2: print('field 1 and field2 are equal') print(field1) else: print('field1:', field1) print('field2:', field2) .. index:: __len__ :class:`epr.Field` object also implement the ``__len__`` special method that returns the number of elements in the field:: if field.get_type() != epr.E_TID_STRING: assert field.get_num_elems() == len(field) else: assert len(field) == len(field.get_elem()) .. note:: differently from the :meth:`epr.Field.get_num_elems` method ``len(field)`` return the number of elements if the field type is not :data:`epr.E_TID_STRING`. If the field contains a string then the string length is returned. .. index:: __enter__, __exit__, context, with pair: context; manager pair: with; statement Finally the :class:`epr.Product` class acts as a `context manager`_ (i.e. it implements the ``__enter__`` and ``__exit__`` methods). This allows the user to write code like the following:: with epr.open('ASA_IMS_ ... _4650.N1') as product: print(product) that ensure that the product is closed as soon as the program exits the ``with`` block. .. index:: update, ENVISAT pair: open; mode Update support -------------- It is not possible to create new ENVISAT_ products for scratch with the EPR API. Indeed EPR means "**E**\ NVISAT **P**\ roduct **R**\ eader". Anyway, since version 0.9, PyEPR_ also include basic *update* features. This means that, while it is still not possible to create new :class:`Products`, the user can *update* existing ones changing the contents of any :class:`Field` in any record with the only exception of MPH and SPH :class:`Field`\s. The user can open a product in update mode (`rb+`):: product = epr.open('ASA_IMS_ ... _4650.N1', 'rb+') and update the :class:`epr.Field` element at a specific index:: field.set_elem(new_value, index) or also update all elements of the :class:`epr.Field` in one shot:: field.set_elems(new_values) .. note:: unfortunately there are some limitations to the update support. Many of the internal structures of the EPR C API are loaded when the :class:`Product` is opened and are not automatically updated when the :meth:`epr.Field.set_elem` and :meth:`epr.Field.set_elems` methods are called. In particular :class:`epr.Band`\ s contents may depend on several :class:`epr.Field` values, e.g. the contents of `Scaling_Factor_GADS` :class:`epr.Dataset`. For this reason the user may need to close and re-open the :class:`epr.Product` in order to have all changes effectively applied. .. seealso:: :doc:`update_example` .. index:: pair: scaling; factor .. _`special method`: https://docs.python.org/3/reference/datamodel.html .. _`context manager`: https://docs.python.org/3/library/stdtypes.html#context-manager-types .. _free-threading: Thread safety and "freethreading" support ----------------------------------------- The `epr` extension is based on a C library that **is not thread safe**. The use of `epr` in multi-thread applications requires a proper locking mechanism to be implemented on the client side. The `epr` extension module is marked as `freethreading_compatible` only to allow its use with a "Free-Threaded" Python interpreter (e.g. Python 3.14t). Nevertheless, is such situations, special care shall taken to avoid that the functions and classes provided by the `epr` extension module are use concurrently by the application. pyepr-1.3.1/extern/000077500000000000000000000000001525260221700141625ustar00rootroot00000000000000pyepr-1.3.1/extern/epr-api/000077500000000000000000000000001525260221700155175ustar00rootroot00000000000000pyepr-1.3.1/pyproject.toml000066400000000000000000000174751525260221700156070ustar00rootroot00000000000000[build-system] requires = [ "setuptools >=77.0.3", "packaging", "cython >=3.1", "numpy >=2", ] build-backend = "setuptools.build_meta" [project] name = "pyepr" authors = [ {name = "Antonio Valentino", email = "antonio.valentino@tiscali.it"}, ] description = "Python ENVISAT Product Reader API" requires-python = ">=3.11, <4" keywords = ["satellite", "reader", "envisat"] license = "GPL-3.0-or-later" license-files = ["LICENSE.txt", "LICENSES/*"] classifiers = [ "Development Status :: 5 - Production/Stable", "Environment :: Other Environment", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Free Threading :: 2 - Beta", "Programming Language :: Cython", "Topic :: Software Development :: Libraries", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: GIS", ] dependencies = [ "numpy >=2", ] dynamic = ["version"] [project.readme] text = """\ PyEPR provides Python_ bindings for the ENVISAT_ Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: https://earth.esa.int """ content-type = "text/x-rst" [project.urls] Homepage = "https://github.com/avalentino/pyepr" Documentation = "https://pyepr.readthedocs.io" Repository = "https://github.com/avalentino/pyepr.git" Changelog = "https://pyepr.readthedocs.io/en/latest/NEWS.html" Issues = "https://github.com/avalentino/pyepr/issues" [dependency-groups] docs = [ "sphinx", "sphinx_rtd_theme", "sphinxcontrib-spelling", "packaging", "ipython", ] test = ["pytest", "packaging", "pooch"] coverage = [ "pytest-cov", "coverage[toml]", "cython", "numpy >=2", {include-group = "test"}, ] lint = ["flake8", "pydocstyle", "isort", "black", "ruff", "mypy", "codespell"] dev = [ "python-build", "twine", "setuptools >=77.0.3", "packaging", "cython >=3.1", "numpy >=2", "tox", {include-group = "docs"}, {include-group = "test"}, {include-group = "coverage"}, {include-group = "lint"}, ] [tool.setuptools] packages = ["epr"] package-dir = {"" = "src"} [tool.setuptools.dynamic] version = {attr = "epr.__version__"} [tool.setuptools.package-data] epr = ["py.typed", "*.pyi"] [tool.cibuildwheel] build = ["cp311-*", "cp31?t-*"] test-groups = ["test"] test-command = "pytest -v {project}/tests" [tool.pytest.ini_options] addopts = [ "--import-mode=importlib", ] [tool.coverage.run] branch = true core = "ctrace" plugins = ["Cython.Coverage"] source_pkgs = ["epr"] [tool.black] line-length = 79 preview = true enable-unstable-feature = [ "hug_parens_with_braces_and_square_brackets", "string_processing", "wrap_long_dict_values_in_parens", ] target-version = ['py311'] [tool.isort] profile = "black" length_sort = true multi_line_output = 3 no_inline_sort = true include_trailing_comma = true use_parentheses = true line_length = 79 # force_grid_wrap = 0 # ensure_newline_before_comments = true known_first_party = ["epr"] # skip_glob = ["packagename/parse/*"] [tool.pydocstyle] add-ignore = ["D105"] # add-ignore = ["D105", "D107"] match='(?!(test_|conf)).*\.py' [tool.codespell] skip = "*.pdf,*.ipynb,./docs/spelling_wordlist.txt,*.N1,extern,./src/epr/*.c,./docs/_build,./htmlcov" count = true quiet-level = 3 ignore-words="docs/spelling_wordlist.txt" [tool.mypy] exclude = [ "^docs/conf\\.py$", ] [tool.ruff] line-length = 79 target-version = "py311" extend-exclude = ["docs/conf.py"] [tool.ruff.lint] preview = true select = [ # ruff --version # ruff 0.16.3 # ruff linter "E", # E/W pycodestyle "W", # E/W pycodestyle "F", # F Pyflakes "D", # D pydocstyle "N", # N pep8-naming "I", # I isort "C90", # C90 mccabe "UP", # UP pyupgrade # --- flake8 --- "YTT", # YTT flake8-2020 # "ANN", # ANN flake8-annotations # "ASYNC", #ASYNC flake8-async # "S", # S flake8-bandit "BLE", # BLE flake8-blind-except "FBT", # FBT flake8-boolean-trap "B", # B flake8-bugbear "A", # A flake8-builtins # "COM", # COM flake8-commas "C4", # C4 flake8-comprehensions # "CPY", # CPY flake8-copyright "DTZ", # DTZ flake8-datetimez "T10", # T10 flake8-debugger "DJ", # DJ flake8-django # "EM", # EM flake8-errmsg "EXE", # EXE flake8-executable # "FIX", # FIX flake8-fixme # manual "FA", # FA flake8-future-annotations # "INT", # INT flake8-gettext "ISC", # ISC flake8-implicit-str-concat "ICN", # ICN flake8-import-conventions # "LOG", # LOG flake8-logging "G", # G flake8-logging-format "INP", # INP flake8-no-pep420 "PIE", # PIE flake8-pie "T20", # T20 flake8-print "PYI", # PYI flake8-pyi # "PT", # PT flake8-pytest-style # manual "Q", # Q flake8-quotes "RSE", # RSE flake8-raise "RET", # RET flake8-return "SLF", # SLF flake8-self "SIM", # SIM flake8-simplify "SLOT", # SLOT flake8-slots "TID", # TID flake8-tidy-imports # "TD", # TD flake8-todos # "TC", # TC flake8-type-checking "ARG", # ARG flake8-unused-arguments "PTH", # PTH flake8-use-pathlib # --- misc --- # "AIR", # AIR Airflow # "ERA", # ERA eradicate # manual # "FAST", # FAST FastAPI "FLY", # FLY flynt "NPY", # NPY NumPy-specific rules # "PD", # PD pandas-vet "PERF", # PERF Perflint # "DOC", # DOC pydoclint "PGH", # PGH pygrep-hooks "PL", # PL Pylint # "FURB", # FURB refurb # --preview "RUF", # RUF Ruff-specific rules # "TRY", # TRY tryceratops # manual ] extend-ignore = [ # "D105", # D105 Missing docstring in magic method # "D107", # D107 Missing docstring in `__init__` "D203", # D203 1 blank line required before class docstring "D213", # D213 Multi-line docstring summary should start at the second line "RUF105" # RUF105 noqa-comments ] [tool.ruff.format] preview = true docstring-code-format = true [tool.ruff.lint.per-file-ignores] "setup.py" = ["D", "N806", "PLC0415", "PTH110", "PTH118", "PTH207", "T201"] "tests/*" = ["D"] "tests/test_all.py" = ["RUF012", "T201"] "docs/conf.py" = ["A001", "D", "INP001", "N812", "PLC0415", "PTH123"] "docs/examples/export_gdalvrt.py" = ["D", "PTH110", "PTH122", "T201"] "docs/examples/write_bands.py" = ["D", "PTH123", "PLR2004", "PTH118", "T201"] "docs/examples/write_bitmask.py" = ["D", "PLR2004", "PTH123", "T201"] "docs/examples/write_ndvi.py" = ["D", "PLR0914", "PLR2004", "PTH123", "T201"] "docs/examples/update_elements.py" = ["D"] [tool.ruff.lint.isort] length-sort = true known-first-party = ["epr"] [tool.ruff.lint.flake8-import-conventions.extend-aliases] "xml.etree.ElementTree" = "etree" pyepr-1.3.1/setup.py000077500000000000000000000155071525260221700144020ustar00rootroot00000000000000#!/usr/bin/env python3 # Copyright (C) 2011-2026, Antonio Valentino # # This file is part of PyEPR. # # PyEPR is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PyEPR is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PyEPR. If not, see . import os import re import sys import glob import warnings import sysconfig import setuptools try: import Cython print(f"CYTHON_VERSION: {Cython.__version__}") del Cython except ImportError: print("CYTHON not installed") # https://mail.python.org/pipermail/distutils-sig/2007-September/008253.html class NumpyExtension(setuptools.Extension): """Extension type that adds the NumPy include directory to include_dirs.""" @property def include_dirs(self): from numpy import get_include return [*self._include_dirs, get_include()] @include_dirs.setter def include_dirs(self, include_dirs): self._include_dirs = include_dirs def tag_to_packed_version(tag: str) -> tuple[int, bool]: mobj = re.match( r"cp(?P\d{1})(?P\d{2})(?Pt)?", tag ) if mobj is None: raise ValueError(f"invalid version tag: {tag!r}") major = int(mobj.group("major")) minor = int(mobj.group("minor")) packed_version = (major << 24) + (minor << 16) free_threading = bool(mobj.group("free_threading") is not None) return packed_version, free_threading def setup_extension( eprsrcdir=None, *, coverage: bool = False, py_limited_api: str | None = None, ): if eprsrcdir: print(f'EPR_API: using EPR C API sources at "{eprsrcdir}"') extra_sources = glob.glob(f"{eprsrcdir}/epr_*.c") include_dirs = [eprsrcdir] libraries = [] else: print("EPR_API: using pre-built dynamic library for EPR C API") extra_sources = [] include_dirs = [] libraries = ["epr_api"] define_macros: list[tuple[str, str | None]] = [ ("NPY_NO_DEPRECATED_API", "NPY_1_7_API_VERSION") ] if coverage: define_macros.extend([ ("CYTHON_TRACE_NOGIL", "1"), ("CYTHON_USE_SYS_MONITORING", "0"), ]) if py_limited_api is not None: warnings.warn( "The use of 'limited_api` is not compatible with the " "'coverage': 'limited_api' will be ignored", stacklevel=2, ) elif py_limited_api is not None: packed_version, free_threading = tag_to_packed_version(py_limited_api) macro_name = "Py_LIMITED_APIT" if free_threading else "Py_LIMITED_API" hex_version = f"0x{packed_version:08X}" print(f"{macro_name}: {hex_version} ({py_limited_api})") if free_threading and not sysconfig.get_config_var("Py_GIL_DISABLED"): warnings.warn( "Trying to use a free-threading stable API with a Python " "interpreter that has GIL enabled", stacklevel=1, ) define_macros.append((macro_name, hex_version)) ext = NumpyExtension( "epr._epr", sources=[os.path.join("src", "epr", "_epr.pyx"), *extra_sources], include_dirs=include_dirs, libraries=libraries, language="c", define_macros=define_macros, py_limited_api=bool(py_limited_api is not None), ) # compiler directives language_level = "3" ext.cython_directives = {"language_level": language_level} print(f"CYTHON_LANGUAGE_LEVEL: {language_level}") if coverage: ext.cython_directives["linetrace"] = True ext.cython_directives["freethreading_compatible"] = True return ext def make_config( eprsrcdir=None, *, coverage=False, py_limited_api: str | None = None, ): if not py_limited_api: py_limited_api = None elif py_limited_api == "AUTO": if not sysconfig.get_config_var("Py_GIL_DISABLED"): py_limited_api = "cp311" else: py_limited_api = None config = { "ext_modules": [ setup_extension( eprsrcdir, coverage=coverage, py_limited_api=py_limited_api ), ] } if py_limited_api is not None: config["options"] = {"bdist_wheel": {"py_limited_api": py_limited_api}} return config def get_parser(): import argparse DEFAULT_EPRAPI_SRC = "extern/epr-api/src" if not os.path.exists(DEFAULT_EPRAPI_SRC): DEFAULT_EPRAPI_SRC = "" DEFAULT_EPRAPI_SRC = os.environ.get("PYEPR_EPRAPI_SRC", DEFAULT_EPRAPI_SRC) DEFAULT_PY_LIMITED_API = os.environ.get("PY_LIMITED_API", None) PYEPR_COVERAGE_STR = os.environ.get("PYEPR_COVERAGE", "").upper() DEFAULT_COVERAGE = bool( PYEPR_COVERAGE_STR in {"Y", "YES", "TRUE", "OK", "ON", "1"} ) parser = argparse.ArgumentParser(add_help=False) parser.add_argument( "--epr-api-src", default=DEFAULT_EPRAPI_SRC, help=( "set the path to the EPR-API source tree. " "If not set uses the system libraries for epr-api. " "Default: %(default)s" ), ) parser.add_argument( "--use-stable-api", dest="py_limited_api", default=DEFAULT_PY_LIMITED_API, help=( "enable the use of the specified stable Python API " "(and limited ABI)." "If 'None', the use of limited API is disabled. " "E.g.: 'cp312' for Python 3.12. " f"Default: {DEFAULT_PY_LIMITED_API}." ), ) parser.add_argument( "--coverage", action="store_true", default=DEFAULT_COVERAGE, help=( "build the epr module to allow cython coverage measurement " "(default: %(default)s)" ), ) return parser if __name__ == "__main__": parser = get_parser() extra_args, setup_argv = parser.parse_known_args(sys.argv) sys.argv[:] = setup_argv print("PY_LIMITED_API:", extra_args.py_limited_api) print("PYEPR_COVERAGE:", extra_args.coverage) config = make_config( extra_args.epr_api_src, coverage=extra_args.coverage, py_limited_api=extra_args.py_limited_api, ) if "-h" in setup_argv or "--help" in setup_argv: msg = parser.format_help() msg = "\n".join(msg.splitlines()[2:]) # remove usage string print(msg) print() print("config:", config) setuptools.setup(**config) pyepr-1.3.1/src/000077500000000000000000000000001525260221700134445ustar00rootroot00000000000000pyepr-1.3.1/src/epr/000077500000000000000000000000001525260221700142325ustar00rootroot00000000000000pyepr-1.3.1/src/epr/__init__.py000066400000000000000000000044501525260221700163460ustar00rootroot00000000000000# PyEPR - Python bindings for ENVISAT Product Reader API # # Copyright (C) 2011-2026, Antonio Valentino # # This file is part of PyEPR. # # PyEPR is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PyEPR is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PyEPR. If not, see . """Python bindings for ENVISAT Product Reader C API. PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API (`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European Space Agency) mission. PyEPR_ is fully object oriented and, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR Level 1B and Level 2 and also ASAR data products. It provides access to the data either on a geophysical (decoded, ready-to-use pixel samples) or on a raw data layer. The raw data access makes it possible to read any data field contained in a product file. .. _PyEPR: https://pyepr.readthedocs.io .. _Python: https://www.python.org .. _`EPR API`: https://github.com/bcdev/epr-api .. _ENVISAT: https://earth.esa.int/eogateway/missions/envisat .. _ESA: http://earth.esa.int """ from ._epr import ( # noqa: F401 DSD, MJD, E_TID_INT, E_SMID_LIN, E_SMID_LOG, E_SMID_NON, E_TID_CHAR, E_TID_TIME, E_TID_UINT, E_SMOD_1OF1, E_SMOD_1OF2, E_SMOD_2OF2, E_SMOD_2TOF, E_SMOD_3TOI, E_TID_FLOAT, E_TID_SHORT, E_TID_SPARE, E_TID_UCHAR, E_TID_DOUBLE, E_TID_STRING, E_TID_USHORT, E_TID_UNKNOWN, EPR_C_API_VERSION, Band, Field, Raster, Record, Dataset, EPRTime, Product, EPRError, EprObject, EPRValueError, open, # noqa: A004 create_raster, get_numpy_dtype, get_data_type_size, data_type_id_to_str, create_bitmask_raster, get_sample_model_name, get_scaling_method_name, ) __version__ = "1.3.1" pyepr-1.3.1/src/epr/_epr.pxd000066400000000000000000000271431525260221700157030ustar00rootroot00000000000000# -*- coding: utf-8 -*- # PyEPR - Python bindings for ENVISAT Product Reader API # # Copyright (C) 2011-2026, Antonio Valentino # # This file is part of PyEPR. # # PyEPR is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PyEPR is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PyEPR. If not, see . from libc.stdio cimport FILE cdef extern from 'epr_api.h' nogil: char* EPR_PRODUCT_API_VERSION_STR ctypedef int epr_boolean ctypedef unsigned char uchar ctypedef unsigned short ushort ctypedef unsigned int uint ctypedef unsigned long ulong ctypedef EPR_Time EPR_STime # ctypedef EPR_FlagDef EPR_SFlagDef ctypedef EPR_PtrArray EPR_SPtrArray ctypedef EPR_FieldInfo EPR_SFieldInfo ctypedef EPR_RecordInfo EPR_SRecordInfo ctypedef EPR_Field EPR_SField ctypedef EPR_Record EPR_SRecord ctypedef EPR_DSD EPR_SDSD ctypedef EPR_Raster EPR_SRaster ctypedef EPR_BandId EPR_SBandId ctypedef EPR_DatasetId EPR_SDatasetId ctypedef EPR_ProductId EPR_SProductId ctypedef EPR_ErrCode EPR_EErrCode ctypedef EPR_LogLevel EPR_ELogLevel ctypedef EPR_SampleModel EPR_ESampleModel ctypedef EPR_ScalingMethod EPR_EScalingMethod ctypedef EPR_DataTypeId EPR_EDataTypeId ctypedef int EPR_Magic int EPR_MAGIC_PRODUCT_ID int EPR_MAGIC_DATASET_ID int EPR_MAGIC_BAND_ID int EPR_MAGIC_RECORD int EPR_MAGIC_FIELD int EPR_MAGIC_RASTER int EPR_MAGIC_FLAG_DEF enum EPR_ErrCode: e_err_none = 0 e_err_null_pointer = 1 e_err_illegal_arg = 2 e_err_illegal_state = 3 e_err_out_of_memory = 4 e_err_index_out_of_range = 5 e_err_illegal_conversion = 6 e_err_illegal_data_type = 7 e_err_file_not_found = 101 e_err_file_access_denied = 102 e_err_file_read_error = 103 e_err_file_write_error = 104 e_err_file_open_failed = 105 e_err_file_close_failed = 106 e_err_api_not_initialized = 201 e_err_invalid_product_id = 203 e_err_invalid_record = 204 e_err_invalid_band = 205 e_err_invalid_raster = 206 e_err_invalid_dataset_name = 207 e_err_invalid_field_name = 208 e_err_invalid_record_name = 209 e_err_invalid_product_name = 210 e_err_invalid_band_name = 211 e_err_invalid_data_format = 212 e_err_invalid_value = 213 e_err_invalid_keyword_name = 214 e_err_unknown_endian_order = 216 e_err_flag_not_found = 301 e_err_invalid_ddbb_format = 402 enum EPR_DataTypeId: e_tid_unknown = 0 e_tid_uchar = 1 e_tid_char = 2 e_tid_ushort = 3 e_tid_short = 4 e_tid_uint = 5 e_tid_int = 6 e_tid_float = 7 e_tid_double = 8 e_tid_string = 11 e_tid_spare = 13 e_tid_time = 21 enum EPR_LogLevel: e_log_debug = -1 e_log_info = 0 e_log_warning = 1 e_log_error = 2 enum EPR_SampleModel: e_smod_1OF1 = 0 e_smod_1OF2 = 1 e_smod_2OF2 = 2 e_smod_3TOI = 3 e_smod_2TOF = 4 enum EPR_ScalingMethod: e_smid_non = 0 e_smid_lin = 1 e_smid_log = 2 struct EPR_Time: int days uint seconds uint microseconds struct EPR_FlagDef: EPR_Magic magic char* name uint bit_mask char* description struct EPR_PtrArray: unsigned int capacity unsigned int length void** elems struct EPR_Field: EPR_Magic magic EPR_FieldInfo* info void* elems struct EPR_Record: EPR_Magic magic EPR_RecordInfo* info uint num_fields EPR_Field** fields struct EPR_DSD: EPR_Magic magic int index char* ds_name char* ds_type char* filename uint ds_offset uint ds_size uint num_dsr uint dsr_size struct EPR_Raster: EPR_Magic magic EPR_DataTypeId data_type uint elem_size uint source_width uint source_height uint source_step_x uint source_step_y uint raster_width uint raster_height void* buffer struct EPR_ProductId: EPR_Magic magic char* file_path FILE* istream uint tot_size uint scene_width uint scene_height char* id_string EPR_Record* mph_record EPR_Record* sph_record EPR_PtrArray* dsd_array EPR_PtrArray* record_info_cache EPR_PtrArray* param_table EPR_PtrArray* dataset_ids EPR_PtrArray* band_ids int meris_iodd_version struct EPR_DatasetId: EPR_Magic magic EPR_ProductId* product_id char* dsd_name EPR_DSD* dsd char* dataset_name # struct RecordDescriptor* record_descriptor EPR_SRecordInfo* record_info char* description struct EPR_DatasetRef: EPR_DatasetId* dataset_id int field_index # -1 if not used int elem_index # -1 if not used struct EPR_BandId: EPR_Magic magic EPR_ProductId* product_id char* band_name int spectr_band_index EPR_DatasetRef dataset_ref EPR_SampleModel sample_model EPR_DataTypeId data_type EPR_ScalingMethod scaling_method float scaling_offset float scaling_factor char* bm_expr EPR_SPtrArray* flag_coding char* unit char* description epr_boolean lines_mirrored # @TODO: improve logging and error management (--> custom handlers) # logging and error handling function pointers ctypedef void (*EPR_FLogHandler)(EPR_ELogLevel, char*) ctypedef void (*EPR_FErrHandler)(EPR_EErrCode, char*) # logging int epr_set_log_level(EPR_ELogLevel) void epr_set_log_handler(EPR_FLogHandler) void epr_log_message(EPR_ELogLevel, char*) # error handling void epr_set_err_handler(EPR_FErrHandler) EPR_EErrCode epr_get_last_err_code() const char* epr_get_last_err_message() void epr_clear_err() # API initialization/finalization int epr_init_api(EPR_ELogLevel, EPR_FLogHandler, EPR_FErrHandler) void epr_close_api() # DATATYPE uint epr_get_data_type_size(EPR_EDataTypeId) const char* epr_data_type_id_to_str(EPR_EDataTypeId) # open products EPR_SProductId* epr_open_product(char*) # PRODUCT int epr_close_product(EPR_SProductId*) uint epr_get_scene_width(EPR_SProductId*) uint epr_get_scene_height(EPR_SProductId*) uint epr_get_num_datasets(EPR_SProductId*) EPR_SDatasetId* epr_get_dataset_id_at(EPR_SProductId*, uint) EPR_SDatasetId* epr_get_dataset_id(EPR_SProductId*, char*) uint epr_get_num_dsds(EPR_SProductId*) EPR_SDSD* epr_get_dsd_at(EPR_SProductId*, uint) EPR_SRecord* epr_get_mph(EPR_SProductId*) EPR_SRecord* epr_get_sph(EPR_SProductId*) uint epr_get_num_bands(EPR_SProductId*) EPR_SBandId* epr_get_band_id_at(EPR_SProductId*, uint) EPR_SBandId* epr_get_band_id(EPR_SProductId*, char*) int epr_read_bitmask_raster(EPR_SProductId*, char*, int, int, EPR_SRaster*) # DATASET const char* epr_get_dataset_name(EPR_SDatasetId*) const char* epr_get_dsd_name(EPR_SDatasetId*) uint epr_get_num_records(EPR_SDatasetId*) EPR_SDSD* epr_get_dsd(EPR_SDatasetId*) EPR_SRecord* epr_create_record(EPR_SDatasetId*) EPR_SRecord* epr_read_record(EPR_SDatasetId*, uint, EPR_SRecord*) # RECORD void epr_free_record(EPR_SRecord*) uint epr_get_num_fields(EPR_SRecord*) void epr_print_record(EPR_SRecord*, FILE*) void epr_print_element(EPR_SRecord*, uint, uint, FILE*) void epr_dump_record(EPR_SRecord*) void epr_dump_element(EPR_SRecord*, uint, uint) EPR_SField* epr_get_field(EPR_SRecord*, char*) EPR_SField* epr_get_field_at(EPR_SRecord*, uint) # FIELD void epr_print_field(EPR_SField*, FILE*) void epr_dump_field(EPR_SField*) const char* epr_get_field_unit(EPR_SField*) const char* epr_get_field_description(EPR_SField*) uint epr_get_field_num_elems(EPR_SField*) const char* epr_get_field_name(EPR_SField*) EPR_EDataTypeId epr_get_field_type(EPR_SField*) char epr_get_field_elem_as_char(EPR_SField*, uint) uchar epr_get_field_elem_as_uchar(EPR_SField*, uint) short epr_get_field_elem_as_short(EPR_SField*, uint) ushort epr_get_field_elem_as_ushort(EPR_SField*, uint) int epr_get_field_elem_as_int(EPR_SField*, uint) uint epr_get_field_elem_as_uint(EPR_SField*, uint) float epr_get_field_elem_as_float(EPR_SField*, uint) double epr_get_field_elem_as_double(EPR_SField*, uint) const char* epr_get_field_elem_as_str(EPR_SField*) EPR_STime* epr_get_field_elem_as_mjd(EPR_SField*) const char* epr_get_field_elems_char(EPR_SField*) uchar* epr_get_field_elems_uchar(EPR_SField*) short* epr_get_field_elems_short(EPR_SField*) ushort* epr_get_field_elems_ushort(EPR_SField*) int* epr_get_field_elems_int(EPR_SField*) uint* epr_get_field_elems_uint(EPR_SField*) float* epr_get_field_elems_float(EPR_SField*) double* epr_get_field_elems_double(EPR_SField*) uint epr_copy_field_elems_as_ints(EPR_SField*, int*, uint) uint epr_copy_field_elems_as_uints(EPR_SField*, uint*, uint) uint epr_copy_field_elems_as_floats(EPR_SField*, float*, uint) uint epr_copy_field_elems_as_doubles(EPR_SField*, double*, uint) # BAND const char* epr_get_band_name(EPR_SBandId*) EPR_SRaster* epr_create_compatible_raster(EPR_SBandId*, uint, uint, uint, uint) int epr_read_band_raster(EPR_SBandId*, int, int, EPR_SRaster*) # RASTER void epr_free_raster(EPR_SRaster*) uint epr_get_raster_width(EPR_SRaster*) uint epr_get_raster_height(EPR_SRaster*) uint epr_get_raster_elem_size(EPR_SRaster*) uint epr_get_pixel_as_uint(EPR_SRaster*, int, int) int epr_get_pixel_as_int(EPR_SRaster*, int, int) float epr_get_pixel_as_float(EPR_SRaster*, int, int) double epr_get_pixel_as_double(EPR_SRaster*, int, int) void* epr_get_raster_elem_addr(EPR_SRaster*, uint) void* epr_get_raster_pixel_addr(EPR_SRaster*, uint, uint) void* epr_get_raster_line_addr(EPR_SRaster*, uint) EPR_SRaster* epr_create_raster(EPR_EDataTypeId, uint, uint, uint, uint) EPR_SRaster* epr_create_bitmask_raster(uint, uint, uint, uint) # @IMPORTANT: # # the following structures are not part of the public API. # It is not ensured that relative header files are available at build time # (e.g. debian does not install them), so structures are relìplicated here. # It is fundamental to ensure that structures defined here are kept totally # in sync with the one defined in EPR C API. # epr_field.h ctypedef struct EPR_FieldInfo: char* name EPR_EDataTypeId data_type_id uint num_elems char* unit char* description uint tot_size # epr_record.h ctypedef struct EPR_RecordInfo: char* dataset_name EPR_SPtrArray* field_infos uint tot_size pyepr-1.3.1/src/epr/_epr.pyi000066400000000000000000000140001525260221700156750ustar00rootroot00000000000000import os import typing import numpy as np EPR_C_API_VERSION: str E_SMID_LIN: int E_SMID_LOG: int E_SMID_NON: int E_SMOD_1OF1: int E_SMOD_1OF2: int E_SMOD_2OF2: int E_SMOD_2TOF: int E_SMOD_3TOI: int E_TID_CHAR: int E_TID_DOUBLE: int E_TID_FLOAT: int E_TID_INT: int E_TID_SHORT: int E_TID_SPARE: int E_TID_STRING: int E_TID_TIME: int E_TID_UCHAR: int E_TID_UINT: int E_TID_UNKNOWN: int E_TID_USHORT: int class EPRTime(typing.NamedTuple): days: int seconds: int microseconds: int MJD: np.dtype _EPR_MAGIC_FIELD: int _EPR_MAGIC_RASTER: int _EPR_MAGIC_RECORD: int _EPR_MAGIC_BAND_ID: int _EPR_MAGIC_PRODUCT_ID: int class EPRError(Exception): def __init__( self, message: str = ..., code: int = ..., *args, **kargs ) -> None: ... class EPRValueError(EPRError, ValueError): ... class EprObject: ... def get_numpy_dtype(type_id: int) -> type | np.dtype | None: ... def get_data_type_size(type_id: int) -> int: ... def data_type_id_to_str(type_id: int) -> str: ... def get_scaling_method_name(method: int) -> str: ... def get_sample_model_name(model: int) -> str: ... class DSD(EprObject): def __eq__(self, other: object) -> bool: ... def __ge__(self, other: object) -> bool: ... def __gt__(self, other: object) -> bool: ... def __le__(self, other: object) -> bool: ... def __lt__(self, other: object) -> bool: ... def __ne__(self, other: object) -> bool: ... class Field(EprObject): tot_size: int def get_description(self) -> str: ... def get_elem(self, index: int = ...): ... def get_elems(self) -> np.ndarray: ... def get_name(self) -> str: ... def get_num_elems(self) -> int: ... def get_offset(self) -> int: ... def get_type(self) -> int: ... def get_unit(self) -> str: ... def print(self, ostream=...) -> None: ... def set_elem(self, elem, index=...) -> None: ... def set_elems(self, elems) -> None: ... def __eq__(self, other: object) -> bool: ... def __ge__(self, other: object) -> bool: ... def __gt__(self, other: object) -> bool: ... def __le__(self, other: object) -> bool: ... def __len__(self) -> int: ... def __lt__(self, other: object) -> bool: ... def __ne__(self, other: object) -> bool: ... class Record(EprObject): dataset_name: str tot_size: int index: int def fields(self) -> list[Field]: ... def get_field(self, name: str) -> Field: ... def get_field_at(self, index: str) -> Field: ... def get_field_names(self) -> list[str]: ... def get_num_fields(self) -> int: ... def get_offset(self) -> int | None: ... def print(self, ostream=...) -> None: ... def print_element( self, field_index: int, element_index: int, ostream=... ) -> None: ... def __iter__(self) -> typing.Generator[Field]: ... class Raster(EprObject): data_type: int source_width: int source_height: int source_step_x: int source_step_y: int data: np.ndarray def get_elem_size(self) -> int: ... def get_height(self) -> int: ... def get_pixel(self, x: int, y: int): ... def get_width(self) -> int: ... def toarray(self) -> np.ndarray: ... def create_raster( data_type: int, src_width: int, src_height: int, xstep: int = ..., ystep: int = ..., ) -> Raster: ... def create_bitmask_raster( src_width: int, src_height: int, xstep: int = ..., ystep: int = ... ) -> Raster: ... class Band(EprObject): product: Product spectr_band_index: int sample_model: int data_type: int scaling_method: int scaling_offset: float scaling_factor: float bm_expr: str | None unit: str | None description: str lines_mirrored: bool dataset: Dataset def create_compatible_raster( self, src_width: int = ..., src_height: int = ..., xstep: int = ..., ystep: int = ..., ) -> Raster: ... def get_name(self) -> str: ... def read_as_array( self, width: int = ..., height: int = ..., xoffset: int = ..., yoffset: int = ..., xstep: int = ..., ystep: int = ..., ) -> np.ndarray: ... def read_raster( self, xoffset: int = ..., yoffset: int = ..., raster: Raster | None = ..., ) -> Raster: ... class Dataset(EprObject): product: Product description: str def create_record(self) -> Record: ... def get_dsd(self) -> DSD: ... def get_dsd_name(self) -> str: ... def get_name(self) -> str: ... def get_num_records(self) -> int: ... def read_record( self, index: int, record: Record | None = ... ) -> Record: ... def records(self) -> list[Record]: ... def __iter__(self) -> typing.Generator[Record]: ... class Product(EprObject): file_path: str mode: str tot_size: int id_string: str meris_iodd_version: int closed: bool def __init__( self, filename: str | os.PathLike[str], mode: str = ... ) -> None: ... def bands(self) -> list[Band]: ... def close(self) -> None: ... def datasets(self) -> list[Dataset]: ... def flush(self) -> None: ... def get_band(self, name: str) -> Band: ... def get_band_at(self, index: int) -> Band: ... def get_band_names(self) -> list[str]: ... def get_dataset(self, name: str) -> Dataset: ... def get_dataset_at(self, index) -> Dataset: ... def get_dataset_names(self) -> list[str]: ... def get_dsd_at(self, index: int) -> DSD: ... def get_mph(self) -> Record: ... def get_num_bands(self) -> int: ... def get_num_datasets(self) -> int: ... def get_num_dsds(self) -> int: ... def get_scene_height(self) -> int: ... def get_scene_width(self) -> int: ... def get_sph(self) -> Record: ... def read_bitmask_raster( self, bm_expr: str, xoffset: int, yoffset: int, raster: Raster ) -> Raster: ... def get_complex_band_as_array( self, i_band_name: str, q_band_name: str, *, strict: bool = ... ) -> np.ndarray: ... def open( # noqa: A001 filename: str | os.PathLike[str], mode: str = ... ) -> Product: ... pyepr-1.3.1/src/epr/_epr.pyx000066400000000000000000002475441525260221700157410ustar00rootroot00000000000000# cython: langyage_level=3str # PyEPR - Python bindings for ENVISAT Product Reader API # # Copyright (C) 2011-2026, Antonio Valentino # # This file is part of PyEPR. # # PyEPR is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PyEPR is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PyEPR. If not, see . """Python bindings for ENVISAT Product Reader C API.""" from posix.stdio cimport fileno cimport numpy as np from libc cimport errno, stdio from libc cimport string as cstring from libc.stdio cimport FILE from cpython.object cimport PyObject_AsFileDescriptor from cpython.weakref cimport PyWeakref_NewRef from ._epr cimport * np.import_array() import os import sys import atexit from collections import namedtuple import numpy as np cdef bint SWAP_BYTES = (sys.byteorder == "little") # internal utils _DEFAULT_FS_ENCODING = sys.getfilesystemencoding() cdef inline bytes _to_bytes(str s, encoding="UTF-8"): return s.encode(encoding) cdef inline str _to_str(bytes b, encoding="UTF-8"): return b.decode(encoding) # utils EPRTime = namedtuple("EPRTime", ("days", "seconds", "microseconds")) MJD = np.dtype( [ ("days", f"i{sizeof(int)}"), ("seconds", f"u{sizeof(uint)}"), ("microseconds", f"u{sizeof(uint)}"), ] ) EPR_C_API_VERSION = _to_str(EPR_PRODUCT_API_VERSION_STR, "ascii") # EPR_DataTypeId E_TID_UNKNOWN = e_tid_unknown E_TID_UCHAR = e_tid_uchar E_TID_CHAR = e_tid_char E_TID_USHORT = e_tid_ushort E_TID_SHORT = e_tid_short E_TID_UINT = e_tid_uint E_TID_INT = e_tid_int E_TID_FLOAT = e_tid_float E_TID_DOUBLE = e_tid_double E_TID_STRING = e_tid_string E_TID_SPARE = e_tid_spare E_TID_TIME = e_tid_time # EPR_SampleModel E_SMOD_1OF1 = e_smod_1OF1 E_SMOD_1OF2 = e_smod_1OF2 E_SMOD_2OF2 = e_smod_2OF2 E_SMOD_3TOI = e_smod_3TOI E_SMOD_2TOF = e_smod_2TOF # EPR_ScalingMethod E_SMID_NON = e_smid_non E_SMID_LIN = e_smid_lin E_SMID_LOG = e_smid_log # EPR magic IDs _EPR_MAGIC_PRODUCT_ID = EPR_MAGIC_PRODUCT_ID _EPR_MAGIC_DATASET_ID = EPR_MAGIC_DATASET_ID _EPR_MAGIC_BAND_ID = EPR_MAGIC_BAND_ID _EPR_MAGIC_RECORD = EPR_MAGIC_RECORD _EPR_MAGIC_FIELD = EPR_MAGIC_FIELD _EPR_MAGIC_RASTER = EPR_MAGIC_RASTER _EPR_MAGIC_FLAG_DEF = EPR_MAGIC_FLAG_DEF cdef np.NPY_TYPES _epr_to_numpy_type_id(EPR_DataTypeId epr_type): if epr_type == e_tid_uchar: return np.NPY_UBYTE if epr_type == e_tid_char: return np.NPY_BYTE if epr_type == e_tid_ushort: return np.NPY_USHORT if epr_type == e_tid_short: return np.NPY_SHORT if epr_type == e_tid_uint: return np.NPY_UINT if epr_type == e_tid_int: return np.NPY_INT if epr_type == e_tid_float: return np.NPY_FLOAT if epr_type == e_tid_double: return np.NPY_DOUBLE if epr_type == e_tid_string: return np.NPY_STRING return np.NPY_NOTYPE _DTYPE_MAP = { E_TID_UCHAR: np.uint8, E_TID_CHAR: np.int8, E_TID_USHORT: np.uint16, E_TID_SHORT: np.int16, E_TID_UINT: np.uint32, E_TID_INT: np.int32, E_TID_FLOAT: np.float32, E_TID_DOUBLE: np.float64, E_TID_STRING: np.bytes_, E_TID_TIME: MJD, E_TID_SPARE: None, E_TID_UNKNOWN: None, } _METHOD_MAP = { E_SMID_NON: "NONE", E_SMID_LIN: "LIN", E_SMID_LOG: "LOG", } _MODEL_MAP = { E_SMOD_1OF1: "1OF1", E_SMOD_1OF2: "1OF2", E_SMOD_2OF2: "2OF2", E_SMOD_3TOI: "3TOI", E_SMOD_2TOF: "2TOF", } ctypedef fused T: np.uint8_t np.int8_t np.uint16_t np.int16_t np.uint32_t np.int32_t np.float32_t np.float64_t np.npy_byte cdef const void* _view_to_ptr(T[:] a): return &a[0] cdef const void* _to_ptr(np.ndarray a, EPR_DataTypeId etype): cdef const void *p = NULL if etype == e_tid_uchar: p = _view_to_ptr[np.uint8_t](a) elif etype == e_tid_char: p = _view_to_ptr[np.int8_t](a) elif etype == e_tid_ushort: p = _view_to_ptr[np.uint16_t](a) elif etype == e_tid_short: p = _view_to_ptr[np.int16_t](a) elif etype == e_tid_uint: p = _view_to_ptr[np.uint32_t](a) elif etype == e_tid_int: p = _view_to_ptr[np.int32_t](a) elif etype == e_tid_float: p = _view_to_ptr[np.float32_t](a) elif etype == e_tid_double: p = _view_to_ptr[np.float64_t](a) elif etype == e_tid_string: p = _view_to_ptr[np.npy_byte](a) else: raise ValueError("unexpected type ID: {etype}") return p class EPRError(Exception): """EPR API error.""" def __init__(self, message="", code=None, *args, **kargs): """__init__(self, message="", code=None, *args, **kargs)""" super(EPRError, self).__init__(message, code, *args, **kargs) #: EPR API error code self.code = code class EPRValueError(EPRError, ValueError): pass cdef pyepr_check_errors(): cdef int code cdef str msg code = epr_get_last_err_code() if code != e_err_none: msg = _to_str(epr_get_last_err_message(), "ascii") epr_clear_err() # @TODO: if not msg: msg = EPR_ERR_MSG[code] if (e_err_invalid_product_id <= code <= e_err_invalid_keyword_name or code in (e_err_null_pointer, e_err_illegal_arg, e_err_index_out_of_range)): raise EPRValueError(msg, code) else: raise EPRError(msg, code) cdef pyepr_null_ptr_error(str msg="null pointer"): cdef int code cdef str eprmsg = _to_str(epr_get_last_err_message(), "ascii") code = epr_get_last_err_code() epr_clear_err() raise EPRValueError(f"{msg}: {eprmsg}", code=code if code else None) # https://stackoverflow.com/questions/1603916/close-a-file-pointer-without-closing-the-underlying-file-descriptor cdef FILE* pyepr_get_file_stream(object ostream) except NULL: # The returned stream can be safely closed cdef FILE* fstream = NULL cdef int fileno_ = -1 if ostream is None: ostream = sys.stdout try: ostream.flush() except AttributeError as exc: raise TypeError(str(exc)) else: fileno_ = PyObject_AsFileDescriptor(ostream) if fileno_ == -1: raise TypeError("bad output stream") else: fileno_ = os.dup(fileno_) if fileno_ == -1: raise TypeError("bad output stream") else: fstream = stdio.fdopen(fileno_, "a+") if fstream is NULL: errno.errno = 0 raise TypeError("invalid ostream") return fstream cdef class _CLib: """Library object to handle C API initialization/finalization. .. warning:: this is meant for internal use only. **Do not use it**. """ def __cinit__(self, *args, **kwargs): cdef bytes msg # @TODO: check # if EPR_C_API_VERSION != "2.2": # raise ImportError( # f"C library version not supported: {EPR_C_API_VERSION!r}") # if epr_init_api(e_log_warning, epr_log_message, NULL): if epr_init_api(e_log_warning, NULL, NULL): msg = epr_get_last_err_message() epr_clear_err() raise ImportError( f"unable to initialize EPR API library: " f"{_to_str(msg, 'ascii')}" ) def __dealloc__(self): epr_close_api() def __init__(self): raise TypeError( f"{self.__class__.__name__!r} class cannot be instantiated from " f"Python" ) # global _CLib instance cdef _CLib _EPR_C_LIB = None cdef class EprObject: cdef object epr_c_lib def __cinit__(self, *args, **kargs): self.epr_c_lib = _EPR_C_LIB def __dealloc__(self): self.epr_c_lib = None def __init__(self): raise TypeError( f"{self.__class__.__name__!r} class cannot be instantiated from " f"Python" ) cpdef get_numpy_dtype(EPR_EDataTypeId type_id): """get_numpy_dtype(epr_type) Return the numpy datatype specified EPR type ID. """ try: return _DTYPE_MAP[type_id] except KeyError: raise ValueError(f"invalid EPR type ID: {type_id}") cpdef uint get_data_type_size(EPR_EDataTypeId type_id): """get_data_type_size(type_id) Gets the size in bytes for an element of the given data type. """ return epr_get_data_type_size(type_id) cpdef str data_type_id_to_str(EPR_EDataTypeId type_id): """data_type_id_to_str(type_id) Gets the "C" data type string for the given data type. """ cdef char* type_id_str = epr_data_type_id_to_str(type_id) return _to_str(type_id_str, "ascii") cpdef str get_scaling_method_name(EPR_ScalingMethod method): """get_scaling_method_name(method) Return the name of the specified scaling method. """ try: return _METHOD_MAP[method] except KeyError: raise ValueError(f"invalid scaling method: {method!r}") cpdef str get_sample_model_name(EPR_SampleModel model): """get_sample_model_name(model) Return the name of the specified sample model. """ try: return _MODEL_MAP[model] except KeyError: raise ValueError(f"invalid sample model: {model!r}") cdef class DSD(EprObject): """Dataset descriptor. The DSD class contains information about the properties of a dataset and its location within an ENVISAT product file. """ cdef EPR_SDSD* _ptr cdef object _parent # Dataset or Product cdef inline check_closed_product(self): if isinstance(self, Dataset): (self._parent).check_closed_product() else: # elif isinstance(self, Product): (self._parent).check_closed_product() @property def index(self): """The index of this DSD (zero-based).""" self.check_closed_product() return self._ptr.index @property def ds_name(self): """The dataset name.""" self.check_closed_product() return _to_str(self._ptr.ds_name, "ascii") @property def ds_type(self): """The dataset type descriptor.""" self.check_closed_product() return _to_str(self._ptr.ds_type, "ascii") @property def filename(self): """The filename in the DDDB with the description of this dataset.""" self.check_closed_product() return _to_str(self._ptr.filename, "ascii") @property def ds_offset(self): """The offset of dataset-information the product file.""" self.check_closed_product() return self._ptr.ds_offset @property def ds_size(self): """The size of dataset-information in dataset product file.""" self.check_closed_product() return self._ptr.ds_size @property def num_dsr(self): """The number of dataset records for the given dataset name.""" self.check_closed_product() return self._ptr.num_dsr @property def dsr_size(self): """The size of dataset record for the given dataset name.""" self.check_closed_product() return self._ptr.dsr_size # --- high level interface ------------------------------------------------ def __repr__(self): return f"epr.DSD({self.ds_name!r})" def __eq__(self, other): cdef EPR_SDSD* p1 = NULL cdef EPR_SDSD* p2 = NULL if isinstance(other, self.__class__): p1 = (self)._ptr p2 = (other)._ptr if p1 == p2: return True (self).check_closed_product() return ((p1.index == p2.index) and (p1.ds_offset == p2.ds_offset) and (p1.ds_size == p2.ds_size) and (p1.num_dsr == p2.num_dsr) and (p1.dsr_size == p2.dsr_size)and (cstring.strcmp(p1.ds_name, p2.ds_name) == 0) and (cstring.strcmp(p1.ds_type, p2.ds_type) == 0) and (cstring.strcmp(p1.filename, p2.filename) == 0)) return NotImplemented # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic cdef new_dsd(EPR_SDSD* ptr, EprObject parent=None): if ptr is NULL: pyepr_null_ptr_error() cdef DSD instance = DSD.__new__(DSD) instance._ptr = ptr instance._parent = parent # Dataset or Product return instance cdef class Field(EprObject): """Represents a field within a record. A field is composed of one or more data elements of one of the types defined in the internal ``field_info`` structure. .. seealso:: :class:`Record` """ cdef EPR_SField* _ptr cdef Record _parent cdef inline check_closed_product(self): self._parent.check_closed_product() cdef inline _check_write_mode(self): self._parent._check_write_mode() cdef long _get_offset(self, bint absolute=0) except -1: cdef bint found = 0 cdef int i = 0 cdef int num_fields_in_record = 0 cdef long offset = 0 cdef const char* name = NULL cdef const EPR_Field* field = NULL cdef const EPR_FieldInfo* info = NULL cdef const EPR_Record* record = NULL info = self._ptr.info name = info.name record = self._parent._ptr num_fields_in_record = epr_get_num_fields(record) for i in range(num_fields_in_record): field = epr_get_field_at(record, i) info = field.info if info.name == name: found = 1 break offset += info.tot_size if not found: raise EPRError("unable to compute field offset") elif absolute: offset += self._parent._get_offset(absolute) return offset def print(self, ostream=None): """print(self, ostream=None) Write the field to specified file (default: :data:`sys.stdout`). This method writes formatted contents of the field to specified *ostream* text file or (default) the ASCII output is be printed to standard output (:data:`sys.stdout`). :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances """ cdef FILE* fstream = NULL self.check_closed_product() fstream = pyepr_get_file_stream(ostream) with nogil: epr_print_field(self._ptr, fstream) stdio.fflush(fstream) stdio.fclose(fstream) pyepr_check_errors() # def dump_field(self): # epr_dump_field(self._ptr) # pyepr_check_errors() def get_unit(self): """get_unit(self) Gets the unit of the field. """ cdef const char* unit = NULL self.check_closed_product() unit = epr_get_field_unit(self._ptr) if unit is NULL: return "" else: return _to_str(unit, "ascii") def get_description(self): """get_description(self) Gets the description of the field. """ cdef char* description = NULL self.check_closed_product() description = epr_get_field_description(self._ptr) return _to_str(description, "ascii") def get_num_elems(self): """get_num_elems(self) Gets the number of elements of the field. """ self.check_closed_product() return epr_get_field_num_elems(self._ptr) def get_name(self): """get_name(self) Gets the name of the field. """ cdef char* name = NULL self.check_closed_product() name = epr_get_field_name(self._ptr) return _to_str(name, "ascii") def get_type(self): """get_type(self) Gets the type of the field. """ self.check_closed_product() return epr_get_field_type(self._ptr) def get_elem(self, uint index=0): """get_elem(self, index=0) Field single element access. This function is for getting the elements of a field. :param int index: the zero-based index of element to be returned, must not be negative :returns: the typed value from given field """ cdef EPR_STime* eprtime self.check_closed_product() etype = epr_get_field_type(self._ptr) if etype == e_tid_uchar: val = epr_get_field_elem_as_uchar(self._ptr, index) elif etype == e_tid_char: val = epr_get_field_elem_as_char(self._ptr, index) elif etype == e_tid_ushort: val = epr_get_field_elem_as_ushort(self._ptr, index) elif etype == e_tid_short: val = epr_get_field_elem_as_short(self._ptr, index) elif etype == e_tid_uint: val = epr_get_field_elem_as_uint(self._ptr, index) elif etype == e_tid_int: val = epr_get_field_elem_as_int(self._ptr, index) elif etype == e_tid_float: val = epr_get_field_elem_as_float(self._ptr, index) elif etype == e_tid_double: val = epr_get_field_elem_as_double(self._ptr, index) elif etype == e_tid_string: if index != 0: raise ValueError(f"invalid index: {index}") val = epr_get_field_elem_as_str(self._ptr) # elif etype == e_tid_spare: # val = epr_get_field_elem_as_str(self._ptr) elif etype == e_tid_time: if index != 0: raise ValueError(f"invalid index: {index}") # use casting to silence warnings eprtime = epr_get_field_elem_as_mjd(self._ptr) val = EPRTime(eprtime.days, eprtime.seconds, eprtime.microseconds) else: raise ValueError("invalid field type") pyepr_check_errors() return val def get_elems(self): """get_elems(self) Field array element access. This function is for getting an array of field elements of the field. :returns: the data array (:class:`numpy.ndarray`) having the type of the field """ cdef void* buf = NULL cdef int ndim = 1 cdef np.npy_intp[1] shape cdef np.ndarray out cdef EPR_Time* t = NULL cdef np.NPY_TYPES dtype self.check_closed_product() shape[0] = epr_get_field_num_elems(self._ptr) etype = epr_get_field_type(self._ptr) msg = f"Filed({self.get_name()!r}) elems pointer is null" if etype == e_tid_time: if shape[0] != 1: raise ValueError( f"unexpected number of elements: {shape[0]}" ) t = epr_get_field_elem_as_mjd(self._ptr) if t is NULL: pyepr_null_ptr_error(msg) out = np.ndarray(1, MJD) out[0]["days"] = t.days out[0]["seconds"] = t.seconds out[0]["microseconds"] = t.microseconds return out if etype == e_tid_uchar: dtype = np.NPY_UBYTE buf = epr_get_field_elems_uchar(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_char: dtype = np.NPY_BYTE buf = epr_get_field_elems_char(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_ushort: dtype = np.NPY_USHORT buf = epr_get_field_elems_ushort(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_short: dtype = np.NPY_SHORT buf = epr_get_field_elems_short(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_uint: dtype = np.NPY_UINT buf = epr_get_field_elems_uint(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_int: dtype = np.NPY_INT buf = epr_get_field_elems_int(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_float: dtype = np.NPY_FLOAT buf = epr_get_field_elems_float(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_double: dtype = np.NPY_DOUBLE buf = epr_get_field_elems_double(self._ptr) if buf is NULL: pyepr_null_ptr_error(msg) elif etype == e_tid_string: if shape[0] != 1: raise ValueError( f"unexpected number of elements: {shape[0]} " "for e_tid_string" ) elem = self.get_elem() return np.asarray(elem) # ndim = 0 # dtype = np.NPY_STRING # buf = epr_get_field_elem_as_str(self._ptr) # if buf is NULL: # pyepr_null_ptr_error(msg) # elif etype == e_tid_unknown: # pass # elif etype = e_tid_spare: # pass else: raise ValueError(f"invalid field type: {etype}") out = np.PyArray_SimpleNewFromData(ndim, shape, dtype, buf) # np.PyArray_CLEARFLAG(out, NPY_ARRAY_WRITEABLE) # new in numpy 1.7 # Make the ndarray keep a reference to this object np.set_array_base(out, self) return out cdef _set_elems(self, np.ndarray elems, uint index=0): cdef Record record cdef Dataset dataset cdef Product product cdef FILE* istream cdef size_t ret cdef size_t nelems cdef size_t elemsize cdef size_t datasize cdef long file_offset cdef long field_offset cdef char* buf cdef EPR_DataTypeId etype = epr_get_field_type(self._ptr) cdef const void* p = NULL dtype = _DTYPE_MAP[etype] elems = np.ascontiguousarray(elems, dtype=dtype) record = self._parent dataset = record._parent product = dataset._parent istream = product._ptr.istream nelems = elems.size elemsize = epr_get_data_type_size(etype) datasize = elemsize * nelems field_offset = index * elemsize file_offset = self._get_offset(absolute=1) buf = self._ptr.elems + field_offset p = _to_ptr(elems, etype) with nogil: cstring.memcpy(buf, p, datasize) if SWAP_BYTES: elems = elems.byteswap() p = _to_ptr(elems, etype) with nogil: stdio.fseek(istream, file_offset + field_offset, stdio.SEEK_SET) ret = stdio.fwrite(p, elemsize, nelems, product._ptr.istream) if ret != nelems: raise IOError(f"write error: {ret} of {datasize} bytes written") def set_elem(self, elem, uint index=0): """set_elem(self, elem, index=0) Set Field array element. This function is for setting an array of field element of the field. :param elem: value of the element to set :param int index: the zero-based index of element to be set, must not be negative. Default: 0. """ self.check_closed_product() self._check_write_mode() if self._parent.index is None: raise NotImplementedError( "setting elements is not implemented on MPH/SPH records" ) elem = np.asarray(elem) if elem.size != 1: raise ValueError( f"invalid shape {elem.shape!r}, scalar value expected" ) self._set_elems(elem, index) def set_elems(self, elems): """set_elems(self, elems) Set Field array elements. This function is for setting an array of field elements of the field. :param elems: np.ndarray of elements to set """ cdef uint nelems self.check_closed_product() self._check_write_mode() if self._parent._index is None: raise NotImplementedError( "setting elements is not implemented on MPH/SPH records" ) elems = np.ascontiguousarray(elems) nelems = epr_get_field_num_elems(self._ptr) if elems.ndim > 1 or elems.size != nelems: raise ValueError( f"invalid shape {elems.shape!r}, '({nelems},)' value expected" ) self._set_elems(elems) @property def tot_size(self): """The total size in bytes of all data elements of a field. *tot_size* is a derived variable, it is computed at runtime and not stored in the DSD-DB. """ cdef EPR_FieldInfo* info = self._ptr.info return info.tot_size # --- high level interface ------------------------------------------------ def __repr__(self): return ( f"epr.Field({self.get_name()!r}) {self.get_num_elems()} " f"{data_type_id_to_str(self.get_type())} elements" ) def __str__(self): cdef object name = self.get_name() cdef EPR_DataTypeId type_ = self.get_type() cdef int num_elems = 0 if type_ == e_tid_string: return f"{name} = {self.get_elem().decode('UTF-8')!r}" elif type_ == e_tid_time: days, seconds, microseconds = self.get_elem() return f"{name} = {{d={days}, j={seconds}, m={microseconds}}}" else: num_elems = epr_get_field_num_elems(self._ptr) if type_ == e_tid_uchar: fmt = "%u" elif type_ == e_tid_char: fmt = "%d" elif type_ == e_tid_ushort: fmt = "%u" elif type_ == e_tid_short: fmt = "%d" elif type_ == e_tid_uint: fmt = "%u" elif type_ == e_tid_int: fmt = "%d" elif type_ == e_tid_float: fmt = "%f" elif type_ == e_tid_double: fmt = "%f" else: if num_elems > 1: data = ["<>"] * num_elems data = ", ".join(data) return f"{name} = {{{data}}}" else: return f"{name} = <>" if num_elems > 1: data = ", ".join([fmt % item for item in self.get_elems()]) return f"{name} = {{{data}}}" else: return f"{name} = {fmt % self.get_elem()}" def __eq__(self, other): cdef size_t n = 0 cdef EPR_SField* p1 = NULL cdef EPR_SField* p2 = NULL if isinstance(other, self.__class__): p1 = (self)._ptr p2 = (other)._ptr if p1 == p2: return True (self).check_closed_product() if ((epr_get_field_num_elems(p1) != epr_get_field_num_elems(p2)) or (epr_get_field_type(p1) != epr_get_field_type(p2)) or (cstring.strcmp(epr_get_field_unit(p1), epr_get_field_unit(p2)) != 0) or (cstring.strcmp(epr_get_field_description(p1), epr_get_field_description(p2)) != 0) or (cstring.strcmp(epr_get_field_name(p1), epr_get_field_name(p2)) != 0)): return False n = epr_get_data_type_size(epr_get_field_type(p1)) if n != 0: n *= epr_get_field_num_elems(p1) # pyepr_check_errors() if n <= 0: # @TODO: check return True return (cstring.memcmp(p1.elems, p2.elems, n) == 0) return NotImplemented def __len__(self): self.check_closed_product() if epr_get_field_type(self._ptr) == e_tid_string: return cstring.strlen(epr_get_field_elem_as_str(self._ptr)) else: return epr_get_field_num_elems(self._ptr) # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic def get_offset(self): """Field offset in bytes within the Record.""" self.check_closed_product() return self._get_offset() cdef new_field(EPR_SField* ptr, Record parent=None): if ptr is NULL: pyepr_null_ptr_error() cdef Field instance = Field.__new__(Field) instance._ptr = ptr instance._parent = parent return instance cdef class Record(EprObject): """Represents a record read from an ENVISAT dataset. A record is composed of multiple fields. .. seealso:: :class:`Field` """ cdef EPR_SRecord* _ptr cdef object _parent # Dataset or Product cdef bint _dealloc cdef int _index def __dealloc__(self): if not self._dealloc: return if self._ptr is not NULL: epr_free_record(self._ptr) pyepr_check_errors() cdef inline check_closed_product(self): if isinstance(self._parent, Dataset): (self._parent).check_closed_product() else: # elif isinstance(self._parent, Product): (self._parent).check_closed_product() cdef inline _check_write_mode(self): if isinstance(self._parent, Dataset): (self._parent)._check_write_mode() else: # elif isinstance(self._parent, Product): (self._parent)._check_write_mode() cdef inline uint _get_offset(self, bint absolute=0): cdef EPR_RecordInfo* info = self._ptr.info cdef uint offset = self._index * info.tot_size # assert self._index is not None if absolute: offset += (self._parent)._get_offset() return offset def get_num_fields(self): """get_num_fields(self) Gets the number of fields contained in the record. """ return epr_get_num_fields(self._ptr) def print(self, ostream=None): """print(self, ostream=None) Write the record to specified file. This method writes formatted contents of the record to specified *ostream* text file or (default) the ASCII output is be printed to standard output (:data:`sys.stdout`). :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances """ cdef FILE* fstream = NULL self.check_closed_product() fstream = pyepr_get_file_stream(ostream) with nogil: epr_print_record(self._ptr, fstream) stdio.fflush(fstream) stdio.fclose(fstream) pyepr_check_errors() def print_element(self, uint field_index, uint element_index, ostream=None): """print_element(self, field_index, element_index, ostream=None) Write the specified field element to file. This method writes formatted contents of the specified field element to the *ostream* text file or (default) the ASCII output will be printed to standard output (:data:`sys.stdout`). :param int field_index: the index of field in the record :param int element_index: the index of element in the specified field :param ostream: the (opened) output file object .. note:: the *ostream* parameter have to be a *real* file not a generic stream object like :class:`StringIO.StringIO` instances. """ cdef FILE* fstream = NULL self.check_closed_product() fstream = pyepr_get_file_stream(ostream) with nogil: epr_print_element(self._ptr, field_index, element_index, fstream) stdio.fflush(fstream) stdio.fclose(fstream) pyepr_check_errors() def get_field(self, str name): """get_field(self, name) Gets a field specified by name. The field is here identified through the given name. It contains the field info and all corresponding values. :param str name: the the name of required field :returns: the specified :class:`Field` or raises an exception (:exc:`EPRValueError`) if an error occurred """ cdef EPR_SField* field_ptr cdef bytes cname = _to_bytes(name) self.check_closed_product() field_ptr = epr_get_field(self._ptr, cname) if field_ptr is NULL: pyepr_null_ptr_error(f"unable to get field {name!r}") return new_field(field_ptr, self) def get_field_at(self, uint index): """get_field_at(self, index) Gets a field at the specified position within the record. :param int index: the zero-based index (position within record) of the field :returns: the field or raises and exception (:exc:`EPRValueError`) if an error occurred """ cdef EPR_SField* field_ptr self.check_closed_product() field_ptr = epr_get_field_at(self._ptr, index) if field_ptr is NULL: pyepr_null_ptr_error(f"unable to get field at index {index}") return new_field(field_ptr, self) @property def dataset_name(self): """The name of the dataset to which this record belongs to.""" self.check_closed_product() cdef EPR_RecordInfo* info = self._ptr.info if info.dataset_name == NULL: return "" else: return _to_str(info.dataset_name) @property def tot_size(self): """The total size in bytes of the record. It includes all data elements of all fields of a record in a product file. *tot_size* is a derived variable, it is computed at runtime and not stored in the DSD-DB. """ self.check_closed_product() cdef EPR_RecordInfo* info = self._ptr.info return info.tot_size @property def index(self): """Index of the record within the dataset. It is *None* for empty records (created with :meth:`Dataset.create_record` but still not read) and for *MPH* (see :meth:`epr.Product.get_mph`) and *SPH* (see :meth:`epr.Product.get_sph`) records. .. seealso:: :meth:`epr.Dataset.read_record` """ return self._index if self._index >= 0 else None # --- high level interface ------------------------------------------------ def get_field_names(self): """get_field_names(self) Return the list of names of the fields in the product. .. note:: this method has no correspondent in the C API. """ cdef EPR_SField* field_ptr cdef int idx cdef char* name cdef int num_fields self.check_closed_product() num_fields = epr_get_num_fields(self._ptr) names = [] for idx in range(num_fields): field_ptr = epr_get_field_at(self._ptr, idx) name = epr_get_field_name(field_ptr) names.append(_to_str(name, "ascii")) return names def fields(self): """fields(self) Return the list of fields contained in the record. """ return list(self) def __iter__(self): self.check_closed_product() cdef int num_fields = epr_get_num_fields(self._ptr) cdef int idx for idx in range(num_fields): yield self.get_field_at(idx) def __str__(self): self.check_closed_product() return "\n".join(map(str, self)) def __repr__(self): self.check_closed_product() return ( f"{super(Record, self).__repr__()} {self.get_num_fields()} fields" ) # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic def get_offset(self): """Record offset in bytes within the Dataset.""" if self._index >= 0: self.check_closed_product() return self._get_offset() else: return None cdef new_record(EPR_SRecord* ptr, EprObject parent=None, bint dealloc=False): if ptr is NULL: pyepr_null_ptr_error() cdef Record instance = Record.__new__(Record) instance._ptr = ptr instance._parent = parent # Dataset or Product instance._dealloc = dealloc instance._index = -1 return instance cdef class Raster(EprObject): """Represents a raster in which data will be stored. All "size" parameter are in PIXEL. """ cdef EPR_SRaster* _ptr cdef Band _parent cdef object _data def __dealloc__(self): if self._ptr is not NULL: epr_free_raster(self._ptr) @property def data_type(self): """The data type of the band's pixels. All ``E_TID_*`` types are possible. """ return self._ptr.data_type @property def source_width(self): """The width of the source.""" return self._ptr.source_width @property def source_height(self): """The height of the source.""" return self._ptr.source_height @property def source_step_x(self): """The sub-sampling for the across-track direction in pixel.""" return self._ptr.source_step_x @property def source_step_y(self): """The sub-sampling for the along-track direction in pixel.""" return self._ptr.source_step_y def get_width(self): """get_width(self) Gets the raster's width in pixels. """ return epr_get_raster_width(self._ptr) def get_height(self): """get_height(self) Gets the raster's height in pixels. """ return epr_get_raster_height(self._ptr) def get_elem_size(self): """get_elem_size(self) The size in byte of a single element (sample) of this raster's buffer. """ return epr_get_raster_elem_size(self._ptr) def get_pixel(self, int x, int y): """get_pixel(x, y) Single pixel access. This function is for getting the values of the elements of a raster (i.e. pixel). :param int x: the (zero-based) X coordinate of the pixel :param int y: the (zero-based) Y coordinate of the pixel :returns: the typed value at the given coordinate """ if (x < 0 or x >= self._ptr.raster_width or y < 0 or y >= self._ptr.raster_height): raise ValueError(f"index out of range: x={x}, y={y}") cdef EPR_EDataTypeId dtype = self._ptr.data_type if dtype == e_tid_uint: val = epr_get_pixel_as_uint(self._ptr, x, y) elif dtype == e_tid_int: val = epr_get_pixel_as_int(self._ptr, x, y) elif dtype == e_tid_float: val = epr_get_pixel_as_float(self._ptr, x, y) elif dtype == e_tid_double: val = epr_get_pixel_as_double(self._ptr, x, y) else: raise ValueError( f"invalid data type: {epr_data_type_id_to_str(dtype)!r}" ) pyepr_check_errors() return val # --- high level interface ------------------------------------------------ cdef np.ndarray toarray(self): cdef np.NPY_TYPES dtype = _epr_to_numpy_type_id(self._ptr.data_type) cdef np.npy_intp[2] shape cdef np.ndarray result if dtype == np.NPY_NOTYPE: raise TypeError("invalid data type") else: shape[0] = self._ptr.raster_height shape[1] = self._ptr.raster_width result = np.PyArray_SimpleNewFromData(2, shape, dtype, self._ptr.buffer) # Make the ndarray keep a reference to this object np.set_array_base(result, self) return result @property def data(self): """Raster data exposed as :class:`numpy.ndarray` object. .. note:: this property shares the data buffer with the :class:`Raster` object so any change in its contents is also reflected to the :class:`Raster` object. """ cdef object data if self._data is not None: data = self._data() if data is not None: return data if self._ptr.buffer is NULL: return np.ndarray(()) data = self.toarray() self._data = PyWeakref_NewRef(data, None) return data def __repr__(self): return ( f"{super(Raster, self).__repr__()} " f"{data_type_id_to_str(self.data_type)} " f"({self.get_height()}L x {self.get_width()}P)" ) # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" return self._ptr.magic cdef new_raster(EPR_SRaster* ptr, Band parent=None): if ptr is NULL: pyepr_null_ptr_error() cdef Raster instance = Raster.__new__(Raster) instance._ptr = ptr instance._parent = parent # Band or None instance._data = None return instance def create_raster(EPR_EDataTypeId data_type, uint src_width, uint src_height, uint xstep=1, uint ystep=1): """create_raster(data_type, src_width, src_height, xstep=1, ystep=1) Creates a raster of the specified data type. This function can be used to create any type of raster, e.g. for later use as a bit-mask. :param data_type: the type of the data to stored in the raster, must be one of E_TID_* :param int src_width: the width (across track dimension) of the source to be read into the raster. See description of :meth:`Band.create_compatible_raster` :param int src_height: the height (along track dimension) of the source to be read into the raster. See description of :meth:`Band.create_compatible_raster` :param int xstep: the sub-sampling step across track of the source when reading into the raster :param int ystep: the sub-sampling step along track of the source when reading into the raster :returns: the new :class:`Raster` instance .. seealso:: description of :meth:`Band.create_compatible_raster` """ if xstep == 0 or ystep == 0: raise ValueError(f"invalid step: xspet={xstep}, ystep={ystep}") cdef EPR_SRaster* raster_ptr raster_ptr = epr_create_raster(data_type, src_width, src_height, xstep, ystep) if raster_ptr is NULL: pyepr_null_ptr_error("unable to create a new raster") return new_raster(raster_ptr) def create_bitmask_raster(uint src_width, uint src_height, uint xstep=1, uint ystep=1): """create_bitmask_raster(src_width, src_height, xstep=1, ystep=1) Creates a raster to be used for reading bitmasks. The raster returned always is of type ``byte``. :param int src_width: the width (across track dimension) of the source to be read into the raster :param int src_height: the height (along track dimension) of the source to be read into the raster :param int xstep: the sub-sampling step across track of the source when reading into the raster :param int ystep: the sub-sampling step along track of the source when reading into the raster :returns: the new raster instance or raises an exception (:exc:`EPRValueError`) if an error occurred .. seealso:: the description of :meth:`Band.create_compatible_raster` """ if xstep == 0 or ystep == 0: raise ValueError(f"invalid step: xspet={xstep}, ystep={ystep}") cdef EPR_SRaster* raster_ptr raster_ptr = epr_create_bitmask_raster(src_width, src_height, xstep, ystep) if raster_ptr is NULL: pyepr_null_ptr_error("unable to create a new raster") return new_raster(raster_ptr) cdef class Band(EprObject): """The band of an ENVISAT product. The Band class contains information about a band within an ENVISAT product file which has been opened with the :func:`open` function. A new Band instance can be obtained with the :meth:`Product.get_band` method. """ cdef EPR_SBandId* _ptr cdef Product _parent cdef inline int check_closed_product(self) except -1: if self._ptr is NULL: raise ValueError("I/O operation on closed file") elif self._parent.check_closed_product() == -1: self._ptr = NULL raise return 0 @property def product(self): """The :class:`Product` instance to which this band belongs to.""" return self._parent @property def spectr_band_index(self): """The (zero-based) spectral band index. -1 if this is not a spectral band. """ self.check_closed_product() return self._ptr.spectr_band_index @property def sample_model(self): """The sample model operation. The sample model operation applied to the source dataset for getting the correct samples from the MDS (for example MERIS L2). Possible values are: * ``*`` --> no operation (direct copy) * ``1OF2`` --> first byte of 2-byte interleaved MDS * ``2OF2`` --> second byte of 2-byte interleaved MDS * ``0123`` --> combine 3-bytes interleaved to 4-byte integer """ self.check_closed_product() return self._ptr.sample_model @property def data_type(self): """The data type of the band's pixels. Possible values are: * ``*`` --> the datatype remains unchanged. * ``uint8_t`` --> 8-bit unsigned integer * ``uint32_t`` --> 32-bit unsigned integer * ``Float`` --> 32-bit IEEE floating point """ self.check_closed_product() return self._ptr.data_type @property def scaling_method(self): """Scaling method. The scaling method which must be applied to the raw source data in order to get the "real" pixel values in geo-physical units. Possible values are: * ``*`` --> no scaling applied * ``Linear_Scale`` --> linear scaling applied:: y = offset + scale * x * ``Log_Scale`` --> logarithmic scaling applied:: y = log10(offset + scale * x) """ self.check_closed_product() return self._ptr.scaling_method @property def scaling_offset(self): """The scaling offset. Possible values are: * ``*`` --> no offset provided (implies scaling_method=*) * ``const`` --> a floating point constant * ``GADS.field[.field2]` --> value is provided in global annotation dataset with name ``GADS`` in field ``field``. Optionally a second element index for multiple-element fields can be given too """ self.check_closed_product() return self._ptr.scaling_offset @property def scaling_factor(self): """The scaling factor. Possible values are: * ``*`` --> no factor provided (implies scaling_method=*) * ``const`` --> a floating point constant * ``GADS.field[.field2]`` --> value is provided in global annotation dataset with name `GADS` in field `field``. Optionally a second element index for multiple-element fields can be given too """ self.check_closed_product() return self._ptr.scaling_factor @property def bm_expr(self): """A bit-mask expression used to filter valid pixels. All others are set to zero. """ self.check_closed_product() if self._ptr.bm_expr is NULL: return None else: return _to_str(self._ptr.bm_expr, "ascii") @property def unit(self): """The geophysical unit for the band's pixel values.""" self.check_closed_product() if self._ptr.unit is NULL: return None else: return _to_str(self._ptr.unit, "ascii") @property def description(self): """A short description of the band's contents.""" self.check_closed_product() if self._ptr.description is NULL: return None else: return _to_str(self._ptr.description, "ascii") @property def lines_mirrored(self): """Mirrored lines flag. If true (=1) lines will be mirrored (flipped) after read into a raster in order to ensure a pixel ordering in raster X direction from WEST to EAST. """ self.check_closed_product() return self._ptr.lines_mirrored @property def dataset(self): """The source dataset. The source dataset containing the raw data used to create the band's pixel values. """ self.check_closed_product() cdef EPR_SDatasetId* dataset_id = self._ptr.dataset_ref.dataset_id cdef const char* cname = epr_get_dataset_name(dataset_id) cdef str name = _to_str(cname) return self.product.get_dataset(name) def get_name(self): """get_name(self) Gets the name of the band. """ cdef char* name = NULL self.check_closed_product() name = epr_get_band_name(self._ptr) return _to_str(name, "ascii") def create_compatible_raster(self, uint src_width=0, uint src_height=0, uint xstep=1, uint ystep=1): """create_compatible_raster(self, src_width, src_height, xstep=1, ystep=1) Creates a raster which is compatible with the data type of the band. The created raster is used to read the data in it (see :meth:`Band.read_raster`). The raster is defined on the grid of the product, from which the data are read. Spatial subsets and under-sampling are possible) through the parameter of the method. A raster is an object that allows direct access to data of a certain portion of the ENVISAT product that are read into the it. Such a portion is called the source. The complete ENVISAT product can be much greater than the source. One can move the raster over the complete ENVISAT product and read in turn different parts (always of the size of the source) of it into the raster. The source is specified by the parameters *height* and *width*. A typical example is a processing in blocks. Lets say, a block has 64x32 pixel. Then, my source has a width of 64 pixel and a height of 32 pixel. Another example is a processing of complete image lines. Then, my source has a widths of the complete product (for example 1121 for a MERIS RR product), and a height of 1). One can loop over all blocks read into the raster and process it. In addition, it is possible to defined a sub-sampling step for a raster. This means, that the source is not read 1:1 into the raster, but that only every 2nd or 3rd pixel is read. This step can be set differently for the across track (source_step_x) and along track (source_step_y) directions. :param int src_width: the width (across track dimension) of the source to be read into the raster (default: scene_width) :param int src_height: the height (along track dimension) of the source to be read into the raster (default: scene_height) :param int xstep: the sub-sampling step across track of the source when reading into the raster (default=1) :param int ystep: the sub-sampling step along track of the source when reading into the raster (default=1) :returns: the new raster instance or raises an exception (:exc:`EPRValueError`) if an error occurred .. note:: src_width and src_height are the dimantion of the of the source area. If one specifies a *step* parameter the resulting raster will have a size that is smaller that the specifies source size:: raster_size = src_size // step """ cdef EPR_SRaster* raster_ptr = NULL cdef uint scene_width cdef uint scene_height self.check_closed_product() scene_width = epr_get_scene_width(self._parent._ptr) scene_height = epr_get_scene_height(self._parent._ptr) if src_width == 0: src_width = scene_width elif src_width > scene_width: raise ValueError( f"requested raster width ({src_width}) is too large for the " f"Band (scene_width={scene_width})" ) if src_height == 0: src_height = scene_height elif src_height > scene_height: raise ValueError( f"requested raster height ({src_height}) is too large for the " f"Band (scene_height={scene_height})" ) if xstep > src_width: raise ValueError( f"xstep ({xstep}) too large for the requested width " f"({src_width})" ) if ystep > src_height: raise ValueError( f"ystep ({ystep}) too large for the requested height " f"({src_height})" ) raster_ptr = epr_create_compatible_raster(self._ptr, src_width, src_height, xstep, ystep) if raster_ptr is NULL: pyepr_null_ptr_error( f"unable to create compatible raster " f"with width={src_width}, height={src_height}, " f"xstep={xstep}, ystep={ystep}" ) return new_raster(raster_ptr, self) cpdef read_raster(self, int xoffset=0, int yoffset=0, Raster raster=None): """read_raster(self, xoffset=0, yoffset=0, Raster raster=None) Reads (geo-)physical values of the band of the specified source-region. The source-region is a defined part of the whole ENVISAT product image, which shall be read into a raster. In this routine the coordinates are specified, where the source-region to be read starts. The dimension of the region and the sub-sampling are attributes of the raster into which the data are read. :param int xoffset: across-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int yoffset: along-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param epr.Raster raster: :class:`Raster` instance set with appropriate parameters to read into. If not provided a new :class:`Raster` is instantiated :returns: the :class:`Raster` instance in which data are read This method raises an instance of the appropriate :exc:`EPRError` sub-class if case of errors .. seealso:: :meth:`Band.create_compatible_raster` and :func:`create_raster` """ cdef int ret cdef uint scene_width cdef uint scene_height self.check_closed_product() if raster is None: raster = self.create_compatible_raster() scene_width = epr_get_scene_width(self._parent._ptr) scene_height = epr_get_scene_height(self._parent._ptr) if (xoffset + raster._ptr.source_width > scene_width or yoffset + raster._ptr.source_height > scene_height): raise ValueError( "at lease part of the requested area is outside the scene" ) raster._data = None with nogil: ret = epr_read_band_raster(self._ptr, xoffset, yoffset, raster._ptr) if ret != 0: pyepr_check_errors() return raster # --- high level interface ------------------------------------------------ def read_as_array( self, width=None, height=None, uint xoffset=0, uint yoffset=0, uint xstep=1, uint ystep=1, ): """read_as_array(width=None, height=None, xoffset=0, yoffset=0, xstep=1, ystep=1): Reads the specified source region as an :class:`numpy.ndarray`. The source-region is a defined part of the whole ENVISAT product image, which shall be read into a raster. In this routine the coordinates are specified, where the source-region to be read starts. The dimension of the region and the sub-sampling are attributes of the raster into which the data are read. :param int src_width: the width (across track dimension) of the source to be read into the raster. If not provided reads as much as possible :param int src_height: the height (along track dimension) of the source to be read into the raster. If not provided reads as much as possible :param int xoffset: across-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int yoffset: along-track source coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int xstep: the sub-sampling step across track of the source when reading into the raster :param int ystep: the sub-sampling step along track of the source when reading into the raster :returns: the :class:`numpy.ndarray` instance in which data are read This method raises an instance of the appropriate :exc:`EPRError` sub-class if case of errors .. seealso:: :meth:`Band.create_compatible_raster`, :func:`create_raster` and :meth:`Band.read_raster` """ cdef uint w cdef uint h cdef EPR_ProductId* product_id self.check_closed_product() product_id = self._parent._ptr if width is None: w = epr_get_scene_width(product_id) if w > xoffset: width = w - xoffset else: raise ValueError("xoffset os larger that the scene width") if height is None: h = epr_get_scene_height(product_id) if h > yoffset: height = h - yoffset else: raise ValueError("yoffset os larger that the scene height") raster = self.create_compatible_raster(width, height, xstep, ystep) self.read_raster(xoffset, yoffset, raster) return raster.data def __repr__(self): return ( f"epr.Band({self.get_name()!r}) of " f"epr.Product({self.product.id_string!r})" ) # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic @property def _field_index(self): """Index or the field (within the dataset) containing the raw data used to create the band's pixel values. It is set to -1 if not used. """ self.check_closed_product() return self._ptr.dataset_ref.field_index @property def _elem_index(self): """Index or the element (within the dataset field) containing the raw data used to create the band's pixel values. It is set to -1 if not used. """ self.check_closed_product() return self._ptr.dataset_ref.elem_index cdef new_band(EPR_SBandId* ptr, Product parent=None): if ptr is NULL: pyepr_null_ptr_error() cdef Band instance = Band.__new__(Band) instance._ptr = ptr instance._parent = parent return instance cdef class Dataset(EprObject): """ENVISAT dataset. The Dataset class contains information about a dataset within an ENVISAT product file which has been opened with the :func:`open` function. A new Dataset instance can be obtained with the :meth:`Product.get_dataset` or :meth:`Product.get_dataset_at` methods. """ cdef EPR_SDatasetId* _ptr cdef Product _parent cdef inline check_closed_product(self): self._parent.check_closed_product() cdef inline _check_write_mode(self): self._parent._check_write_mode() cdef inline uint _get_offset(self): cdef const EPR_SDSD* dsd = epr_get_dsd(self._ptr) return dsd.ds_offset @property def product(self): """The :class:`Product` instance to which this dataset belongs to.""" return self._parent @property def description(self): """A short description of the band's contents.""" if self._ptr is not NULL: self.check_closed_product() if self._ptr.description is not NULL: return _to_str(self._ptr.description, "ascii") return "" def get_name(self): """get_name(self) Gets the name of the dataset. """ cdef char* name if self._ptr is not NULL: self.check_closed_product() name = epr_get_dataset_name(self._ptr) return _to_str(name, "ascii") return "" def get_dsd_name(self): """get_dsd_name(self) Gets the name of the DSD (dataset descriptor). """ cdef char* name if self._ptr is not NULL: self.check_closed_product() name = epr_get_dsd_name(self._ptr) return _to_str(name, "ascii") return "" def get_num_records(self): """get_num_records(self) Gets the number of records of the dataset. """ if self._ptr is not NULL: self.check_closed_product() return epr_get_num_records(self._ptr) return 0 def get_dsd(self): """get_dsd(self) Gets the dataset descriptor (DSD). """ self.check_closed_product() return new_dsd(epr_get_dsd(self._ptr), self) def create_record(self): """create_record(self) Creates a new record. Creates a new, empty record with a structure compatible with the dataset. Such a record is typically used in subsequent calls to :meth:`Dataset.read_record`. :returns: the new record instance """ self.check_closed_product() return new_record(epr_create_record(self._ptr), self, True) def read_record(self, uint index=0, Record record=None): """read_record(self, index, record=None) Reads specified record of the dataset. The record is identified through the given zero-based record index. In order to reduce memory reallocation, a record (pre-)created by the method :meth:`Dataset.create_record` can be passed to this method. Data is then read into this given record. If no record (``None``) is given, the method initiates a new one. In both cases, the record in which the data is read into will be returned. :param int index: the zero-based record index (default: 0) :param epr.Record record: a pre-created record to reduce memory reallocation, can be ``None`` (default) to let the function allocate a new record :returns: the record in which the data has been read into or raises an exception (:exc:`EPRValueError`) if an error occurred .. versionchanged:: 0.9 The *index* parameter now defaults to zero """ cdef EPR_SRecord* record_ptr = NULL self.check_closed_product() if record: record_ptr = (record)._ptr with nogil: record_ptr = epr_read_record(self._ptr, index, record_ptr) if record_ptr is NULL: pyepr_null_ptr_error(f"unable to read record at index {index}") if not record: record = new_record(record_ptr, self, True) record._index = index return record # --- high level interface ------------------------------------------------ def records(self): """records(self) Return the list of records contained in the dataset. """ return list(self) def __iter__(self): self.check_closed_product() cdef uint idx for idx in range(epr_get_num_records(self._ptr)): yield self.read_record(idx) def __str__(self): lines = [repr(self), ""] lines.extend(map(str, self)) return "\n".join(lines) def __repr__(self): return ( f"epr.Dataset({self.get_name()!r}) {self.get_num_records()} " f"records" ) # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic cdef new_dataset(EPR_SDatasetId* ptr, Product parent=None): if ptr is NULL: pyepr_null_ptr_error() cdef Dataset instance = Dataset.__new__(Dataset) instance._ptr = ptr instance._parent = parent return instance cdef class Product(EprObject): """ENVISAT product. The Product class provides methods and properties to get information about an ENVISAT product file. .. seealso:: :func:`open` """ cdef EPR_SProductId* _ptr cdef str _mode def __cinit__(self, filename, str mode="rb"): pfilename = os.fspath(filename) cdef bytes bfilename cdef char* cfilename if hasattr(pfilename, "encode"): bfilename = _to_bytes(pfilename, _DEFAULT_FS_ENCODING) cfilename = bfilename else: cfilename = pfilename cdef bytes bmode cdef char* cmode if mode not in ("rb", "rb+", "r+b"): raise ValueError(f"invalid open mode: {mode!r}") self._mode = mode with nogil: self._ptr = epr_open_product(cfilename) if self._ptr is NULL: # try to get error info from the lib pyepr_check_errors() raise ValueError(f"unable to open '{filename}'") if "+" in mode: # reopen in "rb+" mode bmode = _to_bytes(mode) cmode = bmode with nogil: self._ptr.istream = stdio.freopen(cfilename, cmode, self._ptr.istream) if self._ptr.istream is NULL: errno.errno = 0 raise ValueError( f"unable to open file '{filename}' in {mode!r} mode" ) def __dealloc__(self): if self._ptr is not NULL: if "+" in self._mode: stdio.fflush(self._ptr.istream) epr_close_product(self._ptr) pyepr_check_errors() self._ptr = NULL cdef inline int check_closed_product(self) except -1: if self._ptr is NULL: raise ValueError("I/O operation on closed file") return 0 cdef inline _check_write_mode(self): if "+" not in self._mode: raise TypeError("write operation on read-only file") def __init__(self, filename, mode="rb"): # @NOTE: this method suppresses the default behavior of EprObject # that is raising an exception when it is instantiated by # the user. pass def close(self): """close(self) Closes the ENVISAT :class:`epr.Product` product. Closes the :class:`epr.Product` product and free the underlying file descriptor. This method has no effect if the :class:`Product` is already closed. Once the :class:`Product` is closed, any operation on it will raise a ValueError. As a convenience, it is allowed to call this method more than once; only the first call, however, will have an effect. """ if self._ptr is not NULL: # if "+" in self.mode: # stdio.fflush(self._ptr.istream) epr_close_product(self._ptr) pyepr_check_errors() self._ptr = NULL def flush(self): """Flush the file stream.""" cdef int ret if "+" in self.mode: ret = stdio.fflush(self._ptr.istream) if ret != 0: errno.errno = 0 raise IOError("flush error") @property def file_path(self): """The file's path including the file name.""" self.check_closed_product() if self._ptr.file_path is NULL: return None else: return _to_str(self._ptr.file_path, "ascii") @property def _fileno(self): """The fileno of the :class:`epr.Product` input stream. To be used with care. .. important:: on MacOS-X the position of the file descriptor shall be reset to the original one after its use. """ if self._ptr.istream is NULL: return None else: return fileno(self._ptr.istream) @property def mode(self): """String that specifies the mode in which the file is opened. Possible values: "rb" for read-only mode, "rb+" for read-write mode. """ return self._mode @property def tot_size(self): """The total size in bytes of the product file.""" self.check_closed_product() return self._ptr.tot_size @property def id_string(self): """The product identifier string obtained from the MPH parameter "PRODUCT". The first 10 characters of this string identify the product type, e.g. "MER_1P__FR" for a MERIS Level 1b full resolution product. The rest of the string decodes product instance properties. """ self.check_closed_product() return _to_str(self._ptr.id_string, "ascii") @property def meris_iodd_version(self): """For MERIS L1b and RR and FR to provide backward compatibility.""" self.check_closed_product() return self._ptr.meris_iodd_version def get_scene_width(self): """get_scene_width(self) Gets the product's scene width in pixels. """ self.check_closed_product() return epr_get_scene_width(self._ptr) def get_scene_height(self): """get_scene_height(self) Gets the product's scene height in pixels. """ self.check_closed_product() return epr_get_scene_height(self._ptr) def get_num_datasets(self): """get_num_datasets(self) Gets the number of all datasets contained in a product. """ self.check_closed_product() return epr_get_num_datasets(self._ptr) def get_num_dsds(self): """get_num_dsds(self) Gets the number of all :class:`DSD`\ s. Gets the number of all :class:`DSD`\ s (dataset descriptors) contained in the product. """ self.check_closed_product() return epr_get_num_dsds(self._ptr) def get_num_bands(self): """get_num_bands(self) Gets the number of all bands contained in a product. """ self.check_closed_product() return epr_get_num_bands(self._ptr) def get_dataset_at(self, uint index): """get_dataset_at(self, index) Gets the dataset at the specified position within the product. :param int index: the index identifying the position of the dataset, starting with 0, must not be negative :returns: the requested :class:`Dataset` """ cdef EPR_SDatasetId* dataset_id dataset_id = epr_get_dataset_id_at(self._ptr, index) if dataset_id is NULL: pyepr_null_ptr_error(f"unable to get dataset at index {index}") return new_dataset(dataset_id, self) def get_dataset(self, str name): """get_dataset(self, name) Gets the dataset corresponding to the specified dataset name. :param str name: the dataset name :returns: the requested :class:`Dataset` instance """ cdef EPR_SDatasetId* dataset_id cdef bytes cname = _to_bytes(name) dataset_id = epr_get_dataset_id(self._ptr, cname) if dataset_id is NULL: pyepr_null_ptr_error(f"unable to get dataset {name!r}") return new_dataset(dataset_id, self) def get_dsd_at(self, uint index): """get_dsd_at(self, index) Gets the :class:`DSD` at the specified position. Gets the :class:`DSD` (dataset descriptor) at the specified position within the product. :param int index: the index identifying the position of the :class:`DSD`, starting with 0, must not be negative :returns: the requested :class:`DSD` instance """ cdef EPR_SDSD* dsd_ptr self.check_closed_product() dsd_ptr = epr_get_dsd_at(self._ptr, index) if dsd_ptr is NULL: pyepr_null_ptr_error(f"unable to get DSD at index {index}") return new_dsd(dsd_ptr, self) def get_mph(self): """get_mph(self) The main product header (MPH) :class:`Record`. """ cdef EPR_SRecord* record_ptr record_ptr = epr_get_mph(self._ptr) if record_ptr is NULL: pyepr_null_ptr_error("unable to get MPH record") return new_record(record_ptr, self, False) def get_sph(self): """get_sph(self) The specific product header (SPH) :class:`Record`. """ cdef EPR_SRecord* record_ptr record_ptr = epr_get_sph(self._ptr) if record_ptr is NULL: pyepr_null_ptr_error("unable to get SPH record") return new_record(record_ptr, self, False) def get_band(self, str name): """get_band(self, name) Gets the band corresponding to the specified name. :param str name: the name of the band :returns: the requested :class:`Band` instance, or raises a :exc:`EPRValueError` if not found """ cdef EPR_SBandId* band_id cdef bytes cname = _to_bytes(name) band_id = epr_get_band_id(self._ptr, cname) if band_id is NULL: pyepr_null_ptr_error(f"unable to get band {name!r}") return new_band(band_id, self) def get_band_at(self, uint index): """get_band_at(self, index) Gets the band at the specified position within the product. :param int index: the index identifying the position of the band, starting with 0, must not be negative :returns: the requested :class:`Band` instance, or raises a :exc:`EPRValueError` if not found """ cdef EPR_SBandId* band_id band_id = epr_get_band_id_at(self._ptr, index) if band_id is NULL: pyepr_null_ptr_error(f"unable to get band at index {index}") return new_band(band_id, self) def read_bitmask_raster(self, str bm_expr, int xoffset, int yoffset, Raster raster not None): """read_bitmask_raster(self, bm_expr, xoffset, yoffset, raster) Calculates a bit-mask raster. Calculates a bit-mask, composed of flags of the given product and combined as described in the given bit-mask expression, for the a certain dimension and sub-sampling as defined in the given raster. :param str bm_expr: a string holding the logical expression for the definition of the bit-mask. In a bit-mask expression, any number of the flag-names (found in the DDDB) can be composed with "(", ")", "NOT", "AND", "OR". Valid bit-mask expression are for example ``flags.LAND OR flags.CLOUD`` or ``NOT flags.WATER AND flags.TURBID_S`` :param int xoffset: across-track coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param int yoffset: along-track coordinate in pixel coordinates (zero-based) of the upper right corner of the source-region :param epr.Raster raster: the raster for the bit-mask. The data type of the raster must be either e_tid_uchar or e_tid_char :returns: zero for success, an error code otherwise .. seealso:: :func:`epr.create_bitmask_raster` """ cdef bytes c_bm_expr = _to_bytes(bm_expr) cdef int ret = 0 self.check_closed_product() ret = epr_read_bitmask_raster(self._ptr, c_bm_expr, xoffset, yoffset, (raster)._ptr) if ret != 0: pyepr_check_errors() return raster # --- high level interface ------------------------------------------------ @property def closed(self): """True if the :class:`epr.Product` is closed.""" return self._ptr is NULL def get_dataset_names(self): """get_dataset_names(self) Return the list of names of the datasets in the product. .. note:: this method has no correspondent in the C API """ cdef EPR_SDatasetId* dataset_ptr cdef int idx cdef char* name cdef int num_datasets self.check_closed_product() num_datasets = epr_get_num_datasets(self._ptr) names = [] for idx in range(num_datasets): dataset_ptr = epr_get_dataset_id_at(self._ptr, idx) name = epr_get_dataset_name(dataset_ptr) names.append(_to_str(name, "ascii")) return names def get_band_names(self): """get_band_names(self) Return the list of names of the bands in the product. .. note:: this method has no correspondent in the C API """ cdef EPR_SBandId* band_ptr cdef int idx cdef char* name cdef int num_bands self.check_closed_product() num_bands = epr_get_num_bands(self._ptr) names = [] for idx in range(num_bands): band_ptr = epr_get_band_id_at(self._ptr, idx) name = epr_get_band_name(band_ptr) names.append(_to_str(name, "ascii")) return names def datasets(self): """datasets(self) Return the list of dataset in the product. """ self.check_closed_product() cdef int num_datasets = epr_get_num_datasets(self._ptr) return [self.get_dataset_at(idx) for idx in range(num_datasets)] def bands(self): """bands(self) Return the list of bands in the product. """ cdef int num_bands self.check_closed_product() num_bands = epr_get_num_bands(self._ptr) return [self.get_band_at(idx) for idx in range(num_bands)] def get_complex_band_as_array( self, str iname, str qname, *, bint strict=True ): """get_complex_band_as_array(self, iname, qname, *, strict=True) Return a complex array that is the combination of two bands. Return a complex array reading the real part from the band named "iname" and the imaginary part from the band named "qname". :param str iname: name of the band containing the real part of the complex array :param str qname: name of the band containing the imaginary part of the complex array :param bool strict: raise a `ValueError` if the and names provided in input (`iname` and `qname`) do not belong to the same dataset, or if `imane` / `qname` does not correspond to the real/imaginary components (respectively) of the dataset """ re = self.get_band(iname) im = self.get_band(qname) if strict: if re.dataset.get_name() != im.dataset.get_name(): raise ValueError( "the input bands does not belong to the same dataset" ) if not iname.startswith("i"): raise ValueError( f"'iname' ('{iname}') does not correspond to the " "real component of a complex band" ) if not qname.startswith("q"): raise ValueError( f"'qname' ('{qname}') does not correspond to the " "imaginary component of a complex band" ) return re.read_as_array() + 1j * im.read_as_array() # @TODO: iter on both datasets and bands (??) # def __iter__(self): # return itertools.chain((self.datasets(), self.bands())) def __repr__(self): return ( f"epr.Product({self.id_string!r}) {self.get_num_datasets()} " f"datasets, {self.get_num_bands()} bands" ) def __str__(self): lines = [repr(self), ""] lines.extend(map(repr, self.datasets())) lines.append("") lines.extend(map(repr, self.bands())) return "\n".join(lines) def __enter__(self): return self def __exit__(self, *exc_info): self.close() # --- low level interface ------------------------------------------------- @property def _magic(self): """The magic number for internal C structure.""" self.check_closed_product() return self._ptr.magic def open(filename, str mode="rb"): """open(filename) Open the ENVISAT product. Opens the ENVISAT product file with the given file path, reads MPH, SPH and all DSDs, organized the table with parameter of line length and tie points number. :param PathLike product_file_path: the path to the ENVISAT product file :param str mode: string that specifies the mode in which the file is opened. Allowed values: "rb", "rb+" for read-write mode. Default: mode="rb". :returns: the :class:`Product` instance representing the specified product. An exception (:exc:`exceptions.ValueError`) is raised if the file could not be opened. .. seealso :class:`Product` """ return Product(filename, mode) # library initialization/finalization _EPR_C_LIB = _CLib.__new__(_CLib) @atexit.register def _close_api(): # ensure that all EprObject(s) are collected before removing the last # reference to _EPR_C_LIB import gc gc.collect() global _EPR_C_LIB _EPR_C_LIB = None # clean namespace del atexit, namedtuple pyepr-1.3.1/src/epr/py.typed000066400000000000000000000000001525260221700157170ustar00rootroot00000000000000pyepr-1.3.1/tests/000077500000000000000000000000001525260221700140175ustar00rootroot00000000000000pyepr-1.3.1/tests/__init__.py000066400000000000000000000000001525260221700161160ustar00rootroot00000000000000pyepr-1.3.1/tests/data/000077500000000000000000000000001525260221700147305ustar00rootroot00000000000000pyepr-1.3.1/tests/data/registry.txt000066400000000000000000000002001525260221700173310ustar00rootroot00000000000000ASA_APM_1PNDSI20091007_025628_000000432083_00118_39751_0000.N1 425132d361595a53a2adff849e3e02429df1be9d4883015f104ce2387f4eb332 pyepr-1.3.1/tests/test_all.py000066400000000000000000003062171525260221700162110ustar00rootroot00000000000000# Copyright (C) 2011-2026, Antonio Valentino # # This file is part of PyEPR. # # PyEPR is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PyEPR is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PyEPR. If not, see . import os import re import sys import shutil import typing import numbers import pathlib import operator import platform import tempfile import unittest import functools import sysconfig try: import resource except ImportError: have_resource = False else: have_resource = True import numpy as np import pooch from numpy import testing as npt from packaging.version import parse as Version # noqa: N812 import epr from epr._epr import ( # noqa: PLC2701 _EPR_MAGIC_FIELD, _EPR_MAGIC_RASTER, _EPR_MAGIC_RECORD, _EPR_MAGIC_BAND_ID, _EPR_MAGIC_PRODUCT_ID, ) FREE_THREAD = sysconfig.get_config_var("Py_GIL_DISABLED") EPR_TO_NUMPY_TYPE = { # epr.E_TID_UNKNOWN: np.NPY_NOTYPE, epr.E_TID_UCHAR: np.ubyte, epr.E_TID_CHAR: np.byte, epr.E_TID_USHORT: np.ushort, epr.E_TID_SHORT: np.short, epr.E_TID_UINT: np.uint, epr.E_TID_INT: int, epr.E_TID_FLOAT: np.float32, epr.E_TID_DOUBLE: np.double, epr.E_TID_STRING: str, # epr.E_TID_SPARE = e_tid_spare, # epr.E_TID_TIME = e_tid_time, } def has_epr_c_bug_pyepr009() -> bool: if "_pyepr" in epr.EPR_C_API_VERSION: v_str = epr.EPR_C_API_VERSION epr_version, _, pyepr_version = v_str.partition("_pyepr") v = Version(epr_version), Version(pyepr_version) v_ref = Version("2.3dev"), Version("082") return v < v_ref return Version(epr.EPR_C_API_VERSION) <= Version("2.3") EPR_C_BUG_PYEPR009 = has_epr_c_bug_pyepr009() EPR_C_BUG_BCEPR002 = EPR_C_BUG_PYEPR009 TESTDIR = pathlib.Path(__file__).parent TESTDATADIR = TESTDIR / "data" TEST_PRODUCT = "ASA_APM_1PNDSI20091007_025628_000000432083_00118_39751_0000.N1" TEST_PRODUCT_BM_EXPR = None PRODUCT_FILE = TESTDATADIR / TEST_PRODUCT def _create_pooch() -> pooch.Pooch: pooch_obj = pooch.create( path=TESTDATADIR, base_url="https://github.com/avalentino/pyepr-test-data/raw/v1.0.0/", ) registry_file = TESTDATADIR / "registry.txt" pooch_obj.load_registry(registry_file) return pooch_obj DATA_MANAGER = _create_pooch() def quiet(func): @functools.wraps(func) def wrapper(*args, **kwds): sysout = sys.stdout syserr = sys.stderr try: # using '/dev/null' doesn't work in python 3 because the file # object cannot be converted into a C FILE* # with file(os.devnull) as fd: with tempfile.TemporaryFile("w+", encoding="utf-8") as fd: sys.stdout = fd sys.stderr = fd ret = func(*args, **kwds) finally: sys.stdout = sysout sys.stderr = syserr return ret return wrapper def equal_products(product1, product2): if type(product1) is not type(product2): return False for name in ("file_path", "tot_size", "id_string", "meris_iodd_version"): if getattr(product1, name) != getattr(product2, name): return False for name in ( "get_scene_width", "get_scene_height", "get_num_datasets", "get_num_dsds", "get_num_bands", ): if getattr(product1, name)() != getattr(product2, name)(): return False return True def setUpModule(): filename_str = DATA_MANAGER.fetch(TEST_PRODUCT) filename = pathlib.Path(filename_str) assert filename.exists() assert filename == PRODUCT_FILE class TestOpenProduct(unittest.TestCase): def test_open(self): with epr.open(PRODUCT_FILE) as product: self.assertTrue(isinstance(product, epr.Product)) self.assertEqual(product.mode, "rb") def test_open_rb(self): with epr.open(PRODUCT_FILE, "rb") as product: self.assertTrue(isinstance(product, epr.Product)) self.assertEqual(product.mode, "rb") def test_open_rwb_01(self): with epr.open(PRODUCT_FILE, "r+b") as product: self.assertTrue(isinstance(product, epr.Product)) self.assertTrue(product.mode in {"r+b", "rb+"}) def test_open_rwb_02(self): with epr.open(PRODUCT_FILE, "rb+") as product: self.assertTrue(isinstance(product, epr.Product)) self.assertTrue(product.mode in {"r+b", "rb+"}) def test_open_invalid_mode_01(self): self.assertRaises(ValueError, epr.open, PRODUCT_FILE, "") def test_open_invalid_mode_02(self): self.assertRaises(ValueError, epr.open, PRODUCT_FILE, "rx") def test_open_invalid_mode_03(self): self.assertRaises(TypeError, epr.open, PRODUCT_FILE, 0) def test_open_bytes(self): filename = str(PRODUCT_FILE).encode("UTF-8") with epr.open(filename) as product: self.assertTrue(isinstance(product, epr.Product)) def test_open_pathlib(self): filename = pathlib.Path(PRODUCT_FILE) with epr.open(filename) as product: self.assertTrue(isinstance(product, epr.Product)) def test_product_constructor(self): with epr.Product(PRODUCT_FILE) as product: self.assertTrue(isinstance(product, epr.Product)) def test_open_failure(self): self.assertRaises(epr.EPRError, epr.open, "") def test_filename_type(self): self.assertRaises(TypeError, epr.open, 3) def test_open_failure_invalid_product(self): self.assertRaises(ValueError, epr.open, __file__) def test_product_constructor_failure(self): self.assertRaises(epr.EPRError, epr.Product, "") def test_product_constructor_failure_invalid_product(self): self.assertRaises(ValueError, epr.Product, __file__) class TestProduct(unittest.TestCase): # noqa: PLR0904 OPEN_MODE = "rb" ID_STRING = TEST_PRODUCT[:48] TOT_SIZE = 22911746 DATASET_NAMES = [ "MDS1_SQ_ADS", "MDS2_SQ_ADS", "MAIN_PROCESSING_PARAMS_ADS", "DOP_CENTROID_COEFFS_ADS", "SR_GR_ADS", "CHIRP_PARAMS_ADS", "GEOLOCATION_GRID_ADS", "MDS1", "MDS2", ] DATASET_NAME = "MDS1" DATASET_WIDTH = 1452 DATASET_HEIGHT = 3915 DATASET_NDSDS = 18 DATASET_NBANDS = 6 BAND_NAME = "proc_data_1" SPH_DESCRIPTOR = "AP Mode Medium Res. Image" MERIS_IODD_VERSION = 0 def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) self.bm_expr = TEST_PRODUCT_BM_EXPR def tearDown(self): self.product.close() def test_close(self): self.product.close() def test_flush(self): self.product.flush() def test_double_close(self): self.product.close() self.product.close() def test_file_path_property(self): self.assertEqual(pathlib.Path(self.product.file_path), PRODUCT_FILE) def test_mode_property(self): self.assertEqual(self.product.mode, self.OPEN_MODE) def test_tot_size_property(self): self.assertEqual(self.product.tot_size, self.TOT_SIZE) def test_id_string_property(self): self.assertEqual(self.product.id_string, self.ID_STRING) def test_meris_iodd_version_property(self): self.assertEqual( self.product.meris_iodd_version, self.MERIS_IODD_VERSION ) def test_get_scene_width(self): self.assertEqual(self.product.get_scene_width(), self.DATASET_WIDTH) def test_get_scene_height(self): self.assertEqual(self.product.get_scene_height(), self.DATASET_HEIGHT) def test_get_num_datasets(self): self.assertEqual( self.product.get_num_datasets(), len(self.DATASET_NAMES) ) def test_get_num_dsds(self): self.assertEqual(self.product.get_num_dsds(), self.DATASET_NDSDS) def test_get_num_bands(self): self.assertEqual(self.product.get_num_bands(), self.DATASET_NBANDS) def test_get_dataset_at(self): dataset = self.product.get_dataset_at(0) self.assertTrue(dataset) def test_get_dataset(self): dataset = self.product.get_dataset(self.DATASET_NAME) self.assertTrue(dataset) def test_datasets(self): datasets = [ self.product.get_dataset_at(idx) for idx in range(self.product.get_num_datasets()) ] dataset_names = [ds.get_name() for ds in datasets] self.assertEqual(dataset_names, self.DATASET_NAMES) def test_get_dsd_at(self): self.assertTrue(isinstance(self.product.get_dsd_at(0), epr.DSD)) def test_get_mph(self): record = self.product.get_mph() self.assertTrue(isinstance(record, epr.Record)) product = record.get_field("PRODUCT").get_elem() self.assertEqual(product.decode("ascii"), PRODUCT_FILE.name) def test_get_sph(self): record = self.product.get_sph() self.assertTrue(isinstance(record, epr.Record)) sph_desct = record.get_field("SPH_DESCRIPTOR").get_elem() self.assertEqual(sph_desct.decode("ascii"), self.SPH_DESCRIPTOR) def test_get_band_id(self): self.assertTrue( isinstance(self.product.get_band(self.BAND_NAME), epr.Band) ) def test_get_band_id_bytes(self): band_name = self.BAND_NAME.encode("UTF-8") self.assertTrue(isinstance(band_name, bytes)) self.assertTrue( isinstance(self.product.get_band(self.BAND_NAME), epr.Band) ) def test_get_band_id_invalid_name(self): self.assertRaises(ValueError, self.product.get_band, "") def test_get_band_id_at(self): self.assertTrue(isinstance(self.product.get_band_at(0), epr.Band)) def test_get_band_id_at_invalid_index(self): self.assertRaises( ValueError, self.product.get_band_at, self.product.get_num_bands() ) @unittest.skipIf(TEST_PRODUCT_BM_EXPR is None, "no flag band available") def test_read_bitmask_raster(self): bm_expr = self.bm_expr xoffset = self.DATASET_WIDTH // 2 yoffset = self.DATASET_HEIGHT // 2 width = self.DATASET_WIDTH // 2 height = self.DATASET_HEIGHT // 2 raster = epr.create_bitmask_raster(width, height) raster = self.product.read_bitmask_raster( bm_expr, xoffset, yoffset, raster ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), width) self.assertEqual(raster.get_height(), height) @unittest.skipIf(TEST_PRODUCT_BM_EXPR is None, "no flag band available") def test_read_bitmask_raster_bytes(self): bm_expr = self.bm_expr.encode("UTF-8") self.assertTrue(isinstance(bm_expr, bytes)) xoffset = self.DATASET_WIDTH // 2 yoffset = self.DATASET_HEIGHT // 2 width = self.DATASET_WIDTH // 2 height = self.DATASET_HEIGHT // 2 raster = epr.create_bitmask_raster(width, height) raster = self.product.read_bitmask_raster( bm_expr, xoffset, yoffset, raster ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), width) self.assertEqual(raster.get_height(), height) def test_read_bitmask_raster_with_invalid_bm_expr(self): bm_expr = "l5_flags.LAND AND !l2_flags.CLOUD" xoffset = self.DATASET_WIDTH // 2 yoffset = self.DATASET_HEIGHT // 2 width = self.DATASET_WIDTH // 2 height = self.DATASET_HEIGHT // 2 raster = epr.create_bitmask_raster(width, height) self.assertRaises( epr.EPRError, self.product.read_bitmask_raster, bm_expr, xoffset, yoffset, raster, ) try: self.product.read_bitmask_raster(bm_expr, xoffset, yoffset, raster) except epr.EPRError as e: self.assertEqual(e.code, 301) def test_read_bitmask_raster_with_wrong_data_type(self): bm_expr = "l2_flags.LAND AND !l2_flags.CLOUD" xoffset = self.DATASET_WIDTH // 2 yoffset = self.DATASET_HEIGHT // 2 width = self.DATASET_WIDTH // 2 height = self.DATASET_HEIGHT // 2 raster = epr.create_raster(epr.E_TID_DOUBLE, width, height) self.assertRaises( epr.EPRError, self.product.read_bitmask_raster, bm_expr, xoffset, yoffset, raster, ) try: self.product.read_bitmask_raster(bm_expr, xoffset, yoffset, raster) except epr.EPRError as e: self.assertEqual(e.code, 7) def test_fileno(self): self.assertTrue(isinstance(self.product._fileno, int)) # noqa: SLF001 def test_fileno_read(self): pos = os.lseek(self.product._fileno, 0, os.SEEK_CUR) # noqa: SLF001 try: os.lseek(self.product._fileno, 0, os.SEEK_SET) # noqa: SLF001 data = os.read(self.product._fileno, 7) # noqa: SLF001 self.assertEqual(data, b"PRODUCT") finally: os.lseek(self.product._fileno, pos, os.SEEK_SET) # noqa: SLF001 class TestProductRW(TestProduct): OPEN_MODE = "rb+" class TestProductHighLevelAPI(unittest.TestCase): DATASET_NAMES = TestProduct.DATASET_NAMES BAND_NAMES = [ "slant_range_time", "incident_angle", "latitude", "longitude", "proc_data_1", "proc_data_2", ] def setUp(self): self.product = epr.Product(PRODUCT_FILE) def tearDown(self): self.product.close() def test_closed(self): self.assertFalse(self.product.closed) self.product.close() self.assertTrue(self.product.closed) def test_readonly_closed(self): self.assertFalse(self.product.closed) self.assertRaises( AttributeError, setattr, self.product, "closed", True, # noqa: FBT003 ) def test_get_dataset_names(self): self.assertEqual(self.product.get_dataset_names(), self.DATASET_NAMES) def test_get_band_names(self): self.assertEqual(self.product.get_band_names(), self.BAND_NAMES) def test_datasets(self): datasets = self.product.datasets() self.assertTrue(datasets) self.assertEqual(len(datasets), self.product.get_num_datasets()) for index, dataset in enumerate(datasets): ref_dataset = self.product.get_dataset_at(index) self.assertEqual(dataset.get_name(), ref_dataset.get_name()) def test_bands(self): bands = self.product.bands() self.assertTrue(bands) self.assertEqual(len(bands), self.product.get_num_bands()) for index, band in enumerate(bands): ref_band = self.product.get_band_at(index) self.assertEqual(band.get_name(), ref_band.get_name()) # @TODO: not implemented # def test_iter(self): # pass def test_repr(self): pattern = ( r"epr\.Product\((?P['\"])(?P\w+)(?P=q)\) " r"(?P\d+) datasets, " r"(?P\d+) bands" ) mobj = re.match(pattern, repr(self.product)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("name"), self.product.id_string) self.assertEqual( mobj.group("n_datasets"), str(self.product.get_num_datasets()) ) self.assertEqual( mobj.group("n_bands"), str(self.product.get_num_bands()) ) def test_repr_type(self): self.assertTrue(isinstance(repr(self.product), str)) def test_str(self): lines = [repr(self.product), ""] lines.extend(map(repr, self.product.datasets())) lines.append("") lines.extend(map(str, self.product.bands())) data = "\n".join(lines) self.assertEqual(data, str(self.product)) def test_str_type(self): self.assertTrue(isinstance(str(self.product), str)) def test_context_manager(self): with epr.open(PRODUCT_FILE) as product: self.assertTrue(isinstance(product, epr.Product)) self.assertFalse(product.closed) self.assertTrue(str(product)) self.assertTrue(product.closed) class TestProductLowLevelAPI(unittest.TestCase): def setUp(self): self.product = epr.Product(PRODUCT_FILE) def tearDown(self): self.product.close() def test_magic(self): self.assertEqual( self.product._magic, # noqa: SLF001 _EPR_MAGIC_PRODUCT_ID, ) class TestClosedProduct(unittest.TestCase): # noqa: PLR0904 DATASET_NAME = "MDS1" BAND_NAME = "proc_data_1" def setUp(self): self.product = epr.open(PRODUCT_FILE) self.product.close() def test_properties(self): for name in ( "file_path", "tot_size", "id_string", "meris_iodd_version", ): self.assertRaises(ValueError, getattr, self.product, name) def test_get_get_scene_width(self): self.assertRaises(ValueError, self.product.get_scene_width) def test_get_get_scene_height(self): self.assertRaises(ValueError, self.product.get_scene_height) def test_get_num_datasets(self): self.assertRaises(ValueError, self.product.get_num_datasets) def test_get_num_dsds(self): self.assertRaises(ValueError, self.product.get_num_dsds) def test_get_num_bands(self): self.assertRaises(ValueError, self.product.get_num_bands) def test_get_mph(self): self.assertRaises(ValueError, self.product.get_mph) def test_get_sph(self): self.assertRaises(ValueError, self.product.get_sph) def test_get_dataset_at(self): self.assertRaises(ValueError, self.product.get_dataset_at, 0) def test_get_dataset(self): self.assertRaises( ValueError, self.product.get_dataset, self.DATASET_NAME ) def test_get_dsd_at(self): self.assertRaises(ValueError, self.product.get_dsd_at, 0) def test_get_band_id(self): self.assertRaises(ValueError, self.product.get_band, self.BAND_NAME) def test_get_band_id_at(self): self.assertRaises(ValueError, self.product.get_band_at, 0) def test_read_bitmask_raster(self): bm_expr = "l2_flags.LAND AND !l2_flags.CLOUD" raster = epr.create_bitmask_raster(12, 10) xoffset = 0 yoffset = 0 self.assertRaises( ValueError, self.product.read_bitmask_raster, bm_expr, xoffset, yoffset, raster, ) def test_get_dataset_names(self): self.assertRaises(ValueError, self.product.get_dataset_names) def test_get_band_names(self): self.assertRaises(ValueError, self.product.get_band_names) def test_datasets(self): self.assertRaises(ValueError, self.product.datasets) def test_bands(self): self.assertRaises(ValueError, self.product.bands) def test_repr(self): self.assertRaises(ValueError, repr, self.product) def test_str(self): self.assertRaises(ValueError, str, self.product) class TestDataset(unittest.TestCase): OPEN_MODE = "rb" DATASET_NAME = "MDS1" DATASET_DESCRIPTION = "Measurement Data Set 1" NUM_RECORDS = 3915 DSD_NAME = "MDS1" RECORD_INDEX = 0 def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) self.dataset = self.product.get_dataset(self.DATASET_NAME) def tearDown(self): self.product.close() def test_product_property(self): self.assertTrue(equal_products(self.dataset.product, self.product)) def test_description_property(self): self.assertEqual(self.dataset.description, self.DATASET_DESCRIPTION) def test_get_name(self): self.assertEqual(self.dataset.get_name(), self.DATASET_NAME) def test_get_dsd_name(self): self.assertEqual(self.dataset.get_dsd_name(), self.DSD_NAME) def test_get_num_records(self): self.assertEqual(self.dataset.get_num_records(), self.NUM_RECORDS) def test_get_dsd(self): self.assertTrue(isinstance(self.dataset.get_dsd(), epr.DSD)) def test_create_record(self): record = self.dataset.create_record() self.assertTrue(isinstance(record, epr.Record)) def test_create_record_index(self): record = self.dataset.create_record() self.assertEqual(record.index, None) def test_read_record(self): record = self.dataset.read_record(self.RECORD_INDEX) self.assertTrue(isinstance(record, epr.Record)) def test_read_record_index(self): record = self.dataset.read_record(self.RECORD_INDEX) self.assertEqual(record.index, self.RECORD_INDEX) def test_read_record_passed(self): created_record = self.dataset.create_record() read_record = self.dataset.read_record( self.RECORD_INDEX, created_record ) self.assertTrue(created_record is read_record) def test_read_record_passed_index(self): created_record = self.dataset.create_record() self.assertEqual(created_record.index, None) read_record = self.dataset.read_record( self.RECORD_INDEX, created_record ) self.assertEqual(read_record.index, self.RECORD_INDEX) def test_read_record_passed_invalid(self): self.assertRaises(TypeError, self.dataset.read_record, 0, 0) class TestDatasetRW(TestDataset): OPEN_MODE = "rb+" class TestDatasetHighLevelAPI(unittest.TestCase): DATASET_NAME = TestDataset.DATASET_NAME def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dataset = self.product.get_dataset(self.DATASET_NAME) def tearDown(self): self.product.close() def test_records(self): records = self.dataset.records() self.assertTrue(records) self.assertEqual(len(records), self.dataset.get_num_records()) for index, record in enumerate(records): ref_record = self.dataset.read_record(index) self.assertEqual( record.get_field_names(), ref_record.get_field_names() ) def test_iter(self): for index, record in enumerate(self.dataset): ref_record = self.dataset.read_record(index) self.assertEqual( record.get_field_names(), ref_record.get_field_names() ) self.assertEqual(index + 1, self.dataset.get_num_records()) def test_repr(self): pattern = ( r"epr\.Dataset\((?P['\"])(?P\w+)(?P=q)\) " r"(?P\d+) records" ) mobj = re.match(pattern, repr(self.dataset)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("name"), self.dataset.get_name()) self.assertEqual( mobj.group("num"), str(self.dataset.get_num_records()) ) def test_repr_type(self): self.assertTrue(isinstance(repr(self.dataset), str)) def test_str(self): lines = [repr(self.dataset), ""] lines.extend(map(str, self.dataset)) data = "\n".join(lines) self.assertEqual(data, str(self.dataset)) def test_str_type(self): self.assertTrue(isinstance(str(self.dataset), str)) class TestDatasetOnClosedProduct(unittest.TestCase): DATASET_NAME = "MDS1" def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dataset = self.product.get_dataset(self.DATASET_NAME) self.record = self.dataset.create_record() self.product.close() def test_product_property(self): self.assertTrue(isinstance(self.dataset.product, epr.Product)) def test_description_property(self): self.assertRaises(ValueError, getattr, self.dataset, "description") def test_get_name(self): self.assertRaises(ValueError, self.dataset.get_name) def test_get_dsd_name(self): self.assertRaises(ValueError, self.dataset.get_dsd_name) def test_get_num_records(self): self.assertRaises(ValueError, self.dataset.get_num_records) def test_get_dsd(self): self.assertRaises(ValueError, self.dataset.get_dsd) def test_create_record(self): self.assertRaises(ValueError, self.dataset.create_record) def test_read_record(self): self.assertRaises(ValueError, self.dataset.read_record, 0) def test_read_record_passed(self): self.assertRaises(ValueError, self.dataset.read_record, 0, self.record) def test_records(self): self.assertRaises(ValueError, self.dataset.records) def test_iter(self): self.assertRaises(ValueError, lambda x: next(iter(x)), self.dataset) def test_repr(self): self.assertRaises(ValueError, repr, self.dataset) def test_str(self): self.assertRaises(ValueError, str, self.dataset) class TestBand(unittest.TestCase): # noqa: PLR0904 OPEN_MODE = "rb+" DATASET_NAME = "MDS1" BAND_NAMES = ( "slant_range_time", "incident_angle", "latitude", "longitude", "proc_data_1", "proc_data_2", ) BAND_NAME = "proc_data_1" BAND_DESCTIPTION = "Alternating Polarization Medium Resolution Image" XOFFSET = 90 YOFFSET = 80 WIDTH = 200 HEIGHT = 100 SCALING_FACTOR = 1.0 SCALING_OFFSET = 0.0 UNIT: str | None = None RTOL = 1e-7 DATA_TYPE = np.float32 # fmt: off TEST_DATA: np.typing.NDArray = np.asarray([ [255., 333., 313., 295., 264., 306., 299., 330., 399., 335.], [254., 233., 320., 325., 281., 247., 249., 228., 217., 210.], [243., 266., 399., 397., 320., 237., 251., 261., 236., 210.], [216., 254., 323., 324., 286., 240., 242., 271., 253., 230.], [199., 226., 241., 259., 276., 272., 261., 252., 259., 235.], [221., 212., 264., 305., 271., 264., 275., 224., 284., 251.], [243., 235., 285., 312., 260., 242., 270., 233., 267., 259.], [248., 259., 266., 261., 269., 254., 274., 278., 287., 347.], [270., 262., 263., 238., 260., 280., 323., 374., 406., 437.], [303., 278., 303., 270., 264., 352., 434., 435., 423., 412.], ]) # fmt: on def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) self.band = self.product.get_band(self.BAND_NAME) def tearDown(self): self.product.close() def test_product_property(self): self.assertTrue(equal_products(self.band.product, self.product)) def test_spectr_band_index_property(self): self.assertEqual(self.band.spectr_band_index, -1) def test_sample_model_property(self): self.assertEqual(self.band.sample_model, 0) def test_data_type_property(self): self.assertEqual(self.band.data_type, epr.E_TID_FLOAT) def test_scaling_method_property(self): self.assertEqual(self.band.scaling_method, epr.E_SMID_LIN) def test_scaling_offset_property(self): self.assertEqual(self.band.scaling_offset, self.SCALING_OFFSET) def test_scaling_factor_property(self): self.assertEqual(self.band.scaling_factor, self.SCALING_FACTOR) self.assertTrue(isinstance(self.band.scaling_factor, float)) def test_bm_expr_property(self): self.assertEqual(self.band.bm_expr, None) def test_unit_property(self): self.assertEqual(self.band.unit, self.UNIT) def test_description_property(self): self.assertEqual(self.band.description, self.BAND_DESCTIPTION) def test_lines_mirrored_property(self): self.assertTrue(isinstance(self.band.lines_mirrored, bool)) self.assertEqual(self.band.lines_mirrored, True) def test_dataset_property(self): dataset = self.band.dataset self.assertTrue(isinstance(dataset, epr.Dataset)) self.assertEqual(dataset.get_name(), self.DATASET_NAME) def test_get_name(self): for index in range(len(self.BAND_NAMES)): b = self.product.get_band_at(index) self.assertEqual(b.get_name(), self.BAND_NAMES[index]) def test_create_compatible_raster(self): width = self.product.get_scene_width() height = self.product.get_scene_height() raster = self.band.create_compatible_raster(width, height) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), width) self.assertEqual(raster.get_height(), height) # @NOTE: data type on disk is epr.E_TID_USHORT self.assertEqual(raster.data_type, epr.E_TID_FLOAT) def test_create_compatible_raster_with_invalid_size(self): width = self.product.get_scene_width() height = self.product.get_scene_height() self.assertRaises( (ValueError, OverflowError), self.band.create_compatible_raster, -1, height, ) self.assertRaises( (ValueError, OverflowError), self.band.create_compatible_raster, width, -1, ) self.assertRaises( ValueError, self.band.create_compatible_raster, self.product.get_scene_width() + 10, height, ) self.assertRaises( ValueError, self.band.create_compatible_raster, width, self.product.get_scene_height() + 10, ) def test_create_compatible_raster_with_step(self): src_width = self.product.get_scene_width() src_height = self.product.get_scene_height() xstep = 2 ystep = 3 width = (src_width - 1) // xstep + 1 height = (src_height - 1) // ystep + 1 raster = self.band.create_compatible_raster( src_width, src_height, xstep, ystep ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), width) self.assertEqual(raster.get_height(), height) # @NOTE: data type on disk is epr.E_TID_USHORT self.assertEqual(raster.data_type, epr.E_TID_FLOAT) def test_create_compatible_raster_with_invalid_step(self): width = self.product.get_scene_width() height = self.product.get_scene_height() self.assertRaises( (ValueError, OverflowError), self.band.create_compatible_raster, width, height, -1, 2, ) self.assertRaises( (ValueError, OverflowError), self.band.create_compatible_raster, width, height, 2, -1, ) self.assertRaises( (ValueError, OverflowError), self.band.create_compatible_raster, width, height, -2, -1, ) self.assertRaises( (ValueError, ValueError), self.band.create_compatible_raster, width, height, width + 10, 2, ) self.assertRaises( (ValueError, ValueError), self.band.create_compatible_raster, width, height, 2, height + 10, ) self.assertRaises( (ValueError, ValueError), self.band.create_compatible_raster, width, height, width + 10, height + 10, ) def test_create_compatible_raster_with_default_size(self): src_width = self.product.get_scene_width() src_height = self.product.get_scene_height() raster = self.band.create_compatible_raster() self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), src_width) self.assertEqual(raster.get_height(), src_height) # @NOTE: data type on disk is epr.E_TID_USHORT self.assertEqual(raster.data_type, epr.E_TID_FLOAT) def test_read_raster(self): rasterin = self.band.create_compatible_raster(self.WIDTH, self.HEIGHT) raster = self.band.read_raster(self.XOFFSET, self.YOFFSET, rasterin) self.assertTrue(isinstance(raster, epr.Raster)) self.assertTrue(raster is rasterin) self.assertEqual(raster.get_width(), self.WIDTH) self.assertEqual(raster.get_height(), self.HEIGHT) # @NOTE: data type on disk is epr.E_TID_USHORT self.assertEqual(raster.data_type, epr.E_TID_FLOAT) h, w = self.TEST_DATA.shape npt.assert_allclose( raster.get_pixel(0, 0), self.TEST_DATA[0, 0], rtol=self.RTOL ) npt.assert_allclose( raster.get_pixel(w - 1, h - 1), self.TEST_DATA[h - 1, w - 1], rtol=self.RTOL, ) def test_read_raster_none(self): raster = self.band.read_raster() self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.get_width(), self.product.get_scene_width()) self.assertEqual(raster.get_height(), self.product.get_scene_height()) # @NOTE: data type on disk is epr.E_TID_USHORT self.assertEqual(raster.data_type, epr.E_TID_FLOAT) h, w = self.TEST_DATA.shape npt.assert_allclose( raster.get_pixel(self.XOFFSET, self.YOFFSET), self.TEST_DATA[0, 0], rtol=self.RTOL, ) npt.assert_allclose( raster.get_pixel(self.XOFFSET + w - 1, self.YOFFSET + h - 1), self.TEST_DATA[h - 1, w - 1], rtol=self.RTOL, ) def test_read_raster_default_offset(self): height = self.HEIGHT width = self.WIDTH raster1 = self.band.create_compatible_raster(width, height) raster2 = self.band.create_compatible_raster(width, height) r1 = self.band.read_raster(0, 0, raster1) r2 = self.band.read_raster(raster=raster2) self.assertTrue(r1 is raster1) self.assertTrue(r2 is raster2) self.assertEqual(raster1.get_pixel(0, 0), raster2.get_pixel(0, 0)) self.assertEqual( raster1.get_pixel(width - 1, height - 1), raster2.get_pixel(width - 1, height - 1), ) h, w = self.TEST_DATA.shape npt.assert_allclose( raster1.get_pixel(self.XOFFSET, self.YOFFSET), self.TEST_DATA[0, 0], rtol=self.RTOL, ) npt.assert_allclose( raster1.get_pixel(self.XOFFSET + w - 1, self.YOFFSET + h - 1), self.TEST_DATA[h - 1, w - 1], rtol=self.RTOL, ) def test_read_raster_with_invalid_raster(self): self.assertRaises(TypeError, self.band.read_raster, 0, 0, 0) def test_read_raster_with_invalid_offset(self): raster = self.band.create_compatible_raster(self.WIDTH, self.HEIGHT) self.assertRaises(ValueError, self.band.read_raster, -1, 0, raster) self.assertRaises(ValueError, self.band.read_raster, 0, -1, raster) self.assertRaises(ValueError, self.band.read_raster, -1, -1, raster) invalid_xoffset = 2 * self.product.get_scene_width() invalid_yoffset = 2 * self.product.get_scene_height() self.assertRaises( ValueError, self.band.read_raster, invalid_xoffset, 0, raster ) self.assertRaises( ValueError, self.band.read_raster, 0, invalid_yoffset, raster ) self.assertRaises( ValueError, self.band.read_raster, invalid_xoffset, invalid_yoffset, raster, ) def test_read_as_array_ref(self): data = self.band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET ) self.assertTrue(isinstance(data, np.ndarray)) self.assertEqual(data.shape, (self.HEIGHT, self.WIDTH)) self.assertEqual(data.dtype, self.DATA_TYPE) h, w = self.TEST_DATA.shape npt.assert_allclose(data[:h, :w], self.TEST_DATA, rtol=self.RTOL) def test_read_as_array_cross(self): data = self.band.read_as_array() box = self.band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET ) npt.assert_array_equal( data[ self.YOFFSET : self.YOFFSET + self.HEIGHT, self.XOFFSET : self.XOFFSET + self.WIDTH, ], box, ) def test_read_as_array_default(self): data = self.band.read_as_array() self.assertTrue(isinstance(data, np.ndarray)) self.assertEqual( data.shape, (self.product.get_scene_height(), self.product.get_scene_width()), ) self.assertEqual(data.dtype, self.DATA_TYPE) h, w = self.TEST_DATA.shape npt.assert_allclose( data[ self.YOFFSET : self.YOFFSET + h, self.XOFFSET : self.XOFFSET + w, ], self.TEST_DATA, rtol=self.RTOL, ) # @SEEALSO: https://www.brockmann-consult.de/beam-jira/browse/EPR-2 @unittest.skipIf(EPR_C_BUG_BCEPR002, "buggy EPR_C_API detected") def test_read_as_array_with_step_2(self): step = 2 band = self.band data = band.read_as_array() box = band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET, step, step ) self.assertTrue(isinstance(box, np.ndarray)) self.assertEqual( box.shape, ((self.HEIGHT - 1) // step + 1, (self.WIDTH - 1) // step + 1), ) self.assertEqual(box.dtype, self.DATA_TYPE) npt.assert_allclose( data[ self.YOFFSET : self.YOFFSET + self.HEIGHT : step, self.XOFFSET : self.XOFFSET + self.WIDTH : step, ], box, ) h, w = self.TEST_DATA.shape npt.assert_allclose( box[: (h - 1) // step + 1, : (w - 1) // step + 1], self.TEST_DATA[::step, ::step], rtol=self.RTOL, ) @unittest.skipIf(EPR_C_BUG_BCEPR002, "buggy EPR_C_API detected") def test_read_as_array_with_step_3(self): step = 3 band = self.band data = band.read_as_array() box = band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET, step, step ) self.assertTrue(isinstance(box, np.ndarray)) self.assertEqual( box.shape, ((self.HEIGHT - 1) // step + 1, (self.WIDTH - 1) // step + 1), ) self.assertEqual(box.dtype, self.DATA_TYPE) npt.assert_allclose( data[ self.YOFFSET : self.YOFFSET + self.HEIGHT : step, self.XOFFSET : self.XOFFSET + self.WIDTH : step, ], box, ) h, w = self.TEST_DATA.shape npt.assert_allclose( box[: (h - 1) // step + 1, : (w - 1) // step + 1], self.TEST_DATA[::step, ::step], rtol=self.RTOL, ) @unittest.skipIf(EPR_C_BUG_BCEPR002, "buggy EPR_C_API detected") def test_read_as_array_with_step_4(self): step = 4 band = self.band data = band.read_as_array() box = band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET, step, step ) self.assertTrue(isinstance(box, np.ndarray)) self.assertEqual( box.shape, ((self.HEIGHT - 1) // step + 1, (self.WIDTH - 1) // step + 1), ) self.assertEqual(box.dtype, self.DATA_TYPE) npt.assert_allclose( data[ self.YOFFSET : self.YOFFSET + self.HEIGHT : step, self.XOFFSET : self.XOFFSET + self.WIDTH : step, ], box, ) h, w = self.TEST_DATA.shape npt.assert_allclose( box[: (h - 1) // step + 1, : (w - 1) // step + 1], self.TEST_DATA[::step, ::step], ) @unittest.skipIf(EPR_C_BUG_BCEPR002, "buggy EPR_C_API detected") def test_read_as_array_with_step_5(self): step = 5 band = self.band data = band.read_as_array() box = band.read_as_array( self.WIDTH, self.HEIGHT, self.XOFFSET, self.YOFFSET, step, step ) self.assertTrue(isinstance(box, np.ndarray)) self.assertEqual( box.shape, ((self.HEIGHT - 1) // step + 1, (self.WIDTH - 1) // step + 1), ) self.assertEqual(box.dtype, self.DATA_TYPE) npt.assert_allclose( data[ self.YOFFSET : self.YOFFSET + self.HEIGHT : step, self.XOFFSET : self.XOFFSET + self.WIDTH : step, ], box, ) h, w = self.TEST_DATA.shape npt.assert_allclose( box[: (h - 1) // step + 1, : (w - 1) // step + 1], self.TEST_DATA[::step, ::step], rtol=self.RTOL, ) class TestBandRW(TestBand): OPEN_MODE = "rb+" class TestAnnotationBand(TestBand): DATASET_NAME = "GEOLOCATION_GRID_ADS" BAND_NAME = "incident_angle" BAND_DESCTIPTION = "Incident angle" SCALING_FACTOR = 1.0 SCALING_OFFSET = 0.0 UNIT = "deg" RTOL = 1e-7 # fmt: off TEST_DATA: np.typing.NDArray = np.asarray([ [21.869589, 21.864470, 21.859352, 21.854235, 21.849115, 21.843998, 21.838880, 21.833761, 21.828644, 21.823524], [21.869589, 21.864470, 21.859352, 21.854235, 21.849115, 21.843998, 21.838880, 21.833761, 21.828644, 21.823524], [21.869590, 21.864471, 21.859354, 21.854237, 21.849117, 21.844000, 21.838882, 21.833763, 21.828646, 21.823526], [21.869590, 21.864471, 21.859354, 21.854237, 21.849117, 21.844000, 21.838882, 21.833763, 21.828646, 21.823526], [21.869590, 21.864471, 21.859354, 21.854237, 21.849117, 21.844000, 21.838882, 21.833763, 21.828646, 21.823526], [21.869593, 21.864473, 21.859356, 21.854239, 21.849120, 21.844002, 21.838884, 21.833765, 21.828648, 21.823528], [21.869593, 21.864473, 21.859356, 21.854239, 21.849120, 21.844002, 21.838884, 21.833765, 21.828648, 21.823528], [21.869595, 21.864475, 21.859358, 21.854240, 21.849121, 21.844004, 21.838886, 21.833767, 21.828650, 21.823530], [21.869595, 21.864475, 21.859358, 21.854240, 21.849121, 21.844004, 21.838886, 21.833767, 21.828650, 21.823530], [21.869595, 21.864475, 21.859358, 21.854240, 21.849121, 21.844004, 21.838886, 21.833767, 21.828650, 21.823530], ]) # fmt: on @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_read_raster(self): super().test_read_raster() @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_read_raster_default_offset(self): super().test_read_raster_default_offset() @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_read_as_array_ref(self): super().test_read_as_array_ref() @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_read_as_array_cross(self): super().test_read_as_array_cross() class TestBandHighLevelAPI(unittest.TestCase): def setUp(self): self.product = epr.Product(PRODUCT_FILE) def tearDown(self): self.product.close() def test_repr(self): pattern = ( r"epr.Band\((?P['\"])(?P\w+)(?P=q1)\) of " r"epr.Product\((?P['\"])(?P\w+)(?P=q2)\)" ) for band in self.product.bands(): mobj = re.match(pattern, repr(band)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("name"), band.get_name()) self.assertEqual(mobj.group("product_id"), self.product.id_string) def test_repr_type(self): band = self.product.get_band_at(0) self.assertTrue(isinstance(repr(band), str)) def test_str_type(self): band = self.product.get_band_at(0) self.assertTrue(isinstance(str(band), str)) class TestBandLowLevelAPI(unittest.TestCase): FIELD_INDEX = 7 ELEM_INDEX = -1 def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.band = self.product.get_band_at(0) def tearDown(self): self.product.close() def test_magic(self): self.assertEqual(self.band._magic, _EPR_MAGIC_BAND_ID) # noqa: SLF001 def test_field_index(self): self.assertEqual( self.band._field_index, # noqa: SLF001 self.FIELD_INDEX, ) def test_elem_index(self): self.assertEqual( self.band._elem_index, # noqa: SLF001 self.ELEM_INDEX, ) class TestBandOnClosedProduct(unittest.TestCase): WIDTH = 12 HEIGHT = 10 def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.band = self.product.get_band_at(0) self.raster = self.band.create_compatible_raster( self.WIDTH, self.HEIGHT ) self.product.close() def test_product_property(self): self.assertTrue(isinstance(self.band.product, epr.Product)) def test_properties(self): fields = ( "spectr_band_index", "sample_model", "data_type", "scaling_method", "scaling_offset", "scaling_factor", "bm_expr", "unit", "description", "lines_mirrored", ) for name in fields: with self.subTest(field=name): self.assertRaises(ValueError, getattr, self.band, name) def test_get_name(self): self.assertRaises(ValueError, self.product.get_band_at, 0) def test_create_compatible_raster(self): self.assertRaises( ValueError, self.band.create_compatible_raster, self.WIDTH, self.HEIGHT, ) def test_read_raster(self): self.assertRaises(ValueError, self.band.read_raster) def test_read_as_array(self): self.assertRaises( ValueError, self.band.read_as_array, self.WIDTH, self.HEIGHT ) def test_str(self): self.assertRaises(ValueError, str, self.band) def test_repr(self): self.assertRaises(ValueError, repr, self.band) class TestCreateRaster(unittest.TestCase): RASTER_WIDTH = 400 RASTER_HEIGHT = 300 RASTER_DATA_TYPE = epr.E_TID_FLOAT def test_create_raster(self): raster = epr.create_raster( self.RASTER_DATA_TYPE, self.RASTER_WIDTH, self.RASTER_HEIGHT ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.data_type, self.RASTER_DATA_TYPE) self.assertEqual(raster.get_width(), self.RASTER_WIDTH) self.assertEqual(raster.get_height(), self.RASTER_HEIGHT) def test_create_raster_with_step(self): src_width = 3 * self.RASTER_WIDTH src_height = 2 * self.RASTER_HEIGHT raster = epr.create_raster( self.RASTER_DATA_TYPE, src_width, src_height, 3, 2 ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.data_type, self.RASTER_DATA_TYPE) self.assertEqual(raster.get_width(), self.RASTER_WIDTH) self.assertEqual(raster.get_height(), self.RASTER_HEIGHT) def test_create_raster_with_invalid_step(self): src_width = 3 * self.RASTER_WIDTH src_height = 2 * self.RASTER_HEIGHT self.assertRaises( ValueError, epr.create_raster, self.RASTER_DATA_TYPE, src_width, src_height, 0, 2, ) def test_create_raster_with_invalid_size(self): self.assertRaises( (ValueError, OverflowError), epr.create_raster, self.RASTER_DATA_TYPE, -1, self.RASTER_HEIGHT, ) def test_create_bitmask_raster(self): raster = epr.create_bitmask_raster( self.RASTER_WIDTH, self.RASTER_HEIGHT ) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.data_type, epr.E_TID_UCHAR) self.assertEqual(raster.get_width(), self.RASTER_WIDTH) self.assertEqual(raster.get_height(), self.RASTER_HEIGHT) def test_create_bitmask_raster_with_step(self): src_width = 3 * self.RASTER_WIDTH src_height = 2 * self.RASTER_HEIGHT raster = epr.create_bitmask_raster(src_width, src_height, 3, 2) self.assertTrue(isinstance(raster, epr.Raster)) self.assertEqual(raster.data_type, epr.E_TID_UCHAR) self.assertEqual(raster.get_width(), self.RASTER_WIDTH) self.assertEqual(raster.get_height(), self.RASTER_HEIGHT) def test_create_bitmask_raster_with_invalid_step(self): src_width = 3 * self.RASTER_WIDTH src_height = 2 * self.RASTER_HEIGHT self.assertRaises( ValueError, epr.create_bitmask_raster, src_width, src_height, 0, 2 ) def test_create_bitmask_raster_with_invalid_size(self): self.assertRaises( (ValueError, OverflowError), epr.create_bitmask_raster, -1, self.RASTER_HEIGHT, ) class TestRaster(unittest.TestCase): RASTER_WIDTH = TestBand.WIDTH RASTER_HEIGHT = TestBand.HEIGHT RASTER_DATA_TYPE = epr.E_TID_FLOAT RASTER_ELEM_SIZE = 4 RTOL = 1e-7 TEST_DATA: np.typing.NDArray = np.zeros((10, 10)) def setUp(self): self.raster = epr.create_raster( self.RASTER_DATA_TYPE, self.RASTER_WIDTH, self.RASTER_HEIGHT ) def test_get_width(self): self.assertEqual(self.raster.get_width(), self.RASTER_WIDTH) def test_get_height(self): self.assertEqual(self.raster.get_height(), self.RASTER_HEIGHT) def test_get_elem_size(self): self.assertEqual(self.raster.get_elem_size(), self.RASTER_ELEM_SIZE) def test_get_pixel(self): npt.assert_allclose(self.raster.get_pixel(0, 0), self.TEST_DATA[0, 0]) def test_get_pixel_invalid_x(self): self.assertRaises(ValueError, self.raster.get_pixel, -1, 0) self.assertRaises( ValueError, self.raster.get_pixel, self.RASTER_WIDTH + 1, 0 ) def test_get_pixel_invalid_y(self): self.assertRaises(ValueError, self.raster.get_pixel, 0, -1) self.assertRaises( ValueError, self.raster.get_pixel, 0, self.RASTER_HEIGHT + 1 ) def test_get_pixel_invalid_coor(self): self.assertRaises(ValueError, self.raster.get_pixel, -1, -1) self.assertRaises( ValueError, self.raster.get_pixel, self.RASTER_WIDTH + 1, self.RASTER_HEIGHT + 1, ) def test_get_pixel_type(self): self.assertEqual(type(self.raster.get_pixel(0, 0)), float) def test_data_type_property(self): self.assertEqual(self.raster.data_type, self.RASTER_DATA_TYPE) def test_source_width_property(self): self.assertEqual(self.raster.source_width, self.RASTER_WIDTH) self.assertTrue(isinstance(self.raster.source_width, numbers.Integral)) def test_source_height_property(self): self.assertEqual(self.raster.source_height, self.RASTER_HEIGHT) self.assertTrue( isinstance(self.raster.source_height, numbers.Integral) ) def test_source_step_x_property(self): self.assertEqual(self.raster.source_step_x, 1) self.assertTrue( isinstance(self.raster.source_step_x, numbers.Integral) ) def test_source_step_y_property(self): self.assertEqual(self.raster.source_step_y, 1) self.assertTrue( isinstance(self.raster.source_step_y, numbers.Integral) ) def test_data_property(self): height = self.raster.get_height() width = self.raster.get_width() data = self.raster.data self.assertTrue(isinstance(data, np.ndarray)) self.assertEqual(data.ndim, 2) self.assertEqual(data.shape, (height, width)) self.assertEqual(data.dtype, EPR_TO_NUMPY_TYPE[self.raster.data_type]) ny, nx = self.TEST_DATA.shape npt.assert_allclose(data[:ny, :nx], self.TEST_DATA, rtol=self.RTOL) def test_data_property_two_times(self): data1 = self.raster.data data2 = self.raster.data self.assertTrue(data1 is data2) self.assertTrue(np.all(data1 == data2)) def test_data_property_shared_data_semantic(self): data1 = self.raster.data data1[0, 0] *= 2 data2 = self.raster.data self.assertTrue(np.all(data1 == data2)) def test_data_property_data_scope(self): data1 = self.raster.data self.assertTrue(isinstance(data1, np.ndarray)) data1 = None data2 = self.raster.data self.assertTrue(isinstance(data2, np.ndarray)) def test_data_property_raster_scope(self): data = self.raster.data self.assertTrue(isinstance(data, np.ndarray)) self.raster = None self.assertTrue(isinstance(data, np.ndarray)) ny, nx = self.TEST_DATA.shape npt.assert_allclose(data[:ny, :nx], self.TEST_DATA, rtol=self.RTOL) class TestRasterRead(TestRaster): BAND_NAME = TestBand.BAND_NAME RASTER_XOFFSET = TestBand.XOFFSET RASTER_YOFFSET = TestBand.YOFFSET TEST_DATA: np.typing.NDArray = TestBand.TEST_DATA def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.band = self.product.get_band(self.BAND_NAME) self.raster = self.band.create_compatible_raster( self.RASTER_WIDTH, self.RASTER_HEIGHT ) self.band.read_raster( self.RASTER_XOFFSET, self.RASTER_YOFFSET, self.raster ) def tearDown(self): self.product.close() def test_data_property_shared_semantics_readload(self): data1 = self.raster.data data1[0, 0] *= 2 self.band.read_raster( self.RASTER_XOFFSET, self.RASTER_YOFFSET, self.raster ) data2 = self.raster.data self.assertEqual(data1[0, 0], data2[0, 0]) self.assertTrue(np.all(data1 == data2)) class TestAnnotatedRasterRead(TestRasterRead): BAND_NAME = TestAnnotationBand.BAND_NAME RASTER_XOFFSET = TestAnnotationBand.XOFFSET RASTER_YOFFSET = TestAnnotationBand.YOFFSET TEST_DATA: np.typing.NDArray = TestAnnotationBand.TEST_DATA RTOL = 1e-6 @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_get_pixel(self): super().test_get_pixel() @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_data_property(self): super().test_data_property() @unittest.skipIf(EPR_C_BUG_PYEPR009, "buggy EPR_C_API detected") def test_data_property_raster_scope(self): super().test_data_property_raster_scope() class TestRasterHighLevelAPI(unittest.TestCase): RASTER_WIDTH = 400 RASTER_HEIGHT = 300 RASTER_DATA_TYPE = epr.E_TID_FLOAT def setUp(self): self.raster = epr.create_raster( self.RASTER_DATA_TYPE, self.RASTER_WIDTH, self.RASTER_HEIGHT ) def test_repr(self): pattern = ( r" (?P\w+) " r"\((?P\d+)L x (?P\d+)P\)" ) mobj = re.match(pattern, repr(self.raster)) self.assertNotEqual(mobj, None) self.assertEqual( mobj.group("data_type"), epr.data_type_id_to_str(self.raster.data_type), ) self.assertEqual(mobj.group("lines"), str(self.raster.get_height())) self.assertEqual(mobj.group("pixels"), str(self.raster.get_width())) def test_repr_type(self): self.assertTrue(isinstance(repr(self.raster), str)) def test_str_type(self): self.assertTrue(isinstance(str(self.raster), str)) class TestRasterLowLevelAPI(unittest.TestCase): RASTER_WIDTH = 400 RASTER_HEIGHT = 300 RASTER_DATA_TYPE = epr.E_TID_FLOAT def setUp(self): self.raster = epr.create_raster( self.RASTER_DATA_TYPE, self.RASTER_WIDTH, self.RASTER_HEIGHT ) def test_magic(self): self.assertEqual(self.raster._magic, _EPR_MAGIC_RASTER) # noqa: SLF001 class TestRecord(unittest.TestCase): OPEN_MODE = "rb" DATASET_NAME = "MDS1_SQ_ADS" NUM_FIELD = 39 FIELD_NAME = "input_missing_lines_flag" TOT_SIZE = 170 RECORD_INDEX = 0 def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) self.dataset = self.product.get_dataset(self.DATASET_NAME) self.record = self.dataset.read_record(self.RECORD_INDEX) def tearDown(self): self.product.close() def test_get_num_fields(self): self.assertEqual(self.record.get_num_fields(), self.NUM_FIELD) @quiet def test_print(self): self.record.print() @quiet def test_print_ostream(self): self.record.print(sys.stderr) def test_print_invalid_ostream(self): self.assertRaises(TypeError, self.record.print, "invalid") @quiet def test_print_element(self): self.record.print_element(3, 0) @quiet def test_print_element_ostream(self): self.record.print_element(0, 0, sys.stderr) def test_print_element_invalid_ostream(self): self.assertRaises( TypeError, self.record.print_element, 0, 0, "invalid" ) @quiet # quiet avoids errors when sys.stderr does not have fileno def test_print_element_field_out_of_range(self): index = self.record.get_num_fields() + 10 self.assertRaises(ValueError, self.record.print_element, index, 0) @quiet # quiet avoids errors when sys.stderr does not have fileno def test_print_element_element_out_of_range(self): self.assertRaises(ValueError, self.record.print_element, 0, 150) def test_get_field(self): field = self.record.get_field(self.FIELD_NAME) self.assertTrue(isinstance(field, epr.Field)) def test_get_field_bytes(self): field_name = self.FIELD_NAME.encode("UTF-8") field = self.record.get_field(self.FIELD_NAME) self.assertTrue(isinstance(field_name, bytes)) self.assertTrue(isinstance(field, epr.Field)) def test_get_field_invlid_name(self): self.assertRaises(ValueError, self.record.get_field, "") def test_get_field_at(self): self.assertTrue(isinstance(self.record.get_field_at(0), epr.Field)) def test_get_field_at_invalid_index(self): index = self.record.get_num_fields() + 10 self.assertRaises(ValueError, self.record.get_field_at, index) def test_dataset_name(self): self.assertEqual(self.record.dataset_name, self.DATASET_NAME) def test_dataset_name_new(self): record = self.dataset.create_record() self.assertEqual(record.dataset_name, self.DATASET_NAME) def test_tot_size(self): self.assertEqual(self.record.tot_size, self.TOT_SIZE) def test_index(self): self.assertEqual(self.record.index, self.RECORD_INDEX) class TestRecordRW(TestRecord): OPEN_MODE = "rb+" class TestRecordHighLevelAPI(unittest.TestCase): DATASET_NAME = TestRecord.DATASET_NAME FIELD_NAMES = [ "zero_doppler_time", "attach_flag", "input_mean_flag", "input_std_dev_flag", "input_gaps_flag", "input_missing_lines_flag", "dop_cen_flag", "dop_amb_flag", "output_mean_flag", "output_std_dev_flag", "chirp_flag", "missing_data_sets_flag", "invalid_downlink_flag", "spare_1", "thresh_chirp_broadening", "thresh_chirp_sidelobe", "thresh_chirp_islr", "thresh_input_mean", "exp_input_mean", "thresh_input_std_dev", "exp_input_std_dev", "thresh_dop_cen", "thresh_dop_amb", "thresh_output_mean", "exp_output_mean", "thresh_output_std_dev", "exp_output_std_dev", "thresh_input_missing_lines", "thresh_input_gaps", "lines_per_gaps", "spare_2", "input_mean", "input_std_dev", "num_gaps", "num_missing_lines", "output_mean", "output_std_dev", "tot_errors", "Spare_3", ] def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dataset = self.product.get_dataset(self.DATASET_NAME) self.record = self.dataset.read_record(0) def tearDown(self): self.product.close() def test_get_field_names_number(self): self.assertEqual( len(self.record.get_field_names()), self.record.get_num_fields() ) def test_get_field_names(self): self.assertEqual( self.record.get_field_names()[: len(self.FIELD_NAMES)], self.FIELD_NAMES, ) def test_fields(self): fields = self.record.fields() self.assertTrue(fields) self.assertEqual(len(fields), self.record.get_num_fields()) names = [field.get_name() for field in fields] self.assertEqual(self.record.get_field_names(), names) def test_iter(self): for index, field in enumerate(self.record): ref_field = self.record.get_field_at(index) self.assertEqual(field.get_name(), ref_field.get_name()) self.assertEqual(index + 1, self.record.get_num_fields()) def test_repr_type(self): self.assertTrue(isinstance(repr(self.record), str)) def test_str_type(self): self.assertTrue(isinstance(str(self.record), str)) class TestRecordLowLevelAPI(unittest.TestCase): RECORD_INDEX = 0 RECORD_SIZE = 170 RECORD_OFFSET = RECORD_INDEX * RECORD_SIZE def setUp(self): self.product = epr.Product(PRODUCT_FILE) dataset = self.product.get_dataset_at(0) self.record = dataset.read_record(self.RECORD_INDEX) def tearDown(self): self.product.close() def test_magic(self): self.assertEqual(self.record._magic, _EPR_MAGIC_RECORD) # noqa: SLF001 def test_get_offset(self): self.assertEqual(self.record.get_offset(), self.RECORD_OFFSET) class TestMultipleRecordsHighLevelAPI(unittest.TestCase): DATASET_NAME = TestProduct.DATASET_NAME def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dataset = self.product.get_dataset(self.DATASET_NAME) def tearDown(self): self.product.close() def test_repr(self): pattern = r" (?P\d+) fields" for record in self.dataset: mobj = re.match(pattern, repr(record)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("num"), str(record.get_num_fields())) def test_str_vs_print(self): for record in self.dataset: with tempfile.TemporaryFile("w+", encoding="utf-8") as fd: record.print(fd) fd.flush() fd.seek(0) data = fd.read() if data.endswith("\n"): data = data[:-1] self.assertEqual(data, str(record)) class TestMphRecordHighLevelAPI(TestRecordHighLevelAPI): DATASET_NAME = "MPH" FIELD_NAMES = [ "PRODUCT", "PROC_STAGE", "REF_DOC", "ACQUISITION_STATION", "PROC_CENTER", "PROC_TIME", "SOFTWARE_VER", "SENSING_START", "SENSING_STOP", "PHASE", "CYCLE", "REL_ORBIT", ] def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.record = self.product.get_mph() def tearDown(self): self.product.close() def test_index(self): self.assertEqual(self.record.index, None) class TestRecordOnClosedProduct(unittest.TestCase): DATASET_NAME = "MDS1_SQ_ADS" NUM_FIELD = 39 FIELD_NAME = "input_missing_lines_flag" FIELD_NAMES = TestRecordHighLevelAPI.FIELD_NAMES def setUp(self): product = epr.Product(PRODUCT_FILE) dataset = product.get_dataset(self.DATASET_NAME) self.record = dataset.read_record(0) # self.mph = product.get_mph() product.close() def test_get_num_fields(self): self.assertEqual(self.record.get_num_fields(), self.NUM_FIELD) # def test_get_num_fields_mph(self): # self.assertEqual(self.mph.get_num_fields(), 34) def test_print(self): self.assertRaises(ValueError, self.record.print) def test_print_element(self): self.assertRaises(ValueError, self.record.print_element, 3, 0) def test_get_field(self): self.assertRaises(ValueError, self.record.get_field, self.FIELD_NAME) def test_get_field_at(self): self.assertRaises(ValueError, self.record.get_field_at, 0) def test_get_field_names(self): self.assertRaises(ValueError, self.record.get_field_names) def test_fields(self): self.assertRaises(ValueError, self.record.fields) def test_iter(self): self.assertRaises(ValueError, lambda x: next(iter(x)), self.record) def test_repr(self): self.assertRaises(ValueError, repr, self.record) def test_str(self): self.assertRaises(ValueError, str, self.record) class TestField(unittest.TestCase): OPEN_MODE = "rb" DATASET_NAME = "MDS1_SQ_ADS" RECORD_INDEX = 0 FIELD_NAME = "input_missing_lines_flag" FIELD_DESCRIPTION = ( "Missing lines significant flag. " "0 = percentage of missing lines <= threshold value " "1 = percentage of missing lines > threshold value. " "The number of missing lines is the number of lines missing from " "the input data excluding data gaps." ) FIELD_TYPE = epr.E_TID_UCHAR # FIELD_TYPE_NAME = 'uchar' FIELD_NUM_ELEMS = 1 FIELD_VALUES: typing.Sequence[int | epr.EPRTime] = (0,) FIELD_UNIT = "flag" FIELD_OFFSET = 16 def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) self.field = record.get_field(self.FIELD_NAME) def tearDown(self): self.product.close() @quiet def test_print_field(self): self.field.print() @quiet def test_print_field_ostream(self): self.field.print(sys.stderr) def test_print_fied_invalid_ostream(self): self.assertRaises(TypeError, self.field.print, "invalid") def test_get_unit(self): self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) def test_get_description(self): self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) def test_get_num_elems(self): self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) def test_get_name(self): self.assertEqual(self.field.get_name(), self.FIELD_NAME) def test_get_type(self): self.assertEqual(self.field.get_type(), self.FIELD_TYPE) def test_get_offset(self): self.assertEqual(self.field.get_offset(), self.FIELD_OFFSET) def test_get_elem(self): self.assertEqual(self.field.get_elem(), self.FIELD_VALUES[0]) def test_get_elem_index(self): self.assertEqual(self.field.get_elem(0), self.FIELD_VALUES[0]) def test_get_elem_invalid_index(self): self.assertRaises( ValueError, self.field.get_elem, self.FIELD_NUM_ELEMS + 10 ) def test_get_elems(self): vect = self.field.get_elems() self.assertTrue(isinstance(vect, np.ndarray)) self.assertEqual(vect.shape, (self.field.get_num_elems(),)) self.assertEqual(vect.dtype, epr.get_numpy_dtype(self.FIELD_TYPE)) npt.assert_allclose(vect[: len(self.FIELD_VALUES)], self.FIELD_VALUES) def test_tot_size(self): elem_size = epr.get_data_type_size(self.FIELD_TYPE) tot_size = elem_size * self.FIELD_NUM_ELEMS self.assertEqual(self.field.tot_size, tot_size) class TestFieldGetElems(unittest.TestCase): def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.record = self.product.get_sph() def test_string_get_elem_int(self): field = self.record.get_field("LINE_LENGTH") value = field.get_elem() self.assertIsInstance(value, int) self.assertEqual(value, 1452) def test_string_get_elem_str(self): field = self.record.get_field("SPH_DESCRIPTOR") value = field.get_elem() self.assertIsInstance(value, bytes) self.assertEqual(value, b"AP Mode Medium Res. Image") def test_string_get_elems_int(self): field = self.record.get_field("LINE_LENGTH") value = field.get_elems() self.assertIsInstance(value, np.ndarray) self.assertTrue(np.isdtype(value.dtype, "integral")) self.assertEqual(value.item(), 1452) def test_string_get_elems_str(self): field = self.record.get_field("SPH_DESCRIPTOR") value = field.get_elems() self.assertIsInstance(value, np.ndarray) self.assertFalse(np.isdtype(value.dtype, "numeric")) self.assertEqual(value.item(), b"AP Mode Medium Res. Image") class TestFieldRW(TestField): OPEN_MODE = "rb+" class TestFieldWriteOnReadOnly(unittest.TestCase): OPEN_MODE = "rb" DATASET_NAME = "MDS1" RECORD_INDEX = 10 FIELD_NAME = "proc_data" FIELD_DESCRIPTION = "SAR Processed Data. Real samples (detected products)" FIELD_TYPE = epr.E_TID_USHORT FIELD_TYPE_NAME = "ushort" FIELD_UNIT = "" FIELD_NUM_ELEMS = 1452 def setUp(self): self.filename = PRODUCT_FILE.with_name(PRODUCT_FILE.name + "_") shutil.copy(PRODUCT_FILE, self.filename) self.product = epr.Product(self.filename, self.OPEN_MODE) dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) self.field = record.get_field(self.FIELD_NAME) def tearDown(self): self.product.close() self.filename.unlink() def test_write_on_read_only_product(self): value = self.field.get_elem() + 10 self.assertRaises(TypeError, self.field.set_elem, value) class TestFieldWrite(unittest.TestCase): OPEN_MODE = "rb+" REOPEN = False DATASET_NAME = "MDS1" RECORD_INDEX = 100 FIELD_NAME = "proc_data" FIELD_DESCRIPTION = "SAR Processed Data. Real samples (detected products)" FIELD_TYPE = epr.E_TID_USHORT FIELD_TYPE_NAME = "ushort" FIELD_UNIT = "" FIELD_INDEX = 3 FIELD_NUM_ELEMS = 1452 # fmt: off FIELD_VALUES = ( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2264, 2123, 2187, 2255, 2332, 2646, 3065, 3496, 3622, 3436, 3694, 3921, 3298, 2368, 1974, ) # fmt: on def setUp(self): self.filename = PRODUCT_FILE.with_name(PRODUCT_FILE.name + "_") shutil.copy(PRODUCT_FILE, self.filename) self.product = None self.dataset = None self.record = None self.field = None self.reopen(self.OPEN_MODE) self.offset = self._get_offset() def _get_offset(self): offset = self.dataset.get_dsd().ds_offset offset += self.record.index * self.record.tot_size for i in range(self.FIELD_INDEX): offset += self.record.get_field_at(i).tot_size return offset def tearDown(self): self.product.close() self.filename.unlink() def reopen(self, mode="rb"): if self.product is not None: self.product.close() self.product = epr.Product(self.filename, mode) self.dataset = self.product.get_dataset(self.DATASET_NAME) self.record = self.dataset.read_record(self.RECORD_INDEX) self.field = self.record.get_field(self.FIELD_NAME) def read(self, offset=0, size=None): if size is None: size = self.field.tot_size os.lseek( self.product._fileno, # noqa: SLF001 self.offset + offset, os.SEEK_SET, ) return os.read(self.product._fileno, size) # noqa: SLF001 def test_set_elem_metadata(self): self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) value = self.field.get_elem() + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) def test_set_elem_data(self): npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], self.FIELD_VALUES ) self.assertEqual(self.field.get_elem(), self.FIELD_VALUES[0]) value = self.field.get_elem() + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_elem(), value) values = np.array(self.FIELD_VALUES) values[0] = value npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], values ) def test_set_elem_rawdata(self): orig_data = self.read() value = self.field.get_elem() + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() data = self.read() self.assertNotEqual(data, orig_data) dtype = np.dtype(epr.get_numpy_dtype(self.FIELD_TYPE)) if dtype.byteorder != ">": dtype = dtype.newbyteorder() data = np.frombuffer(data, dtype) orig_data = np.frombuffer(orig_data, dtype).copy() orig_data[0] = value npt.assert_array_equal(data, orig_data) def test_set_elem0_metadata(self): self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) value = self.field.get_elem(0) + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) def test_set_elem0_data(self): npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], self.FIELD_VALUES ) self.assertEqual(self.field.get_elem(0), self.FIELD_VALUES[0]) value = self.field.get_elem(0) + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_elem(0), value) values = np.array(self.FIELD_VALUES) values[0] = value npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], values ) def test_set_elem0_rawdata(self): orig_data = self.read() value = self.field.get_elem(0) + 10 self.field.set_elem(value) if self.REOPEN: self.reopen() else: self.product.flush() data = self.read() self.assertNotEqual(data, orig_data) dtype = np.dtype(epr.get_numpy_dtype(self.FIELD_TYPE)) if dtype.byteorder != ">": dtype = dtype.newbyteorder() data = np.frombuffer(data, dtype) orig_data = np.frombuffer(orig_data, dtype).copy() orig_data[0] = value npt.assert_array_equal(data, orig_data) def test_set_elem20_metadata(self): self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) value = self.field.get_elem(20) + 1 self.field.set_elem(value, 20) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) def test_set_elem20_data(self): npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], self.FIELD_VALUES ) self.assertEqual(self.field.get_elem(20), self.FIELD_VALUES[20]) value = self.field.get_elem(20) + 1 self.field.set_elem(value, 20) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_elem(20), value) values = np.array(self.FIELD_VALUES) values[20] = value npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], values ) def test_set_elem20_rawdata(self): orig_data = self.read() value = self.field.get_elem(20) + 1 self.field.set_elem(value, 20) if self.REOPEN: self.reopen() else: self.product.flush() data = self.read() self.assertNotEqual(data, orig_data) dtype = np.dtype(epr.get_numpy_dtype(self.FIELD_TYPE)) if dtype.byteorder != ">": dtype = dtype.newbyteorder() data = np.frombuffer(data, dtype) orig_data = np.frombuffer(orig_data, dtype).copy() orig_data[20] = value npt.assert_array_equal(data, orig_data) def test_set_elems_metadata(self): self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) values = self.field.get_elems() + 1 self.field.set_elems(values) if self.REOPEN: self.reopen() else: self.product.flush() self.assertEqual(self.field.get_description(), self.FIELD_DESCRIPTION) self.assertEqual(self.field.get_num_elems(), self.FIELD_NUM_ELEMS) self.assertEqual(self.field.get_type(), self.FIELD_TYPE) self.assertEqual( epr.data_type_id_to_str(self.field.get_type()), self.FIELD_TYPE_NAME, ) self.assertEqual(self.field.get_unit(), self.FIELD_UNIT) def test_set_elems_data(self): npt.assert_array_equal( self.field.get_elems()[: len(self.FIELD_VALUES)], self.FIELD_VALUES ) values = self.field.get_elems() + 1 self.field.set_elems(values) if self.REOPEN: self.reopen() else: self.product.flush() npt.assert_array_equal(self.field.get_elems(), values) def test_set_elems_rawdata(self): orig_data = self.read() values = self.field.get_elems() + 1 self.field.set_elems(values) if self.REOPEN: self.reopen() else: self.product.flush() data = self.read() self.assertNotEqual(data, orig_data) dtype = np.dtype(epr.get_numpy_dtype(self.FIELD_TYPE)) if dtype.byteorder != ">": dtype = dtype.newbyteorder() data = np.frombuffer(data, dtype) orig_data = np.frombuffer(orig_data, dtype).copy() orig_data += 1 npt.assert_array_equal(data, orig_data) def test_set_mph_elem(self): mph = self.product.get_mph() field = mph.get_field_at(3) self.assertRaises(NotImplementedError, field.set_elem, 5) class TestFieldWriteReopen(TestFieldWrite): REOPEN = True class TestTimeField(TestField): DATASET_NAME = "MDS1_SQ_ADS" FIELD_NAME = "zero_doppler_time" FIELD_DESCRIPTION = "Zero doppler time at which SQ information applies" FIELD_TYPE = epr.E_TID_TIME FIELD_TYPE_NAME = "time" FIELD_NUM_ELEMS = 1 FIELD_VALUES = ( epr.EPRTime(days=3567, seconds=10588, microseconds=239048), ) FIELD_UNIT = "MJD" FIELD_OFFSET = 0 def test_get_elems(self): vect = self.field.get_elems() self.assertTrue(isinstance(vect, np.ndarray)) self.assertEqual(vect.shape, (self.field.get_num_elems(),)) self.assertEqual(vect.dtype, epr.MJD) value = self.FIELD_VALUES[0] self.assertEqual(vect[0]["days"], value.days) self.assertEqual(vect[0]["seconds"], value.seconds) self.assertEqual(vect[0]["microseconds"], value.microseconds) class TestFieldWithMiltipleElems(TestField): DATASET_NAME = TestProduct.DATASET_NAME RECORD_INDEX = TestFieldWrite.RECORD_INDEX FIELD_NAME = "proc_data" FIELD_DESCRIPTION = "SAR Processed Data. Real samples (detected products)" FIELD_TYPE = epr.E_TID_USHORT FIELD_TYPE_NAME = "ushort" FIELD_NUM_ELEMS = 1452 FIELD_VALUES = TestFieldWrite.FIELD_VALUES FIELD_UNIT = "" FIELD_OFFSET = 17 class TestFieldHighLevelAPI(unittest.TestCase): DATASET_NAME = TestProduct.DATASET_NAME def setUp(self): self.product = epr.Product(PRODUCT_FILE) dataset = self.product.get_dataset(self.DATASET_NAME) self.record = dataset.read_record(0) def tearDown(self): self.product.close() def test_repr(self): pattern = ( r"epr\.Field\((?P['\"])(?P.+)(?P=q)\) (?P\d+) " r"(?P\w+) elements" ) for field in self.record: mobj = re.match(pattern, repr(field)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("name"), field.get_name()) self.assertEqual(mobj.group("num"), str(field.get_num_elems())) self.assertEqual( mobj.group("type"), epr.data_type_id_to_str(field.get_type()) ) def test_repr_type(self): field = self.record.get_field_at(0) self.assertTrue(isinstance(repr(field), str)) def test_str_type(self): field = self.record.get_field_at(0) self.assertTrue(isinstance(str(field), str)) def test_str_vs_print(self): for field in self.record: with tempfile.TemporaryFile("w+", encoding="utf-8") as fd: field.print(fd) fd.flush() fd.seek(0) data = fd.read() if data.endswith("\n"): data = data[:-1] self.assertEqual(data, str(field)) def test_eq_field1_field1(self): field = self.record.get_field_at(0) self.assertEqual(field, field) def test_eq_field1_field2(self): field1 = self.record.get_field_at(1) field2 = self.record.get_field_at(2) self.assertFalse(field1 == field2) def test_eq_field_record(self): field = self.record.get_field_at(0) self.assertFalse(field == self.record) def test_ne_field1_field1(self): field = self.record.get_field_at(0) self.assertFalse(field != field) # noqa: PLR0124 def test_ne_field1_field2(self): field1 = self.record.get_field_at(1) field2 = self.record.get_field_at(2) self.assertNotEqual(field1, field2) def test_ne_field_record(self): field = self.record.get_field_at(0) self.assertNotEqual(field, self.record) class TestFieldHighLevelAPI2(unittest.TestCase): DATASET_NAME = "MAIN_PROCESSING_PARAMS_ADS" RECORD_INDEX = 0 def setUp(self): self.product = epr.Product(PRODUCT_FILE) def tearDown(self): self.product.close() def test_len_1(self): dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) field = record.get_field("range_spacing") self.assertEqual(len(field), field.get_num_elems()) def test_len_x(self): dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) field = record.get_field("image_parameters.prf_value") self.assertEqual(len(field), field.get_num_elems()) def test_len_e_tid_unknown(self): dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) field = record.get_field("spare_1") self.assertEqual(len(field), field.get_num_elems()) def test_len_e_tid_string(self): dataset = self.product.get_dataset(self.DATASET_NAME) record = dataset.read_record(self.RECORD_INDEX) field = record.get_field("swath_id") self.assertEqual(len(field), len(field.get_elem())) class TestFieldLowLevelAPI(unittest.TestCase): DATASET_INDEX = 0 RECORD_INDEX = 0 FIELD_NAME = "invalid_downlink_flag" FIELD_OFFSET = 23 def setUp(self): self.product = epr.Product(PRODUCT_FILE) dataset = self.product.get_dataset_at(self.DATASET_INDEX) record = dataset.read_record(self.RECORD_INDEX) self.field = record.get_field(self.FIELD_NAME) def tearDown(self): self.product.close() def test_magic(self): self.assertEqual(self.field._magic, _EPR_MAGIC_FIELD) # noqa: SLF001 def test_get_offset(self): self.assertEqual(self.field.get_offset(), self.FIELD_OFFSET) class TestFieldOnClosedProduct(unittest.TestCase): DATASET_NAME = "MDS1_SQ_ADS" RECOSR_INDEX = 0 FIELD_NAME = "invalid_downlink_flag" FIELD_NAME2 = "zero_doppler_time" def setUp(self): product = epr.Product(PRODUCT_FILE) dataset = product.get_dataset(self.DATASET_NAME) self.record = dataset.read_record(self.RECOSR_INDEX) self.field = self.record.get_field(self.FIELD_NAME) self.field2 = self.record.get_field(self.FIELD_NAME2) product.close() def test_print_field(self): self.assertRaises(ValueError, self.field.print) def test_get_unit(self): self.assertRaises(ValueError, self.field.get_unit) def test_get_description(self): self.assertRaises(ValueError, self.field.get_description) def test_get_num_elems(self): self.assertRaises(ValueError, self.field.get_num_elems) def test_get_name(self): self.assertRaises(ValueError, self.field.get_name) def test_get_type(self): self.assertRaises(ValueError, self.field.get_type) def test_get_elem(self): self.assertRaises(ValueError, self.field.get_elem) def test_get_elems(self): self.assertRaises(ValueError, self.field.get_elems) def test_repr(self): self.assertRaises(ValueError, repr, self.field) def test_str(self): self.assertRaises(ValueError, str, self.field) def test_eq(self): self.assertRaises(ValueError, operator.eq, self.field, self.field2) def test_ne(self): self.assertRaises(ValueError, operator.ne, self.field, self.field2) def test_len(self): self.assertRaises(ValueError, len, self.field) class TestDSD(unittest.TestCase): OPEN_MODE = "rb" DSD_INDEX = 0 DS_NAME = "MDS1 SQ ADS" DS_OFFSET = 7346 DS_TYPE = "A" DS_SIZE = 170 DSR_SIZE = 170 NUM_DSR = 1 def setUp(self): self.product = epr.Product(PRODUCT_FILE, self.OPEN_MODE) self.dsd = self.product.get_dsd_at(self.DSD_INDEX) def tearDown(self): self.product.close() def test_index(self): self.assertEqual(self.dsd.index, self.DSD_INDEX) self.assertTrue(isinstance(self.dsd.index, int)) def test_ds_name(self): self.assertEqual(self.dsd.ds_name, self.DS_NAME) self.assertTrue(isinstance(self.dsd.ds_name, str)) def test_ds_type(self): self.assertEqual(self.dsd.ds_type, self.DS_TYPE) self.assertTrue(isinstance(self.dsd.ds_type, str)) def test_filename(self): self.assertEqual(self.dsd.filename, "") self.assertTrue(isinstance(self.dsd.filename, str)) def test_ds_offset(self): self.assertEqual(self.dsd.ds_offset, self.DS_OFFSET) self.assertTrue(isinstance(self.dsd.ds_offset, numbers.Integral)) def test_ds_size(self): self.assertEqual(self.dsd.ds_size, self.DS_SIZE) self.assertTrue(isinstance(self.dsd.ds_size, numbers.Integral)) def test_num_dsr(self): self.assertEqual(self.dsd.num_dsr, self.NUM_DSR) self.assertTrue(isinstance(self.dsd.num_dsr, numbers.Integral)) def test_dsr_size(self): self.assertEqual(self.dsd.dsr_size, self.DSR_SIZE) self.assertTrue(isinstance(self.dsd.dsr_size, numbers.Integral)) def test_eq_dsd1_dsd1(self): self.assertEqual(self.dsd, self.dsd) def test_eq_dsd1_dsd2(self): dsd1 = self.product.get_dsd_at(1) dsd2 = self.product.get_dsd_at(2) self.assertFalse(dsd1 == dsd2) def test_eq_dsd_product(self): self.assertFalse(self.dsd == self.product) def test_ne_dsd1_dsd1(self): self.assertFalse(self.dsd != self.dsd) def test_ne_dsd1_dsd2(self): dsd1 = self.product.get_dsd_at(1) dsd2 = self.product.get_dsd_at(2) self.assertNotEqual(dsd1, dsd2) def test_ne_dsd_record(self): self.assertTrue(self.dsd != self.product) class TestDSDRW(TestDSD): OPEN_MODE = "rb+" class TestDsdHighLevelAPI(unittest.TestCase): def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dsd = self.product.get_dsd_at(0) def tearDown(self): self.product.close() def test_repr(self): pattern = r"epr\.DSD\((?P['\"])(?P.+)(?P=q)\)" mobj = re.match(pattern, repr(self.dsd)) self.assertNotEqual(mobj, None) self.assertEqual(mobj.group("name"), self.dsd.ds_name) def test_repr_type(self): self.assertTrue(isinstance(repr(self.dsd), str)) def test_str_type(self): self.assertTrue(isinstance(str(self.dsd), str)) class TestDsdLowLevelAPI(unittest.TestCase): def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dsd = self.product.get_dsd_at(0) def tearDown(self): self.product.close() def test_magic(self): # self.assertEqual(self.dsd._magic, _EPR_MAGIC_DSD_ID) self.assertTrue(isinstance(self.dsd._magic, int)) # noqa: SLF001 class TestDSDOnCloserProduct(unittest.TestCase): DSD_INDEX = 0 def setUp(self): self.product = epr.Product(PRODUCT_FILE) self.dsd = self.product.get_dsd_at(self.DSD_INDEX) self.dsd2 = self.product.get_dsd_at(self.DSD_INDEX + 1) self.product.close() def test_index(self): self.assertRaises(ValueError, getattr, self.dsd, "index") def test_ds_name(self): self.assertRaises(ValueError, getattr, self.dsd, "ds_name") def test_ds_type(self): self.assertRaises(ValueError, getattr, self.dsd, "ds_type") def test_filename(self): self.assertRaises(ValueError, getattr, self.dsd, "filename") def test_ds_offset(self): self.assertRaises(ValueError, getattr, self.dsd, "ds_offset") def test_ds_size(self): self.assertRaises(ValueError, getattr, self.dsd, "ds_size") def test_num_dsr(self): self.assertRaises(ValueError, getattr, self.dsd, "num_dsr") def test_dsr_size(self): self.assertRaises(ValueError, getattr, self.dsd, "dsr_size") def test_eq(self): self.assertRaises(ValueError, operator.eq, self.dsd, self.dsd2) def test_ne(self): self.assertRaises(ValueError, operator.ne, self.dsd, self.dsd2) def test_repr(self): self.assertRaises(ValueError, repr, self.dsd) def test_str(self): self.assertRaises(ValueError, str, self.dsd) class TestDataypeFunctions(unittest.TestCase): TYPE_NAMES = { epr.E_TID_UNKNOWN: "", epr.E_TID_UCHAR: "uchar", epr.E_TID_CHAR: "char", epr.E_TID_USHORT: "ushort", epr.E_TID_SHORT: "short", epr.E_TID_UINT: "uint", epr.E_TID_INT: "int", epr.E_TID_FLOAT: "float", epr.E_TID_DOUBLE: "double", epr.E_TID_STRING: "string", epr.E_TID_SPARE: "spare", epr.E_TID_TIME: "time", } TYPE_SIZES = { epr.E_TID_UNKNOWN: 0, epr.E_TID_UCHAR: 1, epr.E_TID_CHAR: 1, epr.E_TID_USHORT: 2, epr.E_TID_SHORT: 2, epr.E_TID_UINT: 4, epr.E_TID_INT: 4, epr.E_TID_FLOAT: 4, epr.E_TID_DOUBLE: 8, epr.E_TID_STRING: 1, epr.E_TID_SPARE: 1, epr.E_TID_TIME: 12, } TYPE_MAP = { epr.E_TID_UNKNOWN: None, epr.E_TID_UCHAR: np.uint8, epr.E_TID_CHAR: np.int8, epr.E_TID_USHORT: np.uint16, epr.E_TID_SHORT: np.int16, epr.E_TID_UINT: np.uint32, epr.E_TID_INT: np.int32, epr.E_TID_FLOAT: np.float32, epr.E_TID_DOUBLE: np.float64, epr.E_TID_STRING: np.bytes_, epr.E_TID_SPARE: None, epr.E_TID_TIME: epr.MJD, } def test_data_type_id_to_str(self): for type_id, type_name in self.TYPE_NAMES.items(): self.assertEqual(epr.data_type_id_to_str(type_id), type_name) def test_data_type_id_to_str_invalid(self): self.assertEqual(epr.data_type_id_to_str(500), "") def test_get_data_type_size(self): for type_id, type_size in self.TYPE_SIZES.items(): self.assertEqual(epr.get_data_type_size(type_id), type_size) def test_get_data_type_size_invalid(self): self.assertEqual(epr.get_data_type_size(500), 0) def test_epr_to_numpy_dtype(self): for epr_type in self.TYPE_MAP: with self.subTest(epr_type=epr_type): self.assertEqual( epr.get_numpy_dtype(epr_type), self.TYPE_MAP[epr_type] ) class TestScalingMethodFunctions(unittest.TestCase): METHOD_NAMES = { epr.E_SMID_NON: "NONE", epr.E_SMID_LIN: "LIN", epr.E_SMID_LOG: "LOG", } def test_get_scaling_method_name(self): for id_, name in self.METHOD_NAMES.items(): self.assertEqual(epr.get_scaling_method_name(id_), name) def test_get_scaling_method_name_invalid(self): self.assertRaises(ValueError, epr.get_scaling_method_name, 500) class TestSampleModelFunctions(unittest.TestCase): MODEL_NAMES = { epr.E_SMOD_1OF1: "1OF1", epr.E_SMOD_1OF2: "1OF2", epr.E_SMOD_2OF2: "2OF2", epr.E_SMOD_3TOI: "3TOI", epr.E_SMOD_2TOF: "2TOF", } def test_get_scaling_method_name(self): for id_, name in self.MODEL_NAMES.items(): self.assertEqual(epr.get_sample_model_name(id_), name) def test_get_scaling_method_name_invalid(self): self.assertRaises(ValueError, epr.get_sample_model_name, 500) class TestDirectInstantiation(unittest.TestCase): MSG_PATTERN = ( "(?P['\"])%s(?P=q) class cannot be instantiated from Python" ) def test_direct_dsd_instantiation(self): pattern = self.MSG_PATTERN % epr.DSD.__name__ self.assertRaisesRegex(TypeError, pattern, epr.DSD) def test_direct_field_instantiation(self): pattern = self.MSG_PATTERN % epr.Field.__name__ self.assertRaisesRegex(TypeError, pattern, epr.Field) def test_direct_record_instantiation(self): pattern = self.MSG_PATTERN % epr.Record.__name__ self.assertRaisesRegex(TypeError, pattern, epr.Record) def test_direct_raster_instantiation(self): pattern = self.MSG_PATTERN % epr.Raster.__name__ self.assertRaisesRegex(TypeError, pattern, epr.Raster) def test_direct_band_instantiation(self): pattern = self.MSG_PATTERN % epr.Band.__name__ self.assertRaisesRegex(TypeError, pattern, epr.Band) def test_direct_dataset_instantiation(self): pattern = self.MSG_PATTERN % epr.Dataset.__name__ self.assertRaisesRegex(TypeError, pattern, epr.Dataset) def test_direct_product_instantiation(self): self.assertRaises(epr.EPRError, epr.Product, "filename") class TestLibVersion(unittest.TestCase): def test_c_api_version(self): self.assertTrue(isinstance(epr.EPR_C_API_VERSION, str)) @unittest.skipIf( platform.python_implementation() == "PyPy", "skip memory leak check on PyPy", ) @unittest.skipIf( FREE_THREAD, "skip memory leak check on free threading builds" ) @unittest.skipIf(not have_resource, "'resource' module not available") class TestMemoryLeaks(unittest.TestCase): # See gh-10 (https://github.com/avalentino/pyepr/issues/10) BAND_NAME = "incident_angle" def test_memory_leacks_on_read_as_array(self): m = 10 for n in range(m): with epr.open(PRODUCT_FILE) as p: p.get_band(self.BAND_NAME).read_as_array() if n <= 1: m1 = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss m2 = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss self.assertLessEqual(m2 - m1, 8) class TestComplexBand(unittest.TestCase): def setUp(self): self.product = epr.open(PRODUCT_FILE) def tearDown(self): self.product.close() def test_get_complex_band_as_array(self): iname = "proc_data_1" qname = "proc_data_2" cdata = self.product.get_complex_band_as_array( iname, qname, strict=False ) self.assertIsInstance(cdata, np.ndarray) self.assertTrue(np.iscomplexobj(cdata)) re = self.product.get_band(iname).read_as_array() self.assertEqual(cdata.shape, re.shape) npt.assert_array_equal(cdata.real, re) del re im = self.product.get_band(qname).read_as_array() self.assertEqual(cdata.shape, im.shape) npt.assert_array_equal(cdata.imag, im) del im def test_get_complex_band_as_array_not_same_dataset(self): iname = "proc_data_1" qname = "proc_data_2" with self.assertRaisesRegex( ValueError, "the input bands does not belong to the same dataset" ): self.product.get_complex_band_as_array(iname, qname, strict=True) if __name__ == "__main__": print(f"PyEPR: {epr.__version__}") print(f"EPR API: {epr.EPR_C_API_VERSION}") print(f"Numpy: {np.__version__}") print(f"Python: {sys.version}") unittest.main()